@particle-academy/agent-integrations 0.45.0 → 0.47.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Particle Academy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -20,15 +20,15 @@ import "@particle-academy/agent-integrations/styles.css";
 
 ## Which version range to depend on
 
-**Use a caret. `^0.42.0` is correct here, and it is deliberate.**
+**Use a caret. `^0.46.0` is correct here, and it is deliberate.**
 
 ```jsonc
-"@particle-academy/agent-integrations": "^0.42.0"
+"@particle-academy/agent-integrations": "^0.46.0"
 ```
 
 This package is **pre-1.0, and breaking changes land in MINOR releases** — see
 the note at the top of [`CHANGELOG.md`](./CHANGELOG.md). A caret on a `0.x` locks
-the minor (npm reads `^0.42.0` as `>=0.42.0 <0.43.0`), so it gives you patches and
+the minor (npm reads `^0.46.0` as `>=0.46.0 <0.47.0`), so it gives you patches and
 holds you at a surface you have already integrated against. That is the right
 default when the next minor may change something under you.
 
@@ -275,6 +275,47 @@ channel.listenForWhisper("mcp", (frame) => transport.deliverFromRemote(frame));
 
 Agents (Claude Desktop, Cline, custom) connect to the same channel via your auth bridge.
 
+## Drive a page you don't own — `./dom-navigation`
+
+`registerNavigationBridge` (`page_describe`, `page_read`, `page_click`,
+`page_set_field`, `nav_visit`, …) needs an adapter that walks the page's DOM.
+`./dom-navigation` ships that walker framework-free, in two halves:
+
+- **In the page:** `createDomNavigationAgent()` — stable handles
+  (`data-co-handle` → `name` → `id` → `role#index`), ARIA names, masking of
+  sensitive values (password, `cc-*`, `one-time-code`, `data-private`), field
+  writes that React-controlled inputs see, and rects. When your code does not
+  run in the page, inject `DOM_NAVIGATION_SCRIPT` from `./dom-navigation/script`
+  instead: a self-contained IIFE (no module system) that installs
+  `globalThis.__fancyDomNavigation`. Re-injecting is a no-op.
+- **In the host:** `createRemoteNavigationAdapter({ transport })` — a
+  `NavigationBridgeAdapter` over any `{ call(method, args): Promise<unknown> }`.
+  Results from the page are coerced to the declared shapes; the page is hostile.
+
+Electron, with the walker in an isolated world so the page cannot reach it:
+
+```ts
+import { DOM_NAVIGATION_SCRIPT } from "@particle-academy/agent-integrations/dom-navigation/script";
+import { createRemoteNavigationAdapter, domNavigationCallScript } from "@particle-academy/agent-integrations/dom-navigation";
+import { registerNavigationBridge } from "@particle-academy/agent-integrations/bridges/navigation";
+
+const WORLD = 1001;
+const wc = view.webContents;
+const inject = () => wc.executeJavaScriptInIsolatedWorld(WORLD, [{ code: DOM_NAVIGATION_SCRIPT }]);
+wc.on("dom-ready", inject); // every document needs its own copy
+
+const adapter = createRemoteNavigationAdapter({
+  transport: {
+    call: (method, args) =>
+      wc.executeJavaScriptInIsolatedWorld(WORLD, [{ code: domNavigationCallScript(method, args) }]),
+  },
+  confirm: (req) => askTheHuman(req), // without this, submits + destructive clicks are NOT staged
+});
+registerNavigationBridge(server, { adapter });
+```
+
+Adapter methods may now return promises; the bridge awaits every call.
+
 ## Tools shipped (whiteboard bridge)
 
 | Tool | Purpose |
@@ -323,9 +364,16 @@ to you:
   `confirm` argument that would apply it (revoking the last passkey is a lockout).
   `passkey_list` re-projects onto the public summary fields, so handing it your
   ORM model cannot leak a public key, a user handle, or a signature counter.
-- **The relay fans tool results + activity to all peers.** The terminal bridge
-  redacts raw command bytes from broadcast meta, but any `structuredContent` you
-  return is visible to every connected peer — don't return secrets.
+- **Activity reaches every peer; tool results reach the caller only if clients
+  label themselves.** Since 0.44.0 a reply goes only to the client that asked
+  when clients send a `client` query parameter; unlabelled clients still get
+  every frame. Notifications are always broadcast. The terminal bridge redacts
+  raw command bytes from broadcast meta, but treat anything you return as
+  visible to every holder of the token — don't return secrets.
+- **The relay serves SSE and long-poll.** Behind Cloudflare (whose HTTP/3 edge
+  resets long SSE streams) install `@particle-academy/fancy-cf-relay` so the
+  browser polls; see `docs/relay-server.md`. Pass `--cors` a list of your
+  sites' origins rather than leaving `*` on a public relay.
 
 ## Status
 

