@agent-native/core 0.169.0 → 0.169.1

package/corpus/templates/design/app/pages/DesignSystemSetup.tsx

@@ -61,6 +61,8 @@ type OtherSource =
   | "existing"
   | "notes";
 
+type BuilderIndexInputSource = "figma" | "github" | "design-md";
+
 interface BuilderIndexResult {
   ok: boolean;
   source: "builder";
@@ -151,6 +153,8 @@ export default function DesignSystemSetup() {
   const [builderIndexing, setBuilderIndexing] = useState(false);
   const [builderIndexResult, setBuilderIndexResult] =
     useState<BuilderIndexResult | null>(null);
+  const [builderIndexInputSource, setBuilderIndexInputSource] =
+    useState<BuilderIndexInputSource | null>(null);
   const [builderIndexError, setBuilderIndexError] = useState<string | null>(
     null,
   );
@@ -222,6 +226,7 @@ export default function DesignSystemSetup() {
       }
       setBuilderIndexError(null);
       setBuilderIndexResult(null);
+      setBuilderIndexInputSource("figma");
       stopDecodePolling();
       setDecodeStatus(null);
       setBuilderIndexing(true);
@@ -550,7 +555,7 @@ export default function DesignSystemSetup() {
     if (isGithubOnlySource) {
       setValidationError(null);
       try {
-        await indexSystemMutation.mutateAsync({
+        const result = await indexSystemMutation.mutateAsync({
           projectName: companyInfo.trim() || undefined,
           description:
             [notes.trim(), customInstructions.trim()]
@@ -562,8 +567,9 @@ export default function DesignSystemSetup() {
             ...(link.include?.length ? { include: link.include } : {}),
           })),
         });
+        setBuilderIndexInputSource("github");
+        setBuilderIndexResult(result);
         toast.success(t("designSystemSetup.githubIndexStarted"));
-        navigate("/design-systems");
       } catch (error) {
         setValidationError(
           error instanceof Error
@@ -603,7 +609,7 @@ export default function DesignSystemSetup() {
     if (isDesignMdOnlySource) {
       setValidationError(null);
       try {
-        await indexSystemMutation.mutateAsync({
+        const result = await indexSystemMutation.mutateAsync({
           projectName: companyInfo.trim() || undefined,
           description:
             [notes.trim(), customInstructions.trim()]
@@ -611,8 +617,9 @@ export default function DesignSystemSetup() {
               .join("\n\n") || undefined,
           designMd: readableDesignMdFiles[0]?.textContent,
         });
+        setBuilderIndexInputSource("design-md");
+        setBuilderIndexResult(result);
         toast.success(t("designSystemSetup.designMdIndexStarted"));
-        navigate("/design-systems");
       } catch (error) {
         setValidationError(
           error instanceof Error
@@ -861,6 +868,23 @@ export default function DesignSystemSetup() {
             </div>
           )}
 
+          {builderIndexResult && builderIndexInputSource !== "figma" ? (
+            <div className="mb-6">
+              <BuilderIndexPreview
+                result={builderIndexResult}
+                decodeStatus={null}
+                source={builderIndexInputSource ?? "design-md"}
+                displayTitle={companyInfo.trim()}
+                onReset={() => {
+                  setDecodeStatus(null);
+                  setBuilderIndexResult(null);
+                  setBuilderIndexInputSource(null);
+                  setBuilderIndexError(null);
+                }}
+              />
+            </div>
+          ) : null}
+
           <div className="space-y-5">
             <section className="rounded-lg border border-border bg-card p-4">
               <div className="mb-3">
@@ -990,6 +1014,7 @@ export default function DesignSystemSetup() {
                     stopDecodePolling();
                     setDecodeStatus(null);
                     setBuilderIndexResult(null);
+                    setBuilderIndexInputSource(null);
                     setBuilderIndexError(null);
                   }}
                 />
@@ -1596,32 +1621,38 @@ function FileList({
 function BuilderIndexPreview({
   result,
   decodeStatus,
+  source = "figma",
   displayTitle,
   onReset,
 }: {
   result: BuilderIndexResult;
   decodeStatus: DecodeJobStatus | null;
+  source?: BuilderIndexInputSource;
   displayTitle?: string;
   onReset: () => void;
 }) {
   const t = useT();
   const decodeError =
     decodeStatus?.status === "error" ? decodeStatus.error : null;
+  const SourceIcon =
+    source === "figma"
+      ? IconBrandFigma
+      : source === "github"
+        ? IconBrandGithub
+        : IconFileDescription;
 
   return (
     <div className="space-y-4 rounded-xl border border-border bg-card p-4">
       <div className="flex items-start gap-3">
         <div className="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg bg-[#609FF8]/10">
-          <IconBrandFigma className="h-5 w-5 text-[#609FF8]" />
+          <SourceIcon className="h-5 w-5 text-[var(--design-editor-accent-color)]" />
         </div>
         <div className="min-w-0 flex-1">
           <h3 className="text-sm font-semibold text-foreground">
             {displayTitle || result.suggestedTitle}
           </h3>
           <p className="mt-1 text-xs leading-relaxed text-muted-foreground">
-            {
-              "Builder is indexing this Figma file into a reusable design system." /* i18n-ignore Builder indexing status */
-            }
+            {t("designSystemSetup.figmaParsingDescription")}
           </p>
         </div>
       </div>

package/corpus/templates/design/app/pages/DesignSystems.tsx

@@ -699,7 +699,7 @@ export default function DesignSystems() {
             </AlertDialogCancel>
             <AlertDialogAction
               onClick={bulkDeleteOpen ? handleBulkDelete : handleDelete}
-              className="bg-red-600 hover:bg-red-700 cursor-pointer"
+              className="bg-destructive text-destructive-foreground hover:bg-destructive/90 cursor-pointer"
             >
               {t("designSystems.actions.delete")}
             </AlertDialogAction>

package/corpus/templates/design/app/pages/Index.tsx

@@ -1232,7 +1232,7 @@ export default function Index() {
             </AlertDialogCancel>
             <AlertDialogAction
               onClick={bulkDeleteOpen ? handleBulkDelete : handleDelete}
-              className="bg-red-600 hover:bg-red-700 cursor-pointer"
+              className="bg-destructive text-destructive-foreground hover:bg-destructive/90 cursor-pointer"
             >
               {t("home.delete")}
             </AlertDialogAction>

package/corpus/templates/design/app/pages/design-editor/preview-navigation.ts

@@ -0,0 +1,25 @@
+/**
+ * Opens a preview from a user gesture without losing it to popup blocking.
+ * The blank window must be created before assigning the real URL; otherwise
+ * browsers can treat the delayed navigation as an unsolicited popup.
+ */
+export function openPreviewUrl(
+  url: string,
+  openWindow: (url: string, target: string) => Window | null,
+  navigateSameTab: (url: string) => void,
+): "popup" | "same-tab" {
+  const popup = openWindow("", "_blank");
+  if (!popup) {
+    navigateSameTab(url);
+    return "same-tab";
+  }
+
+  try {
+    popup.opener = null;
+    popup.location.href = url;
+    return "popup";
+  } catch {
+    navigateSameTab(url);
+    return "same-tab";
+  }
+}

package/corpus/templates/mail/app/hooks/use-emails.ts

@@ -88,19 +88,27 @@ export function fetchThreadMessages(
 }
 
 let externalRefreshAt = 0;
+let externalRefreshGeneration = 0;
+const externalRefreshConsumers = new Map<string, number>();
 
 export function markExternalEmailRefresh() {
   externalRefreshAt = Date.now();
+  externalRefreshGeneration += 1;
 }
 
-export function consumeExternalEmailRefresh(): number | undefined {
+export function consumeExternalEmailRefresh(
+  scope = "default",
+): number | undefined {
   const refreshAt = externalRefreshAt;
   if (!refreshAt) return undefined;
   if (Date.now() - refreshAt >= 5000) {
     externalRefreshAt = 0;
+    externalRefreshConsumers.clear();
     return undefined;
   }
-  externalRefreshAt = 0;
+  if (externalRefreshConsumers.get(scope) === externalRefreshGeneration)
+    return undefined;
+  externalRefreshConsumers.set(scope, externalRefreshGeneration);
   return refreshAt;
 }
 
@@ -516,7 +524,9 @@ export function useEmails(
       if (label) params.set("label", label);
       if (pageParam) params.set("pageToken", pageParam);
       const forceRefreshAt = !pageParam
-        ? consumeExternalEmailRefresh()
+        ? consumeExternalEmailRefresh(
+            JSON.stringify([view, search ?? null, label ?? null]),
+          )
         : undefined;
       if (forceRefreshAt) {
         params.set("forceRefresh", String(forceRefreshAt));

package/dist/agent/engine/credential-errors.d.ts

@@ -5,7 +5,7 @@ export declare const LLM_MISSING_CREDENTIALS_ERROR_CODE = "missing_credentials";
  * recognize it without importing server-only code into the browser bundle.
  */
 export declare const CREDENTIAL_STORE_UNAVAILABLE_ERROR_CODE = "credential_store_unavailable";
-export declare const LLM_MISSING_CREDENTIALS_MESSAGE = "No LLM provider is connected. Open this app's Manage agent > LLM, then connect Builder.io (free tier available) or add a provider key.";
+export declare const LLM_MISSING_CREDENTIALS_MESSAGE = "No LLM provider is connected. Open Settings > Agent > AI providers, then connect Builder.io (free tier available) or add a provider key.";
 /**
  * The one line a site visitor sees for every gateway rejection. Quota,
  * concurrency, a revoked token, a disabled gateway and an unreadable credential

package/dist/agent/engine/credential-errors.js

@@ -6,7 +6,7 @@ export const LLM_MISSING_CREDENTIALS_ERROR_CODE = "missing_credentials";
  * recognize it without importing server-only code into the browser bundle.
  */
 export const CREDENTIAL_STORE_UNAVAILABLE_ERROR_CODE = "credential_store_unavailable";
-export const LLM_MISSING_CREDENTIALS_MESSAGE = "No LLM provider is connected. Open this app's Manage agent > LLM, then connect Builder.io (free tier available) or add a provider key.";
+export const LLM_MISSING_CREDENTIALS_MESSAGE = "No LLM provider is connected. Open Settings > Agent > AI providers, then connect Builder.io (free tier available) or add a provider key.";
 /**
  * The one line a site visitor sees for every gateway rejection. Quota,
  * concurrency, a revoked token, a disabled gateway and an unreadable credential
@@ -59,7 +59,7 @@ export function formatLlmCredentialErrorMessage(options) {
         return GATEWAY_UNAVAILABLE_VISITOR_MESSAGE;
     const agentName = options?.agentName?.trim();
     if (agentName) {
-        return `The ${agentName} agent could not finish this request because that app needs an LLM connection. Open ${agentName}'s Manage agent > LLM, then connect Builder.io (free tier available) or add a provider key.`;
+        return `The ${agentName} agent could not finish this request because that app needs an LLM connection. Open Settings > Agent > AI providers, then connect Builder.io (free tier available) or add a provider key.`;
     }
     return LLM_MISSING_CREDENTIALS_MESSAGE;
 }

package/dist/client/AssistantChat.js

@@ -121,6 +121,8 @@ function getPollAbortMs(interval) {
     return Math.max(POLL_ABORT_MIN_MS, interval * 4);
 }
 const ACTIVE_RUN_CLEAR_TIMEOUT_MS = 5_000;
+const ACTIVE_RUN_CLEAR_STABLE_POLLS = 2;
+const ACTIVE_RUN_CLEAR_RETRY_DELAY_MS = 1_000;
 const ACTIVE_RUN_STUCK_THRESHOLD_MS = 90_000;
 const BACKGROUND_ACTIVE_RUN_STUCK_THRESHOLD_MS = 13 * 60_000;
 const ACTIVE_RUN_POLL_INTERVAL_MS = 150;
@@ -303,6 +305,7 @@ export async function waitForThreadRunToClear(apiUrl, threadId) {
         return true;
     const deadline = Date.now() + ACTIVE_RUN_CLEAR_TIMEOUT_MS;
     let activeRunToResume = null;
+    let consecutiveClearPolls = 0;
     const resumeActiveRun = (info) => {
         if (!info.runId)
             return;
@@ -323,11 +326,22 @@ export async function waitForThreadRunToClear(apiUrl, threadId) {
             const res = await fetch(`${apiUrl}/runs/active?threadId=${encodeURIComponent(threadId)}`);
             if (res.ok) {
                 const info = (await res.json());
-                if (!info?.active ||
+                const runLooksClear = !info?.active ||
                     info?.status !== "running" ||
-                    activeRunLooksStale(info))
-                    return true;
-                if (info.runId) {
+                    activeRunLooksStale(info);
+                if (runLooksClear) {
+                    consecutiveClearPolls += 1;
+                    // A terminal/no-active snapshot can briefly appear between a
+                    // foreground run and its server-owned continuation. Require two
+                    // consecutive clear polls before releasing a queued follow-up.
+                    if (consecutiveClearPolls >= ACTIVE_RUN_CLEAR_STABLE_POLLS) {
+                        return true;
+                    }
+                }
+                else {
+                    consecutiveClearPolls = 0;
+                }
+                if (!runLooksClear && info.runId) {
                     activeRunToResume = info;
                     if (info.awaitingRedispatch === true) {
                         // This is not the brief terminal-write lag the 5s waiter was built
@@ -340,8 +354,12 @@ export async function waitForThreadRunToClear(apiUrl, threadId) {
                     }
                 }
             }
+            else {
+                consecutiveClearPolls = 0;
+            }
         }
         catch {
+            consecutiveClearPolls = 0;
             // Transient poll failure — try again until the short grace period ends.
         }
         await new Promise((resolve) => window.setTimeout(resolve, ACTIVE_RUN_POLL_INTERVAL_MS));
@@ -1730,6 +1748,15 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         tabId,
         onActiveRunChange: setHasActiveServerRun,
     });
+    // Server truth must participate in submit gating, not only in the missing
+    // final-response warning. The local lifecycle can clear during a transport
+    // handoff while the server still owns the turn.
+    const serverRunState = useRunStuckDetection({
+        threadId: threadId ?? null,
+        enabled: isActiveComposer,
+        apiUrl,
+    });
+    const serverRunActive = serverRunState.runId != null && serverRunState.status === "running";
     // Real running state drives submission/queue gating; UI running also covers
     // short auto-continuation gaps so the latest assistant message does not flash
     // into a done state while the agent is still working.
@@ -1739,19 +1766,10 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         isReconnecting,
         optimisticRunning,
         isAutoResuming,
-        hasActiveServerRun,
+        hasActiveServerRun: hasActiveServerRun || serverRunActive,
         hasTerminalRunError: runErrorInfo !== null,
     });
     const textStreaming = showRunningInUI || externalStreaming;
-    // Server truth about this thread's run, used to suppress the "agent stopped
-    // without sending a final message" notice while the server still has the
-    // turn in flight. The poll backs itself off to 15s while nothing is running.
-    const serverRunState = useRunStuckDetection({
-        threadId: threadId ?? null,
-        enabled: isActiveComposer,
-        apiUrl,
-    });
-    const serverRunActive = serverRunState.runId != null && serverRunState.status === "running";
     const storedActiveRun = getActiveRun();
     const activeChatRunId = (serverRunState.status === "running" ? serverRunState.runId : null) ??
         (activeRunMatchesThread(storedActiveRun, threadId)
@@ -3318,6 +3336,7 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         dequeueInFlightRef.current = true;
         let cancelled = false;
         let started = false;
+        let retryTimer = null;
         const timer = window.setTimeout(() => {
             started = true;
             void (async () => {
@@ -3329,8 +3348,19 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                     // complete. Starting the queued turn during that window can reconnect
                     // to the old run and replay the old answer under the new prompt.
                     const runCleared = await waitForThreadRunToClear(apiUrl, threadId);
-                    if (cancelled || !runCleared)
+                    if (cancelled)
                         return;
+                    if (!runCleared) {
+                        // The server still owns this turn (including a deferred durable
+                        // successor). Keep the queued message visible and retry after a
+                        // short delay so one transient idle snapshot cannot strand it.
+                        retryTimer = window.setTimeout(() => {
+                            if (!cancelled) {
+                                setQueueWakeVersion((version) => version + 1);
+                            }
+                        }, ACTIVE_RUN_CLEAR_RETRY_DELAY_MS);
+                        return;
+                    }
                     if (queueStopVersionRef.current !== stopVersion ||
                         queuedMessagesRef.current[0]?.id !== next.id) {
                         return;
@@ -3391,6 +3421,8 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         return () => {
             cancelled = true;
             window.clearTimeout(timer);
+            if (retryTimer !== null)
+                window.clearTimeout(retryTimer);
             if (!started) {
                 dequeueInFlightRef.current = false;
             }

package/dist/client/ConnectBuilderCard.d.ts

@@ -12,10 +12,12 @@ export interface ConnectBuilderCardProps {
     /** The user's feature/change request, forwarded to the selected coding
      *  agent when they click Send. Empty for generic "connect Builder" prompts. */
     prompt?: string;
+    /** Formatted staged chat context forwarded with the Builder request. */
+    context?: string;
 }
 /**
  * Rich inline card rendered for the `connect-builder` tool call. Shows the
  * Builder handoff when available, or routes local development requests to the
  * external coding agent.
  */
-export declare function ConnectBuilderCard({ configured: initialConfigured, builderEnabled: initialBuilderEnabled, connectUrl: initialConnectUrl, orgName: initialOrgName, prompt, }: ConnectBuilderCardProps): React.JSX.Element;
+export declare function ConnectBuilderCard({ configured: initialConfigured, builderEnabled: initialBuilderEnabled, connectUrl: initialConnectUrl, orgName: initialOrgName, prompt, context, }: ConnectBuilderCardProps): React.JSX.Element;

package/dist/client/ConnectBuilderCard.js

@@ -30,7 +30,7 @@ function hasElectronShellBridge() {
  * Builder handoff when available, or routes local development requests to the
  * external coding agent.
  */
-export function ConnectBuilderCard({ configured: initialConfigured, builderEnabled: initialBuilderEnabled = true, connectUrl: initialConnectUrl, orgName: initialOrgName, prompt = "", }) {
+export function ConnectBuilderCard({ configured: initialConfigured, builderEnabled: initialBuilderEnabled = true, connectUrl: initialConnectUrl, orgName: initialOrgName, prompt = "", context = "", }) {
     // The connect-poll state machine is shared — the tool-call result is
     // frozen at render time, so the hook's mount-time fetch + focus refresh
     // is what catches a flow the user completed in another tab.
@@ -89,7 +89,10 @@ export function ConnectBuilderCard({ configured: initialConfigured, builderEnabl
             const res = await fetch(new URL(agentNativePath("/_agent-native/builder/run"), origin).href, {
                 method: "POST",
                 headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({ prompt }),
+                body: JSON.stringify({
+                    prompt,
+                    ...(context.trim() ? { context } : {}),
+                }),
             });
             const data = await res.json().catch(() => ({}));
             if (!res.ok) {
@@ -108,7 +111,7 @@ export function ConnectBuilderCard({ configured: initialConfigured, builderEnabl
             setSendErr(e instanceof Error ? e.message : "Send failed");
             setSending(false);
         }
-    }, [prompt]);
+    }, [context, prompt]);
     const handleJoinWaitlist = useCallback(async () => {
         setJoiningWaitlist(true);
         setWaitlistErr(null);

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

@@ -115,6 +115,13 @@ export declare function shouldShowMissingFinalResponse({ isCurrentTurnRunning, s
     hasActiveTool?: boolean;
     userStoppedRun?: boolean;
 }): boolean;
+/**
+ * "The agent stopped" is derived from local client state, which dips to
+ * not-running at every chunk boundary and transport re-attach while the turn is
+ * still alive server-side. Requiring the shape to hold for a beat keeps the
+ * notice off the screen for those gaps without hiding a real stop for long.
+ */
+export declare const MISSING_FINAL_RESPONSE_SETTLE_MS = 3000;
 export declare function useSettledFlag(active: boolean, delayMs: number): boolean;
 export declare function shouldShowAssistantWorkSummary({ isLast, isComplete, hasCollapsibleWork, hasUnresolvedTool, hasActiveTool, chatRunning, }: {
     isLast: boolean;

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

@@ -728,7 +728,7 @@ export function shouldShowMissingFinalResponse({ isCurrentTurnRunning, serverRun
  * still alive server-side. Requiring the shape to hold for a beat keeps the
  * notice off the screen for those gaps without hiding a real stop for long.
  */
-const MISSING_FINAL_RESPONSE_SETTLE_MS = 250;
+export const MISSING_FINAL_RESPONSE_SETTLE_MS = 3_000;
 export function useSettledFlag(active, delayMs) {
     const [settled, setSettled] = useState(false);
     useEffect(() => {

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

@@ -120,6 +120,9 @@ function isMissingLlmProviderRunError(info) {
         ((code === "missing_credentials" || code === "missing_api_key") &&
             !text.trim()));
 }
+function isDesktopChatRelayRunError(info) {
+    return [info.message, info.details].some((value) => typeof value === "string" && /desktop app chat relay failed/i.test(value));
+}
 // ─── BuilderConnectCta ────────────────────────────────────────────────────────
 // Renders a single row with left-aligned copy and a right-aligned action.
 // Click opens the Builder OAuth popup via the shared
@@ -210,7 +213,7 @@ export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDism
     });
     const canRecover = info.recoverable === true;
     const shouldShowBuilderReconnect = isBuilderReconnectRunError(info);
-    const shouldShowMissingProviderSetup = isMissingLlmProviderRunError(info);
+    const shouldShowProviderSetup = isMissingLlmProviderRunError(info) || isDesktopChatRelayRunError(info);
     const isProviderAuthError = isProviderAuthenticationError([info.message, info.details].filter(Boolean).join("\n"), info.errorCode);
     // Blocked on something the reader goes and fixes elsewhere, then comes back
     // to. Recoverable runs and email verification keep a retry path; rejected
@@ -292,7 +295,7 @@ export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDism
             onDismiss();
         }
     }, [builderReconnectResolved, onDismiss]);
-    if (shouldShowMissingProviderSetup) {
+    if (shouldShowProviderSetup) {
         return (_jsxs("div", { className: "w-full", children: [_jsx(BuilderSetupCard, { fullWidth: true, layout: "sidebar", onConnected: handleMissingProviderConnected }), providerConnected ? (_jsx("div", { className: "flex justify-center px-3 pt-1", children: _jsxs("button", { type: "button", onClick: handleMissingProviderRetry, disabled: retryRequested, className: "inline-flex h-8 items-center gap-1.5 rounded-md bg-foreground px-3 text-xs font-medium text-background hover:opacity-90 disabled:cursor-wait disabled:opacity-60", children: [_jsx(IconRefresh, { size: 13 }), t("agentChat.common.retry")] }) })) : null] }));
     }
     return (_jsxs("div", { className: "rounded-lg border border-amber-500/25 bg-amber-500/[0.06] p-3 text-sm", children: [_jsxs("div", { className: "flex items-start gap-2", children: [_jsx("span", { className: "mt-0.5 flex h-6 w-6 shrink-0 items-center justify-center rounded-md bg-amber-500/10 text-amber-700 dark:text-amber-300", children: _jsx(IconAlertTriangle, { size: 14 }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "font-medium text-foreground", children: runErrorHeadline(info, {

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

@@ -1,6 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { IconLoader2, IconAlertTriangle, IconCircleX, IconCheck, IconChevronRight, IconCopy, IconCode, IconBrandSlack, IconTerminal2, IconDatabase, IconSearch, IconFileCode, IconShieldCheck, IconX, } from "@tabler/icons-react";
 import React, { useState, useEffect, useCallback, useLayoutEffect, useRef, } from "react";
+import { formatAgentChatContextItemsForPrompt } from "../agent-chat.js";
 import { AgentTaskCard } from "../AgentTaskCard.js";
 import { writeClipboardText } from "../clipboard.js";
 import { Popover, PopoverContent, PopoverTrigger, } from "../components/ui/popover.js";
@@ -12,6 +13,7 @@ import { findMcpIntegrationForToolName } from "../resources/mcp-integration-cata
 import { McpIntegrationLogo } from "../resources/McpIntegrationLogo.js";
 import { BashCell, EditCell, WriteCell, FilesChangedSummary, } from "../tool-cells/index.js";
 import { humanizeToolName, isCallAgentToolCallShadowed, isToolCallActive, } from "../tool-display.js";
+import { useAgentChatContext } from "../use-agent-chat-context.js";
 import { cn } from "../utils.js";
 import { ActionChatUiSurface } from "./action-chat-ui-surface.js";
 import { SmoothMarkdownText, HighlightedCodeBlock, } from "./markdown-renderer.js";
@@ -280,6 +282,10 @@ function ApprovalAffordance({ toolName, toolCallId, approval, }) {
 }
 // ─── ToolCallDisplay ──────────────────────────────────────────────────────────
 export function ToolCallDisplay({ toolName, toolCallId, argsText, args, result, mcpApp, chatUI, isRunning, outcome, structuredMeta, activity, approval, repeatCount, isLatestRunning = isRunning, isActiveTail, }) {
+    const { items: agentChatContextItems } = useAgentChatContext(toolName === "connect-builder");
+    const builderContext = toolName === "connect-builder"
+        ? formatAgentChatContextItemsForPrompt(agentChatContextItems)
+        : "";
     const isDelegatedAgentCall = toolName === "call-agent" || toolName.startsWith("agent:");
     const effectiveIsRunning = isRunning ||
         (isDelegatedAgentCall &&
@@ -306,9 +312,9 @@ export function ToolCallDisplay({ toolName, toolCallId, argsText, args, result,
     if (toolKind === "write") {
         return wrapToolDisplay(_jsx(WriteCell, { meta: structuredMeta, isRunning: effectiveIsRunning }));
     }
-    return wrapToolDisplay(_jsx(ToolCallDisplayGeneric, { toolName: toolName, toolCallId: toolCallId, argsText: argsText, args: args, result: result, mcpApp: mcpApp, chatUI: chatUI, isRunning: effectiveIsRunning, outcome: outcome, isActiveTail: showActiveTail, structuredMeta: structuredMeta, approval: approval, repeatCount: repeatCount }));
+    return wrapToolDisplay(_jsx(ToolCallDisplayGeneric, { toolName: toolName, toolCallId: toolCallId, argsText: argsText, args: args, result: result, mcpApp: mcpApp, chatUI: chatUI, isRunning: effectiveIsRunning, outcome: outcome, isActiveTail: showActiveTail, structuredMeta: structuredMeta, approval: approval, repeatCount: repeatCount, context: builderContext }));
 }
-function ToolCallDisplayGeneric({ toolName, toolCallId, argsText, args, result, mcpApp, chatUI, isRunning, outcome, isActiveTail, structuredMeta, approval, repeatCount, }) {
+function ToolCallDisplayGeneric({ toolName, toolCallId, argsText, args, result, mcpApp, chatUI, isRunning, outcome, isActiveTail, structuredMeta, approval, repeatCount, context, }) {
     const t = useT();
     const suppressInlineOpenApp = React.useContext(SuppressInlineOpenAppContext);
     const isRawCallAgent = toolName === "call-agent";
@@ -339,7 +345,7 @@ function ToolCallDisplayGeneric({ toolName, toolCallId, argsText, args, result,
                 return (_jsx(ConnectBuilderCard, { configured: !!parsed.configured, builderEnabled: parsed.builderEnabled !== false, 
                     // Ignore obsolete direct-auth URLs from older tool results. The
                     // card fetches a fresh app-local connect URL on mount and click.
-                    connectUrl: parsed.connectUrl || "", orgName: parsed.orgName ?? null, prompt: typeof parsed.prompt === "string" ? parsed.prompt : "" }));
+                    connectUrl: parsed.connectUrl || "", orgName: parsed.orgName ?? null, prompt: typeof parsed.prompt === "string" ? parsed.prompt : "", context: context }));
             }
         }
         catch {

package/dist/client/error-format.js

@@ -80,6 +80,18 @@ const KNOWN_CHAT_ERROR_KEYS = new Map([
         "No LLM provider is connected. Open this app's Manage agent > LLM, then connect Builder.io or add a provider key.",
         "agentChat.errorMessages.noProviderConnected",
     ],
+    [
+        "No LLM provider is connected. Open this app's Manage agent > LLM, then connect Builder.io (free tier available) or add a provider key.",
+        "agentChat.errorMessages.noProviderConnected",
+    ],
+    [
+        "No LLM provider is connected. Open Settings > Agent > AI providers, then connect Builder.io or add a provider key.",
+        "agentChat.errorMessages.noProviderConnected",
+    ],
+    [
+        "No LLM provider is connected. Open Settings > Agent > AI providers, then connect Builder.io (free tier available) or add a provider key.",
+        "agentChat.errorMessages.noProviderConnected",
+    ],
     [
         "The provider behind this model rejected the request. Pick a different model, then retry.",
         "agentChat.errorMessages.builderModelUnauthorized",

package/dist/client/navigation/index.d.ts

@@ -1,5 +1,6 @@
 export { agentNativePath, appApiPath, appBasePath, appPath, } from "../api-path.js";
 export { useAgentRouteState, useSemanticNavigationState, type AgentRouteLocation, type SemanticNavigationCommandEnvelope, type UseAgentRouteStateOptions, type UseAgentRouteStateResult, type UseSemanticNavigationStateOptions, type UseSemanticNavigationStateResult, } from "../route-state.js";
+export { AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE, postAgentNativeWorkspaceAppRoute, type AgentNativeWorkspaceAppRouteMessage, } from "../workspace-app-navigation.js";
 export { COMMAND_MENU_OPEN_EVENT, CommandMenu, openAgentSidebar, openAgentSettings, openCommandMenu, submitToAgent, useCommandMenuShortcut, type CommandMenuProps, type CommandMenuDoc, type CommandDocsGroupProps, type CommandGroupProps, type CommandItemProps, type CommandShortcutProps, } from "../CommandMenu.js";
 export { buildOpenRouteLink, buildOpenRoutePath, buildLegacyAgentSettingsRoute, buildResourceRoute, buildSettingsRoute, buildStandardAppRoute, buildTeamRoute, createStandardOpenPathResolver, STANDARD_APP_ROUTES, STANDARD_SETTINGS_TABS, type BuildResourceRouteOptions, type BuildStandardAppRouteOptions, type NavigationLink, type NavigationTarget, type StandardAppRouteId, type StandardOpenPathResolverOptions, type StandardOpenPathRoute, type StandardSettingsTabId, } from "../../navigation/index.js";
 export { postNavigate, isInAgentEmbed, AGENT_NAVIGATE_MESSAGE_TYPE, type AgentNavigateMessage, } from "../embed.js";

package/dist/client/navigation/index.js

@@ -1,5 +1,6 @@
 export { agentNativePath, appApiPath, appBasePath, appPath, } from "../api-path.js";
 export { useAgentRouteState, useSemanticNavigationState, } from "../route-state.js";
+export { AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE, postAgentNativeWorkspaceAppRoute, } from "../workspace-app-navigation.js";
 export { COMMAND_MENU_OPEN_EVENT, CommandMenu, openAgentSidebar, openAgentSettings, openCommandMenu, submitToAgent, useCommandMenuShortcut, } from "../CommandMenu.js";
 export { buildOpenRouteLink, buildOpenRoutePath, buildLegacyAgentSettingsRoute, buildResourceRoute, buildSettingsRoute, buildStandardAppRoute, buildTeamRoute, createStandardOpenPathResolver, STANDARD_APP_ROUTES, STANDARD_SETTINGS_TABS, } from "../../navigation/index.js";
 export { postNavigate, isInAgentEmbed, AGENT_NAVIGATE_MESSAGE_TYPE, } from "../embed.js";

package/dist/client/route-state.js

@@ -4,6 +4,7 @@ import { useLocation, useNavigate, } from "react-router";
 import { isWorkspaceAppPath } from "./api-path.js";
 import { deleteClientAppState, readClientAppState, setClientAppState, } from "./application-state.js";
 import { navigateWithAgentChatViewTransition, } from "./chat-view-transition.js";
+import { postAgentNativeWorkspaceAppRoute } from "./workspace-app-navigation.js";
 const SAFE_BROWSER_TAB_ID_RE = /^[A-Za-z0-9_-]{1,96}$/;
 function normalizeBrowserTabId(browserTabId) {
     if (typeof browserTabId !== "string")
@@ -195,6 +196,11 @@ export function useAgentRouteState(options) {
     const location = useLocation();
     const navigate = useNavigate();
     const browserTabId = useMemo(() => normalizeBrowserTabId(options.browserTabId), [options.browserTabId]);
+    useEffect(() => {
+        if (options.enabled === false)
+            return;
+        postAgentNativeWorkspaceAppRoute(`${location.pathname}${location.search}${location.hash}`);
+    }, [location.hash, location.pathname, location.search, options.enabled]);
     const navigationKeys = useMemo(() => {
         const scopedKey = appStateKeyForBrowserTab(navigationKey, browserTabId);
         const keys = [scopedKey];

package/dist/client/workspace-app-navigation.d.ts

@@ -0,0 +1,10 @@
+export declare const AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE: "agent-native:workspace-app-route";
+export interface AgentNativeWorkspaceAppRouteMessage {
+    type: typeof AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE;
+    path: string;
+}
+/**
+ * Report an app-local route to its immediate embedding host. The host checks
+ * the iframe source and origin before applying the route to its own URL.
+ */
+export declare function postAgentNativeWorkspaceAppRoute(path: string): boolean;

package/dist/client/workspace-app-navigation.js

@@ -0,0 +1,38 @@
+export const AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE = "agent-native:workspace-app-route";
+function normalizeWorkspaceAppRoute(path) {
+    if (typeof path !== "string" ||
+        !path.startsWith("/") ||
+        path.startsWith("//")) {
+        return null;
+    }
+    if (/[\u0000-\u001f\u007f]/.test(path))
+        return null;
+    try {
+        const url = new URL(path, "http://agent-native.invalid");
+        return `${url.pathname}${url.search}${url.hash}`;
+    }
+    catch {
+        // coercion-ok: malformed route input is not reported to the host.
+        return null;
+    }
+}
+/**
+ * Report an app-local route to its immediate embedding host. The host checks
+ * the iframe source and origin before applying the route to its own URL.
+ */
+export function postAgentNativeWorkspaceAppRoute(path) {
+    if (typeof window === "undefined")
+        return false;
+    const parentWindow = window.parent;
+    if (!parentWindow || parentWindow === window)
+        return false;
+    const normalizedPath = normalizeWorkspaceAppRoute(path);
+    if (!normalizedPath)
+        return false;
+    const message = {
+        type: AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE,
+        path: normalizedPath,
+    };
+    parentWindow.postMessage(message, "*");
+    return true;
+}