@buoy-gg/mcp 7.0.34 → 7.0.36

package/dist/{chunk-LS2L5OOL.mjs → chunk-QIINQPNK.mjs}

@@ -614,7 +614,7 @@ async function waitForBroker(url, attempts = 20) {
 var delay = (ms) => new Promise((r) => setTimeout(r, ms));
 
 // src/version.ts
-var VERSION = "7.0.34" ? "7.0.34" : "0.0.0-dev";
+var VERSION = "7.0.36" ? "7.0.36" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -2745,6 +2745,9 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
         body: z13.union([z13.string(), z13.record(z13.unknown()), z13.array(z13.unknown())]).optional().describe(
           "For kind 'respond': the response body. Pass JSON directly (an object or array) or a raw string; content-type is inferred."
         ),
+        bodyPatch: z13.record(z13.unknown()).optional().describe(
+          'For `add` with `fromRequestId` (or a rule `id`): fields deep-merged INTO the real captured response \u2014 the way to change one field of a big payload without pasting it back. Send only what changes, e.g. {"name":"test123"}. Ignored when `body` is given.'
+        ),
         statusText: z13.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."
         ),
@@ -2796,6 +2799,7 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
                   status: args.status,
                   statusText: args.statusText,
                   body: args.body,
+                  bodyPatch: args.bodyPatch,
                   headers: args.headers,
                   failKind: args.failKind,
                   delayMs: args.delayMs,
@@ -4013,13 +4017,21 @@ 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. If you already know the sequence you want to drive, `run_flow` does the whole thing (taps, waits, assertions) in one call instead. Re-run after navigating or when the screen changes, since positions move. Requires Buoy Pro.",
       inputSchema: {
         interactiveOnly: z18.boolean().optional().describe("Only return tappable (onPress) elements. Default false (include labels/text for context)."),
+        includeBuoy: z18.boolean().optional().describe(
+          "Also list Buoy's own overlay \u2014 the dial, tool sheets, Ask Buoy's chat. Default false: the screen described is the app's. Exact testIDs inside Buoy (buoy-\u2026) can still be tapped without this."
+        ),
         deviceId: deviceIdInput
       }
     },
     async (args) => {
       try {
         const target = sync.requireProDevice(args.deviceId);
-        const res = await sync.callAction(TOOL_ID2, "describeScreen", {}, target);
+        const res = await sync.callAction(
+          TOOL_ID2,
+          "describeScreen",
+          { includeBuoy: args.includeBuoy },
+          target
+        );
         const all = res?.elements ?? [];
         const elements = args.interactiveOnly ? all.filter((e) => e.interactive) : all;
         if (elements.length === 0) {
@@ -4027,7 +4039,8 @@ function registerInteractTools(server, sync) {
             "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 }).`;
+        const hidden = res.hiddenBuoy ? ` Buoy's own overlay (${res.hiddenBuoy} element${res.hiddenBuoy === 1 ? "" : "s"}) is left out \u2014 pass includeBuoy:true to see it.` : "";
+        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 }).${hidden}`;
         return text5(`${header}
 
 ${elements.map(formatElement).join("\n")}`);
@@ -4048,6 +4061,7 @@ ${elements.map(formatElement).join("\n")}`);
         text: z18.string().optional().describe("For a text input: the string to set via onChangeText."),
         longPress: z18.boolean().optional().describe("Invoke the element's onLongPress instead of onPress. Fails with a clear reason if the element has no onLongPress handler."),
         scrollIntoView: z18.boolean().optional().describe("Scroll the target into view first if it's off-screen. Default true."),
+        includeBuoy: z18.boolean().optional().describe("Let a fuzzy `query` match Buoy's own overlay. Default false \u2014 an exact nativeTag/testID always may."),
         deviceId: deviceIdInput
       }
     },
