@metamask/client-mcp-core 0.1.0

package/dist/utils/fetch.cjs

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchWithTimeout = fetchWithTimeout;
+/**
+ * Fetch with configurable timeout using AbortController
+ *
+ * @param url - The URL to fetch
+ * @param options - Standard fetch options (method, headers, body, etc.)
+ * @param timeoutMs - Timeout in milliseconds (default: 5000ms)
+ * @returns Promise resolving to the fetch Response
+ * @throws Error if the request times out or fails
+ *
+ * @example
+ * ```typescript
+ * const response = await fetchWithTimeout(
+ *   'http://localhost:8545',
+ *   { method: 'GET' },
+ *   3000
+ * );
+ * ```
+ */
+async function fetchWithTimeout(url, options = {}, timeoutMs = 5000) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+        });
+        return response;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=fetch.cjs.map

package/dist/utils/fetch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.cjs","sourceRoot":"","sources":["../../src/utils/fetch.ts"],"names":[],"mappings":";;AAkBA,4CAiBC;AAnCD;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,UAAuB,EAAE,EACzB,SAAS,GAAG,IAAI;IAEhB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,GAAG,OAAO;YACV,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC","sourcesContent":["/**\n * Fetch with configurable timeout using AbortController\n *\n * @param url - The URL to fetch\n * @param options - Standard fetch options (method, headers, body, etc.)\n * @param timeoutMs - Timeout in milliseconds (default: 5000ms)\n * @returns Promise resolving to the fetch Response\n * @throws Error if the request times out or fails\n *\n * @example\n * ```typescript\n * const response = await fetchWithTimeout(\n *   'http://localhost:8545',\n *   { method: 'GET' },\n *   3000\n * );\n * ```\n */\nexport async function fetchWithTimeout(\n  url: string,\n  options: RequestInit = {},\n  timeoutMs = 5000,\n): Promise<Response> {\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const response = await fetch(url, {\n      ...options,\n      signal: controller.signal,\n    });\n    return response;\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n"]}

package/dist/utils/fetch.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Fetch with configurable timeout using AbortController
+ *
+ * @param url - The URL to fetch
+ * @param options - Standard fetch options (method, headers, body, etc.)
+ * @param timeoutMs - Timeout in milliseconds (default: 5000ms)
+ * @returns Promise resolving to the fetch Response
+ * @throws Error if the request times out or fails
+ *
+ * @example
+ * ```typescript
+ * const response = await fetchWithTimeout(
+ *   'http://localhost:8545',
+ *   { method: 'GET' },
+ *   3000
+ * );
+ * ```
+ */
+export declare function fetchWithTimeout(url: string, options?: RequestInit, timeoutMs?: number): Promise<Response>;
+//# sourceMappingURL=fetch.d.cts.map

package/dist/utils/fetch.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.cts","sourceRoot":"","sources":["../../src/utils/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,SAAS,SAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAanB"}

package/dist/utils/fetch.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Fetch with configurable timeout using AbortController
+ *
+ * @param url - The URL to fetch
+ * @param options - Standard fetch options (method, headers, body, etc.)
+ * @param timeoutMs - Timeout in milliseconds (default: 5000ms)
+ * @returns Promise resolving to the fetch Response
+ * @throws Error if the request times out or fails
+ *
+ * @example
+ * ```typescript
+ * const response = await fetchWithTimeout(
+ *   'http://localhost:8545',
+ *   { method: 'GET' },
+ *   3000
+ * );
+ * ```
+ */
+export declare function fetchWithTimeout(url: string, options?: RequestInit, timeoutMs?: number): Promise<Response>;
+//# sourceMappingURL=fetch.d.mts.map

package/dist/utils/fetch.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.mts","sourceRoot":"","sources":["../../src/utils/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,SAAS,SAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAanB"}

package/dist/utils/fetch.mjs

@@ -0,0 +1,33 @@
+/**
+ * Fetch with configurable timeout using AbortController
+ *
+ * @param url - The URL to fetch
+ * @param options - Standard fetch options (method, headers, body, etc.)
+ * @param timeoutMs - Timeout in milliseconds (default: 5000ms)
+ * @returns Promise resolving to the fetch Response
+ * @throws Error if the request times out or fails
+ *
+ * @example
+ * ```typescript
+ * const response = await fetchWithTimeout(
+ *   'http://localhost:8545',
+ *   { method: 'GET' },
+ *   3000
+ * );
+ * ```
+ */
+export async function fetchWithTimeout(url, options = {}, timeoutMs = 5000) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+        });
+        return response;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=fetch.mjs.map

