@agent-native/core 0.7.82 → 0.8.0

package/dist/agent/run-manager.js

@@ -4,14 +4,37 @@ const activeRuns = new Map();
 const threadToRun = new Map();
 /** How long to keep completed runs in memory before cleanup (5 min) */
 const CLEANUP_DELAY_MS = 5 * 60 * 1000;
+/** Default run chunk budget for hosted/serverless deploys. */
+export const DEFAULT_HOSTED_RUN_SOFT_TIMEOUT_MS = 55_000;
+function isHostedRuntime() {
+    if (process.env.NETLIFY === "true" && process.env.NETLIFY_LOCAL !== "true") {
+        return true;
+    }
+    return Boolean(process.env.CF_PAGES ||
+        process.env.VERCEL ||
+        process.env.VERCEL_ENV ||
+        process.env.RENDER ||
+        process.env.FLY_APP_NAME ||
+        process.env.K_SERVICE);
+}
 export function resolveRunSoftTimeoutMs(overrideMs) {
     if (typeof overrideMs === "number" && Number.isFinite(overrideMs)) {
         return Math.max(0, overrideMs);
     }
-    const raw = Number(process.env.AGENT_RUN_SOFT_TIMEOUT_MS);
-    if (Number.isFinite(raw) && raw >= 0)
-        return raw;
-    return 0;
+    const envValue = process.env.AGENT_RUN_SOFT_TIMEOUT_MS;
+    if (envValue !== undefined) {
+        const raw = Number(envValue);
+        if (Number.isFinite(raw) && raw >= 0)
+            return raw;
+    }
+    return isHostedRuntime() ? DEFAULT_HOSTED_RUN_SOFT_TIMEOUT_MS : 0;
+}
+function isTerminalRunEvent(event) {
+    return (event.type === "done" ||
+        event.type === "error" ||
+        event.type === "missing_api_key" ||
+        event.type === "loop_limit" ||
+        event.type === "auto_continue");
 }
 /**
  * Start a new agent run in the background.
@@ -64,6 +87,8 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
     // Periodic SQL abort check interval (for cross-isolate abort on Workers)
     let lastAbortCheck = Date.now();
     const send = (event) => {
+        if (run.status === "aborted" && abort.signal.aborted)
+            return;
         const runEvent = { seq: run.events.length, event };
         run.events.push(runEvent);
         // Notify in-memory subscribers (same isolate, fast path)
@@ -92,6 +117,10 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
     // Run in background — intentionally detached from any HTTP connection
     const runPromise = runFn(send, abort.signal)
         .then(() => {
+        if (abort.signal.aborted) {
+            run.status = softTimedOut ? "completed" : "aborted";
+            return;
+        }
         run.status = "completed";
     })
         .catch((err) => {
@@ -130,11 +159,7 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
                     : { type: "done" },
             };
             const last = run.events[run.events.length - 1];
-            if (!last ||
-                (last.event.type !== "done" &&
-                    last.event.type !== "error" &&
-                    last.event.type !== "missing_api_key" &&
-                    last.event.type !== "loop_limit")) {
+            if (!last || !isTerminalRunEvent(last.event)) {
                 run.events.push(terminal);
                 insertRunEvent(runId, terminal.seq, JSON.stringify(terminal.event)).catch(() => { });
                 for (const subscriber of run.subscribers) {
@@ -154,7 +179,7 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
         //    still ticking so the run doesn't look stale to any concurrent
         //    /runs/active check while we wait for SQL writes to land.
         let completionError = null;
-        if (onComplete) {
+        if (onComplete && run.status !== "aborted") {
             try {
                 await onComplete(run);
             }
@@ -260,10 +285,7 @@ function subscribeInMemory(run, fromSeq) {
                 try {
                     controller.enqueue(encoder.encode(`data: ${JSON.stringify({ ...event.event, seq: event.seq })}\n\n`));
                     // Close stream after terminal events
-                    if (event.event.type === "done" ||
-                        event.event.type === "error" ||
-                        event.event.type === "missing_api_key" ||
-                        event.event.type === "loop_limit") {
+                    if (isTerminalRunEvent(event.event)) {
                         run.subscribers.delete(subscriberRef);
                         if (pingTimer)
                             clearInterval(pingTimer);
@@ -329,10 +351,7 @@ function subscribeFromSQL(runId, fromSeq) {
                         }
                         lastSeq = seq;
                         // Close on terminal events
-                        if (parsed.type === "done" ||
-                            parsed.type === "error" ||
-                            parsed.type === "missing_api_key" ||
-                            parsed.type === "loop_limit") {
+                        if (isTerminalRunEvent(parsed)) {
                             if (pingTimer)
                                 clearInterval(pingTimer);
                             controller.close();
@@ -474,7 +493,14 @@ export function getRun(runId) {
 export function abortRun(runId) {
     const run = activeRuns.get(runId);
     if (run) {
+        run.status = "aborted";
+        if (threadToRun.get(run.threadId) === runId) {
+            threadToRun.delete(run.threadId);
+        }
         run.abort.abort();
+        for (const subscriber of run.subscribers) {
+            run.subscribers.delete(subscriber);
+        }
     }
     // Also mark as aborted in SQL (for cross-isolate abort on Workers)
     markRunAborted(runId).catch(() => { });

package/dist/agent/run-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-manager.js","sourceRoot":"","sources":["../../src/agent/run-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentChatEvent, RunEvent, RunStatus } from \"./types.js\";\nimport { EngineError } from \"./engine/types.js\";\nimport {\n  insertRun,\n  insertRunEvent,\n  updateRunStatus,\n  markRunAborted,\n  isRunAborted,\n  getRunEventsSince,\n  getRunById,\n  getRunByThread,\n  cleanupOldRuns,\n  updateRunHeartbeat,\n  reapIfStale,\n} from \"./run-store.js\";\n\nexport interface ActiveRun {\n  runId: string;\n  threadId: string;\n  events: RunEvent[];\n  status: RunStatus;\n  subscribers: Set<(event: RunEvent) => void>;\n  abort: AbortController;\n  startedAt: number;\n}\n\nconst activeRuns = new Map<string, ActiveRun>();\nconst threadToRun = new Map<string, string>();\n\n/** How long to keep completed runs in memory before cleanup (5 min) */\nconst CLEANUP_DELAY_MS = 5 * 60 * 1000;\n\nexport interface StartRunOptions {\n  /** Optional internal run chunk budget. When reached, the framework emits an\n   * auto-continuation signal instead of a user-facing timeout. Leave unset for\n   * no framework-imposed run timeout. */\n  softTimeoutMs?: number;\n}\n\nexport function resolveRunSoftTimeoutMs(overrideMs?: number): number {\n  if (typeof overrideMs === \"number\" && Number.isFinite(overrideMs)) {\n    return Math.max(0, overrideMs);\n  }\n  const raw = Number(process.env.AGENT_RUN_SOFT_TIMEOUT_MS);\n  if (Number.isFinite(raw) && raw >= 0) return raw;\n  return 0;\n}\n\n/**\n * Start a new agent run in the background.\n * `runFn` receives a `send` callback and an `AbortSignal`.\n * The run continues even if all SSE subscribers disconnect.\n *\n * Events are persisted to SQL for cross-isolate access (Cloudflare Workers).\n */\nexport function startRun(\n  runId: string,\n  threadId: string,\n  runFn: (\n    send: (event: AgentChatEvent) => void,\n    signal: AbortSignal,\n  ) => Promise<void>,\n  onComplete?: (run: ActiveRun) => void | Promise<void>,\n  options?: StartRunOptions,\n): ActiveRun {\n  // If there's already a run for this thread, abort it\n  const existingRunId = threadToRun.get(threadId);\n  if (existingRunId) {\n    abortRun(existingRunId);\n  }\n\n  const abort = new AbortController();\n  let softTimedOut = false;\n  const run: ActiveRun = {\n    runId,\n    threadId,\n    events: [],\n    status: \"running\",\n    subscribers: new Set(),\n    abort,\n    startedAt: Date.now(),\n  };\n\n  activeRuns.set(runId, run);\n  threadToRun.set(threadId, runId);\n\n  // Persist run to SQL (fire-and-forget — don't block the response)\n  insertRun(runId, threadId).catch(() => {});\n\n  // Heartbeat: bump heartbeat_at every 1.5s so watchers can detect a dead\n  // producer (process crash, HMR restart, isolate eviction) quickly and\n  // reap the row. Paired with RUN_STALE_MS (6s) — 4x the interval to\n  // tolerate transient DB slowness without false positives.\n  const heartbeatTimer: ReturnType<typeof setInterval> = setInterval(() => {\n    updateRunHeartbeat(runId).catch(() => {});\n  }, 1500);\n  const softTimeoutMs = resolveRunSoftTimeoutMs(options?.softTimeoutMs);\n  const softTimeoutTimer =\n    softTimeoutMs > 0\n      ? setTimeout(() => {\n          if (run.status !== \"running\" || abort.signal.aborted) return;\n          softTimedOut = true;\n          send({\n            type: \"auto_continue\",\n            reason: \"run_timeout\",\n          });\n          abort.abort();\n        }, softTimeoutMs)\n      : null;\n\n  // Periodic SQL abort check interval (for cross-isolate abort on Workers)\n  let lastAbortCheck = Date.now();\n\n  const send = (event: AgentChatEvent) => {\n    const runEvent: RunEvent = { seq: run.events.length, event };\n    run.events.push(runEvent);\n\n    // Notify in-memory subscribers (same isolate, fast path)\n    for (const subscriber of run.subscribers) {\n      try {\n        subscriber(runEvent);\n      } catch {\n        run.subscribers.delete(subscriber);\n      }\n    }\n\n    // Persist event to SQL (fire-and-forget)\n    insertRunEvent(runId, runEvent.seq, JSON.stringify(event)).catch(() => {});\n\n    // Check SQL for cross-isolate abort every 3 seconds\n    const now = Date.now();\n    if (now - lastAbortCheck > 3000) {\n      lastAbortCheck = now;\n      isRunAborted(runId)\n        .then((aborted) => {\n          if (aborted && !abort.signal.aborted) abort.abort();\n        })\n        .catch(() => {});\n    }\n  };\n\n  // Run in background — intentionally detached from any HTTP connection\n  const runPromise = runFn(send, abort.signal)\n    .then(() => {\n      run.status = \"completed\";\n    })\n    .catch((err) => {\n      // Don't surface abort errors — the run was intentionally stopped\n      if (abort.signal.aborted) {\n        run.status = softTimedOut ? \"completed\" : \"aborted\";\n        return;\n      }\n      run.status = \"errored\";\n      send({\n        type: \"error\",\n        error: err?.message ?? \"Unknown error\",\n        ...(err instanceof EngineError && err.errorCode\n          ? { errorCode: err.errorCode }\n          : {}),\n        ...(err instanceof EngineError && err.upgradeUrl\n          ? { upgradeUrl: err.upgradeUrl }\n          : {}),\n      });\n    })\n    .finally(async () => {\n      // Ordering matters here — this is the atomic-complete boundary.\n      // Invariant: once agent_runs.status flips to \"completed\"/\"errored\"\n      // in SQL, thread_data for this turn is already durable. This lets\n      // reconnecting clients trust the simple rule \"status != running →\n      // fetch thread_data\" without polling/retrying for a race window\n      // where onComplete was still pending.\n\n      // 1. Emit terminal event to live subscribers + SQL event log so\n      //    in-flight SSE streams close promptly. Thread-data save below\n      //    runs in parallel with subscribers disconnecting.\n      if (run.status === \"errored\" || run.status === \"completed\") {\n        const terminal: RunEvent = {\n          seq: run.events.length,\n          event:\n            run.status === \"errored\"\n              ? { type: \"error\", error: \"Agent run ended unexpectedly\" }\n              : { type: \"done\" },\n        };\n        const last = run.events[run.events.length - 1];\n        if (\n          !last ||\n          (last.event.type !== \"done\" &&\n            last.event.type !== \"error\" &&\n            last.event.type !== \"missing_api_key\" &&\n            last.event.type !== \"loop_limit\")\n        ) {\n          run.events.push(terminal);\n          insertRunEvent(\n            runId,\n            terminal.seq,\n            JSON.stringify(terminal.event),\n          ).catch(() => {});\n          for (const subscriber of run.subscribers) {\n            try {\n              subscriber(terminal);\n            } catch {\n              // ignore — subscriber will be cleaned up below\n            }\n          }\n        }\n      }\n      for (const subscriber of run.subscribers) {\n        run.subscribers.delete(subscriber);\n      }\n\n      // 2. Await the completion callback (thread_data save). Heartbeat is\n      //    still ticking so the run doesn't look stale to any concurrent\n      //    /runs/active check while we wait for SQL writes to land.\n      let completionError: unknown = null;\n      if (onComplete) {\n        try {\n          await onComplete(run);\n        } catch (err) {\n          completionError = err;\n          console.error(\n            \"[run-manager] onComplete callback error:\",\n            err instanceof Error ? err.message : err,\n          );\n        }\n      }\n\n      // 3. Stop the heartbeat — all liveness writes are done.\n      clearInterval(heartbeatTimer);\n      if (softTimeoutTimer) clearTimeout(softTimeoutTimer);\n\n      // 4. Persist final status to SQL. If the completion callback threw,\n      //    we'd rather mark the run errored than claim success with\n      //    incomplete thread_data.\n      const finalStatus =\n        run.status === \"aborted\"\n          ? \"aborted\"\n          : run.status === \"errored\" || completionError\n            ? \"errored\"\n            : \"completed\";\n      try {\n        await updateRunStatus(runId, finalStatus);\n      } catch {\n        // Best-effort — reapIfStale will eventually clean this up via\n        // the heartbeat-stale path.\n      }\n\n      // 5. Schedule in-memory cleanup + opportunistic old-run pruning.\n      setTimeout(() => {\n        activeRuns.delete(runId);\n        if (threadToRun.get(threadId) === runId) {\n          threadToRun.delete(threadId);\n        }\n      }, CLEANUP_DELAY_MS);\n      cleanupOldRuns(30 * 60 * 1000).catch(() => {});\n    });\n\n  // On Cloudflare Workers, keep the isolate alive for this run\n  try {\n    const cfCtx = globalThis.__cf_ctx;\n    if (cfCtx?.waitUntil) {\n      cfCtx.waitUntil(runPromise);\n    }\n  } catch {\n    // Not on Workers — ignore\n  }\n\n  return run;\n}\n\n/**\n * Subscribe to a run's events starting from `fromSeq`.\n * Returns a ReadableStream that replays buffered events then live-tails.\n * Cancelling the stream only unsubscribes — does NOT abort the agent.\n *\n * Falls back to SQL polling when the run is not in local memory\n * (cross-isolate reconnection on Workers).\n */\nexport function subscribeToRun(\n  runId: string,\n  fromSeq: number,\n): ReadableStream<Uint8Array> | null {\n  const run = activeRuns.get(runId);\n  if (run) {\n    return subscribeInMemory(run, fromSeq);\n  }\n  // Not in local memory — try SQL (cross-isolate path)\n  return subscribeFromSQL(runId, fromSeq);\n}\n\n/** In-memory subscription (same isolate, fast path) */\nfunction subscribeInMemory(\n  run: ActiveRun,\n  fromSeq: number,\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder();\n  let subscriberRef: ((event: RunEvent) => void) | null = null;\n  let pingTimer: ReturnType<typeof setInterval> | null = null;\n\n  return new ReadableStream({\n    start(controller) {\n      const ping = () => {\n        try {\n          controller.enqueue(encoder.encode(`: ping ${Date.now()}\\n\\n`));\n        } catch {\n          if (subscriberRef) run.subscribers.delete(subscriberRef);\n          if (pingTimer) clearInterval(pingTimer);\n        }\n      };\n      ping();\n      pingTimer = setInterval(ping, 10_000);\n\n      // Replay buffered events from fromSeq\n      for (let i = fromSeq; i < run.events.length; i++) {\n        try {\n          controller.enqueue(\n            encoder.encode(\n              `data: ${JSON.stringify({ ...run.events[i].event, seq: run.events[i].seq })}\\n\\n`,\n            ),\n          );\n        } catch {\n          return;\n        }\n      }\n\n      // If run is already done, close immediately\n      if (run.status !== \"running\") {\n        if (pingTimer) clearInterval(pingTimer);\n        controller.close();\n        return;\n      }\n\n      // Subscribe to live events\n      subscriberRef = (event: RunEvent) => {\n        try {\n          controller.enqueue(\n            encoder.encode(\n              `data: ${JSON.stringify({ ...event.event, seq: event.seq })}\\n\\n`,\n            ),\n          );\n          // Close stream after terminal events\n          if (\n            event.event.type === \"done\" ||\n            event.event.type === \"error\" ||\n            event.event.type === \"missing_api_key\" ||\n            event.event.type === \"loop_limit\"\n          ) {\n            run.subscribers.delete(subscriberRef!);\n            if (pingTimer) clearInterval(pingTimer);\n            controller.close();\n          }\n        } catch {\n          run.subscribers.delete(subscriberRef!);\n        }\n      };\n\n      run.subscribers.add(subscriberRef);\n    },\n    cancel() {\n      // Only unsubscribe — do NOT abort the agent run\n      if (subscriberRef) run.subscribers.delete(subscriberRef);\n      if (pingTimer) clearInterval(pingTimer);\n    },\n  });\n}\n\n/** SQL-based subscription (cross-isolate, polling) */\nfunction subscribeFromSQL(\n  runId: string,\n  fromSeq: number,\n): ReadableStream<Uint8Array> | null {\n  const encoder = new TextEncoder();\n  let cancelled = false;\n  let pollTimer: ReturnType<typeof setTimeout> | null = null;\n  let pingTimer: ReturnType<typeof setInterval> | null = null;\n\n  return new ReadableStream({\n    async start(controller) {\n      let lastSeq = fromSeq;\n      const ping = () => {\n        try {\n          controller.enqueue(encoder.encode(`: ping ${Date.now()}\\n\\n`));\n        } catch {\n          cancelled = true;\n          if (pingTimer) clearInterval(pingTimer);\n        }\n      };\n      ping();\n      pingTimer = setInterval(ping, 10_000);\n\n      const poll = async () => {\n        if (cancelled) return;\n        try {\n          // Read new events from SQL\n          const events = await getRunEventsSince(runId, lastSeq);\n          for (const { seq, eventData } of events) {\n            let parsed: any;\n            try {\n              parsed = JSON.parse(eventData);\n            } catch {\n              continue;\n            }\n            try {\n              controller.enqueue(\n                encoder.encode(\n                  `data: ${JSON.stringify({ ...parsed, seq })}\\n\\n`,\n                ),\n              );\n            } catch {\n              cancelled = true;\n              return;\n            }\n            lastSeq = seq;\n\n            // Close on terminal events\n            if (\n              parsed.type === \"done\" ||\n              parsed.type === \"error\" ||\n              parsed.type === \"missing_api_key\" ||\n              parsed.type === \"loop_limit\"\n            ) {\n              if (pingTimer) clearInterval(pingTimer);\n              controller.close();\n              return;\n            }\n          }\n\n          // Check if run completed (no terminal event but status changed)\n          if (events.length === 0) {\n            // Opportunistically reap a stale producer before trusting SQL's\n            // \"running\" status — otherwise a crashed server leaves us polling\n            // forever.\n            await reapIfStale(runId).catch(() => {});\n            const run = await getRunById(runId);\n            if (!run || run.status !== \"running\") {\n              // Run ended — do one final event read, then close\n              const finalEvents = await getRunEventsSince(runId, lastSeq);\n              for (const { seq, eventData } of finalEvents) {\n                let parsed: any;\n                try {\n                  parsed = JSON.parse(eventData);\n                } catch {\n                  continue;\n                }\n                try {\n                  controller.enqueue(\n                    encoder.encode(\n                      `data: ${JSON.stringify({ ...parsed, seq })}\\n\\n`,\n                    ),\n                  );\n                } catch {\n                  cancelled = true;\n                  return;\n                }\n              }\n              if (pingTimer) clearInterval(pingTimer);\n              controller.close();\n              return;\n            }\n          }\n\n          // Schedule next poll\n          if (!cancelled) {\n            pollTimer = setTimeout(poll, 500);\n          }\n        } catch {\n          // SQL error — close stream\n          try {\n            if (pingTimer) clearInterval(pingTimer);\n            controller.close();\n          } catch {}\n        }\n      };\n\n      // Verify run exists before starting poll\n      try {\n        const run = await getRunById(runId);\n        if (!run) {\n          if (pingTimer) clearInterval(pingTimer);\n          controller.close();\n          return;\n        }\n      } catch {\n        controller.close();\n        return;\n      }\n\n      await poll();\n    },\n    cancel() {\n      cancelled = true;\n      if (pollTimer) clearTimeout(pollTimer);\n      if (pingTimer) clearInterval(pingTimer);\n    },\n  });\n}\n\n/** Get the active run for a thread (if any) — checks memory then SQL */\nexport function getActiveRunForThread(threadId: string): ActiveRun | null {\n  const runId = threadToRun.get(threadId);\n  if (runId) {\n    const run = activeRuns.get(runId);\n    if (run) return run;\n  }\n  return null;\n}\n\n/**\n * Async version that also checks SQL — for cross-isolate access.\n * Used by the /runs/active endpoint.\n *\n * Returns `heartbeatAt` so the client can independently decide a run is\n * dead even before the server-side stale reap has fired.\n */\nexport async function getActiveRunForThreadAsync(threadId: string): Promise<{\n  runId: string;\n  threadId: string;\n  status: string;\n  heartbeatAt: number;\n} | null> {\n  // Check memory first — return both running AND recently-completed runs\n  // that still have events in memory. This allows sub-agent tabs to replay\n  // the full conversation from completed runs via SSE.\n  const memRun = getActiveRunForThread(threadId);\n  if (memRun && (memRun.status === \"running\" || memRun.events.length > 0)) {\n    return {\n      runId: memRun.runId,\n      threadId: memRun.threadId,\n      status: memRun.status,\n      // In-memory means this isolate is the producer. By definition, the\n      // heartbeat is fresh as of \"now\" — the client can trust this.\n      heartbeatAt: Date.now(),\n    };\n  }\n  // Fall back to SQL\n  try {\n    const sqlRun = await getRunByThread(threadId);\n    if (sqlRun && sqlRun.status === \"running\") {\n      // If the producer is dead (no recent heartbeat), reap before the\n      // client can see a stale \"running\" status and enter a reconnect\n      // loop it can never exit.\n      const reaped = await reapIfStale(sqlRun.id).catch(() => false);\n      if (reaped) return null;\n      return {\n        runId: sqlRun.id,\n        threadId: sqlRun.threadId,\n        status: sqlRun.status,\n        heartbeatAt: sqlRun.heartbeatAt ?? sqlRun.startedAt,\n      };\n    }\n  } catch {\n    // SQL error — fall through\n  }\n  return null;\n}\n\n/** Get a run by ID */\nexport function getRun(runId: string): ActiveRun | null {\n  return activeRuns.get(runId) ?? null;\n}\n\n/** Explicitly abort a run (e.g. Stop button) */\nexport function abortRun(runId: string): boolean {\n  const run = activeRuns.get(runId);\n  if (run) {\n    run.abort.abort();\n  }\n  // Also mark as aborted in SQL (for cross-isolate abort on Workers)\n  markRunAborted(runId).catch(() => {});\n  return !!run;\n}\n"]}
+{"version":3,"file":"run-manager.js","sourceRoot":"","sources":["../../src/agent/run-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentChatEvent, RunEvent, RunStatus } from \"./types.js\";\nimport { EngineError } from \"./engine/types.js\";\nimport {\n  insertRun,\n  insertRunEvent,\n  updateRunStatus,\n  markRunAborted,\n  isRunAborted,\n  getRunEventsSince,\n  getRunById,\n  getRunByThread,\n  cleanupOldRuns,\n  updateRunHeartbeat,\n  reapIfStale,\n} from \"./run-store.js\";\n\nexport interface ActiveRun {\n  runId: string;\n  threadId: string;\n  events: RunEvent[];\n  status: RunStatus;\n  subscribers: Set<(event: RunEvent) => void>;\n  abort: AbortController;\n  startedAt: number;\n}\n\nconst activeRuns = new Map<string, ActiveRun>();\nconst threadToRun = new Map<string, string>();\n\n/** How long to keep completed runs in memory before cleanup (5 min) */\nconst CLEANUP_DELAY_MS = 5 * 60 * 1000;\n\n/** Default run chunk budget for hosted/serverless deploys. */\nexport const DEFAULT_HOSTED_RUN_SOFT_TIMEOUT_MS = 55_000;\n\nexport interface StartRunOptions {\n  /** Optional internal run chunk budget. When reached, the framework emits an\n   * auto-continuation signal instead of a user-facing timeout. Leave unset for\n   * no framework-imposed run timeout. */\n  softTimeoutMs?: number;\n}\n\nfunction isHostedRuntime(): boolean {\n  if (process.env.NETLIFY === \"true\" && process.env.NETLIFY_LOCAL !== \"true\") {\n    return true;\n  }\n  return Boolean(\n    process.env.CF_PAGES ||\n    process.env.VERCEL ||\n    process.env.VERCEL_ENV ||\n    process.env.RENDER ||\n    process.env.FLY_APP_NAME ||\n    process.env.K_SERVICE,\n  );\n}\n\nexport function resolveRunSoftTimeoutMs(overrideMs?: number): number {\n  if (typeof overrideMs === \"number\" && Number.isFinite(overrideMs)) {\n    return Math.max(0, overrideMs);\n  }\n  const envValue = process.env.AGENT_RUN_SOFT_TIMEOUT_MS;\n  if (envValue !== undefined) {\n    const raw = Number(envValue);\n    if (Number.isFinite(raw) && raw >= 0) return raw;\n  }\n  return isHostedRuntime() ? DEFAULT_HOSTED_RUN_SOFT_TIMEOUT_MS : 0;\n}\n\nfunction isTerminalRunEvent(event: AgentChatEvent): boolean {\n  return (\n    event.type === \"done\" ||\n    event.type === \"error\" ||\n    event.type === \"missing_api_key\" ||\n    event.type === \"loop_limit\" ||\n    event.type === \"auto_continue\"\n  );\n}\n\n/**\n * Start a new agent run in the background.\n * `runFn` receives a `send` callback and an `AbortSignal`.\n * The run continues even if all SSE subscribers disconnect.\n *\n * Events are persisted to SQL for cross-isolate access (Cloudflare Workers).\n */\nexport function startRun(\n  runId: string,\n  threadId: string,\n  runFn: (\n    send: (event: AgentChatEvent) => void,\n    signal: AbortSignal,\n  ) => Promise<void>,\n  onComplete?: (run: ActiveRun) => void | Promise<void>,\n  options?: StartRunOptions,\n): ActiveRun {\n  // If there's already a run for this thread, abort it\n  const existingRunId = threadToRun.get(threadId);\n  if (existingRunId) {\n    abortRun(existingRunId);\n  }\n\n  const abort = new AbortController();\n  let softTimedOut = false;\n  const run: ActiveRun = {\n    runId,\n    threadId,\n    events: [],\n    status: \"running\",\n    subscribers: new Set(),\n    abort,\n    startedAt: Date.now(),\n  };\n\n  activeRuns.set(runId, run);\n  threadToRun.set(threadId, runId);\n\n  // Persist run to SQL (fire-and-forget — don't block the response)\n  insertRun(runId, threadId).catch(() => {});\n\n  // Heartbeat: bump heartbeat_at every 1.5s so watchers can detect a dead\n  // producer (process crash, HMR restart, isolate eviction) quickly and\n  // reap the row. Paired with RUN_STALE_MS (6s) — 4x the interval to\n  // tolerate transient DB slowness without false positives.\n  const heartbeatTimer: ReturnType<typeof setInterval> = setInterval(() => {\n    updateRunHeartbeat(runId).catch(() => {});\n  }, 1500);\n  const softTimeoutMs = resolveRunSoftTimeoutMs(options?.softTimeoutMs);\n  const softTimeoutTimer =\n    softTimeoutMs > 0\n      ? setTimeout(() => {\n          if (run.status !== \"running\" || abort.signal.aborted) return;\n          softTimedOut = true;\n          send({\n            type: \"auto_continue\",\n            reason: \"run_timeout\",\n          });\n          abort.abort();\n        }, softTimeoutMs)\n      : null;\n\n  // Periodic SQL abort check interval (for cross-isolate abort on Workers)\n  let lastAbortCheck = Date.now();\n\n  const send = (event: AgentChatEvent) => {\n    if (run.status === \"aborted\" && abort.signal.aborted) return;\n\n    const runEvent: RunEvent = { seq: run.events.length, event };\n    run.events.push(runEvent);\n\n    // Notify in-memory subscribers (same isolate, fast path)\n    for (const subscriber of run.subscribers) {\n      try {\n        subscriber(runEvent);\n      } catch {\n        run.subscribers.delete(subscriber);\n      }\n    }\n\n    // Persist event to SQL (fire-and-forget)\n    insertRunEvent(runId, runEvent.seq, JSON.stringify(event)).catch(() => {});\n\n    // Check SQL for cross-isolate abort every 3 seconds\n    const now = Date.now();\n    if (now - lastAbortCheck > 3000) {\n      lastAbortCheck = now;\n      isRunAborted(runId)\n        .then((aborted) => {\n          if (aborted && !abort.signal.aborted) abort.abort();\n        })\n        .catch(() => {});\n    }\n  };\n\n  // Run in background — intentionally detached from any HTTP connection\n  const runPromise = runFn(send, abort.signal)\n    .then(() => {\n      if (abort.signal.aborted) {\n        run.status = softTimedOut ? \"completed\" : \"aborted\";\n        return;\n      }\n      run.status = \"completed\";\n    })\n    .catch((err) => {\n      // Don't surface abort errors — the run was intentionally stopped\n      if (abort.signal.aborted) {\n        run.status = softTimedOut ? \"completed\" : \"aborted\";\n        return;\n      }\n      run.status = \"errored\";\n      send({\n        type: \"error\",\n        error: err?.message ?? \"Unknown error\",\n        ...(err instanceof EngineError && err.errorCode\n          ? { errorCode: err.errorCode }\n          : {}),\n        ...(err instanceof EngineError && err.upgradeUrl\n          ? { upgradeUrl: err.upgradeUrl }\n          : {}),\n      });\n    })\n    .finally(async () => {\n      // Ordering matters here — this is the atomic-complete boundary.\n      // Invariant: once agent_runs.status flips to \"completed\"/\"errored\"\n      // in SQL, thread_data for this turn is already durable. This lets\n      // reconnecting clients trust the simple rule \"status != running →\n      // fetch thread_data\" without polling/retrying for a race window\n      // where onComplete was still pending.\n\n      // 1. Emit terminal event to live subscribers + SQL event log so\n      //    in-flight SSE streams close promptly. Thread-data save below\n      //    runs in parallel with subscribers disconnecting.\n      if (run.status === \"errored\" || run.status === \"completed\") {\n        const terminal: RunEvent = {\n          seq: run.events.length,\n          event:\n            run.status === \"errored\"\n              ? { type: \"error\", error: \"Agent run ended unexpectedly\" }\n              : { type: \"done\" },\n        };\n        const last = run.events[run.events.length - 1];\n        if (!last || !isTerminalRunEvent(last.event)) {\n          run.events.push(terminal);\n          insertRunEvent(\n            runId,\n            terminal.seq,\n            JSON.stringify(terminal.event),\n          ).catch(() => {});\n          for (const subscriber of run.subscribers) {\n            try {\n              subscriber(terminal);\n            } catch {\n              // ignore — subscriber will be cleaned up below\n            }\n          }\n        }\n      }\n      for (const subscriber of run.subscribers) {\n        run.subscribers.delete(subscriber);\n      }\n\n      // 2. Await the completion callback (thread_data save). Heartbeat is\n      //    still ticking so the run doesn't look stale to any concurrent\n      //    /runs/active check while we wait for SQL writes to land.\n      let completionError: unknown = null;\n      if (onComplete && run.status !== \"aborted\") {\n        try {\n          await onComplete(run);\n        } catch (err) {\n          completionError = err;\n          console.error(\n            \"[run-manager] onComplete callback error:\",\n            err instanceof Error ? err.message : err,\n          );\n        }\n      }\n\n      // 3. Stop the heartbeat — all liveness writes are done.\n      clearInterval(heartbeatTimer);\n      if (softTimeoutTimer) clearTimeout(softTimeoutTimer);\n\n      // 4. Persist final status to SQL. If the completion callback threw,\n      //    we'd rather mark the run errored than claim success with\n      //    incomplete thread_data.\n      const finalStatus =\n        run.status === \"aborted\"\n          ? \"aborted\"\n          : run.status === \"errored\" || completionError\n            ? \"errored\"\n            : \"completed\";\n      try {\n        await updateRunStatus(runId, finalStatus);\n      } catch {\n        // Best-effort — reapIfStale will eventually clean this up via\n        // the heartbeat-stale path.\n      }\n\n      // 5. Schedule in-memory cleanup + opportunistic old-run pruning.\n      setTimeout(() => {\n        activeRuns.delete(runId);\n        if (threadToRun.get(threadId) === runId) {\n          threadToRun.delete(threadId);\n        }\n      }, CLEANUP_DELAY_MS);\n      cleanupOldRuns(30 * 60 * 1000).catch(() => {});\n    });\n\n  // On Cloudflare Workers, keep the isolate alive for this run\n  try {\n    const cfCtx = globalThis.__cf_ctx;\n    if (cfCtx?.waitUntil) {\n      cfCtx.waitUntil(runPromise);\n    }\n  } catch {\n    // Not on Workers — ignore\n  }\n\n  return run;\n}\n\n/**\n * Subscribe to a run's events starting from `fromSeq`.\n * Returns a ReadableStream that replays buffered events then live-tails.\n * Cancelling the stream only unsubscribes — does NOT abort the agent.\n *\n * Falls back to SQL polling when the run is not in local memory\n * (cross-isolate reconnection on Workers).\n */\nexport function subscribeToRun(\n  runId: string,\n  fromSeq: number,\n): ReadableStream<Uint8Array> | null {\n  const run = activeRuns.get(runId);\n  if (run) {\n    return subscribeInMemory(run, fromSeq);\n  }\n  // Not in local memory — try SQL (cross-isolate path)\n  return subscribeFromSQL(runId, fromSeq);\n}\n\n/** In-memory subscription (same isolate, fast path) */\nfunction subscribeInMemory(\n  run: ActiveRun,\n  fromSeq: number,\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder();\n  let subscriberRef: ((event: RunEvent) => void) | null = null;\n  let pingTimer: ReturnType<typeof setInterval> | null = null;\n\n  return new ReadableStream({\n    start(controller) {\n      const ping = () => {\n        try {\n          controller.enqueue(encoder.encode(`: ping ${Date.now()}\\n\\n`));\n        } catch {\n          if (subscriberRef) run.subscribers.delete(subscriberRef);\n          if (pingTimer) clearInterval(pingTimer);\n        }\n      };\n      ping();\n      pingTimer = setInterval(ping, 10_000);\n\n      // Replay buffered events from fromSeq\n      for (let i = fromSeq; i < run.events.length; i++) {\n        try {\n          controller.enqueue(\n            encoder.encode(\n              `data: ${JSON.stringify({ ...run.events[i].event, seq: run.events[i].seq })}\\n\\n`,\n            ),\n          );\n        } catch {\n          return;\n        }\n      }\n\n      // If run is already done, close immediately\n      if (run.status !== \"running\") {\n        if (pingTimer) clearInterval(pingTimer);\n        controller.close();\n        return;\n      }\n\n      // Subscribe to live events\n      subscriberRef = (event: RunEvent) => {\n        try {\n          controller.enqueue(\n            encoder.encode(\n              `data: ${JSON.stringify({ ...event.event, seq: event.seq })}\\n\\n`,\n            ),\n          );\n          // Close stream after terminal events\n          if (isTerminalRunEvent(event.event)) {\n            run.subscribers.delete(subscriberRef!);\n            if (pingTimer) clearInterval(pingTimer);\n            controller.close();\n          }\n        } catch {\n          run.subscribers.delete(subscriberRef!);\n        }\n      };\n\n      run.subscribers.add(subscriberRef);\n    },\n    cancel() {\n      // Only unsubscribe — do NOT abort the agent run\n      if (subscriberRef) run.subscribers.delete(subscriberRef);\n      if (pingTimer) clearInterval(pingTimer);\n    },\n  });\n}\n\n/** SQL-based subscription (cross-isolate, polling) */\nfunction subscribeFromSQL(\n  runId: string,\n  fromSeq: number,\n): ReadableStream<Uint8Array> | null {\n  const encoder = new TextEncoder();\n  let cancelled = false;\n  let pollTimer: ReturnType<typeof setTimeout> | null = null;\n  let pingTimer: ReturnType<typeof setInterval> | null = null;\n\n  return new ReadableStream({\n    async start(controller) {\n      let lastSeq = fromSeq;\n      const ping = () => {\n        try {\n          controller.enqueue(encoder.encode(`: ping ${Date.now()}\\n\\n`));\n        } catch {\n          cancelled = true;\n          if (pingTimer) clearInterval(pingTimer);\n        }\n      };\n      ping();\n      pingTimer = setInterval(ping, 10_000);\n\n      const poll = async () => {\n        if (cancelled) return;\n        try {\n          // Read new events from SQL\n          const events = await getRunEventsSince(runId, lastSeq);\n          for (const { seq, eventData } of events) {\n            let parsed: any;\n            try {\n              parsed = JSON.parse(eventData);\n            } catch {\n              continue;\n            }\n            try {\n              controller.enqueue(\n                encoder.encode(\n                  `data: ${JSON.stringify({ ...parsed, seq })}\\n\\n`,\n                ),\n              );\n            } catch {\n              cancelled = true;\n              return;\n            }\n            lastSeq = seq;\n\n            // Close on terminal events\n            if (isTerminalRunEvent(parsed)) {\n              if (pingTimer) clearInterval(pingTimer);\n              controller.close();\n              return;\n            }\n          }\n\n          // Check if run completed (no terminal event but status changed)\n          if (events.length === 0) {\n            // Opportunistically reap a stale producer before trusting SQL's\n            // \"running\" status — otherwise a crashed server leaves us polling\n            // forever.\n            await reapIfStale(runId).catch(() => {});\n            const run = await getRunById(runId);\n            if (!run || run.status !== \"running\") {\n              // Run ended — do one final event read, then close\n              const finalEvents = await getRunEventsSince(runId, lastSeq);\n              for (const { seq, eventData } of finalEvents) {\n                let parsed: any;\n                try {\n                  parsed = JSON.parse(eventData);\n                } catch {\n                  continue;\n                }\n                try {\n                  controller.enqueue(\n                    encoder.encode(\n                      `data: ${JSON.stringify({ ...parsed, seq })}\\n\\n`,\n                    ),\n                  );\n                } catch {\n                  cancelled = true;\n                  return;\n                }\n              }\n              if (pingTimer) clearInterval(pingTimer);\n              controller.close();\n              return;\n            }\n          }\n\n          // Schedule next poll\n          if (!cancelled) {\n            pollTimer = setTimeout(poll, 500);\n          }\n        } catch {\n          // SQL error — close stream\n          try {\n            if (pingTimer) clearInterval(pingTimer);\n            controller.close();\n          } catch {}\n        }\n      };\n\n      // Verify run exists before starting poll\n      try {\n        const run = await getRunById(runId);\n        if (!run) {\n          if (pingTimer) clearInterval(pingTimer);\n          controller.close();\n          return;\n        }\n      } catch {\n        controller.close();\n        return;\n      }\n\n      await poll();\n    },\n    cancel() {\n      cancelled = true;\n      if (pollTimer) clearTimeout(pollTimer);\n      if (pingTimer) clearInterval(pingTimer);\n    },\n  });\n}\n\n/** Get the active run for a thread (if any) — checks memory then SQL */\nexport function getActiveRunForThread(threadId: string): ActiveRun | null {\n  const runId = threadToRun.get(threadId);\n  if (runId) {\n    const run = activeRuns.get(runId);\n    if (run) return run;\n  }\n  return null;\n}\n\n/**\n * Async version that also checks SQL — for cross-isolate access.\n * Used by the /runs/active endpoint.\n *\n * Returns `heartbeatAt` so the client can independently decide a run is\n * dead even before the server-side stale reap has fired.\n */\nexport async function getActiveRunForThreadAsync(threadId: string): Promise<{\n  runId: string;\n  threadId: string;\n  status: string;\n  heartbeatAt: number;\n} | null> {\n  // Check memory first — return both running AND recently-completed runs\n  // that still have events in memory. This allows sub-agent tabs to replay\n  // the full conversation from completed runs via SSE.\n  const memRun = getActiveRunForThread(threadId);\n  if (memRun && (memRun.status === \"running\" || memRun.events.length > 0)) {\n    return {\n      runId: memRun.runId,\n      threadId: memRun.threadId,\n      status: memRun.status,\n      // In-memory means this isolate is the producer. By definition, the\n      // heartbeat is fresh as of \"now\" — the client can trust this.\n      heartbeatAt: Date.now(),\n    };\n  }\n  // Fall back to SQL\n  try {\n    const sqlRun = await getRunByThread(threadId);\n    if (sqlRun && sqlRun.status === \"running\") {\n      // If the producer is dead (no recent heartbeat), reap before the\n      // client can see a stale \"running\" status and enter a reconnect\n      // loop it can never exit.\n      const reaped = await reapIfStale(sqlRun.id).catch(() => false);\n      if (reaped) return null;\n      return {\n        runId: sqlRun.id,\n        threadId: sqlRun.threadId,\n        status: sqlRun.status,\n        heartbeatAt: sqlRun.heartbeatAt ?? sqlRun.startedAt,\n      };\n    }\n  } catch {\n    // SQL error — fall through\n  }\n  return null;\n}\n\n/** Get a run by ID */\nexport function getRun(runId: string): ActiveRun | null {\n  return activeRuns.get(runId) ?? null;\n}\n\n/** Explicitly abort a run (e.g. Stop button) */\nexport function abortRun(runId: string): boolean {\n  const run = activeRuns.get(runId);\n  if (run) {\n    run.status = \"aborted\";\n    if (threadToRun.get(run.threadId) === runId) {\n      threadToRun.delete(run.threadId);\n    }\n    run.abort.abort();\n    for (const subscriber of run.subscribers) {\n      run.subscribers.delete(subscriber);\n    }\n  }\n  // Also mark as aborted in SQL (for cross-isolate abort on Workers)\n  markRunAborted(runId).catch(() => {});\n  return !!run;\n}\n"]}

