react-native-mcp-kit 2.2.2 → 2.3.1

package/dist/server/metro/tools/openInEditor.d.ts

@@ -0,0 +1,3 @@
+import { type HostToolHandler } from '../../../server/host/types';
+export declare const openInEditorTool: () => HostToolHandler;
+//# sourceMappingURL=openInEditor.d.ts.map

package/dist/server/metro/tools/openInEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openInEditor.d.ts","sourceRoot":"","sources":["../../../../src/server/metro/tools/openInEditor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,eAAO,MAAM,gBAAgB,QAAO,eAiFnC,CAAC"}

package/dist/server/metro/tools/openInEditor.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openInEditorTool = void 0;
+const resolveMetroUrl_1 = require("../../../server/metro/resolveMetroUrl");
+const METRO_TIMEOUT_MS = 3_000;
+const openInEditorTool = () => {
+    return {
+        description: `Jump to a source location in the dev machine's editor — POSTs to Metro's \`/open-stack-frame\` endpoint, which shells out via $REACT_EDITOR / $EDITOR.
+
+Natural finisher for a symbolication flow: errors__get_errors → metro__symbolicate → metro__open_in_editor on the top user-frame. Unlike a plain \`open file:…\` shell call, this jumps to the exact line and column.
+
+Returns { ok: true, file, lineNumber, metroUrl } on success.`,
+        handler: async (args, ctx) => {
+            const file = typeof args.file === 'string' ? args.file : undefined;
+            const lineNumber = typeof args.lineNumber === 'number' ? args.lineNumber : undefined;
+            const column = typeof args.column === 'number' ? args.column : undefined;
+            if (!file) {
+                return { error: '`file` is required.' };
+            }
+            if (typeof lineNumber !== 'number') {
+                return { error: '`lineNumber` is required (number).' };
+            }
+            const metroUrl = (0, resolveMetroUrl_1.resolveMetroUrl)(args, ctx);
+            const body = { file, lineNumber };
+            if (typeof column === 'number')
+                body.column = column;
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => {
+                    controller.abort();
+                }, METRO_TIMEOUT_MS);
+                const res = await fetch(`${metroUrl}/open-stack-frame`, {
+                    body: JSON.stringify(body),
+                    headers: { 'Content-Type': 'application/json' },
+                    method: 'POST',
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (!res.ok) {
+                    return {
+                        error: `Metro responded ${res.status}`,
+                        file,
+                        lineNumber,
+                        metroUrl,
+                        ok: false,
+                        skipped: true,
+                    };
+                }
+                return { file, lineNumber, metroUrl, ok: true };
+            }
+            catch (err) {
+                return {
+                    error: `Metro at ${metroUrl} unreachable: ${err.message}`,
+                    file,
+                    lineNumber,
+                    metroUrl,
+                    ok: false,
+                    skipped: true,
+                };
+            }
+        },
+        inputSchema: {
+            clientId: {
+                description: 'Target client ID — used to pick up the Metro URL the app was loaded from (falls back to `metroUrl` or the hardcoded default).',
+                type: 'string',
+            },
+            column: {
+                description: 'Column number (1-based). Optional.',
+                type: 'number',
+            },
+            file: {
+                description: 'Absolute or repo-relative path to the source file. Paths from metro__symbolicate output plug in directly.',
+                examples: ['src/screens/HomeScreen/HomeScreen.tsx', '/Users/me/project/src/Foo.tsx'],
+                type: 'string',
+            },
+            lineNumber: {
+                description: 'Line number (1-based).',
+                type: 'number',
+            },
+            metroUrl: {
+                description: `Base URL of the Metro dev server. Overrides the URL reported by the connected client. Default "http://localhost:8081".`,
+                type: 'string',
+            },
+        },
+        timeout: METRO_TIMEOUT_MS + 1_000,
+    };
+};
+exports.openInEditorTool = openInEditorTool;
+//# sourceMappingURL=openInEditor.js.map

package/dist/server/metro/tools/openInEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openInEditor.js","sourceRoot":"","sources":["../../../../src/server/metro/tools/openInEditor.ts"],"names":[],"mappings":"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"}

package/dist/server/metro/tools/openUrl.d.ts

@@ -0,0 +1,3 @@
+import { type HostToolHandler } from '../../../server/host/types';
+export declare const openUrlTool: () => HostToolHandler;
+//# sourceMappingURL=openUrl.d.ts.map