package/dist/utils/fetch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.mjs","sourceRoot":"","sources":["../../src/utils/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,UAAuB,EAAE,EACzB,SAAS,GAAG,IAAI;IAEhB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,GAAG,OAAO;YACV,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC","sourcesContent":["/**\n * Fetch with configurable timeout using AbortController\n *\n * @param url - The URL to fetch\n * @param options - Standard fetch options (method, headers, body, etc.)\n * @param timeoutMs - Timeout in milliseconds (default: 5000ms)\n * @returns Promise resolving to the fetch Response\n * @throws Error if the request times out or fails\n *\n * @example\n * ```typescript\n * const response = await fetchWithTimeout(\n *   'http://localhost:8545',\n *   { method: 'GET' },\n *   3000\n * );\n * ```\n */\nexport async function fetchWithTimeout(\n  url: string,\n  options: RequestInit = {},\n  timeoutMs = 5000,\n): Promise<Response> {\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const response = await fetch(url, {\n      ...options,\n      signal: controller.signal,\n    });\n    return response;\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n"]}

package/dist/utils/index.cjs

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Shared utility functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForServiceReady = exports.fetchWithTimeout = void 0;
+var fetch_js_1 = require("./fetch.cjs");
+Object.defineProperty(exports, "fetchWithTimeout", { enumerable: true, get: function () { return fetch_js_1.fetchWithTimeout; } });
+var service_readiness_js_1 = require("./service-readiness.cjs");
+Object.defineProperty(exports, "waitForServiceReady", { enumerable: true, get: function () { return service_readiness_js_1.waitForServiceReady; } });
+//# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,wCAA8C;AAArC,4GAAA,gBAAgB,OAAA;AACzB,gEAGgC;AAF9B,2HAAA,mBAAmB,OAAA","sourcesContent":["/**\n * Shared utility functions\n */\n\nexport { fetchWithTimeout } from './fetch.js';\nexport {\n  waitForServiceReady,\n  type WaitForServiceReadyOptions,\n} from './service-readiness.js';\n"]}

package/dist/utils/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Shared utility functions
+ */
+export { fetchWithTimeout } from "./fetch.cjs";
+export { waitForServiceReady, type WaitForServiceReadyOptions, } from "./service-readiness.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/utils/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAmB;AAC9C,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,gCAA+B"}

package/dist/utils/index.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Shared utility functions
+ */
+export { fetchWithTimeout } from "./fetch.mjs";
+export { waitForServiceReady, type WaitForServiceReadyOptions, } from "./service-readiness.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/utils/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAmB;AAC9C,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,gCAA+B"}

package/dist/utils/index.mjs

@@ -0,0 +1,6 @@
+/**
+ * Shared utility functions
+ */
+export { fetchWithTimeout } from "./fetch.mjs";
+export { waitForServiceReady } from "./service-readiness.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAmB;AAC9C,OAAO,EACL,mBAAmB,EAEpB,gCAA+B","sourcesContent":["/**\n * Shared utility functions\n */\n\nexport { fetchWithTimeout } from './fetch.js';\nexport {\n  waitForServiceReady,\n  type WaitForServiceReadyOptions,\n} from './service-readiness.js';\n"]}

