@agent-native/core 0.15.13 → 0.16.0

package/dist/client/AgentNative.js

@@ -0,0 +1,79 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo } from "react";
+import { AgentNativeFrame, } from "./AgentNativeFrame.js";
+import { readAgentNativeScreenContext, } from "./host-bridge.js";
+function mergeObject(base, override) {
+    if (!base && !override)
+        return undefined;
+    return { ...(base ?? {}), ...(override ?? {}) };
+}
+function mergeHostContext(base, override) {
+    if (!override)
+        return base;
+    return {
+        ...base,
+        ...override,
+        route: mergeObject(base.route, override.route),
+        selection: mergeObject(base.selection, override.selection),
+        screen: mergeObject(base.screen, override.screen),
+    };
+}
+function toCommandHandler(callback) {
+    if (!callback)
+        return undefined;
+    return (request) => callback(request.payload, {
+        command: request.command,
+        requestId: request.requestId,
+        origin: request.origin,
+    });
+}
+export function useAgentNativeScreenContext(options) {
+    return useCallback(() => readAgentNativeScreenContext(options), [options]);
+}
+export function AgentNative({ actions, getContext, screen = true, commands, onRefresh, onNavigate, onRemount, onOpenResource, onRequestApproval, ...frameProps }) {
+    const getMergedContext = useCallback(async () => {
+        const screenContext = screen === false
+            ? {}
+            : readAgentNativeScreenContext(screen === true ? {} : screen);
+        const customContext = getContext ? await getContext() : undefined;
+        return mergeHostContext(screenContext, customContext);
+    }, [getContext, screen]);
+    const mergedCommands = useMemo(() => {
+        const refreshHandler = toCommandHandler(onRefresh);
+        const navigateHandler = toCommandHandler(onNavigate);
+        const remountHandler = toCommandHandler(onRemount);
+        const openResourceHandler = toCommandHandler(onOpenResource);
+        const requestApprovalHandler = toCommandHandler(onRequestApproval);
+        return {
+            ...commands,
+            ...(refreshHandler
+                ? { refreshData: refreshHandler, "refresh-data": refreshHandler }
+                : {}),
+            ...(navigateHandler ? { navigate: navigateHandler } : {}),
+            ...(remountHandler
+                ? { remountView: remountHandler, "remount-view": remountHandler }
+                : {}),
+            ...(openResourceHandler
+                ? {
+                    openResource: openResourceHandler,
+                    "open-resource": openResourceHandler,
+                }
+                : {}),
+            ...(requestApprovalHandler
+                ? {
+                    requestApproval: requestApprovalHandler,
+                    "request-approval": requestApprovalHandler,
+                }
+                : {}),
+        };
+    }, [
+        commands,
+        onNavigate,
+        onOpenResource,
+        onRefresh,
+        onRemount,
+        onRequestApproval,
+    ]);
+    return (_jsx(AgentNativeFrame, { ...frameProps, actions: actions, commands: mergedCommands, getContext: getMergedContext }));
+}
+//# sourceMappingURL=AgentNative.js.map

package/dist/client/AgentNative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentNative.js","sourceRoot":"","sources":["../../src/client/AgentNative.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useCallback, useMemo } from \"react\";\nimport {\n  AgentNativeFrame,\n  type AgentNativeFrameProps,\n} from \"./AgentNativeFrame.js\";\nimport {\n  readAgentNativeScreenContext,\n  type AgentNativeClientActions,\n  type AgentNativeHostCommandHandler,\n  type AgentNativeHostCommandHandlers,\n  type AgentNativeHostCommandRequest,\n  type AgentNativeHostContext,\n  type AgentNativeHostContextGetter,\n  type AgentNativeScreenSnapshotOptions,\n} from \"./host-bridge.js\";\n\nexport interface AgentNativeCommandCallbackInfo {\n  command: string;\n  requestId?: string;\n  origin: string;\n}\n\nexport type AgentNativeCommandCallback = (\n  payload: unknown,\n  info: AgentNativeCommandCallbackInfo,\n) => unknown | Promise<unknown>;\n\nexport interface AgentNativeProps extends Omit<\n  AgentNativeFrameProps,\n  \"actions\" | \"commands\" | \"getContext\"\n> {\n  /**\n   * Live browser-session tools. These can change as page state changes and are\n   * only callable while this tab is connected.\n   */\n  actions?: AgentNativeClientActions;\n  /** Semantic app/page context layered over the built-in screen snapshot. */\n  getContext?: AgentNativeHostContextGetter;\n  /**\n   * Built-in screen context. Defaults to visible text + route + selection.\n   * Pass false to disable, or { includeDomHtml: true } for a DOM fallback.\n   */\n  screen?: boolean | AgentNativeScreenSnapshotOptions;\n  /** Extra/advanced host commands. */\n  commands?: AgentNativeHostCommandHandlers;\n  onRefresh?: AgentNativeCommandCallback;\n  onNavigate?: AgentNativeCommandCallback;\n  onRemount?: AgentNativeCommandCallback;\n  onOpenResource?: AgentNativeCommandCallback;\n  onRequestApproval?: AgentNativeCommandCallback;\n}\n\nfunction mergeObject<T extends object>(\n  base: T | undefined,\n  override: T | undefined,\n): T | undefined {\n  if (!base && !override) return undefined;\n  return { ...(base ?? {}), ...(override ?? {}) } as T;\n}\n\nfunction mergeHostContext(\n  base: AgentNativeHostContext,\n  override: AgentNativeHostContext | undefined,\n): AgentNativeHostContext {\n  if (!override) return base;\n  return {\n    ...base,\n    ...override,\n    route: mergeObject(base.route, override.route),\n    selection: mergeObject(base.selection, override.selection),\n    screen: mergeObject(base.screen, override.screen),\n  };\n}\n\nfunction toCommandHandler(\n  callback: AgentNativeCommandCallback | undefined,\n): AgentNativeHostCommandHandler | undefined {\n  if (!callback) return undefined;\n  return (request: AgentNativeHostCommandRequest) =>\n    callback(request.payload, {\n      command: request.command,\n      requestId: request.requestId,\n      origin: request.origin,\n    });\n}\n\nexport function useAgentNativeScreenContext(\n  options?: AgentNativeScreenSnapshotOptions,\n): AgentNativeHostContextGetter {\n  return useCallback(() => readAgentNativeScreenContext(options), [options]);\n}\n\nexport function AgentNative({\n  actions,\n  getContext,\n  screen = true,\n  commands,\n  onRefresh,\n  onNavigate,\n  onRemount,\n  onOpenResource,\n  onRequestApproval,\n  ...frameProps\n}: AgentNativeProps) {\n  const getMergedContext = useCallback(async () => {\n    const screenContext =\n      screen === false\n        ? {}\n        : readAgentNativeScreenContext(screen === true ? {} : screen);\n    const customContext = getContext ? await getContext() : undefined;\n    return mergeHostContext(screenContext, customContext);\n  }, [getContext, screen]);\n\n  const mergedCommands = useMemo(() => {\n    const refreshHandler = toCommandHandler(onRefresh);\n    const navigateHandler = toCommandHandler(onNavigate);\n    const remountHandler = toCommandHandler(onRemount);\n    const openResourceHandler = toCommandHandler(onOpenResource);\n    const requestApprovalHandler = toCommandHandler(onRequestApproval);\n\n    return {\n      ...commands,\n      ...(refreshHandler\n        ? { refreshData: refreshHandler, \"refresh-data\": refreshHandler }\n        : {}),\n      ...(navigateHandler ? { navigate: navigateHandler } : {}),\n      ...(remountHandler\n        ? { remountView: remountHandler, \"remount-view\": remountHandler }\n        : {}),\n      ...(openResourceHandler\n        ? {\n            openResource: openResourceHandler,\n            \"open-resource\": openResourceHandler,\n          }\n        : {}),\n      ...(requestApprovalHandler\n        ? {\n            requestApproval: requestApprovalHandler,\n            \"request-approval\": requestApprovalHandler,\n          }\n        : {}),\n    };\n  }, [\n    commands,\n    onNavigate,\n    onOpenResource,\n    onRefresh,\n    onRemount,\n    onRequestApproval,\n  ]);\n\n  return (\n    <AgentNativeFrame\n      {...frameProps}\n      actions={actions}\n      commands={mergedCommands}\n      getContext={getMergedContext}\n    />\n  );\n}\n"]}

