@amodalai/runtime 0.1.26 → 0.2.0

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

@@ -0,0 +1,287 @@
+/**
+ * @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, ctx.tenantId — 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',
+        tenantId: 'tenant-456',
+        ...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.tenantId).toBe('tenant-456');
+        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',
+            tenant: 'tenant-456',
+        });
+    });
+    // -------------------------------------------------------------------------
+    // 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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"}

package/dist/src/session/types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Session types for the standalone session manager.
+ */
+import type { ModelMessage } from 'ai';
+import type { TokenUsage, LLMProvider } from '../providers/types.js';
+import type { ToolRegistry, ToolContext } from '../tools/types.js';
+import type { PermissionChecker } from '../security/permission-checker.js';
+import type { Logger } from '../logger.js';
+/**
+ * Token usage for a single turn (one LLM call + tool executions).
+ * Reported via the `onUsage` callback on AgentContext.
+ */
+export interface TurnUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    cacheCreationInputTokens: number;
+    totalTokens: number;
+    turnNumber: number;
+}
+/**
+ * Full automation configuration from the agent repo.
+ *
+ * All fields are defined here. Only `schedule`, `prompt`, and `enabled`
+ * are currently implemented. The parser reads and validates the full
+ * schema; unimplemented fields are stored but ignored, so when future
+ * features ship the config is already parsed.
+ */
+export interface AutomationConfig {
+    name: string;
+    description?: string;
+    /** Cron expression */
+    schedule: string;
+    /** IANA timezone (default: UTC) */
+    timezone?: string;
+    prompt: string;
+    /** LLM model override (default: primary model) */
+    model?: string;
+    /** Max turns per run (default: 15) */
+    maxTurns?: number;
+    /** Max tokens per run */
+    budget?: number;
+    /** Delivery routing — parsed now, implemented in roadmap 3.1 */
+    delivery?: {
+        on: 'completion' | 'new_results';
+        targets: Array<{
+            type: 'webhook' | 'callback';
+            url?: string;
+        }>;
+        template?: string;
+    };
+    /** Failure alerting — parsed now, implemented in roadmap 3.1 */
+    failureAlert?: {
+        after: number;
+        targets: Array<{
+            type: 'webhook' | 'callback';
+            url?: string;
+        }>;
+        cooldownMinutes?: number;
+    };
+    enabled: boolean;
+}
+/**
+ * Result of an automation run (returned to onAutomationResult hook).
+ */
+export interface AutomationResult {
+    automation: string;
+    response: string;
+    toolCalls: Array<{
+        toolName: string;
+        toolId: string;
+        status: 'success' | 'error';
+        durationMs?: number;
+    }>;
+    outputSent: boolean;
+    durationMs: number;
+    usage: TokenUsage;
+}
+/**
+ * Shape of a persisted session record in the database.
+ * Versioned from day one so we can migrate the format later.
+ */
+export interface PersistedSession {
+    version: 1;
+    id: string;
+    tenantId: string;
+    userId: string;
+    messages: ModelMessage[];
+    tokenUsage: TokenUsage;
+    metadata: SessionMetadata;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Metadata stored alongside a session. */
+export interface SessionMetadata {
+    title?: string;
+    model?: string;
+    provider?: string;
+    appId?: string;
+    automationName?: string;
+    [key: string]: unknown;
+}
+/**
+ * A live session managed by the standalone SessionManager.
+ *
+ * This is the runtime representation — it holds the components needed
+ * to execute messages via the agent loop. Separate from the persisted
+ * session which only holds serializable data.
+ */
+export interface Session {
+    id: string;
+    tenantId: string;
+    userId: string;
+    /** LLM provider for this session (pinned at creation) */
+    provider: LLMProvider;
+    /** Tool registry holding all available tools */
+    toolRegistry: ToolRegistry;
+    /** Permission checker for tool execution */
+    permissionChecker: PermissionChecker;
+    /** Logger scoped to this session */
+    logger: Logger;
+    /** Compiled system prompt */
+    systemPrompt: string;
+    /** Mutable: conversation messages */
+    messages: ModelMessage[];
+    /** Mutable: accumulated token usage */
+    usage: TokenUsage;
+    /** Model identifier (pinned at creation, survives resume) */
+    model: string;
+    /** Provider name (pinned at creation, survives resume) */
+    providerName: string;
+    /** User roles for permission checks and field guidance */
+    userRoles: string[];
+    /** App ID for multi-app isolation */
+    appId: string;
+    /** Session metadata (title, automation info, etc.) */
+    metadata: SessionMetadata;
+    /** Timestamps */
+    createdAt: number;
+    lastAccessedAt: number;
+    /** Max turns for the agent loop */
+    maxTurns: number;
+    /** Max context tokens (provider limit) */
+    maxContextTokens: number;
+    /** Tool context factory cached from session creation (avoids rebuilding per request) */
+    toolContextFactory?: (callId: string) => ToolContext;
+}
+/** Options for creating the standalone SessionManager. */
+export interface SessionManagerOptions {
+    /** Session TTL in milliseconds (default: 30 minutes) */
+    ttlMs?: number;
+    /** Cleanup interval in milliseconds (default: 5 minutes) */
+    cleanupIntervalMs?: number;
+    /** Logger for the session manager itself */
+    logger: Logger;
+    /** Default max turns per session (default: 50) */
+    defaultMaxTurns?: number;
+    /** Default max context tokens (default: 200_000) */
+    defaultMaxContextTokens?: number;
+}
+/** Options for creating a new session. */
+export interface CreateSessionOptions {
+    tenantId: string;
+    userId: string;
+    provider: LLMProvider;
+    toolRegistry: ToolRegistry;
+    permissionChecker: PermissionChecker;
+    systemPrompt: string;
+    appId?: string;
+    metadata?: SessionMetadata;
+    maxTurns?: number;
+    maxContextTokens?: number;
+    /** Optional: seed messages for resuming */
+    messages?: ModelMessage[];
+    /** Optional: seed token usage for resuming */
+    usage?: TokenUsage;
+    /** User roles for permission checks and field guidance */
+    userRoles?: string[];
+    /** Optional: onUsage callback fired after each turn */
+    onUsage?: (usage: TurnUsage) => void;
+    /** Optional: tool context factory to cache on the session */
+    toolContextFactory?: (callId: string) => ToolContext;
+}

package/dist/src/session/types.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/session/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/stores/drizzle-store-backend.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
+import type { LoadedStore } from '@amodalai/core';
+import type { StoreBackend, StoreDocument, StoreDocumentMeta, StorePutResult, StoreListOptions, StoreListResult } from '@amodalai/types';
+import type { Logger } from '../logger.js';
+type AnyPgDatabase = PgDatabase<PgQueryResultHKT, Record<string, unknown>>;
+export interface DrizzleStoreBackendOptions {
+    db: AnyPgDatabase;
+    stores: LoadedStore[];
+    logger: Logger;
+    onClose: () => Promise<void>;
+}
+export declare class DrizzleStoreBackend implements StoreBackend {
+    private readonly db;
+    private readonly storeConfigs;
+    private readonly logger;
+    private readonly onClose;
+    private writeQueue;
+    private closed;
+    constructor(opts: DrizzleStoreBackendOptions);
+    /**
+     * StoreBackend.initialize() — no-op on this class. The concrete
+     * factory (createPGLiteStoreBackend / createPostgresStoreBackend)
+     * creates the db client and runs DDL before constructing this
+     * backend. Kept for interface compliance.
+     */
+    initialize(_stores: LoadedStore[]): Promise<void>;
+    /**
+     * Serialize write operations through a queue so that PGLite's
+     * single-threaded WASM engine never sees concurrent writes. Postgres
+     * doesn't need this strictly, but the overhead is negligible and the
+     * shared ordering semantics are valuable.
+     */
+    private enqueue;
+    private ensureOpen;
+    get(appId: string, store: string, key: string): Promise<StoreDocument | null>;
+    put(appId: string, store: string, key: string, payload: Record<string, unknown>, meta: Partial<StoreDocumentMeta>): Promise<StorePutResult>;
+    list(appId: string, store: string, options?: StoreListOptions): Promise<StoreListResult>;
+    delete(appId: string, store: string, key: string): Promise<boolean>;
+    history(appId: string, store: string, key: string): Promise<StoreDocument[]>;
+    purgeExpired(appId: string, store?: string): Promise<number>;
+    close(): Promise<void>;
+    private rowToDocument;
+}
+export {};