@particle-academy/agent-integrations 0.34.0 → 0.36.0

package/dist/{chunk-LQZKRBWR.js → chunk-XY2TDE6E.js}

@@ -14,7 +14,15 @@ function registerDocBridge(host, options) {
   const disposers = [];
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   let idSeq = 0;
-  const mintId = () => adapter.newId?.() ?? `${surface}-${idSeq += 1}`;
+  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) {
@@ -33,10 +41,10 @@ function registerDocBridge(host, options) {
   }
   function submit(op, label, targetId) {
     if (stage(op) === "confirm") {
-      const id = `${surface}-pending-${idSeq += 1}`;
-      pending.set(id, { op, label, targetId });
-      options.onPending?.({ id, op, label });
-      return { staged: true, id };
+      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 };
@@ -119,18 +127,26 @@ function registerDocBridge(host, options) {
       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)." }
+      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 id = mintId();
+      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 : 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}` : `added ${id}` };
+      return { ...res, _text: res.staged ? `staged add ${id} \u2014 confirm ${res.pendingId}` : `added ${id}` };
     },
     true,
     (_args, result) => target(result.id)
@@ -145,7 +161,7 @@ function registerDocBridge(host, options) {
       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}` : `updated ${id}` };
+      return { ...res, id, _text: res.staged ? `staged update ${id} \u2014 confirm ${res.pendingId}` : `updated ${id}` };
     },
     true,
     (args) => target(String(args.id))
@@ -161,7 +177,7 @@ function registerDocBridge(host, options) {
       if (!tree.nodes[id]) throw new Error(`No node ${id}`);
       const count = 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}` : `removed ${id}` };
+      return { ...res, id, removed: count, _text: res.staged ? `staged remove ${id} \u2014 confirm ${res.pendingId}` : `removed ${id}` };
     },
     true,
     (args) => target(String(args.id))
@@ -178,7 +194,7 @@ function registerDocBridge(host, options) {
       const parent = args.parent === null ? null : typeof args.parent === "string" ? args.parent : tree.nodes[id].parent;
       const order = typeof args.order === "string" ? args.order : appendOrder(tree, parent);
       const res = submit({ t: "move", id, parent, order }, `move ${id}`, id);
-      return { ...res, id, _text: res.staged ? `staged move ${id}` : `moved ${id}` };
+      return { ...res, id, _text: res.staged ? `staged move ${id} \u2014 confirm ${res.pendingId}` : `moved ${id}` };
     },
     true,
     (args) => target(String(args.id))
@@ -194,7 +210,7 @@ function registerDocBridge(host, options) {
         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}` : t.verb };
+        return { ...res, id: tid, _text: res.staged ? `staged ${t.verb} \u2014 confirm ${res.pendingId}` : t.verb };
       },
       true,
       (args) => target(t.targetId?.(args))
