@agent-native/core 0.157.8 → 0.157.10

package/dist/client/ConnectBuilderCard.js

@@ -5,6 +5,7 @@ import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js
 import { agentNativePath } from "./api-path.js";
 import { BuilderBMark } from "./builder-mark.js";
 import { writeClipboardText } from "./clipboard.js";
+import { requestDesktopLocalCodeChange } from "./desktop-local-code-change.js";
 import { getCallbackOrigin } from "./frame.js";
 import { useBuilderConnectFlow } from "./settings/useBuilderStatus.js";
 import { cn } from "./utils.js";
@@ -18,6 +19,12 @@ function isLocalDevelopment() {
     const hostname = window.location.hostname;
     return (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1");
 }
+function hasElectronShellBridge() {
+    if (typeof window === "undefined")
+        return false;
+    const electronApi = window.electronAPI;
+    return Boolean(electronApi?.appConfig);
+}
 /**
  * Rich inline card rendered for the `connect-builder` tool call. Shows the
  * Builder handoff when available, or routes local development requests to the
@@ -48,7 +55,9 @@ export function ConnectBuilderCard({ configured: initialConfigured, builderEnabl
     const [sendErr, setSendErr] = useState(null);
     const [copyErr, setCopyErr] = useState(null);
     const [promptCopied, setPromptCopied] = useState(false);
+    const [localCodeChangeRequested, setLocalCodeChangeRequested] = useState(false);
     const [localDevelopment] = useState(() => isLocalDevelopment());
+    const [electronShell] = useState(() => hasElectronShellBridge());
     const mountedRef = useRef(true);
     const copyResetRef = useRef(null);
     // Tracks whether the user clicked "Connect Builder" *this session*. When
@@ -154,6 +163,12 @@ export function ConnectBuilderCard({ configured: initialConfigured, builderEnabl
     const err = sendErr ?? waitlistErr ?? copyErr ?? flow.error;
     const hasPrompt = prompt.trim().length > 0;
     const canSend = configured && builderEnabled && hasPrompt;
+    const showDesktopLocalHandoff = electronShell && hasPrompt;
+    const handleDoLocally = useCallback((event) => {
+        if (requestDesktopLocalCodeChange(prompt, event.currentTarget)) {
+            setLocalCodeChangeRequested(true);
+        }
+    }, [prompt]);
     // Auto-send the user's pending prompt the moment connecting finishes
     // successfully. Without this, the connect popup closing leaves the user
     // staring at a "Send to Builder" button — feels like they have to
@@ -181,14 +196,19 @@ export function ConnectBuilderCard({ configured: initialConfigured, builderEnabl
         : `AI credits are ready to use. ${CODE_CHANGE_FALLBACK_TEXT}`;
     let title;
     let subtitle;
-    if (runResult) {
+    if (localCodeChangeRequested) {
+        title = "Preparing a local copy";
+        subtitle = "Desktop is cloning this app and applying this request.";
+    }
+    else if (runResult) {
         title = "Builder is working on it";
         subtitle = (_jsxs(_Fragment, { children: ["Working on branch", " ", _jsx("span", { className: "font-mono text-foreground", children: runResult.branchName }), ". Click through to watch progress in the Visual Editor."] }));
     }
     else if (showExternalAgentHandoff) {
         title = "This requires a code change";
-        subtitle =
-            "Open your coding agent in this project, then paste this request.";
+        subtitle = showDesktopLocalHandoff
+            ? "Make the change in a local copy of this app, or copy the request to another coding agent."
+            : "Open your coding agent in this project, then paste this request.";
     }
     else if (showWaitlist) {
         title = "This requires a code change";
@@ -206,8 +226,16 @@ export function ConnectBuilderCard({ configured: initialConfigured, builderEnabl
         title = "Connect Builder.io";
         subtitle = _jsx(_Fragment, { children: "Builder.io's free tier includes AI credits." });
     }
-    return (_jsx("div", { className: cn("my-2 rounded-lg border border-border overflow-hidden"), children: _jsxs("div", { className: "flex items-start gap-3 px-4 py-3.5 bg-gradient-to-br from-teal-500/5 via-transparent to-transparent", children: [_jsx("div", { className: cn("flex h-9 w-9 shrink-0 items-center justify-center rounded-lg", "bg-foreground text-background"), children: runResult ? (_jsx(IconLoader2, { className: "h-5 w-5 animate-spin" })) : showExternalAgentHandoff ? (_jsx(IconCode, { className: "h-5 w-5" })) : (_jsx(BuilderBMark, { className: "h-5 w-5" })) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("div", { className: "flex items-center gap-2 flex-wrap", children: _jsx("span", { className: "text-sm font-semibold text-foreground", children: title }) }), _jsx("div", { className: "mt-0.5 text-xs text-muted-foreground leading-relaxed", children: subtitle }), showWaitlist && (_jsxs("a", { href: DESKTOP_DOWNLOAD_URL, target: "_blank", rel: "noopener noreferrer", className: "mt-2 inline-flex items-center gap-1 text-[11px] font-medium text-muted-foreground no-underline hover:text-foreground", children: ["Download desktop app", _jsx(IconExternalLink, { className: "h-3 w-3" })] })), err && _jsx("div", { className: "mt-2 text-xs text-destructive", children: err }), _jsx("div", { className: "mt-3", children: runResult ? (_jsxs("a", { href: withBuilderUtmTrackingParams(runResult.url, {
+    return (_jsx("div", { className: cn("my-2 rounded-lg border border-border overflow-hidden"), children: _jsxs("div", { className: "flex items-start gap-3 px-4 py-3.5 bg-gradient-to-br from-teal-500/5 via-transparent to-transparent", children: [_jsx("div", { className: cn("flex h-9 w-9 shrink-0 items-center justify-center rounded-lg", "bg-foreground text-background"), children: runResult ? (_jsx(IconLoader2, { className: "h-5 w-5 animate-spin" })) : showExternalAgentHandoff ? (_jsx(IconCode, { className: "h-5 w-5" })) : (_jsx(BuilderBMark, { className: "h-5 w-5" })) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("div", { className: "flex items-center gap-2 flex-wrap", children: _jsx("span", { className: "text-sm font-semibold text-foreground", children: title }) }), _jsx("div", { className: "mt-0.5 text-xs text-muted-foreground leading-relaxed", children: subtitle }), showWaitlist && !showDesktopLocalHandoff && (_jsxs("a", { href: DESKTOP_DOWNLOAD_URL, target: "_blank", rel: "noopener noreferrer", className: "mt-2 inline-flex items-center gap-1 text-[11px] font-medium text-muted-foreground no-underline hover:text-foreground", children: ["Download desktop app", _jsx(IconExternalLink, { className: "h-3 w-3" })] })), err && _jsx("div", { className: "mt-2 text-xs text-destructive", children: err }), _jsx("div", { className: "mt-3", children: runResult ? (_jsxs("a", { href: withBuilderUtmTrackingParams(runResult.url, {
                                     campaign: "product",
                                     content: "connect_builder_card_branch",
-                                }), target: "_blank", rel: "noopener noreferrer", className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90"), children: ["Open branch in Builder", _jsx(IconExternalLink, { className: "h-3.5 w-3.5" })] })) : canSend ? (_jsx("button", { type: "button", onClick: handleSend, disabled: sending, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90", sending && "opacity-70 cursor-wait"), children: sending ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Sending to Builder\u2026"] })) : (_jsx(_Fragment, { children: "Send to Builder" })) })) : showExternalAgentHandoff ? (_jsx("button", { type: "button", onClick: () => void handleCopyPrompt(), className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90"), children: promptCopied ? (_jsxs(_Fragment, { children: [_jsx(IconCheck, { className: "h-3.5 w-3.5" }), "Prompt copied"] })) : (_jsxs(_Fragment, { children: [_jsx(IconCopy, { className: "h-3.5 w-3.5" }), "Copy prompt"] })) })) : showWaitlist && !waitlistJoined ? (_jsx("button", { type: "button", onClick: handleJoinWaitlist, disabled: joiningWaitlist, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90", joiningWaitlist && "opacity-70 cursor-wait"), children: joiningWaitlist ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Joining\u2026"] })) : (_jsx(_Fragment, { children: "Join the waitlist" })) })) : !configured ? (_jsx("button", { type: "button", onClick: () => flow.start(), disabled: connecting, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90", connecting && "opacity-70 cursor-wait"), children: connecting ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Waiting for Builder\u2026"] })) : ("Connect Builder") })) : null })] })] }) }));
+                                }), target: "_blank", rel: "noopener noreferrer", className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90"), children: ["Open branch in Builder", _jsx(IconExternalLink, { className: "h-3.5 w-3.5" })] })) : canSend ? (_jsxs("div", { className: "flex flex-wrap gap-2", children: [showDesktopLocalHandoff && (_jsxs("button", { type: "button", "data-desktop-local-code-change": true, onClick: handleDoLocally, disabled: localCodeChangeRequested, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", localCodeChangeRequested && "cursor-wait opacity-70"), children: [localCodeChangeRequested ? (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(IconCode, { className: "h-3.5 w-3.5" })), localCodeChangeRequested
+                                                ? "Preparing locally…"
+                                                : "Do locally"] })), _jsx("button", { type: "button", onClick: handleSend, disabled: sending, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90", sending && "opacity-70 cursor-wait"), children: sending ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Sending to Builder\u2026"] })) : (_jsx(_Fragment, { children: "Send to Builder" })) })] })) : showExternalAgentHandoff ? (_jsxs("div", { className: "flex flex-wrap gap-2", children: [showDesktopLocalHandoff && (_jsxs("button", { type: "button", "data-desktop-local-code-change": true, onClick: handleDoLocally, disabled: localCodeChangeRequested, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90", localCodeChangeRequested && "cursor-wait opacity-70"), children: [localCodeChangeRequested ? (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(IconCode, { className: "h-3.5 w-3.5" })), localCodeChangeRequested
+                                                ? "Preparing locally…"
+                                                : "Do locally"] })), _jsx("button", { type: "button", onClick: () => void handleCopyPrompt(), className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent"), children: promptCopied ? (_jsxs(_Fragment, { children: [_jsx(IconCheck, { className: "h-3.5 w-3.5" }), "Prompt copied"] })) : (_jsxs(_Fragment, { children: [_jsx(IconCopy, { className: "h-3.5 w-3.5" }), "Copy prompt"] })) })] })) : showWaitlist && !waitlistJoined ? (_jsxs("div", { className: "flex flex-wrap gap-2", children: [showDesktopLocalHandoff && (_jsxs("button", { type: "button", "data-desktop-local-code-change": true, onClick: handleDoLocally, disabled: localCodeChangeRequested, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90", localCodeChangeRequested && "cursor-wait opacity-70"), children: [localCodeChangeRequested ? (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(IconCode, { className: "h-3.5 w-3.5" })), localCodeChangeRequested
+                                                ? "Preparing locally…"
+                                                : "Do locally"] })), _jsx("button", { type: "button", onClick: handleJoinWaitlist, disabled: joiningWaitlist, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", joiningWaitlist && "opacity-70 cursor-wait"), children: joiningWaitlist ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Joining\u2026"] })) : (_jsx(_Fragment, { children: "Join the waitlist" })) })] })) : !configured ? (_jsxs("div", { className: "flex flex-wrap gap-2", children: [showDesktopLocalHandoff && (_jsxs("button", { type: "button", "data-desktop-local-code-change": true, onClick: handleDoLocally, disabled: localCodeChangeRequested, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "bg-foreground text-background hover:bg-foreground/90", localCodeChangeRequested && "cursor-wait opacity-70"), children: [localCodeChangeRequested ? (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(IconCode, { className: "h-3.5 w-3.5" })), localCodeChangeRequested
+                                                ? "Preparing locally…"
+                                                : "Do locally"] })), _jsx("button", { type: "button", onClick: () => flow.start(), disabled: connecting, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", connecting && "opacity-70 cursor-wait"), children: connecting ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), "Waiting for Builder\u2026"] })) : ("Connect Builder") })] })) : showDesktopLocalHandoff ? (_jsxs("button", { type: "button", "data-desktop-local-code-change": true, onClick: handleDoLocally, disabled: localCodeChangeRequested, className: cn("inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-accent", localCodeChangeRequested && "cursor-wait opacity-70"), children: [localCodeChangeRequested ? (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(IconCode, { className: "h-3.5 w-3.5" })), localCodeChangeRequested ? "Preparing locally…" : "Do locally"] })) : null })] })] }) }));
 }

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

@@ -1,7 +1,9 @@
 import { unwrapAttachmentEnvelope } from "@agent-native/toolkit/composer/pasted-text";
 import { actionPreparationContinuationNote } from "../agent/action-continuation-guidance.js";
 import { LLM_MISSING_CREDENTIALS_ERROR_CODE, LLM_MISSING_CREDENTIALS_MESSAGE, } from "../agent/engine/credential-errors.js";
+import { ANALYTICS_CLIENT_PLATFORM_HEADER } from "../shared/analytics-platform.js";
 import { clearPendingTurnIfMatches, getActiveRun, setActiveRun, updateActiveRunSeq, clearActiveRun, clearActiveRunIfMatches, setPendingTurn, } from "./active-run-state.js";
+import { getAnalyticsClientPlatform } from "./analytics-platform.js";
 import { getOrCreateAnalyticsSessionId } from "./analytics-session.js";
 import { captureError } from "./analytics.js";
 import { agentNativePath } from "./api-path.js";
@@ -2000,6 +2002,8 @@ export function createAgentChatAdapter(options) {
                 catch {
                     // Analytics session unavailable — traces just lose replay linkage.
                 }
+                headers[ANALYTICS_CLIENT_PLATFORM_HEADER] =
+                    getAnalyticsClientPlatform();
                 // Surface hint — the server uses this to keep code-editing dev tools
                 // out of the app-rendered sidebar. The outer dev frame passes
                 // "dev-frame" explicitly; the reusable in-product chat defaults to

package/dist/client/analytics-platform.d.ts

@@ -0,0 +1,2 @@
+import { type AnalyticsClientPlatform } from "../shared/analytics-platform.js";
+export declare function getAnalyticsClientPlatform(configured?: AnalyticsClientPlatform): AnalyticsClientPlatform;

package/dist/client/analytics-platform.js

@@ -0,0 +1,12 @@
+import { normalizeAnalyticsClientPlatform, } from "../shared/analytics-platform.js";
+export function getAnalyticsClientPlatform(configured) {
+    if (configured)
+        return configured;
+    if (typeof window === "undefined")
+        return "web";
+    const platformWindow = window;
+    return (normalizeAnalyticsClientPlatform(platformWindow.agentNativeDesktop?.analytics?.clientPlatform) ??
+        normalizeAnalyticsClientPlatform(platformWindow.__AGENT_NATIVE_HOST_PLATFORM__) ??
+        normalizeAnalyticsClientPlatform(platformWindow.__AGENT_NATIVE_CONFIG__?.clientPlatform) ??
+        "web");
+}

package/dist/client/analytics.d.ts

@@ -1,3 +1,4 @@
+import { type AnalyticsClientPlatform } from "../shared/analytics-platform.js";
 export { clearAnalyticsSessionId, setAnalyticsSessionId, } from "./analytics-session.js";
 import type { SessionReplayOptions, SessionReplayStartResult } from "./session-replay.js";
 export { scrubUrl } from "./url-scrub.js";
@@ -51,6 +52,8 @@ export type ErrorCaptureConfigOptions = {
     maxBreadcrumbs?: number;
 };
 export type ConfigureTrackingOptions = {
+    /** Platform attribution attached to every event emitted by this client. */
+    clientPlatform?: AnalyticsClientPlatform;
     /**
      * Agent Native first-party analytics public key. This mirrors hosted
      * analytics SDKs where consumers pass the key at setup time instead of

package/dist/client/analytics.js

@@ -1,5 +1,7 @@
+import { ANALYTICS_CLIENT_PLATFORM_PROPERTY, } from "../shared/analytics-platform.js";
 import { llmConnectionTrackingProperties, } from "../shared/llm-connection.js";
 import { toPostHogExceptionProperties } from "../tracking/posthog-exception.js";
+import { getAnalyticsClientPlatform } from "./analytics-platform.js";
 import { getOrCreateAnalyticsAnonymousId, getOrCreateAnalyticsSessionId, } from "./analytics-session.js";
 export { clearAnalyticsSessionId, setAnalyticsSessionId, } from "./analytics-session.js";
 import { fetchAgentEngineStatus, fetchAuthSessionStatus, } from "./client-status-requests.js";
@@ -10,6 +12,7 @@ export { scrubUrl } from "./url-scrub.js";
 export { addErrorBreadcrumb, captureException, captureMessage, isErrorCaptureInstalled, } from "./error-capture.js";
 export { getSessionReplayContext, getSessionReplayUrl, } from "./session-replay.js";
 let _getDefaultProps = null;
+let _configuredAnalyticsClientPlatform = null;
 let _agentNativeAnalyticsPublicKey = null;
 let _agentNativeAnalyticsEndpoint = null;
 let _amplitudeInitialized = false;
@@ -934,6 +937,9 @@ export function trackAgentChatLifecycle(input) {
     })();
 }
 export function configureTracking(options) {
+    if (options.clientPlatform) {
+        _configuredAnalyticsClientPlatform = options.clientPlatform;
+    }
     const publicKey = options.key || options.publicKey;
     if (publicKey) {
         _agentNativeAnalyticsPublicKey = publicKey;
@@ -1413,7 +1419,10 @@ function resolveProps(name, params) {
         if (enriched[key] === undefined)
             enriched[key] = value;
     }
-    return applyTrackingIdentity(enriched);
+    return {
+        ...applyTrackingIdentity(enriched),
+        [ANALYTICS_CLIENT_PLATFORM_PROPERTY]: getAnalyticsClientPlatform(_configuredAnalyticsClientPlatform ?? undefined),
+    };
 }
 function sessionReplayTrackingProperties() {
     const module = _sessionReplayModuleForCapture;

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

@@ -11,6 +11,7 @@ export * from "./runtime.js";
 export { sendToAgentChat, sendToAgentChatAndConfirm, reportAgentChatSubmitResult, AGENT_CHAT_SUBMIT_RESULT_EVENT, type AgentChatMessage, type AgentChatSubmitResult, type SendToAgentChatAndConfirmResult, } from "../agent-chat.js";
 export { useAgentChatGenerating } from "../use-agent-chat.js";
 export { useSendToAgentChat } from "../use-send-to-agent-chat.js";
+export { DESKTOP_LOCAL_CODE_CHANGE_EVENT, requestDesktopLocalCodeChange, type DesktopLocalCodeChangeDetail, } from "../desktop-local-code-change.js";
 export { AGENT_SIDEBAR_DEFAULT_MAX_WIDTH, AGENT_SIDEBAR_MIN_WIDTH, AGENT_SIDEBAR_WIDE_WIDTH_RATIO, clampAgentSidebarWidth, getAgentSidebarMaxWidth, getAgentSidebarWideWidth, requestAgentSidebarOpen, SIDEBAR_STATE_CHANGE_EVENT, setAgentSidebarOpenPreference, type AgentSidebarStateChangeDetail, type AgentSidebarStateMode, type AgentSidebarStateSource, } from "../agent-sidebar-state.js";
 export { clearReservedToolRenderersForTests, clearToolRenderersForTests, registerActionChatRenderer, registerFallbackToolRenderer, registerReservedActionChatRenderer, registerReservedFallbackToolRenderer, registerReservedToolRenderer, registerToolRenderer, resolveToolRenderer, type ActionChatRendererRegistration, type ToolRendererComponent, type ToolRendererContext, type ToolRendererMatch, type ToolRendererProps, type ToolRendererRegistration, } from "./tool-render-registry.js";
 export { ACTION_CHAT_UI_DATA_CHART_RENDERER, ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER, ACTION_CHAT_UI_DATA_TABLE_RENDERER, ACTION_CHAT_UI_DATA_WIDGET_RENDERER, ACTION_CHAT_UI_INLINE_EXTENSION_RENDERER, ACTION_CHAT_UI_WORKSPACE_FILE_RENDERER, type ActionChatUIConfig, } from "../../action-ui.js";

package/dist/client/chat/index.js

@@ -11,6 +11,7 @@ export * from "./runtime.js";
 export { sendToAgentChat, sendToAgentChatAndConfirm, reportAgentChatSubmitResult, AGENT_CHAT_SUBMIT_RESULT_EVENT, } from "../agent-chat.js";
 export { useAgentChatGenerating } from "../use-agent-chat.js";
 export { useSendToAgentChat } from "../use-send-to-agent-chat.js";
+export { DESKTOP_LOCAL_CODE_CHANGE_EVENT, requestDesktopLocalCodeChange, } from "../desktop-local-code-change.js";
 export { AGENT_SIDEBAR_DEFAULT_MAX_WIDTH, AGENT_SIDEBAR_MIN_WIDTH, AGENT_SIDEBAR_WIDE_WIDTH_RATIO, clampAgentSidebarWidth, getAgentSidebarMaxWidth, getAgentSidebarWideWidth, requestAgentSidebarOpen, SIDEBAR_STATE_CHANGE_EVENT, setAgentSidebarOpenPreference, } from "../agent-sidebar-state.js";
 export { clearReservedToolRenderersForTests, clearToolRenderersForTests, registerActionChatRenderer, registerFallbackToolRenderer, registerReservedActionChatRenderer, registerReservedFallbackToolRenderer, registerReservedToolRenderer, registerToolRenderer, resolveToolRenderer, } from "./tool-render-registry.js";
 export { ACTION_CHAT_UI_DATA_CHART_RENDERER, ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER, ACTION_CHAT_UI_DATA_TABLE_RENDERER, ACTION_CHAT_UI_DATA_WIDGET_RENDERER, ACTION_CHAT_UI_INLINE_EXTENSION_RENDERER, ACTION_CHAT_UI_WORKSPACE_FILE_RENDERER, } from "../../action-ui.js";

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

@@ -31,6 +31,7 @@ export declare const MessageActionsContext: React.Context<{
      */
     bannerRunErrorKey?: string | null;
 } | null>;
