@buoy-gg/shared-ui 7.0.41 → 7.0.42

package/lib/commonjs/sync/toolActionRegistry.js

@@ -1,249 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.dispatchToolAction = dispatchToolAction;
-exports.getToolAdapters = getToolAdapters;
-exports.guardToolAdapter = guardToolAdapter;
-exports.isToolRegistryReady = isToolRegistryReady;
-exports.listSnapshotToolIds = listSnapshotToolIds;
-exports.listToolActions = listToolActions;
-exports.listToolIds = listToolIds;
-exports.readToolSnapshot = readToolSnapshot;
-exports.registerToolAdapters = registerToolAdapters;
-exports.waitForToolRegistry = waitForToolRegistry;
-var _licenseModule = require("../license/licenseModule.js");
-/**
- * toolActionRegistry — the on-device twin of the broker's action dispatch.
- *
- * Buoy already has exactly one place where `{toolId, action, params}` becomes a
- * real call into a tool: `handleAction` in external-sync, fed by the adapter
- * map that `autoExternalSync` assembles. That map was private to the React
- * tree, so anything running ON the device (the Scenarios runner) had no way to
- * reach it and would have had to duplicate the map — two dispatch paths that
- * drift the first time an adapter changes.
- *
- * This module publishes the SAME map through a global seam, so a scenario step,
- * a desktop click and an MCP call are one code path with two entry points.
- *
- * WHY A GLOBAL, NOT AN IMPORT: the map is built inside a component (the
- * react-query adapter is a hook, the env adapter is a factory closed over a
- * prop, and custom tools arrive as props), so it cannot be a module constant.
- * Meanwhile the consumer must not import `@buoy-gg/core` — that package imports
- * the tools, and a tool importing it back is the require cycle that puts a
- * LogBox on every reload. Same reasoning, and the same shape, as
- * `crashFlush.ts` in external-sync.
- *
- * WE STORE A GETTER, NOT A SNAPSHOT, for the reason `attachDeviceSync` does:
- * the adapter map is re-created on renders that change its inputs, and a stale
- * captured copy would keep dispatching into adapters the tree has replaced.
- *
- * SAFETY: this registry is populated only while `AutoExternalSync` is mounted,
- * which is itself gated (dev, or release + an explicit opt-in + a real Pro
- * license). It is deliberately NOT a substitute for a caller's own production
- * gate — anything that bends app state through it must check `__DEV__` itself,
- * because the actions reachable here (network overrides, storage writes,
- * impersonation) have no business running in a shipped app.
- */
-
-const REGISTRY_KEY = "__buoyToolActionRegistry";
-
-/** The duck-typed adapter shape, matching external-sync's `ToolSyncAdapter`. */
-
-/**
- * A SET of getters, not one slot — React can briefly mount two providers, or
- * re-run an effect's setup before the previous cleanup. A last-writer-wins slot
- * would let the second registration silently blank the first.
- */
-
-function sources() {
-  const g = globalThis;
-  if (!g[REGISTRY_KEY]) g[REGISTRY_KEY] = new Set();
-  return g[REGISTRY_KEY];
-}
-
-/**
- * Publish the live adapter map. Called by `autoExternalSync` with a getter that
- * reads its current `useMemo` value. Returns the unregister function.
- */
-function registerToolAdapters(getTools) {
-  const set = sources();
-  set.add(getTools);
-  let disposed = false;
-  const dispose = () => {
-    if (disposed) return;
-    disposed = true;
-    const raw = getTools();
-    // Private inverse operations only. No credential bypass reaches public dispatch.
-    const cleanup = async (toolId, action, params) => {
-      if (!(toolId === "network" && action === "deleteOverrideRule" || toolId === "impersonate" && action === "stopImpersonation")) {
-        throw new Error("Unsupported account-lock cleanup operation");
-      }
-      if (toolId === "impersonate") return raw[toolId]?.dispose?.(cleanup);
-      const fn = raw[toolId]?.actions?.[action];
-      if (!fn) throw new Error(`Cleanup unavailable for ${toolId}`);
-      return fn(params);
-    };
-    for (const adapter of Object.values(raw)) {
-      try {
-        Promise.resolve(adapter.dispose?.(cleanup)).catch(error => console.warn("[Buoy] Tool cleanup failed", error));
-      } catch (error) {
-        console.warn("[Buoy] Tool cleanup failed", error);
-      }
-    }
-  };
-  const off = (0, _licenseModule.subscribeAccountAccess)(() => {
-    if (!(0, _licenseModule.hasAccountAccess)()) dispose();else disposed = false;
-  });
-  return () => {
-    off();
-    set.delete(getTools);
-    // A second provider still owns these adapters during Strict Mode/remount.
-    Promise.resolve().then(() => {
-      if (set.size === 0) dispose();
-    });
-  };
-}
-
-/** The merged adapter map across every live source. */
-function getToolAdapters() {
-  if (!(0, _licenseModule.hasAccountAccess)()) return {};
-  const merged = {};
-  for (const get of sources()) {
-    try {
-      Object.assign(merged, get());
-    } catch {
-      // A source that throws must not take the whole registry down.
-    }
-  }
-  return Object.fromEntries(Object.entries(merged).map(([id, adapter]) => [id, guardToolAdapter(adapter)]));
-}
-
-/** Tool ids currently dispatchable. */
-function listToolIds() {
-  return Object.keys(getToolAdapters());
-}
-
-/** `toolId -> action names`, for pre-flight validation and capability display. */
-function listToolActions() {
-  const out = {};
-  for (const [id, adapter] of Object.entries(getToolAdapters())) {
-    out[id] = Object.keys(adapter.actions ?? {});
-  }
-  return out;
-}
-
-/**
- * Tool ids whose adapter publishes a `getSnapshot`.
- *
- * Buoy's read surface is split in two: some tools answer through `actions`
- * (`listQueries`, `async.getAllKeys`), and some answer only through the
- * snapshot the sync layer polls — console entries, network events, the route
- * sitemap, the env table. Anything driving tools ON the device sees only the
- * first half unless it asks for the second, which is why the console and
- * network panels look empty to an in-app agent that has an action for
- * everything except reading them.
- */
-function listSnapshotToolIds() {
-  return Object.entries(getToolAdapters()).filter(([, adapter]) => typeof adapter.getSnapshot === "function").map(([id]) => id);
-}
-
-/**
- * Read one tool's snapshot — the same value `attachDeviceSync` puts on the wire
- * for MCP's `get_snapshot`, without a socket.
- *
- * Async to match {@link dispatchToolAction}: every caller already awaits, and
- * an adapter is free to make this a promise later without breaking them.
- */
-async function readToolSnapshot(toolId) {
-  (0, _licenseModule.assertAccountAccess)();
-  const tools = getToolAdapters();
-  const adapter = tools[toolId];
-  if (!adapter) throw new Error(`Unknown tool "${toolId}"`);
-  if (typeof adapter.getSnapshot !== "function") {
-    throw new Error(`Tool "${toolId}" has no snapshot to read`);
-  }
-  return await adapter.getSnapshot();
-}
-function isToolRegistryReady() {
-  return (0, _licenseModule.hasAccountAccess)() && sources().size > 0;
-}
-
-/**
- * Dispatch one action, shaping failures exactly as `handleAction` does: an
- * unknown tool and an unknown action are distinguishable, and adapter errors
- * surface as plain messages rather than objects nobody can read on a phone.
- */
-async function dispatchToolAction(toolId, action, params) {
-  (0, _licenseModule.assertAccountAccess)();
-  const tools = getToolAdapters();
-  const tool = tools[toolId];
-  const fn = tool?.actions?.[action];
-  if (!fn) {
-    throw new Error(tool ? `Unknown action "${action}" on tool "${toolId}"` : `Unknown tool "${toolId}"`);
-  }
-  return await fn(params);
-}
-
-/**
- * Wait for the registry to be populated, for the narrow window between first
- * frame and `AutoExternalSync` mounting. Resolves false on timeout so the
- * caller can say "Buoy tools are still starting up" instead of "unknown tool".
- */
-async function waitForToolRegistry(timeoutMs = 2000) {
-  if (isToolRegistryReady()) return true;
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    await new Promise(r => setTimeout(r, 50));
-    if (isToolRegistryReady()) return true;
-  }
-  return false;
-}
-
-/** Guard retained references too, and discard results completed after revocation. */
-function guardToolAdapter(adapter) {
-  const guard = fn => (...args) => {
-    (0, _licenseModule.assertAccountAccess)();
-    let revoked = false;
-    const off = (0, _licenseModule.subscribeAccountAccess)(() => {
-      if (!(0, _licenseModule.hasAccountAccess)()) revoked = true;
-    });
-    const check = () => {
-      if (revoked) throw new Error("Buoy account access ended while the operation was pending.");
-      (0, _licenseModule.assertAccountAccess)();
-    };
-    try {
-      const result = fn.apply(adapter, args);
-      if (result && typeof result.then === "function") {
-        return Promise.resolve(result).then(value => {
-          check();
-          return value;
-        }).finally(off);
-      }
-      check();
-      off();
-      return result;
-    } catch (error) {
-      off();
-      throw error;
-    }
-  };
-  return {
-    ...adapter,
-    ...(adapter.getSnapshot ? {
-      getSnapshot: guard(adapter.getSnapshot)
-    } : {}),
-    ...(adapter.actions ? {
-      actions: Object.fromEntries(Object.entries(adapter.actions).map(([name, action]) => [name, guard(action)]))
-    } : {}),
-    ...(adapter.subscribe ? {
-      subscribe: listener => {
-        (0, _licenseModule.assertAccountAccess)();
-        return adapter.subscribe(() => {
-          if ((0, _licenseModule.hasAccountAccess)()) listener();
-        });
-      }
-    } : {})
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.dispatchToolAction=dispatchToolAction;exports.getToolAdapters=getToolAdapters;exports.guardToolAdapter=guardToolAdapter;exports.isToolRegistryReady=isToolRegistryReady;exports.listSnapshotToolIds=listSnapshotToolIds;exports.listToolActions=listToolActions;exports.listToolIds=listToolIds;exports.readToolSnapshot=readToolSnapshot;exports.registerToolAdapters=registerToolAdapters;exports.waitForToolRegistry=waitForToolRegistry;var _licenseModule=require("../license/licenseModule.js");var _realNow=require("../utils/realNow.js");const REGISTRY_KEY="__buoyToolActionRegistry";function sources(){const e=globalThis;if(!e[REGISTRY_KEY])e[REGISTRY_KEY]=new Set;return e[REGISTRY_KEY]}function registerToolAdapters(e){const t=sources();t.add(e);let o=false;const c=()=>{if(o)return;o=true;const r=e();const a=async(s,n,l)=>{if(!(s==="network"&&n==="deleteOverrideRule"||s==="impersonate"&&n==="stopImpersonation")){throw new Error("Unsupported account-lock cleanup operation")}if(s==="impersonate")return r[s]?.dispose?.(a);const u=r[s]?.actions?.[n];if(!u)throw new Error(`Cleanup unavailable for ${s}`);return u(l)};for(const s of Object.values(r)){try{Promise.resolve(s.dispose?.(a)).catch(n=>console.warn("[Buoy] Tool cleanup failed",n))}catch(n){console.warn("[Buoy] Tool cleanup failed",n)}}};const i=(0,_licenseModule.subscribeAccountAccess)(()=>{if(!(0,_licenseModule.hasAccountAccess)())c();else o=false});return()=>{i();t.delete(e);Promise.resolve().then(()=>{if(t.size===0)c()})}}function getToolAdapters(){if(!(0,_licenseModule.hasAccountAccess)())return{};const e={};for(const t of sources()){try{Object.assign(e,t())}catch{}}return Object.fromEntries(Object.entries(e).map(([t,o])=>[t,guardToolAdapter(o)]))}function listToolIds(){return Object.keys(getToolAdapters())}function listToolActions(){const e={};for(const[t,o]of Object.entries(getToolAdapters())){e[t]=Object.keys(o.actions??{})}return e}function listSnapshotToolIds(){return Object.entries(getToolAdapters()).filter(([,e])=>typeof e.getSnapshot==="function").map(([e])=>e)}async function readToolSnapshot(e){(0,_licenseModule.assertAccountAccess)();const t=getToolAdapters();const o=t[e];if(!o)throw new Error(`Unknown tool "${e}"`);if(typeof o.getSnapshot!=="function"){throw new Error(`Tool "${e}" has no snapshot to read`)}return await o.getSnapshot()}function isToolRegistryReady(){return(0,_licenseModule.hasAccountAccess)()&&sources().size>0}async function dispatchToolAction(e,t,o){(0,_licenseModule.assertAccountAccess)();const c=getToolAdapters();const i=c[e];const r=i?.actions?.[t];if(!r){throw new Error(i?`Unknown action "${t}" on tool "${e}"`:`Unknown tool "${e}"`)}return await r(o)}async function waitForToolRegistry(e=2e3){if(isToolRegistryReady())return true;const t=(0,_realNow.realNow)()+e;while((0,_realNow.realNow)()<t){await new Promise(o=>setTimeout(o,50));if(isToolRegistryReady())return true}return false}function guardToolAdapter(e){const t=o=>(...c)=>{(0,_licenseModule.assertAccountAccess)();let i=false;const r=(0,_licenseModule.subscribeAccountAccess)(()=>{if(!(0,_licenseModule.hasAccountAccess)())i=true});const a=()=>{if(i)throw new Error("Buoy account access ended while the operation was pending.");(0,_licenseModule.assertAccountAccess)()};try{const s=o.apply(e,c);if(s&&typeof s.then==="function"){return Promise.resolve(s).then(n=>{a();return n}).finally(r)}a();r();return s}catch(s){r();throw s}};return{...e,...e.getSnapshot?{getSnapshot:t(e.getSnapshot)}:{},...e.actions?{actions:Object.fromEntries(Object.entries(e.actions).map(([o,c])=>[o,t(c)]))}:{},...e.subscribe?{subscribe:o=>{(0,_licenseModule.assertAccountAccess)();return e.subscribe(()=>{if((0,_licenseModule.hasAccountAccess)())o()})}}:{}}}

package/lib/commonjs/sync/toolAttention.test.js

@@ -1,51 +1 @@
-"use strict";
-
-var _vitest = require("vitest");
-var _toolUiBridge = require("./toolUiBridge.js");
-/**
- * The attention badge seam: a tool says "I need you" and the rail hears it.
- */
-
-(0, _vitest.describe)("toolAttention", () => {
-  (0, _vitest.it)("stores, replaces and clears a badge, notifying once per change", () => {
-    const fn = _vitest.vi.fn();
-    const off = (0, _toolUiBridge.subscribeToolAttention)(fn);
-    (0, _toolUiBridge.setToolAttention)("ask-buoy", {
-      kind: "needsInput",
-      label: "Needs your approval"
-    });
-    (0, _vitest.expect)((0, _toolUiBridge.getToolAttention)("ask-buoy")).toEqual({
-      kind: "needsInput",
-      label: "Needs your approval"
-    });
-    (0, _vitest.expect)(fn).toHaveBeenCalledTimes(1);
-    // Same value again is not a change.
-    (0, _toolUiBridge.setToolAttention)("ask-buoy", {
-      kind: "needsInput",
-      label: "Needs your approval"
-    });
-    (0, _vitest.expect)(fn).toHaveBeenCalledTimes(1);
-    (0, _toolUiBridge.setToolAttention)("ask-buoy", {
-      kind: "done",
-      label: "Finished"
-    });
-    (0, _vitest.expect)(fn).toHaveBeenCalledTimes(2);
-    (0, _toolUiBridge.setToolAttention)("ask-buoy", null);
-    (0, _vitest.expect)((0, _toolUiBridge.getToolAttention)("ask-buoy")).toBeNull();
-    (0, _vitest.expect)(fn).toHaveBeenCalledTimes(3);
-    // Clearing what is already clear is silent.
-    (0, _toolUiBridge.setToolAttention)("ask-buoy", null);
-    (0, _vitest.expect)(fn).toHaveBeenCalledTimes(3);
-    off();
-  });
-  (0, _vitest.it)("keeps tools apart", () => {
-    (0, _toolUiBridge.setToolAttention)("a", {
-      kind: "failed",
-      label: "x"
-    });
-    (0, _toolUiBridge.setToolAttention)("b", null);
-    (0, _vitest.expect)((0, _toolUiBridge.getToolAttention)("a")?.kind).toBe("failed");
-    (0, _vitest.expect)((0, _toolUiBridge.getToolAttention)("b")).toBeNull();
-    (0, _toolUiBridge.setToolAttention)("a", null);
-  });
-});
+"use strict";var _vitest=require("vitest");var _toolUiBridge=require("./toolUiBridge.js");(0,_vitest.describe)("toolAttention",()=>{(0,_vitest.it)("stores, replaces and clears a badge, notifying once per change",()=>{const e=_vitest.vi.fn();const t=(0,_toolUiBridge.subscribeToolAttention)(e);(0,_toolUiBridge.setToolAttention)("ask-buoy",{kind:"needsInput",label:"Needs your approval"});(0,_vitest.expect)((0,_toolUiBridge.getToolAttention)("ask-buoy")).toEqual({kind:"needsInput",label:"Needs your approval"});(0,_vitest.expect)(e).toHaveBeenCalledTimes(1);(0,_toolUiBridge.setToolAttention)("ask-buoy",{kind:"needsInput",label:"Needs your approval"});(0,_vitest.expect)(e).toHaveBeenCalledTimes(1);(0,_toolUiBridge.setToolAttention)("ask-buoy",{kind:"done",label:"Finished"});(0,_vitest.expect)(e).toHaveBeenCalledTimes(2);(0,_toolUiBridge.setToolAttention)("ask-buoy",null);(0,_vitest.expect)((0,_toolUiBridge.getToolAttention)("ask-buoy")).toBeNull();(0,_vitest.expect)(e).toHaveBeenCalledTimes(3);(0,_toolUiBridge.setToolAttention)("ask-buoy",null);(0,_vitest.expect)(e).toHaveBeenCalledTimes(3);t()});(0,_vitest.it)("keeps tools apart",()=>{(0,_toolUiBridge.setToolAttention)("a",{kind:"failed",label:"x"});(0,_toolUiBridge.setToolAttention)("b",null);(0,_vitest.expect)((0,_toolUiBridge.getToolAttention)("a")?.kind).toBe("failed");(0,_vitest.expect)((0,_toolUiBridge.getToolAttention)("b")).toBeNull();(0,_toolUiBridge.setToolAttention)("a",null)})});

package/lib/commonjs/sync/toolSyncAdapter.js

@@ -1,63 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.createSyncAdapter = createSyncAdapter;
-exports.mergeChangeSources = mergeChangeSources;
-/**
- * ToolSyncAdapter — the contract a tool implements to sync to Buoy Desktop /
- * the MCP server, plus `createSyncAdapter`, the one way to build one.
- *
- * Every tool package used to declare its adapter as a bare object literal
- * with the comment "structurally matches external-sync's ToolSyncAdapter so
- * this package doesn't need a dependency on it". That kept the packages
- * decoupled but left the contract unchecked: storage shipped `version: 3`
- * while every sibling was on 2 and nothing noticed. The type now lives here,
- * in shared (which every tool already depends on), and external-sync
- * re-exports it — one definition, checked everywhere.
- *
- * `createSyncAdapter` is deliberately thin. It:
- *  - type-checks the literal against the contract (a wrong `subscribe`
- *    signature or a non-function action fails at compile time),
- *  - keeps the CONCRETE `actions` type, so `adapter.actions.getChangeDetail()`
- *    stays typed for tests and callers,
- *  - merges several change sources into one `subscribe` (a store plus its
- *    registry, envelopes plus drops) — the second most-copied block.
- */
-
-/** A remote-invocable action. Thrown errors are reported back to the dashboard. */
-
-/** Anything that can tell the bridge "something changed". */
-
-/**
- * The contract each dev tool implements to become remotely syncable.
- * Works with BaseEventStore, ChangeLog, createToolStore, or any pattern
- * exposing subscribe + getSnapshot.
- *
- * Payloads (snapshots and action results) must be JSON-serializable —
- * no functions, circular references, or class instances.
- */
-
-/** Subscribe to every source; the returned function unsubscribes from all. */
-function mergeChangeSources(sources) {
-  if (sources.length === 1) return sources[0];
-  return onChange => {
-    const offs = sources.map(source => source(onChange));
-    return () => {
-      for (const off of offs) off();
-    };
-  };
-}
-function createSyncAdapter(definition) {
-  const subscribe = Array.isArray(definition.subscribe) ? mergeChangeSources(definition.subscribe) : definition.subscribe;
-  const adapter = {
-    version: definition.version,
-    getSnapshot: definition.getSnapshot,
-    subscribe,
-    ...(definition.actions ? {
-      actions: definition.actions
-    } : {})
-  };
-  return adapter;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.createSyncAdapter=createSyncAdapter;exports.mergeChangeSources=mergeChangeSources;function mergeChangeSources(r){if(r.length===1)return r[0];return e=>{const s=r.map(t=>t(e));return()=>{for(const t of s)t()}}}function createSyncAdapter(r){const e=Array.isArray(r.subscribe)?mergeChangeSources(r.subscribe):r.subscribe;const s={version:r.version,getSnapshot:r.getSnapshot,subscribe:e,...r.actions?{actions:r.actions}:{}};return s}

package/lib/commonjs/sync/toolUiBridge.js

@@ -1,132 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.canOpenBuoyTools = canOpenBuoyTools;
-exports.getToolAttention = getToolAttention;
-exports.openBuoyTool = openBuoyTool;
-exports.registerToolOpener = registerToolOpener;
-exports.setToolAttention = setToolAttention;
-exports.subscribeToolAttention = subscribeToolAttention;
-/**
- * toolUiBridge — let a tool ask the host to bring another tool back on screen.
- *
- * WHY THIS EXISTS. Buoy's tool overlays (the SIMULATED banner, the recording
- * banner, the perf HUD) render as siblings of `AppHostProvider`, not inside it,
- * so none of them can reach the host that knows how to open and restore tools.
- * That is usually fine — an overlay's job is to be seen, not to navigate. It
- * stops being fine the moment an overlay is the ONLY thing on screen and the
- * next step lives inside a tool: the macro recorder minimizes Scenarios so a
- * tester can drive the app, and when they stop, the review screen they need is
- * behind a tool icon they have to know to hunt for.
- *
- * The alternative was moving every overlay inside the provider, which would
- * re-order the stacking of six unrelated tools to fix one banner's button. This
- * is the same global-seam shape `toolActionRegistry` already uses for the same
- * reason: the capability lives inside a component tree, the caller must not
- * import `@buoy-gg/core` (that package imports the tools, and a tool importing
- * it back is a require cycle), so it is published through a global.
- *
- * A SET of openers, not one slot, for the reason the action registry keeps one:
- * React can briefly mount two providers, or re-run an effect's setup before the
- * previous cleanup, and a last-writer-wins slot lets the second registration
- * silently blank the first.
- */
-
-const BRIDGE_KEY = "__buoyToolUiBridge";
-
-/** Returns true when the tool was actually brought back on screen. */
-
-function openers() {
-  const g = globalThis;
-  if (!g[BRIDGE_KEY]) g[BRIDGE_KEY] = new Set();
-  return g[BRIDGE_KEY];
-}
-
-/** Published by the host, inside the provider that owns open tools. */
-function registerToolOpener(opener) {
-  const set = openers();
-  set.add(opener);
-  return () => {
-    set.delete(opener);
-  };
-}
-
-/**
- * Ask the host to show a tool.
- *
- * Returns false when nothing could do it — no host mounted, or the tool isn't
- * open for it to restore. Callers must treat that as a real answer and say so,
- * rather than rendering a button that silently does nothing.
- */
-function openBuoyTool(toolId) {
-  for (const opener of openers()) {
-    try {
-      if (opener(toolId)) return true;
-    } catch {
-      // A host that throws must not stop another from answering.
-    }
-  }
-  return false;
-}
-
-/** True when some host is listening — for deciding whether to offer the button. */
-function canOpenBuoyTools() {
-  return openers().size > 0;
-}
-
-// ─── Attention ───────────────────────────────────────────────────────────────
-
-/**
- * "This tool needs you" — shown as a badge on its chip in the minimized rail.
- *
- * The case: Ask Buoy is minimized so a tester can watch the app, and the
- * agent hits a step that needs a tap. Nobody can see the card. The sheet used
- * to fail safe by DECLINING the change and ending the turn — which made
- * minimize mean "stop", the opposite of what it is for. Now the approval
- * holds, the chip gets a badge, and tapping the chip (the existing restore
- * path) brings the card back. Same seam shape as the opener above: the rail
- * lives inside the host, the tool cannot import the host, so it publishes
- * through a global.
- *
- * `done` and `failed` cover the other thing a hidden tool cannot say — that
- * the work you minimized it to wait for has finished.
- */
-
-const ATTENTION_KEY = "__buoyToolAttention";
-function attention() {
-  const g = globalThis;
-  if (!g[ATTENTION_KEY]) g[ATTENTION_KEY] = {
-    byTool: new Map(),
-    listeners: new Set()
-  };
-  return g[ATTENTION_KEY];
-}
-
-/** Set, replace or (with null) clear a tool's badge. No-op when nothing changed. */
-function setToolAttention(toolId, next) {
-  const store = attention();
-  const prev = store.byTool.get(toolId) ?? null;
-  if (prev === next || prev && next && prev.kind === next.kind && prev.label === next.label) return;
-  if (next) store.byTool.set(toolId, next);else store.byTool.delete(toolId);
-  for (const fn of store.listeners) {
-    try {
-      fn();
-    } catch {
-      // A throwing subscriber must not stop the others from hearing.
-    }
-  }
-}
-function getToolAttention(toolId) {
-  return attention().byTool.get(toolId) ?? null;
-}
-
-/** For `useSyncExternalStore` in the rail. */
-function subscribeToolAttention(fn) {
-  const store = attention();
-  store.listeners.add(fn);
-  return () => {
-    store.listeners.delete(fn);
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.canOpenBuoyTools=canOpenBuoyTools;exports.getToolAttention=getToolAttention;exports.openBuoyTool=openBuoyTool;exports.registerToolOpener=registerToolOpener;exports.setToolAttention=setToolAttention;exports.subscribeToolAttention=subscribeToolAttention;const BRIDGE_KEY="__buoyToolUiBridge";function openers(){const o=globalThis;if(!o[BRIDGE_KEY])o[BRIDGE_KEY]=new Set;return o[BRIDGE_KEY]}function registerToolOpener(o){const e=openers();e.add(o);return()=>{e.delete(o)}}function openBuoyTool(o){for(const e of openers()){try{if(e(o))return true}catch{}}return false}function canOpenBuoyTools(){return openers().size>0}const ATTENTION_KEY="__buoyToolAttention";function attention(){const o=globalThis;if(!o[ATTENTION_KEY])o[ATTENTION_KEY]={byTool:new Map,listeners:new Set};return o[ATTENTION_KEY]}function setToolAttention(o,e){const t=attention();const n=t.byTool.get(o)??null;if(n===e||n&&e&&n.kind===e.kind&&n.label===e.label)return;if(e)t.byTool.set(o,e);else t.byTool.delete(o);for(const r of t.listeners){try{r()}catch{}}}function getToolAttention(o){return attention().byTool.get(o)??null}function subscribeToolAttention(o){const e=attention();e.listeners.add(o);return()=>{e.listeners.delete(o)}}