package/dist/server/metro/tools/openUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openUrl.d.ts","sourceRoot":"","sources":["../../../../src/server/metro/tools/openUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,eAAO,MAAM,WAAW,QAAO,eAgE9B,CAAC"}

package/dist/server/metro/tools/openUrl.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openUrlTool = void 0;
+const resolveMetroUrl_1 = require("../../../server/metro/resolveMetroUrl");
+const METRO_TIMEOUT_MS = 5_000;
+const openUrlTool = () => {
+    return {
+        description: `Open a URL in the default browser on the machine running Metro — POSTs to Metro's \`/open-url\` endpoint.
+
+Useful for handing off to a view the agent has discovered but can't usefully display itself: a CI job page, a Grafana dashboard, a PR diff, a deployed preview build. This runs \`open\` on macOS / \`xdg-open\` on Linux against the host, not on the mobile device. For deep-linking into the app use navigation module or iOS/Android URL schemes instead.
+
+Returns { ok: true, url, metroUrl } on success.`,
+        handler: async (args, ctx) => {
+            const url = typeof args.url === 'string' ? args.url : undefined;
+            if (!url) {
+                return { error: '`url` is required.' };
+            }
+            const metroUrl = (0, resolveMetroUrl_1.resolveMetroUrl)(args, ctx);
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => {
+                    controller.abort();
+                }, METRO_TIMEOUT_MS);
+                const res = await fetch(`${metroUrl}/open-url`, {
+                    body: JSON.stringify({ url }),
+                    headers: { 'Content-Type': 'application/json' },
+                    method: 'POST',
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (!res.ok) {
+                    return {
+                        error: `Metro responded ${res.status}`,
+                        metroUrl,
+                        ok: false,
+                        skipped: true,
+                        url,
+                    };
+                }
+                return { metroUrl, ok: true, url };
+            }
+            catch (err) {
+                return {
+                    error: `Metro at ${metroUrl} unreachable: ${err.message}`,
+                    metroUrl,
+                    ok: false,
+                    skipped: true,
+                    url,
+                };
+            }
+        },
+        inputSchema: {
+            clientId: {
+                description: 'Target client ID — used to pick up the Metro URL the app was loaded from (falls back to `metroUrl` or the hardcoded default).',
+                type: 'string',
+            },
+            metroUrl: {
+                description: `Base URL of the Metro dev server. Overrides the URL reported by the connected client. Default "http://localhost:8081".`,
+                type: 'string',
+            },
+            url: {
+                description: 'Absolute URL to open on the host (http/https). Deep-linking into the mobile app is a different concern — use navigation tools instead.',
+                examples: ['https://example.com/dashboard', 'https://github.com/org/repo/pull/42'],
+                type: 'string',
+            },
+        },
+        timeout: METRO_TIMEOUT_MS + 1_000,
+    };
+};
+exports.openUrlTool = openUrlTool;
+//# sourceMappingURL=openUrl.js.map

package/dist/server/metro/tools/openUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openUrl.js","sourceRoot":"","sources":["../../../../src/server/metro/tools/openUrl.ts"],"names":[],"mappings":";;;AACA,oEAAiE;AAEjE,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAExB,MAAM,WAAW,GAAG,GAAoB,EAAE;IAC/C,OAAO;QACL,WAAW,EAAE;;;;gDAI+B;QAC5C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YAChE,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,MAAM,QAAQ,GAAG,IAAA,iCAAe,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC,EAAE,gBAAgB,CAAC,CAAC;gBACrB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,WAAW,EAAE;oBAC9C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;oBAC7B,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,MAAM,EAAE,MAAM;oBACd,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBACH,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,OAAO;wBACL,KAAK,EAAE,mBAAmB,GAAG,CAAC,MAAM,EAAE;wBACtC,QAAQ;wBACR,EAAE,EAAE,KAAK;wBACT,OAAO,EAAE,IAAI;wBACb,GAAG;qBACJ,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,KAAK,EAAE,YAAY,QAAQ,iBAAkB,GAAa,CAAC,OAAO,EAAE;oBACpE,QAAQ;oBACR,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,IAAI;oBACb,GAAG;iBACJ,CAAC;YACJ,CAAC;QACH,CAAC;QACD,WAAW,EAAE;YACX,QAAQ,EAAE;gBACR,WAAW,EACT,+HAA+H;gBACjI,IAAI,EAAE,QAAQ;aACf;YACD,QAAQ,EAAE;gBACR,WAAW,EAAE,wHAAwH;gBACrI,IAAI,EAAE,QAAQ;aACf;YACD,GAAG,EAAE;gBACH,WAAW,EACT,wIAAwI;gBAC1I,QAAQ,EAAE,CAAC,+BAA+B,EAAE,qCAAqC,CAAC;gBAClF,IAAI,EAAE,QAAQ;aACf;SACF;QACD,OAAO,EAAE,gBAAgB,GAAG,KAAK;KAClC,CAAC;AACJ,CAAC,CAAC;AAhEW,QAAA,WAAW,eAgEtB"}

