@buoy-gg/mcp 7.0.14 → 7.0.16

package/dist/{chunk-ZEHIU6OG.mjs → chunk-P2OALRPK.mjs}

@@ -301,7 +301,7 @@ async function waitForBroker(url, attempts = 20) {
 var delay = (ms) => new Promise((r) => setTimeout(r, ms));
 
 // src/version.ts
-var VERSION = "7.0.14" ? "7.0.14" : "0.0.0-dev";
+var VERSION = "7.0.16" ? "7.0.16" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -2025,7 +2025,7 @@ function registerScreenshotTools(server, sync) {
 
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z as z17 } from "zod";
+import { z as z18 } from "zod";
 
 // src/tools/packs/network.ts
 import { z as z12 } from "zod";
@@ -2879,7 +2879,9 @@ function registerImagesTools(server, sync) {
             error: r.error,
             errorCode: r.errorCode,
             overrideLabel: r.overrideLabel,
-            loadCount: r.loadCount
+            loadCount: r.loadCount,
+            hasAltText: r.hasAltText,
+            layoutShifts: r.layoutShifts
           }))
         };
         return text13(`${md}
@@ -3008,17 +3010,234 @@ ${JSON.stringify(slim)}
   );
 }
 
-// src/tools/packs/reload.ts
+// src/tools/packs/assets.ts
 import { z as z16 } from "zod";
+var ASSETS_TOOL_ID = "assets";
+var text14 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail16 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg16 = (e) => e instanceof Error ? e.message : String(e);
+function kb(bytes) {
+  if (bytes == null || bytes <= 0) return "\u2013";
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(2)}MB`;
+}
+function sizeLabel(r) {
+  if (r.sizeBytes == null) return "\u2013";
+  return r.sizeSource === "measured" ? kb(r.sizeBytes) : `~${kb(r.sizeBytes)}`;
+}
+function scalesLabel(scales) {
+  if (!scales.length) return "\u2013";
+  return scales.map((s) => `@${s}x`).join(" ");
+}
+function flagsLabel(r, ins) {
+  const flags = [];
+  if (!r.loaded) flags.push("UNUSED");
+  if (ins.overDecode.includes(r.id)) flags.push("OVERSIZE");
+  if (ins.duplicates.some((d) => d.ids.includes(r.id))) flags.push("DUP");
+  if (ins.heavyGifs.includes(r.id) || ins.heavyFonts.includes(r.id)) flags.push("HEAVY");
+  if (ins.scaleAnomalies.includes(r.id)) flags.push("BAD-SCALE");
+  else if (ins.scaleGaps.includes(r.id)) flags.push("LOW-RES");
+  if (ins.webpCandidates.includes(r.id)) flags.push("WEBP");
+  return flags.length ? flags.join(" ") : "\u2013";
+}
+function formatListMarkdown2(list, limit) {
+  const lines = [];
+  const s = list.stats;
+  const ss = list.scanStatus;
+  lines.push(`## Asset inventory (${list.total} assets, showing ${Math.min(limit, list.records.length)}, largest first)`);
+  lines.push("");
+  const kindBits = Object.entries(s.byKind).filter(([, v]) => v.count > 0).map(([k, v]) => `${v.count} ${k}${v.bytes > 0 ? ` (${kb(v.bytes)})` : ""}`);
+  lines.push(
+    `${s.loaded} loaded \xB7 ${s.neverLoaded} never loaded \xB7 ` + (s.totalBytes > 0 ? `${kb(s.totalBytes)} measured (${s.measuredCount}/${s.total})` : "sizes not measured") + ` \xB7 ${kindBits.join(" \xB7 ")}`
+  );
+  if (ss.fontFamilies.length > 0) {
+    lines.push(`Loaded font families: ${ss.fontFamilies.join(", ")}`);
+  }
+  if (!ss.graphSupported || ss.graphCount == null) {
+    lines.push(
+      "\u26A0 No Metro bundle graph (release build or graph fetch failed) \u2014 showing runtime-registered assets only; never-loaded detection unavailable." + (ss.graphError ? ` (${ss.graphError})` : "")
+    );
+  }
+  if (ss.measuring) lines.push("\u26A0 Size measurement in progress \u2014 byte totals are partial; re-run get_assets shortly.");
+  const ins = list.insights;
+  const chips = [];
+  if (ins.neverLoaded.length) chips.push(`${ins.neverLoaded.length} never loaded`);
+  if (ins.duplicates.length) {
+    const wasted = ins.duplicates.reduce((sum, d) => sum + (d.wastedBytes ?? 0), 0);
+    chips.push(`${ins.duplicates.length} duplicate group(s)${wasted > 0 ? ` (${kb(wasted)} wasted)` : ""}`);
+  }
+  if (ins.overDecode.length) chips.push(`${ins.overDecode.length} decode larger than 2\xD7 the screen`);
+  if (ins.webpCandidates.length) chips.push(`${ins.webpCandidates.length} WebP candidate(s)`);
+  if (ins.heavyGifs.length) chips.push(`${ins.heavyGifs.length} heavy GIF(s)`);
+  if (ins.heavyFonts.length) chips.push(`${ins.heavyFonts.length} heavy font(s)`);
+  if (ins.scaleGaps.length) chips.push(`${ins.scaleGaps.length} scale gap(s)`);
+  if (ins.scaleAnomalies.length) chips.push(`${ins.scaleAnomalies.length} scale anomaly(ies)`);
+  if (chips.length) {
+    lines.push("");
+    lines.push(`**Findings:** ${chips.join(" \xB7 ")}`);
+  }
+  const diff = list.diff;
+  if (diff) {
+    const net = diff.netBytes == null ? "net unknown" : Math.abs(diff.netBytes) < 1024 ? "\xB10 net" : `${diff.netBytes >= 0 ? "+" : "\u2212"}${kb(Math.abs(diff.netBytes))} net`;
+    lines.push("");
+    lines.push(
+      `**Since baseline** (${new Date(diff.baselineSavedAt).toISOString()}): ${diff.added.length} added \xB7 ${diff.removed.length} removed \xB7 ${diff.grown.length} grew \xB7 ${net}` + (diff.removed.length ? ` \u2014 removed: ${diff.removed.slice(0, 5).map((r) => `${r.name}.${r.type}`).join(", ")}${diff.removed.length > 5 ? "\u2026" : ""}` : "")
+    );
+  }
+  lines.push("");
+  lines.push("| id | asset | kind | dims | scales | size | flags |");
+  lines.push("|---|---|---|---|---|---|---|");
+  for (const r of list.records) {
+    const dims = r.width != null && r.height != null ? `${Math.round(r.width)}\xD7${Math.round(r.height)}` : "\u2013";
+    lines.push(
+      `| ${r.id} | ${r.name}.${r.type} | ${r.kind} | ${dims} | ${scalesLabel(r.scales)} | ${sizeLabel(r)} | ${flagsLabel(r, ins)} |`
+    );
+  }
+  lines.push("");
+  lines.push(
+    "_Sizes marked ~ are decoded-memory estimates (unmeasurable in this environment). Use `asset_action` for rescan / measure_sizes / detail / baseline ops._"
+  );
+  return lines.join("\n");
+}
+function registerAssetsTools(server, sync) {
+  server.registerTool(
+    "get_assets",
+    {
+      description: "Bundled-asset inventory from the app: every asset (images, fonts, video, audio) with dimensions, @1x/@2x/@3x scale coverage, byte sizes (measured from the Metro server in dev), loaded vs never-loaded state, and audit findings \u2014 duplicates (by content hash), shipped-but-never-loaded, WebP candidates, images decoding larger than the screen, heavy GIFs/fonts, scale gaps \u2014 plus the change vs a saved baseline. This is what the app SHIPS; use get_images for what it RENDERS. Requires @buoy-gg/assets on the device.",
+      inputSchema: {
+        deviceId: z16.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        limit: z16.number().optional().describe("Max records to return (largest first). Default 40, max 500."),
+        kind: z16.enum(["image", "font", "video", "audio", "data", "other"]).optional().describe("Only assets of this kind."),
+        unusedOnly: z16.boolean().optional().describe("Only assets shipped in the bundle but never loaded at runtime.")
+      }
+    },
+    async ({ deviceId, limit, kind, unusedOnly }) => {
+      try {
+        const target = sync.requireProDevice(deviceId);
+        const capped = Math.min(Math.max(limit ?? 40, 1), 500);
+        const list = await sync.callAction(
+          ASSETS_TOOL_ID,
+          "list",
+          { limit: unusedOnly ? 500 : capped, kind, loadedOnly: false },
+          target
+        );
+        if (!list) return fail16("Device returned nothing \u2014 is @buoy-gg/assets installed in the app?");
+        if (unusedOnly) {
+          list.records = list.records.filter((r) => !r.loaded).slice(0, capped);
+        }
+        const md = formatListMarkdown2(list, capped);
+        const slim = {
+          stats: list.stats,
+          scanStatus: list.scanStatus,
+          insights: list.insights,
+          diff: list.diff,
+          records: list.records.map((r) => ({
+            id: r.id,
+            name: r.name,
+            type: r.type,
+            kind: r.kind,
+            hash: r.hash,
+            width: r.width,
+            height: r.height,
+            scales: r.scales,
+            loaded: r.loaded,
+            sizeBytes: r.sizeBytes,
+            sizeSource: r.sizeSource
+          }))
+        };
+        return text14(`${md}
+
+\`\`\`json
+${JSON.stringify(slim)}
+\`\`\``);
+      } catch (e) {
+        return fail16(errMsg16(e));
+      }
+    }
+  );
+  server.registerTool(
+    "asset_action",
+    {
+      description: "Drive the assets tool: rescan (re-walk the registry + merge the Metro bundle graph + refresh fonts + measure sizes \u2014 run this first if the inventory looks stale or empty), measure_sizes (re-measure byte sizes only), detail (full metadata for one asset by id: source dir, per-scale sizes, resolved URI, per-file graph paths), save_baseline (persist the current inventory for before/after comparison \u2014 save, make your change, then get_assets shows added/removed/grown/net bytes), clear_baseline, clear_records (wipe + rescan rebuilds).",
+      inputSchema: {
+        deviceId: z16.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        action: z16.enum(["rescan", "measure_sizes", "detail", "save_baseline", "clear_baseline", "clear_records"]).describe("What to do."),
+        id: z16.number().optional().describe("Asset id from get_assets (detail only).")
+      }
+    },
+    async ({ deviceId, action, id }) => {
+      try {
+        const target = sync.requireProDevice(deviceId);
+        switch (action) {
+          case "rescan": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "rescan", {}, target);
+            const ss = result?.scanStatus;
+            if (!ss) return fail16("Device returned nothing for rescan.");
+            return text14(
+              `Rescan done: ${ss.registryCount} registered at runtime` + (ss.graphCount != null ? ` \xB7 ${ss.graphCount} in the bundle graph` : " \xB7 no bundle graph") + (ss.graphError ? ` (graph: ${ss.graphError})` : "") + ` \xB7 ${ss.fontFamilies.length} font families` + (ss.measuring ? " \xB7 size measurement running \u2014 get_assets in a moment" : "")
+            );
+          }
+          case "measure_sizes": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "measureSizes", {}, target);
+            return text14(`Measured ${result?.measured ?? 0} of ${result?.total ?? 0} assets.`);
+          }
+          case "detail": {
+            if (id == null) return fail16("detail requires the `id` param (from get_assets).");
+            const detail = await sync.callAction(ASSETS_TOOL_ID, "getDetail", { id }, target);
+            if (!detail) return fail16(`Asset ${id} not found \u2014 re-run get_assets for current ids.`);
+            const lines = [
+              `## ${detail.name}.${detail.type} (#${detail.id})`,
+              "",
+              `- Kind: ${detail.kind} \xB7 ${detail.loaded ? "loaded at runtime" : "in bundle, NEVER loaded"} (${detail.origin})`
+            ];
+            if (detail.width != null) lines.push(`- Dimensions: ${detail.width}\xD7${detail.height} logical \xB7 scales ${scalesLabel(detail.scales)}`);
+            if (detail.sizesByScale) {
+              for (const [scale, bytes] of Object.entries(detail.sizesByScale)) {
+                lines.push(`- Size @${scale}x: ${kb(bytes)}`);
+              }
+            }
+            if (detail.sizeBytes != null) lines.push(`- Total: ${sizeLabel(detail)}`);
+            if (detail.estDecodedBytes) lines.push(`- Decoded memory: ~${kb(detail.estDecodedBytes)} (RGBA)`);
+            if (detail.hash) lines.push(`- Hash: ${detail.hash}`);
+            if (detail.fileSystemLocation) lines.push(`- Source dir: ${detail.fileSystemLocation}`);
+            if (detail.files?.length) lines.push(`- Files: ${detail.files.join(", ")}`);
+            if (detail.uri) lines.push(`- Resolved URI: ${detail.uri}`);
+            return text14(lines.join("\n"));
+          }
+          case "save_baseline": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "saveBaseline", {}, target);
+            return text14(
+              `Baseline saved (${result?.assets ?? 0} assets). Make your change, then get_assets reports added/removed/grown/net bytes against it.`
+            );
+          }
+          case "clear_baseline": {
+            await sync.callAction(ASSETS_TOOL_ID, "clearBaseline", {}, target);
+            return text14("Baseline cleared.");
+          }
+          case "clear_records": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "clearRecords", {}, target);
+            return text14(result?.message ?? "Inventory cleared.");
+          }
+        }
+      } catch (e) {
+        return fail16(errMsg16(e));
+      }
+    }
+  );
+}
+
+// src/tools/packs/reload.ts
+import { z as z17 } from "zod";
 var APP_TOOL_ID = "app";
 var RELOAD_ACTION = "reloadApp";
 var DEFAULT_WAIT_MS = 3e4;
 var TEARDOWN_GRACE_MS = 1200;
 var PROBE_TIMEOUT_MS = 1500;
 var PROBE_INTERVAL_MS = 400;
