@amodalai/runtime 0.1.26 → 0.2.1

package/dist/src/session/tool-context-factory.js

@@ -0,0 +1,189 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { ConnectionError, StoreError } from '../errors.js';
+import { resolveKey } from '../stores/key-resolver.js';
+// ---------------------------------------------------------------------------
+// Request implementation (internalized from request-helper.ts)
+// ---------------------------------------------------------------------------
+const REQUEST_TIMEOUT_MS = 30_000;
+/**
+ * Resolve auth template variables: "Bearer {{API_KEY}}" → "Bearer token123"
+ */
+function resolveAuthTemplate(template, connectionConfig) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, varName) => {
+        const value = connectionConfig[varName];
+        return value !== undefined ? String(value) : '';
+    });
+}
+async function makeRequest(opts, connection, endpoint, params, signal) {
+    const method = params?.method ?? 'GET';
+    const connConfig = opts.connectionsMap[connection];
+    if (!connConfig) {
+        const available = Object.keys(opts.connectionsMap);
+        const suggestion = available.find((n) => n.toLowerCase() === connection.toLowerCase())
+            ?? available.find((n) => connection.toLowerCase().includes(n.toLowerCase()) || n.toLowerCase().includes(connection.toLowerCase()));
+        throw new ConnectionError(`Connection "${connection}" not found. Available: ${available.join(', ') || '(none)'}${suggestion ? `. Did you mean "${suggestion}"?` : ''}`, { connection, action: `${method} ${endpoint}` });
+    }
+    const baseUrl = connConfig.base_url;
+    if (!baseUrl) {
+        throw new ConnectionError(`Connection "${connection}" has no base_url`, { connection, action: `${method} ${endpoint}` });
+    }
+    let url = `${baseUrl.replace(/\/$/, '')}/${endpoint.replace(/^\//, '')}`;
+    // Add query params
+    if (params?.params) {
+        const searchParams = new URLSearchParams();
+        for (const [k, v] of Object.entries(params.params)) {
+            searchParams.set(k, v);
+        }
+        const qs = searchParams.toString();
+        if (qs) {
+            url += `?${qs}`;
+        }
+    }
+    // Build headers
+    const headers = { 'Content-Type': 'application/json' };
+    const reqConfig = connConfig._request_config;
+    if (reqConfig?.auth) {
+        for (const entry of reqConfig.auth) {
+            headers[entry.header] = resolveAuthTemplate(entry.value_template, connConfig);
+        }
+    }
+    if (reqConfig?.default_headers) {
+        for (const [k, v] of Object.entries(reqConfig.default_headers)) {
+            headers[k] = v;
+        }
+    }
+    const requestSignal = signal ?? AbortSignal.timeout(REQUEST_TIMEOUT_MS);
+    const fetchOpts = { method, headers, signal: requestSignal };
+    if (params?.data && (method === 'POST' || method === 'PUT' || method === 'PATCH')) {
+        fetchOpts.body = JSON.stringify(params.data);
+    }
+    const response = await fetch(url, fetchOpts);
+    const text = await response.text();
+    // Field scrubbing — only attempt on valid JSON; scrubber errors propagate
+    let output = text;
+    if (opts.fieldScrubber) {
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            // Not JSON — skip scrubbing, return text as-is
+            parsed = undefined;
+        }
+        if (parsed !== undefined) {
+            const scrubResult = opts.fieldScrubber.scrub(parsed, connection, endpoint);
+            output = JSON.stringify(scrubResult.data);
+        }
+    }
+    if (!response.ok) {
+        if (response.status === 401 || response.status === 403) {
+            throw new ConnectionError(`Authentication failed (${String(response.status)}) for connection "${connection}". Check credentials.`, { connection, action: `${method} ${endpoint}` });
+        }
+        throw new ConnectionError(`HTTP ${String(response.status)} from "${connection}" ${method} ${endpoint}: ${output.substring(0, 500)}`, { connection, action: `${method} ${endpoint}` });
+    }
+    // Parse JSON response if possible
+    try {
+        return JSON.parse(output);
+    }
+    catch {
+        return output;
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a factory function that builds ToolContext instances for tool execution.
+ *
+ * The returned factory is passed as `AgentContext.buildToolContext`. The EXECUTING
+ * state handler calls it once per tool execution with the tool call ID.
+ *
+ * The EXECUTING handler composes its own AbortSignal (session + per-tool timeout)
+ * and overrides `ctx.signal` via object spread before passing to the tool's
+ * execute function. Methods on this context read `ctx.signal` at call time
+ * (not at creation time) so that the overridden signal propagates to HTTP
+ * requests and other async operations.
+ */
+export function createToolContextFactory(opts) {
+    return (callId) => {
+        // Build ctx as a named object so methods can reference ctx.signal at
+        // call time. When EXECUTING does `{...toolCtx, signal: combined}`, the
+        // spread creates a new object — but the closures still capture `ctx`.
+        // To fix this, EXECUTING must mutate `toolCtx.signal` directly instead
+        // of spreading. The default signal here is a safety net in case
+        // the caller doesn't override.
+        const ctx = {
+            async request(connection, endpoint, params) {
+                opts.logger.debug('tool_context_request', {
+                    callId,
+                    connection,
+                    endpoint,
+                    method: params?.method ?? 'GET',
+                    session: opts.sessionId,
+                });
+                return makeRequest(opts, connection, endpoint, params, ctx.signal);
+            },
+            async store(storeName, payload) {
+                const storeDef = opts.storeDefinitions.find((s) => s.name === storeName);
+                if (!storeDef) {
+                    const available = opts.storeDefinitions.map((s) => s.name).join(', ');
+                    throw new StoreError(`Store "${storeName}" not found. Available: ${available || '(none)'}`, {
+                        store: storeName,
+                        operation: 'put',
+                        context: { available, session: opts.sessionId },
+                    });
+                }
+                const key = resolveKey(storeDef.entity.key, payload);
+                opts.logger.debug('tool_context_store_write', {
+                    callId,
+                    store: storeName,
+                    key,
+                    session: opts.sessionId,
+                });
+                // Race against abort signal so a hung PGLite doesn't block forever
+                await Promise.race([
+                    opts.storeBackend.put(opts.appId, storeName, key, payload, {}),
+                    new Promise((_resolve, reject) => {
+                        if (ctx.signal.aborted) {
+                            reject(new StoreError('Store write timed out', { store: storeName, operation: 'put', context: { callId, key } }));
+                            return;
+                        }
+                        ctx.signal.addEventListener('abort', () => {
+                            reject(new StoreError('Store write timed out', { store: storeName, operation: 'put', context: { callId, key } }));
+                        }, { once: true });
+                    }),
+                ]);
+                opts.logger.debug('tool_context_store_complete', {
+                    callId,
+                    store: storeName,
+                    key,
+                    session: opts.sessionId,
+                });
+                return { key };
+            },
+            env(name) {
+                if (!(name in opts.envAllowlist)) {
+                    return undefined;
+                }
+                return opts.envAllowlist[name];
+            },
+            log(message) {
+                opts.logger.info('tool_log', {
+                    callId,
+                    message,
+                    session: opts.sessionId,
+                });
+            },
+            user: opts.user,
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            sessionId: opts.sessionId,
+            ...(opts.searchProvider ? { searchProvider: opts.searchProvider } : {}),
+        };
+        return ctx;
+    };
+}
+//# sourceMappingURL=tool-context-factory.js.map

package/dist/src/session/tool-context-factory.js.map

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

package/dist/src/session/tool-context-factory.test.d.ts

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

package/dist/src/session/tool-context-factory.test.js

@@ -0,0 +1,284 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Tool Context Factory Tests.
+ *
+ * Covers:
+ * 1. ctx.request() — makes HTTP calls through connections with auth headers
+ * 2. ctx.request() — connection not found error with suggestion
+ * 3. ctx.request() — auth failure → ConnectionError
+ * 4. ctx.store() — writes to store backend with key resolution
+ * 5. ctx.store() — store not found error
+ * 6. ctx.env() — allowlisted vars exposed, others blocked
+ * 7. ctx.log() — emits structured log event
+ * 8. ctx.user, ctx.sessionId — passthrough
+ * 9. Factory returns fresh context per callId
+ */
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { createToolContextFactory } from './tool-context-factory.js';
+import { StoreError } from '../errors.js';
+// ---------------------------------------------------------------------------
+// Mocks
+// ---------------------------------------------------------------------------
+function makeMockLogger() {
+    return {
+        trace: vi.fn(),
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        fatal: vi.fn(),
+        child: vi.fn().mockReturnThis(),
+    };
+}
+function makeMockStoreBackend() {
+    return {
+        initialize: vi.fn(),
+        get: vi.fn(),
+        put: vi.fn().mockResolvedValue({ stored: true, key: 'resolved-key', version: 1 }),
+        list: vi.fn(),
+        delete: vi.fn(),
+        history: vi.fn(),
+        purgeExpired: vi.fn(),
+        close: vi.fn(),
+    };
+}
+function makeStoreDefinition(overrides) {
+    return {
+        name: 'deals',
+        entity: {
+            name: 'Deal',
+            key: '{company}_{quarter}',
+            schema: {
+                company: { type: 'string' },
+                quarter: { type: 'string' },
+                amount: { type: 'number' },
+            },
+        },
+        location: '/tmp/stores/deals.json',
+        ...overrides,
+    };
+}
+function makeConnectionsMap() {
+    return {
+        stripe: {
+            base_url: 'https://api.stripe.com',
+            _request_config: {
+                base_url_field: 'base_url',
+                auth: [{ header: 'Authorization', value_template: 'Bearer {{STRIPE_KEY}}' }],
+            },
+            STRIPE_KEY: 'sk_test_123',
+        },
+        slack: {
+            base_url: 'https://slack.com/api',
+            _request_config: {
+                base_url_field: 'base_url',
+                auth: [{ header: 'Authorization', value_template: 'Bearer {{SLACK_TOKEN}}' }],
+                default_headers: { 'X-Custom': 'value' },
+            },
+            SLACK_TOKEN: 'xoxb-test',
+        },
+    };
+}
+function makeFactoryOpts(overrides) {
+    return {
+        connectionsMap: makeConnectionsMap(),
+        storeBackend: makeMockStoreBackend(),
+        storeDefinitions: [makeStoreDefinition()],
+        appId: 'test-app',
+        envAllowlist: { ALLOWED_VAR: 'allowed-value' },
+        logger: makeMockLogger(),
+        user: { roles: ['analyst'] },
+        sessionId: 'sess-123',
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('createToolContextFactory', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    // -------------------------------------------------------------------------
+    // Basic factory behavior
+    // -------------------------------------------------------------------------
+    it('returns a factory function that produces ToolContext', () => {
+        const factory = createToolContextFactory(makeFactoryOpts());
+        const ctx = factory('call-1');
+        expect(ctx.sessionId).toBe('sess-123');
+        expect(ctx.user.roles).toEqual(['analyst']);
+        expect(ctx.signal).toBeDefined();
+        expect(ctx.signal.aborted).toBe(false);
+    });
+    it('returns fresh context per callId', () => {
+        const factory = createToolContextFactory(makeFactoryOpts());
+        const ctx1 = factory('call-1');
+        const ctx2 = factory('call-2');
+        // Different objects
+        expect(ctx1).not.toBe(ctx2);
+        // Same session info
+        expect(ctx1.sessionId).toBe(ctx2.sessionId);
+    });
+    // -------------------------------------------------------------------------
+    // ctx.env()
+    // -------------------------------------------------------------------------
+    it('env() returns allowlisted vars', () => {
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        expect(ctx.env('ALLOWED_VAR')).toBe('allowed-value');
+    });
+    it('env() blocks non-allowlisted vars', () => {
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        expect(ctx.env('BLOCKED_VAR')).toBeUndefined();
+        expect(ctx.env('HOME')).toBeUndefined();
+        expect(ctx.env('PATH')).toBeUndefined();
+    });
+    // -------------------------------------------------------------------------
+    // ctx.log()
+    // -------------------------------------------------------------------------
+    it('log() emits structured event via logger', () => {
+        const logger = makeMockLogger();
+        const ctx = createToolContextFactory(makeFactoryOpts({ logger }))('call-42');
+        ctx.log('processing item');
+        expect(logger.info).toHaveBeenCalledWith('tool_log', {
+            callId: 'call-42',
+            message: 'processing item',
+            session: 'sess-123',
+        });
+    });
+    // -------------------------------------------------------------------------
+    // ctx.store()
+    // -------------------------------------------------------------------------
+    it('store() writes to backend with resolved key', async () => {
+        const backend = makeMockStoreBackend();
+        const ctx = createToolContextFactory(makeFactoryOpts({ storeBackend: backend }))('call-1');
+        const result = await ctx.store('deals', { company: 'acme', quarter: 'Q1', amount: 5000 });
+        expect(result).toEqual({ key: 'acme_Q1' });
+        expect(backend.put).toHaveBeenCalledWith('test-app', 'deals', 'acme_Q1', { company: 'acme', quarter: 'Q1', amount: 5000 }, {});
+    });
+    it('store() throws StoreError when store not found', async () => {
+        const ctx = createToolContextFactory(makeFactoryOpts({ storeDefinitions: [] }))('call-1');
+        await expect(ctx.store('nonexistent', {})).rejects.toThrow(StoreError);
+        await expect(ctx.store('nonexistent', {})).rejects.toThrow(/Store "nonexistent" not found/);
+    });
+    it('store() throws when key template field is missing', async () => {
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        await expect(ctx.store('deals', { company: 'acme' })).rejects.toThrow(/field "quarter"/);
+    });
+    it('store() logs write with key and store name', async () => {
+        const logger = makeMockLogger();
+        const ctx = createToolContextFactory(makeFactoryOpts({ logger }))('call-1');
+        await ctx.store('deals', { company: 'acme', quarter: 'Q1', amount: 100 });
+        expect(logger.debug).toHaveBeenCalledWith('tool_context_store_write', expect.objectContaining({
+            store: 'deals',
+            key: 'acme_Q1',
+        }));
+    });
+    // -------------------------------------------------------------------------
+    // ctx.request()
+    // -------------------------------------------------------------------------
+    it('request() makes HTTP call with auth headers', async () => {
+        const mockResponse = new Response(JSON.stringify({ data: 'ok' }), { status: 200 });
+        const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        const result = await ctx.request('stripe', '/v1/customers', { method: 'GET' });
+        expect(result).toEqual({ data: 'ok' });
+        expect(fetchSpy).toHaveBeenCalledWith('https://api.stripe.com/v1/customers', expect.objectContaining({
+            method: 'GET',
+            headers: expect.objectContaining({
+                Authorization: 'Bearer sk_test_123',
+            }),
+        }));
+    });
+    it('request() includes default headers from connection config', async () => {
+        const mockResponse = new Response(JSON.stringify({ ok: true }), { status: 200 });
+        const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        await ctx.request('slack', '/chat.postMessage', { method: 'POST', data: { text: 'hi' } });
+        expect(fetchSpy).toHaveBeenCalledWith('https://slack.com/api/chat.postMessage', expect.objectContaining({
+            method: 'POST',
+            headers: expect.objectContaining({
+                'Authorization': 'Bearer xoxb-test',
+                'X-Custom': 'value',
+            }),
+            body: JSON.stringify({ text: 'hi' }),
+        }));
+    });
+    it('request() adds query params', async () => {
+        const mockResponse = new Response(JSON.stringify([]), { status: 200 });
+        const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        await ctx.request('stripe', '/v1/charges', { params: { limit: '10', status: 'paid' } });
+        const calledUrl = fetchSpy.mock.calls[0][0];
+        expect(calledUrl).toContain('limit=10');
+        expect(calledUrl).toContain('status=paid');
+    });
+    it('request() throws ConnectionError when connection not found', async () => {
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        await expect(ctx.request('unknown', '/foo')).rejects.toThrow(/Connection "unknown" not found/);
+    });
+    it('request() suggests similar connection name', async () => {
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        await expect(ctx.request('Stripe', '/foo')).rejects.toThrow(/Did you mean "stripe"/);
+    });
+    it('request() throws ConnectionError on auth failure', async () => {
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('Unauthorized', { status: 401 }));
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        await expect(ctx.request('stripe', '/v1/customers')).rejects.toThrow(/Authentication failed/);
+    });
+    it('request() throws ConnectionError on server error', async () => {
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('Server Error', { status: 500 }));
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        await expect(ctx.request('stripe', '/v1/customers')).rejects.toThrow(/HTTP 500/);
+    });
+    it('request() returns raw text when response is not JSON', async () => {
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('plain text', { status: 200 }));
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        const result = await ctx.request('stripe', '/v1/export');
+        expect(result).toBe('plain text');
+    });
+    it('request() defaults to GET method', async () => {
+        const mockResponse = new Response(JSON.stringify({ ok: true }), { status: 200 });
+        const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        await ctx.request('stripe', '/v1/customers');
+        expect(fetchSpy).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ method: 'GET' }));
+    });
+    it('request() logs with connection and endpoint', async () => {
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('{}', { status: 200 }));
+        const logger = makeMockLogger();
+        const ctx = createToolContextFactory(makeFactoryOpts({ logger }))('call-7');
+        await ctx.request('stripe', '/v1/customers', { method: 'GET' });
+        expect(logger.debug).toHaveBeenCalledWith('tool_context_request', expect.objectContaining({
+            callId: 'call-7',
+            connection: 'stripe',
+            endpoint: '/v1/customers',
+            method: 'GET',
+        }));
+    });
+    it('request() uses ctx.signal for abort — propagates when mutated', async () => {
+        const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('{}', { status: 200 }));
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        // Simulate what EXECUTING handler does: mutate signal with combined timeout
+        const controller = new AbortController();
+        ctx.signal = controller.signal;
+        await ctx.request('stripe', '/v1/customers');
+        // The fetch call should have received the mutated signal, not the default timeout
+        const fetchOpts = fetchSpy.mock.calls[0][1];
+        expect(fetchOpts.signal).toBe(controller.signal);
+    });
+    it('request() aborts when ctx.signal is aborted', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        vi.spyOn(globalThis, 'fetch').mockImplementation(() => {
+            throw new DOMException('The operation was aborted', 'AbortError');
+        });
+        const ctx = createToolContextFactory(makeFactoryOpts())('call-1');
+        ctx.signal = controller.signal;
+        await expect(ctx.request('stripe', '/v1/customers')).rejects.toThrow('aborted');
+    });
+});
+//# sourceMappingURL=tool-context-factory.test.js.map

package/dist/src/session/tool-context-factory.test.js.map

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