@agent-native/core 0.157.3 → 0.157.5

package/corpus/templates/tasks/.agents/skills/sharing/SKILL.md

@@ -184,6 +184,27 @@ import { ShareButton } from "@agent-native/core/client/sharing";
 
 For list views, show `<VisibilityBadge visibility={row.visibility} />` next to each resource.
 
+## Standard share surface
+
+All app share popovers should use the same compact surface contract:
+
+- Use the text-only `ShareTrigger` from `@agent-native/toolkit/sharing`.
+- Render ordinary links with `ShareCopyRow`, which exposes a Copy action without
+  printing the raw URL.
+- Keep general access and individual people access in the standard Core sharing
+  flow. The people flow supports email invites, roles, notifications, and
+  removal through the shared share actions.
+- Add `ShareAgentsSection` only when the resource has a real agent-readable
+  link or prompt. Keep it collapsed by default and supply domain-specific
+  content through the shared section shell.
+- App-specific tabs or controls may remain when they represent a real domain
+  action (for example, an embed-code editor), but they should retain the same
+  trigger, copy-row, access, and spacing language.
+
+`ShareDisclosureSection` is the toolkit-owned shell for optional expandable
+share details; use its `ShareAgentsSection` or `SharePeopleSection` wrappers
+instead of creating another collapsible share panel in a template.
+
 ## Actions available everywhere
 
 The framework auto-mounts these actions in every template — no per-template boilerplate:

package/dist/chat-threads/schema.d.ts

@@ -463,7 +463,7 @@ export declare const chatThreadShares: import("drizzle-orm/sqlite-core").SQLiteT
             data: string;
             driverParam: string;
             notNull: true;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;

package/dist/cli/code-agent-executor.js

@@ -23,6 +23,8 @@ const MAX_TOOL_OUTPUT_CHARS = 50_000;
 const MAX_FILE_READ_CHARS = 120_000;
 const CODEX_CLI_ENGINE_NAME = "codex-cli";
 const CLAUDE_CLI_ENGINE_NAME = "claude-cli";
+const PI_CLI_ENGINE_NAME = "pi-cli";
+const OPENCODE_CLI_ENGINE_NAME = "opencode-cli";
 const CLAUDE_CLI_DEFAULT_MODEL = "claude-sonnet-5";
 const RECAP_SOURCE_TOOL_PROFILE = "recap-source";
 const RECAP_SOURCE_OUTPUT_FILE = "recap-source.json";
@@ -125,6 +127,30 @@ export async function executeCodeAgentRun(options) {
             signal: options.signal,
         });
     }
