@buoy-gg/mcp 7.0.78 → 7.0.80

package/dist/cli.mjs

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
-import{createRequire as S}from"module";const N=S(import.meta.url);import{SyncClient as v,createMcpServer as R,stopAllHidStreamsNow as B,stopAllRecordingsNow as k}from"./chunk-HEPFVYZG.mjs";import{runInit as O}from"./chunk-LHGIYW7N.mjs";import"./chunk-3STZVJQG.mjs";import"./chunk-XA74T4JN.mjs";import"./chunk-ODGXMS2O.mjs";import"./chunk-5NOZVPWB.mjs";import"./chunk-D5K6WO6B.mjs";import"./chunk-OP23W722.mjs";import"./chunk-DVRR7W22.mjs";import"./chunk-MTTWR4T7.mjs";import{StdioServerTransport as T}from"@modelcontextprotocol/sdk/server/stdio.js";var $=console.log;console.log=(...e)=>console.error(...e);console.info=(...e)=>console.error(...e);console.debug=(...e)=>console.error(...e);async function P(){const e=process.env.BUOY_BROKER_PORT;const r=new v({url:process.env.BUOY_BROKER_URL,port:e?Number(e):void 0,autoSpawnBroker:process.env.BUOY_NO_SPAWN!=="1"});const n=R(r);const t=new T;let c=false;const s=o=>{if(c)return;c=true;process.stderr.write(`[buoy-mcp] shutting down (${o})
-`);k();B();setTimeout(()=>process.exit(0),2e3).unref();void(async()=>{await r.stop().catch(()=>{});await n.close().catch(()=>{});process.exit(0)})()};process.stdin.once("end",()=>s("stdin closed"));process.stdin.once("close",()=>s("stdin closed"));n.server.onclose=()=>s("transport closed");process.on("SIGINT",()=>s("SIGINT"));process.on("SIGTERM",()=>s("SIGTERM"));process.on("SIGHUP",()=>s("SIGHUP"));await n.connect(t);process.stderr.write(`[buoy-mcp] serving MCP over stdio; connecting to broker\u2026
-`);r.start().then(o=>process.stderr.write(`[buoy-mcp] broker ${o}
-`)).catch(o=>process.stderr.write(`[buoy-mcp] broker connection failed: ${o?.message??o} \u2014 tools will report no devices until it recovers
-`))}async function E(){const e=process.env.BUOY_BROKER_PORT;const r=new v({url:process.env.BUOY_BROKER_URL,port:e?Number(e):void 0,autoSpawnBroker:false});const{hasProAccess:n}=await import("./policy-UNODNYFR.mjs");try{const t=await Promise.race([r.start().then(()=>true,()=>false),new Promise(s=>setTimeout(()=>s(false),4e3))]);if(!t)return{account:false,pro:false};let c=r.isAdmitted();for(let s=0;s<10;s++){const o=r.connectedDevices();if(o.some(i=>n(i)))return{account:true,pro:true};c||=o.some(i=>i.tier==="free");await new Promise(i=>setTimeout(i,300))}return{account:c,pro:false}}finally{await Promise.race([r.stop().catch(()=>{}),new Promise(t=>setTimeout(t,2e3))])}}if(process.argv[2]==="web"){void import("./main-6OX5577P.mjs").then(e=>e.runWebServer()).catch(e=>{process.stderr.write(`[buoy-web] fatal: ${e?.message??e}
-`);process.exit(1)})}else if(process.argv[2]==="web-bench"){void(async()=>{try{const e=process.argv.slice(3);const r=e.find(a=>!a.startsWith("--"));if(!r)throw new Error("usage: buoy-mcp web-bench <config.json> [--json]");const{readFileSync:n}=await import("fs");const{runWebBench:t,formatWebBenchMarkdown:c}=await import("./webBench-BEMJWKB3.mjs");const{readEntitlement:s,entitlementHasPro:o}=await import("./camera-6HTJDU4Y.mjs");const{freeWebBench:i,lockedLines:y,nothingLocked:h}=await import("./freeView-3LHV3RBG.mjs");const l=s();const m=o(l)?{account:true,pro:true}:await E();const d=o(l)||m.pro;if(!l.admitted&&!m.account){throw new Error("web-bench needs a Buoy account. A free one works. Sign in to Buoy Desktop, or run `npx --package=@buoy-gg/core buoy login` in the project.")}const p=JSON.parse(n(r,"utf8"));if(p.traceDir&&!d)throw new Error("traceDir (Chrome traces) needs Buoy Pro. See https://buoy.gg/pricing.");let w=h();const u=await t({...p,durationMs:p.durationMs??p.perCaseDurationMs,redact:d?void 0:a=>{const b=i(a);w=b.locked;return b.result}},a=>process.stderr.write(`[web-bench] ${a}
+import{createRequire as S}from"module";const I=S(import.meta.url);import{createMcpServer as R,stopAllHidStreamsNow as B,stopAllRecordingsNow as k}from"./chunk-BKCCZNDR.mjs";import"./chunk-DVRR7W22.mjs";import{runInit as O}from"./chunk-2324LPBJ.mjs";import"./chunk-23AXQYJ4.mjs";import{SyncClient as b,stopNativeProfiles as P}from"./chunk-TMN3LXKB.mjs";import"./chunk-5XATNNKY.mjs";import"./chunk-FYJWWTAC.mjs";import"./chunk-5NOZVPWB.mjs";import"./chunk-D5K6WO6B.mjs";import"./chunk-OP23W722.mjs";import"./chunk-MTTWR4T7.mjs";import{StdioServerTransport as T}from"@modelcontextprotocol/sdk/server/stdio.js";var $=console.log;console.log=(...e)=>console.error(...e);console.info=(...e)=>console.error(...e);console.debug=(...e)=>console.error(...e);async function E(){const e=process.env.BUOY_BROKER_PORT;const r=new b({url:process.env.BUOY_BROKER_URL,port:e?Number(e):void 0,autoSpawnBroker:process.env.BUOY_NO_SPAWN!=="1"});const n=R(r);const t=new T;let c=false;const o=s=>{if(c)return;c=true;process.stderr.write(`[buoy-mcp] shutting down (${s})
+`);k();B();setTimeout(()=>process.exit(0),2e3).unref();void(async()=>{await P();await r.stop().catch(()=>{});await n.close().catch(()=>{});process.exit(0)})()};process.stdin.once("end",()=>o("stdin closed"));process.stdin.once("close",()=>o("stdin closed"));n.server.onclose=()=>o("transport closed");process.on("SIGINT",()=>o("SIGINT"));process.on("SIGTERM",()=>o("SIGTERM"));process.on("SIGHUP",()=>o("SIGHUP"));await n.connect(t);process.stderr.write(`[buoy-mcp] serving MCP over stdio; connecting to broker\u2026
+`);r.start().then(s=>process.stderr.write(`[buoy-mcp] broker ${s}
+`)).catch(s=>process.stderr.write(`[buoy-mcp] broker connection failed: ${s?.message??s} \u2014 tools will report no devices until it recovers
+`))}async function N(){const e=process.env.BUOY_BROKER_PORT;const r=new b({url:process.env.BUOY_BROKER_URL,port:e?Number(e):void 0,autoSpawnBroker:false});const{hasProAccess:n}=await import("./policy-UNODNYFR.mjs");try{const t=await Promise.race([r.start().then(()=>true,()=>false),new Promise(o=>setTimeout(()=>o(false),4e3))]);if(!t)return{account:false,pro:false};let c=r.isAdmitted();for(let o=0;o<10;o++){const s=r.connectedDevices();if(s.some(i=>n(i)))return{account:true,pro:true};c||=s.some(i=>i.tier==="free");await new Promise(i=>setTimeout(i,300))}return{account:c,pro:false}}finally{await Promise.race([r.stop().catch(()=>{}),new Promise(t=>setTimeout(t,2e3))])}}if(process.argv[2]==="web"){void import("./main-QEH33AS3.mjs").then(e=>e.runWebServer()).catch(e=>{process.stderr.write(`[buoy-web] fatal: ${e?.message??e}
+`);process.exit(1)})}else if(process.argv[2]==="web-bench"){void(async()=>{try{const e=process.argv.slice(3);const r=e.find(a=>!a.startsWith("--"));if(!r)throw new Error("usage: buoy-mcp web-bench <config.json> [--json]");const{readFileSync:n}=await import("fs");const{runWebBench:t,formatWebBenchMarkdown:c}=await import("./webBench-BEMJWKB3.mjs");const{readEntitlement:o,entitlementHasPro:s}=await import("./camera-6HTJDU4Y.mjs");const{freeWebBench:i,lockedLines:y,nothingLocked:h}=await import("./freeView-3LHV3RBG.mjs");const l=o();const m=s(l)?{account:true,pro:true}:await N();const d=s(l)||m.pro;if(!l.admitted&&!m.account){throw new Error("web-bench needs a Buoy account. A free one works. Sign in to Buoy Desktop, or run `npx --package=@buoy-gg/core buoy login` in the project.")}const p=JSON.parse(n(r,"utf8"));if(p.traceDir&&!d)throw new Error("traceDir (Chrome traces) needs Buoy Pro. See https://buoy.gg/pricing.");let w=h();const u=await t({...p,durationMs:p.durationMs??p.perCaseDurationMs,redact:d?void 0:a=>{const v=i(a);w=v.locked;return v.result}},a=>process.stderr.write(`[web-bench] ${a}
 `));const f=y(w);if(f)process.stderr.write(`${f}
 `);const g=u.status==="failed"||u.browserLeftRunning?1:0;const x=(e.includes("--json")?JSON.stringify(u,null,2):c(u))+"\n";setTimeout(()=>process.exit(g),5e3).unref();process.stdout.write(x,()=>process.exit(g))}catch(e){process.stderr.write(`[buoy-mcp] web-bench failed: ${e?.message??e}
-`,()=>process.exit(1));setTimeout(()=>process.exit(1),5e3).unref()}})()}else if(process.argv[2]==="flow"&&process.argv[3]==="run"){void(async()=>{try{const{parseFlowRunArgs:e,runFlows:r,formatFlowResults:n}=await import("./flowRun-XEK65IL7.mjs");const t=e(process.argv.slice(4));const c=await r(t);const s=t.json?JSON.stringify(c,null,2):n(c);const o=c.every(i=>i.passed)?0:1;setTimeout(()=>process.exit(o),5e3).unref();process.stdout.write(`${s}
-`,()=>process.exit(o))}catch(e){process.stderr.write(`[buoy-mcp] flow run failed: ${e?.message??e}
-`,()=>process.exit(1));setTimeout(()=>process.exit(1),5e3).unref()}})()}else if(process.argv[2]==="farm"){console.log=$;void import("./src-R7ICMP6Q.mjs").then(e=>e.runFarmCommand(process.argv.slice(3),{prog:"npx @buoy-gg/mcp farm",entry:process.argv[1],chromeKeeperArgs:["farm","chrome","keeper"]})).catch(e=>{const r=e;process.stderr.write(`${r?.message??e}${r?.next?`
+`,()=>process.exit(1));setTimeout(()=>process.exit(1),5e3).unref()}})()}else if(process.argv[2]==="flow"&&process.argv[3]==="run"){void(async()=>{try{const{parseFlowRunArgs:e,runFlows:r,formatFlowResults:n}=await import("./flowRun-DYM3QAEL.mjs");const t=e(process.argv.slice(4));const c=await r(t);const o=t.json?JSON.stringify(c,null,2):n(c);const s=c.every(i=>i.passed)?0:1;setTimeout(()=>process.exit(s),5e3).unref();process.stdout.write(`${o}
+`,()=>process.exit(s))}catch(e){process.stderr.write(`[buoy-mcp] flow run failed: ${e?.message??e}
+`,()=>process.exit(1));setTimeout(()=>process.exit(1),5e3).unref()}})()}else if(process.argv[2]==="farm"){console.log=$;void import("./src-HRUK7GEE.mjs").then(e=>e.runFarmCommand(process.argv.slice(3),{prog:"npx @buoy-gg/mcp farm",entry:process.argv[1],chromeKeeperArgs:["farm","chrome","keeper"]})).catch(e=>{const r=e;process.stderr.write(`${r?.message??e}${r?.next?`
 ${r.next}`:""}
-`);process.exit(1)})}else if(process.argv[2]==="farmd"){void import("./simFarm-R4P6QXRK.mjs").then(e=>e.runFarmd()).catch(e=>{process.stderr.write(`[buoy-mcp] farmd failed: ${e?.message??e}
-`);process.exit(1)})}else if(process.argv[2]==="init"){void(async()=>{try{const e=process.argv.slice(3);let r="auto";if(e.includes("--local"))r="local";else if(e.includes("--npx"))r="npx";const n=e.indexOf("--registry");const t=n!==-1?e[n+1]:void 0;if(e.includes("--web")){const{runWebInit:c}=await import("./init-VCQMVZXB.mjs");c({mode:r,registry:t})}else O({mode:r,registry:t});process.exit(0)}catch(e){process.stderr.write(`[buoy-mcp] init failed: ${e?.message??e}
-`);process.exit(1)}})()}else{P().catch(e=>{process.stderr.write(`[buoy-mcp] fatal: ${e?.message??e}
+`);process.exit(1)})}else if(process.argv[2]==="farmd"){void import("./simFarm-AWVHVU6A.mjs").then(e=>e.runFarmd()).catch(e=>{process.stderr.write(`[buoy-mcp] farmd failed: ${e?.message??e}
+`);process.exit(1)})}else if(process.argv[2]==="init"){void(async()=>{try{const e=process.argv.slice(3);let r="auto";if(e.includes("--local"))r="local";else if(e.includes("--npx"))r="npx";const n=e.indexOf("--registry");const t=n!==-1?e[n+1]:void 0;if(e.includes("--web")){const{runWebInit:c}=await import("./init-HT6H7SCW.mjs");c({mode:r,registry:t})}else O({mode:r,registry:t});process.exit(0)}catch(e){process.stderr.write(`[buoy-mcp] init failed: ${e?.message??e}
+`);process.exit(1)}})()}else{E().catch(e=>{process.stderr.write(`[buoy-mcp] fatal: ${e?.message??e}
 `);process.exit(1)})}

package/dist/flowRun-DYM3QAEL.mjs

@@ -0,0 +1,2 @@
+import{createRequire as v}from"module";const E=v(import.meta.url);import{createMcpServer as y}from"./chunk-BKCCZNDR.mjs";import"./chunk-DVRR7W22.mjs";import"./chunk-23AXQYJ4.mjs";import{SyncClient as R}from"./chunk-TMN3LXKB.mjs";import"./chunk-5XATNNKY.mjs";import"./chunk-FYJWWTAC.mjs";import"./chunk-5NOZVPWB.mjs";import"./chunk-D5K6WO6B.mjs";import"./chunk-OP23W722.mjs";import"./chunk-MTTWR4T7.mjs";import{promises as S}from"fs";import $ from"path";import{Client as _}from"@modelcontextprotocol/sdk/client/index.js";import{InMemoryTransport as B}from"@modelcontextprotocol/sdk/inMemory.js";function I(e){const o={names:[]};for(let n=0;n<e.length;n++){const t=e[n];if(t==="--device")o.deviceId=e[++n];else if(t==="--update-snapshots")o.updateSnapshots=true;else if(t==="--json")o.json=true;else if(t==="--wait")o.waitMs=Number(e[++n])*1e3;else if(t==="--all")continue;else if(!t.startsWith("--"))o.names.push(t);else throw new Error(`Unknown option ${t}.`)}return o}async function P(){const e=$.join(process.cwd(),".buoy","flows");return(await S.readdir(e).catch(()=>[])).filter(o=>o.endsWith(".json")).map(o=>o.replace(/\.json$/,"")).sort()}async function g(e,o=n=>process.stderr.write(`${n}
+`)){const n=e.names.length?e.names:await P();if(n.length===0)throw new Error('No saved flows. Save one with run_flow and save:"name", or pass a flow name.');const t=process.env.BUOY_BROKER_PORT;const s=new R({url:process.env.BUOY_BROKER_URL,port:t?Number(t):void 0,autoSpawnBroker:process.env.BUOY_NO_SPAWN!=="1"});const w=y(s);const[d,f]=B.createLinkedPair();const i=new _({name:"buoy-flow-run",version:"1"});try{await w.connect(f);await i.connect(d);await s.start();const a=Date.now()+(e.waitMs??6e4);while(Date.now()<a&&!s.connectedDevices().some(r=>(r.isPro||r.tier==="free")&&(!e.deviceId||r.deviceId===e.deviceId))){await new Promise(r=>setTimeout(r,500))}if(!s.connectedDevices().some(r=>r.isPro||r.tier==="free")){throw new Error("No app on a Buoy account is connected. Start the app (with Buoy) on a simulator or device, then run again.")}const m=[];for(const r of n){const p=Date.now();o(`\u25B6 ${r}`);const u=await i.callTool({name:"run_flow",arguments:{flow:r,include:"none",...e.deviceId?{deviceId:e.deviceId}:{},...e.updateSnapshots?{updateSnapshots:true}:{}}},void 0,{timeout:10*6e4});const h=(u.content??[]).filter(c=>c.type==="text").map(c=>c.text).join("\n");const l=u.isError!==true;m.push({name:r,passed:l,ms:Date.now()-p,report:h});o(`${l?"\u2713":"\u2717"} ${r} (${((Date.now()-p)/1e3).toFixed(1)}s)`)}return m}finally{await i.close().catch(()=>void 0);await Promise.race([s.stop().catch(()=>void 0),new Promise(a=>setTimeout(a,2e3))])}}function j(e){const o=e.filter(t=>!t.passed);const n=[`${e.length-o.length} of ${e.length} flows passed.`];for(const t of o){n.push("",`\u2717 ${t.name}`,t.report.trim(),`  Rerun: npx @buoy-gg/mcp flow run ${t.name}`)}return n.join("\n")}export{j as formatFlowResults,I as parseFlowRunArgs,g as runFlows};

package/dist/index.d.mts

@@ -1,373 +1,7 @@
-import { ToolCapability } from '@buoy-gg/sync-broker';
+import { S as SyncClient } from './SyncClient-gqMRmB79.mjs';
+export { B as BrokerMode, D as DeviceInfo, a as SyncClientOptions } from './SyncClient-gqMRmB79.mjs';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-
-type AccessLevel = "free" | "pro";
-
-interface SyncClientOptions {
-    /** Broker URL to connect to. @default http://localhost:42831 */
-    url?: string;
-    /** Broker port to probe/spawn on. @default 42831 */
-    port?: number;
-    /**
-     * If no broker is already running on the port, spawn one in-process so the
-     * MCP server works standalone (no desktop app needed). @default true
-     */
-    autoSpawnBroker?: boolean;
-    /** Default per-action timeout. @default 15000 */
-    actionTimeoutMs?: number;
-    /** Optional logger — writes to stderr by default (stdout is the MCP channel). */
-    log?: (msg: string) => void;
-}
-interface DeviceInfo {
-    deviceId: string;
-    deviceName: string;
-    platform?: string;
-    isConnected: boolean;
-    /** Whether the connected app reported an active Buoy Pro license. */
-    isPro: boolean;
-    /**
-     * The app's tier after admission. New sockets are "checking"; an account
-     * lock is "locked". Older apps report only `isPro`, which maps to Pro
-     * or locked because keys could only grant Pro before the tier split.
-     *
-     * Surfaced so `list_devices` can say WHY the MCP is blocked: "signed in on
-     * the free tier" and "no admitted account" are different problems.
-     */
-    tier: "checking" | "locked" | "free" | "pro";
-    /**
-     * More than one app is registered under this id right now (a pinned
-     * `externalSync.deviceId` copied onto two devices). Actions sent to it
-     * land on an arbitrary one. Broker-computed; false for apps too old to
-     * announce a runtime instance id.
-     */
-    collision: boolean;
-    tools: ToolCapability[];
-}
-/** How the client obtained its broker connection. */
-type BrokerMode = "connected" | "spawned";
-/**
- * A headless "Dashboard" client of the Buoy sync broker — the same role the
- * desktop app plays, but driven programmatically by the MCP server. Implements
- * connect-or-spawn: connects to a running broker (e.g. the desktop app) if one
- * is up, otherwise hosts its own in-process so it works standalone.
- */
-declare class SyncClient {
-    private socket;
-    private admitted;
-    /** When this client was made: the startup window for {@link awaitBroker}. */
-    private readonly createdAt;
-    private lockedDevices;
-    private hostAccount;
-    private broker;
-    private readonly url;
-    private readonly port;
-    private readonly actionTimeoutMs;
-    private readonly log;
-    /** Latest capabilities announce per deviceId. */
-    private capabilities;
-    /** Latest device list from the broker's `all-devices-update`. */
-    private devices;
-    /**
-     * The device this session last named explicitly. Agents name a device once,
-     * then leave deviceId out on later calls; with several apps connected every
-     * one of those calls failed ("Multiple devices connected"), which cost a
-     * turn at the start of almost every benchmark run. An explicit id sets it,
-     * and so does the project-folder match in resolveDevice. It never switches on its own: if that device goes away, calls
-     * without an id fail instead of picking another app.
-     */
-    private sessionDevice;
-    /** Latest snapshot payload per `${deviceId}::${toolId}`. */
-    private snapshots;
-    /**
-     * Capture-mode watches this client holds, keyed by snapKey. Stored with
-     * their addressing because they have to be RE-SENT on every reconnect: the
-     * broker keys watch state by socket id, and a reconnect gets a new one.
-     */
-    private watching;
-    /** In-flight actions awaiting a result, keyed by requestId. */
-    private pendingActions;
-    /** Callbacks waiting for the next snapshot of `${deviceId}::${toolId}`. */
-    private snapshotWaiters;
-    /** When each cached snapshot arrived, keyed by snapKey (staleness reporting). */
-    private snapshotAt;
-    /** Liveness per device — see {@link noteTimeout}. */
-    private health;
-    /** Dev-server origin per device — see {@link noteDevServerOrigin}. */
-    private devServerOrigins;
-    /** Newest crash-report console entry id seen per device — see {@link noteCrashReport}. */
-    private crashSeen;
-    /** Lookups still working out a device's dev-server folder (origin probe, then lsof). */
-    private rootLookups;
-    /** Folder each device's dev server runs from — see {@link devServerRoot}. */
-    private devServerRoots;
-    /** Devices whose origin probe already ran (a production bundle has none). */
-    private originProbed;
-    /** Last time each device appeared in the broker's device list. */
-    private lastSeen;
-    constructor(opts?: SyncClientOptions);
-    private readonly autoSpawn;
-    /** Connect to a running broker, or spawn one in-process, then handshake. */
-    start(): Promise<BrokerMode>;
-    private connectSocket;
-    /**
-     * Drop everything remembered about devices that have been gone a while.
-     *
-     * Deliberately NOT on disconnect: a crashed app often drops off the broker,
-     * and its cached console snapshot is the crash evidence — throwing that away
-     * the instant it disconnects would delete the answer. But device ids change
-     * with every simulator erase and fresh dev client, and each one can hold
-     * multi-MB snapshots, so a long-lived server has to forget eventually.
-     */
-    /** Whether the broker admitted this host's Buoy account. */
-    isAdmitted(): boolean;
-    private requireAdmission;
-    private transportLost;
-    private setAdmission;
-    private requireDeviceAccount;
-    private lockDevice;
-    private pruneStaleDevices;
-    /** Disconnect and tear down a spawned broker, if any. */
-    stop(): Promise<void>;
-    /** All devices the broker knows about, merged with their advertised tools. */
-    listDevices(): DeviceInfo[];
-    /** Connected devices only. */
-    connectedDevices(): DeviceInfo[];
-    /** Actions advertised for a tool, with the devices offering it. */
-    toolActions(toolId: string): {
-        deviceId: string;
-        deviceName: string;
-        actions: string[];
-    }[];
-    /**
-     * This project's own connected app, if the broker has admitted it. Picks
-     * nothing for the session; for warming up host tools before the first call.
-     */
-    peekProjectDevice(): string | null;
-    /**
-     * Resolve a concrete target deviceId. If `deviceId` is given it's used as-is.
-     * Otherwise, if exactly one device is connected, that one is chosen; if none
-     * or many, an informative error is thrown (callers can pass "All" explicitly).
-     */
-    resolveDevice(deviceId?: string): string;
-    /**
-     * Resolve a target device AND require the tier the current tool call needs.
-     * Most tools need Buoy Pro; the free ones (access/policy.ts) also take an app
-     * on the free tier. The level comes from the call's scope, set centrally in
-     * server.ts before any handler runs, so a handler can't pick its own. With no
-     * scope (work outside any tool call) the level is Pro. The app's own license
-     * check is the source of truth (the device reports it over the broker); this
-     * just reads it.
-     *
-     * `list_devices` deliberately does NOT call this — a user without access can
-     * still see their device and its tier, which explains what is blocked.
-     */
-    requireProDevice(deviceId?: string): string;
-    /**
-     * The check under every app call (callAction, getSnapshot, the snapshot
-     * cache, lastSync), on top of requireProDevice. A call to a Pro app always
-     * passes. A call to any other app passes only inside a free tool call and
-     * only for the app calls listed in access/policy.ts, so a Pro tool that
-     * forgot requireProDevice still can't act on a free app, and a free tool
-     * can't reach Pro data by any path. Work outside any tool call (reconnects,
-     * health pings) is plumbing and passes.
-     */
-    private checkAppCall;
-    /**
-     * A free app's tap must land on the app, not on Buoy's own panels: their
-     * controls do what Pro tools do. The app side leaves Buoy out of fuzzy
-     * matches but lets an exact testID or nativeTag through, so on a free app an
-     * exact tap goes through only when the app-only screen list shows that
-     * target. Anything this can't prove (a Buoy control, an off-screen target, a
-     * failed read, a broadcast to "All") is refused. Resolves to replacement
-     * params when it narrows the tap (never edits the caller's object, which a
-     * flow reuses on retries). Returns null, without an await, for every call it
-     * doesn't apply to.
-     */
-    private refuseBuoyPanelTap;
-    /**
-     * Whether a result for this device may carry Pro's why-data (render names,
-     * script names, JS origins). True for a Pro key or the Weekend Pass. A free
-     * tool works on a free app too; this decides how much of its result it
-     * gets (access/freeView.ts).
-     */
-    fullResultsFor(deviceId: string): boolean;
-    /**
-     * Whether this device was seen on a tier good enough for the current call,
-     * connected or not. For host controls that keep working after the app
-     * quits or crashes (see hostKit), and for the last-sync fallback.
-     */
-    deviceWasAllowed(deviceId: string): boolean;
-    /**
-     * Where a device stands for `level` (the current call's by default):
-     * connected and allowed ("ready"), not connected ("offline"), connected but
-     * its account not announced yet ("pending"), or announced on a tier without
-     * this access ("denied").
-     */
-    accessState(deviceId: string, level?: AccessLevel): "ready" | "offline" | "pending" | "denied";
-    private healthOf;
-    /** The device answered — it's alive. */
-    private noteOk;
-    /**
-     * The device didn't answer. A crashed app never answers again, so after the
-     * first miss we stop paying the full timeout on every subsequent call.
-     */
-    private noteTimeout;
-    /** True once a device has missed TWO calls and hasn't answered since. */
-    isUnresponsive(deviceId: string): boolean;
-    /**
-     * Full timeout normally; a short one for a device already not answering.
-     *
-     * A single missed call does not trigger the short budget — one slow
-     * `describeScreen` is not a crash. `app.ping` / `app.reloadApp` always get
-     * the full budget (they are the recovery path).
-     *
-     * Escape hatch: every RECOVERY_PROBE_MS a flagged device gets the full
-     * budget again so the short timeout cannot become self-sustaining.
-     */
-    private timeoutFor;
-    /**
-     * Plain-language diagnosis for a device that isn't answering, including the
-     * app's last words if the console tool got a crash flush out in time.
-     *
-     * A silent timeout is the worst possible answer here: the app is on a redbox,
-     * the reason is already captured, and without this the caller reads "timed
-     * out" and keeps retrying the same dead device.
-     */
-    unresponsiveNote(deviceId: string): string;
-    /**
-     * A fresh crash report from the console tool (its crash flush runs as the
-     * app's React tree dies) means actions waiting on that device will likely
-     * never be answered: navigate to a screen that throws used to sit out its
-     * full 15 s. Cut their wait to the short leash instead of failing them at
-     * once, and only after a ping goes unanswered: an ErrorBoundary can catch a
-     * render error and the app lives.
-     */
-    private noteCrashReport;
-    /**
-     * The newest error line the console tool synced for this device, if any.
-     * Reads the cached console snapshot rather than the device (which, by the
-     * time this matters, is not answering).
-     */
-    private lastFatalFor;
-    /** Age of the cached snapshot for a tool, in ms (null = never received). */
-    snapshotAgeMs(toolId: string, deviceId: string): number | null;
-    /**
-     * Remember where a device's bundle came from, reported by core's `app`
-     * adapter while the app is healthy. It is the only way to reload an app that
-     * has crashed: the in-app reload needs the React tree that the crash
-     * destroyed, but the dev server's reload is handled natively.
-     */
-    noteDevServerOrigin(deviceId: string, origin: unknown): void;
-    /**
-     * Ask a freshly-announced device where its bundle came from, once.
-     *
-     * Deliberately eager: this is the piece of information that can ONLY be
-     * collected while the app is healthy, and is only ever needed after it has
-     * stopped answering. One cheap round-trip per device buys the ability to
-     * recover a crashed app instead of telling the caller to go do it by hand.
-     */
-    private learnDevServerOrigin;
-    private trackRootLookup;
-    /**
-     * Wait (briefly) for project-folder lookups still running, so an agent's
-     * first call right after apps connect can still be matched to this
-     * project's app instead of failing with "Multiple devices connected". Only
-     * worth it when no device is chosen yet and several apps are connected.
-     */
-    /**
-     * Right after the MCP starts, the broker may not have admitted this client
-     * yet: a first call then failed with "A verified Buoy account ... required"
-     * although the account is fine. Every call gives admission (and the first
-     * device list) a moment; once admitted this returns at once.
-     */
-    awaitBroker(): Promise<void>;
-    settleDeviceChoice(maxMs?: number): Promise<void>;
-    /** The dev-server origin last reported by this device, if any. */
-    devServerOrigin(deviceId: string): string | null;
-    /**
-     * Keep the device RECORDING this tool, without asking it to stream.
-     *
-     * A dashboard watches for as long as its panel is open; this client is
-     * request/response, so it used to watch and unwatch around every single
-     * read. That works for a tool whose state just IS (the query cache, the env
-     * table) and is useless for one that records a timeline: the unwatch drops
-     * the device's subscriber count to zero, which stops capture, so nothing is
-     * ever recorded between two reads. The list comes back empty and reads as
-     * "the app made no requests" — a wrong conclusion that is very expensive to
-     * chase, because everything about the app looks fine.
-     *
-     * Capture-mode watches are held for the life of the connection and released
-     * on disconnect (the broker also drops them for us). They cost the device's
-     * ring buffer, not the socket: no snapshot is pushed, and reads still go
-     * through `request-devtool-state`.
-     */
-    private ensureWatching;
-    private sendWatch;
-    /**
-     * Re-arm every held watch after a reconnect.
-     *
-     * The broker tracks watches per SOCKET, so a reconnect (broker restart, a
-     * dropped wifi link) silently discards all of ours while `watching` still
-     * says we hold them — `ensureWatching` would then short-circuit forever and
-     * the device would never record again. Silent and permanent: the exact
-     * failure this whole capture-mode change exists to remove.
-     */
-    private rearmWatches;
-    /** Each device's current connection (socket id + nonce), to spot a reload. */
-    private deviceConnections;
-    /**
-     * Re-arm the watches for a device that came back on a NEW connection.
-     *
-     * A relaunch or JS reload gives the app a fresh socket and fresh adapters,
-     * whose capture starts switched off. Our watches still say "held", so
-     * `ensureWatching` short-circuited and the device never recorded again: after
-     * one restart, the storage timeline stayed empty for the rest of the session
-     * (found by the BK storage suite — every case after a relaunch read nothing).
-     */
-    private rearmReconnectedDevices;
-    /** Stop streaming a tool (releases the device-side backpressure). */
-    unwatch(toolId: string, targetDeviceId: string): void;
-    /** Last snapshot received for a tool/device, if any. */
-    cachedSnapshot(toolId: string, deviceId: string): unknown;
-    /**
-     * Get a tool's current state: arm capture (once, for the connection), ask
-     * for state explicitly, and resolve with the snapshot that comes back.
-     * Falls back to the last cached snapshot if the request times out.
-     *
-     * The capture watch is deliberately NOT released afterwards — see
-     * `ensureWatching`. It costs the device nothing on the socket, and dropping
-     * it is what made every timeline tool look permanently empty from here.
-     */
-    getSnapshot(toolId: string, deviceId?: string, opts?: {
-        timeoutMs?: number;
-        silent?: boolean;
-    }): Promise<{
-        deviceId: string;
-        payload: unknown;
-        stale?: string;
-    }>;
-    /**
-     * The last snapshot a device sent for a tool, kept after the device drops
-     * off. A fatal render error tears down the app's React tree, and Buoy's
-     * connection with it; @buoy-gg/console flushes its logs out first, so this
-     * is where the app's last words are once it can no longer be asked.
-     */
-    lastSync(deviceId: string, toolId: string): {
-        payload: unknown;
-        ageMs: number | null;
-    } | undefined;
-    /** Header line for data served from cache because the device went quiet. */
-    private staleNote;
-    private waitForSnapshot;
-    /**
-     * Invoke a remote action on a device and await its result. Pass deviceId to
-     * target one device, or "All" to broadcast (resolves with the first responder).
-     */
-    callAction(toolId: string, action: string, params?: unknown, deviceId?: string, opts?: {
-        timeoutMs?: number;
-        silent?: boolean;
-    }): Promise<unknown>;
-}
+import '@buoy-gg/sync-broker';
 
 declare function createMcpServer(sync: SyncClient): McpServer;
 
@@ -998,4 +632,9 @@ declare const DASHBOARD_NAME = "Dashboard";
 /** Target token meaning "every connected device". */
 declare const ALL_DEVICES = "All";
 
-export { ALL_DEVICES, BROKER_PORT, BROKER_URL, type BrokerMode, DASHBOARD_NAME, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_SNAPSHOT_TIMEOUT_MS, type DeviceInfo, type InitOptions, PACKAGE_NAME, SyncClient, type SyncClientOptions, VERSION, buildAutomationConfig, compareReportStats, createMcpServer, estimateBatchMs, formatRankingMarkdown, getUpdateNotice, rankBatchFromIndex, registerConsoleTools, registerEventsTools, registerGenericTools, registerJotaiTools, registerPerfMonitorTools, registerReactQueryTools, registerReduxTools, registerRoutesTools, registerScreenshotTools, registerStorageTools, registerZustandTools, runInit };
+/** Runs on the chosen device. A suspect is a clue, not proof of a leak. */
+declare function registerMemoryLeaksTools(server: McpServer, sync: SyncClient): void;
+
+declare function registerOtaTools(server: McpServer, sync: SyncClient): void;
+
+export { ALL_DEVICES, BROKER_PORT, BROKER_URL, DASHBOARD_NAME, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_SNAPSHOT_TIMEOUT_MS, type InitOptions, PACKAGE_NAME, SyncClient, VERSION, buildAutomationConfig, compareReportStats, createMcpServer, estimateBatchMs, formatRankingMarkdown, getUpdateNotice, rankBatchFromIndex, registerConsoleTools, registerEventsTools, registerGenericTools, registerJotaiTools, registerMemoryLeaksTools, registerOtaTools, registerPerfMonitorTools, registerReactQueryTools, registerReduxTools, registerRoutesTools, registerScreenshotTools, registerStorageTools, registerZustandTools, runInit };