@agent-native/core 0.137.7 → 0.138.0

package/dist/client/AgentPanel.js

@@ -54,7 +54,6 @@ import { useT } from "./i18n.js";
 import { isFirstRunOnboardingEnabled } from "./onboarding/first-run-enabled.js";
 import { useOnboardingPreviewMode } from "./onboarding/use-preview-mode.js";
 import { recoverFromStaleChunkError } from "./route-chunk-recovery.js";
-import { AgentNativeRouteWarmup } from "./route-warmup.js";
 import { withBuilderConnectTrackingParams } from "./settings/useBuilderStatus.js";
 import { useScreenRefreshKey } from "./use-db-sync.js";
 import { useDevMode } from "./use-dev-mode.js";
@@ -396,6 +395,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
     const onboardingPreviewMode = useOnboardingPreviewMode();
     const showFirstRunOnboarding = SHOW_FIRST_RUN_ONBOARDING || onboardingPreviewMode;
     const insideAgentSidebar = React.useContext(AgentSidebarOnboardingContext);
+    const isFirstRunOnboardingSurface = showFirstRunOnboarding && !insideAgentSidebar;
     const feedbackEnabled = resolveFeedbackUrl(undefined, mounted ? undefined : null) !== null;
     const keyPrefix = storageKey ? `:${storageKey}` : "";
     const execModeKey = `${EXEC_MODE_KEY}${keyPrefix}`;
@@ -858,7 +858,13 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
         activateOnKeyDown,
         closeCliTab,
     ]);
