@agent-native/core 0.164.4 → 0.164.12

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

@@ -1429,6 +1429,16 @@ function isMissingCredentialMessage(message) {
         msg.includes("no llm provider") ||
         msg.includes("llm provider is connected"));
 }
+function isMissingProviderErrorMessage(message, errorCode) {
+    const text = message.toLowerCase();
+    const code = (errorCode ?? "").toLowerCase();
+    return (text.includes("no llm provider") ||
+        text.includes("missing credentials") ||
+        text.includes("missing api key") ||
+        text.includes("missing_api_key") ||
+        ((code === "missing_credentials" || code === "missing_api_key") &&
+            text.includes("llm provider")));
+}
 function missingCredentialFailure(message) {
     try {
         const parsed = JSON.parse(message);
@@ -1439,9 +1449,10 @@ function missingCredentialFailure(message) {
                 : message;
         const errorCode = typeof parsed.errorCode === "string"
             ? parsed.errorCode
-            : "missing_credentials";
+            : isMissingCredentialMessage(raw)
+                ? "missing_credentials"
+                : "authentication_error";
         return {
-            text: formatChatErrorText(raw, typeof parsed.upgradeUrl === "string" ? parsed.upgradeUrl : undefined, errorCode),
             runError: {
                 message: normalizeChatError(raw).message,
                 errorCode,
@@ -1450,10 +1461,11 @@ function missingCredentialFailure(message) {
     }
     catch {
         return {
-            text: formatChatErrorText(message, undefined, "missing_credentials"),
             runError: {
                 message: normalizeChatError(message).message,
-                errorCode: "missing_credentials",
+                errorCode: isMissingCredentialMessage(message)
+                    ? "missing_credentials"
+                    : "authentication_error",
             },
         };
     }
@@ -1707,6 +1719,16 @@ export function createAgentChatAdapter(options) {
                         activeRun.threadId === threadId &&
                         activeRun.runId === runId));
             };
+            const clearOwnedActiveRun = () => {
+                if (!ownsActiveRunState())
+                    return;
+                if (threadId && runId) {
+                    clearActiveRunIfMatches(threadId, runId);
+                }
+                else {
+                    clearActiveRun();
+                }
+            };
             // The adapter's own stream outranks AssistantChat's reconnect fallback:
             // when it attaches to a run, any reconnect reader folding the same run
             // must stop writing UI state or both folds render at once.
@@ -1716,6 +1738,18 @@ export function createAgentChatAdapter(options) {
                     preemptRunStream(threadId, runId, streamOwnershipToken);
                 }
             };
+            let terminalChatUiStopped = false;
+            const publishTerminalChatUiStopped = () => {
+                if (terminalChatUiStopped)
+                    return;
+                terminalChatUiStopped = true;
+                if (typeof window === "undefined")
+                    return;
+                dispatchTerminalChatUiCleanup(tabId);
+                window.dispatchEvent(new CustomEvent("agentNative.chatRunning", {
+                    detail: { isRunning: false, tabId },
+                }));
+            };
             const settleTerminalChatRun = () => {
                 if (threadId && runId) {
                     releaseRunStream(threadId, runId, streamOwnershipToken);
@@ -1728,12 +1762,7 @@ export function createAgentChatAdapter(options) {
                 else {
                     clearActiveRun();
                 }
-                if (typeof window === "undefined")
-                    return;
-                dispatchTerminalChatUiCleanup(tabId);
-                window.dispatchEvent(new CustomEvent("agentNative.chatRunning", {
-                    detail: { isRunning: false, tabId },
-                }));
+                publishTerminalChatUiStopped();
             };
             const seenRunSeqs = new Map();
             const preparingActionStatesByRun = new Map();
@@ -2062,7 +2091,7 @@ export function createAgentChatAdapter(options) {
                             const reconnectRes = await fetch(`${apiUrl}/runs/${encodeURIComponent(runId)}/events?after=${lastSeq + 1}`, { signal: abortSignal });
                             if (!reconnectRes.ok || !reconnectRes.body) {
                                 if (reconnectRes.status === 404) {
-                                    clearActiveRun();
+                                    clearOwnedActiveRun();
                                     return false;
                                 }
                                 lastReconnectError = new Error(`Reconnect failed: ${reconnectRes.status}`);
@@ -2091,14 +2120,14 @@ export function createAgentChatAdapter(options) {
                                 yield nextResult;
                             }
                             if (ownsActiveRunState()) {
-                                clearActiveRun();
+                                clearOwnedActiveRun();
                             }
                             return true;
                         }
                         catch (reconnectErr) {
                             if (reconnectErr instanceof Error &&
                                 reconnectErr.name === "AbortError") {
-                                clearActiveRun();
+                                clearOwnedActiveRun();
                                 return true;
                             }
                             if (reconnectErr instanceof AgentAutoContinueSignal) {
@@ -2162,7 +2191,7 @@ export function createAgentChatAdapter(options) {
                         catch (activeErr) {
                             if (activeErr instanceof Error &&
                                 activeErr.name === "AbortError") {
-                                clearActiveRun();
+                                clearOwnedActiveRun();
                                 return true;
                             }
                             lastActiveRunError = activeErr;
@@ -2235,7 +2264,7 @@ export function createAgentChatAdapter(options) {
                         catch (activeErr) {
                             if (activeErr instanceof Error &&
                                 activeErr.name === "AbortError") {
-                                clearActiveRun();
+                                clearOwnedActiveRun();
                                 return true;
                             }
                             lastActiveRunError = activeErr;
@@ -2273,17 +2302,19 @@ export function createAgentChatAdapter(options) {
                     settleInterruptedToolCalls(content, undefined, {
                         includeActivity: true,
                     });
-                    content.push({
-                        type: "text",
-                        text: formatChatErrorText(args.message, undefined, args.errorCode),
-                    });
+                    if (!isMissingProviderErrorMessage(args.message, args.errorCode)) {
+                        content.push({
+                            type: "text",
+                            text: formatChatErrorText(args.message, undefined, args.errorCode),
+                        });
+                    }
                     settleTerminalChatRun();
                     yield {
                         content: [...content],
                         status: { type: "incomplete", reason: "error" },
                         metadata: { custom: { ...(runId ? { runId } : {}), runError } },
                     };
-                    clearActiveRun();
+                    clearOwnedActiveRun();
                 };
                 // Final outcome for a background turn the follow loop can no longer
                 // follow: either the run went terminal server-side (surface its
@@ -2313,7 +2344,7 @@ export function createAgentChatAdapter(options) {
                                 },
                             },
                         };
-                        clearActiveRun();
+                        clearOwnedActiveRun();
                         return;
                     }
                     // terminal_reason is either a bare reason ("dispatch_payload_missing")
@@ -2385,7 +2416,7 @@ export function createAgentChatAdapter(options) {
                                 },
                             },
                         };
-                        clearActiveRun();
+                        clearOwnedActiveRun();
                         return;
                     }
                     if (lastRecoverableRunError) {
@@ -2466,17 +2497,17 @@ export function createAgentChatAdapter(options) {
                             }
                             settleTerminalChatRun();
                             yield missingFinalResponseResult;
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return "completed";
                         }
                         // readSSEStream returned normally: a terminal done/error was
                         // consumed and rendered — the turn is over.
-                        clearActiveRun();
+                        clearOwnedActiveRun();
                         return "completed";
                     }
                     catch (attachErr) {
                         if (attachErr instanceof Error && attachErr.name === "AbortError") {
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return "aborted";
                         }
                         if (attachErr instanceof AgentAutoContinueSignal) {
@@ -2624,7 +2655,7 @@ export function createAgentChatAdapter(options) {
                     const replayedTerminalRunIds = new Set();
                     while (true) {
                         if (abortSignal.aborted) {
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return "completed";
                         }
                         if (Date.now() - followStartedAt >=
@@ -2663,7 +2694,7 @@ export function createAgentChatAdapter(options) {
                         }
                         catch (pollErr) {
                             if (pollErr instanceof Error && pollErr.name === "AbortError") {
-                                clearActiveRun();
+                                clearOwnedActiveRun();
                                 return "completed";
                             }
                             activeUnreadable = true;
@@ -2672,7 +2703,7 @@ export function createAgentChatAdapter(options) {
                             // Unreadable: learn nothing, decide nothing, wait and re-ask.
                             await delay(BACKGROUND_FOLLOW_POLL_INTERVAL_MS, abortSignal);
                             if (abortSignal.aborted) {
-                                clearActiveRun();
+                                clearOwnedActiveRun();
                                 return "completed";
                             }
                             continue;
@@ -2747,7 +2778,7 @@ export function createAgentChatAdapter(options) {
                                 if (isBackgroundTerminalErrorOutcome(active)) {
                                     const graceOutcome = await awaitBackgroundErrorRecoverySuccessor(activeRunId);
                                     if (graceOutcome === "aborted") {
-                                        clearActiveRun();
+                                        clearOwnedActiveRun();
                                         return "completed";
                                     }
                                     if (graceOutcome === "successor") {
@@ -2866,7 +2897,7 @@ export function createAgentChatAdapter(options) {
                                 catch (refetchErr) {
                                     if (refetchErr instanceof Error &&
                                         refetchErr.name === "AbortError") {
-                                        clearActiveRun();
+                                        clearOwnedActiveRun();
                                         return "completed";
                                     }
                                     secondOpinionUnreadable = true;
@@ -2966,7 +2997,7 @@ export function createAgentChatAdapter(options) {
                         const nextPollDelayMs = Math.min(backedOffPollDelayMs, idleRemainingMs);
                         await delay(nextPollDelayMs, abortSignal);
                         if (abortSignal.aborted) {
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return "completed";
                         }
                     }
@@ -3098,7 +3129,7 @@ export function createAgentChatAdapter(options) {
                     includeReferences = Boolean(runConfig?.custom?.references);
                     internalContinuationRequest = true;
                     startupRecoveryAttempts = 0;
-                    clearActiveRun();
+                    clearOwnedActiveRun();
                     if (!isTransient) {
                         return {
                             ok: true,
@@ -3334,7 +3365,6 @@ export function createAgentChatAdapter(options) {
                                             detail: { ...failure.runError, tabId },
                                         }));
                                     }
-                                    content.push({ type: "text", text: failure.text });
                                     settleTerminalChatRun();
                                     yield {
                                         content: [...content],
@@ -3417,17 +3447,17 @@ export function createAgentChatAdapter(options) {
                             }
                             settleTerminalChatRun();
                             yield missingFinalResponseResult;
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return;
                         }
                         // Run completed normally — clear active run state
-                        clearActiveRun();
+                        clearOwnedActiveRun();
                         return;
                     }
                     catch (err) {
                         if (err instanceof Error && err.name === "AbortError") {
                             // User-initiated abort (Stop button) — clear active run
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return;
                         }
                         if (err instanceof AgentAutoContinueSignal) {
@@ -3487,7 +3517,7 @@ export function createAgentChatAdapter(options) {
                                             },
                                         },
                                     };
-                                    clearActiveRun();
+                                    clearOwnedActiveRun();
                                     return;
                                 }
                                 const preservedError = err.errorInfo ?? lastRecoverableRunError ?? null;
@@ -3541,7 +3571,7 @@ export function createAgentChatAdapter(options) {
                                         custom: { ...(runId ? { runId } : {}), runError },
                                     },
                                 };
-                                clearActiveRun();
+                                clearOwnedActiveRun();
                                 return;
                             }
                             if (continuation.resetVisibleContent) {
@@ -3612,7 +3642,7 @@ export function createAgentChatAdapter(options) {
                                     custom: { ...(runId ? { runId } : {}), runError },
                                 },
                             };
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return;
                         }
                         const errMsg = err instanceof Error ? err.message : "Something went wrong.";
@@ -3636,7 +3666,7 @@ export function createAgentChatAdapter(options) {
                                     reason: "error",
                                 },
                             };
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return;
                         }
                         if (isMissingCredentialMessage(errMsg)) {
@@ -3647,7 +3677,6 @@ export function createAgentChatAdapter(options) {
                                     detail: { ...failure.runError, tabId },
                                 }));
                             }
-                            content.push({ type: "text", text: failure.text });
                             settleTerminalChatRun();
                             yield {
                                 content: [...content],
@@ -3657,7 +3686,7 @@ export function createAgentChatAdapter(options) {
                                 },
                                 metadata: { custom: { runError: failure.runError } },
                             };
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return;
                         }
                         // Connection lost — try to reconnect to the run
@@ -3716,7 +3745,7 @@ export function createAgentChatAdapter(options) {
                                 },
                                 metadata: { custom: { ...(runId ? { runId } : {}), runError } },
                             };
-                            clearActiveRun();
+                            clearOwnedActiveRun();
                             return;
                         }
                         // Reconnect failed or not possible — keep going from the partial
@@ -3745,7 +3774,7 @@ export function createAgentChatAdapter(options) {
                                             },
                                         },
                                     };
-                                    clearActiveRun();
+                                    clearOwnedActiveRun();
                                     return;
                                 }
                                 const message = exhaustedRecoveryMessage("stream_ended");
@@ -3780,7 +3809,7 @@ export function createAgentChatAdapter(options) {
                                         custom: { ...(runId ? { runId } : {}), runError },
                                     },
                                 };
