@agent-native/core 0.52.0 → 0.53.0

package/dist/agent/run-loop-with-resume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-loop-with-resume.d.ts","sourceRoot":"","sources":["../../src/agent/run-loop-with-resume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,YAAY,EAIb,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,EACxC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAyFnD"}
+{"version":3,"file":"run-loop-with-resume.d.ts","sourceRoot":"","sources":["../../src/agent/run-loop-with-resume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,YAAY,EAIb,MAAM,uBAAuB,CAAC;AAqD/B;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,EACxC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CA4FnD"}

package/dist/agent/run-loop-with-resume.js

@@ -22,6 +22,52 @@
  */
 import { runAgentLoop, appendAgentLoopContinuation, isResumableEngineError, continuationReasonForResumableError, } from "./production-agent.js";
 import { resolveRunSoftTimeoutMs } from "./run-manager.js";
+import { getCurrentTurnEventsForThread } from "./run-store.js";
+import { classifyToolCallJournal, buildResumeJournalNote, } from "./tool-call-journal.js";
+/**
+ * Derive the per-turn tool-call journal from the durable run-event ledger and,
+ * when there is anything to report, append a STRUCTURED note to the message
+ * prefix so the resumed model:
+ *   - does NOT re-execute tool calls that already completed (avoiding duplicate
+ *     side effects like re-sending an email or re-creating a ticket), and
+ *   - is explicitly told about any tool call that started but whose outcome was
+ *     never recorded ("interrupted, unknown outcome") so it can decide.
+ *
+ * This is additive to the existing "continue from where you left off" nudge —
+ * it is appended right after it. When the journal is empty (no completed or
+ * interrupted tool calls — e.g. a turn with no tool activity, or a clean
+ * continuation), nothing extra is appended and resume behavior is byte-for-byte
+ * what it was before. Best-effort: any ledger read/parse failure is swallowed so
+ * a journal hiccup can never block a recovery that would otherwise succeed.
+ *
+ * TODO(charlie-merge): optional hard-block — once CHARLIE's loop edits land,
+ * pair this prompt-level journal with tool-layer enforcement in
+ * production-agent.ts/runToolCall that refuses to re-execute a journaled-
+ * complete tool call (return the journaled result instead). See
+ * `tool-call-journal.ts` for the keying to use.
+ */
+async function appendToolCallJournalNote(messages, threadId) {
+    if (!threadId)
+        return;
+    try {
+        const events = await getCurrentTurnEventsForThread(threadId);
+        if (events.length === 0)
+            return;
+        const journal = classifyToolCallJournal(events);
+        const note = buildResumeJournalNote(journal);
+        if (!note)
+            return;
+        messages.push({
+            role: "user",
+            content: [{ type: "text", text: note }],
+        });
+    }
+    catch {
+        // The journal is a hardening layer, never a gate. A failed ledger read or
+        // parse must not break the resume that the continuation nudge already set
+        // up — the model still continues, just without the structured journal.
+    }
+}
 /**
  * Cap on continuation iterations inside a single
  * `runAgentLoopDirectWithSoftTimeout` invocation. The host's hard function
@@ -89,6 +135,7 @@ export async function runAgentLoopDirectWithSoftTimeout(opts, softTimeoutMs) {
             addUsage(nextUsage);
             if (softTimedOut && !upstreamSignal.aborted) {
                 appendAgentLoopContinuation(opts.messages, "run_timeout");
+                await appendToolCallJournalNote(opts.messages, opts.threadId);
                 continue;
             }
             return usage;
@@ -99,6 +146,7 @@ export async function runAgentLoopDirectWithSoftTimeout(opts, softTimeoutMs) {
                 // resumed model doesn't re-emit it and produce duplicated output.
                 opts.send({ type: "clear" });
                 appendAgentLoopContinuation(opts.messages, "run_timeout");
+                await appendToolCallJournalNote(opts.messages, opts.threadId);
                 continue;
             }
             // Resumable transport / gateway interruptions: the LLM call was cut off
@@ -117,6 +165,7 @@ export async function runAgentLoopDirectWithSoftTimeout(opts, softTimeoutMs) {
             if (!upstreamSignal.aborted && isResumableEngineError(err)) {
                 opts.send({ type: "clear" });
                 appendAgentLoopContinuation(opts.messages, continuationReasonForResumableError(err));
+                await appendToolCallJournalNote(opts.messages, opts.threadId);
                 continue;
             }
             throw err;

package/dist/agent/run-loop-with-resume.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-loop-with-resume.js","sourceRoot":"","sources":["../../src/agent/run-loop-with-resume.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Wraps `runAgentLoop` with two layered recovery mechanisms so a single hosted\n * invocation can survive interruptions without showing the user a dead chat:\n *\n * 1. **Soft timeout** — an inner timer that aborts the LLM call before the\n *    hosting function's hard limit (Lambda 75s, Vercel 60s, etc.) so we have a\n *    chance to gracefully wind down and append a continuation nudge. Without\n *    this the function gets killed mid-stream and the user sees a frozen\n *    spinner.\n *\n * 2. **Resumable-error continuation** — when the LLM call errors with a\n *    transport- or gateway-level interruption (Builder gateway 45s timeout,\n *    socket hang up, ECONNRESET, upstream 5xx that survived engine retries),\n *    we save the conversation prefix, append a \"continue from where you left\n *    off\" message, and run another LLM call. Anthropic's prompt cache makes\n *    the resume call dramatically faster than the cold first attempt, and the\n *    agent gets explicit context that it was cut off so it doesn't re-do\n *    completed work.\n *\n * Both paths route through `appendAgentLoopContinuation` so the agent sees a\n * uniform \"continue\" instruction regardless of which recovery fired.\n */\n\nimport {\n  runAgentLoop,\n  appendAgentLoopContinuation,\n  isResumableEngineError,\n  continuationReasonForResumableError,\n} from \"./production-agent.js\";\nimport { resolveRunSoftTimeoutMs } from \"./run-manager.js\";\n\n/**\n * Cap on continuation iterations inside a single\n * `runAgentLoopDirectWithSoftTimeout` invocation. The host's hard function\n * timeout usually bounds this naturally — but a defensive cap prevents an\n * instant-error spiral from looping forever inside hosting environments with a\n * generous budget.\n *\n * 6 leaves room for: 1 normal completion + a few resume rounds for design\n * generation (prompt + 3 variants ≈ 4 LLM calls), with a small safety margin.\n */\nexport const MAX_RUN_LOOP_CONTINUATIONS = 6;\n\n/**\n * Internal entry point used by the agent-chat plugin's run handler. Wraps\n * `runAgentLoop` with soft-timeout + resumable-error continuation recovery.\n *\n * The `softTimeoutMs` argument falls back to `resolveRunSoftTimeoutMs(...)` so\n * different hosting environments (Lambda, Vercel, Cloudflare, local dev) get\n * an appropriate inner budget. Setting it to <= 0 disables both layers — the\n * call goes straight to `runAgentLoop` with no wrapping.\n */\nexport async function runAgentLoopDirectWithSoftTimeout(\n  opts: Parameters<typeof runAgentLoop>[0],\n  softTimeoutMs?: number,\n): Promise<Awaited<ReturnType<typeof runAgentLoop>>> {\n  const timeoutMs = resolveRunSoftTimeoutMs(softTimeoutMs);\n  if (timeoutMs <= 0) return runAgentLoop(opts);\n\n  const upstreamSignal = opts.signal;\n  const usage: Awaited<ReturnType<typeof runAgentLoop>> = {\n    inputTokens: 0,\n    outputTokens: 0,\n    cacheReadTokens: 0,\n    cacheWriteTokens: 0,\n    model: opts.model,\n  };\n\n  const addUsage = (next: Awaited<ReturnType<typeof runAgentLoop>>) => {\n    usage.inputTokens += next.inputTokens;\n    usage.outputTokens += next.outputTokens;\n    usage.cacheReadTokens += next.cacheReadTokens;\n    usage.cacheWriteTokens += next.cacheWriteTokens;\n    usage.model = next.model;\n  };\n\n  let attempts = 0;\n  while (!upstreamSignal.aborted && attempts < MAX_RUN_LOOP_CONTINUATIONS) {\n    attempts++;\n    const controller = new AbortController();\n    const abortFromUpstream = () => controller.abort();\n    if (upstreamSignal.aborted) {\n      controller.abort();\n    } else {\n      upstreamSignal.addEventListener(\"abort\", abortFromUpstream, {\n        once: true,\n      });\n    }\n\n    let softTimedOut = false;\n    const timer = setTimeout(() => {\n      if (controller.signal.aborted) return;\n      softTimedOut = true;\n      controller.abort();\n    }, timeoutMs);\n\n    try {\n      const nextUsage = await runAgentLoop({\n        ...opts,\n        signal: controller.signal,\n      });\n      addUsage(nextUsage);\n      if (softTimedOut && !upstreamSignal.aborted) {\n        appendAgentLoopContinuation(opts.messages, \"run_timeout\");\n        continue;\n      }\n      return usage;\n    } catch (err) {\n      if (softTimedOut && !upstreamSignal.aborted) {\n        // Clear partial text the client received before the abort so the\n        // resumed model doesn't re-emit it and produce duplicated output.\n        opts.send({ type: \"clear\" });\n        appendAgentLoopContinuation(opts.messages, \"run_timeout\");\n        continue;\n      }\n      // Resumable transport / gateway interruptions: the LLM call was cut off\n      // mid-stream (gateway 45s timeout, socket hang up, function-level\n      // timeout that didn't trip our soft timer first). Treat it the same way\n      // as a soft timeout — append a \"continue from where you left off\" nudge\n      // and let the loop run another LLM call. The conversation prefix up to\n      // the cut-off is preserved in opts.messages, and Anthropic's prompt\n      // cache makes the resume call much faster.\n      //\n      // Emit 'clear' so any partial streamed text is discarded on the client\n      // before the model resumes. Without this the model restarts its sentence\n      // from scratch and the fold produces duplicated text in one message\n      // (the partial text was already sent to the client but never entered\n      // the in-memory messages array, so the next attempt re-emits it).\n      if (!upstreamSignal.aborted && isResumableEngineError(err)) {\n        opts.send({ type: \"clear\" });\n        appendAgentLoopContinuation(\n          opts.messages,\n          continuationReasonForResumableError(err),\n        );\n        continue;\n      }\n      throw err;\n    } finally {\n      clearTimeout(timer);\n      upstreamSignal.removeEventListener(\"abort\", abortFromUpstream);\n    }\n  }\n\n  return usage;\n}\n"]}
+{"version":3,"file":"run-loop-with-resume.js","sourceRoot":"","sources":["../../src/agent/run-loop-with-resume.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Wraps `runAgentLoop` with two layered recovery mechanisms so a single hosted\n * invocation can survive interruptions without showing the user a dead chat:\n *\n * 1. **Soft timeout** — an inner timer that aborts the LLM call before the\n *    hosting function's hard limit (Lambda 75s, Vercel 60s, etc.) so we have a\n *    chance to gracefully wind down and append a continuation nudge. Without\n *    this the function gets killed mid-stream and the user sees a frozen\n *    spinner.\n *\n * 2. **Resumable-error continuation** — when the LLM call errors with a\n *    transport- or gateway-level interruption (Builder gateway 45s timeout,\n *    socket hang up, ECONNRESET, upstream 5xx that survived engine retries),\n *    we save the conversation prefix, append a \"continue from where you left\n *    off\" message, and run another LLM call. Anthropic's prompt cache makes\n *    the resume call dramatically faster than the cold first attempt, and the\n *    agent gets explicit context that it was cut off so it doesn't re-do\n *    completed work.\n *\n * Both paths route through `appendAgentLoopContinuation` so the agent sees a\n * uniform \"continue\" instruction regardless of which recovery fired.\n */\n\nimport {\n  runAgentLoop,\n  appendAgentLoopContinuation,\n  isResumableEngineError,\n  continuationReasonForResumableError,\n} from \"./production-agent.js\";\nimport { resolveRunSoftTimeoutMs } from \"./run-manager.js\";\nimport { getCurrentTurnEventsForThread } from \"./run-store.js\";\nimport {\n  classifyToolCallJournal,\n  buildResumeJournalNote,\n} from \"./tool-call-journal.js\";\nimport type { EngineMessage } from \"./engine/types.js\";\n\n/**\n * Derive the per-turn tool-call journal from the durable run-event ledger and,\n * when there is anything to report, append a STRUCTURED note to the message\n * prefix so the resumed model:\n *   - does NOT re-execute tool calls that already completed (avoiding duplicate\n *     side effects like re-sending an email or re-creating a ticket), and\n *   - is explicitly told about any tool call that started but whose outcome was\n *     never recorded (\"interrupted, unknown outcome\") so it can decide.\n *\n * This is additive to the existing \"continue from where you left off\" nudge —\n * it is appended right after it. When the journal is empty (no completed or\n * interrupted tool calls — e.g. a turn with no tool activity, or a clean\n * continuation), nothing extra is appended and resume behavior is byte-for-byte\n * what it was before. Best-effort: any ledger read/parse failure is swallowed so\n * a journal hiccup can never block a recovery that would otherwise succeed.\n *\n * TODO(charlie-merge): optional hard-block — once CHARLIE's loop edits land,\n * pair this prompt-level journal with tool-layer enforcement in\n * production-agent.ts/runToolCall that refuses to re-execute a journaled-\n * complete tool call (return the journaled result instead). See\n * `tool-call-journal.ts` for the keying to use.\n */\nasync function appendToolCallJournalNote(\n  messages: EngineMessage[],\n  threadId: string | undefined,\n): Promise<void> {\n  if (!threadId) return;\n  try {\n    const events = await getCurrentTurnEventsForThread(threadId);\n    if (events.length === 0) return;\n    const journal = classifyToolCallJournal(events);\n    const note = buildResumeJournalNote(journal);\n    if (!note) return;\n    messages.push({\n      role: \"user\",\n      content: [{ type: \"text\", text: note }],\n    });\n  } catch {\n    // The journal is a hardening layer, never a gate. A failed ledger read or\n    // parse must not break the resume that the continuation nudge already set\n    // up — the model still continues, just without the structured journal.\n  }\n}\n\n/**\n * Cap on continuation iterations inside a single\n * `runAgentLoopDirectWithSoftTimeout` invocation. The host's hard function\n * timeout usually bounds this naturally — but a defensive cap prevents an\n * instant-error spiral from looping forever inside hosting environments with a\n * generous budget.\n *\n * 6 leaves room for: 1 normal completion + a few resume rounds for design\n * generation (prompt + 3 variants ≈ 4 LLM calls), with a small safety margin.\n */\nexport const MAX_RUN_LOOP_CONTINUATIONS = 6;\n\n/**\n * Internal entry point used by the agent-chat plugin's run handler. Wraps\n * `runAgentLoop` with soft-timeout + resumable-error continuation recovery.\n *\n * The `softTimeoutMs` argument falls back to `resolveRunSoftTimeoutMs(...)` so\n * different hosting environments (Lambda, Vercel, Cloudflare, local dev) get\n * an appropriate inner budget. Setting it to <= 0 disables both layers — the\n * call goes straight to `runAgentLoop` with no wrapping.\n */\nexport async function runAgentLoopDirectWithSoftTimeout(\n  opts: Parameters<typeof runAgentLoop>[0],\n  softTimeoutMs?: number,\n): Promise<Awaited<ReturnType<typeof runAgentLoop>>> {\n  const timeoutMs = resolveRunSoftTimeoutMs(softTimeoutMs);\n  if (timeoutMs <= 0) return runAgentLoop(opts);\n\n  const upstreamSignal = opts.signal;\n  const usage: Awaited<ReturnType<typeof runAgentLoop>> = {\n    inputTokens: 0,\n    outputTokens: 0,\n    cacheReadTokens: 0,\n    cacheWriteTokens: 0,\n    model: opts.model,\n  };\n\n  const addUsage = (next: Awaited<ReturnType<typeof runAgentLoop>>) => {\n    usage.inputTokens += next.inputTokens;\n    usage.outputTokens += next.outputTokens;\n    usage.cacheReadTokens += next.cacheReadTokens;\n    usage.cacheWriteTokens += next.cacheWriteTokens;\n    usage.model = next.model;\n  };\n\n  let attempts = 0;\n  while (!upstreamSignal.aborted && attempts < MAX_RUN_LOOP_CONTINUATIONS) {\n    attempts++;\n    const controller = new AbortController();\n    const abortFromUpstream = () => controller.abort();\n    if (upstreamSignal.aborted) {\n      controller.abort();\n    } else {\n      upstreamSignal.addEventListener(\"abort\", abortFromUpstream, {\n        once: true,\n      });\n    }\n\n    let softTimedOut = false;\n    const timer = setTimeout(() => {\n      if (controller.signal.aborted) return;\n      softTimedOut = true;\n      controller.abort();\n    }, timeoutMs);\n\n    try {\n      const nextUsage = await runAgentLoop({\n        ...opts,\n        signal: controller.signal,\n      });\n      addUsage(nextUsage);\n      if (softTimedOut && !upstreamSignal.aborted) {\n        appendAgentLoopContinuation(opts.messages, \"run_timeout\");\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      return usage;\n    } catch (err) {\n      if (softTimedOut && !upstreamSignal.aborted) {\n        // Clear partial text the client received before the abort so the\n        // resumed model doesn't re-emit it and produce duplicated output.\n        opts.send({ type: \"clear\" });\n        appendAgentLoopContinuation(opts.messages, \"run_timeout\");\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      // Resumable transport / gateway interruptions: the LLM call was cut off\n      // mid-stream (gateway 45s timeout, socket hang up, function-level\n      // timeout that didn't trip our soft timer first). Treat it the same way\n      // as a soft timeout — append a \"continue from where you left off\" nudge\n      // and let the loop run another LLM call. The conversation prefix up to\n      // the cut-off is preserved in opts.messages, and Anthropic's prompt\n      // cache makes the resume call much faster.\n      //\n      // Emit 'clear' so any partial streamed text is discarded on the client\n      // before the model resumes. Without this the model restarts its sentence\n      // from scratch and the fold produces duplicated text in one message\n      // (the partial text was already sent to the client but never entered\n      // the in-memory messages array, so the next attempt re-emits it).\n      if (!upstreamSignal.aborted && isResumableEngineError(err)) {\n        opts.send({ type: \"clear\" });\n        appendAgentLoopContinuation(\n          opts.messages,\n          continuationReasonForResumableError(err),\n        );\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      throw err;\n    } finally {\n      clearTimeout(timer);\n      upstreamSignal.removeEventListener(\"abort\", abortFromUpstream);\n    }\n  }\n\n  return usage;\n}\n"]}

