@ethisyscore/extension-runtime 1.70.0 → 1.71.1

package/dist/host/index.d.cts

@@ -3,10 +3,11 @@ import { C as ComponentRegistry } from '../registry-DpCx_LxF.cjs';
 export { P as PrimitiveProps } from '../registry-DpCx_LxF.cjs';
 import { SduiNode } from '@ethisyscore/protocol';
 export { PrimitiveName, SduiNode } from '@ethisyscore/protocol';
-import { M as McpHttpClient, f as VersionSkew } from '../transport-BbSPAS_N.cjs';
-export { C as CAPABILITY_REJECTION_REASON_HEADER, D as DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, E as EXTENSION_ACTIVE_VERSION_HEADER, a as EXTENSION_VERSION_HEADER, I as InputEventPayload, b as McpHttpRequest, c as McpHttpResponse, d as McpResponseMetadata, e as McpUploadRequest, V as VERSION_MISMATCH_REASON, g as VersionSkewSource, W as WORKER_TRANSPORT_PROTOCOL, h as WorkerCtor, i as WorkerHandshakePayload, j as WorkerLike, k as WorkerRemoteDomTransport, l as WorkerRemoteDomTransportOptions, m as detectVersionSkew } from '../transport-BbSPAS_N.cjs';
+import { M as McpHttpClient, f as VersionSkew } from '../transport-C4xoMWBE.cjs';
+export { C as CAPABILITY_REJECTION_REASON_HEADER, D as DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, E as EXTENSION_ACTIVE_VERSION_HEADER, a as EXTENSION_VERSION_HEADER, I as InputEventPayload, b as McpHttpRequest, c as McpHttpResponse, d as McpResponseMetadata, e as McpUploadRequest, V as VERSION_MISMATCH_REASON, g as VersionSkewSource, W as WORKER_TRANSPORT_PROTOCOL, h as WorkerCtor, i as WorkerHandshakePayload, j as WorkerLike, k as WorkerRemoteDomTransport, l as WorkerRemoteDomTransportOptions, m as detectVersionSkew } from '../transport-C4xoMWBE.cjs';
 export { RemoteReceiver, RemoteReceiverComment, RemoteReceiverElement, RemoteReceiverNode, RemoteReceiverParent, RemoteReceiverRoot, RemoteReceiverText } from '@remote-dom/core/receivers';
 export { RemoteComponentRendererMap, RemoteComponentRendererProps, RemoteRootRenderer, RemoteRootRendererProps, createRemoteComponentRenderer } from '@remote-dom/react/host';