@@ -202,8 +218,8 @@ function registerDocBridge(host, options) {
   }
   reg(
     "confirm",
-    "Apply a staged op by its pending id (from a staged mutation).",
-    { id: { type: "string" } },
+    "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);
@@ -218,8 +234,8 @@ function registerDocBridge(host, options) {
   );
   reg(
     "reject",
-    "Discard a staged op by its pending id.",
-    { id: { type: "string" } },
+    "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);
@@ -241,5 +257,5 @@ function registerDocBridge(host, options) {
 }
 
 export { registerDocBridge };
-//# sourceMappingURL=chunk-LQZKRBWR.js.map
-//# sourceMappingURL=chunk-LQZKRBWR.js.map
+//# sourceMappingURL=chunk-XY2TDE6E.js.map
+//# sourceMappingURL=chunk-XY2TDE6E.js.map

package/dist/chunk-XY2TDE6E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/doc.ts"],"names":[],"mappings":"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","file":"chunk-XY2TDE6E.js","sourcesContent":["/**\n * registerDocBridge — a GENERIC MCP bridge over a `@particle-academy/fancy-doc-commons`\n * `DocTree`. Give it an adapter (`{ get, set }`) and it generates, from the shared\n * op-spine, a full Human+ surface: uniform read tools + the canonical node op tools\n * (add / update / remove / move) under one verb lexicon, with **undo derived from\n * the reducer**, agent-activity broadcasts, unconditional `agent_undo/redo/history`,\n * and an optional **staged-write** (confirm / reject) channel — replacing the ~500-line\n * bespoke bridges (whiteboard/flow/artboard/…) with one builder. A surface adds its\n * domain ops (e.g. cms `set_style`) via `opTools` + a matching reducer.\n */\nimport { textResult, errorResult } from \"../mcp/server\";\nimport type { ToolHost } from \"../mcp/tool-host\";\nimport type { JsonObject } from \"../mcp/types\";\nimport type { Bridge } from \"./types\";\nimport { wrapToolWithActivity } from \"../presence/wrap-tool-with-activity\";\nimport type { AgentTarget } from \"../presence/types\";\nimport { pushUndoEntry } from \"../undo/undo-stack\";\nimport { ensureUndoToolsRegistered } from \"../undo/undo-tools\";\nimport {\n  treeReducer,\n  childrenOf,\n  descendantsOf,\n  appendOrder,\n  autoApply,\n  type DocTree,\n  type DocNode,\n  type TreeOp,\n  type DocReducer,\n  type StagePolicy,\n} from \"@particle-academy/fancy-doc-commons\";\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\n/** Host-provided access to the document tree. */\nexport interface DocAdapter<N extends DocNode> {\n  /** Read the current tree. */\n  get(): DocTree<N>;\n  /** Replace the tree — host wires this to its `onChange` / `setState`. */\n  set(next: DocTree<N>): void;\n  /** Optional fancy-screens screen id, for presence scoping. */\n  screenId?: string;\n  /** Mint a fresh, unique node id. Default: `<surface>-<n>`. */\n  newId?(): string;\n}\n\n/**\n * A domain op tool beyond the built-in add/update/remove/move — lets a surface\n * expose its own ops (e.g. cms `set_style`) through the same undo + activity path.\n */\nexport interface DocOpTool<N extends DocNode, TOp> {\n  /** Verb, prefixed with the surface (e.g. `set_style` → `cms_set_style`). */\n  verb: string;\n  description: string;\n  properties: Record<string, unknown>;\n  required: string[];\n  /** Build the op from the args (or return `{ error }`). */\n  build(args: JsonObject, tree: DocTree<N>): TOp | { error: string };\n  /** Node id this op targets (for the activity target + undo label). */\n  targetId?(args: JsonObject): string | undefined;\n}\n\nexport interface DocBridgeOptions<N extends DocNode, TOp = TreeOp<N>> {\n  adapter: DocAdapter<N>;\n  /** Tool-name prefix + activity kind (e.g. `\"cms\"` → `cms_add`, kind `\"cms\"`). */\n  surface: string;\n  agent?: { id: string; name?: string; color?: string };\n  /** Reducer for reduce + invert. Default: the substrate `treeReducer<N>()`. */\n  reducer?: DocReducer<DocTree<N>, TOp>;\n  /** Build a full node from the core fields + props (fill surface defaults, e.g. `style`). */\n  makeNode?: (core: { id: string; type: string; parent: string | null; order: string }, props: Record<string, unknown>) => N;\n  /** Domain op tools beyond the built-ins. */\n  opTools?: DocOpTool<N, TOp>[];\n  /** Decide auto-apply vs. confirm per op. Default: everything auto-applies. */\n  stagePolicy?: StagePolicy<TOp>;\n  /** Fired when an op is staged pending human confirmation. */\n  onPending?: (staged: { id: string; op: TOp; label: string }) => void;\n  /** Summarize a node for describe/list. Default: id/type/parent + prop keys. */\n  describeNode?: (node: N) => Record<string, unknown>;\n}\n\n/** Register the generic doc-surface bridge. Returns a {@link Bridge}. */\nexport function registerDocBridge<N extends DocNode, TOp = TreeOp<N>>(\n  host: ToolHost,\n  options: DocBridgeOptions<N, TOp>,\n): Bridge {\n  const { adapter, surface } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const reducer = (options.reducer ?? (treeReducer<N>() as unknown as DocReducer<DocTree<N>, TOp>));\n  const stage = options.stagePolicy ?? (autoApply as StagePolicy<TOp>);\n  const makeNode =\n    options.makeNode ?? (({ id, type, parent, order }, props) => ({ id, type, parent, order, props }) as N);\n  const describeNode =\n    options.describeNode ?? ((n: N) => ({ id: n.id, type: n.type, parent: n.parent, props: Object.keys(n.props ?? {}) }));\n  const disposers: Array<() => void> = [];\n\n  // agent_undo / agent_redo / agent_history — always present (undo derives from\n  // the reducer, so every doc surface gets working undo for free).\n  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });\n\n  let idSeq = 0;\n  // The counter restarts with the bridge, so on a tree loaded from elsewhere\n  // `surface-1` may well be taken. Skip past anything that already exists\n  // rather than minting an id that silently overwrites a node.\n  const mintId = () => {\n    if (adapter.newId) return adapter.newId();\n    const taken = adapter.get().nodes;\n    let id: string;\n    do id = `${surface}-${(idSeq += 1)}`;\n    while (taken[id]);\n    return id;\n  };\n  const target = (elementId?: string): AgentTarget => ({ kind: surface, screenId: adapter.screenId, elementId });\n\n  // Staged ops awaiting confirmation.\n  const pending = new Map<string, { op: TOp; label: string; targetId?: string }>();\n\n  /** Apply an op immediately: reduce → set → push a snapshot-based undo entry. */\n  function commit(op: TOp, label: string, targetId?: string): Record<string, unknown> {\n    const prev = adapter.get();\n    const next = reducer.reduce(prev, op);\n    adapter.set(next);\n    pushUndoEntry(agent.id, {\n      timestamp: Date.now(),\n      bridgeId: surface,\n      action: label,\n      label,\n      undo: () => adapter.set(prev),\n      redo: () => adapter.set(next),\n    });\n    return { ok: true, id: targetId };\n  }\n\n  /**\n   * Auto-apply, or stage for confirmation per the stage policy.\n   *\n   * The staged case reports the pending id under its OWN key. Returning it as\n   * `id` — as this used to — collided with the node id every mutation already\n   * reports, so `update`/`remove`/`move` overwrote it and left the agent holding\n   * a node id that `confirm` does not accept. The staged write was unconfirmable\n   * for three of the four canonical ops, and looked fine from the outside.\n   */\n  function submit(op: TOp, label: string, targetId?: string): { staged: boolean; id?: string; pendingId?: string } {\n    if (stage(op) === \"confirm\") {\n      const pendingId = `${surface}-pending-${(idSeq += 1)}`;\n      pending.set(pendingId, { op, label, targetId });\n      options.onPending?.({ id: pendingId, op, label });\n      return { staged: true, id: targetId, pendingId };\n    }\n    commit(op, label, targetId);\n    return { staged: false, id: targetId };\n  }\n\n  const reg = (\n    verb: string,\n    description: string,\n    properties: Record<string, unknown>,\n    required: string[],\n    handler: (args: JsonObject) => Record<string, unknown> | Promise<Record<string, unknown>>,\n    isMutation: boolean,\n    resolveTarget?: (args: JsonObject, result: Record<string, unknown>) => AgentTarget | null,\n  ): void => {\n    const name = `${surface}_${verb}`;\n    const wrapped = async (args: JsonObject) => {\n      try {\n        // `_text` is the human-facing line; the rest is structuredContent.\n        const { _text, ...structured } = await handler(args);\n        return textResult(typeof _text === \"string\" ? _text : name, structured);\n      } catch (e) {\n        return errorResult(e instanceof Error ? e.message : String(e));\n      }\n    };\n    const final = isMutation\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name,\n          agent,\n          kind: surface,\n          screenId: adapter.screenId,\n          resolveTarget: ({ args, result }) => {\n            if ((result.structuredContent as JsonObject | undefined)?.staged) return null;\n            return resolveTarget?.(args, (result.structuredContent as JsonObject) ?? {}) ?? target();\n          },\n        })\n      : wrapped;\n    disposers.push(\n      host.registerTool(\n        { name, description, inputSchema: { type: \"object\", properties: properties as never, required, additionalProperties: false } },\n        final as never,\n      ),\n    );\n  };\n\n  // ── Read tools ──────────────────────────────────────────────────────────\n  reg(\n    \"describe\",\n    `Summarize the ${surface} document: node count, roots, and the active surface. Call before reading or writing.`,\n    {},\n    [],\n    () => {\n      const tree = adapter.get();\n      const ids = Object.keys(tree.nodes);\n      return { nodeCount: ids.length, roots: childrenOf(tree, null).map((n) => n.id), _text: `${ids.length} nodes` };\n    },\n    false,\n  );\n  reg(\n    \"get\",\n    `Get the whole ${surface} document tree as JSON.`,\n    {},\n    [],\n    () => ({ tree: adapter.get(), _text: \"full tree\" }),\n    false,\n  );\n  reg(\n    \"list\",\n    \"List nodes (optionally the children of `parent`), in order.\",\n    { parent: { type: [\"string\", \"null\"], description: \"Parent id, or null/omitted for roots.\" } },\n    [],\n    (args) => {\n      const tree = adapter.get();\n      const parent = typeof args.parent === \"string\" ? args.parent : null;\n      return { nodes: childrenOf(tree, parent).map(describeNode), _text: `children of ${parent ?? \"root\"}` };\n    },\n    false,\n  );\n  reg(\n    \"get_node\",\n    \"Get one node by id.\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    (args) => {\n      const node = adapter.get().nodes[String(args.id)];\n      if (!node) throw new Error(`No node ${args.id}`);\n      return { node, _text: `node ${node.id}` };\n    },\n    false,\n  );\n\n  // ── Canonical op tools ──────────────────────────────────────────────────\n  reg(\n    \"add\",\n    \"Insert a node. Returns its id. Appends under `parent` (or roots) unless `order` is given.\",\n    {\n      type: { type: \"string\", description: \"Node type discriminant.\" },\n      parent: { type: [\"string\", \"null\"], description: \"Parent id, or null for a root.\" },\n      props: { type: \"object\", description: \"JSON props bag.\" },\n      order: { type: \"string\", description: \"Fractional order key (default: append).\" },\n      id: {\n        type: \"string\",\n        description:\n          \"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.\",\n      },\n    },\n    [\"type\"],\n    (args) => {\n      const tree = adapter.get();\n      const parent = typeof args.parent === \"string\" ? args.parent : null;\n      // An agent that names the node names the handle it will use afterwards.\n      // Minted ids are addressable too, just less memorable.\n      const requested = typeof args.id === \"string\" ? args.id : undefined;\n      if (requested !== undefined && tree.nodes[requested]) {\n        throw new Error(`Node ${requested} already exists — pick a different id or update it instead`);\n      }\n      const id = requested ?? mintId();\n      const order = typeof args.order === \"string\" ? args.order : appendOrder(tree, parent);\n      const props = (args.props && typeof args.props === \"object\" ? args.props : {}) as Record<string, unknown>;\n      const node = makeNode({ id, type: String(args.type), parent, order }, props);\n      const res = submit({ t: \"insert\", node } as unknown as TOp, `add ${args.type} ${id}`, id);\n      return { ...res, _text: res.staged ? `staged add ${id} — confirm ${res.pendingId}` : `added ${id}` };\n    },\n    true,\n    (_args, result) => target(result.id as string | undefined),\n  );\n  reg(\n    \"update\",\n    \"Merge a props patch into a node.\",\n    { id: { type: \"string\" }, patch: { type: \"object\" } },\n    [\"id\", \"patch\"],\n    (args) => {\n      const id = String(args.id);\n      if (!adapter.get().nodes[id]) throw new Error(`No node ${id}`);\n      const patch = (args.patch && typeof args.patch === \"object\" ? args.patch : {}) as Record<string, unknown>;\n      const res = submit({ t: \"set_props\", id, patch } as unknown as TOp, `update ${id}`, id);\n      return { ...res, id, _text: res.staged ? `staged update ${id} — confirm ${res.pendingId}` : `updated ${id}` };\n    },\n    true,\n    (args) => target(String(args.id)),\n  );\n  reg(\n    \"remove\",\n    \"Remove a node and its subtree.\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    (args) => {\n      const id = String(args.id);\n      const tree = adapter.get();\n      if (!tree.nodes[id]) throw new Error(`No node ${id}`);\n      const count = descendantsOf(tree, id).length + 1;\n      const res = submit({ t: \"remove\", id } as unknown as TOp, `remove ${id} (${count} node${count === 1 ? \"\" : \"s\"})`, id);\n      return { ...res, id, removed: count, _text: res.staged ? `staged remove ${id} — confirm ${res.pendingId}` : `removed ${id}` };\n    },\n    true,\n    (args) => target(String(args.id)),\n  );\n  reg(\n    \"move\",\n    \"Reparent + reorder a node.\",\n    { id: { type: \"string\" }, parent: { type: [\"string\", \"null\"] }, order: { type: \"string\", description: \"Fractional order key (default: append under the new parent).\" } },\n    [\"id\"],\n    (args) => {\n      const id = String(args.id);\n      const tree = adapter.get();\n      if (!tree.nodes[id]) throw new Error(`No node ${id}`);\n      const parent = args.parent === null ? null : typeof args.parent === \"string\" ? args.parent : tree.nodes[id]!.parent;\n      const order = typeof args.order === \"string\" ? args.order : appendOrder(tree, parent);\n      const res = submit({ t: \"move\", id, parent, order } as unknown as TOp, `move ${id}`, id);\n      return { ...res, id, _text: res.staged ? `staged move ${id} — confirm ${res.pendingId}` : `moved ${id}` };\n    },\n    true,\n    (args) => target(String(args.id)),\n  );\n\n  // ── Domain op tools ─────────────────────────────────────────────────────\n  for (const t of options.opTools ?? []) {\n    reg(\n      t.verb,\n      t.description,\n      t.properties,\n      t.required,\n      (args) => {\n        const built = t.build(args, adapter.get());\n        if (built && typeof built === \"object\" && \"error\" in built) throw new Error((built as { error: string }).error);\n        const tid = t.targetId?.(args);\n        const res = submit(built as TOp, `${t.verb} ${tid ?? \"\"}`.trim(), tid);\n        return { ...res, id: tid, _text: res.staged ? `staged ${t.verb} — confirm ${res.pendingId}` : t.verb };\n      },\n      true,\n      (args) => target(t.targetId?.(args)),\n    );\n  }\n\n  // ── Staged-write confirm / reject ───────────────────────────────────────\n  reg(\n    \"confirm\",\n    \"Apply a staged op. Pass the `pendingId` a staged mutation returned — not the node `id` it also returns.\",\n    { id: { type: \"string\", description: \"The `pendingId` from a staged mutation.\" } },\n    [\"id\"],\n    (args) => {\n      const id = String(args.id);\n      const p = pending.get(id);\n      if (!p) throw new Error(`No pending op ${id}`);\n      pending.delete(id);\n      commit(p.op, p.label, p.targetId);\n      return { ok: true, applied: p.label, id: p.targetId, _text: `applied ${p.label}` };\n    },\n    true,\n    (_args, result) => target(result.id as string | undefined),\n  );\n  reg(\n    \"reject\",\n    \"Discard a staged op. Pass the `pendingId` a staged mutation returned — not the node `id` it also returns.\",\n    { id: { type: \"string\", description: \"The `pendingId` from a staged mutation.\" } },\n    [\"id\"],\n    (args) => {\n      const id = String(args.id);\n      const p = pending.get(id);\n      if (!p) throw new Error(`No pending op ${id}`);\n      pending.delete(id);\n      return { ok: true, rejected: p.label, _text: `rejected ${p.label}` };\n    },\n    false,\n  );\n\n  return {\n    id: surface,\n    title: surface,\n    dispose: () => {\n      for (const d of disposers) d();\n      pending.clear();\n    },\n  };\n}\n"]}

