@amodalai/runtime 0.3.49 → 0.3.50

package/dist/src/session/manager.js

@@ -15,6 +15,7 @@
 import { randomUUID } from 'node:crypto';
 import { runAgent } from '../agent/loop.js';
 import { DEFAULT_LOOP_CONFIG } from '../agent/loop-types.js';
+import { matchIntent, runIntent } from '../intent/index.js';
 import { SSEEventType } from '../types.js';
 import { SessionError } from '../errors.js';
 import { VISION_PROVIDERS } from '../providers/types.js';
@@ -132,6 +133,7 @@ export class StandaloneSessionManager {
             maxContextTokens: opts.maxContextTokens ?? this.defaultMaxContextTokens,
             maxSessionTokens: opts.maxSessionTokens ?? this.defaultMaxSessionTokens,
             toolContextFactory: opts.toolContextFactory,
+            intents: opts.intents ?? [],
         };
         this.sessions.set(id, session);
         this.logger.info('session_created', {
@@ -186,6 +188,118 @@ export class StandaloneSessionManager {
                 timestamp: new Date().toISOString(),
             };
         }
+        // Intent routing — deterministic shortcut layer in front of the
+        // agent loop. Tested only when the user message is plain text;
+        // multimodal turns (image-bearing) always go to the LLM since
+        // intent regexes are textual. First-match-wins; on a clean
+        // completion we skip the agent loop entirely. On fall-through
+        // (handler returned null before any tool ran) we proceed to the
+        // LLM as if no intent existed.
+        if (session.intents.length > 0 && images.length === 0) {
+            const matched = matchIntent(session.intents, userMessage);
+            if (matched) {
+                // Single-line route marker — easy to grep + visible in dev
+                // (passesQuietFilter passes `intent_` lines through). Pairs
+                // with the route_llm log below so each turn reports exactly
+                // one route decision.
+                session.logger.info('route_intent', {
+                    sessionId: session.id,
+                    intentId: matched.intent.id,
+                    userMessagePreview: userMessage.slice(0, 80),
+                });
+                const buildToolContext = opts?.buildToolContext ?? makeNoOpToolContext(session);
+                const intentGen = runIntent({
+                    match: matched,
+                    userMessage,
+                    sessionId: session.id,
+                    scopeId: session.scopeId,
+                    toolRegistry: session.toolRegistry,
+                    buildToolContext,
+                    logger: session.logger,
+                });
+                let next = await intentGen.next();
+                while (!next.done) {
+                    yield next.value;
+                    next = await intentGen.next();
+                }
+                const outcome = next.value;
+                if (outcome.kind === 'completed') {
+                    session.messages = [
+                        ...session.messages,
+                        outcome.assistantMessage,
+                        ...outcome.toolMessages,
+                    ];
+                    if (this.store) {
+                        await this.persist(session);
+                    }
+                    return;
+                }
+                if (outcome.kind === 'completedContinue') {
+                    // Intent did its deterministic part — validate, persist,
+                    // whatever — then handed off to the LLM for the next-step
+                    // rendering (multi-option ask_choice, conversational
+                    // framing, optional-batch copy). Append the synthetic
+                    // messages so the LLM sees the new state, then fall
+                    // through to the agent loop. The agent loop emits its own
+                    // Done event when the LLM turn finishes; runIntent
+                    // suppresses the intent-side Done so we don't double-fire.
+                    session.messages = [
+                        ...session.messages,
+                        outcome.assistantMessage,
+                        ...outcome.toolMessages,
+                    ];
+                    if (this.store) {
+                        await this.persist(session);
+                    }
+                    session.logger.info('route_llm', {
+                        sessionId: session.id,
+                        reason: 'intent_continued',
+                        intentId: matched.intent.id,
+                    });
+                    // Fall through to agent loop below.
+                }
+                else if (outcome.kind === 'errored') {
+                    // Intent emitted an error SSE; the user has the failure
+                    // visible. Don't fall through — they retry or type
+                    // something more general (which won't match any intent
+                    // and will hit the LLM next turn).
+                    if (this.store) {
+                        await this.persist(session);
+                    }
+                    return;
+                }
+                else {
+                    // outcome.kind === 'fellThrough' — fall through to the LLM.
+                    // No SSE events emitted, no messages appended; the agent
+                    // loop runs as if intent routing never happened. Log the
+                    // route flip so the dev terminal shows why the LLM ran.
+                    session.logger.info('route_llm', {
+                        sessionId: session.id,
+                        reason: 'intent_fell_through',
+                        intentId: matched.intent.id,
+                    });
+                }
+            }
+            else {
+                session.logger.info('route_llm', {
+                    sessionId: session.id,
+                    reason: 'no_intent_match',
+                    userMessagePreview: userMessage.slice(0, 80),
+                });
+            }
+        }
+        else if (session.intents.length === 0) {
+            session.logger.info('route_llm', {
+                sessionId: session.id,
+                reason: 'no_intents_loaded',
+            });
+        }
+        else if (images.length > 0) {
+            session.logger.info('route_llm', {
+                sessionId: session.id,
+                reason: 'multimodal_skips_intent',
+            });
+        }
         // Build AgentContext from Session
         const ctx = {
             provider: session.provider,

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

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

package/dist/src/session/session-builder.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2026 Amodal Labs, Inc.
  * SPDX-License-Identifier: MIT
  */
-import type { AgentBundle, CustomToolExecutor, StoreBackend } from '@amodalai/types';
+import type { AgentBundle, CustomToolExecutor, StoreBackend, IntentDefinition } from '@amodalai/types';
 import type { McpManager, AdminAgentContent, FieldScrubber } from '@amodalai/core';
 import type { LLMProvider } from '../providers/types.js';
 import type { ToolRegistry, ToolContext } from '../tools/types.js';
@@ -21,6 +21,13 @@ export interface SessionComponents {
     permissionChecker: PermissionChecker;
     systemPrompt: string;
     toolContextFactory: (callId: string) => ToolContext;
+    /**
+     * Deterministic intents loaded from `<repoPath>/intents/` at session
+     * build time. Empty when the repo doesn't have an `intents/` dir
+     * (most agents) — `runMessage` short-circuits the intent path on
+     * empty arrays so this is zero-cost when unused.
+     */
+    intents: IntentDefinition[];
 }
 /** Options for building session components. */
 export interface BuildSessionComponentsOptions {
@@ -71,6 +78,14 @@ export interface BuildSessionComponentsOptions {
      * resolver rather than left as literal strings.
      */
     credentialResolver?: CredentialResolver;
+    /**
+     * Pre-loaded intents from the agent's `intents/` directory. The
+     * caller is responsible for loading these (via `loadIntents`)
+     * because intent loading involves esbuild compile + dynamic
+     * import, which is async — `buildSessionComponents` itself stays
+     * sync. Default: empty array.
+     */
+    intents?: IntentDefinition[];
 }
 declare const PRESENT_TOOL_NAME = "present";
 declare const STOP_EXECUTION_TOOL_NAME = "stop_execution";

package/dist/src/session/session-builder.js

@@ -22,8 +22,9 @@ import { registerStoreTools } from '../tools/store-tools.js';
 import { createRequestTool, REQUEST_TOOL_NAME } from '../tools/request-tool.js';
 import { createCustomToolDefinition } from '../tools/custom-tool-adapter.js';
 import { LocalFsBackend } from '../tools/fs/local.js';
-import { HttpFsBackend } from '../tools/fs/http.js';
-import { registerHttpFileTools } from '../tools/http-file-tools.js';
+import { getDb, getSetupState, upsertSetupState, markComplete, deleteSetupState, } from '@amodalai/db';
+import { composePlan } from '@amodalai/core';
+import { commitSetup } from '../setup/commit-setup.js';
 import { registerMcpTools } from '../tools/mcp-tool-adapter.js';
 import { AccessJsonPermissionChecker, } from '../security/permission-checker.js';
 import { compileContext } from '../context/compiler.js';
@@ -37,8 +38,8 @@ import { createWebSearchTool, WEB_SEARCH_TOOL_NAME } from '../tools/web-search-t
 import { createFetchUrlTool, FETCH_URL_TOOL_NAME } from '../tools/fetch-url-tool.js';
 import { createMemoryTool, MEMORY_TOOL_NAME } from '../tools/memory-tool.js';
 import { registerFileTools, DEFAULT_ALLOWED_DIRS, DEFAULT_BLOCKED_FILES } from '../tools/file-tools.js';
-import { registerCollectSecretTool } from '../tools/collect-secret-tool.js';
-import { registerAgentConfigTool } from '../tools/agent-config-tool.js';
+import { registerAdminTools } from '../tools/admin-tools.js';
+import { ASK_CHOICE_TOOL_NAME, createAskChoiceTool } from '../tools/builtin/ask-choice.js';
 // ---------------------------------------------------------------------------
 // Present tool (system tool)
 // ---------------------------------------------------------------------------
@@ -74,6 +75,8 @@ Widget selection:
         }),
         readOnly: true,
         metadata: { category: 'system' },
+        runningLabel: 'Showing widget',
+        completedLabel: 'Showed widget',
         async execute(params) {
             // The present tool's result is consumed by the SSE layer to emit a
             // Widget event. The execute function just passes the data through.
@@ -93,6 +96,8 @@ function createStopExecutionTool() {
         }),
         readOnly: true,
         metadata: { category: 'system' },
+        runningLabel: 'Stopping',
+        completedLabel: 'Stopped',
         async execute(params) {
             // The __stop sentinel is checked by the EXECUTING state handler.
             // When detected, it transitions to DONE(model_stop) instead of continuing.
@@ -126,7 +131,7 @@ function bundleConnectionToCompilerConnection(name, conn) {
 // ---------------------------------------------------------------------------
 // Custom tool session context bridge
 // ---------------------------------------------------------------------------
-function buildCustomToolSessionContext(bundle, connectionsMap, storeBackend, appId, fs) {
+function buildCustomToolSessionContext(bundle, connectionsMap, storeBackend, appId, repoRoot) {
     // Adapt StoreBackend.put (returns StorePutResult) to CustomToolSessionContext.storeBackend.put (returns void)
     const adaptedBackend = storeBackend
         ? {
@@ -135,6 +140,35 @@ function buildCustomToolSessionContext(bundle, connectionsMap, storeBackend, app
             },
         }
         : undefined;
+    // Phase A: expose ctx.fs to handlers when we know the repo root.
+    // Defaults to LocalFsBackend; the cloud backend will plug in here in
+    // Phase 0G via the same factory selection used for the SDK ToolContext.
+    const fs = repoRoot ? new LocalFsBackend({ repoRoot }) : undefined;
+    // Phase B: expose ctx.setupState. The factory closes over the agent
+    // id + a Drizzle handle pulled lazily from the runtime's pool so
+    // session-builder doesn't need to wire the db connection through
+    // its existing flow. Skipped when the pool isn't initialized
+    // (e.g. unit tests with no DATABASE_URL).
+    //
+    // Identity resolution: prefer `process.env.AGENT_ID` when the
+    // process was spawned with one (the CLI sets it for both Studio
+    // and the admin agent so all three subprocesses key
+    // `setup_state` rows by the SAME id). Fall back to
+    // `bundle.config.name` for the standalone runtime case where no
+    // CLI is in front. Without this, the admin-agent process — whose
+    // bundle is loaded from ~/.amodal/admin-agent (name: "admin") —
+    // would write/read rows under "admin" while Studio's repo-state
+    // probe queries under "default", and `commit_setup` would mark
+    // the wrong row complete.
+    const agentId = process.env['AGENT_ID'] ?? bundle.config.name;
+    const setupStateFactory = buildSetupStateFactory(agentId);
+    // Phase C: expose ctx.plan. The composer reads node_modules under
+    // repoPath, so this is undefined when no repoPath is resolvable.
+    const plan = repoRoot ? buildPlanOps(repoRoot) : undefined;
+    // Phase E: expose ctx.completion. Needs both a db pool (to read
+    // setup_state + write completed_at) and a fs backend (to write
+    // amodal.json). Skipped when either is missing.
+    const completionFactory = fs ? buildCompletionFactory(agentId, fs) : undefined;
     return {
         config: {
             getConnections() {
@@ -151,9 +185,158 @@ function buildCustomToolSessionContext(bundle, connectionsMap, storeBackend, app
         },
         storeBackend: adaptedBackend,
         appId,
-        ...(fs ? { fs } : {}),
+        repoRoot: repoRoot ?? undefined,
+        fs,
+        agentId,
+        ...(setupStateFactory ? { setupStateFactory } : {}),
+        ...(plan ? { plan } : {}),
+        ...(completionFactory ? { completionFactory } : {}),
     };
 }
+/**
+ * Build the `ctx.plan` ops bound to the agent's repo path. The
+ * composer reads files under `<repoPath>/node_modules/<pkg>/`; when
+ * the package isn't installed we surface a typed `not_installed`
+ * soft-fail instead of throwing the underlying ENOENT.
+ */
+function buildPlanOps(repoPath) {
+    return {
+        async compose(templatePackageName) {
+            try {
+                const composed = await composePlan({ repoPath, templatePackage: templatePackageName });
+                return { ok: true, plan: composed };
+            }
+            catch (err) {
+                if (err !== null &&
+                    typeof err === 'object' &&
+                    'code' in err &&
+                    err.code === 'CONFIG_NOT_FOUND') {
+                    return {
+                        ok: false,
+                        reason: 'not_installed',
+                        message: `Template "${templatePackageName}" is not installed. Call install_package first.`,
+                    };
+                }
+                if (err !== null &&
+                    typeof err === 'object' &&
+                    'code' in err &&
+                    (err.code === 'CONFIG_PARSE_FAILED' ||
+                        err.code === 'CONFIG_VALIDATION_FAILED')) {
+                    return {
+                        ok: false,
+                        reason: 'malformed',
+                        message: err instanceof Error ? err.message : String(err),
+                    };
+                }
+                return {
+                    ok: false,
+                    reason: 'error',
+                    message: err instanceof Error ? err.message : String(err),
+                };
+            }
+        },
+    };
+}
+/**
+ * Build a `setupState` ops factory closed over the runtime's Drizzle
+ * pool. Returns undefined when no pool is initialized — `amodal dev`
+ * always has one (it requires DATABASE_URL), but unit tests that
+ * exercise the session-builder without a db pool see this as a soft
+ * skip and the handler falls back to its own no-db error path.
+ */
+function buildSetupStateFactory(agentId) {
+    let db;
+    try {
+        db = getDb();
+    }
+    catch {
+        // No DATABASE_URL configured — setupState ops not available for this session.
+        return undefined;
+    }
+    return (scopeId) => ({
+        async read() {
+            const row = await getSetupState(db, agentId, scopeId);
+            if (!row)
+                return null;
+            return {
+                state: row.state,
+                completedAt: row.completedAt ? row.completedAt.toISOString() : null,
+            };
+        },
+        async upsert(patch) {
+            const row = await upsertSetupState(db, agentId, scopeId, patch);
+            return {
+                state: row.state,
+                completedAt: row.completedAt ? row.completedAt.toISOString() : null,
+            };
+        },
+        async markComplete() {
+            const dt = await markComplete(db, agentId, scopeId);
+            return dt ? dt.toISOString() : null;
+        },
+    });
+}
+/**
+ * Build the `ctx.completion` ops factory closed over (agentId, db,
+ * fs). The factory takes scopeId at call-time so concurrent
+ * per-scope sessions don't share the same ops object — same
+ * pattern as `buildSetupStateFactory`.
+ */
+function buildCompletionFactory(agentId, fs) {
+    let db;
+    try {
+        db = getDb();
+    }
+    catch {
+        // No DATABASE_URL — completion ops not available.
+        return undefined;
+    }
+    return (scopeId) => ({
+        async commit(opts) {
+            try {
+                const result = await commitSetup({
+                    db,
+                    fs,
+                    agentId,
+                    scopeId,
+                    force: opts?.force ?? false,
+                    ...(opts?.connectionsStatus ? { connectionsStatus: opts.connectionsStatus } : {}),
+                });
+                if (result.ok) {
+                    return {
+                        ok: true,
+                        alreadyComplete: result.alreadyComplete,
+                        completedAt: result.completedAt.toISOString(),
+                    };
+                }
+                if (result.reason === 'not_ready') {
+                    return { ok: false, reason: 'not_ready', warnings: result.warnings };
+                }
+                return { ok: false, reason: 'no_state', message: result.message };
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    reason: 'error',
+                    message: err instanceof Error ? err.message : String(err),
+                };
+            }
+        },
+        async cancel() {
+            try {
+                const deleted = await deleteSetupState(db, agentId, scopeId);
+                return { ok: true, deleted };
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    reason: 'error',
+                    message: err instanceof Error ? err.message : String(err),
+                };
+            }
+        },
+    });
+}
 // ---------------------------------------------------------------------------
 // Env allowlist
 // ---------------------------------------------------------------------------
@@ -178,7 +361,7 @@ function collectEnvAllowlist(bundle) {
  * create a session.
  */
 export function buildSessionComponents(opts) {
-    const { bundle, storeBackend, mcpManager, sessionType = 'chat', pinnedModel, logger, appId = LOCAL_APP_ID, toolExecutor, adminContent, sessionId = 'pending', scopeId = '', scopeContext, fieldScrubber, memoryContent, memoryDb, credentialResolver, } = opts;
+    const { bundle, storeBackend, mcpManager, sessionType = 'chat', pinnedModel, logger, appId = LOCAL_APP_ID, toolExecutor, adminContent, sessionId = 'pending', scopeId = '', scopeContext, fieldScrubber, memoryContent, memoryDb, credentialResolver, intents = [], } = opts;
     // -------------------------------------------------------------------------
     // 1. Create LLM provider
     // -------------------------------------------------------------------------
@@ -232,27 +415,14 @@ export function buildSessionComponents(opts) {
         }));
     }
     // -------------------------------------------------------------------------
-    // 4b. Create fs backend (shared by custom tools + file tools)
-    // -------------------------------------------------------------------------
-    // TODO: refactor file-tools.ts to use FsBackend directly instead of
-    // duplicating tool implementations in http-file-tools.ts
-    let fsBackend;
-    const workspaceApiUrl = process.env['WORKSPACE_API_URL'];
-    const fsRepoRoot = process.env['REPO_PATH'] ?? bundle.origin;
-    const isRealPath = fsRepoRoot && fsRepoRoot.startsWith('/');
-    if (workspaceApiUrl) {
-        fsBackend = new HttpFsBackend({ runtimeUrl: workspaceApiUrl, authToken: process.env['WORKSPACE_AUTH_TOKEN'] });
-        logger.debug('fs_backend_http', { url: workspaceApiUrl });
-    }
-    else if (isRealPath) {
-        fsBackend = new LocalFsBackend({ repoRoot: fsRepoRoot });
-        logger.debug('fs_backend_local', { repoRoot: fsRepoRoot });
-    }
-    // -------------------------------------------------------------------------
     // 5. Register custom tools
     // -------------------------------------------------------------------------
+    // repoRoot is needed both for custom tools (so handlers can read repo
+    // files via ctx.fs, Phase A) and the file-tools / admin-tools registration
+    // further down. Compute it once here.
+    const repoRoot = process.env['REPO_PATH'] ?? bundle.origin;
     if (toolExecutor) {
-        const customToolSessionCtx = buildCustomToolSessionContext(bundle, connectionsMap, scopedBackend, appId, fsBackend);
+        const customToolSessionCtx = buildCustomToolSessionContext(bundle, connectionsMap, scopedBackend, appId, repoRoot);
         for (const tool of bundle.tools) {
             // Skip tools with confirm: 'never' — they exist but are not callable
             if (tool.confirm === 'never')
@@ -279,6 +449,12 @@ export function buildSessionComponents(opts) {
     // -------------------------------------------------------------------------
     registry.register(DISPATCH_TOOL_NAME, createDispatchTool());
     // -------------------------------------------------------------------------
+    // 10a-pre. Register ask_choice as a runtime built-in (Phase 0.6).
+    //          Every agent gets it without declaring — templates and custom
+    //          agents can prompt the user with structured options.
+    // -------------------------------------------------------------------------
+    registry.register(ASK_CHOICE_TOOL_NAME, createAskChoiceTool());
+    // -------------------------------------------------------------------------
     // 10a. Build search provider + register web tools (if webTools configured)
     // -------------------------------------------------------------------------
     let searchProvider;
@@ -326,13 +502,7 @@ export function buildSessionComponents(opts) {
     // -------------------------------------------------------------------------
     const fileToolsConfig = bundle.config.fileTools;
     const fileToolsEnabled = fileToolsConfig === true || (typeof fileToolsConfig === 'object' && fileToolsConfig !== null);
-    const repoRoot = process.env['REPO_PATH'] ?? bundle.origin;
-    if (fileToolsEnabled && workspaceApiUrl && fsBackend) {
-        // Cloud mode: file tools call the remote runtime's workspace API
-        registerHttpFileTools(registry, { fs: fsBackend, logger });
-        logger.debug('file_tools_registered', { mode: 'http', url: workspaceApiUrl });
-    }
-    else if (fileToolsEnabled && repoRoot) {
+    if (fileToolsEnabled && repoRoot) {
         const customConfig = typeof fileToolsConfig === 'object' ? fileToolsConfig : {};
         registerFileTools(registry, {
             repoRoot,
@@ -341,21 +511,18 @@ export function buildSessionComponents(opts) {
             studioUrl: process.env['STUDIO_URL'],
             logger,
         });
-        logger.debug('file_tools_registered', { mode: 'local', repoRoot });
+        logger.debug('file_tools_registered', { repoRoot });
     }
     else if (fileToolsConfig) {
         logger.debug('file_tools_not_registered', { reason: 'no_repo_root' });
     }
     // -------------------------------------------------------------------------
-    // 10b. Admin agent tools
+    // 10d. Register admin onboarding tools when this is an admin session
+    //      (show_preview, ask_choice, search_packages, install_package, write_skill)
     // -------------------------------------------------------------------------
-    const isAdminAgent = process.env['AMODAL_NO_ADMIN'] === '1';
-    const userRepoPath = process.env['REPO_PATH'];
-    if (isAdminAgent) {
-        registerCollectSecretTool(registry);
-        if (userRepoPath) {
-            registerAgentConfigTool(registry, userRepoPath);
-        }
+    if (sessionType === 'admin' && repoRoot) {
+        registerAdminTools(registry, { repoRoot, logger });
+        logger.debug('admin_tools_registered', { repoRoot });
     }
     // -------------------------------------------------------------------------
     // 11. Build permission checker (session-level)
@@ -448,6 +615,7 @@ export function buildSessionComponents(opts) {
         permissionChecker: sessionPermissionChecker,
         systemPrompt: compiled.systemPrompt,
         toolContextFactory,
+        intents,
     };
 }
 // ---------------------------------------------------------------------------