+export declare function isLocalDevelopmentHost(hostname: string): boolean;
 /**
  * Restore rewrites the working tree, so only offer it when the server actually
  * has a checkpoint for this turn. Auto-checkpointing skips turns that started
@@ -43,6 +44,7 @@ export declare function shouldOfferRestore(args: {
     isLast: boolean;
     runId: string | undefined;
     checkpointRunIds: ReadonlySet<string> | undefined;
+    hostname: string;
 }): boolean;
 /**
  * Live yields put the run id at `metadata.custom.runId`; server-persisted

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

@@ -156,6 +156,14 @@ export function SelectionAttachedPill() {
 // ─── CheckpointContext / MessageActionsContext ────────────────────────────────
 export const CheckpointContext = React.createContext(null);
 export const MessageActionsContext = React.createContext(null);
+export function isLocalDevelopmentHost(hostname) {
+    const normalizedHostname = hostname.trim().toLowerCase();
+    return (normalizedHostname === "localhost" ||
+        normalizedHostname === "127.0.0.1" ||
+        normalizedHostname === "0.0.0.0" ||
+        normalizedHostname === "::1" ||
+        normalizedHostname === "[::1]");
+}
 /**
  * Restore rewrites the working tree, so only offer it when the server actually
  * has a checkpoint for this turn. Auto-checkpointing skips turns that started
@@ -163,7 +171,8 @@ export const MessageActionsContext = React.createContext(null);
  * "Revert to here" item on turns where clicking it could do nothing.
  */
 export function shouldOfferRestore(args) {
-    return Boolean(args.devMode &&
+    return Boolean(isLocalDevelopmentHost(args.hostname) &&
+        args.devMode &&
         args.isComplete &&
         !args.isLast &&
         args.runId &&
@@ -1018,6 +1027,7 @@ export function AssistantMessage() {
         isLast,
         runId: messageRunId,
         checkpointRunIds: cpCtx?.checkpointRunIds,
+        hostname: window.location.hostname,
     });
     // Collect parts for the files-changed summary (code-agent turns only).
     const msgContent = msg.content;

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

@@ -33,9 +33,10 @@ export declare function BuilderSetupContent({ onConnected, layout, }: {
     onConnected?: () => void;
     layout?: BuilderSetupCardLayout;
 }): import("react").JSX.Element;
-export declare function BuilderSetupCard({ onConnected, bouncePulse, fullWidth, layout, }: {
+export declare function BuilderSetupCard({ onConnected, bouncePulse, attached, fullWidth, layout, }: {
     onConnected?: () => void;
     bouncePulse?: number;
+    attached?: boolean;
     fullWidth?: boolean;
     layout?: BuilderSetupCardLayout;
 }): import("react").JSX.Element;

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

@@ -165,7 +165,7 @@ export function BuilderSetupContent({ onConnected, layout = "default", }) {
                                     defaultValue: "Custom keys",
                                 }) })] })] }), keyOpen ? (_jsx("div", { className: "mt-3", children: _jsx(ApiKeyConnect, { onConnected: onConnected }) })) : null] }));
 }
