@ethisyscore/extension-runtime 1.70.0 → 1.71.1

package/dist/plugin/index.cjs

@@ -468,6 +468,100 @@ function defaultConnectionFactory(port) {
   };
 }
 
+// src/bridge/mcp-error.ts
+var MCP_ERROR_CODES = [
+  "unauthorized",
+  "forbidden",
+  "not_found",
+  "invalid_request",
+  "conflict",
+  "rate_limited",
+  "timeout",
+  "unavailable",
+  "internal"
+];
+function isMcpErrorCode(value) {
+  return typeof value === "string" && MCP_ERROR_CODES.includes(value);
+}
+var RETRYABLE = ["rate_limited", "timeout", "unavailable"];
+function isRetryableMcpErrorCode(code) {
+  return RETRYABLE.includes(code);
+}
+var McpToolError = class extends Error {
+  /** Machine-readable classification. `internal` when the host sent none. */
+  code;
+  /**
+   * Marks the instance for {@link isMcpToolError}. A structural marker rather than a prototype
+   * check because the error can be constructed in one bundle and inspected in another, where
+   * `instanceof` compares two different class objects and answers false.
+   */
+  isMcpToolError = true;
+  constructor(message, code = "internal") {
+    super(message);
+    this.name = "McpHostError";
+    this.code = code;
+  }
+  /** True when this failure is worth retrying unchanged. */
+  get retryable() {
+    return isRetryableMcpErrorCode(this.code);
+  }
+};
+function isMcpToolError(value) {
+  return value instanceof McpToolError || value !== null && typeof value === "object" && value.isMcpToolError === true && isMcpErrorCode(value.code);
+}
+function mcpErrorCodeFromHttpStatus(status) {
+  switch (status) {
+    case 401:
+      return "unauthorized";
+    case 403:
+      return "forbidden";
+    case 404:
+      return "not_found";
+    case 400:
+    case 422:
+      return "invalid_request";
+    case 409:
+    case 412:
+      return "conflict";
+    case 429:
+      return "rate_limited";
+    case 408:
+    case 504:
+      return "timeout";
+    case 502:
+    case 503:
+      return "unavailable";
+    default:
+      return "internal";
+  }
+}
+function classifyHostResponse(response) {
+  if (response.ok) {
+    return void 0;
+  }
+  if (isMcpErrorCode(response.mcpErrorCode)) {
+    return response.mcpErrorCode;
+  }
+  return typeof response.status === "number" ? mcpErrorCodeFromHttpStatus(response.status) : "internal";
+}
+function classifyHostError(err) {
+  if (err === null || typeof err !== "object") {
+    return "internal";
+  }
+  const candidate = err;
+  if (isMcpErrorCode(candidate.mcpErrorCode)) {
+    return candidate.mcpErrorCode;
+  }
+  const status = typeof candidate.status === "number" ? candidate.status : typeof candidate.statusCode === "number" ? candidate.statusCode : void 0;
+  if (status !== void 0) {
+    return mcpErrorCodeFromHttpStatus(status);
+  }
+  if (candidate.name === "AbortError" || candidate.name === "TimeoutError") {
+    return "timeout";
+  }
+  return "internal";
+}
+
 // src/plugin/createPortMcpTransport.ts
 var WIRE_INVOKE_TOOL_REQUEST = "ethisys:mcp:invokeTool";
 var WIRE_INVOKE_TOOL_RESULT = "ethisys:mcp:invokeTool:result";
@@ -505,11 +599,10 @@ function createPortMcpTransport(port, options = {}) {
     if (reply.ok === true) {
       resolver.resolve(reply.data);
     } else {
-      const error = new Error(
-        typeof reply.error === "string" ? reply.error : "Unknown host error"
-      );
-      error.name = "McpHostError";
-      resolver.reject(error);
+      resolver.reject(new McpToolError(
+        typeof reply.error === "string" ? reply.error : "Unknown host error",
+        isMcpErrorCode(reply.code) ? reply.code : "internal"
+      ));
     }
   }
   shim.addEventListener("message", onMessage);
@@ -812,13 +905,21 @@ exports.BridgeClientContext = BridgeClientContext;
 exports.ClientPushContext = ClientPushContext;
 exports.ExtensionRuntimeProvider = ExtensionRuntimeProvider;
 exports.HostIdentityContext = HostIdentityContext;
+exports.MCP_ERROR_CODES = MCP_ERROR_CODES;
+exports.McpToolError = McpToolError;
 exports.PluginRealtimeContext = PluginRealtimeContext;
+exports.classifyHostError = classifyHostError;
+exports.classifyHostResponse = classifyHostResponse;
 exports.createPortBridgeClient = createPortBridgeClient;
 exports.createPortMcpTransport = createPortMcpTransport;
 exports.createRemoteRoot = createRemoteRoot;
 exports.decodeJwtPayload = decodeJwtPayload;
 exports.defineDeclarativePlugin = defineDeclarativePlugin;
 exports.defineEthisysPlugin = defineEthisysPlugin;
+exports.isMcpErrorCode = isMcpErrorCode;
+exports.isMcpToolError = isMcpToolError;
+exports.isRetryableMcpErrorCode = isRetryableMcpErrorCode;
+exports.mcpErrorCodeFromHttpStatus = mcpErrorCodeFromHttpStatus;
 exports.unwrapItems = unwrapItems;
 exports.useAuth = useAuth;
 exports.useBridgeClient = useBridgeClient;