package/dist/utils/service-readiness.cjs

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForServiceReady = waitForServiceReady;
+const fetch_js_1 = require("./fetch.cjs");
+/**
+ * Wait for a service to become ready by polling an endpoint
+ *
+ * Repeatedly attempts to fetch from the given URL until either:
+ * - The service responds with a successful status (2xx or 503)
+ * - Maximum attempts are reached (throws error)
+ *
+ * @param url - The URL to poll for service readiness
+ * @param options - Configuration options
+ * @throws Error if service doesn't become ready within maxAttempts
+ *
+ * @example
+ * ```typescript
+ * // Wait for fixture server to be ready
+ * await waitForServiceReady('http://localhost:12345/state.json', {
+ *   maxAttempts: 10,
+ *   delayMs: 500,
+ *   timeoutMs: 3000,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom fetch function
+ * await waitForServiceReady('http://localhost:8545', {
+ *   fetchFn: customFetch,
+ *   maxAttempts: 5,
+ * });
+ * ```
+ */
+async function waitForServiceReady(url, options = {}) {
+    const { maxAttempts = 10, delayMs = 500, fetchFn = fetch_js_1.fetchWithTimeout, timeoutMs = 3000, } = options;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            const response = await fetchFn(url, {}, timeoutMs);
+            // Service is ready if it responds with 2xx or 503 (service unavailable but responding)
+            if (response.ok || response.status === 503) {
+                return;
+            }
+        }
+        catch (error) {
+            const caughtError = error;
+            // Connection refused - service not yet started, retry
+            if (caughtError.cause &&
+                JSON.stringify(caughtError.cause).includes('ECONNREFUSED')) {
+                await delay(delayMs);
+                continue;
+            }
+            // Timeout - service slow to respond, retry
+            if (caughtError.name === 'AbortError') {
+                await delay(delayMs);
+                continue;
+            }
+            // Other errors (e.g., self-signed cert accepted) - consider service ready
+            return;
+        }
+        // Response received but not ok/503 - retry
+        await delay(delayMs);
+    }
+    throw new Error(`Service at ${url} failed to become ready after ${maxAttempts} attempts`);
+}
+/**
+ * Delay helper function.
+ *
+ * @param ms - The delay in milliseconds.
+ * @returns A promise that resolves after the delay.
+ */
+async function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=service-readiness.cjs.map