package/dist/agent/run-store.d.ts

@@ -1,3 +1,4 @@
+import type { AgentChatEvent } from "./types.js";
 /**
  * Max time without a heartbeat before a "running" run is considered dead.
  * The run-manager heartbeats every 1.5s, so 15s tolerates ~9 missed writes.
@@ -107,6 +108,22 @@ export declare function getRunByThread(threadId: string, options?: {
     completedAt: number | null;
     lastProgressAt: number | null;
 } | null>;
+/**
+ * Read the current logical turn's recorded events for a thread, parsed into
+ * `AgentChatEvent`s in seq order, for per-turn tool-call journal classification
+ * (see `tool-call-journal.ts`). Read-only and additive — reuses the existing
+ * `agent_runs` / `agent_run_events` ledger with no schema change.
+ *
+ * A logical turn may span several continuation runs (each chunk is its own run
+ * sharing one `turn_id`), so we union the events of every run that belongs to
+ * the latest turn for this thread. Events are ordered by (started_at, seq) so
+ * earlier chunks come before later ones and the positional `tool_start` →
+ * `tool_done` matching in the classifier stays correct across chunk boundaries.
+ *
+ * Returns an empty array when the thread has no run yet or no parseable events.
+ * Best-effort on parse: malformed ledger rows are skipped rather than thrown.
+ */
+export declare function getCurrentTurnEventsForThread(threadId: string): Promise<AgentChatEvent[]>;
 /**
  * Expire any "running" rows whose heartbeat is stale — producer died.
  * Safe to call at server startup on multi-isolate deployments: only rows

package/dist/agent/run-store.d.ts.map

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

package/dist/agent/run-store.js

@@ -451,6 +451,61 @@ export async function getRunByThread(threadId, options) {
         lastProgressAt: r.last_progress_at == null ? null : Number(r.last_progress_at),
     };
 }
+/**
+ * Read the current logical turn's recorded events for a thread, parsed into
+ * `AgentChatEvent`s in seq order, for per-turn tool-call journal classification
+ * (see `tool-call-journal.ts`). Read-only and additive — reuses the existing
+ * `agent_runs` / `agent_run_events` ledger with no schema change.
+ *
+ * A logical turn may span several continuation runs (each chunk is its own run
+ * sharing one `turn_id`), so we union the events of every run that belongs to
+ * the latest turn for this thread. Events are ordered by (started_at, seq) so
+ * earlier chunks come before later ones and the positional `tool_start` →
+ * `tool_done` matching in the classifier stays correct across chunk boundaries.
+ *
+ * Returns an empty array when the thread has no run yet or no parseable events.
+ * Best-effort on parse: malformed ledger rows are skipped rather than thrown.
+ */
+export async function getCurrentTurnEventsForThread(threadId) {
+    await ensureRunTables();
+    const client = getDbExec();
+    // Find the latest run for this thread (terminal or running) to learn the
+    // logical turn id. The journal is consulted on the resume path, where the
+    // just-interrupted run is typically already terminal.
+    const latest = await client.execute({
+        sql: `SELECT id, turn_id FROM agent_runs WHERE thread_id = ? ORDER BY started_at DESC LIMIT 1`,
+        args: [threadId],
+    });
+    if (latest.rows.length === 0)
+        return [];
+    const latestRow = latest.rows[0];
+    const turnId = latestRow.turn_id ?? latestRow.id;
+    // Gather every run that belongs to this logical turn, oldest chunk first, and
+    // read their events in seq order. COALESCE(turn_id, id) folds older rows that
+    // predate the turn_id backfill into a turn keyed by their own run id.
+    const { rows } = await client.execute({
+        sql: `SELECT e.event_data AS event_data
+          FROM agent_run_events e
+          JOIN agent_runs r ON r.id = e.run_id
+          WHERE r.thread_id = ?
+            AND COALESCE(r.turn_id, r.id) = ?
+          ORDER BY r.started_at ASC, e.seq ASC`,
+        args: [threadId, turnId],
+    });
+    const events = [];
+    for (const r of rows) {
+        const raw = r.event_data;
+        if (!raw)
+            continue;
+        try {
+            events.push(JSON.parse(raw));
+        }
+        catch {
+            // Skip malformed ledger rows — the journal is best-effort.
+        }
+    }
+    return events;
+}
 /**
  * Expire any "running" rows whose heartbeat is stale — producer died.
  * Safe to call at server startup on multi-isolate deployments: only rows

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

@@ -1 +1 @@
-{"version":3,"file":"run-store.js","sourceRoot":"","sources":["../../src/agent/run-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SQL persistence for agent runs and events.\n * Enables cross-isolate access on Cloudflare Workers and\n * reliable reconnection after page refreshes.\n */\nimport { getDbExec, intType, isPostgres } from \"../db/client.js\";\nimport { captureError } from \"../server/capture-error.js\";\n\nlet _initPromise: Promise<void> | undefined;\n\n/**\n * Max time without a heartbeat before a \"running\" run is considered dead.\n * The run-manager heartbeats every 1.5s, so 15s tolerates ~9 missed writes.\n * Widened from 6s to absorb real-world DB latency spikes and GC pauses that\n * caused false-positive reaps: a live run whose heartbeat lagged 6s+ would be\n * reaped and a zombie would keep running, eventually clobbering the new row.\n */\nexport const RUN_STALE_MS = 15_000;\n\nexport const STALE_RUN_ERROR_EVENT = {\n  type: \"error\",\n  error:\n    \"The agent stopped before it could finish. It may have hit a server timeout or the worker may have been interrupted.\",\n  errorCode: \"stale_run\",\n  recoverable: true,\n  details:\n    \"The run heartbeat stopped while the run was still marked running. Partial output and tool calls were preserved when available.\",\n} as const;\n\nasync function ensureRunTables(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_runs (\n          id TEXT PRIMARY KEY,\n          thread_id TEXT NOT NULL,\n          status TEXT NOT NULL DEFAULT 'running',\n          abort_reason TEXT,\n          started_at ${intType()} NOT NULL,\n          completed_at ${intType()},\n          heartbeat_at ${intType()},\n          last_progress_at ${intType()},\n          turn_id TEXT,\n          error_code TEXT,\n          error_detail TEXT\n        )\n      `);\n      // Backfill heartbeat_at on older deployments.\n      try {\n        if (isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS heartbeat_at ${intType()}`,\n          );\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS abort_reason TEXT`,\n          );\n        } else {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN heartbeat_at ${intType()}`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      try {\n        if (!isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN abort_reason TEXT`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      // Backfill last_progress_at — this is distinct from heartbeat_at.\n      // heartbeat_at = \"the producer process is alive\" (bumped on a timer).\n      // last_progress_at = \"the agent is actually emitting events\" (bumped on\n      // each emit). The gap between them is the stuck-detector signal.\n      try {\n        if (isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS last_progress_at ${intType()}`,\n          );\n        } else {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN last_progress_at ${intType()}`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      // Backfill turn_id / error_code / error_detail.\n      //   turn_id    = stable identity for one logical assistant turn that may\n      //                span several continuation runs, so the durable record\n      //                can be folded across runs instead of dropped per-run.\n      //   error_code / error_detail = terminal failure classification captured\n      //                at completion so errored/cut-off runs are queryable for\n      //                pattern analysis (see listErroredRuns).\n      for (const col of [\"turn_id\", \"error_code\", \"error_detail\"] as const) {\n        try {\n          if (isPostgres()) {\n            await client.execute(\n              `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS ${col} TEXT`,\n            );\n          } else {\n            await client.execute(\n              `ALTER TABLE agent_runs ADD COLUMN ${col} TEXT`,\n            );\n          }\n        } catch {\n          // Column already exists — ignore\n        }\n      }\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_run_events (\n          run_id TEXT NOT NULL,\n          seq ${intType()} NOT NULL,\n          event_data TEXT NOT NULL,\n          PRIMARY KEY (run_id, seq)\n        )\n      `);\n      // Tool-call result ledger: persists the outcome of write tool calls that\n      // completed AFTER their chunk was abandoned (zombie completions). A\n      // resumed continuation can recover the real result by matching\n      // thread_id + tool_key (name:stableInputHash) instead of re-executing\n      // the side effect. Entries are scoped to the thread and expire with it.\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_tool_ledger (\n          thread_id TEXT NOT NULL,\n          tool_key TEXT NOT NULL,\n          result_summary TEXT NOT NULL,\n          completed_at ${intType()} NOT NULL,\n          PRIMARY KEY (thread_id, tool_key)\n        )\n      `);\n    })().catch((err) => {\n      // Retry init on the next call after a failed startup.\n      _initPromise = undefined;\n      throw err;\n    });\n  }\n  return _initPromise;\n}\n\n// ─── Tool-call result ledger ─────────────────────────────────────────────────\n//\n// When the run-level abort signal fires (soft timeout / user cancel) while a\n// write tool is in-flight, `Promise.race` abandons the call — but the action's\n// Promise continues running in the background (a \"zombie\"). If the zombie\n// resolves before the continuation's next tool dispatch, we record the result\n// here so the continuation can recover it without re-executing the side effect.\n//\n// Keyed by (thread_id, tool_key) where tool_key = \"<toolName>:<stableJsonHash>\".\n// The write is fire-and-forget from the hot path; reads are synchronous look-\n// ups at the start of each write-tool dispatch in the continuation.\n\n/** Max length for a persisted result summary (8 KB). */\nconst LEDGER_RESULT_MAX_CHARS = 8_000;\n\n/**\n * Persist a zombie tool-call completion to the ledger. Called by the detached\n * promise continuation after `Promise.race` abandons it. Best-effort — never\n * throws so a ledger write failure doesn't break any caller.\n */\nexport async function writeLedgerEntry(\n  threadId: string,\n  toolKey: string,\n  resultSummary: string,\n): Promise<void> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    const capped =\n      resultSummary.length > LEDGER_RESULT_MAX_CHARS\n        ? resultSummary.slice(0, LEDGER_RESULT_MAX_CHARS) +\n          `\\n...[ledger truncated at ${LEDGER_RESULT_MAX_CHARS} chars]`\n        : resultSummary;\n    await client.execute({\n      sql: `INSERT INTO agent_tool_ledger (thread_id, tool_key, result_summary, completed_at)\n            VALUES (?, ?, ?, ?)\n            ON CONFLICT (thread_id, tool_key) DO UPDATE SET\n              result_summary = excluded.result_summary,\n              completed_at = excluded.completed_at`,\n      args: [threadId, toolKey, capped, Date.now()],\n    });\n  } catch {\n    // Ledger is best-effort; never surface failures to the caller.\n  }\n}\n\n/**\n * Look up a prior zombie completion for this thread + tool key. Returns the\n * persisted result summary, or `null` when no entry exists.\n */\nexport async function readLedgerEntry(\n  threadId: string,\n  toolKey: string,\n): Promise<string | null> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    const { rows } = await client.execute({\n      sql: `SELECT result_summary FROM agent_tool_ledger WHERE thread_id = ? AND tool_key = ?`,\n      args: [threadId, toolKey],\n    });\n    if (rows.length === 0) return null;\n    const row = rows[0] as { result_summary: string };\n    return row.result_summary;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Delete ledger entries for a thread. Called after a turn fully completes so\n * old entries don't bleed into the next turn's disambiguation.\n * Best-effort — never throws.\n */\nexport async function clearLedgerForThread(threadId: string): Promise<void> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    await client.execute({\n      sql: `DELETE FROM agent_tool_ledger WHERE thread_id = ?`,\n      args: [threadId],\n    });\n  } catch {\n    // Best-effort.\n  }\n}\n\nexport async function insertRun(\n  id: string,\n  threadId: string,\n  turnId?: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const now = Date.now();\n  await client.execute({\n    sql: `INSERT INTO agent_runs (id, thread_id, status, started_at, heartbeat_at, last_progress_at, turn_id) VALUES (?, ?, 'running', ?, ?, ?, ?)`,\n    args: [id, threadId, now, now, now, turnId ?? id],\n  });\n}\n\n/**\n * Atomically acquire a run lease for a thread. Succeeds (returns true) only\n * when no other run for the same thread is currently status='running' with a\n * fresh heartbeat. Works for both Postgres and SQLite: the stale-cutoff\n * comparison lets a dead producer's run be replaced without waiting for the\n * reaper, mirroring the logic in `reapIfStale`.\n *\n * Callers that win the claim then insert the run row normally; callers that\n * lose skip the run and return the existing active runId to the caller.\n */\nexport async function tryClaimRunSlot(\n  threadId: string,\n  maxStaleMs: number = RUN_STALE_MS,\n): Promise<{ claimed: boolean; activeRunId: string | null }> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const heartbeatCutoff = Date.now() - maxStaleMs;\n  const { rows } = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE thread_id = ?\n            AND status = 'running'\n            AND COALESCE(heartbeat_at, started_at) >= ?\n          ORDER BY started_at DESC LIMIT 1`,\n    args: [threadId, heartbeatCutoff],\n  });\n  if (rows.length > 0) {\n    const row = rows[0] as { id: string };\n    return { claimed: false, activeRunId: row.id };\n  }\n  return { claimed: true, activeRunId: null };\n}\n\n/**\n * Record terminal failure classification for a run so cut-off / errored runs\n * can be surfaced for pattern analysis (see listErroredRuns). Best-effort —\n * never throws, since it runs on the completion path that must not fail the run.\n */\nexport async function setRunError(\n  runId: string,\n  errorCode: string | undefined,\n  errorDetail: string | undefined,\n): Promise<void> {\n  if (!errorCode && !errorDetail) return;\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    await client.execute({\n      sql: `UPDATE agent_runs SET error_code = ?, error_detail = ? WHERE id = ?`,\n      args: [\n        errorCode ?? null,\n        errorDetail ? errorDetail.slice(0, 2000) : null,\n        runId,\n      ],\n    });\n  } catch {\n    // Diagnostics are best-effort; never let them break completion.\n  }\n}\n\n/** Update the run's liveness heartbeat. Called periodically by run-manager. */\nexport async function updateRunHeartbeat(runId: string): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET heartbeat_at = ? WHERE id = ?`,\n    args: [Date.now(), runId],\n  });\n}\n\n/**\n * Bump `last_progress_at` — call this whenever the agent actually emits an\n * event (token, tool call, message). Distinct from `heartbeat_at` so the\n * stuck-detector can tell \"process alive but nothing happening\" from\n * \"process dead.\" Callers should throttle (run-manager debounces to ~1/s).\n */\nexport async function bumpRunProgress(runId: string): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET last_progress_at = ? WHERE id = ?`,\n    args: [Date.now(), runId],\n  });\n}\n\n/**\n * If the given run is marked \"running\" in SQL but its heartbeat is stale\n * (producer likely crashed), flip it to \"errored\" so watchers stop waiting.\n * Returns true if the row was reaped.\n */\nexport async function reapIfStale(\n  runId: string,\n  maxStaleMs: number = RUN_STALE_MS,\n): Promise<boolean> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const completedAt = Date.now();\n  const cutoff = completedAt - maxStaleMs;\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE id = ?\n            AND status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      runId,\n      cutoff,\n    ],\n  });\n  const reaped = (rowsAffected ?? 0) > 0;\n  if (reaped) {\n    await safeAppendTerminalRunEvent(\n      runId,\n      STALE_RUN_ERROR_EVENT,\n      \"reap-if-stale\",\n    );\n  }\n  return reaped;\n}\n\nexport async function updateRunStatus(\n  runId: string,\n  status: \"completed\" | \"errored\" | \"aborted\",\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ?`,\n    args: [status, Date.now(), runId],\n  });\n}\n\n/**\n * Conditional terminal status write: only updates if the row still belongs to\n * this run AND is still status='running'. Returns true when the update landed.\n *\n * This is the safe variant used by the producer's finally block so a zombie run\n * (reaped while executing) can never clobber the status written by the reaper\n * or a replacement run.\n */\nexport async function updateRunStatusIfRunning(\n  runId: string,\n  status: \"completed\" | \"errored\" | \"aborted\",\n): Promise<boolean> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ? AND status = 'running'`,\n    args: [status, Date.now(), runId],\n  });\n  return (rowsAffected ?? 0) > 0;\n}\n\n/** Read the current status of a run row. Returns null when the row is missing. */\nexport async function getRunStatus(runId: string): Promise<string | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT status FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return null;\n  return String((rows[0] as { status: string }).status);\n}\n\nexport async function markRunAborted(\n  runId: string,\n  reason?: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET status = 'aborted', abort_reason = ?, completed_at = ? WHERE id = ?`,\n    args: [reason ?? \"user\", Date.now(), runId],\n  });\n  await safeAppendTerminalRunEvent(runId, { type: \"done\" }, \"mark-aborted\");\n}\n\nexport async function isRunAborted(runId: string): Promise<boolean> {\n  return (await getRunAbortState(runId)).aborted;\n}\n\nexport async function getRunAbortState(\n  runId: string,\n): Promise<{ aborted: boolean; reason?: string }> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT status, abort_reason FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return { aborted: false };\n  const row = rows[0] as { status: string; abort_reason?: string | null };\n  if (row.status !== \"aborted\") return { aborted: false };\n  return {\n    aborted: true,\n    ...(row.abort_reason ? { reason: row.abort_reason } : {}),\n  };\n}\n\nexport async function insertRunEvent(\n  runId: string,\n  seq: number,\n  eventData: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  // ON CONFLICT DO NOTHING: a (runId, seq) collision can happen on the\n  // soft-timeout / terminal-event path where `pendingTerminalEvent` was\n  // assigned a seq that later gets reused by an event pushed after it.\n  // It can also race with `appendTerminalRunEvent` (max-seq + 1) when a\n  // run aborts at the same time the producer emits its final event.\n  // Treat the second write as a no-op so the run completes cleanly.\n  await client.execute({\n    sql: `INSERT INTO agent_run_events (run_id, seq, event_data) VALUES (?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,\n    args: [runId, seq, eventData],\n  });\n}\n\nexport async function getRunEventsSince(\n  runId: string,\n  fromSeq: number,\n): Promise<Array<{ seq: number; eventData: string }>> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT seq, event_data FROM agent_run_events WHERE run_id = ? AND seq >= ? ORDER BY seq ASC`,\n    args: [runId, fromSeq],\n  });\n  return rows.map((r) => {\n    const row = r as { seq: number | string; event_data: string };\n    return { seq: Number(row.seq), eventData: row.event_data };\n  });\n}\n\nexport async function getRunById(runId: string): Promise<{\n  id: string;\n  threadId: string;\n  status: string;\n  startedAt: number;\n} | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, status, started_at FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return null;\n  const r = rows[0] as {\n    id: string;\n    thread_id: string;\n    status: string;\n    started_at: number | string;\n  };\n  return {\n    id: r.id,\n    threadId: r.thread_id,\n    status: r.status,\n    startedAt: Number(r.started_at),\n  };\n}\n\nexport async function getRunByThread(\n  threadId: string,\n  options?: { includeTerminal?: boolean },\n): Promise<{\n  id: string;\n  threadId: string;\n  turnId?: string | null;\n  status: string;\n  startedAt: number;\n  heartbeatAt: number | null;\n  completedAt: number | null;\n  lastProgressAt: number | null;\n} | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const sql = options?.includeTerminal\n    ? `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at FROM agent_runs WHERE thread_id = ? ORDER BY started_at DESC LIMIT 1`\n    : `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at FROM agent_runs WHERE thread_id = ? AND status = 'running' ORDER BY started_at DESC LIMIT 1`;\n  const { rows } = await client.execute({ sql, args: [threadId] });\n  if (rows.length === 0) return null;\n  const r = rows[0] as {\n    id: string;\n    thread_id: string;\n    turn_id?: string | null;\n    status: string;\n    started_at: number | string;\n    heartbeat_at: number | string | null;\n    completed_at: number | string | null;\n    last_progress_at: number | string | null;\n  };\n  return {\n    id: r.id,\n    threadId: r.thread_id,\n    turnId: r.turn_id ?? null,\n    status: r.status,\n    startedAt: Number(r.started_at),\n    heartbeatAt: r.heartbeat_at == null ? null : Number(r.heartbeat_at),\n    completedAt: r.completed_at == null ? null : Number(r.completed_at),\n    lastProgressAt:\n      r.last_progress_at == null ? null : Number(r.last_progress_at),\n  };\n}\n\n/**\n * Expire any \"running\" rows whose heartbeat is stale — producer died.\n * Safe to call at server startup on multi-isolate deployments: only rows\n * without a fresh heartbeat get reaped, so runs owned by OTHER live\n * isolates (which keep heartbeating) are left alone.\n */\nexport async function reapAllStaleRuns(): Promise<number> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const heartbeatCutoff = Date.now() - RUN_STALE_MS;\n  const stale = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [heartbeatCutoff],\n  });\n  const completedAt = Date.now();\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      heartbeatCutoff,\n    ],\n  });\n  for (const row of stale.rows) {\n    const id = (row as { id?: unknown }).id;\n    if (typeof id === \"string\") {\n      await safeAppendTerminalRunEvent(\n        id,\n        STALE_RUN_ERROR_EVENT,\n        \"reap-all-stale\",\n      );\n    }\n  }\n  return rowsAffected ?? 0;\n}\n\n/** Delete old runs and expire stale \"running\" rows that haven't had activity\n *  (e.g. worker crashed before updating status). Completed runs are pruned at\n *  `olderThanMs`; errored/aborted runs are kept until `erroredOlderThanMs` (a\n *  longer window, falling back to `olderThanMs`) so their event log survives\n *  for cut-off pattern analysis via listErroredRuns. */\nexport async function cleanupOldRuns(\n  olderThanMs: number,\n  erroredOlderThanMs?: number,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const cutoff = Date.now() - olderThanMs;\n  const erroredCutoff =\n    Date.now() - Math.max(erroredOlderThanMs ?? 0, olderThanMs);\n  // Expire stale running rows on the absolute-age threshold — safety net\n  // for runs that never received a heartbeat (very old deployments). The\n  // SELECT covers BOTH UPDATE conditions so the terminal-event-append loop\n  // below catches every row we're about to flip — a 24h-old row with a\n  // somehow-fresh heartbeat would slip past a heartbeat-only SELECT.\n  const heartbeatCutoff = Date.now() - RUN_STALE_MS;\n  const stale = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE status = 'running'\n            AND (\n              COALESCE(heartbeat_at, started_at) < ?\n              OR started_at < ?\n    )`,\n    args: [heartbeatCutoff, cutoff],\n  });\n  const completedAt = Date.now();\n  await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running' AND started_at < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      cutoff,\n    ],\n  });\n  // Also expire runs whose heartbeat is stale — producer has died.\n  await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      heartbeatCutoff,\n    ],\n  });\n  for (const row of stale.rows) {\n    const id = (row as { id?: unknown }).id;\n    if (typeof id === \"string\") {\n      await safeAppendTerminalRunEvent(\n        id,\n        STALE_RUN_ERROR_EVENT,\n        \"cleanup-old-runs\",\n      );\n    }\n  }\n  // Delete events for old terminal runs. Completed runs prune at `cutoff`;\n  // errored/aborted runs are retained until the (longer) `erroredCutoff`.\n  await client.execute({\n    sql: `DELETE FROM agent_run_events WHERE run_id IN (\n      SELECT id FROM agent_runs\n      WHERE (status = 'completed' AND completed_at < ?)\n         OR (status IN ('errored', 'aborted') AND completed_at < ?)\n    )`,\n    args: [cutoff, erroredCutoff],\n  });\n  await client.execute({\n    sql: `DELETE FROM agent_runs\n          WHERE (status = 'completed' AND completed_at < ?)\n             OR (status IN ('errored', 'aborted') AND completed_at < ?)`,\n    args: [cutoff, erroredCutoff],\n  });\n}\n\n/**\n * List recent errored/aborted runs for cut-off pattern analysis. Read-only,\n * bounded, and ordered newest-first. Surfaced via the list-errored-runs action\n * so the team can see why chats are failing (terminal error code, duration,\n * turn linkage) instead of discovering it ad hoc.\n */\nexport async function listErroredRuns(options?: {\n  limit?: number;\n  sinceMs?: number;\n}): Promise<\n  Array<{\n    id: string;\n    threadId: string;\n    turnId: string | null;\n    status: string;\n    errorCode: string | null;\n    errorDetail: string | null;\n    startedAt: number;\n    completedAt: number | null;\n    durationMs: number | null;\n  }>\n> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const limit = Math.min(Math.max(Math.floor(options?.limit ?? 100), 1), 1000);\n  const since =\n    options?.sinceMs && options.sinceMs > 0 ? Date.now() - options.sinceMs : 0;\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, turn_id, status, error_code, error_detail, started_at, completed_at\n          FROM agent_runs\n          WHERE status IN ('errored', 'aborted')\n            AND COALESCE(completed_at, started_at) >= ?\n          ORDER BY COALESCE(completed_at, started_at) DESC\n          LIMIT ${limit}`,\n    args: [since],\n  });\n  return rows.map((r) => {\n    const row = r as {\n      id: string;\n      thread_id: string;\n      turn_id: string | null;\n      status: string;\n      error_code: string | null;\n      error_detail: string | null;\n      started_at: number | string;\n      completed_at: number | string | null;\n    };\n    const startedAt = Number(row.started_at);\n    const completedAt =\n      row.completed_at == null ? null : Number(row.completed_at);\n    return {\n      id: row.id,\n      threadId: row.thread_id,\n      turnId: row.turn_id ?? null,\n      status: row.status,\n      errorCode: row.error_code ?? null,\n      errorDetail: row.error_detail ?? null,\n      startedAt,\n      completedAt,\n      durationMs: completedAt == null ? null : completedAt - startedAt,\n    };\n  });\n}\n\n/**\n * Idempotently append a terminal event to a run's event stream. No-op if the\n * stream already ends in a terminal event. Used by reapers AND by SSE\n * reconnect paths that discover an `errored` run row with no terminal event\n * (e.g. an earlier reaper's silent `.catch(() => {})` swallowed the append).\n *\n * Persisting from the reconnect path is what keeps the system self-healing:\n * subsequent reconnects replay the proper terminal event from SQL instead of\n * synthesizing a fresh one each time.\n */\nexport async function ensureTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n): Promise<void> {\n  return appendTerminalRunEvent(runId, event);\n}\n\n/**\n * Append a terminal run event, retrying once on failure and reporting to\n * Sentry if both attempts fail. Background reaper paths can't surface errors\n * to a user, but they MUST eventually persist a terminal event — losing it\n * leaves reconnecting clients staring at a bare `status='errored'` row with\n * no payload to render. The previous `.catch(() => {})` callsites silently\n * dropped transient SQL blips and produced exactly that bug. Never throws.\n */\nasync function safeAppendTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n  source: string,\n): Promise<void> {\n  let firstError: unknown;\n  try {\n    await appendTerminalRunEvent(runId, event);\n    return;\n  } catch (err) {\n    firstError = err;\n  }\n  // Brief backoff — most \"transient\" SQL failures (connection blip, lock\n  // contention) clear within a couple hundred ms.\n  await new Promise<void>((resolve) => setTimeout(resolve, 100));\n  try {\n    await appendTerminalRunEvent(runId, event);\n  } catch (retryErr) {\n    captureError(retryErr, {\n      tags: {\n        component: \"agent-run-store\",\n        operation: \"append-terminal-event\",\n        source,\n      },\n      extra: {\n        runId,\n        eventType: typeof event.type === \"string\" ? event.type : \"(unknown)\",\n        firstError:\n          firstError instanceof Error ? firstError.message : String(firstError),\n      },\n    });\n  }\n}\n\nasync function appendTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT seq, event_data FROM agent_run_events WHERE run_id = ? ORDER BY seq DESC LIMIT 1`,\n    args: [runId],\n  });\n  const last = rows[0] as\n    | { seq?: number | string; event_data?: string }\n    | undefined;\n  if (last?.event_data) {\n    try {\n      const parsed = JSON.parse(last.event_data);\n      if (\n        parsed?.type === \"done\" ||\n        parsed?.type === \"error\" ||\n        parsed?.type === \"missing_api_key\" ||\n        parsed?.type === \"loop_limit\" ||\n        parsed?.type === \"auto_continue\"\n      ) {\n        return;\n      }\n    } catch {\n      // Ignore malformed rows and append the terminal event.\n    }\n  }\n  const nextSeq = last ? Number(last.seq ?? -1) + 1 : 0;\n  await client.execute({\n    sql: `INSERT INTO agent_run_events (run_id, seq, event_data) VALUES (?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,\n    args: [runId, nextSeq, JSON.stringify(event)],\n  });\n}\n"]}
+{"version":3,"file":"run-store.js","sourceRoot":"","sources":["../../src/agent/run-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SQL persistence for agent runs and events.\n * Enables cross-isolate access on Cloudflare Workers and\n * reliable reconnection after page refreshes.\n */\nimport { getDbExec, intType, isPostgres } from \"../db/client.js\";\nimport { captureError } from \"../server/capture-error.js\";\nimport type { AgentChatEvent } from \"./types.js\";\n\nlet _initPromise: Promise<void> | undefined;\n\n/**\n * Max time without a heartbeat before a \"running\" run is considered dead.\n * The run-manager heartbeats every 1.5s, so 15s tolerates ~9 missed writes.\n * Widened from 6s to absorb real-world DB latency spikes and GC pauses that\n * caused false-positive reaps: a live run whose heartbeat lagged 6s+ would be\n * reaped and a zombie would keep running, eventually clobbering the new row.\n */\nexport const RUN_STALE_MS = 15_000;\n\nexport const STALE_RUN_ERROR_EVENT = {\n  type: \"error\",\n  error:\n    \"The agent stopped before it could finish. It may have hit a server timeout or the worker may have been interrupted.\",\n  errorCode: \"stale_run\",\n  recoverable: true,\n  details:\n    \"The run heartbeat stopped while the run was still marked running. Partial output and tool calls were preserved when available.\",\n} as const;\n\nasync function ensureRunTables(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_runs (\n          id TEXT PRIMARY KEY,\n          thread_id TEXT NOT NULL,\n          status TEXT NOT NULL DEFAULT 'running',\n          abort_reason TEXT,\n          started_at ${intType()} NOT NULL,\n          completed_at ${intType()},\n          heartbeat_at ${intType()},\n          last_progress_at ${intType()},\n          turn_id TEXT,\n          error_code TEXT,\n          error_detail TEXT\n        )\n      `);\n      // Backfill heartbeat_at on older deployments.\n      try {\n        if (isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS heartbeat_at ${intType()}`,\n          );\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS abort_reason TEXT`,\n          );\n        } else {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN heartbeat_at ${intType()}`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      try {\n        if (!isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN abort_reason TEXT`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      // Backfill last_progress_at — this is distinct from heartbeat_at.\n      // heartbeat_at = \"the producer process is alive\" (bumped on a timer).\n      // last_progress_at = \"the agent is actually emitting events\" (bumped on\n      // each emit). The gap between them is the stuck-detector signal.\n      try {\n        if (isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS last_progress_at ${intType()}`,\n          );\n        } else {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN last_progress_at ${intType()}`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      // Backfill turn_id / error_code / error_detail.\n      //   turn_id    = stable identity for one logical assistant turn that may\n      //                span several continuation runs, so the durable record\n      //                can be folded across runs instead of dropped per-run.\n      //   error_code / error_detail = terminal failure classification captured\n      //                at completion so errored/cut-off runs are queryable for\n      //                pattern analysis (see listErroredRuns).\n      for (const col of [\"turn_id\", \"error_code\", \"error_detail\"] as const) {\n        try {\n          if (isPostgres()) {\n            await client.execute(\n              `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS ${col} TEXT`,\n            );\n          } else {\n            await client.execute(\n              `ALTER TABLE agent_runs ADD COLUMN ${col} TEXT`,\n            );\n          }\n        } catch {\n          // Column already exists — ignore\n        }\n      }\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_run_events (\n          run_id TEXT NOT NULL,\n          seq ${intType()} NOT NULL,\n          event_data TEXT NOT NULL,\n          PRIMARY KEY (run_id, seq)\n        )\n      `);\n      // Tool-call result ledger: persists the outcome of write tool calls that\n      // completed AFTER their chunk was abandoned (zombie completions). A\n      // resumed continuation can recover the real result by matching\n      // thread_id + tool_key (name:stableInputHash) instead of re-executing\n      // the side effect. Entries are scoped to the thread and expire with it.\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_tool_ledger (\n          thread_id TEXT NOT NULL,\n          tool_key TEXT NOT NULL,\n          result_summary TEXT NOT NULL,\n          completed_at ${intType()} NOT NULL,\n          PRIMARY KEY (thread_id, tool_key)\n        )\n      `);\n    })().catch((err) => {\n      // Retry init on the next call after a failed startup.\n      _initPromise = undefined;\n      throw err;\n    });\n  }\n  return _initPromise;\n}\n\n// ─── Tool-call result ledger ─────────────────────────────────────────────────\n//\n// When the run-level abort signal fires (soft timeout / user cancel) while a\n// write tool is in-flight, `Promise.race` abandons the call — but the action's\n// Promise continues running in the background (a \"zombie\"). If the zombie\n// resolves before the continuation's next tool dispatch, we record the result\n// here so the continuation can recover it without re-executing the side effect.\n//\n// Keyed by (thread_id, tool_key) where tool_key = \"<toolName>:<stableJsonHash>\".\n// The write is fire-and-forget from the hot path; reads are synchronous look-\n// ups at the start of each write-tool dispatch in the continuation.\n\n/** Max length for a persisted result summary (8 KB). */\nconst LEDGER_RESULT_MAX_CHARS = 8_000;\n\n/**\n * Persist a zombie tool-call completion to the ledger. Called by the detached\n * promise continuation after `Promise.race` abandons it. Best-effort — never\n * throws so a ledger write failure doesn't break any caller.\n */\nexport async function writeLedgerEntry(\n  threadId: string,\n  toolKey: string,\n  resultSummary: string,\n): Promise<void> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    const capped =\n      resultSummary.length > LEDGER_RESULT_MAX_CHARS\n        ? resultSummary.slice(0, LEDGER_RESULT_MAX_CHARS) +\n          `\\n...[ledger truncated at ${LEDGER_RESULT_MAX_CHARS} chars]`\n        : resultSummary;\n    await client.execute({\n      sql: `INSERT INTO agent_tool_ledger (thread_id, tool_key, result_summary, completed_at)\n            VALUES (?, ?, ?, ?)\n            ON CONFLICT (thread_id, tool_key) DO UPDATE SET\n              result_summary = excluded.result_summary,\n              completed_at = excluded.completed_at`,\n      args: [threadId, toolKey, capped, Date.now()],\n    });\n  } catch {\n    // Ledger is best-effort; never surface failures to the caller.\n  }\n}\n\n/**\n * Look up a prior zombie completion for this thread + tool key. Returns the\n * persisted result summary, or `null` when no entry exists.\n */\nexport async function readLedgerEntry(\n  threadId: string,\n  toolKey: string,\n): Promise<string | null> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    const { rows } = await client.execute({\n      sql: `SELECT result_summary FROM agent_tool_ledger WHERE thread_id = ? AND tool_key = ?`,\n      args: [threadId, toolKey],\n    });\n    if (rows.length === 0) return null;\n    const row = rows[0] as { result_summary: string };\n    return row.result_summary;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Delete ledger entries for a thread. Called after a turn fully completes so\n * old entries don't bleed into the next turn's disambiguation.\n * Best-effort — never throws.\n */\nexport async function clearLedgerForThread(threadId: string): Promise<void> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    await client.execute({\n      sql: `DELETE FROM agent_tool_ledger WHERE thread_id = ?`,\n      args: [threadId],\n    });\n  } catch {\n    // Best-effort.\n  }\n}\n\nexport async function insertRun(\n  id: string,\n  threadId: string,\n  turnId?: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const now = Date.now();\n  await client.execute({\n    sql: `INSERT INTO agent_runs (id, thread_id, status, started_at, heartbeat_at, last_progress_at, turn_id) VALUES (?, ?, 'running', ?, ?, ?, ?)`,\n    args: [id, threadId, now, now, now, turnId ?? id],\n  });\n}\n\n/**\n * Atomically acquire a run lease for a thread. Succeeds (returns true) only\n * when no other run for the same thread is currently status='running' with a\n * fresh heartbeat. Works for both Postgres and SQLite: the stale-cutoff\n * comparison lets a dead producer's run be replaced without waiting for the\n * reaper, mirroring the logic in `reapIfStale`.\n *\n * Callers that win the claim then insert the run row normally; callers that\n * lose skip the run and return the existing active runId to the caller.\n */\nexport async function tryClaimRunSlot(\n  threadId: string,\n  maxStaleMs: number = RUN_STALE_MS,\n): Promise<{ claimed: boolean; activeRunId: string | null }> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const heartbeatCutoff = Date.now() - maxStaleMs;\n  const { rows } = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE thread_id = ?\n            AND status = 'running'\n            AND COALESCE(heartbeat_at, started_at) >= ?\n          ORDER BY started_at DESC LIMIT 1`,\n    args: [threadId, heartbeatCutoff],\n  });\n  if (rows.length > 0) {\n    const row = rows[0] as { id: string };\n    return { claimed: false, activeRunId: row.id };\n  }\n  return { claimed: true, activeRunId: null };\n}\n\n/**\n * Record terminal failure classification for a run so cut-off / errored runs\n * can be surfaced for pattern analysis (see listErroredRuns). Best-effort —\n * never throws, since it runs on the completion path that must not fail the run.\n */\nexport async function setRunError(\n  runId: string,\n  errorCode: string | undefined,\n  errorDetail: string | undefined,\n): Promise<void> {\n  if (!errorCode && !errorDetail) return;\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    await client.execute({\n      sql: `UPDATE agent_runs SET error_code = ?, error_detail = ? WHERE id = ?`,\n      args: [\n        errorCode ?? null,\n        errorDetail ? errorDetail.slice(0, 2000) : null,\n        runId,\n      ],\n    });\n  } catch {\n    // Diagnostics are best-effort; never let them break completion.\n  }\n}\n\n/** Update the run's liveness heartbeat. Called periodically by run-manager. */\nexport async function updateRunHeartbeat(runId: string): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET heartbeat_at = ? WHERE id = ?`,\n    args: [Date.now(), runId],\n  });\n}\n\n/**\n * Bump `last_progress_at` — call this whenever the agent actually emits an\n * event (token, tool call, message). Distinct from `heartbeat_at` so the\n * stuck-detector can tell \"process alive but nothing happening\" from\n * \"process dead.\" Callers should throttle (run-manager debounces to ~1/s).\n */\nexport async function bumpRunProgress(runId: string): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET last_progress_at = ? WHERE id = ?`,\n    args: [Date.now(), runId],\n  });\n}\n\n/**\n * If the given run is marked \"running\" in SQL but its heartbeat is stale\n * (producer likely crashed), flip it to \"errored\" so watchers stop waiting.\n * Returns true if the row was reaped.\n */\nexport async function reapIfStale(\n  runId: string,\n  maxStaleMs: number = RUN_STALE_MS,\n): Promise<boolean> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const completedAt = Date.now();\n  const cutoff = completedAt - maxStaleMs;\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE id = ?\n            AND status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      runId,\n      cutoff,\n    ],\n  });\n  const reaped = (rowsAffected ?? 0) > 0;\n  if (reaped) {\n    await safeAppendTerminalRunEvent(\n      runId,\n      STALE_RUN_ERROR_EVENT,\n      \"reap-if-stale\",\n    );\n  }\n  return reaped;\n}\n\nexport async function updateRunStatus(\n  runId: string,\n  status: \"completed\" | \"errored\" | \"aborted\",\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ?`,\n    args: [status, Date.now(), runId],\n  });\n}\n\n/**\n * Conditional terminal status write: only updates if the row still belongs to\n * this run AND is still status='running'. Returns true when the update landed.\n *\n * This is the safe variant used by the producer's finally block so a zombie run\n * (reaped while executing) can never clobber the status written by the reaper\n * or a replacement run.\n */\nexport async function updateRunStatusIfRunning(\n  runId: string,\n  status: \"completed\" | \"errored\" | \"aborted\",\n): Promise<boolean> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ? AND status = 'running'`,\n    args: [status, Date.now(), runId],\n  });\n  return (rowsAffected ?? 0) > 0;\n}\n\n/** Read the current status of a run row. Returns null when the row is missing. */\nexport async function getRunStatus(runId: string): Promise<string | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT status FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return null;\n  return String((rows[0] as { status: string }).status);\n}\n\nexport async function markRunAborted(\n  runId: string,\n  reason?: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET status = 'aborted', abort_reason = ?, completed_at = ? WHERE id = ?`,\n    args: [reason ?? \"user\", Date.now(), runId],\n  });\n  await safeAppendTerminalRunEvent(runId, { type: \"done\" }, \"mark-aborted\");\n}\n\nexport async function isRunAborted(runId: string): Promise<boolean> {\n  return (await getRunAbortState(runId)).aborted;\n}\n\nexport async function getRunAbortState(\n  runId: string,\n): Promise<{ aborted: boolean; reason?: string }> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT status, abort_reason FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return { aborted: false };\n  const row = rows[0] as { status: string; abort_reason?: string | null };\n  if (row.status !== \"aborted\") return { aborted: false };\n  return {\n    aborted: true,\n    ...(row.abort_reason ? { reason: row.abort_reason } : {}),\n  };\n}\n\nexport async function insertRunEvent(\n  runId: string,\n  seq: number,\n  eventData: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  // ON CONFLICT DO NOTHING: a (runId, seq) collision can happen on the\n  // soft-timeout / terminal-event path where `pendingTerminalEvent` was\n  // assigned a seq that later gets reused by an event pushed after it.\n  // It can also race with `appendTerminalRunEvent` (max-seq + 1) when a\n  // run aborts at the same time the producer emits its final event.\n  // Treat the second write as a no-op so the run completes cleanly.\n  await client.execute({\n    sql: `INSERT INTO agent_run_events (run_id, seq, event_data) VALUES (?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,\n    args: [runId, seq, eventData],\n  });\n}\n\nexport async function getRunEventsSince(\n  runId: string,\n  fromSeq: number,\n): Promise<Array<{ seq: number; eventData: string }>> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT seq, event_data FROM agent_run_events WHERE run_id = ? AND seq >= ? ORDER BY seq ASC`,\n    args: [runId, fromSeq],\n  });\n  return rows.map((r) => {\n    const row = r as { seq: number | string; event_data: string };\n    return { seq: Number(row.seq), eventData: row.event_data };\n  });\n}\n\nexport async function getRunById(runId: string): Promise<{\n  id: string;\n  threadId: string;\n  status: string;\n  startedAt: number;\n} | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, status, started_at FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return null;\n  const r = rows[0] as {\n    id: string;\n    thread_id: string;\n    status: string;\n    started_at: number | string;\n  };\n  return {\n    id: r.id,\n    threadId: r.thread_id,\n    status: r.status,\n    startedAt: Number(r.started_at),\n  };\n}\n\nexport async function getRunByThread(\n  threadId: string,\n  options?: { includeTerminal?: boolean },\n): Promise<{\n  id: string;\n  threadId: string;\n  turnId?: string | null;\n  status: string;\n  startedAt: number;\n  heartbeatAt: number | null;\n  completedAt: number | null;\n  lastProgressAt: number | null;\n} | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const sql = options?.includeTerminal\n    ? `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at FROM agent_runs WHERE thread_id = ? ORDER BY started_at DESC LIMIT 1`\n    : `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at FROM agent_runs WHERE thread_id = ? AND status = 'running' ORDER BY started_at DESC LIMIT 1`;\n  const { rows } = await client.execute({ sql, args: [threadId] });\n  if (rows.length === 0) return null;\n  const r = rows[0] as {\n    id: string;\n    thread_id: string;\n    turn_id?: string | null;\n    status: string;\n    started_at: number | string;\n    heartbeat_at: number | string | null;\n    completed_at: number | string | null;\n    last_progress_at: number | string | null;\n  };\n  return {\n    id: r.id,\n    threadId: r.thread_id,\n    turnId: r.turn_id ?? null,\n    status: r.status,\n    startedAt: Number(r.started_at),\n    heartbeatAt: r.heartbeat_at == null ? null : Number(r.heartbeat_at),\n    completedAt: r.completed_at == null ? null : Number(r.completed_at),\n    lastProgressAt:\n      r.last_progress_at == null ? null : Number(r.last_progress_at),\n  };\n}\n\n/**\n * Read the current logical turn's recorded events for a thread, parsed into\n * `AgentChatEvent`s in seq order, for per-turn tool-call journal classification\n * (see `tool-call-journal.ts`). Read-only and additive — reuses the existing\n * `agent_runs` / `agent_run_events` ledger with no schema change.\n *\n * A logical turn may span several continuation runs (each chunk is its own run\n * sharing one `turn_id`), so we union the events of every run that belongs to\n * the latest turn for this thread. Events are ordered by (started_at, seq) so\n * earlier chunks come before later ones and the positional `tool_start` →\n * `tool_done` matching in the classifier stays correct across chunk boundaries.\n *\n * Returns an empty array when the thread has no run yet or no parseable events.\n * Best-effort on parse: malformed ledger rows are skipped rather than thrown.\n */\nexport async function getCurrentTurnEventsForThread(\n  threadId: string,\n): Promise<AgentChatEvent[]> {\n  await ensureRunTables();\n  const client = getDbExec();\n  // Find the latest run for this thread (terminal or running) to learn the\n  // logical turn id. The journal is consulted on the resume path, where the\n  // just-interrupted run is typically already terminal.\n  const latest = await client.execute({\n    sql: `SELECT id, turn_id FROM agent_runs WHERE thread_id = ? ORDER BY started_at DESC LIMIT 1`,\n    args: [threadId],\n  });\n  if (latest.rows.length === 0) return [];\n  const latestRow = latest.rows[0] as { id: string; turn_id: string | null };\n  const turnId = latestRow.turn_id ?? latestRow.id;\n  // Gather every run that belongs to this logical turn, oldest chunk first, and\n  // read their events in seq order. COALESCE(turn_id, id) folds older rows that\n  // predate the turn_id backfill into a turn keyed by their own run id.\n  const { rows } = await client.execute({\n    sql: `SELECT e.event_data AS event_data\n          FROM agent_run_events e\n          JOIN agent_runs r ON r.id = e.run_id\n          WHERE r.thread_id = ?\n            AND COALESCE(r.turn_id, r.id) = ?\n          ORDER BY r.started_at ASC, e.seq ASC`,\n    args: [threadId, turnId],\n  });\n  const events: AgentChatEvent[] = [];\n  for (const r of rows) {\n    const raw = (r as { event_data?: string }).event_data;\n    if (!raw) continue;\n    try {\n      events.push(JSON.parse(raw) as AgentChatEvent);\n    } catch {\n      // Skip malformed ledger rows — the journal is best-effort.\n    }\n  }\n  return events;\n}\n\n/**\n * Expire any \"running\" rows whose heartbeat is stale — producer died.\n * Safe to call at server startup on multi-isolate deployments: only rows\n * without a fresh heartbeat get reaped, so runs owned by OTHER live\n * isolates (which keep heartbeating) are left alone.\n */\nexport async function reapAllStaleRuns(): Promise<number> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const heartbeatCutoff = Date.now() - RUN_STALE_MS;\n  const stale = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [heartbeatCutoff],\n  });\n  const completedAt = Date.now();\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      heartbeatCutoff,\n    ],\n  });\n  for (const row of stale.rows) {\n    const id = (row as { id?: unknown }).id;\n    if (typeof id === \"string\") {\n      await safeAppendTerminalRunEvent(\n        id,\n        STALE_RUN_ERROR_EVENT,\n        \"reap-all-stale\",\n      );\n    }\n  }\n  return rowsAffected ?? 0;\n}\n\n/** Delete old runs and expire stale \"running\" rows that haven't had activity\n *  (e.g. worker crashed before updating status). Completed runs are pruned at\n *  `olderThanMs`; errored/aborted runs are kept until `erroredOlderThanMs` (a\n *  longer window, falling back to `olderThanMs`) so their event log survives\n *  for cut-off pattern analysis via listErroredRuns. */\nexport async function cleanupOldRuns(\n  olderThanMs: number,\n  erroredOlderThanMs?: number,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const cutoff = Date.now() - olderThanMs;\n  const erroredCutoff =\n    Date.now() - Math.max(erroredOlderThanMs ?? 0, olderThanMs);\n  // Expire stale running rows on the absolute-age threshold — safety net\n  // for runs that never received a heartbeat (very old deployments). The\n  // SELECT covers BOTH UPDATE conditions so the terminal-event-append loop\n  // below catches every row we're about to flip — a 24h-old row with a\n  // somehow-fresh heartbeat would slip past a heartbeat-only SELECT.\n  const heartbeatCutoff = Date.now() - RUN_STALE_MS;\n  const stale = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE status = 'running'\n            AND (\n              COALESCE(heartbeat_at, started_at) < ?\n              OR started_at < ?\n    )`,\n    args: [heartbeatCutoff, cutoff],\n  });\n  const completedAt = Date.now();\n  await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running' AND started_at < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      cutoff,\n    ],\n  });\n  // Also expire runs whose heartbeat is stale — producer has died.\n  await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      heartbeatCutoff,\n    ],\n  });\n  for (const row of stale.rows) {\n    const id = (row as { id?: unknown }).id;\n    if (typeof id === \"string\") {\n      await safeAppendTerminalRunEvent(\n        id,\n        STALE_RUN_ERROR_EVENT,\n        \"cleanup-old-runs\",\n      );\n    }\n  }\n  // Delete events for old terminal runs. Completed runs prune at `cutoff`;\n  // errored/aborted runs are retained until the (longer) `erroredCutoff`.\n  await client.execute({\n    sql: `DELETE FROM agent_run_events WHERE run_id IN (\n      SELECT id FROM agent_runs\n      WHERE (status = 'completed' AND completed_at < ?)\n         OR (status IN ('errored', 'aborted') AND completed_at < ?)\n    )`,\n    args: [cutoff, erroredCutoff],\n  });\n  await client.execute({\n    sql: `DELETE FROM agent_runs\n          WHERE (status = 'completed' AND completed_at < ?)\n             OR (status IN ('errored', 'aborted') AND completed_at < ?)`,\n    args: [cutoff, erroredCutoff],\n  });\n}\n\n/**\n * List recent errored/aborted runs for cut-off pattern analysis. Read-only,\n * bounded, and ordered newest-first. Surfaced via the list-errored-runs action\n * so the team can see why chats are failing (terminal error code, duration,\n * turn linkage) instead of discovering it ad hoc.\n */\nexport async function listErroredRuns(options?: {\n  limit?: number;\n  sinceMs?: number;\n}): Promise<\n  Array<{\n    id: string;\n    threadId: string;\n    turnId: string | null;\n    status: string;\n    errorCode: string | null;\n    errorDetail: string | null;\n    startedAt: number;\n    completedAt: number | null;\n    durationMs: number | null;\n  }>\n> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const limit = Math.min(Math.max(Math.floor(options?.limit ?? 100), 1), 1000);\n  const since =\n    options?.sinceMs && options.sinceMs > 0 ? Date.now() - options.sinceMs : 0;\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, turn_id, status, error_code, error_detail, started_at, completed_at\n          FROM agent_runs\n          WHERE status IN ('errored', 'aborted')\n            AND COALESCE(completed_at, started_at) >= ?\n          ORDER BY COALESCE(completed_at, started_at) DESC\n          LIMIT ${limit}`,\n    args: [since],\n  });\n  return rows.map((r) => {\n    const row = r as {\n      id: string;\n      thread_id: string;\n      turn_id: string | null;\n      status: string;\n      error_code: string | null;\n      error_detail: string | null;\n      started_at: number | string;\n      completed_at: number | string | null;\n    };\n    const startedAt = Number(row.started_at);\n    const completedAt =\n      row.completed_at == null ? null : Number(row.completed_at);\n    return {\n      id: row.id,\n      threadId: row.thread_id,\n      turnId: row.turn_id ?? null,\n      status: row.status,\n      errorCode: row.error_code ?? null,\n      errorDetail: row.error_detail ?? null,\n      startedAt,\n      completedAt,\n      durationMs: completedAt == null ? null : completedAt - startedAt,\n    };\n  });\n}\n\n/**\n * Idempotently append a terminal event to a run's event stream. No-op if the\n * stream already ends in a terminal event. Used by reapers AND by SSE\n * reconnect paths that discover an `errored` run row with no terminal event\n * (e.g. an earlier reaper's silent `.catch(() => {})` swallowed the append).\n *\n * Persisting from the reconnect path is what keeps the system self-healing:\n * subsequent reconnects replay the proper terminal event from SQL instead of\n * synthesizing a fresh one each time.\n */\nexport async function ensureTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n): Promise<void> {\n  return appendTerminalRunEvent(runId, event);\n}\n\n/**\n * Append a terminal run event, retrying once on failure and reporting to\n * Sentry if both attempts fail. Background reaper paths can't surface errors\n * to a user, but they MUST eventually persist a terminal event — losing it\n * leaves reconnecting clients staring at a bare `status='errored'` row with\n * no payload to render. The previous `.catch(() => {})` callsites silently\n * dropped transient SQL blips and produced exactly that bug. Never throws.\n */\nasync function safeAppendTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n  source: string,\n): Promise<void> {\n  let firstError: unknown;\n  try {\n    await appendTerminalRunEvent(runId, event);\n    return;\n  } catch (err) {\n    firstError = err;\n  }\n  // Brief backoff — most \"transient\" SQL failures (connection blip, lock\n  // contention) clear within a couple hundred ms.\n  await new Promise<void>((resolve) => setTimeout(resolve, 100));\n  try {\n    await appendTerminalRunEvent(runId, event);\n  } catch (retryErr) {\n    captureError(retryErr, {\n      tags: {\n        component: \"agent-run-store\",\n        operation: \"append-terminal-event\",\n        source,\n      },\n      extra: {\n        runId,\n        eventType: typeof event.type === \"string\" ? event.type : \"(unknown)\",\n        firstError:\n          firstError instanceof Error ? firstError.message : String(firstError),\n      },\n    });\n  }\n}\n\nasync function appendTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT seq, event_data FROM agent_run_events WHERE run_id = ? ORDER BY seq DESC LIMIT 1`,\n    args: [runId],\n  });\n  const last = rows[0] as\n    | { seq?: number | string; event_data?: string }\n    | undefined;\n  if (last?.event_data) {\n    try {\n      const parsed = JSON.parse(last.event_data);\n      if (\n        parsed?.type === \"done\" ||\n        parsed?.type === \"error\" ||\n        parsed?.type === \"missing_api_key\" ||\n        parsed?.type === \"loop_limit\" ||\n        parsed?.type === \"auto_continue\"\n      ) {\n        return;\n      }\n    } catch {\n      // Ignore malformed rows and append the terminal event.\n    }\n  }\n  const nextSeq = last ? Number(last.seq ?? -1) + 1 : 0;\n  await client.execute({\n    sql: `INSERT INTO agent_run_events (run_id, seq, event_data) VALUES (?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,\n    args: [runId, nextSeq, JSON.stringify(event)],\n  });\n}\n"]}

