@metamask/device-mcp 0.2.0 → 0.3.1

package/dist/tools/hermes-cdp.cjs

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHermesCdpTool = registerHermesCdpTool;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.cjs");
+const hermes_cdp_js_1 = require("../hermes/hermes-cdp.cjs");
+const session_js_1 = require("../hermes/session.cjs");
+const DEFAULT_TIMEOUT_MS = 30000;
+const MIN_TIMEOUT_MS = 1000;
+const MAX_TIMEOUT_MS = 120000;
+/**
+ * Registers the `hermes_cdp` MCP tool, which speaks raw Chrome DevTools
+ * Protocol (CDP) to the React Native Hermes runtime of a running app via
+ * Metro's inspector proxy (iOS and Android).
+ *
+ * The handler is intentionally THIN: it resolves the Metro port/appId and the
+ * current device pin from {@link getHermesSession}, delegates ALL discovery,
+ * verification, and execution logic to {@link runHermesCdp}, and persists the
+ * resolved pin via the core's `onPin` callback.
+ *
+ * @param server - The MCP server to register the tool on.
+ * @param backend - The lazy device backend, used at call time only to read the
+ * live platform so the session can resolve the correct default app bundle ID.
+ */
+function registerHermesCdpTool(server, backend) {
+    server.registerTool('hermes_cdp', {
+        title: 'Hermes CDP',
+        description: 'Speak raw Chrome DevTools Protocol (CDP) to the React Native Hermes ' +
+            'JS runtime of a running app via Metro\u2019s inspector proxy (iOS and ' +
+            'Android). Requires a DEBUG build with Metro running; release builds ' +
+            'expose no inspector. Blocked methods (for safety): ' +
+            'Runtime.terminateExecution, Inspector.detached. Node 20 must be ' +
+            'launched with NODE_OPTIONS="--experimental-websocket" (Node 22+ works ' +
+            'out of the box). Example: method "Runtime.evaluate" with params ' +
+            '{"expression":"1+1","returnByValue":true} \u2014 the raw response nests ' +
+            'the value at result.result.value.',
+        inputSchema: {
+            method: zod_1.z
+                .string()
+                .describe('The CDP method to invoke, e.g. "Runtime.evaluate".'),
+            params: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.unknown())
+                .optional()
+                .describe('Optional CDP method parameters.'),
+            timeoutMs: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe(`Timeout in milliseconds applied to each phase independently: ` +
+                `discovery, socket open, identity probe, and the CDP call ` +
+                `(default ${DEFAULT_TIMEOUT_MS}, floored to ${MIN_TIMEOUT_MS}, max ${MAX_TIMEOUT_MS}).`),
+            metroPort: zod_1.z
+                .number()
+                .optional()
+                .describe('Override the Metro inspector proxy port for this call.'),
+            appId: zod_1.z
+                .string()
+                .optional()
+                .describe('Override the expected app bundle identifier.'),
+        },
+    }, async ({ method, params, timeoutMs, metroPort, appId }) => {
+        try {
+            const session = (0, session_js_1.getHermesSession)();
+            const resolved = session.resolve({
+                metroPort,
+                appId,
+                platform: backend.platform,
+            });
+            const clampedTimeoutMs = Math.min(Math.max(timeoutMs ?? DEFAULT_TIMEOUT_MS, MIN_TIMEOUT_MS), MAX_TIMEOUT_MS);
+            const result = await (0, hermes_cdp_js_1.runHermesCdp)({
+                method,
+                params,
+                timeoutMs: clampedTimeoutMs,
+                metroPort: resolved.metroPort,
+                appId: resolved.appId,
+                pinnedDeviceId: resolved.pinnedDeviceId,
+                onPin: (id) => {
+                    const currentPin = session.getPinnedHermesDeviceId();
+                    if (currentPin === undefined) {
+                        session.setPinnedHermesDeviceId(id);
+                    }
+                },
+            });
+            if (!result.ok) {
+                return (0, shared_js_1.errorResult)(new Error(`[${result.code}] ${result.message}`));
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result.result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return (0, shared_js_1.errorResult)(error);
+        }
+    });
+}
+//# sourceMappingURL=hermes-cdp.cjs.map

