@agent-native/core 0.47.1 → 0.48.2

package/dist/agent/run-store.js

@@ -8,11 +8,12 @@ import { captureError } from "../server/capture-error.js";
 let _initPromise;
 /**
  * Max time without a heartbeat before a "running" run is considered dead.
- * The run-manager heartbeats every 1.5s, so 6s tolerates 3 missed writes.
- * Short window is what makes reload recovery feel instant instead of
- * stranding the user on "Thinking..." for up to 90s after a process death.
+ * The run-manager heartbeats every 1.5s, so 15s tolerates ~9 missed writes.
+ * Widened from 6s to absorb real-world DB latency spikes and GC pauses that
+ * caused false-positive reaps: a live run whose heartbeat lagged 6s+ would be
+ * reaped and a zombie would keep running, eventually clobbering the new row.
  */
-export const RUN_STALE_MS = 6_000;
+export const RUN_STALE_MS = 15_000;
 export const STALE_RUN_ERROR_EVENT = {
     type: "error",
     error: "The agent stopped before it could finish. It may have hit a server timeout or the worker may have been interrupted.",
@@ -102,6 +103,20 @@ async function ensureRunTables() {
           event_data TEXT NOT NULL,
           PRIMARY KEY (run_id, seq)
         )
+      `);
+            // Tool-call result ledger: persists the outcome of write tool calls that
+            // completed AFTER their chunk was abandoned (zombie completions). A
+            // resumed continuation can recover the real result by matching
+            // thread_id + tool_key (name:stableInputHash) instead of re-executing
+            // the side effect. Entries are scoped to the thread and expire with it.
+            await client.execute(`
+        CREATE TABLE IF NOT EXISTS agent_tool_ledger (
+          thread_id TEXT NOT NULL,
+          tool_key TEXT NOT NULL,
+          result_summary TEXT NOT NULL,
+          completed_at ${intType()} NOT NULL,
+          PRIMARY KEY (thread_id, tool_key)
+        )
       `);
         })().catch((err) => {
             // Retry init on the next call after a failed startup.
@@ -111,6 +126,84 @@ async function ensureRunTables() {
     }
     return _initPromise;
 }
+// ─── Tool-call result ledger ─────────────────────────────────────────────────
+//
+// When the run-level abort signal fires (soft timeout / user cancel) while a
+// write tool is in-flight, `Promise.race` abandons the call — but the action's
+// Promise continues running in the background (a "zombie"). If the zombie
+// resolves before the continuation's next tool dispatch, we record the result
+// here so the continuation can recover it without re-executing the side effect.
+//
+// Keyed by (thread_id, tool_key) where tool_key = "<toolName>:<stableJsonHash>".
+// The write is fire-and-forget from the hot path; reads are synchronous look-
+// ups at the start of each write-tool dispatch in the continuation.
+/** Max length for a persisted result summary (8 KB). */
+const LEDGER_RESULT_MAX_CHARS = 8_000;
+/**
+ * Persist a zombie tool-call completion to the ledger. Called by the detached
+ * promise continuation after `Promise.race` abandons it. Best-effort — never
+ * throws so a ledger write failure doesn't break any caller.
+ */
+export async function writeLedgerEntry(threadId, toolKey, resultSummary) {
+    try {
+        await ensureRunTables();
+        const client = getDbExec();
+        const capped = resultSummary.length > LEDGER_RESULT_MAX_CHARS
+            ? resultSummary.slice(0, LEDGER_RESULT_MAX_CHARS) +
+                `\n...[ledger truncated at ${LEDGER_RESULT_MAX_CHARS} chars]`
+            : resultSummary;
+        await client.execute({
+            sql: `INSERT INTO agent_tool_ledger (thread_id, tool_key, result_summary, completed_at)
+            VALUES (?, ?, ?, ?)
+            ON CONFLICT (thread_id, tool_key) DO UPDATE SET
+              result_summary = excluded.result_summary,
+              completed_at = excluded.completed_at`,
+            args: [threadId, toolKey, capped, Date.now()],
+        });
+    }
+    catch {
+        // Ledger is best-effort; never surface failures to the caller.
+    }
+}
+/**
+ * Look up a prior zombie completion for this thread + tool key. Returns the
+ * persisted result summary, or `null` when no entry exists.
+ */
+export async function readLedgerEntry(threadId, toolKey) {
+    try {
+        await ensureRunTables();
+        const client = getDbExec();
+        const { rows } = await client.execute({
+            sql: `SELECT result_summary FROM agent_tool_ledger WHERE thread_id = ? AND tool_key = ?`,
+            args: [threadId, toolKey],
+        });
+        if (rows.length === 0)
+            return null;
+        const row = rows[0];
+        return row.result_summary;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Delete ledger entries for a thread. Called after a turn fully completes so
+ * old entries don't bleed into the next turn's disambiguation.
+ * Best-effort — never throws.
+ */
+export async function clearLedgerForThread(threadId) {
+    try {
+        await ensureRunTables();
+        const client = getDbExec();
+        await client.execute({
+            sql: `DELETE FROM agent_tool_ledger WHERE thread_id = ?`,
+            args: [threadId],
+        });
+    }
+    catch {
+        // Best-effort.
+    }
+}
 export async function insertRun(id, threadId, turnId) {
     await ensureRunTables();
     const client = getDbExec();
@@ -120,6 +213,34 @@ export async function insertRun(id, threadId, turnId) {
         args: [id, threadId, now, now, now, turnId ?? id],
     });
 }
+/**
+ * Atomically acquire a run lease for a thread. Succeeds (returns true) only
+ * when no other run for the same thread is currently status='running' with a
+ * fresh heartbeat. Works for both Postgres and SQLite: the stale-cutoff
+ * comparison lets a dead producer's run be replaced without waiting for the
+ * reaper, mirroring the logic in `reapIfStale`.
+ *
+ * Callers that win the claim then insert the run row normally; callers that
+ * lose skip the run and return the existing active runId to the caller.
+ */
+export async function tryClaimRunSlot(threadId, maxStaleMs = RUN_STALE_MS) {
+    await ensureRunTables();
+    const client = getDbExec();
+    const heartbeatCutoff = Date.now() - maxStaleMs;
+    const { rows } = await client.execute({
+        sql: `SELECT id FROM agent_runs
+          WHERE thread_id = ?
+            AND status = 'running'
+            AND COALESCE(heartbeat_at, started_at) >= ?
+          ORDER BY started_at DESC LIMIT 1`,
+        args: [threadId, heartbeatCutoff],
+    });
+    if (rows.length > 0) {
+        const row = rows[0];
+        return { claimed: false, activeRunId: row.id };
+    }
+    return { claimed: true, activeRunId: null };
+}
 /**
  * Record terminal failure classification for a run so cut-off / errored runs
  * can be surfaced for pattern analysis (see listErroredRuns). Best-effort —
@@ -208,6 +329,35 @@ export async function updateRunStatus(runId, status) {
         args: [status, Date.now(), runId],
     });
 }
+/**
+ * Conditional terminal status write: only updates if the row still belongs to
+ * this run AND is still status='running'. Returns true when the update landed.
+ *
+ * This is the safe variant used by the producer's finally block so a zombie run
+ * (reaped while executing) can never clobber the status written by the reaper
+ * or a replacement run.
+ */
+export async function updateRunStatusIfRunning(runId, status) {
+    await ensureRunTables();
+    const client = getDbExec();
+    const { rowsAffected } = await client.execute({
+        sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ? AND status = 'running'`,
+        args: [status, Date.now(), runId],
+    });
+    return (rowsAffected ?? 0) > 0;
+}
+/** Read the current status of a run row. Returns null when the row is missing. */
+export async function getRunStatus(runId) {
+    await ensureRunTables();
+    const client = getDbExec();
+    const { rows } = await client.execute({
+        sql: `SELECT status FROM agent_runs WHERE id = ?`,
+        args: [runId],
+    });
+    if (rows.length === 0)
+        return null;
+    return String(rows[0].status);
+}
 export async function markRunAborted(runId, reason) {
     await ensureRunTables();
     const client = getDbExec();

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 6s tolerates 3 missed writes.\n * Short window is what makes reload recovery feel instant instead of\n * stranding the user on \"Thinking...\" for up to 90s after a process death.\n */\nexport const RUN_STALE_MS = 6_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    })().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\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 * 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\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  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, 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, 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    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    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\";\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  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, 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, 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    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    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"]}