+    if (requestedEngine === PI_CLI_ENGINE_NAME) {
+        return executePiCliRun({
+            run: existing,
+            prompt: executionPrompt,
+            model: options.model ?? metadataString(existing, "model"),
+            reasoningEffort: options.reasoningEffort ?? metadataReasoningEffort(existing),
+            permissionMode: existing.permissionMode ?? "full-auto",
+            stdout: options.stdout,
+            streamToolOutputToStdout,
+            signal: options.signal,
+        });
+    }
+    if (requestedEngine === OPENCODE_CLI_ENGINE_NAME) {
+        return executeOpenCodeCliRun({
+            run: existing,
+            prompt: executionPrompt,
+            model: options.model ?? metadataString(existing, "model"),
+            reasoningEffort: options.reasoningEffort ?? metadataReasoningEffort(existing),
+            permissionMode: existing.permissionMode ?? "full-auto",
+            stdout: options.stdout,
+            streamToolOutputToStdout,
+            signal: options.signal,
+        });
+    }
     const engine = options.engine ?? (await resolveExecutorEngine(requestedEngine));
     if (!engine) {
         const message = "No LLM provider key was found. Set ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, another supported provider key, or run `codex login` to use Codex CLI.";
@@ -669,6 +695,298 @@ function isRecordValue(value) {
 function asRecordValue(value) {
     return isRecordValue(value) ? value : null;
 }
+async function executePiCliRun(options) {
+    const model = normalizeLocalCliModel(options.model, PI_CLI_ENGINE_NAME);
+    const thinking = normalizePiCliThinking(options.reasoningEffort);
+    const args = ["--print", "--mode", "text", "--no-session"];
+    if (options.permissionMode === "read-only") {
+        args.push("--tools", "read,grep,find,ls");
+    }
+    if (model)
+        args.push("--model", model);
+    if (thinking)
+        args.push("--thinking", thinking);
+    args.push(buildLocalCliPrompt(options.run, options.prompt));
+    return executeSimpleLocalCliRun({
+        ...options,
+        engine: PI_CLI_ENGINE_NAME,
+        label: "Pi",
+        command: "pi",
+        args,
+        model,
+    });
+}
+async function executeOpenCodeCliRun(options) {
+    const model = normalizeLocalCliModel(options.model, OPENCODE_CLI_ENGINE_NAME);
+    const variant = normalizeOpenCodeVariant(options.reasoningEffort);
+    const cwd = options.run.cwd || process.cwd();
+    const args = ["run", "--format", "default", "--dir", cwd];
+    if (options.permissionMode === "read-only") {
+        args.push("--agent", "plan");
+    }
+    if (model)
+        args.push("--model", model);
+    if (variant)
+        args.push("--variant", variant);
+    args.push(buildLocalCliPrompt(options.run, options.prompt));
+    return executeSimpleLocalCliRun({
+        ...options,
+        engine: OPENCODE_CLI_ENGINE_NAME,
+        label: "OpenCode",
+        command: "opencode",
+        args,
+        model,
+    });
+}
+async function executeSimpleLocalCliRun(options) {
+    const cwd = options.run.cwd || process.cwd();
+    const streamToolOutputToStdout = options.streamToolOutputToStdout ??
+        process.env.AGENT_NATIVE_CODE_AGENT_STRUCTURED_STDOUT !== "1";
+    appendCodeAgentTranscriptEvent({
+        runId: options.run.id,
+        kind: "status",
+        message: `Starting ${options.label} locally.`,
+        metadata: {
+            status: "running",
+            phase: "executing",
+            engine: options.engine,
+        },
+    });
+    try {
+        const result = await runLocalCliProcess({
+            command: options.command,
+            args: options.args,
+            cwd,
+            prompt: options.prompt,
+            stdout: options.stdout,
+            streamToolOutputToStdout,
+            signal: options.signal,
+        });
+        if (result.exitCode !== 0) {
+            const interrupted = options.signal?.aborted === true;
+            const message = result.error ||
+                result.stderr.trim() ||
+                `${options.label} exited with ${result.exitSignal ?? result.exitCode}.`;
+            const summary = interrupted
+                ? `${options.label} run paused.`
+                : `${options.label} run failed: ${message}`;
+            if (streamToolOutputToStdout)
+                options.stdout?.write(`\n${summary}\n`);
+            appendCodeAgentTranscriptEvent({
+                runId: options.run.id,
+                kind: "status",
+                message: summary,
+                metadata: {
+                    status: interrupted ? "paused" : "errored",
+                    phase: interrupted ? "paused" : "error",
+                    engine: options.engine,
+                    exitCode: result.exitCode,
+                    exitSignal: result.exitSignal,
+                },
+            });
+            return updateCodeAgentRunRecord(options.run.id, {
+                status: interrupted ? "paused" : "errored",
+                phase: interrupted ? "paused" : "error",
+                progress: {
+                    label: interrupted ? "Paused" : "Error",
+                    completed: 0,
+                    total: 1,
+                    failed: interrupted ? 0 : 1,
+                    percent: 0,
+                },
+                metadata: {
+                    ...(interrupted
+                        ? { executionPausedAt: new Date().toISOString() }
+                        : {
+                            executionError: message,
+                            executionErroredAt: new Date().toISOString(),
+                        }),
+                    engine: options.engine,
+                    ...(options.model ? { model: options.model } : {}),
+                },
+            });
+        }
+        const finalMessage = result.stdout.trim() || `${options.label} run completed.`;
+        appendCodeAgentTranscriptEvent({
+            runId: options.run.id,
+            kind: "system",
+            message: finalMessage,
+            metadata: {
+                role: "assistant",
+                engine: options.engine,
+                ...(options.model ? { model: options.model } : {}),
+            },
+        });
+        const pendingFollowUp = dequeueCodeAgentFollowUp(options.run.id);
+        if (pendingFollowUp) {
+            const message = pendingFollowUp.mode === "queued"
+                ? `${options.label} run completed; running queued follow-up.`
+                : `${options.label} run completed; applying steering follow-up.`;
+            appendCodeAgentTranscriptEvent({
+                runId: options.run.id,
+                kind: "status",
+                message,
+                metadata: {
+                    status: "running",
+                    phase: "follow-up",
+                    followUpId: pendingFollowUp.id,
+                    followUpMode: pendingFollowUp.mode,
+                    engine: options.engine,
+                },
+            });
+            if (pendingFollowUp.permissionMode) {
+                updateCodeAgentRunRecord(options.run.id, {
+                    permissionMode: pendingFollowUp.permissionMode,
+                });
+            }
+            return executeCodeAgentRun({
+                runId: options.run.id,
+                prompt: pendingFollowUp.prompt,
+                attachments: pendingFollowUp.attachments ??
+                    userPromptAttachmentsForEvent(options.run.id, pendingFollowUp.eventId),
+                appendUserEvent: false,
+                stdout: options.stdout,
+                streamToolOutputToStdout: options.streamToolOutputToStdout,
+                signal: options.signal,
+            });
+        }
+        appendCodeAgentTranscriptEvent({
+            runId: options.run.id,
+            kind: "status",
+            message: `${options.label} run completed.`,
+            metadata: {
+                status: "completed",
+                phase: "complete",
+                engine: options.engine,
+            },
+        });
+        return updateCodeAgentRunRecord(options.run.id, {
+            status: "completed",
+            phase: "complete",
+            needsApproval: false,
+            progress: {
+                label: "Complete",
+                completed: 1,
+                total: 1,
+                percent: 100,
+            },
+            metadata: {
+                executionCompletedAt: new Date().toISOString(),
+                engine: options.engine,
+                ...(options.model ? { model: options.model } : {}),
+                permissionMode: options.permissionMode,
+            },
+        });
+    }
+    catch (error) {
+        const interrupted = options.signal?.aborted === true;
+        const message = error instanceof Error ? error.message : String(error);
+        const summary = interrupted
+            ? `${options.label} run paused.`
+            : `${options.label} run failed: ${message}`;
+        if (streamToolOutputToStdout)
+            options.stdout?.write(`\n${summary}\n`);
+        appendCodeAgentTranscriptEvent({
+            runId: options.run.id,
+            kind: "status",
+            message: summary,
+            metadata: {
+                status: interrupted ? "paused" : "errored",
+                phase: interrupted ? "paused" : "error",
+                engine: options.engine,
+            },
+        });
+        return updateCodeAgentRunRecord(options.run.id, {
+            status: interrupted ? "paused" : "errored",
+            phase: interrupted ? "paused" : "error",
+            progress: {
+                label: interrupted ? "Paused" : "Error",
+                completed: 0,
+                total: 1,
+                failed: interrupted ? 0 : 1,
+                percent: 0,
+            },
+            metadata: {
+                ...(interrupted
+                    ? { executionPausedAt: new Date().toISOString() }
+                    : {
+                        executionError: message,
+                        executionErroredAt: new Date().toISOString(),
+                    }),
+                engine: options.engine,
+                ...(options.model ? { model: options.model } : {}),
+            },
+        });
+    }
+}
+function runLocalCliProcess(options) {
+    return new Promise((resolve) => {
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        const child = spawn(options.command, options.args, {
+            cwd: options.cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+            env: process.env,
+        });
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            options.signal?.removeEventListener("abort", onAbort);
+            resolve({ ...result, stdout, stderr });
+        };
+        const onAbort = () => child.kill("SIGTERM");
+        if (options.signal) {
+            if (options.signal.aborted)
+                onAbort();
+            else
+                options.signal.addEventListener("abort", onAbort, { once: true });
+        }
+        child.stdout?.on("data", (chunk) => {
+            const text = chunk.toString();
+            stdout += text;
+            if (options.streamToolOutputToStdout ?? true) {
+                options.stdout?.write(text);
+            }
+        });
+        child.stderr?.on("data", (chunk) => {
+            const text = chunk.toString();
+            stderr += text;
+            if (options.streamToolOutputToStdout ?? true) {
+                options.stdout?.write(text);
+            }
+        });
+        child.on("error", (error) => finish({
+            exitCode: null,
+            exitSignal: null,
+            error: error.message,
+        }));
+        child.on("close", (exitCode, exitSignal) => finish({ exitCode, exitSignal }));
+        // Pi and OpenCode receive the prompt as a positional argument. Close the
+        // pipe without sending it a second time.
+        child.stdin?.end();
+    });
+}
+function buildLocalCliPrompt(run, prompt) {
+    return buildClaudeCliPrompt(run, prompt);
+}
+function normalizeLocalCliModel(model, engine) {
+    const trimmed = model?.trim();
+    if (!trimmed || trimmed === "auto" || trimmed === engine)
+        return undefined;
+    return trimmed;
+}
+function normalizePiCliThinking(effort) {
+    if (!effort || effort === "auto" || effort === "none")
+        return undefined;
+    return effort === "max" ? "xhigh" : effort;
+}
+function normalizeOpenCodeVariant(effort) {
+    if (!effort || effort === "auto" || effort === "none")
+        return undefined;
+    return effort;
+}
 async function executeCodexCliRun(options) {
     const cwd = options.run.cwd || process.cwd();
     const outputDir = fs.mkdtempSync(path.join(os.tmpdir(), "agent-native-code-codex-"));

package/dist/client/AgentPanel.d.ts

@@ -173,6 +173,18 @@ export interface AgentSidebarProps {
     onComposerTextChange?: AssistantChatProps["onComposerTextChange"];
     /** Optional secondary model menu shown inside the chat composer model picker. */
     imageModelMenu?: AssistantChatProps["imageModelMenu"];
+    /** Local or hosted agent runtimes shown above the model list. */
+    availableAgents?: AssistantChatProps["availableAgents"];
+    /** Selected agent runtime identifier. */
+    selectedAgent?: AssistantChatProps["selectedAgent"];
+    /** Callback when the user picks an agent runtime. */
+    onAgentChange?: AssistantChatProps["onAgentChange"];
+    /** Route local runtime setup through the host's native bridge. */
+    onConnectLocalRuntime?: AssistantChatProps["onConnectLocalRuntime"];
+    /** Bring-your-own runtime used by embedded hosts such as Electron. */
+    runtime?: AssistantChatProps["runtime"];
+    /** Explicit key for recreating an injected runtime adapter. */
+    adapterReloadKey?: AssistantChatProps["adapterReloadKey"];
     /** Optional content rendered at the bottom of the chat thread. */
     threadFooterSlot?: AssistantChatProps["threadFooterSlot"];
     /** Initial sidebar width in pixels. Mount-only; user resize and a saved
@@ -234,7 +246,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, openStorageKey, apiUrl, agentChatSurface, showTabBar, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning, onFullscreenRequest, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, }: AgentSidebarProps): React.JSX.Element;
+export declare function AgentSidebar({ children, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, selectedAgent, onAgentChange, onConnectLocalRuntime, runtime, adapterReloadKey, 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

@@ -44,6 +44,7 @@ import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js
 import { AGENT_SIDEBAR_MIN_WIDTH, consumeAgentSidebarUrlOpenOverride, clampAgentSidebarWidth, dispatchAgentSidebarStateChange, getAgentSidebarMaxWidth, getInitialAgentSidebarOpen, getAgentSidebarWideWidth, setAgentSidebarOpenPreference, subscribeAgentSidebarUrlChanges, SIDEBAR_STATE_CHANGE_EVENT, } from "./agent-sidebar-state.js";
 import { trackEvent } from "./analytics.js";
 import { agentNativePath, appPath, isWorkspaceAppPath } from "./api-path.js";
+import { APP_CHAT_SIDEBAR_STATE_EVENT, APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE, buildAppChatSidebarStateMessage, isPerAppChatStorageKey, } from "./app-chat-sidebar.js";
 import { readClientAppState } from "./application-state.js";
 import { assistantUiRecoverableRenderErrorKind } from "./assistant-ui-recovery.js";
 import { shouldParentFrameOwnAgentPanel } from "./builder-frame.js";
@@ -65,6 +66,12 @@ const AgentTerminal = lazy(() => import("./terminal/index.js").then((m) => ({ de
 const AGENT_PANEL_PREPARE_EVENT = "agent-panel:prepare";
 const AGENT_PANEL_SET_MODE_EVENT = "agent-panel:set-mode";
 const AGENT_PANEL_OPEN_SETTINGS_EVENT = "agent-panel:open-settings";
+function postPerAppChatSidebarStateToEmbeddedFrames(open) {
+    const message = buildAppChatSidebarStateMessage(open);
+    for (const frame of document.querySelectorAll("iframe")) {
+        frame.contentWindow?.postMessage(message, "*");
+    }
+}
 function settingsRouteHashForSection(section) {
     const normalized = section?.replace(/^#/, "").toLowerCase() ?? "";
     if (normalized === "voice")
@@ -1407,8 +1414,9 @@ 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, openStorageKey, apiUrl, agentChatSurface, showTabBar = true, suppressInlineOpenApp, composerPlaceholder, 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, availableAgents, selectedAgent, onAgentChange, onConnectLocalRuntime, runtime, adapterReloadKey, 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 isPerAppChatSidebar = isPerAppChatStorageKey(sidebarOpenStorageKey);
     const onboardingPreviewMode = useOnboardingPreviewMode();
     const firstRunOnboardingGateOwnsSurface = useFirstRunOnboardingGateOwnsSurface();
     const showFirstRunOnboarding = !firstRunOnboardingGateOwnsSurface &&
@@ -1537,6 +1545,36 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
         presentationMode,
         hasFrameSidebarState,
     ]);
+    useEffect(() => {
+        if (!isPerAppChatSidebar)
+            return;
+        const frameOwned = frameCodeMode && shouldParentFrameOwnAgentPanel();
+        if (frameOwned && !hasFrameSidebarState)
+            return;
+        const openState = !presentationMode && (frameOwned ? frameSidebarOpen : open);
+        const message = buildAppChatSidebarStateMessage(openState);
+        window.dispatchEvent(new CustomEvent(APP_CHAT_SIDEBAR_STATE_EVENT, {
+            detail: message.data,
+        }));
+        postPerAppChatSidebarStateToEmbeddedFrames(openState);
+        const handleStateRequest = (event) => {
+            if (event.data?.type !== APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE)
+                return;
+            const frame = Array.from(document.querySelectorAll("iframe")).find((candidate) => candidate.contentWindow === event.source);
+            if (!frame)
+                return;
+            frame.contentWindow?.postMessage(message, event.origin || "*");
+        };
+        window.addEventListener("message", handleStateRequest);
+        return () => window.removeEventListener("message", handleStateRequest);
+    }, [
+        frameCodeMode,
+        frameSidebarOpen,
+        hasFrameSidebarState,
+        isPerAppChatSidebar,
+        open,
+        presentationMode,
+    ]);
     useEffect(() => {
         const preparePanel = () => setBackgroundPanelActive(true);
         const handleChatRunning = (event) => {
@@ -1924,9 +1962,9 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
                         ? "mobile"
                         : desktopAnimationEnabled
                             ? "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
+                            : undefined, "data-agent-sidebar-layout": panelLayout, "data-agent-sidebar-position": position, "data-agent-sidebar-state": panelOpen ? "open" : "closed", "data-agent-sidebar-per-app-chat": isPerAppChatSidebar ? "true" : undefined, "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, 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;
+                    : 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, availableAgents: availableAgents, selectedAgent: selectedAgent, onAgentChange: onAgentChange, onConnectLocalRuntime: onConnectLocalRuntime, runtime: runtime, adapterReloadKey: adapterReloadKey, 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 &&

package/dist/client/AssistantChat.d.ts

@@ -1,4 +1,4 @@
-import type { ComposerImageModelMenu } from "@agent-native/toolkit/composer/TiptapComposer";
+import type { ComposerAgentOption, ComposerImageModelMenu } from "@agent-native/toolkit/composer/TiptapComposer";
 import type { ChatModelAdapter, ExportedMessageRepository } from "@assistant-ui/react";
 import React from "react";
 import type { ReasoningEffort } from "../shared/reasoning-effort.js";
@@ -262,6 +262,8 @@ export interface AssistantChatProps {
     threadId?: string;
     /** Resource scope to include with chat requests for server-side context. */
     contextScope?: ChatThreadScope | null;
+    /** Namespace used to hide ambient composer context from other host surfaces. */
+    contextNamespace?: string;
     /** Whether this chat owns the active visible composer context snapshot. */
     isActiveComposer?: boolean;
     /**
@@ -363,6 +365,12 @@ export interface AssistantChatProps {
     onModelChange?: (model: string, engine: string) => void;
     /** Callback when user picks an effort from the picker */
     onEffortChange?: (effort: ReasoningEffort) => void;
+    /** Local or hosted agent runtimes shown above the model list. */
+    availableAgents?: ComposerAgentOption[];
+    /** Selected agent runtime identifier. */
+    selectedAgent?: string;
+    /** Callback when the user picks an agent runtime. */
+    onAgentChange?: (agent: string) => void;
     /**
      * Optional secondary model menu (e.g. an image-generation model) shown inside
      * the composer's model picker. Opt-in; chat-only apps omit it.

package/dist/client/AssistantChat.js

@@ -10,7 +10,7 @@ import { useState, useRef, useEffect, useCallback, useMemo, useLayoutEffect, for
 import { createPollEngine } from "../shared/poll-engine.js";
 import { clearPendingTurnIfMatches, clearActiveRunIfMatches, getPendingTurn, getActiveRunActivityTool, getActiveRun, hasRecentActiveRunProgress, resolveReconnectAfterSeq, setActiveRun, updateActiveRunActivity, updateActiveRunSeq, } from "./active-run-state.js";
 import { activeRunLooksAlive, createAgentChatAdapter, hasInFlightToolCall, } from "./agent-chat-adapter.js";
-import { appendAgentChatContextToMessage, formatAgentChatContextItemsForPrompt, getAgentChatContextState, isAgentChatSubmitCancelled, normalizeAgentChatContextItem, publishAgentChatContextItems, refreshAgentChatContext, reportAgentChatSubmitResult, subscribeAgentChatContext, } from "./agent-chat.js";
+import { appendAgentChatContextToMessage, filterAgentChatContextItems, formatAgentChatContextItemsForPrompt, getAgentChatContextState, isAgentChatSubmitCancelled, normalizeAgentChatContextItem, publishAgentChatContextItems, refreshAgentChatContext, reportAgentChatSubmitResult, subscribeAgentChatContext, } from "./agent-chat.js";
 import { captureError } from "./analytics.js";
 import { agentNativePath } from "./api-path.js";
 import { AssistantMessageListErrorBoundary, AssistantUiStaleIndexErrorBoundary, } from "./assistant-ui-recovery.js";
@@ -1375,7 +1375,7 @@ export function useAutoResumeStatus(tabId, forceStopped) {
 function approvalResolutionIdentity(approvalKey, toolCallId) {
     return `${toolCallId ?? ""}\u0000${approvalKey}`;
 }
-const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateText, suggestions, dynamicSuggestions, threadFooterSlot, emptyStateAddon, showHeader = true, onSwitchToCli, className, apiUrl, tabId, browserTabId, threadId, contextScope, isActiveComposer = true, onMessageCountChange, onSaveThread, onGenerateTitle, composerSlot, onComposerTextChange, composerAreaClassName, composerPlaceholder, missingApiKeySetupLayout = "default", composerLayoutVariant = "default", centerComposerWhenEmpty = false, emptyStateDisplay = "default", composerToolbarSlot, composerExtraActionButton, showModelSelector = true, composerDisabled = false, composerDisabledPlaceholder, isNewThread, isThreadStateLoading, onSlashCommand, execMode, onExecModeChange, approvalActions, planModeDisabled, planModeDisabledReason, selectedModel, defaultModel, selectedEngine, selectedEffort, availableModels, modelListLoading, onModelChange, onEffortChange, imageModelMenu, onForkChat, onConnectProvider, onConnectLocalRuntime, plusMenuMode = "full", providerStatusChecksEnabled = true, loadHistoryRepository, historyReloadKey, externalStreaming = false, agentChatSurface = "app", suppressInlineOpenApp = false, }, ref) {
+const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateText, suggestions, dynamicSuggestions, threadFooterSlot, emptyStateAddon, showHeader = true, onSwitchToCli, className, apiUrl, tabId, browserTabId, threadId, contextScope, contextNamespace, isActiveComposer = true, onMessageCountChange, onSaveThread, onGenerateTitle, composerSlot, onComposerTextChange, composerAreaClassName, composerPlaceholder, missingApiKeySetupLayout = "default", composerLayoutVariant = "default", centerComposerWhenEmpty = false, emptyStateDisplay = "default", composerToolbarSlot, composerExtraActionButton, showModelSelector = true, composerDisabled = false, composerDisabledPlaceholder, isNewThread, isThreadStateLoading, onSlashCommand, execMode, onExecModeChange, approvalActions, planModeDisabled, planModeDisabledReason, selectedModel, defaultModel, selectedEngine, selectedEffort, availableModels, modelListLoading, onModelChange, onEffortChange, availableAgents, selectedAgent, onAgentChange, imageModelMenu, onForkChat, onConnectProvider, onConnectLocalRuntime, plusMenuMode = "full", providerStatusChecksEnabled = true, loadHistoryRepository, historyReloadKey, externalStreaming = false, agentChatSurface = "app", suppressInlineOpenApp = false, }, ref) {
     const t = useT();
     const thread = useThread();
     const threadRuntime = useThreadRuntime();
@@ -1529,11 +1529,18 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
     const composerContextItemsRef = useRef([]);
     const isActiveComposerRef = useRef(isActiveComposer);
     isActiveComposerRef.current = isActiveComposer;
+    const normalizedContextNamespace = contextNamespace?.trim() || undefined;
     const publishComposerContextItems = useCallback((items) => {
         if (!isActiveComposerRef.current)
             return;
-        publishAgentChatContextItems(items);
-    }, []);
+        const hiddenItems = normalizedContextNamespace
+            ? getAgentChatContextState().items.filter((item) => {
+                const itemNamespace = item.contextNamespace?.trim();
+                return (itemNamespace && itemNamespace !== normalizedContextNamespace);
+            })
+            : [];
+        publishAgentChatContextItems([...hiddenItems, ...items]);
+    }, [normalizedContextNamespace]);
     const updateComposerContextItems = useCallback((updater) => {
         setComposerContextItems((previous) => {
             const next = updater(previous);
@@ -1556,6 +1563,10 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         const item = normalizeAgentChatContextItem(rawItem);
         if (!item)
             return;
+        if (filterAgentChatContextItems([item], normalizedContextNamespace)
+            .length === 0) {
+            return;
+        }
         updateComposerContextItems((previous) => {
             const index = previous.findIndex((current) => current.key === item.key);
             if (index === -1)
@@ -1594,21 +1605,23 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
         void refreshAgentChatContext().then((state) => {
             if (cancelled || !isActiveComposerRef.current)
                 return;
-            composerContextItemsRef.current = state.items;
-            setComposerContextItems(state.items);
+            const visibleItems = filterAgentChatContextItems(state.items, normalizedContextNamespace);
+            composerContextItemsRef.current = visibleItems;
+            setComposerContextItems(visibleItems);
         });
         const unsubscribe = subscribeAgentChatContext(() => {
             if (cancelled || !isActiveComposerRef.current)
                 return;
             const state = getAgentChatContextState();
-            composerContextItemsRef.current = state.items;
-            setComposerContextItems(state.items);
+            const visibleItems = filterAgentChatContextItems(state.items, normalizedContextNamespace);
+            composerContextItemsRef.current = visibleItems;
+            setComposerContextItems(visibleItems);
         });
         return () => {
             cancelled = true;
             unsubscribe();
         };
-    }, [isActiveComposer]);
+    }, [isActiveComposer, normalizedContextNamespace]);
     // Tracks the JSON of the last queue we successfully persisted so the
     // debounced save effect can skip no-op writes (e.g. restore-from-server
     // on mount, or queue state that hasn't actually changed).
@@ -4263,16 +4276,16 @@ const AssistantChatInner = forwardRef(function AssistantChatInner({ emptyStateTe
                                                                                             isRunning,
                                                                                             requestedIntent: options?.intent,
                                                                                         }), undefined, true)
-                                                                                        : undefined, willQueue: engineSetupRequired || isRunning, onSlashCommand: onSlashCommand, execMode: execMode, onExecModeChange: onExecModeChange, planModeDisabled: planModeDisabled, planModeDisabledReason: planModeDisabledReason, selectedModel: selectedModel ?? defaultModel, selectedEffort: selectedEffort, availableModels: availableModels, modelListLoading: modelListLoading, onModelChange: shouldShowAssistantChatModelSelector(showModelSelector)
+                                                                                        : undefined, willQueue: engineSetupRequired || isRunning, onSlashCommand: onSlashCommand, execMode: execMode, onExecModeChange: onExecModeChange, planModeDisabled: planModeDisabled, planModeDisabledReason: planModeDisabledReason, selectedModel: selectedModel ?? defaultModel, selectedEffort: selectedEffort, availableModels: availableModels, availableAgents: availableAgents, selectedAgent: selectedAgent, modelListLoading: modelListLoading, onModelChange: shouldShowAssistantChatModelSelector(showModelSelector)
                                                                                         ? onModelChange
-                                                                                        : undefined, onEffortChange: onEffortChange, imageModelMenu: imageModelMenu, onConnectProvider: onConnectProvider, onConnectLocalRuntime: onConnectLocalRuntime, toolbarSlot: composerToolbarSlot, contextItems: composerContextItems, onRemoveContextItem: removeComposerContextItem, plusMenuMode: plusMenuMode, layoutVariant: composerLayoutVariant, providerConnectStatusEnabled: providerStatusChecksEnabled, voiceEnabled: true, draftScope: threadId || tabId, interceptBuildRequestsForBuilder: true, onAttachmentError: setComposerError, extraActionButton: composerExtraActionButton, stopButton: showRunningInUI ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: () => stopActiveRun({
+                                                                                        : undefined, onEffortChange: onEffortChange, onAgentChange: onAgentChange, imageModelMenu: imageModelMenu, onConnectProvider: onConnectProvider, onConnectLocalRuntime: onConnectLocalRuntime, toolbarSlot: composerToolbarSlot, contextItems: composerContextItems, onRemoveContextItem: removeComposerContextItem, plusMenuMode: plusMenuMode, layoutVariant: composerLayoutVariant, providerConnectStatusEnabled: providerStatusChecksEnabled, voiceEnabled: true, draftScope: threadId || tabId, interceptBuildRequestsForBuilder: true, onAttachmentError: setComposerError, extraActionButton: composerExtraActionButton, stopButton: showRunningInUI ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: () => stopActiveRun({
                                                                                                         preserveQueuedMessages: true,
                                                                                                     }), "aria-label": t("agentChat.composer.stopResponse"), "data-agent-composer-slot": "stop-button", className: "shrink-0 flex h-7 w-7 cursor-pointer items-center justify-center rounded-full bg-primary text-primary-foreground shadow-sm transition-opacity hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", children: _jsx(IconPlayerStopFilled, { className: "h-3 w-3" }) }) }), _jsx(TooltipContent, { children: t("agentChat.composer.stopResponse") })] })) : undefined })] })) }), showMissingKeySetup &&
                                                                         !showInlineMissingKeySetup ? (_jsx(PopoverContent, { side: missingApiKeySetupLayout === "sidebar"
                                                                             ? "top"
                                                                             : "bottom", align: "center", sideOffset: 8, collisionPadding: 12, "data-agent-native-composer-popover": "true", className: "z-[260] box-border w-[min(calc(100vw-2rem),var(--radix-popover-content-available-width,26rem),26rem)] rounded-lg border-border p-3 shadow-lg", children: _jsx(BuilderSetupContent, { onConnected: handleBuilderConnected, layout: missingApiKeySetupLayout }) })) : null] })] })] }) }) }) }) }) }) }) }) }) }) }));
 });
-export const AssistantChat = forwardRef(function AssistantChat({ apiUrl = agentNativePath("/_agent-native/agent-chat"), tabId, browserTabId, threadId, contextScope, isActiveComposer, ...props }, ref) {
+export const AssistantChat = forwardRef(function AssistantChat({ apiUrl = agentNativePath("/_agent-native/agent-chat"), tabId, browserTabId, threadId, contextScope, contextNamespace, isActiveComposer, ...props }, ref) {
     const modelRef = useRef(props.selectedModel);
     modelRef.current = props.selectedModel;
     const engineRef = useRef(props.selectedEngine);
@@ -4335,5 +4348,5 @@ export const AssistantChat = forwardRef(function AssistantChat({ apiUrl = agentN
     const runtime = useLocalRuntime(adapter, {
         adapters: { attachments: attachmentAdapter },
     });
-    return (_jsx(AssistantRuntimeProvider, { runtime: runtime, children: _jsx(TooltipProvider, { delayDuration: 200, children: _jsx(ThreadPrimitive.Root, { className: "flex flex-1 flex-col h-full min-h-0 overflow-x-hidden", children: _jsx(AssistantUiStaleIndexErrorBoundary, { resetKey: `${tabId ?? ""}:${threadId ?? ""}`, componentName: "AssistantChat", children: _jsx(AssistantChatInner, { ref: ref, ...props, browserTabId: browserTabId, contextScope: contextScope, isActiveComposer: isActiveComposer, apiUrl: apiUrl, tabId: tabId, threadId: threadId }) }) }) }) }));
+    return (_jsx(AssistantRuntimeProvider, { runtime: runtime, children: _jsx(TooltipProvider, { delayDuration: 200, children: _jsx(ThreadPrimitive.Root, { className: "flex flex-1 flex-col h-full min-h-0 overflow-x-hidden", children: _jsx(AssistantUiStaleIndexErrorBoundary, { resetKey: `${tabId ?? ""}:${threadId ?? ""}`, componentName: "AssistantChat", children: _jsx(AssistantChatInner, { ref: ref, ...props, browserTabId: browserTabId, contextScope: contextScope, contextNamespace: contextNamespace, isActiveComposer: isActiveComposer, apiUrl: apiUrl, tabId: tabId, threadId: threadId }) }) }) }) }));
 });