package/dist/client/AgentNativeEmbedded.d.ts

@@ -0,0 +1,47 @@
+import React from "react";
+import { type AgentChatSurfaceProps, type AgentSidebarProps } from "./AgentPanel.js";
+import { type AgentNativeBrowserSessionBridge } from "./browser-session-bridge.js";
+import { type AgentNativeClientActions, type AgentNativeHostCommandHandlers, type AgentNativeHostContextGetter, type AgentNativeHostSession, type AgentNativeScreenSnapshotOptions } from "./host-bridge.js";
+export interface AgentNativeEmbeddedCommandCallbackInfo {
+    command: string;
+    requestId?: string;
+    origin: string;
+}
+export type AgentNativeEmbeddedCommandCallback = (payload: unknown, info: AgentNativeEmbeddedCommandCallbackInfo) => unknown | Promise<unknown>;
+export interface AgentNativeEmbeddedBrowserSessionOptions {
+    endpoint?: string;
+    sessionId?: string;
+    label?: string;
+    heartbeatMs?: number;
+    pollMs?: number;
+    ttlMs?: number;
+    fetch?: typeof fetch;
+    onReady?: (bridge: AgentNativeBrowserSessionBridge) => void;
+}
+export interface UseAgentNativeEmbeddedBrowserSessionOptions {
+    enabled?: boolean;
+    actions?: AgentNativeClientActions;
+    getContext?: AgentNativeHostContextGetter;
+    screen?: boolean | AgentNativeScreenSnapshotOptions;
+    commands?: AgentNativeHostCommandHandlers;
+    session?: string | Partial<AgentNativeHostSession>;
+    browserSession?: AgentNativeEmbeddedBrowserSessionOptions;
+    onRefresh?: AgentNativeEmbeddedCommandCallback;
+    onNavigate?: AgentNativeEmbeddedCommandCallback;
+    onRemount?: AgentNativeEmbeddedCommandCallback;
+    onOpenResource?: AgentNativeEmbeddedCommandCallback;
+    onRequestApproval?: AgentNativeEmbeddedCommandCallback;
+}
+export interface AgentNativeEmbeddedProps extends Omit<AgentSidebarProps, "children">, UseAgentNativeEmbeddedBrowserSessionOptions {
+    children?: React.ReactNode;
+    /**
+     * Render only the agent chat surface when no host children are supplied.
+     * Defaults to "sidebar" when `children` exist and "panel" otherwise.
+     */
+    surface?: "sidebar" | "panel";
+    /** Props forwarded to AgentChatSurface in panel mode. */
+    panel?: AgentChatSurfaceProps;
+}
+export declare function useAgentNativeEmbeddedBrowserSession({ enabled, actions, getContext, screen, commands, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, }: UseAgentNativeEmbeddedBrowserSessionOptions): void;
+export declare function AgentNativeEmbedded({ children, surface, actions, getContext, enabled, screen, commands, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, panel, ...sidebarProps }: AgentNativeEmbeddedProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AgentNativeEmbedded.d.ts.map

package/dist/client/AgentNativeEmbedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentNativeEmbedded.d.ts","sourceRoot":"","sources":["../../src/client/AgentNativeEmbedded.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAC/D,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,wBAAwB,EAE7B,KAAK,8BAA8B,EAGnC,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,EACtC,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,sCAAsC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kCAAkC,GAAG,CAC/C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,sCAAsC,KACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,+BAA+B,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,2CAA2C;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,UAAU,CAAC,EAAE,4BAA4B,CAAC;IAC1C,MAAM,CAAC,EAAE,OAAO,GAAG,gCAAgC,CAAC;IACpD,QAAQ,CAAC,EAAE,8BAA8B,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnD,cAAc,CAAC,EAAE,wCAAwC,CAAC;IAC1D,SAAS,CAAC,EAAE,kCAAkC,CAAC;IAC/C,UAAU,CAAC,EAAE,kCAAkC,CAAC;IAChD,SAAS,CAAC,EAAE,kCAAkC,CAAC;IAC/C,cAAc,CAAC,EAAE,kCAAkC,CAAC;IACpD,iBAAiB,CAAC,EAAE,kCAAkC,CAAC;CACxD;AAED,MAAM,WAAW,wBACf,SACE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,EACnC,2CAA2C;IAC7C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,yDAAyD;IACzD,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B;AAkGD,wBAAgB,oCAAoC,CAAC,EACnD,OAAc,EACd,OAAO,EACP,UAAU,EACV,MAAa,EACb,QAAQ,EACR,OAAO,EACP,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,iBAAiB,GAClB,EAAE,2CAA2C,QAqD7C;AAED,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,OAAO,EACP,OAAO,EACP,UAAU,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,OAAO,EACP,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,KAAK,EACL,GAAG,YAAY,EAChB,EAAE,wBAAwB,2CA+B1B"}

package/dist/client/AgentNativeEmbedded.js

@@ -0,0 +1,148 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo } from "react";
+import { AgentChatSurface, AgentSidebar, } from "./AgentPanel.js";
+import { createAgentNativeBrowserSessionBridge, } from "./browser-session-bridge.js";
+import { readAgentNativeScreenContext, } from "./host-bridge.js";
+function mergeObject(base, override) {
+    if (!base && !override)
+        return undefined;
+    return { ...(base ?? {}), ...(override ?? {}) };
+}
+function mergeHostContext(base, override) {
+    if (!override)
+        return base;
+    return {
+        ...base,
+        ...override,
+        route: mergeObject(base.route, override.route),
+        selection: mergeObject(base.selection, override.selection),
+        screen: mergeObject(base.screen, override.screen),
+    };
+}
+function toCommandHandler(callback) {
+    if (!callback)
+        return undefined;
+    return (request) => callback(request.payload, {
+        command: request.command,
+        requestId: request.requestId,
+        origin: request.origin,
+    });
+}
+function sessionBrowserTabId(session) {
+    if (typeof session === "string")
+        return session;
+    return typeof session?.id === "string" ? session.id : undefined;
+}
+function useMergedEmbeddedCommands({ commands, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, }) {
+    return useMemo(() => {
+        const refreshHandler = toCommandHandler(onRefresh);
+        const navigateHandler = toCommandHandler(onNavigate);
+        const remountHandler = toCommandHandler(onRemount);
+        const openResourceHandler = toCommandHandler(onOpenResource);
+        const requestApprovalHandler = toCommandHandler(onRequestApproval);
+        return {
+            ...commands,
+            ...(refreshHandler
+                ? { refreshData: refreshHandler, "refresh-data": refreshHandler }
+                : {}),
+            ...(navigateHandler ? { navigate: navigateHandler } : {}),
+            ...(remountHandler
+                ? { remountView: remountHandler, "remount-view": remountHandler }
+                : {}),
+            ...(openResourceHandler
+                ? {
+                    openResource: openResourceHandler,
+                    "open-resource": openResourceHandler,
+                }
+                : {}),
+            ...(requestApprovalHandler
+                ? {
+                    requestApproval: requestApprovalHandler,
+                    "request-approval": requestApprovalHandler,
+                }
+                : {}),
+        };
+    }, [
+        commands,
+        onNavigate,
+        onOpenResource,
+        onRefresh,
+        onRemount,
+        onRequestApproval,
+    ]);
+}
+export function useAgentNativeEmbeddedBrowserSession({ enabled = true, actions, getContext, screen = true, commands, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, }) {
+    const mergedCommands = useMergedEmbeddedCommands({
+        commands,
+        onNavigate,
+        onOpenResource,
+        onRefresh,
+        onRemount,
+        onRequestApproval,
+    });
+    const getMergedContext = useCallback(async () => {
+        const screenContext = screen === false
+            ? {}
+            : readAgentNativeScreenContext(screen === true ? {} : screen);
+        const customContext = getContext ? await getContext() : undefined;
+        return mergeHostContext(screenContext, customContext);
+    }, [getContext, screen]);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const bridge = createAgentNativeBrowserSessionBridge({
+            endpoint: browserSession?.endpoint,
+            sessionId: browserSession?.sessionId,
+            label: browserSession?.label,
+            heartbeatMs: browserSession?.heartbeatMs,
+            pollMs: browserSession?.pollMs,
+            ttlMs: browserSession?.ttlMs,
+            fetch: browserSession?.fetch,
+            session,
+            getContext: getMergedContext,
+            actions,
+            commands: mergedCommands,
+        }).start();
+        browserSession?.onReady?.(bridge);
+        return () => bridge.stop();
+    }, [
+        actions,
+        browserSession?.endpoint,
+        browserSession?.fetch,
+        browserSession?.heartbeatMs,
+        browserSession?.label,
+        browserSession?.onReady,
+        browserSession?.pollMs,
+        browserSession?.sessionId,
+        browserSession?.ttlMs,
+        enabled,
+        getMergedContext,
+        mergedCommands,
+        session,
+    ]);
+}
+export function AgentNativeEmbedded({ children, surface, actions, getContext, enabled, screen, commands, session, browserSession, onNavigate, onOpenResource, onRefresh, onRemount, onRequestApproval, panel, ...sidebarProps }) {
+    useAgentNativeEmbeddedBrowserSession({
+        enabled,
+        actions,
+        getContext,
+        screen,
+        commands,
+        session,
+        browserSession,
+        onNavigate,
+        onOpenResource,
+        onRefresh,
+        onRemount,
+        onRequestApproval,
+    });
+    const mode = surface ?? (children ? "sidebar" : "panel");
+    const browserTabId = sidebarProps.browserTabId ??
+        panel?.browserTabId ??
+        sessionBrowserTabId(session);
+    if (mode === "panel" || !children) {
+        return _jsx(AgentChatSurface, { browserTabId: browserTabId, ...panel });
+    }
+    return (_jsx(AgentSidebar, { ...sidebarProps, browserTabId: browserTabId, children: children }));
+}
+//# sourceMappingURL=AgentNativeEmbedded.js.map