package/dist/components-shared-whiteboard.cjs

@@ -279,6 +279,7 @@ var SseRelayTransport = class {
     this.listeners = /* @__PURE__ */ new Set();
     this.state = "idle";
     this.peers = /* @__PURE__ */ new Set();
+    this.peerListeners = /* @__PURE__ */ new Set();
     this.opts = options;
     this.expectedToken = options.token;
   }
@@ -339,6 +340,8 @@ var SseRelayTransport = class {
     this.es?.close();
     this.es = void 0;
     this.connected = false;
+    this.peers.clear();
+    this.notifyPeers();
     this.setState("closed");
   }
   onStateChange(listener) {
@@ -346,6 +349,28 @@ var SseRelayTransport = class {
     listener(this.state);
     return () => this.listeners.delete(listener);
   }
+  /** How many remote peers (agents) are currently attached to this session. */
+  peerCount() {
+    return this.peers.size;
+  }
+  /**
+   * Subscribe to peer arrivals/departures. Fires immediately with the current
+   * count.
+   *
+   * This is the ONLY honest answer to "is an agent actually here?".
+   * `onStateChange` reports the BROWSER's own channel to the relay, which opens
+   * the instant sharing starts — so a UI keyed on it announces "Agent is
+   * driving" to a human who has not yet handed the link to anybody, and can
+   * never tell them when one really arrives.
+   */
+  onPeersChange(listener) {
+    this.peerListeners.add(listener);
+    listener(this.peers.size);
+    return () => this.peerListeners.delete(listener);
+  }
+  notifyPeers() {
+    for (const l of this.peerListeners) l(this.peers.size);
+  }
   /**
    * For relays that wrap each frame with auth metadata: hosts can call this
    * directly when a frame arrives via a non-SSE path. The transport will
@@ -380,6 +405,7 @@ var SseRelayTransport = class {
     if ("method" in message && message.method === "notifications/peer_joined") {
       const subscriberId = String(message.params?.subscriberId ?? "peer");
       this.peers.add(subscriberId);
+      this.notifyPeers();
       fancyAutoCommon.emitActivity({
         agentId: "agent",
         agentName: "Agent",
@@ -394,6 +420,7 @@ var SseRelayTransport = class {
     if ("method" in message && message.method === "notifications/peer_left") {
       const subscriberId = String(message.params?.subscriberId ?? "peer");
       this.peers.delete(subscriberId);
+      this.notifyPeers();
       if (this.peers.size === 0) {
         fancyAutoCommon.emitActivity({
           agentId: "agent",