@ethisyscore/extension-runtime 1.70.0 → 1.71.1

package/dist/host/index.cjs

@@ -287,6 +287,100 @@ function createInputEventCoalescer(sink, options = {}) {
   };
 }
 
+// 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/host/version-skew.ts
 var EXTENSION_VERSION_HEADER = "x-extension-version";
 var EXTENSION_ACTIVE_VERSION_HEADER = "x-extension-active-version";
@@ -713,7 +807,11 @@ var WorkerRemoteDomTransport = class {
         type: "ethisys:mcp:invokeTool:result",
         ok: result.ok,
         data: result.data,
-        error: result.error
+        error: result.error,
+        // A client that REPORTS failure rather than throwing lands here, which is the common
+        // shape for anything wrapping HTTP. Classifying only the thrown path left these
+        // arriving as `internal`.
+        code: classifyHostResponse(result)
       });
     } catch (err) {
       this.replyError(message.id, "ethisys:mcp:invokeTool:result", err);
@@ -743,7 +841,11 @@ var WorkerRemoteDomTransport = class {
         type: "ethisys:mcp:getResource:result",
         ok: result.ok,
         data: result.data,
-        error: result.error
+        error: result.error,
+        // A client that REPORTS failure rather than throwing lands here, which is the common
+        // shape for anything wrapping HTTP. Classifying only the thrown path left these
+        // arriving as `internal`.
+        code: classifyHostResponse(result)
       });
     } catch (err) {
       this.replyError(message.id, "ethisys:mcp:getResource:result", err);
@@ -774,7 +876,11 @@ var WorkerRemoteDomTransport = class {
         type: "ethisys:mcp:uploadDocument:result",
         ok: result.ok,
         data: result.data,
-        error: result.error
+        error: result.error,
+        // A client that REPORTS failure rather than throwing lands here, which is the common
+        // shape for anything wrapping HTTP. Classifying only the thrown path left these
+        // arriving as `internal`.
+        code: classifyHostResponse(result)
       });
     } catch (err) {
       this.replyError(message.id, "ethisys:mcp:uploadDocument:result", err);
@@ -782,7 +888,7 @@ var WorkerRemoteDomTransport = class {
   }
   replyError(id, type, err) {
     const message = err instanceof Error ? err.message : "MCP request failed";
-    this.safePostMessage({ id, type, ok: false, error: message });
+    this.safePostMessage({ id, type, ok: false, error: message, code: classifyHostError(err) });
   }
 };
 var IFRAME_BRIDGE_PROTOCOL = "ethisys.iframe.bridge.v1";
@@ -988,7 +1094,11 @@ var IframeBridgeTransport = class {
         type: "ethisys:mcp:invokeTool:result",
         ok: result.ok,
         data: result.data,
-        error: result.error
+        error: result.error,
+        // A client that REPORTS failure rather than throwing lands here, which is the common shape
+        // for anything wrapping HTTP. Classifying only the thrown path left these arriving as
+        // `internal`.
+        code: classifyHostResponse(result)
       });
     } catch (err) {
       this.replyError(message.id, "ethisys:mcp:invokeTool:result", err);
@@ -1042,7 +1152,11 @@ var IframeBridgeTransport = class {
         type: "ethisys:mcp:getResource:result",
         ok: result.ok,
         data: result.data,
-        error: result.error
+        error: result.error,
+        // A client that REPORTS failure rather than throwing lands here, which is the common shape
+        // for anything wrapping HTTP. Classifying only the thrown path left these arriving as
+        // `internal`.
+        code: classifyHostResponse(result)
       });
     } catch (err) {
       this.replyError(message.id, "ethisys:mcp:getResource:result", err);
@@ -1050,7 +1164,7 @@ var IframeBridgeTransport = class {
   }
   replyError(id, type, err) {
     const message = err instanceof Error ? err.message : "MCP request failed";
-    this.safePostMessage({ id, type, ok: false, error: message });
+    this.safePostMessage({ id, type, ok: false, error: message, code: classifyHostError(err) });
   }
   /** Best-effort reply over the host port; tolerates post-dispose races. */
   safePostMessage(message) {
@@ -1084,14 +1198,22 @@ exports.EXTENSION_ACTIVE_VERSION_HEADER = EXTENSION_ACTIVE_VERSION_HEADER;
 exports.EXTENSION_VERSION_HEADER = EXTENSION_VERSION_HEADER;
 exports.IFRAME_BRIDGE_PROTOCOL = IFRAME_BRIDGE_PROTOCOL;
 exports.IframeBridgeTransport = IframeBridgeTransport;
+exports.MCP_ERROR_CODES = MCP_ERROR_CODES;
+exports.McpToolError = McpToolError;
 exports.SemanticComponentRegistry = SemanticComponentRegistry;
 exports.VERSION_MISMATCH_REASON = VERSION_MISMATCH_REASON;
 exports.WORKER_TRANSPORT_PROTOCOL = WORKER_TRANSPORT_PROTOCOL;
 exports.WorkerRemoteDomTransport = WorkerRemoteDomTransport;
+exports.classifyHostError = classifyHostError;
+exports.classifyHostResponse = classifyHostResponse;
 exports.createInputEventCoalescer = createInputEventCoalescer;
 exports.createOffscreenCanvasTransfer = createOffscreenCanvasTransfer;
 exports.detectVersionSkew = detectVersionSkew;
 exports.evaluate = evaluate;
 exports.interpret = interpret;
+exports.isMcpErrorCode = isMcpErrorCode;
+exports.isMcpToolError = isMcpToolError;
+exports.isRetryableMcpErrorCode = isRetryableMcpErrorCode;
+exports.mcpErrorCodeFromHttpStatus = mcpErrorCodeFromHttpStatus;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map