-export function BuilderSetupCard({ onConnected, bouncePulse, fullWidth, layout = "default", }) {
+export function BuilderSetupCard({ onConnected, bouncePulse, attached = false, fullWidth, layout = "default", }) {
     const sidebarLayout = layout === "sidebar";
     const cardRef = useRef(null);
     // Replay the bounce keyframe each time bouncePulse increments. Toggling the
@@ -181,7 +181,7 @@ export function BuilderSetupCard({ onConnected, bouncePulse, fullWidth, layout =
         void el.offsetWidth;
         el.classList.add("animate-bounce-once");
     }, [bouncePulse]);
-    return (_jsx("div", { ref: cardRef, className: cn("agent-builder-setup-card", sidebarLayout && "agent-builder-setup-card--sidebar", fullWidth
+    return (_jsx("div", { ref: cardRef, className: cn("agent-builder-setup-card", sidebarLayout && "agent-builder-setup-card--sidebar", attached && "agent-builder-setup-card--attached", fullWidth
             ? "w-full px-3 pb-2"
             : sidebarLayout
                 ? "mx-auto w-full max-w-[42rem] px-3 pb-2"

package/dist/client/chat-first/apps-rail.d.ts

@@ -1,2 +1,2 @@
 import type { ChatFirstAppRailProps } from "./types.js";
-export declare const ChatFirstAppsRail: import("react").MemoExoticComponent<({ apps, activeAppId, loading, error, collapsed, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy, }: ChatFirstAppRailProps) => import("react").JSX.Element>;
+export declare const ChatFirstAppsRail: import("react").MemoExoticComponent<({ apps, defaultAppIds, activeAppId, loading, error, collapsed, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy, }: ChatFirstAppRailProps) => import("react").JSX.Element>;

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

@@ -2,7 +2,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuTrigger, Skeleton, Tooltip, TooltipContent, TooltipTrigger, } from "@agent-native/toolkit/ui";
 import { IconApps, IconChevronDown, IconChevronUp, IconPin, IconPlus, IconTrash, } from "@tabler/icons-react";
 import { memo, useMemo, useState } from "react";
-import { orderChatFirstAppIds, readChatFirstAppLayout, writeChatFirstAppLayout, } from "../chat-first.js";
+import { CHAT_FIRST_DEFAULT_APP_IDS, orderChatFirstAppIds, readChatFirstAppLayout, writeChatFirstAppLayout, } from "../chat-first.js";
 import { cn } from "../utils.js";
 import { defaultChatFirstCopy } from "./copy.js";
 function ChatFirstRailAppIcon({ app, activeAppId, renderIcon, }) {
@@ -10,8 +10,8 @@ function ChatFirstRailAppIcon({ app, activeAppId, renderIcon, }) {
     const isInactive = activeAppId !== undefined && !isActive;
     return (_jsx("span", { "data-chat-first-app-icon": true, className: cn("transition-[filter]", isInactive && "grayscale"), children: renderIcon(app, { isActive, isInactive }) }));
 }
-function AppRows({ apps, activeAppId, layout, onDragStart, onDrop, onDragEnd, onOpenApp, onRemoveApp, onTogglePinned, onMove, renderIcon, copy, }) {
-    const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout);
+function AppRows({ apps, defaultAppIds, activeAppId, layout, onDragStart, onDrop, onDragEnd, onOpenApp, onRemoveApp, onTogglePinned, onMove, renderIcon, copy, }) {
+    const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout, defaultAppIds);
     const appsById = new Map(apps.map((app) => [app.id, app]));
     const orderedApps = orderedIds
         .map((id) => appsById.get(id))
@@ -41,28 +41,28 @@ function AppRows({ apps, activeAppId, layout, onDragStart, onDrop, onDragEnd, on
                                     }), "aria-pressed": pinned, onClick: () => onTogglePinned(app.id), children: _jsx(IconPin, { size: 13, strokeWidth: pinned ? 2.2 : 1.6, "aria-hidden": "true" }) }), _jsx("span", { className: "sr-only", children: `${index + 1} of ${orderedApps.length}` })] }) }), _jsxs(ContextMenuContent, { children: [_jsxs(ContextMenuItem, { onSelect: () => onTogglePinned(app.id), children: [_jsx(IconPin, { size: 14, "aria-hidden": "true" }), pinned ? copy("removePinned") : copy("pinTop")] }), _jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { disabled: index === 0, onSelect: () => onMove(app.id, -1), children: [_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" }), copy("moveUp")] }), _jsxs(ContextMenuItem, { disabled: index === orderedApps.length - 1, onSelect: () => onMove(app.id, 1), children: [_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" }), copy("moveDown")] }), onRemoveApp ? (_jsxs(_Fragment, { children: [_jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { onSelect: () => onRemoveApp(app), className: "text-destructive focus:text-destructive", children: [_jsx(IconTrash, { size: 14, "aria-hidden": "true" }), copy("removeApp")] })] })) : null] })] }, app.id));
         }) }));
 }
