@agent-native/core 0.176.1 → 0.176.2-nightly-20260831184159

package/dist/app-config/observability.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 /**
- * Agent trace capture.
+ * Agent trace capture, plus the MCP server's own instrumentation switches.
  *
  * These were an `observability-config` settings row, which nothing in core ever
  * wrote — the only "UI" was a snippet in the docs telling app authors to write
@@ -45,6 +45,30 @@ export const observabilityConfig = z.object({
         env: ["AGENT_NATIVE_OBSERVABILITY_CAPTURE_TOOL_RESULTS"],
         doc: "Include tool results and error text on tool spans.",
     }),
+    // MCP server instrumentation. These gate the `$mcp_*` events every tracking
+    // provider receives, so they live here with the other capture switches rather
+    // than beside one provider's key in `analytics`.
+    mcpEvents: z
+        .boolean()
+        .default(true)
+        .meta({
+        env: ["MCP_ANALYTICS"],
+        doc: "Emit `$mcp_*` analytics events for the MCP server the app exposes.",
+    }),
+    mcpCaptureParameters: z
+        .boolean()
+        .default(false)
+        .meta({
+        env: ["MCP_ANALYTICS_PARAMETERS"],
+        doc: "Include redacted MCP tool-call arguments as $mcp_parameters. Off by default: arguments carry user content.",
+    }),
+    mcpDebugInitialize: z
+        .boolean()
+        .default(false)
+        .meta({
+        env: ["MCP_DEBUG_INIT"],
+        doc: "Log the clientInfo and capabilities of every MCP initialize handshake. Off by default: a handshake can carry client-specific metadata.",
+    }),
     captureLlmSpans: z
         .boolean()
         .default(true)

package/dist/app-config/schema.d.ts

@@ -19,8 +19,12 @@ export declare const appConfigSchema: z.ZodObject<{
         engine: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         builtInEngines: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        buildEnginePackages: z.ZodOptional<z.ZodString>;
         mode: z.ZodOptional<z.ZodString>;
         preferBringYourOwnKey: z.ZodDefault<z.ZodBoolean>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        mainChatMaxOutputTokens: z.ZodDefault<z.ZodNumber>;
+        emptyResponseRetryMaxOutputTokens: z.ZodDefault<z.ZodNumber>;
         sourceSweepToolCallThreshold: z.ZodDefault<z.ZodNumber>;
         runSoftTimeoutMs: z.ZodOptional<z.ZodNumber>;
         completedRunRetentionMs: z.ZodOptional<z.ZodNumber>;
@@ -52,10 +56,12 @@ export declare const appConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     integrations: z.ZodPrefault<z.ZodObject<{
         allowUnverifiedWebhooks: z.ZodDefault<z.ZodBoolean>;
+        webhookBaseUrl: z.ZodOptional<z.ZodString>;
         platforms: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     migration: z.ZodPrefault<z.ZodObject<{
         releaseMigrations: z.ZodDefault<z.ZodBoolean>;
+        deployContext: z.ZodOptional<z.ZodString>;
         betaSchemaOwner: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     observability: z.ZodPrefault<z.ZodObject<{
@@ -63,6 +69,9 @@ export declare const appConfigSchema: z.ZodObject<{
         capturePrompts: z.ZodDefault<z.ZodBoolean>;
         captureToolArgs: z.ZodDefault<z.ZodBoolean>;
         captureToolResults: z.ZodDefault<z.ZodBoolean>;
+        mcpEvents: z.ZodDefault<z.ZodBoolean>;
+        mcpCaptureParameters: z.ZodDefault<z.ZodBoolean>;
+        mcpDebugInitialize: z.ZodDefault<z.ZodBoolean>;
         captureLlmSpans: z.ZodDefault<z.ZodBoolean>;
         evalSampleRate: z.ZodDefault<z.ZodNumber>;
         inferredSentimentEnabled: z.ZodOptional<z.ZodBoolean>;

package/dist/app-config/store.js

@@ -72,6 +72,7 @@ export function readConfigEnvironment(embedded = {
     AGENT_NATIVE_BETA_SCHEMA_OWNER: process.env.AGENT_NATIVE_BETA_SCHEMA_OWNER,
     AGENT_NATIVE_BUILD_ANALYTICS_PUBLIC_KEY: process.env.AGENT_NATIVE_BUILD_ANALYTICS_PUBLIC_KEY,
     AGENT_NATIVE_BUILD_ANALYTICS_ENDPOINT: process.env.AGENT_NATIVE_BUILD_ANALYTICS_ENDPOINT,
+    AGENT_NATIVE_BUILD_ENGINE_PACKAGES: process.env.AGENT_NATIVE_BUILD_ENGINE_PACKAGES,
 }) {
     const env = { ...process.env };
     for (const [key, value] of Object.entries(embedded)) {

package/dist/client/AgentAskPopover.d.ts

@@ -7,6 +7,7 @@ export interface AgentAskPopoverProps {
     context?: string;
     className?: string;
     icon?: ReactNode;
+    draftScope?: string;
 }
 /** A low-emphasis entry point for asking the agent without losing the current surface. */
