@buoy-gg/mcp 7.0.12 → 7.0.14

package/dist/{chunk-IGB5AS45.mjs → chunk-ZEHIU6OG.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.12" ? "7.0.12" : "0.0.0-dev";
+var VERSION = "7.0.14" ? "7.0.14" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -2033,6 +2033,10 @@ var NETWORK_TOOL_ID = "network";
 var text10 = (s) => ({ content: [{ type: "text", text: s }] });
 var fail12 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
 var errMsg12 = (e) => e instanceof Error ? e.message : String(e);
+var masterNote = (state) => {
+  if (state?.enabled !== false) return "";
+  return state.autoPaused ? ' \u2014 AUTO-PAUSED after the app failed to settle on launch with overrides active; nothing is firing. Re-arm with network_override({action:"enable"}).' : " \u2014 MASTER SWITCH IS OFF, nothing is firing";
+};
 function parseSnapshot(payload) {
   if (Array.isArray(payload)) return { events: payload, saved: [] };
   if (payload && typeof payload === "object") {
@@ -2246,6 +2250,222 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
       }
     }
   );
+  server.registerTool(
+    "network_override",
+    {
+      description: "Force matching HTTP requests to return a chosen status/body, to fail outright, or to arrive late \u2014 without touching the backend or the app's code. This is how you drive an app into a state it won't reach on its own: force a 500 and see whether the error UI appears, return [] and check the empty state, simulate offline or a slow connection. Rules run INSIDE the app and survive an app reload, so they also cover the boot path. After adding one, trigger the request (navigate/tap_element) and read the result with get_network_requests or describe_screen. ALWAYS remove your rules when done \u2014 a forgotten rule looks exactly like a real bug. Requires Buoy Pro.",
+      inputSchema: {
+        action: z12.enum(["list", "add", "remove", "clear", "enable", "disable", "debug"]).describe(
+          "add creates a rule (or replaces one when `id` is given). remove drops one by `id`. clear drops all. enable/disable flip ONE rule when `id` is given, otherwise the master switch \u2014 rules are kept either way. list shows every rule with its hit counts; pass `id` to dump one rule in full, body included. debug reports why a rule is or isn't firing."
+        ),
+        urlPattern: z12.string().optional().describe(
+          "For `add`: glob matched against the WHOLE request URL, query string included. `*` is the only wildcard, e.g. '*pokeapi.co*' or 'https://api.example.com/v1/users*'. Careful with an exact URL copied from get_network_requests \u2014 if the client cache-busts or pages, the next call won't match it and the rule sits at 0 hits. Prefer `fromRequestId`, which handles that for you."
+        ),
+        fromRequestId: z12.string().optional().describe(
+          "For `add`: build the rule from a captured request id (from get_network_requests) \u2014 the same 'Override this request' the developer gets in the UI. Seeds the pattern (query string replaced with `*` so it keeps matching), the method, the status, and the REAL response body, so you can change two fields of a payload you just saw instead of authoring one from scratch. Anything you pass explicitly overrides the prefill."
+        ),
+        methods: z12.array(z12.string()).optional().describe("For `add`: restrict to these HTTP methods. Omit for any."),
+        kind: z12.enum(["respond", "fail", "delay"]).optional().describe(
+          "respond = return your status/body, never hitting the network (default). fail = a transport failure, as if the device were offline. delay = let the real request run, just late."
+        ),
+        status: z12.number().optional().describe(
+          "For kind 'respond': HTTP status, 200\u2013599 (default 200). Outside that range fetch itself throws, so use kind 'fail' for connection errors rather than status 0."
+        ),
+        body: z12.union([z12.string(), z12.record(z12.unknown()), z12.array(z12.unknown())]).optional().describe(
+          "For kind 'respond': the response body. Pass JSON directly (an object or array) or a raw string; content-type is inferred."
+        ),
+        statusText: z12.string().optional().describe(
+          "For kind 'respond': the status line's text, e.g. 'Service Unavailable'. Cosmetic \u2014 React Native's XMLHttpRequest has no statusText field, so the app never sees it; it only makes the developer's rule list read correctly."
+        ),
+        headers: z12.record(z12.string()).optional().describe("For kind 'respond': response headers to send."),
+        failKind: z12.enum(["network", "timeout"]).optional().describe("For kind 'fail': 'network' (default) or 'timeout'."),
+        delayMs: z12.number().optional().describe("Latency before the outcome, in ms. Works with every kind."),
+        times: z12.number().optional().describe(
+          "Auto-disable the rule after N matches. Use 1 for 'make the next call fail' so it can't linger."
+        ),
+        alternate: z12.boolean().optional().describe(
+          "Apply to every OTHER matching request, forever: the first goes through, the second is overridden, and so on. This is how you test retry logic and flaky endpoints \u2014 a rule that is always on or always off can't reach those paths."
+        ),
+        name: z12.string().optional().describe("Label shown in the developer's UI."),
+        enabled: z12.boolean().optional().describe(
+          "For `add`: create the rule switched off (default true). Useful for staging a rule you'll arm later with enable({id})."
+        ),
+        id: z12.string().optional().describe(
+          "Rule id. Required for `remove`. For `add` it replaces that rule. For `enable`/`disable` it targets ONE rule instead of the master switch. For `list` it dumps that rule in full."
+        ),
+        url: z12.string().optional().describe(
+          "For `debug`: a concrete URL to test the rules against, so the report says which rule would match it and why."
+        ),
+        deviceId: z12.string().optional().describe("Target device id (auto-selected if one is connected).")
+      }
+    },
+    async (args) => {
+      try {
+        const target = sync.requireProDevice(args.deviceId);
+        switch (args.action) {
+          case "add": {
+            if (!args.urlPattern && !args.fromRequestId) {
+              return fail12(
+                "`add` needs a `urlPattern` or a `fromRequestId`. Take an id from get_network_requests to override a request you just saw, or pass a glob like '*pokeapi.co*'."
+              );
+            }
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "upsertOverrideRule",
+              {
+                fromRequestId: args.fromRequestId,
+                rule: {
+                  id: args.id,
+                  name: args.name,
+                  urlPattern: args.urlPattern,
+                  methods: args.methods,
+                  // Not defaulted here — the device defaults to "respond" too,
+                  // and leaving it absent lets a `fromRequestId` prefill win.
+                  kind: args.kind,
+                  status: args.status,
+                  statusText: args.statusText,
+                  body: args.body,
+                  headers: args.headers,
+                  failKind: args.failKind,
+                  delayMs: args.delayMs,
+                  times: args.times,
+                  alternate: args.alternate,
+                  enabled: args.enabled !== false
+                }
+              },
+              target
+            );
+            const shaped = res;
+            if (!shaped?.ok) {
+              return fail12(shaped?.error ?? `Could not add the rule on ${target}.`);
+            }
+            const pattern = shaped.rule?.urlPattern ?? args.urlPattern;
+            const armed = shaped.rule?.enabled === false ? `
+
+It is switched OFF \u2014 arm it with network_override({action:"enable", id:"${shaped.rule?.id}"}).` : "";
+            return text10(
+              `Override added on ${target} \u2014 \`${shaped.rule?.id}\` matching \`${pattern}\`.${armed}
+
+Trigger the request now (navigate / tap_element), then check it with get_network_requests or describe_screen. Remove it with network_override({action:"remove", id:"${shaped.rule?.id}"}) when you're done.`
+            );
+          }
+          case "remove": {
+            if (!args.id) {
+              return fail12('`remove` needs an `id`. List them with network_override({action:"list"}).');
+            }
+            await sync.callAction(NETWORK_TOOL_ID, "deleteOverrideRule", { id: args.id }, target);
+            return text10(`Removed override \`${args.id}\` on ${target}.`);
+          }
+          case "clear":
+            await sync.callAction(NETWORK_TOOL_ID, "clearOverrideRules", {}, target);
+            return text10(`Removed all override rules on ${target}. Traffic is real again.`);
+          case "enable":
+          case "disable": {
+            const enabled = args.action === "enable";
+            if (args.id) {
+              await sync.callAction(
+                NETWORK_TOOL_ID,
+                "setOverrideRuleEnabled",
+                { id: args.id, enabled },
+                target
+              );
+              return text10(
+                `Rule \`${args.id}\` is now ${enabled ? "ON" : "OFF"} on ${target}. The other rules and the master switch are unchanged.`
+              );
+            }
+            await sync.callAction(NETWORK_TOOL_ID, "setOverridesEnabled", { enabled }, target);
+            return text10(
+              enabled ? `Overrides switched ON for ${target}.` : `Overrides switched OFF for ${target}. Rules are kept \u2014 re-enable with network_override({action:"enable"}).`
+            );
+          }
+          case "list": {
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "listOverrideRules",
+              {},
+              target
+            );
+            const rules = res?.rules ?? [];
+            if (args.id) {
+              const rule = rules.find((r) => r.id === args.id);
+              if (!rule) {
+                return fail12(
+                  `No override rule \`${args.id}\` on ${target}. List them with network_override({action:"list"}).`
+                );
+              }
+              return text10(
+                `**Override rule \`${rule.id}\`** on ${target}${masterNote(res)}
+
+\`\`\`json
+${JSON.stringify(rule, null, 2)}
+\`\`\``
+              );
+            }
+            if (rules.length === 0) {
+              return text10(
+                `No override rules on ${target}.
+
+Add one with network_override({action:"add", urlPattern:"*", status:500}) to force an error state.`
+              );
+            }
+            const rows = rules.map((rule, i) => {
+              const what = rule.kind === "respond" ? `\u2192 ${rule.status ?? 200}${rule.statusText ? ` ${rule.statusText}` : ""}` : rule.kind === "fail" ? `\u2192 ${rule.failKind === "timeout" ? "timeout" : "network error"}` : "\u2192 real response";
+              const bits = [
+                rule.methods?.length ? rule.methods.join("/") : "any method",
+                what,
+                // Enough to tell WHICH body this is without printing it.
+                rule.kind === "respond" && rule.body ? `body ${rule.body.length}B` : "",
+                rule.headers && Object.keys(rule.headers).length ? `${Object.keys(rule.headers).length} header(s)` : "",
+                rule.delayMs ? `${rule.delayMs}ms delay` : "",
+                rule.alternate ? "every other request" : "",
+                typeof rule.times === "number" ? `${rule.times}\xD7 then off` : "",
+                `${rule.hits} hit${rule.hits === 1 ? "" : "s"}`,
+                // Only interesting when the two can disagree: `alternate` and
+                // spent `times` rules match without applying, and a gap between
+                // the numbers is the explanation for "it matched but nothing
+                // happened".
+                rule.seen != null && rule.seen !== rule.hits ? `${rule.seen} matched` : "",
+                rule.enabled ? "" : "DISABLED"
+              ].filter(Boolean);
+              return `${i + 1}. \`${rule.id}\`${rule.name ? ` ${rule.name}` : ""}
+   \u2514\u2500 \`${rule.urlPattern}\` \xB7 ${bits.join(" \xB7 ")}`;
+            });
+            return text10(
+              `**Override rules on ${target}**${masterNote(res)}
+
+${rows.join("\n")}
+
+Full detail incl. body: network_override({action:"list", id:"${rules[0]?.id}"}).`
+            );
+          }
+          case "debug": {
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "debugOverrides",
+              { url: args.url },
+              target
+            );
+            if (!res) {
+              return fail12(
+                `${target} did not answer the diagnostics call \u2014 the network tool may not be mounted.`
+              );
+            }
+            return text10(
+              `**Override diagnostics on ${target}**${args.url ? ` for \`${args.url}\`` : ""}
+
+\`\`\`json
+${JSON.stringify(res, null, 2)}
+\`\`\`
+
+A rule that never fires is usually one of: the master switch is off, the interceptor isn't installed (nothing is subscribed to the network tool), or the pattern doesn't match the FULL url including its query string.`
+            );
+          }
+        }
+      } catch (e) {
+        return fail12(errMsg12(e));
+      }
+    }
+  );
 }
 
 // src/tools/packs/interact.ts