-export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, activeAppId, loading = false, error, collapsed = false, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy = defaultChatFirstCopy, }) {
+export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, defaultAppIds, activeAppId, loading = false, error, collapsed = false, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy = defaultChatFirstCopy, }) {
     const [localLayout, setLocalLayout] = useState(() => readChatFirstAppLayout());
     const layout = controlledLayout ?? localLayout;
     const [draggedAppId, setDraggedAppId] = useState(null);
     const [showAllApps, setShowAllApps] = useState(false);
     const orderedApps = useMemo(() => {
-        const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout);
+        const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout, defaultAppIds);
         const appsById = new Map(apps.map((app) => [app.id, app]));
         return orderedIds
             .map((id) => appsById.get(id))
             .filter((app) => Boolean(app));
-    }, [apps, layout]);
+    }, [apps, defaultAppIds, layout]);
     const visibleApps = useMemo(() => {
         if (showAllApps)
             return orderedApps;
-        const defaultApps = orderedApps.slice(0, 5);
+        const defaultApps = orderedApps.slice(0, defaultAppIds?.length ?? CHAT_FIRST_DEFAULT_APP_IDS.length);
         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]);
+    }, [activeAppId, defaultAppIds, 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);
@@ -82,7 +82,7 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, activeA
     function reorderApps(targetId) {
         if (!draggedAppId || draggedAppId === targetId)
             return;
-        const currentOrder = orderChatFirstAppIds(apps.map((app) => app.id), layout);
+        const currentOrder = orderChatFirstAppIds(apps.map((app) => app.id), layout, defaultAppIds);
         const fromIndex = currentOrder.indexOf(draggedAppId);
         const toIndex = currentOrder.indexOf(targetId);
         if (fromIndex < 0 || toIndex < 0)
@@ -94,7 +94,7 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, activeA
         setDraggedAppId(null);
     }
     function moveApp(appId, direction) {
-        const currentOrder = orderChatFirstAppIds(apps.map((app) => app.id), layout);
+        const currentOrder = orderChatFirstAppIds(apps.map((app) => app.id), layout, defaultAppIds);
         const index = currentOrder.indexOf(appId);
         const nextIndex = index + direction;
         if (index < 0 || nextIndex < 0 || nextIndex >= currentOrder.length)
@@ -113,5 +113,5 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, activeA
                             ? "text-sidebar-foreground"
                             : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), title: app.name, children: _jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }) }, app.id))), onOpenAllApps ? (_jsx("button", { type: "button", "data-chat-first-all-apps": true, className: "flex size-9 items-center justify-center rounded-md text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", onClick: onOpenAllApps, "aria-label": copy("allApps"), title: copy("allApps"), children: _jsx(IconApps, { size: 16, "aria-hidden": "true" }) })) : null, error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }));
     }