-export declare function AgentAskPopover({ prompt, title, label, placeholder, context, className, icon, }: AgentAskPopoverProps): import("react").JSX.Element;
+export declare function AgentAskPopover({ prompt, title, label, placeholder, context, className, icon, draftScope, }: AgentAskPopoverProps): import("react").JSX.Element;

package/dist/client/AgentAskPopover.js

@@ -6,7 +6,7 @@ import { Popover, PopoverContent, PopoverTrigger, } from "./components/ui/popove
 import { PromptComposer } from "./composer/index.js";
 import { useT } from "./i18n.js";
 /** A low-emphasis entry point for asking the agent without losing the current surface. */
-export function AgentAskPopover({ prompt, title, label, placeholder, context, className, icon, }) {
+export function AgentAskPopover({ prompt, title, label, placeholder, context, className, icon, draftScope, }) {
     const t = useT();
     const [open, setOpen] = useState(false);
     const handleSubmit = useCallback((text) => {
@@ -22,7 +22,7 @@ export function AgentAskPopover({ prompt, title, label, placeholder, context, cl
         setOpen(false);
     }, [context]);
     return (_jsxs(Popover, { open: open, onOpenChange: setOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { type: "button", variant: "outline", size: "sm", className: className ?? "cursor-pointer", children: [icon, label ?? t("agentPanel.askAgent", { defaultValue: "Ask the agent" })] }) }), _jsxs(PopoverContent, { align: "end", sideOffset: 8, collisionPadding: 12, className: "z-[260] w-[calc(100vw-32px)] max-w-[420px] p-3", children: [_jsx("p", { className: "px-1 pb-2 text-sm font-semibold text-foreground", children: title ??
-                            t("agentPanel.askAgentTitle", { defaultValue: "Ask the agent" }) }), _jsx(PromptComposer, { autoFocus: true, attachmentsEnabled: false, initialText: prompt, initialTextKey: prompt, layoutVariant: "compact", placeholder: placeholder ??
+                            t("agentPanel.askAgentTitle", { defaultValue: "Ask the agent" }) }), _jsx(PromptComposer, { autoFocus: true, attachmentsEnabled: false, draftScope: draftScope, initialText: prompt, initialTextKey: prompt, layoutVariant: "compact", placeholder: placeholder ??
                             t("agentPanel.askAgentPlaceholder", {
                                 defaultValue: "Tell the agent what you want to do…",
                             }), showModelSelector: false, voiceEnabled: false, onSubmit: handleSubmit })] })] }));

package/dist/client/AgentPanel.d.ts

@@ -27,8 +27,12 @@ import type { AgentChatSurfaceKind } from "./agent-chat-adapter.js";
 import type { AssistantChatProps } from "./AssistantChat.js";
 import type { MultiTabAssistantChatHeaderProps, MultiTabAssistantChatProps } from "./MultiTabAssistantChat.js";
 export declare function shouldHandleAgentSidebarToggle(event: Event, toggleScopeId?: string | null): boolean;
-type PanelMode = "chat" | "cli" | "resources" | "settings";
-export declare function normalizeAgentPanelModeForSurface(mode: PanelMode, allowSettingsMode: boolean, chatOnly?: boolean): PanelMode;
+export declare function settingsRouteHashForSection(section?: string | null, currentHash?: string | null): string;
+export declare function AgentPanelSettingsNavigation({ onOpenSettings, }?: {
+    onOpenSettings?: (section?: string) => void;
+}): null;
+type PanelMode = "chat" | "cli" | "resources";
+export declare function normalizeAgentPanelModeForSurface(mode: string, chatOnly?: boolean): PanelMode;
 export declare function deferAgentPanelOverlayOpen(event: {
     preventDefault: () => void;
 }, closeMenu: () => void, openOverlay: () => void): void;
@@ -102,8 +106,18 @@ export interface AgentPanelProps extends Omit<AssistantChatProps, "onSwitchToCli
     isWideDrawer?: boolean;
     /** Called when the user returns the wide drawer to the normal layout. */
     onExitWideDrawer?: () => void;