package/dist/cli.js

@@ -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.12" ? "7.0.12" : "0.0.0-dev";
+var VERSION = "7.0.14" ? "7.0.14" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -1296,6 +1296,10 @@ var NETWORK_TOOL_ID = "network";
 var text3 = (s) => ({ content: [{ type: "text", text: s }] });
 var fail4 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
 var errMsg4 = (e) => e instanceof Error ? e.message : String(e);
+var masterNote = (state) => {
+  if (state?.enabled !== false) return "";
+  return state.autoPaused ? ' \u2014 AUTO-PAUSED after the app failed to settle on launch with overrides active; nothing is firing. Re-arm with network_override({action:"enable"}).' : " \u2014 MASTER SWITCH IS OFF, nothing is firing";
+};
 function parseSnapshot(payload) {
   if (Array.isArray(payload)) return { events: payload, saved: [] };
   if (payload && typeof payload === "object") {
@@ -1509,6 +1513,222 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
       }
     }
   );
+  server.registerTool(
+    "network_override",
+    {
+      description: "Force matching HTTP requests to return a chosen status/body, to fail outright, or to arrive late \u2014 without touching the backend or the app's code. This is how you drive an app into a state it won't reach on its own: force a 500 and see whether the error UI appears, return [] and check the empty state, simulate offline or a slow connection. Rules run INSIDE the app and survive an app reload, so they also cover the boot path. After adding one, trigger the request (navigate/tap_element) and read the result with get_network_requests or describe_screen. ALWAYS remove your rules when done \u2014 a forgotten rule looks exactly like a real bug. Requires Buoy Pro.",
+      inputSchema: {
+        action: import_zod4.z.enum(["list", "add", "remove", "clear", "enable", "disable", "debug"]).describe(
+          "add creates a rule (or replaces one when `id` is given). remove drops one by `id`. clear drops all. enable/disable flip ONE rule when `id` is given, otherwise the master switch \u2014 rules are kept either way. list shows every rule with its hit counts; pass `id` to dump one rule in full, body included. debug reports why a rule is or isn't firing."
+        ),
+        urlPattern: import_zod4.z.string().optional().describe(
+          "For `add`: glob matched against the WHOLE request URL, query string included. `*` is the only wildcard, e.g. '*pokeapi.co*' or 'https://api.example.com/v1/users*'. Careful with an exact URL copied from get_network_requests \u2014 if the client cache-busts or pages, the next call won't match it and the rule sits at 0 hits. Prefer `fromRequestId`, which handles that for you."
+        ),
+        fromRequestId: import_zod4.z.string().optional().describe(
+          "For `add`: build the rule from a captured request id (from get_network_requests) \u2014 the same 'Override this request' the developer gets in the UI. Seeds the pattern (query string replaced with `*` so it keeps matching), the method, the status, and the REAL response body, so you can change two fields of a payload you just saw instead of authoring one from scratch. Anything you pass explicitly overrides the prefill."
+        ),
+        methods: import_zod4.z.array(import_zod4.z.string()).optional().describe("For `add`: restrict to these HTTP methods. Omit for any."),
+        kind: import_zod4.z.enum(["respond", "fail", "delay"]).optional().describe(
+          "respond = return your status/body, never hitting the network (default). fail = a transport failure, as if the device were offline. delay = let the real request run, just late."
+        ),
+        status: import_zod4.z.number().optional().describe(
+          "For kind 'respond': HTTP status, 200\u2013599 (default 200). Outside that range fetch itself throws, so use kind 'fail' for connection errors rather than status 0."
+        ),
+        body: import_zod4.z.union([import_zod4.z.string(), import_zod4.z.record(import_zod4.z.unknown()), import_zod4.z.array(import_zod4.z.unknown())]).optional().describe(
+          "For kind 'respond': the response body. Pass JSON directly (an object or array) or a raw string; content-type is inferred."
+        ),
+        statusText: import_zod4.z.string().optional().describe(
+          "For kind 'respond': the status line's text, e.g. 'Service Unavailable'. Cosmetic \u2014 React Native's XMLHttpRequest has no statusText field, so the app never sees it; it only makes the developer's rule list read correctly."
+        ),
+        headers: import_zod4.z.record(import_zod4.z.string()).optional().describe("For kind 'respond': response headers to send."),
+        failKind: import_zod4.z.enum(["network", "timeout"]).optional().describe("For kind 'fail': 'network' (default) or 'timeout'."),
+        delayMs: import_zod4.z.number().optional().describe("Latency before the outcome, in ms. Works with every kind."),
+        times: import_zod4.z.number().optional().describe(
+          "Auto-disable the rule after N matches. Use 1 for 'make the next call fail' so it can't linger."
+        ),
+        alternate: import_zod4.z.boolean().optional().describe(
+          "Apply to every OTHER matching request, forever: the first goes through, the second is overridden, and so on. This is how you test retry logic and flaky endpoints \u2014 a rule that is always on or always off can't reach those paths."
+        ),
+        name: import_zod4.z.string().optional().describe("Label shown in the developer's UI."),
+        enabled: import_zod4.z.boolean().optional().describe(
+          "For `add`: create the rule switched off (default true). Useful for staging a rule you'll arm later with enable({id})."
+        ),
+        id: import_zod4.z.string().optional().describe(
+          "Rule id. Required for `remove`. For `add` it replaces that rule. For `enable`/`disable` it targets ONE rule instead of the master switch. For `list` it dumps that rule in full."
+        ),
+        url: import_zod4.z.string().optional().describe(
+          "For `debug`: a concrete URL to test the rules against, so the report says which rule would match it and why."
+        ),
+        deviceId: import_zod4.z.string().optional().describe("Target device id (auto-selected if one is connected).")
+      }
+    },
+    async (args) => {
+      try {
+        const target = sync.requireProDevice(args.deviceId);
+        switch (args.action) {
+          case "add": {
+            if (!args.urlPattern && !args.fromRequestId) {
+              return fail4(
+                "`add` needs a `urlPattern` or a `fromRequestId`. Take an id from get_network_requests to override a request you just saw, or pass a glob like '*pokeapi.co*'."
+              );
+            }
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "upsertOverrideRule",
+              {
+                fromRequestId: args.fromRequestId,
+                rule: {
+                  id: args.id,
+                  name: args.name,
+                  urlPattern: args.urlPattern,
+                  methods: args.methods,
+                  // Not defaulted here — the device defaults to "respond" too,
+                  // and leaving it absent lets a `fromRequestId` prefill win.
+                  kind: args.kind,
+                  status: args.status,
+                  statusText: args.statusText,
+                  body: args.body,
+                  headers: args.headers,
+                  failKind: args.failKind,
+                  delayMs: args.delayMs,
+                  times: args.times,
+                  alternate: args.alternate,
+                  enabled: args.enabled !== false
+                }
+              },
+              target
+            );
+            const shaped = res;
+            if (!shaped?.ok) {
+              return fail4(shaped?.error ?? `Could not add the rule on ${target}.`);
+            }
+            const pattern = shaped.rule?.urlPattern ?? args.urlPattern;
+            const armed = shaped.rule?.enabled === false ? `
+
+It is switched OFF \u2014 arm it with network_override({action:"enable", id:"${shaped.rule?.id}"}).` : "";
+            return text3(
+              `Override added on ${target} \u2014 \`${shaped.rule?.id}\` matching \`${pattern}\`.${armed}
+
+Trigger the request now (navigate / tap_element), then check it with get_network_requests or describe_screen. Remove it with network_override({action:"remove", id:"${shaped.rule?.id}"}) when you're done.`
+            );
+          }
+          case "remove": {
+            if (!args.id) {
+              return fail4('`remove` needs an `id`. List them with network_override({action:"list"}).');
+            }
+            await sync.callAction(NETWORK_TOOL_ID, "deleteOverrideRule", { id: args.id }, target);
+            return text3(`Removed override \`${args.id}\` on ${target}.`);
+          }
+          case "clear":
+            await sync.callAction(NETWORK_TOOL_ID, "clearOverrideRules", {}, target);
+            return text3(`Removed all override rules on ${target}. Traffic is real again.`);
+          case "enable":
+          case "disable": {
+            const enabled = args.action === "enable";
+            if (args.id) {
+              await sync.callAction(
+                NETWORK_TOOL_ID,
+                "setOverrideRuleEnabled",
+                { id: args.id, enabled },
+                target
+              );
+              return text3(
+                `Rule \`${args.id}\` is now ${enabled ? "ON" : "OFF"} on ${target}. The other rules and the master switch are unchanged.`
+              );
+            }
+            await sync.callAction(NETWORK_TOOL_ID, "setOverridesEnabled", { enabled }, target);
+            return text3(
+              enabled ? `Overrides switched ON for ${target}.` : `Overrides switched OFF for ${target}. Rules are kept \u2014 re-enable with network_override({action:"enable"}).`
+            );
+          }
+          case "list": {
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "listOverrideRules",
+              {},
+              target
+            );
+            const rules = res?.rules ?? [];
+            if (args.id) {
+              const rule = rules.find((r) => r.id === args.id);
+              if (!rule) {
+                return fail4(
+                  `No override rule \`${args.id}\` on ${target}. List them with network_override({action:"list"}).`
+                );
+              }
+              return text3(
+                `**Override rule \`${rule.id}\`** on ${target}${masterNote(res)}
+
+\`\`\`json
+${JSON.stringify(rule, null, 2)}
+\`\`\``
+              );
+            }
+            if (rules.length === 0) {
+              return text3(
+                `No override rules on ${target}.
+
+Add one with network_override({action:"add", urlPattern:"*", status:500}) to force an error state.`
+              );
+            }
+            const rows = rules.map((rule, i) => {
+              const what = rule.kind === "respond" ? `\u2192 ${rule.status ?? 200}${rule.statusText ? ` ${rule.statusText}` : ""}` : rule.kind === "fail" ? `\u2192 ${rule.failKind === "timeout" ? "timeout" : "network error"}` : "\u2192 real response";
+              const bits = [
+                rule.methods?.length ? rule.methods.join("/") : "any method",
+                what,
+                // Enough to tell WHICH body this is without printing it.
+                rule.kind === "respond" && rule.body ? `body ${rule.body.length}B` : "",
+                rule.headers && Object.keys(rule.headers).length ? `${Object.keys(rule.headers).length} header(s)` : "",
+                rule.delayMs ? `${rule.delayMs}ms delay` : "",
+                rule.alternate ? "every other request" : "",
+                typeof rule.times === "number" ? `${rule.times}\xD7 then off` : "",
+                `${rule.hits} hit${rule.hits === 1 ? "" : "s"}`,
+                // Only interesting when the two can disagree: `alternate` and
+                // spent `times` rules match without applying, and a gap between
+                // the numbers is the explanation for "it matched but nothing
+                // happened".
+                rule.seen != null && rule.seen !== rule.hits ? `${rule.seen} matched` : "",
+                rule.enabled ? "" : "DISABLED"
+              ].filter(Boolean);
+              return `${i + 1}. \`${rule.id}\`${rule.name ? ` ${rule.name}` : ""}
+   \u2514\u2500 \`${rule.urlPattern}\` \xB7 ${bits.join(" \xB7 ")}`;
+            });
+            return text3(
+              `**Override rules on ${target}**${masterNote(res)}
+
+${rows.join("\n")}
+
+Full detail incl. body: network_override({action:"list", id:"${rules[0]?.id}"}).`
+            );
+          }
+          case "debug": {
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "debugOverrides",
+              { url: args.url },
+              target
+            );
+            if (!res) {
+              return fail4(
+                `${target} did not answer the diagnostics call \u2014 the network tool may not be mounted.`
+              );
+            }
+            return text3(
+              `**Override diagnostics on ${target}**${args.url ? ` for \`${args.url}\`` : ""}
+
+\`\`\`json
+${JSON.stringify(res, null, 2)}
+\`\`\`
+
+A rule that never fires is usually one of: the master switch is off, the interceptor isn't installed (nothing is subscribed to the network tool), or the pattern doesn't match the FULL url including its query string.`
+            );
+          }
+        }
+      } catch (e) {
+        return fail4(errMsg4(e));
+      }
+    }
+  );
 }
 
 // src/tools/packs/reactQuery.ts