package/dist/client/AgentNativeEmbedded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentNativeEmbedded.js","sourceRoot":"","sources":["../../src/client/AgentNativeEmbedded.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useCallback, useEffect, useMemo } from \"react\";\nimport {\n  AgentChatSurface,\n  AgentSidebar,\n  type AgentChatSurfaceProps,\n  type AgentSidebarProps,\n} from \"./AgentPanel.js\";\nimport {\n  createAgentNativeBrowserSessionBridge,\n  type AgentNativeBrowserSessionBridge,\n} from \"./browser-session-bridge.js\";\nimport {\n  readAgentNativeScreenContext,\n  type AgentNativeClientActions,\n  type AgentNativeHostCommandHandler,\n  type AgentNativeHostCommandHandlers,\n  type AgentNativeHostCommandRequest,\n  type AgentNativeHostContext,\n  type AgentNativeHostContextGetter,\n  type AgentNativeHostSession,\n  type AgentNativeScreenSnapshotOptions,\n} from \"./host-bridge.js\";\n\nexport interface AgentNativeEmbeddedCommandCallbackInfo {\n  command: string;\n  requestId?: string;\n  origin: string;\n}\n\nexport type AgentNativeEmbeddedCommandCallback = (\n  payload: unknown,\n  info: AgentNativeEmbeddedCommandCallbackInfo,\n) => unknown | Promise<unknown>;\n\nexport interface AgentNativeEmbeddedBrowserSessionOptions {\n  endpoint?: string;\n  sessionId?: string;\n  label?: string;\n  heartbeatMs?: number;\n  pollMs?: number;\n  ttlMs?: number;\n  fetch?: typeof fetch;\n  onReady?: (bridge: AgentNativeBrowserSessionBridge) => void;\n}\n\nexport interface UseAgentNativeEmbeddedBrowserSessionOptions {\n  enabled?: boolean;\n  actions?: AgentNativeClientActions;\n  getContext?: AgentNativeHostContextGetter;\n  screen?: boolean | AgentNativeScreenSnapshotOptions;\n  commands?: AgentNativeHostCommandHandlers;\n  session?: string | Partial<AgentNativeHostSession>;\n  browserSession?: AgentNativeEmbeddedBrowserSessionOptions;\n  onRefresh?: AgentNativeEmbeddedCommandCallback;\n  onNavigate?: AgentNativeEmbeddedCommandCallback;\n  onRemount?: AgentNativeEmbeddedCommandCallback;\n  onOpenResource?: AgentNativeEmbeddedCommandCallback;\n  onRequestApproval?: AgentNativeEmbeddedCommandCallback;\n}\n\nexport interface AgentNativeEmbeddedProps\n  extends\n    Omit<AgentSidebarProps, \"children\">,\n    UseAgentNativeEmbeddedBrowserSessionOptions {\n  children?: React.ReactNode;\n  /**\n   * Render only the agent chat surface when no host children are supplied.\n   * Defaults to \"sidebar\" when `children` exist and \"panel\" otherwise.\n   */\n  surface?: \"sidebar\" | \"panel\";\n  /** Props forwarded to AgentChatSurface in panel mode. */\n  panel?: AgentChatSurfaceProps;\n}\n\nfunction mergeObject<T extends object>(\n  base: T | undefined,\n  override: T | undefined,\n): T | undefined {\n  if (!base && !override) return undefined;\n  return { ...(base ?? {}), ...(override ?? {}) } as T;\n}\n\nfunction mergeHostContext(\n  base: AgentNativeHostContext,\n  override: AgentNativeHostContext | undefined,\n): AgentNativeHostContext {\n  if (!override) return base;\n  return {\n    ...base,\n    ...override,\n    route: mergeObject(base.route, override.route),\n    selection: mergeObject(base.selection, override.selection),\n    screen: mergeObject(base.screen, override.screen),\n  };\n}\n\nfunction toCommandHandler(\n  callback: AgentNativeEmbeddedCommandCallback | undefined,\n): AgentNativeHostCommandHandler | undefined {\n  if (!callback) return undefined;\n  return (request: AgentNativeHostCommandRequest) =>\n    callback(request.payload, {\n      command: request.command,\n      requestId: request.requestId,\n      origin: request.origin,\n    });\n}\n\nfunction sessionBrowserTabId(\n  session: UseAgentNativeEmbeddedBrowserSessionOptions[\"session\"],\n): string | undefined {\n  if (typeof session === \"string\") return session;\n  return typeof session?.id === \"string\" ? session.id : undefined;\n}\n\nfunction useMergedEmbeddedCommands({\n  commands,\n  onNavigate,\n  onOpenResource,\n  onRefresh,\n  onRemount,\n  onRequestApproval,\n}: Pick<\n  UseAgentNativeEmbeddedBrowserSessionOptions,\n  | \"commands\"\n  | \"onNavigate\"\n  | \"onOpenResource\"\n  | \"onRefresh\"\n  | \"onRemount\"\n  | \"onRequestApproval\"\n>) {\n  return useMemo(() => {\n    const refreshHandler = toCommandHandler(onRefresh);\n    const navigateHandler = toCommandHandler(onNavigate);\n    const remountHandler = toCommandHandler(onRemount);\n    const openResourceHandler = toCommandHandler(onOpenResource);\n    const requestApprovalHandler = toCommandHandler(onRequestApproval);\n\n    return {\n      ...commands,\n      ...(refreshHandler\n        ? { refreshData: refreshHandler, \"refresh-data\": refreshHandler }\n        : {}),\n      ...(navigateHandler ? { navigate: navigateHandler } : {}),\n      ...(remountHandler\n        ? { remountView: remountHandler, \"remount-view\": remountHandler }\n        : {}),\n      ...(openResourceHandler\n        ? {\n            openResource: openResourceHandler,\n            \"open-resource\": openResourceHandler,\n          }\n        : {}),\n      ...(requestApprovalHandler\n        ? {\n            requestApproval: requestApprovalHandler,\n            \"request-approval\": requestApprovalHandler,\n          }\n        : {}),\n    };\n  }, [\n    commands,\n    onNavigate,\n    onOpenResource,\n    onRefresh,\n    onRemount,\n    onRequestApproval,\n  ]);\n}\n\nexport function useAgentNativeEmbeddedBrowserSession({\n  enabled = true,\n  actions,\n  getContext,\n  screen = true,\n  commands,\n  session,\n  browserSession,\n  onNavigate,\n  onOpenResource,\n  onRefresh,\n  onRemount,\n  onRequestApproval,\n}: UseAgentNativeEmbeddedBrowserSessionOptions) {\n  const mergedCommands = useMergedEmbeddedCommands({\n    commands,\n    onNavigate,\n    onOpenResource,\n    onRefresh,\n    onRemount,\n    onRequestApproval,\n  });\n\n  const getMergedContext = useCallback(async () => {\n    const screenContext =\n      screen === false\n        ? {}\n        : readAgentNativeScreenContext(screen === true ? {} : screen);\n    const customContext = getContext ? await getContext() : undefined;\n    return mergeHostContext(screenContext, customContext);\n  }, [getContext, screen]);\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const bridge = createAgentNativeBrowserSessionBridge({\n      endpoint: browserSession?.endpoint,\n      sessionId: browserSession?.sessionId,\n      label: browserSession?.label,\n      heartbeatMs: browserSession?.heartbeatMs,\n      pollMs: browserSession?.pollMs,\n      ttlMs: browserSession?.ttlMs,\n      fetch: browserSession?.fetch,\n      session,\n      getContext: getMergedContext,\n      actions,\n      commands: mergedCommands,\n    }).start();\n\n    browserSession?.onReady?.(bridge);\n    return () => bridge.stop();\n  }, [\n    actions,\n    browserSession?.endpoint,\n    browserSession?.fetch,\n    browserSession?.heartbeatMs,\n    browserSession?.label,\n    browserSession?.onReady,\n    browserSession?.pollMs,\n    browserSession?.sessionId,\n    browserSession?.ttlMs,\n    enabled,\n    getMergedContext,\n    mergedCommands,\n    session,\n  ]);\n}\n\nexport function AgentNativeEmbedded({\n  children,\n  surface,\n  actions,\n  getContext,\n  enabled,\n  screen,\n  commands,\n  session,\n  browserSession,\n  onNavigate,\n  onOpenResource,\n  onRefresh,\n  onRemount,\n  onRequestApproval,\n  panel,\n  ...sidebarProps\n}: AgentNativeEmbeddedProps) {\n  useAgentNativeEmbeddedBrowserSession({\n    enabled,\n    actions,\n    getContext,\n    screen,\n    commands,\n    session,\n    browserSession,\n    onNavigate,\n    onOpenResource,\n    onRefresh,\n    onRemount,\n    onRequestApproval,\n  });\n\n  const mode = surface ?? (children ? \"sidebar\" : \"panel\");\n  const browserTabId =\n    sidebarProps.browserTabId ??\n    panel?.browserTabId ??\n    sessionBrowserTabId(session);\n\n  if (mode === \"panel\" || !children) {\n    return <AgentChatSurface browserTabId={browserTabId} {...panel} />;\n  }\n\n  return (\n    <AgentSidebar {...sidebarProps} browserTabId={browserTabId}>\n      {children}\n    </AgentSidebar>\n  );\n}\n"]}

