@strands-agents/sdk 0.2.2 → 0.4.0

package/dist/src/session/__tests__/s3-storage.test.node.js

@@ -0,0 +1,375 @@
+import { describe, expect, it, beforeEach, vi } from 'vitest';
+import { S3Storage } from '../s3-storage.js';
+import { SessionError } from '../../errors.js';
+import { createTestSnapshot, createTestManifest, createTestScope } from '../../__fixtures__/mock-storage-provider.js';
+vi.mock('@aws-sdk/client-s3', () => ({
+    S3Client: vi.fn().mockImplementation(function () {
+        return {
+            send: vi.fn(),
+            config: {},
+        };
+    }),
+    PutObjectCommand: vi.fn().mockImplementation(function (input) {
+        return { input };
+    }),
+    GetObjectCommand: vi.fn().mockImplementation(function (input) {
+        return { input };
+    }),
+    ListObjectsV2Command: vi.fn().mockImplementation(function (input) {
+        return { input };
+    }),
+}));
+const SCOPE_ID = 'test-agent';
+describe('S3Storage', () => {
+    let storage;
+    let mockS3Client;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        storage = new S3Storage({ bucket: 'test-bucket', region: 'us-east-1' });
+        mockS3Client = storage._s3;
+    });
+    describe('constructor', () => {
+        describe('S3SnapshotStorage_When_ValidConfig_Then_CreatesInstance', () => {
+            it('stores bucket and region configuration', () => {
+                const instance = new S3Storage({ bucket: 'test-bucket', region: 'us-west-2' });
+                expect(instance._bucket).toBe('test-bucket');
+                expect(instance._s3).toBeDefined();
+            });
+            it('stores prefix when provided', () => {
+                const instance = new S3Storage({ bucket: 'test-bucket', prefix: 'my-prefix', region: 'us-east-1' });
+                expect(instance._prefix).toBe('my-prefix');
+            });
+            it('uses provided S3 client instead of creating new one', () => {
+                const customClient = { send: vi.fn() };
+                const instance = new S3Storage({ bucket: 'test-bucket', s3Client: customClient });
+                expect(instance._s3).toBe(customClient);
+            });
+            it('throws error when both s3Client and region are provided', () => {
+                const config = { bucket: 'test-bucket', region: 'us-west-2', s3Client: { send: vi.fn() } };
+                expect(() => new S3Storage(config)).toThrow(SessionError);
+                expect(() => new S3Storage(config)).toThrow('Cannot specify both s3Client and region');
+            });
+        });
+    });
+    describe('saveSnapshot', () => {
+        describe('S3SnapshotStorage_When_saveSnapshot_Then_PutsObjects', () => {
+            it('saves snapshot to S3 history', async () => {
+                const location = { sessionId: 'test-session', scope: createTestScope(), scopeId: SCOPE_ID };
+                const snapshot = createTestSnapshot();
+                mockS3Client.send.mockResolvedValue({});
+                await storage.saveSnapshot({ location, snapshotId: '1', isLatest: false, snapshot });
+                expect(mockS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: {
+                        Bucket: 'test-bucket',
+                        Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00001.json`,
+                        Body: JSON.stringify(snapshot, null, 2),
+                        ContentType: 'application/json',
+                    },
+                }));
+            });
+            it('saves snapshot as latest when isLatest is true', async () => {
+                const location = { sessionId: 'test-session', scope: createTestScope(), scopeId: SCOPE_ID };
+                const snapshot = createTestSnapshot();
+                mockS3Client.send.mockResolvedValue({});
+                await storage.saveSnapshot({ location, snapshotId: '1', isLatest: true, snapshot });
+                expect(mockS3Client.send).toHaveBeenCalledTimes(2);
+                expect(mockS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: expect.objectContaining({
+                        Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/snapshot_latest.json`,
+                    }),
+                }));
+            });
+            it('uses prefix when configured', async () => {
+                const storageWithPrefix = new S3Storage({ bucket: 'test-bucket', prefix: 'my-app', region: 'us-east-1' });
+                const mockPrefixS3Client = storageWithPrefix._s3;
+                const location = { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID };
+                const snapshot = createTestSnapshot();
+                mockPrefixS3Client.send.mockResolvedValue({});
+                await storageWithPrefix.saveSnapshot({ location, snapshotId: '1', isLatest: false, snapshot });
+                expect(mockPrefixS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: expect.objectContaining({
+                        Key: `my-app/test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00001.json`,
+                    }),
+                }));
+            });
+        });
+        describe('S3SnapshotStorage_When_saveSnapshotFails_Then_ThrowsSessionError', () => {
+            it('throws SessionError when S3 put fails', async () => {
+                const location = { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID };
+                const snapshot = createTestSnapshot();
+                mockS3Client.send.mockRejectedValue(new Error('S3 error'));
+                await expect(storage.saveSnapshot({ location, snapshotId: '1', isLatest: false, snapshot })).rejects.toThrow('Failed to write S3 object');
+            });
+        });
+        describe('S3SnapshotStorage_When_MultiAgentScope_Then_SavesCorrectly', () => {
+            it('saves multi-agent snapshot to correct S3 key', async () => {
+                const location = { sessionId: 'multi-session', scope: 'multiAgent', scopeId: 'graph-1' };
+                const snapshot = createTestSnapshot({ scope: 'multiAgent' });
+                mockS3Client.send.mockResolvedValue({});
+                await storage.saveSnapshot({ location, snapshotId: '1', isLatest: true, snapshot });
+                expect(mockS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: expect.objectContaining({
+                        Key: 'multi-session/scopes/multiAgent/graph-1/snapshots/snapshot_latest.json',
+                    }),
+                }));
+            });
+        });
+    });
+    describe('loadSnapshot', () => {
+        describe('S3SnapshotStorage_When_LoadLatestSnapshot_Then_ReturnsSnapshot', () => {
+            it('loads latest snapshot when snapshotId is undefined', async () => {
+                const location = { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID };
+                const snapshot = createTestSnapshot();
+                mockS3Client.send.mockResolvedValue({
+                    Body: { transformToString: () => Promise.resolve(JSON.stringify(snapshot)) },
+                });
+                const result = await storage.loadSnapshot({ location });
+                expect(result).toEqual(snapshot);
+                expect(mockS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: {
+                        Bucket: 'test-bucket',
+                        Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/snapshot_latest.json`,
+                    },
+                }));
+            });
+        });
+        describe('S3SnapshotStorage_When_LoadSpecificSnapshot_Then_ReturnsSnapshot', () => {
+            it('loads specific snapshot by ID', async () => {
+                const location = { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID };
+                const snapshot = createTestSnapshot();
+                mockS3Client.send.mockResolvedValue({
+                    Body: { transformToString: () => Promise.resolve(JSON.stringify(snapshot)) },
+                });
+                const result = await storage.loadSnapshot({ location, snapshotId: '5' });
+                expect(result).toEqual(snapshot);
+                expect(mockS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: expect.objectContaining({
+                        Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00005.json`,
+                    }),
+                }));
+            });
+        });
+        describe('S3SnapshotStorage_When_SnapshotNotFound_Then_ReturnsNull', () => {
+            it('returns null when S3 object does not exist', async () => {
+                const noSuchKeyError = Object.assign(new Error('NoSuchKey'), { name: 'NoSuchKey' });
+                mockS3Client.send.mockRejectedValue(noSuchKeyError);
+                const result = await storage.loadSnapshot({
+                    location: { sessionId: 'nonexistent', scope: 'agent', scopeId: SCOPE_ID },
+                });
+                expect(result).toBeNull();
+            });
+            it('returns null when S3 response has no body', async () => {
+                mockS3Client.send.mockResolvedValue({ Body: null });
+                const result = await storage.loadSnapshot({
+                    location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID },
+                });
+                expect(result).toBeNull();
+            });
+            it('returns null when S3 response body is empty', async () => {
+                mockS3Client.send.mockResolvedValue({ Body: { transformToString: () => Promise.resolve('') } });
+                const result = await storage.loadSnapshot({
+                    location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID },
+                });
+                expect(result).toBeNull();
+            });
+        });
+        describe('S3SnapshotStorage_When_InvalidJSON_Then_ThrowsSessionError', () => {
+            it('throws SessionError when JSON is invalid', async () => {
+                mockS3Client.send.mockResolvedValue({
+                    Body: { transformToString: () => Promise.resolve('invalid json') },
+                });
+                await expect(storage.loadSnapshot({ location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID } })).rejects.toThrow('Invalid JSON in S3 object');
+            });
+        });
+        describe('S3SnapshotStorage_When_S3Error_Then_ThrowsSessionError', () => {
+            it('throws SessionError when S3 get fails', async () => {
+                mockS3Client.send.mockRejectedValue(new Error('S3 error'));
+                await expect(storage.loadSnapshot({ location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID } })).rejects.toThrow('S3 error reading');
+            });
+        });
+    });
+    describe('listSnapshots', () => {
+        describe('S3SnapshotStorage_When_listSnapshots_Then_ReturnsOrderedIds', () => {
+            it('returns sorted snapshot IDs', async () => {
+                mockS3Client.send.mockResolvedValue({
+                    Contents: [
+                        { Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00003.json` },
+                        { Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00001.json` },
+                        { Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00002.json` },
+                    ],
+                });
+                const result = await storage.listSnapshotIds({
+                    location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID },
+                });
+                expect(result).toEqual(['1', '2', '3']);
+                expect(mockS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: {
+                        Bucket: 'test-bucket',
+                        Prefix: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/`,
+                    },
+                }));
+            });
+            it('returns empty array when no objects exist', async () => {
+                mockS3Client.send.mockResolvedValue({ Contents: [] });
+                const result = await storage.listSnapshotIds({
+                    location: { sessionId: 'empty-session', scope: 'agent', scopeId: SCOPE_ID },
+                });
+                expect(result).toEqual([]);
+            });
+            it('ignores non-snapshot objects', async () => {
+                mockS3Client.send.mockResolvedValue({
+                    Contents: [
+                        { Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00001.json` },
+                        { Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/other-file.txt` },
+                        { Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00002.json` },
+                    ],
+                });
+                const result = await storage.listSnapshotIds({
+                    location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID },
+                });
+                expect(result).toEqual(['1', '2']);
+            });
+            it('handles objects without Key property', async () => {
+                mockS3Client.send.mockResolvedValue({
+                    Contents: [
+                        { Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00001.json` },
+                        {},
+                        { Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/immutable_history/snapshot_00002.json` },
+                    ],
+                });
+                const result = await storage.listSnapshotIds({
+                    location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID },
+                });
+                expect(result).toEqual(['1', '2']);
+            });
+        });
+        describe('S3SnapshotStorage_When_ListObjectsFails_Then_ThrowsSessionError', () => {
+            it('throws SessionError when S3 list fails', async () => {
+                mockS3Client.send.mockRejectedValue(new Error('S3 list error'));
+                await expect(storage.listSnapshotIds({ location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID } })).rejects.toThrow('Failed to list snapshots for session test-session');
+            });
+        });
+    });
+    describe('loadManifest', () => {
+        describe('S3SnapshotStorage_When_LoadManifest_Then_ReturnsManifest', () => {
+            it('loads existing manifest', async () => {
+                const location = { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID };
+                const manifest = createTestManifest({ nextSnapshotId: '5' });
+                mockS3Client.send.mockResolvedValue({
+                    Body: { transformToString: () => Promise.resolve(JSON.stringify(manifest)) },
+                });
+                const result = await storage.loadManifest({ location });
+                expect(result).toEqual(manifest);
+                expect(mockS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: expect.objectContaining({
+                        Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/manifest.json`,
+                    }),
+                }));
+            });
+        });
+        describe('S3SnapshotStorage_When_ManifestNotFound_Then_ReturnsDefault', () => {
+            it('returns default manifest when S3 object does not exist', async () => {
+                const noSuchKeyError = Object.assign(new Error('NoSuchKey'), { name: 'NoSuchKey' });
+                mockS3Client.send.mockRejectedValue(noSuchKeyError);
+                const result = await storage.loadManifest({
+                    location: { sessionId: 'nonexistent', scope: 'agent', scopeId: SCOPE_ID },
+                });
+                expect(result).toEqual({
+                    schemaVersion: '1.0',
+                    nextSnapshotId: '1',
+                    updatedAt: expect.any(String),
+                });
+            });
+        });
+        describe('S3SnapshotStorage_When_InvalidManifestJSON_Then_ThrowsSessionError', () => {
+            it('throws SessionError when manifest JSON is invalid', async () => {
+                mockS3Client.send.mockResolvedValue({
+                    Body: { transformToString: () => Promise.resolve('invalid json') },
+                });
+                await expect(storage.loadManifest({ location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID } })).rejects.toThrow(SessionError);
+            });
+        });
+    });
+    describe('saveManifest', () => {
+        describe('S3SnapshotStorage_When_SaveManifest_Then_PutsObject', () => {
+            it('saves manifest to S3', async () => {
+                const location = { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID };
+                const manifest = createTestManifest({ nextSnapshotId: '10' });
+                mockS3Client.send.mockResolvedValue({});
+                await storage.saveManifest({ location, manifest });
+                expect(mockS3Client.send).toHaveBeenCalledWith(expect.objectContaining({
+                    input: {
+                        Bucket: 'test-bucket',
+                        Key: `test-session/scopes/agent/${SCOPE_ID}/snapshots/manifest.json`,
+                        Body: JSON.stringify(manifest, null, 2),
+                        ContentType: 'application/json',
+                    },
+                }));
+            });
+        });
+        describe('S3SnapshotStorage_When_SaveManifestFails_Then_ThrowsSessionError', () => {
+            it('throws SessionError when S3 put fails', async () => {
+                mockS3Client.send.mockRejectedValue(new Error('S3 error'));
+                await expect(storage.saveManifest({
+                    location: { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID },
+                    manifest: createTestManifest(),
+                })).rejects.toThrow(SessionError);
+            });
+        });
+    });
+    describe('edge cases', () => {
+        describe('S3SnapshotStorage_When_InvalidIdentifiers_Then_ThrowsError', () => {
+            it('throws error for invalid session ID', async () => {
+                const snapshot = createTestSnapshot();
+                await expect(storage.saveSnapshot({
+                    location: { sessionId: 'invalid/session', scope: 'agent', scopeId: SCOPE_ID },
+                    snapshotId: '1',
+                    isLatest: false,
+                    snapshot,
+                })).rejects.toThrow();
+            });
+            it('throws error for invalid scopeId', async () => {
+                const snapshot = createTestSnapshot();
+                await expect(storage.saveSnapshot({
+                    location: { sessionId: 'test-session', scope: 'agent', scopeId: 'invalid/agent' },
+                    snapshotId: '1',
+                    isLatest: false,
+                    snapshot,
+                })).rejects.toThrow();
+            });
+        });
+        describe('S3SnapshotStorage_When_SpecialCharacters_Then_HandlesCorrectly', () => {
+            it('handles special characters in snapshot data', async () => {
+                const location = { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID };
+                const specialData = { emoji: '🚀', unicode: 'café', quotes: '"test"' };
+                const snapshot = createTestSnapshot({
+                    data: { messages: [], state: specialData, systemPrompt: null },
+                });
+                mockS3Client.send
+                    .mockResolvedValueOnce({})
+                    .mockResolvedValueOnce({})
+                    .mockResolvedValueOnce({ Body: { transformToString: () => Promise.resolve(JSON.stringify(snapshot)) } });
+                await storage.saveSnapshot({ location, snapshotId: '1', isLatest: true, snapshot });
+                const result = await storage.loadSnapshot({ location });
+                expect(result?.data.state).toEqual(specialData);
+            });
+        });
+        describe('S3SnapshotStorage_When_LargeSnapshot_Then_HandlesCorrectly', () => {
+            it('handles large snapshots', async () => {
+                const location = { sessionId: 'test-session', scope: 'agent', scopeId: SCOPE_ID };
+                const largeState = { data: 'x'.repeat(10000) };
+                const snapshot = createTestSnapshot({
+                    data: { messages: [], state: largeState, systemPrompt: null },
+                });
+                mockS3Client.send
+                    .mockResolvedValueOnce({})
+                    .mockResolvedValueOnce({})
+                    .mockResolvedValueOnce({ Body: { transformToString: () => Promise.resolve(JSON.stringify(snapshot)) } });
+                await storage.saveSnapshot({ location, snapshotId: '1', isLatest: true, snapshot });
+                const result = await storage.loadSnapshot({ location });
+                expect(result?.data.state).toEqual(largeState);
+            });
+        });
+    });
+});
+//# sourceMappingURL=s3-storage.test.node.js.map

