SessionManager

Defined in: src/session/session-manager.ts:57

Manages session persistence for agents, enabling conversation state to be saved and restored across invocations using pluggable storage backends.

Example

import { SessionManager, FileStorage } from '@strands-agents/sdk'

const session = new SessionManager({
  sessionId: 'my-session',
  storage: { snapshot: new FileStorage() },
})
const agent = new Agent({ sessionManager: session })

Extends

Plugin

Constructors

Constructor

new SessionManager(config): SessionManager;

Defined in: src/session/session-manager.ts:70

Parameters

Parameter	Type
`config`	`SessionManagerConfig`

Returns

SessionManager

Overrides

Plugin.constructor

Accessors

name

Get Signature

get name(): string;

Defined in: src/session/session-manager.ts:66

Unique identifier for this plugin.

Returns

string

Overrides

Plugin.name

Methods

getTools()

getTools(): Tool[];

Defined in: src/plugins/plugin.ts:82

Returns tools provided by this plugin for auto-registration. Override to provide plugin-specific tools.

Returns

Tool[]

Array of tools to register with the agent

Inherited from

Plugin.getTools

initAgent()

initAgent(agent): void;

Defined in: src/session/session-manager.ts:79

Initializes the plugin by registering lifecycle hook callbacks.

Parameters

Parameter	Type
`agent`	`AgentData`

Returns

void

Overrides

Plugin.initAgent

saveSnapshot()

saveSnapshot(params): Promise<void>;

Defined in: src/session/session-manager.ts:102

Parameters

Parameter	Type
`params`	{ `target`: `Agent`; `isLatest`: `boolean`; }
`params.target`	`Agent`
`params.isLatest`	`boolean`

Returns

Promise<void>

deleteSession()

deleteSession(): Promise<void>;

Defined in: src/session/session-manager.ts:114

Deletes all snapshots and manifests for this session from storage.

Returns

Promise<void>

restoreSnapshot()

restoreSnapshot(params): Promise<boolean>;

Defined in: src/session/session-manager.ts:119

Loads a snapshot from storage and restores it into the target agent. Returns false if no snapshot exists.

Parameters

Parameter	Type
`params`	{ `target`: `Agent`; `snapshotId?`: `string`; }
`params.target`	`Agent`
`params.snapshotId?`	`string`

Returns

Promise<boolean>