@strands-agents/sdk 0.5.0 → 0.7.0

package/dist/src/session/s3-storage.js

@@ -1,14 +1,23 @@
-import { S3Client, PutObjectCommand, GetObjectCommand, ListObjectsV2Command } from '@aws-sdk/client-s3';
+import { S3Client, PutObjectCommand, GetObjectCommand, ListObjectsV2Command, DeleteObjectsCommand, } from '@aws-sdk/client-s3';
 import { SessionError } from '../errors.js';
-import { validateIdentifier } from './validation.js';
+import { validateIdentifier, validateUuidV7 } from './validation.js';
 const MANIFEST = 'manifest.json';
 const SNAPSHOT_LATEST = 'snapshot_latest.json';
 const IMMUTABLE_HISTORY = 'immutable_history/';
-const SNAPSHOT_REGEX = /snapshot_(\d+)\.json$/;
 const SCHEMA_VERSION = '1.0';
-const DEFAULT_SNAPSHOT_ID = '1';
+const SNAPSHOT_REGEX = /snapshot_([\w-]+)\.json$/;
+const S3_PAGE_SIZE = 1000;
 /**
- * S3-based implementation of SnapshotStorage for persisting session snapshots
+ * S3-based implementation of SnapshotStorage.
+ * Persists session snapshots as JSON objects in an S3 bucket.
+ *
+ * Object key layout:
+ * ```
+ * [<prefix>/]<sessionId>/scopes/<scope>/<scopeId>/snapshots/
+ *   snapshot_latest.json
+ *   immutable_history/
+ *     snapshot_<uuid7>.json
+ * ```
  */
 export class S3Storage {
     /** S3 client instance */
@@ -30,7 +39,8 @@ export class S3Storage {
         this._s3 = config.s3Client ?? new S3Client({ region: config.region ?? 'us-east-1' });
     }
     /**
-     * Generates S3 key path for session scope snapshots
+     * Resolves the full S3 object key for a given scope location and path.
+     * Validates sessionId and scopeId before constructing the key.
      */
     _getKey(location, path) {
         validateIdentifier(location.sessionId);
@@ -39,16 +49,31 @@ export class S3Storage {
         return `${base}${location.sessionId}/scopes/${location.scope}/${location.scopeId}/snapshots/${path}`;
     }
     /**
-     * Saves snapshot to S3, optionally marking as latest
+     * Resolves the S3 key prefix for an entire session (`[<prefix>/]<sessionId>/`).
+     * Used by deleteSession to list and remove all objects under the session.
+     */
+    _getSessionPrefix(sessionId) {
+        validateIdentifier(sessionId);
+        const base = this._prefix ? `${this._prefix}/` : '';
+        return `${base}${sessionId}/`;
+    }
+    /**
+     * Persists a snapshot to S3.
+     * If `isLatest` is true, writes to `snapshot_latest.json` (overwriting any previous).
+     * Otherwise, writes to `immutable_history/snapshot_<snapshotId>.json`.
      */
     async saveSnapshot(params) {
-        await this._writeJSON(this._getHistorySnapshotKey(params.location, params.snapshotId), params.snapshot);
-        if (params.isLatest) {
+        if (!params.isLatest) {
+            await this._writeJSON(this._getHistorySnapshotKey(params.location, params.snapshotId), params.snapshot);
+        }
+        else {
             await this._writeJSON(this._getLatestSnapshotKey(params.location), params.snapshot);
         }
     }
     /**
-     * Loads snapshot by ID or latest if undefined
+     * Loads a snapshot from S3.
+     * If `snapshotId` is omitted, loads `snapshot_latest.json`.
+     * Returns null if the object does not exist.
      */
     async loadSnapshot(params) {
         const key = params.snapshotId === undefined
@@ -57,54 +82,102 @@ export class S3Storage {
         return this._readJSON(key);
     }
     /**
-     * Lists all snapshot IDs for a session scope.
-     *
-     * TODO: Add pagination support for long-running agents with many snapshots.
-     * Future signature could be:
-     * ```typescript
-     * 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 }>
-     * ```
+     * Lists immutable snapshot IDs for a scope, sorted chronologically.
+     * Since IDs are UUID v7, lexicographic sort equals chronological order.
+     * Pushes `startAfter` and `limit` down to S3 via `StartAfter` and `MaxKeys`
+     * to avoid fetching unnecessary objects.
+     * Returns an empty array if no snapshots exist yet.
      */
     async listSnapshotIds(params) {
+        if (params.limit !== undefined && params.limit <= 0)
+            return [];
+        if (params.startAfter)
+            validateUuidV7(params.startAfter);
         const prefix = this._getKey(params.location, IMMUTABLE_HISTORY);
+        // S3 StartAfter is a full object key; construct it from the UUID cursor.
+        // Exclusive: objects after this key are returned, matching our pagination contract.
+        const startAfterKey = params.startAfter
+            ? this._getHistorySnapshotKey(params.location, params.startAfter)
+            : undefined;
         try {
-            const response = await this._s3.send(new ListObjectsV2Command({ Bucket: this._bucket, Prefix: prefix }));
-            return (response.Contents ?? [])
-                .map((obj) => obj.Key?.match(SNAPSHOT_REGEX)?.[1])
-                .filter((id) => id !== undefined)
-                .map((id) => String(parseInt(id)))
-                .sort((a, b) => parseInt(a) - parseInt(b));
+            const ids = [];
+            let continuationToken;
+            do {
+                const response = await this._s3.send(new ListObjectsV2Command({
+                    Bucket: this._bucket,
+                    Prefix: prefix,
+                    StartAfter: continuationToken ? undefined : startAfterKey,
+                    MaxKeys: params.limit !== undefined ? Math.min(S3_PAGE_SIZE, params.limit - ids.length) : S3_PAGE_SIZE,
+                    ContinuationToken: continuationToken,
+                }));
+                const page = (response.Contents ?? [])
+                    .map((obj) => obj.Key?.match(SNAPSHOT_REGEX)?.[1])
+                    .filter((id) => id !== undefined);
+                ids.push(...page);
+                if (response.IsTruncated) {
+                    if (!response.NextContinuationToken) {
+                        throw new SessionError('S3 returned truncated response without continuation token');
+                    }
+                    continuationToken = response.NextContinuationToken;
+                }
+                else {
+                    continuationToken = undefined;
+                }
+            } while (continuationToken && (params.limit === undefined || ids.length < params.limit));
+            return params.limit !== undefined ? ids.slice(0, params.limit) : ids;
         }
         catch (error) {
+            if (error instanceof SessionError)
+                throw error;
+            if (this._isNotFoundError(error))
+                return [];
             throw new SessionError(`Failed to list snapshots for session ${params.location.sessionId}`, { cause: error });
         }
     }
     /**
-     * Loads manifest or returns default if not found
+     * Deletes all S3 objects belonging to a session by listing and batch-deleting
+     * everything under `[<prefix>/]<sessionId>/`.
+     * Handles buckets with more than 1000 objects via continuation token pagination.
+     * No-ops if the session has no objects.
+     */
+    async deleteSession(params) {
+        const prefix = this._getSessionPrefix(params.sessionId);
+        try {
+            let continuationToken;
+            do {
+                const response = await this._s3.send(new ListObjectsV2Command({ Bucket: this._bucket, Prefix: prefix, ContinuationToken: continuationToken }));
+                const keys = (response.Contents ?? []).map((obj) => ({ Key: obj.Key }));
+                if (keys.length > 0) {
+                    await this._s3.send(new DeleteObjectsCommand({ Bucket: this._bucket, Delete: { Objects: keys } }));
+                }
+                continuationToken = response.IsTruncated ? response.NextContinuationToken : undefined;
+            } while (continuationToken);
+        }
+        catch (error) {
+            throw new SessionError(`Failed to delete session ${params.sessionId}`, { cause: error });
+        }
+    }
+    /**
+     * Loads the snapshot manifest for a scope from S3.
+     * Returns a default manifest with the current timestamp if none exists yet.
      */
     async loadManifest(params) {
         const key = this._getKey(params.location, MANIFEST);
         const manifest = await this._readJSON(key);
         return (manifest ?? {
             schemaVersion: SCHEMA_VERSION,
-            nextSnapshotId: DEFAULT_SNAPSHOT_ID,
             updatedAt: new Date().toISOString(),
         });
     }
     /**
-     * Saves manifest to S3
+     * Persists the snapshot manifest for a scope to S3.
      */
     async saveManifest(params) {
         const key = this._getKey(params.location, MANIFEST);
         await this._writeJSON(key, params.manifest);
     }
     /**
-     * Writes JSON data to S3
+     * Serializes data as JSON and writes it to S3 with `application/json` content type.
      */
     async _writeJSON(key, data) {
         try {
@@ -120,7 +193,8 @@ export class S3Storage {
         }
     }
     /**
-     * Reads and parses JSON from S3
+     * Reads and parses a JSON object from S3. Returns null if the object does not exist.
+     * Throws SessionError on parse failure or unexpected S3 errors.
      */
     async _readJSON(key) {
         try {
@@ -131,7 +205,7 @@ export class S3Storage {
             return JSON.parse(body);
         }
         catch (error) {
-            if (error && typeof error === 'object' && 'name' in error && error.name === 'NoSuchKey') {
+            if (this._isNotFoundError(error)) {
                 return null;
             }
             if (error instanceof SyntaxError) {
@@ -140,11 +214,22 @@ export class S3Storage {
             throw new SessionError(`S3 error reading ${key}`, { cause: error });
         }
     }
+    /** Returns true if the error represents a missing S3 object (`NoSuchKey`) or bucket (`NoSuchBucket`). */
+    _isNotFoundError(error) {
+        return (error !== null &&
+            typeof error === 'object' &&
+            'name' in error &&
+            typeof error.name === 'string' &&
+            (error.name === 'NoSuchKey' || error.name === 'NoSuchBucket'));
+    }
+    /** Returns the S3 key for `snapshot_latest.json` within the given scope. */
     _getLatestSnapshotKey(location) {
         return this._getKey(location, SNAPSHOT_LATEST);
     }
+    /** Returns the S3 key for an immutable snapshot in `immutable_history/`. Validates the snapshotId before constructing the key. */
     _getHistorySnapshotKey(location, snapshotId) {
-        return this._getKey(location, `${IMMUTABLE_HISTORY}snapshot_${String(snapshotId).padStart(5, '0')}.json`);
+        validateIdentifier(snapshotId);
+        return this._getKey(location, `${IMMUTABLE_HISTORY}snapshot_${snapshotId}.json`);
     }
 }
 //# sourceMappingURL=s3-storage.js.map

package/dist/src/session/s3-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3-storage.js","sourceRoot":"","sources":["../../../src/session/s3-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"s3-storage.js","sourceRoot":"","sources":["../../../src/session/s3-storage.ts"],"names":[],"mappings":"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"}

package/dist/src/session/session-manager.d.ts

@@ -0,0 +1,87 @@
+import type { SnapshotStorage } from './storage.js';
+import type { SnapshotTriggerCallback } from './types.js';
+import type { Plugin } from '../plugins/plugin.js';
+import type { LocalAgent } from '../types/agent.js';
+import type { Agent } from '../agent/agent.js';
+/**
+ * Controls when `snapshot_latest` is saved automatically.
+ *
+ * There are two kinds of snapshots:
+ * - **`snapshot_latest`**: A single mutable snapshot that is overwritten on each save. Used to
+ *   resume the most recent conversation state (e.g. after a crash or restart). Always reflects
+ *   the last saved point in time.
+ * - **Immutable snapshots**: Append-only snapshots with unique IDs (UUID v7), created only when
+ *   `snapshotTrigger` fires. Used for checkpointing — you can restore to any prior state, not
+ *   just the latest.
+ *
+ * `SaveLatestStrategy` controls how frequently `snapshot_latest` is updated:
+ * - `'invocation'`: after every agent invocation completes (default; balances durability and I/O)
+ * - `'message'`: after every message added and after model calls with guardrail redactions (most durable, highest I/O)
+ * - `'trigger'`: only when a `snapshotTrigger` fires (or manually via `saveSnapshot`)
+ */
+export type SaveLatestStrategy = 'message' | 'invocation' | 'trigger';
+export interface SessionManagerConfig {
+    /** Pluggable storage backends for snapshot persistence. Defaults to FileStorage in Node.js; required in browser environments. */
+    storage: {
+        snapshot: SnapshotStorage;
+    };
+    /** Unique session identifier. Defaults to `'default-session'`. */
+    sessionId?: string;
+    /** When to save snapshot_latest. Default: `'invocation'` (after each agent invocation completes). See {@link SaveLatestStrategy} for details. */
+    saveLatestOn?: SaveLatestStrategy;
+    /** Callback invoked after each invocation to decide whether to create an immutable snapshot. */
+    snapshotTrigger?: SnapshotTriggerCallback;
+}
+/**
+ * Manages session persistence for agents, enabling conversation state
+ * to be saved and restored across invocations using pluggable storage backends.
+ *
+ * @example
+ * ```typescript
+ * import { SessionManager, FileStorage } from '@strands-agents/sdk'
+ *
+ * const session = new SessionManager({
+ *   sessionId: 'my-session',
+ *   storage: { snapshot: new FileStorage() },
+ * })
+ * const agent = new Agent({ sessionManager: session })
+ * ```
+ */
+export declare class SessionManager implements Plugin {
+    private readonly _sessionId;
+    private readonly _storage;
+    private readonly _saveLatestOn;
+    private readonly _snapshotTrigger?;
+    /**
+     * Unique identifier for this plugin.
+     */
+    get name(): string;
+    constructor(config: SessionManagerConfig);
+    /** Initializes the plugin by registering lifecycle hook callbacks. */
+    initAgent(agent: LocalAgent): void;
+    private _location;
+    saveSnapshot(params: {
+        target: Agent;
+        isLatest: boolean;
+    }): Promise<void>;
+    /** Deletes all snapshots and manifests for this session from storage. */
+    deleteSession(): Promise<void>;
+    /** Loads a snapshot from storage and restores it into the target agent. Returns false if no snapshot exists. */
+    restoreSnapshot(params: {
+        target: Agent;
+        snapshotId?: string;
+    }): Promise<boolean>;
+    /** Restores session state on agent initialization. */
+    private _onAgentInitialized;
+    /** Saves latest on invocation and fires the snapshot trigger if configured. */
+    private _onAfterAgentInvocation;
+    private _onMessageAdded;
+    /**
+     * Saves snapshot when a message is redacted after a model call.
+     * Critical for ensuring guardrail redactions are persisted immediately.
+     */
+    private _onAfterModelCall;
+    /** Captures one snapshot and writes it to both immutable history and snapshot_latest. */
+    private _saveImmutableAndLatest;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/src/session/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/session/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAA;AAErE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAG9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAErE,MAAM,WAAW,oBAAoB;IACnC,iIAAiI;IACjI,OAAO,EAAE;QACP,QAAQ,EAAE,eAAe,CAAA;KAC1B,CAAA;IACD,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iJAAiJ;IACjJ,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC,gGAAgG;IAChG,eAAe,CAAC,EAAE,uBAAuB,CAAA;CAC1C;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,MAAM;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAqC;IAEvE;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;gBAEW,MAAM,EAAE,oBAAoB;IAOxC,sEAAsE;IAC/D,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAmBzC,OAAO,CAAC,SAAS;IAIX,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/E,yEAAyE;IACnE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,gHAAgH;IAC1G,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvF,sDAAsD;YACxC,mBAAmB;IAIjC,+EAA+E;YACjE,uBAAuB;YAYvB,eAAe;IAK7B;;;OAGG;YACW,iBAAiB;IAQ/B,yFAAyF;YAC3E,uBAAuB;CAatC"}

package/dist/src/session/session-manager.js

@@ -0,0 +1,128 @@
+import { validateIdentifier } from './validation.js';
+import { AfterInvocationEvent, AfterModelCallEvent, InitializedEvent, MessageAddedEvent } from '../hooks/events.js';
+import { v7 as uuidV7 } from 'uuid';
+import { takeSnapshot, loadSnapshot } from '../agent/snapshot.js';
+/**
+ * Manages session persistence for agents, enabling conversation state
+ * to be saved and restored across invocations using pluggable storage backends.
+ *
+ * @example
+ * ```typescript
+ * import { SessionManager, FileStorage } from '@strands-agents/sdk'
+ *
+ * const session = new SessionManager({
+ *   sessionId: 'my-session',
+ *   storage: { snapshot: new FileStorage() },
+ * })
+ * const agent = new Agent({ sessionManager: session })
+ * ```
+ */
+export class SessionManager {
+    _sessionId;
+    _storage;
+    _saveLatestOn;
+    _snapshotTrigger;
+    /**
+     * Unique identifier for this plugin.
+     */
+    get name() {
+        return 'strands:session-manager';
+    }
+    constructor(config) {
+        this._sessionId = validateIdentifier(config.sessionId ?? 'default-session');
+        this._storage = { snapshot: config.storage.snapshot };
+        this._saveLatestOn = config.saveLatestOn ?? 'invocation';
+        this._snapshotTrigger = config.snapshotTrigger;
+    }
+    /** Initializes the plugin by registering lifecycle hook callbacks. */
+    initAgent(agent) {
+        agent.addHook(InitializedEvent, async (event) => {
+            await this._onAgentInitialized(event);
+        });
+        if (this._saveLatestOn === 'message') {
+            agent.addHook(MessageAddedEvent, async (event) => {
+                await this._onMessageAdded(event);
+            });
+            // Also listen to AfterModelCallEvent when saving per-message to ensure
+            // message modifications (e.g., guardrail redactions) are persisted immediately
+            agent.addHook(AfterModelCallEvent, async (event) => {
+                await this._onAfterModelCall(event);
+            });
+        }
+        agent.addHook(AfterInvocationEvent, async (event) => {
+            await this._onAfterAgentInvocation(event);
+        });
+    }
+    _location(agent) {
+        return { sessionId: this._sessionId, scope: 'agent', scopeId: agent.id };
+    }
+    async saveSnapshot(params) {
+        const snapshot = takeSnapshot(params.target, { preset: 'session' });
+        const snapshotId = params.isLatest ? 'latest' : uuidV7();
+        await this._storage.snapshot.saveSnapshot({
+            location: this._location(params.target),
+            snapshotId,
+            isLatest: params.isLatest,
+            snapshot,
+        });
+    }
+    /** Deletes all snapshots and manifests for this session from storage. */
+    async deleteSession() {
+        await this._storage.snapshot.deleteSession({ sessionId: this._sessionId });
+    }
+    /** Loads a snapshot from storage and restores it into the target agent. Returns false if no snapshot exists. */
+    async restoreSnapshot(params) {
+        const snapshot = await this._storage.snapshot.loadSnapshot({
+            location: this._location(params.target),
+            ...(params.snapshotId !== undefined && { snapshotId: params.snapshotId }),
+        });
+        if (!snapshot)
+            return false;
+        loadSnapshot(params.target, snapshot);
+        return true;
+    }
+    /** Restores session state on agent initialization. */
+    async _onAgentInitialized(event) {
+        await this.restoreSnapshot({ target: event.agent });
+    }
+    /** Saves latest on invocation and fires the snapshot trigger if configured. */
+    async _onAfterAgentInvocation(event) {
+        const agent = event.agent;
+        if (this._saveLatestOn === 'invocation') {
+            await this.saveSnapshot({ target: agent, isLatest: true });
+        }
+        if (this._snapshotTrigger?.({ agentData: agent })) {
+            await this._saveImmutableAndLatest(agent);
+        }
+    }
+    async _onMessageAdded(event) {
+        const agent = event.agent;
+        await this.saveSnapshot({ target: agent, isLatest: true });
+    }
+    /**
+     * Saves snapshot when a message is redacted after a model call.
+     * Critical for ensuring guardrail redactions are persisted immediately.
+     */
+    async _onAfterModelCall(event) {
+        // Only save if there was a redaction
+        if (event.stopData?.redaction) {
+            const agent = event.agent;
+            await this.saveSnapshot({ target: agent, isLatest: true });
+        }
+    }
+    /** Captures one snapshot and writes it to both immutable history and snapshot_latest. */
+    async _saveImmutableAndLatest(agent) {
+        const snapshot = takeSnapshot(agent, { preset: 'session' });
+        const snapshotId = uuidV7();
+        await Promise.all([
+            this._storage.snapshot.saveSnapshot({ location: this._location(agent), snapshotId, isLatest: false, snapshot }),
+            this._storage.snapshot.saveSnapshot({
+                location: this._location(agent),
+                snapshotId: 'latest',
+                isLatest: true,
+                snapshot,
+            }),
+        ]);
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/src/session/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../../src/session/session-manager.ts"],"names":[],"mappings":"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"}

package/dist/src/session/storage.d.ts

@@ -7,7 +7,7 @@ export type SnapshotLocation = {
     sessionId: string;
     /** Scope of the snapshot (agent or multi-agent) */
     scope: Scope;
-    /** Scope-specific identifier (agentId or multiAgentId) */
+    /** Scope-specific identifier (agent id or multi-agent id) */
     scopeId: string;
 };
 /**
@@ -35,10 +35,9 @@ export type SessionStorage = {
  *     agent/<scope_id>/
  *       snapshots/
  *         snapshot_latest.json
- *         manifest.json
  *         immutable_history/
- *           snapshot_00001.json
- *           snapshot_00002.json
+ *           snapshot_<uuid>.json
+ *           snapshot_<uuid>.json
  * ```
  */
 export interface SnapshotStorage {
@@ -59,21 +58,30 @@ export interface SnapshotStorage {
         snapshotId?: string;
     }): Promise<Snapshot | null>;
     /**
-     * Lists all available snapshot IDs for a session scope.
+     * Lists all available immutable snapshot IDs for a session scope, sorted chronologically.
+     * Snapshot IDs are UUID v7 strings vended by the SDK — callers should treat them as opaque
+     * handles and never construct them manually.
      *
-     * TODO: Add pagination support for long-running agents with many snapshots.
-     * Future signature could be:
+     * Typical pagination pattern:
      * ```typescript
-     * listSnapshots(params: {
-     *   location: SnapshotLocation
-     *   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 }>
+     * const page1 = await storage.listSnapshotIds({ location })
+     * const page2 = await storage.listSnapshotIds({ location, startAfter: page1.at(-1) })
      * ```
+     *
+     * `limit` caps the number of returned IDs. `startAfter` is an exclusive cursor (the last ID
+     * from the previous page); it must be a UUID v7 obtained from a prior `listSnapshotIds` call.
      */
     listSnapshotIds(params: {
         location: SnapshotLocation;
+        limit?: number;
+        startAfter?: string;
     }): Promise<string[]>;
+    /**
+     * Deletes all snapshots and directories belonging to the session ID.
+     */
+    deleteSession(params: {
+        sessionId: string;
+    }): Promise<void>;
     /**
      * Loads the snapshot manifest.
      */

package/dist/src/session/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/session/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEnE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,KAAK,EAAE,KAAK,CAAA;IACZ,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,eAAe,CAAA;CAE1B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QACnB,QAAQ,EAAE,gBAAgB,CAAA;QAC1B,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,OAAO,CAAA;QACjB,QAAQ,EAAE,QAAQ,CAAA;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAEnG;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE1E;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE/E;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChG"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/session/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEnE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,KAAK,EAAE,KAAK,CAAA;IACZ,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,eAAe,CAAA;CAE1B,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QACnB,QAAQ,EAAE,gBAAgB,CAAA;QAC1B,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,OAAO,CAAA;QACjB,QAAQ,EAAE,QAAQ,CAAA;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAEnG;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE/G;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE/E;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChG"}

package/dist/src/session/types.d.ts

@@ -1,14 +1,12 @@
-import type { AgentData } from '../types/agent.js';
+import type { LocalAgent } from '../types/agent.js';
 export type { Snapshot, Scope } from '../agent/snapshot.js';
 /**
- * Manifest tracks snapshot metadata and ID allocation.
- * Stored alongside snapshots to manage versioning.
+ * Manifest tracks snapshot metadata.
+ * Stored alongside snapshots to support versioning and future multi-agent patterns.
  */
 export interface SnapshotManifest {
     /** Schema version for forward/backward compatibility */
     schemaVersion: string;
-    /** Next available snapshot ID for allocation */
-    nextSnapshotId: string;
     /** ISO 8601 timestamp of last manifest update */
     updatedAt: string;
 }
@@ -16,12 +14,8 @@ export interface SnapshotManifest {
  * Parameters passed to SnapshotTriggerCallback to determine when to create snapshots.
  */
 export interface SnapshotTriggerParams {
-    /** Number of agent invocations (turns) since session started */
-    turnCount: number;
-    /** Timestamp (ms) of last immutable snapshot creation, undefined if no snapshot yet */
-    lastSnapshotAt?: number;
     /** Current agent data including messages and state */
-    agentData: AgentData;
+    agentData: LocalAgent;
 }
 /**
  * Callback function to determine when to create immutable snapshots.
@@ -32,17 +26,11 @@ export interface SnapshotTriggerParams {
  *
  * @example
  * ```ts
- * // Snapshot every 5 turns
- * const trigger: SnapshotTriggerCallback = ({ turnCount }) => turnCount % 5 === 0
+ * // Snapshot every 10 messages
+ * const trigger: SnapshotTriggerCallback = ({ agentData }) => agentData.messages.length % 10 === 0
  *
- * // Snapshot every 60 seconds
- * const trigger: SnapshotTriggerCallback = ({ lastSnapshotAt }) => {
- *   if (!lastSnapshotAt) return false
- *   return Date.now() - lastSnapshotAt > 60000
- * }
- *
- * // Snapshot when conversation exceeds 10 messages
- * const trigger: SnapshotTriggerCallback = ({ agentData }) => agentData.messages.length > 10
+ * // Snapshot when conversation exceeds 20 messages
+ * const trigger: SnapshotTriggerCallback = ({ agentData }) => agentData.messages.length > 20
  * ```
  */
 export type SnapshotTriggerCallback = (params: SnapshotTriggerParams) => boolean;

package/dist/src/session/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAGlD,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAA;IACrB,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAA;IACjB,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,SAAS,EAAE,SAAS,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,SAAS,EAAE,UAAU,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAA"}

package/dist/src/session/validation.d.ts

@@ -7,4 +7,11 @@
  * @throws Error if identifier contains invalid characters
  */
 export declare function validateIdentifier(id: string): string;
+/**
+ * Validates that a string is a UUID v7.
+ *
+ * @param id - The string to validate
+ * @throws Error if the string is not a valid UUID v7
+ */
+export declare function validateUuidV7(id: string): void;
 //# sourceMappingURL=validation.d.ts.map

package/dist/src/session/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/session/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMrD"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/session/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK/C"}