@amodalai/runtime 0.1.26 → 0.2.1

package/dist/src/events/events-route.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * SSE route for the runtime event bus.
+ *
+ * GET /api/events
+ *
+ * Clients open a single EventSource and receive every server-emitted
+ * runtime event (session_created, automation_triggered, store_updated,
+ * etc.) without polling.
+ *
+ * Reconnect-and-resume: clients may send a `Last-Event-ID` header
+ * (EventSource does this automatically on reconnect). The bus replays
+ * any buffered events with seq > Last-Event-ID before streaming live.
+ *
+ * Heartbeats: a comment line is sent every 15s so proxies don't close
+ * the connection during quiet periods.
+ */
+import { Router } from 'express';
+import type { RuntimeEventBus } from './event-bus.js';
+/** Minimal logger surface — matches the runtime's Logger interface. */
+interface EventsRouterLogger {
+    debug(event: string, data?: Record<string, unknown>): void;
+}
+export interface EventsRouterOptions {
+    bus: RuntimeEventBus;
+    /** Heartbeat interval in ms. Default 15000. */
+    heartbeatMs?: number;
+    /** Optional logger for connect/disconnect observability */
+    logger?: EventsRouterLogger;
+}
+export declare function createEventsRouter(options: EventsRouterOptions): Router;
+export {};

package/dist/src/events/events-route.js

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * SSE route for the runtime event bus.
+ *
+ * GET /api/events
+ *
+ * Clients open a single EventSource and receive every server-emitted
+ * runtime event (session_created, automation_triggered, store_updated,
+ * etc.) without polling.
+ *
+ * Reconnect-and-resume: clients may send a `Last-Event-ID` header
+ * (EventSource does this automatically on reconnect). The bus replays
+ * any buffered events with seq > Last-Event-ID before streaming live.
+ *
+ * Heartbeats: a comment line is sent every 15s so proxies don't close
+ * the connection during quiet periods.
+ */
+import { Router } from 'express';
+const HEARTBEAT_DEFAULT_MS = 15_000;
+export function createEventsRouter(options) {
+    const router = Router();
+    const { bus, logger } = options;
+    const heartbeatMs = options.heartbeatMs ?? HEARTBEAT_DEFAULT_MS;
+    router.get('/api/events', (req, res) => {
+        // Parse optional Last-Event-ID for reconnect-and-resume
+        const lastIdHeader = req.header('Last-Event-ID');
+        let sinceSeq;
+        if (lastIdHeader) {
+            const parsed = Number.parseInt(lastIdHeader, 10);
+            if (Number.isFinite(parsed) && parsed >= 0) {
+                sinceSeq = parsed;
+            }
+        }
+        logger?.debug('events_client_connected', {
+            sinceSeq,
+            listenerCount: bus.listenerCount + 1,
+        });
+        // SSE response headers
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache, no-transform');
+        res.setHeader('Connection', 'keep-alive');
+        // Disable nginx response buffering for SSE
+        res.setHeader('X-Accel-Buffering', 'no');
+        res.flushHeaders();
+        // Subscribe to the bus. `subscribe` replays buffered events > sinceSeq
+        // synchronously, then hands live events to the listener.
+        const unsubscribe = bus.subscribe((event) => {
+            // SSE frame: id + event + data. `id:` lets EventSource resume.
+            res.write(`id: ${String(event.seq)}\n`);
+            res.write(`event: ${event.type}\n`);
+            res.write(`data: ${JSON.stringify(event)}\n\n`);
+        }, sinceSeq);
+        // Heartbeat: SSE comment line every N seconds. Keeps proxies from
+        // closing an idle connection and lets the client detect drops.
+        const heartbeat = setInterval(() => {
+            res.write(':\n\n');
+        }, heartbeatMs);
+        // Clean up on disconnect
+        let cleanedUp = false;
+        const cleanup = () => {
+            if (cleanedUp)
+                return;
+            cleanedUp = true;
+            clearInterval(heartbeat);
+            unsubscribe();
+            logger?.debug('events_client_disconnected', {
+                listenerCount: bus.listenerCount,
+            });
+        };
+        req.on('close', cleanup);
+        req.on('error', cleanup);
+        res.on('close', cleanup);
+    });
+    return router;
+}
+//# sourceMappingURL=events-route.js.map

