FileStorage

Defined in: src/session/file-storage.ts:16

File-based implementation of SnapshotStorage for persisting session snapshots

Implements

SnapshotStorage

Constructors

Constructor

new FileStorage(baseDir): FileStorage;

Defined in: src/session/file-storage.ts:24

Creates new FileStorage instance

Parameters

Parameter	Type	Description
`baseDir`	`string`	Base directory path for storing snapshots

Returns

FileStorage

Methods

saveSnapshot()

saveSnapshot(params): Promise<void>;

Defined in: src/session/file-storage.ts:41

Saves snapshot to file, optionally marking as latest

Parameters

Parameter	Type
`params`	{ `location`: `SnapshotLocation`; `snapshotId`: `string`; `isLatest`: `boolean`; `snapshot`: `Snapshot`; }
`params.location`	`SnapshotLocation`
`params.snapshotId`	`string`
`params.isLatest`	`boolean`
`params.snapshot`	`Snapshot`

Returns

Promise<void>

Implementation of

SnapshotStorage.saveSnapshot

loadSnapshot()

loadSnapshot(params): Promise<Snapshot>;

Defined in: src/session/file-storage.ts:57

Loads snapshot by ID or latest if null

Parameters

Parameter	Type
`params`	{ `location`: `SnapshotLocation`; `snapshotId?`: `string`; }
`params.location`	`SnapshotLocation`
`params.snapshotId?`	`string`

Returns

Promise<Snapshot>

Implementation of

SnapshotStorage.loadSnapshot

listSnapshotIds()

listSnapshotIds(params): Promise<string[]>;

Defined in: src/session/file-storage.ts:86

Lists all snapshot IDs for a session scope.

TODO: Add pagination support for long-running agents with many snapshots. Future signature could be:

listSnapshots(params: {
  sessionId: string
  scope: Scope
  limit?: number        // Max results to return (e.g., 100)
  startAfter?: string   // Snapshot ID to start after (for cursor-based pagination)
}): Promise<{ snapshotIds: string[]; nextToken?: string }>

Parameters

Parameter	Type
`params`	{ `location`: `SnapshotLocation`; }
`params.location`	`SnapshotLocation`

Returns

Promise<string[]>

Implementation of

SnapshotStorage.listSnapshotIds

loadManifest()

loadManifest(params): Promise<SnapshotManifest>;

Defined in: src/session/file-storage.ts:106

Loads manifest or returns default if not found

Parameters

Parameter	Type
`params`	{ `location`: `SnapshotLocation`; }
`params.location`	`SnapshotLocation`

Returns

Promise<SnapshotManifest>

Implementation of

SnapshotStorage.loadManifest

saveManifest()

saveManifest(params): Promise<void>;

Defined in: src/session/file-storage.ts:121

Saves manifest to file

Parameters

Parameter	Type
`params`	{ `location`: `SnapshotLocation`; `manifest`: `SnapshotManifest`; }
`params.location`	`SnapshotLocation`
`params.manifest`	`SnapshotManifest`

Returns

Promise<void>

Implementation of

SnapshotStorage.saveManifest