package/dist/bridges/artboard.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 /**
  * Transport-level JSON shapes. These intentionally mirror fancy-artboard's

package/dist/bridges/artboard.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 /**
  * Transport-level JSON shapes. These intentionally mirror fancy-artboard's

package/dist/bridges/catalog.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 /**
  * Headless bridge for `@particle-academy/fancy-catalog` — a Stripe catalog with

package/dist/bridges/catalog.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 /**
  * Headless bridge for `@particle-academy/fancy-catalog` — a Stripe catalog with

package/dist/bridges/charts.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 /**
  * Adapter wires a single fancy-echarts chart to the bridge. Charts are

package/dist/bridges/charts.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 /**
  * Adapter wires a single fancy-echarts chart to the bridge. Charts are

package/dist/bridges/cms.d.cts

@@ -1,8 +1,8 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
 import { DocAdapter } from './doc.cjs';
 import { StyledNode, StagePolicy, TreeOp, StyleProps, LayoutMode, DocReducer, DocTree } from '@particle-academy/fancy-doc-commons';
-import '../types-C2DtnHIn.cjs';
+import '../types-gzIpsUDE.cjs';
 
 /**
  * registerCmsBridge — the greenfield CMS agent bridge, built entirely on

package/dist/bridges/cms.d.ts

@@ -1,8 +1,8 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
 import { DocAdapter } from './doc.js';
 import { StyledNode, StagePolicy, TreeOp, StyleProps, LayoutMode, DocReducer, DocTree } from '@particle-academy/fancy-doc-commons';
-import '../types-C2DtnHIn.js';
+import '../types-gzIpsUDE.js';
 
 /**
  * registerCmsBridge — the greenfield CMS agent bridge, built entirely on

package/dist/bridges/code.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 /**
  * Adapter the host wires to a fancy-code CodeEditor (typically via the

package/dist/bridges/code.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 /**
  * Adapter the host wires to a fancy-code CodeEditor (typically via the

package/dist/bridges/doc.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { J as JsonObject } from '../types-C2DtnHIn.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { J as JsonObject } from '../types-gzIpsUDE.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
 import { DocNode, DocTree, TreeOp, DocReducer, StagePolicy } from '@particle-academy/fancy-doc-commons';
 
 /** Host-provided access to the document tree. */

package/dist/bridges/doc.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { J as JsonObject } from '../types-C2DtnHIn.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { J as JsonObject } from '../types-gzIpsUDE.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
 import { DocNode, DocTree, TreeOp, DocReducer, StagePolicy } from '@particle-academy/fancy-doc-commons';
 
 /** Host-provided access to the document tree. */