package/dist/src/events/events-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-route.js","sourceRoot":"","sources":["../../../src/events/events-route.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAC,MAAM,EAAC,MAAM,SAAS,CAAC;AAiB/B,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,EAAC,GAAG,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IAC9B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;IAEhE,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACxD,wDAAwD;QACxD,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,QAA4B,CAAC;QACjC,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAC3C,QAAQ,GAAG,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;QAED,MAAM,EAAE,KAAK,CAAC,yBAAyB,EAAE;YACvC,QAAQ;YACR,aAAa,EAAE,GAAG,CAAC,aAAa,GAAG,CAAC;SACrC,CAAC,CAAC;QAEH,uBAAuB;QACvB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QACnD,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;QACzD,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC1C,2CAA2C;QAC3C,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,YAAY,EAAE,CAAC;QAEnB,uEAAuE;QACvE,yDAAyD;QACzD,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1C,+DAA+D;YAC/D,GAAG,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxC,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;YACpC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC,EAAE,QAAQ,CAAC,CAAC;QAEb,kEAAkE;QAClE,+DAA+D;QAC/D,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC,EAAE,WAAW,CAAC,CAAC;QAEhB,yBAAyB;QACzB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,WAAW,EAAE,CAAC;YACd,MAAM,EAAE,KAAK,CAAC,4BAA4B,EAAE;gBAC1C,aAAa,EAAE,GAAG,CAAC,aAAa;aACjC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/events/events-route.test.d.ts

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

package/dist/src/events/events-route.test.js

@@ -0,0 +1,134 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import express from 'express';
+import { RuntimeEventBus } from './event-bus.js';
+import { createEventsRouter } from './events-route.js';
+function startServer(bus) {
+    const app = express();
+    app.use(createEventsRouter({ bus, heartbeatMs: 60_000 }));
+    return new Promise((resolve) => {
+        const server = app.listen(0, () => {
+            const address = server.address();
+            const port = address && typeof address === 'object' ? address.port : 0;
+            resolve({ port, server, bus });
+        });
+    });
+}
+function closeServer(server) {
+    return new Promise((resolve) => {
+        server.close(() => resolve());
+    });
+}
+async function collectEvents(url, expected, opts = {}) {
+    const headers = { Accept: 'text/event-stream' };
+    if (opts.lastEventId)
+        headers['Last-Event-ID'] = opts.lastEventId;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), opts.timeoutMs ?? 2000);
+    const res = await fetch(url, { headers, signal: controller.signal });
+    if (!res.body)
+        throw new Error('no response body');
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    const collected = [];
+    let buffer = '';
+    try {
+        while (collected.length < expected) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let idx;
+            while ((idx = buffer.indexOf('\n\n')) !== -1) {
+                const frame = buffer.slice(0, idx);
+                buffer = buffer.slice(idx + 2);
+                const dataLine = frame.split('\n').find((l) => l.startsWith('data:'));
+                if (dataLine) {
+                    const json = dataLine.slice(5).trim();
+                    collected.push(JSON.parse(json));
+                    if (collected.length >= expected)
+                        break;
+                }
+            }
+        }
+    }
+    finally {
+        clearTimeout(timeout);
+        controller.abort();
+        reader.cancel().catch(() => { });
+    }
+    return collected;
+}
+describe('events SSE route', () => {
+    let harness = null;
+    afterEach(async () => {
+        if (harness) {
+            await closeServer(harness.server);
+            harness = null;
+        }
+    });
+    it('streams emitted events to connected clients', async () => {
+        const bus = new RuntimeEventBus();
+        harness = await startServer(bus);
+        const url = `http://127.0.0.1:${String(harness.port)}/api/events`;
+        const eventsPromise = collectEvents(url, 2, { timeoutMs: 2000 });
+        setTimeout(() => {
+            bus.emit({ type: 'session_created', sessionId: 's1', appId: 'local' });
+            bus.emit({ type: 'manifest_changed' });
+        }, 50);
+        const events = await eventsPromise;
+        expect(events).toHaveLength(2);
+        expect(events[0]?.['type']).toBe('session_created');
+        expect(events[0]?.['seq']).toBe(1);
+        expect(events[1]?.['type']).toBe('manifest_changed');
+        expect(events[1]?.['seq']).toBe(2);
+    });
+    it('replays buffered events matching Last-Event-ID', async () => {
+        const bus = new RuntimeEventBus();
+        harness = await startServer(bus);
+        const url = `http://127.0.0.1:${String(harness.port)}/api/events`;
+        bus.emit({ type: 'session_created', sessionId: 's1', appId: 'local' });
+        bus.emit({ type: 'session_created', sessionId: 's2', appId: 'local' });
+        bus.emit({ type: 'session_created', sessionId: 's3', appId: 'local' });
+        const events = await collectEvents(url, 2, { lastEventId: '1', timeoutMs: 2000 });
+        expect(events).toHaveLength(2);
+        expect(events[0]?.['seq']).toBe(2);
+        expect(events[1]?.['seq']).toBe(3);
+    });
+    it('includes id and event headers in SSE frames', async () => {
+        const bus = new RuntimeEventBus();
+        harness = await startServer(bus);
+        const url = `http://127.0.0.1:${String(harness.port)}/api/events`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(url, {
+            headers: { Accept: 'text/event-stream' },
+            signal: controller.signal,
+        });
+        if (!res.body)
+            throw new Error('no response body');
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        setTimeout(() => {
+            bus.emit({ type: 'manifest_changed' });
+        }, 50);
+        let raw = '';
+        while (!raw.includes('\n\n')) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            raw += decoder.decode(value, { stream: true });
+        }
+        clearTimeout(timeout);
+        controller.abort();
+        reader.cancel().catch(() => { });
+        expect(raw).toContain('id: 1');
+        expect(raw).toContain('event: manifest_changed');
+        expect(raw).toContain('data: {"type":"manifest_changed"');
+    });
+});
+//# sourceMappingURL=events-route.test.js.map

