@strands-agents/sdk 0.4.0 → 0.6.0

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

@@ -0,0 +1,461 @@
+import { describe, expect, it, beforeEach, vi } from 'vitest';
+import { SessionManager } from '../session-manager.js';
+import { MockSnapshotStorage, createTestSnapshot } from '../../__fixtures__/mock-storage-provider.js';
+import { HookRegistry, InitializedEvent, MessageAddedEvent, AfterModelCallEvent, AfterInvocationEvent, } from '../../hooks/index.js';
+import { Agent } from '../../agent/agent.js';
+import { Message, TextBlock } from '../../types/messages.js';
+// Test fixtures
+function createMockAgent(agentId = 'default') {
+    const agent = {
+        agentId,
+        messages: [],
+        state: {
+            _m: new Map(),
+            get(k) {
+                return this._m.get(k);
+            },
+            set(k, v) {
+                this._m.set(k, v);
+            },
+            toJSON() {
+                return Object.fromEntries(this._m);
+            },
+            loadStateFromJson(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 };
+}
+describe('SessionManager', () => {
+    let storage;
+    let sessionManager;
+    let registry;
+    let mockAgent;
+    beforeEach(() => {
+        storage = new MockSnapshotStorage();
+        mockAgent = createMockAgent();
+        registry = new HookRegistry();
+    });
+    describe('constructor', () => {
+        it('defaults saveLatestOn to invocation', async () => {
+            sessionManager = new SessionManager({ sessionId: 'test-default', storage: { snapshot: storage } });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const snapshot = await storage.loadSnapshot({
+                location: { sessionId: 'test-default', scope: 'agent', scopeId: 'default' },
+            });
+            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 },
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(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 },
+            });
+            sessionManager.registerCallbacks(registry);
+            await expect(registry.invokeCallbacks(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',
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(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',
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new MessageAddedEvent(createMockMessageEvent(mockAgent)));
+            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',
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(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',
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(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,
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(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,
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(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,
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(new AfterInvocationEvent(createMockEvent(mockAgent)));
+            expect(triggerSpy).toHaveBeenCalledWith(expect.objectContaining({
+                agentData: {
+                    state: mockAgent.state,
+                    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,
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(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,
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(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 registry.invokeCallbacks(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.state.get('checkpoint') === true,
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(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.state.set('checkpoint', true);
+            await registry.invokeCallbacks(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,
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(new AfterInvocationEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(new AfterInvocationEvent(createMockEvent(mockAgent)));
+            await registry.invokeCallbacks(new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const latest = await storage.loadSnapshot({
+                location: { sessionId: 'lifecycle-test', scope: 'agent', scopeId: 'default' },
+            });
+            const immutableIds = await storage.listSnapshotIds({
+                location: { sessionId: 'lifecycle-test', scope: 'agent', scopeId: 'default' },
+            });
+            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,
+            });
+            sessionManager.registerCallbacks(registry);
+            await registry.invokeCallbacks(new InitializedEvent(createMockEvent(mockAgent)));
+            mockAgent.messages.push(MOCK_MESSAGE, MOCK_MESSAGE);
+            await registry.invokeCallbacks(new AfterInvocationEvent(createMockEvent(mockAgent)));
+            const ids = await storage.listSnapshotIds({
+                location: { sessionId: 'resume-test', scope: 'agent', scopeId: 'default' },
+            });
+            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 newRegistry = new HookRegistry();
+            newSessionManager.registerCallbacks(newRegistry);
+            await newRegistry.invokeCallbacks(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',
+            });
+            sessionManager.registerCallbacks(registry);
+            const assistantMessage = new Message({ role: 'assistant', content: [new TextBlock('Response')] });
+            const event = {
+                agent: mockAgent,
+                stopData: {
+                    message: assistantMessage,
+                    stopReason: 'endTurn',
+                    redaction: {
+                        userMessage: '[User input redacted.]',
+                    },
+                },
+            };
+            await registry.invokeCallbacks(new AfterModelCallEvent(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',
+            });
+            sessionManager.registerCallbacks(registry);
+            const assistantMessage = new Message({ role: 'assistant', content: [new TextBlock('Response')] });
+            const event = {
+                agent: mockAgent,
+                stopData: {
+                    message: assistantMessage,
+                    stopReason: 'endTurn',
+                },
+            };
+            await registry.invokeCallbacks(new AfterModelCallEvent(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',
+            });
+            sessionManager.registerCallbacks(registry);
+            const assistantMessage = new Message({ role: 'assistant', content: [new TextBlock('Response')] });
+            const event = {
+                agent: mockAgent,
+                stopData: {
+                    message: assistantMessage,
+                    stopReason: 'endTurn',
+                    redaction: {
+                        userMessage: '[User input redacted.]',
+                    },
+                },
+            };
+            await registry.invokeCallbacks(new AfterModelCallEvent(event));
+            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":"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"}

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