@agent-native/core 0.84.49 → 0.84.51

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @agent-native/core
 
+## 0.84.51
+
+### Patch Changes
+
+- 55e4678: Recover durable background chat runs when action input preparation stops making byte progress, and avoid duplicate tool cards when reconnects replay completed tool events.
+
+## 0.84.50
+
+### Patch Changes
+
+- 24a6bd2: Retry agent chat startup timeouts before showing an error when no run stream starts.
+
 ## 0.84.49
 
 ### Patch Changes

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.84.49",
+  "version": "0.84.51",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {

package/corpus/core/src/client/agent-chat-adapter.ts

@@ -1380,6 +1380,7 @@ export function createAgentChatAdapter(
       const turnId = generateTurnId();
       let runId: string | null = null;
       let lastSeq = -1;
+      const seenRunSeqs = new Map<string, number>();
       let currentRunDispatchMode: string | null = null;
       let currentMessageText = normalizeMentions(
         recoveryMessageText.trim() || userMessageText,
@@ -1548,6 +1549,27 @@ export function createAgentChatAdapter(
         if (mode) currentRunDispatchMode = mode;
       };
 
+      const rememberRunSeq = (seq: number) => {
+        lastSeq = seq;
+        if (runId) {
+          seenRunSeqs.set(runId, seq);
+        }
+      };
+
+      const reconnectCursorForRun = (
+        nextRunId: string,
+        previousRunId: string | null,
+      ) => {
+        const rememberedSeq = seenRunSeqs.get(nextRunId);
+        if (rememberedSeq !== undefined) {
+          lastSeq = rememberedSeq;
+          return;
+        }
+        if (previousRunId !== nextRunId) {
+          lastSeq = -1;
+        }
+      };
+
       const currentSSEOptions = () => ({
         durableBackgroundRun:
           currentRunDispatchMode?.startsWith("background") === true,
@@ -1671,7 +1693,7 @@ export function createAgentChatAdapter(
                 toolCallCounter,
                 tabId,
                 (seq) => {
-                  lastSeq = seq;
+                  rememberRunSeq(seq);
                   if (threadId) updateActiveRunSeq(seq);
                 },
                 runId,
@@ -1765,12 +1787,13 @@ export function createAgentChatAdapter(
                   return false;
                 }
                 const activeRunId = String(active.runId);
+                const previousRunId = runId;
                 runId = activeRunId;
                 if (!attemptedRunIds.includes(activeRunId)) {
                   attemptedRunIds.push(activeRunId);
                 }
-                lastSeq = -1;
-                setActiveRun({ threadId, runId: activeRunId, lastSeq: -1 });
+                reconnectCursorForRun(activeRunId, previousRunId);
+                setActiveRun({ threadId, runId: activeRunId, lastSeq });
                 const reconnected = yield* reconnectCurrentRun();
                 if (reconnected) return true;
               }
@@ -1844,12 +1867,13 @@ export function createAgentChatAdapter(
                 if (activeStatus !== "running" && activeStatus !== "starting") {
                   return false;
                 }
+                const previousRunId = runId;
                 runId = activeRunId;
                 if (!attemptedRunIds.includes(activeRunId)) {
                   attemptedRunIds.push(activeRunId);
                 }
-                lastSeq = -1;
-                setActiveRun({ threadId, runId: activeRunId, lastSeq: -1 });
+                reconnectCursorForRun(activeRunId, previousRunId);
+                setActiveRun({ threadId, runId: activeRunId, lastSeq });
                 const reconnected = yield* reconnectCurrentRun();
                 if (reconnected) return true;
               } catch (activeErr: unknown) {
@@ -2290,13 +2314,14 @@ export function createAgentChatAdapter(
                 }
                 if (activeRunId) {
                   try {
+                    const previousRunId = runId;
                     runId = activeRunId;
                     if (!attemptedRunIds.includes(runId)) {
                       attemptedRunIds.push(runId);
                     }
-                    lastSeq = -1;
+                    reconnectCursorForRun(activeRunId, previousRunId);
                     if (threadId) {
-                      setActiveRun({ threadId, runId, lastSeq: -1 });
+                      setActiveRun({ threadId, runId, lastSeq });
                     }
                     const reconnected = yield* reconnectCurrentRun();
                     if (reconnected) return;
@@ -2423,7 +2448,7 @@ export function createAgentChatAdapter(
               toolCallCounter,
               tabId,
               (seq) => {
-                lastSeq = seq;
+                rememberRunSeq(seq);
                 if (runId && threadId) {
                   updateActiveRunSeq(seq);
                 }
@@ -2616,10 +2641,16 @@ export function createAgentChatAdapter(
             if (activeReconnected) return;
 
             if (err instanceof AgentStartupTimeoutError) {
+              if (startupRecoveryAttempts < MAX_STARTUP_RECOVERY_ATTEMPTS) {
+                await retryDelay(startupRecoveryAttempts++, abortSignal);
+                if (abortSignal.aborted) return;
+                continue;
+              }
               const message =
-                "The agent chat endpoint accepted the request but did not start streaming in time. This usually means prompt setup, the LLM gateway, or the provider is stalled.";
+                "The agent chat endpoint did not start streaming in time after several recovery attempts. This usually means prompt setup, the LLM gateway, or the provider is stalled.";
               captureChatClientError(err, "startup-timeout", {
                 timeoutMs: err.timeoutMs,
+                startupRecoveryAttempts,
               });
               const runError = {
                 message,

package/corpus/core/src/client/sse-event-processor.ts

@@ -151,9 +151,10 @@ export const SSE_ACTION_PREPARATION_STALL_TIMEOUT_MS = 90_000;
 export interface SSEStreamOptions {
   /**
    * Durable background runs have their own server-side liveness budget and
-   * heartbeat. While one is active, keepalive-only periods and zero-byte
-   * action-preparation activity should keep the client attached instead of
-   * aborting and starting duplicate continuations.
+   * heartbeat. While one is active, generic keepalive-only periods keep the
+   * client attached. Tool-input preparation is stricter: real byte progress
+   * keeps long payloads alive, but zero-byte/silent preparation still recovers
+   * so one stuck action cannot pin the chat forever.
    */
   durableBackgroundRun?: boolean;
 }
@@ -278,6 +279,24 @@ function findPendingToolCallIndex(
   return -1;
 }
 
+function findCompletedToolCallIndex(
+  content: ContentPart[],
+  toolCallId?: string,
+): number {
+  if (!toolCallId) return -1;
+  for (let i = content.length - 1; i >= 0; i--) {
+    const part = content[i];
+    if (
+      part.type === "tool-call" &&
+      part.toolCallId === toolCallId &&
+      part.result !== undefined
+    ) {
+      return i;
+    }
+  }
+  return -1;
+}
+
 function appendActivityTrail(
   trail: ActivityTrailEntry[],
   next: ActivityTrailEntry,
@@ -359,12 +378,7 @@ function updatePreparingActionState(
   return undefined;
 }
 
-function hasStalledPreparingAction(
-  state: PreparingActionState,
-  now: number,
-  options?: SSEStreamOptions,
-) {
-  if (options?.durableBackgroundRun === true) return false;
+function hasStalledPreparingAction(state: PreparingActionState, now: number) {
   // Fire only when a tool input has gone SILENT — no further streaming deltas
   // for the whole window — never merely because a large input has been
   // streaming for a long time. `lastProgressAt` advances on every delta
@@ -787,6 +801,9 @@ export function processEvent(
   if (ev.type === "tool_start") {
     const args = (ev.input ?? {}) as Record<string, string>;
     const tool = ev.tool ?? "unknown";
+    if (findCompletedToolCallIndex(content, ev.id) >= 0) {
+      return { action: "continue" };
+    }
     if (typeof window !== "undefined") {
       window.dispatchEvent(
         new CustomEvent("agent-native:tool-start", {
@@ -868,6 +885,9 @@ export function processEvent(
     // so a tool_done frame with an undefined tool name still matches its
     // pending tool-call entry instead of leaving it forever unresolved.
     const doneTool = ev.tool ?? "unknown";
+    if (findCompletedToolCallIndex(content, ev.id) >= 0) {
+      return { action: "continue" };
+    }
     if (typeof window !== "undefined") {
       window.dispatchEvent(
         new CustomEvent("agent-native:tool-done", {
@@ -1340,9 +1360,7 @@ export async function* readSSEStream(
         );
 
         if (result) yield withStreamMetadata(result);
-        if (
-          hasStalledPreparingAction(preparingActionState, Date.now(), options)
-        ) {
+        if (hasStalledPreparingAction(preparingActionState, Date.now())) {
           throw new AgentAutoContinueSignal({
             reason: "no_progress",
             activityTrail: [...activityTrail],
@@ -1525,9 +1543,7 @@ export async function readSSEStreamRaw(
               : { reason: "stream_ended", activityTrail: [...activityTrail] },
           );
         }
-        if (
-          hasStalledPreparingAction(preparingActionState, Date.now(), options)
-        ) {
+        if (hasStalledPreparingAction(preparingActionState, Date.now())) {
           onUpdate(contentSnapshot(content));
           throw new AgentAutoContinueSignal({
             reason: "no_progress",

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;AAkBrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,oBAAoB;AAC9B;;;;GAIG;AACD,KAAK;AACP,0EAA0E;GACxE,WAAW,CAAC;AA+pChB;;;;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;AAED,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,6BAA6B,GACtC,gBAAgB,CAihDlB"}
+{"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;AAkBrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,oBAAoB;AAC9B;;;;GAIG;AACD,KAAK;AACP,0EAA0E;GACxE,WAAW,CAAC;AA+pChB;;;;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;AAED,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,6BAA6B,GACtC,gBAAgB,CAgjDlB"}

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

@@ -1055,6 +1055,7 @@ export function createAgentChatAdapter(options) {
             const turnId = generateTurnId();
             let runId = null;
             let lastSeq = -1;
+            const seenRunSeqs = new Map();
             let currentRunDispatchMode = null;
             let currentMessageText = normalizeMentions(recoveryMessageText.trim() || userMessageText);
             let currentHistory = history;
@@ -1208,6 +1209,22 @@ export function createAgentChatAdapter(options) {
                 if (mode)
                     currentRunDispatchMode = mode;
             };
+            const rememberRunSeq = (seq) => {
+                lastSeq = seq;
+                if (runId) {
+                    seenRunSeqs.set(runId, seq);
+                }
+            };
+            const reconnectCursorForRun = (nextRunId, previousRunId) => {
+                const rememberedSeq = seenRunSeqs.get(nextRunId);
+                if (rememberedSeq !== undefined) {
+                    lastSeq = rememberedSeq;
+                    return;
+                }
+                if (previousRunId !== nextRunId) {
+                    lastSeq = -1;
+                }
+            };
             const currentSSEOptions = () => ({
                 durableBackgroundRun: currentRunDispatchMode?.startsWith("background") === true,
             });
@@ -1305,7 +1322,7 @@ export function createAgentChatAdapter(options) {
                             }
                             updateCurrentRunDispatchMode(reconnectRes.headers.get("X-Dispatch-Mode"));
                             for await (const result of readSSEStream(reconnectRes.body, content, toolCallCounter, tabId, (seq) => {
-                                lastSeq = seq;
+                                rememberRunSeq(seq);
                                 if (threadId)
                                     updateActiveRunSeq(seq);
                             }, runId, currentSSEOptions())) {
@@ -1380,12 +1397,13 @@ export function createAgentChatAdapter(options) {
                                     return false;
                                 }
                                 const activeRunId = String(active.runId);
+                                const previousRunId = runId;
                                 runId = activeRunId;
                                 if (!attemptedRunIds.includes(activeRunId)) {
                                     attemptedRunIds.push(activeRunId);
                                 }
-                                lastSeq = -1;
-                                setActiveRun({ threadId, runId: activeRunId, lastSeq: -1 });
+                                reconnectCursorForRun(activeRunId, previousRunId);
+                                setActiveRun({ threadId, runId: activeRunId, lastSeq });
                                 const reconnected = yield* reconnectCurrentRun();
                                 if (reconnected)
                                     return true;
@@ -1449,12 +1467,13 @@ export function createAgentChatAdapter(options) {
                             if (activeStatus !== "running" && activeStatus !== "starting") {
                                 return false;
                             }
+                            const previousRunId = runId;
                             runId = activeRunId;
                             if (!attemptedRunIds.includes(activeRunId)) {
                                 attemptedRunIds.push(activeRunId);
                             }
-                            lastSeq = -1;
-                            setActiveRun({ threadId, runId: activeRunId, lastSeq: -1 });
+                            reconnectCursorForRun(activeRunId, previousRunId);
+                            setActiveRun({ threadId, runId: activeRunId, lastSeq });
                             const reconnected = yield* reconnectCurrentRun();
                             if (reconnected)
                                 return true;
@@ -1834,13 +1853,14 @@ export function createAgentChatAdapter(options) {
                                 }
                                 if (activeRunId) {
                                     try {
+                                        const previousRunId = runId;
                                         runId = activeRunId;
                                         if (!attemptedRunIds.includes(runId)) {
                                             attemptedRunIds.push(runId);
                                         }
-                                        lastSeq = -1;
+                                        reconnectCursorForRun(activeRunId, previousRunId);
                                         if (threadId) {
-                                            setActiveRun({ threadId, runId, lastSeq: -1 });
+                                            setActiveRun({ threadId, runId, lastSeq });
                                         }
                                         const reconnected = yield* reconnectCurrentRun();
                                         if (reconnected)
@@ -1959,7 +1979,7 @@ export function createAgentChatAdapter(options) {
                             setActiveRun({ threadId, runId, lastSeq: -1 });
                         }
                         for await (const result of readSSEStream(res.body, content, toolCallCounter, tabId, (seq) => {
-                            lastSeq = seq;
+                            rememberRunSeq(seq);
                             if (runId && threadId) {
                                 updateActiveRunSeq(seq);
                             }
@@ -2132,9 +2152,16 @@ export function createAgentChatAdapter(options) {
                         if (activeReconnected)
                             return;
                         if (err instanceof AgentStartupTimeoutError) {
-                            const message = "The agent chat endpoint accepted the request but did not start streaming in time. This usually means prompt setup, the LLM gateway, or the provider is stalled.";
+                            if (startupRecoveryAttempts < MAX_STARTUP_RECOVERY_ATTEMPTS) {
+                                await retryDelay(startupRecoveryAttempts++, abortSignal);
+                                if (abortSignal.aborted)
+                                    return;
+                                continue;
+                            }
+                            const message = "The agent chat endpoint did not start streaming in time after several recovery attempts. This usually means prompt setup, the LLM gateway, or the provider is stalled.";
                             captureChatClientError(err, "startup-timeout", {
                                 timeoutMs: err.timeoutMs,
+                                startupRecoveryAttempts,
                             });
                             const runError = {
                                 message,