@amodalai/runtime 0.1.0

package/dist/src/server.js.map

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

package/dist/src/server.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/server.test.js

@@ -0,0 +1,153 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import request from 'supertest';
+import { SSEEventType } from './types.js';
+// Mock core module
+const mockInitialize = vi.fn().mockResolvedValue(undefined);
+const mockShutdownAudit = vi.fn().mockResolvedValue(undefined);
+const mockGetGeminiClient = vi.fn();
+const mockGetMessageBus = vi.fn().mockReturnValue({
+    on: vi.fn(),
+    removeListener: vi.fn(),
+});
+const mockGetModel = vi.fn().mockReturnValue('test-model');
+vi.mock('@amodalai/core', () => ({
+    AmodalConfig: vi.fn(function () {
+        this['initialize'] = mockInitialize;
+        this['shutdownAudit'] = mockShutdownAudit;
+        this['getGeminiClient'] = mockGetGeminiClient;
+        this['getMessageBus'] = mockGetMessageBus;
+        this['getModel'] = mockGetModel;
+        this['getConnections'] = vi.fn().mockReturnValue({});
+        this['getUpstreamConfig'] = vi.fn().mockReturnValue({});
+        this['initializeAuth'] = vi.fn().mockResolvedValue(undefined);
+        this['getModelConfig'] = vi.fn().mockReturnValue(undefined);
+        this['setModelConfig'] = vi.fn();
+        this['getBasePrompt'] = vi.fn().mockReturnValue(undefined);
+        this['getAgentName'] = vi.fn().mockReturnValue('Test Agent');
+        this['getAgentDescription'] = vi.fn().mockReturnValue(undefined);
+        this['getAgentContext'] = vi.fn().mockReturnValue(undefined);
+        this['getStores'] = vi.fn().mockReturnValue([]);
+        this['getStoreBackend'] = vi.fn().mockReturnValue(undefined);
+        this['setStoreBackend'] = vi.fn();
+    }),
+    Scheduler: vi.fn(function () {
+        this['schedule'] = vi.fn().mockResolvedValue([]);
+    }),
+    ROOT_SCHEDULER_ID: 'root',
+    ApprovalMode: { YOLO: 'yolo' },
+    PolicyDecision: { ALLOW: 'allow', ASK_USER: 'ask_user', DENY: 'deny' },
+    GeminiEventType: {
+        Content: 'content',
+        ToolCallRequest: 'tool_call_request',
+        Error: 'error',
+        AgentExecutionStopped: 'agent_execution_stopped',
+    },
+    ToolErrorType: {
+        STOP_EXECUTION: 'stop_execution',
+    },
+    PRESENT_TOOL_NAME: 'present',
+    ACTIVATE_SKILL_TOOL_NAME: 'activate_skill',
+    buildDefaultPrompt: vi.fn().mockReturnValue('Default system prompt'),
+}));
+const { createServer } = await import('./server.js');
+// Helper to create an async generator from events
+async function* makeStream(events) {
+    for (const event of events) {
+        yield event;
+    }
+}
+describe('createServer', () => {
+    let serverInstance;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockInitialize.mockResolvedValue(undefined);
+        mockShutdownAudit.mockResolvedValue(undefined);
+        mockGetMessageBus.mockReturnValue({
+            on: vi.fn(),
+            removeListener: vi.fn(),
+        });
+        const mockChat = {
+            recordCompletedToolCalls: vi.fn(),
+        };
+        mockGetGeminiClient.mockReturnValue({
+            sendMessageStream: vi.fn().mockReturnValue(makeStream([{ type: 'content', value: 'Hello from server!' }])),
+            getCurrentSequenceModel: vi.fn().mockReturnValue('test-model'),
+            getChat: vi.fn().mockReturnValue(mockChat),
+        });
+        vi.spyOn(process.stderr, 'write').mockReturnValue(true);
+        serverInstance = createServer({
+            baseParams: {
+                sessionId: 'server-test',
+                model: 'test-model',
+                cwd: '/tmp',
+                targetDir: '/tmp',
+                debugMode: false,
+            },
+            config: {
+                port: 0, // Random port
+                host: '127.0.0.1',
+                sessionTtlMs: 30_000,
+                automations: [],
+            },
+            version: '1.0.0-test',
+        });
+    });
+    afterEach(async () => {
+        await serverInstance.stop();
+    });
+    it('responds to GET /health', async () => {
+        const res = await request(serverInstance.app).get('/health');
+        expect(res.status).toBe(200);
+        expect(res.body.status).toBe('ok');
+    });
+    it('responds to GET /version', async () => {
+        const res = await request(serverInstance.app).get('/version');
+        expect(res.status).toBe(200);
+        expect(res.body.version).toBe('1.0.0-test');
+    });
+    it('responds to POST /chat with valid message', async () => {
+        const res = await request(serverInstance.app)
+            .post('/chat')
+            .send({ message: 'hello' });
+        expect(res.status).toBe(200);
+        expect(res.body.session_id).toBeDefined();
+        expect(res.body.response).toBe('Hello from server!');
+    });
+    it('responds to POST /chat/stream with SSE', async () => {
+        const res = await request(serverInstance.app)
+            .post('/chat/stream')
+            .send({ message: 'hello' });
+        expect(res.headers['content-type']).toContain('text/event-stream');
+        expect(res.text).toContain('data: ');
+        // Parse the SSE events
+        const lines = res.text.split('\n\n').filter(Boolean);
+        const events = lines.map((line) => JSON.parse(line.replace('data: ', '')));
+        // Should have init, text_delta, done events
+        const types = events.map((e) => e['type']);
+        expect(types).toContain(SSEEventType.Init);
+        expect(types).toContain(SSEEventType.Done);
+    });
+    it('rejects invalid POST /chat request', async () => {
+        const res = await request(serverInstance.app)
+            .post('/chat')
+            .send({});
+        expect(res.status).toBe(400);
+        expect(res.body.error.code).toBe('VALIDATION_ERROR');
+    });
+    it('returns 404 for unknown webhook', async () => {
+        const res = await request(serverInstance.app)
+            .post('/webhooks/nonexistent')
+            .send({});
+        expect(res.status).toBe(404);
+    });
+    it('returns 404 for non-existent routes', async () => {
+        const res = await request(serverInstance.app).get('/nonexistent');
+        expect(res.status).toBe(404);
+    });
+});
+//# sourceMappingURL=server.test.js.map