package/dist/server/metro/tools/reload.d.ts

@@ -0,0 +1,3 @@
+import { type HostToolHandler } from '../../../server/host/types';
+export declare const reloadTool: () => HostToolHandler;
+//# sourceMappingURL=reload.d.ts.map

package/dist/server/metro/tools/reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.d.ts","sourceRoot":"","sources":["../../../../src/server/metro/tools/reload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,eAAO,MAAM,UAAU,QAAO,eA6C7B,CAAC"}

package/dist/server/metro/tools/reload.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reloadTool = void 0;
+const resolveMetroUrl_1 = require("../../../server/metro/resolveMetroUrl");
+const METRO_TIMEOUT_MS = 5_000;
+const reloadTool = () => {
+    return {
+        description: `Trigger a full JS reload on every app attached to Metro — POSTs to Metro's \`/reload\` endpoint.
+
+Equivalent to shaking the device and tapping "Reload". Use this when the agent needs a clean runtime (post-edit, after state corruption, or between test cases) without touching the simulator UI. All connected clients reload, not just the targeted one — Metro broadcasts.
+
+Returns { ok: true, metroUrl } on success. On an unreachable Metro returns { ok: false, error, metroUrl, skipped: true }.`,
+        handler: async (args, ctx) => {
+            const metroUrl = (0, resolveMetroUrl_1.resolveMetroUrl)(args, ctx);
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => {
+                    controller.abort();
+                }, METRO_TIMEOUT_MS);
+                const res = await fetch(`${metroUrl}/reload`, {
+                    method: 'POST',
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (!res.ok) {
+                    return { error: `Metro responded ${res.status}`, metroUrl, ok: false, skipped: true };
+                }
+                return { metroUrl, ok: true };
+            }
+            catch (err) {
+                return {
+                    error: `Metro at ${metroUrl} unreachable: ${err.message}`,
+                    metroUrl,
+                    ok: false,
+                    skipped: true,
+                };
+            }
+        },
+        inputSchema: {
+            clientId: {
+                description: 'Target client ID — used to pick up the Metro URL the app was loaded from (falls back to `metroUrl` or the hardcoded default).',
+                type: 'string',
+            },
+            metroUrl: {
+                description: `Base URL of the Metro dev server. Overrides the URL reported by the connected client. Default "${'http://localhost:8081'}".`,
+                type: 'string',
+            },
+        },
+        timeout: METRO_TIMEOUT_MS + 1_000,
+    };
+};
+exports.reloadTool = reloadTool;
+//# sourceMappingURL=reload.js.map

package/dist/server/metro/tools/reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../../../src/server/metro/tools/reload.ts"],"names":[],"mappings":";;;AACA,oEAAiE;AAEjE,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAExB,MAAM,UAAU,GAAG,GAAoB,EAAE;IAC9C,OAAO;QACL,WAAW,EAAE;;;;0HAIyG;QACtH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,IAAA,iCAAe,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC,EAAE,gBAAgB,CAAC,CAAC;gBACrB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,SAAS,EAAE;oBAC5C,MAAM,EAAE,MAAM;oBACd,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBACH,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,OAAO,EAAE,KAAK,EAAE,mBAAmB,GAAG,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACxF,CAAC;gBACD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,KAAK,EAAE,YAAY,QAAQ,iBAAkB,GAAa,CAAC,OAAO,EAAE;oBACpE,QAAQ;oBACR,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;QACD,WAAW,EAAE;YACX,QAAQ,EAAE;gBACR,WAAW,EACT,+HAA+H;gBACjI,IAAI,EAAE,QAAQ;aACf;YACD,QAAQ,EAAE;gBACR,WAAW,EAAE,kGAAkG,uBAAuB,IAAI;gBAC1I,IAAI,EAAE,QAAQ;aACf;SACF;QACD,OAAO,EAAE,gBAAgB,GAAG,KAAK;KAClC,CAAC;AACJ,CAAC,CAAC;AA7CW,QAAA,UAAU,cA6CrB"}