package/dist/agent/runtime-context.d.ts

@@ -1,6 +1,36 @@
 export interface RuntimeContextOptions {
     now?: Date;
     timezone?: string | null;
+    /**
+     * Delegation depth of the agent this prompt is built for. 0 = the top-level
+     * (user-facing) agent, 1 = a sub-agent spawned by the top-level agent, and so
+     * on. Threaded through so a spawned sub-agent knows how deep it sits and
+     * whether it is still allowed to delegate further. Omitted (or 0) for the
+     * top-level chat. See `MAX_SUBAGENT_DELEGATION_DEPTH`.
+     */
+    delegationDepth?: number;
 }
+/**
+ * Default hard cap on sub-agent delegation depth. The top-level agent is depth
+ * 0 and may spawn sub-agents (depth 1); those may spawn once more (depth 2);
+ * a spawn that would create a depth-3 sub-agent is refused. Borrowed from the
+ * "sub-agents must not infinitely spawn sub-agents" runaway/cost safety rail.
+ *
+ * Override at deploy time via `AGENT_NATIVE_MAX_SUBAGENT_DEPTH` (see
+ * `resolveMaxSubagentDelegationDepth`).
+ */
+export declare const MAX_SUBAGENT_DELEGATION_DEPTH = 2;
+/** Env var name that overrides the default sub-agent delegation-depth cap. */
+export declare const MAX_SUBAGENT_DELEGATION_DEPTH_ENV = "AGENT_NATIVE_MAX_SUBAGENT_DEPTH";
+/**
+ * Resolve the effective maximum sub-agent delegation depth.
+ *
+ * Reads `AGENT_NATIVE_MAX_SUBAGENT_DEPTH` and, when it parses to a finite
+ * non-negative integer, clamps it to `[0, MAX_SUBAGENT_DELEGATION_DEPTH_CEILING]`.
+ * Any invalid value (non-numeric, negative, NaN, Infinity, fractional) falls
+ * back to `MAX_SUBAGENT_DELEGATION_DEPTH` so a typo can never silently disable
+ * the guardrail. `0` is a valid override meaning "no sub-agents may be spawned".
+ */
+export declare function resolveMaxSubagentDelegationDepth(env?: Record<string, string | undefined>): number;
 export declare function buildRuntimeContextPrompt(options?: RuntimeContextOptions): string;
 //# sourceMappingURL=runtime-context.d.ts.map

