@agent-native/core 0.157.6 → 0.157.8

package/dist/client/app-chat-sidebar.js

@@ -1,4 +1,5 @@
 import { useEffect, useState } from "react";
+import { getFramePostMessageTargetOrigin } from "./frame.js";
 /** Custom event used by top-level hosts such as Electron webviews. */
 export const APP_CHAT_SIDEBAR_STATE_EVENT = "agent-native:per-app-chat-state";
 /** postMessage sent from a per-app chat host to its embedded app. */
@@ -8,7 +9,7 @@ export const APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE = "agentNative.perAppChatSta
 export function buildAppChatSidebarStateMessage(open) {
     return {
         type: APP_CHAT_SIDEBAR_STATE_MESSAGE,
-        data: { open },
+        data: { open, hosted: true },
     };
 }
 export function buildAppChatSidebarStateRequest() {
@@ -22,22 +23,62 @@ export function buildAppChatSidebarStateRequest() {
 export function isPerAppChatStorageKey(storageKey) {
     return (storageKey === "desktop-app-chat" || storageKey === "dispatch-app-chat");
 }
-export function usePerAppChatOpen() {
-    const [open, setOpen] = useState(false);
+function readDesktopChatBridge() {
+    if (typeof window === "undefined")
+        return null;
+    const bridge = window.agentNativeDesktop;
+    return bridge?.chat ?? null;
+}
+function readInitialPerAppChatState() {
+    return {
+        open: false,
+        hosted: readDesktopChatBridge() !== null,
+    };
+}
+export function requestPerAppChatCommand(command) {
+    if (typeof window === "undefined")
+        return false;
+    const desktopCommand = readDesktopChatBridge()?.[command];
+    if (desktopCommand) {
+        desktopCommand();
+        return true;
+    }
+    if (window.parent === window)
+        return false;
+    const data = command === "toggle" ? undefined : { open: command === "open" };
+    window.parent.postMessage({
+        type: "agentNative.toggleSidebar",
+        ...(data ? { data } : {}),
+    }, getFramePostMessageTargetOrigin() ?? "*");
+    return true;
+}
+export function usePerAppChatState(enabled = true) {
+    const [state, setState] = useState(() => enabled ? readInitialPerAppChatState() : { open: false, hosted: false });
     useEffect(() => {
+        if (!enabled)
+            return;
         const applyState = (value) => {
-            if (typeof value === "boolean")
-                setOpen(value);
+            if (!value || typeof value !== "object")
+                return;
+            const next = value;
+            if (typeof next.open !== "boolean")
+                return;
+            setState({
+                open: next.open,
+                // Older hosts sent only `open`; a typed host-state message is still
+                // enough to establish that the parent owns this app's chat.
+                hosted: next.hosted !== false,
+            });
         };
         const handleCustomEvent = (event) => {
-            applyState(event.detail?.open);
+            applyState(event.detail);
         };
         const handleMessage = (event) => {
             if (window.parent === window || event.source !== window.parent)
                 return;
             if (event.data?.type !== APP_CHAT_SIDEBAR_STATE_MESSAGE)
                 return;
-            applyState(event.data.data?.open);
+            applyState(event.data.data);
         };
         window.addEventListener(APP_CHAT_SIDEBAR_STATE_EVENT, handleCustomEvent);
         window.addEventListener("message", handleMessage);
@@ -48,6 +89,9 @@ export function usePerAppChatOpen() {
             window.removeEventListener(APP_CHAT_SIDEBAR_STATE_EVENT, handleCustomEvent);
             window.removeEventListener("message", handleMessage);
         };
-    }, []);
-    return open;
+    }, [enabled]);
+    return state;
+}
+export function usePerAppChatOpen() {
+    return usePerAppChatState().open;
 }

package/dist/client/chat/composer-draft.d.ts

@@ -0,0 +1,4 @@
+export declare function assistantChatComposerDraftKey(scope?: string | null): string | null;
+export declare function readAssistantChatComposerDraft(scope?: string | null): string | null;
+export declare function writeAssistantChatComposerDraft(scope: string | null | undefined, text: string): void;
+export declare function clearAssistantChatComposerDraft(scope?: string | null): void;

package/dist/client/chat/composer-draft.js

@@ -0,0 +1,63 @@
+const ASSISTANT_CHAT_COMPOSER_DRAFT_PREFIX = "agent-chat-composer-text:";
+export function assistantChatComposerDraftKey(scope) {
+    const normalizedScope = scope?.trim();
+    return normalizedScope
+        ? `${ASSISTANT_CHAT_COMPOSER_DRAFT_PREFIX}${encodeURIComponent(normalizedScope)}`
+        : null;
+}
+function getComposerDraftStorage() {
+    if (typeof window === "undefined")
+        return null;
+    try {
+        return window.localStorage;
+    }
+    catch {
+        // coercion-ok: browser storage may be unavailable; treat it as absent.
+        return null;
+    }
+}
+export function readAssistantChatComposerDraft(scope) {
+    const key = assistantChatComposerDraftKey(scope);
+    const storage = getComposerDraftStorage();
+    if (!key || !storage)
+        return null;
+    try {
+        const draft = storage.getItem(key);
+        return draft && draft.trim().length > 0 ? draft : null;
+    }
+    catch {
+        // coercion-ok: browser storage may be unavailable; treat it as absent.
+        return null;
+    }
+}
+export function writeAssistantChatComposerDraft(scope, text) {
+    const key = assistantChatComposerDraftKey(scope);
+    const storage = getComposerDraftStorage();
+    if (!key || !storage)
+        return;
+    try {
+        if (text.trim().length > 0) {
+            storage.setItem(key, text);
+        }
+        else {
+            storage.removeItem(key);
+        }
+    }
+    catch {
+        // coercion-ok: browser storage may be unavailable; keep the live editor authoritative.
+        // The live editor remains the source of truth when browser storage is unavailable.
+    }
+}
+export function clearAssistantChatComposerDraft(scope) {
+    const key = assistantChatComposerDraftKey(scope);
+    const storage = getComposerDraftStorage();
+    if (!key || !storage)
+        return;
+    try {
+        storage.removeItem(key);
+    }
+    catch {
+        // coercion-ok: browser storage may be unavailable; keep the live editor authoritative.
+        // The live editor remains the source of truth when browser storage is unavailable.
+    }
+}

package/dist/client/chat-first/apps-rail.js

@@ -53,7 +53,16 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, activeA
             .map((id) => appsById.get(id))
             .filter((app) => Boolean(app));
     }, [apps, layout]);