-var text14 = (s) => ({ content: [{ type: "text", text: s }] });
-var fail16 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
-var errMsg16 = (e) => e instanceof Error ? e.message : String(e);
+var text15 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail17 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg17 = (e) => e instanceof Error ? e.message : String(e);
 var delay3 = (ms) => new Promise((r) => setTimeout(r, ms));
 async function ping(sync, deviceId, timeoutMs) {
   try {
@@ -3053,12 +3272,12 @@ function registerReloadTools(server, sync) {
     {
       description: "Reload the running app's JS bundle (Expo Go, dev client, or RN CLI) \u2014 the equivalent of shaking the device and hitting Reload, but from here. Use it to pick up a change Fast Refresh didn't apply, to clear leaked in-memory state before a measurement, or to re-run app startup. In dev builds it uses React Native's DevSettings.reload(); otherwise it falls back to expo-updates (if the app installs it). All in-memory state is lost. By default this waits for the app to come back up and reports how long the reload took. Works on any app running @buoy-gg/core \u2014 no particular tool package needed. Requires Buoy Pro.",
       inputSchema: {
-        strategy: z16.enum(["auto", "dev-settings", "expo-updates"]).optional().describe(
+        strategy: z17.enum(["auto", "dev-settings", "expo-updates"]).optional().describe(
           "Reload mechanism. 'auto' (default) uses DevSettings in dev builds and expo-updates otherwise. Force one only when debugging the reload itself."
         ),
-        wait: z16.boolean().optional().describe("Wait for the app to come back before returning. Default true \u2014 turn off for fire-and-forget."),
-        timeoutMs: z16.number().optional().describe("How long to wait for the app to reconnect, in ms. Default 30000."),
-        deviceId: z16.string().optional().describe('Target device id (auto-selected if one is connected). Use "All" to reload every connected app.')
+        wait: z17.boolean().optional().describe("Wait for the app to come back before returning. Default true \u2014 turn off for fire-and-forget."),
+        timeoutMs: z17.number().optional().describe("How long to wait for the app to reconnect, in ms. Default 30000."),
+        deviceId: z17.string().optional().describe('Target device id (auto-selected if one is connected). Use "All" to reload every connected app.')
       }
     },
     async (args) => {
@@ -3074,19 +3293,19 @@ function registerReloadTools(server, sync) {
         );
         const via = ack?.strategy ? ` via ${ack.strategy}` : "";
         if (args.wait === false) {
-          return text14(`Reload requested${via}. The app is restarting \u2014 its in-memory state is gone; re-read anything you cached.`);
+          return text15(`Reload requested${via}. The app is restarting \u2014 its in-memory state is gone; re-read anything you cached.`);
         }
         const elapsed = await waitForAppBack(sync, target, args.timeoutMs ?? DEFAULT_WAIT_MS, previousRealm);
         if (elapsed == null) {
-          return fail16(
+          return fail17(
             `Reload was accepted${via}, but the app hasn't reconnected yet. It may still be building the bundle (a cold Metro rebuild can take a while) \u2014 check the device, then run list_devices.`
           );
         }
-        return text14(
+        return text15(
           `Reloaded the app${via} \u2014 back and connected after ${(elapsed / 1e3).toFixed(1)}s. All in-memory state was reset, so re-read any state you cached before this.`
         );
       } catch (e) {
-        return fail16(errMsg16(e));
+        return fail17(errMsg17(e));
       }
     }
   );
@@ -3130,6 +3349,12 @@ Debugging images (not loading, slow, stale cache, memory)? \`get_images\` lists
 expo-image load with cache verdicts and oversize audits; \`image_action\` reloads, retries, or
 simulates failures per image; \`set_image_simulation\` flips app-wide offline/cold/blank modes.
 
+Auditing app size / bundled assets? \`get_assets\` inventories everything the app SHIPS \u2014 images,
+fonts, video, audio \u2014 with byte sizes, scale coverage, and findings (duplicates, never-loaded,
+WebP candidates, heavy GIFs/fonts). \`asset_action\` rescans, fetches per-asset detail, and runs
+the baseline diff workflow (save_baseline \u2192 change something \u2192 get_assets shows what it added).
+get_images = what RENDERS at runtime; get_assets = what SHIPS in the bundle.
+
 Need the app RESTARTED (a change Fast Refresh didn't pick up, leaked in-memory state before a
 measurement, re-running startup)? \`reload_app\` reloads the JS bundle \u2014 DevSettings.reload() in dev
 builds, expo-updates otherwise \u2014 and waits for the app to reconnect. It wipes in-memory state, so
@@ -3166,11 +3391,12 @@ function createMcpServer(sync) {
   registerInteractTools(server, sync);
   registerJsThreadTools(server, sync);
   registerImagesTools(server, sync);
+  registerAssetsTools(server, sync);
   registerReloadTools(server, sync);
   return server;
 }
 var deviceIdField = {
-  deviceId: z17.string().optional().describe(
+  deviceId: z18.string().optional().describe(
     'Target device id (from list_devices). Omit to auto-select when exactly one device is connected. Use "All" to broadcast.'
   )
 };

package/dist/cli.js

@@ -330,7 +330,7 @@ var delay = (ms) => new Promise((r) => setTimeout(r, ms));
 
 // src/server.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
-var import_zod17 = require("zod");
+var import_zod18 = require("zod");
 
 // src/tools/generic.ts
 var import_zod = require("zod");
@@ -341,7 +341,7 @@ var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
 
 // src/version.ts
-var VERSION = "7.0.14" ? "7.0.14" : "0.0.0-dev";
+var VERSION = "7.0.16" ? "7.0.16" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -2911,7 +2911,9 @@ function registerImagesTools(server, sync) {
             error: r.error,
             errorCode: r.errorCode,
             overrideLabel: r.overrideLabel,
-            loadCount: r.loadCount
+            loadCount: r.loadCount,
+            hasAltText: r.hasAltText,
+            layoutShifts: r.layoutShifts
           }))
         };
         return text13(`${md}
@@ -3040,17 +3042,234 @@ ${JSON.stringify(slim)}
   );
 }
 
-// src/tools/packs/reload.ts
+// src/tools/packs/assets.ts
 var import_zod16 = require("zod");
+var ASSETS_TOOL_ID = "assets";
+var text14 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail16 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg16 = (e) => e instanceof Error ? e.message : String(e);
+function kb(bytes) {
+  if (bytes == null || bytes <= 0) return "\u2013";
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(2)}MB`;
+}
+function sizeLabel(r) {
+  if (r.sizeBytes == null) return "\u2013";
+  return r.sizeSource === "measured" ? kb(r.sizeBytes) : `~${kb(r.sizeBytes)}`;
+}
+function scalesLabel(scales) {
+  if (!scales.length) return "\u2013";
+  return scales.map((s) => `@${s}x`).join(" ");
+}
+function flagsLabel(r, ins) {
+  const flags = [];
+  if (!r.loaded) flags.push("UNUSED");
+  if (ins.overDecode.includes(r.id)) flags.push("OVERSIZE");
+  if (ins.duplicates.some((d) => d.ids.includes(r.id))) flags.push("DUP");
+  if (ins.heavyGifs.includes(r.id) || ins.heavyFonts.includes(r.id)) flags.push("HEAVY");
+  if (ins.scaleAnomalies.includes(r.id)) flags.push("BAD-SCALE");
+  else if (ins.scaleGaps.includes(r.id)) flags.push("LOW-RES");
+  if (ins.webpCandidates.includes(r.id)) flags.push("WEBP");
+  return flags.length ? flags.join(" ") : "\u2013";
+}
+function formatListMarkdown2(list, limit) {
+  const lines = [];
+  const s = list.stats;
+  const ss = list.scanStatus;
+  lines.push(`## Asset inventory (${list.total} assets, showing ${Math.min(limit, list.records.length)}, largest first)`);
+  lines.push("");
+  const kindBits = Object.entries(s.byKind).filter(([, v]) => v.count > 0).map(([k, v]) => `${v.count} ${k}${v.bytes > 0 ? ` (${kb(v.bytes)})` : ""}`);
+  lines.push(
+    `${s.loaded} loaded \xB7 ${s.neverLoaded} never loaded \xB7 ` + (s.totalBytes > 0 ? `${kb(s.totalBytes)} measured (${s.measuredCount}/${s.total})` : "sizes not measured") + ` \xB7 ${kindBits.join(" \xB7 ")}`
+  );
+  if (ss.fontFamilies.length > 0) {
+    lines.push(`Loaded font families: ${ss.fontFamilies.join(", ")}`);
+  }
+  if (!ss.graphSupported || ss.graphCount == null) {
+    lines.push(
+      "\u26A0 No Metro bundle graph (release build or graph fetch failed) \u2014 showing runtime-registered assets only; never-loaded detection unavailable." + (ss.graphError ? ` (${ss.graphError})` : "")
+    );
+  }
+  if (ss.measuring) lines.push("\u26A0 Size measurement in progress \u2014 byte totals are partial; re-run get_assets shortly.");
+  const ins = list.insights;
+  const chips = [];
+  if (ins.neverLoaded.length) chips.push(`${ins.neverLoaded.length} never loaded`);
+  if (ins.duplicates.length) {
+    const wasted = ins.duplicates.reduce((sum, d) => sum + (d.wastedBytes ?? 0), 0);
+    chips.push(`${ins.duplicates.length} duplicate group(s)${wasted > 0 ? ` (${kb(wasted)} wasted)` : ""}`);
+  }
+  if (ins.overDecode.length) chips.push(`${ins.overDecode.length} decode larger than 2\xD7 the screen`);
+  if (ins.webpCandidates.length) chips.push(`${ins.webpCandidates.length} WebP candidate(s)`);
+  if (ins.heavyGifs.length) chips.push(`${ins.heavyGifs.length} heavy GIF(s)`);
+  if (ins.heavyFonts.length) chips.push(`${ins.heavyFonts.length} heavy font(s)`);
+  if (ins.scaleGaps.length) chips.push(`${ins.scaleGaps.length} scale gap(s)`);
+  if (ins.scaleAnomalies.length) chips.push(`${ins.scaleAnomalies.length} scale anomaly(ies)`);
+  if (chips.length) {
+    lines.push("");
+    lines.push(`**Findings:** ${chips.join(" \xB7 ")}`);
+  }
+  const diff = list.diff;
+  if (diff) {
+    const net = diff.netBytes == null ? "net unknown" : Math.abs(diff.netBytes) < 1024 ? "\xB10 net" : `${diff.netBytes >= 0 ? "+" : "\u2212"}${kb(Math.abs(diff.netBytes))} net`;
+    lines.push("");
+    lines.push(
+      `**Since baseline** (${new Date(diff.baselineSavedAt).toISOString()}): ${diff.added.length} added \xB7 ${diff.removed.length} removed \xB7 ${diff.grown.length} grew \xB7 ${net}` + (diff.removed.length ? ` \u2014 removed: ${diff.removed.slice(0, 5).map((r) => `${r.name}.${r.type}`).join(", ")}${diff.removed.length > 5 ? "\u2026" : ""}` : "")
+    );
+  }
+  lines.push("");
+  lines.push("| id | asset | kind | dims | scales | size | flags |");
+  lines.push("|---|---|---|---|---|---|---|");
+  for (const r of list.records) {
+    const dims = r.width != null && r.height != null ? `${Math.round(r.width)}\xD7${Math.round(r.height)}` : "\u2013";
+    lines.push(
+      `| ${r.id} | ${r.name}.${r.type} | ${r.kind} | ${dims} | ${scalesLabel(r.scales)} | ${sizeLabel(r)} | ${flagsLabel(r, ins)} |`
+    );
+  }
+  lines.push("");
+  lines.push(
+    "_Sizes marked ~ are decoded-memory estimates (unmeasurable in this environment). Use `asset_action` for rescan / measure_sizes / detail / baseline ops._"
+  );
+  return lines.join("\n");
+}
+function registerAssetsTools(server, sync) {
+  server.registerTool(
+    "get_assets",
+    {
+      description: "Bundled-asset inventory from the app: every asset (images, fonts, video, audio) with dimensions, @1x/@2x/@3x scale coverage, byte sizes (measured from the Metro server in dev), loaded vs never-loaded state, and audit findings \u2014 duplicates (by content hash), shipped-but-never-loaded, WebP candidates, images decoding larger than the screen, heavy GIFs/fonts, scale gaps \u2014 plus the change vs a saved baseline. This is what the app SHIPS; use get_images for what it RENDERS. Requires @buoy-gg/assets on the device.",
+      inputSchema: {
+        deviceId: import_zod16.z.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        limit: import_zod16.z.number().optional().describe("Max records to return (largest first). Default 40, max 500."),
+        kind: import_zod16.z.enum(["image", "font", "video", "audio", "data", "other"]).optional().describe("Only assets of this kind."),
+        unusedOnly: import_zod16.z.boolean().optional().describe("Only assets shipped in the bundle but never loaded at runtime.")
+      }
+    },
+    async ({ deviceId, limit, kind, unusedOnly }) => {
+      try {
+        const target = sync.requireProDevice(deviceId);
+        const capped = Math.min(Math.max(limit ?? 40, 1), 500);
+        const list = await sync.callAction(
+          ASSETS_TOOL_ID,
+          "list",
+          { limit: unusedOnly ? 500 : capped, kind, loadedOnly: false },
+          target
+        );
+        if (!list) return fail16("Device returned nothing \u2014 is @buoy-gg/assets installed in the app?");
+        if (unusedOnly) {
+          list.records = list.records.filter((r) => !r.loaded).slice(0, capped);
+        }
+        const md = formatListMarkdown2(list, capped);
+        const slim = {
+          stats: list.stats,
+          scanStatus: list.scanStatus,
+          insights: list.insights,
+          diff: list.diff,
+          records: list.records.map((r) => ({
+            id: r.id,
+            name: r.name,
+            type: r.type,
+            kind: r.kind,
+            hash: r.hash,
+            width: r.width,
+            height: r.height,
+            scales: r.scales,
+            loaded: r.loaded,
+            sizeBytes: r.sizeBytes,
+            sizeSource: r.sizeSource
+          }))
+        };
+        return text14(`${md}
+
+\`\`\`json
+${JSON.stringify(slim)}
+\`\`\``);
+      } catch (e) {
+        return fail16(errMsg16(e));
+      }
+    }
+  );
+  server.registerTool(
+    "asset_action",
+    {
+      description: "Drive the assets tool: rescan (re-walk the registry + merge the Metro bundle graph + refresh fonts + measure sizes \u2014 run this first if the inventory looks stale or empty), measure_sizes (re-measure byte sizes only), detail (full metadata for one asset by id: source dir, per-scale sizes, resolved URI, per-file graph paths), save_baseline (persist the current inventory for before/after comparison \u2014 save, make your change, then get_assets shows added/removed/grown/net bytes), clear_baseline, clear_records (wipe + rescan rebuilds).",
+      inputSchema: {
+        deviceId: import_zod16.z.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        action: import_zod16.z.enum(["rescan", "measure_sizes", "detail", "save_baseline", "clear_baseline", "clear_records"]).describe("What to do."),
+        id: import_zod16.z.number().optional().describe("Asset id from get_assets (detail only).")
+      }
+    },
+    async ({ deviceId, action, id }) => {
+      try {
+        const target = sync.requireProDevice(deviceId);
+        switch (action) {
+          case "rescan": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "rescan", {}, target);
+            const ss = result?.scanStatus;
+            if (!ss) return fail16("Device returned nothing for rescan.");
+            return text14(
+              `Rescan done: ${ss.registryCount} registered at runtime` + (ss.graphCount != null ? ` \xB7 ${ss.graphCount} in the bundle graph` : " \xB7 no bundle graph") + (ss.graphError ? ` (graph: ${ss.graphError})` : "") + ` \xB7 ${ss.fontFamilies.length} font families` + (ss.measuring ? " \xB7 size measurement running \u2014 get_assets in a moment" : "")
+            );
+          }
+          case "measure_sizes": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "measureSizes", {}, target);
+            return text14(`Measured ${result?.measured ?? 0} of ${result?.total ?? 0} assets.`);
+          }
+          case "detail": {
+            if (id == null) return fail16("detail requires the `id` param (from get_assets).");
+            const detail = await sync.callAction(ASSETS_TOOL_ID, "getDetail", { id }, target);
+            if (!detail) return fail16(`Asset ${id} not found \u2014 re-run get_assets for current ids.`);
+            const lines = [
+              `## ${detail.name}.${detail.type} (#${detail.id})`,
+              "",
+              `- Kind: ${detail.kind} \xB7 ${detail.loaded ? "loaded at runtime" : "in bundle, NEVER loaded"} (${detail.origin})`
+            ];
+            if (detail.width != null) lines.push(`- Dimensions: ${detail.width}\xD7${detail.height} logical \xB7 scales ${scalesLabel(detail.scales)}`);
+            if (detail.sizesByScale) {
+              for (const [scale, bytes] of Object.entries(detail.sizesByScale)) {
+                lines.push(`- Size @${scale}x: ${kb(bytes)}`);
+              }
+            }
+            if (detail.sizeBytes != null) lines.push(`- Total: ${sizeLabel(detail)}`);
+            if (detail.estDecodedBytes) lines.push(`- Decoded memory: ~${kb(detail.estDecodedBytes)} (RGBA)`);
+            if (detail.hash) lines.push(`- Hash: ${detail.hash}`);
+            if (detail.fileSystemLocation) lines.push(`- Source dir: ${detail.fileSystemLocation}`);
+            if (detail.files?.length) lines.push(`- Files: ${detail.files.join(", ")}`);
+            if (detail.uri) lines.push(`- Resolved URI: ${detail.uri}`);
+            return text14(lines.join("\n"));
+          }
+          case "save_baseline": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "saveBaseline", {}, target);
+            return text14(
+              `Baseline saved (${result?.assets ?? 0} assets). Make your change, then get_assets reports added/removed/grown/net bytes against it.`
+            );
+          }
+          case "clear_baseline": {
+            await sync.callAction(ASSETS_TOOL_ID, "clearBaseline", {}, target);
+            return text14("Baseline cleared.");
+          }
+          case "clear_records": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "clearRecords", {}, target);
+            return text14(result?.message ?? "Inventory cleared.");
+          }
+        }
+      } catch (e) {
+        return fail16(errMsg16(e));
+      }
+    }
+  );
+}
+
+// src/tools/packs/reload.ts
+var import_zod17 = require("zod");
 var APP_TOOL_ID = "app";
 var RELOAD_ACTION = "reloadApp";
 var DEFAULT_WAIT_MS = 3e4;
 var TEARDOWN_GRACE_MS = 1200;
 var PROBE_TIMEOUT_MS = 1500;
 var PROBE_INTERVAL_MS = 400;