package/dist/src/events/events-route.test.js.map

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

package/dist/src/events/store-event-wrapper.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Wraps a `StoreBackend` so every successful write emits a `store_updated`
+ * event to the runtime event bus. Read operations pass through unchanged.
+ *
+ * Instrumenting at the backend level (rather than each call site: tools,
+ * REST routes, admin file tools, task execution) means we cover every
+ * write path through one seam.
+ */
+import type { StoreBackend, RuntimeEventPayload } from '@amodalai/types';
+interface StoreEventSink {
+    emit: (payload: RuntimeEventPayload) => unknown;
+}
+export declare function wrapStoreBackendWithEvents(inner: StoreBackend, bus: StoreEventSink): StoreBackend;
+export {};

package/dist/src/events/store-event-wrapper.js

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export function wrapStoreBackendWithEvents(inner, bus) {
+    return {
+        initialize(stores) {
+            return inner.initialize(stores);
+        },
+        get(appId, store, key) {
+            return inner.get(appId, store, key);
+        },
+        list(appId, store, opts) {
+            return inner.list(appId, store, opts);
+        },
+        history(appId, store, key) {
+            return inner.history(appId, store, key);
+        },
+        async put(appId, store, key, payload, meta) {
+            const result = await inner.put(appId, store, key, payload, meta);
+            bus.emit({
+                type: 'store_updated',
+                storeName: store,
+                operation: 'put',
+            });
+            return result;
+        },
+        async delete(appId, store, key) {
+            const result = await inner.delete(appId, store, key);
+            if (result) {
+                bus.emit({
+                    type: 'store_updated',
+                    storeName: store,
+                    operation: 'delete',
+                });
+            }
+            return result;
+        },
+        async purgeExpired(appId, store) {
+            const count = await inner.purgeExpired(appId, store);
+            if (count > 0) {
+                bus.emit({
+                    type: 'store_updated',
+                    storeName: store ?? '*',
+                    operation: 'delete',
+                    count,
+                });
+            }
+            return count;
+        },
+        close() {
+            return inner.close();
+        },
+    };
+}
+//# sourceMappingURL=store-event-wrapper.js.map