package/dist/src/session/__tests__/s3-storage.test.node.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/validation.test.ts"],"names":[],"mappings":""}

package/dist/src/session/__tests__/validation.test.js

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { validateIdentifier } from '../validation.js';
+describe('validateIdentifier', () => {
+    describe('when identifier is valid', () => {
+        it('returns the identifier', () => {
+            expect(validateIdentifier('valid-id')).toBe('valid-id');
+        });
+    });
+    describe('when identifier contains forward slash', () => {
+        it('throws error', () => {
+            expect(() => validateIdentifier('invalid/id')).toThrow("Identifier 'invalid/id' can only contain lowercase letters, numbers, hyphens, and underscores");
+        });
+    });
+    describe('when identifier contains backslash', () => {
+        it('throws error', () => {
+            expect(() => validateIdentifier('invalid\\id')).toThrow("Identifier 'invalid\\id' can only contain lowercase letters, numbers, hyphens, and underscores");
+        });
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/src/session/__tests__/validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../../../src/session/__tests__/validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACzD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;QACtD,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CACpD,+FAA+F,CAChG,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAClD,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CACrD,gGAAgG,CACjG,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,79 @@
+import type { SnapshotStorage, SnapshotLocation } from './storage.js';
+import type { Snapshot, SnapshotManifest } from './types.js';
+/**
+ * File-based implementation of SnapshotStorage for persisting session snapshots
+ */
+export declare class FileStorage implements SnapshotStorage {
+    /** Base directory path */
+    private readonly _baseDir;
+    /**
+     * Creates new FileStorage instance
+     * @param baseDir - Base directory path for storing snapshots
+     */
+    constructor(baseDir: string);
+    /**
+     * Generates file path for session scope snapshots
+     */
+    private _getPath;
+    /**
+     * Saves snapshot to file, optionally marking as latest
+     */
+    saveSnapshot(params: {
+        location: SnapshotLocation;
+        snapshotId: string;
+        isLatest: boolean;
+        snapshot: Snapshot;
+    }): Promise<void>;
+    /**
+     * Loads snapshot by ID or latest if null
+     */
+    loadSnapshot(params: {
+        location: SnapshotLocation;
+        snapshotId?: string;
+    }): Promise<Snapshot | null>;
+    /**
+     * Checks if an error is a file not found error (ENOENT)
+     */
+    private _isFileNotFoundError;
+    /**
+     * 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 }>
+     * ```
+     */
+    listSnapshotIds(params: {
+        location: SnapshotLocation;
+    }): Promise<string[]>;
+    /**
+     * Loads manifest or returns default if not found
+     */
+    loadManifest(params: {
+        location: SnapshotLocation;
+    }): Promise<SnapshotManifest>;
+    /**
+     * Saves manifest to file
+     */
+    saveManifest(params: {
+        location: SnapshotLocation;
+        manifest: SnapshotManifest;
+    }): Promise<void>;
+    /**
+     * Writes JSON data to file atomically
+     */
+    private _writeJSON;
+    /**
+     * Reads and parses JSON from file
+     */
+    private _readJSON;
+    private _getLatestSnapshotPath;
+    private _getHistorySnapshotPath;
+}
+//# sourceMappingURL=file-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../../../src/session/file-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAY5D;;GAEG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,0BAA0B;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IAEjC;;;OAGG;gBACS,OAAO,EAAE,MAAM;IAI3B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAMhB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,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;IAOjB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAQzG;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;;;;;;;;;;;OAaG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBhF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAarF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrG;;OAEG;YACW,UAAU;IAWxB;;OAEG;YACW,SAAS;IAevB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,uBAAuB;CAGhC"}