@agent-native/core 0.92.11 → 0.93.0

package/dist/client/RunStuckBanner.d.ts

@@ -29,6 +29,19 @@ export interface RunStuckBannerProps {
      * itself only handles aborting the prior run.
      */
     onRetry?: (runId: string) => void;
+    /**
+     * Returns true when the run has a tool call or sub-agent (A2A) call that
+     * hasn't returned a result yet — typically backed by
+     * `chatHandle.hasInFlightWork()`. "No progress" for a stretch of time does
+     * not mean the run is dead: a long provider query or a cross-app `call
+     * agent` can legitimately emit nothing for minutes. When this returns
+     * true, Retry (which aborts the run) is hidden — aborting would destroy
+     * real in-flight work and re-execute the same long call from scratch.
+     * Only Cancel, an explicit destructive choice, remains available. Checked
+     * fresh on every render; omit to keep the unconditional Retry/Cancel
+     * behavior.
+     */
+    hasInFlightWork?: () => boolean;
     /**
      * Called whenever the stuck state transitions. Useful for surfacing
      * observability events (Sentry, PostHog) at the call site.
@@ -49,5 +62,5 @@ export interface RunStuckBannerProps {
     /** Extra class on the outer container. */
     className?: string;
 }
-export declare function RunStuckBanner({ threadId, enabled, apiUrl, stuckThresholdMs, onRetry, onStuckStateChange, autoRetry, autoRetryOwnerId, className, }: RunStuckBannerProps): import("react").JSX.Element | null;
+export declare function RunStuckBanner({ threadId, enabled, apiUrl, stuckThresholdMs, onRetry, onStuckStateChange, autoRetry, autoRetryOwnerId, hasInFlightWork, className, }: RunStuckBannerProps): import("react").JSX.Element | null;
 //# sourceMappingURL=RunStuckBanner.d.ts.map

package/dist/client/RunStuckBanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RunStuckBanner.d.ts","sourceRoot":"","sources":["../../src/client/RunStuckBanner.tsx"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAGtC;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2FD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,OAAc,EACd,MAAM,EACN,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,SAAiB,EACjB,gBAAgB,EAChB,SAAS,GACV,EAAE,mBAAmB,sCAqNrB"}
+{"version":3,"file":"RunStuckBanner.d.ts","sourceRoot":"","sources":["../../src/client/RunStuckBanner.tsx"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAGtC;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC;IAChC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2FD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,OAAc,EACd,MAAM,EACN,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,SAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,SAAS,GACV,EAAE,mBAAmB,sCAwPrB"}

package/dist/client/RunStuckBanner.js

@@ -61,7 +61,7 @@ async function claimAutoRetryAttempt(threadId, runId, ownerId) {
     }
     return markAutoRetryClaim(key, ownerId);
 }
-export function RunStuckBanner({ threadId, enabled = true, apiUrl, stuckThresholdMs, onRetry, onStuckStateChange, autoRetry = false, autoRetryOwnerId, className, }) {
+export function RunStuckBanner({ threadId, enabled = true, apiUrl, stuckThresholdMs, onRetry, onStuckStateChange, autoRetry = false, autoRetryOwnerId, hasInFlightWork, className, }) {
     const state = useRunStuckDetection({
         threadId,
         enabled,
@@ -77,6 +77,22 @@ export function RunStuckBanner({ threadId, enabled = true, apiUrl, stuckThreshol
     }
     const ownerId = autoRetryOwnerId ?? generatedOwnerIdRef.current;
     const backgroundWorkerStillAlive = isFreshBackgroundWorker(state);
+    // A live tool call or sub-agent (A2A) call means "no progress" is not the
+    // same as "dead" — the process is genuinely still doing the user's work.
+    // Retry aborts the run, so it must not be offered as the (implicitly
+    // safe-looking) primary action while real work is in flight; see the
+    // `hasInFlightWork` prop doc comment. Re-checked on every render (the
+    // underlying source mutates in place as tool/agent-call events stream in),
+    // which is why this is a function prop rather than a plain boolean.
+    //
+    // Two sources, combined disjunctively (either knowing = in flight): the
+    // SERVER-authoritative `state.hasInFlightWork` from /runs/active (the
+    // `in_flight_since` marker, correct even when the client's message list is
+    // stale after a reconnect/reader-mode replay) and the client-side proxy
+    // prop (unresolved tool-call parts in the local messages). Destroying live
+    // work is the failure we guard against, so we err toward "in flight" if
+    // either signal says so.
+    const inFlightWork = state.hasInFlightWork === true || (hasInFlightWork?.() ?? false);
     // Server-continued runs are recovered by the SERVER (chained continuation
     // chunks + lost-handoff sweep); an automatic client abort would kill a live
     // server-chained run. Auto-retry is therefore disabled unconditionally for
@@ -126,6 +142,9 @@ export function RunStuckBanner({ threadId, enabled = true, apiUrl, stuckThreshol
             // comment on isServerContinuedDispatch above).
             isServerContinuedDispatch ||
             backgroundWorkerStillAlive ||
+            // A live tool/A2A call in flight — never auto-abort real work (see
+            // `inFlightWork` comment above).
+            inFlightWork ||
             !state.isStuck ||
             !state.runId ||
             busy.type !== "none" ||
@@ -158,6 +177,7 @@ export function RunStuckBanner({ threadId, enabled = true, apiUrl, stuckThreshol
         autoRetry,
         backgroundWorkerStillAlive,
         busy,
+        inFlightWork,
         isServerContinuedDispatch,
         onRetry,
         ownerId,
@@ -181,7 +201,10 @@ export function RunStuckBanner({ threadId, enabled = true, apiUrl, stuckThreshol
         await abortRun(runId, "user_stuck_cancel");
     };
     const handleRetry = async () => {
-        if (!state.runId || busy.type !== "none")
+        // Defense in depth: the button is hidden while `inFlightWork` is true
+        // (see render below), but guard the handler itself too so an abort can
+        // never be triggered against live work through this path.
+        if (!state.runId || busy.type !== "none" || inFlightWork)
             return;
         const runId = state.runId;
         setBusy({ type: "retry", runId });
@@ -196,12 +219,17 @@ export function RunStuckBanner({ threadId, enabled = true, apiUrl, stuckThreshol
     };
     const busyType = busy.type;
     const stuckSeconds = state.stuckSinceMs != null ? Math.floor(state.stuckSinceMs / 1000) : null;
-    return (_jsxs("div", { role: "status", "aria-live": "polite", className: cn("mx-3 mt-2 flex items-start gap-2.5 rounded-md border border-amber-500/40 bg-amber-500/10 px-3 py-2.5 text-xs text-foreground", className), children: [_jsx(IconAlertTriangle, { size: 16, className: "mt-0.5 shrink-0 text-amber-500", "aria-hidden": "true" }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1.5", children: [_jsxs("div", { className: "leading-snug", children: [_jsx("span", { className: "font-medium", children: backgroundWorkerStillAlive
+    const stillWorking = backgroundWorkerStillAlive || inFlightWork;
+    return (_jsxs("div", { role: "status", "aria-live": "polite", className: cn("mx-3 mt-2 flex items-start gap-2.5 rounded-md border border-amber-500/40 bg-amber-500/10 px-3 py-2.5 text-xs text-foreground", className), children: [_jsx(IconAlertTriangle, { size: 16, className: "mt-0.5 shrink-0 text-amber-500", "aria-hidden": "true" }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1.5", children: [_jsxs("div", { className: "leading-snug", children: [_jsx("span", { className: "font-medium", children: stillWorking
                                     ? "The agent is still working."
-                                    : "This chat looks stuck." }), " ", _jsxs("span", { className: "text-muted-foreground", children: ["No progress", stuckSeconds != null ? ` for ${stuckSeconds}s` : "", ".", " ", backgroundWorkerStillAlive
-                                        ? "The background worker is still alive; large updates can take a few minutes."
-                                        : "The agent may have hit a server timeout or lost its connection.", autoRetry && busyType === "retry"
+                                    : "This chat looks stuck." }), " ", _jsxs("span", { className: "text-muted-foreground", children: ["No progress", stuckSeconds != null ? ` for ${stuckSeconds}s` : "", ".", " ", inFlightWork
+                                        ? "It's waiting on a call to another app or a long tool — canceling will stop that work."
+                                        : backgroundWorkerStillAlive
+                                            ? "The background worker is still alive; large updates can take a few minutes."
+                                            : "The agent may have hit a server timeout or lost its connection.", autoRetry && busyType === "retry"
                                         ? " Retrying automatically now."
-                                        : ""] })] }), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsxs("button", { type: "button", onClick: handleRetry, disabled: busyType !== "none", className: "inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md bg-foreground px-2.5 text-[11px] font-medium text-background transition-colors hover:bg-foreground/90 disabled:cursor-not-allowed disabled:opacity-60", children: [busyType === "retry" ? (_jsx(IconLoader2, { size: 12, className: "animate-spin", "aria-hidden": "true" })) : null, "Retry"] }), _jsxs("button", { type: "button", onClick: handleCancel, disabled: busyType !== "none", className: "inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md border border-border bg-background px-2.5 text-[11px] font-medium text-foreground transition-colors hover:bg-accent disabled:cursor-not-allowed disabled:opacity-60", children: [busyType === "cancel" ? (_jsx(IconLoader2, { size: 12, className: "animate-spin", "aria-hidden": "true" })) : null, "Cancel"] })] })] })] }));
+                                        : ""] })] }), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [inFlightWork ? null : (_jsxs("button", { type: "button", onClick: handleRetry, disabled: busyType !== "none", className: "inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md bg-foreground px-2.5 text-[11px] font-medium text-background transition-colors hover:bg-foreground/90 disabled:cursor-not-allowed disabled:opacity-60", children: [busyType === "retry" ? (_jsx(IconLoader2, { size: 12, className: "animate-spin", "aria-hidden": "true" })) : null, "Retry"] })), _jsxs("button", { type: "button", onClick: handleCancel, disabled: busyType !== "none", title: inFlightWork
+                                    ? "Stop the in-progress run. Work that hasn't finished will be lost."
+                                    : undefined, className: "inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md border border-border bg-background px-2.5 text-[11px] font-medium text-foreground transition-colors hover:bg-accent disabled:cursor-not-allowed disabled:opacity-60", children: [busyType === "cancel" ? (_jsx(IconLoader2, { size: 12, className: "animate-spin", "aria-hidden": "true" })) : null, "Cancel"] })] })] })] }));
 }
 //# sourceMappingURL=RunStuckBanner.js.map