package/dist/client/AgentNativeFrame.d.ts

@@ -0,0 +1,25 @@
+import React, { type IframeHTMLAttributes } from "react";
+import { type AgentNativeClientActions, type AgentNativeHostAuth, type AgentNativeHostBridge, type AgentNativeHostBridgeEvent, type AgentNativeHostCommandHandlers, type AgentNativeHostContextGetter, type AgentNativeHostSession } from "./host-bridge.js";
+export interface AgentNativeFrameProps extends Omit<IframeHTMLAttributes<HTMLIFrameElement>, "src"> {
+    /** URL of the Agent-Native sidecar/frame app. */
+    agentUrl: string;
+    /**
+     * Exact trusted sidecar origin. Defaults to `new URL(agentUrl).origin`.
+     * Pass "*" only for local prototypes.
+     */
+    agentOrigin?: string;
+    /** Stable browser-session identity for multi-tab sidecars. */
+    session?: string | Partial<AgentNativeHostSession>;
+    /** Return page, selection, resource, user/org, and host-specific context. */
+    getContext?: AgentNativeHostContextGetter;
+    /** Commands the iframe sidecar can ask the host app to run. */
+    commands?: AgentNativeHostCommandHandlers;
+    /** Live browser-session actions the iframe sidecar can discover and call. */
+    actions?: AgentNativeClientActions;
+    /** Optional auth payload sent to the trusted iframe sidecar. */
+    auth?: AgentNativeHostAuth;
+    onBridgeEvent?: (event: AgentNativeHostBridgeEvent) => void;
+    onBridgeReady?: (bridge: AgentNativeHostBridge) => void;
+}
+export declare const AgentNativeFrame: React.ForwardRefExoticComponent<AgentNativeFrameProps & React.RefAttributes<HTMLIFrameElement>>;
+//# sourceMappingURL=AgentNativeFrame.d.ts.map

