@metamask/client-mcp-core 0.1.0

package/dist/mcp-server/tools/error-classification.cjs

@@ -0,0 +1,296 @@
+"use strict";
+/**
+ * Error classification utilities for tool handlers.
+ *
+ * These utilities help classify errors into specific error codes
+ * based on error message patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPageClosedError = isPageClosedError;
+exports.classifyInteractionError = classifyInteractionError;
+exports.classifyClickError = classifyClickError;
+exports.classifyTypeError = classifyTypeError;
+exports.classifyWaitError = classifyWaitError;
+exports.classifyNavigationError = classifyNavigationError;
+exports.classifyTabError = classifyTabError;
+exports.classifyNotificationError = classifyNotificationError;
+exports.classifyDiscoveryError = classifyDiscoveryError;
+exports.classifyScreenshotError = classifyScreenshotError;
+exports.classifyStateError = classifyStateError;
+exports.classifySeedingError = classifySeedingError;
+exports.classifyContextError = classifyContextError;
+const types_1 = require("../types/index.cjs");
+const utils_1 = require("../utils/index.cjs");
+const ERROR_PATTERNS = {
+    targetNotFound: [
+        'Unknown a11yRef',
+        'not found',
+        'No element found',
+        'Timeout waiting for selector',
+    ],
+    timeout: ['Timeout', 'exceeded', 'timed out'],
+    navigation: ['Navigation failed', 'net::ERR'],
+    pageClosed: [
+        'Target page, context or browser has been closed',
+        'page has been closed',
+        'context has been closed',
+        'browser has been closed',
+        'Target closed',
+        'Session closed',
+    ],
+};
+/**
+ * Check if an error indicates the page was closed.
+ *
+ * @param error - The error to check for page closure indicators
+ * @returns True if the error indicates the page was closed
+ */
+function isPageClosedError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    return ERROR_PATTERNS.pageClosed.some((pattern) => message.includes(pattern));
+}
+/**
+ * Classify an interaction error into a specific error code.
+ *
+ * @param error - The error to classify
+ * @param fallbackCode - The fallback error code if no pattern matches
+ * @returns Object with error code and message
+ */
+function classifyInteractionError(error, fallbackCode) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    for (const pattern of ERROR_PATTERNS.targetNotFound) {
+        if (message.includes(pattern)) {
+            return { code: types_1.ErrorCodes.MM_TARGET_NOT_FOUND, message };
+        }
+    }
+    for (const pattern of ERROR_PATTERNS.timeout) {
+        if (message.includes(pattern)) {
+            return { code: types_1.ErrorCodes.MM_WAIT_TIMEOUT, message };
+        }
+    }
+    return { code: fallbackCode, message: `Operation failed: ${message}` };
+}
+/**
+ * Classify a click error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyClickError(error) {
+    return classifyInteractionError(error, types_1.ErrorCodes.MM_CLICK_FAILED);
+}
+/**
+ * Classify a type error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyTypeError(error) {
+    return classifyInteractionError(error, types_1.ErrorCodes.MM_TYPE_FAILED);
+}
+/**
+ * Classify a wait error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyWaitError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    return {
+        code: types_1.ErrorCodes.MM_WAIT_TIMEOUT,
+        message: `Wait timed out: ${message}`,
+    };
+}
+/**
+ * Classify a navigation error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyNavigationError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    for (const pattern of ERROR_PATTERNS.navigation) {
+        if (message.includes(pattern)) {
+            return { code: types_1.ErrorCodes.MM_NAVIGATION_FAILED, message };
+        }
+    }
+    for (const pattern of ERROR_PATTERNS.timeout) {
+        if (message.includes(pattern)) {
+            return { code: types_1.ErrorCodes.MM_WAIT_TIMEOUT, message };
+        }
+    }
+    for (const pattern of ERROR_PATTERNS.pageClosed) {
+        if (message.includes(pattern)) {
+            return {
+                code: types_1.ErrorCodes.MM_NAVIGATION_FAILED,
+                message: `Page closed during navigation: ${message}`,
+            };
+        }
+    }
+    return {
+        code: types_1.ErrorCodes.MM_NAVIGATION_FAILED,
+        message: `Navigation failed: ${message}`,
+    };
+}
+/**
+ * Classify a tab operation error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyTabError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    if (message.includes('not found') || message.includes('No tab found')) {
+        return { code: types_1.ErrorCodes.MM_TAB_NOT_FOUND, message };
+    }
+    for (const pattern of ERROR_PATTERNS.timeout) {
+        if (message.includes(pattern)) {
+            return { code: types_1.ErrorCodes.MM_WAIT_TIMEOUT, message };
+        }
+    }
+    for (const pattern of ERROR_PATTERNS.pageClosed) {
+        if (message.includes(pattern)) {
+            return {
+                code: types_1.ErrorCodes.MM_NAVIGATION_FAILED,
+                message: `Tab operation failed - page closed: ${message}`,
+            };
+        }
+    }
+    return {
+        code: types_1.ErrorCodes.MM_NAVIGATION_FAILED,
+        message: `Tab operation failed: ${message}`,
+    };
+}
+/**
+ * Classify a notification wait error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyNotificationError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    for (const pattern of ERROR_PATTERNS.timeout) {
+        if (message.includes(pattern)) {
+            return {
+                code: types_1.ErrorCodes.MM_NOTIFICATION_TIMEOUT,
+                message: `Notification popup did not appear: ${message}`,
+            };
+        }
+    }
+    for (const pattern of ERROR_PATTERNS.pageClosed) {
+        if (message.includes(pattern)) {
+            return {
+                code: types_1.ErrorCodes.MM_NOTIFICATION_TIMEOUT,
+                message: `Browser closed while waiting for notification: ${message}`,
+            };
+        }
+    }
+    return {
+        code: types_1.ErrorCodes.MM_NOTIFICATION_TIMEOUT,
+        message: `Notification popup did not appear: ${message}`,
+    };
+}
+/**
+ * Classify a discovery tool error (list_testids, accessibility_snapshot, describe_screen).
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyDiscoveryError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    for (const pattern of ERROR_PATTERNS.pageClosed) {
+        if (message.includes(pattern)) {
+            return {
+                code: types_1.ErrorCodes.MM_PAGE_CLOSED,
+                message: `Page closed during discovery: ${message}`,
+            };
+        }
+    }
+    for (const pattern of ERROR_PATTERNS.timeout) {
+        if (message.includes(pattern)) {
+            return {
+                code: types_1.ErrorCodes.MM_WAIT_TIMEOUT,
+                message: `Discovery timed out: ${message}`,
+            };
+        }
+    }
+    return {
+        code: types_1.ErrorCodes.MM_DISCOVERY_FAILED,
+        message: `Discovery failed: ${message}`,
+    };
+}
+/**
+ * Classify a screenshot error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyScreenshotError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    for (const pattern of ERROR_PATTERNS.pageClosed) {
+        if (message.includes(pattern)) {
+            return {
+                code: types_1.ErrorCodes.MM_PAGE_CLOSED,
+                message: `Page closed during screenshot: ${message}`,
+            };
+        }
+    }
+    return {
+        code: types_1.ErrorCodes.MM_SCREENSHOT_FAILED,
+        message: `Screenshot failed: ${message}`,
+    };
+}
+/**
+ * Classify a state tool error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyStateError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    for (const pattern of ERROR_PATTERNS.pageClosed) {
+        if (message.includes(pattern)) {
+            return {
+                code: types_1.ErrorCodes.MM_PAGE_CLOSED,
+                message: `Page closed during state retrieval: ${message}`,
+            };
+        }
+    }
+    return {
+        code: types_1.ErrorCodes.MM_STATE_FAILED,
+        message: `State retrieval failed: ${message}`,
+    };
+}
+/**
+ * Classify a seeding/contract deployment error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifySeedingError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    if (message.includes('not found') || message.includes('Unknown contract')) {
+        return { code: types_1.ErrorCodes.MM_CONTRACT_NOT_FOUND, message };
+    }
+    return {
+        code: types_1.ErrorCodes.MM_SEED_FAILED,
+        message: `Contract operation failed: ${message}`,
+    };
+}
+/**
+ * Classify a context switching error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+function classifyContextError(error) {
+    const message = (0, utils_1.extractErrorMessage)(error);
+    if (message.includes(types_1.ErrorCodes.MM_CONTEXT_SWITCH_BLOCKED)) {
+        return { code: types_1.ErrorCodes.MM_CONTEXT_SWITCH_BLOCKED, message };
+    }
+    return {
+        code: types_1.ErrorCodes.MM_SET_CONTEXT_FAILED,
+        message: `Context switch failed: ${message}`,
+    };
+}
+//# sourceMappingURL=error-classification.cjs.map

package/dist/mcp-server/tools/error-classification.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/error-classification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Error classification utilities for tool handlers.\n *\n * These utilities help classify errors into specific error codes\n * based on error message patterns.\n */\n\nimport { ErrorCodes } from '../types';\nimport { extractErrorMessage } from '../utils';\n\nconst ERROR_PATTERNS = {\n  targetNotFound: [\n    'Unknown a11yRef',\n    'not found',\n    'No element found',\n    'Timeout waiting for selector',\n  ],\n  timeout: ['Timeout', 'exceeded', 'timed out'],\n  navigation: ['Navigation failed', 'net::ERR'],\n  pageClosed: [\n    'Target page, context or browser has been closed',\n    'page has been closed',\n    'context has been closed',\n    'browser has been closed',\n    'Target closed',\n    'Session closed',\n  ],\n} as const;\n\n/**\n * Check if an error indicates the page was closed.\n *\n * @param error - The error to check for page closure indicators\n * @returns True if the error indicates the page was closed\n */\nexport function isPageClosedError(error: unknown): boolean {\n  const message = extractErrorMessage(error);\n  return ERROR_PATTERNS.pageClosed.some((pattern) => message.includes(pattern));\n}\n\n/**\n * Classify an interaction error into a specific error code.\n *\n * @param error - The error to classify\n * @param fallbackCode - The fallback error code if no pattern matches\n * @returns Object with error code and message\n */\nexport function classifyInteractionError(\n  error: unknown,\n  fallbackCode: string,\n): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  for (const pattern of ERROR_PATTERNS.targetNotFound) {\n    if (message.includes(pattern)) {\n      return { code: ErrorCodes.MM_TARGET_NOT_FOUND, message };\n    }\n  }\n\n  for (const pattern of ERROR_PATTERNS.timeout) {\n    if (message.includes(pattern)) {\n      return { code: ErrorCodes.MM_WAIT_TIMEOUT, message };\n    }\n  }\n\n  return { code: fallbackCode, message: `Operation failed: ${message}` };\n}\n\n/**\n * Classify a click error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyClickError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  return classifyInteractionError(error, ErrorCodes.MM_CLICK_FAILED);\n}\n\n/**\n * Classify a type error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyTypeError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  return classifyInteractionError(error, ErrorCodes.MM_TYPE_FAILED);\n}\n\n/**\n * Classify a wait error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyWaitError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n  return {\n    code: ErrorCodes.MM_WAIT_TIMEOUT,\n    message: `Wait timed out: ${message}`,\n  };\n}\n\n/**\n * Classify a navigation error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyNavigationError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  for (const pattern of ERROR_PATTERNS.navigation) {\n    if (message.includes(pattern)) {\n      return { code: ErrorCodes.MM_NAVIGATION_FAILED, message };\n    }\n  }\n\n  for (const pattern of ERROR_PATTERNS.timeout) {\n    if (message.includes(pattern)) {\n      return { code: ErrorCodes.MM_WAIT_TIMEOUT, message };\n    }\n  }\n\n  for (const pattern of ERROR_PATTERNS.pageClosed) {\n    if (message.includes(pattern)) {\n      return {\n        code: ErrorCodes.MM_NAVIGATION_FAILED,\n        message: `Page closed during navigation: ${message}`,\n      };\n    }\n  }\n\n  return {\n    code: ErrorCodes.MM_NAVIGATION_FAILED,\n    message: `Navigation failed: ${message}`,\n  };\n}\n\n/**\n * Classify a tab operation error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyTabError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  if (message.includes('not found') || message.includes('No tab found')) {\n    return { code: ErrorCodes.MM_TAB_NOT_FOUND, message };\n  }\n\n  for (const pattern of ERROR_PATTERNS.timeout) {\n    if (message.includes(pattern)) {\n      return { code: ErrorCodes.MM_WAIT_TIMEOUT, message };\n    }\n  }\n\n  for (const pattern of ERROR_PATTERNS.pageClosed) {\n    if (message.includes(pattern)) {\n      return {\n        code: ErrorCodes.MM_NAVIGATION_FAILED,\n        message: `Tab operation failed - page closed: ${message}`,\n      };\n    }\n  }\n\n  return {\n    code: ErrorCodes.MM_NAVIGATION_FAILED,\n    message: `Tab operation failed: ${message}`,\n  };\n}\n\n/**\n * Classify a notification wait error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyNotificationError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  for (const pattern of ERROR_PATTERNS.timeout) {\n    if (message.includes(pattern)) {\n      return {\n        code: ErrorCodes.MM_NOTIFICATION_TIMEOUT,\n        message: `Notification popup did not appear: ${message}`,\n      };\n    }\n  }\n\n  for (const pattern of ERROR_PATTERNS.pageClosed) {\n    if (message.includes(pattern)) {\n      return {\n        code: ErrorCodes.MM_NOTIFICATION_TIMEOUT,\n        message: `Browser closed while waiting for notification: ${message}`,\n      };\n    }\n  }\n\n  return {\n    code: ErrorCodes.MM_NOTIFICATION_TIMEOUT,\n    message: `Notification popup did not appear: ${message}`,\n  };\n}\n\n/**\n * Classify a discovery tool error (list_testids, accessibility_snapshot, describe_screen).\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyDiscoveryError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  for (const pattern of ERROR_PATTERNS.pageClosed) {\n    if (message.includes(pattern)) {\n      return {\n        code: ErrorCodes.MM_PAGE_CLOSED,\n        message: `Page closed during discovery: ${message}`,\n      };\n    }\n  }\n\n  for (const pattern of ERROR_PATTERNS.timeout) {\n    if (message.includes(pattern)) {\n      return {\n        code: ErrorCodes.MM_WAIT_TIMEOUT,\n        message: `Discovery timed out: ${message}`,\n      };\n    }\n  }\n\n  return {\n    code: ErrorCodes.MM_DISCOVERY_FAILED,\n    message: `Discovery failed: ${message}`,\n  };\n}\n\n/**\n * Classify a screenshot error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyScreenshotError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  for (const pattern of ERROR_PATTERNS.pageClosed) {\n    if (message.includes(pattern)) {\n      return {\n        code: ErrorCodes.MM_PAGE_CLOSED,\n        message: `Page closed during screenshot: ${message}`,\n      };\n    }\n  }\n\n  return {\n    code: ErrorCodes.MM_SCREENSHOT_FAILED,\n    message: `Screenshot failed: ${message}`,\n  };\n}\n\n/**\n * Classify a state tool error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyStateError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  for (const pattern of ERROR_PATTERNS.pageClosed) {\n    if (message.includes(pattern)) {\n      return {\n        code: ErrorCodes.MM_PAGE_CLOSED,\n        message: `Page closed during state retrieval: ${message}`,\n      };\n    }\n  }\n\n  return {\n    code: ErrorCodes.MM_STATE_FAILED,\n    message: `State retrieval failed: ${message}`,\n  };\n}\n\n/**\n * Classify a seeding/contract deployment error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifySeedingError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  if (message.includes('not found') || message.includes('Unknown contract')) {\n    return { code: ErrorCodes.MM_CONTRACT_NOT_FOUND, message };\n  }\n\n  return {\n    code: ErrorCodes.MM_SEED_FAILED,\n    message: `Contract operation failed: ${message}`,\n  };\n}\n\n/**\n * Classify a context switching error.\n *\n * @param error - The error to classify\n * @returns Object with error code and message\n */\nexport function classifyContextError(error: unknown): {\n  code: string;\n  message: string;\n} {\n  const message = extractErrorMessage(error);\n\n  if (message.includes(ErrorCodes.MM_CONTEXT_SWITCH_BLOCKED)) {\n    return { code: ErrorCodes.MM_CONTEXT_SWITCH_BLOCKED, message };\n  }\n\n  return {\n    code: ErrorCodes.MM_SET_CONTEXT_FAILED,\n    message: `Context switch failed: ${message}`,\n  };\n}\n"]}

