@amodalai/runtime 0.1.26 → 0.2.1

package/dist/src/session/session-builder.test.js

@@ -0,0 +1,350 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Tests for Session Builder.
+ *
+ * Covers:
+ * 1. Build from fixture bundle → all tool types registered
+ * 2. Admin session → admin skills, user skills absent
+ * 3. Build with MCP → MCP tools registered
+ * 4. Build with pinned model → provider uses pinned model
+ * 5. stop_execution tool is registered
+ * 6. present tool is registered
+ * 7. shell_exec is NOT registered (G24 — dropped by design)
+ * 8. System prompt includes connection, skill, knowledge (G9)
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { buildSessionComponents, PRESENT_TOOL_NAME, STOP_EXECUTION_TOOL_NAME } from './session-builder.js';
+import { createLogger } from '../logger.js';
+const logger = createLogger({ component: 'test:session-builder' });
+// ---------------------------------------------------------------------------
+// Mocks
+// ---------------------------------------------------------------------------
+// Mock the provider creation to avoid real API key requirements
+vi.mock('../providers/create-provider.js', () => ({
+    createProvider: vi.fn((config) => ({
+        model: config.model,
+        provider: config.provider,
+        languageModel: {},
+        streamText: () => { throw new Error('not implemented'); },
+        generateText: () => Promise.reject(new Error('not implemented')),
+    })),
+}));
+// ---------------------------------------------------------------------------
+// Fixtures
+// ---------------------------------------------------------------------------
+function makeConnection(name) {
+    return {
+        name,
+        spec: {
+            protocol: 'rest',
+            baseUrl: `https://api.${name}.com`,
+            auth: { type: 'bearer', token: 'env:API_KEY' },
+        },
+        access: {
+            endpoints: {
+                'GET /items': { returns: ['id', 'name'] },
+                'POST /items': { returns: ['id'], confirm: true },
+            },
+        },
+        surface: [
+            { method: 'GET', path: '/items', description: 'List items', included: true },
+            { method: 'POST', path: '/items', description: 'Create item', included: true },
+        ],
+        entities: 'Item — a thing',
+        rules: 'Always paginate',
+        location: '/tmp/connections/' + name,
+    };
+}
+function makeStore() {
+    return {
+        name: 'deals',
+        entity: {
+            name: 'Deal',
+            key: '{company}_{quarter}',
+            schema: {
+                company: { type: 'string' },
+                quarter: { type: 'string' },
+                amount: { type: 'number' },
+            },
+        },
+        location: '/tmp/stores/deals',
+    };
+}
+function makeSkill() {
+    return {
+        name: 'revenue-report',
+        description: 'Generate revenue report',
+        trigger: 'When user asks about revenue',
+        body: 'Step 1: Query charges. Step 2: Aggregate.',
+        location: '/tmp/skills/revenue-report',
+    };
+}
+function makeKnowledge() {
+    return {
+        name: 'style-guide',
+        title: 'Style Guide',
+        body: 'Always use markdown tables.',
+        location: '/tmp/knowledge/style-guide',
+    };
+}
+function makeCustomTool() {
+    return {
+        name: 'analyze_data',
+        description: 'Analyze data',
+        parameters: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'] },
+        confirm: true,
+        timeout: 30000,
+        env: ['OPENAI_API_KEY'],
+        handlerPath: '/tmp/tools/analyze/handler.ts',
+        location: '/tmp/tools/analyze',
+        hasPackageJson: false,
+        hasSetupScript: false,
+        hasRequirementsTxt: false,
+        hasDockerfile: false,
+        sandboxLanguage: 'typescript',
+    };
+}
+function makeBundle(overrides) {
+    const connections = new Map();
+    connections.set('stripe', makeConnection('stripe'));
+    return {
+        source: 'local',
+        origin: '/tmp/agent',
+        config: {
+            name: 'test-agent',
+            version: '1.0.0',
+            description: 'A test agent',
+            userContext: 'Be helpful and concise.',
+            models: {
+                main: { provider: 'anthropic', model: 'claude-sonnet-4-20250514' },
+            },
+        },
+        connections,
+        skills: [makeSkill()],
+        agents: { main: undefined, simple: undefined, subagents: [] },
+        automations: [],
+        knowledge: [makeKnowledge()],
+        evals: [],
+        tools: [],
+        stores: [makeStore()],
+        ...overrides,
+    };
+}
+function makeStoreBackend() {
+    return {
+        put: vi.fn().mockResolvedValue({ version: 1 }),
+        get: vi.fn(),
+        list: vi.fn(),
+        delete: vi.fn(),
+        history: vi.fn(),
+        close: vi.fn(),
+        initialize: vi.fn(),
+        purgeExpired: vi.fn(),
+    };
+}
+function makeOpts(overrides) {
+    return {
+        bundle: makeBundle(),
+        storeBackend: makeStoreBackend(),
+        mcpManager: null,
+        logger,
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('buildSessionComponents', () => {
+    it('returns all required components', () => {
+        const components = buildSessionComponents(makeOpts());
+        expect(components.provider).toBeDefined();
+        expect(components.toolRegistry).toBeDefined();
+        expect(components.permissionChecker).toBeDefined();
+        expect(components.systemPrompt).toBeTruthy();
+        expect(components.toolContextFactory).toBeInstanceOf(Function);
+        expect(components.userRoles).toEqual([]);
+    });
+    it('registers store tools', () => {
+        const components = buildSessionComponents(makeOpts());
+        const names = components.toolRegistry.names();
+        expect(names).toContain('store_deals');
+        expect(names).toContain('store_deals_batch');
+        expect(names).toContain('query_store');
+    });
+    it('registers request tool when connections exist', () => {
+        const components = buildSessionComponents(makeOpts());
+        expect(components.toolRegistry.names()).toContain('request');
+    });
+    it('does not register request tool when no connections', () => {
+        const bundle = makeBundle({ connections: new Map() });
+        const components = buildSessionComponents(makeOpts({ bundle }));
+        expect(components.toolRegistry.names()).not.toContain('request');
+    });
+    it('registers present tool', () => {
+        const components = buildSessionComponents(makeOpts());
+        expect(components.toolRegistry.names()).toContain(PRESENT_TOOL_NAME);
+    });
+    it('registers stop_execution tool', () => {
+        const components = buildSessionComponents(makeOpts());
+        expect(components.toolRegistry.names()).toContain(STOP_EXECUTION_TOOL_NAME);
+    });
+    it('does NOT register shell_exec (dropped by design)', () => {
+        const components = buildSessionComponents(makeOpts());
+        expect(components.toolRegistry.names()).not.toContain('shell_exec');
+    });
+    it('does NOT register ask_user (dropped by design)', () => {
+        const components = buildSessionComponents(makeOpts());
+        expect(components.toolRegistry.names()).not.toContain('ask_user');
+    });
+    it('does NOT register activate_skill (dropped by design)', () => {
+        const components = buildSessionComponents(makeOpts());
+        expect(components.toolRegistry.names()).not.toContain('activate_skill');
+    });
+    it('does NOT register load_knowledge (dropped by design)', () => {
+        const components = buildSessionComponents(makeOpts());
+        expect(components.toolRegistry.names()).not.toContain('load_knowledge');
+    });
+    describe('custom tools', () => {
+        it('registers custom tools when executor provided', () => {
+            const bundle = makeBundle({ tools: [makeCustomTool()] });
+            const executor = { execute: vi.fn() };
+            const components = buildSessionComponents(makeOpts({ bundle, toolExecutor: executor }));
+            expect(components.toolRegistry.names()).toContain('analyze_data');
+        });
+        it('skips custom tools with confirm: never', () => {
+            const tool = makeCustomTool();
+            tool.confirm = 'never';
+            const bundle = makeBundle({ tools: [tool] });
+            const executor = { execute: vi.fn() };
+            const components = buildSessionComponents(makeOpts({ bundle, toolExecutor: executor }));
+            expect(components.toolRegistry.names()).not.toContain('analyze_data');
+        });
+        it('does not register custom tools without executor', () => {
+            const bundle = makeBundle({ tools: [makeCustomTool()] });
+            const components = buildSessionComponents(makeOpts({ bundle }));
+            expect(components.toolRegistry.names()).not.toContain('analyze_data');
+        });
+    });
+    describe('MCP tools', () => {
+        it('registers MCP tools when mcpManager provided', () => {
+            const mcpManager = {
+                getDiscoveredTools: vi.fn().mockReturnValue([
+                    {
+                        name: 'mcp-server__tool1',
+                        description: 'A tool',
+                        parameters: { type: 'object', properties: {} },
+                        serverName: 'mcp-server',
+                        originalName: 'tool1',
+                    },
+                ]),
+                callTool: vi.fn(),
+            };
+            const components = buildSessionComponents(makeOpts({ mcpManager: mcpManager }));
+            expect(components.toolRegistry.names()).toContain('mcp-server__tool1');
+        });
+    });
+    describe('admin sessions', () => {
+        it('uses admin skills/knowledge in system prompt', () => {
+            const adminContent = {
+                agentPrompt: 'You are the admin agent.',
+                skills: [{ name: 'manage-connections', description: 'Manage connections', body: 'Admin skill body', location: '/tmp' }],
+                knowledge: [{ name: 'admin-guide', title: 'Admin Guide', body: 'Admin knowledge body', location: '/tmp' }],
+            };
+            const components = buildSessionComponents(makeOpts({
+                sessionType: 'admin',
+                adminContent,
+                repoRoot: '/tmp/agent',
+            }));
+            // Admin skills should appear in prompt
+            expect(components.systemPrompt).toContain('manage-connections');
+            expect(components.systemPrompt).toContain('Admin skill body');
+            // User skills should NOT appear
+            expect(components.systemPrompt).not.toContain('revenue-report');
+        });
+        it('registers admin file tools', () => {
+            const adminContent = {
+                agentPrompt: null,
+                skills: [],
+                knowledge: [],
+            };
+            const components = buildSessionComponents(makeOpts({
+                sessionType: 'admin',
+                adminContent,
+                repoRoot: '/tmp/agent',
+            }));
+            const names = components.toolRegistry.names();
+            expect(names).toContain('read_repo_file');
+            expect(names).toContain('write_repo_file');
+            expect(names).toContain('delete_repo_file');
+            expect(names).toContain('internal_api');
+        });
+        it('does not register admin file tools for chat sessions', () => {
+            const components = buildSessionComponents(makeOpts());
+            const names = components.toolRegistry.names();
+            expect(names).not.toContain('read_repo_file');
+            expect(names).not.toContain('write_repo_file');
+            expect(names).not.toContain('delete_repo_file');
+        });
+    });
+    describe('pinned model', () => {
+        it('uses pinned model over bundle config', () => {
+            const components = buildSessionComponents(makeOpts({
+                pinnedModel: { provider: 'openai', model: 'gpt-4o' },
+            }));
+            expect(components.provider.model).toBe('gpt-4o');
+            expect(components.provider.provider).toBe('openai');
+        });
+    });
+    describe('system prompt (G9)', () => {
+        it('includes connection endpoints', () => {
+            const components = buildSessionComponents(makeOpts());
+            expect(components.systemPrompt).toContain('/items');
+        });
+        it('includes skill body', () => {
+            const components = buildSessionComponents(makeOpts());
+            expect(components.systemPrompt).toContain('Query charges');
+        });
+        it('includes knowledge body', () => {
+            const components = buildSessionComponents(makeOpts());
+            expect(components.systemPrompt).toContain('markdown tables');
+        });
+        it('includes userContext (G10)', () => {
+            const components = buildSessionComponents(makeOpts());
+            expect(components.systemPrompt).toContain('Be helpful and concise');
+        });
+    });
+    describe('stop_execution tool', () => {
+        it('returns __stop sentinel', async () => {
+            const components = buildSessionComponents(makeOpts());
+            const tool = components.toolRegistry.get(STOP_EXECUTION_TOOL_NAME);
+            expect(tool).toBeDefined();
+            const result = await tool.execute({ reason: 'Task complete' }, {});
+            expect(result).toEqual({ __stop: true, reason: 'Task complete' });
+        });
+    });
+    describe('present tool', () => {
+        it('returns rendered widget data', async () => {
+            const components = buildSessionComponents(makeOpts());
+            const tool = components.toolRegistry.get(PRESENT_TOOL_NAME);
+            expect(tool).toBeDefined();
+            const result = await tool.execute({ widget: 'entity-card', data: { name: 'Test' } }, {});
+            expect(result).toEqual({ widget: 'entity-card', data: { name: 'Test' }, rendered: true });
+        });
+    });
+    describe('tool context factory', () => {
+        it('factory produces ToolContext with correct session info', () => {
+            const components = buildSessionComponents(makeOpts({
+                sessionId: 'sess-123',
+                userRoles: ['analyst'],
+            }));
+            const ctx = components.toolContextFactory('call-1');
+            expect(ctx.sessionId).toBe('sess-123');
+            expect(ctx.user.roles).toEqual(['analyst']);
+        });
+    });
+});
+//# sourceMappingURL=session-builder.test.js.map

package/dist/src/session/session-builder.test.js.map

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

package/dist/src/session/session-store-selector.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Picks the right session-store factory given repo config.
+ *
+ * Extracted from `local-server.ts` so the selection logic is
+ * unit-testable without spinning up the full server.
+ */
+import type { Logger } from '../logger.js';
+import type { SessionStore } from './store.js';
+export interface SessionStoreSelectorOptions {
+    /** From amodal.json `stores.backend`. Defaults to `pglite` if unset. */
+    backend?: 'pglite' | 'postgres';
+    /**
+     * Already-resolved Postgres connection string. Callers must resolve
+     * any `env:VAR` reference upstream (see `resolveEnvRef` in
+     * `../env-ref.ts`) — this function does not read `process.env`.
+     */
+    postgresUrl?: string;
+    /** Logger for init and fallback events. */
+    logger: Logger;
+    /** Optional PGLite data dir (defaults to in-memory). */
+    dataDir?: string;
+}
+/**
+ * Select, construct, and initialize a `SessionStore`.
+ *
+ * Decision:
+ *   1. If `backend === 'postgres'` and `postgresUrl` is set →
+ *      `createPostgresSessionStore`.
+ *   2. If `backend === 'postgres'` but the URL is missing, **or the
+ *      Postgres connection fails to initialize** → log the failure at
+ *      `error` level and fall back to `createPGLiteSessionStore`. The
+ *      session store must always be available; a missing URL or dead
+ *      DB should not crash the runtime on boot.
+ *   3. If the Postgres backend rejects config at construct time
+ *      (invalid `tableName`, missing options, etc.) → **rethrow**.
+ *      Config typos in `amodal.json` are programmer errors that must
+ *      fail fast — if they fell through to PGLite silently, every
+ *      session would evaporate on restart with no visible signal.
+ *   4. Otherwise → PGLite (default).
+ *
+ * **Fallback scope:** only connection-class failures (network, auth,
+ * DDL) trigger the fallback. Construct-time validation is fatal.
+ */
+export declare function selectSessionStore(opts: SessionStoreSelectorOptions): Promise<SessionStore>;

package/dist/src/session/session-store-selector.js

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { SessionStoreError } from '../errors.js';
+import { createPGLiteSessionStore } from './pglite-session-store.js';
+/**
+ * Select, construct, and initialize a `SessionStore`.
+ *
+ * Decision:
+ *   1. If `backend === 'postgres'` and `postgresUrl` is set →
+ *      `createPostgresSessionStore`.
+ *   2. If `backend === 'postgres'` but the URL is missing, **or the
+ *      Postgres connection fails to initialize** → log the failure at
+ *      `error` level and fall back to `createPGLiteSessionStore`. The
+ *      session store must always be available; a missing URL or dead
+ *      DB should not crash the runtime on boot.
+ *   3. If the Postgres backend rejects config at construct time
+ *      (invalid `tableName`, missing options, etc.) → **rethrow**.
+ *      Config typos in `amodal.json` are programmer errors that must
+ *      fail fast — if they fell through to PGLite silently, every
+ *      session would evaporate on restart with no visible signal.
+ *   4. Otherwise → PGLite (default).
+ *
+ * **Fallback scope:** only connection-class failures (network, auth,
+ * DDL) trigger the fallback. Construct-time validation is fatal.
+ */
+export async function selectSessionStore(opts) {
+    const { backend = 'pglite', postgresUrl, logger, dataDir } = opts;
+    if (backend === 'postgres') {
+        if (!postgresUrl) {
+            logger.warn('session_store_postgres_url_missing', { fallback: 'pglite' });
+        }
+        else {
+            try {
+                // Dynamic import so `pg` stays optional for PGLite-only users.
+                const mod = await import('./postgres-session-store.js');
+                return await mod.createPostgresSessionStore({
+                    connectionString: postgresUrl,
+                    logger,
+                });
+            }
+            catch (err) {
+                // Construct-time validation errors are programmer errors —
+                // fail fast so operators notice the amodal.json typo.
+                if (err instanceof SessionStoreError && err.operation === 'construct') {
+                    throw err;
+                }
+                // Connection-class failure — log and fall back to PGLite.
+                logger.error('session_store_postgres_init_failed', {
+                    error: err instanceof Error ? err.message : String(err),
+                    fallback: 'pglite',
+                });
+            }
+        }
+    }
+    return createPGLiteSessionStore({ logger, dataDir });
+}
+//# sourceMappingURL=session-store-selector.js.map

package/dist/src/session/session-store-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store-selector.js","sourceRoot":"","sources":["../../../src/session/session-store-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAC,wBAAwB,EAAC,MAAM,2BAA2B,CAAC;AAiBnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAiC;IAEjC,MAAM,EAAC,OAAO,GAAG,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC;IAEhE,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAC,QAAQ,EAAE,QAAQ,EAAC,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,+DAA+D;gBAC/D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;gBACxD,OAAO,MAAM,GAAG,CAAC,0BAA0B,CAAC;oBAC1C,gBAAgB,EAAE,WAAW;oBAC7B,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,2DAA2D;gBAC3D,sDAAsD;gBACtD,IAAI,GAAG,YAAY,iBAAiB,IAAI,GAAG,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;oBACtE,MAAM,GAAG,CAAC;gBACZ,CAAC;gBACD,0DAA0D;gBAC1D,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE;oBACjD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACvD,QAAQ,EAAE,QAAQ;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,wBAAwB,CAAC,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/src/session/session-store-selector.test.d.ts

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

package/dist/src/session/session-store-selector.test.js

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import { selectSessionStore } from './session-store-selector.js';
+import { DrizzleSessionStore } from './drizzle-session-store.js';
+import { createLogger } from '../logger.js';
+const logger = createLogger({ component: 'test:selector' });
+/**
+ * Both backends return `DrizzleSessionStore` today; we assert on the
+ * `backendName` tag to tell them apart in tests. If that instance type
+ * ever changes, this narrow cast is the one place to update.
+ */
+function asDrizzle(store) {
+    expect(store).toBeInstanceOf(DrizzleSessionStore);
+    return store;
+}
+describe('selectSessionStore', () => {
+    const created = [];
+    afterEach(async () => {
+        while (created.length > 0) {
+            const s = created.pop();
+            await s.close();
+        }
+    });
+    it('defaults to PGLite when no backend specified', async () => {
+        const store = await selectSessionStore({ logger });
+        created.push(store);
+        expect(asDrizzle(store).backendName).toBe('pglite');
+    });
+    it('uses PGLite when backend is explicitly pglite', async () => {
+        const store = await selectSessionStore({ backend: 'pglite', logger });
+        created.push(store);
+        expect(asDrizzle(store).backendName).toBe('pglite');
+    });
+    it('falls back to PGLite when backend=postgres but no URL is set', async () => {
+        const store = await selectSessionStore({ backend: 'postgres', logger });
+        created.push(store);
+        expect(asDrizzle(store).backendName).toBe('pglite');
+    });
+    it('falls back to PGLite when postgresUrl is an empty string', async () => {
+        // Caller is responsible for resolving env: refs; empty string is
+        // what they pass when `env:VAR` was unset.
+        const store = await selectSessionStore({
+            backend: 'postgres',
+            postgresUrl: '',
+            logger,
+        });
+        created.push(store);
+        expect(asDrizzle(store).backendName).toBe('pglite');
+    });
+    it('falls back to PGLite when Postgres connection fails to initialize', async () => {
+        // Unreachable host + very short connect timeout → init throws →
+        // selector logs error and falls back to PGLite. This is the
+        // "runtime must boot even on misconfigured Postgres" path.
+        const store = await selectSessionStore({
+            backend: 'postgres',
+            // Port 1 is reserved and connection will be refused fast
+            postgresUrl: 'postgres://nobody:nothing@127.0.0.1:1/missing?connect_timeout=1',
+            logger,
+        });
+        created.push(store);
+        expect(asDrizzle(store).backendName).toBe('pglite');
+    });
+    const pgUrl = process.env['TEST_POSTGRES_URL'] ?? '';
+    const itPg = pgUrl ? it : it.skip;
+    itPg('uses Postgres backend when backend=postgres and URL is set', async () => {
+        const store = await selectSessionStore({
+            backend: 'postgres',
+            postgresUrl: pgUrl,
+            logger,
+        });
+        created.push(store);
+        expect(asDrizzle(store).backendName).toBe('postgres');
+    });
+});
+//# sourceMappingURL=session-store-selector.test.js.map

package/dist/src/session/session-store-selector.test.js.map

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