package/dist/utils/service-readiness.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-readiness.cjs","sourceRoot":"","sources":["../../src/utils/service-readiness.ts"],"names":[],"mappings":";;AAiEA,kDAgDC;AAjHD,0CAA8C;AAmC9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACI,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,UAAsC,EAAE;IAExC,MAAM,EACJ,WAAW,GAAG,EAAE,EAChB,OAAO,GAAG,GAAG,EACb,OAAO,GAAG,2BAAgB,EAC1B,SAAS,GAAG,IAAI,GACjB,GAAG,OAAO,CAAC;IAEZ,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;YAEnD,uFAAuF;YACvF,IAAI,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC3C,OAAO;YACT,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,KAAc,CAAC;YAEnC,sDAAsD;YACtD,IACE,WAAW,CAAC,KAAK;gBACjB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,EAC1D,CAAC;gBACD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,2CAA2C;YAC3C,IAAI,WAAW,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACtC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,0EAA0E;YAC1E,OAAO;QACT,CAAC;QAED,2CAA2C;QAC3C,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,cAAc,GAAG,iCAAiC,WAAW,WAAW,CACzE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,KAAK,CAAC,EAAU;IAC7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import { fetchWithTimeout } from './fetch.js';\n\n/**\n * Options for waitForServiceReady\n */\nexport type WaitForServiceReadyOptions = {\n  /**\n   * Maximum number of attempts to check service readiness\n   *\n   * @default 10\n   */\n  maxAttempts?: number;\n\n  /**\n   * Delay in milliseconds between attempts\n   *\n   * @default 500\n   */\n  delayMs?: number;\n\n  /**\n   * Custom fetch function (useful for testing or custom timeout behavior)\n   *\n   * @default fetchWithTimeout\n   */\n  fetchFn?: typeof fetch;\n\n  /**\n   * Timeout in milliseconds for each fetch attempt\n   *\n   * @default 3000\n   */\n  timeoutMs?: number;\n};\n\n/**\n * Wait for a service to become ready by polling an endpoint\n *\n * Repeatedly attempts to fetch from the given URL until either:\n * - The service responds with a successful status (2xx or 503)\n * - Maximum attempts are reached (throws error)\n *\n * @param url - The URL to poll for service readiness\n * @param options - Configuration options\n * @throws Error if service doesn't become ready within maxAttempts\n *\n * @example\n * ```typescript\n * // Wait for fixture server to be ready\n * await waitForServiceReady('http://localhost:12345/state.json', {\n *   maxAttempts: 10,\n *   delayMs: 500,\n *   timeoutMs: 3000,\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With custom fetch function\n * await waitForServiceReady('http://localhost:8545', {\n *   fetchFn: customFetch,\n *   maxAttempts: 5,\n * });\n * ```\n */\nexport async function waitForServiceReady(\n  url: string,\n  options: WaitForServiceReadyOptions = {},\n): Promise<void> {\n  const {\n    maxAttempts = 10,\n    delayMs = 500,\n    fetchFn = fetchWithTimeout,\n    timeoutMs = 3000,\n  } = options;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      const response = await fetchFn(url, {}, timeoutMs);\n\n      // Service is ready if it responds with 2xx or 503 (service unavailable but responding)\n      if (response.ok || response.status === 503) {\n        return;\n      }\n    } catch (error) {\n      const caughtError = error as Error;\n\n      // Connection refused - service not yet started, retry\n      if (\n        caughtError.cause &&\n        JSON.stringify(caughtError.cause).includes('ECONNREFUSED')\n      ) {\n        await delay(delayMs);\n        continue;\n      }\n\n      // Timeout - service slow to respond, retry\n      if (caughtError.name === 'AbortError') {\n        await delay(delayMs);\n        continue;\n      }\n\n      // Other errors (e.g., self-signed cert accepted) - consider service ready\n      return;\n    }\n\n    // Response received but not ok/503 - retry\n    await delay(delayMs);\n  }\n\n  throw new Error(\n    `Service at ${url} failed to become ready after ${maxAttempts} attempts`,\n  );\n}\n\n/**\n * Delay helper function.\n *\n * @param ms - The delay in milliseconds.\n * @returns A promise that resolves after the delay.\n */\nasync function delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}

package/dist/utils/service-readiness.d.cts

@@ -0,0 +1,61 @@
+/**
+ * Options for waitForServiceReady
+ */
+export type WaitForServiceReadyOptions = {
+    /**
+     * Maximum number of attempts to check service readiness
+     *
+     * @default 10
+     */
+    maxAttempts?: number;
+    /**
+     * Delay in milliseconds between attempts
+     *
+     * @default 500
+     */
+    delayMs?: number;
+    /**
+     * Custom fetch function (useful for testing or custom timeout behavior)
+     *
+     * @default fetchWithTimeout
+     */
+    fetchFn?: typeof fetch;
+    /**
+     * Timeout in milliseconds for each fetch attempt
+     *
+     * @default 3000
+     */
+    timeoutMs?: number;
+};
+/**
+ * Wait for a service to become ready by polling an endpoint
+ *
+ * Repeatedly attempts to fetch from the given URL until either:
+ * - The service responds with a successful status (2xx or 503)
+ * - Maximum attempts are reached (throws error)
+ *
+ * @param url - The URL to poll for service readiness
+ * @param options - Configuration options
+ * @throws Error if service doesn't become ready within maxAttempts
+ *
+ * @example
+ * ```typescript
+ * // Wait for fixture server to be ready
+ * await waitForServiceReady('http://localhost:12345/state.json', {
+ *   maxAttempts: 10,
+ *   delayMs: 500,
+ *   timeoutMs: 3000,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom fetch function
+ * await waitForServiceReady('http://localhost:8545', {
+ *   fetchFn: customFetch,
+ *   maxAttempts: 5,
+ * });
+ * ```
+ */
+export declare function waitForServiceReady(url: string, options?: WaitForServiceReadyOptions): Promise<void>;
+//# sourceMappingURL=service-readiness.d.cts.map

package/dist/utils/service-readiness.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-readiness.d.cts","sourceRoot":"","sources":["../../src/utils/service-readiness.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAEvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/utils/service-readiness.d.mts

@@ -0,0 +1,61 @@
+/**
+ * Options for waitForServiceReady
+ */
+export type WaitForServiceReadyOptions = {
+    /**
+     * Maximum number of attempts to check service readiness
+     *
+     * @default 10
+     */
+    maxAttempts?: number;
+    /**
+     * Delay in milliseconds between attempts
+     *
+     * @default 500
+     */
+    delayMs?: number;
+    /**
+     * Custom fetch function (useful for testing or custom timeout behavior)
+     *
+     * @default fetchWithTimeout
+     */
+    fetchFn?: typeof fetch;
+    /**
+     * Timeout in milliseconds for each fetch attempt
+     *
+     * @default 3000
+     */
+    timeoutMs?: number;
+};
+/**
+ * Wait for a service to become ready by polling an endpoint
+ *
+ * Repeatedly attempts to fetch from the given URL until either:
+ * - The service responds with a successful status (2xx or 503)
+ * - Maximum attempts are reached (throws error)
+ *
+ * @param url - The URL to poll for service readiness
+ * @param options - Configuration options
+ * @throws Error if service doesn't become ready within maxAttempts
+ *
+ * @example
+ * ```typescript
+ * // Wait for fixture server to be ready
+ * await waitForServiceReady('http://localhost:12345/state.json', {
+ *   maxAttempts: 10,
+ *   delayMs: 500,
+ *   timeoutMs: 3000,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom fetch function
+ * await waitForServiceReady('http://localhost:8545', {
+ *   fetchFn: customFetch,
+ *   maxAttempts: 5,
+ * });
+ * ```
+ */
+export declare function waitForServiceReady(url: string, options?: WaitForServiceReadyOptions): Promise<void>;
+//# sourceMappingURL=service-readiness.d.mts.map

package/dist/utils/service-readiness.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-readiness.d.mts","sourceRoot":"","sources":["../../src/utils/service-readiness.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAEvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/utils/service-readiness.mjs

@@ -0,0 +1,72 @@
+import { fetchWithTimeout } from "./fetch.mjs";
+/**
+ * Wait for a service to become ready by polling an endpoint
+ *
+ * Repeatedly attempts to fetch from the given URL until either:
+ * - The service responds with a successful status (2xx or 503)
+ * - Maximum attempts are reached (throws error)
+ *
+ * @param url - The URL to poll for service readiness
+ * @param options - Configuration options
+ * @throws Error if service doesn't become ready within maxAttempts
+ *
+ * @example
+ * ```typescript
+ * // Wait for fixture server to be ready
+ * await waitForServiceReady('http://localhost:12345/state.json', {
+ *   maxAttempts: 10,
+ *   delayMs: 500,
+ *   timeoutMs: 3000,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom fetch function
+ * await waitForServiceReady('http://localhost:8545', {
+ *   fetchFn: customFetch,
+ *   maxAttempts: 5,
+ * });
+ * ```
+ */
+export async function waitForServiceReady(url, options = {}) {
+    const { maxAttempts = 10, delayMs = 500, fetchFn = fetchWithTimeout, timeoutMs = 3000, } = options;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            const response = await fetchFn(url, {}, timeoutMs);
+            // Service is ready if it responds with 2xx or 503 (service unavailable but responding)
+            if (response.ok || response.status === 503) {
+                return;
+            }
+        }
+        catch (error) {
+            const caughtError = error;
+            // Connection refused - service not yet started, retry
+            if (caughtError.cause &&
+                JSON.stringify(caughtError.cause).includes('ECONNREFUSED')) {
+                await delay(delayMs);
+                continue;
+            }
+            // Timeout - service slow to respond, retry
+            if (caughtError.name === 'AbortError') {
+                await delay(delayMs);
+                continue;
+            }
+            // Other errors (e.g., self-signed cert accepted) - consider service ready
+            return;
+        }
+        // Response received but not ok/503 - retry
+        await delay(delayMs);
+    }
+    throw new Error(`Service at ${url} failed to become ready after ${maxAttempts} attempts`);
+}
+/**
+ * Delay helper function.
+ *
+ * @param ms - The delay in milliseconds.
+ * @returns A promise that resolves after the delay.
+ */
+async function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=service-readiness.mjs.map

