@agent-native/core 0.193.0 → 0.193.1-nightly-20260926224948

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 10195
+- template files: 10202

package/corpus/templates/assets/changelog/2026-09-26-builder-is-the-primary-first-run-setup.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-26
+---
+
+New users can continue with Builder, choose their own API keys, or skip setup and start using Assets.

package/corpus/templates/chat/app/components/chat/ChatRouteContent.tsx

@@ -3,6 +3,8 @@ import type {
   AgentMessage,
 } from "@agent-native/agentkit";
 import {
+  AgentMessageView,
+  AgentRunFailure,
   AgentConnectionRequestCard,
   AgentKitChat,
 } from "@agent-native/agentkit/react/components";
@@ -10,9 +12,14 @@ import {
   useAgentKit,
   useAgentKitControl,
   useAgentThread,
+  type AgentRunFailureRenderProps,
   type AgentKitRenderProps,
 } from "@agent-native/agentkit/react/context";
 import { AgentKitRoot } from "@agent-native/agentkit/react/root";
+import {
+  BuilderSetupCard,
+  isMissingLlmProviderRunError,
+} from "@agent-native/core/client/agent-chat";
 import { CoreComposerRuntimeProvider } from "@agent-native/core/client/agentkit-chat/composer";
 import {
   McpAgentKitConnectionRequestCard,
@@ -120,7 +127,9 @@ function ChatThreadRouteContent({
             labels={{ composerPlaceholder: t("chat.composerPlaceholder") }}
             slots={{
               emptyState: ChatEmptyState,
+              message: ChatMessage,
               messageSupplement: ChatMcpConnectionSuggestion,
+              runFailure: ChatRunFailure,
               connectionRequest: ChatMcpConnectionRequest,
               footer: ChatAgentFooter,
             }}
@@ -153,6 +162,90 @@ function ChatThreadRouteContent({
   );
 }
 
+function ChatMessage({ value, threadId }: AgentKitRenderProps<AgentMessage>) {
+  const metadata = value.metadata as
+    | { custom?: { agentNativeRecoveryAction?: unknown } }
+    | undefined;
+  const recoveryAction = metadata?.custom?.agentNativeRecoveryAction;
+  if (
+    value.role === "user" &&
+    (recoveryAction === "continue" || recoveryAction === "retry")
+  ) {
+    return null;
+  }
+  return <AgentMessageView value={value} threadId={threadId} />;
+}
+
+function ChatRunFailure({
+  error,
+  runId,
+  threadId,
+}: AgentRunFailureRenderProps) {
+  const thread = useAgentThread(threadId);
+  const { controller } = useAgentKit();
+  const t = useT();
+  const recoveryMetadata = (message: (typeof thread.messages)[number]) =>
+    (
+      message.metadata as
+        | {
+            custom?: {
+              agentNativeRecoveryAction?: unknown;
+              agentNativeRecoveryOfRunId?: unknown;
+            };
+          }
+        | undefined
+    )?.custom;
+  const userRequests = thread.messages.filter((message) => {
+    if (message.role !== "user") return false;
+    const action = recoveryMetadata(message)?.agentNativeRecoveryAction;
+    return action !== "continue" && action !== "retry";
+  });
+  const originalRequest = userRequests[0];
+  const hasRetryForThisRun = thread.messages.some(
+    (message) =>
+      recoveryMetadata(message)?.agentNativeRecoveryAction === "retry" &&
+      recoveryMetadata(message)?.agentNativeRecoveryOfRunId === runId,
+  );
+  const retryFirstMessage = useCallback(() => {
+    const prompt =
+      originalRequest?.parts
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("\n") ?? "";
+    const attachments =
+      originalRequest?.parts.filter((part) => part.type === "file") ?? [];
+    void controller.sendMessage({
+      threadId,
+      text: prompt || t("chat.retryPreviousRequest"),
+      ...(attachments.length ? { attachments } : {}),
+      metadata: {
+        custom: {
+          agentNativeRecoveryAction: "retry",
+          agentNativeRecoveryOfRunId: runId,
+        },
+      },
+    });
+  }, [controller, originalRequest, runId, t, threadId]);
+  const isFirstMessage = userRequests.length === 1 && !hasRetryForThisRun;
+  if (
+    isFirstMessage &&
+    isMissingLlmProviderRunError({
+      message: error.message,
+      details: typeof error.details === "string" ? error.details : undefined,
+      errorCode: error.code,
+    })
+  ) {
+    return (
+      <BuilderSetupCard
+        fullWidth
+        layout="sidebar"
+        onRetry={retryFirstMessage}
+      />
+    );
+  }
+  return <AgentRunFailure error={error} runId={runId} threadId={threadId} />;
+}
+
 function ChatLifecycleTracking({ threadId }: { threadId: string }) {
   const thread = useAgentThread(threadId);
   const lifecycleRef = useRef({

package/corpus/templates/chat/app/i18n/en-US.ts

@@ -33,6 +33,8 @@ const messages = {
     pinChat: "Pin Chat",
     pinned: "Pinned",
     recents: "Recents",
+    retryPreviousRequest:
+      "Retry my previous request now that the model provider is connected.",
     renameChat: "Rename Chat",
     renameFailed: "Rename Failed",
     renameThread: "Rename Thread",

package/corpus/templates/chat/changelog/2026-09-26-builder-setup-retry.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-09-26
+---
+
+Chat can connect Builder when model credentials are missing and retry the original request with its files.

package/corpus/templates/clips/changelog/2026-09-26-builder-is-the-primary-first-run-setup.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-26
+---
+
+New users can continue with Builder, choose their own API keys, or skip setup and start using Clips.

package/corpus/templates/content/app/hooks/use-content-recent.ts

@@ -11,9 +11,51 @@ import {
   type ContentRecentTarget,
 } from "@shared/content-personal-navigation";
 import { useQueryClient } from "@tanstack/react-query";
-import { useCallback, useEffect, useRef } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { toast } from "sonner";
 
+const contentRecentRecoveries = new WeakMap<
+  ReturnType<typeof useQueryClient>,
+  Map<string, Promise<void>>
+>();
+
+function recoverContentRecentScope(
+  queryClient: ReturnType<typeof useQueryClient>,
+  scopeKey: string,
+  refresh: () => Promise<void>,
+) {
+  let recoveries = contentRecentRecoveries.get(queryClient);
+  if (!recoveries) {
+    recoveries = new Map();
+    contentRecentRecoveries.set(queryClient, recoveries);
+  }
+  const recovery = recoveries.get(scopeKey);
+  if (recovery) return recovery;
+
+  let nextRecovery: Promise<void>;
+  nextRecovery = Promise.resolve()
+    .then(refresh)
+    .finally(() => {
+      if (recoveries.get(scopeKey) === nextRecovery) {
+        recoveries.delete(scopeKey);
+      }
+    });
+  recoveries.set(scopeKey, nextRecovery);
+  return nextRecovery;
+}
+
+function contentRecentScopeKey(
+  org: ReturnType<typeof useOrg>["data"],
+  spaceId?: string,
+) {
+  if (!org) return undefined;
+  return JSON.stringify([
+    org.email.trim().toLowerCase(),
+    org.orgId ?? null,
+    spaceId ?? null,
+  ]);
+}
+
 export function contentRecentQueryArgs(
   scopeKey: string | undefined,
   spaceId?: string,
@@ -22,31 +64,110 @@ export function contentRecentQueryArgs(
   return { scopeKey, ...(spaceId ? { spaceId } : {}) };
 }
 
+export function isContentRecentContextChanged(error: unknown): boolean {
+  return (
+    !!error &&
+    typeof error === "object" &&
+    (error as { errorCode?: unknown }).errorCode === "context_changed"
+  );
+}
+
 export function useContentRecent(spaceId?: string) {
   const org = useOrg();
-  const scopeKey = org.data
-    ? JSON.stringify([
-        org.data.email.trim().toLowerCase(),
-        org.data.orgId ?? null,
-        spaceId ?? null,
-      ])
-    : undefined;
-  const query = useActionQuery(
-    "get-content-recent",
-    contentRecentQueryArgs(scopeKey, spaceId),
-    {
-      enabled: Boolean(scopeKey) && !org.isFetching,
-      placeholderData: undefined,
+  const queryClient = useQueryClient();
+  const scopeKey = contentRecentScopeKey(org.data, spaceId);
+  const args = useMemo(
+    () => contentRecentQueryArgs(scopeKey, spaceId),
+    [scopeKey, spaceId],
+  );
+  const query = useActionQuery("get-content-recent", args, {
+    enabled: Boolean(scopeKey) && !org.isFetching,
+    placeholderData: undefined,
+  });
+  const [refreshingScopes, setRefreshingScopes] = useState<Set<string>>(
+    () => new Set(),
+  );
+  const resyncedScopesRef = useRef(new Set<string>());
+  const contextChanged = isContentRecentContextChanged(query.error);
+
+  useEffect(() => {
+    if (!contextChanged) {
+      if (scopeKey) {
+        resyncedScopesRef.current.delete(scopeKey);
+      }
+      return;
+    }
+    if (!scopeKey) return;
+    if (resyncedScopesRef.current.has(scopeKey)) return;
+
+    resyncedScopesRef.current.add(scopeKey);
+    setRefreshingScopes((current) => new Set(current).add(scopeKey));
+    void recoverContentRecentScope(queryClient, scopeKey, async () => {
+      try {
+        const refreshedOrg = await org.refetch({ cancelRefetch: false });
+        if (refreshedOrg.isError) return;
+        const refreshedArgs = contentRecentQueryArgs(
+          contentRecentScopeKey(refreshedOrg.data, spaceId),
+          spaceId,
+        );
+        if (!refreshedArgs) return;
+        await queryClient.invalidateQueries(
+          {
+            queryKey: ["action", "get-content-recent", refreshedArgs],
+            exact: true,
+          },
+          { cancelRefetch: false },
+        );
+      } catch (error) {
+        console.warn(
+          "Could not refresh the Content Recent context after a scope mismatch.",
+          error,
+        );
+      }
+    }).finally(() => {
+      setRefreshingScopes((current) => {
+        if (!current.has(scopeKey)) return current;
+        const next = new Set(current);
+        next.delete(scopeKey);
+        return next;
+      });
+    });
+  }, [
+    contextChanged,
+    org.refetch,
+    query.error,
+    query.isError,
+    queryClient,
+    scopeKey,
+    spaceId,
+  ]);
+
+  const refetch = useCallback(
+    (...args: Parameters<typeof query.refetch>) => {
+      if (contextChanged && scopeKey) {
+        resyncedScopesRef.current.delete(scopeKey);
+        contentRecentRecoveries.get(queryClient)?.delete(scopeKey);
+      }
+      return query.refetch(...args);
     },
+    [contextChanged, query.refetch, scopeKey],
   );
+
+  const recoveringContext =
+    contextChanged &&
+    (!scopeKey ||
+      refreshingScopes.has(scopeKey) ||
+      !resyncedScopesRef.current.has(scopeKey));
   return {
     ...query,
+    refetch,
     data:
       !org.isFetching && query.data?.scopeKey === scopeKey
         ? query.data
         : undefined,
-    isLoading: org.isLoading || org.isFetching || query.isLoading,
-    isError: org.isError || query.isError,
+    isLoading:
+      org.isLoading || org.isFetching || query.isLoading || recoveringContext,
+    isError: org.isError || (query.isError && !recoveringContext),
   };
 }
 

package/corpus/templates/content/changelog/2026-09-26-empty-recent-list.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-26
+---
+
+An empty Recent list now loads without an error after first run.

package/corpus/templates/design/changelog/2026-09-26-builder-is-the-primary-first-run-setup.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-26
+---
+
+New users can continue with Builder, choose their own API keys, or skip setup and start using Design.

package/corpus/templates/mail/app/components/layout/AppLayout.tsx

@@ -16,6 +16,7 @@ import {
   AppSidebarHeader,
   EnvironmentBadge,
   FeedbackButton,
+  RouterSidebarLink,
 } from "@agent-native/core/client/ui";
 import { SidebarFooterActions } from "@agent-native/toolkit/app-shell";
 import {
@@ -1458,7 +1459,7 @@ function AppLayoutInner({ children }: AppLayoutProps) {
                     dropIndicator?.tabIndex === tabIndex &&
                     dropIndicator.side === "right";
                   const link = (
-                    <Link
+                    <RouterSidebarLink
                       to={tab.href}
                       aria-current={tab.isActive ? "page" : undefined}
                       draggable={canDrag}
@@ -1492,7 +1493,7 @@ function AppLayoutInner({ children }: AppLayoutProps) {
                           {count}
                         </span>
                       )}
-                    </Link>
+                    </RouterSidebarLink>
                   );
                   return (
                     <div
@@ -1900,7 +1901,7 @@ function AppLayoutInner({ children }: AppLayoutProps) {
                     return (
                       <Tooltip key={item.id}>
                         <TooltipTrigger asChild>
-                          <Link
+                          <RouterSidebarLink
                             to={item.href}
                             aria-label={item.label}
                             className={cn(
@@ -1913,7 +1914,7 @@ function AppLayoutInner({ children }: AppLayoutProps) {
                             {item.count && item.count > 0 ? (
                               <span className="absolute end-1 top-1 h-1.5 w-1.5 rounded-full bg-primary" />
                             ) : null}
-                          </Link>
+                          </RouterSidebarLink>
                         </TooltipTrigger>
                         <TooltipContent side="right">
                           {item.label}
@@ -2134,14 +2135,14 @@ function AppLayoutInner({ children }: AppLayoutProps) {
                         <DevDatabaseLink />
                         <Tooltip>
                           <TooltipTrigger asChild>
-                            <Link
+                            <RouterSidebarLink
                               to="/settings"
                               onClick={closeSidebar}
                               aria-label={t("mail.toolbar.settings")}
                               className="flex size-9 shrink-0 items-center justify-center rounded-md text-primary hover:bg-accent/60 hover:text-primary"
                             >
                               <IconSettings className="size-4" />
-                            </Link>
+                            </RouterSidebarLink>
                           </TooltipTrigger>
                           <TooltipContent side="right">
                             {t("mail.toolbar.settings")}
@@ -2625,14 +2626,14 @@ function StandardLayout({ children }: AppLayoutProps) {
               <DevDatabaseLink />
               <Tooltip>
                 <TooltipTrigger asChild>
-                  <Link
+                  <RouterSidebarLink
                     to="/settings"
                     onClick={() => setSidebarOpen(false)}
                     aria-label={t("mail.toolbar.settings")}
                     className="flex size-9 shrink-0 items-center justify-center rounded-md text-primary hover:bg-accent/60 hover:text-primary"
                   >
                     <IconSettings className="size-4" />
-                  </Link>
+                  </RouterSidebarLink>
                 </TooltipTrigger>
                 <TooltipContent side="right">
                   {t("mail.toolbar.settings")}

package/corpus/templates/mail/app/components/layout/HeaderActions.tsx

@@ -51,7 +51,7 @@ export function useSetPageTitle(node: ReactNode) {
       currentTitle = null;
       notify();
     };
-  });
+  }, [node]);
 }
 
 export function useSetHeaderActions(node: ReactNode) {
@@ -70,5 +70,5 @@ export function useSetHeaderActions(node: ReactNode) {
         notify();
       }
     };
-  });
+  }, [node]);
 }

package/corpus/templates/mail/changelog/2026-09-26-fixed-an-inbox-crash-when-the-sidebar-is-pinned.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-26
+---
+
+Fixed an inbox crash when the sidebar is pinned

package/corpus/templates/slides/changelog/2026-09-26-builder-is-the-primary-first-run-setup.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-26
+---
+
+New users can continue with Builder, choose their own API keys, or skip setup and start using Slides.

package/dist/automation/index.d.ts

@@ -186,8 +186,8 @@ export declare function createAutomationCallbackHandler(runtime: AutomationRunti
     duplicate?: undefined;
     eventId?: undefined;
 } | {
-    error?: undefined;
     accepted: boolean;
     duplicate: boolean;
     eventId: string;
+    error?: undefined;
 }>;

package/dist/client/AgentPanel.js

@@ -40,7 +40,7 @@ const loadMultiTabAssistantChat = () => import("./MultiTabAssistantChat.js").the
     default: m.MultiTabAssistantChat,
 }));
 const MultiTabAssistantChatLazy = lazy(loadMultiTabAssistantChat);
-import { Link, useLocation, useNavigate } from "react-router";
+import { useLocation, useNavigate } from "react-router";
 import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import { AGENT_PANEL_OPEN_SETTINGS_EVENT, AGENT_PANEL_SET_MODE_EVENT, } from "./agent-sidebar-events.js";
 export { shouldHandleAgentPanelChatShortcut, shouldHandleAgentSidebarToggle, } from "./agent-sidebar-events.js";
@@ -59,6 +59,7 @@ import { useFirstRunOnboardingGateOwnsSurface } from "./onboarding/first-run-sta
 import { useOnboardingPreviewMode } from "./onboarding/use-preview-mode.js";
 import { recoverFromStaleChunkError } from "./route-chunk-recovery.js";
 import { withBuilderConnectTrackingParams } from "./settings/useBuilderStatus.js";
+import { RouterSidebarLink } from "./ui/AppSidebar.js";
 import { useDevMode } from "./use-dev-mode.js";
 import { cn } from "./utils.js";
 function parentFrameTargetOrigin() {
@@ -786,7 +787,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                             // A sibling overlay owns focus next; restoring it to the menu
                             // trigger would dismiss that overlay as an outside interaction.
                             consumeAgentPanelOverlayFocusRestore(preventHeaderMenuFocusRestoreRef, event);
-                        }, children: [onCollapse && (_jsxs(_Fragment, { children: [_jsxs(DropdownMenuItem, { onSelect: onCollapse, children: [_jsx(IconLayoutSidebarRightCollapse, { size: 14, className: "shrink-0" }), t("agentPanel.collapseSidebar"), _jsx(DropdownMenuShortcut, { children: toggleSidebarHint })] }), _jsx(DropdownMenuSeparator, {})] })), onCollapse && mode === "chat" && wideDrawerAction ? (_jsxs(DropdownMenuItem, { onSelect: wideDrawerAction, children: [_jsx(IconArrowsHorizontal, { size: 14, className: "shrink-0" }), wideDrawerLabel, _jsx(DropdownMenuShortcut, { children: widenChatHint })] })) : null, fullViewAction?.kind === "callback" && onFullViewRequest ? (_jsxs(DropdownMenuItem, { onSelect: onFullViewRequest, "aria-label": t("agentPanel.openFullView"), children: [_jsx(IconArrowsMaximize, { size: 14, className: "shrink-0" }), t("agentPanel.openFullView")] })) : fullViewAction?.kind === "link" ? (_jsx(DropdownMenuItem, { asChild: true, children: _jsxs(Link, { to: fullViewAction.href, "aria-label": t("agentPanel.openFullView"), children: [_jsx(IconArrowsMaximize, { size: 14, className: "shrink-0" }), t("agentPanel.openFullView")] }) })) : null, (onCollapse && mode === "chat" && wideDrawerAction) ||
+                        }, children: [onCollapse && (_jsxs(_Fragment, { children: [_jsxs(DropdownMenuItem, { onSelect: onCollapse, children: [_jsx(IconLayoutSidebarRightCollapse, { size: 14, className: "shrink-0" }), t("agentPanel.collapseSidebar"), _jsx(DropdownMenuShortcut, { children: toggleSidebarHint })] }), _jsx(DropdownMenuSeparator, {})] })), onCollapse && mode === "chat" && wideDrawerAction ? (_jsxs(DropdownMenuItem, { onSelect: wideDrawerAction, children: [_jsx(IconArrowsHorizontal, { size: 14, className: "shrink-0" }), wideDrawerLabel, _jsx(DropdownMenuShortcut, { children: widenChatHint })] })) : null, fullViewAction?.kind === "callback" && onFullViewRequest ? (_jsxs(DropdownMenuItem, { onSelect: onFullViewRequest, "aria-label": t("agentPanel.openFullView"), children: [_jsx(IconArrowsMaximize, { size: 14, className: "shrink-0" }), t("agentPanel.openFullView")] })) : fullViewAction?.kind === "link" ? (_jsx(DropdownMenuItem, { asChild: true, children: _jsxs(RouterSidebarLink, { to: fullViewAction.href, "aria-label": t("agentPanel.openFullView"), children: [_jsx(IconArrowsMaximize, { size: 14, className: "shrink-0" }), t("agentPanel.openFullView")] }) })) : null, (onCollapse && mode === "chat" && wideDrawerAction) ||
                                 fullViewAction ? (_jsx(DropdownMenuSeparator, {})) : null, onCollapse &&
                                 (newTabMode === "cli" || (mode === "cli" && renderCliTab)) && (_jsxs(_Fragment, { children: [_jsxs(DropdownMenuItem, { onSelect: () => openNewUiTab(addTab), children: [_jsx(IconPlus, { size: 14, className: "shrink-0" }), newUiTabLabel ?? t("agentPanel.newChat")] }), _jsxs(DropdownMenuItem, { onSelect: openNewCliTab, children: [_jsx(IconTerminal2, { size: 14, className: "shrink-0" }), newCliTabLabel ?? t("agentPanel.newTerminal")] }), mode === "chat" ? _jsx(DropdownMenuSeparator, {}) : null] })), onCollapse && mode === "chat" && newTabMode !== "cli" && (_jsxs(DropdownMenuItem, { onSelect: () => openNewUiTab(addTab), children: [_jsx(IconPlus, { size: 14, className: "shrink-0" }), newUiTabLabel ?? t("agentPanel.newChat")] })), onCollapse &&
                                 mode === "chat" &&

package/dist/client/agent-chat/index.d.ts

@@ -18,7 +18,7 @@ export { CodeRequiredDialog, type CodeRequiredDialogProps, } from "../components
 export { ChatFirstAgentActivityPanel, type ChatFirstAgentActivityPanelProps, } from "../chat-first-agent-activity.js";
 export { ChatFirstSurfacePanelToggle } from "../chat-first-surface-panel-toggle.js";
 export { useAgentEngineConfigured, type AgentEngineConfiguredState, type UseAgentEngineConfiguredResult, } from "../use-agent-engine-configured.js";
-export { BuilderSetupCard } from "../chat/run-recovery.js";
+export { BuilderSetupCard, isMissingLlmProviderRunError, type RunErrorInfo, } from "../chat/run-recovery.js";
 export { AgentConversation, AgentConversationMessageView, normalizeCodeAgentTranscriptForConversation, useNearBottomAutoscroll, type CodeAgentConversationTranscriptEvent, type CodeAgentConversationTranscriptEventType, type NormalizeCodeAgentTranscriptOptions, type AgentConversationArtifact, type AgentConversationAttachment, type AgentConversationMessage, type AgentConversationMessagePart, type AgentConversationMessageRole, type AgentConversationNotice, type AgentConversationNoticeTone, type AgentConversationToolCall, type AgentConversationToolState, } from "../conversation/index.js";
 export { McpAppRenderer } from "../mcp-apps/McpAppRenderer.js";
 export { AGENT_NATIVE_MCP_APP_HOST_MESSAGE_TYPES, getMcpAppHostContext, initializeMcpAppHost, openMcpAppHostLink, requestMcpAppDisplayMode, sendMcpAppHostMessage, updateMcpAppModelContext, useMcpAppHostContext, type AgentNativeMcpAppHostMessageType, type McpAppDisplayMode, type McpAppHostChatMessage, type McpAppHostCapabilities, type McpAppHostContext, type McpAppHostInfo, type McpAppHostContextSnapshot, type McpAppModelContextContentPart, type McpAppModelContextUpdate, } from "../mcp-app-host.js";

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

@@ -18,7 +18,7 @@ export { CodeRequiredDialog, } from "../components/CodeRequiredDialog.js";
 export { ChatFirstAgentActivityPanel, } from "../chat-first-agent-activity.js";
 export { ChatFirstSurfacePanelToggle } from "../chat-first-surface-panel-toggle.js";
 export { useAgentEngineConfigured, } from "../use-agent-engine-configured.js";
-export { BuilderSetupCard } from "../chat/run-recovery.js";
+export { BuilderSetupCard, isMissingLlmProviderRunError, } from "../chat/run-recovery.js";
 export { AgentConversation, AgentConversationMessageView, normalizeCodeAgentTranscriptForConversation, useNearBottomAutoscroll, } from "../conversation/index.js";
 export { McpAppRenderer } from "../mcp-apps/McpAppRenderer.js";
 export { AGENT_NATIVE_MCP_APP_HOST_MESSAGE_TYPES, getMcpAppHostContext, initializeMcpAppHost, openMcpAppHostLink, requestMcpAppDisplayMode, sendMcpAppHostMessage, updateMcpAppModelContext, useMcpAppHostContext, } from "../mcp-app-host.js";

package/dist/client/chat/agentkit-protocol.js

@@ -1852,12 +1852,29 @@ export function createAgentKitProtocolAdapter(runtime, options = {}) {
             if (input.resume !== undefined) {
                 throw new AgentProtocolValidationError("startRun.resume", "Core requires approval continuations to use resumeRun");
             }
-            const turnMetadata = mergeTrustedProtocolMetadata(options.metadata, input.metadata, input.options?.metadata, input.options?.agentId ? { agentId: input.options.agentId } : undefined, input.options?.locale ? { locale: input.options.locale } : undefined, input.options?.mode ? { mode: input.options.mode } : undefined);
+            const latestUserMessage = [...input.messages]
+                .reverse()
+                .find((message) => message.role === "user");
+            const latestUserMetadata = asRecord(latestUserMessage?.metadata);
+            const recoveryMetadata = asRecord(latestUserMetadata?.custom);
+            const isRecoveryRetry = recoveryMetadata?.agentNativeRecoveryAction === "retry";
+            const turnMetadata = mergeTrustedProtocolMetadata(options.metadata, input.metadata, input.options?.metadata, input.options?.agentId ? { agentId: input.options.agentId } : undefined, input.options?.locale ? { locale: input.options.locale } : undefined, input.options?.mode ? { mode: input.options.mode } : undefined, isRecoveryRetry ? { agentNativeInternalContinuation: true } : undefined);
             const session = await getSession(input.threadId, turnMetadata);
             const messages = input.messages.map(protocolMessageToRuntimeMessage);
+            const attachments = latestUserMessage?.parts.flatMap((part) => part.type === "file"
+                ? [
+                    {
+                        name: part.name,
+                        ...(part.fileId ? { id: part.fileId } : {}),
+                        ...(part.mediaType ? { mediaType: part.mediaType } : {}),
+                        ...(part.url ? { url: part.url } : {}),
+                    },
+                ]
+                : []) ?? [];
             const turn = await session.startTurn({
                 prompt: latestUserPrompt(input.messages),
                 messages,
+                ...(attachments.length ? { attachments } : {}),
                 model: input.options?.model,
                 reasoningEffort: input.options?.reasoningEffort,
                 temperature: input.options?.temperature,

package/dist/client/chat/run-recovery.d.ts

@@ -22,6 +22,7 @@ export declare function runErrorHeadline(info: RunErrorInfo, labels?: {
 }): string;
 export declare function getRequestModeMetadata(message: unknown): "act" | "plan" | null;
 export declare function isBuilderReconnectRunError(info: RunErrorInfo): boolean;
+export declare function isMissingLlmProviderRunError(info: RunErrorInfo): boolean;
 export declare function BuilderConnectCta({ variant, onConnected, reconnect, }: {
     variant?: "primary" | "compact";
     onConnected?: () => void;

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

@@ -119,7 +119,7 @@ function isConnectionRecoveryRunError(info) {
         message.includes("connection kept failing") ||
         message.includes("automatic recovery attempts"));
 }
-function isMissingLlmProviderRunError(info) {
+export function isMissingLlmProviderRunError(info) {
     const code = (info.errorCode ?? "").toLowerCase();
     const text = [info.message, info.details].filter(Boolean).join("\n");
     const hasCredentialSetupText = /no llm provider(?: key)? (?:is connected|was found)|missing credentials|missing api key|missing_api_key|(?:api[_ -]?key|auth[_ -]?token)\s*(?:(?:is|was)\s+)?(?:not\s+(?:set|configured|available|present|provided|found)|missing|unavailable|empty|unset|unconfigured)/i.test(text);