@particle-academy/agent-integrations 0.34.0 → 0.36.0

package/dist/index.d.cts

@@ -24,8 +24,10 @@ export { TerminalBridge, TerminalBridgeAdapter, TerminalBridgeOptions, TerminalR
 export { CatalogBridgeAdapter, CatalogBridgeOptions, CatalogCheckoutArgs, CatalogPrice, CatalogProduct, registerCatalogBridge } from './bridges/catalog.cjs';
 export { FeatureDefinition, FeatureGrant, FeaturesBridgeAdapter, FeaturesBridgeOptions, registerFeaturesBridge } from './bridges/features.cjs';
 export { PASSKEY_BRIDGE_TOOLS, PasskeyBridgeAdapter, PasskeyBridgeOptions, PasskeyProposal, PasskeySummaryLike, PasskeySupport, PasskeySurfaceState, registerPasskeyBridge } from './bridges/passkeys.cjs';
-export { DocAdapter, DocBridgeOptions, DocOpTool, registerDocBridge } from './bridges/doc.cjs';
+import { DocAdapter } from './bridges/doc.cjs';
+export { DocBridgeOptions, DocOpTool, registerDocBridge } from './bridges/doc.cjs';
 export { CmsBridgeOptions, CmsOp, cmsReducer, registerCmsBridge } from './bridges/cms.cjs';
+import { DocNode, StagePolicy, TreeOp } from '@particle-academy/fancy-doc-commons';
 import { RelayState } from './sharing/index.cjs';
 export { SseRelayOptions, SseRelayTransport, attachSseRelay } from './sharing/index.cjs';
 import { S as SessionDescriptor } from './token-BZ8doMam.cjs';
@@ -40,7 +42,6 @@ export { CLAUDE_CONNECTORS_URL, CONNECTOR_GLYPHS, CONNECTOR_TARGETS, ClaudeMark,
 export { D as DEFAULT_MCPB_ENTRY_POINT, b as MCPB_MANIFEST_VERSION, c as MCPB_MIN_NODE, M as McpbManifestInput, a as McpbTool, d as buildMcpbManifest, e as buildMcpbProxyStub } from './mcpb-BXOrsRnv.cjs';
 import '@particle-academy/fancy-sheets';
 import '@particle-academy/fancy-slides';
-import '@particle-academy/fancy-doc-commons';
 
 /**
  * One interactive element the agent can act on, addressed by a STABLE handle
@@ -159,6 +160,46 @@ type NavigationBridgeOptions = {
  */
 declare function registerNavigationBridge(host: ToolHost, options: NavigationBridgeOptions): Bridge;
 
+/**
+ * Reserved node type for a literal string child. Must match fancy-screens'
+ * `TEXT_NODE_TYPE`; duplicated rather than imported to keep this bridge free of
+ * a fancy-screens dependency.
+ */
+declare const SCREEN_TEXT_NODE_TYPE = "#text";
+/** A screen document node — a `DocNode` plus the minted-id flag. */
+interface ScreenDocNode extends DocNode {
+    /**
+     * True when fancy-screens minted this id because the author supplied none.
+     * A synthetic id is derived from position, so it is not a durable handle.
+     */
+    synthetic?: boolean;
+}
+type ScreenDocOp = TreeOp<ScreenDocNode>;
+interface ScreenDocBridgeOptions {
+    adapter: DocAdapter<ScreenDocNode>;
+    /**
+     * Tool-name prefix. Default `"screen"` → `screen_add`, `screen_set_text`, …
+     *
+     * Tool names are global, so a host wiring more than one doc-driven screen at
+     * once must give each a distinct prefix (`"screen_checkout"`).
+     */
+    surface?: string;
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+    /** Auto-apply vs. confirm per op (trust-but-verify). Default: auto. */
+    stagePolicy?: StagePolicy<ScreenDocOp>;
+    onPending?: (staged: {
+        id: string;
+        op: ScreenDocOp;
+        label: string;
+    }) => void;
+}
+/** Register the screen-content bridge (prefix `screen_`) over a screen's `DocTree`. */
+declare function registerScreenDocBridge(host: ToolHost, options: ScreenDocBridgeOptions): Bridge;
+
 /** A thing the human did, surfaced so the connected agent stays aware. */
 type CoBrowseUserEvent = {
     kind: "navigation";
@@ -213,6 +254,18 @@ type CoBrowseSession = {
     server: MicroMcpServer | null;
     session: SessionDescriptor | null;
     relayState: RelayState;
+    /**
+     * True once at least one remote agent is actually attached to the session.
+     *
+     * Distinct from `relayState === "open"`, which only says the BROWSER reached
+     * the relay — true the moment sharing starts, before the link has been handed
+     * to anyone. A UI that keys "Agent is driving" off the relay state therefore
+     * announces a driver who does not exist, and stays silent when a real one
+     * arrives.
+     */
+    agentConnected: boolean;
+    /** How many remote agents are attached (0 when nobody has joined). */
+    agentCount: number;
     startShare: () => Promise<void>;
     stopShare: () => void;
     /**
@@ -440,8 +493,8 @@ type CoBrowsePresenceProps = {
 };
 /**
  * The human's view of a site-wide co-browsing session: a "Let an agent drive"
- * starter, the share/connect surface once started, a live "agent is driving"
- * status with the latest action, and a Stop / take-back-control button.
+ * starter, the share/connect surface until an agent arrives, a live log of what
+ * it is doing once one has, and a Stop / take-back-control button.
  *
  * Staged-action confirms are rendered by the HOST (via the navigation adapter's
  * `confirm`), so this component stays presentation-only.
@@ -456,6 +509,15 @@ type CoBrowseCursorLayerProps = {
     active?: boolean;
     /** Stacking order of the overlay. Default just under the max. */
     zIndex?: number;
+    /**
+     * Retire the cursor after this long without a tool call. Default 15s;
+     * `0` keeps it on screen indefinitely.
+     *
+     * A cursor that sits still is not neutral — it reads as "the agent is
+     * broken", which is worse than showing nothing. Continuous presence belongs
+     * in the activity log; the cursor is for *motion*.
+     */
+    idleAfterMs?: number;
 };
 /**
  * Page-wide agent presence for co-browsing — the missing "all actors present"
@@ -469,7 +531,7 @@ type CoBrowseCursorLayerProps = {
  * Mount it once near the app root (e.g. in your CoBrowseProvider), gated on an
  * active session. SSR-safe: renders null on the server / until the first action.
  */
-declare function CoBrowseCursorLayer({ active, zIndex }: CoBrowseCursorLayerProps): react.ReactPortal | null;
+declare function CoBrowseCursorLayer({ active, zIndex, idleAfterMs, }: CoBrowseCursorLayerProps): react.ReactPortal | null;
 declare namespace CoBrowseCursorLayer {
     var displayName: string;
 }
@@ -504,4 +566,4 @@ type SimulateUsersButtonProps = {
  */
 declare function SimulateUsersButton({ endpoint, count, label, csrfToken, onTriggered, onError, className, style, }: SimulateUsersButtonProps): react.JSX.Element;
 
-export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, Bridge, BridgedForm, type BridgedFormProps, CoBrowseCursorLayer, type CoBrowseCursorLayerProps, CoBrowsePresence, type CoBrowsePresenceProps, type CoBrowseSession, type CoBrowseUserEvent, FormFieldDescriptor, MicroMcpServer, type NavigationBridgeAdapter, type NavigationBridgeOptions, type NavigationConfirmRequest, type PageAction, type PageSnapshot, RelayState, ScreensActivityBridge, type ScreensActivityBridgeProps, SessionDescriptor, ShareControls, type ShareControlsProps, SimulateUsersButton, type SimulateUsersButtonProps, ToolHost, type UseCoBrowseSessionOptions, buildAgentPrompt, registerNavigationBridge, useCoBrowseSession };
+export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, Bridge, BridgedForm, type BridgedFormProps, CoBrowseCursorLayer, type CoBrowseCursorLayerProps, CoBrowsePresence, type CoBrowsePresenceProps, type CoBrowseSession, type CoBrowseUserEvent, DocAdapter, FormFieldDescriptor, MicroMcpServer, type NavigationBridgeAdapter, type NavigationBridgeOptions, type NavigationConfirmRequest, type PageAction, type PageSnapshot, RelayState, SCREEN_TEXT_NODE_TYPE, type ScreenDocBridgeOptions, type ScreenDocNode, type ScreenDocOp, ScreensActivityBridge, type ScreensActivityBridgeProps, SessionDescriptor, ShareControls, type ShareControlsProps, SimulateUsersButton, type SimulateUsersButtonProps, ToolHost, type UseCoBrowseSessionOptions, buildAgentPrompt, registerNavigationBridge, registerScreenDocBridge, useCoBrowseSession };

package/dist/index.d.ts

@@ -24,8 +24,10 @@ export { TerminalBridge, TerminalBridgeAdapter, TerminalBridgeOptions, TerminalR
 export { CatalogBridgeAdapter, CatalogBridgeOptions, CatalogCheckoutArgs, CatalogPrice, CatalogProduct, registerCatalogBridge } from './bridges/catalog.js';
 export { FeatureDefinition, FeatureGrant, FeaturesBridgeAdapter, FeaturesBridgeOptions, registerFeaturesBridge } from './bridges/features.js';
 export { PASSKEY_BRIDGE_TOOLS, PasskeyBridgeAdapter, PasskeyBridgeOptions, PasskeyProposal, PasskeySummaryLike, PasskeySupport, PasskeySurfaceState, registerPasskeyBridge } from './bridges/passkeys.js';
-export { DocAdapter, DocBridgeOptions, DocOpTool, registerDocBridge } from './bridges/doc.js';
+import { DocAdapter } from './bridges/doc.js';
+export { DocBridgeOptions, DocOpTool, registerDocBridge } from './bridges/doc.js';
 export { CmsBridgeOptions, CmsOp, cmsReducer, registerCmsBridge } from './bridges/cms.js';
+import { DocNode, StagePolicy, TreeOp } from '@particle-academy/fancy-doc-commons';
 import { RelayState } from './sharing/index.js';
 export { SseRelayOptions, SseRelayTransport, attachSseRelay } from './sharing/index.js';
 import { S as SessionDescriptor } from './token-BZ8doMam.js';
@@ -40,7 +42,6 @@ export { CLAUDE_CONNECTORS_URL, CONNECTOR_GLYPHS, CONNECTOR_TARGETS, ClaudeMark,
 export { D as DEFAULT_MCPB_ENTRY_POINT, b as MCPB_MANIFEST_VERSION, c as MCPB_MIN_NODE, M as McpbManifestInput, a as McpbTool, d as buildMcpbManifest, e as buildMcpbProxyStub } from './mcpb-BXOrsRnv.js';
 import '@particle-academy/fancy-sheets';
 import '@particle-academy/fancy-slides';
-import '@particle-academy/fancy-doc-commons';
 
 /**
  * One interactive element the agent can act on, addressed by a STABLE handle
@@ -159,6 +160,46 @@ type NavigationBridgeOptions = {
  */
 declare function registerNavigationBridge(host: ToolHost, options: NavigationBridgeOptions): Bridge;
 
+/**
+ * Reserved node type for a literal string child. Must match fancy-screens'
+ * `TEXT_NODE_TYPE`; duplicated rather than imported to keep this bridge free of
+ * a fancy-screens dependency.
+ */
+declare const SCREEN_TEXT_NODE_TYPE = "#text";
+/** A screen document node — a `DocNode` plus the minted-id flag. */
+interface ScreenDocNode extends DocNode {
+    /**
+     * True when fancy-screens minted this id because the author supplied none.
+     * A synthetic id is derived from position, so it is not a durable handle.
+     */
+    synthetic?: boolean;
+}
+type ScreenDocOp = TreeOp<ScreenDocNode>;
+interface ScreenDocBridgeOptions {
+    adapter: DocAdapter<ScreenDocNode>;
+    /**
+     * Tool-name prefix. Default `"screen"` → `screen_add`, `screen_set_text`, …
+     *
+     * Tool names are global, so a host wiring more than one doc-driven screen at
+     * once must give each a distinct prefix (`"screen_checkout"`).
+     */
+    surface?: string;
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+    /** Auto-apply vs. confirm per op (trust-but-verify). Default: auto. */
+    stagePolicy?: StagePolicy<ScreenDocOp>;
+    onPending?: (staged: {
+        id: string;
+        op: ScreenDocOp;
+        label: string;
+    }) => void;
+}
+/** Register the screen-content bridge (prefix `screen_`) over a screen's `DocTree`. */
+declare function registerScreenDocBridge(host: ToolHost, options: ScreenDocBridgeOptions): Bridge;
+
 /** A thing the human did, surfaced so the connected agent stays aware. */
 type CoBrowseUserEvent = {
     kind: "navigation";
@@ -213,6 +254,18 @@ type CoBrowseSession = {
     server: MicroMcpServer | null;
     session: SessionDescriptor | null;
     relayState: RelayState;
+    /**
+     * True once at least one remote agent is actually attached to the session.
+     *
+     * Distinct from `relayState === "open"`, which only says the BROWSER reached
+     * the relay — true the moment sharing starts, before the link has been handed
+     * to anyone. A UI that keys "Agent is driving" off the relay state therefore
+     * announces a driver who does not exist, and stays silent when a real one
+     * arrives.
+     */
+    agentConnected: boolean;
+    /** How many remote agents are attached (0 when nobody has joined). */
+    agentCount: number;
     startShare: () => Promise<void>;
     stopShare: () => void;
     /**
@@ -440,8 +493,8 @@ type CoBrowsePresenceProps = {
 };
 /**
  * The human's view of a site-wide co-browsing session: a "Let an agent drive"
- * starter, the share/connect surface once started, a live "agent is driving"
- * status with the latest action, and a Stop / take-back-control button.
+ * starter, the share/connect surface until an agent arrives, a live log of what
+ * it is doing once one has, and a Stop / take-back-control button.
  *
  * Staged-action confirms are rendered by the HOST (via the navigation adapter's
  * `confirm`), so this component stays presentation-only.
@@ -456,6 +509,15 @@ type CoBrowseCursorLayerProps = {
     active?: boolean;
     /** Stacking order of the overlay. Default just under the max. */
     zIndex?: number;
+    /**
+     * Retire the cursor after this long without a tool call. Default 15s;
+     * `0` keeps it on screen indefinitely.
+     *
+     * A cursor that sits still is not neutral — it reads as "the agent is
+     * broken", which is worse than showing nothing. Continuous presence belongs
+     * in the activity log; the cursor is for *motion*.
+     */
+    idleAfterMs?: number;
 };
 /**
  * Page-wide agent presence for co-browsing — the missing "all actors present"
@@ -469,7 +531,7 @@ type CoBrowseCursorLayerProps = {
  * Mount it once near the app root (e.g. in your CoBrowseProvider), gated on an
  * active session. SSR-safe: renders null on the server / until the first action.
  */
-declare function CoBrowseCursorLayer({ active, zIndex }: CoBrowseCursorLayerProps): react.ReactPortal | null;
+declare function CoBrowseCursorLayer({ active, zIndex, idleAfterMs, }: CoBrowseCursorLayerProps): react.ReactPortal | null;
 declare namespace CoBrowseCursorLayer {
     var displayName: string;
 }
@@ -504,4 +566,4 @@ type SimulateUsersButtonProps = {
  */
 declare function SimulateUsersButton({ endpoint, count, label, csrfToken, onTriggered, onError, className, style, }: SimulateUsersButtonProps): react.JSX.Element;
 
-export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, Bridge, BridgedForm, type BridgedFormProps, CoBrowseCursorLayer, type CoBrowseCursorLayerProps, CoBrowsePresence, type CoBrowsePresenceProps, type CoBrowseSession, type CoBrowseUserEvent, FormFieldDescriptor, MicroMcpServer, type NavigationBridgeAdapter, type NavigationBridgeOptions, type NavigationConfirmRequest, type PageAction, type PageSnapshot, RelayState, ScreensActivityBridge, type ScreensActivityBridgeProps, SessionDescriptor, ShareControls, type ShareControlsProps, SimulateUsersButton, type SimulateUsersButtonProps, ToolHost, type UseCoBrowseSessionOptions, buildAgentPrompt, registerNavigationBridge, useCoBrowseSession };
+export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, Bridge, BridgedForm, type BridgedFormProps, CoBrowseCursorLayer, type CoBrowseCursorLayerProps, CoBrowsePresence, type CoBrowsePresenceProps, type CoBrowseSession, type CoBrowseUserEvent, DocAdapter, FormFieldDescriptor, MicroMcpServer, type NavigationBridgeAdapter, type NavigationBridgeOptions, type NavigationConfirmRequest, type PageAction, type PageSnapshot, RelayState, SCREEN_TEXT_NODE_TYPE, type ScreenDocBridgeOptions, type ScreenDocNode, type ScreenDocOp, ScreensActivityBridge, type ScreensActivityBridgeProps, SessionDescriptor, ShareControls, type ShareControlsProps, SimulateUsersButton, type SimulateUsersButtonProps, ToolHost, type UseCoBrowseSessionOptions, buildAgentPrompt, registerNavigationBridge, registerScreenDocBridge, useCoBrowseSession };

package/dist/index.js

@@ -2,18 +2,19 @@ export { useSheetsActivityHighlights, useSheetsAdapter } from './chunk-KHKSQEMC.
 import { ConnectorButtons } from './chunk-5HNTNIWY.js';
 export { CLAUDE_CONNECTORS_URL, CONNECTOR_GLYPHS, CONNECTOR_TARGETS, ClaudeMark, ConnectorButtons, CursorMark, DesktopMark, VscodeMark, WrenchMark, buildCursorDeeplink, buildManualConfig, buildManualConfigSnippet, buildVscodeDeeplink, connectorHref, encodeBase64Json, slugifyServerName } from './chunk-5HNTNIWY.js';
 export { DEFAULT_MCPB_ENTRY_POINT, MCPB_MANIFEST_VERSION, MCPB_MIN_NODE, buildMcpbManifest, buildMcpbProxyStub } from './chunk-GO2Y6H6U.js';
-import { ShareControls, AgentActivityHighlight, AgentCursor } from './chunk-SJTLTITO.js';
-export { AgentActivityHighlight, AgentCursor, AgentPanel, ShareControls, buildAgentPrompt } from './chunk-SJTLTITO.js';
+import { ShareControls, AgentActivityHighlight, AgentCursor } from './chunk-ABP2THQV.js';
+export { AgentActivityHighlight, AgentCursor, AgentPanel, ShareControls, buildAgentPrompt } from './chunk-ABP2THQV.js';
 import './chunk-IJ6JX5VC.js';
-import { createSessionDescriptor, attachSseRelay } from './chunk-N6RLSLOF.js';
-export { SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './chunk-N6RLSLOF.js';
+import { createSessionDescriptor, attachSseRelay } from './chunk-JDCB2NMM.js';
+export { SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './chunk-JDCB2NMM.js';
 export { attachHeuristicsSink, mapActivityToEvent as mapActivityToHeuristicsEvent } from './chunk-7R6RMROL.js';
 export { useUndoStack } from './chunk-BT7HM5I6.js';
 export { registerCatalogBridge } from './chunk-OAFJ53X3.js';
 export { registerFeaturesBridge } from './chunk-ZNGTC4CO.js';
 export { PASSKEY_BRIDGE_TOOLS, registerPasskeyBridge } from './chunk-7THGQUX3.js';
-export { cmsReducer, registerCmsBridge } from './chunk-DKSR4R4O.js';
-export { registerDocBridge } from './chunk-LQZKRBWR.js';
+export { cmsReducer, registerCmsBridge } from './chunk-JJUABMAP.js';
+import { registerDocBridge } from './chunk-XY2TDE6E.js';
+export { registerDocBridge } from './chunk-XY2TDE6E.js';
 export { registerTuiBridge } from './chunk-MFMBR6LN.js';
 import { useAgentActivity } from './chunk-UCKJAUBY.js';
 export { useAgentActivity, useAgentActivityForScreen } from './chunk-UCKJAUBY.js';
@@ -39,8 +40,9 @@ import { wrapToolWithActivity } from './chunk-2VENWGLZ.js';
 export { wrapToolWithActivity } from './chunk-2VENWGLZ.js';
 import { emitActivity, onActivity } from './chunk-C3TYI5TJ.js';
 export { emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from './chunk-C3TYI5TJ.js';
-import { MicroMcpServer, textResult, errorResult } from './chunk-DF3PLL2E.js';
+import { textResult, MicroMcpServer, errorResult } from './chunk-DF3PLL2E.js';
 export { MCP_PROTOCOL_VERSION, MicroMcpServer, ToolRegistry, errorResult, rpcError, textResult } from './chunk-DF3PLL2E.js';
+import { childrenOf, appendOrder } from '@particle-academy/fancy-doc-commons';
 import { useRef, useState, useEffect, useCallback, useMemo } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { createPortal } from 'react-dom';
@@ -308,6 +310,90 @@ function registerNavigationBridge(host, options) {
     }
   };
 }
+var SCREEN_TEXT_NODE_TYPE = "#text";
+function registerScreenDocBridge(host, options) {
+  const { adapter } = options;
+  const surface = options.surface ?? "screen";
+  const setText = {
+    verb: "set_text",
+    description: "Replace the literal text of an element node \u2014 the natural way to change a label, heading or paragraph. Pass the ELEMENT's id, not the text node's.",
+    properties: {
+      id: { type: "string", description: "Id of the element whose text to set." },
+      text: { type: "string" }
+    },
+    required: ["id", "text"],
+    build: (args, tree) => {
+      const id = String(args.id);
+      const node = tree.nodes[id];
+      if (!node) return { error: `No node ${id}` };
+      if (node.type === SCREEN_TEXT_NODE_TYPE) {
+        return { t: "set_props", id, patch: { value: String(args.text) } };
+      }
+      const texts = childrenOf(tree, id).filter((c) => c.type === SCREEN_TEXT_NODE_TYPE);
+      if (texts.length === 1) {
+        return { t: "set_props", id: texts[0].id, patch: { value: String(args.text) } };
+      }
+      if (texts.length === 0) {
+        return {
+          t: "insert",
+          node: {
+            id: `${id}-text`,
+            type: SCREEN_TEXT_NODE_TYPE,
+            parent: id,
+            order: appendOrder(tree, id),
+            props: { value: String(args.text) }
+          }
+        };
+      }
+      return {
+        error: `Node ${id} has ${texts.length} text children (${texts.map((t) => t.id).join(", ")}) \u2014 set_text on the one you mean`
+      };
+    },
+    targetId: (args) => String(args.id)
+  };
+  const bridge = registerDocBridge(host, {
+    adapter,
+    surface,
+    agent: options.agent,
+    stagePolicy: options.stagePolicy,
+    onPending: options.onPending,
+    // Anything the AGENT adds is authored by definition — it chose or was given
+    // the id — so it must not inherit the synthetic flag from its neighbours.
+    makeNode: ({ id, type, parent, order }, props) => ({ id, type, parent, order, props }),
+    describeNode: (n) => ({
+      id: n.id,
+      type: n.type,
+      parent: n.parent,
+      ...n.synthetic ? { synthetic: true } : {},
+      ...n.type === SCREEN_TEXT_NODE_TYPE ? { text: String(n.props?.value ?? "") } : { props: Object.keys(n.props ?? {}) }
+    }),
+    opTools: [setText]
+  });
+  const disposeAddressable = host.registerTool(
+    {
+      name: `${surface}_addressable`,
+      description: "List the node ids that are safe to remember and use later. Ids NOT listed here were minted from a node's position: they resolve today and silently point at a different node once a sibling is inserted above them. Address those in the same turn you read them, and never store one.",
+      inputSchema: { type: "object", properties: {}, required: [], additionalProperties: false }
+    },
+    (async () => {
+      const nodes = Object.values(adapter.get().nodes);
+      const authored = nodes.filter((n) => !n.synthetic).map((n) => ({ id: n.id, type: n.type }));
+      const syntheticCount = nodes.length - authored.length;
+      return textResult(
+        authored.length ? `${authored.length} addressable, ${syntheticCount} positional` : `no addressable ids \u2014 all ${syntheticCount} nodes are positional`,
+        { addressable: authored, syntheticCount }
+      );
+    })
+  );
+  return {
+    id: surface,
+    title: "Screen content",
+    dispose: () => {
+      disposeAddressable();
+      bridge.dispose();
+    }
+  };
+}
 var DEFAULT_AGENT2 = { id: "agent", name: "Agent", color: "#a855f7" };
 var USER = { id: "human", name: "You" };
 function useCoBrowseSession(options) {
@@ -320,6 +406,7 @@ function useCoBrowseSession(options) {
   const disposeBridge = useRef(null);
   const [session, setSession] = useState(null);
   const [relayState, setRelayState] = useState("idle");
+  const [agentCount, setAgentCount] = useState(0);
   useEffect(() => {
     const server = new MicroMcpServer({
       info: options.info ?? { name: "fancy-co-browse", version: "0.1.0" },
@@ -354,6 +441,7 @@ function useCoBrowseSession(options) {
     }
     const relay = attachSseRelay(server, { baseUrl: relayBaseUrl, sessionId: descriptor.id, token: descriptor.token });
     relay.onStateChange(setRelayState);
+    relay.onPeersChange(setAgentCount);
     relayRef.current = relay;
     setSession(descriptor);
   }, [relayBaseUrl, options]);
@@ -362,6 +450,7 @@ function useCoBrowseSession(options) {
     relayRef.current?.close();
     relayRef.current = null;
     setRelayState("idle");
+    setAgentCount(0);
     setSession(null);
     if (current) {
       const csrf = options.csrfToken?.() ?? "";
@@ -384,7 +473,16 @@ function useCoBrowseSession(options) {
       meta: event
     });
   }, []);
-  return { server: serverRef.current, session, relayState, startShare, stopShare, observeUser };
+  return {
+    server: serverRef.current,
+    session,
+    relayState,
+    agentConnected: agentCount > 0,
+    agentCount,
+    startShare,
+    stopShare,
+    observeUser
+  };
 }
 function BridgedForm({
   id,
@@ -478,10 +576,12 @@ function ScreensActivityBridge({ system, fadeMs = 1500 }) {
   }, [system, fadeMs]);
   return null;
 }
+var LIFECYCLE_ACTIONS = /* @__PURE__ */ new Set(["agent_connected", "agent_disconnected"]);
 function CoBrowsePresence({ session, connectUrl, shareBaseUrl, className }) {
   const { events } = useAgentActivity(void 0, { capacity: 40 });
-  const lastAgentAction = [...events].reverse().find((e) => (e.source ?? "agent") !== "user");
-  const connected = session.relayState === "open";
+  const lastAgentAction = [...events].reverse().find((e) => (e.source ?? "agent") !== "user" && !LIFECYCLE_ACTIONS.has(e.action));
+  const connected = session.agentConnected;
+  const activity = useMemo(() => events.map(toPanelActivity), [events]);
   if (!session.session) {
     return /* @__PURE__ */ jsx("div", { className, "data-co-browse-presence": "idle", children: /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void session.startShare(), "data-co-browse-start": true, children: "Let an agent drive" }) });
   }
@@ -499,12 +599,25 @@ function CoBrowsePresence({ session, connectUrl, shareBaseUrl, className }) {
         onStart: () => void session.startShare(),
         onStop: session.stopShare,
         status: session.relayState,
+        agentConnected: connected,
+        activity,
         shareBaseUrl
       }
     ),
     connectUrl && /* @__PURE__ */ jsx(ConnectorButtons, { serverName: "Fancy UI co-browse", mcpUrl: connectUrl })
   ] });
 }
+function toPanelActivity(event) {
+  const who = (event.source ?? "agent") === "user" ? "You" : event.agentName ?? "Agent";
+  return {
+    id: `${event.timestamp}-${event.action}-${event.target?.elementId ?? event.target?.label ?? ""}`,
+    at: event.timestamp,
+    kind: LIFECYCLE_ACTIONS.has(event.action) ? "info" : "tool",
+    source: who,
+    text: event.target?.label ?? event.action,
+    detail: event.meta
+  };
+}
 CoBrowsePresence.displayName = "CoBrowsePresence";
 var CURSOR_EDGE_INSET = 24;
 var FLUID_CURSOR_SPEED_PX_PER_SECOND = 1050;
@@ -523,19 +636,26 @@ function fluidGlideDuration(from, to) {
   const distance = Math.hypot(to.x - from.x, to.y - from.y);
   return Math.round(Math.min(MAX_GLIDE_MS, Math.max(MIN_GLIDE_MS, distance / FLUID_CURSOR_SPEED_PX_PER_SECOND * 1e3)));
 }
-function CoBrowseCursorLayer({ active = true, zIndex = 2147483e3 }) {
+var LIFECYCLE_ACTIONS2 = /* @__PURE__ */ new Set(["agent_connected", "agent_disconnected"]);
+function CoBrowseCursorLayer({
+  active = true,
+  zIndex = 2147483e3,
+  idleAfterMs = 15e3
+}) {
   const { latest } = useAgentActivity(void 0, { capacity: 12 });
   const [cursor, setCursor] = useState(
     null
   );
   const [pulse, setPulse] = useState(null);
+  const [lastActionAt, setLastActionAt] = useState(0);
   useEffect(() => {
     if (!latest || (latest.source ?? "agent") === "user") return;
-    if (latest.action === "agent_disconnected") {
-      setCursor((prev) => prev ? { ...prev, status: "Standing by", glideMs: 0 } : prev);
+    if (LIFECYCLE_ACTIONS2.has(latest.action)) {
+      setCursor((prev) => prev ? { ...prev, status: "Standing by", glideMs: 0 } : null);
       setPulse(null);
       return;
     }
+    setLastActionAt(latest.timestamp);
     const color = latest.agentColor ?? "#a855f7";
     const name = latest.agentName ?? "Agent";
     const status = latest.target?.label ?? latest.action;
@@ -557,6 +677,14 @@ function CoBrowseCursorLayer({ active = true, zIndex = 2147483e3 }) {
       );
     }
   }, [latest?.timestamp]);
+  useEffect(() => {
+    if (!idleAfterMs || !lastActionAt) return;
+    const timer = setTimeout(() => {
+      setCursor(null);
+      setPulse(null);
+    }, idleAfterMs);
+    return () => clearTimeout(timer);
+  }, [lastActionAt, idleAfterMs]);
   if (!active || !cursor || typeof document === "undefined") return null;
   return createPortal(
     /* @__PURE__ */ jsxs("div", { "data-co-browse-cursor-layer": "", style: { position: "fixed", inset: 0, pointerEvents: "none", zIndex }, children: [
@@ -660,6 +788,6 @@ function SimulateUsersButton({
   );
 }
 
-export { BridgedForm, CoBrowseCursorLayer, CoBrowsePresence, ScreensActivityBridge, SimulateUsersButton, registerNavigationBridge, useCoBrowseSession };
+export { BridgedForm, CoBrowseCursorLayer, CoBrowsePresence, SCREEN_TEXT_NODE_TYPE, ScreensActivityBridge, SimulateUsersButton, registerNavigationBridge, registerScreenDocBridge, useCoBrowseSession };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map