@particle-academy/agent-integrations 0.47.1 → 0.48.0

package/CHANGELOG.md

@@ -11,6 +11,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.48.0] - 2026-10-24
+
+### Added
+
+- **Scoped screen-content bridge:** import `registerScreenDocBridge`,
+  `SCREEN_TEXT_NODE_TYPE`, `DocAdapter`, `ScreenDocBridgeOptions`, `ScreenDocNode`
+  and `ScreenDocOp` from `@particle-academy/agent-integrations/bridges/screen-doc`.
+  Both ESM and CommonJS builds include their type declarations. This complements
+  `bridges/screens`, which navigates between screens rather than editing their
+  contents. **Nothing to do: the root import still works.** The other 22 bridge
+  modules already have scoped exports; no additional missing entry was found.
+- Built-package coverage for every discovered bridge: Node loads all scoped
+  entries through both ESM and CommonJS, and TypeScript checks ESM/CommonJS
+  declaration consumers. `npm test` builds fresh output first, so stale `dist`
+  files cannot hide a missing export.
+
+### Security
+
+- **Dev toolchain only — no runtime change, nothing for consumers to do.** The
+  lockfile now resolves `vite` 8.3.5 (was 8.2.2), whose bundled
+  `launch-editor` fixes GHSA-587h-7wmj-h5pm (HIGH, `fs.existsSync()` check
+  bypassable on Windows), GHSA-698v-4r3x-3vcv (`escapeCmdArgs()` omits `%`
+  escaping on Windows) and GHSA-r825-w8mm-5pxw (editor CLI flag
+  misinterpretation). `vite` is only reached through the test/dev toolchain
+  and the published package does not ship our lockfile, so the exposure was
+  this repo's own dev server.
+
 ## [0.47.1] - 2026-10-21
 
 **What to do — nothing, unless you call `DomNavigationAgent.read()` yourself**

package/README.md

@@ -87,12 +87,20 @@ Every bridge has a matching subpath if you'd rather import surgically:
 | charts              | `…/bridges/charts`                                     |
 | scene               | `…/bridges/scene`                                      |
 | screens             | `…/bridges/screens`                                    |
+| screen contents     | `…/bridges/screen-doc`                                 |
 | passkeys            | `…/bridges/passkeys`                                   |
 | sheets adapter hook | `…/sheets-adapter`                                     |
 | presence            | `…/presence`                                           |
 | undo                | `…/undo`                                               |
 | sharing             | `…/sharing`                                            |
 
+`registerScreensBridge` handles navigation between screens.
+`registerScreenDocBridge` edits the nodes inside one screen and exports its
+`DocAdapter`, `ScreenDocBridgeOptions`, `ScreenDocNode` and `ScreenDocOp` types
+from `@particle-academy/agent-integrations/bridges/screen-doc`. The existing
+root import still works; nothing to do for existing consumers. Use a distinct
+`surface` tool prefix for each concurrently bridged document.
+
 ## When you don't need an MCP server
 
 If your agent runs in the same JS process as the surfaces it drives (an embedded chat widget, an in-page worker, an SSR-time tool loop), you don't need any of MCP's JSON-RPC framing. Use **`ToolRegistry`** — a plain in-memory tool host that the bridges register against. Agents drive the surface with `host.callTool("sheet_set_cell", { … })` directly.

package/dist/bridges/screen-doc.d.cts