package/dist/client/RunStuckBanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"RunStuckBanner.js","sourceRoot":"","sources":["../../src/client/RunStuckBanner.tsx"],"names":[],"mappings":"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","sourcesContent":["import { IconAlertTriangle, IconLoader2 } from \"@tabler/icons-react\";\nimport { useEffect, useRef, useState } from \"react\";\n\nimport { trackEvent } from \"./analytics.js\";\nimport {\n  useRunStuckDetection,\n  useAbortRun,\n  type RunStuckState,\n} from \"./use-run-stuck-detection.js\";\nimport { cn } from \"./utils.js\";\n\n/**\n * Surface a user-visible affordance when a chat run hasn't emitted any\n * events for an unusually long time. The adapter's silent reconnect logic\n * keeps trying in the background; this banner is the fallback when those\n * attempts haven't restored progress and the user is staring at a frozen\n * spinner.\n */\nexport interface RunStuckBannerProps {\n  /** The thread to monitor. Pass null/undefined to disable. */\n  threadId: string | null | undefined;\n  /**\n   * Set false to skip polling entirely — used when this banner is mounted\n   * for a background tab kept alive via display:none. Only the active tab\n   * should poll `/runs/active`. Defaults to true.\n   */\n  enabled?: boolean;\n  /** API base path. Default `/_agent-native/agent-chat`. */\n  apiUrl?: string;\n  /**\n   * Threshold above which an in-flight run is considered stuck.\n   * Defaults to 90s (after the adapter's 75s no-progress reconnect\n   * has had a chance to recover).\n   */\n  stuckThresholdMs?: number;\n  /**\n   * Called when the user clicks Retry. Implementations should re-prompt\n   * the agent (typically via `chatHandle.sendMessage(...)`) — the banner\n   * itself only handles aborting the prior run.\n   */\n  onRetry?: (runId: string) => void;\n  /**\n   * Called whenever the stuck state transitions. Useful for surfacing\n   * observability events (Sentry, PostHog) at the call site.\n   */\n  onStuckStateChange?: (state: RunStuckState) => void;\n  /**\n   * Automatically abort and retry once when the server reports a run is\n   * alive but has stopped making real progress. Manual controls remain visible\n   * as the fallback if the automatic recovery cannot clear the run.\n   */\n  autoRetry?: boolean;\n  /**\n   * Stable browser-tab/window id used to coordinate automatic retries across\n   * multiple mounted chat views for the same thread. A local id is generated\n   * when omitted.\n   */\n  autoRetryOwnerId?: string;\n  /** Extra class on the outer container. */\n  className?: string;\n}\n\nconst AUTO_RETRY_CLAIM_TTL_MS = 5 * 60 * 1000;\nconst BACKGROUND_WORKER_FRESH_HEARTBEAT_MS = 30_000;\n\ntype BusyState = { type: \"none\" } | { type: \"cancel\" | \"retry\"; runId: string };\n\ntype MaybeLockManager = {\n  request<T>(\n    name: string,\n    options: { mode?: \"exclusive\" | \"shared\"; ifAvailable?: boolean },\n    callback: (lock: unknown) => T | Promise<T>,\n  ): Promise<T>;\n};\n\nfunction createAutoRetryOwnerId() {\n  const cryptoApi =\n    typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\"\n      ? crypto\n      : null;\n  return cryptoApi?.randomUUID() ?? `owner-${Math.random().toString(36)}`;\n}\n\nfunction autoRetryClaimKey(threadId: string, runId: string) {\n  return `agent-native:stuck-auto-retry:${threadId}:${runId}`;\n}\n\nfunction isFreshBackgroundWorker(state: RunStuckState): boolean {\n  return Boolean(\n    state.status === \"running\" &&\n    state.dispatchMode === \"background-processing\" &&\n    state.heartbeatSinceMs != null &&\n    state.heartbeatSinceMs >= 0 &&\n    state.heartbeatSinceMs < BACKGROUND_WORKER_FRESH_HEARTBEAT_MS,\n  );\n}\n\nfunction markAutoRetryClaim(key: string, ownerId: string) {\n  if (typeof window === \"undefined\") return true;\n  const now = Date.now();\n  try {\n    const raw = window.localStorage.getItem(key);\n    if (raw) {\n      const existing = JSON.parse(raw) as {\n        ownerId?: unknown;\n        expiresAt?: unknown;\n      };\n      const expiresAt =\n        typeof existing.expiresAt === \"number\" ? existing.expiresAt : 0;\n      if (expiresAt > now && existing.ownerId !== ownerId) return false;\n    }\n    window.localStorage.setItem(\n      key,\n      JSON.stringify({ ownerId, expiresAt: now + AUTO_RETRY_CLAIM_TTL_MS }),\n    );\n    const confirmed = JSON.parse(window.localStorage.getItem(key) ?? \"{}\") as {\n      ownerId?: unknown;\n    };\n    return confirmed.ownerId === ownerId;\n  } catch {\n    // Private browsing or disabled storage: fall back to in-tab retry. The\n    // server abort is idempotent, and manual controls remain available.\n    return true;\n  }\n}\n\nasync function claimAutoRetryAttempt(\n  threadId: string | null | undefined,\n  runId: string,\n  ownerId: string,\n) {\n  if (!threadId) return true;\n  const key = autoRetryClaimKey(threadId, runId);\n  const locks =\n    typeof navigator !== \"undefined\"\n      ? (navigator as Navigator & { locks?: MaybeLockManager }).locks\n      : undefined;\n  if (locks?.request) {\n    try {\n      return await locks.request(\n        key,\n        { mode: \"exclusive\", ifAvailable: true },\n        (lock) => (lock ? markAutoRetryClaim(key, ownerId) : false),\n      );\n    } catch {\n      return markAutoRetryClaim(key, ownerId);\n    }\n  }\n  return markAutoRetryClaim(key, ownerId);\n}\n\nexport function RunStuckBanner({\n  threadId,\n  enabled = true,\n  apiUrl,\n  stuckThresholdMs,\n  onRetry,\n  onStuckStateChange,\n  autoRetry = false,\n  autoRetryOwnerId,\n  className,\n}: RunStuckBannerProps) {\n  const state = useRunStuckDetection({\n    threadId,\n    enabled,\n    stuckThresholdMs,\n    apiUrl,\n  });\n  const abortRun = useAbortRun(apiUrl);\n  const [busy, setBusy] = useState<BusyState>({ type: \"none\" });\n  const autoRetriedRunIdsRef = useRef<Set<string>>(new Set());\n  const generatedOwnerIdRef = useRef<string | null>(null);\n  if (!generatedOwnerIdRef.current) {\n    generatedOwnerIdRef.current = createAutoRetryOwnerId();\n  }\n  const ownerId = autoRetryOwnerId ?? generatedOwnerIdRef.current;\n  const backgroundWorkerStillAlive = isFreshBackgroundWorker(state);\n  // Server-continued runs are recovered by the SERVER (chained continuation\n  // chunks + lost-handoff sweep); an automatic client abort would kill a live\n  // server-chained run. Auto-retry is therefore disabled unconditionally for\n  // these modes — not just a fresh-heartbeat worker — and the\n  // localStorage/Web-Locks auto-retry claim below is never taken for them (the\n  // adapter's follow loop is read-only, so multiple tabs need no retry dedup).\n  // Only the manual banner remains, on the wider server-owned threshold from\n  // useRunStuckDetection.\n  const isServerContinuedDispatch =\n    state.dispatchMode === \"foreground-self-chain\" ||\n    state.dispatchMode?.startsWith(\"background\") === true;\n\n  const lastReportedRef = useRef<{\n    isStuck: boolean;\n    runId: string | null;\n  }>({ isStuck: false, runId: null });\n  useEffect(() => {\n    const last = lastReportedRef.current;\n    if (last.isStuck === state.isStuck && last.runId === state.runId) return;\n    lastReportedRef.current = { isStuck: state.isStuck, runId: state.runId };\n    onStuckStateChange?.(state);\n    if (state.isStuck && state.runId) {\n      trackEvent(\"agent_chat_stuck_detected\", {\n        runId: state.runId,\n        threadId: threadId ?? null,\n        stuckSinceMs: state.stuckSinceMs ?? null,\n        stuckSinceSec:\n          state.stuckSinceMs != null\n            ? Math.floor(state.stuckSinceMs / 1000)\n            : null,\n        runStatus: state.status,\n      });\n    }\n  }, [state, onStuckStateChange, threadId]);\n\n  // Reset the busy spinner once the underlying run is no longer the one we\n  // acted on. A recovery continuation can start quickly enough that polling\n  // never observes an idle state between run ids.\n  useEffect(() => {\n    setBusy((current) => {\n      if (current.type === \"none\") return current;\n      if (state.status !== \"running\") return { type: \"none\" };\n      if (state.runId && state.runId !== current.runId) return { type: \"none\" };\n      return current;\n    });\n  }, [state.runId, state.status]);\n\n  useEffect(() => {\n    if (\n      !autoRetry ||\n      // Server owns recovery for these dispatch modes — never auto-abort (see\n      // comment on isServerContinuedDispatch above).\n      isServerContinuedDispatch ||\n      backgroundWorkerStillAlive ||\n      !state.isStuck ||\n      !state.runId ||\n      busy.type !== \"none\" ||\n      autoRetriedRunIdsRef.current.has(state.runId)\n    ) {\n      return;\n    }\n\n    const runId = state.runId;\n    void claimAutoRetryAttempt(threadId, runId, ownerId).then((claimed) => {\n      autoRetriedRunIdsRef.current.add(runId);\n      if (!claimed) return;\n      setBusy({ type: \"retry\", runId });\n      trackEvent(\"agent_chat_stuck_auto_retry\", {\n        runId,\n        threadId: threadId ?? null,\n        stuckSinceMs: state.stuckSinceMs ?? null,\n      });\n      void abortRun(runId, \"auto_stuck_retry\").then((aborted) => {\n        if (aborted) {\n          onRetry?.(aborted);\n          return;\n        }\n        setBusy((current) =>\n          current.type !== \"none\" && current.runId === runId\n            ? { type: \"none\" }\n            : current,\n        );\n      });\n    });\n  }, [\n    abortRun,\n    autoRetry,\n    backgroundWorkerStillAlive,\n    busy,\n    isServerContinuedDispatch,\n    onRetry,\n    ownerId,\n    state.isStuck,\n    state.runId,\n    state.stuckSinceMs,\n    threadId,\n  ]);\n\n  if (!state.isStuck || !state.runId) return null;\n\n  const handleCancel = async () => {\n    if (!state.runId || busy.type !== \"none\") return;\n    const runId = state.runId;\n    setBusy({ type: \"cancel\", runId });\n    trackEvent(\"agent_chat_stuck_cancel\", {\n      runId,\n      threadId: threadId ?? null,\n      stuckSinceMs: state.stuckSinceMs ?? null,\n    });\n    await abortRun(runId, \"user_stuck_cancel\");\n  };\n\n  const handleRetry = async () => {\n    if (!state.runId || busy.type !== \"none\") return;\n    const runId = state.runId;\n    setBusy({ type: \"retry\", runId });\n    trackEvent(\"agent_chat_stuck_retry\", {\n      runId,\n      threadId: threadId ?? null,\n      stuckSinceMs: state.stuckSinceMs ?? null,\n    });\n    const aborted = await abortRun(runId, \"user_stuck_retry\");\n    if (aborted) onRetry?.(aborted);\n  };\n\n  const busyType = busy.type;\n\n  const stuckSeconds =\n    state.stuckSinceMs != null ? Math.floor(state.stuckSinceMs / 1000) : null;\n\n  return (\n    <div\n      role=\"status\"\n      aria-live=\"polite\"\n      className={cn(\n        \"mx-3 mt-2 flex items-start gap-2.5 rounded-md border border-amber-500/40 bg-amber-500/10 px-3 py-2.5 text-xs text-foreground\",\n        className,\n      )}\n    >\n      <IconAlertTriangle\n        size={16}\n        className=\"mt-0.5 shrink-0 text-amber-500\"\n        aria-hidden=\"true\"\n      />\n      <div className=\"flex min-w-0 flex-1 flex-col gap-1.5\">\n        <div className=\"leading-snug\">\n          <span className=\"font-medium\">\n            {backgroundWorkerStillAlive\n              ? \"The agent is still working.\"\n              : \"This chat looks stuck.\"}\n          </span>{\" \"}\n          <span className=\"text-muted-foreground\">\n            No progress\n            {stuckSeconds != null ? ` for ${stuckSeconds}s` : \"\"}.{\" \"}\n            {backgroundWorkerStillAlive\n              ? \"The background worker is still alive; large updates can take a few minutes.\"\n              : \"The agent may have hit a server timeout or lost its connection.\"}\n            {autoRetry && busyType === \"retry\"\n              ? \" Retrying automatically now.\"\n              : \"\"}\n          </span>\n        </div>\n        <div className=\"flex flex-wrap items-center gap-2\">\n          <button\n            type=\"button\"\n            onClick={handleRetry}\n            disabled={busyType !== \"none\"}\n            className=\"inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md bg-foreground px-2.5 text-[11px] font-medium text-background transition-colors hover:bg-foreground/90 disabled:cursor-not-allowed disabled:opacity-60\"\n          >\n            {busyType === \"retry\" ? (\n              <IconLoader2\n                size={12}\n                className=\"animate-spin\"\n                aria-hidden=\"true\"\n              />\n            ) : null}\n            Retry\n          </button>\n          <button\n            type=\"button\"\n            onClick={handleCancel}\n            disabled={busyType !== \"none\"}\n            className=\"inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md border border-border bg-background px-2.5 text-[11px] font-medium text-foreground transition-colors hover:bg-accent disabled:cursor-not-allowed disabled:opacity-60\"\n          >\n            {busyType === \"cancel\" ? (\n              <IconLoader2\n                size={12}\n                className=\"animate-spin\"\n                aria-hidden=\"true\"\n              />\n            ) : null}\n            Cancel\n          </button>\n        </div>\n      </div>\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"RunStuckBanner.js","sourceRoot":"","sources":["../../src/client/RunStuckBanner.tsx"],"names":[],"mappings":"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","sourcesContent":["import { IconAlertTriangle, IconLoader2 } from \"@tabler/icons-react\";\nimport { useEffect, useRef, useState } from \"react\";\n\nimport { trackEvent } from \"./analytics.js\";\nimport {\n  useRunStuckDetection,\n  useAbortRun,\n  type RunStuckState,\n} from \"./use-run-stuck-detection.js\";\nimport { cn } from \"./utils.js\";\n\n/**\n * Surface a user-visible affordance when a chat run hasn't emitted any\n * events for an unusually long time. The adapter's silent reconnect logic\n * keeps trying in the background; this banner is the fallback when those\n * attempts haven't restored progress and the user is staring at a frozen\n * spinner.\n */\nexport interface RunStuckBannerProps {\n  /** The thread to monitor. Pass null/undefined to disable. */\n  threadId: string | null | undefined;\n  /**\n   * Set false to skip polling entirely — used when this banner is mounted\n   * for a background tab kept alive via display:none. Only the active tab\n   * should poll `/runs/active`. Defaults to true.\n   */\n  enabled?: boolean;\n  /** API base path. Default `/_agent-native/agent-chat`. */\n  apiUrl?: string;\n  /**\n   * Threshold above which an in-flight run is considered stuck.\n   * Defaults to 90s (after the adapter's 75s no-progress reconnect\n   * has had a chance to recover).\n   */\n  stuckThresholdMs?: number;\n  /**\n   * Called when the user clicks Retry. Implementations should re-prompt\n   * the agent (typically via `chatHandle.sendMessage(...)`) — the banner\n   * itself only handles aborting the prior run.\n   */\n  onRetry?: (runId: string) => void;\n  /**\n   * Returns true when the run has a tool call or sub-agent (A2A) call that\n   * hasn't returned a result yet — typically backed by\n   * `chatHandle.hasInFlightWork()`. \"No progress\" for a stretch of time does\n   * not mean the run is dead: a long provider query or a cross-app `call\n   * agent` can legitimately emit nothing for minutes. When this returns\n   * true, Retry (which aborts the run) is hidden — aborting would destroy\n   * real in-flight work and re-execute the same long call from scratch.\n   * Only Cancel, an explicit destructive choice, remains available. Checked\n   * fresh on every render; omit to keep the unconditional Retry/Cancel\n   * behavior.\n   */\n  hasInFlightWork?: () => boolean;\n  /**\n   * Called whenever the stuck state transitions. Useful for surfacing\n   * observability events (Sentry, PostHog) at the call site.\n   */\n  onStuckStateChange?: (state: RunStuckState) => void;\n  /**\n   * Automatically abort and retry once when the server reports a run is\n   * alive but has stopped making real progress. Manual controls remain visible\n   * as the fallback if the automatic recovery cannot clear the run.\n   */\n  autoRetry?: boolean;\n  /**\n   * Stable browser-tab/window id used to coordinate automatic retries across\n   * multiple mounted chat views for the same thread. A local id is generated\n   * when omitted.\n   */\n  autoRetryOwnerId?: string;\n  /** Extra class on the outer container. */\n  className?: string;\n}\n\nconst AUTO_RETRY_CLAIM_TTL_MS = 5 * 60 * 1000;\nconst BACKGROUND_WORKER_FRESH_HEARTBEAT_MS = 30_000;\n\ntype BusyState = { type: \"none\" } | { type: \"cancel\" | \"retry\"; runId: string };\n\ntype MaybeLockManager = {\n  request<T>(\n    name: string,\n    options: { mode?: \"exclusive\" | \"shared\"; ifAvailable?: boolean },\n    callback: (lock: unknown) => T | Promise<T>,\n  ): Promise<T>;\n};\n\nfunction createAutoRetryOwnerId() {\n  const cryptoApi =\n    typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\"\n      ? crypto\n      : null;\n  return cryptoApi?.randomUUID() ?? `owner-${Math.random().toString(36)}`;\n}\n\nfunction autoRetryClaimKey(threadId: string, runId: string) {\n  return `agent-native:stuck-auto-retry:${threadId}:${runId}`;\n}\n\nfunction isFreshBackgroundWorker(state: RunStuckState): boolean {\n  return Boolean(\n    state.status === \"running\" &&\n    state.dispatchMode === \"background-processing\" &&\n    state.heartbeatSinceMs != null &&\n    state.heartbeatSinceMs >= 0 &&\n    state.heartbeatSinceMs < BACKGROUND_WORKER_FRESH_HEARTBEAT_MS,\n  );\n}\n\nfunction markAutoRetryClaim(key: string, ownerId: string) {\n  if (typeof window === \"undefined\") return true;\n  const now = Date.now();\n  try {\n    const raw = window.localStorage.getItem(key);\n    if (raw) {\n      const existing = JSON.parse(raw) as {\n        ownerId?: unknown;\n        expiresAt?: unknown;\n      };\n      const expiresAt =\n        typeof existing.expiresAt === \"number\" ? existing.expiresAt : 0;\n      if (expiresAt > now && existing.ownerId !== ownerId) return false;\n    }\n    window.localStorage.setItem(\n      key,\n      JSON.stringify({ ownerId, expiresAt: now + AUTO_RETRY_CLAIM_TTL_MS }),\n    );\n    const confirmed = JSON.parse(window.localStorage.getItem(key) ?? \"{}\") as {\n      ownerId?: unknown;\n    };\n    return confirmed.ownerId === ownerId;\n  } catch {\n    // Private browsing or disabled storage: fall back to in-tab retry. The\n    // server abort is idempotent, and manual controls remain available.\n    return true;\n  }\n}\n\nasync function claimAutoRetryAttempt(\n  threadId: string | null | undefined,\n  runId: string,\n  ownerId: string,\n) {\n  if (!threadId) return true;\n  const key = autoRetryClaimKey(threadId, runId);\n  const locks =\n    typeof navigator !== \"undefined\"\n      ? (navigator as Navigator & { locks?: MaybeLockManager }).locks\n      : undefined;\n  if (locks?.request) {\n    try {\n      return await locks.request(\n        key,\n        { mode: \"exclusive\", ifAvailable: true },\n        (lock) => (lock ? markAutoRetryClaim(key, ownerId) : false),\n      );\n    } catch {\n      return markAutoRetryClaim(key, ownerId);\n    }\n  }\n  return markAutoRetryClaim(key, ownerId);\n}\n\nexport function RunStuckBanner({\n  threadId,\n  enabled = true,\n  apiUrl,\n  stuckThresholdMs,\n  onRetry,\n  onStuckStateChange,\n  autoRetry = false,\n  autoRetryOwnerId,\n  hasInFlightWork,\n  className,\n}: RunStuckBannerProps) {\n  const state = useRunStuckDetection({\n    threadId,\n    enabled,\n    stuckThresholdMs,\n    apiUrl,\n  });\n  const abortRun = useAbortRun(apiUrl);\n  const [busy, setBusy] = useState<BusyState>({ type: \"none\" });\n  const autoRetriedRunIdsRef = useRef<Set<string>>(new Set());\n  const generatedOwnerIdRef = useRef<string | null>(null);\n  if (!generatedOwnerIdRef.current) {\n    generatedOwnerIdRef.current = createAutoRetryOwnerId();\n  }\n  const ownerId = autoRetryOwnerId ?? generatedOwnerIdRef.current;\n  const backgroundWorkerStillAlive = isFreshBackgroundWorker(state);\n  // A live tool call or sub-agent (A2A) call means \"no progress\" is not the\n  // same as \"dead\" — the process is genuinely still doing the user's work.\n  // Retry aborts the run, so it must not be offered as the (implicitly\n  // safe-looking) primary action while real work is in flight; see the\n  // `hasInFlightWork` prop doc comment. Re-checked on every render (the\n  // underlying source mutates in place as tool/agent-call events stream in),\n  // which is why this is a function prop rather than a plain boolean.\n  //\n  // Two sources, combined disjunctively (either knowing = in flight): the\n  // SERVER-authoritative `state.hasInFlightWork` from /runs/active (the\n  // `in_flight_since` marker, correct even when the client's message list is\n  // stale after a reconnect/reader-mode replay) and the client-side proxy\n  // prop (unresolved tool-call parts in the local messages). Destroying live\n  // work is the failure we guard against, so we err toward \"in flight\" if\n  // either signal says so.\n  const inFlightWork =\n    state.hasInFlightWork === true || (hasInFlightWork?.() ?? false);\n  // Server-continued runs are recovered by the SERVER (chained continuation\n  // chunks + lost-handoff sweep); an automatic client abort would kill a live\n  // server-chained run. Auto-retry is therefore disabled unconditionally for\n  // these modes — not just a fresh-heartbeat worker — and the\n  // localStorage/Web-Locks auto-retry claim below is never taken for them (the\n  // adapter's follow loop is read-only, so multiple tabs need no retry dedup).\n  // Only the manual banner remains, on the wider server-owned threshold from\n  // useRunStuckDetection.\n  const isServerContinuedDispatch =\n    state.dispatchMode === \"foreground-self-chain\" ||\n    state.dispatchMode?.startsWith(\"background\") === true;\n\n  const lastReportedRef = useRef<{\n    isStuck: boolean;\n    runId: string | null;\n  }>({ isStuck: false, runId: null });\n  useEffect(() => {\n    const last = lastReportedRef.current;\n    if (last.isStuck === state.isStuck && last.runId === state.runId) return;\n    lastReportedRef.current = { isStuck: state.isStuck, runId: state.runId };\n    onStuckStateChange?.(state);\n    if (state.isStuck && state.runId) {\n      trackEvent(\"agent_chat_stuck_detected\", {\n        runId: state.runId,\n        threadId: threadId ?? null,\n        stuckSinceMs: state.stuckSinceMs ?? null,\n        stuckSinceSec:\n          state.stuckSinceMs != null\n            ? Math.floor(state.stuckSinceMs / 1000)\n            : null,\n        runStatus: state.status,\n      });\n    }\n  }, [state, onStuckStateChange, threadId]);\n\n  // Reset the busy spinner once the underlying run is no longer the one we\n  // acted on. A recovery continuation can start quickly enough that polling\n  // never observes an idle state between run ids.\n  useEffect(() => {\n    setBusy((current) => {\n      if (current.type === \"none\") return current;\n      if (state.status !== \"running\") return { type: \"none\" };\n      if (state.runId && state.runId !== current.runId) return { type: \"none\" };\n      return current;\n    });\n  }, [state.runId, state.status]);\n\n  useEffect(() => {\n    if (\n      !autoRetry ||\n      // Server owns recovery for these dispatch modes — never auto-abort (see\n      // comment on isServerContinuedDispatch above).\n      isServerContinuedDispatch ||\n      backgroundWorkerStillAlive ||\n      // A live tool/A2A call in flight — never auto-abort real work (see\n      // `inFlightWork` comment above).\n      inFlightWork ||\n      !state.isStuck ||\n      !state.runId ||\n      busy.type !== \"none\" ||\n      autoRetriedRunIdsRef.current.has(state.runId)\n    ) {\n      return;\n    }\n\n    const runId = state.runId;\n    void claimAutoRetryAttempt(threadId, runId, ownerId).then((claimed) => {\n      autoRetriedRunIdsRef.current.add(runId);\n      if (!claimed) return;\n      setBusy({ type: \"retry\", runId });\n      trackEvent(\"agent_chat_stuck_auto_retry\", {\n        runId,\n        threadId: threadId ?? null,\n        stuckSinceMs: state.stuckSinceMs ?? null,\n      });\n      void abortRun(runId, \"auto_stuck_retry\").then((aborted) => {\n        if (aborted) {\n          onRetry?.(aborted);\n          return;\n        }\n        setBusy((current) =>\n          current.type !== \"none\" && current.runId === runId\n            ? { type: \"none\" }\n            : current,\n        );\n      });\n    });\n  }, [\n    abortRun,\n    autoRetry,\n    backgroundWorkerStillAlive,\n    busy,\n    inFlightWork,\n    isServerContinuedDispatch,\n    onRetry,\n    ownerId,\n    state.isStuck,\n    state.runId,\n    state.stuckSinceMs,\n    threadId,\n  ]);\n\n  if (!state.isStuck || !state.runId) return null;\n\n  const handleCancel = async () => {\n    if (!state.runId || busy.type !== \"none\") return;\n    const runId = state.runId;\n    setBusy({ type: \"cancel\", runId });\n    trackEvent(\"agent_chat_stuck_cancel\", {\n      runId,\n      threadId: threadId ?? null,\n      stuckSinceMs: state.stuckSinceMs ?? null,\n    });\n    await abortRun(runId, \"user_stuck_cancel\");\n  };\n\n  const handleRetry = async () => {\n    // Defense in depth: the button is hidden while `inFlightWork` is true\n    // (see render below), but guard the handler itself too so an abort can\n    // never be triggered against live work through this path.\n    if (!state.runId || busy.type !== \"none\" || inFlightWork) return;\n    const runId = state.runId;\n    setBusy({ type: \"retry\", runId });\n    trackEvent(\"agent_chat_stuck_retry\", {\n      runId,\n      threadId: threadId ?? null,\n      stuckSinceMs: state.stuckSinceMs ?? null,\n    });\n    const aborted = await abortRun(runId, \"user_stuck_retry\");\n    if (aborted) onRetry?.(aborted);\n  };\n\n  const busyType = busy.type;\n\n  const stuckSeconds =\n    state.stuckSinceMs != null ? Math.floor(state.stuckSinceMs / 1000) : null;\n\n  const stillWorking = backgroundWorkerStillAlive || inFlightWork;\n\n  return (\n    <div\n      role=\"status\"\n      aria-live=\"polite\"\n      className={cn(\n        \"mx-3 mt-2 flex items-start gap-2.5 rounded-md border border-amber-500/40 bg-amber-500/10 px-3 py-2.5 text-xs text-foreground\",\n        className,\n      )}\n    >\n      <IconAlertTriangle\n        size={16}\n        className=\"mt-0.5 shrink-0 text-amber-500\"\n        aria-hidden=\"true\"\n      />\n      <div className=\"flex min-w-0 flex-1 flex-col gap-1.5\">\n        <div className=\"leading-snug\">\n          <span className=\"font-medium\">\n            {stillWorking\n              ? \"The agent is still working.\"\n              : \"This chat looks stuck.\"}\n          </span>{\" \"}\n          <span className=\"text-muted-foreground\">\n            No progress\n            {stuckSeconds != null ? ` for ${stuckSeconds}s` : \"\"}.{\" \"}\n            {inFlightWork\n              ? \"It's waiting on a call to another app or a long tool — canceling will stop that work.\"\n              : backgroundWorkerStillAlive\n                ? \"The background worker is still alive; large updates can take a few minutes.\"\n                : \"The agent may have hit a server timeout or lost its connection.\"}\n            {autoRetry && busyType === \"retry\"\n              ? \" Retrying automatically now.\"\n              : \"\"}\n          </span>\n        </div>\n        <div className=\"flex flex-wrap items-center gap-2\">\n          {inFlightWork ? null : (\n            <button\n              type=\"button\"\n              onClick={handleRetry}\n              disabled={busyType !== \"none\"}\n              className=\"inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md bg-foreground px-2.5 text-[11px] font-medium text-background transition-colors hover:bg-foreground/90 disabled:cursor-not-allowed disabled:opacity-60\"\n            >\n              {busyType === \"retry\" ? (\n                <IconLoader2\n                  size={12}\n                  className=\"animate-spin\"\n                  aria-hidden=\"true\"\n                />\n              ) : null}\n              Retry\n            </button>\n          )}\n          <button\n            type=\"button\"\n            onClick={handleCancel}\n            disabled={busyType !== \"none\"}\n            title={\n              inFlightWork\n                ? \"Stop the in-progress run. Work that hasn't finished will be lost.\"\n                : undefined\n            }\n            className=\"inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md border border-border bg-background px-2.5 text-[11px] font-medium text-foreground transition-colors hover:bg-accent disabled:cursor-not-allowed disabled:opacity-60\"\n          >\n            {busyType === \"cancel\" ? (\n              <IconLoader2\n                size={12}\n                className=\"animate-spin\"\n                aria-hidden=\"true\"\n              />\n            ) : null}\n            Cancel\n          </button>\n        </div>\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/client/agent-chat-adapter.d.ts

@@ -9,7 +9,10 @@ export type AgentChatSurfaceKind =
  */
 "app"
 /** Chat rendered by the outer local dev frame, outside the app iframe. */
- | "dev-frame";
+ | "dev-frame"
+/** Chat hosted by Desktop for a local app with explicit code access. */
+ | "desktop";
+export declare const BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS = 150000;
 /**
  * The composer's exec mode is sent as explicit request metadata. The server
  * owns the plan-mode prompt and read-only tool filtering so the chat history

package/dist/client/agent-chat-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-chat-adapter.d.ts","sourceRoot":"","sources":["../../src/client/agent-chat-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAC;AAOhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAmBrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,oBAAoB;AAC9B;;;;GAIG;AACD,KAAK;AACP,0EAA0E;GACxE,WAAW,CAAC;AA6uChB;;;;GAIG;AACH;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;KAAE,CAAC;IACrD,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAyED,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,6BAA6B,GACtC,gBAAgB,CA8+DlB"}
+{"version":3,"file":"agent-chat-adapter.d.ts","sourceRoot":"","sources":["../../src/client/agent-chat-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAC;AAWhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAmBrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,oBAAoB;AAC9B;;;;GAIG;AACD,KAAK;AACP,0EAA0E;GACxE,WAAW;AACb,wEAAwE;GACtE,SAAS,CAAC;AAwId,eAAO,MAAM,iCAAiC,SAAU,CAAC;AA6nCzD;;;;GAIG;AACH;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;KAAE,CAAC;IACrD,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAyED,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,6BAA6B,GACtC,gBAAgB,CA6iElB"}

package/dist/client/agent-chat-adapter.js

@@ -1,4 +1,5 @@
 import { actionPreparationContinuationNote } from "../agent/action-continuation-guidance.js";
+import { LLM_MISSING_CREDENTIALS_ERROR_CODE, LLM_MISSING_CREDENTIALS_MESSAGE, } from "../agent/engine/credential-errors.js";
 import { setActiveRun, updateActiveRunSeq, clearActiveRun, } from "./active-run-state.js";
 import { captureError } from "./analytics.js";
 import { agentNativePath } from "./api-path.js";
@@ -96,18 +97,42 @@ const BACKGROUND_FOLLOW_POLL_INTERVAL_MS = 1_000;
 // the 25s grace plus sweep/DB latency. This stays below the background
 // reconnect stuck threshold, but gives the server-owned recovery brain time to
 // surface the successor or terminal errored run before the client reports idle.
-const BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS = 150_000;
+//
+// THREE-SITE INVARIANT (keep in lockstep with run-store.ts and
+// agent-chat-plugin.ts — see `UNCLAIMED_BACKGROUND_RUN_FAST_SWEEP_MS`'s doc
+// comment in run-store.ts for the full derivation): a `chainServerDrivenContinuation`
+// deferral (server/production-agent.ts) leaves a successor row `running` with
+// no live worker until a sweep redispatches it. The budget is a derived
+// chain, each bound comfortably inside the next:
+//   UNCLAIMED_BACKGROUND_RUN_GRACE_MS            (25s)
+// + UNCLAIMED_BACKGROUND_RUN_FAST_SWEEP_MS       (20s)
+// = ~45-65s worst-case time-to-first-redispatch-attempt
+// < BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS            (150s, this constant)
+// < UNCLAIMED_BACKGROUND_RUN_REDISPATCH_BOUND_MS (300s, run-store.ts)
+// On top of that margin, the follow loop below never counts a tick against
+// this timeout at all while `/runs/active` reports `awaitingRedispatch:
+// true` — a server-authoritative "known deferred, recovery in progress"
+// signal, not a guess — so this timeout is a backstop for a genuinely lost
+// run, not the primary mechanism racing the sweep. Do NOT raise this value to
+// paper over a slow sweep; fix the sweep timing (run-store.ts /
+// agent-chat-plugin.ts) instead, and keep this comment's inequality chain
+// accurate if any of the four numbers change.
+export const BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS = 150_000;
 /**
  * User-facing copy for the server's background terminal reasons
  * (`agent_runs.terminal_reason`, surfaced by /runs/active). These runs died in
  * server-side handoff machinery where no richer error event may exist, so the
  * client owns the message. Keys are matched after stripping an optional
- * `error:` prefix (`terminalReasonForEvent` records `error:<code>`).
+ * `error:` prefix (`terminalReasonForEvent` records `error:<code>`). Keep this
+ * map scoped to terminal failures, including reasons that must override a
+ * mistakenly completed row.
  */
 const BACKGROUND_TERMINAL_REASON_MESSAGES = {
     background_worker_never_started: "The agent run was handed off to a background worker that never started. It was recovered so you can try again.",
     background_continuation_dispatch_failed: "The agent's background worker could not hand off the next step of this run. Retry to continue from the preserved context.",
     dispatch_payload_missing: "The agent's background run lost its saved request data and could not continue. Retry to start a fresh run.",
+    missing_api_key: LLM_MISSING_CREDENTIALS_MESSAGE,
+    missing_credentials: LLM_MISSING_CREDENTIALS_MESSAGE,
     turn_continuation_budget_exhausted: "This request needed more automatic continuations than allowed and was stopped. Try breaking it into smaller steps.",
 };
 function normalizeMentions(text) {
@@ -1399,6 +1424,11 @@ export function createAgentChatAdapter(options) {
                 }
             };
             const reconnectCursorForRun = (nextRunId, previousRunId) => {
+                if (previousRunId !== nextRunId) {
+                    lastAutoContinueReason = null;
+                    lastRecoverableRunError = null;
+                    lastActivityTrail = [];
+                }
                 const rememberedSeq = seenRunSeqs.get(nextRunId);
                 if (rememberedSeq !== undefined) {
                     lastSeq = rememberedSeq;
@@ -1705,6 +1735,9 @@ export function createAgentChatAdapter(options) {
                         ...(runId ? { runId } : {}),
                     };
                     if (typeof window !== "undefined") {
+                        if (args.errorCode === LLM_MISSING_CREDENTIALS_ERROR_CODE) {
+                            dispatchMissingApiKey();
+                        }
                         window.dispatchEvent(new CustomEvent("agent-chat:run-error", {
                             detail: { ...runError, tabId },
                         }));
@@ -1735,7 +1768,41 @@ export function createAgentChatAdapter(options) {
                         : "";
                     // terminal_reason is either a bare reason ("dispatch_payload_missing")
                     // or "error:<errorCode>" when derived from a terminal error event.
+                    const hasErrorTerminalReason = rawTerminalReason.startsWith("error:");
                     const terminalReason = rawTerminalReason.replace(/^error:/, "");
+                    const mappedMessage = terminalReason
+                        ? BACKGROUND_TERMINAL_REASON_MESSAGES[terminalReason]
+                        : undefined;
+                    const mappedErrorCode = terminalReason === "missing_api_key" ||
+                        terminalReason === LLM_MISSING_CREDENTIALS_ERROR_CODE
+                        ? LLM_MISSING_CREDENTIALS_ERROR_CODE
+                        : terminalReason;
+                    if (mappedMessage) {
+                        yield* emitBackgroundTerminalError({
+                            message: mappedMessage,
+                            errorCode: mappedErrorCode,
+                            details: `terminal_reason: ${rawTerminalReason}`,
+                        });
+                        return;
+                    }
+                    if (hasErrorTerminalReason) {
+                        if (lastRecoverableRunError) {
+                            yield* emitBackgroundTerminalError({
+                                message: lastRecoverableRunError.message,
+                                errorCode: lastRecoverableRunError.errorCode ||
+                                    mappedErrorCode ||
+                                    "background_run_failed",
+                                details: lastRecoverableRunError.details,
+                            });
+                            return;
+                        }
+                        yield* emitBackgroundTerminalError({
+                            message: "The agent's background run failed before its final response could be recovered. You can retry from the preserved chat context.",
+                            errorCode: mappedErrorCode || "background_run_failed",
+                            details: `terminal_reason: ${rawTerminalReason}`,
+                        });
+                        return;
+                    }
                     if (status === "completed") {
                         // The turn finished server-side; the events we managed to fold are
                         // the durable transcript. Finalize with them.
@@ -1750,17 +1817,6 @@ export function createAgentChatAdapter(options) {
                         clearActiveRun();
                         return;
                     }
-                    const mappedMessage = terminalReason
-                        ? BACKGROUND_TERMINAL_REASON_MESSAGES[terminalReason]
-                        : undefined;
-                    if (mappedMessage) {
-                        yield* emitBackgroundTerminalError({
-                            message: mappedMessage,
-                            errorCode: terminalReason,
-                            details: `terminal_reason: ${rawTerminalReason}`,
-                        });
-                        return;
-                    }
                     if (lastRecoverableRunError) {
                         // A replayed terminal error event already carried the real
                         // message (recoverable errors replay as auto-continue signals
@@ -1934,10 +1990,24 @@ export function createAgentChatAdapter(options) {
                             if (isTerminal) {
                                 replayedTerminalRunIds.add(activeRunId);
                             }
-                            if (attach === "detached") {
+                            // Server-authoritative "silently deferred, recovery in
+                            // progress" signal (see `awaitingRedispatch` on
+                            // `getActiveRunForThreadAsync`, run-manager.ts): a
+                            // `chainServerDrivenContinuation` successor still inside
+                            // `UNCLAIMED_BACKGROUND_RUN_REDISPATCH_BOUND_MS`, being
+                            // redispatched by the server's fast/slow sweeps. This is known
+                            // to demonstrably exist — same as a "detached" attach — so
+                            // treat it identically and never accumulate idle time against
+                            // it. Once the server's own bound is exceeded (or the row is
+                            // claimed/terminal) this flips false and normal idle accounting
+                            // resumes, so a truly stuck deferral still fails loud via the
+                            // existing timeout below.
+                            const awaitingRedispatch = active?.awaitingRedispatch === true;
+                            if (attach === "detached" || awaitingRedispatch) {
                                 // We really attached to a live stream (chunk boundary or
-                                // transport blip) — the run demonstrably exists; keep
-                                // following with a fresh idle window.
+                                // transport blip), or the server told us recovery is
+                                // in-flight — the run demonstrably exists; keep following
+                                // with a fresh idle window.
                                 idleSince = null;
                             }
                             else {
@@ -2320,7 +2390,18 @@ export function createAgentChatAdapter(options) {
                                         recoverable: true,
                                         runId: activeRunId,
                                     };
+                                    // This is a terminal outcome for the attempted turn. Settle
+                                    // both real in-flight calls and activity-only placeholders
+                                    // before yielding the error; otherwise a prior "Preparing
+                                    // run-code" event remains an unresolved tool card and the UI
+                                    // keeps showing a spinner beside an already-terminal error.
+                                    settleInterruptedToolCalls(content, undefined, {
+                                        includeActivity: true,
+                                    });
                                     if (typeof window !== "undefined") {
+                                        window.dispatchEvent(new CustomEvent("agent-chat:activity-clear", {
+                                            detail: { tabId },
+                                        }));
                                         window.dispatchEvent(new CustomEvent("agent-chat:run-error", {
                                             detail: { ...runError, tabId },
                                         }));