package/dist/server/metro/tools/status.d.ts

@@ -0,0 +1,3 @@
+import { type HostToolHandler } from '../../../server/host/types';
+export declare const statusTool: () => HostToolHandler;
+//# sourceMappingURL=status.d.ts.map

package/dist/server/metro/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/server/metro/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,eAAO,MAAM,UAAU,QAAO,eA2C7B,CAAC"}

package/dist/server/metro/tools/status.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusTool = void 0;
+const resolveMetroUrl_1 = require("../../../server/metro/resolveMetroUrl");
+const METRO_TIMEOUT_MS = 3_000;
+const PACKAGER_STATUS = 'packager-status:running';
+const statusTool = () => {
+    return {
+        description: `Ping Metro's \`/status\` endpoint — returns { running: true, metroUrl } when Metro is up and reachable, { running: false, error, metroUrl } when it's not.
+
+Cheap, side-effect-free sanity check. Useful before a chain of Metro-facing operations (symbolicate, reload) to fail fast with a clear reason instead of a cascade of timeouts.`,
+        handler: async (args, ctx) => {
+            const metroUrl = (0, resolveMetroUrl_1.resolveMetroUrl)(args, ctx);
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => {
+                    controller.abort();
+                }, METRO_TIMEOUT_MS);
+                const res = await fetch(`${metroUrl}/status`, { signal: controller.signal });
+                clearTimeout(timer);
+                if (!res.ok) {
+                    return { error: `Metro responded ${res.status}`, metroUrl, running: false };
+                }
+                const body = (await res.text()).trim();
+                const running = body === PACKAGER_STATUS;
+                return running
+                    ? { metroUrl, running: true }
+                    : { body, error: `unexpected body: "${body}"`, metroUrl, running: false };
+            }
+            catch (err) {
+                return {
+                    error: `Metro at ${metroUrl} unreachable: ${err.message}`,
+                    metroUrl,
+                    running: false,
+                };
+            }
+        },
+        inputSchema: {
+            clientId: {
+                description: 'Target client ID — used to pick up the Metro URL the app was loaded from (falls back to `metroUrl` or the hardcoded default).',
+                type: 'string',
+            },
+            metroUrl: {
+                description: `Base URL of the Metro dev server. Overrides the URL reported by the connected client. Default "http://localhost:8081".`,
+                type: 'string',
+            },
+        },
+        timeout: METRO_TIMEOUT_MS + 1_000,
+    };
+};
+exports.statusTool = statusTool;
+//# sourceMappingURL=status.js.map

package/dist/server/metro/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/server/metro/tools/status.ts"],"names":[],"mappings":";;;AACA,oEAAiE;AAEjE,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAE3C,MAAM,UAAU,GAAG,GAAoB,EAAE;IAC9C,OAAO;QACL,WAAW,EAAE;;gLAE+J;QAC5K,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,IAAA,iCAAe,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC,EAAE,gBAAgB,CAAC,CAAC;gBACrB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7E,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,OAAO,EAAE,KAAK,EAAE,mBAAmB,GAAG,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;gBAC9E,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACvC,MAAM,OAAO,GAAG,IAAI,KAAK,eAAe,CAAC;gBACzC,OAAO,OAAO;oBACZ,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;oBAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,qBAAqB,IAAI,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC9E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,KAAK,EAAE,YAAY,QAAQ,iBAAkB,GAAa,CAAC,OAAO,EAAE;oBACpE,QAAQ;oBACR,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;QACH,CAAC;QACD,WAAW,EAAE;YACX,QAAQ,EAAE;gBACR,WAAW,EACT,+HAA+H;gBACjI,IAAI,EAAE,QAAQ;aACf;YACD,QAAQ,EAAE;gBACR,WAAW,EAAE,wHAAwH;gBACrI,IAAI,EAAE,QAAQ;aACf;SACF;QACD,OAAO,EAAE,gBAAgB,GAAG,KAAK;KAClC,CAAC;AACJ,CAAC,CAAC;AA3CW,QAAA,UAAU,cA2CrB"}

