@particle-academy/agent-integrations 0.40.0 → 0.42.0

package/dist/index.d.cts

@@ -1,13 +1,13 @@
-import { M as MicroMcpServer } from './server-DDD3IZ56.cjs';
-export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-DDD3IZ56.cjs';
-import { T as ToolHost } from './tool-host-EuYHYSSH.cjs';
-export { a as ToolRegistry } from './tool-host-EuYHYSSH.cjs';
+import { M as MicroMcpServer } from './server-BJNF7pQe.cjs';
+export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-BJNF7pQe.cjs';
+import { T as ToolHost } from './tool-host-BpEBqf5u.cjs';
+export { a as ToolRegistry } from './tool-host-BpEBqf5u.cjs';
 export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.cjs';
 export { C as CallToolResult, d as ContentBlock, I as InitializeResult, J as JsonObject, b as JsonRpcMessage, e as JsonRpcNotification, f as JsonRpcRequest, g as JsonValue, M as MCP_PROTOCOL_VERSION, a as ServerCapabilities, S as ServerInfo, h as ToolCallContext, T as ToolDefinition, c as ToolHandler } from './types-C58ZXs4K.cjs';
 export { HumanPlusDisposition, HumanPlusEvent, HumanPlusEventPage, HumanPlusEventQuery, HumanPlusEventStore, MemoryHumanPlusEventStore, NewHumanPlusEvent } from './human-plus/index.cjs';
 export { TuiBridgeOptions, TuiSurfaceRegistryLike, registerTuiBridge } from './bridges/tui.cjs';
-import { B as Bridge } from './types-NFGP769G.cjs';
-export { a as BridgeFactory } from './types-NFGP769G.cjs';
+import { B as Bridge } from './types-C4NaIW6B.cjs';
+export { a as BridgeFactory } from './types-C4NaIW6B.cjs';
 import { FormFieldDescriptor } from './bridges/forms.cjs';
 export { FormBridgeAdapter, FormBridgeOptions, registerFormBridge } from './bridges/forms.cjs';
 export { SheetsBridgeAdapter, SheetsBridgeOptions, registerSheetsBridge } from './bridges/sheets.cjs';
