@buoy-gg/mcp 7.0.46 → 7.0.48

package/dist/cli.mjs

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
-import{SyncClient as i,createMcpServer as p,runInit as a}from"./chunk-WST6W5ZP.mjs";import{StdioServerTransport as l}from"@modelcontextprotocol/sdk/server/stdio.js";console.log=(...e)=>console.error(...e);console.info=(...e)=>console.error(...e);console.debug=(...e)=>console.error(...e);async function d(){const e=process.env.BUOY_BROKER_PORT;const s=new i({url:process.env.BUOY_BROKER_URL,port:e?Number(e):void 0,autoSpawnBroker:process.env.BUOY_NO_SPAWN!=="1"});const o=p(s);const c=new l;let n=false;const r=t=>{if(n)return;n=true;process.stderr.write(`[buoy-mcp] shutting down (${t})
-`);setTimeout(()=>process.exit(0),2e3).unref();void(async()=>{await s.stop().catch(()=>{});await o.close().catch(()=>{});process.exit(0)})()};process.stdin.once("end",()=>r("stdin closed"));process.stdin.once("close",()=>r("stdin closed"));o.server.onclose=()=>r("transport closed");process.on("SIGINT",()=>r("SIGINT"));process.on("SIGTERM",()=>r("SIGTERM"));process.on("SIGHUP",()=>r("SIGHUP"));await o.connect(c);process.stderr.write(`[buoy-mcp] serving MCP over stdio; connecting to broker\u2026
-`);s.start().then(t=>process.stderr.write(`[buoy-mcp] broker ${t}
-`)).catch(t=>process.stderr.write(`[buoy-mcp] broker connection failed: ${t?.message??t} \u2014 tools will report no devices until it recovers
-`))}if(process.argv[2]==="init"){try{const e=process.argv.slice(3);let s="auto";if(e.includes("--local"))s="local";else if(e.includes("--npx"))s="npx";const o=e.indexOf("--registry");const c=o!==-1?e[o+1]:void 0;a({mode:s,registry:c});process.exit(0)}catch(e){process.stderr.write(`[buoy-mcp] init failed: ${e?.message??e}
-`);process.exit(1)}}else{d().catch(e=>{process.stderr.write(`[buoy-mcp] fatal: ${e?.message??e}
+import{SyncClient as a,createMcpServer as p,runInit as l}from"./chunk-OBR5RY7Z.mjs";import"./chunk-2PTJT2QF.mjs";import{StdioServerTransport as d}from"@modelcontextprotocol/sdk/server/stdio.js";console.log=(...e)=>console.error(...e);console.info=(...e)=>console.error(...e);console.debug=(...e)=>console.error(...e);async function u(){const e=process.env.BUOY_BROKER_PORT;const s=new a({url:process.env.BUOY_BROKER_URL,port:e?Number(e):void 0,autoSpawnBroker:process.env.BUOY_NO_SPAWN!=="1"});const t=p(s);const c=new d;let n=false;const r=o=>{if(n)return;n=true;process.stderr.write(`[buoy-mcp] shutting down (${o})
+`);setTimeout(()=>process.exit(0),2e3).unref();void(async()=>{await s.stop().catch(()=>{});await t.close().catch(()=>{});process.exit(0)})()};process.stdin.once("end",()=>r("stdin closed"));process.stdin.once("close",()=>r("stdin closed"));t.server.onclose=()=>r("transport closed");process.on("SIGINT",()=>r("SIGINT"));process.on("SIGTERM",()=>r("SIGTERM"));process.on("SIGHUP",()=>r("SIGHUP"));await t.connect(c);process.stderr.write(`[buoy-mcp] serving MCP over stdio; connecting to broker\u2026
+`);s.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
+`))}if(process.argv[2]==="web-bench"){void(async()=>{try{const e=process.argv.slice(3);const s=e.find(i=>!i.startsWith("--"));if(!s)throw new Error("usage: buoy-mcp web-bench <config.json> [--json]");const{readFileSync:t}=await import("fs");const{runWebBench:c,formatWebBenchMarkdown:n}=await import("./webBench-LKAOZXHK.mjs");const r=JSON.parse(t(s,"utf8"));const o=await c({...r,durationMs:r.durationMs??r.perCaseDurationMs},i=>process.stderr.write(`[web-bench] ${i}
+`));process.stdout.write((e.includes("--json")?JSON.stringify(o,null,2):n(o))+"\n");process.exit(0)}catch(e){process.stderr.write(`[buoy-mcp] web-bench failed: ${e?.message??e}
+`);process.exit(1)}})()}else if(process.argv[2]==="init"){try{const e=process.argv.slice(3);let s="auto";if(e.includes("--local"))s="local";else if(e.includes("--npx"))s="npx";const t=e.indexOf("--registry");const c=t!==-1?e[t+1]:void 0;l({mode:s,registry:c});process.exit(0)}catch(e){process.stderr.write(`[buoy-mcp] init failed: ${e?.message??e}
+`);process.exit(1)}}else{u().catch(e=>{process.stderr.write(`[buoy-mcp] fatal: ${e?.message??e}
 `);process.exit(1)})}

package/dist/index.d.mts

@@ -474,6 +474,59 @@ interface AutomationConfig {
     captureRenders?: boolean;
 }
 /** A lightweight saved-recording summary (the device's index entry). */
+/** Per-run browser probe summary (perf-monitor webRunProbe.ts). */
+interface WebRunSummary {
+    durationMs: number;
+    frames: number;
+    refreshHz: number;
+    frameGapP95Ms: number | null;
+    frameGapMaxMs: number | null;
+    longFrames: number;
+    longTasksSupported: boolean;
+    longTaskMs: number | null;
+    longTaskPct: number | null;
+    hidden: boolean;
+    heapSupported: boolean;
+    viewport: {
+        width: number;
+        height: number;
+    } | null;
+    dpr: number | null;
+    resized: boolean;
+    userAgent: string | null;
+    loaf?: {
+        count: number;
+        blockingMs: number;
+        worstMs: number;
+        styleLayoutMs: number;
+        forcedLayoutMs: number;
+        topScripts: {
+            name: string;
+            ms: number;
+            count: number;
+        }[];
+    } | null;
+    interactions?: {
+        count: number;
+        worstMs: number | null;
+        worstInputDelayMs: number | null;
+        worstProcessingMs: number | null;
+        worstPresentationMs: number | null;
+        worstType: string | null;
+    } | null;
+    layoutShift?: number | null;
+    domNodesStart?: number | null;
+    domNodesEnd?: number | null;
+    pageLoad?: {
+        pageAgeMs: number;
+        ttfbMs: number | null;
+        fcpMs: number | null;
+        lcpMs: number | null;
+        domContentLoadedMs: number | null;
+        scriptKb: number | null;
+        totalKb: number | null;
+    } | null;
+}
 interface IndexEntry {
     id: string;
     createdAt: number;
@@ -496,6 +549,10 @@ interface IndexEntry {
     caseId?: string;
     runIndex?: number;
     isMedianRun?: boolean;
+    /** Set on every run of the batch's baseline case. batchIndex is the shuffled slot, so it can't say which case is the baseline. */
+    isBaseline?: boolean;
+    /** Browser runs only: what the per-run probe saw. Mirrors perf-monitor's WebRunSummary. */
+    webRun?: WebRunSummary;
     /** Thermal state at run start; a throttled run reads cheap AND janky. */
     thermalState?: "nominal" | "fair" | "serious" | "critical";
     /** Render-capture mirror (absent when capture was unavailable/disabled). */
@@ -607,7 +664,56 @@ interface RankRow {
     jsJank: number | null;
     uiJank: number | null;
     deviceMaxRefreshRate: number | null;
-    /** Delta vs the baseline (first case) — positive = better/more fps. */
+    /** True for the caller's baseline case (its first case, wherever it ran). */
+    isBaseline?: boolean;
+    /**
+     * "web" when the run came from a browser. Browser rows read differently:
+     * one main-thread FPS (in `jsFps`; `uiFps` is null), no CPU (long-task time
+     * is in `longTaskPct`), and real frame gaps instead of slow-sample counts.
+     */
+    platform?: "web";
+    /** Browser rows: % of the run the main thread spent in long tasks (>50 ms). null = not supported. */
+    longTaskPct?: number | null;
+    /** Browser rows: 95th-percentile gap between frames, ms. */
+    frameGapP95Ms?: number | null;
+    /** Browser rows: the longest gap between frames, ms. */
+    frameGapMaxMs?: number | null;
+    /** Browser rows: gaps long enough to miss at least one frame. */
+    longFrames?: number | null;
+    /** Browser rows: metrics this browser can't measure (they show as —, never 0). */
+    missingMetrics?: string[];
+    /** Browser rows (LoAF): input-blocking time in long animation frames, ms. */
+    loafBlockingMs?: number | null;
+    /** Browser rows (LoAF): style + layout time at the end of slow frames, ms. */
+    styleLayoutMs?: number | null;
+    /** Browser rows (LoAF): layout forced inside scripts, ms. */
+    forcedLayoutMs?: number | null;
+    /** Browser rows (LoAF): the scripts that took the most time in slow frames. */
+    topScripts?: {
+        name: string;
+        ms: number;
+        count: number;
+    }[];
+    /** Browser rows: slowest tap/key from input to next paint, ms (null = no input). */
+    worstInteractionMs?: number | null;
+    /** Browser rows: layout-shift score inside the run. */
+    layoutShift?: number | null;
+    /** Browser rows: elements in the page at the end of the median run. */
+    domNodes?: number | null;
+    /**
+     * Browser rows: elements added between the first and last run of this case,
+     * when every run started with more than the one before. Each run remounts
+     * the screen, so steady growth means nodes are left behind.
+     */
+    domGrowth?: number | null;
+    /** FPS range over this case's valid runs (UI FPS on native, FPS on web). */
+    fpsMin?: number | null;
+    fpsMax?: number | null;
+    /** Runs that saved without a failure. */
+    validRuns?: number;
+    /** Browser rows: how the page loaded (page-lifetime; see FRESH_LOAD_MS). */
+    pageLoad?: NonNullable<WebRunSummary["pageLoad"]> | null;
+    /** Delta vs the baseline case — positive = better/more fps. */
     deltaUiFps: number | null;
     deltaJsFps: number | null;
     /** At-risk axes for this case (e.g. "UI thread drops frames", "CPU near cap"). */
@@ -637,6 +743,8 @@ interface BatchRanking {
         lowestCpu?: string;
         lowestMem?: string;
         fewestJank?: string;
+        /** Browser batches: least main-thread time in long tasks. */
+        fewestLongTasks?: string;
     };
     /** Cases with an at-risk axis (esp. UI thread) — never a silent winner. */
     flagged: {

package/dist/index.d.ts

@@ -474,6 +474,59 @@ interface AutomationConfig {
     captureRenders?: boolean;
 }
 /** A lightweight saved-recording summary (the device's index entry). */
+/** Per-run browser probe summary (perf-monitor webRunProbe.ts). */
+interface WebRunSummary {
+    durationMs: number;
+    frames: number;
+    refreshHz: number;
+    frameGapP95Ms: number | null;
+    frameGapMaxMs: number | null;
+    longFrames: number;
+    longTasksSupported: boolean;
+    longTaskMs: number | null;
+    longTaskPct: number | null;
+    hidden: boolean;
+    heapSupported: boolean;
+    viewport: {
+        width: number;
+        height: number;
+    } | null;
+    dpr: number | null;
+    resized: boolean;
+    userAgent: string | null;
+    loaf?: {
+        count: number;
+        blockingMs: number;
+        worstMs: number;
+        styleLayoutMs: number;
+        forcedLayoutMs: number;
+        topScripts: {
+            name: string;
+            ms: number;
+            count: number;
+        }[];
+    } | null;
+    interactions?: {
+        count: number;
+        worstMs: number | null;
+        worstInputDelayMs: number | null;
+        worstProcessingMs: number | null;
+        worstPresentationMs: number | null;
+        worstType: string | null;
+    } | null;
+    layoutShift?: number | null;
+    domNodesStart?: number | null;
+    domNodesEnd?: number | null;
+    pageLoad?: {
+        pageAgeMs: number;
+        ttfbMs: number | null;
+        fcpMs: number | null;
+        lcpMs: number | null;
+        domContentLoadedMs: number | null;
+        scriptKb: number | null;
+        totalKb: number | null;
+    } | null;
+}
 interface IndexEntry {
     id: string;
     createdAt: number;
@@ -496,6 +549,10 @@ interface IndexEntry {
     caseId?: string;
     runIndex?: number;
     isMedianRun?: boolean;
+    /** Set on every run of the batch's baseline case. batchIndex is the shuffled slot, so it can't say which case is the baseline. */
+    isBaseline?: boolean;
+    /** Browser runs only: what the per-run probe saw. Mirrors perf-monitor's WebRunSummary. */
+    webRun?: WebRunSummary;
     /** Thermal state at run start; a throttled run reads cheap AND janky. */
     thermalState?: "nominal" | "fair" | "serious" | "critical";
     /** Render-capture mirror (absent when capture was unavailable/disabled). */
@@ -607,7 +664,56 @@ interface RankRow {
     jsJank: number | null;
     uiJank: number | null;
     deviceMaxRefreshRate: number | null;
-    /** Delta vs the baseline (first case) — positive = better/more fps. */
+    /** True for the caller's baseline case (its first case, wherever it ran). */
+    isBaseline?: boolean;
+    /**
+     * "web" when the run came from a browser. Browser rows read differently:
+     * one main-thread FPS (in `jsFps`; `uiFps` is null), no CPU (long-task time
+     * is in `longTaskPct`), and real frame gaps instead of slow-sample counts.
+     */
+    platform?: "web";
+    /** Browser rows: % of the run the main thread spent in long tasks (>50 ms). null = not supported. */
+    longTaskPct?: number | null;
+    /** Browser rows: 95th-percentile gap between frames, ms. */
+    frameGapP95Ms?: number | null;
+    /** Browser rows: the longest gap between frames, ms. */
+    frameGapMaxMs?: number | null;
+    /** Browser rows: gaps long enough to miss at least one frame. */
+    longFrames?: number | null;
+    /** Browser rows: metrics this browser can't measure (they show as —, never 0). */
+    missingMetrics?: string[];
+    /** Browser rows (LoAF): input-blocking time in long animation frames, ms. */
+    loafBlockingMs?: number | null;
+    /** Browser rows (LoAF): style + layout time at the end of slow frames, ms. */
+    styleLayoutMs?: number | null;
+    /** Browser rows (LoAF): layout forced inside scripts, ms. */
+    forcedLayoutMs?: number | null;
+    /** Browser rows (LoAF): the scripts that took the most time in slow frames. */
+    topScripts?: {
+        name: string;
+        ms: number;
+        count: number;
+    }[];
+    /** Browser rows: slowest tap/key from input to next paint, ms (null = no input). */
+    worstInteractionMs?: number | null;
+    /** Browser rows: layout-shift score inside the run. */
+    layoutShift?: number | null;
+    /** Browser rows: elements in the page at the end of the median run. */
+    domNodes?: number | null;
+    /**
+     * Browser rows: elements added between the first and last run of this case,
+     * when every run started with more than the one before. Each run remounts
+     * the screen, so steady growth means nodes are left behind.
+     */
+    domGrowth?: number | null;
+    /** FPS range over this case's valid runs (UI FPS on native, FPS on web). */
+    fpsMin?: number | null;
+    fpsMax?: number | null;
+    /** Runs that saved without a failure. */
+    validRuns?: number;
+    /** Browser rows: how the page loaded (page-lifetime; see FRESH_LOAD_MS). */
+    pageLoad?: NonNullable<WebRunSummary["pageLoad"]> | null;
+    /** Delta vs the baseline case — positive = better/more fps. */
     deltaUiFps: number | null;
     deltaJsFps: number | null;
     /** At-risk axes for this case (e.g. "UI thread drops frames", "CPU near cap"). */
@@ -637,6 +743,8 @@ interface BatchRanking {
         lowestCpu?: string;
         lowestMem?: string;
         fewestJank?: string;
+        /** Browser batches: least main-thread time in long tasks. */
+        fewestLongTasks?: string;
     };
     /** Cases with an at-risk axis (esp. UI thread) — never a silent winner. */
     flagged: {