package/dist/agent/thread-data-builder.d.ts.map

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

package/dist/agent/thread-data-builder.js

@@ -1,5 +1,12 @@
 import { normalizeCodeAgentTranscript, } from "../code-agents/transcript-normalizer.js";
 const MAX_STORED_ATTACHMENT_CHARS = 60_000;
+/**
+ * When no file-upload provider is configured we fall back to storing base64
+ * directly in the SQL thread_data column. Cap the raw base64 per attachment to
+ * avoid unbounded row growth. Attachments larger than this get a '[truncated]'
+ * marker so the transcript still renders but the column stays sane.
+ */
+const MAX_STORED_BASE64_BYTES = 2 * 1024 * 1024; // 2 MB per attachment
 function isInternalContinuationError(event) {
     const code = String(event.errorCode ?? "").toLowerCase();
     const msg = event.error.toLowerCase();
@@ -624,10 +631,57 @@ function textAttachmentEnvelope(att, text) {
     ].filter(Boolean);
     return `<attachment ${attrs.join(" ")}>\n${truncateStoredAttachment(text)}\n</attachment>`;
 }
+/**
+ * Cap a base64 data-URL string for storage. When the encoded string is over
+ * the limit we replace the base64 payload with a truncation marker so the
+ * transcript still renders the attachment chip but doesn't bloat SQL.
+ */
+function capBase64DataUrl(dataUrl) {
+    const commaIdx = dataUrl.indexOf(",");
+    if (commaIdx === -1)
+        return dataUrl;
+    const header = dataUrl.slice(0, commaIdx + 1);
+    const b64 = dataUrl.slice(commaIdx + 1);
+    // Each base64 char encodes 6 bits; 4 chars = 3 bytes.
+    const approxBytes = Math.floor((b64.length * 3) / 4);
+    if (approxBytes <= MAX_STORED_BASE64_BYTES)
+        return dataUrl;
+    return `${header}[base64 truncated — ${approxBytes.toLocaleString()} bytes exceeds storage limit]`;
+}
 function buildStoredAttachments(attachments, runId) {
     return (attachments ?? [])
         .map((att, index) => {
         const id = `server-${runId ?? Date.now()}-attachment-${index}`;
+        // When the attachment was successfully pre-uploaded, store only the URL
+        // reference. This keeps the SQL thread_data row compact regardless of
+        // file size, and lets the transcript render from the hosted URL instead
+        // of re-shipping megabytes of base64 on every poll save.
+        const uploadedUrl = att.url;
+        if (uploadedUrl) {
+            return {
+                id,
+                type: att.type === "image" ? "image" : "file",
+                name: att.name,
+                contentType: att.contentType,
+                status: { type: "complete" },
+                // URL reference shape — content[0] uses the hosted URL.
+                content: att.type === "image"
+                    ? [{ type: "image", image: uploadedUrl }]
+                    : [
+                        {
+                            type: "file",
+                            url: uploadedUrl,
+                            mimeType: att.contentType,
+                            filename: att.name,
+                        },
+                    ],
+                // Keep the reference metadata for tooling / read-attachment.
+                metadata: {
+                    uploadUrl: uploadedUrl,
+                    uploadProvider: att.uploadProvider,
+                },
+            };
+        }
         if (att.type === "image" && att.data) {
             return {
                 id,
@@ -635,7 +689,7 @@ function buildStoredAttachments(attachments, runId) {
                 name: att.name,
                 contentType: att.contentType,
                 status: { type: "complete" },
-                content: [{ type: "image", image: att.data }],
+                content: [{ type: "image", image: capBase64DataUrl(att.data) }],
             };
         }
         if (att.data) {
@@ -648,7 +702,7 @@ function buildStoredAttachments(attachments, runId) {
                 content: [
                     {
                         type: "file",
-                        data: att.data,
+                        data: capBase64DataUrl(att.data),
                         mimeType: att.contentType,
                         filename: att.name,
                     },
@@ -726,6 +780,7 @@ function toolContentPartForCodeAgentTranscriptItem(item) {
         ...(item.result !== undefined
             ? { result: previewCodeAgentTranscriptValue(item.result) ?? "" }
             : {}),
+        ...(item.structuredMeta ? { structuredMeta: item.structuredMeta } : {}),
     };
 }
 function statusTextForCodeAgentTranscriptItem(item, options) {