@strands-agents/sdk 0.5.0 → 0.7.0

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

@@ -0,0 +1,443 @@
+import { describe, expect, it, beforeEach, vi } from 'vitest';
+import { SessionManager } from '../session-manager.js';
+import { MockSnapshotStorage, createTestSnapshot } from '../../__fixtures__/mock-storage-provider.js';
+import { InitializedEvent, MessageAddedEvent, AfterInvocationEvent, AfterModelCallEvent, HookableEvent, } from '../../hooks/index.js';
+import { Agent } from '../../agent/agent.js';
+import { Message, TextBlock } from '../../types/messages.js';
+import { createMockAgent as createMockAgentWithHooks, invokeTrackedHook } from '../../__fixtures__/agent-helpers.js';
+import { loadStateFromJSONSymbol, stateToJSONSymbol } from '../../types/serializable.js';
+// Test fixtures
+function createMockAgent(id = 'agent') {
+    const agent = {
+        id,
+        messages: [],
+        appState: {
+            _m: new Map(),
+            get(k) {
+                return this._m.get(k);
+            },
+            set(k, v) {
+                this._m.set(k, v);
+            },
+            [stateToJSONSymbol]() {
+                return Object.fromEntries(this._m);
+            },
+            [loadStateFromJSONSymbol](json) {
+                Object.entries(json).forEach(([k, v]) => this._m.set(k, v));
+            },
+        },
+        systemPrompt: 'Test prompt',
+    };
+    return agent;
+}
+const MOCK_MESSAGE = new Message({ role: 'user', content: [new TextBlock('test')] });
+function createMockEvent(agent) {
+    return { agent };
+}
+function createMockMessageEvent(agent) {
+    return { agent, message: MOCK_MESSAGE };
+}
+async function initPluginAndInvokeHook(sessionManager, event) {
+    const pluginAgent = createMockAgentWithHooks();
+    sessionManager.initAgent(pluginAgent);
+    await invokeTrackedHook(pluginAgent, event);
+}
+describe('SessionManager', () => {
+    let storage;
+    let sessionManager;
+    let mockAgent;
+    beforeEach(() => {
+        storage = new MockSnapshotStorage();
+        mockAgent = createMockAgent();
+    });
+    describe('constructor', () => {
+        it('defaults saveLatestOn to invocation', async () => {
+            sessionManager = new SessionManager({ sessionId: 'test-default', storage: { snapshot: storage } });
+            await initPluginAndInvokeHook(sessionManager, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-default', scope: 'agent', scopeId: 'agent' },
+            });
+            expect(snapshot).not.toBeNull();
+        });
+    });
+    describe('saveSnapshot', () => {
+        beforeEach(() => {
+            mockAgent = createMockAgent('test-agent');
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+            });
+        });
+        it('saves snapshot_latest when isLatest is true', async () => {
+            await sessionManager.saveSnapshot({ target: mockAgent, isLatest: true });
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(snapshot).not.toBeNull();
+            expect(snapshot?.scope).toBe('agent');
+        });
+        it('saves immutable snapshot when isLatest is false', async () => {
+            await sessionManager.saveSnapshot({ target: mockAgent, isLatest: false });
+            const ids = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(ids.length).toBeGreaterThan(0);
+        });
+        it('allocates unique snapshot IDs', async () => {
+            await sessionManager.saveSnapshot({ target: mockAgent, isLatest: false });
+            await sessionManager.saveSnapshot({ target: mockAgent, isLatest: false });
+            await sessionManager.saveSnapshot({ target: mockAgent, isLatest: false });
+            const ids = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(ids.length).toBe(3);
+        });
+    });
+    describe('restoreSnapshot', () => {
+        beforeEach(() => {
+            mockAgent = createMockAgent('test-agent');
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+            });
+        });
+        it('restores snapshot_latest when no snapshotId provided', async () => {
+            const snapshot = createTestSnapshot();
+            await storage.saveSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+                snapshotId: 'latest',
+                isLatest: true,
+                snapshot,
+            });
+            const result = await sessionManager.restoreSnapshot({ target: mockAgent });
+            expect(result).toBe(true);
+        });
+        it('restores specific snapshot by ID', async () => {
+            const snapshot = createTestSnapshot();
+            await storage.saveSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+                snapshotId: '5',
+                isLatest: false,
+                snapshot,
+            });
+            const result = await sessionManager.restoreSnapshot({ target: mockAgent, snapshotId: '5' });
+            expect(result).toBe(true);
+        });
+        it('returns false when snapshot not found', async () => {
+            const result = await sessionManager.restoreSnapshot({ target: mockAgent, snapshotId: '999' });
+            expect(result).toBe(false);
+        });
+    });
+    describe('InitializedEvent handling', () => {
+        beforeEach(() => {
+            mockAgent = createMockAgent('test-agent');
+        });
+        it('loads snapshot_latest on initialization', async () => {
+            const snapshot = createTestSnapshot();
+            await storage.saveSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+                snapshotId: 'latest',
+                isLatest: true,
+                snapshot,
+            });
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+            });
+            await initPluginAndInvokeHook(sessionManager, new InitializedEvent(createMockEvent(mockAgent)));
+            expect(mockAgent.messages).toEqual(snapshot.data.messages);
+        });
+        it('handles missing snapshot gracefully', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'new-session',
+                storage: { snapshot: storage },
+            });
+            await expect(initPluginAndInvokeHook(sessionManager, new InitializedEvent(createMockEvent(mockAgent)))).resolves.not.toThrow();
+        });
+    });
+    describe('MessageAddedEvent handling', () => {
+        beforeEach(() => {
+            mockAgent = createMockAgent('test-agent');
+        });
+        it('saves snapshot_latest when saveLatestOn is message', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'message',
+            });
+            await initPluginAndInvokeHook(sessionManager, new MessageAddedEvent(createMockMessageEvent(mockAgent)));
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(snapshot).not.toBeNull();
+        });
+        it('does not save when saveLatestOn is invocation', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'invocation',
+            });
+            // MessageAddedEvent is not registered when saveLatestOn is 'invocation'
+            // So we need to call initAgent and check that no hook is registered for MessageAddedEvent
+            const pluginAgent = createMockAgentWithHooks();
+            sessionManager.initAgent(pluginAgent);
+            // Verify MessageAddedEvent hook is not registered
+            const messageHook = pluginAgent.trackedHooks.find((h) => h.eventType === MessageAddedEvent);
+            expect(messageHook).toBeUndefined();
+            // Even if we try to invoke (nothing should happen)
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(snapshot).toBeNull();
+        });
+    });
+    describe('AfterInvocationEvent handling', () => {
+        beforeEach(() => {
+            mockAgent = createMockAgent('test-agent');
+        });
+        it('saves snapshot_latest when saveLatestOn is invocation', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'invocation',
+            });
+            await initPluginAndInvokeHook(sessionManager, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(snapshot).not.toBeNull();
+        });
+        it('does not save snapshot_latest when saveLatestOn is trigger', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'trigger',
+            });
+            await initPluginAndInvokeHook(sessionManager, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(snapshot).toBeNull();
+        });
+    });
+    describe('snapshotTrigger', () => {
+        beforeEach(() => {
+            mockAgent = createMockAgent('test-agent');
+        });
+        it('creates immutable snapshot when trigger returns true', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'trigger',
+                snapshotTrigger: () => true,
+            });
+            await initPluginAndInvokeHook(sessionManager, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const ids = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(ids.length).toBe(1);
+        });
+        it('does not create immutable snapshot when trigger returns false', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'trigger',
+                snapshotTrigger: () => false,
+            });
+            await initPluginAndInvokeHook(sessionManager, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const ids = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(ids.length).toBe(0);
+        });
+        it('provides agentData to trigger', async () => {
+            const triggerSpy = vi.fn(() => false);
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'trigger',
+                snapshotTrigger: triggerSpy,
+            });
+            await initPluginAndInvokeHook(sessionManager, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            expect(triggerSpy).toHaveBeenCalledWith(expect.objectContaining({
+                agentData: expect.objectContaining({
+                    appState: mockAgent.appState,
+                    messages: mockAgent.messages,
+                }),
+            }));
+        });
+        it('saves both immutable and latest when trigger fires', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'trigger',
+                snapshotTrigger: () => true,
+            });
+            await initPluginAndInvokeHook(sessionManager, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const immutableIds = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            const latest = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(immutableIds.length).toBe(1);
+            expect(latest).not.toBeNull();
+        });
+        it('trigger based on message count via agentData', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'trigger',
+                snapshotTrigger: ({ agentData }) => agentData.messages.length >= 2,
+            });
+            const pluginAgent = createMockAgentWithHooks();
+            sessionManager.initAgent(pluginAgent);
+            await invokeTrackedHook(pluginAgent, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            let ids = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(ids.length).toBe(0); // 0 messages — no snapshot
+            mockAgent.messages.push(MOCK_MESSAGE, MOCK_MESSAGE);
+            await invokeTrackedHook(pluginAgent, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            ids = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(ids.length).toBe(1); // 2 messages — snapshot taken
+        });
+        it('trigger based on agent state via agentData', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'trigger',
+                snapshotTrigger: ({ agentData }) => agentData.appState.get('checkpoint') === true,
+            });
+            const pluginAgent = createMockAgentWithHooks();
+            sessionManager.initAgent(pluginAgent);
+            await invokeTrackedHook(pluginAgent, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            let ids = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(ids.length).toBe(0); // state not set — no snapshot
+            mockAgent.appState.set('checkpoint', true);
+            await invokeTrackedHook(pluginAgent, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            ids = await storage.listSnapshotIds({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(ids.length).toBe(1); // state set — snapshot taken
+        });
+    });
+    describe('integration scenarios', () => {
+        it('handles complete session lifecycle', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'lifecycle-test',
+                storage: { snapshot: storage },
+                saveLatestOn: 'invocation',
+                snapshotTrigger: () => true,
+            });
+            const pluginAgent = createMockAgentWithHooks();
+            sessionManager.initAgent(pluginAgent);
+            await invokeTrackedHook(pluginAgent, new InitializedEvent(createMockEvent(mockAgent)));
+            await invokeTrackedHook(pluginAgent, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            await invokeTrackedHook(pluginAgent, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            await invokeTrackedHook(pluginAgent, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const latest = await storage.loadSnapshot({
+                location: { sessionId: 'lifecycle-test', scope: 'agent', scopeId: 'agent' },
+            });
+            const immutableIds = await storage.listSnapshotIds({
+                location: { sessionId: 'lifecycle-test', scope: 'agent', scopeId: 'agent' },
+            });
+            expect(latest).not.toBeNull();
+            expect(immutableIds.length).toBe(3);
+        });
+        it('supports resuming from immutable snapshot', async () => {
+            // First session - snapshot fires when messages.length === 2 (after turn 1)
+            sessionManager = new SessionManager({
+                sessionId: 'resume-test',
+                storage: { snapshot: storage },
+                saveLatestOn: 'trigger',
+                snapshotTrigger: ({ agentData }) => agentData.messages.length === 2,
+            });
+            const pluginAgent = createMockAgentWithHooks();
+            sessionManager.initAgent(pluginAgent);
+            await invokeTrackedHook(pluginAgent, new InitializedEvent(createMockEvent(mockAgent)));
+            mockAgent.messages.push(MOCK_MESSAGE, MOCK_MESSAGE);
+            await invokeTrackedHook(pluginAgent, new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const ids = await storage.listSnapshotIds({
+                location: { sessionId: 'resume-test', scope: 'agent', scopeId: 'agent' },
+            });
+            expect(ids.length).toBe(1);
+            // Second session - resume from that snapshot
+            const newAgent = createMockAgent();
+            const newSessionManager = new SessionManager({
+                sessionId: 'resume-test',
+                storage: { snapshot: storage },
+                saveLatestOn: 'invocation',
+            });
+            const newAgentData = createMockAgentWithHooks();
+            newSessionManager.initAgent(newAgentData);
+            await invokeTrackedHook(newAgentData, new InitializedEvent(createMockEvent(newAgent)));
+            await newSessionManager.restoreSnapshot({ target: newAgent, snapshotId: ids[0] });
+            expect(newAgent.messages).toEqual(mockAgent.messages);
+        });
+    });
+    describe('AfterModelCallEvent with redaction handling', () => {
+        beforeEach(() => {
+            mockAgent = createMockAgent('test-agent');
+        });
+        it('saves snapshot_latest when saveLatestOn is message and redaction occurred', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'message',
+            });
+            const assistantMessage = new Message({ role: 'assistant', content: [new TextBlock('Response')] });
+            const event = new AfterModelCallEvent({
+                agent: mockAgent,
+                stopData: {
+                    message: assistantMessage,
+                    stopReason: 'endTurn',
+                    redaction: { userMessage: '[User input redacted.]' },
+                },
+            });
+            await initPluginAndInvokeHook(sessionManager, event);
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(snapshot).not.toBeNull();
+        });
+        it('does not save when saveLatestOn is message but no redaction occurred', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'message',
+            });
+            const assistantMessage = new Message({ role: 'assistant', content: [new TextBlock('Response')] });
+            const event = new AfterModelCallEvent({
+                agent: mockAgent,
+                stopData: { message: assistantMessage, stopReason: 'endTurn' },
+            });
+            await initPluginAndInvokeHook(sessionManager, event);
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(snapshot).toBeNull();
+        });
+        it('does not save when saveLatestOn is invocation', async () => {
+            sessionManager = new SessionManager({
+                sessionId: 'test-session',
+                storage: { snapshot: storage },
+                saveLatestOn: 'invocation',
+            });
+            // AfterModelCallEvent hook is not registered when saveLatestOn is 'invocation'
+            const pluginAgent = createMockAgentWithHooks();
+            sessionManager.initAgent(pluginAgent);
+            const afterModelHook = pluginAgent.trackedHooks.find((h) => h.eventType === AfterModelCallEvent);
+            expect(afterModelHook).toBeUndefined();
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-session', scope: 'agent', scopeId: 'test-agent' },
+            });
+            expect(snapshot).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=session-manager.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.test.js","sourceRoot":"","sources":["../../../../src/session/__tests__/session-manager.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAA;AACrG,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,eAAe,IAAI,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AACpH,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAExF,gBAAgB;AAChB,SAAS,eAAe,CAAC,EAAE,GAAG,OAAO;IACnC,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE;YACR,EAAE,EAAE,IAAI,GAAG,EAAE;YACb,GAAG,CAAC,CAAS;gBACX,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YACvB,CAAC;YACD,GAAG,CAAC,CAAS,EAAE,CAAU;gBACvB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YACnB,CAAC;YACD,CAAC,iBAAiB,CAAC;gBACjB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACpC,CAAC;YACD,CAAC,uBAAuB,CAAC,CAAC,IAA6B;gBACrD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC;SACK;QACR,YAAY,EAAE,aAAa;KACR,CAAA;IACrB,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAA;AAEpF,SAAS,eAAe,CAAC,KAAY;IACnC,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAY;IAC1C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;AACzC,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,cAA8B,EAC9B,KAAQ;IAER,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAA;IAC9C,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACrC,MAAM,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;AAC7C,CAAC;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,OAA4B,CAAA;IAChC,IAAI,cAA8B,CAAA;IAClC,IAAI,SAAgB,CAAA;IAEpB,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,IAAI,mBAAmB,EAAE,CAAA;QACnC,SAAS,GAAG,eAAe,EAAE,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA;YAElG,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAEnG,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;aAC1E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QACjC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,UAAU,CAAC,GAAG,EAAE;YACd,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;YACzC,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;aAC/B,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YAExE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;YAC/B,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACvC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YAC/D,MAAM,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;YAEzE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACxC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QACvC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;YACzE,MAAM,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;YACzE,MAAM,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;YAEzE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACxC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,UAAU,CAAC,GAAG,EAAE;YACd,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;YACzC,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;aAC/B,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;YACrC,MAAM,OAAO,CAAC,YAAY,CAAC;gBACzB,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;gBAC9E,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,IAAI;gBACd,QAAQ;aACT,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;YAE1E,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;YACrC,MAAM,OAAO,CAAC,YAAY,CAAC;gBACzB,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;gBAC9E,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE,KAAK;gBACf,QAAQ;aACT,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAA;YAE3F,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;YAE7F,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,UAAU,CAAC,GAAG,EAAE;YACd,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;YACrC,MAAM,OAAO,CAAC,YAAY,CAAC;gBACzB,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;gBAC9E,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,IAAI;gBACd,QAAQ;aACT,CAAC,CAAA;YAEF,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;aAC/B,CAAC,CAAA;YAEF,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,gBAAgB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAE/F,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,aAAa;gBACxB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;aAC/B,CAAC,CAAA;YAEF,MAAM,MAAM,CACV,uBAAuB,CAAC,cAAc,EAAE,IAAI,gBAAgB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAC1F,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,UAAU,CAAC,GAAG,EAAE;YACd,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;aACxB,CAAC,CAAA;YAEF,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,iBAAiB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAEvG,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QACjC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,YAAY;aAC3B,CAAC,CAAA;YAEF,wEAAwE;YACxE,0FAA0F;YAC1F,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAA;YAC9C,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;YAErC,kDAAkD;YAClD,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,iBAAiB,CAAC,CAAA;YAC3F,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAA;YAEnC,mDAAmD;YACnD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,UAAU,CAAC,GAAG,EAAE;YACd,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YACrE,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,YAAY;aAC3B,CAAC,CAAA;YAEF,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAEnG,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QACjC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;YAC1E,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;aACxB,CAAC,CAAA;YAEF,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAEnG,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,UAAU,CAAC,GAAG,EAAE;YACd,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;gBACvB,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;aAC5B,CAAC,CAAA;YAEF,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAEnG,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACxC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;YAC7E,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;gBACvB,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK;aAC7B,CAAC,CAAA;YAEF,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAEnG,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACxC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;YACrC,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;gBACvB,eAAe,EAAE,UAAU;aAC5B,CAAC,CAAA;YAEF,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAEnG,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACrC,MAAM,CAAC,gBAAgB,CAAC;gBACtB,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC;oBACjC,QAAQ,EAAE,SAAS,CAAC,QAAQ;oBAC5B,QAAQ,EAAE,SAAS,CAAC,QAAQ;iBAC7B,CAAC;aACH,CAAC,CACH,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;gBACvB,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;aAC5B,CAAC,CAAA;YAEF,MAAM,uBAAuB,CAAC,cAAc,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAEnG,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACjD,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBACxC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YAEF,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC/B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;gBACvB,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC;aACnE,CAAC,CAAA;YAEF,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAA;YAC9C,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;YAErC,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC1F,IAAI,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACtC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA,CAAC,2BAA2B;YAEtD,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;YACnD,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC1F,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBAClC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA,CAAC,8BAA8B;QAC3D,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;gBACvB,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAE,SAAS,CAAC,QAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI;aAC3F,CAAC,CAAA;YAEF,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAA;YAC9C,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;YAErC,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC1F,IAAI,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACtC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA,CAAC,8BAA8B;YAEzD,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;YAC1C,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC1F,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBAClC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA,CAAC,6BAA6B;QAC1D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,gBAAgB;gBAC3B,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,YAAY;gBAC1B,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;aAC5B,CAAC,CAAA;YAEF,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAA;YAC9C,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;YAErC,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,gBAAgB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YACtF,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC1F,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC1F,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAE1F,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBACxC,QAAQ,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;aAC5E,CAAC,CAAA;YACF,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACjD,QAAQ,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;aAC5E,CAAC,CAAA;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;YAC7B,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,2EAA2E;YAC3E,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,aAAa;gBACxB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;gBACvB,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;aACpE,CAAC,CAAA;YAEF,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAA;YAC9C,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;YAErC,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,gBAAgB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YACtF,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;YACnD,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAE1F,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;gBACxC,QAAQ,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;aACzE,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAE1B,6CAA6C;YAC7C,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAA;YAClC,MAAM,iBAAiB,GAAG,IAAI,cAAc,CAAC;gBAC3C,SAAS,EAAE,aAAa;gBACxB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,YAAY;aAC3B,CAAC,CAAA;YAEF,MAAM,YAAY,GAAG,wBAAwB,EAAE,CAAA;YAC/C,iBAAiB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;YAEzC,MAAM,iBAAiB,CAAC,YAAY,EAAE,IAAI,gBAAgB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YACtF,MAAM,iBAAiB,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAE,EAAE,CAAC,CAAA;YAElF,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACvD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;QAC3D,UAAU,CAAC,GAAG,EAAE;YACd,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;YACzF,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;aACxB,CAAC,CAAA;YAEF,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAA;YACjG,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC;gBACpC,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE;oBACR,OAAO,EAAE,gBAAgB;oBACzB,UAAU,EAAE,SAAkB;oBAC9B,SAAS,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE;iBACrD;aACK,CAAC,CAAA;YAET,MAAM,uBAAuB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;YAEpD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QACjC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;YACpF,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,SAAS;aACxB,CAAC,CAAA;YAEF,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAA;YACjG,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC;gBACpC,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAkB,EAAE;aACjE,CAAC,CAAA;YAET,MAAM,uBAAuB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;YAEpD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAA;QAC7B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,cAAc,GAAG,IAAI,cAAc,CAAC;gBAClC,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC9B,YAAY,EAAE,YAAY;aAC3B,CAAC,CAAA;YAEF,+EAA+E;YAC/E,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAA;YAC9C,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;YACrC,MAAM,cAAc,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,mBAAmB,CAAC,CAAA;YAChG,MAAM,CAAC,cAAc,CAAC,CAAC,aAAa,EAAE,CAAA;YAEtC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;gBAC1C,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;aAC/E,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { validateIdentifier } from '../validation.js';
+import { validateIdentifier, validateUuidV7 } from '../validation.js';
 describe('validateIdentifier', () => {
     describe('when identifier is valid', () => {
         it('returns the identifier', () => {
@@ -17,4 +17,31 @@ describe('validateIdentifier', () => {
         });
     });
 });
+describe('validateUuidV7', () => {
+    describe('when id is a valid UUID v7', () => {
+        it('does not throw', () => {
+            expect(() => validateUuidV7('01956891-2b4c-7000-8abc-123456789abc')).not.toThrow();
+        });
+    });
+    describe('when id is a UUID v4 (wrong version)', () => {
+        it('throws error', () => {
+            expect(() => validateUuidV7('550e8400-e29b-41d4-a716-446655440000')).toThrow("'550e8400-e29b-41d4-a716-446655440000' is not a valid UUID v7 snapshot ID");
+        });
+    });
+    describe('when id is a timestamp string', () => {
+        it('throws error', () => {
+            expect(() => validateUuidV7('2025-01-15T10:30:00Z')).toThrow("'2025-01-15T10:30:00Z' is not a valid UUID v7 snapshot ID");
+        });
+    });
+    describe('when id contains path traversal', () => {
+        it('throws error', () => {
+            expect(() => validateUuidV7('../evil')).toThrow("'../evil' is not a valid UUID v7 snapshot ID");
+        });
+    });
+    describe('when id is empty string', () => {
+        it('throws error', () => {
+            expect(() => validateUuidV7('')).toThrow("'' is not a valid UUID v7 snapshot ID");
+        });
+    });
+});
 //# sourceMappingURL=validation.test.js.map

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

@@ -1 +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"}
+{"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,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAErE,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;AAEF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;YACxB,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,sCAAsC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QACpF,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;QACpD,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,sCAAsC,CAAC,CAAC,CAAC,OAAO,CAC1E,2EAA2E,CAC5E,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAC1D,2DAA2D,CAC5D,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC/C,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAA;QACjG,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAA;QACnF,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -1,22 +1,38 @@
 import type { SnapshotStorage, SnapshotLocation } from './storage.js';
 import type { Snapshot, SnapshotManifest } from './types.js';
 /**
- * File-based implementation of SnapshotStorage for persisting session snapshots
+ * File-based implementation of SnapshotStorage.
+ * Persists session snapshots to the local filesystem under a configurable base directory.
+ *
+ * Directory layout:
+ * ```
+ * <baseDir>/<sessionId>/scopes/<scope>/<scopeId>/snapshots/
+ *   snapshot_latest.json
+ *   immutable_history/
+ *     snapshot_<uuid7>.json
+ * ```
  */
 export declare class FileStorage implements SnapshotStorage {
-    /** Base directory path */
+    /** Absolute path to the root directory where all session data is stored. */
     private readonly _baseDir;
     /**
-     * Creates new FileStorage instance
-     * @param baseDir - Base directory path for storing snapshots
+     * @param baseDir - Absolute path to the root directory for storing session snapshots.
      */
     constructor(baseDir: string);
     /**
-     * Generates file path for session scope snapshots
+     * Resolves the absolute file path for a given scope location and filename.
+     * Validates sessionId and scopeId before constructing the path.
      */
     private _getPath;
     /**
-     * Saves snapshot to file, optionally marking as latest
+     * Resolves the absolute path to the root directory for a session.
+     * Used by deleteSession to remove all data under `<baseDir>/<sessionId>/`.
+     */
+    private _getSessionDir;
+    /**
+     * Persists a snapshot to disk.
+     * If `isLatest` is true, writes to `snapshot_latest.json` (overwriting any previous).
+     * Otherwise, writes to `immutable_history/snapshot_<snapshotId>.json`.
      */
     saveSnapshot(params: {
         location: SnapshotLocation;
@@ -25,55 +41,65 @@ export declare class FileStorage implements SnapshotStorage {
         snapshot: Snapshot;
     }): Promise<void>;
     /**
-     * Loads snapshot by ID or latest if null
+     * Loads a snapshot from disk.
+     * If `snapshotId` is omitted, loads `snapshot_latest.json`.
+     * Returns null if the file does not exist.
      */
     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 }>
-     * ```
+     * Lists immutable snapshot IDs for a scope, sorted chronologically.
+     * Since IDs are UUID v7, lexicographic sort equals chronological order.
+     * `startAfter` filters to IDs after the given UUID v7 (exclusive cursor).
+     * `limit` caps the number of returned IDs.
+     * Returns an empty array if no snapshots exist yet.
      */
     listSnapshotIds(params: {
         location: SnapshotLocation;
+        limit?: number;
+        startAfter?: string;
     }): Promise<string[]>;
     /**
-     * Loads manifest or returns default if not found
+     * Deletes all data for a session by removing its root directory (`<baseDir>/<sessionId>/`) recursively.
+     * No-ops if the session directory does not exist.
+     */
+    deleteSession(params: {
+        sessionId: string;
+    }): Promise<void>;
+    /**
+     * Loads the snapshot manifest for a scope.
+     * Returns a default manifest with the current timestamp if none exists yet.
      */
     loadManifest(params: {
         location: SnapshotLocation;
     }): Promise<SnapshotManifest>;
     /**
-     * Saves manifest to file
+     * Persists the snapshot manifest for a scope to disk.
      */
     saveManifest(params: {
         location: SnapshotLocation;
         manifest: SnapshotManifest;
     }): Promise<void>;
     /**
-     * Writes JSON data to file atomically
+     * Atomically writes JSON to a file using a `.tmp` intermediary to prevent partial writes.
+     * Creates parent directories if they do not exist.
      */
     private _writeJSON;
     /**
-     * Reads and parses JSON from file
+     * Reads and parses a JSON file. Returns null if the file does not exist.
+     * Throws SessionError on parse failure or unexpected filesystem errors.
      */
     private _readJSON;
+    /** Returns true if the error represents a missing file or directory (ENOENT). */
+    private _isFileNotFoundError;
+    /** Returns the file path for `snapshot_latest.json` within the given scope. */
     private _getLatestSnapshotPath;
+    /**
+     * Returns the file path for an immutable snapshot in `immutable_history/`.
+     * Validates the snapshotId and guards against path traversal outside `_baseDir`.
+     */
     private _getHistorySnapshotPath;
 }
 //# sourceMappingURL=file-storage.d.ts.map