@agent-native/core 0.155.0 → 0.157.1

package/dist/agent/production-agent.d.ts

@@ -255,6 +255,29 @@ export interface ActionEntry {
 /** @deprecated Use `ActionEntry` instead */
 export type ScriptEntry = ActionEntry;
 export type AgentExecutionMode = "act" | "plan";
+export interface AgentActionSurface {
+    allowedActionNames: readonly string[];
+}
+export interface AgentActionSurfaceDetails {
+    event: any;
+    ownerEmail: string | null;
+    orgId: string | null;
+    threadId?: string;
+    mode: AgentExecutionMode;
+    internalContinuation: boolean;
+    availableActionNames: readonly string[];
+}
+/** Read a persisted allowlist while preserving legacy absence and failing
+ * closed when the field is present but malformed. */
+export declare function readPersistedAllowedActionNames(value: unknown): string[] | undefined;
+export interface PersistedActionSurface {
+    orgId: string | null;
+    allowedActionNames: string[];
+}
+/** Read a nested persisted action surface. An absent envelope is legacy;
+ * a present but invalid envelope is an explicit org-less, empty surface. */
+export declare function readPersistedActionSurface(value: unknown, propertyName: string): PersistedActionSurface | undefined;
+export declare function filterActionsByAllowedNames(actions: Record<string, ActionEntry>, allowedActionNames: readonly string[]): Record<string, ActionEntry>;
 export declare const PLAN_MODE_SYSTEM_PROMPT = "## Plan Mode Active\n\nYou are in Plan mode. This turn is for research, clarification, and a proposed approach only.\n\nHard rules:\n- Use only read-only tools. Do not edit files, write resources, run mutating bash commands, mutate SQL rows, navigate the UI, send notifications, create jobs, create tools, send messages or tasks to external agents, or change external systems.\n- If a needed detail is unclear, ask a concise clarifying question before proposing a plan.\n- When ready, present a concrete plan with the files/tools you expect to touch, the intended changes, validation steps, and notable risks.\n- Do not treat approval as implicit while Plan mode is still active. Tell the user to switch to Act mode with the mode selector or /act before implementation.";
 export declare function isPlanModeToolCallAllowed(name: string, input: unknown, entry: ActionEntry): boolean;
 export declare function createPlanModeActionRegistry(actions: Record<string, ActionEntry>): Record<string, ActionEntry>;
@@ -314,6 +337,13 @@ export interface ProductionAgentOptions {
         displayMessage?: string;
         attachments?: AgentChatAttachment[];
     }>;
+    /**
+     * Resolve the exact action registry exposed to one interactive agent-chat
+     * request. Returned names are a hard allowlist: omitted actions are absent
+     * from both the provider schemas and the searchable registry. When set, all
+     * allowed actions are loaded directly on the first model request.
+     */
+    resolveActionSurface?: (details: AgentActionSurfaceDetails) => AgentActionSurface | Promise<AgentActionSurface>;
     /** Optional per-app agent run chunk budget in milliseconds. Defaults to
      *  AGENT_RUN_SOFT_TIMEOUT_MS when set, otherwise no framework-imposed
      *  timeout. When reached, the client receives an internal auto-continuation

package/dist/agent/production-agent.js

@@ -16,7 +16,7 @@ import { completeRun as completeProgressRun, startRun as startProgressRun, updat
 import { isRuntimeVisibleScope, parseSkillFrontmatter, } from "../server/agent-chat/skill-frontmatter.js";
 import { canUseDeployCredentialFallbackForRequest, getProviderCredentialAuthFailure, readDeployCredentialEnv, } from "../server/credential-provider.js";
 import { readBody } from "../server/h3-helpers.js";
-import { getRequestRunContext, ensureRequestRunContext, getRequestContext, getRequestOrgId, getRequestUserEmail, runWithRequestContext, } from "../server/request-context.js";
+import { assertRequestActionSurfaceIsolation, getRequestRunContext, ensureRequestRunContext, getRequestContext, getRequestOrgId, getRequestUserEmail, runWithRequestContext, } from "../server/request-context.js";
 import { fireInternalDispatch } from "../server/self-dispatch.js";
 import { isReasoningEffort, normalizeReasoningEffortForRequest, stepDownReasoningEffort, } from "../shared/reasoning-effort.js";
 import { actionPreparationContinuationNote } from "./action-continuation-guidance.js";
@@ -391,6 +391,55 @@ export async function resolveOwnerEngineApiKey(input) {
 export async function getOwnerAnthropicApiKey(ownerEmail) {
     return getOwnerApiKey("anthropic", ownerEmail);
 }
+function hasOwn(value, propertyName) {
+    return (typeof value === "object" &&
+        value !== null &&
+        Object.prototype.hasOwnProperty.call(value, propertyName));
+}
+/** Read a persisted allowlist while preserving legacy absence and failing
+ * closed when the field is present but malformed. */
+export function readPersistedAllowedActionNames(value) {
+    if (!hasOwn(value, "allowedActionNames"))
+        return undefined;
+    const names = value.allowedActionNames;
+    if (!Array.isArray(names) ||
+        !names.every((name) => typeof name === "string")) {
+        return [];
+    }
+    return [...new Set(names)];
+}
+/** Read a nested persisted action surface. An absent envelope is legacy;
+ * a present but invalid envelope is an explicit org-less, empty surface. */
+export function readPersistedActionSurface(value, propertyName) {
+    if (!hasOwn(value, propertyName))
+        return undefined;
+    const surface = value[propertyName];
+    const allowedActionNames = readPersistedAllowedActionNames(surface) ?? [];
+    if (!hasOwn(surface, "orgId")) {
+        return { orgId: null, allowedActionNames: [] };
+    }
+    const orgId = surface.orgId;
+    if (orgId !== null &&
+        (typeof orgId !== "string" || orgId.trim().length === 0)) {
+        return { orgId: null, allowedActionNames: [] };
+    }
+    return { orgId, allowedActionNames };
+}
+export function filterActionsByAllowedNames(actions, allowedActionNames) {
+    const allowedNames = [...new Set(allowedActionNames)];
+    const unknownNames = allowedNames.filter((name) => !Object.prototype.hasOwnProperty.call(actions, name));
+    if (unknownNames.length > 0) {
+        throw new Error(`resolveActionSurface returned unknown action name(s): ${unknownNames.join(", ")}`);
+    }
+    const filtered = Object.fromEntries(allowedNames.map((name) => [name, actions[name]]));
+    // `attachToolSearch` closes over the registry it was originally attached to.
+    // Rebind it to this request's filtered registry so explicitly allowing
+    // `tool-search` cannot disclose actions that the resolver omitted.
+    if (filtered[TOOL_SEARCH_ACTION_NAME]) {
+        filtered[TOOL_SEARCH_ACTION_NAME] = createToolSearchEntry(() => filtered);
+    }
+    return filtered;
+}
 export const PLAN_MODE_SYSTEM_PROMPT = `## Plan Mode Active
 
 You are in Plan mode. This turn is for research, clarification, and a proposed approach only.
@@ -6031,6 +6080,9 @@ export function resolveAgentRequestReasoningEffort({ model, requestEffort, confi
     return normalizeReasoningEffortForRequest(model, isReasoningEffort(requestEffort) ? requestEffort : configuredEffort);
 }
 export function createProductionAgentHandler(options) {
+    if (options.resolveActionSurface) {
+        assertRequestActionSurfaceIsolation();
+    }
     // Undefined = let each engine pick its own defaultModel at request time.
     const configuredModel = options.model;
     // Resolve actions — prefer `actions`, fall back to deprecated `scripts`
@@ -6040,7 +6092,7 @@ export function createProductionAgentHandler(options) {
     // the settings UI) show up to the LLM without a process restart. MCP tools
     // are also scope-filtered per request — a user-scope server added by Alice
     // must not appear in Bob's tool list in a shared-process deployment.
-    const getEngineTools = (actions = resolvedActions) => {
+    const getRequestActions = (actions = resolvedActions) => {
         const filtered = {};
         for (const [name, entry] of Object.entries(actions)) {
             if (name.startsWith("mcp__") && !isMcpToolAllowedForRequest(name)) {
@@ -6048,8 +6100,9 @@ export function createProductionAgentHandler(options) {
             }
             filtered[name] = entry;
         }
-        return actionsToEngineTools(filtered);
+        return filtered;
     };
+    const getEngineTools = (actions) => actionsToEngineTools(getRequestActions(actions));
     return defineEventHandler(async (event) => {
         // Diagnostic-only setup-timing instrumentation. Captures wall-clock offsets
         // from handler entry through the work done BEFORE startRun so a slow pre-run
@@ -6089,12 +6142,20 @@ export function createProductionAgentHandler(options) {
         // (the route HMAC-verifies the dispatch before invoking us). When set, we
         // run the loop inline with the background soft-timeout, reusing the
         // pre-claimed runId/turnId — we must NOT re-claim the slot or re-dispatch.
-        const backgroundRunMarker = body[AGENT_CHAT_BACKGROUND_RUN_FIELD] &&
+        const backgroundRunMarker = preInjectedBody &&
+            body[AGENT_CHAT_BACKGROUND_RUN_FIELD] &&
             typeof body[AGENT_CHAT_BACKGROUND_RUN_FIELD] === "object" &&
             typeof body[AGENT_CHAT_BACKGROUND_RUN_FIELD].runId === "string"
             ? body[AGENT_CHAT_BACKGROUND_RUN_FIELD]
             : null;
         const isBackgroundWorker = backgroundRunMarker !== null;
+        // Both fields are internal durable-dispatch artifacts, never client input.
+        // A body marker alone is not proof of worker identity: only the verified
+        // `_process-run` route can install `preInjectedBody` on the event context.
+        if (!isBackgroundWorker) {
+            delete body[AGENT_CHAT_BACKGROUND_RUN_FIELD];
+            delete body.__resolvedActionSurface;
+        }
         // DIAGNOSTIC-ONLY: progressive per-stage hang localizer for the bg worker.
         // The worker's runId is available EARLY on the marker (the general `runId`
         // var resolves much later), so capture it now and emit the LAST setup stage
@@ -6197,6 +6258,35 @@ export function createProductionAgentHandler(options) {
                 requestAttachments = preparedRequest.attachments;
             }
         }
+        const availableRequestActions = getRequestActions();
+        let surfacedRequestActions = availableRequestActions;
+        if (options.resolveActionSurface) {
+            const persistedSurface = isBackgroundWorker
+                ? readPersistedActionSurface(body, "__resolvedActionSurface")
+                : undefined;
+            const surface = persistedSurface !== undefined
+                ? persistedSurface
+                : await options.resolveActionSurface({
+                    event,
+                    ownerEmail,
+                    orgId: getRequestOrgId() ?? null,
+                    threadId,
+                    mode: requestMode,
+                    internalContinuation: Boolean(internalContinuation),
+                    availableActionNames: Object.keys(availableRequestActions),
+                });
+            surfacedRequestActions = filterActionsByAllowedNames(availableRequestActions, surface.allowedActionNames);
+            const allowedNames = Object.keys(surfacedRequestActions);
+            const runCtx = ensureRequestRunContext();
+            if (runCtx)
+                runCtx.allowedActionNames = allowedNames;
+            if (!isBackgroundWorker) {
+                body.__resolvedActionSurface = {
+                    orgId: getRequestOrgId() ?? null,
+                    allowedActionNames: allowedNames,
+                };
+            }
+        }
         // DIAGNOSTIC-ONLY: owner/request context prep (resolveAgentOwnerEmail +
         // prepareRequest) finished. A worker stuck before this points at the
         // owner/request-context awaits.
@@ -6428,7 +6518,7 @@ export function createProductionAgentHandler(options) {
         const screenContextThunk = () => (async () => {
             const screenStart = Date.now();
             try {
-                const viewScreenAction = resolvedActions["view-screen"];
+                const viewScreenAction = surfacedRequestActions["view-screen"];
                 if (viewScreenAction) {
                     const result = await viewScreenAction.run({}, {
                         userEmail: getRequestUserEmail(),
@@ -6667,10 +6757,12 @@ export function createProductionAgentHandler(options) {
         }
         const screenContext = timeBlock + screenBlock + urlBlock + selectionBlock;
         const requestActions = requestMode === "plan"
-            ? createPlanModeActionRegistry(resolvedActions)
-            : resolvedActions;
+            ? createPlanModeActionRegistry(surfacedRequestActions)
+            : surfacedRequestActions;
         const availableRequestTools = getEngineTools(requestActions);
-        const initialRequestTools = filterInitialEngineTools(availableRequestTools, options.initialToolNames);
+        const initialRequestTools = options.resolveActionSurface
+            ? availableRequestTools
+            : filterInitialEngineTools(availableRequestTools, options.initialToolNames);
         const requestTools = requestMode === "plan"
             ? preloadPlanModeEngineTools({
                 request: requestMessage,

package/dist/agent/types.d.ts

@@ -186,6 +186,15 @@ export interface AgentChatRequest {
          */
         payloadRef?: boolean;
     };
+    /**
+     * Server-resolved action authorization carried across authenticated durable
+     * background dispatches. Normal client requests must not trust this field;
+     * the foreground handler deletes and replaces it before persistence.
+     */
+    __resolvedActionSurface?: {
+        orgId: string | null;
+        allowedActionNames: string[];
+    };
     /**
      * Stable identity for the logical assistant turn this request belongs to.
      * The client sends the SAME turnId for the initial POST and every

package/dist/client/AgentPanel.d.ts

@@ -201,6 +201,18 @@ export interface AgentSidebarProps {
     chatViewTransitionHandoff?: boolean;
     /** Namespace for persisted chat state. Use the same key as AgentChatHome. */
     storageKey?: string;
+    /** Namespace for the persisted open/closed preference. Defaults to storageKey. */
+    openStorageKey?: string;
+    /** API base URL used by the chat surface. */
+    apiUrl?: string;
+    /** Runtime surface identity used for server-side chat capabilities. */
+    agentChatSurface?: AgentChatSurfaceKind;
+    /** Show the chat thread tab row. Default: true. */
+    showTabBar?: MultiTabAssistantChatProps["showTabBar"];
+    /** Keep inline app-opening results inside the current app chat. */
+    suppressInlineOpenApp?: AssistantChatProps["suppressInlineOpenApp"];
+    /** Placeholder shown in the chat composer. */
+    composerPlaceholder?: AssistantChatProps["composerPlaceholder"];
     /** Open the sidebar when a chat run is active or reconnects. */
     openOnChatRunning?: boolean;
     /** Called when the user selects the full-view action from the chat sidebar. */
@@ -222,7 +234,7 @@ export interface AgentSidebarProps {
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export declare function AgentSidebar({ children, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openOnChatRunning, onFullscreenRequest, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, }: AgentSidebarProps): React.JSX.Element;
+export declare function AgentSidebar({ children, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openStorageKey, apiUrl, agentChatSurface, showTabBar, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning, onFullscreenRequest, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, }: AgentSidebarProps): React.JSX.Element;
 /**
  * Focus the agent chat composer input.
  * Opens the sidebar if closed, then focuses the text input.

package/dist/client/AgentPanel.js

@@ -200,6 +200,7 @@ function IconTooltip({ content, children, }) {
     return (_jsx(DesignSystemTooltip, { trigger: children, content: normalizeTooltipText(content), placement: "bottom", delayMs: 250, className: "z-[300] overflow-hidden rounded-md border border-border bg-popover px-2 py-1 text-[11px] text-foreground shadow-md" }));
 }
 function ChatLoadingSkeleton({ renderHeader, centerComposerWhenEmpty = false, composerSlot, composerAreaClassName, composerLayoutVariant = "default", }) {
+    const t = useT();
     // Provide empty no-op implementations so renderHeader can render the real
     // tab/mode buttons without needing actual chat state.
     const noop = useCallback(() => { }, []);
@@ -219,7 +220,7 @@ function ChatLoadingSkeleton({ renderHeader, centerComposerWhenEmpty = false, co
         toggleHistory: noop,
     };
     if (centerComposerWhenEmpty) {
-        return (_jsxs("div", { className: "flex flex-col flex-1 min-h-0", children: [renderHeader ? renderHeader(stubProps) : null, _jsxs("div", { "data-agent-empty-state": "centered", className: "relative flex flex-1 flex-col h-full min-h-0 text-foreground", children: [_jsx("div", { className: "agent-chat-scroll flex-1 overflow-y-auto overflow-x-hidden min-h-0", children: _jsx("div", { className: "agent-empty-state sr-only", "aria-busy": "true", children: "Loading chat..." }) }), composerSlot, _jsx("div", { className: "agent-composer-stack", children: _jsx("div", { className: cn("agent-composer-area shrink-0 px-3 py-2", composerLayoutVariant !== "default" &&
+        return (_jsxs("div", { className: "flex flex-col flex-1 min-h-0", children: [renderHeader ? renderHeader(stubProps) : null, _jsxs("div", { "data-agent-empty-state": "centered", className: "relative flex flex-1 flex-col h-full min-h-0 text-foreground", children: [_jsx("div", { className: "agent-chat-scroll flex-1 overflow-y-auto overflow-x-hidden min-h-0", children: _jsx("div", { className: "agent-empty-state sr-only", "aria-busy": "true", children: t("agentChat.empty.loadingChat") }) }), composerSlot, _jsx("div", { className: "agent-composer-stack", children: _jsx("div", { className: cn("agent-composer-area shrink-0 px-3 py-2", composerLayoutVariant !== "default" &&
                                     `agent-composer-area--${composerLayoutVariant}`, composerAreaClassName), children: _jsxs("div", { className: cn("agent-composer-root flex flex-col rounded-lg border border-input bg-muted/45 transition-colors", composerLayoutVariant !== "default" &&
                                         `agent-composer-root--${composerLayoutVariant}`), children: [_jsx("div", { className: "px-3 pt-3", children: _jsx("div", { className: "h-5 w-3/5 rounded bg-muted animate-pulse motion-reduce:animate-none" }) }), _jsxs("div", { className: "mt-auto flex items-center gap-2 px-3 py-2", children: [_jsx("div", { className: "h-5 w-5 rounded bg-muted animate-pulse motion-reduce:animate-none" }), _jsx("div", { className: "ml-auto h-4 w-28 rounded bg-muted animate-pulse motion-reduce:animate-none" }), _jsx("div", { className: "h-7 w-7 rounded-md bg-muted animate-pulse motion-reduce:animate-none" })] })] }) }) })] })] }));
     }
@@ -721,7 +722,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                         (activeTabMessageCount <= 0 && activeTab.status === "idle")) {
                         return null;
                     }
-                    return (_jsx(ShareButton, { resourceType: "chat_thread", resourceId: activeTab.id, allowedRoles: ["viewer", "editor", "admin"], resourceTitle: activeTab.label || "Chat", shareUrl: getChatThreadShareUrl(activeTab.id), trigger: "icon", triggerClassName: "h-7 w-7", defaultOpen: onCollapse && shareFromMenuOpen, onOpenChange: onCollapse ? setShareFromMenuOpen : undefined }));
+                    return (_jsx(ShareButton, { resourceType: "chat_thread", resourceId: activeTab.id, allowedRoles: ["viewer", "editor", "admin"], resourceTitle: activeTab.label || t("agentPanel.chat"), shareUrl: getChatThreadShareUrl(activeTab.id), triggerClassName: "h-7 px-2", defaultOpen: onCollapse && shareFromMenuOpen, onOpenChange: onCollapse ? setShareFromMenuOpen : undefined }));
                 })(), feedbackEnabled ? (_jsx(FeedbackButton, { variant: "icon", side: "bottom", align: "end", chatSessionId: activeChatSessionId, chatStorageKey: storageKey, open: feedbackOpen, onOpenChange: setFeedbackOpen, trigger: _jsx("button", { type: "button", tabIndex: -1, "aria-hidden": "true", className: "pointer-events-none absolute end-0 top-full h-px w-px opacity-0" }) })) : null, mode === "chat" && (_jsx(IconTooltip, { content: t("agentPanel.newChat"), children: _jsx("button", { onClick: addTab, "aria-label": t("agentPanel.newChat"), className: "flex h-6 w-6 items-center justify-center rounded text-muted-foreground hover:text-foreground hover:bg-accent/50", children: _jsx(IconPlus, { size: 14 }) }) })), !onCollapse && mode === "cli" && canUseCodeTools && (_jsx(IconTooltip, { content: t("agentPanel.newTerminal"), children: _jsx("button", { onClick: addCliTab, "aria-label": t("agentPanel.newTerminal"), className: "flex h-6 w-6 items-center justify-center rounded text-muted-foreground hover:text-foreground hover:bg-accent/50", children: _jsx(IconPlus, { size: 14 }) }) })), _jsxs(DropdownMenu, { open: headerMenuOpen, onOpenChange: setHeaderMenuOpen, children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx("button", { className: cn("flex h-6 w-6 items-center justify-center rounded text-muted-foreground hover:text-foreground hover:bg-accent/50", (headerMenuOpen || mode === "settings") &&
                                 "bg-accent text-foreground"), "aria-label": t("agentPanel.panelOptions"), children: _jsx(IconDotsVertical, { size: 14 }) }) }), _jsxs(DropdownMenuContent, { align: "end", sideOffset: 6, className: "w-48", onCloseAutoFocus: (event) => {
                             // A sibling overlay owns focus next; restoring it to the menu
@@ -785,7 +786,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
             ? tabs.find((tab) => tab.id === activeTabId)
             : undefined;
         const canShareActiveTab = activeTab && (activeTabMessageCount > 0 || activeTab.status !== "idle");
-        return (_jsxs(_Fragment, { children: [_jsx("div", { "aria-hidden": "true", "data-agent-page-chat-fade": "", className: "pointer-events-none absolute inset-x-0 top-0 z-50 h-16 bg-gradient-to-b from-background via-background/90 to-transparent opacity-0 transition-opacity duration-150" }), _jsx("div", { className: "pointer-events-none absolute inset-x-0 top-3 z-[60] flex justify-end px-3 sm:top-4 sm:px-4", children: _jsxs("div", { className: "pointer-events-auto flex items-center gap-1", children: [canShareActiveTab ? (_jsx(ShareButton, { resourceType: "chat_thread", resourceId: activeTab.id, allowedRoles: ["viewer", "editor", "admin"], resourceTitle: activeTab.label || "Chat", shareUrl: getChatThreadShareUrl(activeTab.id), trigger: "icon", triggerClassName: "h-8 w-8 border border-border bg-background/95 shadow-sm backdrop-blur hover:bg-accent" })) : null, _jsxs("button", { type: "button", "data-agent-page-new-chat": "", "aria-label": t("agentPanel.newChat"), onClick: () => {
+        return (_jsxs(_Fragment, { children: [_jsx("div", { "aria-hidden": "true", "data-agent-page-chat-fade": "", className: "pointer-events-none absolute inset-x-0 top-0 z-50 h-16 bg-gradient-to-b from-background via-background/90 to-transparent opacity-0 transition-opacity duration-150" }), _jsx("div", { className: "pointer-events-none absolute inset-x-0 top-3 z-[60] flex justify-end px-3 sm:top-4 sm:px-4", children: _jsxs("div", { className: "pointer-events-auto flex items-center gap-1", children: [canShareActiveTab ? (_jsx(ShareButton, { resourceType: "chat_thread", resourceId: activeTab.id, allowedRoles: ["viewer", "editor", "admin"], resourceTitle: activeTab.label || t("agentPanel.chat"), shareUrl: getChatThreadShareUrl(activeTab.id), triggerClassName: "h-8 px-2 border border-border bg-background/95 shadow-sm backdrop-blur hover:bg-accent" })) : null, _jsxs("button", { type: "button", "data-agent-page-new-chat": "", "aria-label": t("agentPanel.newChat"), onClick: () => {
                                     addTab();
                                 }, className: "inline-flex h-8 items-center gap-1.5 rounded-md border border-border bg-background/95 px-2.5 text-xs font-medium text-foreground shadow-sm backdrop-blur transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: [_jsx(IconPlus, { size: 14 }), _jsx("span", { children: t("agentPanel.newChat") })] })] }) })] }));
     }, [getChatThreadShareUrl, t]);
@@ -829,7 +830,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                                             activeTab?.parentThreadId === tab.id);
                                     return (_jsxs("div", { role: "button", tabIndex: 0, ref: isActive ? activeTabRefCb : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer max-w-[150px]", isActive
                                             ? "bg-accent text-foreground"
-                                            : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1.5 w-1.5 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": "Close tab", onClick: (e) => {
+                                            : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1.5 w-1.5 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": t("agentPanel.closeTab"), onClick: (e) => {
                                                     e.stopPropagation();
                                                     closeTab(tab.id);
                                                 }, className: "agent-tab-close flex items-center justify-end text-muted-foreground hover:text-foreground", style: {
@@ -872,7 +873,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                                                         activeTab?.parentThreadId === tab.id);
                                                 return (_jsxs("div", { role: "button", tabIndex: 0, ref: isActive ? activeTabRefCb : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer max-w-[150px]", isActive
                                                         ? "bg-accent text-foreground"
-                                                        : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1.5 w-1.5 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": "Close tab", onClick: (e) => {
+                                                        : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1.5 w-1.5 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": t("agentPanel.closeTab"), onClick: (e) => {
                                                                 e.stopPropagation();
                                                                 closeTab(tab.id);
                                                             }, className: "agent-tab-close flex items-center justify-end text-muted-foreground hover:text-foreground", style: {
@@ -890,7 +891,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                                                     ? activeTabRefCb
                                                     : undefined, onClick: () => setActiveCliTab(id), onKeyDown: activateOnKeyDown(() => setActiveCliTab(id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1.5 text-[11px] font-medium cursor-pointer", id === activeCliTab
                                                     ? "bg-accent text-foreground"
-                                                    : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsxs("span", { children: ["Terminal ", i + 1] }), _jsx("button", { type: "button", "aria-label": "Close tab", onClick: (e) => {
+                                                    : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsxs("span", { children: ["Terminal ", i + 1] }), _jsx("button", { type: "button", "aria-label": t("agentPanel.closeTab"), onClick: (e) => {
                                                             e.stopPropagation();
                                                             closeCliTab(id);
                                                         }, className: "agent-tab-close flex items-center justify-end text-muted-foreground hover:text-foreground", style: {
@@ -908,7 +909,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                                                     ? activeTabRefCb
                                                     : undefined, onClick: () => setActiveTabId(tab.id), onKeyDown: activateOnKeyDown(() => setActiveTabId(tab.id)), className: cn("agent-tab relative flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-[10px] font-medium cursor-pointer max-w-[140px]", tab.id === activeTabId
                                                     ? "bg-accent text-foreground"
-                                                    : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.subAgentName || tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1 w-1 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": "Close tab", onClick: (e) => {
+                                                    : "text-muted-foreground hover:bg-accent hover:text-foreground"), children: [_jsx("span", { className: "truncate pe-1", children: tab.subAgentName || tab.label }), tab.status === "running" && (_jsx("span", { className: "h-1 w-1 shrink-0 rounded-full bg-muted-foreground/50 animate-pulse" })), _jsx("button", { type: "button", "aria-label": t("agentPanel.closeTab"), onClick: (e) => {
                                                             e.stopPropagation();
                                                             closeTab(tab.id);
                                                         }, className: "agent-tab-close flex items-center justify-end text-muted-foreground hover:text-foreground", style: {
@@ -937,6 +938,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
         activeTabRefCb,
         activateOnKeyDown,
         closeCliTab,
+        t,
     ]);
     return (_jsxs("div", { className: cn("agent-panel-root flex flex-1 flex-col min-h-0 h-full text-[13px] leading-[1.2] antialiased", className), style: {
             ...AGENT_PANEL_ROOT_STYLE,
@@ -972,7 +974,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                 ? mode === "cli" &&
                     cliTabs.map((id) => (_jsx("div", { className: "min-h-0 relative flex-1", style: {
                             display: id === activeCliTab ? undefined : "none",
-                        }, children: _jsx(Suspense, { fallback: _jsx("div", { className: "flex items-center justify-center h-full text-muted-foreground text-sm", children: "Loading terminal..." }), children: _jsx(AgentTerminal, { command: selectedCli, hideInFrame: false, className: "h-full", style: { background: "transparent" } }) }) }, id)))
+                        }, children: _jsx(Suspense, { fallback: _jsx("div", { className: "flex items-center justify-center h-full text-muted-foreground text-sm", children: t("agentPanel.loadingTerminal") }), children: _jsx(AgentTerminal, { command: selectedCli, hideInFrame: false, className: "h-full", style: { background: "transparent" } }) }) }, id)))
                 : mode === "cli" && (_jsx("div", { className: "flex flex-1 flex-col items-center justify-center min-h-0 px-6 gap-3", children: _jsx(CodeAccessUnavailablePanel, { title: codeAccessEnabled
                             ? t("agentPanel.cliRequiresDevMode")
                             : codeUnavailableTitle, description: codeAccessEnabled
@@ -1405,14 +1407,16 @@ export function AgentChatSurface({ mode = "panel", className, defaultMode = "cha
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export function AgentSidebar({ children, emptyStateText = "How can I help you?", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openOnChatRunning = false, onFullscreenRequest, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, }) {
+export function AgentSidebar({ children, emptyStateText = "How can I help you?", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openStorageKey, apiUrl, agentChatSurface, showTabBar = true, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning = false, onFullscreenRequest, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, }) {
+    const sidebarOpenStorageKey = openStorageKey ?? storageKey;
     const onboardingPreviewMode = useOnboardingPreviewMode();
     const firstRunOnboardingGateOwnsSurface = useFirstRunOnboardingGateOwnsSurface();
     const showFirstRunOnboarding = !firstRunOnboardingGateOwnsSurface &&
         !suppressFirstRunOnboarding &&
         (SHOW_FIRST_RUN_ONBOARDING || onboardingPreviewMode);
     const initialWidth = defaultSidebarWidth ?? sidebarWidth ?? 380;
-    const [open, setOpen] = useState(() => openOnChatRunning || getInitialAgentSidebarOpen(defaultOpen, storageKey));
+    const [open, setOpen] = useState(() => openOnChatRunning ||
+        getInitialAgentSidebarOpen(defaultOpen, sidebarOpenStorageKey));
     const [presentationMode, setPresentationMode] = useState(false);
     const [width, setWidth] = useState(initialWidth);
     const [isWideDrawer, setIsWideDrawer] = useState(() => {
@@ -1469,15 +1473,15 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
     const setOpenPersisted = useCallback((next) => {
         setOpen((prev) => {
             const value = typeof next === "function" ? next(prev) : next;
-            setAgentSidebarOpenPreference(value, storageKey);
+            setAgentSidebarOpenPreference(value, sidebarOpenStorageKey);
             return value;
         });
-    }, [storageKey]);
+    }, [sidebarOpenStorageKey]);
     const applyUrlOpenOverride = useCallback(() => {
-        const override = consumeAgentSidebarUrlOpenOverride(storageKey);
+        const override = consumeAgentSidebarUrlOpenOverride(sidebarOpenStorageKey);
         if (override !== null)
             setOpenPersisted(override);
-    }, [setOpenPersisted, storageKey]);
+    }, [setOpenPersisted, sidebarOpenStorageKey]);
     useEffect(() => {
         applyUrlOpenOverride();
         return subscribeAgentSidebarUrlChanges(applyUrlOpenOverride);
@@ -1922,11 +1926,11 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
                             ? "desktop"
                             : undefined, "data-agent-sidebar-layout": panelLayout, "data-agent-sidebar-position": position, "data-agent-sidebar-state": panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, "data-agent-sidebar-chat-handoff": chatViewTransitionHandoff ? "true" : undefined, style: chatViewTransition
                     ? getAgentChatViewTransitionStyle(panelStyle)
-                    : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, threadFooterSlot: threadFooterSlot, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), onSnapTo75Percent: isMobile ? undefined : snapTo75Percent, isWideDrawer: isMobile ? false : isWideDrawer, onExitWideDrawer: isMobile ? undefined : exitWideDrawer, onFullViewRequest: onFullscreenRequest, storageKey: storageKey, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: position, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
+                    : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, threadFooterSlot: threadFooterSlot, apiUrl: apiUrl, agentChatSurface: agentChatSurface, showTabBar: showTabBar, suppressInlineOpenApp: suppressInlineOpenApp, composerPlaceholder: composerPlaceholder, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), onSnapTo75Percent: isMobile ? undefined : snapTo75Percent, isWideDrawer: isMobile ? false : isWideDrawer, onExitWideDrawer: isMobile ? undefined : exitWideDrawer, onFullViewRequest: onFullscreenRequest, storageKey: storageKey, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: position, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
     const drawerPlaceholder = wideDrawerEnabled && !presentationMode && panelOpen ? (_jsx("div", { "aria-hidden": "true", className: "agent-sidebar-drawer-placeholder shrink-0", "data-agent-sidebar-placeholder": "true", style: { width: drawerPlaceholderWidth + 1 } })) : null;
     return (_jsx(AgentSidebarOnboardingContext.Provider, { value: true, children: _jsxs(RealtimeVoiceModeProvider, { browserTabId: browserTabId, children: [showFirstRunOnboarding && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsxs("div", { className: "agent-sidebar-shell flex min-w-0 flex-1 h-screen overflow-hidden", "data-agent-sidebar-position": position, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: [isMobile &&
                             !presentationMode &&
-                            (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-foreground/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? _jsx(URLSync, { browserTabId: browserTabId }) : null, isLeft && !presentationMode ? sidebar : null, isLeft && !presentationMode ? drawerPlaceholder : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": position, "data-agent-sidebar-main-state": !isMobile && !presentationMode && panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: _jsx(ScreenRefreshBoundary, { children: children }) }), !isLeft && !presentationMode ? drawerPlaceholder : null, !isLeft && !presentationMode ? sidebar : null] })] }) }));
+                            (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-foreground/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? _jsx(URLSync, { browserTabId: browserTabId }) : null, isResizing ? (_jsx("div", { "aria-hidden": "true", className: "agent-sidebar-resize-overlay" })) : null, isLeft && !presentationMode ? sidebar : null, isLeft && !presentationMode ? drawerPlaceholder : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": position, "data-agent-sidebar-main-state": !isMobile && !presentationMode && panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: _jsx(ScreenRefreshBoundary, { children: children }) }), !isLeft && !presentationMode ? drawerPlaceholder : null, !isLeft && !presentationMode ? sidebar : null] })] }) }));
 }
 /**
  * Focus the agent chat composer input.
@@ -1957,6 +1961,7 @@ export function focusAgentChat() {
  * Dispatches a custom event that AgentSidebar listens for.
  */
 export function AgentToggleButton({ className }) {
+    const t = useT();
     const [open, setOpen] = useState(false);
     useEffect(() => {
         const handler = (event) => {
@@ -1972,5 +1977,5 @@ export function AgentToggleButton({ className }) {
     // own close button.
     if (open)
         return null;
-    return (_jsx(DesignSystemTooltip, { trigger: _jsx("button", { type: "button", "aria-label": "Toggle agent", onClick: () => window.dispatchEvent(new Event("agent-panel:toggle")), className: cn("inline-flex h-8 w-8 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-accent/40 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", className), children: _jsx(IconMessageDots, { size: 20, "aria-hidden": true }) }), content: "Toggle agent", delayMs: 200 }));
+    return (_jsx(DesignSystemTooltip, { trigger: _jsx("button", { type: "button", "aria-label": t("agentPanel.toggleAgent"), onClick: () => window.dispatchEvent(new Event("agent-panel:toggle")), className: cn("inline-flex h-8 w-8 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-accent/40 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", className), children: _jsx(IconMessageDots, { size: 20, "aria-hidden": true }) }), content: t("agentPanel.toggleAgent"), delayMs: 200 }));
 }

package/dist/client/AssistantChat.d.ts

@@ -132,11 +132,22 @@ export declare function resolveAssistantChatRunningState({ forceStopped, isRunti
     isRunning: boolean;
     showRunningInUI: boolean;
 };
-export declare function resolveAssistantChatRunningStatusLabel({ runningActivityLabel, isAutoResuming, isReconnecting, hasReconnectContent, }: {
+export declare function resolveAssistantChatRunningStatusLabel({ runningActivityLabel, isAutoResuming, isReconnecting, hasReconnectContent, labels, }: {
     runningActivityLabel: string | null | undefined;
     isAutoResuming: boolean;
     isReconnecting: boolean;
     hasReconnectContent: boolean;
+    labels?: {
+        thinking: string;
+        resuming: string;
+        stillWorking: string;
+        working?: string;
+        contactingModel?: string;
+        starting?: (activity: string) => string;
+        preparing?: (activity: string) => string;
+        writing?: (activity: string) => string;
+        stillGenerating?: (activity: string) => string;
+    };
 }): string;
 export declare function resolveAssistantChatComposerPlaceholder(composerPlaceholder: string | null | undefined): string;
 export declare function shouldShowGlobalRunningStatus({ showRunningInUI, runningActivityLabel, runningActivityTool, latestMessage, reconnectContent, }: {
@@ -311,6 +322,8 @@ export interface AssistantChatProps {
     composerToolbarSlot?: React.ReactNode;
     /** Optional action rendered beside the voice/send controls. */
     composerExtraActionButton?: React.ReactNode;
+    /** Show the framework model picker in the shared composer. Defaults to true. */
+    showModelSelector?: boolean;
     /** Disable the composer for capability-gated surfaces while still showing history. */
     composerDisabled?: boolean;
     /** Placeholder to show while the composer is disabled by the host surface. */
@@ -410,6 +423,7 @@ export interface AssistantChatProps {
         onAlwaysAllow?: (approvalKey: string) => void;
     };
 }
+export declare function shouldShowAssistantChatModelSelector(showModelSelector: boolean | undefined): boolean;
 export declare const CHAT_STORAGE_PREFIX = "agent-chat:";
 /** Remove persisted chat for a given tabId (or "default"). */
 export declare function clearChatStorage(tabId?: string): void;