@amodalai/runtime 0.1.0

package/dist/src/agent/routes/stores.js

@@ -0,0 +1,137 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { Router } from 'express';
+/**
+ * Creates routes for reading store data directly (without going through the LLM).
+ *
+ * GET  /api/stores              — list store definitions with doc counts
+ * GET  /api/stores/:name        — list documents (filter, sort, limit, offset)
+ * GET  /api/stores/:name/:key   — get single document + version history
+ */
+export function createStoresRouter(options) {
+    const router = Router();
+    const { repo, storeBackend, tenantId } = options;
+    // List all store definitions with document counts
+    router.get('/api/stores', async (_req, res) => {
+        try {
+            const stores = await Promise.all(repo.stores.map(async (store) => {
+                const result = await storeBackend.list(tenantId, store.name, { limit: 0 });
+                return {
+                    name: store.name,
+                    entity: store.entity,
+                    ttl: store.ttl,
+                    trace: store.trace,
+                    history: store.history,
+                    documentCount: result.total,
+                };
+            }));
+            res.json({ stores });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            res.status(500).json({ error: message });
+        }
+    });
+    // List documents from a store
+    router.get('/api/stores/:name', async (req, res) => {
+        const storeName = req.params['name'] ?? '';
+        // Verify store exists
+        const store = repo.stores.find((s) => s.name === storeName);
+        if (!store) {
+            res.status(404).json({ error: `Store "${storeName}" not found` });
+            return;
+        }
+        // Parse query params
+        let filter;
+        if (req.query['filter']) {
+            try {
+                filter = JSON.parse(String(req.query['filter']));
+            }
+            catch {
+                res.status(400).json({ error: 'Invalid filter JSON' });
+                return;
+            }
+        }
+        const sort = req.query['sort'] ? String(req.query['sort']) : undefined;
+        const limit = req.query['limit'] ? Number(req.query['limit']) : 20;
+        const offset = req.query['offset'] ? Number(req.query['offset']) : 0;
+        try {
+            const result = await storeBackend.list(tenantId, storeName, {
+                filter,
+                sort,
+                limit,
+                offset,
+            });
+            res.json(result);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            res.status(500).json({ error: message });
+        }
+    });
+    // Get a single document + version history
+    router.get('/api/stores/:name/:key', async (req, res) => {
+        const storeName = req.params['name'] ?? '';
+        const key = req.params['key'] ?? '';
+        // Verify store exists
+        const store = repo.stores.find((s) => s.name === storeName);
+        if (!store) {
+            res.status(404).json({ error: `Store "${storeName}" not found` });
+            return;
+        }
+        try {
+            const document = await storeBackend.get(tenantId, storeName, key);
+            if (!document) {
+                res.status(404).json({ error: `Document "${key}" not found in store "${storeName}"` });
+                return;
+            }
+            // Include history if the store has versioning configured
+            let history = [];
+            if (store.history) {
+                history = await storeBackend.history(tenantId, storeName, key);
+            }
+            res.json({ document, history });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            res.status(500).json({ error: message });
+        }
+    });
+    // Write a document to a store (for seeding/testing)
+    router.post('/api/stores/:name', async (req, res) => {
+        const storeName = req.params['name'] ?? '';
+        const store = repo.stores.find((s) => s.name === storeName);
+        if (!store) {
+            res.status(404).json({ error: `Store "${storeName}" not found` });
+            return;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Express request body
+        const payload = req.body;
+        if (!payload || typeof payload !== 'object') {
+            res.status(400).json({ error: 'Request body must be a JSON object' });
+            return;
+        }
+        // Resolve key from template
+        const keyTemplate = store.entity.key;
+        const key = keyTemplate.replace(/\{(\w+)\}/g, (_, field) => {
+            const value = payload[field];
+            if (value === undefined || value === null) {
+                return field;
+            }
+            return String(value);
+        });
+        try {
+            const result = await storeBackend.put(tenantId, storeName, key, payload, {});
+            res.status(201).json(result);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            res.status(500).json({ error: message });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=stores.js.map

package/dist/src/agent/routes/stores.js.map

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

package/dist/src/agent/routes/stores.test.d.ts

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

package/dist/src/agent/routes/stores.test.js

@@ -0,0 +1,191 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi } from 'vitest';
+import express from 'express';
+import request from 'supertest';
+import { createStoresRouter } from './stores.js';
+function makeStore(name) {
+    return {
+        name,
+        entity: {
+            name: name.charAt(0).toUpperCase() + name.slice(1),
+            key: '{id}',
+            schema: {
+                id: { type: 'string' },
+                value: { type: 'string' },
+            },
+        },
+        location: `/test/stores/${name}.json`,
+    };
+}
+function makeRepo(stores) {
+    return {
+        source: 'local',
+        origin: '/test',
+        config: {
+            name: 'test',
+            version: '1.0',
+            models: { main: { provider: 'anthropic', model: 'claude-sonnet-4-20250514' } },
+        },
+        connections: new Map(),
+        skills: [],
+        agents: { subagents: [] },
+        automations: [],
+        knowledge: [],
+        evals: [],
+        tools: [],
+        stores,
+    };
+}
+function makeMockBackend() {
+    return {
+        initialize: vi.fn(),
+        get: vi.fn(),
+        put: vi.fn(),
+        list: vi.fn(),
+        delete: vi.fn(),
+        history: vi.fn(),
+        purgeExpired: vi.fn(),
+        close: vi.fn(),
+    };
+}
+function createApp(repo, backend) {
+    const app = express();
+    app.use(express.json());
+    app.use(createStoresRouter({ repo, storeBackend: backend, tenantId: 'test-tenant' }));
+    return app;
+}
+describe('stores router', () => {
+    describe('GET /api/stores', () => {
+        it('returns store definitions with document counts', async () => {
+            const stores = [makeStore('alerts'), makeStore('deals')];
+            const repo = makeRepo(stores);
+            const backend = makeMockBackend();
+            vi.mocked(backend.list)
+                .mockResolvedValueOnce({ documents: [], total: 47, hasMore: false })
+                .mockResolvedValueOnce({ documents: [], total: 12, hasMore: false });
+            const app = createApp(repo, backend);
+            const res = await request(app).get('/api/stores');
+            expect(res.status).toBe(200);
+            expect(res.body['stores']).toHaveLength(2);
+            expect(res.body['stores'][0]['name']).toBe('alerts');
+            expect(res.body['stores'][0]['documentCount']).toBe(47);
+            expect(res.body['stores'][1]['documentCount']).toBe(12);
+        });
+        it('returns empty when no stores defined', async () => {
+            const repo = makeRepo([]);
+            const backend = makeMockBackend();
+            const app = createApp(repo, backend);
+            const res = await request(app).get('/api/stores');
+            expect(res.status).toBe(200);
+            expect(res.body['stores']).toEqual([]);
+        });
+    });
+    describe('GET /api/stores/:name', () => {
+        it('lists documents from a store', async () => {
+            const stores = [makeStore('alerts')];
+            const repo = makeRepo(stores);
+            const backend = makeMockBackend();
+            vi.mocked(backend.list).mockResolvedValue({
+                documents: [{ key: 'a', tenantId: 'test', store: 'alerts', version: 1, payload: { id: 'a' }, meta: { computedAt: '2026-01-01', stale: false } }],
+                total: 1,
+                hasMore: false,
+            });
+            const app = createApp(repo, backend);
+            const res = await request(app).get('/api/stores/alerts');
+            expect(res.status).toBe(200);
+            expect(res.body['documents']).toHaveLength(1);
+            expect(res.body['total']).toBe(1);
+        });
+        it('returns 404 for unknown store', async () => {
+            const repo = makeRepo([]);
+            const backend = makeMockBackend();
+            const app = createApp(repo, backend);
+            const res = await request(app).get('/api/stores/nonexistent');
+            expect(res.status).toBe(404);
+        });
+        it('parses filter query param', async () => {
+            const stores = [makeStore('alerts')];
+            const repo = makeRepo(stores);
+            const backend = makeMockBackend();
+            vi.mocked(backend.list).mockResolvedValue({ documents: [], total: 0, hasMore: false });
+            const app = createApp(repo, backend);
+            await request(app)
+                .get('/api/stores/alerts')
+                .query({ filter: '{"severity":"P1"}', sort: '-severity', limit: '10' });
+            expect(backend.list).toHaveBeenCalledWith('test-tenant', 'alerts', expect.objectContaining({
+                filter: { severity: 'P1' },
+                sort: '-severity',
+                limit: 10,
+            }));
+        });
+        it('returns 400 for invalid filter JSON', async () => {
+            const stores = [makeStore('alerts')];
+            const repo = makeRepo(stores);
+            const backend = makeMockBackend();
+            const app = createApp(repo, backend);
+            const res = await request(app)
+                .get('/api/stores/alerts')
+                .query({ filter: 'not json' });
+            expect(res.status).toBe(400);
+        });
+    });
+    describe('GET /api/stores/:name/:key', () => {
+        it('returns a document by key', async () => {
+            const stores = [makeStore('alerts')];
+            const repo = makeRepo(stores);
+            const backend = makeMockBackend();
+            vi.mocked(backend.get).mockResolvedValue({
+                key: 'evt_123',
+                tenantId: 'test',
+                store: 'alerts',
+                version: 2,
+                payload: { id: 'evt_123', value: 'test' },
+                meta: { computedAt: '2026-01-01', stale: false },
+            });
+            vi.mocked(backend.history).mockResolvedValue([]);
+            const app = createApp(repo, backend);
+            const res = await request(app).get('/api/stores/alerts/evt_123');
+            expect(res.status).toBe(200);
+            expect(res.body['document']['key']).toBe('evt_123');
+            expect(res.body['history']).toEqual([]);
+        });
+        it('returns 404 for missing document', async () => {
+            const stores = [makeStore('alerts')];
+            const repo = makeRepo(stores);
+            const backend = makeMockBackend();
+            vi.mocked(backend.get).mockResolvedValue(null);
+            const app = createApp(repo, backend);
+            const res = await request(app).get('/api/stores/alerts/missing');
+            expect(res.status).toBe(404);
+        });
+        it('returns 404 for unknown store', async () => {
+            const repo = makeRepo([]);
+            const backend = makeMockBackend();
+            const app = createApp(repo, backend);
+            const res = await request(app).get('/api/stores/unknown/key');
+            expect(res.status).toBe(404);
+        });
+        it('includes version history when store has history config', async () => {
+            const stores = [makeStore('alerts')];
+            stores[0].history = { versions: 3 };
+            const repo = makeRepo(stores);
+            const backend = makeMockBackend();
+            vi.mocked(backend.get).mockResolvedValue({
+                key: 'k', tenantId: 'test', store: 'alerts', version: 3,
+                payload: { id: 'k' }, meta: { computedAt: '2026-01-01', stale: false },
+            });
+            vi.mocked(backend.history).mockResolvedValue([
+                { key: 'k', tenantId: 'test', store: 'alerts', version: 2, payload: { id: 'k' }, meta: { computedAt: '2026-01-01', stale: false } },
+            ]);
+            const app = createApp(repo, backend);
+            const res = await request(app).get('/api/stores/alerts/k');
+            expect(res.status).toBe(200);
+            expect(res.body['history']).toHaveLength(1);
+        });
+    });
+});
+//# sourceMappingURL=stores.test.js.map

package/dist/src/agent/routes/stores.test.js.map

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

package/dist/src/agent/routes/task.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { Router } from 'express';
+import type { AgentSessionManager } from '../session-manager.js';
+export interface TaskRouterOptions {
+    sessionManager: AgentSessionManager;
+}
+export declare function createTaskRouter(options: TaskRouterOptions): Router;

package/dist/src/agent/routes/task.js

@@ -0,0 +1,116 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { Router } from 'express';
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { runAgentTurn } from '../agent-runner.js';
+import { SSEEventType } from '../../types.js';
+const TaskRequestSchema = z.object({
+    prompt: z.string().min(1),
+    tenant_id: z.string().min(1),
+    tenant_token: z.string().optional(),
+});
+const tasks = new Map();
+export function createTaskRouter(options) {
+    const router = Router();
+    // POST /task — fire-and-forget task
+    router.post('/task', async (req, res) => {
+        const parsed = TaskRequestSchema.safeParse(req.body);
+        if (!parsed.success) {
+            res.status(400).json({ error: { code: 'VALIDATION_ERROR', message: parsed.error.message } });
+            return;
+        }
+        const { prompt, tenant_id, tenant_token } = parsed.data;
+        const taskId = randomUUID();
+        const record = {
+            id: taskId,
+            status: 'running',
+            events: [],
+            createdAt: Date.now(),
+        };
+        tasks.set(taskId, record);
+        // Return task ID immediately
+        res.status(202).json({ task_id: taskId });
+        // Run in background
+        void (async () => {
+            try {
+                const session = await options.sessionManager.create(tenant_id, tenant_token);
+                const controller = new AbortController();
+                for await (const event of runAgentTurn(session, prompt, controller.signal)) {
+                    record.events.push(event);
+                }
+                record.status = 'completed';
+            }
+            catch (err) {
+                record.status = 'error';
+                const errMsg = err instanceof Error ? err.message : String(err);
+                record.events.push({ type: SSEEventType.Error, message: errMsg, timestamp: new Date().toISOString() });
+            }
+        })();
+    });
+    // GET /task/:id — poll task status
+    router.get('/task/:id', (req, res) => {
+        const taskId = req.params['id'];
+        if (!taskId) {
+            res.status(400).json({ error: { code: 'MISSING_ID', message: 'Task ID required' } });
+            return;
+        }
+        const record = tasks.get(taskId);
+        if (!record) {
+            res.status(404).json({ error: { code: 'NOT_FOUND', message: 'Task not found' } });
+            return;
+        }
+        res.json({
+            task_id: record.id,
+            status: record.status,
+            event_count: record.events.length,
+            created_at: record.createdAt,
+        });
+    });
+    // GET /task/:id/stream — stream task events
+    router.get('/task/:id/stream', (req, res) => {
+        const taskId = req.params['id'];
+        if (!taskId) {
+            res.status(400).json({ error: { code: 'MISSING_ID', message: 'Task ID required' } });
+            return;
+        }
+        const record = tasks.get(taskId);
+        if (!record) {
+            res.status(404).json({ error: { code: 'NOT_FOUND', message: 'Task not found' } });
+            return;
+        }
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+        });
+        // Send all existing events
+        for (const event of record.events) {
+            res.write(`data: ${JSON.stringify(event)}\n\n`);
+        }
+        if (record.status !== 'running') {
+            res.end();
+            return;
+        }
+        // Poll for new events
+        let lastSent = record.events.length;
+        const interval = setInterval(() => {
+            while (lastSent < record.events.length) {
+                res.write(`data: ${JSON.stringify(record.events[lastSent])}\n\n`);
+                lastSent++;
+            }
+            if (record.status !== 'running') {
+                clearInterval(interval);
+                res.end();
+            }
+        }, 100);
+        req.on('close', () => {
+            clearInterval(interval);
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=task.js.map

package/dist/src/agent/routes/task.js.map

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

package/dist/src/agent/routes/task.test.d.ts

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

package/dist/src/agent/routes/task.test.js

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import express from 'express';
+import request from 'supertest';
+import { createTaskRouter } from './task.js';
+// Mock agent-runner
+vi.mock('../agent-runner.js', () => ({
+    runAgentTurn: vi.fn(async function* () {
+        yield { type: 'text_delta', content: 'Task output', timestamp: new Date().toISOString() };
+        yield { type: 'done', timestamp: new Date().toISOString() };
+    }),
+}));
+function makeSessionManager() {
+    return {
+        size: 0,
+        create: vi.fn(async () => ({
+            id: 'session-1',
+            tenantId: 'tenant-1',
+            runtime: { compiledContext: { systemPrompt: 'test' } },
+            conversationHistory: [],
+            createdAt: Date.now(),
+            lastAccessedAt: Date.now(),
+            planModeManager: {},
+            exploreConfig: {},
+        })),
+        get: vi.fn(),
+        destroy: vi.fn(),
+        cleanup: vi.fn(),
+        updateRepo: vi.fn(),
+        shutdown: vi.fn(),
+    };
+}
+function createTestApp(sessionManager) {
+    const app = express();
+    app.use(express.json());
+    app.use(createTaskRouter({ sessionManager }));
+    return app;
+}
+describe('repo-task route', () => {
+    let sessionManager;
+    beforeEach(() => {
+        sessionManager = makeSessionManager();
+    });
+    it('should reject invalid request', async () => {
+        const app = createTestApp(sessionManager);
+        const res = await request(app).post('/task').send({});
+        expect(res.status).toBe(400);
+    });
+    it('should accept and return task_id', async () => {
+        const app = createTestApp(sessionManager);
+        const res = await request(app)
+            .post('/task')
+            .send({ prompt: 'do something', tenant_id: 'tenant-1' });
+        expect(res.status).toBe(202);
+        expect(res.body).toHaveProperty('task_id');
+    });
+    it('should return 404 for unknown task', async () => {
+        const app = createTestApp(sessionManager);
+        const res = await request(app).get('/task/nonexistent');
+        expect(res.status).toBe(404);
+    });
+    it('should return task status after creation', async () => {
+        const app = createTestApp(sessionManager);
+        const createRes = await request(app)
+            .post('/task')
+            .send({ prompt: 'do something', tenant_id: 'tenant-1' });
+        const taskId = createRes.body['task_id'];
+        // Give the background task a moment to complete
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        const statusRes = await request(app).get(`/task/${taskId}`);
+        expect(statusRes.status).toBe(200);
+        expect(statusRes.body).toHaveProperty('task_id', taskId);
+        expect(statusRes.body).toHaveProperty('status');
+    });
+    it('should stream task events', async () => {
+        const app = createTestApp(sessionManager);
+        const createRes = await request(app)
+            .post('/task')
+            .send({ prompt: 'do something', tenant_id: 'tenant-1' });
+        const taskId = createRes.body['task_id'];
+        // Give the background task a moment
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        const streamRes = await request(app).get(`/task/${taskId}/stream`);
+        expect(streamRes.status).toBe(200);
+    });
+});
+//# sourceMappingURL=task.test.js.map

package/dist/src/agent/routes/task.test.js.map

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

package/dist/src/agent/routes/webhooks.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { Router } from 'express';
+import type { ProactiveRunner } from '../proactive/proactive-runner.js';
+export interface WebhookRouterOptions {
+    runner: ProactiveRunner;
+    webhookSecret?: string;
+}
+/**
+ * Creates routes for receiving webhook events from external systems.
+ *
+ * POST /webhooks/:name — trigger a webhook-based automation
+ */
+export declare function createWebhookRouter(options: WebhookRouterOptions): Router;