@agent-native/core 0.92.11 → 0.92.12

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";
@@ -102,12 +103,16 @@ const BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS = 150_000;
  * (`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 +1404,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 +1715,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 +1748,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 +1797,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