@agent-native/core 0.157.2 → 0.157.4

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 }) }) }) }) }));
 });

package/dist/client/MultiTabAssistantChat.js

@@ -3,7 +3,7 @@ import { IconPlus, IconHistory, IconX } from "@tabler/icons-react";
 import { useState, useRef, useEffect, useCallback } from "react";
 import { DEFAULT_MODEL } from "../agent/default-model.js";
 import { DEFAULT_REASONING_EFFORT, isReasoningEffort, resolveReasoningEffortSelection, } from "../shared/reasoning-effort.js";
-import { AGENT_CHAT_CLEAR_CONTEXT_MESSAGE_TYPE, AGENT_CHAT_REMOVE_CONTEXT_MESSAGE_TYPE, AGENT_CHAT_SET_CONTEXT_MESSAGE_TYPE, appendAgentChatContextToMessage, claimAgentChatOpenRequest, claimAgentChatSubmit, drainBufferedAgentChatOpenRequests, drainBufferedAgentChatSubmits, getAgentChatContextState, isAgentChatSubmitCancelled, normalizeAgentChatContextItem, parseSubmitChatMessage, removeAgentChatContextItem, reportAgentChatSubmitResult, reportAgentChatSubmitTarget, setAgentChatContextItem, } from "./agent-chat.js";
+import { AGENT_CHAT_CLEAR_CONTEXT_MESSAGE_TYPE, AGENT_CHAT_REMOVE_CONTEXT_MESSAGE_TYPE, AGENT_CHAT_SET_CONTEXT_MESSAGE_TYPE, appendAgentChatContextToMessage, claimAgentChatOpenRequest, claimAgentChatSubmit, drainBufferedAgentChatOpenRequests, drainBufferedAgentChatSubmits, filterAgentChatContextItems, getAgentChatContextState, isAgentChatSubmitCancelled, normalizeAgentChatContextItem, parseSubmitChatMessage, removeAgentChatContextItem, reportAgentChatSubmitResult, reportAgentChatSubmitTarget, setAgentChatContextItem, } from "./agent-chat.js";
 import { agentNativePath, appPath } from "./api-path.js";
 import { AssistantChat, } from "./AssistantChat.js";
 import { buildChatModelGroups, } from "./chat-model-groups.js";
