@amodalai/runtime 0.2.0 → 0.2.1

package/dist/src/agent/automation-bridge.test.js

@@ -47,6 +47,69 @@ describe('bridgeAutomation', () => {
         expect(result.prompt).toBe(prompt);
     });
 });
+describe('bridgeAutomation env:NAME resolution', () => {
+    it('resolves env:NAME refs in delivery webhook URLs', () => {
+        process.env['TEST_WEBHOOK_URL'] = 'https://hooks.example.com/abc123';
+        try {
+            const result = bridgeAutomation(makeAutomation({
+                delivery: {
+                    targets: [{ type: 'webhook', url: 'env:TEST_WEBHOOK_URL' }],
+                },
+            }));
+            expect(result.delivery?.targets[0]).toEqual({
+                type: 'webhook',
+                url: 'https://hooks.example.com/abc123',
+            });
+        }
+        finally {
+            delete process.env['TEST_WEBHOOK_URL'];
+        }
+    });
+    it('resolves env:NAME refs in failureAlert webhook URLs', () => {
+        process.env['TEST_ALERT_URL'] = 'https://alerts.example.com/oncall';
+        try {
+            const result = bridgeAutomation(makeAutomation({
+                failureAlert: {
+                    targets: [{ type: 'webhook', url: 'env:TEST_ALERT_URL' }],
+                },
+            }));
+            expect(result.failureAlert?.targets[0]).toEqual({
+                type: 'webhook',
+                url: 'https://alerts.example.com/oncall',
+            });
+        }
+        finally {
+            delete process.env['TEST_ALERT_URL'];
+        }
+    });
+    it('leaves callback targets unchanged', () => {
+        const result = bridgeAutomation(makeAutomation({
+            delivery: {
+                targets: [{ type: 'callback', name: 'my-handler' }],
+            },
+        }));
+        expect(result.delivery?.targets[0]).toEqual({ type: 'callback', name: 'my-handler' });
+    });
+    it('leaves literal http URLs unchanged', () => {
+        const result = bridgeAutomation(makeAutomation({
+            delivery: {
+                targets: [{ type: 'webhook', url: 'https://hooks.example.com/fixed' }],
+            },
+        }));
+        expect(result.delivery?.targets[0]).toEqual({
+            type: 'webhook',
+            url: 'https://hooks.example.com/fixed',
+        });
+    });
+    it('throws at bridge time if env var is missing (fail fast at boot)', () => {
+        delete process.env['NONEXISTENT_WEBHOOK'];
+        expect(() => bridgeAutomation(makeAutomation({
+            delivery: {
+                targets: [{ type: 'webhook', url: 'env:NONEXISTENT_WEBHOOK' }],
+            },
+        }))).toThrow(/NONEXISTENT_WEBHOOK/);
+    });
+});
 describe('bridgeAutomations', () => {
     it('converts an array of automations', () => {
         const automations = [

package/dist/src/agent/automation-bridge.test.js.map

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

package/dist/src/agent/local-server.d.ts

@@ -5,11 +5,4 @@
  */
 import type { LocalServerConfig } from './agent-types.js';
 import type { ServerInstance } from '../server.js';
-/**
- * Creates an Express server for repo-based agent mode.
- *
- * Loads the `.amodal/` config from `config.repoPath`, creates a
- * `StandaloneSessionManager`, mounts all routes, and optionally watches
- * for config changes (hot reload).
- */
 export declare function createLocalServer(config: LocalServerConfig): Promise<ServerInstance>;

package/dist/src/agent/local-server.js

@@ -18,11 +18,15 @@ import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { loadRepo } from '@amodalai/core';
 import { StandaloneSessionManager } from '../session/manager.js';
-import { PGLiteSessionStore } from '../session/store.js';
+import { selectSessionStore } from '../session/session-store-selector.js';
+import { resolveEnvRef } from '../env-ref.js';
 import { buildSessionComponents } from '../session/session-builder.js';
 import { LocalToolExecutor } from './tool-executor-local.js';
 import { buildMcpConfigs } from './mcp-config.js';
 import { ConfigWatcher } from './config-watcher.js';
+import { RuntimeEventBus } from '../events/event-bus.js';
+import { createEventsRouter } from '../events/events-route.js';
+import { wrapStoreBackendWithEvents } from '../events/store-event-wrapper.js';
 import { ProactiveRunner } from './proactive/proactive-runner.js';
 import { createChatStreamRouter } from '../routes/chat-stream.js';
 import { createChatRouter } from '../routes/chat.js';
@@ -37,14 +41,20 @@ import { createStoresRouter } from './routes/stores.js';
 import { createFilesRouter } from './routes/files.js';
 import { createEvalRouter } from './routes/evals.js';
 import { errorHandler } from '../middleware/error-handler.js';
+import { asyncHandler } from '../routes/route-helpers.js';
 import { createPGLiteStoreBackend } from '../stores/pglite-store-backend.js';
-import { SessionStore } from './session-store.js';
 import { EvalStore } from './eval-store.js';
 import { buildPages } from './page-builder.js';
 import { LOCAL_APP_ID } from '../constants.js';
 import { log, createLogger } from '../logger.js';
+// Each check must use an endpoint that returns 200 on a valid key and
+// a distinct auth-failure status (typically 401) on a bad key. Do NOT
+// use endpoints with method guards that might return 405 before the
+// auth check — `GET /v1/messages` on Anthropic does exactly that, and
+// makes every key (good or bad) look invalid because Anthropic returns
+// 405 for wrong-method regardless of whether the x-api-key is real.
 const PROVIDER_CHECKS = [
-    { provider: 'anthropic', envVar: 'ANTHROPIC_API_KEY', url: 'https://api.anthropic.com/v1/messages', authHeader: (key) => ({ 'x-api-key': key, 'anthropic-version': '2023-06-01' }) },
+    { provider: 'anthropic', envVar: 'ANTHROPIC_API_KEY', url: 'https://api.anthropic.com/v1/models', authHeader: (key) => ({ 'x-api-key': key, 'anthropic-version': '2023-06-01' }) },
     { provider: 'openai', envVar: 'OPENAI_API_KEY', url: 'https://api.openai.com/v1/models', authHeader: (key) => ({ Authorization: `Bearer ${key}` }) },
 ];
 async function checkProviders() {
@@ -80,7 +90,33 @@ async function checkProviders() {
  * `StandaloneSessionManager`, mounts all routes, and optionally watches
  * for config changes (hot reload).
  */
+/**
+ * Install a process-level unhandledRejection listener that logs instead
+ * of crashing. An escaped rejection is always a bug — we want loud logs,
+ * not silent outages. The previous behavior (default Node: print + crash)
+ * turned small bugs (one leaked promise) into whole-server downtime for
+ * every active session. Logging + continuing preserves service for all
+ * other sessions while still surfacing the issue to operators.
+ *
+ * Idempotent: only installs once per process (the local-server can be
+ * created and torn down repeatedly during tests).
+ */
+let unhandledRejectionListenerInstalled = false;
+function installUnhandledRejectionLogger() {
+    if (unhandledRejectionListenerInstalled)
+        return;
+    unhandledRejectionListenerInstalled = true;
+    process.on('unhandledRejection', (reason) => {
+        const err = reason instanceof Error ? reason : new Error(String(reason));
+        log.error('unhandled_rejection', {
+            name: err.name,
+            message: err.message,
+            stack: err.stack,
+        });
+    });
+}
 export async function createLocalServer(config) {
+    installUnhandledRejectionLogger();
     let bundle = await loadRepo({ localPath: config.repoPath });
     // Check provider API keys in the background at startup
     let providerStatuses = PROVIDER_CHECKS.map((c) => ({
@@ -110,9 +146,7 @@ export async function createLocalServer(config) {
         const storeConfig = bundle.config.stores;
         const backend = storeConfig?.backend ?? 'pglite';
         if (backend === 'postgres' && storeConfig?.postgresUrl) {
-            const connUrl = storeConfig.postgresUrl.startsWith('env:')
-                ? process.env[storeConfig.postgresUrl.slice(4)] ?? ''
-                : storeConfig.postgresUrl;
+            const connUrl = resolveEnvRef(storeConfig.postgresUrl) ?? '';
             if (!connUrl) {
                 log.error('store_postgres_url_missing', { configured: storeConfig.postgresUrl });
             }
@@ -178,19 +212,41 @@ export async function createLocalServer(config) {
         }
     }
     // -------------------------------------------------------------------------
+    // Runtime event bus (powers /api/events SSE for live UI updates)
+    // -------------------------------------------------------------------------
+    const eventBus = new RuntimeEventBus({
+        onListenerError: (err, event) => {
+            log.warn('event_bus_listener_error', {
+                seq: event.seq,
+                type: event.type,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        },
+    });
+    // Wrap the store backend so every write emits store_updated events.
+    // Covers every write path through one seam: tools, REST routes, admin
+    // file tools, task execution — they all go through this backend.
+    if (storeBackend) {
+        storeBackend = wrapStoreBackendWithEvents(storeBackend, eventBus);
+    }
+    // -------------------------------------------------------------------------
     // Session manager (new standalone stack)
     // -------------------------------------------------------------------------
     const sessionLogger = createLogger({ component: 'session-manager' });
-    const sessionStore = new PGLiteSessionStore({ logger: sessionLogger });
-    await sessionStore.initialize();
+    const sessionDataDir = `${config.repoPath}/.amodal/session-data`;
+    const sessionStore = await selectSessionStore({
+        backend: bundle.config.stores?.backend,
+        postgresUrl: resolveEnvRef(bundle.config.stores?.postgresUrl),
+        logger: sessionLogger,
+        dataDir: sessionDataDir,
+    });
     const sessionManager = new StandaloneSessionManager({
         logger: sessionLogger,
         store: sessionStore,
         ttlMs: config.sessionTtlMs,
+        eventBus,
     });
     sessionManager.start();
-    // Legacy session store for UI history (file-based)
-    const legacySessionStore = new SessionStore(config.repoPath);
     // -------------------------------------------------------------------------
     // MCP connections (shared across sessions)
     // -------------------------------------------------------------------------
@@ -235,8 +291,6 @@ export async function createLocalServer(config) {
             sessionType: 'automation',
         });
         const session = sessionManager.create({
-            tenantId: 'local',
-            userId: 'automation',
             provider: components.provider,
             toolRegistry: components.toolRegistry,
             permissionChecker: components.permissionChecker,
@@ -255,9 +309,15 @@ export async function createLocalServer(config) {
         createSessionComponents: createAutomationSessionComponents,
         logger: log,
         webhookSecret: config.webhookSecret,
-        onSessionComplete: (session) => {
+        summarizeToolResult: config.summarizeToolResult,
+        onSessionComplete: (session, automationName) => {
+            // Tag the automation name onto metadata so the UI can filter
+            // sessions by automation via /sessions?automation=<name>.
+            session.metadata.automationName = automationName;
             void sessionManager.persist(session);
         },
+        eventBus,
+        onAutomationResult: config.onAutomationResult,
     });
     // -------------------------------------------------------------------------
     // Config watcher (hot reload)
@@ -327,7 +387,11 @@ export async function createLocalServer(config) {
     // Resolve resume session ID
     let resumeSessionId = config.resumeSessionId;
     if (resumeSessionId === 'latest') {
-        resumeSessionId = legacySessionStore.latest() ?? undefined;
+        const { sessions: recent } = await sessionStore.list({
+            limit: 1,
+            filter: { appId: LOCAL_APP_ID },
+        });
+        resumeSessionId = recent[0]?.id;
     }
     if (resumeSessionId) {
         log.debug('resume_session', { sessionId: resumeSessionId });
@@ -336,43 +400,48 @@ export async function createLocalServer(config) {
     app.get('/config', (_req, res) => {
         res.json({ resumeSessionId: resumeSessionId ?? null });
     });
-    // Sessions endpoints (legacy file-based store for UI history)
-    app.get('/sessions', (req, res) => {
+    // Sessions endpoints — served directly from the DrizzleSessionStore.
+    //
+    // Dev-UI consumers (sidebar Recent list, Sessions page, Automation detail
+    // page) don't paginate — they render what they get and slice the top N.
+    // A 500-session ceiling keeps the response bounded without forcing a
+    // cursor API on the client today. If dev sessions regularly exceed this,
+    // the store already supports cursor pagination via SessionListOptions.
+    const SESSION_LIST_LIMIT = 500;
+    app.get('/sessions', asyncHandler(async (req, res) => {
         const automationFilter = typeof req.query?.['automation'] === 'string' ? String(req.query['automation']) : undefined;
-        const all = legacySessionStore.list();
-        const visible = all.filter((s) => s.appId !== 'eval-runner' && s.appId !== 'admin');
-        const filtered = automationFilter ? visible.filter((s) => s.automationName === automationFilter) : visible;
-        res.json({ sessions: filtered });
-    });
-    app.get('/session/:id', (req, res) => {
-        const persisted = legacySessionStore.load(req.params['id'] ?? '');
+        // Automation filter uses metadata.automationName; otherwise restrict
+        // to chat sessions by metadata.appId (excludes eval-runner / admin).
+        const filter = automationFilter
+            ? { automationName: automationFilter }
+            : { appId: LOCAL_APP_ID };
+        const { sessions: rows } = await sessionStore.list({ limit: SESSION_LIST_LIMIT, filter });
+        const sessions = rows.map((s) => {
+            const title = typeof s.metadata['title'] === 'string' ? s.metadata['title'] : undefined;
+            const appId = typeof s.metadata['appId'] === 'string' ? s.metadata['appId'] : LOCAL_APP_ID;
+            const automationName = typeof s.metadata['automationName'] === 'string' ? s.metadata['automationName'] : undefined;
+            return {
+                id: s.id,
+                appId,
+                title,
+                summary: title ?? extractFirstUserText(s.messages) ?? 'Untitled',
+                createdAt: s.createdAt.getTime(),
+                lastAccessedAt: s.updatedAt.getTime(),
+                automationName,
+            };
+        });
+        res.json({ sessions });
+    }));
+    app.get('/session/:id', asyncHandler(async (req, res) => {
+        const persisted = await sessionStore.load(req.params['id'] ?? '');
         if (!persisted) {
             res.status(404).json({ error: 'Session not found' });
             return;
         }
-        const messages = persisted.conversationHistory.map((msg) => {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Persisted message
-            const m = msg;
-            if (m['type'] === 'user') {
-                return { role: 'user', text: String(m['text'] ?? '') };
-            }
-            if (m['type'] === 'assistant_text') {
-                return { role: 'assistant', text: String(m['text'] ?? ''), toolCalls: m['toolCalls'] };
-            }
-            if (m['role'] === 'user') {
-                return { role: 'user', text: typeof m['content'] === 'string' ? m['content'] : '' };
-            }
-            if (m['role'] === 'assistant') {
-                const blocks = Array.isArray(m['content']) ? m['content'] : [];
-                const isTextBlock = (b) => typeof b === 'object' && b !== null && 'type' in b && b['type'] === 'text' && 'text' in b;
-                const text = blocks.filter(isTextBlock).map((b) => b.text).join('');
-                return { role: 'assistant', text };
-            }
-            return { role: String(m['role'] ?? m['type'] ?? 'unknown'), text: String(m['text'] ?? '') };
-        });
+        const messages = persisted.messages.map(flattenModelMessage).filter((m) => m !== null);
         res.json({ session_id: persisted.id, messages });
-    });
-    app.patch('/session/:id', express.json(), (req, res) => {
+    }));
+    app.patch('/session/:id', express.json(), asyncHandler(async (req, res) => {
         const sessionId = req.params['id'] ?? '';
         const body = req.body;
         if (!body || typeof body !== 'object' || !('title' in body) || typeof body['title'] !== 'string') {
@@ -381,72 +450,67 @@ export async function createLocalServer(config) {
         }
         // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- validated above
         const title = body['title'];
-        const updated = legacySessionStore.updateTitle(sessionId, title);
-        if (!updated) {
-            res.status(404).json({ error: 'Session not found' });
-            return;
+        // Live session: mutate metadata on the shared object and persist so
+        // the next /sessions read reflects the new title. A concurrent
+        // runMessage may be mid-turn, but JSON.stringify runs atomically in
+        // JS's single-threaded event loop — no torn writes. The next
+        // end-of-turn persist will overwrite with the completed messages
+        // array; metadata.title stays because it's on the live session.
+        //
+        // Not-live: load → mutate → save. No race possible.
+        const live = sessionManager.get(sessionId);
+        if (live) {
+            live.metadata.title = title;
+            await sessionManager.persist(live);
         }
+        else {
+            const persisted = await sessionStore.load(sessionId);
+            if (!persisted) {
+                res.status(404).json({ error: 'Session not found' });
+                return;
+            }
+            persisted.metadata.title = title;
+            persisted.updatedAt = new Date();
+            await sessionStore.save(persisted);
+        }
+        // Emit session_updated so the sidebar picks up the new title live.
+        eventBus.emit({ type: 'session_updated', sessionId, appId: LOCAL_APP_ID, title });
         res.json({ ok: true });
-    });
-    app.delete('/session/:id', (req, res) => {
+    }));
+    app.delete('/session/:id', asyncHandler(async (req, res) => {
         const sessionId = req.params['id'] ?? '';
-        void sessionManager.destroy(sessionId);
-        const deleted = legacySessionStore.delete(sessionId);
+        await sessionManager.destroy(sessionId);
+        const deleted = await sessionStore.delete(sessionId);
         if (!deleted) {
             res.status(404).json({ error: 'Session not found' });
             return;
         }
+        eventBus.emit({ type: 'session_deleted', sessionId });
         res.json({ ok: true });
-    });
+    }));
     // File browser/editor
     app.use(createFilesRouter({ repoPath: config.repoPath }));
+    // Event bus SSE stream (live UI updates)
+    app.use(createEventsRouter({ bus: eventBus, logger: log }));
     // Evals
     const evalStore = new EvalStore(config.repoPath);
     app.use(createEvalRouter({ getBundle, evalStore, repoPath: config.repoPath, getPort: () => config.port }));
     // Feedback
     const feedbackStore = new FeedbackStore(config.repoPath);
     app.use(createFeedbackRouter({ feedbackStore }));
-    // Chat routes (new stack)
+    // Chat routes (new stack) — persistence is handled inside runMessage /
+    // route-helpers, so no explicit hooks are needed here.
     app.use(createChatStreamRouter({
         sessionManager,
         bundleResolver: { staticBundle: bundle },
         shared,
-        createStreamHooks: () => ({
-            onSessionPersist: (sessionId) => {
-                const session = sessionManager.get(sessionId);
-                if (session) {
-                    void sessionManager.persist(session);
-                    // Also mirror to the legacy file-based store so the /sessions
-                    // endpoints (read by the UI history panel) see chat sessions.
-                    // Without this, chat sessions only land in PGLite and the UI
-                    // only sees automation/task sessions. PGLite remains the source
-                    // of truth — a mirror failure is logged and swallowed (the hook
-                    // is invoked from fireDrainHooks after the response has drained,
-                    // so throwing here would break the route handler).
-                    try {
-                        legacySessionStore.save({
-                            id: session.id,
-                            appId: session.appId,
-                            title: session.metadata.title,
-                            messages: session.messages,
-                            createdAt: session.createdAt,
-                            lastAccessedAt: session.lastAccessedAt,
-                        });
-                    }
-                    catch (err) {
-                        log.warn('legacy_session_mirror_failed', {
-                            sessionId: session.id,
-                            error: err instanceof Error ? err.message : String(err),
-                        });
-                    }
-                }
-            },
-        }),
+        summarizeToolResult: config.summarizeToolResult,
     }));
     app.use(createChatRouter({
         sessionManager,
         bundleResolver: { staticBundle: bundle },
         shared,
+        summarizeToolResult: config.summarizeToolResult,
     }));
     // Task runner
     app.use(createTaskRouter({ sessionManager, createTaskSession: createAutomationSessionComponents }));
@@ -520,6 +584,8 @@ export async function createLocalServer(config) {
                     // Shared resources and session components will pick up the new
                     // bundle on next session creation via getBundle().
                     log.info('config_reloaded', { name: newBundle.config.name });
+                    eventBus.emit({ type: 'manifest_changed' });
+                    eventBus.emit({ type: 'files_changed' });
                 });
                 watcher.start();
             }
@@ -560,4 +626,82 @@ export async function createLocalServer(config) {
         },
     };
 }
+// ---------------------------------------------------------------------------
+// /sessions + /session/:id response helpers
+// ---------------------------------------------------------------------------
+/** Max length of the first-user-message excerpt shown in session lists. */
+const SUMMARY_EXCERPT_MAX = 80;
+function isRecord(x) {
+    return typeof x === 'object' && x !== null;
+}
+function isTextPart(part) {
+    return isRecord(part) && part['type'] === 'text' && typeof part['text'] === 'string';
+}
+function isToolCallPart(part) {
+    return (isRecord(part) &&
+        part['type'] === 'tool-call' &&
+        typeof part['toolCallId'] === 'string' &&
+        typeof part['toolName'] === 'string');
+}
+function getMessageRole(raw) {
+    if (!isRecord(raw))
+        return null;
+    const role = raw['role'];
+    return typeof role === 'string' ? role : null;
+}
+function getMessageContent(raw) {
+    if (!isRecord(raw))
+        return undefined;
+    return raw['content'];
+}
+/** Truncate with an ellipsis when the source exceeds the excerpt budget. */
+function excerpt(s) {
+    return s.length > SUMMARY_EXCERPT_MAX ? `${s.slice(0, SUMMARY_EXCERPT_MAX)}…` : s;
+}
+/** Extract the first user-message text from a persisted message array for list summaries. */
+function extractFirstUserText(messages) {
+    for (const raw of messages) {
+        if (getMessageRole(raw) !== 'user')
+            continue;
+        const content = getMessageContent(raw);
+        if (typeof content === 'string')
+            return excerpt(content);
+        if (Array.isArray(content)) {
+            const firstText = content.find(isTextPart);
+            if (firstText)
+                return excerpt(firstText.text);
+        }
+    }
+    return undefined;
+}
+/**
+ * Flatten a persisted `ModelMessage` (ai SDK v6) into the shape the web UI's
+ * /session/:id consumer expects: {role, text, toolCalls?}. Returns null for
+ * tool-result messages and for assistant turns with no renderable content
+ * (the history panel shows conversation + tool-call chips, not raw tool
+ * plumbing).
+ */
+function flattenModelMessage(raw) {
+    const role = getMessageRole(raw);
+    if (role !== 'user' && role !== 'assistant')
+        return null;
+    const content = getMessageContent(raw);
+    if (typeof content === 'string') {
+        return { role, text: content };
+    }
+    if (Array.isArray(content)) {
+        const text = content.filter(isTextPart).map((p) => p.text).join('');
+        const toolCalls = role === 'assistant'
+            ? content.filter(isToolCallPart).map((p) => ({
+                toolId: p.toolCallId,
+                toolName: p.toolName,
+                parameters: isRecord(p.input) ? p.input : {},
+            }))
+            : [];
+        if (text.length === 0 && toolCalls.length === 0)
+            return null;
+        return toolCalls.length > 0 ? { role, text, toolCalls } : { role, text };
+    }
+    return null;
+}
 //# sourceMappingURL=local-server.js.map