package/dist/client/AgentNativeFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentNativeFrame.d.ts","sourceRoot":"","sources":["../../src/client/AgentNativeFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAMZ,KAAK,oBAAoB,EAC1B,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC5B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,KAAK,CACN;IACC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnD,6EAA6E;IAC7E,UAAU,CAAC,EAAE,4BAA4B,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,8BAA8B,CAAC;IAC1C,6EAA6E;IAC7E,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,gEAAgE;IAChE,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAC5D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACzD;AAyBD,eAAO,MAAM,gBAAgB,iGAkF3B,CAAC"}

package/dist/client/AgentNativeFrame.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useEffect, useMemo, useRef, } from "react";
+import { createAgentNativeHostBridge, } from "./host-bridge.js";
+function originFromUrl(value) {
+    try {
+        const base = typeof window !== "undefined"
+            ? window.location.href
+            : "http://agent-native.local";
+        return new URL(value, base).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+function setForwardedRef(ref, value) {
+    if (typeof ref === "function")
+        ref(value);
+    else if (ref)
+        ref.current = value;
+}
+const defaultStyle = {
+    border: 0,
+    width: "100%",
+    height: "100%",
+};
+export const AgentNativeFrame = forwardRef(function AgentNativeFrame({ agentUrl, agentOrigin, session, getContext, commands, actions, auth, onBridgeEvent, onBridgeReady, title = "Agent Native assistant", sandbox = "allow-scripts allow-same-origin allow-forms allow-popups allow-downloads", allow = "clipboard-read; clipboard-write; microphone; fullscreen", referrerPolicy = "strict-origin-when-cross-origin", style, onLoad, ...iframeProps }, forwardedRef) {
+    const iframeRef = useRef(null);
+    const bridgeRef = useRef(null);
+    const resolvedOrigin = useMemo(() => agentOrigin ?? originFromUrl(agentUrl), [agentOrigin, agentUrl]);
+    useEffect(() => {
+        const bridge = createAgentNativeHostBridge({
+            agentOrigin: resolvedOrigin,
+            session,
+            getContext,
+            commands,
+            actions,
+            auth,
+            onEvent: onBridgeEvent,
+            targetWindow: iframeRef.current?.contentWindow ?? null,
+        }).start();
+        bridgeRef.current = bridge;
+        onBridgeReady?.(bridge);
+        return () => {
+            bridge.stop();
+            if (bridgeRef.current === bridge)
+                bridgeRef.current = null;
+        };
+    }, [
+        auth,
+        actions,
+        commands,
+        getContext,
+        onBridgeEvent,
+        onBridgeReady,
+        resolvedOrigin,
+        session,
+    ]);
+    return (_jsx("iframe", { ...iframeProps, ref: (node) => {
+            iframeRef.current = node;
+            setForwardedRef(forwardedRef, node);
+            bridgeRef.current?.setTargetWindow(node?.contentWindow ?? null);
+        }, src: agentUrl, title: title, sandbox: sandbox, allow: allow, referrerPolicy: referrerPolicy, style: { ...defaultStyle, ...style }, onLoad: (event) => {
+            bridgeRef.current?.setTargetWindow(event.currentTarget.contentWindow ?? null);
+            void bridgeRef.current?.sendInit();
+            onLoad?.(event);
+        } }));
+});
+//# sourceMappingURL=AgentNativeFrame.js.map

package/dist/client/AgentNativeFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentNativeFrame.js","sourceRoot":"","sources":["../../src/client/AgentNativeFrame.tsx"],"names":[],"mappings":";AAAA,OAAc,EACZ,UAAU,EACV,SAAS,EACT,OAAO,EACP,MAAM,GAGP,MAAM,OAAO,CAAC;AACf,OAAO,EACL,2BAA2B,GAQ5B,MAAM,kBAAkB,CAAC;AA2B1B,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GACR,OAAO,MAAM,KAAK,WAAW;YAC3B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI;YACtB,CAAC,CAAC,2BAA2B,CAAC;QAClC,OAAO,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAI,GAA0B,EAAE,KAAe;IACrE,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,GAAG,CAAC,KAAK,CAAC,CAAC;SACrC,IAAI,GAAG;QAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;AACpC,CAAC;AAED,MAAM,YAAY,GAAkB;IAClC,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAGxC,SAAS,gBAAgB,CACzB,EACE,QAAQ,EACR,WAAW,EACX,OAAO,EACP,UAAU,EACV,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,aAAa,EACb,aAAa,EACb,KAAK,GAAG,wBAAwB,EAChC,OAAO,GAAG,0EAA0E,EACpF,KAAK,GAAG,yDAAyD,EACjE,cAAc,GAAG,iCAAiC,EAClD,KAAK,EACL,MAAM,EACN,GAAG,WAAW,EACf,EACD,YAAY;IAEZ,MAAM,SAAS,GAAG,MAAM,CAA2B,IAAI,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,CAA+B,IAAI,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CAAC,WAAW,IAAI,aAAa,CAAC,QAAQ,CAAC,EAC5C,CAAC,WAAW,EAAE,QAAQ,CAAC,CACxB,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,2BAA2B,CAAC;YACzC,WAAW,EAAE,cAAc;YAC3B,OAAO;YACP,UAAU;YACV,QAAQ;YACR,OAAO;YACP,IAAI;YACJ,OAAO,EAAE,aAAa;YACtB,YAAY,EAAE,SAAS,CAAC,OAAO,EAAE,aAAa,IAAI,IAAI;SACvD,CAAC,CAAC,KAAK,EAAE,CAAC;QACX,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;QAC3B,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM;gBAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC7D,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,UAAU;QACV,aAAa;QACb,aAAa;QACb,cAAc;QACd,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,CACL,oBACM,WAAW,EACf,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;YACZ,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YACzB,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACpC,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC,CAAC;QAClE,CAAC,EACD,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,EAAE,EACpC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChB,SAAS,CAAC,OAAO,EAAE,eAAe,CAChC,KAAK,CAAC,aAAa,CAAC,aAAa,IAAI,IAAI,CAC1C,CAAC;YACF,KAAK,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;YACnC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,GACD,CACH,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["import React, {\n  forwardRef,\n  useEffect,\n  useMemo,\n  useRef,\n  type CSSProperties,\n  type IframeHTMLAttributes,\n} from \"react\";\nimport {\n  createAgentNativeHostBridge,\n  type AgentNativeClientActions,\n  type AgentNativeHostAuth,\n  type AgentNativeHostBridge,\n  type AgentNativeHostBridgeEvent,\n  type AgentNativeHostCommandHandlers,\n  type AgentNativeHostContextGetter,\n  type AgentNativeHostSession,\n} from \"./host-bridge.js\";\n\nexport interface AgentNativeFrameProps extends Omit<\n  IframeHTMLAttributes<HTMLIFrameElement>,\n  \"src\"\n> {\n  /** URL of the Agent-Native sidecar/frame app. */\n  agentUrl: string;\n  /**\n   * Exact trusted sidecar origin. Defaults to `new URL(agentUrl).origin`.\n   * Pass \"*\" only for local prototypes.\n   */\n  agentOrigin?: string;\n  /** Stable browser-session identity for multi-tab sidecars. */\n  session?: string | Partial<AgentNativeHostSession>;\n  /** Return page, selection, resource, user/org, and host-specific context. */\n  getContext?: AgentNativeHostContextGetter;\n  /** Commands the iframe sidecar can ask the host app to run. */\n  commands?: AgentNativeHostCommandHandlers;\n  /** Live browser-session actions the iframe sidecar can discover and call. */\n  actions?: AgentNativeClientActions;\n  /** Optional auth payload sent to the trusted iframe sidecar. */\n  auth?: AgentNativeHostAuth;\n  onBridgeEvent?: (event: AgentNativeHostBridgeEvent) => void;\n  onBridgeReady?: (bridge: AgentNativeHostBridge) => void;\n}\n\nfunction originFromUrl(value: string): string | undefined {\n  try {\n    const base =\n      typeof window !== \"undefined\"\n        ? window.location.href\n        : \"http://agent-native.local\";\n    return new URL(value, base).origin;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction setForwardedRef<T>(ref: React.ForwardedRef<T>, value: T | null) {\n  if (typeof ref === \"function\") ref(value);\n  else if (ref) ref.current = value;\n}\n\nconst defaultStyle: CSSProperties = {\n  border: 0,\n  width: \"100%\",\n  height: \"100%\",\n};\n\nexport const AgentNativeFrame = forwardRef<\n  HTMLIFrameElement,\n  AgentNativeFrameProps\n>(function AgentNativeFrame(\n  {\n    agentUrl,\n    agentOrigin,\n    session,\n    getContext,\n    commands,\n    actions,\n    auth,\n    onBridgeEvent,\n    onBridgeReady,\n    title = \"Agent Native assistant\",\n    sandbox = \"allow-scripts allow-same-origin allow-forms allow-popups allow-downloads\",\n    allow = \"clipboard-read; clipboard-write; microphone; fullscreen\",\n    referrerPolicy = \"strict-origin-when-cross-origin\",\n    style,\n    onLoad,\n    ...iframeProps\n  },\n  forwardedRef,\n) {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const bridgeRef = useRef<AgentNativeHostBridge | null>(null);\n  const resolvedOrigin = useMemo(\n    () => agentOrigin ?? originFromUrl(agentUrl),\n    [agentOrigin, agentUrl],\n  );\n\n  useEffect(() => {\n    const bridge = createAgentNativeHostBridge({\n      agentOrigin: resolvedOrigin,\n      session,\n      getContext,\n      commands,\n      actions,\n      auth,\n      onEvent: onBridgeEvent,\n      targetWindow: iframeRef.current?.contentWindow ?? null,\n    }).start();\n    bridgeRef.current = bridge;\n    onBridgeReady?.(bridge);\n    return () => {\n      bridge.stop();\n      if (bridgeRef.current === bridge) bridgeRef.current = null;\n    };\n  }, [\n    auth,\n    actions,\n    commands,\n    getContext,\n    onBridgeEvent,\n    onBridgeReady,\n    resolvedOrigin,\n    session,\n  ]);\n\n  return (\n    <iframe\n      {...iframeProps}\n      ref={(node) => {\n        iframeRef.current = node;\n        setForwardedRef(forwardedRef, node);\n        bridgeRef.current?.setTargetWindow(node?.contentWindow ?? null);\n      }}\n      src={agentUrl}\n      title={title}\n      sandbox={sandbox}\n      allow={allow}\n      referrerPolicy={referrerPolicy}\n      style={{ ...defaultStyle, ...style }}\n      onLoad={(event) => {\n        bridgeRef.current?.setTargetWindow(\n          event.currentTarget.contentWindow ?? null,\n        );\n        void bridgeRef.current?.sendInit();\n        onLoad?.(event);\n      }}\n    />\n  );\n});\n"]}

package/dist/client/AgentPanel.d.ts

@@ -17,8 +17,8 @@
  *   // In a popover
  *   <Popover><AgentPanel suggestions={[...]} /></Popover>
  *
- *   // Full page
- *   <AgentPanel className="h-screen" />
+ *   // Full page chat surface
+ *   <AgentChatSurface mode="page" className="h-screen" />
  */
 import React from "react";
 import { type AssistantChatProps } from "./AssistantChat.js";
@@ -71,6 +71,23 @@ export interface AgentPanelProps extends Omit<AssistantChatProps, "onSwitchToCli
     codeAccess?: AgentPanelCodeAccess;
 }
 export declare function AgentPanel(props: AgentPanelProps): import("react/jsx-runtime").JSX.Element;