package/dist/server/metro/tools/symbolicate.d.ts

@@ -0,0 +1,3 @@
+import { type HostToolHandler } from '../../../server/host/types';
+export declare const symbolicateTool: () => HostToolHandler;
+//# sourceMappingURL=symbolicate.d.ts.map

package/dist/server/metro/tools/symbolicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolicate.d.ts","sourceRoot":"","sources":["../../../../src/server/metro/tools/symbolicate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA6F3D,eAAO,MAAM,eAAe,QAAO,eAoIlC,CAAC"}

package/dist/server/metro/tools/symbolicate.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.symbolicateTool = void 0;
+const resolveMetroUrl_1 = require("../../../server/metro/resolveMetroUrl");
+const METRO_TIMEOUT_MS = 5_000;
+const DEFAULT_MAX_FRAMES = 10;
+const MAX_FRAMES_CEILING = 100;
+/**
+ * Parses a raw Error.stack string into structured frames. Supports both the
+ * V8 `    at method (file:line:col)` format and the Hermes / JSC
+ * `method@file:line:col` form used by React Native. Returns an empty array if
+ * nothing matches so the caller can fall back gracefully.
+ */
+const parseStackString = (stack) => {
+    const frames = [];
+    const v8Regex = /^\s*at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?\s*$/gm;
+    let match;
+    while ((match = v8Regex.exec(stack)) !== null) {
+        frames.push({
+            column: Number.parseInt(match[4], 10),
+            file: match[2],
+            lineNumber: Number.parseInt(match[3], 10),
+            methodName: match[1]?.trim() || undefined,
+        });
+    }
+    if (frames.length > 0)
+        return frames;
+    const hermesRegex = /^(.*?)@(.+?):(\d+):(\d+)$/gm;
+    while ((match = hermesRegex.exec(stack)) !== null) {
+        frames.push({
+            column: Number.parseInt(match[4], 10),
+            file: match[2],
+            lineNumber: Number.parseInt(match[3], 10),
+            methodName: match[1]?.trim() || undefined,
+        });
+    }
+    return frames;
+};
+/**
+ * Shorten an absolute filesystem path by stripping the current working
+ * directory prefix. Leaves URLs and unrelated absolute paths untouched.
+ */
+const relativeToCwd = (file, cwd) => {
+    if (!file)
+        return file;
+    if (file.startsWith('http://') || file.startsWith('https://'))
+        return file;
+    if (file.startsWith(cwd + '/'))
+        return file.slice(cwd.length + 1);
+    if (file === cwd)
+        return '.';
+    return file;
+};
+/**
+ * Apply token-saving transforms to a resolved stack:
+ * 1. Drop framework frames (`collapse: true` from Metro = node_modules / RN
+ *    internals) unless explicitly kept via includeFrameworkFrames.
+ * 2. Trim to `maxFrames` (from the top — where the actual cause lives).
+ * 3. Rewrite file paths relative to cwd unless fullPaths is set.
+ * 4. Drop `collapse` from output (already used for filtering).
+ */
+const trimFrames = (frames, opts) => {
+    const filtered = opts.includeFramework
+        ? frames
+        : frames.filter((f) => {
+            return !f.collapse;
+        });
+    const limited = filtered.slice(0, opts.maxFrames);
+    const cwd = process.cwd();
+    return limited.map((f) => {
+        const out = {};
+        const file = opts.fullPaths ? f.file : relativeToCwd(f.file, cwd);
+        if (file)
+            out.file = file;
+        if (typeof f.lineNumber === 'number')
+            out.lineNumber = f.lineNumber;
+        if (typeof f.column === 'number' && f.column > 0)
+            out.column = f.column;
+        if (f.methodName)
+            out.methodName = f.methodName;
+        return out;
+    });
+};
+const symbolicateTool = () => {
+    return {
+        description: `Resolve a JS stack trace via Metro's /symbolicate endpoint — maps bundled paths like "http://localhost:8081/index.bundle:12345:67" back to original sources like "src/components/Foo.tsx:42:10".
+
+Pass either a raw stack string (from errors__get_errors.stack) or a parsed array of frames (from log_box__get_logs[*].stack). No-ops gracefully when Metro is unreachable (returns { skipped: true, error }), so safe to call opportunistically.
+
+TOKEN-SAVING DEFAULTS
+  - node_modules / RN-internal frames (collapse: true from Metro) are dropped.
+  - Only the top ${DEFAULT_MAX_FRAMES} frames returned.
+  - Absolute paths are shortened relative to the MCP server's cwd.
+  Opt-out via includeFrameworkFrames / maxFrames / fullPaths.`,
+        handler: async (args, ctx) => {
+            const stack = args.stack;
+            const frames = args.frames;
+            const metroUrl = (0, resolveMetroUrl_1.resolveMetroUrl)(args, ctx);
+            const includeFramework = args.includeFrameworkFrames === true;
+            const fullPaths = args.fullPaths === true;
+            const maxFrames = Math.max(1, Math.min(MAX_FRAMES_CEILING, typeof args.maxFrames === 'number' ? Math.floor(args.maxFrames) : DEFAULT_MAX_FRAMES));
+            const trimOpts = { fullPaths, includeFramework, maxFrames };
+            let rawFrames;
+            if (Array.isArray(frames) && frames.length > 0) {
+                rawFrames = frames;
+            }
+            else if (typeof stack === 'string' && stack.length > 0) {
+                rawFrames = parseStackString(stack);
+            }
+            else {
+                return { error: 'Pass either `stack` (string) or `frames` (array).' };
+            }
+            if (rawFrames.length === 0) {
+                return { error: 'No frames parsed from input.', frames: [], skipped: true };
+            }
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => {
+                    controller.abort();
+                }, METRO_TIMEOUT_MS);
+                const res = await fetch(`${metroUrl}/symbolicate`, {
+                    body: JSON.stringify({ stack: rawFrames }),
+                    headers: { 'Content-Type': 'application/json' },
+                    method: 'POST',
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (!res.ok) {
+                    return {
+                        error: `Metro responded ${res.status}`,
+                        frames: trimFrames(rawFrames, trimOpts),
+                        skipped: true,
+                    };
+                }
+                const json = (await res.json());
+                const resolved = json.stack ?? rawFrames;
+                const totalFrames = includeFramework
+                    ? resolved.length
+                    : resolved.filter((f) => {
+                        return !f.collapse;
+                    }).length;
+                const trimmed = trimFrames(resolved, trimOpts);
+                const result = { frames: trimmed, totalFrames };
+                if (!includeFramework) {
+                    result.droppedFrameworkFrames = resolved.length - totalFrames;
+                }
+                if (totalFrames > trimmed.length)
+                    result.truncated = true;
+                return result;
+            }
+            catch (err) {
+                return {
+                    error: `Metro at ${metroUrl} unreachable: ${err.message}`,
+                    frames: trimFrames(rawFrames, trimOpts),
+                    skipped: true,
+                };
+            }
+        },
+        inputSchema: {
+            clientId: {
+                description: 'Target client ID — used to pick up the Metro URL the app was actually loaded from (falls back to `metroUrl` or the hardcoded default).',
+                type: 'string',
+            },
+            frames: {
+                description: 'Parsed stack frames: [{ file, lineNumber, column, methodName? }]. Takes precedence over `stack` when both are provided.',
+                examples: [
+                    [
+                        {
+                            column: 42,
+                            file: 'http://localhost:8081/index.bundle',
+                            lineNumber: 1234,
+                            methodName: 'render',
+                        },
+                    ],
+                ],
+                type: 'array',
+            },
+            fullPaths: {
+                description: 'Return absolute file paths instead of ones relative to the MCP server cwd. Default false.',
+                type: 'boolean',
+            },
+            includeFrameworkFrames: {
+                description: 'Keep node_modules / React Native internal frames (marked collapse: true by Metro). Default false — framework noise is dropped to save tokens.',
+                type: 'boolean',
+            },
+            maxFrames: {
+                description: `Max frames to return after filtering (top-down). Default ${DEFAULT_MAX_FRAMES}, max ${MAX_FRAMES_CEILING}.`,
+                type: 'number',
+            },
+            metroUrl: {
+                description: `Base URL of the Metro dev server. Overrides the URL reported by the connected client. Default "http://localhost:8081".`,
+                type: 'string',
+            },
+            stack: {
+                description: 'Raw stack trace string (e.g. from an Error.stack). Parsed into frames.',
+                type: 'string',
+            },
+        },
+        timeout: METRO_TIMEOUT_MS + 1_000,
+    };
+};
+exports.symbolicateTool = symbolicateTool;
+//# sourceMappingURL=symbolicate.js.map