+export { M as MCP_ERROR_CODES, a as McpErrorCode, b as McpToolError, c as classifyHostError, d as classifyHostResponse, i as isMcpErrorCode, e as isMcpToolError, f as isRetryableMcpErrorCode, m as mcpErrorCodeFromHttpStatus } from '../mcp-error-CCZQd8Xl.cjs';
 import '../bridge-envelopes-DA6vxbyb.cjs';
 
 /**

package/dist/host/index.d.ts

@@ -3,10 +3,11 @@ import { C as ComponentRegistry } from '../registry-DpCx_LxF.js';
 export { P as PrimitiveProps } from '../registry-DpCx_LxF.js';
 import { SduiNode } from '@ethisyscore/protocol';
 export { PrimitiveName, SduiNode } from '@ethisyscore/protocol';
-import { M as McpHttpClient, f as VersionSkew } from '../transport-BPwasdNz.js';
-export { C as CAPABILITY_REJECTION_REASON_HEADER, D as DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, E as EXTENSION_ACTIVE_VERSION_HEADER, a as EXTENSION_VERSION_HEADER, I as InputEventPayload, b as McpHttpRequest, c as McpHttpResponse, d as McpResponseMetadata, e as McpUploadRequest, V as VERSION_MISMATCH_REASON, g as VersionSkewSource, W as WORKER_TRANSPORT_PROTOCOL, h as WorkerCtor, i as WorkerHandshakePayload, j as WorkerLike, k as WorkerRemoteDomTransport, l as WorkerRemoteDomTransportOptions, m as detectVersionSkew } from '../transport-BPwasdNz.js';
+import { M as McpHttpClient, f as VersionSkew } from '../transport-BuX8gzq1.js';
+export { C as CAPABILITY_REJECTION_REASON_HEADER, D as DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, E as EXTENSION_ACTIVE_VERSION_HEADER, a as EXTENSION_VERSION_HEADER, I as InputEventPayload, b as McpHttpRequest, c as McpHttpResponse, d as McpResponseMetadata, e as McpUploadRequest, V as VERSION_MISMATCH_REASON, g as VersionSkewSource, W as WORKER_TRANSPORT_PROTOCOL, h as WorkerCtor, i as WorkerHandshakePayload, j as WorkerLike, k as WorkerRemoteDomTransport, l as WorkerRemoteDomTransportOptions, m as detectVersionSkew } from '../transport-BuX8gzq1.js';
 export { RemoteReceiver, RemoteReceiverComment, RemoteReceiverElement, RemoteReceiverNode, RemoteReceiverParent, RemoteReceiverRoot, RemoteReceiverText } from '@remote-dom/core/receivers';
 export { RemoteComponentRendererMap, RemoteComponentRendererProps, RemoteRootRenderer, RemoteRootRendererProps, createRemoteComponentRenderer } from '@remote-dom/react/host';
+export { M as MCP_ERROR_CODES, a as McpErrorCode, b as McpToolError, c as classifyHostError, d as classifyHostResponse, i as isMcpErrorCode, e as isMcpToolError, f as isRetryableMcpErrorCode, m as mcpErrorCodeFromHttpStatus } from '../mcp-error-CCZQd8Xl.js';
 import '../bridge-envelopes-DA6vxbyb.js';
 
 /**

package/dist/host/index.js

@@ -285,6 +285,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";
@@ -711,7 +805,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);
@@ -741,7 +839,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);
@@ -772,7 +874,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);
@@ -780,7 +886,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";
@@ -986,7 +1092,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);
@@ -1040,7 +1150,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);
@@ -1048,7 +1162,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) {
@@ -1062,6 +1176,6 @@ var IframeBridgeTransport = class {
   }
 };
 
-export { CAPABILITY_REJECTION_REASON_HEADER, CONTRACT_B_PRIMITIVES, DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, DEFAULT_OFFSCREEN_COALESCE_MS, EXTENSION_ACTIVE_VERSION_HEADER, EXTENSION_VERSION_HEADER, IFRAME_BRIDGE_PROTOCOL, IframeBridgeTransport, SemanticComponentRegistry, VERSION_MISMATCH_REASON, WORKER_TRANSPORT_PROTOCOL, WorkerRemoteDomTransport, createInputEventCoalescer, createOffscreenCanvasTransfer, detectVersionSkew, evaluate, interpret };
+export { CAPABILITY_REJECTION_REASON_HEADER, CONTRACT_B_PRIMITIVES, DEFAULT_MAX_CONCURRENT_MCP_REQUESTS, DEFAULT_OFFSCREEN_COALESCE_MS, EXTENSION_ACTIVE_VERSION_HEADER, EXTENSION_VERSION_HEADER, IFRAME_BRIDGE_PROTOCOL, IframeBridgeTransport, MCP_ERROR_CODES, McpToolError, SemanticComponentRegistry, VERSION_MISMATCH_REASON, WORKER_TRANSPORT_PROTOCOL, WorkerRemoteDomTransport, classifyHostError, classifyHostResponse, createInputEventCoalescer, createOffscreenCanvasTransfer, detectVersionSkew, evaluate, interpret, isMcpErrorCode, isMcpToolError, isRetryableMcpErrorCode, mcpErrorCodeFromHttpStatus };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map