-                                clearActiveRun();
+                                clearOwnedActiveRun();
                                 return;
                             }
                             if (continuation.resetVisibleContent) {
@@ -3843,11 +3872,8 @@ export function createAgentChatAdapter(options) {
                 }
             }
             finally {
-                if (typeof window !== "undefined" && ownsActiveRunState()) {
-                    dispatchTerminalChatUiCleanup(tabId);
-                    window.dispatchEvent(new CustomEvent("agentNative.chatRunning", {
-                        detail: { isRunning: false, tabId },
-                    }));
+                if (ownsActiveRunState()) {
+                    publishTerminalChatUiStopped();
                 }
             }
         },

package/dist/client/app-providers.js

@@ -143,14 +143,14 @@ function DocumentTitleGuard({ fallbackTitle }) {
     }, [fallbackTitle]);
     return null;
 }
-function ProvidersInner({ queryClient, defaultTheme = "system", themeAttribute = "class", tooltipDelayDuration, toaster = DEFAULT_TOASTER, disableThemeTransitions = true, i18n, documentTitleFallback, children, }) {
+function ProvidersInner({ queryClient, defaultTheme = "system", themeAttribute = "class", tooltipDelayDuration, toaster = DEFAULT_TOASTER, disableThemeTransitions = true, i18n, documentTitleFallback, showProductionEnvironmentBadge, children, }) {
     const localizedChildren = i18n === false ? (children) : (_jsx(AgentNativeI18nProvider, { ...(i18n ?? {}), children: children }));
-    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsxs(ThemeProvider, { attribute: themeAttribute, defaultTheme: defaultTheme, enableSystem: true, disableTransitionOnChange: disableThemeTransitions, children: [_jsx(EmbeddedThemeSync, {}), _jsxs(TooltipProvider, { delayDuration: tooltipDelayDuration, children: [localizedChildren, _jsx(DocumentTitleGuard, { fallbackTitle: documentTitleFallback }), _jsx(RuntimeConfigNotice, {}), _jsx(RoutedAppEnhancements, {}), toaster] })] }) }));
+    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsxs(ThemeProvider, { attribute: themeAttribute, defaultTheme: defaultTheme, enableSystem: true, disableTransitionOnChange: disableThemeTransitions, children: [_jsx(EmbeddedThemeSync, {}), _jsxs(TooltipProvider, { delayDuration: tooltipDelayDuration, children: [localizedChildren, _jsx(DocumentTitleGuard, { fallbackTitle: documentTitleFallback }), _jsx(RuntimeConfigNotice, {}), _jsx(RoutedAppEnhancements, {}), _jsx(EnvironmentBadge, { showProduction: showProductionEnvironmentBadge }), toaster] })] }) }));
 }
 export function AppProviders({ queryClient, isPublicPath = false, clientOnlyFallback, sessionBypass = false, defaultTheme, themeAttribute, tooltipDelayDuration, toaster, disableThemeTransitions, i18n, documentTitleFallback, children, }) {
     const fallback = clientOnlyFallback ?? _jsx(DefaultSpinner, {});
     if (isPublicPath) {
-        return (_jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, children: children }));
+        return (_jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, showProductionEnvironmentBadge: false, children: children }));
     }