+export type AgentChatSurfaceMode = "panel" | "page";
+export interface AgentChatSurfaceProps extends AgentPanelProps {
+    /**
+     * Layout treatment for the reusable chat surface. Use "page" when rendering
+     * chat as the primary route content instead of inside the sidebar shell.
+     * Default: "panel".
+     */
+    mode?: AgentChatSurfaceMode;
+}
+/**
+ * Reusable chat surface backed by AgentPanel internals.
+ *
+ * This gives page-level routes the same tabbed conversations, composer,
+ * model controls, scoped chat behavior, and recovery boundary used by the
+ * sidebar without introducing a second chat implementation.
+ */
+export declare function AgentChatSurface({ mode, className, defaultMode, isFullscreen, ...props }: AgentChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
 export interface AgentSidebarProps {
     children: React.ReactNode;
     /** Placeholder text for the empty chat state */

package/dist/client/AgentPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentPanel.d.ts","sourceRoot":"","sources":["../../src/client/AgentPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KASN,MAAM,OAAO,CAAC;AAwCf,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAgK5B,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,mEAAmE;IACnE,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,wEAAwE;IACxE,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC;AAgGD,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAC3C,kBAAkB,EAClB,eAAe,CAChB;IACC,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6GAA6G;IAC7G,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,iFAAiF;IACjF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6HAA6H;IAC7H,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,uBAAuB,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/D,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,uDAAuD;IACvD,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAm+CD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,2CAgBhD;AAID,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;yDACqD;IACrD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,uBAAuB,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/D,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,cAAsC,EACtC,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,QAAkB,EAClB,WAAmB,EACnB,aAAqB,EACrB,KAAK,EACL,YAAY,GACb,EAAE,iBAAiB,2CAgZnB;AAED;;;GAGG;AACH,wBAAgB,cAAc,SAgB7B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,2CAuBtE"}
+{"version":3,"file":"AgentPanel.d.ts","sourceRoot":"","sources":["../../src/client/AgentPanel.tsx"],"names":[],"mappings":"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"}

package/dist/client/AgentPanel.js

@@ -18,8 +18,8 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  *   // In a popover
  *   <Popover><AgentPanel suggestions={[...]} /></Popover>
  *
- *   // Full page
- *   <AgentPanel className="h-screen" />
+ *   // Full page chat surface
+ *   <AgentChatSurface mode="page" className="h-screen" />
  */
 import React, { useState, useEffect, useRef, useCallback, useMemo, lazy, Suspense, startTransition, } from "react";
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
@@ -236,7 +236,7 @@ function CodeAccessUnavailablePanel({ title, description, ctaLabel, ctaHref, sec
                             });
                         }, className: "inline-flex items-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-xs font-medium text-foreground hover:bg-accent", children: [secondaryCtaLabel, _jsx(IconExternalLink, { className: "h-3 w-3" })] })] })] }));
 }
