@agent-native/core 0.176.1 → 0.176.2-nightly-20260831185956

package/dist/client/AssistantChat.js

@@ -20,9 +20,9 @@ import { AGENT_CHAT_VIEW_TRANSITION_PREPARE_EVENT } from "./chat-view-transition
 import { DownscalingImageAttachmentAdapter, BinaryDocumentAttachmentAdapter, MAX_ESTIMATED_BODY_BYTES, AGGRESSIVE_MAX_IMAGE_DIMENSION, AGGRESSIVE_JPEG_QUALITY, transcodeImageToDataURL, createAgentImageAttachments, serializeQueuedAttachments, estimateAttachmentBodyBytes, } from "./chat/attachment-adapters.js";
 import { readAssistantChatComposerDraft, writeAssistantChatComposerDraft, } from "./chat/composer-draft.js";
 import { ExternalTextStreamingContext, TextStreamingContext, } from "./chat/markdown-renderer.js";
-import { CheckpointContext, MessageActionsContext, assistantMessageRunId, UserMessage, AssistantMessage, ExternalUserStoppedRunContext, SelectionAttachedPill, RunningActivityStatus, displayableUserMessageText, isHiddenUserMessage, ServerRunActiveContext, UserStoppedRunContext, } from "./chat/message-components.js";
+import { AssistantChatHistoryContext, assistantMessageHasCompletedSideEffect, findMatchingAssistantChatHistoryVersion, isAssistantChatHistoryVersion, CheckpointContext, MessageActionsContext, assistantMessageRunId, UserMessage, AssistantMessage, ExternalUserStoppedRunContext, SelectionAttachedPill, RunningActivityStatus, displayableUserMessageText, isHiddenUserMessage, ServerRunActiveContext, UserStoppedRunContext, } from "./chat/message-components.js";
 import { repoHasAssistantMessage, getRepoMessages, getRepoMessage, shouldImportServerThreadData, dedupeRepoMessagesById, dropEmptyAssistantMessages, withLastAssistantRunDuration, } from "./chat/repo-helpers.js";
-import { BuilderSetupCard, LoopLimitContinueCard, RunErrorRecoveryCard, PlanModeCallout, getLoopLimitMetadata, getRunErrorMetadata, getRequestModeMetadata, runErrorKey, } from "./chat/run-recovery.js";
+import { BuilderSetupCard, LoopLimitContinueCard, RunErrorRecoveryCard, PlanModeCallout, getLoopLimitMetadata, getRunErrorMetadata, getRequestModeMetadata, isBuilderReconnectRunError, runErrorKey, } from "./chat/run-recovery.js";
 import { createAgentChatRuntimeAdapter, } from "./chat/runtime.js";
 import { ChatRunningContext, ChatRunningRunIdContext, ChatRunningTurnIdContext, ChatRunDurationContext, SuppressInlineOpenAppContext, ApprovalContext, ReconnectStreamMessage, } from "./chat/tool-call-display.js";
 import { useAgentChatLifecycleTracking } from "./chat/use-agent-chat-lifecycle-tracking.js";
@@ -41,7 +41,7 @@ import { claimRunStream, createRunStreamToken, ownsRunStream, releaseRunStream,
 import { signOut } from "./sign-out.js";
 import { AgentAutoContinueSignal, readSSEStreamRaw, settleInterruptedToolCalls, } from "./sse-event-processor.js";
 import { ThinkingDisplayProvider } from "./thinking-display.js";
-import { callAction } from "./use-action.js";
+import { callAction, useActionMutation, useActionQuery } from "./use-action.js";
 import { useAgentEngineConfigured } from "./use-agent-engine-configured.js";
 import { appendChatThreadScopeParams, } from "./use-chat-threads.js";
 import { useDevMode } from "./use-dev-mode.js";
@@ -74,7 +74,7 @@ export function assistantUiMessageListStructureKey(messages) {
         (message.attachments ?? []).map((attachment) => attachment.id),
     ]));
 }