@@ -4067,7 +4081,8 @@ ${elements.map(formatElement).join("\n")}`);
             value: args.value,
             text: args.text,
             longPress: args.longPress,
-            scrollIntoView: args.scrollIntoView
+            scrollIntoView: args.scrollIntoView,
+            includeBuoy: args.includeBuoy
           },
           target
         );
@@ -4079,7 +4094,12 @@ ${elements.map(formatElement).join("\n")}`);
           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}` : m.via === "onLongPress" ? `Long-pressed "${label}"${id}` : `Tapped "${label}"${id}`;
-          return text5(`${verb}${scrolledNote}.${flowTip}`);
+          const fx = res.effect;
+          const effectNote = !fx ? "" : fx.commits > 0 ? ` ${fx.commits} re-render${fx.commits === 1 ? "" : "s"} followed.` : ` No re-render followed within ${fx.observedMs}ms \u2014 the handler ran but the app did not react. The element may sit on a screen beneath the current one, or be inert; do not treat this as done.`;
+          const alsoNote = res.alsoMatched?.length ? `
+Also matched equally well (the choice was a coin toss \u2014 re-tap by #nativeTag if this was wrong):
+` + res.alsoMatched.map((c) => `- ${c.name}${c.text ? ` "${c.text}"` : ""}${c.testID ? ` [testID=${c.testID}]` : ""}${c.nativeTag != null ? ` #${c.nativeTag}` : ""}`).join("\n") : "";
+          return text5(`${verb}${scrolledNote}.${effectNote}${alsoNote}${flowTip}`);
         }
         let msg = res?.reason ?? "Tap failed.";
         if (res?.candidates?.length) {

package/dist/cli.js

@@ -652,7 +652,7 @@ var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
 
 // src/version.ts
-var VERSION = "7.0.34" ? "7.0.34" : "0.0.0-dev";
+var VERSION = "7.0.36" ? "7.0.36" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -1979,6 +1979,9 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
         body: import_zod5.z.union([import_zod5.z.string(), import_zod5.z.record(import_zod5.z.unknown()), import_zod5.z.array(import_zod5.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."
         ),
+        bodyPatch: import_zod5.z.record(import_zod5.z.unknown()).optional().describe(
+          'For `add` with `fromRequestId` (or a rule `id`): fields deep-merged INTO the real captured response \u2014 the way to change one field of a big payload without pasting it back. Send only what changes, e.g. {"name":"test123"}. Ignored when `body` is given.'
+        ),
         statusText: import_zod5.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."
         ),
@@ -2030,6 +2033,7 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
                   status: args.status,
                   statusText: args.statusText,
                   body: args.body,
+                  bodyPatch: args.bodyPatch,
                   headers: args.headers,
                   failKind: args.failKind,
                   delayMs: args.delayMs,
@@ -4043,13 +4047,21 @@ 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. If you already know the sequence you want to drive, `run_flow` does the whole thing (taps, waits, assertions) in one call instead. Re-run after navigating or when the screen changes, since positions move. Requires Buoy Pro.",
       inputSchema: {
         interactiveOnly: import_zod18.z.boolean().optional().describe("Only return tappable (onPress) elements. Default false (include labels/text for context)."),
+        includeBuoy: import_zod18.z.boolean().optional().describe(
+          "Also list Buoy's own overlay \u2014 the dial, tool sheets, Ask Buoy's chat. Default false: the screen described is the app's. Exact testIDs inside Buoy (buoy-\u2026) can still be tapped without this."
+        ),
         deviceId: deviceIdInput
       }
     },
     async (args) => {
       try {
         const target = sync.requireProDevice(args.deviceId);
-        const res = await sync.callAction(TOOL_ID2, "describeScreen", {}, target);
+        const res = await sync.callAction(
+          TOOL_ID2,
+          "describeScreen",
+          { includeBuoy: args.includeBuoy },
+          target
+        );
         const all = res?.elements ?? [];
         const elements = args.interactiveOnly ? all.filter((e) => e.interactive) : all;
         if (elements.length === 0) {
@@ -4057,7 +4069,8 @@ function registerInteractTools(server, sync) {
             "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 }).`;
+        const hidden = res.hiddenBuoy ? ` Buoy's own overlay (${res.hiddenBuoy} element${res.hiddenBuoy === 1 ? "" : "s"}) is left out \u2014 pass includeBuoy:true to see it.` : "";
+        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 }).${hidden}`;
         return text5(`${header}
 
 ${elements.map(formatElement).join("\n")}`);
@@ -4078,6 +4091,7 @@ ${elements.map(formatElement).join("\n")}`);
         text: import_zod18.z.string().optional().describe("For a text input: the string to set via onChangeText."),
         longPress: import_zod18.z.boolean().optional().describe("Invoke the element's onLongPress instead of onPress. Fails with a clear reason if the element has no onLongPress handler."),
         scrollIntoView: import_zod18.z.boolean().optional().describe("Scroll the target into view first if it's off-screen. Default true."),
