SessionManager

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

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 })

Implements

HookProvider

Constructors

Constructor

new SessionManager(config): SessionManager;

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

Parameters

Parameter	Type
`config`	`SessionManagerConfig`

Returns

SessionManager

Methods

registerCallbacks()

registerCallbacks(registry): void;

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

Registers lifecycle hook callbacks on the provided registry.

Parameters

Parameter	Type
`registry`	`HookRegistry`

Returns

void

Implementation of

HookProvider.registerCallbacks

saveSnapshot()

saveSnapshot(params): Promise<void>;

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

Parameters

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

Returns

Promise<void>

restoreSnapshot()

restoreSnapshot(params): Promise<boolean>;

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

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>