execbro 2.3.0 → 2.6.0

package/build/tools/executionTools.js

@@ -6,7 +6,6 @@ import { applyResultBudget } from "../core/truncate.js";
 import { buildCollectExpression, dropHandle } from "../core/promiseHandles.js";
 import { DEVICE_ARG_DESC } from "./_deviceArg.js";
 export function registerExecutionTools(server) {
-    // Tool: Execute JavaScript in app
     registerToolWithTelemetry(server, "execute_in_app", {
         description: "Execute JavaScript code in the connected React Native app and return the result. Use this for inspecting app state, calling methods on exposed global objects, or running diagnostic code. Hermes compatible: 'global' is automatically polyfilled to 'globalThis', so both global.__REDUX_STORE__ and globalThis.__REDUX_STORE__ work.\n\n" +
             "RECOMMENDED WORKFLOW: 1) list_debug_globals to discover available objects, 2) inspect_global to see properties/methods, 3) execute_in_app to call methods or read values.\n\n" +
@@ -88,8 +87,6 @@ export function registerExecutionTools(server) {
         }
         if (!result.success) {
             let errorText = `Error: ${result.error}`;
-            // If the error is a ReferenceError (accessing a global that doesn't exist),
-            // guide the agent to expose the variable as a global first
             if (result.error?.includes("ReferenceError")) {
                 errorText +=
                     "\n\nNOTE: This variable is not exposed as a global. To access it, first assign it to a global variable in your app code (e.g., `globalThis.__MY_VAR__ = myVar;`), then use execute_in_app to read `__MY_VAR__`. You can also use list_debug_globals to see what globals ARE currently available.";
@@ -104,17 +101,10 @@ export function registerExecutionTools(server) {
                     }
                 ],
                 isError: true,
-                // Include expression as context for telemetry (helps debug syntax errors)
                 _errorContext: expression
             };
         }
         let resultText = result.result ?? "undefined";
-        // Bound the result unless verbose or explicitly unlimited.
-        //
-        // Structural bounding rather than a mid-string clip: a clip can cut
-        // JSON in half, which tells the reader nothing about what was lost
-        // and cannot be parsed. Bounding keeps the shape and reports real
-        // array lengths and key counts, so the next read can be targeted.
         if (!verbose && maxResultLength > 0) {
             const bounded = applyResultBudget(resultText, maxResultLength);
             resultText = bounded.text;
@@ -138,15 +128,12 @@ export function registerExecutionTools(server) {
                 }
             ]
         };
-    }, 
-    // Empty result detector: successful execution but no meaningful output
-    (result) => {
+    }, (result) => {
         if (result?.isError)
             return false;
         const text = result?.content?.[0]?.text;
         return text === undefined || text === "" || text === "undefined" || text === "null";
     });
-    // Tool: List debug globals available in the app
     registerToolWithTelemetry(server, "list_debug_globals", {
         description: "List globally available debugging objects in the connected app (Apollo, Redux, React DevTools, etc.).\n" +
             "PURPOSE: Enumerate the app's globalThis.* surface so you know which stores, clients, and debug hooks you can drill into.\n" +
@@ -181,7 +168,6 @@ export function registerExecutionTools(server) {
             ]
         };
     });