+        includeBuoy: import_zod18.z.boolean().optional().describe("Let a fuzzy `query` match Buoy's own overlay. Default false \u2014 an exact nativeTag/testID always may."),
         deviceId: deviceIdInput
       }
     },
@@ -4097,7 +4111,8 @@ ${elements.map(formatElement).join("\n")}`);
             value: args.value,
             text: args.text,
             longPress: args.longPress,
-            scrollIntoView: args.scrollIntoView
+            scrollIntoView: args.scrollIntoView,
+            includeBuoy: args.includeBuoy
           },
           target
         );
@@ -4109,7 +4124,12 @@ ${elements.map(formatElement).join("\n")}`);
           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}` : m.via === "onLongPress" ? `Long-pressed "${label}"${id}` : `Tapped "${label}"${id}`;
-          return text5(`${verb}${scrolledNote}.${flowTip}`);
+          const fx = res.effect;
+          const effectNote = !fx ? "" : fx.commits > 0 ? ` ${fx.commits} re-render${fx.commits === 1 ? "" : "s"} followed.` : ` No re-render followed within ${fx.observedMs}ms \u2014 the handler ran but the app did not react. The element may sit on a screen beneath the current one, or be inert; do not treat this as done.`;
+          const alsoNote = res.alsoMatched?.length ? `
+Also matched equally well (the choice was a coin toss \u2014 re-tap by #nativeTag if this was wrong):
+` + res.alsoMatched.map((c) => `- ${c.name}${c.text ? ` "${c.text}"` : ""}${c.testID ? ` [testID=${c.testID}]` : ""}${c.nativeTag != null ? ` #${c.nativeTag}` : ""}`).join("\n") : "";
+          return text5(`${verb}${scrolledNote}.${effectNote}${alsoNote}${flowTip}`);
         }
         let msg = res?.reason ?? "Tap failed.";
         if (res?.candidates?.length) {

package/dist/cli.mjs

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

package/dist/index.js

@@ -687,7 +687,7 @@ var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
 
 // src/version.ts
-var VERSION = "7.0.34" ? "7.0.34" : "0.0.0-dev";
+var VERSION = "7.0.36" ? "7.0.36" : "0.0.0-dev";
 var PACKAGE_NAME = "@buoy-gg/mcp";
 
 // src/update/checkForUpdate.ts
@@ -2014,6 +2014,9 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
         body: import_zod5.z.union([import_zod5.z.string(), import_zod5.z.record(import_zod5.z.unknown()), import_zod5.z.array(import_zod5.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."
         ),
+        bodyPatch: import_zod5.z.record(import_zod5.z.unknown()).optional().describe(
+          'For `add` with `fromRequestId` (or a rule `id`): fields deep-merged INTO the real captured response \u2014 the way to change one field of a big payload without pasting it back. Send only what changes, e.g. {"name":"test123"}. Ignored when `body` is given.'
+        ),
         statusText: import_zod5.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."
         ),
@@ -2065,6 +2068,7 @@ _\u{1F4CC} pinned \xB7 \u{1F516} saved. Act on one with its id, e.g. network_act
                   status: args.status,
                   statusText: args.statusText,
                   body: args.body,
+                  bodyPatch: args.bodyPatch,
                   headers: args.headers,
                   failKind: args.failKind,
                   delayMs: args.delayMs,
@@ -4078,13 +4082,21 @@ 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. If you already know the sequence you want to drive, `run_flow` does the whole thing (taps, waits, assertions) in one call instead. Re-run after navigating or when the screen changes, since positions move. Requires Buoy Pro.",
       inputSchema: {
         interactiveOnly: import_zod18.z.boolean().optional().describe("Only return tappable (onPress) elements. Default false (include labels/text for context)."),
+        includeBuoy: import_zod18.z.boolean().optional().describe(
+          "Also list Buoy's own overlay \u2014 the dial, tool sheets, Ask Buoy's chat. Default false: the screen described is the app's. Exact testIDs inside Buoy (buoy-\u2026) can still be tapped without this."
+        ),
         deviceId: deviceIdInput
       }
     },
     async (args) => {
       try {
         const target = sync.requireProDevice(args.deviceId);
-        const res = await sync.callAction(TOOL_ID2, "describeScreen", {}, target);
+        const res = await sync.callAction(
+          TOOL_ID2,
+          "describeScreen",
+          { includeBuoy: args.includeBuoy },
+          target
+        );
         const all = res?.elements ?? [];
         const elements = args.interactiveOnly ? all.filter((e) => e.interactive) : all;
         if (elements.length === 0) {
@@ -4092,7 +4104,8 @@ function registerInteractTools(server, sync) {
             "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 }).`;
+        const hidden = res.hiddenBuoy ? ` Buoy's own overlay (${res.hiddenBuoy} element${res.hiddenBuoy === 1 ? "" : "s"}) is left out \u2014 pass includeBuoy:true to see it.` : "";
+        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 }).${hidden}`;
         return text5(`${header}
 
 ${elements.map(formatElement).join("\n")}`);
@@ -4113,6 +4126,7 @@ ${elements.map(formatElement).join("\n")}`);
         text: import_zod18.z.string().optional().describe("For a text input: the string to set via onChangeText."),
         longPress: import_zod18.z.boolean().optional().describe("Invoke the element's onLongPress instead of onPress. Fails with a clear reason if the element has no onLongPress handler."),
         scrollIntoView: import_zod18.z.boolean().optional().describe("Scroll the target into view first if it's off-screen. Default true."),