package/dist/mcp-server/tools/error-classification.d.cts

@@ -0,0 +1,135 @@
+/**
+ * Error classification utilities for tool handlers.
+ *
+ * These utilities help classify errors into specific error codes
+ * based on error message patterns.
+ */
+/**
+ * Check if an error indicates the page was closed.
+ *
+ * @param error - The error to check for page closure indicators
+ * @returns True if the error indicates the page was closed
+ */
+export declare function isPageClosedError(error: unknown): boolean;
+/**
+ * Classify an interaction error into a specific error code.
+ *
+ * @param error - The error to classify
+ * @param fallbackCode - The fallback error code if no pattern matches
+ * @returns Object with error code and message
+ */
+export declare function classifyInteractionError(error: unknown, fallbackCode: string): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a click error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyClickError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a type error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyTypeError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a wait error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyWaitError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a navigation error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyNavigationError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a tab operation error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyTabError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a notification wait error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyNotificationError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a discovery tool error (list_testids, accessibility_snapshot, describe_screen).
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyDiscoveryError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a screenshot error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyScreenshotError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a state tool error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyStateError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a seeding/contract deployment error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifySeedingError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a context switching error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyContextError(error: unknown): {
+    code: string;
+    message: string;
+};
+//# sourceMappingURL=error-classification.d.cts.map