-    return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "mt-3 px-2 pb-2 pt-2", "aria-label": copy("workspaceApps"), children: [_jsxs("div", { className: "mb-1 flex items-center gap-1.5 px-2 text-[11px] font-medium text-sidebar-foreground/50", children: [_jsx("span", { children: copy("workspaceApps") }), _jsx("span", { className: "ml-auto", children: createTrigger })] }), loading && apps.length === 0 ? (_jsx("div", { className: "space-y-0.5 px-2", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "h-8 w-full rounded-md" }, index))) })) : apps.length === 0 ? (_jsxs("div", { className: "px-2", children: [_jsx("p", { className: "text-xs text-sidebar-foreground/55", children: copy("noWorkspaceApps") }), createAppTrigger ? (createTrigger) : onCreateApp ? (_jsxs("button", { type: "button", className: "mt-1 inline-flex h-6 items-center gap-1.5 rounded-md border border-sidebar-border px-2 text-xs text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, children: [_jsx(IconPlus, { size: 13, "aria-hidden": "true" }), copy("createApp")] })) : (createTrigger)] })) : (_jsx(AppRows, { apps: visibleApps, activeAppId: activeAppId, layout: layout, onDragStart: setDraggedAppId, onDrop: reorderApps, onDragEnd: () => setDraggedAppId(null), onOpenApp: onOpenApp, onRemoveApp: onRemoveApp, onTogglePinned: togglePinned, onMove: moveApp, renderIcon: renderIcon, copy: copy })), hasMoreApps || showAllApps ? (_jsxs("button", { type: "button", className: "mt-0.5 flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/50 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: () => setShowAllApps((value) => !value), children: [showAllApps ? (_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" })) : (_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" })), showAllApps ? copy("showLess") : copy("showMore")] })) : null, onOpenAllApps ? (_jsx("div", { className: "mt-1 border-t border-sidebar-border/60 pt-1", children: _jsxs("button", { type: "button", "data-chat-first-all-apps": true, className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onOpenAllApps, children: [_jsx(IconApps, { size: 14, "aria-hidden": "true" }), _jsx("span", { children: copy("allApps") })] }) })) : null, error ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "mt-1 flex items-center gap-1 px-2 text-[10px] text-destructive/80", onClick: onRetry, "aria-label": error, children: [_jsx("span", { className: "size-1.5 rounded-full bg-destructive" }), onRetry ? copy("retry") : copy("appsLoadError")] }) }), _jsx(TooltipContent, { side: "right", children: error })] })) : null] }));
+    return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "mt-3 px-2 pb-2 pt-2", "aria-label": copy("workspaceApps"), children: [_jsxs("div", { className: "mb-1 flex items-center gap-1.5 px-2 text-[11px] font-medium text-sidebar-foreground/50", children: [_jsx("span", { children: copy("workspaceApps") }), _jsx("span", { className: "ml-auto", children: createTrigger })] }), loading && apps.length === 0 ? (_jsx("div", { className: "space-y-0.5 px-2", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "h-8 w-full rounded-md" }, index))) })) : apps.length === 0 ? (_jsxs("div", { className: "px-2", children: [_jsx("p", { className: "text-xs text-sidebar-foreground/55", children: copy("noWorkspaceApps") }), createAppTrigger ? (createTrigger) : onCreateApp ? (_jsxs("button", { type: "button", className: "mt-1 inline-flex h-6 items-center gap-1.5 rounded-md border border-sidebar-border px-2 text-xs text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, children: [_jsx(IconPlus, { size: 13, "aria-hidden": "true" }), copy("createApp")] })) : (createTrigger)] })) : (_jsx(AppRows, { apps: visibleApps, defaultAppIds: defaultAppIds, activeAppId: activeAppId, layout: layout, onDragStart: setDraggedAppId, onDrop: reorderApps, onDragEnd: () => setDraggedAppId(null), onOpenApp: onOpenApp, onRemoveApp: onRemoveApp, onTogglePinned: togglePinned, onMove: moveApp, renderIcon: renderIcon, copy: copy })), hasMoreApps || showAllApps ? (_jsxs("button", { type: "button", className: "mt-0.5 flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/50 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: () => setShowAllApps((value) => !value), children: [showAllApps ? (_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" })) : (_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" })), showAllApps ? copy("showLess") : copy("showMore")] })) : null, onOpenAllApps ? (_jsx("div", { className: "mt-1 border-t border-sidebar-border/60 pt-1", children: _jsxs("button", { type: "button", "data-chat-first-all-apps": true, className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onOpenAllApps, children: [_jsx(IconApps, { size: 14, "aria-hidden": "true" }), _jsx("span", { children: copy("allApps") })] }) })) : null, error ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "mt-1 flex items-center gap-1 px-2 text-[10px] text-destructive/80", onClick: onRetry, "aria-label": error, children: [_jsx("span", { className: "size-1.5 rounded-full bg-destructive" }), onRetry ? copy("retry") : copy("appsLoadError")] }) }), _jsx(TooltipContent, { side: "right", children: error })] })) : null] }));
 });