@@ -386,6 +386,9 @@ function runToAgentTeamTabInfo(run) {
 }
 export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderOverlay, contentHidden = false, apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey, restoreActiveThread = true, browserTabId, threadUrlSync = false, scope = null, agentTeamPollMs = DEFAULT_AGENT_TEAM_POLL_MS, ...props }) {
     const translate = useT();
+    const contextNamespace = scope
+        ? scope.contextKey?.trim() || `scope:${scope.type}:${scope.id}`
+        : undefined;
     const { enabled: threadUrlSyncEnabled, paramName: threadUrlParamName, routeThreadId, getPath: getThreadPath, navigate: navigateThreadUrl, } = resolveThreadUrlSync(threadUrlSync);
     const threadRouteControlsActiveThread = threadUrlSyncEnabled &&
         threadUrlSync !== true &&
@@ -578,6 +581,9 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
     }, [bumpModelSelectionVersion, modelSelectionKey]);
     const postMessageSubmissionsDisabled = props.composerDisabled === true;
     const setContextInTab = useCallback((threadId, item, options) => {
+        if (filterAgentChatContextItems([item], contextNamespace).length === 0) {
+            return;
+        }
         const ref = chatRefs.current.get(threadId);
         if (ref) {
             ref.setComposerContextItem(item, options);
@@ -589,7 +595,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
             ? [...existing, item]
             : existing.map((current, currentIndex) => currentIndex === index ? item : current);
         pendingContextItems.current.set(threadId, next);
-    }, []);
+    }, [contextNamespace]);
     const removeContextInTab = useCallback((threadId, key) => {
         const ref = chatRefs.current.get(threadId);
         if (ref) {
@@ -772,7 +778,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
         const type = formatScopeType(nextScope.type);
         const title = nextScope.label?.trim() ||
             type.replace(/^./, (character) => character.toUpperCase());
-        const key = nextScope.contextKey || "agent-current-resource-context";
+        const key = nextScope.contextKey?.trim() || "agent-current-resource-context";
         const marker = `Resource context: ${nextScope.type}:${nextScope.id}`;
         const existing = getAgentChatContextState().items.find((item) => item.key === key);
         let ownsContextItem = false;
@@ -780,6 +786,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
             setAgentChatContextItem({
                 key,
                 title,
+                ...(contextNamespace ? { contextNamespace } : {}),
                 context: [
                     marker,
                     `The user is currently viewing this ${type}.`,
@@ -802,7 +809,13 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                 removeAgentChatContextItem(key);
             }
         };
-    }, [scope?.contextKey, scope?.id, scope?.label, scope?.type]);
+    }, [
+        contextNamespace,
+        scope?.contextKey,
+        scope?.id,
+        scope?.label,
+        scope?.type,
+    ]);
     // Persist open tab IDs to localStorage (exclude sub-agent tabs — they're session-only)
     useEffect(() => {
         if (openTabsKeyRef.current !== OPEN_TABS_KEY)
@@ -1797,7 +1810,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                                         else {
                                             chatRefs.current.delete(tabId);
                                         }
-                                    }, threadId: tabId, tabId: tabId, browserTabId: browserTabId, isActiveComposer: tabId === activeThreadId, apiUrl: apiUrl, isNewThread: newThreadIds.current.has(tabId) || isNewThread(tabId), isThreadStateLoading: isLoading, onMessageCountChange: (count) => setMessageCounts((prev) => prev[tabId] === count
+                                    }, threadId: tabId, tabId: tabId, browserTabId: browserTabId, contextNamespace: contextNamespace, isActiveComposer: tabId === activeThreadId, apiUrl: apiUrl, isNewThread: newThreadIds.current.has(tabId) || isNewThread(tabId), isThreadStateLoading: isLoading, onMessageCountChange: (count) => setMessageCounts((prev) => prev[tabId] === count
                                         ? prev
                                         : { ...prev, [tabId]: count }), onSaveThread: handleSaveThread, onGenerateTitle: handleGenerateTitle, onSlashCommand: handleSlashCommand, selectedModel: modelSelection?.model, selectedEngine: modelSelection?.engine, selectedEffort: modelSelection?.effort ?? DEFAULT_REASONING_EFFORT, composerSlot: props.composerSlot, defaultModel: defaultModel, availableModels: availableModels, modelListLoading: modelListLoading, onModelChange: handleModelChange, onEffortChange: handleEffortChange, onForkChat: () => handleForkChat(tabId), 
                                     // Sub-agent tabs are read-only: sending a new message from the

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

@@ -94,6 +94,8 @@ export interface AgentChatContextItem {
     title: string;
     /** Hidden context included with the next submitted prompt. */
     context: string;
+    /** Optional host namespace used to keep ambient context local to one surface. */
+    contextNamespace?: string;
 }
 export interface AgentChatContextSetOptions extends AgentChatContextItem {
     /**
@@ -233,6 +235,12 @@ export declare function claimAgentChatOpenRequest(id: unknown): boolean;
 /** Test-only: reset the self-submit buffer and claim set. */
 export declare function _resetAgentChatSubmitBufferForTests(): void;
 export declare function normalizeAgentChatContextItem(item: unknown): AgentChatContextItem | null;
+/**
+ * Keep unscoped context visible everywhere, but hide ambient context owned by
+ * a different host surface. This prevents mounted-but-hidden app panes from
+ * leaking their resource chips into the active app's composer.
+ */
+export declare function filterAgentChatContextItems(items: readonly AgentChatContextItem[], contextNamespace?: string | null): AgentChatContextItem[];
 export declare function normalizeAgentChatContextItems(items: unknown): AgentChatContextItem[];
 export declare function publishAgentChatContextItems(items: readonly AgentChatContextItem[], options?: {
     persist?: boolean;

package/dist/client/agent-chat.js

@@ -207,12 +207,27 @@ export function normalizeAgentChatContextItem(item) {
     const context = candidate.context.trim();
     if (!key || !context)
         return null;
+    const contextNamespace = typeof candidate.contextNamespace === "string"
+        ? candidate.contextNamespace.trim()
+        : "";
     return {
         key,
         title: candidate.title.trim() || key,
         context,
+        ...(contextNamespace ? { contextNamespace } : {}),
     };
 }
+/**
+ * Keep unscoped context visible everywhere, but hide ambient context owned by
+ * a different host surface. This prevents mounted-but-hidden app panes from
+ * leaking their resource chips into the active app's composer.
+ */
+export function filterAgentChatContextItems(items, contextNamespace) {
+    const namespace = contextNamespace?.trim();
+    if (!namespace)
+        return [...items];
+    return items.filter((item) => !item.contextNamespace || item.contextNamespace.trim() === namespace);
+}
 export function normalizeAgentChatContextItems(items) {
     if (!Array.isArray(items))
         return [];

package/dist/client/app-chat-sidebar.d.ts

@@ -0,0 +1,23 @@
+/** Custom event used by top-level hosts such as Electron webviews. */
+export declare const APP_CHAT_SIDEBAR_STATE_EVENT = "agent-native:per-app-chat-state";
+/** postMessage sent from a per-app chat host to its embedded app. */
+export declare const APP_CHAT_SIDEBAR_STATE_MESSAGE = "agentNative.perAppChatState";
+/** Request sent by an iframe that mounted after the host announced its state. */
+export declare const APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE = "agentNative.perAppChatStateRequest";
+export interface AppChatSidebarState {
+    open: boolean;
+}
+export declare function buildAppChatSidebarStateMessage(open: boolean): {
+    type: typeof APP_CHAT_SIDEBAR_STATE_MESSAGE;
+    data: AppChatSidebarState;
+};
+export declare function buildAppChatSidebarStateRequest(): {
+    type: typeof APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE;
+};
+/**
+ * The two host shells are the only AgentSidebar instances that control a
+ * separate app surface. Keeping this check here prevents ordinary in-app
+ * agent panels from changing the app's navigation chrome.
+ */
+export declare function isPerAppChatStorageKey(storageKey: string | undefined): boolean;
+export declare function usePerAppChatOpen(): boolean;

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

@@ -0,0 +1,53 @@
+import { useEffect, useState } from "react";
+/** Custom event used by top-level hosts such as Electron webviews. */
+export const APP_CHAT_SIDEBAR_STATE_EVENT = "agent-native:per-app-chat-state";
+/** postMessage sent from a per-app chat host to its embedded app. */
+export const APP_CHAT_SIDEBAR_STATE_MESSAGE = "agentNative.perAppChatState";
+/** Request sent by an iframe that mounted after the host announced its state. */
+export const APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE = "agentNative.perAppChatStateRequest";
+export function buildAppChatSidebarStateMessage(open) {
+    return {
+        type: APP_CHAT_SIDEBAR_STATE_MESSAGE,
+        data: { open },
+    };
+}
+export function buildAppChatSidebarStateRequest() {
+    return { type: APP_CHAT_SIDEBAR_STATE_REQUEST_MESSAGE };
+}
+/**
+ * The two host shells are the only AgentSidebar instances that control a
+ * separate app surface. Keeping this check here prevents ordinary in-app
+ * agent panels from changing the app's navigation chrome.
+ */
+export function isPerAppChatStorageKey(storageKey) {
+    return (storageKey === "desktop-app-chat" || storageKey === "dispatch-app-chat");
+}
+export function usePerAppChatOpen() {
+    const [open, setOpen] = useState(false);
+    useEffect(() => {
+        const applyState = (value) => {
+            if (typeof value === "boolean")
+                setOpen(value);
+        };
+        const handleCustomEvent = (event) => {
+            applyState(event.detail?.open);
+        };
+        const handleMessage = (event) => {
+            if (window.parent === window || event.source !== window.parent)
+                return;
+            if (event.data?.type !== APP_CHAT_SIDEBAR_STATE_MESSAGE)
+                return;
+            applyState(event.data.data?.open);
+        };
+        window.addEventListener(APP_CHAT_SIDEBAR_STATE_EVENT, handleCustomEvent);
+        window.addEventListener("message", handleMessage);
+        if (window.parent !== window) {
+            window.parent.postMessage(buildAppChatSidebarStateRequest(), "*");
+        }
+        return () => {
+            window.removeEventListener(APP_CHAT_SIDEBAR_STATE_EVENT, handleCustomEvent);
+            window.removeEventListener("message", handleMessage);
+        };
+    }, []);
+    return open;
+}

package/dist/client/app-providers.js

@@ -51,7 +51,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { Toaster } from "@agent-native/toolkit/ui/sonner";
 import { TooltipProvider } from "@radix-ui/react-tooltip";
 import { QueryClientProvider } from "@tanstack/react-query";
-import { ThemeProvider } from "next-themes";
+import { ThemeProvider, useTheme } from "next-themes";
 import { useEffect, useRef } from "react";
 import { useInRouterContext } from "react-router";
 import { isHumanReadableDocumentTitle, normalizeDocumentTitle, } from "../shared/document-title.js";
@@ -63,6 +63,7 @@ import { RequireSession } from "./require-session.js";
 import { AgentNativeRouteWarmup } from "./route-warmup.js";
 import { RouteTransitionIndicator } from "./RouteTransitionIndicator.js";
 import { RuntimeConfigNotice } from "./RuntimeConfigNotice.js";
+import { EMBEDDED_THEME_CHANGE_EVENT, applyEmbeddedThemeUpdate, parseEmbeddedThemeUpdate, } from "./theme.js";
 const DEFAULT_TOASTER = _jsx(Toaster, { richColors: true, position: "bottom-left" });
 function RoutedAppEnhancements() {
     const isInRouter = useInRouterContext();
@@ -81,6 +82,34 @@ function readDocumentTitleFallback() {
         .find((title) => isHumanReadableDocumentTitle(title));
     return normalizeDocumentTitle(metadataTitle, "Agent Native");
 }
+function EmbeddedThemeSync() {
+    const { setTheme } = useTheme();
+    useEffect(() => {
+        const applyUpdate = (update) => {
+            if (!update)
+                return;
+            applyEmbeddedThemeUpdate(document.documentElement, update);
+            setTheme(update.theme);
+        };
+        const onMessage = (event) => {
+            if (window.parent === window || event.source !== window.parent)
+                return;
+            applyUpdate(parseEmbeddedThemeUpdate(event.data));
+        };
+        const onThemeChange = (event) => {
+            if (!(event instanceof CustomEvent))
+                return;
+            applyUpdate(parseEmbeddedThemeUpdate(event.detail));
+        };
+        window.addEventListener("message", onMessage);
+        window.addEventListener(EMBEDDED_THEME_CHANGE_EVENT, onThemeChange);
+        return () => {
+            window.removeEventListener("message", onMessage);
+            window.removeEventListener(EMBEDDED_THEME_CHANGE_EVENT, onThemeChange);
+        };
+    }, [setTheme]);
+    return null;
+}
 /** Repairs route metadata that would otherwise expose a structured payload in the tab. */
 function DocumentTitleGuard({ fallbackTitle }) {
     const initialTitleRef = useRef(null);
@@ -115,7 +144,7 @@ function DocumentTitleGuard({ fallbackTitle }) {
 }
 function ProvidersInner({ queryClient, defaultTheme = "system", themeAttribute = "class", tooltipDelayDuration, toaster = DEFAULT_TOASTER, disableThemeTransitions = true, i18n, documentTitleFallback, children, }) {
     const localizedChildren = i18n === false ? (children) : (_jsx(AgentNativeI18nProvider, { ...(i18n ?? {}), children: children }));
-    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(ThemeProvider, { attribute: themeAttribute, defaultTheme: defaultTheme, enableSystem: true, disableTransitionOnChange: disableThemeTransitions, children: _jsxs(TooltipProvider, { delayDuration: tooltipDelayDuration, children: [localizedChildren, _jsx(DocumentTitleGuard, { fallbackTitle: documentTitleFallback }), _jsx(RuntimeConfigNotice, {}), _jsx(RoutedAppEnhancements, {}), toaster] }) }) }));
+    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsxs(ThemeProvider, { attribute: themeAttribute, defaultTheme: defaultTheme, enableSystem: true, disableTransitionOnChange: disableThemeTransitions, children: [_jsx(EmbeddedThemeSync, {}), _jsxs(TooltipProvider, { delayDuration: tooltipDelayDuration, children: [localizedChildren, _jsx(DocumentTitleGuard, { fallbackTitle: documentTitleFallback }), _jsx(RuntimeConfigNotice, {}), _jsx(RoutedAppEnhancements, {}), toaster] })] }) }));
 }
 export function AppProviders({ queryClient, isPublicPath = false, clientOnlyFallback, sessionBypass = false, defaultTheme, themeAttribute, tooltipDelayDuration, toaster, disableThemeTransitions, i18n, documentTitleFallback, children, }) {
     const fallback = clientOnlyFallback ?? _jsx(DefaultSpinner, {});

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

@@ -49,6 +49,17 @@ export interface ToggleSidebarMessage {
         open?: boolean;
     };
 }
+/** The host chat rail asks the embedded app to compact its own navigation. */
+export interface PerAppChatSidebarStateMessage {
+    type: "agentNative.perAppChatState";
+    data: {
+        open: boolean;
+    };
+}
+/** The embedded app asks a host for the current per-app chat state on mount. */
+export interface PerAppChatSidebarStateRequestMessage {
+    type: "agentNative.perAppChatStateRequest";
+}
 export interface EnterStyleEditingMessage {
     type: "agentNative.enterStyleEditing";
     data: {
@@ -78,7 +89,7 @@ export interface PresentationModeMessage {
 export interface DesignCloseMessage {
     type: "design:close";
 }
-export type AppToFrameMessage = AppReadyMessage | SubmitChatMessage | SetChatContextMessage | RemoveChatContextMessage | ClearChatContextMessage | GetUserInfoMessage | SetEnvVarsMessage | DevModeChangeMessage | ToggleSidebarMessage | EnterStyleEditingMessage | EnterTextEditingMessage | ExitSelectionModeMessage | PresentationModeMessage | DesignCloseMessage;
+export type AppToFrameMessage = AppReadyMessage | AuthStateMessage | SubmitChatMessage | SetChatContextMessage | RemoveChatContextMessage | ClearChatContextMessage | GetUserInfoMessage | SetEnvVarsMessage | DevModeChangeMessage | ToggleSidebarMessage | PerAppChatSidebarStateRequestMessage | EnterStyleEditingMessage | EnterTextEditingMessage | ExitSelectionModeMessage | PresentationModeMessage | DesignCloseMessage;
 export interface FrameOriginMessage {
     type: "agentNative.frameOrigin";
     origin: string;
@@ -98,6 +109,13 @@ export interface UserInfoMessage {
         email?: string;
     };
 }
+/** The embedded app's own session state, surfaced to a trusted host frame. */
+export interface AuthStateMessage {
+    type: "agentNative.authState";
+    data: {
+        status: "authenticated" | "unauthenticated";
+    };
+}
 export interface CodeCompleteMessage {
     type: "agentNative.codeComplete";
     tabId: string;
@@ -132,5 +150,5 @@ export interface DesignInitMessage {
         };
     };
 }
-export type FrameToAppMessage = FrameOriginMessage | ChatRunningMessage | UserInfoMessage | CodeCompleteMessage | SidebarModeMessage | PresentationModeMessage | DesignInitMessage;
+export type FrameToAppMessage = FrameOriginMessage | ChatRunningMessage | UserInfoMessage | PerAppChatSidebarStateMessage | CodeCompleteMessage | SidebarModeMessage | PresentationModeMessage | DesignInitMessage;
 export type FrameMessage = AppToFrameMessage | FrameToAppMessage;

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

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

package/dist/client/hooks/index.js

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

package/dist/client/sharing/AgentShareSection.d.ts

@@ -0,0 +1,8 @@
+export interface AgentShareSectionProps {
+    resourceType: string;
+    resourceId: string;
+    enabled?: boolean;
+    className?: string;
+}
+/** Optional shared handoff for resources with a registered agent context. */
+export declare function AgentShareSection({ resourceType, resourceId, enabled, className, }: AgentShareSectionProps): import("react").JSX.Element | null;

package/dist/client/sharing/AgentShareSection.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ActionButton } from "@agent-native/toolkit/design-system";
+import { ShareAgentsSection, ShareCopyRow, } from "@agent-native/toolkit/sharing";
+import { useCallback, useState } from "react";
+import { writeClipboardText } from "../clipboard.js";
+import { useT } from "../i18n.js";
+import { useActionMutation } from "../use-action.js";
+/** Optional shared handoff for resources with a registered agent context. */
+export function AgentShareSection({ resourceType, resourceId, enabled = false, className, }) {
+    const t = useT();
+    const createAgentLink = useActionMutation("create-agent-resource-link");
+    const [open, setOpen] = useState(false);
+    const [contextUrl, setContextUrl] = useState("");
+    const [linkError, setLinkError] = useState(false);
+    const loadContextUrl = useCallback(() => {
+        setContextUrl("");
+        setLinkError(false);
+        createAgentLink.mutate({ resourceType, resourceId }, {
+            onSuccess: (result) => {
+                if (result.contextUrl)
+                    setContextUrl(result.contextUrl);
+                else
+                    setLinkError(true);
+            },
+            onError: () => setLinkError(true),
+        });
+    }, [createAgentLink, resourceId, resourceType]);
+    const handleOpenChange = useCallback((nextOpen) => {
+        setOpen(nextOpen);
+        if (nextOpen && !contextUrl)
+            loadContextUrl();
+    }, [contextUrl, loadContextUrl]);
+    if (!enabled)
+        return null;
+    return (_jsx(ShareAgentsSection, { label: t("agentChat.share.shareWithAgents", {
+            defaultValue: "Share with agents",
+        }), open: open, onOpenChange: handleOpenChange, className: className, children: _jsxs("div", { className: "space-y-2", children: [contextUrl ? (_jsx(ShareCopyRow, { label: t("agentChat.share.agentContext", {
+                        defaultValue: "Agent context link",
+                    }), description: t("agentChat.share.agentContextDescription", {
+                        defaultValue: "Read-only context for an external agent.",
+                    }), value: contextUrl, copyLabel: t("agentChat.share.copy", { defaultValue: "Copy" }), copiedLabel: t("agentChat.share.copied", {
+                        defaultValue: "Copied",
+                    }), onCopy: writeClipboardText })) : null, createAgentLink.isPending ? (_jsx("div", { className: "text-xs text-muted-foreground", children: t("agentChat.share.preparingAgentLink", {
+                        defaultValue: "Preparing agent link...",
+                    }) })) : null, linkError ? (_jsxs("div", { className: "flex items-center justify-between gap-2 rounded-md border border-border bg-muted/30 px-3 py-2", children: [_jsx("span", { className: "text-xs text-muted-foreground", children: t("agentChat.share.agentLinkUnavailable", {
+                                defaultValue: "Agent link unavailable.",
+                            }) }), _jsx(ActionButton, { type: "button", emphasis: "ghost", size: "compact", onPress: loadContextUrl, disabled: createAgentLink.isPending, children: t("agentChat.share.retryAgentLink", {
+                                defaultValue: "Retry",
+                            }) })] })) : null] }) }));
+}

package/dist/client/sharing/ShareButton.js

@@ -7,6 +7,7 @@ import { writeClipboardText } from "../clipboard.js";
 import { Popover, PopoverAnchor, PopoverContent, PopoverTrigger, } from "../components/ui/popover.js";
 import { useT } from "../i18n.js";
 import { cn } from "../utils.js";
+import { AgentShareSection } from "./AgentShareSection.js";
 import { useShareButtonController, } from "./useShareButtonController.js";
 // Match shadcn's <Button size="sm" variant="outline"> sizing so the trigger
 // sits flush next to other controls while staying transparent at rest.
@@ -181,7 +182,7 @@ function SharePanel(props) {
                                             defaultValue: "Remove",
                                         }), onClick: () => handleRemove(s), disabled: inFlight.has(keyOf(s)), className: BUTTON_GHOST_ICON, children: _jsx(IconTrash, { size: 14 }) })) : null] }, keyOf(s)))), !shares.length && !data?.ownerEmail ? (_jsx("li", { className: "px-1 py-1.5 text-sm text-muted-foreground", children: t("agentChat.share.noAccess", {
                                     defaultValue: "No one has access yet.",
-                                }) })) : null] })] }), shareError && !canManage ? (_jsx("div", { role: "alert", className: "mb-4 rounded-md border border-destructive/40 bg-destructive/10 px-3 py-2 text-xs text-destructive", children: shareError })) : null, props.accessNote ? (_jsx("div", { className: "mb-4 rounded-md border border-border bg-muted/35 p-3 text-xs text-muted-foreground", children: props.accessNote })) : null, showShareLinks && shareUrlPlacement === "bottom" ? shareLinks : null, props.shareFooterContent] }));
+                                }) })) : null] })] }), shareError && !canManage ? (_jsx("div", { role: "alert", className: "mb-4 rounded-md border border-destructive/40 bg-destructive/10 px-3 py-2 text-xs text-destructive", children: shareError })) : null, _jsx(AgentShareSection, { enabled: data?.agentReadable === true, resourceType: props.resourceType, resourceId: props.resourceId }), props.accessNote ? (_jsx("div", { className: "mb-4 rounded-md border border-border bg-muted/35 p-3 text-xs text-muted-foreground", children: props.accessNote })) : null, showShareLinks && shareUrlPlacement === "bottom" ? shareLinks : null, props.shareFooterContent] }));
     if (!hasTabs)
         return sharePanel;
     const tabs = [

package/dist/client/sharing/ShareDialog.d.ts

@@ -26,7 +26,7 @@ export interface ShareDialogProps {
  * Framework share dialog. Drop into any template via
  * `<ShareDialog open onClose resourceType resourceId />`. Passing `shareUrl`
  * lights up a Link tab with a copy field; passing `embedUrl` lights up an
- * Embed tab. With neither prop, renders a single Invite + general-access
- * panel (Google-Docs-lite).
+ * Embed tab. People access stays on the primary sharing surface so the same
+ * Google-Docs-style flow works whether or not a link or embed is available.
  */
 export declare function ShareDialog({ open, onClose, resourceType, resourceId, resourceTitle, shareUrl, embedUrl, embedTabContent, linkTabExtras, }: ShareDialogProps): import("react").JSX.Element | null;