@buoy-gg/mcp 7.0.3 → 7.0.5

package/dist/{chunk-MGZN6MJE.mjs → chunk-KZFJFXI4.mjs}

@@ -296,7 +296,7 @@ async function waitForBroker(url, attempts = 20) {
 var delay = (ms) => new Promise((r) => setTimeout(r, ms));
 
 // src/version.ts
-var VERSION = "7.0.3" ? "7.0.3" : "0.0.0-dev";
+var VERSION = "7.0.5" ? "7.0.5" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -2006,17 +2006,238 @@ function registerScreenshotTools(server, sync) {
 
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z as z15 } from "zod";
+import { z as z17 } from "zod";
 
-// src/tools/packs/interact.ts
+// src/tools/packs/network.ts
 import { z as z12 } from "zod";
-var TOOL_ID2 = "highlight-updates";
+var NETWORK_TOOL_ID = "network";
 var text10 = (s) => ({ content: [{ type: "text", text: s }] });
-var fail12 = (message) => ({
+var fail12 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg12 = (e) => e instanceof Error ? e.message : String(e);
+function parseSnapshot(payload) {
+  if (Array.isArray(payload)) return { events: payload, saved: [] };
+  if (payload && typeof payload === "object") {
+    const shaped = payload;
+    return {
+      events: Array.isArray(shaped.events) ? shaped.events : [],
+      saved: Array.isArray(shaped.saved) ? shaped.saved : []
+    };
+  }
+  return { events: [], saved: [] };
+}
+function statusIcon(e) {
+  if (e.error) return "\u274C";
+  if (e.status === void 0) return "\u23F3";
+  if (e.status >= 400) return "\u274C";
+  if (e.status >= 300) return "\u21AA\uFE0F";
+  return "\u2705";
+}
+function statusLabel(e) {
+  if (e.error) return `ERR ${e.error}`;
+  if (e.status === void 0) return "pending";
+  return String(e.status);
+}
+function formatBytes(n) {
+  if (!n) return "";
+  if (n < 1024) return `${n}B`;
+  if (n < 1024 * 1024) return `${Math.round(n / 1024)}KB`;
+  return `${(n / (1024 * 1024)).toFixed(1)}MB`;
+}
+function matchesStatus(e, status) {
+  if (!status || status === "all") return true;
+  const failed = !!e.error || e.status !== void 0 && e.status >= 400;
+  if (status === "errors") return failed;
+  if (status === "pending") return e.status === void 0 && !e.error;
+  if (status === "success") return !failed && e.status !== void 0;
+  return true;
+}
+function truncate2(v, n = 600) {
+  if (v === null || v === void 0) return "(none)";
+  const s = typeof v === "string" ? v : JSON.stringify(v);
+  return s.length > n ? `${s.slice(0, n)}\u2026(+${s.length - n} chars)` : s;
+}
+function formatRow(index, e, markers) {
+  const where = e.path || e.url;
+  const bits = [
+    `${e.duration !== void 0 ? `${Math.round(e.duration)}ms` : "\u2014"}`,
+    formatBytes(e.responseSize),
+    e.host ?? "",
+    e.requestClient ?? ""
+  ].filter(Boolean);
+  const op = e.operationName ? ` (${e.operationName})` : "";
+  return `${index}. \`${e.id}\` ${statusIcon(e)} ${statusLabel(e)} ${e.method} ${where}${op}${markers ? ` ${markers}` : ""}
+   \u2514\u2500 ${bits.join(" \xB7 ")}`;
+}
+function registerNetworkTools(server, sync) {
+  server.registerTool(
+    "get_network_requests",
+    {
+      description: "List captured HTTP requests WITH their request ids, plus which ones are pinned/saved. Use this (not get_events) when you need to ACT on a request \u2014 every network action is keyed by the id, and get_events does not emit ids. Compact by default: one line per request (id \xB7 status \xB7 method \xB7 path \xB7 timing \xB7 size). Set flagged:'pinned'|'saved'|'any' to read the developer's KEPT requests \u2014 those are snapshots that outlive Clear, the 500-request cap and app restarts, so treat a pinned request as 'a human flagged this as the problem'. Filter with status:'errors' to go straight to failures, or `pattern` to match a URL substring. includeBodies:true adds truncated request/response payloads (heavier).",
+      inputSchema: {
+        limit: z12.number().optional().describe("Most-recent N requests. Default 25."),
+        pattern: z12.string().optional().describe("Only requests whose URL contains this substring (case-insensitive)."),
+        status: z12.enum(["all", "errors", "success", "pending"]).optional().describe("Filter by outcome. Default all."),
+        flagged: z12.enum(["pinned", "saved", "any"]).optional().describe("Read KEPT requests instead of the live list: 'pinned' (held at the top of the developer's list), 'saved' (their favorites), 'any' (either). These survive Clear and app restarts."),
+        includeBodies: z12.boolean().optional().describe("Include truncated request/response bodies. Default false (compact)."),
+        deviceId: z12.string().optional().describe("Target device id (auto-selected if one is connected).")
+      }
+    },
+    async (args) => {
+      try {
+        const target = sync.requireProDevice(args.deviceId);
+        const { payload } = await sync.getSnapshot(NETWORK_TOOL_ID, target);
+        const { events, saved } = parseSnapshot(payload);
+        const limit = typeof args.limit === "number" && args.limit > 0 ? args.limit : 25;
+        const pattern = args.pattern?.toLowerCase();
+        const pinnedIds = /* @__PURE__ */ new Set();
+        const savedIds = /* @__PURE__ */ new Set();
+        for (const r of saved) {
+          if (r.pinned) pinnedIds.add(r.event?.id);
+          if (r.saved) savedIds.add(r.event?.id);
+          if (r.pinned) pinnedIds.add(r.liveId);
+          if (r.saved) savedIds.add(r.liveId);
+        }
+        if (args.flagged) {
+          const wanted = saved.filter(
+            (r) => args.flagged === "pinned" ? r.pinned : args.flagged === "saved" ? r.saved : r.pinned || r.saved
+          );
+          const rows2 = wanted.filter((r) => r.event && matchesStatus(r.event, args.status)).filter((r) => !pattern || (r.event.url ?? "").toLowerCase().includes(pattern)).slice(0, limit);
+          if (rows2.length === 0) {
+            return text10(
+              `No ${args.flagged === "any" ? "pinned or saved" : args.flagged} requests on ${target}.
+
+The developer pins/saves a request from the Network tool (long-press a row, or the pin/bookmark buttons in the request detail header), or you can with network_action.`
+            );
+          }
+          const body2 = rows2.map((r, i) => {
+            const marks = [r.pinned ? "\u{1F4CC} pinned" : "", r.saved ? "\u{1F516} saved" : ""].filter(Boolean).join(" ");
+            const stale = r.event.id?.startsWith("saved:") ? " \xB7 from an earlier app run" : "";
+            const trunc = r.bodyTruncated ? " \xB7 body truncated" : "";
+            let out = formatRow(i + 1, r.event, marks);
+            out += `
+   \u2514\u2500 key \`${r.key}\`${stale}${trunc}`;
+            if (args.includeBodies) {
+              out += `
+   \u2514\u2500 request: ${truncate2(r.event.requestData)}`;
+              out += `
+   \u2514\u2500 response: ${truncate2(r.event.responseData)}`;
+            }
+            return out;
+          }).join("\n");
+          return text10(
+            `**Kept requests on ${target}** \u2014 ${rows2.length} of ${wanted.length}
+
+${body2}
+
+_These are snapshots: they survive Clear, the 500-request cap and app restarts. Remove one with network_action({action:"remove", key}). Ids starting \`saved:\` are from an earlier run of the app._`
+          );
+        }
+        const rows = events.filter((e) => matchesStatus(e, args.status)).filter((e) => !pattern || (e.url ?? "").toLowerCase().includes(pattern)).slice(0, limit);
+        if (rows.length === 0) {
+          const why = events.length === 0 ? "The network tool has captured nothing yet (is it enabled, and has the app made a request?)." : "No request matched the filter.";
+          return text10(`No requests on ${target}. ${why}`);
+        }
+        const body = rows.map((e, i) => {
+          const marks = [pinnedIds.has(e.id) ? "\u{1F4CC}" : "", savedIds.has(e.id) ? "\u{1F516}" : ""].filter(Boolean).join("");
+          let out = formatRow(i + 1, e, marks);
+          if (args.includeBodies) {
+            out += `
+   \u2514\u2500 request: ${truncate2(e.requestData)}`;
+            out += `
+   \u2514\u2500 response: ${truncate2(e.responseData)}`;
+          }
+          return out;
+        }).join("\n");
+        const keptNote = saved.length > 0 ? ` \xB7 ${saved.length} kept (flagged:'any' to list)` : "";
+        return text10(
+          `**Network requests on ${target}** \u2014 ${rows.length} of ${events.length}${keptNote}
+
+${body}
+
+_\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_action({action:"pin", id:"${rows[0].id}"})._`
+        );
+      } catch (e) {
+        return fail12(errMsg12(e));
+      }
+    }
+  );
+  server.registerTool(
+    "network_action",
+    {
+      description: "Act on captured HTTP requests: PIN one (holds it at the top of the developer's Network list, ignoring their filters), SAVE one to their favorites, or clear the list. Pinning and saving keep a full snapshot that survives Clear, the 500-request cap and app restarts \u2014 so this is how you hand a request to a human ('I pinned the failing call') or keep one you'll need after the log rolls over. Get ids from get_network_requests (get_events does not emit them). `remove` takes the record `key` from get_network_requests({flagged:'any'}), not a request id.",
+      inputSchema: {
+        action: z12.enum(["pin", "unpin", "save", "unsave", "remove", "clearPinned", "clearSaved", "clearRequests"]).describe("pin/unpin/save/unsave act on one request by `id`. remove drops one kept record by `key`. clearPinned/clearSaved drop all of that kind. clearRequests wipes the live capture list (kept requests survive)."),
+        id: z12.string().optional().describe("Request id for pin/unpin/save/unsave \u2014 from get_network_requests."),
+        key: z12.string().optional().describe("Kept-record key for `remove` \u2014 from get_network_requests({flagged:'any'})."),
+        deviceId: z12.string().optional().describe("Target device id (auto-selected if one is connected).")
+      }
+    },
+    async (args) => {
+      try {
+        const target = sync.requireProDevice(args.deviceId);
+        const needsId = ["pin", "unpin", "save", "unsave"].includes(args.action);
+        if (needsId && !args.id) {
+          return fail12(`"${args.action}" needs an \`id\`. List requests with get_network_requests to get one.`);
+        }
+        if (args.action === "remove" && !args.key) {
+          return fail12('"remove" needs a `key` (not a request id). Get it from get_network_requests({flagged:"any"}).');
+        }
+        switch (args.action) {
+          case "pin":
+          case "unpin": {
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "setPinned",
+              { id: args.id, pinned: args.action === "pin" },
+              target
+            );
+            if (res === null) return fail12(`No request "${args.id}" on ${target}. It may have been cleared or aged out \u2014 re-list with get_network_requests.`);
+            const capped = typeof res === "object" && res !== null && res.reason === "pin-cap";
+            if (capped) return fail12(`Pin limit reached on ${target}. Unpin something first (network_action({action:"clearPinned"}) drops them all).`);
+            return text10(`${args.action === "pin" ? "\u{1F4CC} Pinned" : "Unpinned"} \`${args.id}\` on ${target}.`);
+          }
+          case "save":
+          case "unsave": {
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "setSaved",
+              { id: args.id, saved: args.action === "save" },
+              target
+            );
+            if (res === null) return fail12(`No request "${args.id}" on ${target}. It may have been cleared or aged out \u2014 re-list with get_network_requests.`);
+            const capped = typeof res === "object" && res !== null && res.reason === "saved-cap";
+            if (capped) return fail12(`Saved-request limit reached on ${target}. Remove one first, or network_action({action:"clearSaved"}).`);
+            return text10(`${args.action === "save" ? "\u{1F516} Saved" : "Unsaved"} \`${args.id}\` on ${target}.`);
+          }
+          case "remove":
+            await sync.callAction(NETWORK_TOOL_ID, "removeSavedRecord", { key: args.key }, target);
+            return text10(`Removed kept record \`${args.key}\` on ${target}.`);
+          case "clearPinned":
+            await sync.callAction(NETWORK_TOOL_ID, "clearPinnedRequests", {}, target);
+            return text10(`Unpinned all requests on ${target} (saved ones kept).`);
+          case "clearSaved":
+            await sync.callAction(NETWORK_TOOL_ID, "clearSavedRequests", {}, target);
+            return text10(`Cleared saved requests on ${target} (pinned ones kept).`);
+          case "clearRequests":
+            await sync.callAction(NETWORK_TOOL_ID, "clearEvents", {}, target);
+            return text10(`Cleared the captured request list on ${target}. Pinned/saved requests are unaffected.`);
+        }
+      } catch (e) {
+        return fail12(errMsg12(e));
+      }
+    }
+  );
+}
+
+// src/tools/packs/interact.ts
+import { z as z13 } from "zod";
+var TOOL_ID2 = "highlight-updates";
+var text11 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail13 = (message) => ({
   isError: true,
   content: [{ type: "text", text: message }]
 });
-var errMsg12 = (e) => e instanceof Error ? e.message : String(e);
+var errMsg13 = (e) => e instanceof Error ? e.message : String(e);
 function formatElement(e) {
   let line = e.interactive ? "\u2022 " : "  ";
   line += e.name;
@@ -2024,6 +2245,7 @@ function formatElement(e) {
   if (display) line += ` "${display}"`;
   if (e.role) line += ` <${e.role}>`;
   if (e.control) line += ` {${e.control}${e.value !== void 0 ? `=${JSON.stringify(e.value)}` : ""}}`;
+  if (e.longPressable) line += " {long-press}";
   if (e.testID) line += ` [testID=${e.testID}]`;
   if (e.tap) line += ` (tap: ${e.tap.x},${e.tap.y})`;
   if (e.nativeTag != null) line += ` #${e.nativeTag}`;
@@ -2035,8 +2257,8 @@ function registerInteractTools(server, sync) {
     {
       description: "List the interactive / labeled elements currently on screen \u2014 the app's live accessibility-style tree walked from the React fiber tree. Each row shows the component name, visible text/label, role, testID, a normalized tap point (tap: x,y in 0\u20131), and its #nativeTag. Rows marked with \u2022 are tappable (have an onPress). Use this to see what's on screen and pick something to tap with tap_element \u2014 no screenshot needed. Re-run after navigating or when the screen changes, since positions move. Requires Buoy Pro.",
       inputSchema: {
-        interactiveOnly: z12.boolean().optional().describe("Only return tappable (onPress) elements. Default false (include labels/text for context)."),
-        deviceId: z12.string().optional().describe("Target device id (auto-selected if one is connected).")
+        interactiveOnly: z13.boolean().optional().describe("Only return tappable (onPress) elements. Default false (include labels/text for context)."),
+        deviceId: z13.string().optional().describe("Target device id (auto-selected if one is connected).")
       }
     },
     async (args) => {
@@ -2046,37 +2268,38 @@ function registerInteractTools(server, sync) {
         const all = res?.elements ?? [];
         const elements = args.interactiveOnly ? all.filter((e) => e.interactive) : all;
         if (elements.length === 0) {
-          return text10(
+          return text11(
             "No elements found on screen. If the app just navigated, wait a moment and retry; make sure highlight-updates is enabled in the app."
           );
         }
         const header = `Screen ${res.screen.width}\xD7${res.screen.height} \u2014 ${elements.length} element${elements.length === 1 ? "" : "s"} (\u2022 = tappable). Tap with tap_element({ testID | query | nativeTag }).`;
-        return text10(`${header}
+        return text11(`${header}
 
 ${elements.map(formatElement).join("\n")}`);
       } catch (e) {
-        return fail12(errMsg12(e));
+        return fail13(errMsg13(e));
       }
     }
   );
   server.registerTool(
     "tap_element",
     {
-      description: "Interact with an on-screen element by invoking its handler directly in JS (no screenshot, no coordinate math, works on real devices). Handles buttons (onPress), toggles/switches and sliders (onValueChange), and text inputs (onChangeText) \u2014 see each element's `control` in describe_screen. Identify the target with an exact `nativeTag` or `testID`, or a fuzzy `query`. For a toggle, pass `value:true/false` (omit to flip); for a slider, pass a numeric `value` (omit to jump to the far end); for a text input, pass `text`. If the element is off-screen it's scrolled into view first (scrollIntoView:false to skip). Call describe_screen first to see options + current values. Requires Buoy Pro.",
+      description: "Interact with an on-screen element by invoking its handler directly in JS (no screenshot, no coordinate math, works on real devices). Handles buttons (onPress + onLongPress), toggles/switches and sliders (onValueChange), and text inputs (onChangeText) \u2014 see each element's `control` in describe_screen. Identify the target with an exact `nativeTag` or `testID`, or a fuzzy `query`. Pass `longPress:true` to invoke onLongPress instead of onPress (elements that support it show {long-press} in describe_screen). For a toggle, pass `value:true/false` (omit to flip); for a slider, pass a numeric `value` (omit to jump to the far end); for a text input, pass `text`. If the element is off-screen it's scrolled into view first (scrollIntoView:false to skip). Call describe_screen first to see options + current values. Requires Buoy Pro.",
       inputSchema: {
-        nativeTag: z12.number().optional().describe("Exact nativeTag from describe_screen (most precise)."),
-        testID: z12.string().optional().describe("Exact testID of the element."),
-        query: z12.string().optional().describe('Fuzzy match against testID / label / visible text / component name \u2014 e.g. "Sign in".'),
-        value: z12.union([z12.number(), z12.boolean()]).optional().describe("For a toggle: true/false (omit to flip). For a slider: the numeric value (omit to jump to the far end)."),
-        text: z12.string().optional().describe("For a text input: the string to set via onChangeText."),
-        scrollIntoView: z12.boolean().optional().describe("Scroll the target into view first if it's off-screen. Default true."),
-        deviceId: z12.string().optional().describe("Target device id (auto-selected if one is connected).")
+        nativeTag: z13.number().optional().describe("Exact nativeTag from describe_screen (most precise)."),
+        testID: z13.string().optional().describe("Exact testID of the element."),
+        query: z13.string().optional().describe('Fuzzy match against testID / label / visible text / component name \u2014 e.g. "Sign in".'),
+        value: z13.union([z13.number(), z13.boolean()]).optional().describe("For a toggle: true/false (omit to flip). For a slider: the numeric value (omit to jump to the far end)."),
+        text: z13.string().optional().describe("For a text input: the string to set via onChangeText."),
+        longPress: z13.boolean().optional().describe("Invoke the element's onLongPress instead of onPress. Fails with a clear reason if the element has no onLongPress handler."),
+        scrollIntoView: z13.boolean().optional().describe("Scroll the target into view first if it's off-screen. Default true."),
+        deviceId: z13.string().optional().describe("Target device id (auto-selected if one is connected).")
       }
     },
     async (args) => {
       try {
         if (args.nativeTag == null && !args.testID && !args.query) {
-          return fail12("Provide one of: nativeTag, testID, or query (from describe_screen).");
+          return fail13("Provide one of: nativeTag, testID, or query (from describe_screen).");
         }
         const target = sync.requireProDevice(args.deviceId);
         const res = await sync.callAction(
@@ -2088,6 +2311,7 @@ ${elements.map(formatElement).join("\n")}`);
             query: args.query,
             value: args.value,
             text: args.text,
+            longPress: args.longPress,
             scrollIntoView: args.scrollIntoView
           },
           target
@@ -2097,27 +2321,27 @@ ${elements.map(formatElement).join("\n")}`);
           const label = m.text ?? m.label ?? m.name;
           const id = m.testID ? ` [testID=${m.testID}]` : m.nativeTag != null ? ` #${m.nativeTag}` : "";
           const scrolledNote = res.scrolled ? " (scrolled into view)" : "";
-          const verb = m.via === "onValueChange" ? `Set "${label}"${id} \u2192 ${JSON.stringify(m.value)}` : m.via === "onChangeText" ? `Typed ${JSON.stringify(m.value)} into "${label}"${id}` : `Tapped "${label}"${id}${m.via === "onLongPress" ? " (via onLongPress)" : ""}`;
-          return text10(`${verb}${scrolledNote}.`);
+          const verb = m.via === "onValueChange" ? `Set "${label}"${id} \u2192 ${JSON.stringify(m.value)}` : m.via === "onChangeText" ? `Typed ${JSON.stringify(m.value)} into "${label}"${id}` : m.via === "onLongPress" ? `Long-pressed "${label}"${id}` : `Tapped "${label}"${id}`;
+          return text11(`${verb}${scrolledNote}.`);
         }
         let msg = res?.reason ?? "Tap failed.";
         if (res?.candidates?.length) {
           msg += "\n\nTappable candidates:\n" + res.candidates.map((c) => `- ${c.name}${c.text ? ` "${c.text}"` : ""}${c.testID ? ` [testID=${c.testID}]` : ""}${c.nativeTag != null ? ` #${c.nativeTag}` : ""}`).join("\n");
         }
-        return fail12(msg);
+        return fail13(msg);
       } catch (e) {
-        return fail12(errMsg12(e));
+        return fail13(errMsg13(e));
       }
     }
   );
 }
 
 // src/tools/packs/jsThread.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 var JS_TOP_TOOL_ID = "js-top";
-var text11 = (s) => ({ content: [{ type: "text", text: s }] });
-var fail13 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
-var errMsg13 = (e) => e instanceof Error ? e.message : String(e);
+var text12 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail14 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg14 = (e) => e instanceof Error ? e.message : String(e);
 var SPARK_CHARS = "\u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
 function sparkline(values) {
   const max = Math.max(1, ...values);
@@ -2188,9 +2412,9 @@ function registerJsThreadTools(server, sync) {
     {
       description: "Task Manager for the React Native JS thread: sample for a few seconds and return a ranked table of which task origins (timers, Promise chains, rAF callbacks, bridge call-ins) consumed JS-thread time \u2014 plus thread busy% and freeze (50ms+ block) attribution. Use when JS FPS is low and you need to know WHAT is eating the thread. To profile one specific interaction, pass clearFirst:true, then drive the UI with tap_element while the sample runs. Drill into a row with get_js_thread_origin_detail. Requires @buoy-gg/js-top on the device.",
       inputSchema: {
-        deviceId: z13.string().optional().describe("Target device id (auto-selected if one is connected)."),
-        durationMs: z13.number().optional().describe("How long to sample before reading the table. Default 3000, max 30000."),
-        clearFirst: z13.boolean().optional().describe("Reset all stats before sampling, so the result attributes only what happens during this sample.")
+        deviceId: z14.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        durationMs: z14.number().optional().describe("How long to sample before reading the table. Default 3000, max 30000."),
+        clearFirst: z14.boolean().optional().describe("Reset all stats before sampling, so the result attributes only what happens during this sample.")
       }
     },
     async ({ deviceId, durationMs, clearFirst }) => {
@@ -2203,7 +2427,7 @@ function registerJsThreadTools(server, sync) {
           { durationMs: duration, clearFirst: clearFirst === true },
           target
         );
-        if (!snap) return fail13("Device returned no snapshot \u2014 is @buoy-gg/js-top installed in the app?");
+        if (!snap) return fail14("Device returned no snapshot \u2014 is @buoy-gg/js-top installed in the app?");
         const md = formatTopMarkdown(snap, duration);
         const slim = {
           busyPct: Math.round(snap.busyPct * 10) / 10,
@@ -2222,13 +2446,13 @@ function registerJsThreadTools(server, sync) {
             worstFreezeMs: r.worstFreezeMs
           }))
         };
-        return text11(`${md}
+        return text12(`${md}
 
 \`\`\`json
 ${JSON.stringify(slim)}
 \`\`\``);
       } catch (e) {
-        return fail13(errMsg13(e));
+        return fail14(errMsg14(e));
       }
     }
   );