-function AgentPanelInner({ defaultMode = "chat", className, apiUrl, emptyStateText, suggestions, showHeader = true, onCollapse, isFullscreen, onToggleFullscreen, devAppUrl, storageKey, scope, browserTabId, chatNotice, codeAccess, }) {
+function AgentPanelInner({ defaultMode = "chat", className, apiUrl, emptyStateText, emptyStateAddon, suggestions, showHeader = true, onCollapse, isFullscreen, onToggleFullscreen, devAppUrl, storageKey, scope, browserTabId, chatNotice, codeAccess, }) {
     const mounted = useClientOnly();
     const keyPrefix = storageKey ? `:${storageKey}` : "";
     const execModeKey = `${EXEC_MODE_KEY}${keyPrefix}`;
@@ -554,7 +554,7 @@ function AgentPanelInner({ defaultMode = "chat", className, apiUrl, emptyStateTe
                         `[data-agent-fullscreen='true'] .agent-composer-area{` +
                         `max-width:${FULLSCREEN_CONTENT_MAX_PX}px;` +
                         `margin-left:auto;margin-right:auto;width:100%;}`,
-                } }), SHOW_ONBOARDING && mounted && canUseCodeTools && (_jsx(Suspense, { fallback: null, children: _jsx(OnboardingPanel, {}) })), _jsx("div", { className: cn("flex flex-col min-h-0", mode === "chat" ? "flex-1" : "shrink-0"), children: mounted && (_jsx(MultiTabAssistantChat, { apiUrl: apiUrl, showHeader: false, renderHeader: showHeader ? renderChatHeader : undefined, renderOverlay: undefined, contentHidden: mode !== "chat", emptyStateText: emptyStateText, suggestions: suggestions, onSwitchToCli: () => switchMode("cli"), execMode: execMode, onExecModeChange: switchExecMode, storageKey: storageKey, scope: scope, browserTabId: browserTabId })) }), canUseCodeTools
+                } }), SHOW_ONBOARDING && mounted && canUseCodeTools && (_jsx(Suspense, { fallback: null, children: _jsx(OnboardingPanel, {}) })), _jsx("div", { className: cn("flex flex-col min-h-0", mode === "chat" ? "flex-1" : "shrink-0"), children: mounted && (_jsx(MultiTabAssistantChat, { apiUrl: apiUrl, showHeader: false, renderHeader: showHeader ? renderChatHeader : undefined, renderOverlay: undefined, contentHidden: mode !== "chat", emptyStateText: emptyStateText, emptyStateAddon: emptyStateAddon, suggestions: suggestions, onSwitchToCli: () => switchMode("cli"), execMode: execMode, onExecModeChange: switchExecMode, storageKey: storageKey, scope: scope, browserTabId: browserTabId })) }), canUseCodeTools
                 ? mode === "cli" &&
                     cliTabs.map((id) => (_jsx("div", { className: "min-h-0 relative flex-1", style: {
                             display: id === activeCliTab ? undefined : "none",
@@ -920,6 +920,17 @@ export function AgentPanel(props) {
     }, [props.storageKey]);
     return (_jsx(TooltipProvider, { delayDuration: 200, children: _jsx(AgentPanelErrorBoundary, { onReset: resetPanel, children: _jsx(AgentPanelInner, { ...props }, resetKey) }) }));
 }
+/**
+ * Reusable chat surface backed by AgentPanel internals.
+ *
+ * This gives page-level routes the same tabbed conversations, composer,
+ * model controls, scoped chat behavior, and recovery boundary used by the
+ * sidebar without introducing a second chat implementation.
+ */
+export function AgentChatSurface({ mode = "panel", className, defaultMode = "chat", isFullscreen, ...props }) {
+    const pageMode = mode === "page";
+    return (_jsx(AgentPanel, { ...props, defaultMode: defaultMode, isFullscreen: isFullscreen ?? pageMode, className: cn(pageMode && "h-full min-h-0 w-full overflow-hidden bg-background", className) }));
+}
 /**
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.