@buoy-gg/mcp 7.0.22 → 7.0.24

package/dist/{chunk-5C6BLMHY.mjs → chunk-DIXFOY4A.mjs}

@@ -196,6 +196,7 @@ var SyncClient = class {
         platform: d.platform,
         isConnected: d.isConnected !== false,
         isPro: d.isPro === true,
+        tier: d.tier ?? (d.isPro === true ? "pro" : "anonymous"),
         tools: caps?.tools ?? []
       };
     });
@@ -245,14 +246,20 @@ var SyncClient = class {
    * is blocked.
    */
   requireProDevice(deviceId) {
-    const proMsg = (name) => `Buoy Pro is required to use the MCP.${name ? ` The connected app "${name}" is on the free tier.` : ""} Upgrade to Buoy Pro in the app to enable MCP access (run \`list_devices\` to check status).`;
+    const tierNote = (dev2) => {
+      if (!dev2) return "";
+      return dev2.tier === "anonymous" ? ` The connected app "${dev2.deviceName}" has no license key at all.` : ` The connected app "${dev2.deviceName}" is on the ${dev2.tier} tier.`;
+    };
+    const proMsg = (dev2) => `Buoy Pro is required to use the MCP.${tierNote(
+      dev2
+    )} Upgrade to Buoy Pro in the app to enable MCP access (run \`list_devices\` to check status).`;
     if (deviceId === ALL_DEVICES) {
       if (!this.connectedDevices().some((d) => d.isPro)) throw new Error(proMsg());
       return ALL_DEVICES;
     }
     const target = this.resolveDevice(deviceId);
     const dev = this.connectedDevices().find((d) => d.deviceId === target);
-    if (!dev?.isPro) throw new Error(proMsg(dev?.deviceName));
+    if (!dev?.isPro) throw new Error(proMsg(dev));
     return target;
   }
   // ----------------------------------------------------------------
@@ -565,7 +572,7 @@ async function waitForBroker(url, attempts = 20) {
 var delay = (ms) => new Promise((r) => setTimeout(r, ms));
 
 // src/version.ts
-var VERSION = "7.0.22" ? "7.0.22" : "0.0.0-dev";
+var VERSION = "7.0.24" ? "7.0.24" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -660,11 +667,13 @@ function registerGenericTools(server, sync) {
           ...updateNotice ? { updateAvailable: updateNotice } : {}
         });
       }
-      const anyPro = devices.some((d) => d.isConnected && d.isPro);
+      const connected = devices.filter((d) => d.isConnected);
+      const anyPro = connected.some((d) => d.isPro);
+      const anySignedIn = connected.some((d) => d.tier !== "anonymous");
       return json({
         devices,
         ...anyPro ? {} : {
-          hint: "The Buoy MCP is a Pro feature \u2014 no connected device has an active Buoy Pro license, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them."
+          hint: anySignedIn ? "The Buoy MCP is a Pro feature \u2014 the connected device is signed in on the free tier, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them." : "The Buoy MCP is a Pro feature \u2014 no connected device has an active Buoy Pro license, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them."
         },
         ...updateNotice ? { updateAvailable: updateNotice } : {}
       });