@@ -2237,8 +2461,8 @@ ${JSON.stringify(slim)}
     {
       description: 'Inspect one js-top task origin in depth: schedules vs runs, avg/max/total exclusive ms, a 5s activity sparkline, freeze attribution, and the captured scheduling site (caller function + stack frames). Pass a row `key` from get_js_thread_top\'s JSON (e.g. "interval|pollFeed" or "unattributed" for the system row).',
       inputSchema: {
-        deviceId: z13.string().optional().describe("Target device id (auto-selected if one is connected)."),
-        key: z13.string().describe("Origin key from get_js_thread_top's JSON rows.")
+        deviceId: z14.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        key: z14.string().describe("Origin key from get_js_thread_top's JSON rows.")
       }
     },
     async ({ deviceId, key }) => {
@@ -2251,18 +2475,18 @@ ${JSON.stringify(slim)}
           target
         );
         if (!detail) {
-          return fail13(
+          return fail14(
             `Origin "${key}" is not tracked (cleared, evicted, or never existed). Re-run get_js_thread_top for current keys.`
           );
         }
         const md = formatDetailMarkdown(detail);
-        return text11(`${md}
+        return text12(`${md}
 
 \`\`\`json
 ${JSON.stringify(detail)}
 \`\`\``);
       } catch (e) {
-        return fail13(errMsg13(e));
+        return fail14(errMsg14(e));
       }
     }
   );