package/dist/agent/runtime-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/agent/runtime-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAsCD,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAiBR"}
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/agent/runtime-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAQ/C,8EAA8E;AAC9E,eAAO,MAAM,iCAAiC,oCACX,CAAC;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,CAYR;AAsCD,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAiCR"}

package/dist/agent/runtime-context.js

@@ -1,3 +1,45 @@
+/**
+ * Default hard cap on sub-agent delegation depth. The top-level agent is depth
+ * 0 and may spawn sub-agents (depth 1); those may spawn once more (depth 2);
+ * a spawn that would create a depth-3 sub-agent is refused. Borrowed from the
+ * "sub-agents must not infinitely spawn sub-agents" runaway/cost safety rail.
+ *
+ * Override at deploy time via `AGENT_NATIVE_MAX_SUBAGENT_DEPTH` (see
+ * `resolveMaxSubagentDelegationDepth`).
+ */
+export const MAX_SUBAGENT_DELEGATION_DEPTH = 2;
+/**
+ * Upper bound the env override is clamped to. A misconfigured very-large value
+ * would defeat the guardrail entirely, so we cap it at a still-generous depth.
+ */
+const MAX_SUBAGENT_DELEGATION_DEPTH_CEILING = 16;
+/** Env var name that overrides the default sub-agent delegation-depth cap. */
+export const MAX_SUBAGENT_DELEGATION_DEPTH_ENV = "AGENT_NATIVE_MAX_SUBAGENT_DEPTH";
+/**
+ * Resolve the effective maximum sub-agent delegation depth.
+ *
+ * Reads `AGENT_NATIVE_MAX_SUBAGENT_DEPTH` and, when it parses to a finite
+ * non-negative integer, clamps it to `[0, MAX_SUBAGENT_DELEGATION_DEPTH_CEILING]`.
+ * Any invalid value (non-numeric, negative, NaN, Infinity, fractional) falls
+ * back to `MAX_SUBAGENT_DELEGATION_DEPTH` so a typo can never silently disable
+ * the guardrail. `0` is a valid override meaning "no sub-agents may be spawned".
+ */
+export function resolveMaxSubagentDelegationDepth(env = process.env) {
+    const raw = env[MAX_SUBAGENT_DELEGATION_DEPTH_ENV];
+    if (raw === undefined)
+        return MAX_SUBAGENT_DELEGATION_DEPTH;
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return MAX_SUBAGENT_DELEGATION_DEPTH;
+    // Only accept plain non-negative integers; reject "2.5", "1e3", "0x4", etc.
+    if (!/^\d+$/.test(trimmed))
+        return MAX_SUBAGENT_DELEGATION_DEPTH;
+    const parsed = Number(trimmed);
+    if (!Number.isSafeInteger(parsed) || parsed < 0) {
+        return MAX_SUBAGENT_DELEGATION_DEPTH;
+    }
+    return Math.min(parsed, MAX_SUBAGENT_DELEGATION_DEPTH_CEILING);
+}
 function isValidTimezone(timezone) {
     try {
         new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
@@ -37,6 +79,17 @@ export function buildRuntimeContextPrompt(options = {}) {
     const timezone = typeof options.timezone === "string" && isValidTimezone(options.timezone)
         ? options.timezone
         : "UTC";
+    const depth = typeof options.delegationDepth === "number" &&
+        Number.isFinite(options.delegationDepth) &&
+        options.delegationDepth > 0
+        ? Math.floor(options.delegationDepth)
+        : 0;
+    const maxDepth = resolveMaxSubagentDelegationDepth();
+    const delegationLine = depth > 0
+        ? `\ndelegationDepth: ${depth}\nmaxDelegationDepth: ${maxDepth}\n${depth >= maxDepth
+            ? `You are a sub-agent at the maximum delegation depth (${maxDepth}); you cannot spawn further sub-agents. Do the work yourself.`
+            : `You are a sub-agent at delegation depth ${depth} (limit ${maxDepth}); spawn additional sub-agents only when truly necessary.`}`
+        : "";
     return `
 
 <runtime-context>
@@ -44,7 +97,7 @@ currentUtc: ${now.toISOString()}
 currentDateUtc: ${formatDate(now, "UTC")}
 currentTimezone: ${timezone}
 currentDateInTimezone: ${formatDate(now, timezone)}
-currentTimeInTimezone: ${formatDateTime(now, timezone)}
+currentTimeInTimezone: ${formatDateTime(now, timezone)}${delegationLine}
 Use this runtime context as authoritative for relative dates such as today, yesterday, tomorrow, this week, and last month. Resolve relative dates to explicit calendar dates before querying data or creating artifacts, and include the exact date or date range in factual answers.
 </runtime-context>`;
 }