package/dist/src/server.test.js.map

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

package/dist/src/session/history-converter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { Content } from '@amodalai/core';
+import type { SessionMessage } from './session-manager.js';
+/**
+ * Convert stored SessionMessage[] to Gemini Content[] history.
+ *
+ * Text-only approach — tool call structures are NOT reconstructed.
+ * The assistant's text already summarizes tool results, which avoids
+ * fragile reconstruction of functionCall/functionResponse pairs.
+ *
+ * Guarantees:
+ * - Error messages and empty-text messages are skipped
+ * - Adjacent same-role entries are merged (can happen after filtering)
+ * - History starts with 'user' role
+ * - Roles alternate (user ↔ model) as required by the Gemini API
+ */
+export declare function convertSessionMessagesToHistory(messages: SessionMessage[]): Content[];

package/dist/src/session/history-converter.js

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Convert stored SessionMessage[] to Gemini Content[] history.
+ *
+ * Text-only approach — tool call structures are NOT reconstructed.
+ * The assistant's text already summarizes tool results, which avoids
+ * fragile reconstruction of functionCall/functionResponse pairs.
+ *
+ * Guarantees:
+ * - Error messages and empty-text messages are skipped
+ * - Adjacent same-role entries are merged (can happen after filtering)
+ * - History starts with 'user' role
+ * - Roles alternate (user ↔ model) as required by the Gemini API
+ */
+export function convertSessionMessagesToHistory(messages) {
+    const history = [];
+    for (const msg of messages) {
+        // Skip errors and empty text
+        if (msg.type === 'error')
+            continue;
+        if (!msg.text || msg.text.trim() === '')
+            continue;
+        const role = msg.type === 'user' ? 'user' : 'model';
+        // Merge adjacent same-role entries
+        const last = history[history.length - 1];
+        if (last && last.role === role) {
+            const existingText = last.parts?.[0]?.text ?? '';
+            last.parts = [{ text: `${existingText}\n\n${msg.text}` }];
+        }
+        else {
+            history.push({ role, parts: [{ text: msg.text }] });
+        }
+    }
+    // Ensure history starts with 'user' role
+    while (history.length > 0 && history[0]?.role !== 'user') {
+        history.shift();
+    }
+    // Ensure alternating roles by dropping consecutive duplicates
+    // (a second pass in case the start-trim exposed new adjacencies)
+    const alternating = [];
+    for (const entry of history) {
+        const prev = alternating[alternating.length - 1];
+        if (prev && prev.role === entry.role) {
+            // Merge into previous
+            const existingText = prev.parts?.[0]?.text ?? '';
+            const newText = entry.parts?.[0]?.text ?? '';
+            prev.parts = [{ text: `${existingText}\n\n${newText}` }];
+        }
+        else {
+            alternating.push(entry);
+        }
+    }
+    return alternating;
+}
+//# sourceMappingURL=history-converter.js.map