package/dist/cli.mjs

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

package/dist/index.js

@@ -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.12" ? "7.0.12" : "0.0.0-dev";
+var VERSION = "7.0.14" ? "7.0.14" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -1331,6 +1331,10 @@ var NETWORK_TOOL_ID = "network";
 var text3 = (s) => ({ content: [{ type: "text", text: s }] });
 var fail4 = (message) => ({ isError: true, content: [{ type: "text", text: message }] });
 var errMsg4 = (e) => e instanceof Error ? e.message : String(e);
+var masterNote = (state) => {
+  if (state?.enabled !== false) return "";
+  return state.autoPaused ? ' \u2014 AUTO-PAUSED after the app failed to settle on launch with overrides active; nothing is firing. Re-arm with network_override({action:"enable"}).' : " \u2014 MASTER SWITCH IS OFF, nothing is firing";
+};
 function parseSnapshot(payload) {
   if (Array.isArray(payload)) return { events: payload, saved: [] };
   if (payload && typeof payload === "object") {
@@ -1544,6 +1548,222 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
       }
     }
   );
+  server.registerTool(
+    "network_override",
+    {
+      description: "Force matching HTTP requests to return a chosen status/body, to fail outright, or to arrive late \u2014 without touching the backend or the app's code. This is how you drive an app into a state it won't reach on its own: force a 500 and see whether the error UI appears, return [] and check the empty state, simulate offline or a slow connection. Rules run INSIDE the app and survive an app reload, so they also cover the boot path. After adding one, trigger the request (navigate/tap_element) and read the result with get_network_requests or describe_screen. ALWAYS remove your rules when done \u2014 a forgotten rule looks exactly like a real bug. Requires Buoy Pro.",
+      inputSchema: {
+        action: import_zod4.z.enum(["list", "add", "remove", "clear", "enable", "disable", "debug"]).describe(
+          "add creates a rule (or replaces one when `id` is given). remove drops one by `id`. clear drops all. enable/disable flip ONE rule when `id` is given, otherwise the master switch \u2014 rules are kept either way. list shows every rule with its hit counts; pass `id` to dump one rule in full, body included. debug reports why a rule is or isn't firing."
+        ),
+        urlPattern: import_zod4.z.string().optional().describe(
+          "For `add`: glob matched against the WHOLE request URL, query string included. `*` is the only wildcard, e.g. '*pokeapi.co*' or 'https://api.example.com/v1/users*'. Careful with an exact URL copied from get_network_requests \u2014 if the client cache-busts or pages, the next call won't match it and the rule sits at 0 hits. Prefer `fromRequestId`, which handles that for you."
+        ),
+        fromRequestId: import_zod4.z.string().optional().describe(
+          "For `add`: build the rule from a captured request id (from get_network_requests) \u2014 the same 'Override this request' the developer gets in the UI. Seeds the pattern (query string replaced with `*` so it keeps matching), the method, the status, and the REAL response body, so you can change two fields of a payload you just saw instead of authoring one from scratch. Anything you pass explicitly overrides the prefill."
+        ),
+        methods: import_zod4.z.array(import_zod4.z.string()).optional().describe("For `add`: restrict to these HTTP methods. Omit for any."),
+        kind: import_zod4.z.enum(["respond", "fail", "delay"]).optional().describe(
+          "respond = return your status/body, never hitting the network (default). fail = a transport failure, as if the device were offline. delay = let the real request run, just late."
+        ),
+        status: import_zod4.z.number().optional().describe(
+          "For kind 'respond': HTTP status, 200\u2013599 (default 200). Outside that range fetch itself throws, so use kind 'fail' for connection errors rather than status 0."
+        ),
+        body: import_zod4.z.union([import_zod4.z.string(), import_zod4.z.record(import_zod4.z.unknown()), import_zod4.z.array(import_zod4.z.unknown())]).optional().describe(
+          "For kind 'respond': the response body. Pass JSON directly (an object or array) or a raw string; content-type is inferred."
+        ),
+        statusText: import_zod4.z.string().optional().describe(
+          "For kind 'respond': the status line's text, e.g. 'Service Unavailable'. Cosmetic \u2014 React Native's XMLHttpRequest has no statusText field, so the app never sees it; it only makes the developer's rule list read correctly."
+        ),
+        headers: import_zod4.z.record(import_zod4.z.string()).optional().describe("For kind 'respond': response headers to send."),
+        failKind: import_zod4.z.enum(["network", "timeout"]).optional().describe("For kind 'fail': 'network' (default) or 'timeout'."),
+        delayMs: import_zod4.z.number().optional().describe("Latency before the outcome, in ms. Works with every kind."),
+        times: import_zod4.z.number().optional().describe(
+          "Auto-disable the rule after N matches. Use 1 for 'make the next call fail' so it can't linger."
+        ),
+        alternate: import_zod4.z.boolean().optional().describe(
+          "Apply to every OTHER matching request, forever: the first goes through, the second is overridden, and so on. This is how you test retry logic and flaky endpoints \u2014 a rule that is always on or always off can't reach those paths."
+        ),
+        name: import_zod4.z.string().optional().describe("Label shown in the developer's UI."),
+        enabled: import_zod4.z.boolean().optional().describe(
+          "For `add`: create the rule switched off (default true). Useful for staging a rule you'll arm later with enable({id})."
+        ),
+        id: import_zod4.z.string().optional().describe(
+          "Rule id. Required for `remove`. For `add` it replaces that rule. For `enable`/`disable` it targets ONE rule instead of the master switch. For `list` it dumps that rule in full."
+        ),
+        url: import_zod4.z.string().optional().describe(
+          "For `debug`: a concrete URL to test the rules against, so the report says which rule would match it and why."
+        ),
+        deviceId: import_zod4.z.string().optional().describe("Target device id (auto-selected if one is connected).")
+      }
+    },
+    async (args) => {
+      try {
+        const target = sync.requireProDevice(args.deviceId);
+        switch (args.action) {
+          case "add": {
+            if (!args.urlPattern && !args.fromRequestId) {
+              return fail4(
+                "`add` needs a `urlPattern` or a `fromRequestId`. Take an id from get_network_requests to override a request you just saw, or pass a glob like '*pokeapi.co*'."
+              );
+            }
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "upsertOverrideRule",
+              {
+                fromRequestId: args.fromRequestId,
+                rule: {
+                  id: args.id,
+                  name: args.name,
+                  urlPattern: args.urlPattern,
+                  methods: args.methods,
+                  // Not defaulted here — the device defaults to "respond" too,
+                  // and leaving it absent lets a `fromRequestId` prefill win.
+                  kind: args.kind,
+                  status: args.status,
+                  statusText: args.statusText,
+                  body: args.body,
+                  headers: args.headers,
+                  failKind: args.failKind,
+                  delayMs: args.delayMs,
+                  times: args.times,
+                  alternate: args.alternate,
+                  enabled: args.enabled !== false
+                }
+              },
+              target
+            );
+            const shaped = res;
+            if (!shaped?.ok) {
+              return fail4(shaped?.error ?? `Could not add the rule on ${target}.`);
+            }
+            const pattern = shaped.rule?.urlPattern ?? args.urlPattern;
+            const armed = shaped.rule?.enabled === false ? `
+
+It is switched OFF \u2014 arm it with network_override({action:"enable", id:"${shaped.rule?.id}"}).` : "";
+            return text3(
+              `Override added on ${target} \u2014 \`${shaped.rule?.id}\` matching \`${pattern}\`.${armed}
+
+Trigger the request now (navigate / tap_element), then check it with get_network_requests or describe_screen. Remove it with network_override({action:"remove", id:"${shaped.rule?.id}"}) when you're done.`
+            );
+          }
+          case "remove": {
+            if (!args.id) {
+              return fail4('`remove` needs an `id`. List them with network_override({action:"list"}).');
+            }
+            await sync.callAction(NETWORK_TOOL_ID, "deleteOverrideRule", { id: args.id }, target);
+            return text3(`Removed override \`${args.id}\` on ${target}.`);
+          }
+          case "clear":
+            await sync.callAction(NETWORK_TOOL_ID, "clearOverrideRules", {}, target);
+            return text3(`Removed all override rules on ${target}. Traffic is real again.`);
+          case "enable":
+          case "disable": {
+            const enabled = args.action === "enable";
+            if (args.id) {
+              await sync.callAction(
+                NETWORK_TOOL_ID,
+                "setOverrideRuleEnabled",
+                { id: args.id, enabled },
+                target
+              );
+              return text3(
+                `Rule \`${args.id}\` is now ${enabled ? "ON" : "OFF"} on ${target}. The other rules and the master switch are unchanged.`
+              );
+            }
+            await sync.callAction(NETWORK_TOOL_ID, "setOverridesEnabled", { enabled }, target);
+            return text3(
+              enabled ? `Overrides switched ON for ${target}.` : `Overrides switched OFF for ${target}. Rules are kept \u2014 re-enable with network_override({action:"enable"}).`
+            );
+          }
+          case "list": {
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "listOverrideRules",
+              {},
+              target
+            );
+            const rules = res?.rules ?? [];
+            if (args.id) {
+              const rule = rules.find((r) => r.id === args.id);
+              if (!rule) {
+                return fail4(
+                  `No override rule \`${args.id}\` on ${target}. List them with network_override({action:"list"}).`
+                );
+              }
+              return text3(
+                `**Override rule \`${rule.id}\`** on ${target}${masterNote(res)}
+
+\`\`\`json
+${JSON.stringify(rule, null, 2)}
+\`\`\``
+              );
+            }
+            if (rules.length === 0) {
+              return text3(
+                `No override rules on ${target}.
+
+Add one with network_override({action:"add", urlPattern:"*", status:500}) to force an error state.`
+              );
+            }
+            const rows = rules.map((rule, i) => {
+              const what = rule.kind === "respond" ? `\u2192 ${rule.status ?? 200}${rule.statusText ? ` ${rule.statusText}` : ""}` : rule.kind === "fail" ? `\u2192 ${rule.failKind === "timeout" ? "timeout" : "network error"}` : "\u2192 real response";
+              const bits = [
+                rule.methods?.length ? rule.methods.join("/") : "any method",
+                what,
+                // Enough to tell WHICH body this is without printing it.
+                rule.kind === "respond" && rule.body ? `body ${rule.body.length}B` : "",
+                rule.headers && Object.keys(rule.headers).length ? `${Object.keys(rule.headers).length} header(s)` : "",
+                rule.delayMs ? `${rule.delayMs}ms delay` : "",
+                rule.alternate ? "every other request" : "",
+                typeof rule.times === "number" ? `${rule.times}\xD7 then off` : "",
+                `${rule.hits} hit${rule.hits === 1 ? "" : "s"}`,
+                // Only interesting when the two can disagree: `alternate` and
+                // spent `times` rules match without applying, and a gap between
+                // the numbers is the explanation for "it matched but nothing
+                // happened".
+                rule.seen != null && rule.seen !== rule.hits ? `${rule.seen} matched` : "",
+                rule.enabled ? "" : "DISABLED"
+              ].filter(Boolean);
+              return `${i + 1}. \`${rule.id}\`${rule.name ? ` ${rule.name}` : ""}
+   \u2514\u2500 \`${rule.urlPattern}\` \xB7 ${bits.join(" \xB7 ")}`;
+            });
+            return text3(
+              `**Override rules on ${target}**${masterNote(res)}
+
+${rows.join("\n")}
+
+Full detail incl. body: network_override({action:"list", id:"${rules[0]?.id}"}).`
+            );
+          }
+          case "debug": {
+            const res = await sync.callAction(
+              NETWORK_TOOL_ID,
+              "debugOverrides",
+              { url: args.url },
+              target
+            );
+            if (!res) {
+              return fail4(
+                `${target} did not answer the diagnostics call \u2014 the network tool may not be mounted.`
+              );
+            }
+            return text3(
+              `**Override diagnostics on ${target}**${args.url ? ` for \`${args.url}\`` : ""}
+
+\`\`\`json
+${JSON.stringify(res, null, 2)}
+\`\`\`
+
+A rule that never fires is usually one of: the master switch is off, the interceptor isn't installed (nothing is subscribed to the network tool), or the pattern doesn't match the FULL url including its query string.`
+            );
+          }
+        }
+      } catch (e) {
+        return fail4(errMsg4(e));
+      }
+    }
+  );
 }
 
 // src/tools/packs/reactQuery.ts

package/dist/index.mjs

@@ -27,7 +27,7 @@ import {
   registerStorageTools,
   registerZustandTools,
   runInit
-} from "./chunk-IGB5AS45.mjs";
+} from "./chunk-ZEHIU6OG.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.12",
+  "version": "7.0.14",
   "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.12"
+    "@buoy-gg/sync-broker": "^7.0.14"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",