-    return (_jsx(ClientOnly, { fallback: fallback, children: _jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, children: _jsx(RequireSession, { bypass: sessionBypass, fallback: fallback, children: sessionBypass ? (children) : (_jsxs(FirstRunOnboardingStartupGate, { children: [children, _jsx(EnvironmentBadge, {})] })) }) }) }));
+    return (_jsx(ClientOnly, { fallback: fallback, children: _jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, showProductionEnvironmentBadge: !sessionBypass, children: _jsx(RequireSession, { bypass: sessionBypass, fallback: fallback, children: sessionBypass ? (children) : (_jsx(FirstRunOnboardingStartupGate, { children: children })) }) }) }));
 }

package/dist/client/chat/message-components.d.ts

@@ -71,6 +71,10 @@ export declare function MessageActionsMenu({ showRevert, onRevert, threadId, }?:
 export declare function UserMessage(): React.JSX.Element | null;
 export declare function messageTextFromContent(content: unknown): string;
 export declare function isMissingFinalResponseWarningText(text: string): boolean;
+export declare function isMissingCredentialAssistantMessage(message: {
+    content?: unknown;
+    metadata?: unknown;
+}): boolean;
 export declare function latestUserMessageText(messages: readonly unknown[]): string;
 export declare function userMessageTextBeforeAssistant(messages: readonly unknown[], assistantMessageId: string): string;
 export declare function assistantMessageHasUnresolvedTool(content: unknown): boolean;

package/dist/client/chat/message-components.js

@@ -539,6 +539,32 @@ function missingFinalResponseWarningText(content) {
     }
     return null;
 }