-    /** URL of the app being developed (shown as "Open app in new tab" in settings). Set by frame. */
-    devAppUrl?: string;
+    /** Route settings requests to a host-owned settings surface. */
+    onOpenSettings?: (section?: string) => void;
+    /** Start a desktop-owned CLI tab from the chat sidebar menu. */
+    onNewCliTab?: () => void;
+    /** Return from a desktop-owned CLI tab to a UI chat tab. */
+    onNewUiTab?: () => void;
+    /** Select the mode used by the chat sidebar's new-tab affordances. */
+    newTabMode?: "ui" | "cli";
+    /** Host-owned label for the desktop CLI tab action. */
+    newCliTabLabel?: string;
+    /** Host-owned label for the desktop UI tab action. */
+    newUiTabLabel?: string;
     /** Namespace for localStorage keys — used to isolate chat state per app in the frame. */
     storageKey?: string;
     /** Restore the previously active chat thread on mount. Default: true. */
@@ -124,11 +138,9 @@ export interface AgentPanelProps extends Omit<AssistantChatProps, "onSwitchToCli
     showTabBar?: boolean;
     /** Show a compact New chat action in page chat when the main header is hidden. */
     showPageNewChatButton?: boolean;
-    /** Allow the sidebar settings view to render inside this panel. Default: true. */
-    allowSettingsMode?: boolean;
     /** Keep this surface on chat even when mode controls are hidden. */
     chatOnly?: boolean;
-    /** Optional link shown in Resources and Settings modes for the full Agent page. */
+    /** Optional link shown in Resources mode for the full Agent page. */
     agentPageHref?: string;
     /** Capability gate for source edits and CLI access. */
     codeAccess?: AgentPanelCodeAccess;
@@ -153,7 +165,6 @@ export interface AgentChatSurfaceProps extends AgentPanelProps {
     chatViewTransition?: boolean;
 }
 export declare function shouldDefaultAgentChatSurfacePageNewChatButton(mode: AgentChatSurfaceMode | undefined, _showTabBar: boolean | undefined): boolean;
-export declare function shouldAllowAgentChatSurfaceSettingsMode(mode: AgentChatSurfaceMode | undefined, allowSettingsMode: boolean | undefined): boolean;
 /**
  * Reusable chat surface backed by AgentPanel internals.
  *
@@ -248,8 +259,22 @@ export interface AgentSidebarProps {
     openOnChatRunning?: boolean;
     /** Called when the user selects the full-view action from the chat sidebar. */
     onFullscreenRequest?: () => void;
+    /** Route settings requests to a host-owned settings surface. */
+    onOpenSettings?: (section?: string) => void;
+    /** Start a desktop-owned CLI tab from the chat sidebar menu. */
+    onNewCliTab?: () => void;
+    /** Return from a desktop-owned CLI tab to a UI chat tab. */
+    onNewUiTab?: () => void;
+    /** Select the mode used by the chat sidebar's new-tab affordances. */
+    newTabMode?: "ui" | "cli";
+    /** Host-owned label for the desktop CLI tab action. */
+    newCliTabLabel?: string;
+    /** Host-owned label for the desktop UI tab action. */
+    newUiTabLabel?: string;
     /** Ambient resource context rendered as a composer chip. */
     scope?: import("./use-chat-threads.js").ChatThreadScope | null;
+    /** Optional host-owned resource history used for chat-side reverts. */
+    chatHistory?: AssistantChatProps["chatHistory"];
     /** Identity used to route host-scoped sidebar toggle events. */
     toggleScopeId?: string;
     /** Keep app-owned chat history isolated to the supplied scope. */
@@ -260,7 +285,7 @@ export interface AgentSidebarProps {
     browserTabId?: string;
     /** Keep chat thread selection in URL state. */
     threadUrlSync?: MultiTabAssistantChatProps["threadUrlSync"];
-    /** Optional link shown in Resources and Settings modes for the full Agent page. */
+    /** Optional link shown in Resources mode for the full Agent page. */
     agentPageHref?: string;
     /** Suppress first-run onboarding while a deep-linked resource is open. */
     suppressFirstRunOnboarding?: boolean;
@@ -271,7 +296,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, enabled, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openStorageKey, restoreActiveThread, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning, onFullscreenRequest, scope, toggleScopeId, isolateHistoryByScope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, thinkingDisplay, }: AgentSidebarProps): React.JSX.Element;
+export declare function AgentSidebar({ children, enabled, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openStorageKey, restoreActiveThread, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning, onFullscreenRequest, onOpenSettings, onNewCliTab, onNewUiTab, newTabMode, newCliTabLabel, newUiTabLabel, scope, chatHistory, toggleScopeId, isolateHistoryByScope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, thinkingDisplay, }: AgentSidebarProps): React.JSX.Element;
 /**
  * Focus the agent chat composer input.
  * Opens the sidebar if closed, then focuses the text input.