-var text14 = (s) => ({ content: [{ type: "text", text: s }] });
-var fail16 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
-var errMsg16 = (e) => e instanceof Error ? e.message : String(e);
+var text15 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail17 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg17 = (e) => e instanceof Error ? e.message : String(e);
 var delay3 = (ms) => new Promise((r) => setTimeout(r, ms));
 async function ping(sync, deviceId, timeoutMs) {
   try {
@@ -3085,12 +3304,12 @@ function registerReloadTools(server, sync) {
     {
       description: "Reload the running app's JS bundle (Expo Go, dev client, or RN CLI) \u2014 the equivalent of shaking the device and hitting Reload, but from here. Use it to pick up a change Fast Refresh didn't apply, to clear leaked in-memory state before a measurement, or to re-run app startup. In dev builds it uses React Native's DevSettings.reload(); otherwise it falls back to expo-updates (if the app installs it). All in-memory state is lost. By default this waits for the app to come back up and reports how long the reload took. Works on any app running @buoy-gg/core \u2014 no particular tool package needed. Requires Buoy Pro.",
       inputSchema: {
-        strategy: import_zod16.z.enum(["auto", "dev-settings", "expo-updates"]).optional().describe(
+        strategy: import_zod17.z.enum(["auto", "dev-settings", "expo-updates"]).optional().describe(
           "Reload mechanism. 'auto' (default) uses DevSettings in dev builds and expo-updates otherwise. Force one only when debugging the reload itself."
         ),
-        wait: import_zod16.z.boolean().optional().describe("Wait for the app to come back before returning. Default true \u2014 turn off for fire-and-forget."),
-        timeoutMs: import_zod16.z.number().optional().describe("How long to wait for the app to reconnect, in ms. Default 30000."),
-        deviceId: import_zod16.z.string().optional().describe('Target device id (auto-selected if one is connected). Use "All" to reload every connected app.')
+        wait: import_zod17.z.boolean().optional().describe("Wait for the app to come back before returning. Default true \u2014 turn off for fire-and-forget."),
+        timeoutMs: import_zod17.z.number().optional().describe("How long to wait for the app to reconnect, in ms. Default 30000."),
+        deviceId: import_zod17.z.string().optional().describe('Target device id (auto-selected if one is connected). Use "All" to reload every connected app.')
       }
     },
     async (args) => {
@@ -3106,19 +3325,19 @@ function registerReloadTools(server, sync) {
         );
         const via = ack?.strategy ? ` via ${ack.strategy}` : "";
         if (args.wait === false) {
-          return text14(`Reload requested${via}. The app is restarting \u2014 its in-memory state is gone; re-read anything you cached.`);
+          return text15(`Reload requested${via}. The app is restarting \u2014 its in-memory state is gone; re-read anything you cached.`);
         }
         const elapsed = await waitForAppBack(sync, target, args.timeoutMs ?? DEFAULT_WAIT_MS, previousRealm);
         if (elapsed == null) {
-          return fail16(
+          return fail17(
             `Reload was accepted${via}, but the app hasn't reconnected yet. It may still be building the bundle (a cold Metro rebuild can take a while) \u2014 check the device, then run list_devices.`
           );
         }
-        return text14(
+        return text15(
           `Reloaded the app${via} \u2014 back and connected after ${(elapsed / 1e3).toFixed(1)}s. All in-memory state was reset, so re-read any state you cached before this.`
         );
       } catch (e) {
-        return fail16(errMsg16(e));
+        return fail17(errMsg17(e));
       }
     }
   );
@@ -3162,6 +3381,12 @@ Debugging images (not loading, slow, stale cache, memory)? \`get_images\` lists
 expo-image load with cache verdicts and oversize audits; \`image_action\` reloads, retries, or
 simulates failures per image; \`set_image_simulation\` flips app-wide offline/cold/blank modes.
 
+Auditing app size / bundled assets? \`get_assets\` inventories everything the app SHIPS \u2014 images,
+fonts, video, audio \u2014 with byte sizes, scale coverage, and findings (duplicates, never-loaded,
+WebP candidates, heavy GIFs/fonts). \`asset_action\` rescans, fetches per-asset detail, and runs
+the baseline diff workflow (save_baseline \u2192 change something \u2192 get_assets shows what it added).
+get_images = what RENDERS at runtime; get_assets = what SHIPS in the bundle.
+
 Need the app RESTARTED (a change Fast Refresh didn't pick up, leaked in-memory state before a
 measurement, re-running startup)? \`reload_app\` reloads the JS bundle \u2014 DevSettings.reload() in dev
 builds, expo-updates otherwise \u2014 and waits for the app to reconnect. It wipes in-memory state, so
@@ -3198,11 +3423,12 @@ function createMcpServer(sync) {
   registerInteractTools(server, sync);
   registerJsThreadTools(server, sync);
   registerImagesTools(server, sync);
+  registerAssetsTools(server, sync);
   registerReloadTools(server, sync);
   return server;
 }
 var deviceIdField = {
-  deviceId: import_zod17.z.string().optional().describe(
+  deviceId: import_zod18.z.string().optional().describe(
     'Target device id (from list_devices). Omit to auto-select when exactly one device is connected. Use "All" to broadcast.'
   )
 };

package/dist/cli.mjs

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

package/dist/index.js

@@ -365,7 +365,7 @@ var delay = (ms) => new Promise((r) => setTimeout(r, ms));
 
 // src/server.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
-var import_zod17 = require("zod");
+var import_zod18 = require("zod");
 
 // src/tools/generic.ts
 var import_zod = require("zod");
@@ -376,7 +376,7 @@ var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
 
 // src/version.ts
-var VERSION = "7.0.14" ? "7.0.14" : "0.0.0-dev";
+var VERSION = "7.0.16" ? "7.0.16" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -2946,7 +2946,9 @@ function registerImagesTools(server, sync) {
             error: r.error,
             errorCode: r.errorCode,
             overrideLabel: r.overrideLabel,
-            loadCount: r.loadCount
+            loadCount: r.loadCount,
+            hasAltText: r.hasAltText,
+            layoutShifts: r.layoutShifts
           }))
         };
         return text13(`${md}
@@ -3075,17 +3077,234 @@ ${JSON.stringify(slim)}
   );
 }
 
-// src/tools/packs/reload.ts
+// src/tools/packs/assets.ts
 var import_zod16 = require("zod");
+var ASSETS_TOOL_ID = "assets";
+var text14 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail16 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg16 = (e) => e instanceof Error ? e.message : String(e);
+function kb(bytes) {
+  if (bytes == null || bytes <= 0) return "\u2013";
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(2)}MB`;
+}
+function sizeLabel(r) {
+  if (r.sizeBytes == null) return "\u2013";
+  return r.sizeSource === "measured" ? kb(r.sizeBytes) : `~${kb(r.sizeBytes)}`;
+}
+function scalesLabel(scales) {
+  if (!scales.length) return "\u2013";
+  return scales.map((s) => `@${s}x`).join(" ");
+}
+function flagsLabel(r, ins) {
+  const flags = [];
+  if (!r.loaded) flags.push("UNUSED");
+  if (ins.overDecode.includes(r.id)) flags.push("OVERSIZE");
+  if (ins.duplicates.some((d) => d.ids.includes(r.id))) flags.push("DUP");
+  if (ins.heavyGifs.includes(r.id) || ins.heavyFonts.includes(r.id)) flags.push("HEAVY");
+  if (ins.scaleAnomalies.includes(r.id)) flags.push("BAD-SCALE");
+  else if (ins.scaleGaps.includes(r.id)) flags.push("LOW-RES");
+  if (ins.webpCandidates.includes(r.id)) flags.push("WEBP");
+  return flags.length ? flags.join(" ") : "\u2013";
+}
+function formatListMarkdown2(list, limit) {
+  const lines = [];
+  const s = list.stats;
+  const ss = list.scanStatus;
+  lines.push(`## Asset inventory (${list.total} assets, showing ${Math.min(limit, list.records.length)}, largest first)`);
+  lines.push("");
+  const kindBits = Object.entries(s.byKind).filter(([, v]) => v.count > 0).map(([k, v]) => `${v.count} ${k}${v.bytes > 0 ? ` (${kb(v.bytes)})` : ""}`);
+  lines.push(
+    `${s.loaded} loaded \xB7 ${s.neverLoaded} never loaded \xB7 ` + (s.totalBytes > 0 ? `${kb(s.totalBytes)} measured (${s.measuredCount}/${s.total})` : "sizes not measured") + ` \xB7 ${kindBits.join(" \xB7 ")}`
+  );
+  if (ss.fontFamilies.length > 0) {
+    lines.push(`Loaded font families: ${ss.fontFamilies.join(", ")}`);
+  }
+  if (!ss.graphSupported || ss.graphCount == null) {
+    lines.push(
+      "\u26A0 No Metro bundle graph (release build or graph fetch failed) \u2014 showing runtime-registered assets only; never-loaded detection unavailable." + (ss.graphError ? ` (${ss.graphError})` : "")
+    );
+  }
+  if (ss.measuring) lines.push("\u26A0 Size measurement in progress \u2014 byte totals are partial; re-run get_assets shortly.");
+  const ins = list.insights;
+  const chips = [];
+  if (ins.neverLoaded.length) chips.push(`${ins.neverLoaded.length} never loaded`);
+  if (ins.duplicates.length) {
+    const wasted = ins.duplicates.reduce((sum, d) => sum + (d.wastedBytes ?? 0), 0);
+    chips.push(`${ins.duplicates.length} duplicate group(s)${wasted > 0 ? ` (${kb(wasted)} wasted)` : ""}`);
+  }
+  if (ins.overDecode.length) chips.push(`${ins.overDecode.length} decode larger than 2\xD7 the screen`);
+  if (ins.webpCandidates.length) chips.push(`${ins.webpCandidates.length} WebP candidate(s)`);
+  if (ins.heavyGifs.length) chips.push(`${ins.heavyGifs.length} heavy GIF(s)`);
+  if (ins.heavyFonts.length) chips.push(`${ins.heavyFonts.length} heavy font(s)`);
+  if (ins.scaleGaps.length) chips.push(`${ins.scaleGaps.length} scale gap(s)`);
+  if (ins.scaleAnomalies.length) chips.push(`${ins.scaleAnomalies.length} scale anomaly(ies)`);
+  if (chips.length) {
+    lines.push("");
+    lines.push(`**Findings:** ${chips.join(" \xB7 ")}`);
+  }
+  const diff = list.diff;
+  if (diff) {
+    const net = diff.netBytes == null ? "net unknown" : Math.abs(diff.netBytes) < 1024 ? "\xB10 net" : `${diff.netBytes >= 0 ? "+" : "\u2212"}${kb(Math.abs(diff.netBytes))} net`;
+    lines.push("");
+    lines.push(
+      `**Since baseline** (${new Date(diff.baselineSavedAt).toISOString()}): ${diff.added.length} added \xB7 ${diff.removed.length} removed \xB7 ${diff.grown.length} grew \xB7 ${net}` + (diff.removed.length ? ` \u2014 removed: ${diff.removed.slice(0, 5).map((r) => `${r.name}.${r.type}`).join(", ")}${diff.removed.length > 5 ? "\u2026" : ""}` : "")
+    );
+  }
+  lines.push("");
+  lines.push("| id | asset | kind | dims | scales | size | flags |");
+  lines.push("|---|---|---|---|---|---|---|");
+  for (const r of list.records) {
+    const dims = r.width != null && r.height != null ? `${Math.round(r.width)}\xD7${Math.round(r.height)}` : "\u2013";
+    lines.push(
+      `| ${r.id} | ${r.name}.${r.type} | ${r.kind} | ${dims} | ${scalesLabel(r.scales)} | ${sizeLabel(r)} | ${flagsLabel(r, ins)} |`
+    );
+  }
+  lines.push("");
+  lines.push(
+    "_Sizes marked ~ are decoded-memory estimates (unmeasurable in this environment). Use `asset_action` for rescan / measure_sizes / detail / baseline ops._"
+  );
+  return lines.join("\n");
+}
+function registerAssetsTools(server, sync) {
+  server.registerTool(
+    "get_assets",
+    {
+      description: "Bundled-asset inventory from the app: every asset (images, fonts, video, audio) with dimensions, @1x/@2x/@3x scale coverage, byte sizes (measured from the Metro server in dev), loaded vs never-loaded state, and audit findings \u2014 duplicates (by content hash), shipped-but-never-loaded, WebP candidates, images decoding larger than the screen, heavy GIFs/fonts, scale gaps \u2014 plus the change vs a saved baseline. This is what the app SHIPS; use get_images for what it RENDERS. Requires @buoy-gg/assets on the device.",
+      inputSchema: {
+        deviceId: import_zod16.z.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        limit: import_zod16.z.number().optional().describe("Max records to return (largest first). Default 40, max 500."),
+        kind: import_zod16.z.enum(["image", "font", "video", "audio", "data", "other"]).optional().describe("Only assets of this kind."),
+        unusedOnly: import_zod16.z.boolean().optional().describe("Only assets shipped in the bundle but never loaded at runtime.")
+      }
+    },
+    async ({ deviceId, limit, kind, unusedOnly }) => {
+      try {
+        const target = sync.requireProDevice(deviceId);
+        const capped = Math.min(Math.max(limit ?? 40, 1), 500);
+        const list = await sync.callAction(
+          ASSETS_TOOL_ID,
+          "list",
+          { limit: unusedOnly ? 500 : capped, kind, loadedOnly: false },
+          target
+        );
+        if (!list) return fail16("Device returned nothing \u2014 is @buoy-gg/assets installed in the app?");
+        if (unusedOnly) {
+          list.records = list.records.filter((r) => !r.loaded).slice(0, capped);
+        }
+        const md = formatListMarkdown2(list, capped);
+        const slim = {
+          stats: list.stats,
+          scanStatus: list.scanStatus,
+          insights: list.insights,
+          diff: list.diff,
+          records: list.records.map((r) => ({
+            id: r.id,
+            name: r.name,
+            type: r.type,
+            kind: r.kind,
+            hash: r.hash,
+            width: r.width,
+            height: r.height,
+            scales: r.scales,
+            loaded: r.loaded,
+            sizeBytes: r.sizeBytes,
+            sizeSource: r.sizeSource
+          }))
+        };
+        return text14(`${md}
+
+\`\`\`json
+${JSON.stringify(slim)}
+\`\`\``);
+      } catch (e) {
+        return fail16(errMsg16(e));
+      }
+    }
+  );
+  server.registerTool(
+    "asset_action",
+    {
+      description: "Drive the assets tool: rescan (re-walk the registry + merge the Metro bundle graph + refresh fonts + measure sizes \u2014 run this first if the inventory looks stale or empty), measure_sizes (re-measure byte sizes only), detail (full metadata for one asset by id: source dir, per-scale sizes, resolved URI, per-file graph paths), save_baseline (persist the current inventory for before/after comparison \u2014 save, make your change, then get_assets shows added/removed/grown/net bytes), clear_baseline, clear_records (wipe + rescan rebuilds).",
+      inputSchema: {
+        deviceId: import_zod16.z.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        action: import_zod16.z.enum(["rescan", "measure_sizes", "detail", "save_baseline", "clear_baseline", "clear_records"]).describe("What to do."),
+        id: import_zod16.z.number().optional().describe("Asset id from get_assets (detail only).")
+      }
+    },
+    async ({ deviceId, action, id }) => {
+      try {
+        const target = sync.requireProDevice(deviceId);
+        switch (action) {
+          case "rescan": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "rescan", {}, target);
+            const ss = result?.scanStatus;
+            if (!ss) return fail16("Device returned nothing for rescan.");
+            return text14(
+              `Rescan done: ${ss.registryCount} registered at runtime` + (ss.graphCount != null ? ` \xB7 ${ss.graphCount} in the bundle graph` : " \xB7 no bundle graph") + (ss.graphError ? ` (graph: ${ss.graphError})` : "") + ` \xB7 ${ss.fontFamilies.length} font families` + (ss.measuring ? " \xB7 size measurement running \u2014 get_assets in a moment" : "")
+            );
+          }
+          case "measure_sizes": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "measureSizes", {}, target);
+            return text14(`Measured ${result?.measured ?? 0} of ${result?.total ?? 0} assets.`);
+          }
+          case "detail": {
+            if (id == null) return fail16("detail requires the `id` param (from get_assets).");
+            const detail = await sync.callAction(ASSETS_TOOL_ID, "getDetail", { id }, target);
+            if (!detail) return fail16(`Asset ${id} not found \u2014 re-run get_assets for current ids.`);
+            const lines = [
+              `## ${detail.name}.${detail.type} (#${detail.id})`,
+              "",
+              `- Kind: ${detail.kind} \xB7 ${detail.loaded ? "loaded at runtime" : "in bundle, NEVER loaded"} (${detail.origin})`
+            ];
+            if (detail.width != null) lines.push(`- Dimensions: ${detail.width}\xD7${detail.height} logical \xB7 scales ${scalesLabel(detail.scales)}`);
+            if (detail.sizesByScale) {
+              for (const [scale, bytes] of Object.entries(detail.sizesByScale)) {
+                lines.push(`- Size @${scale}x: ${kb(bytes)}`);
+              }
+            }
+            if (detail.sizeBytes != null) lines.push(`- Total: ${sizeLabel(detail)}`);
+            if (detail.estDecodedBytes) lines.push(`- Decoded memory: ~${kb(detail.estDecodedBytes)} (RGBA)`);
+            if (detail.hash) lines.push(`- Hash: ${detail.hash}`);
+            if (detail.fileSystemLocation) lines.push(`- Source dir: ${detail.fileSystemLocation}`);
+            if (detail.files?.length) lines.push(`- Files: ${detail.files.join(", ")}`);
+            if (detail.uri) lines.push(`- Resolved URI: ${detail.uri}`);
+            return text14(lines.join("\n"));
+          }
+          case "save_baseline": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "saveBaseline", {}, target);
+            return text14(
+              `Baseline saved (${result?.assets ?? 0} assets). Make your change, then get_assets reports added/removed/grown/net bytes against it.`
+            );
+          }
+          case "clear_baseline": {
+            await sync.callAction(ASSETS_TOOL_ID, "clearBaseline", {}, target);
+            return text14("Baseline cleared.");
+          }
+          case "clear_records": {
+            const result = await sync.callAction(ASSETS_TOOL_ID, "clearRecords", {}, target);
+            return text14(result?.message ?? "Inventory cleared.");
+          }
+        }
+      } catch (e) {
+        return fail16(errMsg16(e));
+      }
+    }
+  );
+}
+
+// src/tools/packs/reload.ts
+var import_zod17 = require("zod");
 var APP_TOOL_ID = "app";
 var RELOAD_ACTION = "reloadApp";
 var DEFAULT_WAIT_MS = 3e4;
 var TEARDOWN_GRACE_MS = 1200;
 var PROBE_TIMEOUT_MS = 1500;
 var PROBE_INTERVAL_MS = 400;