package/dist/agent/types.d.ts

@@ -123,7 +123,7 @@ export type AgentChatEvent = {
     maxIterations?: number;
 } | {
     type: "auto_continue";
-    reason: "run_timeout" | "loop_limit" | "stream_ended";
+    reason: "run_timeout" | "loop_limit" | "no_progress" | "stream_ended";
     maxIterations?: number;
 } | {
     type: "clear";

package/dist/agent/types.d.ts.map

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

package/dist/agent/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReasoningEffort } from \"../shared/reasoning-effort.js\";\n\nexport interface ActionTool {\n  description: string;\n  parameters?: {\n    type: \"object\";\n    properties: Record<\n      string,\n      {\n        type: string;\n        description?: string;\n        enum?: string[];\n      }\n    >;\n    required?: string[];\n  };\n}\n\n/** @deprecated Use `ActionTool` instead */\nexport type ScriptTool = ActionTool;\n\nexport interface AgentMessage {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface AgentChatReference {\n  type: \"file\" | \"skill\" | \"mention\" | \"agent\" | \"custom-agent\";\n  path: string;\n  name: string;\n  source: string;\n  refType?: string;\n  refId?: string;\n}\n\nexport interface MentionProviderItem {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  refType: string;\n  refId?: string;\n  refPath?: string;\n}\n\nexport interface MentionProvider {\n  label: string;\n  icon?: string;\n  search: (\n    query: string,\n    /** The H3 event for the current request — use to make internal API calls */\n    event?: any,\n  ) => MentionProviderItem[] | Promise<MentionProviderItem[]>;\n}\n\nexport interface AgentChatAttachment {\n  type: string;\n  name: string;\n  data?: string;\n  contentType?: string;\n  text?: string;\n}\n\nexport interface AgentChatRequest {\n  message: string;\n  history?: AgentMessage[];\n  references?: AgentChatReference[];\n  threadId?: string;\n  attachments?: AgentChatAttachment[];\n  /** Execution mode for this turn. Plan mode is read-only and proposes before acting. */\n  mode?: \"act\" | \"plan\";\n  /** Per-request model override (ephemeral, from the composer model picker). */\n  model?: string;\n  /** Per-request engine override (sent alongside model for cross-provider switches). */\n  engine?: string;\n  /** Per-request reasoning effort override (ephemeral, from the composer picker). */\n  effort?: ReasoningEffort;\n  /** Usage-tracking label for this call (e.g. \"chat\", \"summarize\"). Default: \"chat\". */\n  usageLabel?: string;\n}\n\nexport type AgentChatEvent =\n  | { type: \"text\"; text: string }\n  | { type: \"tool_start\"; tool: string; input: Record<string, string> }\n  | { type: \"tool_done\"; tool: string; result: string }\n  | {\n      type: \"agent_call\";\n      agent: string;\n      status: \"start\" | \"done\" | \"error\";\n    }\n  | { type: \"agent_call_text\"; agent: string; text: string }\n  | {\n      type: \"agent_task\";\n      taskId: string;\n      threadId: string;\n      description: string;\n      status: \"running\" | \"completed\" | \"errored\";\n    }\n  | {\n      type: \"agent_task_update\";\n      taskId: string;\n      preview: string;\n      currentStep?: string;\n    }\n  | {\n      type: \"agent_task_complete\";\n      taskId: string;\n      summary: string;\n    }\n  | { type: \"done\" }\n  | {\n      type: \"error\";\n      error: string;\n      /**\n       * Optional machine-readable error code. Builder gateway uses codes\n       * like \"credits-limit-monthly\" / \"unauthorized\" / \"gateway_not_enabled\"\n       * so the chat UI can render a structured CTA (e.g. upgrade button).\n       */\n      errorCode?: string;\n      /** Optional link paired with errorCode — e.g. Builder billing page. */\n      upgradeUrl?: string;\n      /** Optional details for expandable UI/debugging. */\n      details?: string;\n      /** True when the user can reasonably continue/retry from partial work. */\n      recoverable?: boolean;\n    }\n  | { type: \"missing_api_key\" }\n  | { type: \"loop_limit\"; maxIterations?: number }\n  | {\n      type: \"auto_continue\";\n      reason: \"run_timeout\" | \"loop_limit\" | \"stream_ended\";\n      maxIterations?: number;\n    }\n  | { type: \"clear\" };\n\nexport interface RunEvent {\n  seq: number;\n  event: AgentChatEvent;\n}\n\nexport type RunStatus = \"running\" | \"completed\" | \"errored\" | \"aborted\";\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReasoningEffort } from \"../shared/reasoning-effort.js\";\n\nexport interface ActionTool {\n  description: string;\n  parameters?: {\n    type: \"object\";\n    properties: Record<\n      string,\n      {\n        type: string;\n        description?: string;\n        enum?: string[];\n      }\n    >;\n    required?: string[];\n  };\n}\n\n/** @deprecated Use `ActionTool` instead */\nexport type ScriptTool = ActionTool;\n\nexport interface AgentMessage {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface AgentChatReference {\n  type: \"file\" | \"skill\" | \"mention\" | \"agent\" | \"custom-agent\";\n  path: string;\n  name: string;\n  source: string;\n  refType?: string;\n  refId?: string;\n}\n\nexport interface MentionProviderItem {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  refType: string;\n  refId?: string;\n  refPath?: string;\n}\n\nexport interface MentionProvider {\n  label: string;\n  icon?: string;\n  search: (\n    query: string,\n    /** The H3 event for the current request — use to make internal API calls */\n    event?: any,\n  ) => MentionProviderItem[] | Promise<MentionProviderItem[]>;\n}\n\nexport interface AgentChatAttachment {\n  type: string;\n  name: string;\n  data?: string;\n  contentType?: string;\n  text?: string;\n}\n\nexport interface AgentChatRequest {\n  message: string;\n  history?: AgentMessage[];\n  references?: AgentChatReference[];\n  threadId?: string;\n  attachments?: AgentChatAttachment[];\n  /** Execution mode for this turn. Plan mode is read-only and proposes before acting. */\n  mode?: \"act\" | \"plan\";\n  /** Per-request model override (ephemeral, from the composer model picker). */\n  model?: string;\n  /** Per-request engine override (sent alongside model for cross-provider switches). */\n  engine?: string;\n  /** Per-request reasoning effort override (ephemeral, from the composer picker). */\n  effort?: ReasoningEffort;\n  /** Usage-tracking label for this call (e.g. \"chat\", \"summarize\"). Default: \"chat\". */\n  usageLabel?: string;\n}\n\nexport type AgentChatEvent =\n  | { type: \"text\"; text: string }\n  | { type: \"tool_start\"; tool: string; input: Record<string, string> }\n  | { type: \"tool_done\"; tool: string; result: string }\n  | {\n      type: \"agent_call\";\n      agent: string;\n      status: \"start\" | \"done\" | \"error\";\n    }\n  | { type: \"agent_call_text\"; agent: string; text: string }\n  | {\n      type: \"agent_task\";\n      taskId: string;\n      threadId: string;\n      description: string;\n      status: \"running\" | \"completed\" | \"errored\";\n    }\n  | {\n      type: \"agent_task_update\";\n      taskId: string;\n      preview: string;\n      currentStep?: string;\n    }\n  | {\n      type: \"agent_task_complete\";\n      taskId: string;\n      summary: string;\n    }\n  | { type: \"done\" }\n  | {\n      type: \"error\";\n      error: string;\n      /**\n       * Optional machine-readable error code. Builder gateway uses codes\n       * like \"credits-limit-monthly\" / \"unauthorized\" / \"gateway_not_enabled\"\n       * so the chat UI can render a structured CTA (e.g. upgrade button).\n       */\n      errorCode?: string;\n      /** Optional link paired with errorCode — e.g. Builder billing page. */\n      upgradeUrl?: string;\n      /** Optional details for expandable UI/debugging. */\n      details?: string;\n      /** True when the user can reasonably continue/retry from partial work. */\n      recoverable?: boolean;\n    }\n  | { type: \"missing_api_key\" }\n  | { type: \"loop_limit\"; maxIterations?: number }\n  | {\n      type: \"auto_continue\";\n      reason: \"run_timeout\" | \"loop_limit\" | \"no_progress\" | \"stream_ended\";\n      maxIterations?: number;\n    }\n  | { type: \"clear\" };\n\nexport interface RunEvent {\n  seq: number;\n  event: AgentChatEvent;\n}\n\nexport type RunStatus = \"running\" | \"completed\" | \"errored\" | \"aborted\";\n"]}