@@ -2271,27 +2495,27 @@ ${JSON.stringify(detail)}
     {
       description: "Reset the js-top task table, freeze history, and busy history on the device (fresh measurement window).",
       inputSchema: {
-        deviceId: z13.string().optional().describe("Target device id (auto-selected if one is connected).")
+        deviceId: z14.string().optional().describe("Target device id (auto-selected if one is connected).")
       }
     },
     async ({ deviceId }) => {
       try {
         const target = sync.requireProDevice(deviceId);
         await sync.callAction(JS_TOP_TOOL_ID, "clear", {}, target);
-        return text11("Cleared js-top stats.");
+        return text12("Cleared js-top stats.");
       } catch (e) {
-        return fail13(errMsg13(e));
+        return fail14(errMsg14(e));
       }
     }
   );
 }
 
 // src/tools/packs/images.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 var IMAGES_TOOL_ID = "images";
-var text12 = (s) => ({ content: [{ type: "text", text: s }] });
-var fail14 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
-var errMsg14 = (e) => e instanceof Error ? e.message : String(e);
+var text13 = (s) => ({ content: [{ type: "text", text: s }] });
+var fail15 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
+var errMsg15 = (e) => e instanceof Error ? e.message : String(e);
 function uriTail(uri) {
   if (!uri) return "(no source)";
   const unstable = uri.match(/[?&]unstable_path=([^&?]+)/);
@@ -2379,9 +2603,9 @@ function registerImagesTools(server, sync) {
     {
       description: "Live image registry from the app: every RN <Image> and expo-image load with cache verdict (memory/disk/network), load ms, decoded vs displayed size with an oversize/upscale verdict and wasted-KB estimate, error details, and any active simulation overrides. Image HTTP never hits the JS network stack, so this is the only visibility into image loading. Requires @buoy-gg/images on the device.",
       inputSchema: {
-        deviceId: z14.string().optional().describe("Target device id (auto-selected if one is connected)."),
-        limit: z14.number().optional().describe("Max records to return (newest first). Default 30, max 200."),
-        status: z14.enum(["pending", "loading", "loaded", "error"]).optional().describe("Only records in this state (e.g. 'error' for the failure log).")
+        deviceId: z15.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        limit: z15.number().optional().describe("Max records to return (newest first). Default 30, max 200."),
+        status: z15.enum(["pending", "loading", "loaded", "error"]).optional().describe("Only records in this state (e.g. 'error' for the failure log).")
       }
     },
     async ({ deviceId, limit, status }) => {
@@ -2394,7 +2618,7 @@ function registerImagesTools(server, sync) {
           { limit: capped, status },
           target
         );
-        if (!list) return fail14("Device returned nothing \u2014 is @buoy-gg/images installed in the app?");
+        if (!list) return fail15("Device returned nothing \u2014 is @buoy-gg/images installed in the app?");
         const md = formatListMarkdown(list, capped);
         const slim = {
           stats: list.stats,
@@ -2419,13 +2643,13 @@ function registerImagesTools(server, sync) {
             loadCount: r.loadCount
           }))
         };
-        return text12(`${md}
+        return text13(`${md}
 
 \`\`\`json
 ${JSON.stringify(slim)}
 \`\`\``);
       } catch (e) {
-        return fail14(errMsg14(e));
+        return fail15(errMsg15(e));
       }
     }
   );