package/dist/utils/service-readiness.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-readiness.mjs","sourceRoot":"","sources":["../../src/utils/service-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAmB;AAmC9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,UAAsC,EAAE;IAExC,MAAM,EACJ,WAAW,GAAG,EAAE,EAChB,OAAO,GAAG,GAAG,EACb,OAAO,GAAG,gBAAgB,EAC1B,SAAS,GAAG,IAAI,GACjB,GAAG,OAAO,CAAC;IAEZ,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;YAEnD,uFAAuF;YACvF,IAAI,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC3C,OAAO;YACT,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,KAAc,CAAC;YAEnC,sDAAsD;YACtD,IACE,WAAW,CAAC,KAAK;gBACjB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,EAC1D,CAAC;gBACD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,2CAA2C;YAC3C,IAAI,WAAW,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACtC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,0EAA0E;YAC1E,OAAO;QACT,CAAC;QAED,2CAA2C;QAC3C,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,cAAc,GAAG,iCAAiC,WAAW,WAAW,CACzE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,KAAK,CAAC,EAAU;IAC7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import { fetchWithTimeout } from './fetch.js';\n\n/**\n * Options for waitForServiceReady\n */\nexport type WaitForServiceReadyOptions = {\n  /**\n   * Maximum number of attempts to check service readiness\n   *\n   * @default 10\n   */\n  maxAttempts?: number;\n\n  /**\n   * Delay in milliseconds between attempts\n   *\n   * @default 500\n   */\n  delayMs?: number;\n\n  /**\n   * Custom fetch function (useful for testing or custom timeout behavior)\n   *\n   * @default fetchWithTimeout\n   */\n  fetchFn?: typeof fetch;\n\n  /**\n   * Timeout in milliseconds for each fetch attempt\n   *\n   * @default 3000\n   */\n  timeoutMs?: number;\n};\n\n/**\n * Wait for a service to become ready by polling an endpoint\n *\n * Repeatedly attempts to fetch from the given URL until either:\n * - The service responds with a successful status (2xx or 503)\n * - Maximum attempts are reached (throws error)\n *\n * @param url - The URL to poll for service readiness\n * @param options - Configuration options\n * @throws Error if service doesn't become ready within maxAttempts\n *\n * @example\n * ```typescript\n * // Wait for fixture server to be ready\n * await waitForServiceReady('http://localhost:12345/state.json', {\n *   maxAttempts: 10,\n *   delayMs: 500,\n *   timeoutMs: 3000,\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With custom fetch function\n * await waitForServiceReady('http://localhost:8545', {\n *   fetchFn: customFetch,\n *   maxAttempts: 5,\n * });\n * ```\n */\nexport async function waitForServiceReady(\n  url: string,\n  options: WaitForServiceReadyOptions = {},\n): Promise<void> {\n  const {\n    maxAttempts = 10,\n    delayMs = 500,\n    fetchFn = fetchWithTimeout,\n    timeoutMs = 3000,\n  } = options;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      const response = await fetchFn(url, {}, timeoutMs);\n\n      // Service is ready if it responds with 2xx or 503 (service unavailable but responding)\n      if (response.ok || response.status === 503) {\n        return;\n      }\n    } catch (error) {\n      const caughtError = error as Error;\n\n      // Connection refused - service not yet started, retry\n      if (\n        caughtError.cause &&\n        JSON.stringify(caughtError.cause).includes('ECONNREFUSED')\n      ) {\n        await delay(delayMs);\n        continue;\n      }\n\n      // Timeout - service slow to respond, retry\n      if (caughtError.name === 'AbortError') {\n        await delay(delayMs);\n        continue;\n      }\n\n      // Other errors (e.g., self-signed cert accepted) - consider service ready\n      return;\n    }\n\n    // Response received but not ok/503 - retry\n    await delay(delayMs);\n  }\n\n  throw new Error(\n    `Service at ${url} failed to become ready after ${maxAttempts} attempts`,\n  );\n}\n\n/**\n * Delay helper function.\n *\n * @param ms - The delay in milliseconds.\n * @returns A promise that resolves after the delay.\n */\nasync function delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@metamask/client-mcp-core",
+  "version": "0.1.0",
+  "description": "MCP server for MetaMask Extension visual testing with LLM agents",
+  "keywords": [
+    "mcp",
+    "playwright",
+    "llm",
+    "visual-testing",
+    "browser-extension"
+  ],
+  "homepage": "https://github.com/MetaMask/client-mcp-core#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/client-mcp-core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/client-mcp-core.git"
+  },
+  "license": "(MIT OR Apache-2.0)",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "ts-bridge --project tsconfig.build.json --clean",
+    "build:docs": "typedoc",
+    "lint": "yarn lint:eslint && yarn lint:constraints && yarn lint:misc --check && yarn lint:dependencies --check && yarn lint:changelog",
+    "lint:changelog": "auto-changelog validate --prettier",
+    "lint:constraints": "yarn constraints",
+    "lint:dependencies": "depcheck && yarn dedupe --check",
+    "lint:dependencies:fix": "depcheck && yarn dedupe",
+    "lint:eslint": "eslint .",
+    "lint:fix": "yarn lint:eslint --fix && yarn lint:constraints --fix && yarn lint:misc --write && yarn lint:dependencies:fix && yarn lint:changelog",
+    "lint:misc": "prettier '**/*.json' '**/*.md' '**/*.yml' '!.yarnrc.yml' --ignore-path .gitignore --no-error-on-unmatched-pattern",
+    "prepack": "./scripts/prepack.sh",
+    "test": "vitest && attw --pack",
+    "test:watch": "vitest --watch"
+  },
+  "resolutions": {
+    "@isaacs/brace-expansion": "5.0.1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.15.3",
+    "@lavamoat/allow-scripts": "^3.0.4",
+    "@lavamoat/preinstall-always-fail": "^2.0.0",
+    "@metamask/auto-changelog": "^5.3.0",
+    "@metamask/eslint-config": "^15.0.0",
+    "@metamask/eslint-config-nodejs": "^15.0.0",
+    "@metamask/eslint-config-typescript": "^15.0.0",
+    "@metamask/eslint-config-vitest": "^15.0.0",
+    "@playwright/test": "^1.49.0",
+    "@ts-bridge/cli": "^0.6.3",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/utils": "^8.6.0",
+    "@vitest/coverage-istanbul": "^3.0.7",
+    "@vitest/eslint-plugin": "^1.1.4",
+    "@yarnpkg/types": "^4.0.0-rc.52",
+    "depcheck": "^1.4.3",
+    "eslint": "^9.11.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-import-resolver-typescript": "^3.6.3",
+    "eslint-plugin-import-x": "^4.3.0",
+    "eslint-plugin-jsdoc": "^50.2.4",
+    "eslint-plugin-n": "^17.10.3",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-promise": "^7.1.0",
+    "playwright": "^1.49.0",
+    "prettier": "^3.3.3",
+    "prettier-plugin-packagejson": "^2.5.8",
+    "ts-node": "^10.7.0",
+    "typedoc": "^0.26.11",
+    "typescript": "~5.7.3",
+    "typescript-eslint": "^8.48.1",
+    "vite": "^6.4.1",
+    "vitest": "^3.0.7"
+  },
+  "peerDependencies": {
+    "@playwright/test": "^1.49.0",
+    "playwright": "^1.49.0"
+  },
+  "packageManager": "yarn@4.11.0",
+  "engines": {
+    "node": "^20 || ^22 || >=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "lavamoat": {
+    "allowScripts": {
+      "@lavamoat/preinstall-always-fail": false,
+      "eslint-plugin-import-x>unrs-resolver": false,
+      "vite>esbuild": false,
+      "vitest>vite-node>vite>esbuild": false,
+      "vitest>vite>esbuild": false
+    }
+  }
+}