react-native-ai-debugger 1.5.2 → 1.6.0

package/build/__tests__/unit/toolDescriptions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toolDescriptions.test.d.ts.map

package/build/__tests__/unit/toolDescriptions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDescriptions.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/toolDescriptions.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/toolDescriptions.test.js

@@ -0,0 +1,145 @@
+// Commit 6 of the MCP Tool Discoverability Rework — regression test that keeps
+// every registered tool description above the bar set by Commits 2–5. Guards
+// against silent regressions back to one-liners and against typos in WORKFLOW /
+// SEE ALSO / PRIMARY / HELPER cross-references that would silently mislead
+// agents to call tools that don't exist.
+//
+// See: docs/improvements/mcp-tool-discoverability-rework.md
+// IMPORTANT: set test mode BEFORE importing src/index.ts so main() is skipped
+// (no license check, no transport, no HTTP listener, no CDP sockets).
+process.env.RN_AI_DEVTOOLS_TEST_MODE = "1";
+import { describe, it, expect } from "@jest/globals";
+import { toolRegistry } from "../../index.js";
+// Tools exempt from the "must contain PURPOSE or WHEN TO USE" and minimum-length
+// checks. These are meta/account/admin tools where a short description reads
+// naturally and adding a PURPOSE line would be boilerplate. execute_in_app uses
+// semantically equivalent headings (RECOMMENDED WORKFLOW / LIMITATIONS / GOOD
+// examples / BAD examples) instead of PURPOSE / WHEN TO USE — see plan.
+const SEMANTIC_ALLOWLIST = new Set([
+    "get_usage_guide",
+    "activate_license",
+    "get_license_status",
+    "delete_account",
+    "send_feedback",
+    "reset_telemetry",
+    "execute_in_app",
+    "dev",
+]);
+// Non-tool identifiers that appear in descriptions (prop names, JS globals,
+// schema keys, natural-language nouns that happen to match the tool-name
+// regex). If the cross-reference scan hits one of these it's a false positive,
+// not a broken link. Keep this list conservative — every addition weakens the
+// guarantee, so prefer tightening the extractor over growing this set.
+const NON_TOOL_TOKENS = new Set([
+    // JS built-ins and common API shapes
+    "true", "false", "null", "undefined", "console", "log", "error", "warn",
+    "fetch", "require", "async", "await", "function", "return", "new",
+    "typeof", "instanceof", "string", "number", "boolean", "object", "array",
+    "map", "set", "promise", "date", "json", "regexp", "math",
+    // Common param / prop names used in example tool calls
+    "text", "query", "component", "pattern", "componentname", "testid",
+    "x", "y", "verbose", "device", "deviceid", "udid", "packagename",
+    "bundleid", "url", "uri", "method", "status", "level", "limit",
+    "offset", "depth", "maxdepth", "timeout", "force", "forcerefresh",
+    "healthcheck", "native", "strategy", "burst", "screenshot", "verify",
+    "frameindex", "groupid", "id", "structureonly", "extended", "topic",
+    "action", "tool", "args", "mode", "format", "type", "name", "value",
+    "key", "keycode", "buttons", "headers", "body", "response", "request",
+    "params", "args", "input", "output", "result", "data", "payload",
+    // DSL / English verbs that match the regex in practice
+    "e", "i", "s", "n", "t", "b", "a", "it", "is", "to", "of", "in", "on",
+    "at", "by", "or", "and", "not", "use", "see", "call", "get", "set",
+    "for", "via", "the", "its", "has", "all", "any", "ids", "file",
+    // Schema / MCP things
+    "isolated_vm", "isolated", "vm", "hermes", "jsc", "metro", "rn",
+    "ios", "android", "cdp", "sdk", "ui", "ocr",
+    // Verb-ish tokens used before "(" in English prose
+    "returns", "includes", "uses", "uses_", "works", "tries", "prefers",
+    "matches", "triggers", "scans", "parses", "reads", "writes", "sends",
+    "sets", "gets", "checks", "detects", "enables", "disables", "skips",
+    "supports", "handles", "captures", "adds", "removes", "runs", "is",
+    "becomes", "executes", "fires", "emits", "wakes",
+    "e.g", "i.e", "eg", "ie",
+    // Connector words used in "prefer <word>" matches that aren't tool names
+    "the", "this", "that", "these", "those",
+    // Method-style identifiers appearing as examples
+    "measureinwindow", "onpress", "onchangetext", "onfocus",
+]);
+describe("Tool descriptions (registration enforcement)", () => {
+    const tools = Array.from(toolRegistry.entries()).map(([name, { config }]) => ({
+        name,
+        description: String(config?.description ?? ""),
+    }));
+    it("registers a non-trivial number of tools", () => {
+        // Current count is ~60-70; a big drop would almost certainly be a bug.
+        expect(tools.length).toBeGreaterThan(30);
+    });
+    describe("each tool has a rich description", () => {
+        it.each(tools.map((t) => [t.name, t]))("%s", (_name, tool) => {
+            const { name, description } = tool;
+            expect(description.length).toBeGreaterThan(0);
+            expect(description.length).toBeLessThanOrEqual(1500);
+            if (!SEMANTIC_ALLOWLIST.has(name)) {
+                // Minimum length protects against regressions to one-liners.
+                expect(description.length).toBeGreaterThanOrEqual(120);
+                // Must contain a PURPOSE or WHEN TO USE anchor so the agent
+                // can scan for intent before reading the whole description.
+                const hasPurposeAnchor = description.includes("PURPOSE") || description.includes("WHEN TO USE");
+                expect(hasPurposeAnchor).toBe(true);
+            }
+        });
+    });
+    it("cross-references only point to registered tool names", () => {
+        const registered = new Set(tools.map((t) => t.name));
+        // Lines whose trailing content is a comma/space separated list of tool
+        // names. These are the high-signal structured lines from the template.
+        const ANCHOR_RE = /^(WORKFLOW|SEE ALSO|PRIMARY|HELPER|PLATFORM FALLBACK|PREFER|PREFERRED)\s*[:=-]/i;
+        const unknown = [];
+        for (const { name, description } of tools) {
+            for (const rawLine of description.split(/\r?\n/)) {
+                const line = rawLine.trim();
+                if (!ANCHOR_RE.test(line))
+                    continue;
+                // Extract backtick-quoted identifiers and bare `name(` forms.
+                const tokens = new Set();
+                for (const m of line.matchAll(/`([a-z_][a-z0-9_]+)`/gi))
+                    tokens.add(m[1]);
+                for (const m of line.matchAll(/([a-z_][a-z0-9_]+)\s*\(/gi))
+                    tokens.add(m[1]);
+                for (const token of tokens) {
+                    const lower = token.toLowerCase();
+                    if (registered.has(token))
+                        continue;
+                    if (NON_TOOL_TOKENS.has(lower))
+                        continue;
+                    // Heuristic: must look like a tool name (snake_case with an
+                    // underscore or a known cross-platform primary). Single
+                    // words like "prefer" are filtered out here.
+                    if (!token.includes("_") && !registered.has(token)) {
+                        // Could still be "tap" / "logbox" etc — only flag if
+                        // it's also not a registered name.
+                        if (!registered.has(token))
+                            continue;
+                    }
+                    unknown.push({ tool: name, token, line });
+                }
+            }
+        }
+        if (unknown.length > 0) {
+            const msg = unknown
+                .map((u) => `  ${u.tool}: unknown "${u.token}" in "${u.line}"`)
+                .join("\n");
+            throw new Error(`Cross-reference check failed — the following tokens look like tool names in structured lines but are not registered:\n${msg}`);
+        }
+    });
+    it("logs total tools/list payload size (informational)", () => {
+        const totalBytes = tools
+            .map((t) => JSON.stringify({ name: t.name, description: t.description }).length)
+            .reduce((a, b) => a + b, 0);
+        // eslint-disable-next-line no-console
+        console.log(`[tool-descriptions] total tools/list payload: ${totalBytes} bytes across ${tools.length} tools`);
+        // Sanity upper bound — not a strict cap, just to catch runaway growth.
+        expect(totalBytes).toBeLessThan(500_000);
+    });
+});
+//# sourceMappingURL=toolDescriptions.test.js.map

package/build/__tests__/unit/toolDescriptions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDescriptions.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/toolDescriptions.test.ts"],"names":[],"mappings":"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"}

package/build/core/guides.d.ts

@@ -8,6 +8,13 @@ export interface Guide {
     summary: string;
     content: string;
 }
+/**
+ * Shared quick decision tree body — embedded into the MCP server-level
+ * `instructions` field (src/index.ts) AND into `getGuideOverview()` so agents
+ * see identical guidance regardless of whether their client surfaces
+ * `instructions`. Keep this as the single source of truth.
+ */
+export declare const DECISION_TREE: string;
 export declare function getGuideOverview(): string;
 export declare function getGuideByTopic(topic: string): string | null;
 export declare function getAvailableTopics(): string[];

package/build/core/guides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guides.d.ts","sourceRoot":"","sources":["../../src/core/guides.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,KAAK;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAgTD,wBAAgB,gBAAgB,IAAI,MAAM,CAUzC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}
+{"version":3,"file":"guides.d.ts","sourceRoot":"","sources":["../../src/core/guides.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,KAAK;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AA+SD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAchB,CAAC;AAEb,wBAAgB,gBAAgB,IAAI,MAAM,CAWzC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/build/core/guides.js

@@ -10,7 +10,7 @@ const guides = [
         content: `# Session Setup
 
 ## Prerequisites (CRITICAL — install BEFORE using device tools)
-- **iOS UI driver (required for tap, swipe, describe, find_element, and all iOS interaction tools):**
+- **iOS UI driver (required for tap, ios_button, and all iOS interaction tools):**
   - Recommended: AXe — brew install cameroncooke/axe/axe (then set IOS_DRIVER=axe in MCP server env)
   - Alternative: IDB — brew install idb-companion (used by default)
   - Without a UI driver, most iOS tools will fail with "not installed" errors
@@ -105,7 +105,7 @@ const guides = [
         content: `# Device Interaction
 
 ## Prerequisites
-iOS interaction tools (tap, ios_swipe, ios_input_text, ios_button, ios_describe_all, ios_find_element, ios_wait_for_element) require a UI driver:
+iOS interaction tools (tap, ios_button) require a UI driver:
 - Recommended: AXe — brew install cameroncooke/axe/axe (set IOS_DRIVER=axe in MCP server env)
 - Alternative: IDB — brew install idb-companion (default)
 Without a UI driver installed, these tools will fail.
@@ -140,13 +140,12 @@ For buttons that contain only an icon (no text):
 tap(text=...) skips fiber for non-ASCII (Hermes limitation) and uses accessibility/OCR instead. For best results, use testID or coordinates.
 
 ## Other Interactions
-- ios_swipe / android_swipe: swipe/scroll with start/end coordinates
-- ios_input_text / android_input_text: type text (tap input field first)
+- android_swipe: swipe/scroll with start/end coordinates
+- android_input_text: type text (tap input field first; on iOS use tap(testID=...) to focus, then native keyboard)
 - ios_button / android_key_event: hardware buttons (HOME, BACK, etc.)
 - ios_open_url: deep links and universal links
 
 ## After Interactions
-- ios_wait_for_element / android_wait_for_element: wait for UI to update
 - Take a screenshot to verify the result`
     },
     {
@@ -303,14 +302,38 @@ If the user wants to share feedback, request a feature, or report a problem with
 - No GitHub account setup or CLI tools needed — just a browser`
     }
 ];
+/**
+ * Shared quick decision tree body — embedded into the MCP server-level
+ * `instructions` field (src/index.ts) AND into `getGuideOverview()` so agents
+ * see identical guidance regardless of whether their client surfaces
+ * `instructions`. Keep this as the single source of truth.
+ */
+export const DECISION_TREE = [
+    "Primary tools: scan_metro, get_logs / search_logs, ios_screenshot / android_screenshot, tap, get_pressable_elements, get_screen_layout.",
+    "Platform-specific ios_* / android_* tools (ios_button, android_swipe, android_input_text, android_key_event, android_long_press, ios_open_url, etc.) are FALLBACKS for non-React or native-only flows — prefer the cross-platform primary tools above whenever possible.",
+    "",
+    "Call get_usage_guide(topic=...) for end-to-end workflows. Available topics:",
+    "  setup     — session setup (scan_metro, connect_metro, ensure_connection)",
+    "  logs      — console debugging (get_logs, search_logs)",
+    "  interact  — device interaction (tap, android_swipe, screenshots, android_input_text)",
+    "  layout    — on-screen layout check (get_screen_layout, get_pressable_elements)",
+    "  inspect   — component inspection (find_components, inspect_component, get_inspector_selection)",
+    "  network   — network request inspection (get_network_requests, search_network)",
+    "  state     — app state & JS execution (execute_in_app, list_debug_globals)",
+    "  bundle    — bundle / Metro error checks (get_bundle_status, get_bundle_errors)",
+    "  feedback  — share feedback, feature requests, or bug reports (send_feedback)"
+].join("\n");
 export function getGuideOverview() {
-    const lines = ["Available usage guides:\n"];
-    for (const guide of guides) {
-        lines.push(`  ${guide.id} — ${guide.summary}`);
-    }
-    lines.push("\nCall get_usage_guide with a topic parameter for the full guide.");
-    lines.push("\nQuick start: scan_metro → get_logs / search_logs (console debugging) → ios_screenshot → get_inspector_selection(x, y) (identify components)");
-    return lines.join("\n");
+    const guideList = guides.map((g) => `  ${g.id} — ${g.summary}`).join("\n");
+    return `Quick decision tree
+-------------------
+${DECISION_TREE}
+
+Available usage guides:
+
+${guideList}
+
+Call get_usage_guide with a topic parameter for the full guide.`;
 }
 export function getGuideByTopic(topic) {
     const guide = guides.find((g) => g.id === topic.toLowerCase());

package/build/core/guides.js.map

@@ -1 +1 @@
-{"version":3,"file":"guides.js","sourceRoot":"","sources":["../../src/core/guides.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,MAAM,GAAY;IACpB;QACI,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,yDAAyD;QAClE,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CA8B8B;KAC1C;IACD;QACI,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,mFAAmF;QAC5F,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;iGAoBgF;KAC5F;IACD;QACI,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE,0EAA0E;QACnF,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;4DA2B2C;KACvD;IACD;QACI,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,wDAAwD;QACjE,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCA6CwB;KACpC;IACD;QACI,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,8DAA8D;QACvE,OAAO,EAAE;;;;;;;;;;;;;;;;;;2DAkB0C;KACtD;IACD;QACI,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,oEAAoE;QAC7E,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0FAuCyE;KACrF;IACD;QACI,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,0EAA0E;QACnF,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;kEAsBiD;KAC7D;IACD;QACI,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,oEAAoE;QAC7E,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;6DAwB4C;KACxD;IACD;QACI,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,0EAA0E;QACnF,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;+DAoB8C;KAC1D;CACJ,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC5B,MAAM,KAAK,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CACN,+IAA+I,CAClJ,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,OAAO,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAC9B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"guides.js","sourceRoot":"","sources":["../../src/core/guides.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,MAAM,GAAY;IACpB;QACI,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,yDAAyD;QAClE,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CA8B8B;KAC1C;IACD;QACI,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,mFAAmF;QAC5F,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;iGAoBgF;KAC5F;IACD;QACI,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE,0EAA0E;QACnF,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;4DA2B2C;KACvD;IACD;QACI,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,wDAAwD;QACjE,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCA4CwB;KACpC;IACD;QACI,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,8DAA8D;QACvE,OAAO,EAAE;;;;;;;;;;;;;;;;;;2DAkB0C;KACtD;IACD;QACI,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,oEAAoE;QAC7E,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0FAuCyE;KACrF;IACD;QACI,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,0EAA0E;QACnF,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;kEAsBiD;KAC7D;IACD;QACI,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,oEAAoE;QAC7E,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;6DAwB4C;KACxD;IACD;QACI,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,0EAA0E;QACnF,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;+DAoB8C;KAC1D;CACJ,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACjC,yIAAyI;IACzI,0QAA0Q;IAC1Q,EAAE;IACF,6EAA6E;IAC7E,4EAA4E;IAC5E,yDAAyD;IACzD,wFAAwF;IACxF,kFAAkF;IAClF,kGAAkG;IAClG,iFAAiF;IACjF,6EAA6E;IAC7E,kFAAkF;IAClF,gFAAgF;CACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,gBAAgB;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO;;EAET,aAAa;;;;EAIb,SAAS;;gEAEqD,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,OAAO,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAC9B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/build/core/nativeOnlyHints.js

@@ -23,8 +23,8 @@ const NATIVE_FALLBACKS = {
     search_network: [],
     get_network_stats: [],
     get_request_details: [],
-    get_screen_layout: ["ios_describe_all", "android_describe_all"],
-    get_inspector_selection: ["ios_describe_point", "android_describe_point"],
+    get_screen_layout: [],
+    get_inspector_selection: [],
 };
 export function buildMetroMissingHint({ toolName, devices }) {
     const fallbacks = NATIVE_FALLBACKS[toolName] ?? [];

package/build/core/nativeOnlyHints.js.map

@@ -1 +1 @@
-{"version":3,"file":"nativeOnlyHints.js","sourceRoot":"","sources":["../../src/core/nativeOnlyHints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,UAAU,QAAQ;IACpB,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC;AAClC,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACrC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/C,8BAA8B,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAClD,uBAAuB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;KAC9C,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;IACtB,MAAM,OAAO,GAAG,CAAC,CAAC,aAAa,CAAC;IAChC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,4DAA4D;AAC5D,8DAA8D;AAC9D,MAAM,gBAAgB,GAA6B;IAC/C,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,EAAE;IACd,oBAAoB,EAAE,EAAE;IACxB,cAAc,EAAE,EAAE;IAClB,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,EAAE;IACvB,iBAAiB,EAAE,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;IAC/D,uBAAuB,EAAE,CAAC,oBAAoB,EAAE,wBAAwB,CAAC;CAC5E,CAAC;AAOF,MAAM,UAAU,qBAAqB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAA2B;IAChF,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IAExG,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;QACf,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,GAAG;YAAE,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,OAAO;YAAE,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,YAAY,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,uGAAuG,CAAC,CAAC;IAC7J,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IAC5G,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,6CAA6C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,6GAA6G,CAAC,CAAC;IAC1H,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,qFAAqF;AACrF,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,QAAgB;IAC3D,IAAI,QAAQ,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC5C,OAAO,MAAM,GAAG,qBAAqB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC"}
+{"version":3,"file":"nativeOnlyHints.js","sourceRoot":"","sources":["../../src/core/nativeOnlyHints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,UAAU,QAAQ;IACpB,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC;AAClC,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACrC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/C,8BAA8B,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAClD,uBAAuB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;KAC9C,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;IACtB,MAAM,OAAO,GAAG,CAAC,CAAC,aAAa,CAAC;IAChC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,4DAA4D;AAC5D,8DAA8D;AAC9D,MAAM,gBAAgB,GAA6B;IAC/C,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,EAAE;IACd,oBAAoB,EAAE,EAAE;IACxB,cAAc,EAAE,EAAE;IAClB,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,EAAE;IACvB,iBAAiB,EAAE,EAAE;IACrB,uBAAuB,EAAE,EAAE;CAC9B,CAAC;AAOF,MAAM,UAAU,qBAAqB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAA2B;IAChF,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IAExG,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;QACf,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,GAAG;YAAE,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,OAAO;YAAE,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,YAAY,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,uGAAuG,CAAC,CAAC;IAC7J,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IAC5G,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,6CAA6C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,6GAA6G,CAAC,CAAC;IAC1H,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,qFAAqF;AACrF,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,QAAgB;IAC3D,IAAI,QAAQ,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC5C,OAAO,MAAM,GAAG,qBAAqB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/build/index.d.ts

@@ -1,3 +1,6 @@
 #!/usr/bin/env node
-export {};
+export declare const toolRegistry: Map<string, {
+    config: any;
+    handler: (args: any) => Promise<any>;
+}>;
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAmUA,eAAO,MAAM,YAAY;YAA6B,GAAG;aAAW,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC;EAAK,CAAC"}