@buoy-gg/mcp 7.0.78 → 7.0.79

package/dist/SyncClient-gqMRmB79.d.ts

@@ -0,0 +1,374 @@
+import { ToolCapability } from '@buoy-gg/sync-broker';
+
+type AccessLevel = "free" | "pro";
+
+interface SyncClientOptions {
+    /** Token supplied by an embedded host. Never read or write a token file. */
+    dashboardToken?: string;
+    /** 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;
+    private readonly dashboardToken?;
+    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>;
+}
+
+export { type BrokerMode as B, type DeviceInfo as D, SyncClient as S, type SyncClientOptions as a };

package/dist/{chunk-LHGIYW7N.mjs → chunk-3FTJ74HL.mjs}

@@ -1,4 +1,4 @@
-import{createRequire as A}from"module";const G=A(import.meta.url);import{PACKAGE_NAME as l,VERSION as v}from"./chunk-3STZVJQG.mjs";import{spawnSync as m}from"child_process";import s from"fs";import E from"os";import c from"path";function g(){return{BUOY_VERIFY:"auto"}}var w="https://registry.npmjs.org";var f=3e3;function R(e={}){const t=e.cwd??process.cwd();const r=e.skillSrcDir??c.resolve(__dirname,"../skill");const n=e.log??(a=>process.stdout.write(a+"\n"));const o=k(e,n);const i=[];d(c.join(t,".mcp.json"),"mcpServers",o,t,i);s.mkdirSync(c.join(t,".cursor"),{recursive:true});d(c.join(t,".cursor","mcp.json"),"mcpServers",o,t,i);if(s.existsSync(c.join(t,".vscode"))){d(c.join(t,".vscode","mcp.json"),"servers",o,t,i)}D(r,t,i);x(c.join(t,"CLAUDE.md"),t,i);x(c.join(t,"AGENTS.md"),t,i);n("Buoy MCP configuration written:");for(const a of i)n("  \u2022 "+a);n("");n("Next steps:");n("  1. Restart your editor (or reconnect the MCP server) to load `buoy`.");n("  2. Sign in: run `npx --package=@buoy-gg/core buoy login` in your app's folder. Then open an app with the required Buoy tools and sync integration.");n("  3. Confirm the device and tools are available. Free accounts get the basic MCP tools; Pro adds the rest.");n("");n(`Want your AI to use the web too? Run \`npx -y ${l}@latest init --web\` for Buoy Web (free, no account).`);if(o.command==="npx"){n("");n(`The editor launches the server with \`npx -y ${l}@latest\`, so it stays`);n(`Registry access may be needed. Re-run \`npx -y ${l}@latest init\` to refresh configuration.`)}else if(!e.cliPath){n("");n(`This uses a pinned local install (no network on startup). To update it later,`);n(`To update the local package, run: npx -y ${o.args[0]?.replace(/dist[/\\]cli\.js$/,"")??""}@latest init --local`)}}function k(e,t){if(e.cliPath){return{type:"stdio",command:"node",args:[e.cliPath],env:g()}}const r=e.mode??"auto";if(r==="npx"){return y()}if(r==="local"){return $(e,t)}const n=I();if(n.reachable){return y()}t(`\u26A0 npm registry ${n.registry?`(${n.registry}) `:""}looks unreachable \u2014 \`npx @latest\` would hang your editor at startup. Falling back to a pinned local install.`);return $(e,t)}function y(){return{type:"stdio",command:"npx",args:["-y",`${l}@latest`],env:g()}}function $(e,t){const r=e.installDir??process.env.BUOY_MCP_HOME??c.join(E.homedir(),".buoy-mcp");const n=e.registry??w;const o=C(r,n,t);if(o){return{type:"stdio",command:"node",args:[o],env:g()}}t("\u26A0 local install failed \u2014 writing the npx entry instead (see the error above).");return y()}function C(e,t,r){const n=`${l}@${v==="0.0.0-dev"?"latest":v}`;s.mkdirSync(e,{recursive:true});const o=process.platform==="win32"?"npm.cmd":"npm";r(`Installing ${n} into ${e} from ${t} \u2026`);const i=m(o,["install",n,"--prefix",e,"--registry",t,`--@buoy-gg:registry=${t}`,"--no-audit","--no-fund","--loglevel=error"],{stdio:["ignore","ignore","inherit"],encoding:"utf8"});if(i.status!==0){r(`\u26A0 npm install exited with code ${i.status??"?"}${i.error?` (${i.error.message})`:""}.`);return null}const a=c.join(e,"node_modules",l,"dist","cli.js");if(!s.existsSync(a)){r(`\u26A0 install finished but ${a} is missing.`);return null}return a}function I(){const e=P();if(!e)return{reachable:false,registry:null};if(/^https?:\/\/registry\.npmjs\.org\/?$/i.test(e)){return{reachable:true,registry:e}}return{reachable:T(e),registry:e}}function P(){const e=S("@buoy-gg:registry");if(e)return e;const t=S("registry");return t??w}function S(e){const t=process.platform==="win32"?"npm.cmd":"npm";const r=m(t,["config","get",e],{encoding:"utf8",timeout:f});if(r.status!==0||typeof r.stdout!=="string")return null;const n=r.stdout.trim();if(!n||n==="undefined"||n==="null")return null;return n}function T(e){const t=m(process.execPath,["-e",F,e,String(f)],{encoding:"utf8",timeout:f+2e3});return t.status===0}var F=`
+import{createRequire as A}from"module";const G=A(import.meta.url);import{PACKAGE_NAME as l,VERSION as v}from"./chunk-SGVMY5TU.mjs";import{spawnSync as m}from"child_process";import s from"fs";import E from"os";import c from"path";function g(){return{BUOY_VERIFY:"auto"}}var w="https://registry.npmjs.org";var f=3e3;function R(e={}){const t=e.cwd??process.cwd();const r=e.skillSrcDir??c.resolve(__dirname,"../skill");const n=e.log??(a=>process.stdout.write(a+"\n"));const o=k(e,n);const i=[];d(c.join(t,".mcp.json"),"mcpServers",o,t,i);s.mkdirSync(c.join(t,".cursor"),{recursive:true});d(c.join(t,".cursor","mcp.json"),"mcpServers",o,t,i);if(s.existsSync(c.join(t,".vscode"))){d(c.join(t,".vscode","mcp.json"),"servers",o,t,i)}D(r,t,i);x(c.join(t,"CLAUDE.md"),t,i);x(c.join(t,"AGENTS.md"),t,i);n("Buoy MCP configuration written:");for(const a of i)n("  \u2022 "+a);n("");n("Next steps:");n("  1. Restart your editor (or reconnect the MCP server) to load `buoy`.");n("  2. Sign in: run `npx --package=@buoy-gg/core buoy login` in your app's folder. Then open an app with the required Buoy tools and sync integration.");n("  3. Confirm the device and tools are available. Free accounts get the basic MCP tools; Pro adds the rest.");n("");n(`Want your AI to use the web too? Run \`npx -y ${l}@latest init --web\` for Buoy Web (free, no account).`);if(o.command==="npx"){n("");n(`The editor launches the server with \`npx -y ${l}@latest\`, so it stays`);n(`Registry access may be needed. Re-run \`npx -y ${l}@latest init\` to refresh configuration.`)}else if(!e.cliPath){n("");n(`This uses a pinned local install (no network on startup). To update it later,`);n(`To update the local package, run: npx -y ${o.args[0]?.replace(/dist[/\\]cli\.js$/,"")??""}@latest init --local`)}}function k(e,t){if(e.cliPath){return{type:"stdio",command:"node",args:[e.cliPath],env:g()}}const r=e.mode??"auto";if(r==="npx"){return y()}if(r==="local"){return $(e,t)}const n=I();if(n.reachable){return y()}t(`\u26A0 npm registry ${n.registry?`(${n.registry}) `:""}looks unreachable \u2014 \`npx @latest\` would hang your editor at startup. Falling back to a pinned local install.`);return $(e,t)}function y(){return{type:"stdio",command:"npx",args:["-y",`${l}@latest`],env:g()}}function $(e,t){const r=e.installDir??process.env.BUOY_MCP_HOME??c.join(E.homedir(),".buoy-mcp");const n=e.registry??w;const o=C(r,n,t);if(o){return{type:"stdio",command:"node",args:[o],env:g()}}t("\u26A0 local install failed \u2014 writing the npx entry instead (see the error above).");return y()}function C(e,t,r){const n=`${l}@${v==="0.0.0-dev"?"latest":v}`;s.mkdirSync(e,{recursive:true});const o=process.platform==="win32"?"npm.cmd":"npm";r(`Installing ${n} into ${e} from ${t} \u2026`);const i=m(o,["install",n,"--prefix",e,"--registry",t,`--@buoy-gg:registry=${t}`,"--no-audit","--no-fund","--loglevel=error"],{stdio:["ignore","ignore","inherit"],encoding:"utf8"});if(i.status!==0){r(`\u26A0 npm install exited with code ${i.status??"?"}${i.error?` (${i.error.message})`:""}.`);return null}const a=c.join(e,"node_modules",l,"dist","cli.js");if(!s.existsSync(a)){r(`\u26A0 install finished but ${a} is missing.`);return null}return a}function I(){const e=P();if(!e)return{reachable:false,registry:null};if(/^https?:\/\/registry\.npmjs\.org\/?$/i.test(e)){return{reachable:true,registry:e}}return{reachable:T(e),registry:e}}function P(){const e=S("@buoy-gg:registry");if(e)return e;const t=S("registry");return t??w}function S(e){const t=process.platform==="win32"?"npm.cmd":"npm";const r=m(t,["config","get",e],{encoding:"utf8",timeout:f});if(r.status!==0||typeof r.stdout!=="string")return null;const n=r.stdout.trim();if(!n||n==="undefined"||n==="null")return null;return n}function T(e){const t=m(process.execPath,["-e",F,e,String(f)],{encoding:"utf8",timeout:f+2e3});return t.status===0}var F=`
 const url = process.argv[1];
 const ms = Number(process.argv[2]) || 3000;
 const c = new AbortController();

package/dist/{chunk-XA74T4JN.mjs → chunk-5XATNNKY.mjs}

@@ -1,4 +1,4 @@
-import{createRequire as U}from"module";const X=U(import.meta.url);import{FarmError as k,agentLabel as E,connectFarm as O,detectAgent as $,findDataContainer as G,nodeLauncher as j,readBuoyInstallId as C}from"./chunk-ODGXMS2O.mjs";import{readEntitlement as N}from"./chunk-5NOZVPWB.mjs";import L from"os";import z from"path";import{z as o}from"zod";function A(t){if(N().admitted)return true;if(!t)return false;if(t.isAdmitted?.())return true;return t.connectedDevices().some(i=>i.isPro===true||i.tier==="free")}function P(t){return`\`${t}\` needs a Buoy account. A free one works.
+import{createRequire as U}from"module";const X=U(import.meta.url);import{FarmError as k,agentLabel as E,connectFarm as O,detectAgent as $,findDataContainer as G,nodeLauncher as j,readBuoyInstallId as C}from"./chunk-FYJWWTAC.mjs";import{readEntitlement as N}from"./chunk-5NOZVPWB.mjs";import L from"os";import z from"path";import{z as o}from"zod";function A(t){if(N().admitted)return true;if(!t)return false;if(t.isAdmitted?.())return true;return t.connectedDevices().some(i=>i.isPro===true||i.tier==="free")}function P(t){return`\`${t}\` needs a Buoy account. A free one works.
 
 Tell the user to sign in to Buoy Desktop, or run \`npx --package=@buoy-gg/core buoy login\` in the project. Then run this again.`}var W=t=>({content:[{type:"text",text:t}]});var f=t=>({isError:true,content:[{type:"text",text:t}]});var u=t=>W(JSON.stringify(t,null,2));var x;var I=t=>A(x)?null:f(P(t));var v=null;var R=()=>void 0;function _(){if(!v){v=$({clientName:R()}).catch(()=>void 0).then(t=>O({label:process.env.BUOY_AGENT_LABEL||(t?E(t):"Buoy MCP"),agent:t,launcher:j(process.argv[1],["farmd"])})).catch(t=>{v=null;throw t})}return v}async function l(t,i,e,r){return(await _()).call(t,i,{timeoutMs:e,requestId:r})}var c=[];function M(t){for(let i=c.length-1;i>=0;i--)if(t(c[i]))c.splice(i,1)}async function H(t,i){const e=()=>c.find(n=>n.buoyDeviceId&&t.endsWith(n.buoyDeviceId));let r=e();if(!r&&c.length){await K().catch(()=>void 0);r=e()}if(!r)return null;try{return{checked:true,...await l("fairness",{leaseId:r.leaseId,epoch:r.epoch,windows:i},3e4)}}catch(n){if(n instanceof k&&n.code==="BAD_REQUEST"&&/Unknown method/.test(n.message)){return{checked:false,why:"This farm is too old to check fairness. Restart Buoy Desktop when the farm is idle."}}return{checked:false,why:n instanceof k?`${n.code}: ${n.message}`:String(n?.message??n)}}}async function K(){const t=await l("status");const i=new Set(c.map(e=>e.leaseId));for(const e of t.android?.copies??[]){if(!e.leaseId||!i.has(e.leaseId))continue;let r=c.find(n=>n.udid===e.udid);if(!r){const n=c.find(s=>s.leaseId===e.leaseId);r={...n,udid:e.udid,buoyDeviceId:void 0};c.push(r)}if(e.buoyDeviceId)r.buoyDeviceId=e.buoyDeviceId}for(const e of t.sims){if(!e.leaseId||!i.has(e.leaseId))continue;let r=c.find(h=>h.udid===e.udid);if(!r){const h=c.find(b=>b.leaseId===e.leaseId);r={...h,udid:e.udid,buoyDeviceId:void 0};c.push(r)}if(e.buoyDeviceId){r.buoyDeviceId=e.buoyDeviceId;continue}const n=t.templates.find(h=>h.id===e.templateId)?.bundleId;const s=z.join(L.homedir(),"Library/Developer/CoreSimulator/Devices",e.udid,"data");const a=n?await G(s,n):null;const d=a?await C(a):null;if(d)r.buoyDeviceId=d}}function y(t){if(t instanceof k&&t.code==="RUN_STOPPED"){return f('RUN_STOPPED: The person stopped this run in Buoy Desktop (reason=user). Stop work on it. Tell them: "You stopped this run in Sims." Start a new run only if they ask.')}if(t instanceof k)return f(`${t.code}: ${t.message}${t.next?`
-Next: ${t.next}`:""}`);return f(`Sim Farm error: ${t?.message??t}`)}var D={leaseId:o.string().describe("The lease id from sim_farm_acquire."),epoch:o.number().int().describe("The epoch from sim_farm_acquire. A stale epoch is refused.")};var S=o.string().optional().describe("Any unique string for this call. Repeating the same call with the same requestId returns the first result instead of acting twice.");var T=o.string().describe("The runId from sim_farm_acquire.");async function Y(t,i,e){const r=new Map;const n=Date.now()+e;for(;;){for(const s of i){if(r.has(s))continue;const a=t.connectedDevices().find(d=>d.deviceId.endsWith(s)&&d.tier!=="checking");if(a)r.set(s,a.deviceId)}if(r.size===i.length||Date.now()>=n)return r;await new Promise(s=>setTimeout(s,500))}}async function F(t){const i=await l("status");const e=t==="android"?i.android?.templates??[]:i.templates??[];return e.filter(r=>r.usable).sort((r,n)=>String(r.createdAt).localeCompare(String(n.createdAt))).pop()?.id}async function q(){(await _()).require("android")}var B=o.enum(["ios","android"]).optional().describe("ios (default) or android. Android copies are emulators started from a saved snapshot.");function J(t,i){R=()=>t.server.getClientVersion()?.name;x=i;t.registerTool("sim_farm_status",{description:"Show the Sim Farm: how many farm simulators exist, which are awake or in use and by whom, free memory and disk, how many more sims fit, templates, leases, and recent events. Farm sims are slim iOS simulators (about 1.5 GB each instead of 5) that the farm makes from a template. `android` lists Android templates (with `roomFor` and `costGB` per copy) and running Android copies: slim emulators that start from a saved snapshot in about 2 s with the app on them. Apps launch as a real phone (an iPhone SE, 2nd gen, by default): they see its RAM and cores and get its memory warnings. Each sim's `phone` shows the app's peak memory, and `overLimit: true` means a real phone would have closed the app. A safety cap closes an app that keeps growing. Start here before sim_farm_acquire. Set `outside` to also list this Mac's other simulators, which the farm never touches.",inputSchema:{outside:o.boolean().optional().describe("Also list simulators the farm does not own.")}},async({outside:e})=>{try{return u(await l("status",{outside:!!e}))}catch(r){return y(r)}});t.registerTool("sim_farm_setup",{description:"Create or resize the Sim Farm. `create` makes a template sim from an app build and, optionally, a seed folder (signed-in app data); clones are made from it in about 4 s each. Dev-client apps (Expo) need `launchUrl` so they open on Metro instead of the launcher. `grow` / `shrink` change how many sims exist. Use `dryRun` first: it returns the plan, what slim mode turns off (push, StoreKit, app links, widgets, Spotlight\u2026) and whether the Mac has room. You own the pool: Buoy Desktop has no size control. sim_farm_acquire makes sims as needed; `shrink` the ones you no longer need so they stop using disk space.",inputSchema:{mode:o.enum(["create","grow","shrink"]).describe("create = new template; grow/shrink = pool size (iOS only)."),platform:B,apkPath:o.string().optional().describe("Android create: path to the app's .apk. A debug build lets the farm read each copy's Buoy id."),phone:o.string().optional().describe("Android create: the phone copies act like (RAM, cores, screen, app memory limit). Default android-3gb. See `farm android phone list`."),reverse:o.array(o.string().regex(/^\d{1,5}(:\d{1,5})?$/)).optional().describe('Android create: ports each copy forwards to this Mac, e.g. ["8081:8802"] so a dev build loads JS from Metro on 8802.'),templateId:o.string().optional().describe("For grow/shrink. Defaults to the newest usable template."),count:o.number().int().min(1).max(64).optional().describe("For grow/shrink: how many sims to add or remove."),appPath:o.string().optional().describe("For create: path to a simulator .app build."),seedDir:o.string().nullable().optional().describe("For create: seed folder (Documents/, AsyncStorage/, Preferences/, seed.json). null = no seed."),launchUrl:o.string().optional().describe("For create: URL opened after each launch, e.g. exp+my-app://expo-development-client/?url=http%3A%2F%2Flocalhost%3A8081."),deviceType:o.string().optional().describe("For create: a simctl device type id. Default iPhone 17 Pro."),runtime:o.string().optional().describe("For create: a simctl runtime id. Default iOS 26.3."),profile:o.enum(["slim","stock"]).optional().describe("For create: slim (default) or stock."),metroPort:o.number().int().min(1).max(65535).optional().describe("For create: the Metro port the app loads from. Default 8802."),dryRun:o.boolean().optional().describe("Return the plan and its cost without changing anything."),requestId:S}},async e=>{const r=I("sim_farm_setup");if(r)return r;try{if(e.platform==="android"){await q();if(e.mode!=="create")return f("Android copies have no pool to grow or shrink: sim_farm_acquire starts them and release closes them.");if(!e.apkPath)return f("Android create needs apkPath.");const a={platform:"android",apk:e.apkPath,phoneId:e.phone,reverse:e.reverse,...e.launchUrl?{launchUrl:e.launchUrl}:{}};if(e.dryRun)return u({wouldCreateTemplate:a,note:"Needs the Android SDK first: npx @buoy-gg/mcp farm android setup (a person accepts Google's license there).",budget:await l("budget",{ramGB:4.3,diskGB:4})});return u(await l("setup",a,30*6e4,e.requestId))}if(e.mode==="create"){const a={appPath:e.appPath,seedDir:e.seedDir,deviceType:e.deviceType??"com.apple.CoreSimulator.SimDeviceType.iPhone-17-Pro",runtime:e.runtime??"com.apple.CoreSimulator.SimRuntime.iOS-26-3",profile:e.profile??"slim",metroPort:e.metroPort??8802,...e.launchUrl?{launchUrl:e.launchUrl}:{}};if(!a.appPath)return f("create needs appPath.");if(a.seedDir===void 0)return f("create needs seedDir, or seedDir: null for an app with no seed.");if(e.dryRun)return u({wouldCreateTemplate:a,budget:await l("budget",{ramGB:6,diskGB:4})});return u(await l("setup",a,15*6e4,e.requestId))}const n=e.templateId??await F("ios");if(!n)return f("No usable template yet. Run sim_farm_setup with mode create first.");const s=e.count??1;if(e.dryRun){const a=await l("budget",{ramGB:0,diskGB:e.mode==="grow"?2*s:0});return u({mode:e.mode,templateId:n,count:s,roomForMoreSims:a.roomFor,ok:a.ok,reason:a.reason})}return u(await l(e.mode,{templateId:n,count:s},30*6e4,e.requestId))}catch(n){return y(n)}});t.registerTool("sim_farm_acquire",{description:"Take farm simulators for your work. The person watches your work live in Buoy Desktop, so give a clear `goal` and a `labels` entry per sim. Returns a run (runId, deadlineAt), a lease (leaseId + epoch) and exact sims (UDID, name, and buoyDeviceId once the app ran: the 8-character tail that its list_devices id ends with; with launch, also deviceId, the full id to pass to other tools). Parked sims are booted and new ones cloned as needed, within the Mac's memory and disk limits. This MCP keeps the lease alive while it runs; release it with sim_farm_finish when done. Only ever target the returned UDIDs: never `booted`, which picks a random simulator when many run. While working, send sim_farm_report when a sim starts, passes or fails. The run stops at deadlineAt unless you ask for more time with sim_farm_extend. If any call returns RUN_STOPPED, the person stopped you: stop and tell them.",inputSchema:{count:o.number().int().min(1).max(64).describe("How many sims. There is no fixed cap: the farm gives as many as this Mac's memory and disk allow. Use allowPartial to take what fits."),goal:o.string().max(200).optional().describe("One short sentence the person sees on the run card, e.g. 'Make the menu list scroll faster'. With runId, the run's goal is used if you leave this out."),labels:o.array(o.string().max(80)).optional().describe("One label per sim, in order, e.g. ['Idea 1: memo rows', 'Idea 2: flat list']."),kind:o.enum(["try-ideas","run-tests","reproduce-bug","explore"]).optional().describe("What sort of work this is."),runId:o.string().optional().describe("Add these sims to a run you already have, instead of starting a new one."),purpose:o.string().optional().describe("Old name for goal. Use goal."),templateId:o.string().optional().describe("Defaults to the newest usable template of the platform."),platform:B,launch:o.boolean().optional().describe("Launch the app on each sim and wait (up to about 30 s) until it joins Buoy. Each sim then has deviceId for other tools."),allowPartial:o.boolean().optional().describe("Return fewer sims than asked instead of failing."),waitSeconds:o.number().int().min(0).max(1800).optional().describe("Wait this long for sims to free up."),ttlMinutes:o.number().int().min(1).max(1440).optional().describe("How long the run may go. Default 15. Agents are capped (1 hour by default); ask for more later with sim_farm_extend."),requestId:S}},async e=>{const r=I("sim_farm_acquire");if(r)return r;try{if(e.platform==="android")await q();const n=e.templateId??await F(e.platform??"ios");if(!n){return f(e.platform==="android"?"No usable Android template yet. Run sim_farm_setup with platform android, mode create and apkPath.":"No usable template yet. Run sim_farm_setup with mode create first.")}let s=(e.goal??e.purpose??"").trim();if(!s&&e.runId)s=((await l("status")).runs??[]).find(m=>m.id===e.runId)?.goal??"";if(!s)return f("Give a goal: one short sentence about what you are doing.");const a=await _();const d=await a.acquire({templateId:n,count:e.count,purpose:s,goal:s,labels:e.labels,kind:e.kind,runId:e.runId,launch:e.launch,allowPartial:e.allowPartial,waitMs:(e.waitSeconds??0)*1e3,ttlMs:(e.ttlMinutes??15)*6e4,requestId:e.requestId});for(const m of d.sims){const w=c.findIndex(g=>g.udid===m.udid);if(w>=0)c.splice(w,1);c.push({leaseId:d.leaseId,epoch:d.epoch,runId:d.runId,udid:m.udid,buoyDeviceId:m.buoyDeviceId??void 0})}let h=d;if(e.launch&&i){const m=d.sims.map(p=>p.buoyDeviceId).filter(p=>!!p);const w=m.length?await Y(i,m,3e4):new Map;h={...d,sims:d.sims.map(p=>({...p,deviceId:p.buoyDeviceId&&w.get(p.buoyDeviceId)||null}))};const g=d.sims.filter(p=>p.buoyDeviceId&&!w.has(p.buoyDeviceId));if(g.length){h.warning=`The app started on ${g.map(p=>p.name).join(", ")} but has not joined Buoy after 30 s. Run list_devices again in a moment, or take a screenshot with sim_farm_action to see the screen.`}}const b=e.launch?d.sims.filter(m=>!m.buoyDeviceId):[];if(b.length){const m=(await l("status").catch(()=>null))?.templates?.find(g=>g.id===n);const w=m?.metroPort?` on port ${m.metroPort}`:"";return u({...h,warning:`The app did not report a Buoy id on ${b.map(g=>g.name).join(", ")}. It may still be loading, or Metro${w} may be down or broken. Check Metro${w}, then take a screenshot with sim_farm_action to see the screen.`})}return u(h)}catch(n){return y(n)}});t.registerTool("sim_farm_release",{description:"Give one lease's sims back. `fast` (default) stops the app and restores its seeded data in about 2 s; `full` rebuilds each sim from the template. Use `full` after anything changed OS settings (permissions, keychain, location) or after a crash. Releasing your last lease ends the run, unless `keepRun` is true. To end a run with a result, use sim_farm_finish instead.",inputSchema:{...D,reset:o.enum(["fast","full"]).optional(),keepRun:o.boolean().optional().describe("Keep the run open to take more sims into it later.")}},async e=>{try{const r=await _();const n=await r.release(e.leaseId,e.epoch,e.reset??"fast",e.keepRun===true);M(s=>s.leaseId===e.leaseId);return u(n)}catch(r){return y(r)}});t.registerTool("sim_farm_action",{description:"Act on sims in your lease: `screenshot` (returns file paths), `open-url` (deep link, pass `url`), `launch` the app, `reset` (restore seeded app data), or `rebuild` (fresh clone; the UDID changes, the result maps old to new). On an Android copy, `reset` and `rebuild` both swap in a fresh copy: the id changes and the result maps old to new. `install` puts a new .apk (pass `apkPath`) on Android copies; it is gone when the copy closes.",inputSchema:{...D,udids:o.array(o.string()).min(1).describe("UDIDs from your lease."),action:o.enum(["screenshot","open-url","launch","reset","rebuild","install"]),url:o.string().optional().describe("For open-url."),apkPath:o.string().optional().describe("For install (Android copies)."),requestId:S}},async e=>{const r=I("sim_farm_action");if(r)return r;try{const n=await l("action",{leaseId:e.leaseId,epoch:e.epoch,udids:e.udids,action:e.action,arg:e.action==="install"?e.apkPath:e.url},20*6e4,e.requestId);if(e.action==="reset"||e.action==="rebuild"){for(const[s,a]of Object.entries(n)){const d=c.find(h=>h.udid===s);if(d&&typeof a==="string"&&a!=="reset"&&a!==s)Object.assign(d,{udid:a,buoyDeviceId:void 0})}}return u(n)}catch(n){return y(n)}});t.registerTool("sim_farm_lock",{description:"Hold or free a Mac-wide lock tied to your lease. `perf-slot` is for fair speed tests: while you hold it the farm boots, clones and screenshots nothing else, and it records how busy the Mac is every second. It waits only for farm work in flight, not for other runs to end, so other sims and other apps may still use the Mac. run_benchmark_batch on your farm sim then marks each run fair or unfair from that record; run the unfair cases again. Measure only while you hold it. Other names guard shared test fixtures (e.g. `ask-buoy-gateway`, `shop`). Locks end with the lease.",inputSchema:{...D,name:o.string().regex(/^[a-z0-9-]{1,40}$/).describe("Lock name, e.g. perf-slot."),hold:o.boolean().describe("true = take it, false = free it."),waitSeconds:o.number().int().min(0).max(1800).optional()}},async e=>{const r=I("sim_farm_lock");if(r)return r;try{const n={leaseId:e.leaseId,epoch:e.epoch,name:e.name,waitMs:(e.waitSeconds??0)*1e3};return u(await l(e.hold?"lock":"unlock",n,(e.waitSeconds??0)*1e3+3e4))}catch(n){return y(n)}});t.registerTool("sim_farm_report",{description:"Tell the person how your run is going. They watch it live in Buoy Desktop. Send one when a sim starts work, passes, fails or needs help, with a short note. `counts` only when you know the full task list. Reports never add time. Pass an increasing `sequence` so a retry is never counted twice.",inputSchema:{runId:T,udid:o.string().optional().describe("The sim this is about. Leave out for the whole run."),state:o.enum(["setting-up","working","waiting","passed","failed","needs-help"]).optional(),note:o.string().max(200).optional().describe("Short and plain, e.g. 'Idea 3: 58 fps, best so far'."),counts:o.object({done:o.number().int().min(0),total:o.number().int().min(0),passed:o.number().int().min(0).optional(),failed:o.number().int().min(0).optional()}).optional(),resultSource:o.enum(["agent","test"]).optional().describe("'test' when a test runner decided pass or fail, 'agent' when you judged it. Default agent."),sequence:o.number().int().min(0).optional()}},async e=>{try{return u(await l("report",e,3e4))}catch(r){return y(r)}});t.registerTool("sim_farm_extend",{description:"Ask for more time on your run before deadlineAt. The farm never goes past the run's cap (capAt). It says how much you got.",inputSchema:{runId:T,minutes:o.number().int().min(1).max(1440).describe("Minutes from now.")}},async e=>{try{return u(await l("extend",e))}catch(r){return y(r)}});t.registerTool("sim_farm_finish",{description:"End your run with a result. Gives back every sim it still holds. The person sees the summary in Buoy Desktop, so make it one or two plain sentences, e.g. 'Idea 3 won: 52 \u2192 58 fps.'",inputSchema:{runId:T,outcome:o.enum(["passed","failed","mixed","unknown"]).optional(),summary:o.string().max(600).optional()}},async e=>{try{const r=await l("finish",e,6e4,`fin-${e.runId}`);M(n=>n.runId===e.runId);return u(r)}catch(r){return y(r)}})}async function Q(){const{startFarmd:t}=await import("./src-R7ICMP6Q.mjs");const i=await t({hostLabel:"buoy-mcp",idleExitMs:10*6e4,onExit:()=>process.exit(0)});if(!i)process.exit(0);for(const e of["SIGTERM","SIGINT"])process.on(e,()=>void i.stop(e))}export{A as hasBuoyAccount,P as accountRequired,H as farmFairness,J as registerSimFarmTools,Q as runFarmd};
+Next: ${t.next}`:""}`);return f(`Sim Farm error: ${t?.message??t}`)}var D={leaseId:o.string().describe("The lease id from sim_farm_acquire."),epoch:o.number().int().describe("The epoch from sim_farm_acquire. A stale epoch is refused.")};var S=o.string().optional().describe("Any unique string for this call. Repeating the same call with the same requestId returns the first result instead of acting twice.");var T=o.string().describe("The runId from sim_farm_acquire.");async function Y(t,i,e){const r=new Map;const n=Date.now()+e;for(;;){for(const s of i){if(r.has(s))continue;const a=t.connectedDevices().find(d=>d.deviceId.endsWith(s)&&d.tier!=="checking");if(a)r.set(s,a.deviceId)}if(r.size===i.length||Date.now()>=n)return r;await new Promise(s=>setTimeout(s,500))}}async function F(t){const i=await l("status");const e=t==="android"?i.android?.templates??[]:i.templates??[];return e.filter(r=>r.usable).sort((r,n)=>String(r.createdAt).localeCompare(String(n.createdAt))).pop()?.id}async function q(){(await _()).require("android")}var B=o.enum(["ios","android"]).optional().describe("ios (default) or android. Android copies are emulators started from a saved snapshot.");function J(t,i){R=()=>t.server.getClientVersion()?.name;x=i;t.registerTool("sim_farm_status",{description:"Show the Sim Farm: how many farm simulators exist, which are awake or in use and by whom, free memory and disk, how many more sims fit, templates, leases, and recent events. Farm sims are slim iOS simulators (about 1.5 GB each instead of 5) that the farm makes from a template. `android` lists Android templates (with `roomFor` and `costGB` per copy) and running Android copies: slim emulators that start from a saved snapshot in about 2 s with the app on them. Apps launch as a real phone (an iPhone SE, 2nd gen, by default): they see its RAM and cores and get its memory warnings. Each sim's `phone` shows the app's peak memory, and `overLimit: true` means a real phone would have closed the app. A safety cap closes an app that keeps growing. Start here before sim_farm_acquire. Set `outside` to also list this Mac's other simulators, which the farm never touches.",inputSchema:{outside:o.boolean().optional().describe("Also list simulators the farm does not own.")}},async({outside:e})=>{try{return u(await l("status",{outside:!!e}))}catch(r){return y(r)}});t.registerTool("sim_farm_setup",{description:"Create or resize the Sim Farm. `create` makes a template sim from an app build and, optionally, a seed folder (signed-in app data); clones are made from it in about 4 s each. Dev-client apps (Expo) need `launchUrl` so they open on Metro instead of the launcher. `grow` / `shrink` change how many sims exist. Use `dryRun` first: it returns the plan, what slim mode turns off (push, StoreKit, app links, widgets, Spotlight\u2026) and whether the Mac has room. You own the pool: Buoy Desktop has no size control. sim_farm_acquire makes sims as needed; `shrink` the ones you no longer need so they stop using disk space.",inputSchema:{mode:o.enum(["create","grow","shrink"]).describe("create = new template; grow/shrink = pool size (iOS only)."),platform:B,apkPath:o.string().optional().describe("Android create: path to the app's .apk. A debug build lets the farm read each copy's Buoy id."),phone:o.string().optional().describe("Android create: the phone copies act like (RAM, cores, screen, app memory limit). Default android-3gb. See `farm android phone list`."),reverse:o.array(o.string().regex(/^\d{1,5}(:\d{1,5})?$/)).optional().describe('Android create: ports each copy forwards to this Mac, e.g. ["8081:8802"] so a dev build loads JS from Metro on 8802.'),templateId:o.string().optional().describe("For grow/shrink. Defaults to the newest usable template."),count:o.number().int().min(1).max(64).optional().describe("For grow/shrink: how many sims to add or remove."),appPath:o.string().optional().describe("For create: path to a simulator .app build."),seedDir:o.string().nullable().optional().describe("For create: seed folder (Documents/, AsyncStorage/, Preferences/, seed.json). null = no seed."),launchUrl:o.string().optional().describe("For create: URL opened after each launch, e.g. exp+my-app://expo-development-client/?url=http%3A%2F%2Flocalhost%3A8081."),deviceType:o.string().optional().describe("For create: a simctl device type id. Default iPhone 17 Pro."),runtime:o.string().optional().describe("For create: a simctl runtime id. Default iOS 26.3."),profile:o.enum(["slim","stock"]).optional().describe("For create: slim (default) or stock."),metroPort:o.number().int().min(1).max(65535).optional().describe("For create: the Metro port the app loads from. Default 8802."),dryRun:o.boolean().optional().describe("Return the plan and its cost without changing anything."),requestId:S}},async e=>{const r=I("sim_farm_setup");if(r)return r;try{if(e.platform==="android"){await q();if(e.mode!=="create")return f("Android copies have no pool to grow or shrink: sim_farm_acquire starts them and release closes them.");if(!e.apkPath)return f("Android create needs apkPath.");const a={platform:"android",apk:e.apkPath,phoneId:e.phone,reverse:e.reverse,...e.launchUrl?{launchUrl:e.launchUrl}:{}};if(e.dryRun)return u({wouldCreateTemplate:a,note:"Needs the Android SDK first: npx @buoy-gg/mcp farm android setup (a person accepts Google's license there).",budget:await l("budget",{ramGB:4.3,diskGB:4})});return u(await l("setup",a,30*6e4,e.requestId))}if(e.mode==="create"){const a={appPath:e.appPath,seedDir:e.seedDir,deviceType:e.deviceType??"com.apple.CoreSimulator.SimDeviceType.iPhone-17-Pro",runtime:e.runtime??"com.apple.CoreSimulator.SimRuntime.iOS-26-3",profile:e.profile??"slim",metroPort:e.metroPort??8802,...e.launchUrl?{launchUrl:e.launchUrl}:{}};if(!a.appPath)return f("create needs appPath.");if(a.seedDir===void 0)return f("create needs seedDir, or seedDir: null for an app with no seed.");if(e.dryRun)return u({wouldCreateTemplate:a,budget:await l("budget",{ramGB:6,diskGB:4})});return u(await l("setup",a,15*6e4,e.requestId))}const n=e.templateId??await F("ios");if(!n)return f("No usable template yet. Run sim_farm_setup with mode create first.");const s=e.count??1;if(e.dryRun){const a=await l("budget",{ramGB:0,diskGB:e.mode==="grow"?2*s:0});return u({mode:e.mode,templateId:n,count:s,roomForMoreSims:a.roomFor,ok:a.ok,reason:a.reason})}return u(await l(e.mode,{templateId:n,count:s},30*6e4,e.requestId))}catch(n){return y(n)}});t.registerTool("sim_farm_acquire",{description:"Take farm simulators for your work. The person watches your work live in Buoy Desktop, so give a clear `goal` and a `labels` entry per sim. Returns a run (runId, deadlineAt), a lease (leaseId + epoch) and exact sims (UDID, name, and buoyDeviceId once the app ran: the 8-character tail that its list_devices id ends with; with launch, also deviceId, the full id to pass to other tools). Parked sims are booted and new ones cloned as needed, within the Mac's memory and disk limits. This MCP keeps the lease alive while it runs; release it with sim_farm_finish when done. Only ever target the returned UDIDs: never `booted`, which picks a random simulator when many run. While working, send sim_farm_report when a sim starts, passes or fails. The run stops at deadlineAt unless you ask for more time with sim_farm_extend. If any call returns RUN_STOPPED, the person stopped you: stop and tell them.",inputSchema:{count:o.number().int().min(1).max(64).describe("How many sims. There is no fixed cap: the farm gives as many as this Mac's memory and disk allow. Use allowPartial to take what fits."),goal:o.string().max(200).optional().describe("One short sentence the person sees on the run card, e.g. 'Make the menu list scroll faster'. With runId, the run's goal is used if you leave this out."),labels:o.array(o.string().max(80)).optional().describe("One label per sim, in order, e.g. ['Idea 1: memo rows', 'Idea 2: flat list']."),kind:o.enum(["try-ideas","run-tests","reproduce-bug","explore"]).optional().describe("What sort of work this is."),runId:o.string().optional().describe("Add these sims to a run you already have, instead of starting a new one."),purpose:o.string().optional().describe("Old name for goal. Use goal."),templateId:o.string().optional().describe("Defaults to the newest usable template of the platform."),platform:B,launch:o.boolean().optional().describe("Launch the app on each sim and wait (up to about 30 s) until it joins Buoy. Each sim then has deviceId for other tools."),allowPartial:o.boolean().optional().describe("Return fewer sims than asked instead of failing."),waitSeconds:o.number().int().min(0).max(1800).optional().describe("Wait this long for sims to free up."),ttlMinutes:o.number().int().min(1).max(1440).optional().describe("How long the run may go. Default 15. Agents are capped (1 hour by default); ask for more later with sim_farm_extend."),requestId:S}},async e=>{const r=I("sim_farm_acquire");if(r)return r;try{if(e.platform==="android")await q();const n=e.templateId??await F(e.platform??"ios");if(!n){return f(e.platform==="android"?"No usable Android template yet. Run sim_farm_setup with platform android, mode create and apkPath.":"No usable template yet. Run sim_farm_setup with mode create first.")}let s=(e.goal??e.purpose??"").trim();if(!s&&e.runId)s=((await l("status")).runs??[]).find(m=>m.id===e.runId)?.goal??"";if(!s)return f("Give a goal: one short sentence about what you are doing.");const a=await _();const d=await a.acquire({templateId:n,count:e.count,purpose:s,goal:s,labels:e.labels,kind:e.kind,runId:e.runId,launch:e.launch,allowPartial:e.allowPartial,waitMs:(e.waitSeconds??0)*1e3,ttlMs:(e.ttlMinutes??15)*6e4,requestId:e.requestId});for(const m of d.sims){const w=c.findIndex(g=>g.udid===m.udid);if(w>=0)c.splice(w,1);c.push({leaseId:d.leaseId,epoch:d.epoch,runId:d.runId,udid:m.udid,buoyDeviceId:m.buoyDeviceId??void 0})}let h=d;if(e.launch&&i){const m=d.sims.map(p=>p.buoyDeviceId).filter(p=>!!p);const w=m.length?await Y(i,m,3e4):new Map;h={...d,sims:d.sims.map(p=>({...p,deviceId:p.buoyDeviceId&&w.get(p.buoyDeviceId)||null}))};const g=d.sims.filter(p=>p.buoyDeviceId&&!w.has(p.buoyDeviceId));if(g.length){h.warning=`The app started on ${g.map(p=>p.name).join(", ")} but has not joined Buoy after 30 s. Run list_devices again in a moment, or take a screenshot with sim_farm_action to see the screen.`}}const b=e.launch?d.sims.filter(m=>!m.buoyDeviceId):[];if(b.length){const m=(await l("status").catch(()=>null))?.templates?.find(g=>g.id===n);const w=m?.metroPort?` on port ${m.metroPort}`:"";return u({...h,warning:`The app did not report a Buoy id on ${b.map(g=>g.name).join(", ")}. It may still be loading, or Metro${w} may be down or broken. Check Metro${w}, then take a screenshot with sim_farm_action to see the screen.`})}return u(h)}catch(n){return y(n)}});t.registerTool("sim_farm_release",{description:"Give one lease's sims back. `fast` (default) stops the app and restores its seeded data in about 2 s; `full` rebuilds each sim from the template. Use `full` after anything changed OS settings (permissions, keychain, location) or after a crash. Releasing your last lease ends the run, unless `keepRun` is true. To end a run with a result, use sim_farm_finish instead.",inputSchema:{...D,reset:o.enum(["fast","full"]).optional(),keepRun:o.boolean().optional().describe("Keep the run open to take more sims into it later.")}},async e=>{try{const r=await _();const n=await r.release(e.leaseId,e.epoch,e.reset??"fast",e.keepRun===true);M(s=>s.leaseId===e.leaseId);return u(n)}catch(r){return y(r)}});t.registerTool("sim_farm_action",{description:"Act on sims in your lease: `screenshot` (returns file paths), `open-url` (deep link, pass `url`), `launch` the app, `reset` (restore seeded app data), or `rebuild` (fresh clone; the UDID changes, the result maps old to new). On an Android copy, `reset` and `rebuild` both swap in a fresh copy: the id changes and the result maps old to new. `install` puts a new .apk (pass `apkPath`) on Android copies; it is gone when the copy closes.",inputSchema:{...D,udids:o.array(o.string()).min(1).describe("UDIDs from your lease."),action:o.enum(["screenshot","open-url","launch","reset","rebuild","install"]),url:o.string().optional().describe("For open-url."),apkPath:o.string().optional().describe("For install (Android copies)."),requestId:S}},async e=>{const r=I("sim_farm_action");if(r)return r;try{const n=await l("action",{leaseId:e.leaseId,epoch:e.epoch,udids:e.udids,action:e.action,arg:e.action==="install"?e.apkPath:e.url},20*6e4,e.requestId);if(e.action==="reset"||e.action==="rebuild"){for(const[s,a]of Object.entries(n)){const d=c.find(h=>h.udid===s);if(d&&typeof a==="string"&&a!=="reset"&&a!==s)Object.assign(d,{udid:a,buoyDeviceId:void 0})}}return u(n)}catch(n){return y(n)}});t.registerTool("sim_farm_lock",{description:"Hold or free a Mac-wide lock tied to your lease. `perf-slot` is for fair speed tests: while you hold it the farm boots, clones and screenshots nothing else, and it records how busy the Mac is every second. It waits only for farm work in flight, not for other runs to end, so other sims and other apps may still use the Mac. run_benchmark_batch on your farm sim then marks each run fair or unfair from that record; run the unfair cases again. Measure only while you hold it. Other names guard shared test fixtures (e.g. `ask-buoy-gateway`, `shop`). Locks end with the lease.",inputSchema:{...D,name:o.string().regex(/^[a-z0-9-]{1,40}$/).describe("Lock name, e.g. perf-slot."),hold:o.boolean().describe("true = take it, false = free it."),waitSeconds:o.number().int().min(0).max(1800).optional()}},async e=>{const r=I("sim_farm_lock");if(r)return r;try{const n={leaseId:e.leaseId,epoch:e.epoch,name:e.name,waitMs:(e.waitSeconds??0)*1e3};return u(await l(e.hold?"lock":"unlock",n,(e.waitSeconds??0)*1e3+3e4))}catch(n){return y(n)}});t.registerTool("sim_farm_report",{description:"Tell the person how your run is going. They watch it live in Buoy Desktop. Send one when a sim starts work, passes, fails or needs help, with a short note. `counts` only when you know the full task list. Reports never add time. Pass an increasing `sequence` so a retry is never counted twice.",inputSchema:{runId:T,udid:o.string().optional().describe("The sim this is about. Leave out for the whole run."),state:o.enum(["setting-up","working","waiting","passed","failed","needs-help"]).optional(),note:o.string().max(200).optional().describe("Short and plain, e.g. 'Idea 3: 58 fps, best so far'."),counts:o.object({done:o.number().int().min(0),total:o.number().int().min(0),passed:o.number().int().min(0).optional(),failed:o.number().int().min(0).optional()}).optional(),resultSource:o.enum(["agent","test"]).optional().describe("'test' when a test runner decided pass or fail, 'agent' when you judged it. Default agent."),sequence:o.number().int().min(0).optional()}},async e=>{try{return u(await l("report",e,3e4))}catch(r){return y(r)}});t.registerTool("sim_farm_extend",{description:"Ask for more time on your run before deadlineAt. The farm never goes past the run's cap (capAt). It says how much you got.",inputSchema:{runId:T,minutes:o.number().int().min(1).max(1440).describe("Minutes from now.")}},async e=>{try{return u(await l("extend",e))}catch(r){return y(r)}});t.registerTool("sim_farm_finish",{description:"End your run with a result. Gives back every sim it still holds. The person sees the summary in Buoy Desktop, so make it one or two plain sentences, e.g. 'Idea 3 won: 52 \u2192 58 fps.'",inputSchema:{runId:T,outcome:o.enum(["passed","failed","mixed","unknown"]).optional(),summary:o.string().max(600).optional()}},async e=>{try{const r=await l("finish",e,6e4,`fin-${e.runId}`);M(n=>n.runId===e.runId);return u(r)}catch(r){return y(r)}})}async function Q(){const{startFarmd:t}=await import("./src-HRUK7GEE.mjs");const i=await t({hostLabel:"buoy-mcp",idleExitMs:10*6e4,onExit:()=>process.exit(0)});if(!i)process.exit(0);for(const e of["SIGTERM","SIGINT"])process.on(e,()=>void i.stop(e))}export{A as hasBuoyAccount,P as accountRequired,H as farmFairness,J as registerSimFarmTools,Q as runFarmd};