package/dist/src/events/store-event-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-event-wrapper.js","sourceRoot":"","sources":["../../../src/events/store-event-wrapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,MAAM,UAAU,0BAA0B,CACxC,KAAmB,EACnB,GAAmB;IAEnB,OAAO;QACL,UAAU,CAAC,MAAqB;YAC9B,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW;YAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,KAAa,EAAE,KAAa,EAAE,IAAuB;YACxD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW;YAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,KAAK,CAAC,GAAG,CACP,KAAa,EACb,KAAa,EACb,GAAW,EACX,OAAgC,EAChC,IAAgC;YAEhC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACjE,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,eAAe;gBACrB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW;YACpD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACrD,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,eAAe;oBACrB,SAAS,EAAE,KAAK;oBAChB,SAAS,EAAE,QAAQ;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,KAAc;YAC9C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACrD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,eAAe;oBACrB,SAAS,EAAE,KAAK,IAAI,GAAG;oBACvB,SAAS,EAAE,QAAQ;oBACnB,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK;YACH,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/events/store-event-wrapper.test.d.ts

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

package/dist/src/events/store-event-wrapper.test.js

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { wrapStoreBackendWithEvents } from './store-event-wrapper.js';
+import { RuntimeEventBus } from './event-bus.js';
+function makeStubBackend(overrides = {}) {
+    return {
+        initialize: vi.fn().mockResolvedValue(undefined),
+        get: vi.fn().mockResolvedValue(null),
+        list: vi.fn().mockResolvedValue({ rows: [], total: 0 }),
+        history: vi.fn().mockResolvedValue([]),
+        put: vi.fn().mockResolvedValue({ version: 1, stale: false }),
+        delete: vi.fn().mockResolvedValue(true),
+        purgeExpired: vi.fn().mockResolvedValue(0),
+        close: vi.fn().mockResolvedValue(undefined),
+        ...overrides,
+    };
+}
+describe('wrapStoreBackendWithEvents', () => {
+    it('emits store_updated on successful put', async () => {
+        const bus = new RuntimeEventBus();
+        const emits = [];
+        bus.subscribe((e) => emits.push({ type: e.type, storeName: e.storeName, operation: e.operation }));
+        const wrapped = wrapStoreBackendWithEvents(makeStubBackend(), bus);
+        await wrapped.put('local', 'leads', 'k1', { x: 1 }, {});
+        expect(emits).toHaveLength(1);
+        expect(emits[0]).toEqual({ type: 'store_updated', storeName: 'leads', operation: 'put' });
+    });
+    it('emits store_updated on successful delete', async () => {
+        const bus = new RuntimeEventBus();
+        const emits = [];
+        bus.subscribe((e) => emits.push(e));
+        const wrapped = wrapStoreBackendWithEvents(makeStubBackend(), bus);
+        await wrapped.delete('local', 'leads', 'k1');
+        expect(emits).toHaveLength(1);
+        expect(emits[0]?.['type']).toBe('store_updated');
+        expect(emits[0]?.['operation']).toBe('delete');
+    });
+    it('does NOT emit on delete that returns false (not found)', async () => {
+        const bus = new RuntimeEventBus();
+        const emits = [];
+        bus.subscribe((e) => emits.push(e));
+        const wrapped = wrapStoreBackendWithEvents(makeStubBackend({ delete: vi.fn().mockResolvedValue(false) }), bus);
+        await wrapped.delete('local', 'leads', 'missing');
+        expect(emits).toHaveLength(0);
+    });
+    it('emits store_updated with count on purgeExpired', async () => {
+        const bus = new RuntimeEventBus();
+        const emits = [];
+        bus.subscribe((e) => emits.push(e));
+        const wrapped = wrapStoreBackendWithEvents(makeStubBackend({ purgeExpired: vi.fn().mockResolvedValue(3) }), bus);
+        await wrapped.purgeExpired('local', 'leads');
+        expect(emits).toHaveLength(1);
+        expect(emits[0]?.['count']).toBe(3);
+        expect(emits[0]?.['storeName']).toBe('leads');
+    });
+    it('does NOT emit on purgeExpired that deletes nothing', async () => {
+        const bus = new RuntimeEventBus();
+        const emits = [];
+        bus.subscribe((e) => emits.push(e));
+        const wrapped = wrapStoreBackendWithEvents(makeStubBackend(), bus);
+        await wrapped.purgeExpired('local');
+        expect(emits).toHaveLength(0);
+    });
+    it('passes read operations through unchanged without emitting', async () => {
+        const bus = new RuntimeEventBus();
+        const emits = [];
+        bus.subscribe((e) => emits.push(e));
+        const inner = makeStubBackend();
+        const wrapped = wrapStoreBackendWithEvents(inner, bus);
+        await wrapped.get('local', 'leads', 'k1');
+        await wrapped.list('local', 'leads');
+        await wrapped.history('local', 'leads', 'k1');
+        expect(emits).toHaveLength(0);
+        expect(inner.get).toHaveBeenCalled();
+        expect(inner.list).toHaveBeenCalled();
+        expect(inner.history).toHaveBeenCalled();
+    });
+    it('propagates put/delete errors without emitting', async () => {
+        const bus = new RuntimeEventBus();
+        const emits = [];
+        bus.subscribe((e) => emits.push(e));
+        const wrapped = wrapStoreBackendWithEvents(makeStubBackend({ put: vi.fn().mockRejectedValue(new Error('disk full')) }), bus);
+        await expect(wrapped.put('local', 'leads', 'k1', {}, {})).rejects.toThrow('disk full');
+        expect(emits).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=store-event-wrapper.test.js.map

package/dist/src/events/store-event-wrapper.test.js.map

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

package/dist/src/index.d.ts

@@ -4,26 +4,27 @@
  * SPDX-License-Identifier: MIT
  */
 export declare const SERVER_VERSION = "0.1.0";
+export { createAgent } from './api/create-agent.js';
+export type { Agent, AgentConfig, AgentSession } from './api/types.js';
 export { createServer } from './server.js';
 export type { ServerInstance, CreateServerOptions } from './server.js';
 export type { ServerConfig } from './types.js';
 export { createAIStreamRouter, type AIStreamRouterOptions } from './routes/ai-stream.js';
 export { createLocalServer } from './agent/local-server.js';
-export type { LocalServerConfig, AgentChatRequest, AgentSession } from './agent/agent-types.js';
-export { SessionManager } from './session/session-manager.js';
-export type { ManagedSession, SessionManagerOptions, SessionStore, StoredSessionRecord } from './session/session-manager.js';
+export type { LocalServerConfig, AgentChatRequest } from './agent/agent-types.js';
 export { ProactiveRunner } from './agent/proactive/proactive-runner.js';
 export type { AutomationInfo, ProactiveRunnerConfig } from './agent/proactive/proactive-runner.js';
 export { createSnapshotServer } from './agent/snapshot-server.js';
 export type { SnapshotServerConfig } from './agent/snapshot-server.js';
 export { createChatStreamRouter } from './routes/chat-stream.js';
 export type { ChatStreamRouterOptions } from './routes/chat-stream.js';
+export { createChatRouter } from './routes/chat.js';
+export type { ChatRouterOptions } from './routes/chat.js';
 export { createTaskRouter } from './agent/routes/task.js';
 export type { TaskRouterOptions } from './agent/routes/task.js';
 export { getAuthContext } from './middleware/auth.js';
 export type { AuthContext } from './middleware/auth.js';
-export type { StreamHooks } from './session/session-runner.js';
-export { runMessage } from './session/session-runner.js';
+export type { StreamHooks, TokenCounts } from './session/stream-hooks.js';
 export { routeOutput } from './output/output-router.js';
 export { errorHandler } from './middleware/error-handler.js';
 export { AmodalError, ProviderError, RateLimitError, ProviderTimeoutError, ToolExecutionError, StoreError, ConnectionError, SessionError, CompactionError, ConfigError, } from './errors.js';
@@ -31,4 +32,30 @@ export type { Result } from './errors.js';
 export { log, setLogLevel, getLogLevel, setLogFormat, getLogFormat, setSanitize, LogLevel, initLogLevel, interceptConsole, verbosityToLogLevel, createLogger } from './logger.js';
 export type { Logger, LoggerConfig, LogFormat } from './logger.js';
 export { loadConfig } from './config.js';
-export type { AgentConfig, ConfigOverrides, LoadConfigOptions, McpServerConfig } from './config.js';
+export type { AgentConfig as LegacyAgentConfig, ConfigOverrides, LoadConfigOptions, McpServerConfig } from './config.js';
+export { createProvider } from './providers/create-provider.js';
+export { createFailoverProvider } from './providers/failover.js';
+export type { FailoverChainConfig } from './providers/failover.js';
+export type { LLMProvider, ProviderConfig, StreamTextOptions, StreamTextResult, GenerateTextOptions, GenerateTextResult, TokenUsage, StreamEvent, } from './providers/types.js';
+export { runAgent, transition } from './agent/loop.js';
+export type { AgentState, AgentContext, AgentLoopConfig, TransitionResult, RunAgentOptions, ToolCall, ToolResult, DoneReason, ThinkingState, StreamingState, ExecutingState, ConfirmingState, CompactingState, DispatchingState, DoneState, DispatchConfig, } from './agent/loop-types.js';
+export { DEFAULT_LOOP_CONFIG } from './agent/loop-types.js';
+export { createToolRegistry } from './tools/registry.js';
+export type { ToolDefinition, ToolContext, ToolCategory, ToolMetadata, ToolRegistry, } from './tools/types.js';
+export { createMcpToolDefinition, registerMcpTools, } from './tools/mcp-tool-adapter.js';
+export { createStoreWriteTool, createStoreBatchTool, createStoreQueryTool, registerStoreTools, storeToToolName, QUERY_STORE_TOOL_NAME, } from './tools/store-tools.js';
+export { createRequestTool, REQUEST_TOOL_NAME } from './tools/request-tool.js';
+export type { ConnectionsMap, CreateRequestToolOptions } from './tools/request-tool.js';
+export { createReadRepoFileTool, createWriteRepoFileTool, createDeleteRepoFileTool, createInternalApiTool, registerAdminFileTools, } from './tools/admin-file-tools.js';
+export { StandaloneSessionManager } from './session/manager.js';
+export type { Session, CreateSessionOptions, SessionManagerOptions as StandaloneSessionManagerOptions, TurnUsage, AutomationResult, PersistedSession, } from './session/types.js';
+export { buildSessionComponents, PRESENT_TOOL_NAME, STOP_EXECUTION_TOOL_NAME } from './session/session-builder.js';
+export type { SessionComponents, BuildSessionComponentsOptions, SessionType } from './session/session-builder.js';
+export { createToolContextFactory } from './session/tool-context-factory.js';
+export type { ToolContextFactoryOptions } from './session/tool-context-factory.js';
+export { resolveSession, resolveBundle } from './routes/session-resolver.js';
+export type { BundleResolver, SharedResources, ResolvedSession, ResolveSessionOptions } from './routes/session-resolver.js';
+export { compileContext } from './context/compiler.js';
+export type { CompilerInput, CompilerOutput, CompilerContribution, CompilerConnection, CompilerSkill, CompilerKnowledge, CompilerStore, } from './context/types.js';
+export { AccessJsonPermissionChecker } from './security/permission-checker.js';
+export type { PermissionChecker, PermissionResult, PermissionCheckRequest, } from './security/permission-checker.js';

package/dist/src/index.js

@@ -6,21 +6,26 @@
 import { createServer } from './server.js';
 import { log } from './logger.js';
 export const SERVER_VERSION = '0.1.0';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export { createAgent } from './api/create-agent.js';
+// ---------------------------------------------------------------------------
 // Re-export for consumers
+// ---------------------------------------------------------------------------
 export { createServer } from './server.js';
 export { createAIStreamRouter } from './routes/ai-stream.js';
 // Local mode
 export { createLocalServer } from './agent/local-server.js';
-export { SessionManager } from './session/session-manager.js';
 export { ProactiveRunner } from './agent/proactive/proactive-runner.js';
 // Snapshot mode
 export { createSnapshotServer } from './agent/snapshot-server.js';
 // Route creators (used by hosted-runtime to build its own server)
 export { createChatStreamRouter } from './routes/chat-stream.js';
+export { createChatRouter } from './routes/chat.js';
 export { createTaskRouter } from './agent/routes/task.js';
 // Auth types (middleware implementation provided by hosting layer)
 export { getAuthContext } from './middleware/auth.js';
-export { runMessage } from './session/session-runner.js';
 // Output routing (for automation result delivery)
 export { routeOutput } from './output/output-router.js';
 // Error handler
@@ -31,6 +36,34 @@ export { AmodalError, ProviderError, RateLimitError, ProviderTimeoutError, ToolE
 export { log, setLogLevel, getLogLevel, setLogFormat, getLogFormat, setSanitize, LogLevel, initLogLevel, interceptConsole, verbosityToLogLevel, createLogger } from './logger.js';
 // Config
 export { loadConfig } from './config.js';
+// LLM Provider (Vercel AI SDK abstraction)
+export { createProvider } from './providers/create-provider.js';
+export { createFailoverProvider } from './providers/failover.js';
+// Agent loop (state machine)
+export { runAgent, transition } from './agent/loop.js';
+export { DEFAULT_LOOP_CONFIG } from './agent/loop-types.js';
+// Tool registry
+export { createToolRegistry } from './tools/registry.js';
+// MCP tool adapter
+export { createMcpToolDefinition, registerMcpTools, } from './tools/mcp-tool-adapter.js';
+// Store tools (new Zod-based implementations)
+export { createStoreWriteTool, createStoreBatchTool, createStoreQueryTool, registerStoreTools, storeToToolName, QUERY_STORE_TOOL_NAME, } from './tools/store-tools.js';
+// Connection request tool
+export { createRequestTool, REQUEST_TOOL_NAME } from './tools/request-tool.js';
+// Admin file tools
+export { createReadRepoFileTool, createWriteRepoFileTool, createDeleteRepoFileTool, createInternalApiTool, registerAdminFileTools, } from './tools/admin-file-tools.js';
+// Standalone session manager
+export { StandaloneSessionManager } from './session/manager.js';
+// Session builder
+export { buildSessionComponents, PRESENT_TOOL_NAME, STOP_EXECUTION_TOOL_NAME } from './session/session-builder.js';
+// Tool context factory
+export { createToolContextFactory } from './session/tool-context-factory.js';
+// Session resolver
+export { resolveSession, resolveBundle } from './routes/session-resolver.js';
+// Context compiler
+export { compileContext } from './context/compiler.js';
+// Permission checker
+export { AccessJsonPermissionChecker } from './security/permission-checker.js';
 // ---------------------------------------------------------------------------
 // Environment variable parsing
 // ---------------------------------------------------------------------------
@@ -52,30 +85,11 @@ async function main() {
     const port = getEnvInt('PORT', 3000);
     const host = getEnvOrDefault('HOST', '0.0.0.0');
     const sessionTtlMs = getEnvInt('SESSION_TTL_MS', 30 * 60 * 1000);
-    // LLM config comes from env. Default matches the platform API default.
-    const model = getEnvOrDefault('MODEL', 'claude-sonnet-4-20250514');
-    // WORKSPACE_DIR scopes file tools and shell_exec. In Docker, set to
-    // /workspace so the agent cannot read server source code. When unset,
-    // falls back to process.cwd() for local dev.
-    const workspaceDir = process.env['WORKSPACE_DIR'] || process.cwd();
-    // Base config params — minimal, org-agnostic defaults.
-    // Org-specific config (tools, skills, knowledge, base_prompt, agent_context)
-    // loaded per session using the API key from each request.
-    const baseParams = {
-        sessionId: 'server-init',
-        model,
-        cwd: workspaceDir,
-        targetDir: workspaceDir,
-        debugMode: process.env['DEBUG'] === 'true',
-        interactive: false,
-        noBrowser: true,
-    };
     // Create and start server
     let serverInstance;
     try {
         const corsOrigin = process.env['CORS_ORIGIN'] || undefined;
         serverInstance = createServer({
-            baseParams,
             config: {
                 port,
                 host,