@@ -0,0 +1,47 @@
+import { T as ToolHost } from '../tool-host-D67N2a2h.cjs';
+import { B as Bridge } from '../types-DP5yQZQU.cjs';
+import { DocAdapter } from './doc.cjs';
+import { DocNode, StagePolicy, TreeOp } from '@particle-academy/fancy-doc-commons';
+import '../types-gzIpsUDE.cjs';
+
+/**
+ * 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;
+
+export { DocAdapter, SCREEN_TEXT_NODE_TYPE, type ScreenDocBridgeOptions, type ScreenDocNode, type ScreenDocOp, registerScreenDocBridge };

package/dist/bridges/screen-doc.d.ts

@@ -0,0 +1,47 @@
+import { T as ToolHost } from '../tool-host-LYfdPE8u.js';
+import { B as Bridge } from '../types-VX_9je7w.js';
+import { DocAdapter } from './doc.js';
+import { DocNode, StagePolicy, TreeOp } from '@particle-academy/fancy-doc-commons';
+import '../types-gzIpsUDE.js';
+
+/**
+ * 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;
+
+export { DocAdapter, SCREEN_TEXT_NODE_TYPE, type ScreenDocBridgeOptions, type ScreenDocNode, type ScreenDocOp, registerScreenDocBridge };

package/dist/bridges-screen-doc.cjs

@@ -0,0 +1,465 @@
+'use strict';
+
+var fancyAutoCommon = require('@particle-academy/fancy-auto-common');
+var fancyDocCommons = require('@particle-academy/fancy-doc-commons');
+
+// src/mcp/server.ts
+function textResult(text, structured) {
+  return {
+    content: [{ type: "text", text }],
+    ...structured !== void 0 ? { structuredContent: structured } : {}
+  };
+}
+function errorResult(text) {
+  return { content: [{ type: "text", text }], isError: true };
+}
+
+// src/presence/wrap-tool-with-activity.ts
+function wrapToolWithActivity(handler, options) {
+  return async (args) => {
+    const result = await handler(args);
+    if (result.isError) return result;
+    let target;
+    if (options.resolveTarget) {
+      target = options.resolveTarget({ toolName: options.toolName, args, result });
+    } else {
+      target = { kind: options.kind, screenId: options.screenId };
+    }
+    if (!target) return result;
+    fancyAutoCommon.emitActivity({
+      agentId: options.agent.id,
+      agentName: options.agent.name,
+      agentColor: options.agent.color,
+      target: { ...target, kind: target.kind ?? options.kind, screenId: target.screenId ?? options.screenId },
+      action: options.toolName,
+      timestamp: Date.now(),
+      meta: options.buildMeta ? options.buildMeta(result) : extractMeta(result),
+      ttlMs: options.ttlMs
+    });
+    return result;
+  };
+}
+function extractMeta(result) {
+  const sc = result.structuredContent;
+  if (sc && typeof sc === "object" && !Array.isArray(sc)) {
+    return sc;
+  }
+  return void 0;
+}
+
+// src/undo/undo-tools.ts
+var installedHosts = /* @__PURE__ */ new WeakSet();
+function ensureUndoToolsRegistered(host, options = {}) {
+  if (installedHosts.has(host)) return;
+  installedHosts.add(host);
+  registerUndoTools(host, options);
+}
+function registerUndoTools(host, options = {}) {
+  const defaultAgent = options.defaultAgentId ?? "agent";
+  const disposers = [];
+  const agentOf = (args) => typeof args?.agentId === "string" ? args.agentId : defaultAgent;
+  disposers.push(
+    host.registerTool(
+      {
+        name: "agent_undo",
+        description: "Undo the most recent action on the agent's stack. Optional agentId targets a specific agent.",
+        inputSchema: {
+          type: "object",
+          properties: { agentId: { type: "string" } },
+          additionalProperties: false
+        }
+      },
+      async (args) => {
+        const entry = await fancyAutoCommon.undoOne(agentOf(args));
+        if (!entry) return errorResult("Nothing to undo.");
+        return textResult(`Undid: ${entry.label}`, { entry: serialize(entry) });
+      }
+    )
+  );
+  disposers.push(
+    host.registerTool(
+      {
+        name: "agent_redo",
+        description: "Redo the most recently undone action.",
+        inputSchema: {
+          type: "object",
+          properties: { agentId: { type: "string" } },
+          additionalProperties: false
+        }
+      },
+      async (args) => {
+        const entry = await fancyAutoCommon.redoOne(agentOf(args));
+        if (!entry) return errorResult("Nothing to redo.");
+        return textResult(`Redid: ${entry.label}`, { entry: serialize(entry) });
+      }
+    )
+  );
+  disposers.push(
+    host.registerTool(
+      {
+        name: "agent_history",
+        description: "List the agent's undo stack (oldest first). Useful for understanding what's reversible.",
+        inputSchema: {
+          type: "object",
+          properties: { agentId: { type: "string" } },
+          additionalProperties: false
+        }
+      },
+      async (args) => {
+        const history = fancyAutoCommon.readHistory(agentOf(args)).map(serialize);
+        const text = history.map((e) => `${new Date(e.timestamp).toISOString()} ${e.bridgeId} ${e.action}: ${e.label}`).join("\n");
+        return textResult(text || "(empty)", history);
+      }
+    )
+  );
+  return () => disposers.forEach((d) => d());
+}
+function serialize(entry) {
+  return {
+    timestamp: entry.timestamp,
+    bridgeId: entry.bridgeId,
+    action: entry.action,
+    label: entry.label
+  };
+}
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerDocBridge(host, options) {
+  const { adapter, surface } = options;
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const reducer = options.reducer ?? fancyDocCommons.treeReducer();
+  const stage = options.stagePolicy ?? fancyDocCommons.autoApply;
+  const makeNode = options.makeNode ?? (({ id, type, parent, order }, props) => ({ id, type, parent, order, props }));
+  const describeNode = options.describeNode ?? ((n) => ({ id: n.id, type: n.type, parent: n.parent, props: Object.keys(n.props ?? {}) }));
+  const disposers = [];
+  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
+  let idSeq = 0;
+  const mintId = () => {
+    if (adapter.newId) return adapter.newId();
+    const taken = adapter.get().nodes;
+    let id;
+    do
+      id = `${surface}-${idSeq += 1}`;
+    while (taken[id]);
+    return id;
+  };
+  const target = (elementId) => ({ kind: surface, screenId: adapter.screenId, elementId });
+  const pending = /* @__PURE__ */ new Map();
+  function commit(op, label, targetId) {
+    const prev = adapter.get();
+    const next = reducer.reduce(prev, op);
+    adapter.set(next);
+    fancyAutoCommon.pushUndoEntry(agent.id, {
+      timestamp: Date.now(),
+      bridgeId: surface,
+      action: label,
+      label,
+      undo: () => adapter.set(prev),
+      redo: () => adapter.set(next)
+    });
+    return { ok: true, id: targetId };
+  }
+  function submit(op, label, targetId) {
+    if (stage(op) === "confirm") {
+      const pendingId = `${surface}-pending-${idSeq += 1}`;
+      pending.set(pendingId, { op, label, targetId });
+      options.onPending?.({ id: pendingId, op, label });
+      return { staged: true, id: targetId, pendingId };
+    }
+    commit(op, label, targetId);
+    return { staged: false, id: targetId };
+  }
+  const reg = (verb, description, properties, required, handler, isMutation, resolveTarget) => {
+    const name = `${surface}_${verb}`;
+    const wrapped = async (args) => {
+      try {
+        const { _text, ...structured } = await handler(args);
+        return textResult(typeof _text === "string" ? _text : name, structured);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = isMutation ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent,
+      kind: surface,
+      screenId: adapter.screenId,
+      resolveTarget: ({ args, result }) => {
+        if (result.structuredContent?.staged) return null;
+        return resolveTarget?.(args, result.structuredContent ?? {}) ?? target();
+      }
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
+        final
+      )
+    );
+  };
+  reg(
+    "describe",
+    `Summarize the ${surface} document: node count, roots, and the active surface. Call before reading or writing.`,
+    {},
+    [],
+    () => {
+      const tree = adapter.get();
+      const ids = Object.keys(tree.nodes);
+      return { nodeCount: ids.length, roots: fancyDocCommons.childrenOf(tree, null).map((n) => n.id), _text: `${ids.length} nodes` };
+    },
+    false
+  );
+  reg(
+    "get",
+    `Get the whole ${surface} document tree as JSON.`,
+    {},
+    [],
+    () => ({ tree: adapter.get(), _text: "full tree" }),
+    false
+  );
+  reg(
+    "list",
+    "List nodes (optionally the children of `parent`), in order.",
+    { parent: { type: ["string", "null"], description: "Parent id, or null/omitted for roots." } },
+    [],
+    (args) => {
+      const tree = adapter.get();
+      const parent = typeof args.parent === "string" ? args.parent : null;
+      return { nodes: fancyDocCommons.childrenOf(tree, parent).map(describeNode), _text: `children of ${parent ?? "root"}` };
+    },
+    false
+  );
+  reg(
+    "get_node",
+    "Get one node by id.",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      const node = adapter.get().nodes[String(args.id)];
+      if (!node) throw new Error(`No node ${args.id}`);
+      return { node, _text: `node ${node.id}` };
+    },
+    false
+  );
+  reg(
+    "add",
+    "Insert a node. Returns its id. Appends under `parent` (or roots) unless `order` is given.",
+    {
+      type: { type: "string", description: "Node type discriminant." },
+      parent: { type: ["string", "null"], description: "Parent id, or null for a root." },
+      props: { type: "object", description: "JSON props bag." },
+      order: { type: "string", description: "Fractional order key (default: append)." },
+      id: {
+        type: "string",
+        description: "Id for the new node. Supply a meaningful one if you intend to address this node later; omitted means one is minted for you. Must not already exist."
+      }
+    },
+    ["type"],
+    (args) => {
+      const tree = adapter.get();
+      const parent = typeof args.parent === "string" ? args.parent : null;
+      const requested = typeof args.id === "string" ? args.id : void 0;
+      if (requested !== void 0 && tree.nodes[requested]) {
+        throw new Error(`Node ${requested} already exists \u2014 pick a different id or update it instead`);
+      }
+      const id = requested ?? mintId();
+      const order = typeof args.order === "string" ? args.order : fancyDocCommons.appendOrder(tree, parent);
+      const props = args.props && typeof args.props === "object" ? args.props : {};
+      const node = makeNode({ id, type: String(args.type), parent, order }, props);
+      const res = submit({ t: "insert", node }, `add ${args.type} ${id}`, id);
+      return { ...res, _text: res.staged ? `staged add ${id} \u2014 confirm ${res.pendingId}` : `added ${id}` };
+    },
+    true,
+    (_args, result) => target(result.id)
+  );
+  reg(
+    "update",
+    "Merge a props patch into a node.",
+    { id: { type: "string" }, patch: { type: "object" } },
+    ["id", "patch"],
+    (args) => {
+      const id = String(args.id);
+      if (!adapter.get().nodes[id]) throw new Error(`No node ${id}`);
+      const patch = args.patch && typeof args.patch === "object" ? args.patch : {};
+      const res = submit({ t: "set_props", id, patch }, `update ${id}`, id);
+      return { ...res, id, _text: res.staged ? `staged update ${id} \u2014 confirm ${res.pendingId}` : `updated ${id}` };
+    },
+    true,
+    (args) => target(String(args.id))
+  );
+  reg(
+    "remove",
+    "Remove a node and its subtree.",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      const id = String(args.id);
+      const tree = adapter.get();
+      if (!tree.nodes[id]) throw new Error(`No node ${id}`);
+      const count = fancyDocCommons.descendantsOf(tree, id).length + 1;
+      const res = submit({ t: "remove", id }, `remove ${id} (${count} node${count === 1 ? "" : "s"})`, id);
+      return { ...res, id, removed: count, _text: res.staged ? `staged remove ${id} \u2014 confirm ${res.pendingId}` : `removed ${id}` };
+    },
+    true,
+    (args) => target(String(args.id))
+  );
+  reg(
+    "move",
+    "Reparent + reorder a node.",
+    { id: { type: "string" }, parent: { type: ["string", "null"] }, order: { type: "string", description: "Fractional order key (default: append under the new parent)." } },
+    ["id"],
+    (args) => {
+      const id = String(args.id);
+      const tree = adapter.get();
+      if (!tree.nodes[id]) throw new Error(`No node ${id}`);
+      const parent = args.parent === null ? null : typeof args.parent === "string" ? args.parent : tree.nodes[id].parent;
+      const order = typeof args.order === "string" ? args.order : fancyDocCommons.appendOrder(tree, parent);
+      const res = submit({ t: "move", id, parent, order }, `move ${id}`, id);
+      return { ...res, id, _text: res.staged ? `staged move ${id} \u2014 confirm ${res.pendingId}` : `moved ${id}` };
+    },
+    true,
+    (args) => target(String(args.id))
+  );
+  for (const t of options.opTools ?? []) {
+    reg(
+      t.verb,
+      t.description,
+      t.properties,
+      t.required,
+      (args) => {
+        const built = t.build(args, adapter.get());
+        if (built && typeof built === "object" && "error" in built) throw new Error(built.error);
+        const tid = t.targetId?.(args);
+        const res = submit(built, `${t.verb} ${tid ?? ""}`.trim(), tid);
+        return { ...res, id: tid, _text: res.staged ? `staged ${t.verb} \u2014 confirm ${res.pendingId}` : t.verb };
+      },
+      true,
+      (args) => target(t.targetId?.(args))
+    );
+  }
+  reg(
+    "confirm",
+    "Apply a staged op. Pass the `pendingId` a staged mutation returned \u2014 not the node `id` it also returns.",
+    { id: { type: "string", description: "The `pendingId` from a staged mutation." } },
+    ["id"],
+    (args) => {
+      const id = String(args.id);
+      const p = pending.get(id);
+      if (!p) throw new Error(`No pending op ${id}`);
+      pending.delete(id);
+      commit(p.op, p.label, p.targetId);
+      return { ok: true, applied: p.label, id: p.targetId, _text: `applied ${p.label}` };
+    },
+    true,
+    (_args, result) => target(result.id)
+  );
+  reg(
+    "reject",
+    "Discard a staged op. Pass the `pendingId` a staged mutation returned \u2014 not the node `id` it also returns.",
+    { id: { type: "string", description: "The `pendingId` from a staged mutation." } },
+    ["id"],
+    (args) => {
+      const id = String(args.id);
+      const p = pending.get(id);
+      if (!p) throw new Error(`No pending op ${id}`);
+      pending.delete(id);
+      return { ok: true, rejected: p.label, _text: `rejected ${p.label}` };
+    },
+    false
+  );
+  return {
+    id: surface,
+    title: surface,
+    dispose: () => {
+      for (const d of disposers) d();
+      pending.clear();
+    }
+  };
+}
+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 = fancyDocCommons.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: fancyDocCommons.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();
+    }
+  };
+}
+
+exports.SCREEN_TEXT_NODE_TYPE = SCREEN_TEXT_NODE_TYPE;
+exports.registerScreenDocBridge = registerScreenDocBridge;
+//# sourceMappingURL=bridges-screen-doc.cjs.map
+//# sourceMappingURL=bridges-screen-doc.cjs.map