-    // Tool: Inspect a global object to see its properties and types
     registerToolWithTelemetry(server, "inspect_global", {
         description: "Inspect a global object (or a dotted path into one) to see its properties, types, and whether they are callable functions. Use this BEFORE calling methods on unfamiliar objects to avoid errors.\n" +
             "PURPOSE: Surface the shape of a global (Apollo client, Redux store, Expo Router, SDK-registered store, etc.) — keys, types, and which members are callable — without executing arbitrary code.\n" +
@@ -201,8 +187,6 @@ export function registerExecutionTools(server) {
         const result = await inspectGlobal(objectName, device);
         if (!result.success) {
             let errorText = `Error: ${result.error}`;
-            // If the global (or path) doesn't resolve, guide the agent toward
-            // either exposing it manually or registering it via the SDK.
             const looksMissing = result.error?.includes("ReferenceError") || result.error?.includes("NotFound") || result.error?.includes("not found");
             if (looksMissing) {
                 const isPath = objectName.includes(".");
@@ -233,7 +217,6 @@ export function registerExecutionTools(server) {
             ]
         };
     });
-    // Tool: Did the JS runtime accept a Fast Refresh update since `since`?
     registerToolWithTelemetry(server, "get_refresh_status", {
         description: "Pull-style probe: did the JS runtime accept a Fast Refresh (HMR) update since `since`? Returns lastUpdateAt, updateCount, and recentUpdates from a 32-entry ring buffer fed by a recorder around __ReactRefresh.performReactRefresh (preferred) or \\$RefreshReg\\$ (fallback).\n\n" +
             "PURPOSE: Confirm an edit landed in the running app without polling logs or screenshots. After editing TSX, wait ~2s then call with `since` = a Date.now() captured BEFORE the edit. updateCount > 0 means Fast Refresh accepted.\n\n" +

package/build/tools/executionTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"executionTools.js","sourceRoot":"","sources":["../../src/tools/executionTools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executionTools.js","sourceRoot":"","sources":["../../src/tools/executionTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IAEpD,yBAAyB,CACrB,MAAM,EACN,gBAAgB,EAChB;QACI,WAAW,EACP,6UAA6U;YAC7U,+KAA+K;YAC/K,gCAAgC;YAChC,sEAAsE;YACtE,8LAA8L;YAC9L,uMAAuM;YACvM,sGAAsG;YACtG,0GAA0G;YAC1G,sFAAsF;YACtF,wJAAwJ;QAC5J,WAAW,EAAE;YACT,OAAO,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACL,wOAAwO,CAC3O;YACL,UAAU,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACL,8eAA8e,CACjf;YACL,YAAY,EAAE,CAAC,CAAC,MAAM;iBACjB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CAAC,2CAA2C,CAAC;YAC1D,eAAe,EAAE,CAAC,CAAC,MAAM;iBACpB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CACL,kOAAkO,CACrO;YACL,OAAO,EAAE,CAAC;iBACL,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,6FAA6F,CAAC;YAC5G,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YACvD,SAAS,EAAE,CAAC,CAAC,MAAM;iBACd,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACL,iNAAiN,CACpN;SACR;KACJ,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;QACzF,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,MAAM,YAAY,CAChC,sBAAsB,CAAC,OAAO,CAAC,EAC/B,KAAK,EACL,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,EACzC,MAAM,CACT,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACrB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC7F,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBACrC,OAAO;oBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mDAAmD,OAAO,eAAe,EAAE,CAAC;iBAC/G,CAAC;YACN,CAAC;YACD,UAAU,CAAC,OAAO,CAAC,CAAC;YACpB,IAAI,SAAS,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBACrC,OAAO;oBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,OAAO,4EAA4E,EAAE,CAAC;oBACjI,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;YACD,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC1I,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yFAAyF,EAAE,CAAC;gBAC5H,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,YAAY,EAAE;YACxD,SAAS;YACT,mBAAmB,EAAE,gBAAgB;SACxC,EAAE,MAAM,CAAC,CAAC;QAEX,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,SAAS,uBAAuB,CAAC,CAAC;QACtH,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACjD,SAAS,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,kBAAkB,qBAAqB,CAAC,CAAC;QAChG,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,SAAS,GAAG,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;YAIzC,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC3C,SAAS;oBACL,kSAAkS,CAAC;YAC3S,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS,GAAG,GAAG,SAAS,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAEhF,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS;qBAClB;iBACJ;gBACD,OAAO,EAAE,IAAI;gBAEb,aAAa,EAAE,UAAU;aAC5B,CAAC;QACN,CAAC;QAED,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC;QAQ9C,IAAI,CAAC,OAAO,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;YAC/D,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAC1B,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;gBACvC,MAAM,KAAK,GAAG,CAAC;oBACX,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,aAAa,cAAc,CAAC,CAAC,eAAe,EAAE;oBACrF,CAAC,CAAC,EAAE,CAAC;gBACT,UAAU;oBACN,iBAAiB,OAAO,CAAC,MAAM,CAAC,aAAa,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa,SAAS,KAAK,GAAG;wBACjG,oEAAoE,CAAC;YAC7E,CAAC;QACL,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,UAAU,GAAG,GAAG,UAAU,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAElF,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU;iBACnB;aACJ;SACJ,CAAC;IACN,CAAC,EAED,CAAC,MAAM,EAAE,EAAE;QACP,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,KAAK,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QACxC,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM,CAAC;IACxF,CAAC,CACJ,CAAC;IAGF,yBAAyB,CACrB,MAAM,EACN,oBAAoB,EACpB;QACI,WAAW,EACP,yGAAyG;YACzG,4HAA4H;YAC5H,kIAAkI;YAClI,6GAA6G;YAC7G,yPAAyP;YACzP,6VAA6V;YAC7V,yEAAyE;YACzE,wIAAwI;QAC5I,WAAW,EAAE;YACT,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;SAC1D;KACJ,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE;qBACjC;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QAED,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0CAA0C,MAAM,CAAC,MAAM,EAAE;iBAClE;aACJ;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;IAGF,yBAAyB,CACrB,MAAM,EACN,gBAAgB,EAChB;QACI,WAAW,EACP,qMAAqM;YACrM,kMAAkM;YAClM,gHAAgH;YAChH,8IAA8I;YAC9I,sQAAsQ;YACtQ,4LAA4L;YAC5L,qIAAqI;YACrI,sHAAsH;QAC1H,WAAW,EAAE;YACT,UAAU,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CAAC,qJAAqJ,CAAC;YACpK,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;SAC1D;KACJ,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAEvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,SAAS,GAAG,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;YAIzC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC3I,IAAI,YAAY,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,MAAM,EAAE,CAAC;oBACT,SAAS,IAAI,cAAc,UAAU,6LAA6L,CAAC;gBACvO,CAAC;qBAAM,CAAC;oBACJ,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACnE,SAAS,IAAI,cAAc,UAAU,yFAAyF,UAAU,MAAM,SAAS,gFAAgF,SAAS,KAAK,SAAS,oDAAoD,SAAS,4CAA4C,CAAC;gBAC5W,CAAC;YACL,CAAC;YAED,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS;qBAClB;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QAED,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iBAAiB,UAAU,QAAQ,MAAM,CAAC,MAAM,EAAE;iBAC3D;aACJ;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;IAGF,yBAAyB,CACrB,MAAM,EACN,oBAAoB,EACpB;QACI,WAAW,EACP,qRAAqR;YACrR,sOAAsO;YACtO,8JAA8J;YAC9J,yOAAyO;YACzO,2LAA2L;YAC3L,yHAAyH;QAC7H,WAAW,EAAE;YACT,SAAS,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6HAA6H,CAAC;YAC5I,KAAK,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4FAA4F,CAAC;YAC3G,MAAM,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,eAAe,CAAC;SACjC;KACJ,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACnC,MAAM,CAAC,GAAG,MAAM,gBAAgB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/D,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;gBACtD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QAED,MAAM,KAAK,GAAa;YACpB,gBAAgB,CAAC,CAAC,WAAW,IAAI,CAAC,EAAE;YACpC,iBAAiB,CAAC,CAAC,YAAY,IAAI,MAAM,EAAE;YAC3C,QAAQ,CAAC,CAAC,GAAG,IAAI,SAAS,EAAE;SAC/B,CAAC;QACF,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC5C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrF,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACxE,CAAC;QAED,OAAO;YACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACtD,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/build/tools/interactionTools.d.ts

@@ -1,17 +1,7 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type TextEntryResult } from "../core/textEntry.js";
-/**
- * Default swipe gesture duration. Android has always used 300ms; iOS passed no
- * duration at all and inherited AXe's ~1s drag, which was both slower and too
- * slow to trigger inertial scrolling. Shared so the platforms cannot drift again.
- */
 export declare const SWIPE_DEFAULT_DURATION_MS = 300;
 export declare function registerInteractionTools(server: McpServer): void;
-/**
- * Renders a text-entry outcome. Two rules carry the whole design:
- * an unverified write must never read as a plain success, and a failed
- * keyboard raise must never read as a failed write.
- */
 export declare function formatTextEntryResponse(r: TextEntryResult): {
     content: Array<{
         type: "text";

package/build/tools/interactionTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactionTools.d.ts","sourceRoot":"","sources":["../../src/tools/interactionTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AASvE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2vBhE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,eAAe,GAAG;IACzD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CA+CA"}
+{"version":3,"file":"interactionTools.d.ts","sourceRoot":"","sources":["../../src/tools/interactionTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAcvE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAs/BhE;AAOD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,eAAe,GAAG;IACzD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CA+CA"}

package/build/tools/interactionTools.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { registerToolWithTelemetry } from "../core/register.js";
-import { androidLongPress, androidSwipe, androidInputText, androidKeyEvent, ANDROID_KEY_EVENTS, iosButton, iosInputText, iosSwipe, IOS_BUTTON_TYPES, getDevicePixelRatio, connectedApps, } from "../core/index.js";
+import { androidLongPress, androidSwipe, androidPinch, androidInputText, androidKeyEvent, ANDROID_KEY_EVENTS, iosButton, iosInputText, iosSwipe, IOS_BUTTON_TYPES, getDevicePixelRatio, connectedApps, } from "../core/index.js";
 import { tap, convertScreenshotToTapCoords, computeSwipeFromDirection } from "../pro/tap.js";
 import { captureScreenshot, verifyAndCapture, burstCaptureAndVerify, } from "../pro/verifyAction.js";
 import { clearFocusedInput, dismissKeyboard, inputTextWithReplace } from "../core/focusedInputTools.js";
@@ -11,14 +11,8 @@ import { readNativeFields } from "../core/nativeInputValue.js";
 import { primaryInteractionBanner, platformFallbackBanner, platformUniqueBanner } from "../core/toolHelpers.js";
 import { resolveDeviceTarget, formatResolverError } from "../core/deviceResolver.js";
 import { resolveAndroidDeviceId, resolveIosUdid, ANDROID_ARG_DESC, IOS_ARG_DESC } from "./_deviceArg.js";
-/**
- * Default swipe gesture duration. Android has always used 300ms; iOS passed no
- * duration at all and inherited AXe's ~1s drag, which was both slower and too
- * slow to trigger inertial scrolling. Shared so the platforms cannot drift again.
- */
 export const SWIPE_DEFAULT_DURATION_MS = 300;
 export function registerInteractionTools(server) {
-    // Tool: Unified tap — tries fiber, accessibility, OCR, coordinate strategies
     registerToolWithTelemetry(server, "tap", {
         description: "Tap a UI element. Automatically tries multiple strategies: fiber tree (React), accessibility tree (native), and OCR (visual)." +
             primaryInteractionBanner() + "\n" +
@@ -118,10 +112,6 @@ export function registerInteractionTools(server) {
         });
         const { screenshot: screenshotData, ...resultWithoutScreenshot } = result;
         const text = JSON.stringify(resultWithoutScreenshot, null, 2);
-        // Pack predicate + strategy mode + attempted strategies into errorContext for telemetry.
-        // Always include the predicate so unmeaningful outcomes (no isError, no _errorMessage) still
-        // carry triage context — otherwise blob8 ends up blank and the dashboard shows empty rows.
-        // e.g. "p={\"text\":\"Save\"}|s=ocr|fiber:no_pressable|ocr:no_match"
         const stratPrefix = args.strategy && args.strategy !== "auto" ? `s=${args.strategy}|` : "";
         let predicatePrefix = "";
         try {
@@ -130,7 +120,6 @@ export function registerInteractionTools(server) {
             }
         }
         catch {
-            // query may contain non-serializable values — drop the prefix rather than fail.
         }
         const attemptedPart = result.attempted?.length
             ? result.attempted.map(a => `${a.strategy}:${a.reason.slice(0, 40)}`).join("|")
@@ -165,9 +154,6 @@ export function registerInteractionTools(server) {
             _appRoute: result.appRoute,
         };
     });
-    // Android UI Input Tools (Phase 2)
-    // ============================================================================
-    // Tool: Android long press
     registerToolWithTelemetry(server, "android_long_press", {
         description: "Long press at specific coordinates on an Android device/emulator screen" +
             platformFallbackBanner("`tap` for short taps; keep android_long_press for long-press gestures specifically") +
@@ -197,7 +183,6 @@ export function registerInteractionTools(server) {
             isError: !result.success
         };
     });
-    // Tool: Cross-platform swipe — auto-routes to iOS or Android backend
     registerToolWithTelemetry(server, "swipe", {
         description: "Swipe gesture that auto-routes to the correct platform (iOS or Android), with pixel-diff verification." +
             primaryInteractionBanner() + "\n" +
@@ -276,8 +261,6 @@ export function registerInteractionTools(server) {
         const coordCount = [startX, startY, endX, endY].filter((v) => v !== undefined).length;
         const hasAllCoords = coordCount === 4;
         const useDirection = !hasAllCoords;
-        // Partial coordinates are only an error when no direction was given; an
-        // explicit direction takes the shorthand path and ignores stray coords.
         if (!hasAllCoords && coordCount > 0 && direction === undefined) {
             return {
                 content: [{
@@ -287,14 +270,11 @@ export function registerInteractionTools(server) {
                 isError: true,
             };
         }
-        // Capture before-screenshot only if we'll need it (verify or burst).
         const wantBefore = shouldVerify || shouldBurst;
         let beforeCapture = wantBefore
             ? await captureScreenshot(resolvedPlatform, resolvedUdid)
             : null;
         if (useDirection) {
-            // Need screen dimensions to compute the centered gesture. Reuse the
-            // before-frame if we captured one; otherwise grab one measurement frame.
             let dims = beforeCapture;
             if (!dims) {
                 dims = await captureScreenshot(resolvedPlatform, resolvedUdid);
@@ -308,7 +288,8 @@ export function registerInteractionTools(server) {
                     isError: true,
                 };
             }
-            const computed = computeSwipeFromDirection((direction ?? "up"), distance, dims.width, dims.height);
+            const shotScale = dims.scaleFactor || 1;
+            const computed = computeSwipeFromDirection((direction ?? "up"), distance, dims.width / shotScale, dims.height / shotScale);
             startX = computed.startX;
             startY = computed.startY;
             endX = computed.endX;
@@ -316,10 +297,6 @@ export function registerInteractionTools(server) {
         }
         const beforeBuffer = beforeCapture?.buffer ?? null;
         const beforeScaleFactor = beforeCapture?.scaleFactor;
-        // Prefer the scale factor of the frame captured for THIS device this
-        // turn over `connectedApps[0].lastScreenshot`, which may be stale or
-        // belong to another device on a multi-device setup — the same fix tap
-        // carries for its coordinate strategy (Bug #5, 2026-05-20).
         const swipeScaleFactor = beforeCapture?.scaleFactor
             ?? connectedApps.values().next().value?.lastScreenshot?.scaleFactor
             ?? 1;
@@ -331,11 +308,6 @@ export function registerInteractionTools(server) {
             const dpr = await getDevicePixelRatio(resolvedUdid, dprHint);
             const start = convertScreenshotToTapCoords(startX, startY, "ios", dpr, swipeScaleFactor);
             const end = convertScreenshotToTapCoords(endX, endY, "ios", dpr, swipeScaleFactor);
-            // Without an explicit duration, AXe drags for ~1s (measured
-            // 2026-08-01) — slower than the Android path, which has always
-            // defaulted to 300ms, and slow enough that iOS never produced the
-            // inertial fling a real scroll gesture has. Default both platforms
-            // to the same 300ms flick.
             const duration = (durationMs ?? SWIPE_DEFAULT_DURATION_MS) / 1000;
             driverResult = await iosSwipe(start.x, start.y, end.x, end.y, { duration, delta, udid: resolvedUdid });
         }
@@ -350,7 +322,6 @@ export function registerInteractionTools(server) {
                 isError: true
             };
         }
-        // Driver succeeded — run verification.
         const verifyResult = shouldBurst
             ? await burstCaptureAndVerify({
                 platform: resolvedPlatform,
@@ -399,7 +370,193 @@ export function registerInteractionTools(server) {
             _changeRate: verification && !verification.skipped ? verification.changeRate : undefined,
         };
     });
-    // Tool: Android input text
+    registerToolWithTelemetry(server, "pinch", {
+        description: "Pinch-to-zoom using REAL two-finger touch events, with pixel-diff verification. ANDROID EMULATOR ONLY (iOS in progress)." +
+            primaryInteractionBanner() + "\n" +
+            "PURPOSE: Zoom a map, image gallery, photo viewer, or any zoomable surface. pinch({ direction: \"out\" }) zooms in at screen centre; \"in\" zooms out. Pass x/y to zoom around a specific point.\n" +
+            "HOW IT WORKS: Two independent contacts sent through the emulator's multi-touch bridge as real kernel touch events. It works below the app, so it drives React Native, native views, WebViews — anything on screen.\n" +
+            "VERIFICATION: verify=true (default) returns `verification.meaningful` — false means nothing zoomed (not zoomable, already at a zoom limit, or the focal point missed).\n" +
+            "WORKFLOW: pinch({ direction: \"out\" }) -> read verification.meaningful. Take x/y from get_screen_state or a screenshot; no conversion needed.\n" +
+            "IF direction=\"in\" DOES NOTHING: lower `span` (try 0.5). A pinch-in starts with the fingers far apart, so at span 1 they land at the screen extremes where a top bar or bottom sheet can take the gesture.\n" +
+            "LIMITATIONS: Physical Android devices and iOS have no multi-touch channel and return an explicit error, never a partial result. Success means real fingers moved — this never fakes zoom by calling app code.\n",
+        inputSchema: {
+            direction: z
+                .enum(["in", "out"])
+                .optional()
+                .default("out")
+                .describe("\"out\" spreads the fingers apart and zooms IN (default). " +
+                "\"in\" brings them together and zooms OUT."),
+            scale: z.coerce
+                .number()
+                .positive()
+                .optional()
+                .default(3)
+                .describe("How far the fingers travel, as a ratio between their start and end separation. " +
+                "Default 3. Large values are split automatically into several chained gestures."),
+            x: z.coerce
+                .number()
+                .optional()
+                .describe("Focal point X in screenshot pixels — the point the zoom centres on. Default: screen centre."),
+            y: z.coerce
+                .number()
+                .optional()
+                .describe("Focal point Y in screenshot pixels — the point the zoom centres on. Default: screen centre."),
+            angle: z.coerce
+                .number()
+                .optional()
+                .default(0)
+                .describe("Axis the two fingers sit on, in degrees. 0 = horizontal (default), 90 = vertical."),
+            span: z.coerce
+                .number()
+                .min(0.05)
+                .max(1)
+                .optional()
+                .default(1)
+                .describe("How much of the screen the gesture occupies, as a fraction 0-1 (default 1 = as wide as fits). " +
+                "Lower it when direction=\"in\" fails: a pinch-in STARTS with the fingers far apart, so at span 1 " +
+                "they land at the screen extremes and a top bar or bottom sheet can take the gesture instead of " +
+                "the zoomable surface. span 0.5 keeps both contacts near the focal point. Does not change the " +
+                "zoom ratio — that is `scale`."),
+            durationMs: z.coerce
+                .number()
+                .optional()
+                .describe(`Gesture duration in milliseconds (default: ${SWIPE_DEFAULT_DURATION_MS}).`),
+            device: z
+                .string()
+                .optional()
+                .describe("Target device. Accepts (a) an Android adb serial like 'emulator-5554', " +
+                "(b) the emulator name (substring match), or " +
+                "(c) a connected RN app's deviceName (substring match against get_apps output). " +
+                "Omit when exactly one device is available. Call list_devices to enumerate."),
+            verify: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Compare before/after screenshots to detect whether the pinch produced a visual change. " +
+                "Set false to skip. When skipped, the response contains `verification: { skipped: true, skippedReason }`."),
+            screenshot: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Return the post-pinch image bytes in the response. Default true. Set to false to drop the PNG bytes — " +
+                "verification still runs (set verify=false to skip that too)."),
+            burst: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Capture rapid sequential frames after the pinch to catch transient feedback (rubber-band " +
+                "snap-back at a zoom limit) even when the final state is unchanged. Frames land in the image " +
+                "buffer; retrieve with get_images(groupId=verification.burstGroupId)."),
+        }
+    }, async ({ direction, scale, x, y, angle, span, durationMs, device, verify, screenshot, burst }) => {
+        const resolved = await resolveDeviceTarget(device);
+        if (!resolved.ok) {
+            return {
+                content: [{ type: "text", text: `Error: ${formatResolverError(resolved.error)}` }],
+                isError: true
+            };
+        }
+        if (resolved.target.platform !== "android") {
+            return {
+                content: [{
+                        type: "text",
+                        text: "Error: pinch is not available on iOS yet. Multi-touch on the iOS simulator needs an " +
+                            "Indigo HID helper that does not ship in any released idb build; it is planned as a " +
+                            "follow-up. Android emulators are supported today.",
+                    }],
+                isError: true,
+            };
+        }
+        const shouldVerify = verify !== false;
+        const shouldScreenshot = screenshot !== false;
+        const shouldBurst = burst === true;
+        const wantBefore = shouldVerify || shouldBurst || x === undefined || y === undefined;
+        const beforeCapture = wantBefore
+            ? await captureScreenshot("android", undefined)
+            : null;
+        if ((x === undefined || y === undefined) && (!beforeCapture || !beforeCapture.width || !beforeCapture.height)) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "Error: could not read screen dimensions to place the pinch. Pass explicit x and y instead.",
+                    }],
+                isError: true,
+            };
+        }
+        const pinchScaleFactor = beforeCapture?.scaleFactor
+            ?? connectedApps.values().next().value?.lastScreenshot?.scaleFactor
+            ?? 1;
+        const focalScreenshotX = x ?? beforeCapture.width / pinchScaleFactor / 2;
+        const focalScreenshotY = y ?? beforeCapture.height / pinchScaleFactor / 2;
+        const focal = convertScreenshotToTapCoords(focalScreenshotX, focalScreenshotY, "android", 1, pinchScaleFactor);
+        const driverResult = await androidPinch({
+            focalX: focal.x,
+            focalY: focal.y,
+            direction: (direction ?? "out"),
+            scale: scale ?? 3,
+            angleDeg: angle ?? 0,
+            durationMs: durationMs ?? SWIPE_DEFAULT_DURATION_MS,
+            span: span ?? 1,
+            serial: resolved.target.androidSerial,
+        });
+        if (!driverResult.success) {
+            return {
+                content: [{ type: "text", text: `Error: ${driverResult.error}` }],
+                isError: true
+            };
+        }
+        const verifyResult = shouldBurst
+            ? await burstCaptureAndVerify({
+                platform: "android",
+                beforeBuffer: beforeCapture?.buffer ?? null,
+                udid: undefined,
+                beforeScaleFactor: beforeCapture?.scaleFactor,
+                source: "pinch-burst",
+            })
+            : await verifyAndCapture({
+                platform: "android",
+                shouldVerify,
+                shouldScreenshot,
+                beforeBuffer: beforeCapture?.buffer ?? null,
+                udid: undefined,
+                beforeScaleFactor: beforeCapture?.scaleFactor,
+                source: "pinch-verify",
+            });
+        const { screenshot: screenshotData, verification } = verifyResult;
+        const warning = verification && !verification.skipped && verification.meaningful === false
+            ? "Pinch executed but no visual change detected — the surface may not be zoomable, may already be at its zoom limit, or the focal point may have missed the zoomable view. Inspect the screenshot and retry with a different focal point if needed."
+            : undefined;
+        const responseBody = {
+            success: true,
+            platform: "android",
+            direction: direction ?? "out",
+            focal: { x: focalScreenshotX, y: focalScreenshotY },
+            span: span ?? 1,
+            separation: { start: driverResult.startHalf, end: driverResult.endHalf },
+            gestureCount: driverResult.gestureCount,
+            frameCount: driverResult.frameCount,
+            driverMessage: driverResult.result,
+            ...(verification && { verification }),
+            ...(warning && { warning }),
+            deviceNote: resolved.note,
+        };
+        const content = [
+            { type: "text", text: JSON.stringify(responseBody, null, 2) },
+        ];
+        if (shouldScreenshot && screenshotData) {
+            content.push({
+                type: "image",
+                data: screenshotData.image,
+                mimeType: "image/jpeg",
+            });
+        }
+        return {
+            content,
+            isError: false,
+            _meaningful: verification && !verification.skipped ? verification.meaningful : undefined,
+            _changeRate: verification && !verification.skipped ? verification.changeRate : undefined,
+        };
+    });
     registerToolWithTelemetry(server, "android_input_text", {
         description: "Type text on an Android device/emulator." +
             platformFallbackBanner("`input_text` — it targets, focuses, writes and verifies in one call") +
@@ -438,7 +595,6 @@ export function registerInteractionTools(server) {
             isError: !result.success
         };
     });
-    // Tool: Android key event
     registerToolWithTelemetry(server, "android_key_event", {
         description: "Send a key event to an Android device/emulator." +
             platformUniqueBanner("sending Android key events (BACK, HOME, MENU, etc.)") +
@@ -453,7 +609,6 @@ export function registerInteractionTools(server) {
                 .describe(ANDROID_ARG_DESC)
         }
     }, async ({ key, deviceId }) => {
-        // Try to parse as number first, otherwise treat as key name
         const keyCode = /^\d+$/.test(key) ? parseInt(key, 10) : key.toUpperCase();
         const r = await resolveAndroidDeviceId(deviceId);
         if (!r.ok)
@@ -469,19 +624,6 @@ export function registerInteractionTools(server) {
             isError: !result.success
         };
     });
-    // ============================================================================
-    // Android Accessibility Tools (UI Hierarchy)
-    // ============================================================================
-    // ============================================================================
-    // iOS Simulator Tools
-    // ============================================================================
-    // Tool: iOS install app
-    // ============================================================================
-    // iOS UI Interaction Tools (require an iOS UI driver)
-    // Default: AXe — brew install cameroncooke/axe/axe
-    // Alternative: IDB — brew install idb-companion (set IOS_DRIVER=idb)
-    // ============================================================================
-    // Tool: iOS button
     server.registerTool("ios_button", {
         description: "Press a hardware button on an iOS simulator." +
             platformUniqueBanner("pressing iOS hardware buttons (HOME, LOCK, SIRI, APPLE_PAY)") +
@@ -510,8 +652,6 @@ export function registerInteractionTools(server) {
             isError: !result.success
         };
     });
-    // Tool: Clear focused text input
-    // Tool: Dismiss keyboard
     registerToolWithTelemetry(server, "dismiss_keyboard", {
         description: "Blur the currently focused TextInput, dismissing the on-screen keyboard." +
             "\nPURPOSE: Close the keyboard when it's blocking content beneath the input, or move focus off an input before a tap that would otherwise be intercepted." +
@@ -538,7 +678,6 @@ export function registerInteractionTools(server) {
             isError: !result.success
         };
     });
-    // Tool: iOS input text
     registerToolWithTelemetry(server, "ios_input_text", {
         description: "Type text on an iOS simulator." +
             platformFallbackBanner("`input_text` — it targets, focuses, writes and verifies in one call") +
@@ -574,7 +713,6 @@ export function registerInteractionTools(server) {
             isError: !result.success
         };
     });
-    // Tool: cross-platform text entry
     registerToolWithTelemetry(server, "input_text", {
         description: "Write text into a React Native TextInput and verify it landed." +
             primaryInteractionBanner() +
@@ -632,11 +770,6 @@ export function registerInteractionTools(server) {
         return formatTextEntryResponse(result);
     });
 }
-/**
- * Renders a text-entry outcome. Two rules carry the whole design:
- * an unverified write must never read as a plain success, and a failed
- * keyboard raise must never read as a failed write.
- */
 export function formatTextEntryResponse(r) {
     const lines = [];
     if (r.success) {
@@ -651,8 +784,6 @@ export function formatTextEntryResponse(r) {
         if (r.landed !== undefined)
             lines.push(`  landed: ${JSON.stringify(r.landed)}`);
         if (r.candidates?.length) {
-            // Never let a capped list read as the complete picture — that is how
-            // a caller concludes its field is absent when it is past the cut.
             const hidden = !r.ambiguous && r.totalInputs !== undefined && r.totalInputs > r.candidates.length
                 ? ` (showing ${r.candidates.length} of ${r.totalInputs})`
                 : "";