package/dist/src/session/history-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-converter.js","sourceRoot":"","sources":["../../../src/session/history-converter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA0B;IAE1B,MAAM,OAAO,GAAc,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,6BAA6B;QAC7B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACnC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QAElD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAEpD,mCAAmC;QACnC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,YAAY,OAAO,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;QACzD,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,8DAA8D;IAC9D,iEAAiE;IACjE,MAAM,WAAW,GAAc,EAAE,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YACrC,sBAAsB;YACtB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,YAAY,OAAO,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/src/session/history-converter.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/session/history-converter.test.js

@@ -0,0 +1,130 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect } from 'vitest';
+import { convertSessionMessagesToHistory } from './history-converter.js';
+function makeMsg(overrides) {
+    return {
+        id: `msg-${Math.random().toString(36).slice(2)}`,
+        timestamp: new Date().toISOString(),
+        ...overrides,
+    };
+}
+describe('convertSessionMessagesToHistory', () => {
+    it('converts user and assistant messages to Content[]', () => {
+        const messages = [
+            makeMsg({ type: 'user', text: 'Hello' }),
+            makeMsg({ type: 'assistant_text', text: 'Hi there!' }),
+            makeMsg({ type: 'user', text: 'How are you?' }),
+            makeMsg({ type: 'assistant_text', text: 'I am well.' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toHaveLength(4);
+        expect(history[0]).toEqual({ role: 'user', parts: [{ text: 'Hello' }] });
+        expect(history[1]).toEqual({ role: 'model', parts: [{ text: 'Hi there!' }] });
+        expect(history[2]).toEqual({ role: 'user', parts: [{ text: 'How are you?' }] });
+        expect(history[3]).toEqual({ role: 'model', parts: [{ text: 'I am well.' }] });
+    });
+    it('skips error messages', () => {
+        const messages = [
+            makeMsg({ type: 'user', text: 'Hello' }),
+            makeMsg({ type: 'error', text: 'Something went wrong' }),
+            makeMsg({ type: 'assistant_text', text: 'Hi!' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toHaveLength(2);
+        expect(history[0]?.role).toBe('user');
+        expect(history[1]?.role).toBe('model');
+    });
+    it('skips empty text messages', () => {
+        const messages = [
+            makeMsg({ type: 'user', text: 'Hello' }),
+            makeMsg({ type: 'assistant_text', text: '' }),
+            makeMsg({ type: 'assistant_text', text: '   ' }),
+            makeMsg({ type: 'assistant_text', text: 'Real response' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toHaveLength(2);
+        expect(history[1]?.parts?.[0]?.text).toBe('Real response');
+    });
+    it('merges adjacent same-role entries', () => {
+        const messages = [
+            makeMsg({ type: 'user', text: 'Part 1' }),
+            makeMsg({ type: 'user', text: 'Part 2' }),
+            makeMsg({ type: 'assistant_text', text: 'Response' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toHaveLength(2);
+        expect(history[0]?.parts?.[0]?.text).toBe('Part 1\n\nPart 2');
+        expect(history[1]?.parts?.[0]?.text).toBe('Response');
+    });
+    it('merges after filtering errors leaves adjacent same-role', () => {
+        const messages = [
+            makeMsg({ type: 'user', text: 'Hello' }),
+            makeMsg({ type: 'assistant_text', text: 'Part A' }),
+            makeMsg({ type: 'error', text: 'oops' }),
+            makeMsg({ type: 'assistant_text', text: 'Part B' }),
+            makeMsg({ type: 'user', text: 'Next' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toHaveLength(3);
+        expect(history[0]?.role).toBe('user');
+        expect(history[1]?.role).toBe('model');
+        expect(history[1]?.parts?.[0]?.text).toBe('Part A\n\nPart B');
+        expect(history[2]?.role).toBe('user');
+    });
+    it('ensures history starts with user role', () => {
+        const messages = [
+            makeMsg({ type: 'assistant_text', text: 'I start first' }),
+            makeMsg({ type: 'user', text: 'Hello' }),
+            makeMsg({ type: 'assistant_text', text: 'Hi!' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toHaveLength(2);
+        expect(history[0]?.role).toBe('user');
+        expect(history[0]?.parts?.[0]?.text).toBe('Hello');
+    });
+    it('returns empty array for empty input', () => {
+        expect(convertSessionMessagesToHistory([])).toEqual([]);
+    });
+    it('returns empty array when all messages are errors', () => {
+        const messages = [
+            makeMsg({ type: 'error', text: 'fail 1' }),
+            makeMsg({ type: 'error', text: 'fail 2' }),
+        ];
+        expect(convertSessionMessagesToHistory(messages)).toEqual([]);
+    });
+    it('handles single user message', () => {
+        const messages = [
+            makeMsg({ type: 'user', text: 'Solo' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toHaveLength(1);
+        expect(history[0]).toEqual({ role: 'user', parts: [{ text: 'Solo' }] });
+    });
+    it('handles single assistant message (dropped — must start with user)', () => {
+        const messages = [
+            makeMsg({ type: 'assistant_text', text: 'Orphan response' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toEqual([]);
+    });
+    it('ensures alternating roles after start-trim exposes adjacency', () => {
+        // After removing the leading model messages, two user messages become adjacent
+        const messages = [
+            makeMsg({ type: 'assistant_text', text: 'pre-1' }),
+            makeMsg({ type: 'assistant_text', text: 'pre-2' }),
+            makeMsg({ type: 'user', text: 'Hello' }),
+            makeMsg({ type: 'user', text: 'World' }),
+            makeMsg({ type: 'assistant_text', text: 'Response' }),
+        ];
+        const history = convertSessionMessagesToHistory(messages);
+        expect(history).toHaveLength(2);
+        expect(history[0]?.role).toBe('user');
+        expect(history[0]?.parts?.[0]?.text).toBe('Hello\n\nWorld');
+        expect(history[1]?.role).toBe('model');
+    });
+});
+//# sourceMappingURL=history-converter.test.js.map

package/dist/src/session/history-converter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-converter.test.js","sourceRoot":"","sources":["../../../src/session/history-converter.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAGzE,SAAS,OAAO,CACd,SAAmF;IAEnF,OAAO;QACL,EAAE,EAAE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAChD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACtD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;YAC/C,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;SACxD,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;YACxD,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SACjD,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YAC7C,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAChD,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;SAC3D,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACzC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACzC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SACtD,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC9D,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnD,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACxC,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC9D,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;YAC1D,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SACjD,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,+BAA+B,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC1C,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC3C,CAAC;QACF,MAAM,CAAC,+BAA+B,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACxC,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;SAC7D,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,+EAA+E;QAC/E,MAAM,QAAQ,GAAqB;YACjC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAClD,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAClD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SACtD,CAAC;QAEF,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,117 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { AmodalConfig, type AmodalConfigParameters, Scheduler, type GeminiClient } from '@amodalai/core';
+import type { AuthContext } from '../middleware/auth.js';
+export interface PendingAskUser {
+    resolve: (answers: Record<string, string>) => void;
+    reject: (reason: Error) => void;
+}
+export interface SessionMessage {
+    type: 'user' | 'assistant_text' | 'error';
+    id: string;
+    text: string;
+    timestamp: string;
+    toolCalls?: Array<Record<string, unknown>>;
+    skillActivations?: string[];
+    widgets?: Array<Record<string, unknown>>;
+    contentBlocks?: Array<Record<string, unknown>>;
+}
+export interface ManagedSession {
+    id: string;
+    config: AmodalConfig;
+    geminiClient: GeminiClient;
+    scheduler: Scheduler;
+    createdAt: number;
+    lastAccessedAt: number;
+    /** The org this session belongs to */
+    orgId?: string;
+    /** Session type — controls which skills, tools, KB docs load */
+    sessionType?: string;
+    /** Pending ask_user responses awaiting user input */
+    pendingAskUser: Map<string, PendingAskUser>;
+    /** Accumulated messages for session history persistence */
+    accumulatedMessages: SessionMessage[];
+    /** Model used for this session (pinned at creation, survives hydration) */
+    model?: string;
+    /** Provider used for this session (pinned at creation, survives hydration) */
+    provider?: string;
+    /** Store backend for cleanup on session destroy */
+    storeBackend?: import('@amodalai/core').StoreBackend;
+}
+export interface SessionManagerOptions {
+    /** Base config parameters to clone for each session */
+    baseParams: AmodalConfigParameters;
+    /** Session TTL in milliseconds (default 30 minutes) */
+    ttlMs?: number;
+    /** Cleanup interval in milliseconds (default 5 minutes) */
+    cleanupIntervalMs?: number;
+    /** Platform API URL (for loading org-specific config per session) */
+    platformApiUrl?: string;
+}
+export declare class SessionManager {
+    private readonly sessions;
+    private readonly baseParams;
+    private readonly ttlMs;
+    private readonly platformApiUrl?;
+    private cleanupTimer;
+    /** Deduplicates concurrent hydration requests for the same conversation */
+    private readonly pendingHydrations;
+    constructor(options: SessionManagerOptions);
+    /**
+     * Create a new session with optional role override and auth context.
+     * When auth context is provided, the session is configured with
+     * the caller's API key and org/app/tenant context.
+     */
+    create(role?: string, auth?: AuthContext, sessionType?: string, pinnedModel?: {
+        provider: string;
+        model: string;
+    }, deployId?: string): Promise<ManagedSession>;
+    /**
+     * Get an existing session by ID, updating its last-accessed timestamp.
+     * Returns undefined if the session doesn't exist.
+     */
+    get(id: string): ManagedSession | undefined;
+    /**
+     * Hydrate a session from stored conversation history in the platform API.
+     *
+     * When a user sends a message to a session that expired from the in-memory
+     * cache, this method fetches the conversation from the DB, creates a fresh
+     * runtime session (new config, tools, KB, secrets), seeds its LLM history
+     * with the stored messages, and registers it under the original conversation ID.
+     *
+     * Returns null if hydration cannot proceed (no platform API, missing auth,
+     * fetch failure, or no stored messages).
+     */
+    hydrate(conversationId: string, role?: string, auth?: AuthContext, sessionType?: string): Promise<ManagedSession | null>;
+    private doHydrate;
+    /**
+     * Destroy a session, flushing its audit log.
+     */
+    destroy(id: string): Promise<void>;
+    /**
+     * Remove sessions that have been idle longer than the TTL.
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Shutdown all sessions and stop the cleanup timer.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Wait for a user's response to an ask_user prompt.
+     * Resolves when the user submits answers via the HTTP endpoint.
+     * Rejects on timeout or if the signal is aborted.
+     */
+    waitForAskUserResponse(session: ManagedSession, askId: string, signal: AbortSignal): Promise<Record<string, string>>;
+    /**
+     * Resolve a pending ask_user with user-provided answers.
+     * Returns true if the ask_id was found and resolved, false otherwise.
+     */
+    resolveAskUser(session: ManagedSession, askId: string, answers: Record<string, string>): boolean;
+    /**
+     * Number of active sessions.
+     */
+    get size(): number;
+}