+export function isMissingCredentialAssistantMessage(message) {
+    const metadata = message.metadata;
+    const runError = metadata?.custom?.runError ?? metadata?.runError;
+    const errorCode = typeof runError?.errorCode === "string"
+        ? runError.errorCode.toLowerCase()
+        : "";
+    const errorMessage = typeof runError?.message === "string" ? runError.message : "";
+    if (/no llm provider(?: key)? (?:is connected|was found)|missing credentials|missing api key|missing_api_key/i.test(errorMessage) ||
+        ((errorCode === "missing_credentials" || errorCode === "missing_api_key") &&
+            !errorMessage &&
+            !message.content)) {
+        return true;
+    }
+    const text = Array.isArray(message.content)
+        ? message.content
+            .filter((part) => Boolean(part) &&
+            typeof part === "object" &&
+            part.type === "text" &&
+            typeof part.text === "string")
+            .map((part) => part.text)
+            .join("\n")
+        : typeof message.content === "string"
+            ? message.content
+            : "";
+    return /^Error:\s*(?:No LLM provider(?: key)? (?:is connected|was found))/i.test(text.trim());
+}
 export function latestUserMessageText(messages) {
     for (let index = messages.length - 1; index >= 0; index -= 1) {
         const message = messages[index];
@@ -847,6 +873,7 @@ export function AssistantMessage() {
     const activeTurnId = React.useContext(ChatRunningTurnIdContext);
     const lastRunDurationMs = React.useContext(ChatRunDurationContext);
     const msg = messageRuntime.getState();
+    const isMissingCredential = isMissingCredentialAssistantMessage(msg);
     const persistedDurationMs = getAssistantRunDurationMs(msg);
     const timestamp = formatMessageTimestamp(msg.createdAt, locale, t("agentChat.history.yesterday"));
     const isLast = msg.isLast;
@@ -1052,7 +1079,7 @@ export function AssistantMessage() {
         chatRunning,
         isLast,
     });
-    if (!hasRenderableContent)
+    if (!hasRenderableContent || isMissingCredential)
         return null;
     return (_jsxs("div", { className: "group relative", style: { contentVisibility: isComplete ? "auto" : "visible" }, children: [_jsxs("div", { className: "w-full max-w-[95%] text-sm leading-relaxed text-foreground", children: [isComplete && (_jsx(McpConnectionSuggestion, { text: responseConnectionText, contextText: responseConnectionContext, variant: "response" })), _jsx(ToolCallStackMotion, { children: _jsx(MessagePrimitive.GroupedParts, { groupBy: groupAssistantWorkParts, children: ({ part, children }) => {
                                 switch (part.type) {

package/dist/client/chat/run-recovery.js

@@ -112,6 +112,14 @@ function isConnectionRecoveryRunError(info) {
         message.includes("connection kept failing") ||
         message.includes("automatic recovery attempts"));
 }
+function isMissingLlmProviderRunError(info) {
+    const code = (info.errorCode ?? "").toLowerCase();
+    const text = [info.message, info.details].filter(Boolean).join("\n");
+    const hasCredentialSetupText = /no llm provider(?: key)? (?:is connected|was found)|missing credentials|missing api key|missing_api_key|(?:api[_ -]?key|auth[_ -]?token)\s*(?:(?:is|was)\s+)?(?:not\s+(?:set|configured|available|present|provided|found)|missing|unavailable|empty|unset|unconfigured)/i.test(text);
+    return (hasCredentialSetupText ||
+        ((code === "missing_credentials" || code === "missing_api_key") &&
+            !text.trim()));
+}
 // ─── BuilderConnectCta ────────────────────────────────────────────────────────
 // Renders a single row with left-aligned copy and a right-aligned action.
 // Click opens the Builder OAuth popup via the shared
@@ -194,11 +202,15 @@ export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDism
     const [copyState, setCopyState] = useState("idle");
     const [forking, setForking] = useState(false);
     const [forkError, setForkError] = useState(null);
+    const [providerConnected, setProviderConnected] = useState(false);
+    const retryRequestedRef = useRef(false);
+    const [retryRequested, setRetryRequested] = useState(false);
     const builderReconnect = useBuilderConnectFlow({
         trackingSource: "assistant_chat_reconnect_error",
     });
     const canRecover = info.recoverable === true;
     const shouldShowBuilderReconnect = isBuilderReconnectRunError(info);
+    const shouldShowMissingProviderSetup = isMissingLlmProviderRunError(info);
     const isProviderAuthError = isProviderAuthenticationError([info.message, info.details].filter(Boolean).join("\n"), info.errorCode);
     // Blocked on something the reader goes and fixes elsewhere, then comes back
     // to. Without a retry the card is a dead end and its own copy ("then retry")
@@ -241,6 +253,17 @@ export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDism
         onRetry();
         onDismiss();
     }, [onDismiss, onProviderConnected, onRetry]);
+    const handleMissingProviderConnected = useCallback(() => {
+        setProviderConnected(true);
+        onProviderConnected?.();
+    }, [onProviderConnected]);
+    const handleMissingProviderRetry = useCallback(() => {
+        if (retryRequestedRef.current)
+            return;
+        retryRequestedRef.current = true;
+        setRetryRequested(true);
+        onRetry();
+    }, [onRetry]);
     const handleFork = useCallback(async () => {
         if (!onFork || forking)
             return;
@@ -264,6 +287,9 @@ export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDism
             onDismiss();
         }
     }, [builderReconnectResolved, onDismiss]);
+    if (shouldShowMissingProviderSetup) {
+        return (_jsxs("div", { className: "w-full", children: [_jsx(BuilderSetupCard, { fullWidth: true, layout: "sidebar", onConnected: handleMissingProviderConnected }), providerConnected ? (_jsx("div", { className: "flex justify-center px-3 pt-1", children: _jsxs("button", { type: "button", onClick: handleMissingProviderRetry, disabled: retryRequested, className: "inline-flex h-8 items-center gap-1.5 rounded-md bg-foreground px-3 text-xs font-medium text-background hover:opacity-90 disabled:cursor-wait disabled:opacity-60", children: [_jsx(IconRefresh, { size: 13 }), t("agentChat.common.retry")] }) })) : null] }));
+    }
     return (_jsxs("div", { className: "rounded-lg border border-amber-500/25 bg-amber-500/[0.06] p-3 text-sm", children: [_jsxs("div", { className: "flex items-start gap-2", children: [_jsx("span", { className: "mt-0.5 flex h-6 w-6 shrink-0 items-center justify-center rounded-md bg-amber-500/10 text-amber-700 dark:text-amber-300", children: _jsx(IconAlertTriangle, { size: 14 }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "font-medium text-foreground", children: runErrorHeadline(info, {
                                     recoverable: t("agentChat.error.stopped"),
                                     terminal: t("agentChat.error.failed"),

package/dist/client/chat-first/apps-rail.d.ts

@@ -1,2 +1,3 @@
 import type { ChatFirstAppRailProps } from "./types.js";
+export declare const CHAT_FIRST_APP_RAIL_SHOW_ALL_STORAGE_KEY = "agent-native:chat-first-app-rail-show-all:v1";
 export declare const ChatFirstAppsRail: import("react").MemoExoticComponent<({ apps, defaultAppIds, activeAppId, loading, error, collapsed, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy, }: ChatFirstAppRailProps) => import("react").JSX.Element>;

package/dist/client/chat-first/apps-rail.js

@@ -1,10 +1,33 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuTrigger, Skeleton, Tooltip, TooltipContent, TooltipTrigger, } from "@agent-native/toolkit/ui";
 import { IconApps, IconChevronDown, IconChevronUp, IconPin, IconPlus, IconTrash, } from "@tabler/icons-react";
-import { memo, useMemo, useState } from "react";
+import { memo, useEffect, useMemo, useState } from "react";
 import { CHAT_FIRST_DEFAULT_APP_IDS, orderChatFirstAppIds, readChatFirstAppLayout, writeChatFirstAppLayout, } from "../chat-first.js";
 import { cn } from "../utils.js";
 import { defaultChatFirstCopy } from "./copy.js";
+export const CHAT_FIRST_APP_RAIL_SHOW_ALL_STORAGE_KEY = "agent-native:chat-first-app-rail-show-all:v1";
+function readChatFirstAppRailShowAll() {
+    if (typeof window === "undefined")
+        return false;
+    try {
+        return (window.localStorage.getItem(CHAT_FIRST_APP_RAIL_SHOW_ALL_STORAGE_KEY) ===
+            "true");
+    }
+    catch {
+        // coercion-ok: localStorage is optional; false keeps the rail usable in-memory.
+        return false;
+    }
+}
+function writeChatFirstAppRailShowAll(showAllApps) {
+    if (typeof window === "undefined")
+        return;
+    try {
+        window.localStorage.setItem(CHAT_FIRST_APP_RAIL_SHOW_ALL_STORAGE_KEY, String(showAllApps));
+    }
+    catch {
+        // coercion-ok: localStorage is optional; the in-memory toggle remains usable.
+    }
+}
 function ChatFirstRailAppIcon({ app, activeAppId, renderIcon, }) {
     const isActive = activeAppId !== undefined && activeAppId === app.id;
     const isInactive = activeAppId !== undefined && !isActive;
@@ -45,7 +68,10 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, default
     const [localLayout, setLocalLayout] = useState(() => readChatFirstAppLayout());
     const layout = controlledLayout ?? localLayout;
     const [draggedAppId, setDraggedAppId] = useState(null);
-    const [showAllApps, setShowAllApps] = useState(false);
+    const [showAllApps, setShowAllApps] = useState(() => readChatFirstAppRailShowAll());
+    useEffect(() => {
+        writeChatFirstAppRailShowAll(showAllApps);
+    }, [showAllApps]);
     const orderedApps = useMemo(() => {
         const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout, defaultAppIds);
         const appsById = new Map(apps.map((app) => [app.id, app]));

package/dist/client/sse-event-processor.js

@@ -605,6 +605,12 @@ function isMissingCredentialText(message, errorCode) {
         msg.includes("no llm provider") ||
         msg.includes("llm provider is connected"));
 }
+function isMissingProviderErrorText(message, errorCode) {
+    const code = String(errorCode ?? "").toLowerCase();
+    return (code === "missing_api_key" ||
+        code === "missing_credentials" ||
+        /no llm provider(?: key)? (?:is connected|was found)/i.test(message));
+}
 function dispatchActivityClear(tabId) {
     if (typeof window === "undefined")
         return;
@@ -1389,10 +1395,6 @@ export function processEvent(ev, content, toolCallCounter, tabId, state) {
         // the last preparation activity, so do not leave its label mounted.
         dispatchActivityClear(tabId);
         settleInterruptedToolCalls(content, undefined, { includeActivity: true });
-        content.push({
-            type: "text",
-            text: formatChatErrorText(errMsg, undefined, errorCode),
-        });
         return {
             action: "missing_api_key",
             result: {
@@ -1472,6 +1474,7 @@ export function processEvent(ev, content, toolCallCounter, tabId, state) {
             };
         }
         const normalized = normalizeChatError(errMsg, ev.errorCode);
+        const missingProviderError = isMissingProviderErrorText(errMsg, ev.errorCode);
         if (isMissingCredentialText(errMsg, ev.errorCode)) {
             dispatchMissingApiKey(tabId);
         }
@@ -1492,10 +1495,12 @@ export function processEvent(ev, content, toolCallCounter, tabId, state) {
             }));
         }
         settleInterruptedToolCalls(content, undefined, { includeActivity: true });
-        content.push({
-            type: "text",
-            text: formatChatErrorText(errMsg, ev.upgradeUrl, ev.errorCode),
-        });
+        if (!missingProviderError) {
+            content.push({
+                type: "text",
+                text: formatChatErrorText(errMsg, ev.upgradeUrl, ev.errorCode),
+            });
+        }
         return {
             action: "error",
             result: {

package/dist/client/use-active-agent-chat-run.d.ts

@@ -0,0 +1,2 @@
+/** Return the focused run for a thread and keep it current as the stream moves. */
+export declare function useActiveAgentChatRunId(threadId: string | null | undefined): string | null;

package/dist/client/use-active-agent-chat-run.js

@@ -0,0 +1,22 @@
+import { useEffect, useState } from "react";
+import { ACTIVE_RUN_STATE_EVENT, getActiveRun, } from "./active-run-state.js";
+/** Return the focused run for a thread and keep it current as the stream moves. */
+export function useActiveAgentChatRunId(threadId) {
+    const [activeRun, setActiveRun] = useState(() => getActiveRun());
+    useEffect(() => {
+        const syncFromStorage = () => setActiveRun(getActiveRun());
+        const handleActiveRunChange = (event) => {
+            const state = event
+                .detail?.state;
+            setActiveRun(state ?? null);
+        };
+        syncFromStorage();
+        window.addEventListener(ACTIVE_RUN_STATE_EVENT, handleActiveRunChange);
+        window.addEventListener("storage", syncFromStorage);
+        return () => {
+            window.removeEventListener(ACTIVE_RUN_STATE_EVENT, handleActiveRunChange);
+            window.removeEventListener("storage", syncFromStorage);
+        };
+    }, []);
+    return activeRun && activeRun.threadId === threadId ? activeRun.runId : null;
+}