-var text14 = (s) => ({ content: [{ type: "text", text: s }] });
-var fail16 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
-var errMsg16 = (e) => e instanceof Error ? e.message : String(e);
+var text15 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail17 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg17 = (e) => e instanceof Error ? e.message : String(e);
 var delay3 = (ms) => new Promise((r) => setTimeout(r, ms));
 async function ping(sync, deviceId, timeoutMs) {
   try {
@@ -3120,12 +3339,12 @@ function registerReloadTools(server, sync) {
     {
       description: "Reload the running app's JS bundle (Expo Go, dev client, or RN CLI) \u2014 the equivalent of shaking the device and hitting Reload, but from here. Use it to pick up a change Fast Refresh didn't apply, to clear leaked in-memory state before a measurement, or to re-run app startup. In dev builds it uses React Native's DevSettings.reload(); otherwise it falls back to expo-updates (if the app installs it). All in-memory state is lost. By default this waits for the app to come back up and reports how long the reload took. Works on any app running @buoy-gg/core \u2014 no particular tool package needed. Requires Buoy Pro.",
       inputSchema: {
-        strategy: import_zod16.z.enum(["auto", "dev-settings", "expo-updates"]).optional().describe(
+        strategy: import_zod17.z.enum(["auto", "dev-settings", "expo-updates"]).optional().describe(
           "Reload mechanism. 'auto' (default) uses DevSettings in dev builds and expo-updates otherwise. Force one only when debugging the reload itself."
         ),
-        wait: import_zod16.z.boolean().optional().describe("Wait for the app to come back before returning. Default true \u2014 turn off for fire-and-forget."),
-        timeoutMs: import_zod16.z.number().optional().describe("How long to wait for the app to reconnect, in ms. Default 30000."),
-        deviceId: import_zod16.z.string().optional().describe('Target device id (auto-selected if one is connected). Use "All" to reload every connected app.')
+        wait: import_zod17.z.boolean().optional().describe("Wait for the app to come back before returning. Default true \u2014 turn off for fire-and-forget."),
+        timeoutMs: import_zod17.z.number().optional().describe("How long to wait for the app to reconnect, in ms. Default 30000."),
+        deviceId: import_zod17.z.string().optional().describe('Target device id (auto-selected if one is connected). Use "All" to reload every connected app.')
       }
     },
     async (args) => {
@@ -3141,19 +3360,19 @@ function registerReloadTools(server, sync) {
         );
         const via = ack?.strategy ? ` via ${ack.strategy}` : "";
         if (args.wait === false) {
-          return text14(`Reload requested${via}. The app is restarting \u2014 its in-memory state is gone; re-read anything you cached.`);
+          return text15(`Reload requested${via}. The app is restarting \u2014 its in-memory state is gone; re-read anything you cached.`);
         }
         const elapsed = await waitForAppBack(sync, target, args.timeoutMs ?? DEFAULT_WAIT_MS, previousRealm);
         if (elapsed == null) {
-          return fail16(
+          return fail17(
             `Reload was accepted${via}, but the app hasn't reconnected yet. It may still be building the bundle (a cold Metro rebuild can take a while) \u2014 check the device, then run list_devices.`
           );
         }
-        return text14(
+        return text15(
           `Reloaded the app${via} \u2014 back and connected after ${(elapsed / 1e3).toFixed(1)}s. All in-memory state was reset, so re-read any state you cached before this.`
         );
       } catch (e) {
-        return fail16(errMsg16(e));
+        return fail17(errMsg17(e));
       }
     }
   );
@@ -3197,6 +3416,12 @@ Debugging images (not loading, slow, stale cache, memory)? \`get_images\` lists
 expo-image load with cache verdicts and oversize audits; \`image_action\` reloads, retries, or
 simulates failures per image; \`set_image_simulation\` flips app-wide offline/cold/blank modes.
 
+Auditing app size / bundled assets? \`get_assets\` inventories everything the app SHIPS \u2014 images,
+fonts, video, audio \u2014 with byte sizes, scale coverage, and findings (duplicates, never-loaded,
+WebP candidates, heavy GIFs/fonts). \`asset_action\` rescans, fetches per-asset detail, and runs
+the baseline diff workflow (save_baseline \u2192 change something \u2192 get_assets shows what it added).
+get_images = what RENDERS at runtime; get_assets = what SHIPS in the bundle.
+
 Need the app RESTARTED (a change Fast Refresh didn't pick up, leaked in-memory state before a
 measurement, re-running startup)? \`reload_app\` reloads the JS bundle \u2014 DevSettings.reload() in dev
 builds, expo-updates otherwise \u2014 and waits for the app to reconnect. It wipes in-memory state, so
@@ -3233,11 +3458,12 @@ function createMcpServer(sync) {
   registerInteractTools(server, sync);
   registerJsThreadTools(server, sync);
   registerImagesTools(server, sync);
+  registerAssetsTools(server, sync);
   registerReloadTools(server, sync);
   return server;
 }
 var deviceIdField = {
-  deviceId: import_zod17.z.string().optional().describe(
+  deviceId: import_zod18.z.string().optional().describe(
     'Target device id (from list_devices). Omit to auto-select when exactly one device is connected. Use "All" to broadcast.'
   )
 };

package/dist/index.mjs

@@ -27,7 +27,7 @@ import {
   registerStorageTools,
   registerZustandTools,
   runInit
-} from "./chunk-ZEHIU6OG.mjs";
+} from "./chunk-P2OALRPK.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.14",
+  "version": "7.0.16",
   "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",
@@ -31,7 +31,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "socket.io-client": "^4.8.1",
     "zod": "^3.25.0",
-    "@buoy-gg/sync-broker": "^7.0.14"
+    "@buoy-gg/sync-broker": "^7.0.16"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",