-    const visibleApps = showAllApps ? orderedApps : orderedApps.slice(0, 5);
+    const visibleApps = useMemo(() => {
+        if (showAllApps)
+            return orderedApps;
+        const defaultApps = orderedApps.slice(0, 5);
+        if (!activeAppId || defaultApps.some((app) => app.id === activeAppId)) {
+            return defaultApps;
+        }
+        const activeApp = orderedApps.find((app) => app.id === activeAppId);
+        return activeApp ? [...defaultApps, activeApp] : defaultApps;
+    }, [activeAppId, orderedApps, showAllApps]);
     const hasMoreApps = orderedApps.length > visibleApps.length;
     const createTrigger = createAppTrigger ??
         (onCreateApp ? (_jsx("button", { type: "button", className: "flex size-6 items-center justify-center rounded text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, "aria-label": copy("createWorkspaceApp"), title: copy("createWorkspaceApp"), children: _jsx(IconPlus, { size: 14, "aria-hidden": "true" }) })) : null);

package/dist/client/chat-first/primary-nav.js

@@ -2,16 +2,21 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { IconClock, IconPlus, IconPlugConnected, IconSearch, } from "@tabler/icons-react";
 import { defaultChatFirstCopy } from "./copy.js";
 export function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, collapsed = false, stickyNewChat = false, copy = defaultChatFirstCopy, }) {
-    const tabClassName = (tab) => `flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium transition-[background-color,color] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${activeTab === tab
+    const tabClassName = (tab) => `flex h-8 w-full items-center gap-2 rounded-md text-[13px] font-medium transition-[background-color,color] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${collapsed ? "justify-center px-0" : "px-2"} ${activeTab === tab
         ? "bg-sidebar-accent text-sidebar-accent-foreground"
         : "text-sidebar-foreground/80 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"}`;
-    const renderTab = (tab, content, onSelect, className) => (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === tab, "aria-label": tab === "new-chat" ? copy("newChat") : undefined, title: tab === "new-chat" && collapsed ? copy("newChat") : undefined, className: [tabClassName(tab), className].filter(Boolean).join(" "), onClick: onSelect, children: content }));
+    const tabLabel = (tab) => tab === "new-chat"
+        ? copy("newChat")
+        : tab === "integrations"
+            ? copy("integrations")
+            : copy("scheduled");
+    const renderTab = (tab, content, onSelect, className) => (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === tab, "aria-label": collapsed || tab === "new-chat" ? tabLabel(tab) : undefined, title: collapsed ? tabLabel(tab) : undefined, className: [tabClassName(tab), className].filter(Boolean).join(" "), onClick: onSelect, children: content }));
     const newChatTab = onNewChat
         ? renderTab("new-chat", _jsxs(_Fragment, { children: [_jsx(IconPlus, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("newChat") })] }), onNewChat, "code-agents-primary-new-chat")
         : null;
-    const integrationsTab = renderTab("integrations", _jsxs(_Fragment, { children: [_jsx(IconPlugConnected, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("integrations") })] }), onOpenIntegrations);
-    const scheduledTab = renderTab("scheduled", _jsxs(_Fragment, { children: [_jsx(IconClock, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("scheduled") })] }), onOpenScheduled);
-    const searchAction = onSearch ? (_jsxs("button", { type: "button", className: "mt-px flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium text-sidebar-foreground/80 transition-[background-color,color] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: onSearch, children: [_jsx(IconSearch, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("search") })] })) : null;
+    const integrationsTab = renderTab("integrations", _jsxs(_Fragment, { children: [_jsx(IconPlugConnected, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("integrations") })] }), onOpenIntegrations);
+    const scheduledTab = renderTab("scheduled", _jsxs(_Fragment, { children: [_jsx(IconClock, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("scheduled") })] }), onOpenScheduled);
+    const searchAction = onSearch ? (_jsxs("button", { type: "button", "aria-label": collapsed ? copy("search") : undefined, title: collapsed ? copy("search") : undefined, className: `mt-px flex h-8 w-full items-center gap-2 rounded-md text-[13px] font-medium text-sidebar-foreground/80 transition-[background-color,color] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${collapsed ? "justify-center px-0" : "px-2"}`, onClick: onSearch, children: [_jsx(IconSearch, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { className: collapsed ? "sr-only" : undefined, children: copy("search") })] })) : null;
     if (stickyNewChat) {
         return (_jsxs(_Fragment, { children: [newChatTab ? (_jsx("div", { className: "code-agents-primary-new-chat-shell", children: newChatTab })) : null, _jsxs("div", { className: "code-agents-nav-list", "aria-label": "Agent navigation", children: [_jsxs("div", { role: "tablist", "aria-label": "Primary navigation", className: "grid gap-px", children: [integrationsTab, scheduledTab] }), searchAction] })] }));
     }

package/dist/client/frame-protocol.d.ts

@@ -54,6 +54,7 @@ export interface PerAppChatSidebarStateMessage {
     type: "agentNative.perAppChatState";
     data: {
         open: boolean;
+        hosted: boolean;
     };
 }
 /** The embedded app asks a host for the current per-app chat state on mount. */

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

@@ -8,7 +8,7 @@ export { notifySessionInvalidated, useSession, type AuthSession, } from "../use-
 export { ACTION_KEEPALIVE_BODY_BUDGET_BYTES, callAction, tryCallActionKeepalive, useActionQuery, useActionMutation, type ActionRegistry, type ClientActionCallOptions, type ClientActionMethod, type KeepaliveActionCallRejectionReason, type KeepaliveActionCallResult, } from "../use-action.js";
 export { createAgentNativeQueryClient } from "../create-query-client.js";
 export { AppProviders, type AppProvidersProps } from "../app-providers.js";
-export { APP_CHAT_SIDEBAR_STATE_EVENT, APP_CHAT_SIDEBAR_STATE_MESSAGE, APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE, buildAppChatSidebarStateMessage, buildAppChatSidebarStateRequest, isPerAppChatStorageKey, usePerAppChatOpen, type AppChatSidebarState, } from "../app-chat-sidebar.js";
+export { APP_CHAT_SIDEBAR_STATE_EVENT, APP_CHAT_SIDEBAR_STATE_MESSAGE, APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE, buildAppChatSidebarStateMessage, buildAppChatSidebarStateRequest, isPerAppChatStorageKey, requestPerAppChatCommand, usePerAppChatState, usePerAppChatOpen, type AppChatSidebarCommand, type AppChatSidebarState, } from "../app-chat-sidebar.js";
 export { usePinchZoom, type UsePinchZoomOptions } from "../use-pinch-zoom.js";
 export { useAvatarUrl, uploadAvatar, invalidateAvatarCache, } from "../use-avatar.js";
 export { usePollLoop, type UsePollLoopOptions, type UsePollLoopHandle, } from "../use-poll-loop.js";

package/dist/client/hooks/index.js

@@ -8,7 +8,7 @@ export { notifySessionInvalidated, useSession, } from "../use-session.js";
 export { ACTION_KEEPALIVE_BODY_BUDGET_BYTES, callAction, tryCallActionKeepalive, useActionQuery, useActionMutation, } from "../use-action.js";
 export { createAgentNativeQueryClient } from "../create-query-client.js";
 export { AppProviders } from "../app-providers.js";
-export { APP_CHAT_SIDEBAR_STATE_EVENT, APP_CHAT_SIDEBAR_STATE_MESSAGE, APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE, buildAppChatSidebarStateMessage, buildAppChatSidebarStateRequest, isPerAppChatStorageKey, usePerAppChatOpen, } from "../app-chat-sidebar.js";
+export { APP_CHAT_SIDEBAR_STATE_EVENT, APP_CHAT_SIDEBAR_STATE_MESSAGE, APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE, buildAppChatSidebarStateMessage, buildAppChatSidebarStateRequest, isPerAppChatStorageKey, requestPerAppChatCommand, usePerAppChatState, usePerAppChatOpen, } from "../app-chat-sidebar.js";
 export { usePinchZoom } from "../use-pinch-zoom.js";
 export { useAvatarUrl, uploadAvatar, invalidateAvatarCache, } from "../use-avatar.js";
 export { usePollLoop, } from "../use-poll-loop.js";

package/dist/client/i18n.js

@@ -451,6 +451,9 @@ const CORE_FALLBACK_MESSAGES = {
     "runsTray.statusDone": "Done",
     "runsTray.statusFailed": "Failed",
     "runsTray.statusStopped": "Stopped",
+    "runsTray.statusNeedsApproval": "Needs approval",
+    "runsTray.statusNeedsInput": "Needs input",
+    "runsTray.statusPaused": "Paused",
     "runsTray.updatedJustNow": "Updated just now",
     "runsTray.finishedJustNow": "Finished just now",
     "runsTray.updatedMinutes": "Updated {{count}}m ago",
@@ -459,8 +462,8 @@ const CORE_FALLBACK_MESSAGES = {
     "runsTray.finishedHours": "Finished {{count}}h ago",
     "runsTray.updatedDate": "Updated {{date}}",
     "runsTray.finishedDate": "Finished {{date}}",
-    "agentTask.backgroundTask": "Background task",
-    "agentTask.stop": "Stop background task",
+    "agentTask.spawnedAgent": "Spawned agent",
+    "agentTask.stop": "Stop spawned agent",
     "agentTask.openThread": "Open task thread",
     "codeRequired.fallbackDetail": "Edit locally or use Builder.io to edit this code in the cloud and continue customizing the app any way you like.",
     "codeRequired.defaultFeature": "Make the requested code changes to this app",

package/dist/client/progress/RunsTray.js

@@ -24,20 +24,37 @@ function useRunsTrayState({ pollMs = 3000, limit = 5, hideWhenIdle = true, showR
     const includeRecent = showRecent ?? !hideWhenIdle;
     const runsVersion = useChangeVersion("runs");
     const refresh = useCallback(async (signal) => {
-        try {
-            const query = new URLSearchParams({ limit: String(limit) });
-            if (!includeRecent)
-                query.set("active", "true");
-            const res = await fetch(agentNativePath(`/_agent-native/runs?${query.toString()}`), { signal });
-            if (!res.ok)
-                return;
-            const rows = (await res.json());
-            setRuns(rows);
+        const query = new URLSearchParams({ limit: String(limit) });
+        if (!includeRecent)
+            query.set("active", "true");
+        const [legacyResult, backgroundResult] = await Promise.allSettled([
+            fetch(agentNativePath(`/_agent-native/runs?${query.toString()}`), {
+                signal,
+            }),
+            fetch(agentNativePath(`/_agent-native/agent-chat/runs/list?${new URLSearchParams({ limit: String(limit) }).toString()}`), { signal }),
+        ]);
+        const rows = legacyResult.status === "fulfilled" && legacyResult.value.ok
+            ? await readLegacyRuns(legacyResult.value)
+            : null;
+        const backgroundRows = backgroundResult.status === "fulfilled" && backgroundResult.value.ok
+            ? await readBackgroundRuns(backgroundResult.value)
+            : null;
+        const hasSuccessfulResponse = rows !== null || backgroundRows !== null;
+        if (!hasSuccessfulResponse) {
+            return;
         }
-        catch {
-            // coercion-ok: `runs` keeps its last good value rather than being
-            // cleared to an empty tray; the next poll tick retries.
+        const merged = new Map();
+        for (const row of rows ?? [])
+            merged.set(row.id, row);
+        for (const row of backgroundRows ?? []) {
+            const normalized = normalizeBackgroundRun(row);
+            if (includeRecent || normalized.status === "running") {
+                merged.set(normalized.id, normalized);
+            }
         }
+        setRuns([...merged.values()]
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+            .slice(0, limit));
     }, [includeRecent, limit]);
     useEffect(() => {
         void refresh();
@@ -54,7 +71,10 @@ function useRunsTrayState({ pollMs = 3000, limit = 5, hideWhenIdle = true, showR
         enabled: pollMs > 0 || hasActiveRun,
     });
     const dismissRun = useCallback(async (runId) => {
+        const existing = runs.find((run) => run.id === runId);
         setRuns((current) => current.filter((run) => run.id !== runId));
+        if (existing && isBackgroundRun(existing))
+            return;
         try {
             const res = await fetch(agentNativePath(`/_agent-native/runs/${runId}`), {
                 method: "DELETE",
@@ -66,7 +86,7 @@ function useRunsTrayState({ pollMs = 3000, limit = 5, hideWhenIdle = true, showR
         catch {
             refresh();
         }
-    }, [refresh]);
+    }, [refresh, runs]);
     const stopRun = useCallback(async (runId) => {
         // Optimistic: mark as cancelled immediately so the UI is responsive.
         setRuns((current) => current.map((run) => run.id === runId
@@ -179,6 +199,67 @@ function RunsTrayContent({ runs, hasRuns, activeCount, terminalCount, onDismiss,
                                 ? t("runsTray.summaryRecent", { count: runs.length })
                                 : t("runsTray.noTrackedWorkYet") })] }), hasRuns ? (_jsx("div", { className: "max-h-96 divide-y divide-border overflow-y-auto", children: runs.map((run) => (_jsx(RunRow, { run: run, onDismiss: onDismiss, onStop: onStop, onOpenThread: onOpenThread }, run.id))) })) : (_jsxs("div", { className: "px-3 py-6 text-center", children: [_jsx(IconClock, { size: 22, className: "mx-auto text-muted-foreground/50", "aria-hidden": true }), _jsx("div", { className: "mt-2 text-sm font-medium text-foreground", children: t("runsTray.noRecentRuns") }), _jsx("p", { className: "mt-1 text-xs leading-relaxed text-muted-foreground", children: t("runsTray.emptyDescription") })] }))] }));
 }
+async function readLegacyRuns(response) {
+    try {
+        const body = await response.json();
+        return Array.isArray(body) ? body : null;
+    }
+    catch {
+        // coercion-ok: malformed responses return null, distinct from an empty run list.
+        return null;
+    }
+}
+async function readBackgroundRuns(response) {
+    try {
+        const body = await response.json();
+        if (!body || typeof body !== "object" || !("runs" in body))
+            return null;
+        const runs = body.runs;
+        return Array.isArray(runs) ? runs : null;
+    }
+    catch {
+        // coercion-ok: malformed responses return null, distinct from an empty run list.
+        return null;
+    }
+}
+function normalizeBackgroundRun(run) {
+    const metadata = run.metadata ?? {};
+    const threadId = run.sourceRecord?.threadId ??
+        (typeof metadata.threadId === "string" ? metadata.threadId : undefined);
+    const status = run.status === "errored"
+        ? "failed"
+        : run.status === "queued" ||
+            run.status === "running" ||
+            run.status === "needs-input" ||
+            run.status === "needs-approval"
+            ? "running"
+            : "succeeded";
+    return {
+        id: run.id,
+        owner: "",
+        title: run.title,
+        step: run.needsApproval
+            ? "Needs approval"
+            : (run.subtitle ?? (run.status === "paused" ? "Paused" : run.phase)),
+        percent: null,
+        status,
+        startedAt: run.createdAt,
+        updatedAt: run.updatedAt,
+        completedAt: status === "running" ? null : run.updatedAt,
+        metadata: {
+            ...metadata,
+            kind: run.kind,
+            source: run.source,
+            sourceLabel: run.sourceLabel,
+            backgroundStatus: run.status,
+            backgroundGoalId: run.goalId,
+            needsApproval: run.needsApproval,
+            needsInput: run.needsInput,
+            ...(run.surfaceUrl ? { surfaceUrl: run.surfaceUrl } : {}),
+            ...(threadId ? { threadId } : {}),
+        },
+    };
+}
 function getRunThreadId(run) {
     const metadata = run.metadata ?? {};
     const direct = typeof metadata.threadId === "string"
@@ -223,13 +304,20 @@ function isAgentTeamRun(run) {
         run.metadata !== null &&
         run.metadata.kind === "agent-team");
 }
+function isBackgroundRun(run) {
+    return (typeof run.metadata === "object" &&
+        run.metadata !== null &&
+        typeof run.metadata.backgroundStatus ===
+            "string");
+}
 function RunRow({ run, onDismiss, onStop, onOpenThread, }) {
     const t = useT();
     const { formatDate } = useFormatters();
     const threadId = getRunThreadId(run);
     const isRunning = run.status === "running";
-    const canStop = isRunning && isAgentTeamRun(run);
-    return (_jsxs("div", { className: "flex flex-col gap-1.5 px-3 py-2.5 text-sm", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "truncate font-medium text-foreground", children: run.title }), run.step ? (_jsx("div", { className: "mt-0.5 truncate text-xs text-muted-foreground", children: run.step })) : null] }), _jsx(StatusPill, { status: run.status })] }), run.percent != null || isRunning ? (_jsx("div", { className: "h-1 w-full overflow-hidden rounded bg-muted", children: run.percent != null ? (_jsx("div", { className: cn("h-full origin-left transition-transform duration-200 ease-[var(--ease-collapse)]", run.status === "failed"
+    const canStop = isRunning && (isAgentTeamRun(run) || isBackgroundRun(run));
+    const backgroundStatus = getBackgroundStatus(run);
+    return (_jsxs("div", { className: "flex flex-col gap-1.5 px-3 py-2.5 text-sm", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "truncate font-medium text-foreground", children: run.title }), run.step ? (_jsx("div", { className: "mt-0.5 truncate text-xs text-muted-foreground", children: run.step })) : null] }), _jsx(StatusPill, { status: run.status, backgroundStatus: backgroundStatus })] }), run.percent != null || isRunning ? (_jsx("div", { className: "h-1 w-full overflow-hidden rounded bg-muted", children: run.percent != null ? (_jsx("div", { className: cn("h-full origin-left transition-transform duration-200 ease-[var(--ease-collapse)]", run.status === "failed"
                         ? "bg-destructive"
                         : run.status === "cancelled"
                             ? "bg-muted-foreground/50"
@@ -250,12 +338,37 @@ const STATUS_PILL_STYLES = {
     failed: "bg-destructive/10 text-destructive",
     cancelled: "bg-muted text-muted-foreground",
 };
-function StatusPill({ status }) {
+function StatusPill({ status, backgroundStatus, }) {
     const t = useT();
+    if (backgroundStatus === "needs-approval") {
+        return (_jsxs("span", { className: "inline-flex h-5 shrink-0 items-center gap-1 rounded-md bg-primary/10 px-1.5 text-[10px] font-medium text-primary", children: [_jsx(IconAlertCircle, { size: 12, "aria-hidden": true }), t("runsTray.statusNeedsApproval", { defaultValue: "Needs approval" })] }));
+    }
+    if (backgroundStatus === "needs-input") {
+        return (_jsxs("span", { className: "inline-flex h-5 shrink-0 items-center gap-1 rounded-md bg-primary/10 px-1.5 text-[10px] font-medium text-primary", children: [_jsx(IconAlertCircle, { size: 12, "aria-hidden": true }), t("runsTray.statusNeedsInput", { defaultValue: "Needs input" })] }));
+    }
+    if (backgroundStatus === "paused") {
+        return (_jsxs("span", { className: "inline-flex h-5 shrink-0 items-center gap-1 rounded-md bg-muted px-1.5 text-[10px] font-medium text-muted-foreground", children: [_jsx(IconClock, { size: 12, "aria-hidden": true }), t("runsTray.statusPaused", { defaultValue: "Paused" })] }));
+    }
     const { Icon, className } = STATUS_GLYPHS[status];
     const spinClass = status === "running" ? " animate-spin" : "";
     return (_jsxs("span", { className: cn("inline-flex h-5 shrink-0 items-center gap-1 rounded-md px-1.5 text-[10px] font-medium", STATUS_PILL_STYLES[status]), children: [_jsx(Icon, { size: 12, className: `${className}${spinClass}`, "aria-hidden": true }), t(STATUS_COPY_KEYS[status])] }));
 }
+function getBackgroundStatus(run) {
+    const value = run.metadata?.backgroundStatus;
+    return typeof value === "string" && isBackgroundStatus(value)
+        ? value
+        : undefined;
+}
+function isBackgroundStatus(value) {
+    return (value === "queued" ||
+        value === "running" ||
+        value === "paused" ||
+        value === "needs-input" ||
+        value === "needs-approval" ||
+        value === "completed" ||
+        value === "errored" ||
+        value === "unknown");
+}
 // dark: variants only where there's no semantic token for the colour
 // (e.g. success green isn't in shadcn's default palette).
 const STATUS_GLYPHS = {

package/dist/client/settings/SettingsRow.js

@@ -12,5 +12,5 @@ export function SettingsGroup({ id, title, description, variant = "default", cla
 }
 /** One setting: label and description on the start side, control on the end. */
 export function SettingsRow({ id, label, description, icon, status, control, children, className, }) {
-    return (_jsxs("div", { id: id, className: cn("scroll-mt-16 px-5 py-4 sm:px-6", className), children: [_jsxs("div", { className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { className: "flex min-w-0 gap-3", children: [icon && (_jsx("span", { className: "mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-md border border-border bg-background text-muted-foreground [&>svg]:size-[18px]", children: icon })), _jsxs("div", { className: "min-w-0", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx("span", { className: "text-sm font-medium text-foreground", children: label }), status] }), description && (_jsx("p", { className: "mt-1 max-w-xl text-sm leading-6 text-muted-foreground", children: description }))] })] }), control && (_jsx("div", { className: "shrink-0 sm:ms-4 sm:text-end", children: control }))] }), children && _jsx("div", { className: "mt-4", children: children })] }));
+    return (_jsxs("div", { id: id, className: cn("agent-native-settings-row scroll-mt-16 px-5 py-4 sm:px-6", className), children: [_jsxs("div", { className: "agent-native-settings-row__layout flex flex-col gap-3", children: [_jsxs("div", { className: "agent-native-settings-row__main flex min-w-0 flex-1 gap-3", children: [icon && (_jsx("span", { className: "mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-md border border-border bg-background text-muted-foreground [&>svg]:size-[18px]", children: icon })), _jsxs("div", { className: "min-w-0", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx("span", { className: "text-sm font-medium text-foreground", children: label }), status] }), description && (_jsx("p", { className: "mt-1 max-w-xl text-sm leading-6 text-muted-foreground", children: description }))] })] }), control && (_jsx("div", { className: "agent-native-settings-row__control max-w-full shrink-0", children: control }))] }), children && _jsx("div", { className: "mt-4", children: children })] }));
 }

package/dist/client/use-chat-threads.js

@@ -467,10 +467,9 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
     //   it; the server hasn't seen it yet because there's no POST anymore,
     //   the row gets written when the user sends a message.
     // - savedId is set but not on the current page → look it up directly. A
-    //   found thread stays active. An auto-creating surface replaces a confirmed
-    //   404 with a fresh local tab rather than reusing an inaccessible server id.
-    //   A list-only surface keeps the saved id as an optimistic empty tab so a
-    //   never-posted tab remains selectable after reload.
+    //   found thread stays active. An unavailable lookup keeps the saved id so
+    //   the detail surface can preserve cached state and offer recovery instead
+    //   of replacing a shared/reopened conversation with a blank local tab.
     // - No savedId → synthesize a fresh local id (no POST; server creates the
     //   row on first message). The server may contain chats from another
     //   branch, preview, or project that shares the same user/database, so
@@ -512,7 +511,12 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             const restoredIsUnavailable = restoredThread === null && lookupRestored && !restoredOnPage;
             const restoredBelongsElsewhere = Boolean(restoredThread &&
                 !threadCanStayVisibleInScope(restoredThread.scope ?? null, scopeRef.current));
-            const restoredNeedsReplacement = restoredBelongsElsewhere || (restoredIsUnavailable && autoCreate);
+            // Keep the saved id when the direct lookup says 404. AssistantChat owns
+            // the detail restore and can show a retryable error while preserving any
+            // cached transcript or composer draft. Replacing the id here silently
+            // turns a shared/reopened conversation into a new blank chat after the
+            // slower lookup finishes.
+            const restoredNeedsReplacement = restoredBelongsElsewhere;
             if (restoredNeedsReplacement)
                 setActiveThreadId(null);
             const savedId = restoredNeedsReplacement ? null : restoredId;
@@ -534,7 +538,8 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             }
             else if (savedId &&
                 !newlyCreatedRef.current.has(savedId) &&
-                !loadedHasSavedId) {
+                !loadedHasSavedId &&
+                !restoredIsUnavailable) {
                 // The tab the user left open isn't a server thread and we didn't
                 // create it this session (newlyCreatedRef was wiped by the
                 // reload). Treat it as the empty tab it is — keep its id and

package/dist/config.d.ts

@@ -59,6 +59,16 @@ export interface AgentNativeChangelogConfig {
     /** Whether agents should create and surface user-facing changelog entries. */
     enabled?: boolean;
 }
+export type AgentNativeHarnessRuntime = "claude-code" | "codex" | "pi" | "opencode";
+export interface AgentNativeHarnessConfig {
+    /** Optionally narrow the hosted harness picker to these runtimes. */
+    runtimes?: AgentNativeHarnessRuntime[];
+}
+/**
+ * The intentionally small app-level switch for hosted tools-only harnesses.
+ * `true` enables every supported runtime; an object narrows the picker.
+ */
+export type AgentNativeHarnessSetting = boolean | AgentNativeHarnessConfig;
 export interface AgentNativeConfig {
     version?: typeof AGENT_NATIVE_CONFIG_VERSION;
     onboarding?: AgentNativeOnboardingConfig;
@@ -67,6 +77,7 @@ export interface AgentNativeConfig {
     instructions?: AgentNativeInstructionsConfig;
     translations?: AgentNativeTranslationsConfig;
     changelog?: AgentNativeChangelogConfig;
+    harness?: AgentNativeHarnessSetting;
 }
 export interface AgentNativeConfigContext {
     command: "serve" | "build";

package/dist/config.js

@@ -30,6 +30,7 @@ export function normalizeAgentNativeConfig(input, source = "agent-native config"
     const instructionsValue = input.instructions;
     const translationsValue = input.translations;
     const changelogValue = input.changelog;
+    const harnessValue = input.harness;
     const normalized = {
         ...(input.version === undefined
             ? {}
@@ -57,6 +58,9 @@ export function normalizeAgentNativeConfig(input, source = "agent-native config"
     if (changelogValue !== undefined) {
         normalized.changelog = normalizeChangelogConfig(changelogValue, `${source}.changelog`);
     }
+    if (harnessValue !== undefined) {
+        normalized.harness = normalizeHarnessConfig(harnessValue, `${source}.harness`);
+    }
     return normalized;
 }
 export function mergeAgentNativeConfigs(base, override) {
@@ -128,6 +132,7 @@ export function mergeAgentNativeConfigs(base, override) {
                 ...override.changelog,
             }
             : undefined,
+        harness: mergeHarnessSettings(base.harness, override.harness),
     };
 }
 export function resolveAgentNativeConfig(input, context) {
@@ -254,6 +259,47 @@ function normalizeChangelogConfig(value, source) {
     }
     return value.enabled === undefined ? {} : { enabled: value.enabled };
 }
+function normalizeHarnessConfig(value, source) {
+    if (typeof value === "boolean")
+        return value;
+    if (!isRecord(value)) {
+        throw new Error(`${source} must be a boolean or object`);
+    }
+    if ("enabled" in value || "ui" in value) {
+        throw new Error(`${source} must be true or an object with runtimes`);
+    }
+    const runtimes = value.runtimes;
+    if (runtimes !== undefined) {
+        if (!Array.isArray(runtimes) ||
+            runtimes.some((runtime) => !isAgentNativeHarnessRuntime(runtime))) {
+            throw new Error(`${source}.runtimes must contain only "claude-code", "codex", "pi", or "opencode"`);
+        }
+    }
+    return {
+        ...(runtimes === undefined
+            ? {}
+            : { runtimes: [...new Set(runtimes)] }),
+    };
+}
+function mergeHarnessSettings(base, override) {
+    if (override === undefined)
+        return base;
+    if (typeof override === "boolean")
+        return override;
+    if (typeof base !== "object" || base === null)
+        return override;
+    if (base.runtimes === undefined && override.runtimes === undefined) {
+        return {};
+    }
+    return {
+        runtimes: [
+            ...new Set([
+                ...(base.runtimes ?? []),
+                ...(override.runtimes ?? []),
+            ]),
+        ],
+    };
+}
 function normalizeRelativeFilePath(value, source) {
     const normalized = value.trim().replaceAll("\\", "/");
     if (!normalized ||
@@ -286,6 +332,12 @@ function isFirstRunMode(value) {
         value === "connect" ||
         value === "connect-and-integrations");
 }
+function isAgentNativeHarnessRuntime(value) {
+    return (value === "claude-code" ||
+        value === "codex" ||
+        value === "pi" ||
+        value === "opencode");
+}
 function isRecord(value) {
     return !!value && typeof value === "object" && !Array.isArray(value);
 }