package/dist/bridges/features.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 /**
  * Headless bridge for `@particle-academy/fancy-features` — feature management

package/dist/bridges/features.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 /**
  * Headless bridge for `@particle-academy/fancy-features` — feature management

package/dist/bridges/files.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 type FileKind = "file" | "dir";
 type FileEntry = {

package/dist/bridges/files.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 type FileKind = "file" | "dir";
 type FileEntry = {

package/dist/bridges/flow.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 type FlowNode = {
     id: string;

package/dist/bridges/flow.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 type FlowNode = {
     id: string;

package/dist/bridges/forms.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 /**
  * Field descriptor — what the host says about each form field. Mirrors the

package/dist/bridges/forms.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 /**
  * Field descriptor — what the host says about each form field. Mirrors the

package/dist/bridges/git.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 type GitProposal = {
     operation: string;

package/dist/bridges/git.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 type GitProposal = {
     operation: string;

package/dist/bridges/grid.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 /**
  * Loose grid types — the public state shape of `@particle-academy/fancy-grid`,

package/dist/bridges/grid.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 /**
  * Loose grid types — the public state shape of `@particle-academy/fancy-grid`,

package/dist/bridges/map.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-LVBgCN5m.cjs';
-import { B as Bridge } from '../types-EcElKOlk.cjs';
-import '../types-C2DtnHIn.cjs';
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
 
 type LatLng = {
     lat: number;

package/dist/bridges/map.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-Wo0pkY83.js';
-import { B as Bridge } from '../types-BxNRKSVd.js';
-import '../types-C2DtnHIn.js';
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import '../types-gzIpsUDE.js';
 
 type LatLng = {
     lat: number;

package/dist/bridges/navigation.d.cts

@@ -0,0 +1,127 @@
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import '../types-gzIpsUDE.cjs';
+
+/**
+ * One interactive element the agent can act on, addressed by a STABLE handle
+ * (not a CSS selector) so the agent drives the page the Human+ way — never DOM
+ * scraping. The host builds these in `describe()` (data-co-handle → name/id →
+ * ARIA role + accessible name).
+ */
+type PageAction = {
+    /** Stable, opaque handle the agent passes back to act on this element. */
+    handle: string;
+    /** ARIA-ish role: "link" | "button" | "textbox" | "checkbox" | "select" | … */
+    role: string;
+    /** Accessible name / label. */
+    label: string;
+    /** Current value for inputs (omitted/masked for sensitive fields). */
+    value?: unknown;
+    /** True when activating this is destructive / submits (agent should stage). */
+    destructive?: boolean;
+};
+/** The page as the agent sees it: where it is + what it can do. */
+type PageSnapshot = {
+    url: string;
+    title: string;
+    actions: PageAction[];
+    /** Monotonic host revision. Human input advances it and invalidates stale agent intent. */
+    revision?: number;
+};
+/** A write the host may want the human to confirm (trust-but-verify). */
+type NavigationConfirmRequest = {
+    action: "submit" | "click";
+    handle: string;
+    label: string;
+};
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Host-provided adapter. In the sandbox this is backed by Inertia's `router` +
+ * the DOM walker from `@particle-academy/agent-integrations/dom-navigation`.
+ * Every method works on stable handles, never raw selectors.
+ *
+ * Any method may return a Promise: a host driving a page it does not run in
+ * (an Electron WebContentsView, via `createRemoteNavigationAdapter`) can only
+ * answer asynchronously. The bridge awaits every call.
+ */
+type NavigationBridgeAdapter = {
+    /** Optional fancy-screens screen id for presence targeting. */
+    screenId?: string;
+    /** Current location. */
+    getLocation: () => MaybePromise<{
+        url: string;
+        title: string;
+    }>;
+    /** Current human-control revision. Omit to disable stale-intent protection. */
+    getRevision?: () => MaybePromise<number>;
+    /** Snapshot of the page's actionable elements (stable handles + labels). */
+    describe: () => MaybePromise<PageSnapshot>;
+    /** Visible text / heading outline for grounding (optional). */
+    read?: () => MaybePromise<string>;
+    /** Navigate to a URL (host wires to router.visit). */
+    visit: (url: string) => void | Promise<void>;
+    back?: () => void | Promise<void>;
+    forward?: () => void | Promise<void>;
+    /** Scroll to coords or to a handle's element. */
+    scrollTo: (opts: {
+        x?: number;
+        y?: number;
+        handle?: string;
+    }) => void | Promise<void>;
+    scrollBy: (dy: number) => void | Promise<void>;
+    /** Set a field's value by handle (host dispatches input/change for React). */
+    setField: (handle: string, value: unknown) => MaybePromise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** Activate an element by handle. */
+    click: (handle: string) => MaybePromise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** Submit a form by handle. */
+    submit: (handle: string) => Promise<{
+        ok: boolean;
+        error?: string;
+    }> | {
+        ok: boolean;
+        error?: string;
+    };
+    /**
+     * Viewport rect of a handle's element, for agent-presence rendering (cursor +
+     * highlight). Returned in tool `meta.rect` so `<CoBrowseCursorLayer>` can show
+     * the agent acting on the page. Optional — omit and there's just no cursor.
+     */
+    rectFor?: (handle: string) => MaybePromise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
+    /**
+     * Trust-but-verify hook. When `pendingMode` is on, `page_submit` and
+     * destructive `page_click` route through this; the host shows a prompt and
+     * resolves true (proceed) / false (declined).
+     */
+    confirm?: (req: NavigationConfirmRequest) => Promise<boolean>;
+};
+type NavigationBridgeOptions = {
+    adapter: NavigationBridgeAdapter;
+    /** Identity tagged into activity events (so the human sees who's driving). */
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+    /** Route submit + destructive clicks through `adapter.confirm`. Default true. */
+    pendingMode?: boolean;
+};
+/**
+ * registerNavigationBridge — site-wide co-browsing. Lets a connected agent
+ * navigate, scroll, and (with staged confirm) fill + click any page, addressed
+ * by stable handles. Pairs with `useCoBrowseSession` (server + relay) and
+ * `<CoBrowsePresence>` (the human's view of the agent). The 12th Fancy bridge.
+ */
+declare function registerNavigationBridge(host: ToolHost, options: NavigationBridgeOptions): Bridge;
+
+export { type NavigationBridgeAdapter, type NavigationBridgeOptions, type NavigationConfirmRequest, type PageAction, type PageSnapshot, registerNavigationBridge };