package/dist/tools/hermes-cdp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-cdp.cjs","sourceRoot":"","sources":["../../src/tools/hermes-cdp.ts"],"names":[],"mappings":"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","sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\nimport { errorResult } from './shared.js';\nimport type { DeviceBackend } from '../backends/types.js';\nimport { runHermesCdp } from '../hermes/hermes-cdp.js';\nimport { getHermesSession } from '../hermes/session.js';\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst MIN_TIMEOUT_MS = 1_000;\nconst MAX_TIMEOUT_MS = 120_000;\n\n/**\n * Registers the `hermes_cdp` MCP tool, which speaks raw Chrome DevTools\n * Protocol (CDP) to the React Native Hermes runtime of a running app via\n * Metro's inspector proxy (iOS and Android).\n *\n * The handler is intentionally THIN: it resolves the Metro port/appId and the\n * current device pin from {@link getHermesSession}, delegates ALL discovery,\n * verification, and execution logic to {@link runHermesCdp}, and persists the\n * resolved pin via the core's `onPin` callback.\n *\n * @param server - The MCP server to register the tool on.\n * @param backend - The lazy device backend, used at call time only to read the\n * live platform so the session can resolve the correct default app bundle ID.\n */\nexport function registerHermesCdpTool(\n  server: McpServer,\n  backend: DeviceBackend,\n): void {\n  server.registerTool(\n    'hermes_cdp',\n    {\n      title: 'Hermes CDP',\n      description:\n        'Speak raw Chrome DevTools Protocol (CDP) to the React Native Hermes ' +\n        'JS runtime of a running app via Metro\\u2019s inspector proxy (iOS and ' +\n        'Android). Requires a DEBUG build with Metro running; release builds ' +\n        'expose no inspector. Blocked methods (for safety): ' +\n        'Runtime.terminateExecution, Inspector.detached. Node 20 must be ' +\n        'launched with NODE_OPTIONS=\"--experimental-websocket\" (Node 22+ works ' +\n        'out of the box). Example: method \"Runtime.evaluate\" with params ' +\n        '{\"expression\":\"1+1\",\"returnByValue\":true} \\u2014 the raw response nests ' +\n        'the value at result.result.value.',\n      inputSchema: {\n        method: z\n          .string()\n          .describe('The CDP method to invoke, e.g. \"Runtime.evaluate\".'),\n        params: z\n          .record(z.string(), z.unknown())\n          .optional()\n          .describe('Optional CDP method parameters.'),\n        timeoutMs: z\n          .number()\n          .int()\n          .positive()\n          .optional()\n          .describe(\n            `Timeout in milliseconds applied to each phase independently: ` +\n              `discovery, socket open, identity probe, and the CDP call ` +\n              `(default ${DEFAULT_TIMEOUT_MS}, floored to ${MIN_TIMEOUT_MS}, max ${MAX_TIMEOUT_MS}).`,\n          ),\n        metroPort: z\n          .number()\n          .optional()\n          .describe('Override the Metro inspector proxy port for this call.'),\n        appId: z\n          .string()\n          .optional()\n          .describe('Override the expected app bundle identifier.'),\n      },\n    },\n    async ({ method, params, timeoutMs, metroPort, appId }) => {\n      try {\n        const session = getHermesSession();\n        const resolved = session.resolve({\n          metroPort,\n          appId,\n          platform: backend.platform,\n        });\n        const clampedTimeoutMs = Math.min(\n          Math.max(timeoutMs ?? DEFAULT_TIMEOUT_MS, MIN_TIMEOUT_MS),\n          MAX_TIMEOUT_MS,\n        );\n\n        const result = await runHermesCdp({\n          method,\n          params,\n          timeoutMs: clampedTimeoutMs,\n          metroPort: resolved.metroPort,\n          appId: resolved.appId,\n          pinnedDeviceId: resolved.pinnedDeviceId,\n          onPin: (id) => {\n            const currentPin = session.getPinnedHermesDeviceId();\n            if (currentPin === undefined) {\n              session.setPinnedHermesDeviceId(id);\n            }\n          },\n        });\n\n        if (!result.ok) {\n          return errorResult(new Error(`[${result.code}] ${result.message}`));\n        }\n\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: JSON.stringify(result.result, null, 2),\n            },\n          ],\n        };\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n}\n"]}

package/dist/tools/hermes-cdp.d.cts

@@ -0,0 +1,18 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DeviceBackend } from "../backends/types.cjs";
+/**
+ * Registers the `hermes_cdp` MCP tool, which speaks raw Chrome DevTools
+ * Protocol (CDP) to the React Native Hermes runtime of a running app via
+ * Metro's inspector proxy (iOS and Android).
+ *
+ * The handler is intentionally THIN: it resolves the Metro port/appId and the
+ * current device pin from {@link getHermesSession}, delegates ALL discovery,
+ * verification, and execution logic to {@link runHermesCdp}, and persists the
+ * resolved pin via the core's `onPin` callback.
+ *
+ * @param server - The MCP server to register the tool on.
+ * @param backend - The lazy device backend, used at call time only to read the
+ * live platform so the session can resolve the correct default app bundle ID.
+ */
+export declare function registerHermesCdpTool(server: McpServer, backend: DeviceBackend): void;
+//# sourceMappingURL=hermes-cdp.d.cts.map

package/dist/tools/hermes-cdp.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-cdp.d.cts","sourceRoot":"","sources":["../../src/tools/hermes-cdp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gDAAgD;AAIzE,OAAO,KAAK,EAAE,aAAa,EAAE,8BAA6B;AAQ1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,aAAa,GACrB,IAAI,CAwFN"}

package/dist/tools/hermes-cdp.d.mts

@@ -0,0 +1,18 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DeviceBackend } from "../backends/types.mjs";
+/**
+ * Registers the `hermes_cdp` MCP tool, which speaks raw Chrome DevTools
+ * Protocol (CDP) to the React Native Hermes runtime of a running app via
+ * Metro's inspector proxy (iOS and Android).
+ *
+ * The handler is intentionally THIN: it resolves the Metro port/appId and the
+ * current device pin from {@link getHermesSession}, delegates ALL discovery,
+ * verification, and execution logic to {@link runHermesCdp}, and persists the
+ * resolved pin via the core's `onPin` callback.
+ *
+ * @param server - The MCP server to register the tool on.
+ * @param backend - The lazy device backend, used at call time only to read the
+ * live platform so the session can resolve the correct default app bundle ID.
+ */
+export declare function registerHermesCdpTool(server: McpServer, backend: DeviceBackend): void;
+//# sourceMappingURL=hermes-cdp.d.mts.map

package/dist/tools/hermes-cdp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-cdp.d.mts","sourceRoot":"","sources":["../../src/tools/hermes-cdp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gDAAgD;AAIzE,OAAO,KAAK,EAAE,aAAa,EAAE,8BAA6B;AAQ1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,aAAa,GACrB,IAAI,CAwFN"}