@@ -2434,9 +2658,9 @@ ${JSON.stringify(slim)}
     {
       description: "Act on one image from get_images (by id): hard_reload (bypass caches + refetch), retry, evict_disk (expo disk entry), flash (red border to locate it on screen), prove_savings (re-encode at displayed size as WebP ON DEVICE and return real byte savings + a previewable file:// uri), or simulation overrides \u2014 force_error (instant offline-safe failure), force_loading (request hangs forever), force_blank, swap_url (requires url), restore (remove override). Returns the record's state after the action so the effect is visible.",
       inputSchema: {
-        deviceId: z14.string().optional().describe("Target device id (auto-selected if one is connected)."),
-        id: z14.number().describe("Record id from get_images."),
-        action: z14.enum([
+        deviceId: z15.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        id: z15.number().describe("Record id from get_images."),
+        action: z15.enum([
           "hard_reload",
           "retry",
           "evict_disk",
@@ -2448,7 +2672,7 @@ ${JSON.stringify(slim)}
           "swap_url",
           "restore"
         ]).describe("What to do."),
-        url: z14.string().optional().describe("Replacement URL (swap_url only).")
+        url: z15.string().optional().describe("Replacement URL (swap_url only).")
       }
     },
     async ({ deviceId, id, action, url }) => {
@@ -2456,8 +2680,8 @@ ${JSON.stringify(slim)}
         const target = sync.requireProDevice(deviceId);
         if (action === "prove_savings") {
           const savings = await sync.callAction(IMAGES_TOOL_ID, "proveSavings", { id }, target);
-          if (!savings) return fail14("Device returned nothing for proveSavings.");
-          if (!savings.ok) return fail14(savings.message);
+          if (!savings) return fail15("Device returned nothing for proveSavings.");
+          if (!savings.ok) return fail15(savings.message);
           const parts = [`**prove_savings** on #${id}: ${savings.message}`];
           if (savings.originalBytes != null)
             parts.push(`Original: ${Math.round(savings.originalBytes / 1024)}KB (${savings.originalBytesSource})`);
@@ -2469,11 +2693,11 @@ ${JSON.stringify(slim)}
             parts.push(`**Saved: ${Math.round(savings.savedBytes / 1024)}KB (${savings.savedPct}%)**`);
           if (savings.optimizedUri)
             parts.push(`Preview in place: image_action {id:${id}, action:"swap_url", url:"${savings.optimizedUri}"}`);
-          return text12(parts.join("\n"));
+          return text13(parts.join("\n"));
         }
         const entry = ACTION_MAP[action];
-        if (!entry) return fail14(`Unknown action: ${action}`);
-        if (action === "swap_url" && !url) return fail14("swap_url requires the `url` param.");
+        if (!entry) return fail15(`Unknown action: ${action}`);
+        if (action === "swap_url" && !url) return fail15("swap_url requires the `url` param.");
         const result = await sync.callAction(
           IMAGES_TOOL_ID,
           entry.action,
@@ -2493,9 +2717,9 @@ ${JSON.stringify(slim)}
           );
           if (detail.error) lines.push(`Error: ${detail.error}`);
         }
-        return text12(lines.join("\n"));
+        return text13(lines.join("\n"));
       } catch (e) {
-        return fail14(errMsg14(e));
+        return fail15(errMsg15(e));
       }
     }
   );