package/dist/server/metro/tools/symbolicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolicate.js","sourceRoot":"","sources":["../../../../src/server/metro/tools/symbolicate.ts"],"names":[],"mappings":"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"}

package/dist/shared/protocol.d.ts

@@ -24,6 +24,19 @@ export interface ModuleDescriptor {
     tools: ModuleToolDescriptor[];
     description?: string;
 }
+/**
+ * Metro dev-server origin the app was loaded from, detected in the client via
+ * `getDevServer()` (`react-native/Libraries/Core/Devtools/getDevServer`).
+ * Absent in production builds (where the bundle is loaded from disk) and when
+ * detection fails. Server-side `metro__*` tools (symbolicate, reload, etc.)
+ * use this instead of hardcoding `localhost:8081`.
+ */
+export interface DevServerInfo {
+    bundleLoadedFromServer: boolean;
+    host: string;
+    port: number;
+    url: string;
+}
 export interface RegistrationMessage {
     modules: ModuleDescriptor[];
     protocolVersion: number;
@@ -31,6 +44,7 @@ export interface RegistrationMessage {
     appName?: string;
     appVersion?: string;
     bundleId?: string;
+    devServer?: DevServerInfo;
     deviceId?: string;
     label?: string;
     platform?: string;

package/dist/shared/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/shared/protocol.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,yDAAyD;AACzD,eAAO,MAAM,cAAc,gBAAkD,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAI/C,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,kBAAkB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;CACtB;AAID,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;CACtB;AAID,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAID,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,YAAY,GACZ,qBAAqB,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,WAAW,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/shared/protocol.ts"],"names":[],"mappings":"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"}

package/dist/shared/slice.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared `slice` input shape for tools that expose a slice-style window into
+ * a time-ordered buffer. Two-tuple mirrors `Array.prototype.slice(start, end?)`:
+ * negative indices count from the end, so [-10] = last ten, [-20, -10] = the
+ * ten before those, [0, 50] = the oldest fifty.
+ */
+export type SliceInput = [number] | [number, number];
+/**
+ * Coerce a tool-argument value to a well-formed SliceInput, or undefined when
+ * the input is missing/malformed. Callers pick their own default behavior
+ * (typically either "return all" or "last N").
+ */
+export declare const parseSliceArg: (raw: unknown) => SliceInput | undefined;
+export declare const applySlice: <T>(arr: T[], slice: SliceInput | undefined) => T[];
+export declare const sliceSchemaDescription: (defaultHint: string) => string;
+//# sourceMappingURL=slice.d.ts.map

package/dist/shared/slice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice.d.ts","sourceRoot":"","sources":["../../src/shared/slice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAS,OAAO,KAAG,UAAU,GAAG,SAOzD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,GAAG,SAAS,KAAG,CAAC,EAIxE,CAAC;AAEF,eAAO,MAAM,sBAAsB,gBAAiB,MAAM,KAAG,MAE5D,CAAC"}

package/dist/shared/slice.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sliceSchemaDescription = exports.applySlice = exports.parseSliceArg = void 0;
+/**
+ * Coerce a tool-argument value to a well-formed SliceInput, or undefined when
+ * the input is missing/malformed. Callers pick their own default behavior
+ * (typically either "return all" or "last N").
+ */
+const parseSliceArg = (raw) => {
+    if (!Array.isArray(raw) || raw.length === 0 || typeof raw[0] !== 'number') {
+        return undefined;
+    }
+    const start = raw[0];
+    const end = typeof raw[1] === 'number' ? raw[1] : undefined;
+    return end === undefined ? [start] : [start, end];
+};
+exports.parseSliceArg = parseSliceArg;
+const applySlice = (arr, slice) => {
+    if (!slice)
+        return arr;
+    const [start, end] = slice;
+    return end === undefined ? arr.slice(start) : arr.slice(start, end);
+};
+exports.applySlice = applySlice;
+const sliceSchemaDescription = (defaultHint) => {
+    return `[start, end?] window over the returned list (Array.prototype.slice semantics, negative indices count from the end). ${defaultHint} Examples: [-10] for the newest ten, [-20, -10] for the ten before those, [0, 50] for the oldest fifty.`;
+};
+exports.sliceSchemaDescription = sliceSchemaDescription;
+//# sourceMappingURL=slice.js.map