+        includeBuoy: import_zod18.z.boolean().optional().describe("Let a fuzzy `query` match Buoy's own overlay. Default false \u2014 an exact nativeTag/testID always may."),
         deviceId: deviceIdInput
       }
     },
@@ -4132,7 +4146,8 @@ ${elements.map(formatElement).join("\n")}`);
             value: args.value,
             text: args.text,
             longPress: args.longPress,
-            scrollIntoView: args.scrollIntoView
+            scrollIntoView: args.scrollIntoView,
+            includeBuoy: args.includeBuoy
           },
           target
         );
@@ -4144,7 +4159,12 @@ ${elements.map(formatElement).join("\n")}`);
           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}` : m.via === "onLongPress" ? `Long-pressed "${label}"${id}` : `Tapped "${label}"${id}`;
-          return text5(`${verb}${scrolledNote}.${flowTip}`);
+          const fx = res.effect;
+          const effectNote = !fx ? "" : fx.commits > 0 ? ` ${fx.commits} re-render${fx.commits === 1 ? "" : "s"} followed.` : ` No re-render followed within ${fx.observedMs}ms \u2014 the handler ran but the app did not react. The element may sit on a screen beneath the current one, or be inert; do not treat this as done.`;
+          const alsoNote = res.alsoMatched?.length ? `
+Also matched equally well (the choice was a coin toss \u2014 re-tap by #nativeTag if this was wrong):
+` + res.alsoMatched.map((c) => `- ${c.name}${c.text ? ` "${c.text}"` : ""}${c.testID ? ` [testID=${c.testID}]` : ""}${c.nativeTag != null ? ` #${c.nativeTag}` : ""}`).join("\n") : "";
+          return text5(`${verb}${scrolledNote}.${effectNote}${alsoNote}${flowTip}`);
         }
         let msg = res?.reason ?? "Tap failed.";
         if (res?.candidates?.length) {

package/dist/index.mjs

@@ -27,7 +27,7 @@ import {
   registerStorageTools,
   registerZustandTools,
   runInit
-} from "./chunk-LS2L5OOL.mjs";
+} from "./chunk-QIINQPNK.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.34",
+  "version": "7.0.36",
   "description": "MCP server for Buoy devtools — lets any LLM copilot drive Buoy tools (perf-monitor benchmarks, etc.) over the devtool sync protocol",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -32,7 +32,7 @@
     "socket.io-client": "^4.8.1",
     "zod": "^3.25.0",
     "ws": "^8.18.0",
-    "@buoy-gg/sync-broker": "^7.0.34"
+    "@buoy-gg/sync-broker": "^7.0.36"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",