package/dist/tools/hermes-cdp.mjs

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { errorResult } from "./shared.mjs";
+import { runHermesCdp } from "../hermes/hermes-cdp.mjs";
+import { getHermesSession } from "../hermes/session.mjs";
+const DEFAULT_TIMEOUT_MS = 30000;
+const MIN_TIMEOUT_MS = 1000;
+const MAX_TIMEOUT_MS = 120000;
+/**
+ * Registers the `hermes_cdp` MCP tool, which speaks raw Chrome DevTools
+ * Protocol (CDP) to the React Native Hermes runtime of a running app via
+ * Metro's inspector proxy (iOS and Android).
+ *
+ * The handler is intentionally THIN: it resolves the Metro port/appId and the
+ * current device pin from {@link getHermesSession}, delegates ALL discovery,
+ * verification, and execution logic to {@link runHermesCdp}, and persists the
+ * resolved pin via the core's `onPin` callback.
+ *
+ * @param server - The MCP server to register the tool on.
+ * @param backend - The lazy device backend, used at call time only to read the
+ * live platform so the session can resolve the correct default app bundle ID.
+ */
+export function registerHermesCdpTool(server, backend) {
+    server.registerTool('hermes_cdp', {
+        title: 'Hermes CDP',
+        description: 'Speak raw Chrome DevTools Protocol (CDP) to the React Native Hermes ' +
+            'JS runtime of a running app via Metro\u2019s inspector proxy (iOS and ' +
+            'Android). Requires a DEBUG build with Metro running; release builds ' +
+            'expose no inspector. Blocked methods (for safety): ' +
+            'Runtime.terminateExecution, Inspector.detached. Node 20 must be ' +
+            'launched with NODE_OPTIONS="--experimental-websocket" (Node 22+ works ' +
+            'out of the box). Example: method "Runtime.evaluate" with params ' +
+            '{"expression":"1+1","returnByValue":true} \u2014 the raw response nests ' +
+            'the value at result.result.value.',
+        inputSchema: {
+            method: z
+                .string()
+                .describe('The CDP method to invoke, e.g. "Runtime.evaluate".'),
+            params: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Optional CDP method parameters.'),
+            timeoutMs: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe(`Timeout in milliseconds applied to each phase independently: ` +
+                `discovery, socket open, identity probe, and the CDP call ` +
+                `(default ${DEFAULT_TIMEOUT_MS}, floored to ${MIN_TIMEOUT_MS}, max ${MAX_TIMEOUT_MS}).`),
+            metroPort: z
+                .number()
+                .optional()
+                .describe('Override the Metro inspector proxy port for this call.'),
+            appId: z
+                .string()
+                .optional()
+                .describe('Override the expected app bundle identifier.'),
+        },
+    }, async ({ method, params, timeoutMs, metroPort, appId }) => {
+        try {
+            const session = getHermesSession();
+            const resolved = session.resolve({
+                metroPort,
+                appId,
+                platform: backend.platform,
+            });
+            const clampedTimeoutMs = Math.min(Math.max(timeoutMs ?? DEFAULT_TIMEOUT_MS, MIN_TIMEOUT_MS), MAX_TIMEOUT_MS);
+            const result = await runHermesCdp({
+                method,
+                params,
+                timeoutMs: clampedTimeoutMs,
+                metroPort: resolved.metroPort,
+                appId: resolved.appId,
+                pinnedDeviceId: resolved.pinnedDeviceId,
+                onPin: (id) => {
+                    const currentPin = session.getPinnedHermesDeviceId();
+                    if (currentPin === undefined) {
+                        session.setPinnedHermesDeviceId(id);
+                    }
+                },
+            });
+            if (!result.ok) {
+                return errorResult(new Error(`[${result.code}] ${result.message}`));
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result.result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=hermes-cdp.mjs.map

package/dist/tools/hermes-cdp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-cdp.mjs","sourceRoot":"","sources":["../../src/tools/hermes-cdp.ts"],"names":[],"mappings":"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","sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\nimport { errorResult } from './shared.js';\nimport type { DeviceBackend } from '../backends/types.js';\nimport { runHermesCdp } from '../hermes/hermes-cdp.js';\nimport { getHermesSession } from '../hermes/session.js';\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst MIN_TIMEOUT_MS = 1_000;\nconst MAX_TIMEOUT_MS = 120_000;\n\n/**\n * Registers the `hermes_cdp` MCP tool, which speaks raw Chrome DevTools\n * Protocol (CDP) to the React Native Hermes runtime of a running app via\n * Metro's inspector proxy (iOS and Android).\n *\n * The handler is intentionally THIN: it resolves the Metro port/appId and the\n * current device pin from {@link getHermesSession}, delegates ALL discovery,\n * verification, and execution logic to {@link runHermesCdp}, and persists the\n * resolved pin via the core's `onPin` callback.\n *\n * @param server - The MCP server to register the tool on.\n * @param backend - The lazy device backend, used at call time only to read the\n * live platform so the session can resolve the correct default app bundle ID.\n */\nexport function registerHermesCdpTool(\n  server: McpServer,\n  backend: DeviceBackend,\n): void {\n  server.registerTool(\n    'hermes_cdp',\n    {\n      title: 'Hermes CDP',\n      description:\n        'Speak raw Chrome DevTools Protocol (CDP) to the React Native Hermes ' +\n        'JS runtime of a running app via Metro\\u2019s inspector proxy (iOS and ' +\n        'Android). Requires a DEBUG build with Metro running; release builds ' +\n        'expose no inspector. Blocked methods (for safety): ' +\n        'Runtime.terminateExecution, Inspector.detached. Node 20 must be ' +\n        'launched with NODE_OPTIONS=\"--experimental-websocket\" (Node 22+ works ' +\n        'out of the box). Example: method \"Runtime.evaluate\" with params ' +\n        '{\"expression\":\"1+1\",\"returnByValue\":true} \\u2014 the raw response nests ' +\n        'the value at result.result.value.',\n      inputSchema: {\n        method: z\n          .string()\n          .describe('The CDP method to invoke, e.g. \"Runtime.evaluate\".'),\n        params: z\n          .record(z.string(), z.unknown())\n          .optional()\n          .describe('Optional CDP method parameters.'),\n        timeoutMs: z\n          .number()\n          .int()\n          .positive()\n          .optional()\n          .describe(\n            `Timeout in milliseconds applied to each phase independently: ` +\n              `discovery, socket open, identity probe, and the CDP call ` +\n              `(default ${DEFAULT_TIMEOUT_MS}, floored to ${MIN_TIMEOUT_MS}, max ${MAX_TIMEOUT_MS}).`,\n          ),\n        metroPort: z\n          .number()\n          .optional()\n          .describe('Override the Metro inspector proxy port for this call.'),\n        appId: z\n          .string()\n          .optional()\n          .describe('Override the expected app bundle identifier.'),\n      },\n    },\n    async ({ method, params, timeoutMs, metroPort, appId }) => {\n      try {\n        const session = getHermesSession();\n        const resolved = session.resolve({\n          metroPort,\n          appId,\n          platform: backend.platform,\n        });\n        const clampedTimeoutMs = Math.min(\n          Math.max(timeoutMs ?? DEFAULT_TIMEOUT_MS, MIN_TIMEOUT_MS),\n          MAX_TIMEOUT_MS,\n        );\n\n        const result = await runHermesCdp({\n          method,\n          params,\n          timeoutMs: clampedTimeoutMs,\n          metroPort: resolved.metroPort,\n          appId: resolved.appId,\n          pinnedDeviceId: resolved.pinnedDeviceId,\n          onPin: (id) => {\n            const currentPin = session.getPinnedHermesDeviceId();\n            if (currentPin === undefined) {\n              session.setPinnedHermesDeviceId(id);\n            }\n          },\n        });\n\n        if (!result.ok) {\n          return errorResult(new Error(`[${result.code}] ${result.message}`));\n        }\n\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: JSON.stringify(result.result, null, 2),\n            },\n          ],\n        };\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n}\n"]}

package/dist/tools/hermes-targets.cjs

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHermesTargetsTool = registerHermesTargetsTool;
+const zod_1 = require("zod");
+const shared_js_1 = require("./shared.cjs");
+const hermes_cdp_js_1 = require("../hermes/hermes-cdp.cjs");
+const session_js_1 = require("../hermes/session.cjs");
+const DISCOVERY_TIMEOUT_MS = 10000;
+function formatTarget(target) {
+    const { reactNative } = target;
+    return [
+        `  id: ${target.id ?? '<unknown>'}`,
+        `  title: ${target.title ?? '<unknown>'}`,
+        `  appId: ${target.appId ?? '<unknown>'}`,
+        `  logicalDeviceId: ${reactNative?.logicalDeviceId ?? '<missing>'}`,
+        `  nativePageReloads: ${reactNative?.capabilities?.nativePageReloads ?? '<unset>'}`,
+        `  wsUrl: ${target.webSocketDebuggerUrl ?? '<missing>'}`,
+    ].join('\n');
+}
+function describeMetroDown(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes('ECONNREFUSED') || message.includes('fetch failed')) {
+        return 'Metro not running or no debuggable app registered.';
+    }
+    return undefined;
+}
+/**
+ * Registers the `hermes_targets` MCP tool, which lists and diagnoses the
+ * debuggable Hermes targets that Metro's inspector proxy currently exposes
+ * (iOS and Android).
+ *
+ * The handler is THIN: it resolves the Metro port/appId from
+ * {@link getHermesSession}, delegates discovery to {@link fetchDiscoveryTargets}
+ * and selection/ambiguity reporting to {@link selectHermesTarget} /
+ * {@link hasAmbiguousTarget}, and formats a readable report. With `all` set,
+ * it bypasses the appId filter so agents can discover the real appId / confirm
+ * Metro is up. No discovery or selection LOGIC lives in this file.
+ *
+ * @param server - The MCP server to register the tool on.
+ * @param backend - The lazy device backend, used at call time only to read the
+ * live platform so the session can resolve the correct default app bundle ID.
+ */
+function registerHermesTargetsTool(server, backend) {
+    server.registerTool('hermes_targets', {
+        title: 'Hermes Targets',
+        description: 'List and diagnose the debuggable React Native Hermes targets that ' +
+            'Metro\u2019s inspector proxy currently exposes (iOS and Android). ' +
+            'Reports each candidate (id / title / appId / logicalDeviceId / ' +
+            'nativePageReloads / wsUrl) plus which target would be chosen or why ' +
+            'it is ambiguous. Use it to confirm Metro is running and your app is ' +
+            'registered. Requires a DEBUG build with Metro running.',
+        inputSchema: {
+            metroPort: zod_1.z
+                .number()
+                .optional()
+                .describe('Override the Metro inspector proxy port for this call.'),
+            appId: zod_1.z
+                .string()
+                .optional()
+                .describe('Override the expected app bundle identifier.'),
+            all: zod_1.z
+                .boolean()
+                .optional()
+                .describe('Bypass the appId filter and list ALL candidates (diagnostics).'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ metroPort, appId, all }) => {
+        try {
+            const resolved = (0, session_js_1.getHermesSession)().resolve({
+                metroPort,
+                appId,
+                platform: backend.platform,
+            });
+            const targets = await (0, hermes_cdp_js_1.fetchDiscoveryTargets)(resolved.metroPort, DISCOVERY_TIMEOUT_MS);
+            if (targets.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Metro not running or no debuggable app registered.',
+                        },
+                    ],
+                };
+            }
+            const candidates = all
+                ? targets
+                : targets
+                    .filter((target) => Boolean(target.webSocketDebuggerUrl))
+                    .filter((target) => target.title !== hermes_cdp_js_1.LEGACY_SYNTHETIC_TITLE)
+                    .filter((target) => target.appId === resolved.appId);
+            const lines = [
+                `Metro port: ${resolved.metroPort}`,
+                `Expected appId: ${resolved.appId}${all ? ' (filter bypassed by all=true)' : ''}`,
+                `Targets discovered: ${targets.length}`,
+                `Candidates listed: ${candidates.length}`,
+                '',
+            ];
+            candidates.forEach((target, index) => {
+                lines.push(`Candidate ${index + 1}:`, formatTarget(target), '');
+            });
+            const selection = (0, hermes_cdp_js_1.selectHermesTarget)(targets, resolved.appId, resolved.pinnedDeviceId);
+            if (selection.ok) {
+                lines.push(`Chosen target: ${selection.target.id ?? '<unknown>'} (device=${selection.target.reactNative?.logicalDeviceId ?? '<missing>'})`);
+            }
+            else if (selection.code === 'HERMES_MULTIPLE_DEVICES' &&
+                (0, hermes_cdp_js_1.hasAmbiguousTarget)(candidates)) {
+                lines.push(`Ambiguous: ${selection.message}`);
+            }
+            else {
+                lines.push(`No target chosen: [${selection.code}] ${selection.message}`);
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (error) {
+            const metroDown = describeMetroDown(error);
+            if (metroDown) {
+                return {
+                    content: [{ type: 'text', text: metroDown }],
+                };
+            }
+            return (0, shared_js_1.errorResult)(error);
+        }
+    });
+}
+//# sourceMappingURL=hermes-targets.cjs.map

package/dist/tools/hermes-targets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-targets.cjs","sourceRoot":"","sources":["../../src/tools/hermes-targets.ts"],"names":[],"mappings":"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","sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\nimport { errorResult } from './shared.js';\nimport type { DeviceBackend } from '../backends/types.js';\nimport {\n  fetchDiscoveryTargets,\n  hasAmbiguousTarget,\n  LEGACY_SYNTHETIC_TITLE,\n  selectHermesTarget,\n} from '../hermes/hermes-cdp.js';\nimport type { HermesTarget } from '../hermes/hermes-cdp.js';\nimport { getHermesSession } from '../hermes/session.js';\n\nconst DISCOVERY_TIMEOUT_MS = 10_000;\n\nfunction formatTarget(target: HermesTarget): string {\n  const { reactNative } = target;\n  return [\n    `  id: ${target.id ?? '<unknown>'}`,\n    `  title: ${target.title ?? '<unknown>'}`,\n    `  appId: ${target.appId ?? '<unknown>'}`,\n    `  logicalDeviceId: ${reactNative?.logicalDeviceId ?? '<missing>'}`,\n    `  nativePageReloads: ${\n      reactNative?.capabilities?.nativePageReloads ?? '<unset>'\n    }`,\n    `  wsUrl: ${target.webSocketDebuggerUrl ?? '<missing>'}`,\n  ].join('\\n');\n}\n\nfunction describeMetroDown(error: unknown): string | undefined {\n  const message = error instanceof Error ? error.message : String(error);\n  if (message.includes('ECONNREFUSED') || message.includes('fetch failed')) {\n    return 'Metro not running or no debuggable app registered.';\n  }\n  return undefined;\n}\n\n/**\n * Registers the `hermes_targets` MCP tool, which lists and diagnoses the\n * debuggable Hermes targets that Metro's inspector proxy currently exposes\n * (iOS and Android).\n *\n * The handler is THIN: it resolves the Metro port/appId from\n * {@link getHermesSession}, delegates discovery to {@link fetchDiscoveryTargets}\n * and selection/ambiguity reporting to {@link selectHermesTarget} /\n * {@link hasAmbiguousTarget}, and formats a readable report. With `all` set,\n * it bypasses the appId filter so agents can discover the real appId / confirm\n * Metro is up. No discovery or selection LOGIC lives in this file.\n *\n * @param server - The MCP server to register the tool on.\n * @param backend - The lazy device backend, used at call time only to read the\n * live platform so the session can resolve the correct default app bundle ID.\n */\nexport function registerHermesTargetsTool(\n  server: McpServer,\n  backend: DeviceBackend,\n): void {\n  server.registerTool(\n    'hermes_targets',\n    {\n      title: 'Hermes Targets',\n      description:\n        'List and diagnose the debuggable React Native Hermes targets that ' +\n        'Metro\\u2019s inspector proxy currently exposes (iOS and Android). ' +\n        'Reports each candidate (id / title / appId / logicalDeviceId / ' +\n        'nativePageReloads / wsUrl) plus which target would be chosen or why ' +\n        'it is ambiguous. Use it to confirm Metro is running and your app is ' +\n        'registered. Requires a DEBUG build with Metro running.',\n      inputSchema: {\n        metroPort: z\n          .number()\n          .optional()\n          .describe('Override the Metro inspector proxy port for this call.'),\n        appId: z\n          .string()\n          .optional()\n          .describe('Override the expected app bundle identifier.'),\n        all: z\n          .boolean()\n          .optional()\n          .describe(\n            'Bypass the appId filter and list ALL candidates (diagnostics).',\n          ),\n      },\n      annotations: { readOnlyHint: true },\n    },\n    async ({ metroPort, appId, all }) => {\n      try {\n        const resolved = getHermesSession().resolve({\n          metroPort,\n          appId,\n          platform: backend.platform,\n        });\n        const targets = await fetchDiscoveryTargets(\n          resolved.metroPort,\n          DISCOVERY_TIMEOUT_MS,\n        );\n\n        if (targets.length === 0) {\n          return {\n            content: [\n              {\n                type: 'text' as const,\n                text: 'Metro not running or no debuggable app registered.',\n              },\n            ],\n          };\n        }\n\n        const candidates = all\n          ? targets\n          : targets\n              .filter((target) => Boolean(target.webSocketDebuggerUrl))\n              .filter((target) => target.title !== LEGACY_SYNTHETIC_TITLE)\n              .filter((target) => target.appId === resolved.appId);\n\n        const lines: string[] = [\n          `Metro port: ${resolved.metroPort}`,\n          `Expected appId: ${resolved.appId}${all ? ' (filter bypassed by all=true)' : ''}`,\n          `Targets discovered: ${targets.length}`,\n          `Candidates listed: ${candidates.length}`,\n          '',\n        ];\n\n        candidates.forEach((target, index) => {\n          lines.push(`Candidate ${index + 1}:`, formatTarget(target), '');\n        });\n\n        const selection = selectHermesTarget(\n          targets,\n          resolved.appId,\n          resolved.pinnedDeviceId,\n        );\n        if (selection.ok) {\n          lines.push(\n            `Chosen target: ${selection.target.id ?? '<unknown>'} (device=${\n              selection.target.reactNative?.logicalDeviceId ?? '<missing>'\n            })`,\n          );\n        } else if (\n          selection.code === 'HERMES_MULTIPLE_DEVICES' &&\n          hasAmbiguousTarget(candidates)\n        ) {\n          lines.push(`Ambiguous: ${selection.message}`);\n        } else {\n          lines.push(\n            `No target chosen: [${selection.code}] ${selection.message}`,\n          );\n        }\n\n        return {\n          content: [{ type: 'text' as const, text: lines.join('\\n') }],\n        };\n      } catch (error) {\n        const metroDown = describeMetroDown(error);\n        if (metroDown) {\n          return {\n            content: [{ type: 'text' as const, text: metroDown }],\n          };\n        }\n        return errorResult(error);\n      }\n    },\n  );\n}\n"]}

package/dist/tools/hermes-targets.d.cts

@@ -0,0 +1,20 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DeviceBackend } from "../backends/types.cjs";
+/**
+ * Registers the `hermes_targets` MCP tool, which lists and diagnoses the
+ * debuggable Hermes targets that Metro's inspector proxy currently exposes
+ * (iOS and Android).
+ *
+ * The handler is THIN: it resolves the Metro port/appId from
+ * {@link getHermesSession}, delegates discovery to {@link fetchDiscoveryTargets}
+ * and selection/ambiguity reporting to {@link selectHermesTarget} /
+ * {@link hasAmbiguousTarget}, and formats a readable report. With `all` set,
+ * it bypasses the appId filter so agents can discover the real appId / confirm
+ * Metro is up. No discovery or selection LOGIC lives in this file.
+ *
+ * @param server - The MCP server to register the tool on.
+ * @param backend - The lazy device backend, used at call time only to read the
+ * live platform so the session can resolve the correct default app bundle ID.
+ */
+export declare function registerHermesTargetsTool(server: McpServer, backend: DeviceBackend): void;
+//# sourceMappingURL=hermes-targets.d.cts.map

package/dist/tools/hermes-targets.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-targets.d.cts","sourceRoot":"","sources":["../../src/tools/hermes-targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gDAAgD;AAIzE,OAAO,KAAK,EAAE,aAAa,EAAE,8BAA6B;AAkC1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,aAAa,GACrB,IAAI,CA4GN"}

package/dist/tools/hermes-targets.d.mts

@@ -0,0 +1,20 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DeviceBackend } from "../backends/types.mjs";
+/**
+ * Registers the `hermes_targets` MCP tool, which lists and diagnoses the
+ * debuggable Hermes targets that Metro's inspector proxy currently exposes
+ * (iOS and Android).
+ *
+ * The handler is THIN: it resolves the Metro port/appId from
+ * {@link getHermesSession}, delegates discovery to {@link fetchDiscoveryTargets}
+ * and selection/ambiguity reporting to {@link selectHermesTarget} /
+ * {@link hasAmbiguousTarget}, and formats a readable report. With `all` set,
+ * it bypasses the appId filter so agents can discover the real appId / confirm
+ * Metro is up. No discovery or selection LOGIC lives in this file.
+ *
+ * @param server - The MCP server to register the tool on.
+ * @param backend - The lazy device backend, used at call time only to read the
+ * live platform so the session can resolve the correct default app bundle ID.
+ */
+export declare function registerHermesTargetsTool(server: McpServer, backend: DeviceBackend): void;
+//# sourceMappingURL=hermes-targets.d.mts.map

package/dist/tools/hermes-targets.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-targets.d.mts","sourceRoot":"","sources":["../../src/tools/hermes-targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gDAAgD;AAIzE,OAAO,KAAK,EAAE,aAAa,EAAE,8BAA6B;AAkC1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,aAAa,GACrB,IAAI,CA4GN"}

package/dist/tools/hermes-targets.mjs

@@ -0,0 +1,124 @@
+import { z } from "zod";
+import { errorResult } from "./shared.mjs";
+import { fetchDiscoveryTargets, hasAmbiguousTarget, LEGACY_SYNTHETIC_TITLE, selectHermesTarget } from "../hermes/hermes-cdp.mjs";
+import { getHermesSession } from "../hermes/session.mjs";
+const DISCOVERY_TIMEOUT_MS = 10000;
+function formatTarget(target) {
+    const { reactNative } = target;
+    return [
+        `  id: ${target.id ?? '<unknown>'}`,
+        `  title: ${target.title ?? '<unknown>'}`,
+        `  appId: ${target.appId ?? '<unknown>'}`,
+        `  logicalDeviceId: ${reactNative?.logicalDeviceId ?? '<missing>'}`,
+        `  nativePageReloads: ${reactNative?.capabilities?.nativePageReloads ?? '<unset>'}`,
+        `  wsUrl: ${target.webSocketDebuggerUrl ?? '<missing>'}`,
+    ].join('\n');
+}
+function describeMetroDown(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes('ECONNREFUSED') || message.includes('fetch failed')) {
+        return 'Metro not running or no debuggable app registered.';
+    }
+    return undefined;
+}
+/**
+ * Registers the `hermes_targets` MCP tool, which lists and diagnoses the
+ * debuggable Hermes targets that Metro's inspector proxy currently exposes
+ * (iOS and Android).
+ *
+ * The handler is THIN: it resolves the Metro port/appId from
+ * {@link getHermesSession}, delegates discovery to {@link fetchDiscoveryTargets}
+ * and selection/ambiguity reporting to {@link selectHermesTarget} /
+ * {@link hasAmbiguousTarget}, and formats a readable report. With `all` set,
+ * it bypasses the appId filter so agents can discover the real appId / confirm
+ * Metro is up. No discovery or selection LOGIC lives in this file.
+ *
+ * @param server - The MCP server to register the tool on.
+ * @param backend - The lazy device backend, used at call time only to read the
+ * live platform so the session can resolve the correct default app bundle ID.
+ */
+export function registerHermesTargetsTool(server, backend) {
+    server.registerTool('hermes_targets', {
+        title: 'Hermes Targets',
+        description: 'List and diagnose the debuggable React Native Hermes targets that ' +
+            'Metro\u2019s inspector proxy currently exposes (iOS and Android). ' +
+            'Reports each candidate (id / title / appId / logicalDeviceId / ' +
+            'nativePageReloads / wsUrl) plus which target would be chosen or why ' +
+            'it is ambiguous. Use it to confirm Metro is running and your app is ' +
+            'registered. Requires a DEBUG build with Metro running.',
+        inputSchema: {
+            metroPort: z
+                .number()
+                .optional()
+                .describe('Override the Metro inspector proxy port for this call.'),
+            appId: z
+                .string()
+                .optional()
+                .describe('Override the expected app bundle identifier.'),
+            all: z
+                .boolean()
+                .optional()
+                .describe('Bypass the appId filter and list ALL candidates (diagnostics).'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ metroPort, appId, all }) => {
+        try {
+            const resolved = getHermesSession().resolve({
+                metroPort,
+                appId,
+                platform: backend.platform,
+            });
+            const targets = await fetchDiscoveryTargets(resolved.metroPort, DISCOVERY_TIMEOUT_MS);
+            if (targets.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Metro not running or no debuggable app registered.',
+                        },
+                    ],
+                };
+            }
+            const candidates = all
+                ? targets
+                : targets
+                    .filter((target) => Boolean(target.webSocketDebuggerUrl))
+                    .filter((target) => target.title !== LEGACY_SYNTHETIC_TITLE)
+                    .filter((target) => target.appId === resolved.appId);
+            const lines = [
+                `Metro port: ${resolved.metroPort}`,
+                `Expected appId: ${resolved.appId}${all ? ' (filter bypassed by all=true)' : ''}`,
+                `Targets discovered: ${targets.length}`,
+                `Candidates listed: ${candidates.length}`,
+                '',
+            ];
+            candidates.forEach((target, index) => {
+                lines.push(`Candidate ${index + 1}:`, formatTarget(target), '');
+            });
+            const selection = selectHermesTarget(targets, resolved.appId, resolved.pinnedDeviceId);
+            if (selection.ok) {
+                lines.push(`Chosen target: ${selection.target.id ?? '<unknown>'} (device=${selection.target.reactNative?.logicalDeviceId ?? '<missing>'})`);
+            }
+            else if (selection.code === 'HERMES_MULTIPLE_DEVICES' &&
+                hasAmbiguousTarget(candidates)) {
+                lines.push(`Ambiguous: ${selection.message}`);
+            }
+            else {
+                lines.push(`No target chosen: [${selection.code}] ${selection.message}`);
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        catch (error) {
+            const metroDown = describeMetroDown(error);
+            if (metroDown) {
+                return {
+                    content: [{ type: 'text', text: metroDown }],
+                };
+            }
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=hermes-targets.mjs.map

package/dist/tools/hermes-targets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-targets.mjs","sourceRoot":"","sources":["../../src/tools/hermes-targets.ts"],"names":[],"mappings":"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","sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\nimport { errorResult } from './shared.js';\nimport type { DeviceBackend } from '../backends/types.js';\nimport {\n  fetchDiscoveryTargets,\n  hasAmbiguousTarget,\n  LEGACY_SYNTHETIC_TITLE,\n  selectHermesTarget,\n} from '../hermes/hermes-cdp.js';\nimport type { HermesTarget } from '../hermes/hermes-cdp.js';\nimport { getHermesSession } from '../hermes/session.js';\n\nconst DISCOVERY_TIMEOUT_MS = 10_000;\n\nfunction formatTarget(target: HermesTarget): string {\n  const { reactNative } = target;\n  return [\n    `  id: ${target.id ?? '<unknown>'}`,\n    `  title: ${target.title ?? '<unknown>'}`,\n    `  appId: ${target.appId ?? '<unknown>'}`,\n    `  logicalDeviceId: ${reactNative?.logicalDeviceId ?? '<missing>'}`,\n    `  nativePageReloads: ${\n      reactNative?.capabilities?.nativePageReloads ?? '<unset>'\n    }`,\n    `  wsUrl: ${target.webSocketDebuggerUrl ?? '<missing>'}`,\n  ].join('\\n');\n}\n\nfunction describeMetroDown(error: unknown): string | undefined {\n  const message = error instanceof Error ? error.message : String(error);\n  if (message.includes('ECONNREFUSED') || message.includes('fetch failed')) {\n    return 'Metro not running or no debuggable app registered.';\n  }\n  return undefined;\n}\n\n/**\n * Registers the `hermes_targets` MCP tool, which lists and diagnoses the\n * debuggable Hermes targets that Metro's inspector proxy currently exposes\n * (iOS and Android).\n *\n * The handler is THIN: it resolves the Metro port/appId from\n * {@link getHermesSession}, delegates discovery to {@link fetchDiscoveryTargets}\n * and selection/ambiguity reporting to {@link selectHermesTarget} /\n * {@link hasAmbiguousTarget}, and formats a readable report. With `all` set,\n * it bypasses the appId filter so agents can discover the real appId / confirm\n * Metro is up. No discovery or selection LOGIC lives in this file.\n *\n * @param server - The MCP server to register the tool on.\n * @param backend - The lazy device backend, used at call time only to read the\n * live platform so the session can resolve the correct default app bundle ID.\n */\nexport function registerHermesTargetsTool(\n  server: McpServer,\n  backend: DeviceBackend,\n): void {\n  server.registerTool(\n    'hermes_targets',\n    {\n      title: 'Hermes Targets',\n      description:\n        'List and diagnose the debuggable React Native Hermes targets that ' +\n        'Metro\\u2019s inspector proxy currently exposes (iOS and Android). ' +\n        'Reports each candidate (id / title / appId / logicalDeviceId / ' +\n        'nativePageReloads / wsUrl) plus which target would be chosen or why ' +\n        'it is ambiguous. Use it to confirm Metro is running and your app is ' +\n        'registered. Requires a DEBUG build with Metro running.',\n      inputSchema: {\n        metroPort: z\n          .number()\n          .optional()\n          .describe('Override the Metro inspector proxy port for this call.'),\n        appId: z\n          .string()\n          .optional()\n          .describe('Override the expected app bundle identifier.'),\n        all: z\n          .boolean()\n          .optional()\n          .describe(\n            'Bypass the appId filter and list ALL candidates (diagnostics).',\n          ),\n      },\n      annotations: { readOnlyHint: true },\n    },\n    async ({ metroPort, appId, all }) => {\n      try {\n        const resolved = getHermesSession().resolve({\n          metroPort,\n          appId,\n          platform: backend.platform,\n        });\n        const targets = await fetchDiscoveryTargets(\n          resolved.metroPort,\n          DISCOVERY_TIMEOUT_MS,\n        );\n\n        if (targets.length === 0) {\n          return {\n            content: [\n              {\n                type: 'text' as const,\n                text: 'Metro not running or no debuggable app registered.',\n              },\n            ],\n          };\n        }\n\n        const candidates = all\n          ? targets\n          : targets\n              .filter((target) => Boolean(target.webSocketDebuggerUrl))\n              .filter((target) => target.title !== LEGACY_SYNTHETIC_TITLE)\n              .filter((target) => target.appId === resolved.appId);\n\n        const lines: string[] = [\n          `Metro port: ${resolved.metroPort}`,\n          `Expected appId: ${resolved.appId}${all ? ' (filter bypassed by all=true)' : ''}`,\n          `Targets discovered: ${targets.length}`,\n          `Candidates listed: ${candidates.length}`,\n          '',\n        ];\n\n        candidates.forEach((target, index) => {\n          lines.push(`Candidate ${index + 1}:`, formatTarget(target), '');\n        });\n\n        const selection = selectHermesTarget(\n          targets,\n          resolved.appId,\n          resolved.pinnedDeviceId,\n        );\n        if (selection.ok) {\n          lines.push(\n            `Chosen target: ${selection.target.id ?? '<unknown>'} (device=${\n              selection.target.reactNative?.logicalDeviceId ?? '<missing>'\n            })`,\n          );\n        } else if (\n          selection.code === 'HERMES_MULTIPLE_DEVICES' &&\n          hasAmbiguousTarget(candidates)\n        ) {\n          lines.push(`Ambiguous: ${selection.message}`);\n        } else {\n          lines.push(\n            `No target chosen: [${selection.code}] ${selection.message}`,\n          );\n        }\n\n        return {\n          content: [{ type: 'text' as const, text: lines.join('\\n') }],\n        };\n      } catch (error) {\n        const metroDown = describeMetroDown(error);\n        if (metroDown) {\n          return {\n            content: [{ type: 'text' as const, text: metroDown }],\n          };\n        }\n        return errorResult(error);\n      }\n    },\n  );\n}\n"]}