metro-mcp 0.1.0

package/dist/metro/connection.d.ts

@@ -0,0 +1,66 @@
+import type { CDPConnection } from '../plugin.js';
+import type { MetroTarget } from './types.js';
+type CDPEventHandler = (params: Record<string, unknown>) => void;
+/**
+ * CDP WebSocket client that connects to a Hermes debugger target.
+ * Implements the CDPConnection interface used by plugins.
+ */
+export declare class CDPClient implements CDPConnection {
+    private ws;
+    private messageId;
+    private pendingRequests;
+    private eventHandlers;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private keepAliveTimer;
+    private connectingPromise;
+    private suppressReconnect;
+    private _isConnected;
+    private target;
+    private readonly maxReconnectAttempts;
+    private readonly reconnectDelays;
+    private readonly requestTimeout;
+    private readonly keepAliveInterval;
+    /**
+     * Connect to a CDP target.
+     */
+    connect(target: MetroTarget): Promise<void>;
+    /**
+     * Wait for an in-progress connection attempt to finish, if any.
+     */
+    waitForConnection(): Promise<boolean>;
+    private doConnect;
+    /**
+     * Send a CDP command and wait for the response.
+     */
+    send(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Subscribe to a CDP event.
+     */
+    on(event: string, handler: CDPEventHandler): void;
+    /**
+     * Unsubscribe from a CDP event.
+     */
+    off(event: string, handler: CDPEventHandler): void;
+    /**
+     * Check if connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Get the current target.
+     */
+    getTarget(): MetroTarget | null;
+    /**
+     * Disconnect and stop reconnecting.
+     */
+    disconnect(): void;
+    private clearReconnectTimer;
+    private startKeepAlive;
+    private stopKeepAlive;
+    private handleMessage;
+    private rejectAllPending;
+    private scheduleReconnect;
+    private emit;
+}
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/dist/metro/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/metro/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAA2B,WAAW,EAAE,MAAM,YAAY,CAAC;AAKvE,KAAK,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAQjE;;;GAGG;AACH,qBAAa,SAAU,YAAW,aAAa;IAC7C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAA4B;IAE1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAM;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAE3C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ3C,OAAO,CAAC,SAAS;IA2CjB;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB9E;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAOjD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAIlD;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,SAAS,IAAI,WAAW,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,IAAI;CAYb"}

package/dist/metro/discovery.d.ts

@@ -0,0 +1,19 @@
+import type { MetroTarget, MetroServerInfo } from './types.js';
+/**
+ * Fetch debuggable targets from a Metro server's /json endpoint.
+ */
+export declare function fetchTargets(host: string, port: number): Promise<MetroTarget[]>;
+/**
+ * Select the best target from a list.
+ * Priority: Bridgeless > Hermes > standard RN (skip Reanimated/Experimental).
+ */
+export declare function selectBestTarget(targets: MetroTarget[]): MetroTarget | null;
+/**
+ * Scan common Metro ports and find running servers.
+ */
+export declare function scanMetroPorts(host: string, specificPort?: number): Promise<MetroServerInfo[]>;
+/**
+ * Check if Metro is running (returns status).
+ */
+export declare function checkMetroStatus(host: string, port: number): Promise<string | null>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/metro/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/metro/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAO/D;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAYrF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,GAAG,IAAI,CAyB3E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAc5B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUzF"}

package/dist/metro/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Target info returned by Metro's /json endpoint.
+ */
+export interface MetroTarget {
+    id: string;
+    title: string;
+    description: string;
+    type: string;
+    devtoolsFrontendUrl?: string;
+    webSocketDebuggerUrl: string;
+    faviconUrl?: string;
+    url?: string;
+    deviceName?: string;
+    reactNative?: {
+        logicalDeviceId?: string;
+    };
+    vm?: string;
+}
+/**
+ * CDP message sent to the debugger.
+ */
+export interface CDPRequest {
+    id: number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * CDP response from the debugger.
+ */
+export interface CDPResponse {
+    id?: number;
+    method?: string;
+    params?: Record<string, unknown>;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * Discovered Metro server info.
+ */
+export interface MetroServerInfo {
+    host: string;
+    port: number;
+    targets: MetroTarget[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/metro/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metro/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE;QACZ,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB"}

package/dist/plugin.cjs

@@ -0,0 +1,51 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/plugin.ts
+var exports_plugin = {};
+__export(exports_plugin, {
+  definePlugin: () => definePlugin,
+  defineConfig: () => defineConfig
+});
+module.exports = __toCommonJS(exports_plugin);
+function definePlugin(plugin) {
+  return plugin;
+}
+function defineConfig(config) {
+  return config;
+}

package/dist/plugin.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+export interface CDPConnection {
+    send(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    on(event: string, handler: (params: Record<string, unknown>) => void): void;
+    off(event: string, handler: (params: Record<string, unknown>) => void): void;
+    isConnected(): boolean;
+}
+export interface FormatUtils {
+    summarize<T>(items: T[], lastN?: number): string;
+    compact(obj: unknown): string;
+    truncate(str: string, maxLen: number): string;
+    structureOnly(tree: ComponentNode): ComponentNode;
+}
+export interface ComponentNode {
+    name: string;
+    children?: ComponentNode[];
+    props?: Record<string, unknown>;
+    state?: unknown;
+    [key: string]: unknown;
+}
+export interface ToolConfig<T extends z.ZodType = z.ZodType> {
+    description: string;
+    parameters: T;
+    handler: (args: z.infer<T>) => Promise<unknown>;
+}
+export interface ResourceConfig {
+    name: string;
+    description: string;
+    mimeType?: string;
+    handler: () => Promise<string>;
+}
+export interface PromptConfig {
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+    handler: (args: Record<string, string>) => Promise<Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>>;
+}
+export interface EvalOptions {
+    /** Wait for a returned Promise to resolve before returning the value */
+    awaitPromise?: boolean;
+    /** CDP timeout in milliseconds (default: 10000) */
+    timeout?: number;
+}
+export interface PluginContext {
+    cdp: CDPConnection;
+    registerTool<T extends z.ZodType>(name: string, config: ToolConfig<T>): void;
+    registerResource(uri: string, config: ResourceConfig): void;
+    registerPrompt(name: string, config: PromptConfig): void;
+    config: Record<string, unknown>;
+    logger: Logger;
+    metro: {
+        host: string;
+        port: number;
+        fetch(path: string): Promise<Response>;
+    };
+    exec(command: string): Promise<string>;
+    format: FormatUtils;
+    /** Evaluate a JavaScript expression in the connected app runtime */
+    evalInApp(expression: string, options?: EvalOptions): Promise<unknown>;
+}
+export interface Logger {
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+}
+export interface PluginDefinition {
+    name: string;
+    version: string;
+    description?: string;
+    setup(ctx: PluginContext): Promise<void>;
+}
+export declare function definePlugin(plugin: PluginDefinition): PluginDefinition;
+export interface MetroMCPConfig {
+    metro?: {
+        host?: string;
+        port?: number;
+        autoDiscover?: boolean;
+    };
+    plugins?: string[];
+    bufferSizes?: {
+        logs?: number;
+        network?: number;
+        errors?: number;
+    };
+    network?: {
+        interceptFetch?: boolean;
+    };
+}
+export declare function defineConfig(config: MetroMCPConfig): MetroMCPConfig;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -0,0 +1,14 @@
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/plugin.ts
+function definePlugin(plugin) {
+  return plugin;
+}
+function defineConfig(config) {
+  return config;
+}
+export {
+  definePlugin,
+  defineConfig
+};

package/dist/plugins/accessibility.d.ts

@@ -0,0 +1,2 @@
+export declare const accessibilityPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/plugins/accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/plugins/accessibility.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,mBAAmB,yCAgQ9B,CAAC"}

package/dist/plugins/appium.d.ts

@@ -0,0 +1,2 @@
+export declare const appiumPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=appium.d.ts.map

package/dist/plugins/appium.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appium.d.ts","sourceRoot":"","sources":["../../src/plugins/appium.ts"],"names":[],"mappings":"AAuEA,eAAO,MAAM,YAAY,yCA6WvB,CAAC"}

package/dist/plugins/bundle.d.ts

@@ -0,0 +1,2 @@
+export declare const bundlePlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/plugins/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/plugins/bundle.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,YAAY,yCA4FvB,CAAC"}

package/dist/plugins/commands.d.ts

@@ -0,0 +1,2 @@
+export declare const commandsPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=commands.d.ts.map

package/dist/plugins/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/plugins/commands.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,cAAc,yCAyEzB,CAAC"}

package/dist/plugins/components.d.ts

@@ -0,0 +1,2 @@
+export declare const componentsPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=components.d.ts.map

package/dist/plugins/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/plugins/components.ts"],"names":[],"mappings":"AA4FA,eAAO,MAAM,gBAAgB,yCAsL3B,CAAC"}

package/dist/plugins/console.d.ts

@@ -0,0 +1,2 @@
+export declare const consolePlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=console.d.ts.map

package/dist/plugins/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/plugins/console.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,aAAa,yCAgFxB,CAAC"}

package/dist/plugins/deeplink.d.ts

@@ -0,0 +1,2 @@
+export declare const deeplinkPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=deeplink.d.ts.map

package/dist/plugins/deeplink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deeplink.d.ts","sourceRoot":"","sources":["../../src/plugins/deeplink.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,yCA+EzB,CAAC"}

package/dist/plugins/device.d.ts

@@ -0,0 +1,2 @@
+export declare const devicePlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=device.d.ts.map

package/dist/plugins/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/plugins/device.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,YAAY,yCAsGvB,CAAC"}

package/dist/plugins/errors.d.ts

@@ -0,0 +1,2 @@
+export declare const errorsPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=errors.d.ts.map

package/dist/plugins/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/plugins/errors.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,YAAY,yCAqGvB,CAAC"}

package/dist/plugins/evaluate.d.ts

@@ -0,0 +1,2 @@
+export declare const evaluatePlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/plugins/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/plugins/evaluate.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,yCAuBzB,CAAC"}

package/dist/plugins/maestro.d.ts

@@ -0,0 +1,2 @@
+export declare const maestroPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=maestro.d.ts.map

package/dist/plugins/maestro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maestro.d.ts","sourceRoot":"","sources":["../../src/plugins/maestro.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,yCA+JxB,CAAC"}

package/dist/plugins/navigation.d.ts

@@ -0,0 +1,2 @@
+export declare const navigationPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/plugins/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/plugins/navigation.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,yCAuK3B,CAAC"}

package/dist/plugins/network.d.ts

@@ -0,0 +1,2 @@
+export declare const networkPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=network.d.ts.map

package/dist/plugins/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/plugins/network.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,aAAa,yCAwJxB,CAAC"}

package/dist/plugins/prompts.d.ts

@@ -0,0 +1,2 @@
+export declare const promptsPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/plugins/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/plugins/prompts.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,yCAyIxB,CAAC"}

package/dist/plugins/redux.d.ts

@@ -0,0 +1,2 @@
+export declare const reduxPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=redux.d.ts.map

package/dist/plugins/redux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redux.d.ts","sourceRoot":"","sources":["../../src/plugins/redux.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,yCA+HtB,CAAC"}

package/dist/plugins/simulator.d.ts

@@ -0,0 +1,2 @@
+export declare const simulatorPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=simulator.d.ts.map

package/dist/plugins/simulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulator.d.ts","sourceRoot":"","sources":["../../src/plugins/simulator.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,yCA2N1B,CAAC"}

package/dist/plugins/source.d.ts

@@ -0,0 +1,2 @@
+export declare const sourcePlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=source.d.ts.map

package/dist/plugins/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/plugins/source.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,yCA4CvB,CAAC"}

package/dist/plugins/storage.d.ts

@@ -0,0 +1,2 @@
+export declare const storagePlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=storage.d.ts.map

package/dist/plugins/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/plugins/storage.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,yCAsFxB,CAAC"}

package/dist/plugins/ui-interact.d.ts

@@ -0,0 +1,2 @@
+export declare const uiInteractPlugin: import("../plugin.js").PluginDefinition;
+//# sourceMappingURL=ui-interact.d.ts.map

package/dist/plugins/ui-interact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-interact.d.ts","sourceRoot":"","sources":["../../src/plugins/ui-interact.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,gBAAgB,yCA4hB3B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import type { MetroMCPConfig } from './plugin.js';
+export declare function startServer(config: Required<MetroMCPConfig>): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EAOf,MAAM,aAAa,CAAC;AAoDrB,wBAAsB,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgOjF"}

package/dist/utils/buffer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Fixed-size circular buffer for storing log entries, network requests, etc.
+ * When full, oldest entries are overwritten.
+ */
+export declare class CircularBuffer<T> {
+    private readonly capacity;
+    private items;
+    private head;
+    private count;
+    constructor(capacity: number);
+    push(item: T): void;
+    getAll(): T[];
+    getLast(n: number): T[];
+    filter(predicate: (item: T) => boolean): T[];
+    clear(): void;
+    get size(): number;
+    get maxSize(): number;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/utils/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/utils/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC;IAKf,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;gBAEW,QAAQ,EAAE,MAAM;IAI7C,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAUnB,MAAM,IAAI,CAAC,EAAE;IAQb,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;IAKvB,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,EAAE;IAI5C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}

package/dist/utils/cdp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extract a human-readable message from a CDP exceptionDetails object.
+ * Works for both Runtime.evaluate responses and Runtime.exceptionThrown events.
+ */
+export declare function extractCDPExceptionMessage(details: Record<string, unknown>, fallback?: string): string;
+//# sourceMappingURL=cdp.d.ts.map

package/dist/utils/cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../src/utils/cdp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,SAAsB,GAC7B,MAAM,CAQR"}

package/dist/utils/fiber.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared fiber tree utilities used across plugins.
+ *
+ * JS string constants are embedded into evalInApp() calls, so they must be
+ * valid JavaScript and cannot reference TypeScript imports.
+ */
+/**
+ * Inline JS snippet that resolves `rootFiber` from the React DevTools hook.
+ * Embed at the top of an IIFE; uses `return` to exit early on failure.
+ * The early-return value should match the IIFE's failure sentinel (null or []).
+ */
+export declare const FIBER_ROOT_JS = "\n  var hook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;\n  if (!hook || !hook.getFiberRoots) return null;\n  var fiberRoots;\n  try {\n    for (var i = 1; i <= 5; i++) {\n      fiberRoots = hook.getFiberRoots(i);\n      if (fiberRoots && fiberRoots.size > 0) break;\n    }\n  } catch(e) { return null; }\n  if (!fiberRoots || fiberRoots.size === 0) return null;\n  var rootFiber = Array.from(fiberRoots)[0].current;\n";
+/**
+ * Complete standalone IIFE that collects testable elements from the fiber tree.
+ * Returns an array of { name, testID, accessibilityLabel, accessibilityRole, text, interactive }.
+ * Uses an iterative stack to safely handle deep navigation trees (depth 200+).
+ */
+export declare const COLLECT_ELEMENTS_JS = "\n  (function() {\n    var hook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;\n    if (!hook || !hook.getFiberRoots) return [];\n    var fiberRoots;\n    try {\n      for (var i = 1; i <= 5; i++) {\n        fiberRoots = hook.getFiberRoots(i);\n        if (fiberRoots && fiberRoots.size > 0) break;\n      }\n    } catch(e) { return []; }\n    if (!fiberRoots || fiberRoots.size === 0) return [];\n    var rootFiber = Array.from(fiberRoots)[0].current;\n    var elements = [];\n    var seen = {};\n    var stack = [{ f: rootFiber, d: 0 }];\n    while (stack.length) {\n      var item = stack.pop();\n      var fiber = item.f; var depth = item.d;\n      if (!fiber || depth > 200) continue;\n      var type = fiber.type;\n      var name = typeof type === 'string' ? type : (type && (type.displayName || type.name));\n      if (name && name.indexOf('RCT') !== 0) {\n        var props = fiber.memoizedProps || {};\n        var testID = props.testID || null;\n        var label = props.accessibilityLabel || props['aria-label'] || null;\n        var key = testID || label;\n        if ((testID || label || typeof props.children === 'string') && (!key || !seen[key])) {\n          if (key) seen[key] = true;\n          elements.push({\n            name: name,\n            testID: testID,\n            accessibilityLabel: label,\n            accessibilityRole: props.accessibilityRole || props['role'] || null,\n            text: typeof props.children === 'string' ? props.children : null,\n            interactive: !!(props.onPress || props.onPressIn || props.onClick),\n          });\n        }\n      }\n      if (fiber.sibling) stack.push({ f: fiber.sibling, d: depth });\n      if (fiber.child) stack.push({ f: fiber.child, d: depth + 1 });\n    }\n    return elements;\n  })()\n";
+export interface TestableElement {
+    name: string;
+    testID?: string;
+    accessibilityLabel?: string;
+    accessibilityRole?: string;
+    text?: string;
+    interactive?: boolean;
+}
+type EvalFn = (expr: string, opts?: {
+    timeout?: number;
+    awaitPromise?: boolean;
+}) => Promise<unknown>;
+export declare function collectElements(evalInApp: EvalFn): Promise<TestableElement[]>;
+export {};
+//# sourceMappingURL=fiber.d.ts.map

package/dist/utils/fiber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiber.d.ts","sourceRoot":"","sources":["../../src/utils/fiber.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,waAYzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,svDA4C/B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtG,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAEnF"}

package/dist/utils/format.d.ts

@@ -0,0 +1,34 @@
+import type { ComponentNode, FormatUtils } from '../plugin.js';
+/**
+ * Summarize a list of items: "47 items. Last 5: ..."
+ */
+export declare function summarize<T>(items: T[], lastN?: number): string;
+/**
+ * Compact representation: single-line key=value format.
+ */
+export declare function compact(obj: unknown): string;
+/**
+ * Truncate a string with "..." suffix.
+ */
+export declare function truncate(str: string, maxLen: number): string;
+/**
+ * Strip props and state from a component tree, keeping only names and structure.
+ */
+export declare function structureOnly(tree: ComponentNode): ComponentNode;
+/**
+ * Format a timestamp to a readable string.
+ */
+export declare function formatTimestamp(ts: number): string;
+/**
+ * Escape a string for safe embedding inside a JS single-quoted string literal.
+ */
+export declare function escapeJsString(str: string): string;
+/**
+ * Format bytes to human-readable string.
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Create a FormatUtils instance.
+ */
+export declare function createFormatUtils(): FormatUtils;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE/D;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,CAS1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,CAMhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from '../plugin.js';
+export declare function createLogger(name: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjD"}