package/dist/cli/create.d.ts

@@ -64,7 +64,7 @@ export { scaffoldWorkspaceRoot as _scaffoldWorkspaceRoot, scaffoldAppTemplate as
  * pnpm-workspace.yaml (works during local framework development).
  */
 declare function loadCatalog(): Record<string, string>;
-declare function fixPackageJsonName(appDir: string, name: string): void;
+declare function fixPackageJsonName(appDir: string, name: string, templateName?: string): void;
 declare function getCoreDependencyVersion(): string;
 declare function getGitHubTemplateRef(): string;
 declare function rewriteNetlifyToml(appDir: string, appName: string, mode: "standalone" | "workspace"): void;

package/dist/cli/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAqCvE,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAmGD,iBAAe,qBAAqB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAwCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAgID;;;;;GAKG;AACH,iBAAe,mBAAmB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf;AAsCD;;;;GAIG;AACH,iBAAe,wBAAwB,CACrC,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAED;;;GAGG;AACH,iBAAS,qBAAqB,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAqEN;AAgHD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,yCAAyC;AACzC,OAAO,EACL,qBAAqB,IAAI,sBAAsB,EAC/C,mBAAmB,IAAI,oBAAoB,EAC3C,wBAAwB,IAAI,yBAAyB,EACrD,qBAAqB,IAAI,sBAAsB,EAC/C,WAAW,IAAI,YAAY,EAC3B,kBAAkB,IAAI,mBAAmB,EACzC,eAAe,IAAI,gBAAgB,EACnC,kBAAkB,IAAI,mBAAmB,EACzC,wBAAwB,IAAI,yBAAyB,EACrD,oBAAoB,IAAI,qBAAqB,EAC7C,uBAAuB,IAAI,wBAAwB,GACpD,CAAC;AAkEF;;;;;GAKG;AACH,iBAAS,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7C;AASD,iBAAS,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED,iBAAS,wBAAwB,IAAI,MAAM,CAW1C;AAcD,iBAAS,oBAAoB,IAAI,MAAM,CAMtC;AAgID,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GAAG,WAAW,GAC/B,IAAI,CA0CN;AAqED,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C;AAyED,iBAAS,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CA0BxE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AA+CvE,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAmJD,iBAAe,qBAAqB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAwCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAsCf;AAgID;;;;;GAKG;AACH,iBAAe,mBAAmB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf;AAsCD;;;;GAIG;AACH,iBAAe,wBAAwB,CACrC,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAED;;;GAGG;AACH,iBAAS,qBAAqB,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAqEN;AA2HD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,yCAAyC;AACzC,OAAO,EACL,qBAAqB,IAAI,sBAAsB,EAC/C,mBAAmB,IAAI,oBAAoB,EAC3C,wBAAwB,IAAI,yBAAyB,EACrD,qBAAqB,IAAI,sBAAsB,EAC/C,WAAW,IAAI,YAAY,EAC3B,kBAAkB,IAAI,mBAAmB,EACzC,eAAe,IAAI,gBAAgB,EACnC,kBAAkB,IAAI,mBAAmB,EACzC,wBAAwB,IAAI,yBAAyB,EACrD,oBAAoB,IAAI,qBAAqB,EAC7C,uBAAuB,IAAI,wBAAwB,GACpD,CAAC;AAkEF;;;;;GAKG;AACH,iBAAS,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7C;AASD,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAeN;AAED,iBAAS,wBAAwB,IAAI,MAAM,CAW1C;AAcD,iBAAS,oBAAoB,IAAI,MAAM,CAMtC;AAgID,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GAAG,WAAW,GAC/B,IAAI,CA0CN;AAqED,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C;AAyED,iBAAS,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CA0BxE"}

package/dist/cli/create.js

@@ -17,10 +17,16 @@ const POSTGRES_DEPENDENCY_VERSION = "^3.4.9";
  * Starter is pre-selected.
  */
 function starterFirst(templates) {
-    const starter = templates.find((t) => t.name === "starter");
-    if (!starter)
+    return moveTemplatesToFront(templates, ["starter"]);
+}
+function moveTemplatesToFront(templates, preferredNames) {
+    const preferred = preferredNames
+        .map((name) => templates.find((t) => t.name === name))
+        .filter((template) => Boolean(template));
+    if (preferred.length === 0)
         return templates;
-    return [starter, ...templates.filter((t) => t.name !== "starter")];
+    const preferredSet = new Set(preferred.map((t) => t.name));
+    return [...preferred, ...templates.filter((t) => !preferredSet.has(t.name))];
 }
 /** Blank scaffold option appended to every picker. */
 const BLANK_OPTION = {
@@ -69,19 +75,38 @@ export async function createApp(name, opts) {
 async function createWorkspaceInteractive(name, opts, clack) {
     clack.intro("Create a new agent-native workspace");
     name = await promptNameIfMissing(name, clack, "workspace", "my-platform");
+    const preselected = parseTemplateList(opts?.template);
+    const dispatchRecommendation = preselected.length === 0
+        ? [
+            "Dispatch is preselected because it is the recommended workspace",
+            "control plane for secrets, messaging, approvals, and cross-app routing.",
+        ]
+        : preselected.includes("dispatch")
+            ? [
+                "Dispatch is included, so the workspace will have a central",
+                "control plane for secrets, messaging, approvals, and cross-app routing.",
+            ]
+            : [
+                "Dispatch is recommended for most workspaces. You can add it later",
+                "with `agent-native add-app --template=dispatch` if you skip it now.",
+            ];
     clack.note([
-        "A workspace is a monorepo that holds one or more apps sharing auth,",
-        "database, and the agent chat. Pick as many as you want — you can add",
-        "more later with `agent-native add-app`. Starter is a minimal scaffold,",
+        `You're creating a workspace named "${name}". A workspace is a monorepo`,
+        "container — it isn't an app itself. Inside it you pick one or more apps",
+        "(below), and each app gets its own route, agent, and UI. Apps in the",
+        "same workspace share auth, database, and the agent chat. Add more apps",
+        "later with `agent-native add-app`. Starter is a minimal scaffold —",
         "useful as a blank app to build from scratch alongside the others.",
+        ...dispatchRecommendation,
     ].join("\n"), "About workspaces");
     // If templates were explicitly passed via --template, use them directly.
     // Otherwise show the multi-select picker.
-    const preselected = parseTemplateList(opts?.template);
     const templates = preselected.length > 0
         ? preselected
         : await promptTemplatePicker(preselected, clack, {
-            defaultTemplates: ["starter", "dispatch"],
+            defaultTemplates: ["dispatch", "starter"],
+            preferredFirst: ["dispatch", "starter"],
+            recommendedNames: ["dispatch"],
         });
     if (templates.length === 0) {
         clack.cancel("No apps selected. Cancelled.");
@@ -126,15 +151,39 @@ async function createWorkspaceInteractive(name, opts, clack) {
         process.exit(1);
     }
     tryGitInit(targetDir);
+    // Show the user the tree we just built so the workspace/app distinction is
+    // visible, not just described. First-time users routinely expect their
+    // workspace name to be the app — seeing apps/<template>/ subdirectories
+    // makes the structure concrete.
+    const treeLines = [
+        `  ${name}/                    ← your workspace`,
+        ...templates.map((t, i) => `  ${i === templates.length - 1 ? "└─" : "├─"} apps/${t}/`.padEnd(30) +
+            `   ← app`),
+    ];
+    const dispatchNextStep = templates.includes("dispatch")
+        ? [
+            `Once running, open Dispatch — you'll see "Workspace: ${titleCase(name)}"`,
+            `at the top, with all your apps listed under it.`,
+        ]
+        : [
+            `This workspace does not include Dispatch. We generally recommend it`,
+            `for workspace secrets, messaging, approvals, and cross-app routing.`,
+        ];
     clack.outro([
-        `Done! Next steps:`,
+        `Created workspace "${name}" with ${templates.length} app${templates.length === 1 ? "" : "s"}:`,
+        ``,
+        ...treeLines,
+        ``,
+        `Next steps:`,
         ``,
         `  cd ${name}`,
         `  pnpm install`,
-        `  pnpm dev`,
+        `  pnpm dev          # starts every app in the workspace`,
         ``,
-        `Add another app later:  agent-native add-app`,
-        `Deploy the whole workspace:  agent-native deploy`,
+        ...dispatchNextStep,
+        ``,
+        `Add another app later:        agent-native add-app`,
+        `Deploy the whole workspace:   agent-native deploy`,
     ].join("\n"));
 }
 async function scaffoldWorkspaceRoot(targetDir, name) {
@@ -197,9 +246,13 @@ export async function addAppToWorkspace(name, opts) {
         await scaffoldOneAppIntoWorkspace(workspace, name, tpl, clack);
         return;
     }
+    const hasDispatch = installed.includes("dispatch");
     const templates = await promptTemplatePicker(preselected, clack, {
         excludeNames: installed,
         message: "Which apps do you want to add?",
+        defaultTemplates: hasDispatch ? undefined : ["dispatch"],
+        preferredFirst: hasDispatch ? ["starter"] : ["dispatch", "starter"],
+        recommendedNames: hasDispatch ? [] : ["dispatch"],
     });
     if (templates.length === 0) {
         clack.cancel("No apps selected. Cancelled.");
@@ -232,7 +285,7 @@ async function scaffoldOneAppIntoWorkspace(workspace, appName, templateName, cla
             workspaceCoreName: workspace.workspaceCoreName,
             coreDependencyVersion: getCoreDependencyVersion(),
         });
-        fixPackageJsonName(appDir, appName);
+        fixPackageJsonName(appDir, appName, templateName);
         rewriteNetlifyToml(appDir, appName, "workspace");
         renameGitignore(appDir);
         setupAgentSymlinks(appDir);
@@ -469,7 +522,7 @@ function postProcessStandalone(name, targetDir, templateName) {
     const appTitle = titleCase(name);
     replacePlaceholders(targetDir, name, appTitle);
     rewriteTrackingAppId(targetDir, name, templateName);
-    fixPackageJsonName(targetDir, name);
+    fixPackageJsonName(targetDir, name, templateName);
     rewriteNetlifyToml(targetDir, name, "standalone");
     for (const base of ["learnings"]) {
         const defaultsFile = path.join(targetDir, `${base}.defaults.md`);
@@ -565,19 +618,27 @@ async function promptNameIfMissing(name, clack, kind, placeholder) {
 }
 async function promptTemplatePicker(preselected, clack, opts) {
     const excluded = new Set(opts?.excludeNames ?? []);
-    const options = starterFirst(coreTemplates())
+    const orderedTemplates = opts?.preferredFirst
+        ? moveTemplatesToFront(coreTemplates(), opts.preferredFirst)
+        : starterFirst(coreTemplates());
+    const recommendedNames = new Set(opts?.recommendedNames ?? []);
+    const options = orderedTemplates
         .filter((t) => !excluded.has(t.name))
         .map((t) => ({
         value: t.name,
-        label: t.label,
-        hint: t.hint,
+        label: recommendedNames.has(t.name)
+            ? `${t.label} (recommended)`
+            : t.label,
+        hint: recommendedNames.has(t.name) && t.name === "dispatch"
+            ? "Recommended workspace control plane: secrets, messaging, approvals, and A2A delegation"
+            : t.hint,
     }));
     // If there's nothing left to pick, the caller gets an empty selection —
     // they decide how to handle it.
     if (options.length === 0)
         return [];
     // Default pre-selection: what the user passed via --template, falling
-    // back to "starter" when that's available and nothing else is pre-picked.
+    // back to caller defaults, then to "starter" when available.
     const defaults = preselected.length > 0
         ? preselected.filter((p) => options.some((o) => o.value === p))
         : opts?.defaultTemplates
@@ -741,13 +802,20 @@ function titleCase(name) {
         .map((w) => (w ? w[0].toUpperCase() + w.slice(1) : w))
         .join(" ");
 }
-function fixPackageJsonName(appDir, name) {
+function fixPackageJsonName(appDir, name, templateName) {
     const pkgPath = path.join(appDir, "package.json");
     if (!fs.existsSync(pkgPath))
         return;
     try {
         const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
         pkg.name = name;
+        // When the user picked a custom name (e.g. `add-app todo --template=starter`)
+        // the template's displayName ("Agent-Native Starter") would otherwise leak
+        // into the workspace apps grid as the new app's label. Overwrite it so the
+        // app shows up as "Todo" instead of the template's branding.
+        if (templateName && name !== templateName) {
+            pkg.displayName = titleCase(name);
+        }
         fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
     }
     catch { }