@agent-native/core 0.168.13 → 0.169.1

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/agent-chat-adapter.d.ts

@@ -15,8 +15,6 @@ export type AgentChatSurfaceKind =
  | "desktop";
 export declare const BACKGROUND_FOLLOW_ATTACH_WATCHDOG_MS = 90000;
 export declare const BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS = 210000;
-export declare const MAX_FOLLOWED_BACKGROUND_RUNS = 24;
-export declare const MAX_BACKGROUND_FOLLOW_WALL_TIME_MS: number;
 /**
  * True when an action was streamed but never returned a result yet — i.e. a
  * `tool_start` with no matching `tool_done`. The server is still executing it,

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

@@ -170,29 +170,13 @@ export const BACKGROUND_FOLLOW_IDLE_TIMEOUT_MS = 210_000;
 // 22 minutes, all error:stale_run, user watching a spinner). These bound the
 // whole turn instead, and an identical repeated failure counts as no progress.
 //
-// CLIENT-ABOVE-SERVER INVARIANT (asserted in agent-chat-adapter.spec.ts).
-// These are a backstop for a server that has gone silent in a way the idle
-// timeout misses — NOT the primary limit. They must stay ABOVE the server's
-// own ceilings so the server, which can actually tell progress from looping,
-// always terminates a turn first and writes a truthful terminal reason:
-//   BACKGROUND_SOFT_TIMEOUT_CEILING_MS  (13 min, run-manager.ts)  — one chunk
-//   MAX_TURN_WALL_CLOCK_MS              (90 min, production-agent.ts) — one turn
-//   MAX_BACKGROUND_RUN_CONTINUATIONS    (20,     production-agent.ts)
-//
-// They were originally set to 10 min / 6 runs, which put the whole-turn client
-// budget BELOW the 13-minute ceiling of a single legal chunk. Any turn needing
-// a second full-length chunk was killed by the client while the server was
-// healthy and had 80 minutes left — measured in prod as turns dying at 11-25
-// minutes with `last_progress_at` tracking the abort, i.e. still streaming
-// tokens and completing tools when the client gave up. That is the top
-// non-auth cause of "the chat just stopped" reports.
-//
-// Killing a turn that is NOT progressing is already covered twice over, by
-// mechanisms that read progress rather than a clock: the 210s idle timeout
-// above, and MAX_REPEATED_BACKGROUND_TERMINAL_REASONS below. Do not re-tighten
-// these two to catch a stuck turn — fix the progress signal instead.
-export const MAX_FOLLOWED_BACKGROUND_RUNS = 24;
-export const MAX_BACKGROUND_FOLLOW_WALL_TIME_MS = 95 * 60_000;
+// Defined in `app-config/run-lifecycle-invariants.ts`, not here, because the
+// CLIENT-ABOVE-SERVER relationship they belong to is checked there against the
+// RESOLVED server configuration — the server bounds are runtime-configurable
+// now, so a spec pinning them against module constants stopped enforcing
+// anything. Re-exported under the same names so importers are unchanged; that
+// module has no runtime imports, so the bundle pays nothing for it.
+import { MAX_BACKGROUND_FOLLOW_WALL_TIME_MS, MAX_FOLLOWED_BACKGROUND_RUNS, } from "../app-config/run-lifecycle-invariants.js";
 const MAX_REPEATED_BACKGROUND_TERMINAL_REASONS = 3;
 // A re-observed terminal run whose outcome would be an ERROR (never a
 // genuine "done" success) gets a short extra grace window before the follow

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;
+}

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/deploy/build.d.ts

@@ -254,6 +254,19 @@ export declare function assertSingleTemplateNetlifyBuildOutput(projectCwd: strin
  * Netlify platform 404s. Preserve any real redirects from `public/_redirects`.
  */
 export declare function writeSingleTemplateNetlifyRedirects(projectCwd: string): void;