package/dist/mcp-server/tools/error-classification.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/error-classification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGzD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,GACnB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAMA;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CA4BA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CA0BA;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAyBA;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAyBA;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAWA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAWA"}

package/dist/mcp-server/tools/error-classification.d.mts

@@ -0,0 +1,135 @@
+/**
+ * Error classification utilities for tool handlers.
+ *
+ * These utilities help classify errors into specific error codes
+ * based on error message patterns.
+ */
+/**
+ * Check if an error indicates the page was closed.
+ *
+ * @param error - The error to check for page closure indicators
+ * @returns True if the error indicates the page was closed
+ */
+export declare function isPageClosedError(error: unknown): boolean;
+/**
+ * Classify an interaction error into a specific error code.
+ *
+ * @param error - The error to classify
+ * @param fallbackCode - The fallback error code if no pattern matches
+ * @returns Object with error code and message
+ */
+export declare function classifyInteractionError(error: unknown, fallbackCode: string): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a click error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyClickError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a type error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyTypeError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a wait error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyWaitError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a navigation error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyNavigationError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a tab operation error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyTabError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a notification wait error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyNotificationError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a discovery tool error (list_testids, accessibility_snapshot, describe_screen).
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyDiscoveryError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a screenshot error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyScreenshotError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a state tool error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyStateError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a seeding/contract deployment error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifySeedingError(error: unknown): {
+    code: string;
+    message: string;
+};
+/**
+ * Classify a context switching error.
+ *
+ * @param error - The error to classify
+ * @returns Object with error code and message
+ */
+export declare function classifyContextError(error: unknown): {
+    code: string;
+    message: string;
+};
+//# sourceMappingURL=error-classification.d.mts.map

package/dist/mcp-server/tools/error-classification.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/error-classification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGzD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,GACnB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAMA;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CA4BA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CA0BA;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAyBA;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAyBA;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAWA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAWA"}