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

Implements

Plugin

Constructors

Constructor

new SessionManager(config): SessionManager;

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

Parameters

Parameter	Type
`config`	`SessionManagerConfig`

Returns

SessionManager

Accessors

name

Get Signature

get name(): string;

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

Unique identifier for this plugin.

Returns

string

A stable string identifier for the plugin. Used for logging, duplicate detection, and plugin management.

For strands-vended plugins, names should be prefixed with strands:.

Implementation of

Plugin.name

Methods

initAgent()

initAgent(agent): void;

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

Initializes the plugin by registering lifecycle hook callbacks.

Parameters

Parameter	Type
`agent`	`AgentData`

Returns

void

Implementation of

Plugin.initAgent

saveSnapshot()

saveSnapshot(params): Promise<void>;

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

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:113

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:118

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>