@@ -737,6 +746,14 @@ function errMsg(e) {
 
 // src/tools/packs/perfRanking.ts
 var clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
+var WARMUP_CASE_NAME = "__batch_warmup__";
+var THERMAL_MARK = {
+  nominal: "\u{1F7E2} nominal",
+  fair: "\u{1F7E1} fair",
+  serious: "\u{1F7E0} serious",
+  critical: "\u{1F534} critical",
+  unknown: "\u2014"
+};
 var FALLBACK = {
   perCaseDurationMs: 5e3,
   settleMs: 600,
@@ -796,6 +813,7 @@ function buildAutomationConfig(input, base = {}) {
     runsPerCase,
     coolDownMs,
     discardWarmupRuns,
+    discardWarmupCase: input.discardWarmupCase ?? base.discardWarmupCase ?? true,
     shuffleCases,
     reloadBetweenCases: input.reloadBetweenCases ?? base.reloadBetweenCases ?? false,
     captureRenders: input.captureRenders ?? base.captureRenders ?? true
@@ -840,7 +858,9 @@ function computeFlags(r) {
 function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
   const entries = index.filter((e) => e.batchId === batchId);
   const failureByIndex = new Map(failures.map((f) => [f.index, f.reason]));
-  const indexes = casesOrder ? casesOrder.map((_, i) => i) : Array.from(new Set(entries.map((e) => e.batchIndex ?? 0))).sort((a, b) => a - b);
+  const indexes = Array.from(new Set(entries.map((e) => e.batchIndex ?? 0))).sort(
+    (a, b) => a - b
+  );
   const medianForCase = (batchIndex) => {
     const runs = entries.filter((e) => (e.batchIndex ?? 0) === batchIndex);
     if (runs.length === 0) return void 0;
@@ -850,7 +870,7 @@ function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
   const rows = indexes.map((batchIndex) => {
     const median = medianForCase(batchIndex);
     const runs = entries.filter((e) => (e.batchIndex ?? 0) === batchIndex).length;
-    const caseName = casesOrder?.[batchIndex]?.name ?? median?.name ?? `case ${batchIndex + 1}`;
+    const caseName = median?.name ?? casesOrder?.[batchIndex]?.name ?? `case ${batchIndex + 1}`;
     const failureReason = failureByIndex.get(batchIndex) ?? median?.batchFailureReason;
     const failed = Boolean(failureReason) || !median;
     const base = {
@@ -869,12 +889,13 @@ function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
       deviceMaxRefreshRate: num(median?.deviceMaxRefreshRate),
       deltaUiFps: null,
       deltaJsFps: null,
+      ...median?.thermalState ? { thermalState: median.thermalState } : {},
       renderCommits: num(median?.renderCommits),
       renderWasted: median?.renderWasted,
       topRenderers: median?.topRenderers ?? []
     };
     return { ...base, flags: failed ? [] : computeFlags(base) };
-  });
+  }).filter((r) => r.caseName !== WARMUP_CASE_NAME).map((r, i) => ({ ...r, batchIndex: i }));
   const baseline = rows[0];
   if (baseline) {
     for (const r of rows) {
@@ -928,18 +949,33 @@ function formatRankingMarkdown(ranking) {
     `**No single winner \u2014 weigh the trade-offs.** UI-thread health matters more than raw averages: a cheap run that drops UI frames is worse than a pricier one that holds them.`
   );
   lines.push("");
-  lines.push("| # | Case | UI FPS | JS FPS | CPU % | Mem MB | JS jank | UI jank | Flags |");
-  lines.push("|---|------|-------:|-------:|------:|-------:|--------:|--------:|-------|");
+  const anyThermal = ranking.rows.some((r) => r.thermalState);
+  const thermalHead = anyThermal ? " Thermal |" : "";
+  const thermalRule = anyThermal ? "-------|" : "";
+  lines.push(`| # | Case | UI FPS | JS FPS | CPU % | Mem MB | JS jank | UI jank |${thermalHead} Flags |`);
+  lines.push(`|---|------|-------:|-------:|------:|-------:|--------:|--------:|${thermalRule}-------|`);
   for (const r of ranking.rows) {
+    const thermalCell = anyThermal ? ` ${THERMAL_MARK[r.thermalState ?? "unknown"] ?? "\u2014"} |` : "";
     if (r.failed) {
-      lines.push(`| ${r.batchIndex} | ${r.caseName} | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u274C FAILED (${r.failureReason}) |`);
+      lines.push(
+        `| ${r.batchIndex} | ${r.caseName} | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 |${thermalCell} \u274C FAILED (${r.failureReason}) |`
+      );
       continue;
     }
     const flagCell = r.flags.length ? `\u26A0\uFE0F ${r.flags.join("; ")}` : "\u2713 clean";
     lines.push(
       `| ${r.batchIndex} | ${r.caseName} | ${f(r.uiFps)}${delta(r.deltaUiFps)} | ${f(r.jsFps)}${delta(
         r.deltaJsFps
-      )} | ${f(r.cpu)} | ${f(r.memMb)} | ${f(r.jsJank, 0)} | ${f(r.uiJank, 0)} | ${flagCell} |`
+      )} | ${f(r.cpu)} | ${f(r.memMb)} | ${f(r.jsJank, 0)} | ${f(r.uiJank, 0)} |${thermalCell} ${flagCell} |`
+    );
+  }
+  const throttled = ranking.rows.filter(
+    (r) => r.thermalState === "serious" || r.thermalState === "critical"
+  );
+  if (throttled.length) {
+    lines.push("");
+    lines.push(
+      `**\u{1F525} Thermally throttled: ${throttled.map((r) => r.caseName).join(", ")}.** A throttled device runs SLOWER at a LOWER cpu%, so these cases can look like the cheapest in the batch while actually delivering fewer frames \u2014 check their UI FPS and jank, and re-run them on a cool device before drawing any conclusion.`
     );
   }
   lines.push("");

package/dist/cli.js

@@ -224,6 +224,7 @@ var SyncClient = class {
         platform: d.platform,
         isConnected: d.isConnected !== false,
         isPro: d.isPro === true,
+        tier: d.tier ?? (d.isPro === true ? "pro" : "anonymous"),
         tools: caps?.tools ?? []
       };
     });
@@ -273,14 +274,20 @@ var SyncClient = class {
    * is blocked.
    */
   requireProDevice(deviceId) {
-    const proMsg = (name) => `Buoy Pro is required to use the MCP.${name ? ` The connected app "${name}" is on the free tier.` : ""} Upgrade to Buoy Pro in the app to enable MCP access (run \`list_devices\` to check status).`;
+    const tierNote = (dev2) => {
+      if (!dev2) return "";
+      return dev2.tier === "anonymous" ? ` The connected app "${dev2.deviceName}" has no license key at all.` : ` The connected app "${dev2.deviceName}" is on the ${dev2.tier} tier.`;
+    };
+    const proMsg = (dev2) => `Buoy Pro is required to use the MCP.${tierNote(
+      dev2
+    )} Upgrade to Buoy Pro in the app to enable MCP access (run \`list_devices\` to check status).`;
     if (deviceId === ALL_DEVICES) {
       if (!this.connectedDevices().some((d) => d.isPro)) throw new Error(proMsg());
       return ALL_DEVICES;
     }
     const target = this.resolveDevice(deviceId);
     const dev = this.connectedDevices().find((d) => d.deviceId === target);
-    if (!dev?.isPro) throw new Error(proMsg(dev?.deviceName));
+    if (!dev?.isPro) throw new Error(proMsg(dev));
     return target;
   }
   // ----------------------------------------------------------------
@@ -605,7 +612,7 @@ var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
 
 // src/version.ts
-var VERSION = "7.0.22" ? "7.0.22" : "0.0.0-dev";
+var VERSION = "7.0.24" ? "7.0.24" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -696,11 +703,13 @@ function registerGenericTools(server, sync) {
           ...updateNotice ? { updateAvailable: updateNotice } : {}
         });
       }
-      const anyPro = devices.some((d) => d.isConnected && d.isPro);
+      const connected = devices.filter((d) => d.isConnected);
+      const anyPro = connected.some((d) => d.isPro);
+      const anySignedIn = connected.some((d) => d.tier !== "anonymous");
       return json({
         devices,
         ...anyPro ? {} : {
-          hint: "The Buoy MCP is a Pro feature \u2014 no connected device has an active Buoy Pro license, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them."
+          hint: anySignedIn ? "The Buoy MCP is a Pro feature \u2014 the connected device is signed in on the free tier, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them." : "The Buoy MCP is a Pro feature \u2014 no connected device has an active Buoy Pro license, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them."
         },
         ...updateNotice ? { updateAvailable: updateNotice } : {}
       });
@@ -779,6 +788,14 @@ var PERF_TOOL_ID = "perf-monitor";
 
 // src/tools/packs/perfRanking.ts
 var clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
+var WARMUP_CASE_NAME = "__batch_warmup__";
+var THERMAL_MARK = {
+  nominal: "\u{1F7E2} nominal",
+  fair: "\u{1F7E1} fair",
+  serious: "\u{1F7E0} serious",
+  critical: "\u{1F534} critical",
+  unknown: "\u2014"
+};
 var FALLBACK = {
   perCaseDurationMs: 5e3,
   settleMs: 600,
@@ -838,6 +855,7 @@ function buildAutomationConfig(input, base = {}) {
     runsPerCase,
     coolDownMs,
     discardWarmupRuns,
+    discardWarmupCase: input.discardWarmupCase ?? base.discardWarmupCase ?? true,
     shuffleCases,
     reloadBetweenCases: input.reloadBetweenCases ?? base.reloadBetweenCases ?? false,
     captureRenders: input.captureRenders ?? base.captureRenders ?? true
@@ -882,7 +900,9 @@ function computeFlags(r) {
 function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
   const entries = index.filter((e) => e.batchId === batchId);
   const failureByIndex = new Map(failures.map((f) => [f.index, f.reason]));
-  const indexes = casesOrder ? casesOrder.map((_, i) => i) : Array.from(new Set(entries.map((e) => e.batchIndex ?? 0))).sort((a, b) => a - b);
+  const indexes = Array.from(new Set(entries.map((e) => e.batchIndex ?? 0))).sort(
+    (a, b) => a - b
+  );
   const medianForCase = (batchIndex) => {
     const runs = entries.filter((e) => (e.batchIndex ?? 0) === batchIndex);
     if (runs.length === 0) return void 0;
@@ -892,7 +912,7 @@ function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
   const rows = indexes.map((batchIndex) => {
     const median = medianForCase(batchIndex);
     const runs = entries.filter((e) => (e.batchIndex ?? 0) === batchIndex).length;
-    const caseName = casesOrder?.[batchIndex]?.name ?? median?.name ?? `case ${batchIndex + 1}`;
+    const caseName = median?.name ?? casesOrder?.[batchIndex]?.name ?? `case ${batchIndex + 1}`;
     const failureReason = failureByIndex.get(batchIndex) ?? median?.batchFailureReason;
     const failed = Boolean(failureReason) || !median;
     const base = {
@@ -911,12 +931,13 @@ function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
       deviceMaxRefreshRate: num(median?.deviceMaxRefreshRate),
       deltaUiFps: null,
       deltaJsFps: null,
+      ...median?.thermalState ? { thermalState: median.thermalState } : {},
       renderCommits: num(median?.renderCommits),
       renderWasted: median?.renderWasted,
       topRenderers: median?.topRenderers ?? []
     };
     return { ...base, flags: failed ? [] : computeFlags(base) };
-  });
+  }).filter((r) => r.caseName !== WARMUP_CASE_NAME).map((r, i) => ({ ...r, batchIndex: i }));
   const baseline = rows[0];
   if (baseline) {
     for (const r of rows) {
@@ -970,18 +991,33 @@ function formatRankingMarkdown(ranking) {
     `**No single winner \u2014 weigh the trade-offs.** UI-thread health matters more than raw averages: a cheap run that drops UI frames is worse than a pricier one that holds them.`
   );
   lines.push("");
-  lines.push("| # | Case | UI FPS | JS FPS | CPU % | Mem MB | JS jank | UI jank | Flags |");
-  lines.push("|---|------|-------:|-------:|------:|-------:|--------:|--------:|-------|");
+  const anyThermal = ranking.rows.some((r) => r.thermalState);
+  const thermalHead = anyThermal ? " Thermal |" : "";
+  const thermalRule = anyThermal ? "-------|" : "";
+  lines.push(`| # | Case | UI FPS | JS FPS | CPU % | Mem MB | JS jank | UI jank |${thermalHead} Flags |`);
+  lines.push(`|---|------|-------:|-------:|------:|-------:|--------:|--------:|${thermalRule}-------|`);
   for (const r of ranking.rows) {
+    const thermalCell = anyThermal ? ` ${THERMAL_MARK[r.thermalState ?? "unknown"] ?? "\u2014"} |` : "";
     if (r.failed) {
-      lines.push(`| ${r.batchIndex} | ${r.caseName} | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u274C FAILED (${r.failureReason}) |`);
+      lines.push(
+        `| ${r.batchIndex} | ${r.caseName} | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 |${thermalCell} \u274C FAILED (${r.failureReason}) |`
+      );
       continue;
     }
     const flagCell = r.flags.length ? `\u26A0\uFE0F ${r.flags.join("; ")}` : "\u2713 clean";
     lines.push(
       `| ${r.batchIndex} | ${r.caseName} | ${f(r.uiFps)}${delta(r.deltaUiFps)} | ${f(r.jsFps)}${delta(
         r.deltaJsFps
-      )} | ${f(r.cpu)} | ${f(r.memMb)} | ${f(r.jsJank, 0)} | ${f(r.uiJank, 0)} | ${flagCell} |`
+      )} | ${f(r.cpu)} | ${f(r.memMb)} | ${f(r.jsJank, 0)} | ${f(r.uiJank, 0)} |${thermalCell} ${flagCell} |`
+    );
+  }
+  const throttled = ranking.rows.filter(
+    (r) => r.thermalState === "serious" || r.thermalState === "critical"
+  );
+  if (throttled.length) {
+    lines.push("");
+    lines.push(
+      `**\u{1F525} Thermally throttled: ${throttled.map((r) => r.caseName).join(", ")}.** A throttled device runs SLOWER at a LOWER cpu%, so these cases can look like the cheapest in the batch while actually delivering fewer frames \u2014 check their UI FPS and jank, and re-run them on a cool device before drawing any conclusion.`
     );
   }
   lines.push("");

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   SyncClient,
   createMcpServer,
   runInit
-} from "./chunk-5C6BLMHY.mjs";
+} from "./chunk-DIXFOY4A.mjs";
 
 // src/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/index.d.mts

@@ -24,6 +24,14 @@ interface DeviceInfo {
     isConnected: boolean;
     /** Whether the connected app reported an active Buoy Pro license. */
     isPro: boolean;
+    /**
+     * The app's access tier. Apps older than the tier split report only `isPro`,
+     * which maps exactly — a key could only ever grant Pro back then.
+     *
+     * Surfaced so `list_devices` can say WHY the MCP is blocked: "signed in on
+     * the free tier" and "no account at all" are different problems.
+     */
+    tier: "anonymous" | "free" | "pro";
     tools: ToolCapability[];
 }
 /** How the client obtained its broker connection. */
@@ -426,6 +434,12 @@ interface AutomationConfig {
     runsPerCase?: number;
     coolDownMs?: number;
     discardWarmupRuns?: number;
+    /**
+     * Run a throwaway case at the front of the batch and drop it from the
+     * results, so the batch's cold start doesn't land on real data. Default true.
+     * See the perf-monitor AutomationConfig for the reproduction.
+     */
+    discardWarmupCase?: boolean;
     shuffleCases?: boolean;
     /** Capture per-component render counts/durations each run. Default true. */
     captureRenders?: boolean;
@@ -453,6 +467,8 @@ interface IndexEntry {
     caseId?: string;
     runIndex?: number;
     isMedianRun?: boolean;
+    /** 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). */
     renderCommits?: number;
     renderTotalMs?: number;
@@ -528,12 +544,13 @@ interface BuildConfigInput {
     coolDownMs?: number;
     navTimeoutMs?: number;
     discardWarmupRuns?: number;
+    discardWarmupCase?: boolean;
     shuffleCases?: boolean;
     reloadBetweenCases?: boolean;
     captureRenders?: boolean;
 }
 /** The settings subset a driver inherits from the device's saved config. */
-type BenchmarkSettings = Partial<Pick<AutomationConfig, "perCaseDurationMs" | "settleMs" | "navTimeoutMs" | "runsPerCase" | "coolDownMs" | "discardWarmupRuns" | "shuffleCases" | "reloadBetweenCases" | "captureRenders">>;
+type BenchmarkSettings = Partial<Pick<AutomationConfig, "perCaseDurationMs" | "settleMs" | "navTimeoutMs" | "runsPerCase" | "coolDownMs" | "discardWarmupRuns" | "discardWarmupCase" | "shuffleCases" | "reloadBetweenCases" | "captureRenders">>;
 /**
  * Build + validate the AutomationConfig the device expects. Throws on bad input.
  *
@@ -566,6 +583,8 @@ interface RankRow {
     deltaJsFps: number | null;
     /** At-risk axes for this case (e.g. "UI thread drops frames", "CPU near cap"). */
     flags: string[];
+    /** Thermal state at the median run's start, when the device reported one. */
+    thermalState?: "nominal" | "fair" | "serious" | "critical";
     /** React commits during the median run (null when capture was off/unavailable). */
     renderCommits: number | null;
     /** Top components by total render self-time during the median run. */

package/dist/index.d.ts

@@ -24,6 +24,14 @@ interface DeviceInfo {
     isConnected: boolean;
     /** Whether the connected app reported an active Buoy Pro license. */
     isPro: boolean;
+    /**
+     * The app's access tier. Apps older than the tier split report only `isPro`,
+     * which maps exactly — a key could only ever grant Pro back then.
+     *
+     * Surfaced so `list_devices` can say WHY the MCP is blocked: "signed in on
+     * the free tier" and "no account at all" are different problems.
+     */
+    tier: "anonymous" | "free" | "pro";
     tools: ToolCapability[];
 }
 /** How the client obtained its broker connection. */
@@ -426,6 +434,12 @@ interface AutomationConfig {
     runsPerCase?: number;
     coolDownMs?: number;
     discardWarmupRuns?: number;
+    /**
+     * Run a throwaway case at the front of the batch and drop it from the
+     * results, so the batch's cold start doesn't land on real data. Default true.
+     * See the perf-monitor AutomationConfig for the reproduction.
+     */
+    discardWarmupCase?: boolean;
     shuffleCases?: boolean;
     /** Capture per-component render counts/durations each run. Default true. */
     captureRenders?: boolean;
@@ -453,6 +467,8 @@ interface IndexEntry {
     caseId?: string;
     runIndex?: number;
     isMedianRun?: boolean;
+    /** 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). */
     renderCommits?: number;
     renderTotalMs?: number;
@@ -528,12 +544,13 @@ interface BuildConfigInput {
     coolDownMs?: number;
     navTimeoutMs?: number;
     discardWarmupRuns?: number;
+    discardWarmupCase?: boolean;
     shuffleCases?: boolean;
     reloadBetweenCases?: boolean;
     captureRenders?: boolean;
 }
 /** The settings subset a driver inherits from the device's saved config. */
-type BenchmarkSettings = Partial<Pick<AutomationConfig, "perCaseDurationMs" | "settleMs" | "navTimeoutMs" | "runsPerCase" | "coolDownMs" | "discardWarmupRuns" | "shuffleCases" | "reloadBetweenCases" | "captureRenders">>;
+type BenchmarkSettings = Partial<Pick<AutomationConfig, "perCaseDurationMs" | "settleMs" | "navTimeoutMs" | "runsPerCase" | "coolDownMs" | "discardWarmupRuns" | "discardWarmupCase" | "shuffleCases" | "reloadBetweenCases" | "captureRenders">>;
 /**
  * Build + validate the AutomationConfig the device expects. Throws on bad input.
  *
@@ -566,6 +583,8 @@ interface RankRow {
     deltaJsFps: number | null;
     /** At-risk axes for this case (e.g. "UI thread drops frames", "CPU near cap"). */
     flags: string[];
+    /** Thermal state at the median run's start, when the device reported one. */
+    thermalState?: "nominal" | "fair" | "serious" | "critical";
     /** React commits during the median run (null when capture was off/unavailable). */
     renderCommits: number | null;
     /** Top components by total render self-time during the median run. */

package/dist/index.js

@@ -259,6 +259,7 @@ var SyncClient = class {
         platform: d.platform,
         isConnected: d.isConnected !== false,
         isPro: d.isPro === true,
+        tier: d.tier ?? (d.isPro === true ? "pro" : "anonymous"),
         tools: caps?.tools ?? []
       };
     });
@@ -308,14 +309,20 @@ var SyncClient = class {
    * is blocked.
    */
   requireProDevice(deviceId) {
-    const proMsg = (name) => `Buoy Pro is required to use the MCP.${name ? ` The connected app "${name}" is on the free tier.` : ""} Upgrade to Buoy Pro in the app to enable MCP access (run \`list_devices\` to check status).`;
+    const tierNote = (dev2) => {
+      if (!dev2) return "";
+      return dev2.tier === "anonymous" ? ` The connected app "${dev2.deviceName}" has no license key at all.` : ` The connected app "${dev2.deviceName}" is on the ${dev2.tier} tier.`;
+    };
+    const proMsg = (dev2) => `Buoy Pro is required to use the MCP.${tierNote(
+      dev2
+    )} Upgrade to Buoy Pro in the app to enable MCP access (run \`list_devices\` to check status).`;
     if (deviceId === ALL_DEVICES) {
       if (!this.connectedDevices().some((d) => d.isPro)) throw new Error(proMsg());
       return ALL_DEVICES;
     }
     const target = this.resolveDevice(deviceId);
     const dev = this.connectedDevices().find((d) => d.deviceId === target);
-    if (!dev?.isPro) throw new Error(proMsg(dev?.deviceName));
+    if (!dev?.isPro) throw new Error(proMsg(dev));
     return target;
   }
   // ----------------------------------------------------------------
@@ -640,7 +647,7 @@ var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
 
 // src/version.ts
-var VERSION = "7.0.22" ? "7.0.22" : "0.0.0-dev";
+var VERSION = "7.0.24" ? "7.0.24" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -731,11 +738,13 @@ function registerGenericTools(server, sync) {
           ...updateNotice ? { updateAvailable: updateNotice } : {}
         });
       }
-      const anyPro = devices.some((d) => d.isConnected && d.isPro);
+      const connected = devices.filter((d) => d.isConnected);
+      const anyPro = connected.some((d) => d.isPro);
+      const anySignedIn = connected.some((d) => d.tier !== "anonymous");
       return json({
         devices,
         ...anyPro ? {} : {
-          hint: "The Buoy MCP is a Pro feature \u2014 no connected device has an active Buoy Pro license, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them."
+          hint: anySignedIn ? "The Buoy MCP is a Pro feature \u2014 the connected device is signed in on the free tier, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them." : "The Buoy MCP is a Pro feature \u2014 no connected device has an active Buoy Pro license, so data/action tools are blocked. Upgrade to Buoy Pro in the app to enable them."
         },
         ...updateNotice ? { updateAvailable: updateNotice } : {}
       });
@@ -814,6 +823,14 @@ var PERF_TOOL_ID = "perf-monitor";
 
 // src/tools/packs/perfRanking.ts
 var clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
+var WARMUP_CASE_NAME = "__batch_warmup__";
+var THERMAL_MARK = {
+  nominal: "\u{1F7E2} nominal",
+  fair: "\u{1F7E1} fair",
+  serious: "\u{1F7E0} serious",
+  critical: "\u{1F534} critical",
+  unknown: "\u2014"
+};
 var FALLBACK = {
   perCaseDurationMs: 5e3,
   settleMs: 600,
@@ -873,6 +890,7 @@ function buildAutomationConfig(input, base = {}) {
     runsPerCase,
     coolDownMs,
     discardWarmupRuns,
+    discardWarmupCase: input.discardWarmupCase ?? base.discardWarmupCase ?? true,
     shuffleCases,
     reloadBetweenCases: input.reloadBetweenCases ?? base.reloadBetweenCases ?? false,
     captureRenders: input.captureRenders ?? base.captureRenders ?? true
@@ -917,7 +935,9 @@ function computeFlags(r) {
 function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
   const entries = index.filter((e) => e.batchId === batchId);
   const failureByIndex = new Map(failures.map((f) => [f.index, f.reason]));
-  const indexes = casesOrder ? casesOrder.map((_, i) => i) : Array.from(new Set(entries.map((e) => e.batchIndex ?? 0))).sort((a, b) => a - b);
+  const indexes = Array.from(new Set(entries.map((e) => e.batchIndex ?? 0))).sort(
+    (a, b) => a - b
+  );
   const medianForCase = (batchIndex) => {
     const runs = entries.filter((e) => (e.batchIndex ?? 0) === batchIndex);
     if (runs.length === 0) return void 0;
@@ -927,7 +947,7 @@ function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
   const rows = indexes.map((batchIndex) => {
     const median = medianForCase(batchIndex);
     const runs = entries.filter((e) => (e.batchIndex ?? 0) === batchIndex).length;
-    const caseName = casesOrder?.[batchIndex]?.name ?? median?.name ?? `case ${batchIndex + 1}`;
+    const caseName = median?.name ?? casesOrder?.[batchIndex]?.name ?? `case ${batchIndex + 1}`;
     const failureReason = failureByIndex.get(batchIndex) ?? median?.batchFailureReason;
     const failed = Boolean(failureReason) || !median;
     const base = {
@@ -946,12 +966,13 @@ function rankBatchFromIndex(index, batchId, casesOrder, failures = []) {
       deviceMaxRefreshRate: num(median?.deviceMaxRefreshRate),
       deltaUiFps: null,
       deltaJsFps: null,
+      ...median?.thermalState ? { thermalState: median.thermalState } : {},
       renderCommits: num(median?.renderCommits),
       renderWasted: median?.renderWasted,
       topRenderers: median?.topRenderers ?? []
     };
     return { ...base, flags: failed ? [] : computeFlags(base) };
-  });
+  }).filter((r) => r.caseName !== WARMUP_CASE_NAME).map((r, i) => ({ ...r, batchIndex: i }));
   const baseline = rows[0];
   if (baseline) {
     for (const r of rows) {
@@ -1005,18 +1026,33 @@ function formatRankingMarkdown(ranking) {
     `**No single winner \u2014 weigh the trade-offs.** UI-thread health matters more than raw averages: a cheap run that drops UI frames is worse than a pricier one that holds them.`
   );
   lines.push("");
-  lines.push("| # | Case | UI FPS | JS FPS | CPU % | Mem MB | JS jank | UI jank | Flags |");
-  lines.push("|---|------|-------:|-------:|------:|-------:|--------:|--------:|-------|");
+  const anyThermal = ranking.rows.some((r) => r.thermalState);
+  const thermalHead = anyThermal ? " Thermal |" : "";
+  const thermalRule = anyThermal ? "-------|" : "";
+  lines.push(`| # | Case | UI FPS | JS FPS | CPU % | Mem MB | JS jank | UI jank |${thermalHead} Flags |`);
+  lines.push(`|---|------|-------:|-------:|------:|-------:|--------:|--------:|${thermalRule}-------|`);
   for (const r of ranking.rows) {
+    const thermalCell = anyThermal ? ` ${THERMAL_MARK[r.thermalState ?? "unknown"] ?? "\u2014"} |` : "";
     if (r.failed) {
-      lines.push(`| ${r.batchIndex} | ${r.caseName} | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u274C FAILED (${r.failureReason}) |`);
+      lines.push(
+        `| ${r.batchIndex} | ${r.caseName} | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 | \u2014 |${thermalCell} \u274C FAILED (${r.failureReason}) |`
+      );
       continue;
     }
     const flagCell = r.flags.length ? `\u26A0\uFE0F ${r.flags.join("; ")}` : "\u2713 clean";
     lines.push(
       `| ${r.batchIndex} | ${r.caseName} | ${f(r.uiFps)}${delta(r.deltaUiFps)} | ${f(r.jsFps)}${delta(
         r.deltaJsFps
-      )} | ${f(r.cpu)} | ${f(r.memMb)} | ${f(r.jsJank, 0)} | ${f(r.uiJank, 0)} | ${flagCell} |`
+      )} | ${f(r.cpu)} | ${f(r.memMb)} | ${f(r.jsJank, 0)} | ${f(r.uiJank, 0)} |${thermalCell} ${flagCell} |`
+    );
+  }
+  const throttled = ranking.rows.filter(
+    (r) => r.thermalState === "serious" || r.thermalState === "critical"
+  );
+  if (throttled.length) {
+    lines.push("");
+    lines.push(
+      `**\u{1F525} Thermally throttled: ${throttled.map((r) => r.caseName).join(", ")}.** A throttled device runs SLOWER at a LOWER cpu%, so these cases can look like the cheapest in the batch while actually delivering fewer frames \u2014 check their UI FPS and jank, and re-run them on a cool device before drawing any conclusion.`
     );
   }
   lines.push("");

package/dist/index.mjs

@@ -27,7 +27,7 @@ import {
   registerStorageTools,
   registerZustandTools,
   runInit
-} from "./chunk-5C6BLMHY.mjs";
+} from "./chunk-DIXFOY4A.mjs";
 export {
   ALL_DEVICES,
   BROKER_PORT,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@buoy-gg/mcp",
   "mcpName": "io.github.buoy-gg/mcp",
-  "version": "7.0.22",
+  "version": "7.0.24",
   "description": "MCP server for Buoy devtools — lets any LLM copilot drive Buoy tools (perf-monitor benchmarks, etc.) over the devtool sync protocol",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -32,7 +32,7 @@
     "socket.io-client": "^4.8.1",
     "zod": "^3.25.0",
     "ws": "^8.18.0",
-    "@buoy-gg/sync-broker": "^7.0.22"
+    "@buoy-gg/sync-broker": "^7.0.24"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",