@@ -2504,12 +2728,12 @@ ${JSON.stringify(slim)}
     {
       description: "App-wide image simulation modes: network 'offline' (every NETWORK image load fails immediately, both libs \u2014 bundled assets still load; reload/remount on-screen images to see it), 'cold' (every image bypasses caches \u2014 first-launch behavior, nothing cleared), 'normal' to reset. blankImages renders every image without a source. massAction applies per-image simulations to everything mounted. Also clears the registry or expo caches when asked.",
       inputSchema: {
-        deviceId: z14.string().optional().describe("Target device id (auto-selected if one is connected)."),
-        network: z14.enum(["normal", "offline", "cold"]).optional().describe("Network simulation mode."),
-        blankImages: z14.boolean().optional().describe("Render all images without a source."),
-        massAction: z14.enum(["error", "loading", "blank", "reload", "flash", "restore"]).optional().describe("Apply to EVERY mounted image at once: force error/loading/blank overrides, hard-reload all, flash all, or restore all overrides."),
-        clearRegistry: z14.boolean().optional().describe("Clear the captured image log."),
-        clearExpoCaches: z14.boolean().optional().describe("Clear expo-image memory + disk caches.")
+        deviceId: z15.string().optional().describe("Target device id (auto-selected if one is connected)."),
+        network: z15.enum(["normal", "offline", "cold"]).optional().describe("Network simulation mode."),
+        blankImages: z15.boolean().optional().describe("Render all images without a source."),
+        massAction: z15.enum(["error", "loading", "blank", "reload", "flash", "restore"]).optional().describe("Apply to EVERY mounted image at once: force error/loading/blank overrides, hard-reload all, flash all, or restore all overrides."),
+        clearRegistry: z15.boolean().optional().describe("Clear the captured image log."),
+        clearExpoCaches: z15.boolean().optional().describe("Clear expo-image memory + disk caches.")
       }
     },
     async ({ deviceId, network, blankImages, massAction, clearRegistry, clearExpoCaches }) => {
@@ -2536,10 +2760,94 @@ ${JSON.stringify(slim)}
           const r = await sync.callAction(IMAGES_TOOL_ID, "clearExpoCaches", {}, target);
           done.push(r?.message ?? "expo caches cleared");
         }