-export function createUserMessageRunConfig(references, requestMode, recoveryAction, trackInRunsTray, approvedToolCalls, queuedMessageId, hideUserMessage, modelSnapshot, turnId) {
+export function createUserMessageRunConfig(references, requestMode, recoveryAction, trackInRunsTray, approvedToolCalls, queuedMessageId, hideUserMessage, modelSnapshot, turnId, usageLabel) {
     const custom = {};
     if (modelSnapshot?.model)
         custom.model = modelSnapshot.model;
@@ -100,6 +100,9 @@ export function createUserMessageRunConfig(references, requestMode, recoveryActi
     if (turnId) {
         custom.turnId = turnId;
     }
+    if (usageLabel) {
+        custom.usageLabel = usageLabel;
+    }
     const options = {};
     if (Object.keys(custom).length > 0) {
         options.runConfig = { custom };
@@ -1273,10 +1276,10 @@ import { extractThreadMeta, normalizeThreadRepository, } from "../agent/thread-d
 export { extractThreadMeta };
 /**
  * Strip raw base64 payload from attachment content parts when a hosted URL
- * already exists in the same content entry. This keeps the periodic thread
- * save payload compact — the server already stored the URL reference when it
- * processed the POST, and re-shipping multi-megabyte base64 strings on every
- * 5-second poll save balloons the SQL thread_data column unnecessarily.
+ * already exists in the same content entry. This keeps thread save and fork
+ * payloads compact — the server already stored the URL reference when it
+ * processed the POST, and re-shipping multi-megabyte base64 strings balloons
+ * the SQL thread_data column and request body unnecessarily.
  *
  * Only strips the raw base64 data-URL string from `content[].image` / `content[].data`
  * when a `metadata.uploadUrl` reference is present on the same attachment object,
@@ -1421,7 +1424,7 @@ function approvalResolutionIdentity(approvalKey, toolCallId,
 askId) {
     return `${toolCallId ?? ""}\u0000${approvalKey}\u0000${askId ?? ""}`;
 }
-const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateText, suggestions, dynamicSuggestions, threadFooterSlot, emptyStateAddon, showHeader = true, onSwitchToCli, className, apiUrl, tabId, browserTabId, threadId, contextScope, isolateHistoryByScope = false, contextNamespace, isActiveComposer = true, onMessageCountChange, onSaveThread, onGenerateTitle, composerSlot, onComposerTextChange, composerAreaClassName, composerPlaceholder, missingApiKeySetupLayout = "default", composerLayoutVariant = "default", centerComposerWhenEmpty = false, emptyStateDisplay = "default", composerToolbarSlot, composerExtraActionButton, showModelSelector = true, composerDisabled = false, composerDisabledPlaceholder, isNewThread, isThreadStateLoading, onSlashCommand, execMode, onExecModeChange, approvalActions, planModeDisabled, planModeDisabledReason, selectedModel, defaultModel, selectedEngine, selectedEffort, availableModels, modelListLoading, onModelChange, onEffortChange, availableAgents, selectedAgent, hostedHarness, onAgentChange, imageModelMenu, onForkChat, onConnectProvider, onConnectLocalRuntime, plusMenuMode = "full", providerStatusChecksEnabled = true, loadHistoryRepository, historyReloadKey, externalStreaming = false, externalUserStopped = false, onStop, agentChatSurface = "app", desktopIdentityUnauthenticated = false, desktopIdentityAuthenticated = false, onThreadRestoreNotFound, suppressInlineOpenApp = false, }, ref) {
+const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateText, suggestions, dynamicSuggestions, threadFooterSlot, emptyStateAddon, showHeader = true, onSwitchToCli, className, apiUrl, tabId, browserTabId, threadId, contextScope, chatHistory, isolateHistoryByScope = false, contextNamespace, isActiveComposer = true, onMessageCountChange, onSaveThread, onGenerateTitle, composerSlot, onComposerTextChange, composerAreaClassName, composerPlaceholder, missingApiKeySetupLayout = "default", composerLayoutVariant = "default", centerComposerWhenEmpty = false, emptyStateDisplay = "default", composerToolbarSlot, composerExtraActionButton, showModelSelector = true, composerDisabled = false, composerDisabledPlaceholder, isNewThread, isThreadStateLoading, onSlashCommand, execMode, onExecModeChange, approvalActions, planModeDisabled, planModeDisabledReason, selectedModel, defaultModel, selectedEngine, selectedEffort, availableModels, modelListLoading, onModelChange, onEffortChange, availableAgents, selectedAgent, hostedHarness, onAgentChange, imageModelMenu, onForkChat, onConnectProvider, onConnectLocalRuntime, plusMenuMode = "full", providerStatusChecksEnabled = true, loadHistoryRepository, historyReloadKey, externalStreaming = false, externalUserStopped = false, onStop, agentChatSurface = "app", desktopIdentityUnauthenticated = false, desktopIdentityAuthenticated = false, onThreadRestoreNotFound, suppressInlineOpenApp = false, }, ref) {
     const t = useT();
     const thread = useThread();
     const threadRuntime = useThreadRuntime();
@@ -1795,6 +1798,113 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         hasActiveServerRun: hasActiveServerRun || serverRunActive,
         hasTerminalRunError: runErrorInfo !== null,
     });
+    const chatHistoryListQuery = useActionQuery((chatHistory?.list.action ?? "list-resource-versions"), chatHistory?.list.args, { enabled: chatHistory !== undefined });
+    const chatHistoryVersions = useMemo(() => {
+        if (!chatHistory || chatHistoryListQuery.data == null)
+            return [];
+        const versions = chatHistory.list.getVersions(chatHistoryListQuery.data);
+        return Array.isArray(versions)
+            ? versions.filter(isAssistantChatHistoryVersion)
+            : [];
+    }, [chatHistory, chatHistoryListQuery.data]);
+    const chatHistoryRestoreMutation = useActionMutation((chatHistory?.restore.action ?? "restore-resource-version"));
+    const chatHistoryCreateMutation = useActionMutation((chatHistory?.createVersion?.action ?? "create-resource-version"));
+    const refetchChatHistory = chatHistoryListQuery.refetch;
+    const restoreHistory = chatHistoryRestoreMutation.mutateAsync;
+    const createHistoryVersion = chatHistoryCreateMutation.mutateAsync;
+    const restoreChatHistoryVersion = useCallback(async (version) => {
+        if (!chatHistory)
+            return;
+        await restoreHistory(chatHistory.restore.args(version));
+        try {
+            await refetchChatHistory();
+        }
+        catch (error) {
+            captureError(error, {
+                tags: {
+                    source: "agent-chat-client",
+                    phase: "chat-history-refetch-after-restore",
+                },
+            });
+        }
+    }, [chatHistory, refetchChatHistory, restoreHistory]);
+    const chatHistoryContext = useMemo(() => chatHistory
+        ? {
+            findVersion: (message) => findMatchingAssistantChatHistoryVersion(chatHistoryVersions, message, {
+                isEditable: chatHistory.isEditable,
+                scope: chatHistory.scope ?? contextScope ?? undefined,
+                matchVersion: chatHistory.matchVersion,
+            }),
+            restoreVersion: restoreChatHistoryVersion,
+        }
+        : null, [chatHistory, chatHistoryVersions, restoreChatHistoryVersion]);
+    const chatHistoryRunObservedRef = useRef(false);
+    const chatHistoryCreateKeyRef = useRef(null);
+    useEffect(() => {
+        if (!chatHistory) {
+            chatHistoryRunObservedRef.current = false;
+            return;
+        }
+        if (isRunning) {
+            chatHistoryRunObservedRef.current = true;
+            return;
+        }
+        if (!chatHistoryRunObservedRef.current)
+            return;
+        chatHistoryRunObservedRef.current = false;
+        const latestAssistantMessage = [...messages]
+            .reverse()
+            .find((message) => message.role === "assistant");
+        if (!latestAssistantMessage ||
+            !assistantMessageHasCompletedSideEffect(latestAssistantMessage)) {
+            return;
+        }
+        const historyMessage = {
+            id: latestAssistantMessage.id,
+            createdAt: latestAssistantMessage.createdAt,
+            hasCompletedSideEffect: true,
+        };
+        if (chatHistoryCreateKeyRef.current === historyMessage.id) {
+            void refetchChatHistory();
+            return;
+        }
+        chatHistoryCreateKeyRef.current = historyMessage.id;
+        void (async () => {
+            try {
+                if (chatHistory.createVersion) {
+                    const args = typeof chatHistory.createVersion.args === "function"
+                        ? chatHistory.createVersion.args(historyMessage)
+                        : chatHistory.createVersion.args;
+                    await createHistoryVersion(args);
+                }
+            }
+            catch (error) {
+                captureError(error, {
+                    tags: {
+                        source: "agent-chat-client",
+                        phase: "chat-history-create-version",
+                    },
+                });
+            }
+            try {
+                await refetchChatHistory();
+            }
+            catch (error) {
+                captureError(error, {
+                    tags: {
+                        source: "agent-chat-client",
+                        phase: "chat-history-refetch-after-run",
+                    },
+                });
+            }
+        })();
+    }, [
+        chatHistory,
+        createHistoryVersion,
+        isRunning,
+        messages,
+        refetchChatHistory,
+    ]);
     const textStreaming = showRunningInUI || externalStreaming;
     const storedActiveRun = getActiveRun();
     const activeChatRunId = (serverRunState.status === "running" ? serverRunState.runId : null) ??
@@ -3404,7 +3514,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                 model: currentNext.model,
                                 engine: currentNext.engine,
                                 effort: currentNext.effort,
-                            }, currentNext.turnId).runConfig ?? {},
+                            }, currentNext.turnId, currentNext.usageLabel).runConfig ?? {},
                         });
                         applyLocalQueuedMessages((prev) => prev.filter((message) => message.id !== currentNext.id));
                     }
@@ -3427,7 +3537,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                 model: currentNext.model,
                                 engine: currentNext.engine,
                                 effort: currentNext.effort,
-                            }, currentNext.turnId),
+                            }, currentNext.turnId, currentNext.usageLabel),
                         });
                     }
                     appended = true;
@@ -3803,7 +3913,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                     model: message.model,
                     engine: message.engine,
                     effort: message.effort,
-                }, message.turnId),
+                }, message.turnId, message.usageLabel),
                 startRun: false,
             });
         }
@@ -3820,7 +3930,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         applyLocalQueuedMessages((prev) => promoteQueuedMessage(prev, id));
     }, [appendThreadMessage, applyLocalQueuedMessages, threadId, threadRuntime]);
     const visibleQueuedMessages = useMemo(() => queuedMessages.filter((message) => !message.hideUserMessage && !message.promoted), [queuedMessages]);
-    const addToQueue = useCallback(async (text, images, references, attachments, requestMode, intent = "queued", recoveryAction, includeComposerContext = false, trackInRunsTray = false, preserveReconnectAutoRecoveryBudget = false, hideUserMessage = false, submitMessageId, approvedToolCalls, continuationTurnId) => {
+    const addToQueue = useCallback(async (text, images, references, attachments, requestMode, intent = "queued", recoveryAction, includeComposerContext = false, trackInRunsTray = false, preserveReconnectAutoRecoveryBudget = false, hideUserMessage = false, submitMessageId, approvedToolCalls, continuationTurnId, usageLabel) => {
         if (isAgentChatSubmitCancelled(submitMessageId))
             return;
         const stoppedRunAtSubmitStart = userStoppedRunRef.current;
@@ -3969,6 +4079,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                     hideUserMessage,
                     approvedToolCalls,
                     ...(continuationTurnId ? { turnId: continuationTurnId } : {}),
+                    ...(usageLabel ? { usageLabel } : {}),
                     ...modelSnapshot,
                 },
             ]);
@@ -3991,6 +4102,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                     hideUserMessage,
                     approvedToolCalls,
                     ...(continuationTurnId ? { turnId: continuationTurnId } : {}),
+                    ...(usageLabel ? { usageLabel } : {}),
                     ...modelSnapshot,
                 },
             ]);
@@ -4004,7 +4116,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                     ...(messageAttachments.length > 0
                         ? { attachments: messageAttachments }
                         : {}),
-                    ...createUserMessageRunConfig(references, effectiveRequestMode, recoveryAction, trackInRunsTray, approvedToolCalls, undefined, hideUserMessage, undefined, continuationTurnId),
+                    ...createUserMessageRunConfig(references, effectiveRequestMode, recoveryAction, trackInRunsTray, approvedToolCalls, undefined, hideUserMessage, undefined, continuationTurnId, usageLabel),
                 });
             }
             catch (error) {
@@ -4086,7 +4198,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
     // Expose imperative handle
     useImperativeHandle(ref, () => ({
         sendMessage(text, images, options) {
-            void addToQueue(text, images, undefined, options?.attachments, options?.requestMode, "queued", undefined, false, options?.trackInRunsTray === true, false, false, options?.submitMessageId);
+            void addToQueue(text, images, undefined, options?.attachments, options?.requestMode, "queued", undefined, false, options?.trackInRunsTray === true, false, false, options?.submitMessageId, undefined, undefined, options?.usageLabel);
         },
         prefillMessage(text) {
             tiptapRef.current?.setText(text);
@@ -4136,7 +4248,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
             const repo = exportPersistableThreadRepo();
             const { title, preview } = extractThreadMeta(repo);
             return {
-                threadData: JSON.stringify(repo),
+                threadData: JSON.stringify(stripBase64FromRepo(repo)),
                 title,
                 preview,
                 messageCount: messages.length,
@@ -4268,11 +4380,8 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
     const visibleRunErrorKey = visibleRunError
         ? runErrorKey(visibleRunError)
         : null;
-    const shouldShowRunError = !!visibleRunError &&
-        !showRunningInUI &&
-        visibleRunErrorKey !== dismissedRunErrorKey &&
-        !matchesUserStoppedRun(userStoppedRunRef.current, threadId, visibleRunError.runId, visibleRunError.turnId);
     const providerAuthErrorKey = visibleRunError &&
+        !isBuilderReconnectRunError(visibleRunError) &&
         isProviderAuthenticationError([visibleRunError.message, visibleRunError.details]
             .filter(Boolean)
             .join("\n"), visibleRunError.errorCode)
@@ -4280,9 +4389,20 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         : null;
     const showProviderAuthSetup = providerAuthErrorKey !== null &&
         providerAuthErrorKey !== dismissedProviderAuthErrorKey &&
-        !authError &&
-        (showRunningInUI || !shouldShowRunError);
+        !authError;
+    const shouldShowRunError = !!visibleRunError &&
+        !showRunningInUI &&
+        visibleRunErrorKey !== dismissedRunErrorKey &&
+        !showProviderAuthSetup &&
+        !matchesUserStoppedRun(userStoppedRunRef.current, threadId, visibleRunError.runId, visibleRunError.turnId);
     const showMissingKeySetup = (engineSetupRequired || showProviderAuthSetup) && !authError;
+    const handleProviderSetupDismiss = useCallback(() => {
+        if (providerAuthErrorKey === null)
+            return;
+        setDismissedProviderAuthErrorKey(providerAuthErrorKey);
+        setDismissedRunErrorKey(providerAuthErrorKey);
+        setRunErrorInfo(null);
+    }, [providerAuthErrorKey]);
     const handleProviderSetupConnected = useCallback(() => {
         handleBuilderConnected();
         if (providerAuthErrorKey === null)
@@ -4290,7 +4410,8 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         setDismissedProviderAuthErrorKey(providerAuthErrorKey);
         setDismissedRunErrorKey(providerAuthErrorKey);
         setRunErrorInfo(null);
-    }, [handleBuilderConnected, providerAuthErrorKey]);
+        retryAfterRunError();
+    }, [handleBuilderConnected, providerAuthErrorKey, retryAfterRunError]);
     // The banner covers one run; every failed turn it does not cover keeps its own
     // inline marker, so a failure stays visible after the next prompt.
     const messageActionsCtx = useMemo(() => ({
@@ -4460,19 +4581,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                                                                                 return;
                                                                                             }
                                                                                             void addToQueue(suggestion);
-                                                                                        }, className: "w-full px-2 py-1 text-center text-[13px] text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", children: suggestion }, suggestion))) })) : null, showInlineEmptyThreadFooterSlot ? (_jsx("div", { className: "agent-thread-footer-slot agent-thread-footer-slot--empty", children: resolvedThreadFooterSlot })) : null] })) : (_jsxs(MessageScrollerContent, { className: "agent-thread-content gap-4 px-4 py-4", children: [threadRestoreErrorSurface ? (_jsx(MessageScrollerItem, { children: threadRestoreErrorSurface })) : null, _jsx(AssistantMessageListErrorBoundary, { resetKey: messageListResetKey, children: _jsx(UserStoppedRunContext.Provider, { value: wasUserStoppedRun, children: _jsx(ExternalUserStoppedRunContext.Provider, { value: externalUserStopped, children: _jsx(ExternalTextStreamingContext.Provider, { value: externalStreaming, children: _jsx(ThreadPrimitive.Messages
-                                                                                                // Deliberately NOT keyed on part structure. Doing that
-                                                                                                // remounted the whole transcript every time a tool call
-                                                                                                // started or a placeholder id was rewritten — a flash and a
-                                                                                                // lost scroll position in the middle of an answer. The
-                                                                                                // error boundary above is the mechanism for assistant-ui's
-                                                                                                // stale tap-resource errors: it catches them, clears, and
-                                                                                                // retries, and its retry signature includes the reset key so
-                                                                                                // a genuinely new structure always gets a fresh budget.
-                                                                                                // `assistant-ui-part-churn.spec.tsx` drives append, mutate,
-                                                                                                // rename and splice through both the import and streaming
-                                                                                                // paths and records that no such error occurs.
-                                                                                                , { 
+                                                                                        }, className: "w-full px-2 py-1 text-center text-[13px] text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", children: suggestion }, suggestion))) })) : null, showInlineEmptyThreadFooterSlot ? (_jsx("div", { className: "agent-thread-footer-slot agent-thread-footer-slot--empty", children: resolvedThreadFooterSlot })) : null] })) : (_jsxs(MessageScrollerContent, { className: "agent-thread-content gap-4 px-4 py-4", children: [threadRestoreErrorSurface ? (_jsx(MessageScrollerItem, { children: threadRestoreErrorSurface })) : null, _jsx(AssistantMessageListErrorBoundary, { resetKey: messageListResetKey, children: _jsx(UserStoppedRunContext.Provider, { value: wasUserStoppedRun, children: _jsx(ExternalUserStoppedRunContext.Provider, { value: externalUserStopped, children: _jsx(ExternalTextStreamingContext.Provider, { value: externalStreaming, children: _jsx(AssistantChatHistoryContext.Provider, { value: chatHistoryContext, children: _jsx(ThreadPrimitive.Messages
                                                                                                     // Deliberately NOT keyed on part structure. Doing that
                                                                                                     // remounted the whole transcript every time a tool call
                                                                                                     // started or a placeholder id was rewritten — a flash and a
@@ -4484,10 +4593,22 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                                                                                     // `assistant-ui-part-churn.spec.tsx` drives append, mutate,
                                                                                                     // rename and splice through both the import and streaming
                                                                                                     // paths and records that no such error occurs.
-                                                                                                    components: {
-                                                                                                        UserMessage: AssistantChatUserMessageItem,
-                                                                                                        AssistantMessage: AssistantChatAssistantMessageItem,
-                                                                                                    } }) }) }) }) }), visibleLoopLimit && !showRunningInUI && (_jsx(MessageScrollerItem, { children: _jsx(LoopLimitContinueCard, { info: visibleLoopLimit, onContinue: () => {
+                                                                                                    , { 
+                                                                                                        // Deliberately NOT keyed on part structure. Doing that
+                                                                                                        // remounted the whole transcript every time a tool call
+                                                                                                        // started or a placeholder id was rewritten — a flash and a
+                                                                                                        // lost scroll position in the middle of an answer. The
+                                                                                                        // error boundary above is the mechanism for assistant-ui's
+                                                                                                        // stale tap-resource errors: it catches them, clears, and
+                                                                                                        // retries, and its retry signature includes the reset key so
+                                                                                                        // a genuinely new structure always gets a fresh budget.
+                                                                                                        // `assistant-ui-part-churn.spec.tsx` drives append, mutate,
+                                                                                                        // rename and splice through both the import and streaming
+                                                                                                        // paths and records that no such error occurs.
+                                                                                                        components: {
+                                                                                                            UserMessage: AssistantChatUserMessageItem,
+                                                                                                            AssistantMessage: AssistantChatAssistantMessageItem,
+                                                                                                        } }) }) }) }) }) }), visibleLoopLimit && !showRunningInUI && (_jsx(MessageScrollerItem, { children: _jsx(LoopLimitContinueCard, { info: visibleLoopLimit, onContinue: () => {
                                                                                             setShowContinue(false);
                                                                                             setLoopLimitInfo(null);
                                                                                             void addToQueue("Continue from where you left off.", undefined, undefined, undefined, undefined, "queued", "continue");
@@ -4519,7 +4640,11 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                                                 ? { 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": t("agentChat.common.dismissError"), 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 })), showMissingKeySetup ? (_jsx(BuilderSetupCard, { fullWidth: true, attached: true, bouncePulse: missingKeyBouncePulse, layout: missingApiKeySetupLayout, onConnected: handleProviderSetupConnected })) : null, _jsx(AgentComposerFrame, { layoutVariant: composerLayoutVariant, className: cn(composerAreaClassName, showMissingKeySetup &&
+                                                            : undefined, children: [_jsx(SelectionAttachedPill, {}), showPlanModeCallout && (_jsx(PlanModeCallout, { canImplementPlan: canImplementPlan, onImplementPlan: handleImplementPlan, onSwitchToAct: handleSwitchToAct })), showMissingKeySetup ? (_jsx(BuilderSetupCard, { fullWidth: true, attached: true, bouncePulse: missingKeyBouncePulse, layout: missingApiKeySetupLayout, onDismiss: providerAuthErrorKey !== null
+                                                                    ? handleProviderSetupDismiss
+                                                                    : undefined, onConnected: handleProviderSetupConnected, onRetry: providerAuthErrorKey !== null
+                                                                    ? retryAfterRunError
+                                                                    : undefined }, providerAuthErrorKey ?? "missing-provider")) : null, _jsx(AgentComposerFrame, { layoutVariant: composerLayoutVariant, className: cn(composerAreaClassName, showMissingKeySetup &&
                                                                     "agent-composer-area--attached-above", isComposerDisabled &&
                                                                     !showMissingKeySetup &&
                                                                     "opacity-70"), onClick: showMissingKeySetup

package/dist/client/ConnectBuilderCard.js

@@ -7,6 +7,7 @@ import { BuilderBMark } from "./builder-mark.js";
 import { writeClipboardText } from "./clipboard.js";
 import { requestDesktopLocalCodeChange } from "./desktop-local-code-change.js";
 import { getCallbackOrigin } from "./frame.js";
+import { BuilderConnectPopover } from "./settings/BuilderConnectPopover.js";
 import { useBuilderConnectFlow } from "./settings/useBuilderStatus.js";
 import { cn } from "./utils.js";
 const DESKTOP_DOWNLOAD_URL = "https://www.agent-native.com/download";
@@ -36,6 +37,7 @@ export function ConnectBuilderCard({ configured: initialConfigured, builderEnabl
     // is what catches a flow the user completed in another tab.
     const flow = useBuilderConnectFlow({
         popupUrl: initialConnectUrl,
+        provisionAccount: true,
         trackingSource: "connect_builder_card",
     });
     // Keep the server-rendered handoff state until a successful status response
@@ -243,5 +245,5 @@ export function ConnectBuilderCard({ configured: initialConfigured, builderEnabl
                                                 ? "Preparing locally…"
                                                 : "Do locally"] })), _jsx("button", { type: "button", onClick: handleJoinWaitlist, disabled: joiningWaitlist, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", joiningWaitlist && "opacity-70 cursor-wait"), children: joiningWaitlist ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Joining\u2026"] })) : (_jsx(_Fragment, { children: "Join the waitlist" })) })] })) : !configured ? (_jsxs("div", { className: "flex flex-wrap gap-2", children: [showDesktopLocalHandoff && (_jsxs("button", { type: "button", "data-desktop-local-code-change": true, onClick: handleDoLocally, disabled: localCodeChangeRequested, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90", localCodeChangeRequested && "cursor-wait opacity-70"), children: [localCodeChangeRequested ? (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(IconCode, { className: "h-3.5 w-3.5" })), localCodeChangeRequested
                                                 ? "Preparing locally…"
-                                                : "Do locally"] })), _jsx("button", { type: "button", onClick: () => flow.start(), disabled: connecting, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", connecting && "opacity-70 cursor-wait"), children: connecting ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Waiting for Builder\u2026"] })) : ("Connect Builder") })] })) : showDesktopLocalHandoff ? (_jsxs("button", { type: "button", "data-desktop-local-code-change": true, onClick: handleDoLocally, disabled: localCodeChangeRequested, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", localCodeChangeRequested && "cursor-wait opacity-70"), children: [localCodeChangeRequested ? (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(IconCode, { className: "h-3.5 w-3.5" })), localCodeChangeRequested ? "Preparing locally…" : "Do locally"] })) : null })] })] }) }));
+                                                : "Do locally"] })), _jsx(BuilderConnectPopover, { flow: flow, children: _jsx("button", { type: "button", disabled: connecting, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", connecting && "opacity-70 cursor-wait"), children: connecting ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Waiting for Builder\u2026"] })) : ("Connect Builder") }) })] })) : showDesktopLocalHandoff ? (_jsxs("button", { type: "button", "data-desktop-local-code-change": true, onClick: handleDoLocally, disabled: localCodeChangeRequested, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", localCodeChangeRequested && "cursor-wait opacity-70"), children: [localCodeChangeRequested ? (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(IconCode, { className: "h-3.5 w-3.5" })), localCodeChangeRequested ? "Preparing locally…" : "Do locally"] })) : null })] })] }) }));
 }

package/dist/client/DefaultSpinner.d.ts

@@ -1,3 +1,15 @@
-export declare function DefaultSpinner({ ariaLabel, }: {
+import { type CSSProperties } from "react";
+declare global {
+    interface Window {
+        __agentNativeLoadingLabelIndex?: number;
+    }
+}
+/**
+ * Full-screen loading spinner rendered during SSR and initial hydration.
+ * Uses inline layout because Tailwind may not be loaded yet on the server.
+ * Respects the user's OS color scheme so dark-mode users don't get a white flash.
+ */
+export declare function DefaultSpinner({ ariaLabel, height, }: {
     ariaLabel?: string;
+    height?: CSSProperties["height"];
 }): import("react").JSX.Element;

package/dist/client/DefaultSpinner.js

@@ -1,62 +1,68 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
+import { CubeLoader } from "@agent-native/toolkit/ui/cube-loader";
+import { useEffect, useLayoutEffect, useRef, useState, } from "react";
+import { LOADING_LABELS } from "../shared/loading-labels.js";
+const LOADING_LABEL_INTERVAL_MS = 3_000;
+const LOADING_SHIMMER_DURATION_MS = 2_600;
+const useBrowserLayoutEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
+function getInitialLoadingLabelIndex() {
+    if (typeof window === "undefined")
+        return 0;
+    const index = window.__agentNativeLoadingLabelIndex;
+    return typeof index === "number" &&
+        Number.isInteger(index) &&
+        index >= 0 &&
+        index < LOADING_LABELS.length
+        ? index
+        : 0;
+}
+function getRandomLoadingLabelIndex() {
+    return Math.floor(Math.random() * LOADING_LABELS.length);
+}
 /**
  * Full-screen loading spinner rendered during SSR and initial hydration.
- * Uses inline SVG + styles because Tailwind may not be loaded yet on the server.
+ * Uses inline layout because Tailwind may not be loaded yet on the server.
  * Respects the user's OS color scheme so dark-mode users don't get a white flash.
- *
- * In development builds, the stall hint is revealed by a pure-CSS
- * `animation-delay`, never a timer:
- * the states that strand a user here (hydration never runs, the route module
- * 404s, a cold dev-server compile) are exactly the states where no JS of ours
- * executes, so a `setTimeout` fallback would never fire. A featureless spinner
- * is indistinguishable from a blank screen, and reads as "the app is broken"
- * rather than "look at the terminal" — that mis-read is what this text buys.
  */
-function isDevelopmentBuild() {
-    if (typeof process !== "undefined" &&
-        process.env?.NODE_ENV === "production") {
-        return false;
-    }
-    const viteEnv = import.meta.env;
-    if (viteEnv?.PROD === true)
-        return false;
-    return viteEnv?.DEV === true;
-}
-export function DefaultSpinner({ ariaLabel = "Loading", }) {
-    const [showStallHint, setShowStallHint] = useState(false);
+export function DefaultSpinner({ ariaLabel = "Loading", height = "100vh", }) {
+    const [loadingLabelIndex, setLoadingLabelIndex] = useState(getInitialLoadingLabelIndex);
+    const loadingLabelRef = useRef(null);
+    useBrowserLayoutEffect(() => {
+        const loadingLabel = loadingLabelRef.current;
+        if (!loadingLabel)
+            return;
+        const width = loadingLabel.scrollWidth;
+        if (width > 0) {
+            loadingLabel.style.width = `${width}px`;
+        }
+        loadingLabel.style.animationDelay = `-${window.performance.now() % LOADING_SHIMMER_DURATION_MS}ms`;
+    }, [loadingLabelIndex]);
     useEffect(() => {
-        setShowStallHint(isDevelopmentBuild());
+        if (typeof window !== "undefined" &&
+            window.__agentNativeLoadingLabelIndex === undefined) {
+            setLoadingLabelIndex(getRandomLoadingLabelIndex());
+        }
+        if (typeof window !== "undefined") {
+            delete window.__agentNativeLoadingLabelIndex;
+        }
+        const interval = window.setInterval(() => {
+            setLoadingLabelIndex((index) => (index + 1) % LOADING_LABELS.length);
+        }, LOADING_LABEL_INTERVAL_MS);
+        return () => window.clearInterval(interval);
     }, []);
     return (_jsxs("div", { style: {
             display: "flex",
             flexDirection: "column",
             alignItems: "center",
             justifyContent: "center",
-            gap: 16,
-            height: "100vh",
+            height,
             width: "100%",
-        }, children: [_jsx("svg", { role: "status", "aria-label": ariaLabel, width: 24, height: 24, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", style: { animation: "an-spin 1s linear infinite", opacity: 0.7 }, children: _jsx("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) }), showStallHint && (_jsx("p", { className: "an-stall-hint", children: "Still loading. A first run compiles dependencies and can take a minute \u2014 if it does not finish, check the terminal running the dev server for errors." })), _jsx("style", { children: `
-        @keyframes an-spin { to { transform: rotate(360deg) } }
-        ${showStallHint
-                    ? `
-        @keyframes an-stall-in { to { opacity: 0.6 } }
-        .an-stall-hint {
-          opacity: 0;
-          margin: 0;
-          max-width: 32rem;
-          padding: 0 1.5rem;
-          text-align: center;
-          font-size: 0.875rem;
-          line-height: 1.5;
-          font-family: ui-sans-serif, system-ui, sans-serif;
-          animation: an-stall-in 0.4s ease-out 10s forwards;
-        }
-        @media (prefers-reduced-motion: reduce) {
-          .an-stall-hint { animation-duration: 0s }
-        }
-        `
-                    : ""}
+        }, children: [_jsxs("div", { style: { display: "flex", alignItems: "center", gap: 12 }, children: [_jsx(CubeLoader, { "aria-label": ariaLabel, className: "size-6" }), _jsx("span", { ref: loadingLabelRef, "data-agent-native-loading-label": "true", className: "agent-running-shimmer agent-loading-label", style: {
+                            fontFamily: "ui-sans-serif, system-ui, sans-serif",
+                            fontSize: 16,
+                            fontWeight: 500,
+                            opacity: 0.65,
+                        }, children: LOADING_LABELS[loadingLabelIndex] })] }), _jsx("style", { children: `
         html {
           background: hsl(var(--background, 0 0% 100%));
           color: hsl(var(--foreground, 240 10% 3.9%));

package/dist/client/FeedbackButton.d.ts

@@ -1,4 +1,16 @@
 import { type ReactNode } from "react";
+export interface SubmitFeedbackFormOptions {
+    value: string;
+    url?: string | null;
+    openedAt?: number;
+    idempotencyKey?: string | null;
+    honeypot?: string;
+    submitterEmail?: string | null;
+    chatSessionId?: string | null;
+    chatStorageKey?: string | null;
+    activeRunId?: string | null;
+}
+export declare function submitFeedbackForm(options: SubmitFeedbackFormOptions): Promise<"submitted" | "unconfigured">;
 export interface FeedbackButtonProps {
     /**
      * "sidebar" renders a full-width row with icon + label (for app left sidebars).