@agent-native/core 0.157.2 → 0.157.4

package/corpus/templates/slides/app/global.css

@@ -435,11 +435,107 @@ button[title="Open agent sidebar"] {
   height: 100%;
   display: flex;
   flex-direction: column;
-  font-family: "Poppins", sans-serif;
+  color: var(--ds-text, #ffffff);
+  background: var(--ds-bg, #0b0b0d);
+  font-family: var(--ds-body-font, "Poppins", sans-serif);
   box-sizing: border-box;
   overflow: hidden;
 }
 
+/* Semantic slide markup is persisted by the agent. Keep the classes useful
+   when a later edit omits inline styles, while leaving explicit inline values
+   authoritative through the normal CSS cascade. */
+.fmd-slide.fmd-slide--title {
+  justify-content: center;
+  align-items: flex-start;
+  gap: 24px;
+  padding: 80px 110px;
+}
+
+.fmd-slide.fmd-slide--content,
+.fmd-slide.fmd-slide--two-column {
+  justify-content: flex-start;
+  gap: 24px;
+  padding: 64px 80px;
+}
+
+.fmd-slide.fmd-slide--statement {
+  align-items: center;
+  justify-content: center;
+  gap: 24px;
+  padding: 64px 80px;
+  text-align: center;
+}
+
+.fmd-slide.fmd-slide--title h1,
+.fmd-slide.fmd-slide--content h1,
+.fmd-slide.fmd-slide--content h2,
+.fmd-slide.fmd-slide--two-column h1,
+.fmd-slide.fmd-slide--two-column h2,
+.fmd-slide.fmd-slide--statement h1,
+.fmd-slide.fmd-slide--statement h2 {
+  color: var(--ds-text, #ffffff);
+  font-family: var(
+    --ds-heading-font,
+    var(--ds-body-font, "Poppins", sans-serif)
+  );
+  font-weight: 700;
+  letter-spacing: -0.03em;
+}
+
+.fmd-slide.fmd-slide--title h1 {
+  font-size: 46px;
+  line-height: 1.1;
+}
+
+.fmd-slide.fmd-slide--content h1,
+.fmd-slide.fmd-slide--two-column h1,
+.fmd-slide.fmd-slide--statement h1 {
+  font-size: 38px;
+  line-height: 1.15;
+}
+
+.fmd-slide.fmd-slide--content h2,
+.fmd-slide.fmd-slide--two-column h2 {
+  font-size: 30px;
+  line-height: 1.2;
+}
+
+.fmd-slide.fmd-slide--statement h2 {
+  font-size: 42px;
+  line-height: 1.15;
+}
+
+.fmd-slide .fmd-subtitle,
+.fmd-slide .fmd-muted {
+  color: var(--ds-text-muted, rgba(255, 255, 255, 0.7));
+}
+
+.fmd-slide .fmd-subtitle {
+  font-size: 22px;
+  line-height: 1.4;
+}
+
+.fmd-slide .fmd-columns {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 32px;
+  width: 100%;
+  min-height: 0;
+}
+
+.fmd-slide .fmd-callout {
+  padding: 20px 24px;
+  border: 1px solid var(--ds-accent, rgba(255, 255, 255, 0.2));
+  border-radius: var(--ds-radius, 12px);
+  background: rgba(255, 255, 255, 0.05);
+}
+
+.fmd-slide .fmd-accent,
+.fmd-slide .fmd-cyan {
+  color: var(--ds-accent, #00e5ff);
+}
+
 .fmd-autofit-scale {
   transform: translate(var(--fmd-fit-x, 0px), var(--fmd-fit-y, 0px))
     scale(var(--fmd-fit-scale, 1));
@@ -461,7 +557,7 @@ button[title="Open agent sidebar"] {
 
 /* Section label - cyan uppercase */
 .fmd-label {
-  color: #00e5ff;
+  color: var(--ds-accent, #00e5ff);
   font-size: 11px;
   font-weight: 600;
   letter-spacing: 3px;
@@ -471,7 +567,7 @@ button[title="Open agent sidebar"] {
 
 /* Cyan accent color */
 .fmd-cyan {
-  color: #00e5ff !important;
+  color: var(--ds-accent, #00e5ff);
 }
 
 /* Large stat numbers */

package/corpus/templates/slides/app/i18n/en-US.ts

@@ -295,6 +295,7 @@ const messages = {
     creatingLink: "Creating link...",
     createShareLink: "Create Share Link",
     copyLink: "Copy link",
+    copied: "Copied",
     openSharedLink: "Open shared link",
     anyoneWithLink: "Anyone with this link can view this presentation.",
   },

package/corpus/templates/tasks/.agents/skills/agent-native-toolkit/SKILL.md

@@ -182,6 +182,11 @@ in the moment of agent use.
   five-item sidebar preview and a footer row with New chat followed by an
   ellipsis disclosure up to fifteen. Apps inject routing, labels, and domain
   actions.
+- **Data grid kit**: provider-agnostic spreadsheet mechanics belong in
+  `@agent-native/toolkit/data-grid`. Apps provide rows, typed columns, editor
+  slots, selection and width state, persistence callbacks, and product-level
+  row/body slots. Keep database models, access checks, grouping, drag/drop,
+  and domain actions in the app adapter.
 - **Agent page kit**: the full-page `/agent` surface (`AgentTabsPage` from
   `@agent-native/core/client`) with Context, Files, Connections, Jobs, and
   Access tabs plus a Personal/Organization scope toggle. The canonical home

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.