@@ -202,6 +202,63 @@ interface ScreenDocBridgeOptions {
 /** Register the screen-content bridge (prefix `screen_`) over a screen's `DocTree`. */
 declare function registerScreenDocBridge(host: ToolHost, options: ScreenDocBridgeOptions): Bridge;
 
+/**
+ * A page's contribution to the shared tool surface.
+ *
+ * Return the disposer that withdraws it — typically the `Bridge`'s own
+ * `dispose`, or the function `registerTool` returns. Returning nothing is
+ * allowed (the original `extraBridges` was typed that way) but means the
+ * contribution can never be withdrawn.
+ */
+type BridgeContribution = (server: MicroMcpServer) => (() => void) | void;
+/**
+ * The registry behind **"site tools always; page tools while mounted"**.
+ *
+ * `useCoBrowseSession` already had an `extraBridges` hook and already called it.
+ * What that shape could not express is a tool surface that CHANGES under the
+ * agent mid-session, because the callback is invoked exactly once while the
+ * server is being built:
+ *
+ *   - a page that mounts later never gets a chance to contribute;
+ *   - a page that unmounts cannot withdraw, so the agent keeps a tool aimed at
+ *     a surface that is gone and only finds out by calling it.
+ *
+ * Both are silent. Nothing errors; the agent just never sees the tools, or sees
+ * dead ones. So contributions live in a registry that is applied when a server
+ * appears, re-applied if it is replaced, and withdrawn when the page unmounts —
+ * rather than a callback captured at construction.
+ *
+ * Withdrawal needs no notification machinery of its own: a bridge's disposer
+ * unregisters its tools, `ToolRegistry` fires `onToolsChanged`, and
+ * `MicroMcpServer` broadcasts `notifications/tools/list_changed`. That was
+ * verified before this was written — a grep for `unregisterTool` reads as
+ * "nothing unregisters", which is a false negative, because bridges use the
+ * disposer `registerTool` returns.
+ */
+declare class BridgeContributions {
+    private readonly contributions;
+    private readonly applied;
+    private server;
+    /**
+     * Contribute bridges for as long as the returned disposer is uncalled.
+     *
+     * Applies immediately when a server is already live, and is held for the next
+     * one otherwise — so a page need not know whether sharing has started.
+     */
+    add(contribute: BridgeContribution): () => void;
+    /** Attach a server and apply every live contribution to it. */
+    bind(server: MicroMcpServer): void;
+    /**
+     * Detach the current server, withdrawing what was applied to it. Contributions
+     * themselves are KEPT: a session can be stopped and restarted under a page
+     * that never unmounted, and its tools must come back rather than silently
+     * vanish.
+     */
+    unbind(): void;
+    private apply;
+    private withdraw;
+}
+
 /** A thing the human did, surfaced so the connected agent stays aware. */
 type CoBrowseUserEvent = {
     kind: "navigation";
@@ -256,7 +313,15 @@ type UseCoBrowseSessionOptions = {
         version: string;
         instructions?: string;
     };
-    /** Register extra bridges (forms/screens/…) on the same server. */
+    /**
+     * Register extra bridges (forms/screens/…) on the same server, once, at
+     * construction.
+     *
+     * For a surface that comes and goes with navigation use
+     * {@link CoBrowseSession.contributeBridges} instead: this callback fires
+     * exactly once while the server is built, so a page mounted afterwards can
+     * never contribute through it, and one that unmounts can never withdraw.
+     */
     extraBridges?: (server: MicroMcpServer) => void;
     /** CSRF token for the relay register/unregister POSTs. */
     csrfToken?: () => string | null | undefined;
@@ -265,6 +330,21 @@ type UseCoBrowseSessionOptions = {
 };
 type CoBrowseSession = {
     server: MicroMcpServer | null;
+    /**
+     * Contribute bridges for as long as the returned disposer is uncalled —
+     * "site tools always; page tools while mounted".
+     *
+     * Call it from a page's mount effect and return its disposer:
+     *
+     * ```tsx
+     * useEffect(() => contributeBridges((server) =>
+     *   registerArtboardBridge(server, { adapter }).dispose), []);
+     * ```
+     *
+     * Safe to call before sharing starts — the contribution is applied to the
+     * server as soon as one exists, and re-applied if the session is restarted.
+     */
+    contributeBridges: (contribute: BridgeContribution) => () => void;
     session: SessionDescriptor | null;
     relayState: RelayState;
     /**
@@ -596,4 +676,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, 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 };
+export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, Bridge, type BridgeContribution, BridgeContributions, 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

@@ -1,13 +1,13 @@
-import { M as MicroMcpServer } from './server-CDX643Kz.js';
-export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-CDX643Kz.js';
-import { T as ToolHost } from './tool-host-CWTOJEm2.js';
-export { a as ToolRegistry } from './tool-host-CWTOJEm2.js';
+import { M as MicroMcpServer } from './server-Dt97UxuD.js';
+export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-Dt97UxuD.js';
+import { T as ToolHost } from './tool-host-xY5F-eqG.js';
+export { a as ToolRegistry } from './tool-host-xY5F-eqG.js';
 export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.js';
 export { C as CallToolResult, d as ContentBlock, I as InitializeResult, J as JsonObject, b as JsonRpcMessage, e as JsonRpcNotification, f as JsonRpcRequest, g as JsonValue, M as MCP_PROTOCOL_VERSION, a as ServerCapabilities, S as ServerInfo, h as ToolCallContext, T as ToolDefinition, c as ToolHandler } from './types-C58ZXs4K.js';
 export { HumanPlusDisposition, HumanPlusEvent, HumanPlusEventPage, HumanPlusEventQuery, HumanPlusEventStore, MemoryHumanPlusEventStore, NewHumanPlusEvent } from './human-plus/index.js';
 export { TuiBridgeOptions, TuiSurfaceRegistryLike, registerTuiBridge } from './bridges/tui.js';
-import { B as Bridge } from './types-BKD6uf86.js';
-export { a as BridgeFactory } from './types-BKD6uf86.js';
+import { B as Bridge } from './types-DSwsNTBG.js';
+export { a as BridgeFactory } from './types-DSwsNTBG.js';
 import { FormFieldDescriptor } from './bridges/forms.js';
 export { FormBridgeAdapter, FormBridgeOptions, registerFormBridge } from './bridges/forms.js';
 export { SheetsBridgeAdapter, SheetsBridgeOptions, registerSheetsBridge } from './bridges/sheets.js';
@@ -202,6 +202,63 @@ interface ScreenDocBridgeOptions {
 /** Register the screen-content bridge (prefix `screen_`) over a screen's `DocTree`. */
 declare function registerScreenDocBridge(host: ToolHost, options: ScreenDocBridgeOptions): Bridge;
 
+/**
+ * A page's contribution to the shared tool surface.
+ *
+ * Return the disposer that withdraws it — typically the `Bridge`'s own
+ * `dispose`, or the function `registerTool` returns. Returning nothing is
+ * allowed (the original `extraBridges` was typed that way) but means the
+ * contribution can never be withdrawn.
+ */
+type BridgeContribution = (server: MicroMcpServer) => (() => void) | void;
+/**
+ * The registry behind **"site tools always; page tools while mounted"**.
+ *
+ * `useCoBrowseSession` already had an `extraBridges` hook and already called it.
+ * What that shape could not express is a tool surface that CHANGES under the
+ * agent mid-session, because the callback is invoked exactly once while the
+ * server is being built:
+ *
+ *   - a page that mounts later never gets a chance to contribute;
+ *   - a page that unmounts cannot withdraw, so the agent keeps a tool aimed at
+ *     a surface that is gone and only finds out by calling it.
+ *
+ * Both are silent. Nothing errors; the agent just never sees the tools, or sees
+ * dead ones. So contributions live in a registry that is applied when a server
+ * appears, re-applied if it is replaced, and withdrawn when the page unmounts —
+ * rather than a callback captured at construction.
+ *
+ * Withdrawal needs no notification machinery of its own: a bridge's disposer
+ * unregisters its tools, `ToolRegistry` fires `onToolsChanged`, and
+ * `MicroMcpServer` broadcasts `notifications/tools/list_changed`. That was
+ * verified before this was written — a grep for `unregisterTool` reads as
+ * "nothing unregisters", which is a false negative, because bridges use the
+ * disposer `registerTool` returns.
+ */
+declare class BridgeContributions {
+    private readonly contributions;
+    private readonly applied;
+    private server;
+    /**
+     * Contribute bridges for as long as the returned disposer is uncalled.
+     *
+     * Applies immediately when a server is already live, and is held for the next
+     * one otherwise — so a page need not know whether sharing has started.
+     */
+    add(contribute: BridgeContribution): () => void;
+    /** Attach a server and apply every live contribution to it. */
+    bind(server: MicroMcpServer): void;
+    /**
+     * Detach the current server, withdrawing what was applied to it. Contributions
+     * themselves are KEPT: a session can be stopped and restarted under a page
+     * that never unmounted, and its tools must come back rather than silently
+     * vanish.
+     */
+    unbind(): void;
+    private apply;
+    private withdraw;
+}
+
 /** A thing the human did, surfaced so the connected agent stays aware. */
 type CoBrowseUserEvent = {
     kind: "navigation";
@@ -256,7 +313,15 @@ type UseCoBrowseSessionOptions = {
         version: string;
         instructions?: string;
     };
-    /** Register extra bridges (forms/screens/…) on the same server. */
+    /**
+     * Register extra bridges (forms/screens/…) on the same server, once, at
+     * construction.
+     *
+     * For a surface that comes and goes with navigation use
+     * {@link CoBrowseSession.contributeBridges} instead: this callback fires
+     * exactly once while the server is built, so a page mounted afterwards can
+     * never contribute through it, and one that unmounts can never withdraw.
+     */
     extraBridges?: (server: MicroMcpServer) => void;
     /** CSRF token for the relay register/unregister POSTs. */
     csrfToken?: () => string | null | undefined;
@@ -265,6 +330,21 @@ type UseCoBrowseSessionOptions = {
 };
 type CoBrowseSession = {
     server: MicroMcpServer | null;
+    /**
+     * Contribute bridges for as long as the returned disposer is uncalled —
+     * "site tools always; page tools while mounted".
+     *
+     * Call it from a page's mount effect and return its disposer:
+     *
+     * ```tsx
+     * useEffect(() => contributeBridges((server) =>
+     *   registerArtboardBridge(server, { adapter }).dispose), []);
+     * ```
+     *
+     * Safe to call before sharing starts — the contribution is applied to the
+     * server as soon as one exists, and re-applied if the session is restarted.
+     */
+    contributeBridges: (contribute: BridgeContribution) => () => void;
     session: SessionDescriptor | null;
     relayState: RelayState;
     /**
@@ -596,4 +676,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, 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 };
+export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, Bridge, type BridgeContribution, BridgeContributions, 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

@@ -1,4 +1,4 @@
-export { useUndoStack } from './chunk-BT7HM5I6.js';
+export { useUndoStack } from './chunk-WEXMZMJH.js';
 export { useSheetsActivityHighlights, useSheetsAdapter } from './chunk-KHKSQEMC.js';
 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';
@@ -9,40 +9,40 @@ import './chunk-IJ6JX5VC.js';
 import { createSessionDescriptor, attachSseRelay } from './chunk-6TZ5IBRN.js';
 export { SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './chunk-6TZ5IBRN.js';
 export { attachHeuristicsSink, mapActivityToEvent as mapActivityToHeuristicsEvent } from './chunk-7R6RMROL.js';
-export { registerTerminalBridge } from './chunk-UZHNKUER.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-JJUABMAP.js';
-import { registerDocBridge } from './chunk-XY2TDE6E.js';
-export { registerDocBridge } from './chunk-XY2TDE6E.js';
-export { registerTuiBridge } from './chunk-MFMBR6LN.js';
+export { registerTerminalBridge } from './chunk-Z4L2GOAK.js';
+export { registerCatalogBridge } from './chunk-NKAH67JK.js';
+export { registerFeaturesBridge } from './chunk-NIFPRC7P.js';
+export { PASSKEY_BRIDGE_TOOLS, registerPasskeyBridge } from './chunk-LOD77NCD.js';
+export { cmsReducer, registerCmsBridge } from './chunk-NIXOY473.js';
+import { registerDocBridge } from './chunk-SXVRIIXW.js';
+export { registerDocBridge } from './chunk-SXVRIIXW.js';
+export { registerTuiBridge } from './chunk-E2I3YVKC.js';
 import { useAgentActivity } from './chunk-UCKJAUBY.js';
 export { useAgentActivity, useAgentActivityForScreen } from './chunk-UCKJAUBY.js';
 export { MemoryHumanPlusEventStore } from './chunk-PMI4C5S4.js';
-export { registerChartsBridge } from './chunk-G5EZNWXJ.js';
-export { registerGridBridge } from './chunk-MJ2S25ON.js';
-export { registerSceneBridge } from './chunk-CA7GIJJC.js';
-export { registerScreensBridge } from './chunk-6YUBWQTS.js';
-export { registerSlidesBridge } from './chunk-PR4SXFZH.js';
-export { registerMapBridge } from './chunk-BHQJJ2YG.js';
-export { registerGitBridge } from './chunk-4D3II37O.js';
-export { registerFilesBridge } from './chunk-A25E22WW.js';
+export { registerChartsBridge } from './chunk-5W6YOXLT.js';
+export { registerGridBridge } from './chunk-VJD3Y7E5.js';
+export { registerSceneBridge } from './chunk-7LLMILTM.js';
+export { registerScreensBridge } from './chunk-TEB5U6Y5.js';
+export { registerSlidesBridge } from './chunk-2Q4EGZHJ.js';
+export { registerMapBridge } from './chunk-MZ74LLDS.js';
+export { registerGitBridge } from './chunk-PUMQDV67.js';
+export { registerFilesBridge } from './chunk-N5VOPV64.js';
 export { RelayTransport, attachRelay } from './chunk-G6N2TQVO.js';
 import { attachInProcess } from './chunk-AFUULW5E.js';
 export { InProcessTransport, attachInProcess } from './chunk-AFUULW5E.js';
-import { registerFormBridge } from './chunk-USQGA672.js';
-export { registerFormBridge } from './chunk-USQGA672.js';
-export { registerSheetsBridge } from './chunk-WCKSDFTM.js';
-export { registerCodeBridge } from './chunk-RIXYCFDO.js';
-import { ensureUndoToolsRegistered, pushUndoEntry } from './chunk-CT3LRNH7.js';
-export { clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne } from './chunk-CT3LRNH7.js';
+import { registerFormBridge } from './chunk-EIBV76IB.js';
+export { registerFormBridge } from './chunk-EIBV76IB.js';
+export { registerSheetsBridge } from './chunk-GT63LSPJ.js';
+export { registerCodeBridge } from './chunk-PCFRBVKS.js';
+import { ensureUndoToolsRegistered, pushUndoEntry } from './chunk-HVDHT7DM.js';
+export { clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne } from './chunk-HVDHT7DM.js';
 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 { textResult, MicroMcpServer, errorResult } from './chunk-DF3PLL2E.js';
-export { MCP_PROTOCOL_VERSION, MicroMcpServer, ToolRegistry, errorResult, rpcError, textResult } from './chunk-DF3PLL2E.js';
+import { textResult, MicroMcpServer, errorResult } from './chunk-QJYRWEXD.js';
+export { MCP_PROTOCOL_VERSION, MicroMcpServer, ToolRegistry, errorResult, rpcError, textResult } from './chunk-QJYRWEXD.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';
@@ -395,6 +395,58 @@ function registerScreenDocBridge(host, options) {
     }
   };
 }
+
+// src/sharing/bridge-contributions.ts
+var BridgeContributions = class {
+  constructor() {
+    this.contributions = /* @__PURE__ */ new Map();
+    this.applied = /* @__PURE__ */ new Map();
+    this.server = null;
+  }
+  /**
+   * Contribute bridges for as long as the returned disposer is uncalled.
+   *
+   * Applies immediately when a server is already live, and is held for the next
+   * one otherwise — so a page need not know whether sharing has started.
+   */
+  add(contribute) {
+    const key = /* @__PURE__ */ Symbol("bridge-contribution");
+    this.contributions.set(key, contribute);
+    if (this.server) this.apply(key, contribute, this.server);
+    return () => {
+      this.contributions.delete(key);
+      this.withdraw(key);
+    };
+  }
+  /** Attach a server and apply every live contribution to it. */
+  bind(server) {
+    if (this.server === server) return;
+    if (this.server) this.unbind();
+    this.server = server;
+    for (const [key, contribute] of this.contributions) this.apply(key, contribute, server);
+  }
+  /**
+   * Detach the current server, withdrawing what was applied to it. Contributions
+   * themselves are KEPT: a session can be stopped and restarted under a page
+   * that never unmounted, and its tools must come back rather than silently
+   * vanish.
+   */
+  unbind() {
+    for (const key of [...this.applied.keys()]) this.withdraw(key);
+    this.server = null;
+  }
+  apply(key, contribute, server) {
+    const dispose = contribute(server);
+    if (typeof dispose === "function") this.applied.set(key, dispose);
+  }
+  withdraw(key) {
+    const dispose = this.applied.get(key);
+    this.applied.delete(key);
+    dispose?.();
+  }
+};
+
+// src/sharing/use-co-browse-session.ts
 var DEFAULT_AGENT2 = { id: "agent", name: "Agent", color: "#a855f7" };
 var USER = { id: "human", name: "You" };
 function useCoBrowseSession(options) {
@@ -402,6 +454,8 @@ function useCoBrowseSession(options) {
   const agent = { ...DEFAULT_AGENT2, ...options.agent ?? {} };
   const relayBaseUrl = options.relayBaseUrl ?? "/agent-relay";
   const serverRef = useRef(null);
+  const contributionsRef = useRef(null);
+  if (!contributionsRef.current) contributionsRef.current = new BridgeContributions();
   const relayRef = useRef(null);
   const detachInProc = useRef(null);
   const disposeBridge = useRef(null);
@@ -415,6 +469,7 @@ function useCoBrowseSession(options) {
     });
     const bridge = registerNavigationBridge(server, { adapter, agent, pendingMode: options.pendingMode });
     extraBridges?.(server);
+    contributionsRef.current.bind(server);
     const inProc = attachInProcess(server);
     detachInProc.current = () => inProc.close();
     disposeBridge.current = bridge.dispose;
@@ -422,6 +477,7 @@ function useCoBrowseSession(options) {
     return () => {
       relayRef.current?.close();
       relayRef.current = null;
+      contributionsRef.current.unbind();
       disposeBridge.current?.();
       detachInProc.current?.();
       serverRef.current = null;
@@ -480,8 +536,13 @@ function useCoBrowseSession(options) {
       meta: event
     });
   }, []);
+  const contributeBridges = useCallback(
+    (contribute) => contributionsRef.current.add(contribute),
+    []
+  );
   return {
     server: serverRef.current,
+    contributeBridges,
     session,
     relayState,
     agentConnected: agentCount > 0,
@@ -795,6 +856,6 @@ function SimulateUsersButton({
   );
 }
 
-export { BridgedForm, CoBrowseCursorLayer, CoBrowsePresence, SCREEN_TEXT_NODE_TYPE, ScreensActivityBridge, SimulateUsersButton, registerNavigationBridge, registerScreenDocBridge, useCoBrowseSession };
+export { BridgeContributions, BridgedForm, CoBrowseCursorLayer, CoBrowsePresence, SCREEN_TEXT_NODE_TYPE, ScreensActivityBridge, SimulateUsersButton, registerNavigationBridge, registerScreenDocBridge, useCoBrowseSession };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map