package/dist/client/chat-first/surface-tabs.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import { type ChatFirstSurfaceTab } from "../chat-first.js";
 import type { ChatFirstSurfaceTabsProps } from "./types.js";
-export declare function ChatFirstSurfaceTabs({ tabs, activeTabId, onActivate, onClose, onCloseOthers, onCloseToRight, onCloseAll, onOpenSurface, apps, onOpenApp, renderAppIcon, copy, }: ChatFirstSurfaceTabsProps): import("react").JSX.Element;
+export declare function ChatFirstSurfaceTabs({ tabs, activeTabId, onActivate, onClose, onCloseOthers, onCloseToRight, onCloseAll, onOpenSurface, hiddenSurfaceKinds, apps, onOpenApp, renderAppIcon, onAddTab, addTabLabel, copy, }: ChatFirstSurfaceTabsProps): import("react").JSX.Element;
 export declare function ChatFirstSurfaceContent({ tabs, activeTabId, renderTab, }: {
     tabs: readonly ChatFirstSurfaceTab[];
     activeTabId: string | null;

package/dist/client/chat-first/surface-tabs.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "@agent-native/toolkit/ui";
-import { IconFiles, IconGitCompare, IconMessageCircle, IconTerminal2, IconUsersGroup, IconWorld, IconX, } from "@tabler/icons-react";
+import { IconFiles, IconGitCompare, IconMessageCircle, IconPlus, IconTerminal2, IconUsersGroup, IconWorld, IconX, } from "@tabler/icons-react";
 import { CHAT_FIRST_SURFACE_CATALOG, } from "../chat-first.js";
 import { cn } from "../utils.js";
 import { defaultChatFirstCopy } from "./copy.js";
@@ -17,44 +17,44 @@ function SurfaceIcon({ kind }) {
     const Icon = ICONS[kind];
     return _jsx(Icon, { size: 14, "aria-hidden": "true" });
 }
-export function ChatFirstSurfaceTabs({ tabs, activeTabId, onActivate, onClose, onCloseOthers, onCloseToRight, onCloseAll, onOpenSurface, apps = [], onOpenApp, renderAppIcon, copy = defaultChatFirstCopy, }) {
+export function ChatFirstSurfaceTabs({ tabs, activeTabId, onActivate, onClose, onCloseOthers, onCloseToRight, onCloseAll, onOpenSurface, hiddenSurfaceKinds = [], apps = [], onOpenApp, renderAppIcon, onAddTab, addTabLabel = "New tab", copy = defaultChatFirstCopy, }) {
     return (_jsx(TooltipProvider, { delayDuration: 400, children: _jsx("div", { "data-chat-first-surface-tabs": true, className: cn("min-w-0 border-b border-border bg-card", tabs.length > 0
                 ? "shrink-0"
-                : "flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden"), children: tabs.length > 0 ? (_jsx("div", { className: "flex min-w-0 items-center gap-1 overflow-x-auto px-2 py-1.5", role: "tablist", "aria-label": copy("openSideSurfaces"), children: tabs.map((tab, index) => (_jsxs(ContextMenu, { children: [_jsx(ContextMenuTrigger, { asChild: true, children: _jsxs("div", { "data-surface-tab-id": tab.id, "data-active": activeTabId === tab.id ? "true" : "false", className: cn("group flex h-8 min-w-0 max-w-48 shrink-0 items-center rounded-md text-xs transition-colors", activeTabId === tab.id
-                                    ? "bg-accent text-foreground"
-                                    : "text-muted-foreground hover:bg-accent hover:text-foreground"), onMouseDown: (event) => {
-                                    if (event.button === 1) {
-                                        event.preventDefault();
-                                        onClose(tab);
-                                    }
-                                }, title: tab.title, children: [_jsxs("button", { type: "button", role: "tab", tabIndex: activeTabId === tab.id ? 0 : -1, "aria-selected": activeTabId === tab.id, "data-chat-first-surface-tab-id": tab.id, className: "flex min-w-0 flex-1 items-center gap-1.5 truncate rounded-md px-2 text-start focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onKeyDown: (event) => {
-                                            if (event.key === "Enter" || event.key === " ") {
-                                                event.preventDefault();
-                                                onActivate(tab);
-                                                return;
-                                            }
-                                            const nextIndex = event.key === "ArrowRight"
-                                                ? (index + 1) % tabs.length
-                                                : event.key === "ArrowLeft"
-                                                    ? (index - 1 + tabs.length) % tabs.length
-                                                    : event.key === "Home"
-                                                        ? 0
-                                                        : event.key === "End"
-                                                            ? tabs.length - 1
-                                                            : -1;
-                                            if (nextIndex < 0)
-                                                return;
+                : "flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden"), children: tabs.length > 0 ? (_jsxs("div", { className: "flex min-w-0 items-center gap-1 overflow-x-auto px-2 py-1.5", role: "tablist", "aria-label": copy("openSideSurfaces"), children: [tabs.map((tab, index) => (_jsxs(ContextMenu, { children: [_jsx(ContextMenuTrigger, { asChild: true, children: _jsxs("div", { "data-surface-tab-id": tab.id, "data-active": activeTabId === tab.id ? "true" : "false", className: cn("group flex h-8 min-w-0 max-w-48 shrink-0 items-center rounded-md text-xs transition-colors", activeTabId === tab.id
+                                        ? "bg-accent text-foreground"
+                                        : "text-muted-foreground hover:bg-accent hover:text-foreground"), onMouseDown: (event) => {
+                                        if (event.button === 1) {
                                             event.preventDefault();
-                                            onActivate(tabs[nextIndex]);
-                                            requestAnimationFrame(() => {
-                                                document
-                                                    .querySelector(`[data-chat-first-surface-tab-id="${CSS.escape(tabs[nextIndex].id)}"]`)
-                                                    ?.focus();
-                                            });
-                                        }, onClick: () => onActivate(tab), children: [_jsx(SurfaceIcon, { kind: tab.kind }), _jsx("span", { className: "truncate", children: tab.title })] }), _jsx("button", { type: "button", className: "mr-1 flex size-5 shrink-0 items-center justify-center rounded text-muted-foreground/65 opacity-0 transition-opacity hover:bg-background/70 hover:text-foreground group-hover:opacity-100 focus-visible:opacity-100", "aria-label": copy("closeTab", { name: tab.title }), title: copy("closeTab", { name: tab.title }), onClick: (event) => {
-                                            event.stopPropagation();
                                             onClose(tab);
-                                        }, children: _jsx(IconX, { size: 12, "aria-hidden": "true" }) })] }) }), _jsxs(ContextMenuContent, { children: [_jsx(ContextMenuItem, { onSelect: () => onClose(tab), children: copy("close") }), _jsx(ContextMenuItem, { disabled: tabs.length < 2, onSelect: () => onCloseOthers(tab), children: copy("closeOthers") }), _jsx(ContextMenuItem, { disabled: tabs[tabs.length - 1]?.id === tab.id, onSelect: () => onCloseToRight(tab), children: copy("closeToRight") }), _jsx(ContextMenuSeparator, {}), _jsx(ContextMenuItem, { onSelect: onCloseAll, children: copy("closeAll") })] })] }, tab.id))) })) : (_jsxs("div", { className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-y-auto px-2 py-1", "data-surface-empty-state": true, "aria-label": copy("openSideSurfaces"), children: [CHAT_FIRST_SURFACE_CATALOG.map((surface) => {
+                                        }
+                                    }, title: tab.title, children: [_jsxs("button", { type: "button", role: "tab", tabIndex: activeTabId === tab.id ? 0 : -1, "aria-selected": activeTabId === tab.id, "data-chat-first-surface-tab-id": tab.id, className: "flex min-w-0 flex-1 items-center gap-1.5 truncate rounded-md px-2 text-start focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onKeyDown: (event) => {
+                                                if (event.key === "Enter" || event.key === " ") {
+                                                    event.preventDefault();
+                                                    onActivate(tab);
+                                                    return;
+                                                }
+                                                const nextIndex = event.key === "ArrowRight"
+                                                    ? (index + 1) % tabs.length
+                                                    : event.key === "ArrowLeft"
+                                                        ? (index - 1 + tabs.length) % tabs.length
+                                                        : event.key === "Home"
+                                                            ? 0
+                                                            : event.key === "End"
+                                                                ? tabs.length - 1
+                                                                : -1;
+                                                if (nextIndex < 0)
+                                                    return;
+                                                event.preventDefault();
+                                                onActivate(tabs[nextIndex]);
+                                                requestAnimationFrame(() => {
+                                                    document
+                                                        .querySelector(`[data-chat-first-surface-tab-id="${CSS.escape(tabs[nextIndex].id)}"]`)
+                                                        ?.focus();
+                                                });
+                                            }, onClick: () => onActivate(tab), children: [_jsx(SurfaceIcon, { kind: tab.kind }), _jsx("span", { className: "truncate", children: tab.title })] }), _jsx("button", { type: "button", className: "mr-1 flex size-5 shrink-0 items-center justify-center rounded text-muted-foreground/65 opacity-0 transition-opacity hover:bg-background/70 hover:text-foreground group-hover:opacity-100 focus-visible:opacity-100", "aria-label": copy("closeTab", { name: tab.title }), title: copy("closeTab", { name: tab.title }), onClick: (event) => {
+                                                event.stopPropagation();
+                                                onClose(tab);
+                                            }, children: _jsx(IconX, { size: 12, "aria-hidden": "true" }) })] }) }), _jsxs(ContextMenuContent, { children: [_jsx(ContextMenuItem, { onSelect: () => onClose(tab), children: copy("close") }), _jsx(ContextMenuItem, { disabled: tabs.length < 2, onSelect: () => onCloseOthers(tab), children: copy("closeOthers") }), _jsx(ContextMenuItem, { disabled: tabs[tabs.length - 1]?.id === tab.id, onSelect: () => onCloseToRight(tab), children: copy("closeToRight") }), _jsx(ContextMenuSeparator, {}), _jsx(ContextMenuItem, { onSelect: onCloseAll, children: copy("closeAll") })] })] }, tab.id))), onAddTab ? (_jsx("button", { type: "button", className: "flex size-8 shrink-0 items-center justify-center rounded-md text-muted-foreground/65 transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "aria-label": addTabLabel, title: addTabLabel, onClick: onAddTab, children: _jsx(IconPlus, { size: 14, "aria-hidden": "true" }) })) : null] })) : (_jsxs("div", { className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-y-auto px-2 py-1", "data-surface-empty-state": true, "aria-label": copy("openSideSurfaces"), children: [CHAT_FIRST_SURFACE_CATALOG.filter((surface) => !hiddenSurfaceKinds.includes(surface.kind)).map((surface) => {
                         const label = copy(`surface.${surface.kind}.label`);
                         const reason = surface.availability === "deferred"
                             ? copy(`surface.${surface.kind}.reason`)
@@ -62,6 +62,8 @@ export function ChatFirstSurfaceTabs({ tabs, activeTabId, onActivate, onClose, o
                         const isDeferred = surface.availability === "deferred";
                         const canOpenSurface = onOpenSurface &&
                             (surface.kind === "browser" ||
+                                (surface.kind === "terminal" &&
+                                    surface.availability === "desktop") ||
                                 surface.kind === "side-chat" ||
                                 surface.kind === "agents");
                         const row = (_jsxs("div", { className: cn("flex h-7 min-w-0 items-center gap-2 rounded px-2 text-xs transition-colors", canOpenSurface
@@ -78,7 +80,7 @@ export function ChatFirstSurfaceTabs({ tabs, activeTabId, onActivate, onClose, o
                     }), apps.length > 0 && onOpenApp ? (_jsxs("div", { className: "mt-1 border-t border-border pt-1", children: [_jsx("p", { className: "px-2 py-1 text-[10px] font-medium uppercase tracking-wide text-muted-foreground", children: copy("workspaceApps") }), _jsx("div", { className: "space-y-0.5", children: apps.map((app) => (_jsxs("button", { type: "button", "data-chat-first-surface-app": app.id, className: "flex h-8 w-full min-w-0 items-center gap-2 rounded px-2 text-start text-xs text-foreground transition-colors hover:bg-accent", title: copy("openApp", { name: app.name }), "aria-label": copy("openApp", { name: app.name }), onClick: () => onOpenApp(app), children: [renderAppIcon?.(app) ?? _jsx(SurfaceIcon, { kind: "app" }), _jsx("span", { className: "min-w-0 flex-1 truncate", children: app.name })] }, app.id))) })] })) : null] })) }) }));
 }
 export function ChatFirstSurfaceContent({ tabs, activeTabId, renderTab, }) {
-    return (_jsx("div", { className: "min-h-0 flex-1 overflow-hidden", children: tabs.map((tab) => {
+    return (_jsx("div", { className: "flex h-full min-h-0 flex-1 flex-col overflow-hidden", children: tabs.map((tab) => {
             const active = tab.id === activeTabId;
             return (_jsx("div", { "data-chat-first-surface-content": tab.id, "aria-hidden": !active, className: cn("h-full min-h-0", !active && "hidden"), children: renderTab(tab) }, tab.id));
         }) }));

package/dist/client/chat-first/types.d.ts

@@ -35,6 +35,9 @@ export interface ChatFirstSurfaceTabsProps {
     onCloseToRight: (tab: ChatFirstSurfaceTab) => void;
     onCloseAll: () => void;
     onOpenSurface?: (kind: ChatFirstSurfaceKind) => void;
+    hiddenSurfaceKinds?: readonly ChatFirstSurfaceKind[];
+    onAddTab?: () => void;
+    addTabLabel?: string;
     apps?: readonly ChatFirstAppItem[];
     onOpenApp?: (app: ChatFirstAppItem) => void;
     renderAppIcon?: (app: ChatFirstAppItem) => ReactNode;
@@ -42,6 +45,8 @@ export interface ChatFirstSurfaceTabsProps {
 }
 export interface ChatFirstAppRailProps {
     apps: readonly ChatFirstAppItem[];
+    /** Optional host-specific fallback order for apps without a saved layout. */
+    defaultAppIds?: readonly string[];
     activeAppId?: string;
     loading?: boolean;
     error?: string | null;

package/dist/client/chat-first.d.ts

@@ -188,7 +188,7 @@ export declare function writeChatFirstAppLayout(layout: ChatFirstAppLayoutPrefer
     ok: false;
     reason: "unavailable" | "write-failed";
 };
-export declare function orderChatFirstAppIds(appIds: readonly string[], layout: ChatFirstAppLayoutPreference): string[];
+export declare function orderChatFirstAppIds(appIds: readonly string[], layout: ChatFirstAppLayoutPreference, preferredAppIds?: readonly string[]): string[];
 export declare function resolveChatFirstBrowserTarget(detail: ChatFirstOpenBrowserDetail): ChatFirstBrowserResolution;
 type ChatFirstOpenAppListener = (detail: ChatFirstOpenAppDetail) => void;
 type ChatFirstOpenBrowserListener = (detail: ChatFirstOpenBrowserDetail) => void;

package/dist/client/chat-first.js

@@ -19,8 +19,8 @@ export const CHAT_FIRST_SURFACE_CATALOG = [
         kind: "terminal",
         label: "Terminal",
         description: "Run commands beside the conversation.",
-        availability: "deferred",
-        disabledReason: "Deferred in this release: the existing terminal is a standalone host surface; a shared PTY lifecycle is needed for an embedded pane.",
+        availability: "desktop",
+        disabledReason: "Open a local coding-agent terminal beside the conversation.",
     },
     {
         kind: "files",
@@ -304,9 +304,9 @@ export function writeChatFirstAppLayout(layout, storage = browserStorage()) {
         return { ok: false, reason: "write-failed" };
     }
 }
-export function orderChatFirstAppIds(appIds, layout) {
+export function orderChatFirstAppIds(appIds, layout, preferredAppIds = CHAT_FIRST_DEFAULT_APP_IDS) {
     const available = new Set(appIds);
-    const preferredDefaults = CHAT_FIRST_DEFAULT_APP_IDS.filter((id) => available.has(id));
+    const preferredDefaults = preferredAppIds.filter((id) => available.has(id));
     const preferredDefaultSet = new Set(preferredDefaults);
     const fallbackOrder = [
         ...preferredDefaults,

package/dist/client/desktop-local-code-change.d.ts

@@ -0,0 +1,10 @@
+export declare const DESKTOP_LOCAL_CODE_CHANGE_EVENT = "agent-native:desktop-local-code-change";
+export interface DesktopLocalCodeChangeDetail {
+    prompt: string;
+}
+/**
+ * Ask an embedding desktop shell to prepare a local code-change workspace.
+ * The optional target keeps bubbling events scoped to the shell that owns the
+ * chat card while preserving a window fallback for standalone consumers.
+ */
+export declare function requestDesktopLocalCodeChange(prompt: string, target?: EventTarget | null): boolean;