+/**
+ * Whether the emitted bundle actually imports the `libsql` native addon.
+ *
+ * The `@libsql/client` node entry `require`s it; `@libsql/client/web` and
+ * `better-sqlite3` do not. Probing the emitted output is the only gate that
+ * cannot be wrong: `getDialect()` reads `DATABASE_URL` at RUNTIME, and neither
+ * the docs nor the beta deploy workflow sets it at build time, so build-time
+ * dialect is unknowable. This mirrors `findServerlessBrowserRuntimeConsumer`,
+ * which already gates the Chromium copy the same way — the asymmetry is why a
+ * 9.3MB Linux SQLite driver shipped in the docs function, a deployment that
+ * runs Postgres and can never load it.
+ */
+export declare function bundleImportsLibsqlNativeAddon(serverDir: string): boolean;
 /**
  * Nitro's file tracer can over-include optional desktop/dev packages that are
  * present in a monorepo install but cannot run in serverless. Netlify installs

package/dist/deploy/build.js

@@ -3389,9 +3389,60 @@ export function writeSingleTemplateNetlifyRedirects(projectCwd) {
     }
     console.log('[deploy] Removed Netlify fallback rewrite to /.netlify/functions/server (incompatible with Nitro config.path: "/*").');
 }
+/**
+ * Whether the emitted bundle actually imports the `libsql` native addon.
+ *
+ * The `@libsql/client` node entry `require`s it; `@libsql/client/web` and
+ * `better-sqlite3` do not. Probing the emitted output is the only gate that
+ * cannot be wrong: `getDialect()` reads `DATABASE_URL` at RUNTIME, and neither
+ * the docs nor the beta deploy workflow sets it at build time, so build-time
+ * dialect is unknowable. This mirrors `findServerlessBrowserRuntimeConsumer`,
+ * which already gates the Chromium copy the same way — the asymmetry is why a
+ * 9.3MB Linux SQLite driver shipped in the docs function, a deployment that
+ * runs Postgres and can never load it.
+ */
+export function bundleImportsLibsqlNativeAddon(serverDir) {
+    const bareImport = /(?:require\(|from\s*)["']libsql["']/;
+    const stack = [serverDir];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // The copied native package itself is the thing being gated; its own
+                // files must never count as a consumer.
+                if (entry.name === "node_modules" || entry.name === "@libsql")
+                    continue;
+                stack.push(full);
+                continue;
+            }
+            if (!/\.(?:mjs|cjs|js)$/.test(entry.name))
+                continue;
+            try {
+                if (bareImport.test(fs.readFileSync(full, "utf8")))
+                    return true;
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return false;
+}
 function copyInstalledLibsqlNativePackages(serverDir) {
     if (!serverDir || !fs.existsSync(serverDir))
         return;
+    if (!bundleImportsLibsqlNativeAddon(serverDir)) {
+        console.log("[deploy] Skipped the libsql native package: the emitted bundle never imports the `libsql` addon.");
+        return;
+    }
     const nodeModulesRoots = nodeModulesAncestors(cwd);
     const destScopeDir = path.join(serverDir, "node_modules", "@libsql");
     let copied = 0;

package/dist/jobs/background-automation-runner.d.ts

@@ -5,7 +5,23 @@ import { type AutomationExecutionIdentity } from "../automations/service.js";
 import { type Resource } from "../resources/store.js";
 import { type RequestContext } from "../server/request-context.js";
 import type { JobFrontmatter } from "./frontmatter.js";
+/**
+ * Default hard abort for one in-process automation run. Read through
+ * `resolveBackgroundRunHardTimeoutMs()` at the use site — this is the host's
+ * real function budget for scheduled work, and it differs by deployment.
+ */
 export declare const BACKGROUND_RUN_HARD_TIMEOUT_MS: number;
+/**
+ * Terminal failure of a background automation, carrying the machine-readable
+ * code the failure taxonomy already computes.
+ *
+ * The code used to be produced and then dropped, so "how often are runs cut
+ * off?" was a `LIKE '%no_progress%'` over an English sentence.
+ */
+export declare class BackgroundAutomationRunError extends Error {
+    readonly errorCode: string;
+    constructor(message: string, errorCode: string);
+}
 export interface BackgroundAutomationContext {
     name: string;
     meta: JobFrontmatter;
@@ -35,6 +51,15 @@ export interface BackgroundAutomationRunOptions {
     actionAutomation?: ActionAutomationContext;
     /** Reuse a history row created by a durable run-now enqueue. */
     historyId?: string;
+    /**
+     * Per-run overrides for the run-manager no-progress backstop. `startRun` has
+     * always accepted these; the automation path had no way to reach them, and
+     * the one indirect route (zeroing `agent.runSoftTimeoutMs`) is global and
+     * would strip foreground chat of its chunk boundary. Additive: unset means
+     * the configured/default behaviour, unchanged.
+     */
+    noProgressTimeoutMs?: number;
+    backgroundNoProgressTimeoutMs?: number;
 }
 export interface BackgroundAutomationRunResult {
     responseText: string;