-        if (done.length === 0) return fail14("Pass at least one of: network, blankImages, massAction, clearRegistry, clearExpoCaches.");
-        return text12(`Applied: ${done.join(" \xB7 ")}`);
+        if (done.length === 0) return fail15("Pass at least one of: network, blankImages, massAction, clearRegistry, clearExpoCaches.");
+        return text13(`Applied: ${done.join(" \xB7 ")}`);
       } catch (e) {
-        return fail14(errMsg14(e));
+        return fail15(errMsg15(e));
+      }
+    }
+  );
+}
+
+// src/tools/packs/reload.ts
+import { z as z16 } 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 delay3 = (ms) => new Promise((r) => setTimeout(r, ms));
+async function ping(sync, deviceId, timeoutMs) {
+  try {
+    const pong = await sync.callAction(APP_TOOL_ID, "ping", {}, deviceId, { timeoutMs });
+    return typeof pong?.startedAt === "number" ? pong.startedAt : null;
+  } catch {
+    return null;
+  }
+}
+function assertReloadSupported(sync, deviceId) {
+  if (deviceId === ALL_DEVICES) return;
+  const entry = sync.toolActions(APP_TOOL_ID).find((t) => t.deviceId === deviceId);
+  if (!entry?.actions.includes(RELOAD_ACTION)) {
+    throw new Error(
+      `This app doesn't expose remote reload \u2014 its @buoy-gg/core is too old. Upgrade @buoy-gg/core, then reload the app once by hand.`
+    );
+  }
+}
+async function waitForAppBack(sync, deviceId, timeoutMs, previousRealm) {
+  const waitStart = Date.now();
+  await delay3(TEARDOWN_GRACE_MS);
+  while (Date.now() - waitStart < timeoutMs) {
+    const realm = await ping(sync, deviceId, PROBE_TIMEOUT_MS);
+    if (realm !== null && realm !== previousRealm) return Date.now() - waitStart;
+    await delay3(PROBE_INTERVAL_MS);
+  }
+  return null;
+}
+function registerReloadTools(server, sync) {
+  server.registerTool(
+    "reload_app",
+    {
+      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(
+          "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.')
+      }
+    },
+    async (args) => {
+      try {
+        const target = sync.requireProDevice(args.deviceId);
+        assertReloadSupported(sync, target);
+        const previousRealm = args.wait === false ? null : await ping(sync, target, PROBE_TIMEOUT_MS);
+        const ack = await sync.callAction(
+          APP_TOOL_ID,
+          RELOAD_ACTION,
+          { strategy: args.strategy ?? "auto" },
+          target
+        );
+        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.`);
+        }
+        const elapsed = await waitForAppBack(sync, target, args.timeoutMs ?? DEFAULT_WAIT_MS, previousRealm);
+        if (elapsed == null) {
+          return fail16(
+            `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(
+          `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));
       }
     }
   );
@@ -2558,6 +2866,13 @@ filter (e.g. sources:["network"] to list HTTP requests). It's the universal, tok
 activity reader across ALL tools and is compact by default \u2014 reach for it before reading source
 code, and prefer it over \`get_snapshot\` for any "what happened / show me the requests" question.
 
+Working on ONE HTTP request rather than skimming activity? \`get_events\` deliberately emits no
+request ids, so use \`get_network_requests\` \u2014 same compact style, but it leads with the id every
+network action is keyed by, and marks which requests are pinned/saved. \`flagged:'any'\` lists the
+requests the DEVELOPER kept: those are snapshots that outlive Clear, the 500-request cap and app
+restarts, so treat a pinned request as "a human flagged this as the problem". \`network_action\`
+pins/saves one \u2014 pin the failing call you want a human to see, or keep one before the log rolls over.
+
 Need to SEE a component (verify a UI change, check styling/layout)? Use \`screenshot_component\` with
 a testID/name \u2014 it locates the live component on-device and returns a cropped screenshot inline.
 iOS Simulator only, and only works when this MCP server runs on the same Mac as the booted Simulator.
@@ -2576,6 +2891,11 @@ 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.
 
+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
+re-read anything you cached.
+
 For everything else:
 - \`list_tool_actions\` to see what a tool can do,
 - \`get_snapshot\` ONLY when you need a tool's full current state (returns raw, heavy payloads),
@@ -2595,6 +2915,7 @@ function createMcpServer(sync) {
   registerGenericTools(server, sync);
   registerPerfMonitorTools(server, sync);
   registerEventsTools(server, sync);
+  registerNetworkTools(server, sync);
   registerReactQueryTools(server, sync);
   registerZustandTools(server, sync);
   registerJotaiTools(server, sync);
@@ -2606,22 +2927,27 @@ function createMcpServer(sync) {
   registerInteractTools(server, sync);
   registerJsThreadTools(server, sync);
   registerImagesTools(server, sync);
+  registerReloadTools(server, sync);
   return server;
 }
 var deviceIdField = {
-  deviceId: z15.string().optional().describe(
+  deviceId: z17.string().optional().describe(
     'Target device id (from list_devices). Omit to auto-select when exactly one device is connected. Use "All" to broadcast.'
   )
 };
 
 // src/init.ts
+import { spawnSync } from "child_process";
 import fs3 from "fs";
+import os3 from "os";
 import path3 from "path";
+var PUBLIC_REGISTRY = "https://registry.npmjs.org";
+var PROBE_TIMEOUT_MS2 = 3e3;
 function runInit(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
   const skillSrcDir = opts.skillSrcDir ?? path3.resolve(__dirname, "../skill");
   const log = opts.log ?? ((m) => process.stdout.write(m + "\n"));
-  const entry = opts.cliPath ? { type: "stdio", command: "node", args: [opts.cliPath] } : { type: "stdio", command: "npx", args: ["-y", `${PACKAGE_NAME}@latest`] };
+  const entry = resolveEntry(opts, log);
   const done = [];
   upsertMcpConfig(path3.join(cwd, ".mcp.json"), "mcpServers", entry, cwd, done);
   if (fs3.existsSync(path3.join(cwd, ".cursor"))) {
@@ -2638,12 +2964,125 @@ function runInit(opts = {}) {
   log("  1. Restart your editor (or reconnect the MCP server) to load `buoy`.");
   log("  2. Open your app with Buoy devtools running on a device or simulator.");
   log('  3. Say "buoy optimize" to start a guided performance pass.');
-  if (!opts.cliPath) {
+  if (entry.command === "npx") {
     log("");
     log(`This launches the server via \`npx -y ${PACKAGE_NAME}@latest\`, so it stays`);
     log(`up to date automatically. To force-refresh, re-run \`npx -y ${PACKAGE_NAME}@latest init\`.`);
+  } else if (!opts.cliPath) {
+    log("");
+    log(`This uses a pinned local install (no network on startup). To update it later,`);
+    log(`re-run init (\`node ${entry.args[0]?.replace(/dist[/\\]cli\.js$/, "") ?? ""}...\` \u2014 or reinstall).`);
+  }
+}
+function resolveEntry(opts, log) {
+  if (opts.cliPath) {
+    return { type: "stdio", command: "node", args: [opts.cliPath] };
+  }
+  const mode = opts.mode ?? "auto";
+  if (mode === "npx") {
+    return npxEntry();
+  }
+  if (mode === "local") {
+    return localEntry(opts, log);
+  }
+  const probe = probeRegistry();
+  if (probe.reachable) {
+    return npxEntry();
+  }
+  log(
+    `\u26A0 npm registry ${probe.registry ? `(${probe.registry}) ` : ""}looks unreachable \u2014 \`npx @latest\` would hang your editor at startup. Falling back to a pinned local install.`
+  );
+  return localEntry(opts, log);
+}
+function npxEntry() {
+  return { type: "stdio", command: "npx", args: ["-y", `${PACKAGE_NAME}@latest`] };
+}
+function localEntry(opts, log) {
+  const installDir = opts.installDir ?? process.env.BUOY_MCP_HOME ?? path3.join(os3.homedir(), ".buoy-mcp");
+  const registry = opts.registry ?? PUBLIC_REGISTRY;
+  const cliPath = installLocalCopy(installDir, registry, log);
+  if (cliPath) {
+    return { type: "stdio", command: "node", args: [cliPath] };
+  }
+  log("\u26A0 local install failed \u2014 writing the npx entry instead (see the error above).");
+  return npxEntry();
+}
+function installLocalCopy(installDir, registry, log) {
+  const spec = `${PACKAGE_NAME}@${VERSION === "0.0.0-dev" ? "latest" : VERSION}`;
+  fs3.mkdirSync(installDir, { recursive: true });
+  const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+  log(`Installing ${spec} into ${installDir} from ${registry} \u2026`);
+  const res = spawnSync(
+    npm,
+    [
+      "install",
+      spec,
+      "--prefix",
+      installDir,
+      "--registry",
+      registry,
+      `--@buoy-gg:registry=${registry}`,
+      "--no-audit",
+      "--no-fund",
+      "--loglevel=error"
+    ],
+    { stdio: ["ignore", "ignore", "inherit"], encoding: "utf8" }
+  );
+  if (res.status !== 0) {
+    log(`\u26A0 npm install exited with code ${res.status ?? "?"}${res.error ? ` (${res.error.message})` : ""}.`);
+    return null;
   }
+  const cliPath = path3.join(installDir, "node_modules", PACKAGE_NAME, "dist", "cli.js");
+  if (!fs3.existsSync(cliPath)) {
+    log(`\u26A0 install finished but ${cliPath} is missing.`);
+    return null;
+  }
+  return cliPath;
 }
+function probeRegistry() {
+  const registry = effectiveRegistry();
+  if (!registry) return { reachable: false, registry: null };
+  if (/^https?:\/\/registry\.npmjs\.org\/?$/i.test(registry)) {
+    return { reachable: true, registry };
+  }
+  return { reachable: hostReachable(registry), registry };
+}
+function effectiveRegistry() {
+  const scoped = npmConfigGet("@buoy-gg:registry");
+  if (scoped) return scoped;
+  const global = npmConfigGet("registry");
+  return global ?? PUBLIC_REGISTRY;
+}
+function npmConfigGet(key) {
+  const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+  const res = spawnSync(npm, ["config", "get", key], { encoding: "utf8", timeout: PROBE_TIMEOUT_MS2 });
+  if (res.status !== 0 || typeof res.stdout !== "string") return null;
+  const val = res.stdout.trim();
+  if (!val || val === "undefined" || val === "null") return null;
+  return val;
+}
+function hostReachable(registry) {
+  const done = spawnSync(
+    process.execPath,
+    ["-e", REACHABILITY_PROBE, registry, String(PROBE_TIMEOUT_MS2)],
+    { encoding: "utf8", timeout: PROBE_TIMEOUT_MS2 + 2e3 }
+  );
+  return done.status === 0;
+}
+var REACHABILITY_PROBE = `
+const url = process.argv[1];
+const ms = Number(process.argv[2]) || 3000;
+const c = new AbortController();
+const t = setTimeout(() => c.abort(), ms);
+fetch(url, { method: 'HEAD', signal: c.signal })
+  .then(() => { clearTimeout(t); process.exit(0); })
+  .catch(() => {
+    // A HEAD may be rejected while the host is up; a bare TCP-level failure is
+    // what we care about. fetch throwing a TypeError = network unreachable.
+    clearTimeout(t);
+    process.exit(1);
+  });
+`;
 function upsertMcpConfig(file, key, entry, cwd, done) {
   let json3 = {};
   if (fs3.existsSync(file)) {