-    return (_jsxs("div", { className: cn("agent-panel-root flex flex-1 flex-col min-h-0 h-full text-[13px] leading-[1.2] antialiased", className), style: { ...AGENT_PANEL_ROOT_STYLE, ...style }, "data-agent-fullscreen": isFullscreen ? "true" : undefined, children: [_jsx("style", { dangerouslySetInnerHTML: {
+    return (_jsxs("div", { className: cn("agent-panel-root flex flex-1 flex-col min-h-0 h-full text-[13px] leading-[1.2] antialiased", className), style: {
+            ...AGENT_PANEL_ROOT_STYLE,
+            ...style,
+            // The chat view-transition container otherwise traps fixed onboarding
+            // chrome below the app's own header instead of the viewport edge.
+            ...(isFirstRunOnboardingSurface ? { contain: "none" } : {}),
+        }, "data-agent-fullscreen": isFullscreen ? "true" : undefined, children: [_jsx("style", { dangerouslySetInnerHTML: {
                     __html: "@media (hover:hover) and (pointer:fine){" +
                         ".agent-sidebar-chat-header[data-agent-sidebar-chat-header]{opacity:0;pointer-events:none;transition:opacity 150ms ease-out;}" +
                         ".agent-panel-root:hover .agent-sidebar-chat-header[data-agent-sidebar-chat-header],.agent-panel-root:focus-within .agent-sidebar-chat-header[data-agent-sidebar-chat-header],.agent-sidebar-chat-header[data-agent-sidebar-chat-header][data-agent-sidebar-chat-header-active]{opacity:1;pointer-events:auto;}" +
@@ -1741,7 +1747,7 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
                         : undefined, "data-agent-sidebar-layout": panelLayout, "data-agent-sidebar-position": position, "data-agent-sidebar-state": panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, "data-agent-sidebar-chat-handoff": chatViewTransitionHandoff ? "true" : undefined, style: chatViewTransition
                     ? getAgentChatViewTransitionStyle(panelStyle)
                     : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, threadFooterSlot: threadFooterSlot, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), isFullscreen: effectiveFullscreen, onToggleFullscreen: isMobile ? undefined : (onFullscreenRequest ?? toggleFullscreen), storageKey: storageKey, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: position, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
-    return (_jsx(AgentSidebarOnboardingContext.Provider, { value: true, children: _jsxs(RealtimeVoiceModeProvider, { browserTabId: browserTabId, children: [showFirstRunOnboarding && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsxs("div", { className: "agent-sidebar-shell flex min-w-0 flex-1 h-screen overflow-hidden", "data-agent-sidebar-position": position, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: [_jsx(AgentNativeRouteWarmup, {}), isMobile &&
+    return (_jsx(AgentSidebarOnboardingContext.Provider, { value: true, children: _jsxs(RealtimeVoiceModeProvider, { browserTabId: browserTabId, children: [showFirstRunOnboarding && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsxs("div", { className: "agent-sidebar-shell flex min-w-0 flex-1 h-screen overflow-hidden", "data-agent-sidebar-position": position, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: [isMobile &&
                             !presentationMode &&
                             (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-foreground/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? _jsx(URLSync, { browserTabId: browserTabId }) : null, isLeft && !presentationMode ? sidebar : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": position, "data-agent-sidebar-main-state": !isMobile &&
                                 !effectiveFullscreen &&

package/dist/client/AssistantChat.js

@@ -13,13 +13,14 @@ import { appendAgentChatContextToMessage, formatAgentChatContextItemsForPrompt,
 import { captureError } from "./analytics.js";
 import { agentNativePath } from "./api-path.js";
 import { AssistantMessageListErrorBoundary, AssistantUiStaleIndexErrorBoundary, } from "./assistant-ui-recovery.js";
+import { modelCatalogConfirmsMissing } from "./chat-model-groups.js";
 import { AGENT_CHAT_VIEW_TRANSITION_PREPARE_EVENT } from "./chat-view-transition.js";
 // ─── chat/ module imports ─────────────────────────────────────────────────────
 import { DownscalingImageAttachmentAdapter, BinaryDocumentAttachmentAdapter, MAX_ESTIMATED_BODY_BYTES, AGGRESSIVE_MAX_IMAGE_DIMENSION, AGGRESSIVE_JPEG_QUALITY, transcodeImageToDataURL, createAgentImageAttachments, serializeQueuedAttachments, estimateAttachmentBodyBytes, } from "./chat/attachment-adapters.js";
 import { TextStreamingContext } from "./chat/markdown-renderer.js";
 import { CheckpointContext, MessageActionsContext, assistantMessageRunId, UserMessage, AssistantMessage, SelectionAttachedPill, RunningActivityStatus, displayableUserMessageText, isHiddenUserMessage, ServerRunActiveContext, } from "./chat/message-components.js";
 import { repoHasAssistantMessage, getRepoMessages, getRepoMessage, shouldImportServerThreadData, dedupeRepoMessagesById, dropEmptyAssistantMessages, withLastAssistantRunDuration, } from "./chat/repo-helpers.js";
-import { BuilderSetupContent, LoopLimitContinueCard, RunErrorRecoveryCard, PlanModeCallout, getLoopLimitMetadata, getRunErrorMetadata, getRequestModeMetadata, runErrorKey, } from "./chat/run-recovery.js";
+import { BuilderSetupCard, BuilderSetupContent, LoopLimitContinueCard, RunErrorRecoveryCard, PlanModeCallout, getLoopLimitMetadata, getRunErrorMetadata, getRequestModeMetadata, runErrorKey, } from "./chat/run-recovery.js";
 import { createAgentChatRuntimeAdapter, } from "./chat/runtime.js";
 import { ChatRunningContext, ChatRunDurationContext, ApprovalContext, ReconnectStreamMessage, } from "./chat/tool-call-display.js";
 import { useAgentChatLifecycleTracking } from "./chat/use-agent-chat-lifecycle-tracking.js";
@@ -1437,11 +1438,18 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
     // gone missing instead of throwing.
     useEffect(() => installAssistantUiMessageRepositoryRecovery(threadRuntime), [threadRuntime]);
     const agentEngineConfigured = useAgentEngineConfigured(providerStatusChecksEnabled, { tabId, threadId });
-    const missingApiKey = agentEngineConfigured.missing;
-    // A status check that has not answered is not a reason to swallow keystrokes,
-    // and a confirmed-missing key swaps the composer for the Connect AI button
-    // below rather than disabling it. Only the host's own `composerDisabled`
-    // (Desktop-only chats) blocks typing.
+    const modelCatalogMissing = modelCatalogConfirmsMissing(availableModels, modelListLoading);
+    // The model picker has already resolved the same provider status shown in
+    // its setup choices. Use that settled signal to surface setup before a slow
+    // readiness request can accept a doomed submit; a later canonical configured
+    // response always wins over a stale catalog.
+    const missingApiKey = agentEngineConfigured.state !== "configured" &&
+        (agentEngineConfigured.missing || modelCatalogMissing);
+    // Unknown and unavailable are setup-required for this surface. Letting a
+    // submit through while the status route is still unreachable creates a run
+    // that can sit on "Thinking" forever when no provider is configured.
+    const engineSetupRequired = providerStatusChecksEnabled &&
+        (agentEngineConfigured.state !== "configured" || missingApiKey);
     const isComposerDisabled = composerDisabled;
     const [missingKeySetupOpen, setMissingKeySetupOpen] = useState(false);
     const requestMissingKeySetup = useCallback(() => {
@@ -2995,7 +3003,12 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
     // restored queues can exist after a reload where this component never saw the
     // previous run as active.
     useEffect(() => {
-        if (isRestoring || isRunning || queuedMessages.length === 0) {
+        // Keep prompts visible while setup is missing. Dequeuing them would remove
+        // the only user-visible copy and immediately re-enter the provider failure.
+        if (isRestoring ||
+            engineSetupRequired ||
+            isRunning ||
+            queuedMessages.length === 0) {
             return;
         }
         if (dequeueInFlightRef.current)
@@ -3090,6 +3103,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         applyLocalQueuedMessages,
         isRestoring,
         isRunning,
+        engineSetupRequired,
         queueWakeVersion,
         queuedMessages,
         threadId,
@@ -3188,7 +3202,9 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         }
         try {
             const frozenContent = cloneContentParts(reconnectContent);
-            settleInterruptedToolCalls(frozenContent);
+            settleInterruptedToolCalls(frozenContent, undefined, {
+                includeActivity: true,
+            });
             const repo = normalizeThreadRepository(threadRuntime.export());
             const messages = getRepoMessages(repo);
             const lastEntry = messages[messages.length - 1];
@@ -3370,10 +3386,8 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
     const addToQueue = useCallback(async (text, images, references, attachments, requestMode, intent = "queued", recoveryAction, includeComposerContext = false, trackInRunsTray = false, preserveReconnectAutoRecoveryBudget = false, hideUserMessage = false, submitMessageId) => {
         if (isAgentChatSubmitCancelled(submitMessageId))
             return;
-        if (agentEngineConfigured.state === "missing") {
+        if (engineSetupRequired) {
             requestMissingKeySetup();
-            reportAgentChatSubmitResult(submitMessageId, false, "missing-engine");
-            return;
         }
         if (!preserveReconnectAutoRecoveryBudget) {
             reconnectAutoRecoveryCountRef.current = 0;
@@ -3523,7 +3537,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
             ]);
             stopActiveRunRef.current({ preserveQueuedMessages: true });
         }
-        else if (isRunning && intent === "queued") {
+        else if (engineSetupRequired || (isRunning && intent === "queued")) {
             applyLocalQueuedMessages((prev) => [
                 ...prev,
                 {
@@ -3576,12 +3590,12 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         }
     }, [
         applyLocalQueuedMessages,
-        agentEngineConfigured.state,
         buildComposerContextSubmission,
         execMode,
         isRunning,
         materializeFrozenReconnectContent,
         markOptimisticRunning,
+        engineSetupRequired,
         appendThreadMessage,
         requestMissingKeySetup,
         selectedEffort,
@@ -3824,7 +3838,8 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
     const latestMessageRole = latestMessage?.role;
     const latestAssistantWasPlan = latestMessageRole === "assistant" &&
         getRequestModeMetadata(latestMessage) === "plan";
-    const showMissingKeySetup = missingApiKey && !authError;
+    const showMissingKeySetup = engineSetupRequired && !authError;
+    const showInlineMissingKeySetup = showMissingKeySetup && missingApiKeySetupLayout === "sidebar";
     const showPlanModeCallout = execMode === "plan" &&
         !planModeDisabled &&
         !isComposerDisabled &&
@@ -3892,7 +3907,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
     const showCenteredEmptyThreadFooterSlot = centeredEmptyState && !isRestoring && hasThreadFooterSlot;
     const showComposerSlot = Boolean(composerSlot) && (!centerComposerWhenEmpty || centeredEmptyState);
     const compactMissingKeyEmptyState = missingApiKeySetupLayout === "sidebar" &&
-        missingApiKey &&
+        engineSetupRequired &&
         !authError &&
         showEmptyState &&
         !isRestoring;
@@ -3912,7 +3927,8 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         (guidedQuestions && guidedQuestions.length > 0) ||
         showScrollToBottom ||
         composerContextItems.length > 0 ||
-        showPlanModeCallout);
+        showPlanModeCallout ||
+        showInlineMissingKeySetup);
     // Human-in-the-loop approvals: when the user approves a paused `needsApproval`
     // tool call, re-issue the turn carrying the call's approval key so the server
     // gate lets that specific call run. Reuses the same append path as recovery /
@@ -3976,7 +3992,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                                                 ? "sr-only"
                                                                 : "flex h-full flex-col items-center justify-center gap-3 px-4 py-16"), children: [_jsx(IconMessage, { className: "h-5 w-5 text-muted-foreground/60" }), _jsx("p", { className: "sr-only", children: emptyStateText ?? "How can I help you?" }), emptyStateAddon, resolvedSuggestions &&
                                                                     resolvedSuggestions.length > 0 ? (_jsx("div", { className: "flex w-full max-w-[280px] flex-col gap-1", children: resolvedSuggestions.map((suggestion) => (_jsx("button", { onClick: () => {
-                                                                            if (missingApiKey) {
+                                                                            if (engineSetupRequired) {
                                                                                 requestMissingKeySetup();
                                                                                 return;
                                                                             }
@@ -3999,12 +4015,12 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                                                         } }) })), (isReconnecting ||
                                                                     reconnectFrozen ||
                                                                     adapterHandoffPending) &&
-                                                                    visibleReconnectContent.length > 0 && (_jsx(MessageScrollerItem, { children: _jsx(ReconnectStreamMessage, { content: visibleReconnectContent }) })), (isReconnecting ||
+                                                                    visibleReconnectContent.length > 0 && (_jsx(MessageScrollerItem, { children: _jsx(ReconnectStreamMessage, { content: visibleReconnectContent, allowActivitySpinner: !reconnectFrozen }) })), (isReconnecting ||
                                                                     reconnectFrozen ||
                                                                     adapterHandoffPending) &&
                                                                     visibleReconnectContent.length === 0 &&
                                                                     reconnectContent.length === 0 &&
-                                                                    reconnectActivityContent.length > 0 && (_jsx(MessageScrollerItem, { children: _jsx(ReconnectStreamMessage, { content: reconnectActivityContent }) })), showGlobalRunningStatus && (_jsx(MessageScrollerItem, { children: _jsx(RunningActivityStatus, { label: runningStatusLabel }) })), visibleQueuedMessages.length > 0 && (_jsx(MessageScrollerItem, { children: _jsxs("div", { className: "flex items-center justify-end gap-1.5 pr-0.5 text-xs text-muted-foreground", children: [_jsx(IconClock, { className: "h-3 w-3" }), _jsxs("span", { children: [visibleQueuedMessages.length, " queued"] })] }) })), visibleQueuedMessages.map((msg) => {
+                                                                    reconnectActivityContent.length > 0 && (_jsx(MessageScrollerItem, { children: _jsx(ReconnectStreamMessage, { content: reconnectActivityContent, allowActivitySpinner: !reconnectFrozen }) })), showGlobalRunningStatus && (_jsx(MessageScrollerItem, { children: _jsx(RunningActivityStatus, { label: runningStatusLabel }) })), visibleQueuedMessages.length > 0 && (_jsx(MessageScrollerItem, { children: _jsxs("div", { className: "flex items-center justify-end gap-1.5 pr-0.5 text-xs text-muted-foreground", children: [_jsx(IconClock, { className: "h-3 w-3" }), _jsxs("span", { children: [visibleQueuedMessages.length, " queued"] })] }) })), visibleQueuedMessages.map((msg) => {
                                                                     const displayText = displayableUserMessageText(msg.text);
                                                                     const imageSources = queuedMessageImageSources(msg);
                                                                     return (_jsx(MessageScrollerItem, { messageId: msg.id, children: _jsxs("div", { className: "group flex items-start justify-end gap-1.5", children: [isRunning && (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: () => sendQueuedMessageNow(msg.id), "aria-label": "Send now", className: "mt-1.5 flex h-5 w-5 cursor-pointer items-center justify-center rounded-full border border-border bg-background text-muted-foreground opacity-0 shadow-sm transition-opacity hover:bg-accent hover:text-foreground focus-visible:opacity-100 group-hover:opacity-100", children: _jsx(IconArrowUp, { className: "h-3 w-3" }) }) }), _jsx(TooltipContent, { children: "Send now (stops the current response)" })] })), _jsx("button", { type: "button", onClick: () => applyLocalQueuedMessages((prev) => prev.filter((m) => m.id !== msg.id)), "aria-label": "Remove from queue", className: "mt-1.5 flex h-5 w-5 cursor-pointer items-center justify-center rounded-full border border-border bg-background text-muted-foreground opacity-0 shadow-sm transition-opacity hover:bg-accent hover:text-foreground focus-visible:opacity-100 group-hover:opacity-100", children: _jsx(IconX, { className: "h-3 w-3" }) }), _jsxs("div", { className: "max-w-[85%] rounded-lg bg-accent/50 px-3 py-2 text-sm leading-relaxed text-foreground/60 whitespace-pre-wrap break-words", children: [displayText, imageSources.length > 0 && (_jsx("div", { className: "flex flex-wrap gap-1.5 mt-1.5", children: imageSources.map((img, j) => (_jsx("img", { src: img, alt: "", className: "h-12 w-12 rounded object-cover border border-border/50" }, j))) }))] })] }) }, msg.id));
@@ -4019,31 +4035,36 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                                     ? { skipLabel: guidedQuestionsSkipLabel }
                                                     : {}), ...(guidedQuestionsSubmitLabel
                                                     ? { submitLabel: guidedQuestionsSubmitLabel }
-                                                    : {}), className: "h-auto items-stretch justify-stretch bg-transparent" }) })), composerError && (_jsxs("div", { role: "alert", className: "shrink-0 mx-3 mb-1.5 flex items-start gap-2 rounded-md border border-destructive/40 bg-destructive/10 px-3 py-2 text-xs text-destructive", children: [_jsx(IconAlertTriangle, { className: "h-3.5 w-3.5 mt-0.5 shrink-0" }), _jsx("span", { className: "flex-1 leading-snug", children: composerError }), _jsx("button", { type: "button", "aria-label": "Dismiss error", onClick: () => setComposerError(null), className: "shrink-0 opacity-70 hover:opacity-100", children: _jsx(IconX, { className: "h-3 w-3" }) })] })), _jsxs("div", { className: "agent-composer-stack", "data-agent-composer-adjacent-ui": hasComposerAccessoryAboveStack ? "true" : undefined, children: [_jsx(SelectionAttachedPill, {}), showPlanModeCallout && (_jsx(PlanModeCallout, { canImplementPlan: canImplementPlan, onImplementPlan: handleImplementPlan, onSwitchToAct: handleSwitchToAct })), _jsxs(Popover, { open: showMissingKeySetup && missingKeySetupOpen, onOpenChange: setMissingKeySetupOpen, children: [_jsx(AgentComposerFrame, { layoutVariant: composerLayoutVariant, className: cn(composerAreaClassName, isComposerDisabled &&
+                                                    : {}), className: "h-auto items-stretch justify-stretch bg-transparent" }) })), composerError && (_jsxs("div", { role: "alert", className: "shrink-0 mx-3 mb-1.5 flex items-start gap-2 rounded-md border border-destructive/40 bg-destructive/10 px-3 py-2 text-xs text-destructive", children: [_jsx(IconAlertTriangle, { className: "h-3.5 w-3.5 mt-0.5 shrink-0" }), _jsx("span", { className: "flex-1 leading-snug", children: composerError }), _jsx("button", { type: "button", "aria-label": "Dismiss error", onClick: () => setComposerError(null), className: "shrink-0 opacity-70 hover:opacity-100", children: _jsx(IconX, { className: "h-3 w-3" }) })] })), _jsxs("div", { className: "agent-composer-stack", "data-agent-composer-adjacent-ui": hasComposerAccessoryAboveStack ? "true" : undefined, children: [_jsx(SelectionAttachedPill, {}), showPlanModeCallout && (_jsx(PlanModeCallout, { canImplementPlan: canImplementPlan, onImplementPlan: handleImplementPlan, onSwitchToAct: handleSwitchToAct })), showInlineMissingKeySetup ? (_jsx(BuilderSetupCard, { fullWidth: true, layout: "sidebar", onConnected: handleBuilderConnected })) : null, _jsxs(Popover, { open: showMissingKeySetup &&
+                                                        !showInlineMissingKeySetup &&
+                                                        missingKeySetupOpen, onOpenChange: setMissingKeySetupOpen, children: [_jsx(AgentComposerFrame, { layoutVariant: composerLayoutVariant, className: cn(composerAreaClassName, isComposerDisabled &&
                                                                 !showMissingKeySetup &&
                                                                 "opacity-70"), rootClassName: cn(showMissingKeySetup &&
-                                                                "agent-composer-root--missing-key"), children: showMissingKeySetup ? (_jsx(PopoverTrigger, { asChild: true, children: _jsx("button", { type: "button", className: "agent-composer-missing-key-trigger", "aria-label": "Connect AI to start chatting", children: _jsxs("span", { className: "agent-composer-missing-key-content", children: [_jsxs("span", { className: "agent-composer-missing-key-copy", children: [_jsx("span", { className: "agent-composer-missing-key-title", children: missingApiKeySetupLayout === "sidebar"
+                                                                "agent-composer-root--missing-key"), children: showMissingKeySetup && !showInlineMissingKeySetup ? (_jsx(PopoverTrigger, { asChild: true, children: _jsx("button", { type: "button", className: "agent-composer-missing-key-trigger", "aria-label": "Connect AI to start chatting", children: _jsxs("span", { className: "agent-composer-missing-key-content", children: [_jsxs("span", { className: "agent-composer-missing-key-copy", children: [_jsx("span", { className: "agent-composer-missing-key-title", children: missingApiKeySetupLayout === "sidebar"
                                                                                             ? "Connect AI to chat"
                                                                                             : "Connect AI to start chatting" }), missingApiKeySetupLayout !== "sidebar" ? (_jsx("span", { className: "agent-composer-missing-key-description", children: "Builder.io includes free credits, or use your own API key." })) : null] }), _jsx("span", { className: "agent-composer-missing-key-cta", children: "Connect AI" })] }) }) })) : (_jsxs(_Fragment, { children: [_jsx(ComposerAttachmentPreviewStrip, {}), _jsx(TiptapComposer, { focusRef: tiptapRef, onTextChange: isActiveComposer
                                                                             ? handleComposerTextChange
-                                                                            : undefined, disabled: isComposerDisabled, placeholder: missingApiKey
-                                                                            ? "Connect AI to start chatting..."
-                                                                            : composerDisabled
-                                                                                ? (composerDisabledPlaceholder ??
-                                                                                    "Open Desktop to use this chat.")
-                                                                                : isRunning
-                                                                                    ? queuedMessages.length > 0
-                                                                                        ? `${queuedMessages.length} queued — send a follow-up...`
-                                                                                        : "Send a follow-up..."
-                                                                                    : composerPlaceholder, onSubmit: isRunning || composerContextItems.length > 0
+                                                                            : undefined, disabled: isComposerDisabled ||
+                                                                            showInlineMissingKeySetup, placeholder: showInlineMissingKeySetup
+                                                                            ? "Connect AI above to start chatting..."
+                                                                            : engineSetupRequired
+                                                                                ? "Connect AI to start chatting..."
+                                                                                : composerDisabled
+                                                                                    ? (composerDisabledPlaceholder ??
+                                                                                        "Open Desktop to use this chat.")
+                                                                                    : isRunning
+                                                                                        ? queuedMessages.length > 0
+                                                                                            ? `${queuedMessages.length} queued — send a follow-up...`
+                                                                                            : "Send a follow-up..."
+                                                                                        : composerPlaceholder, onSubmit: isRunning || composerContextItems.length > 0
                                                                             ? (text, references, attachments, options) => void addToQueue(text, undefined, references.length > 0
                                                                                 ? references
                                                                                 : undefined, attachments, undefined, resolveAssistantChatSubmitIntent({
                                                                                 isRunning,
                                                                                 requestedIntent: options?.intent,
                                                                             }), undefined, true)
-                                                                            : undefined, onSlashCommand: onSlashCommand, execMode: execMode, onExecModeChange: onExecModeChange, planModeDisabled: planModeDisabled, planModeDisabledReason: planModeDisabledReason, selectedModel: selectedModel ?? defaultModel, selectedEffort: selectedEffort, availableModels: availableModels, modelListLoading: modelListLoading, onModelChange: onModelChange, onEffortChange: onEffortChange, imageModelMenu: imageModelMenu, onConnectProvider: onConnectProvider, onConnectLocalRuntime: onConnectLocalRuntime, toolbarSlot: composerToolbarSlot, contextItems: composerContextItems, onRemoveContextItem: removeComposerContextItem, plusMenuMode: plusMenuMode, layoutVariant: composerLayoutVariant, providerConnectStatusEnabled: providerStatusChecksEnabled, voiceEnabled: true, draftScope: threadId || tabId, interceptBuildRequestsForBuilder: true, onAttachmentError: setComposerError, extraActionButton: contextXRayEnabled ||
-                                                                            composerExtraActionButton ? (_jsxs(_Fragment, { children: [contextXRayEnabled && (_jsx(ContextMeter, { threadId: threadId })), composerExtraActionButton] })) : undefined, stopButton: showRunningInUI ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: () => stopActiveRun(), "aria-label": "Stop response", "data-agent-composer-slot": "stop-button", className: "shrink-0 flex h-7 w-7 cursor-pointer items-center justify-center rounded-full bg-primary text-primary-foreground shadow-sm transition-opacity hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", children: _jsx(IconPlayerStopFilled, { className: "h-3 w-3" }) }) }), _jsx(TooltipContent, { children: "Stop response" })] })) : undefined })] })) }), showMissingKeySetup ? (_jsx(PopoverContent, { side: missingApiKeySetupLayout === "sidebar"
+                                                                            : undefined, willQueue: engineSetupRequired || isRunning, onSlashCommand: onSlashCommand, execMode: execMode, onExecModeChange: onExecModeChange, planModeDisabled: planModeDisabled, planModeDisabledReason: planModeDisabledReason, selectedModel: selectedModel ?? defaultModel, selectedEffort: selectedEffort, availableModels: availableModels, modelListLoading: modelListLoading, onModelChange: onModelChange, onEffortChange: onEffortChange, imageModelMenu: imageModelMenu, onConnectProvider: onConnectProvider, onConnectLocalRuntime: onConnectLocalRuntime, toolbarSlot: composerToolbarSlot, contextItems: composerContextItems, onRemoveContextItem: removeComposerContextItem, plusMenuMode: plusMenuMode, layoutVariant: composerLayoutVariant, providerConnectStatusEnabled: providerStatusChecksEnabled, voiceEnabled: true, draftScope: threadId || tabId, interceptBuildRequestsForBuilder: true, onAttachmentError: setComposerError, extraActionButton: contextXRayEnabled ||
+                                                                            composerExtraActionButton ? (_jsxs(_Fragment, { children: [contextXRayEnabled && (_jsx(ContextMeter, { threadId: threadId })), composerExtraActionButton] })) : undefined, stopButton: showRunningInUI ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: () => stopActiveRun(), "aria-label": "Stop response", "data-agent-composer-slot": "stop-button", className: "shrink-0 flex h-7 w-7 cursor-pointer items-center justify-center rounded-full bg-primary text-primary-foreground shadow-sm transition-opacity hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", children: _jsx(IconPlayerStopFilled, { className: "h-3 w-3" }) }) }), _jsx(TooltipContent, { children: "Stop response" })] })) : undefined })] })) }), showMissingKeySetup && !showInlineMissingKeySetup ? (_jsx(PopoverContent, { side: missingApiKeySetupLayout === "sidebar"
                                                                 ? "top"
                                                                 : "bottom", align: "center", sideOffset: 8, collisionPadding: 12, "data-agent-native-composer-popover": "true", className: "z-[260] box-border w-[min(calc(100vw-2rem),var(--radix-popover-content-available-width,26rem),26rem)] rounded-lg border-border p-3 shadow-lg", children: _jsx(BuilderSetupContent, { onConnected: handleBuilderConnected, layout: missingApiKeySetupLayout }) })) : null] })] })] }) }) }) }) }) }) }) }));
 });

package/dist/client/MultiTabAssistantChat.js

@@ -482,7 +482,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
         threadUrlParamName,
         threadUrlSyncEnabled,
     ]);
-    const { threads, activeThreadId, isLoading, createThread, switchThread: switchThreadState, forkThread, saveThreadData, generateTitle, searchThreads, loadMoreThreads, refreshThreads, hasMoreThreads, isLoadingMoreThreads, threadsLoadError, isNewThread, pinThread, renameThread, } = useChatThreads(apiUrl, storageKey, null, {
+    const { threads, activeThreadId, isLoading, createThread, switchThread: switchThreadState, forkThread, saveThreadData, generateTitle, searchThreads, loadMoreThreads, refreshThreads, hasMoreThreads, isLoadingMoreThreads, threadsLoadError, isNewThread, pinThread, renameThread, } = useChatThreads(apiUrl, storageKey, scope, {
         restoreActiveThread,
         routeThreadId: threadUrlSyncEnabled
             ? urlThreadId

package/dist/client/RouteTransitionIndicator.d.ts

@@ -0,0 +1,7 @@
+export declare const ROUTE_TRANSITION_INDICATOR_DELAY_MS = 180;
+/**
+ * Shows the destination after a short delay so fast route changes stay quiet.
+ * The provider shell survives lazy route loading, including a cold Vite graph.
+ */
+export declare function RouteTransitionIndicator(): import("react").JSX.Element | null;
+//# sourceMappingURL=RouteTransitionIndicator.d.ts.map

package/dist/client/RouteTransitionIndicator.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { IconLoader2 } from "@tabler/icons-react";
+import { useEffect, useState } from "react";
+import { useNavigation } from "react-router";
+export const ROUTE_TRANSITION_INDICATOR_DELAY_MS = 180;
+/**
+ * Shows the destination after a short delay so fast route changes stay quiet.
+ * The provider shell survives lazy route loading, including a cold Vite graph.
+ */
+export function RouteTransitionIndicator() {
+    const navigation = useNavigation();
+    const destination = navigation.state === "loading" && navigation.location
+        ? `${navigation.location.pathname}${navigation.location.search}${navigation.location.hash}`
+        : null;
+    const [visibleDestination, setVisibleDestination] = useState(null);
+    useEffect(() => {
+        if (!destination) {
+            setVisibleDestination(null);
+            return;
+        }
+        setVisibleDestination(null);
+        const timer = window.setTimeout(() => {
+            setVisibleDestination(destination);
+        }, ROUTE_TRANSITION_INDICATOR_DELAY_MS);
+        return () => window.clearTimeout(timer);
+    }, [destination]);
+    if (!destination || visibleDestination !== destination)
+        return null;
+    return (_jsxs("div", { "aria-label": `Loading ${destination}`, "aria-live": "polite", className: "pointer-events-none fixed bottom-4 right-4 z-50 flex max-w-[calc(100vw-2rem)] items-center gap-2 rounded-md border border-border bg-background/95 px-3 py-2 text-xs text-muted-foreground shadow-lg backdrop-blur", "data-route-transition-indicator": "true", "data-route-transition-target": destination, role: "status", children: [_jsx(IconLoader2, { "aria-hidden": "true", className: "size-3.5 shrink-0 animate-spin text-primary" }), _jsx("span", { className: "truncate", children: destination })] }));
+}
+//# sourceMappingURL=RouteTransitionIndicator.js.map

package/dist/client/agent-engine-key.js

@@ -69,7 +69,7 @@ export async function saveAgentEngineProviderSettings({ provider, key, apiKey, b
             .catch(() => null);
         throw new Error(message ??
             (res.status === 401
-                ? "Sign in to save a key, or connect Builder instead."
+                ? "Sign in to save a key, or connect Builder with a free tier instead."
                 : `Could not save provider settings (HTTP ${res.status}).`));
     }
     dispatchConfiguredChanged();

package/dist/client/app-providers.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * Shared provider shell for agent-native template roots.
  *
@@ -52,14 +52,23 @@ import { Toaster } from "@agent-native/toolkit/ui/sonner";
 import { TooltipProvider } from "@radix-ui/react-tooltip";
 import { QueryClientProvider } from "@tanstack/react-query";
 import { ThemeProvider } from "next-themes";
+import { useInRouterContext } from "react-router";
 import { ClientOnly } from "./ClientOnly.js";
 import { DefaultSpinner } from "./DefaultSpinner.js";
 import { AgentNativeI18nProvider, } from "./i18n.js";
 import { RequireSession } from "./require-session.js";
+import { AgentNativeRouteWarmup } from "./route-warmup.js";
+import { RouteTransitionIndicator } from "./RouteTransitionIndicator.js";
 const DEFAULT_TOASTER = _jsx(Toaster, { richColors: true, position: "bottom-left" });
+function RoutedAppEnhancements() {
+    const isInRouter = useInRouterContext();
+    if (!isInRouter)
+        return null;
+    return (_jsxs(_Fragment, { children: [_jsx(AgentNativeRouteWarmup, {}), _jsx(RouteTransitionIndicator, {})] }));
+}
 function ProvidersInner({ queryClient, defaultTheme = "system", themeAttribute = "class", tooltipDelayDuration, toaster = DEFAULT_TOASTER, disableThemeTransitions = true, i18n, children, }) {
     const localizedChildren = i18n === false ? (children) : (_jsx(AgentNativeI18nProvider, { ...(i18n ?? {}), children: children }));
-    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(ThemeProvider, { attribute: themeAttribute, defaultTheme: defaultTheme, enableSystem: true, disableTransitionOnChange: disableThemeTransitions, children: _jsxs(TooltipProvider, { delayDuration: tooltipDelayDuration, children: [localizedChildren, toaster] }) }) }));
+    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(ThemeProvider, { attribute: themeAttribute, defaultTheme: defaultTheme, enableSystem: true, disableTransitionOnChange: disableThemeTransitions, children: _jsxs(TooltipProvider, { delayDuration: tooltipDelayDuration, children: [localizedChildren, _jsx(RoutedAppEnhancements, {}), toaster] }) }) }));
 }
 export function AppProviders({ queryClient, isPublicPath = false, clientOnlyFallback, sessionBypass = false, defaultTheme, themeAttribute, tooltipDelayDuration, toaster, disableThemeTransitions, i18n, children, }) {
     const fallback = clientOnlyFallback ?? _jsx(DefaultSpinner, {});

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

@@ -634,7 +634,7 @@ export function isCollapsibleAssistantWorkPart(part) {
         !ALWAYS_VISIBLE_ASSISTANT_TOOLS.has(part.toolName ?? "") &&
         part.chatUI === undefined &&
         part.mcpApp === undefined &&
-        // Keep the Approve/Deny affordance outside "Worked for…" — needsApproval
+        // Keep the Approve/Deny affordance outside "Worked for…" - needsApproval
         // tools finish with a result string, so without this they collapse and the
         // human gate disappears from the viewport.
         !toolCallHasPendingApproval(part));

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

@@ -277,7 +277,7 @@ export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDism
             onDismiss();
         }
     }, [builderReconnectResolved, onDismiss]);
-    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) }), _jsx("p", { className: "mt-1 text-xs leading-relaxed text-muted-foreground", children: info.message }), shouldShowBuilderReconnect && !builderReconnectResolved && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-muted-foreground", children: "The current Builder.io or model-provider credential was rejected. Reconnect Builder.io, then retry this message." })), isConnectionRecoveryError && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-muted-foreground", children: "If retry lands on the same error, start a new chat session and continue from what already changed." })), (info.runId || info.errorCode || info.details) && (_jsxs("button", { type: "button", onClick: () => setDetailsOpen((v) => !v), className: "mt-2 inline-flex items-center gap-1 text-[11px] font-medium text-muted-foreground hover:text-foreground", children: [_jsx(IconChevronDown, { size: 12, className: cn("transition-transform", detailsOpen && "rotate-180") }), "Details"] })), detailsOpen && (_jsxs("div", { className: "mt-2 rounded-md border border-border/60 bg-background/70 p-2 font-mono text-[11px] leading-relaxed text-muted-foreground", children: [info.runId && _jsxs("div", { children: ["run: ", info.runId] }), info.errorCode && _jsxs("div", { children: ["code: ", info.errorCode] }), info.details && (_jsx("pre", { className: "mt-2 max-h-28 overflow-auto whitespace-pre-wrap break-words font-mono", children: info.details }))] }))] }), _jsx("button", { type: "button", onClick: onDismiss, "aria-label": "Dismiss", className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-md text-muted-foreground hover:bg-background/80 hover:text-foreground", children: _jsx(IconX, { size: 14 }) })] }), _jsxs("div", { className: "mt-3 flex flex-wrap items-center gap-2", children: [shouldShowBuilderReconnect && !builderReconnectResolved && (_jsxs("button", { type: "button", onClick: () => builderReconnect.start(), disabled: builderReconnect.connecting, 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-70", children: [builderReconnect.connecting ? (_jsx(IconLoader2, { size: 13, className: "animate-spin" })) : null, builderReconnect.connecting
+    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) }), _jsx("p", { className: "mt-1 text-xs leading-relaxed text-muted-foreground", children: info.message }), shouldShowBuilderReconnect && !builderReconnectResolved && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-muted-foreground", children: "The current Builder.io or model-provider credential was rejected. Reconnect Builder.io (free tier available), then retry this message." })), isConnectionRecoveryError && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-muted-foreground", children: "If retry lands on the same error, start a new chat session and continue from what already changed." })), (info.runId || info.errorCode || info.details) && (_jsxs("button", { type: "button", onClick: () => setDetailsOpen((v) => !v), className: "mt-2 inline-flex items-center gap-1 text-[11px] font-medium text-muted-foreground hover:text-foreground", children: [_jsx(IconChevronDown, { size: 12, className: cn("transition-transform", detailsOpen && "rotate-180") }), "Details"] })), detailsOpen && (_jsxs("div", { className: "mt-2 rounded-md border border-border/60 bg-background/70 p-2 font-mono text-[11px] leading-relaxed text-muted-foreground", children: [info.runId && _jsxs("div", { children: ["run: ", info.runId] }), info.errorCode && _jsxs("div", { children: ["code: ", info.errorCode] }), info.details && (_jsx("pre", { className: "mt-2 max-h-28 overflow-auto whitespace-pre-wrap break-words font-mono", children: info.details }))] }))] }), _jsx("button", { type: "button", onClick: onDismiss, "aria-label": "Dismiss", className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-md text-muted-foreground hover:bg-background/80 hover:text-foreground", children: _jsx(IconX, { size: 14 }) })] }), _jsxs("div", { className: "mt-3 flex flex-wrap items-center gap-2", children: [shouldShowBuilderReconnect && !builderReconnectResolved && (_jsxs("button", { type: "button", onClick: () => builderReconnect.start(), disabled: builderReconnect.connecting, 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-70", children: [builderReconnect.connecting ? (_jsx(IconLoader2, { size: 13, className: "animate-spin" })) : null, builderReconnect.connecting
                                 ? "Connecting Builder.io"
                                 : "Reconnect Builder.io"] })), canRecover && (_jsxs(_Fragment, { children: [_jsxs("button", { type: "button", onClick: onContinue, 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", children: [_jsx(IconPlayerPlay, { size: 13 }), "Continue"] }), _jsxs("button", { type: "button", onClick: onRetry, className: "inline-flex h-8 items-center gap-1.5 rounded-md border border-border bg-background px-3 text-xs font-medium text-foreground hover:bg-accent", children: [_jsx(IconRefresh, { size: 13 }), isQueryError ? "Diagnose and retry" : "Retry"] })] })), canRecover && isConnectionRecoveryError && (_jsxs("button", { type: "button", onClick: startNewChat, className: "inline-flex h-8 items-center gap-1.5 rounded-md border border-border bg-background px-3 text-xs font-medium text-foreground hover:bg-accent", children: [_jsx(IconPlus, { size: 13 }), "New chat"] })), canRecover && onFork && !isConnectionRecoveryError && (_jsxs("button", { type: "button", onClick: handleFork, disabled: forking, title: "Fork this conversation into a separate chat thread.", "aria-label": "Fork this conversation into a separate chat thread", className: "inline-flex h-8 items-center gap-1.5 rounded-md border border-border bg-background px-3 text-xs font-medium text-foreground hover:bg-accent disabled:cursor-wait disabled:opacity-70", children: [forking ? (_jsx(IconLoader2, { size: 13, className: "animate-spin" })) : (_jsx(IconGitFork, { size: 13 })), forking ? "Forking..." : "Fork chat"] })), _jsxs("button", { type: "button", onClick: copyDetails, className: "ml-auto inline-flex h-8 items-center gap-1.5 rounded-md px-2.5 text-xs font-medium text-muted-foreground hover:bg-background/80 hover:text-foreground", children: [copyState === "copied" ? (_jsx(IconCheck, { size: 13 })) : copyState === "failed" ? (_jsx(IconX, { size: 13 })) : (_jsx(IconCopy, { size: 13 })), _jsx("span", { "aria-live": "polite", children: copyState === "copied"
                                     ? "Copied"

package/dist/client/chat/tool-call-display.d.ts

@@ -94,8 +94,10 @@ export declare function ToolCallFallback({ toolName, args, argsText, result, ...
     isLatestRunning?: boolean;
     isActiveTail?: boolean;
 }): React.JSX.Element;
-export declare function ReconnectStreamMessage({ content, }: {
+export declare function ReconnectStreamMessage({ content, allowActivitySpinner, }: {
     content: ContentPart[];
+    /** Activity-only cards are live during reconnect, but static once frozen. */
+    allowActivitySpinner?: boolean;
 }): React.JSX.Element;
 export declare function ReasoningCell({ text, isStreaming, resetKey, defaultOpen, autoCollapse, collapseWhenReplaced, durationMs, }: {
     text: string;

package/dist/client/chat/tool-call-display.js

@@ -446,7 +446,7 @@ export function ToolCallFallback({ toolName, args, argsText, result, ...rest })
 // ─── ReconnectStreamMessage ────────────────────────────────────────────────────
 // Renders the agent's in-progress response during reconnection (outside
 // assistant-ui's runtime). Uses the same visual styling as normal messages.
-export function ReconnectStreamMessage({ content, }) {
+export function ReconnectStreamMessage({ content, allowActivitySpinner = true, }) {
     const chatRunning = React.useContext(ChatRunningContext);
     const toolSummary = getReconnectToolSummaryInfo(content);
     const latestReasoningPartIndex = content.reduce((latestIndex, part, index) => part.type === "reasoning" ? index : latestIndex, -1);
@@ -454,7 +454,7 @@ export function ReconnectStreamMessage({ content, }) {
     const streamingReasoningPartIndex = content.at(-1)?.type === "reasoning" ? content.length - 1 : -1;
     const latestActiveToolIndex = content.reduce((latestIndex, part, index) => part.type === "tool-call" &&
         !isCallAgentToolCallShadowed(content, index) &&
-        (chatRunning || part.activity === true)
+        (chatRunning || (allowActivitySpinner && part.activity === true))
         ? index
         : latestIndex, -1);
     const renderPart = (part, i) => {
@@ -467,7 +467,8 @@ export function ReconnectStreamMessage({ content, }) {
         if (part.type === "reasoning") {
             return (_jsx(ReasoningCell, { text: part.text, isStreaming: chatRunning && i === streamingReasoningPartIndex, resetKey: `reconnect-reasoning-${i}`, defaultOpen: i === latestReasoningPartIndex, collapseWhenReplaced: i < latestReasoningPartIndex }, `reconnect-reasoning-${i}`));
         }
-        return (_jsx(ToolCallDisplay, { toolName: part.toolName, argsText: part.argsText, args: part.args, result: part.result, mcpApp: part.mcpApp, chatUI: part.chatUI, structuredMeta: part.structuredMeta, outcome: part.outcome, isRunning: part.result === undefined && (chatRunning || part.activity === true), isActiveTail: i === latestActiveToolIndex, approval: part.approval, repeatCount: part.repeatCount }, `reconnect-tool-${i}`));
+        return (_jsx(ToolCallDisplay, { toolName: part.toolName, argsText: part.argsText, args: part.args, result: part.result, mcpApp: part.mcpApp, chatUI: part.chatUI, structuredMeta: part.structuredMeta, outcome: part.outcome, isRunning: part.result === undefined &&
+                (chatRunning || (allowActivitySpinner && part.activity === true)), isActiveTail: i === latestActiveToolIndex, approval: part.approval, repeatCount: part.repeatCount }, `reconnect-tool-${i}`));
     };
     const renderedParts = [];
     let summaryStartIndex = -1;

package/dist/client/chat-model-groups.d.ts

@@ -18,5 +18,11 @@ export interface BuildChatModelGroupsOptions {
     currentEngineName?: string;
     currentModel?: string;
 }
+/**
+ * A loaded provider-backed catalog can confirm that setup is missing before
+ * the slower canonical readiness request resolves. An empty catalog is a
+ * failed lookup, not evidence that no provider is configured.
+ */
+export declare function modelCatalogConfirmsMissing(groups: readonly Pick<EngineModelGroup, "configured">[] | undefined, loading: boolean | undefined): boolean;
 export declare function buildChatModelGroups({ engines, configuredKeys, builderConnected, currentEngineName, currentModel, }: BuildChatModelGroupsOptions): EngineModelGroup[];
 //# sourceMappingURL=chat-model-groups.d.ts.map

package/dist/client/chat-model-groups.js

@@ -1,3 +1,14 @@
+/**
+ * A loaded provider-backed catalog can confirm that setup is missing before
+ * the slower canonical readiness request resolves. An empty catalog is a
+ * failed lookup, not evidence that no provider is configured.
+ */
+export function modelCatalogConfirmsMissing(groups, loading) {
+    return (loading === false &&
+        groups !== undefined &&
+        groups.length > 0 &&
+        groups.every((group) => !group.configured));
+}
 const HIDDEN_CHAT_MODEL_ENGINES = new Set([
     "ai-sdk:groq",
     "ai-sdk:mistral",

package/dist/client/error-format.js

@@ -94,7 +94,7 @@ export function normalizeChatError(errorMessage, errorCode) {
     }
     if (code === "builder_auth_error") {
         return {
-            message: "Builder rejected the connected credentials. Reconnect Builder.io in Settings, then retry.",
+            message: "Builder rejected the connected credentials. Reconnect Builder.io (free tier available) in Settings, then retry.",
             details: text,
         };
     }

package/dist/client/i18n.js

@@ -365,7 +365,7 @@ const CORE_FALLBACK_MESSAGES = {
     "codeRequired.codeChangeTitle": "This requires a code change",
     "codeRequired.codeChangeBadge": "Code change",
     "codeRequired.connectBuilderTitle": "Connect Builder.io",
-    "codeRequired.connectBuilderDescription": "Connect Builder to enable cloud-based code changes from this app.",
+    "codeRequired.connectBuilderDescription": "Connect Builder (free tier available) to enable cloud-based code changes from this app.",
     "codeRequired.setupRequired": "Setup required",
     "codeRequired.branchCreated": "Branch created",
     "codeRequired.close": "Close",

package/dist/client/onboarding/FirstRunOnboarding.d.ts

@@ -1,3 +1,7 @@
 import React from "react";
-export declare function FirstRunOnboarding(): React.JSX.Element | null;
+export interface FirstRunOnboardingProps {
+    /** Test hook; generated apps use the public Vite flag instead. */
+    skipIntegrations?: boolean;
+}
+export declare function FirstRunOnboarding({ skipIntegrations, }?: FirstRunOnboardingProps): React.JSX.Element | null;
 //# sourceMappingURL=FirstRunOnboarding.d.ts.map