@ethisyscore/extension-runtime 1.71.0 → 1.71.2

package/dist/plugin/index.d.cts

@@ -6,6 +6,7 @@ import { SduiNode, RenderMode } from '@ethisyscore/protocol';
 import { RemoteConnection } from '@remote-dom/core';
 import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload } from '../bridge-client-DzRcKIJT.cjs';
 export { A as A11yPayload, B as BridgePortShim, D as DensityPayload, N as NavPayload, S as SessionTokenPayload, c as createPortBridgeClient } from '../bridge-client-DzRcKIJT.cjs';
+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';
 
 /**
  * A single client-push event delivered from the host to a plugin surface. The host

package/dist/plugin/index.d.ts

@@ -6,6 +6,7 @@ import { SduiNode, RenderMode } from '@ethisyscore/protocol';
 import { RemoteConnection } from '@remote-dom/core';
 import { P as PortBridgeClient, T as ThemePayload, L as LocalePayload } from '../bridge-client-DD99netz.js';
 export { A as A11yPayload, B as BridgePortShim, D as DensityPayload, N as NavPayload, S as SessionTokenPayload, c as createPortBridgeClient } from '../bridge-client-DD99netz.js';
+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';
 
 /**
  * A single client-push event delivered from the host to a plugin surface. The host

package/dist/plugin/index.js

@@ -462,6 +462,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";
@@ -499,11 +593,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);
@@ -802,6 +895,6 @@ function useAuth(transport) {
   };
 }
 
-export { BridgeClientContext, ClientPushContext, ExtensionRuntimeProvider, HostIdentityContext, PluginRealtimeContext, createPortBridgeClient, createPortMcpTransport, createRemoteRoot, decodeJwtPayload, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useAuth, useBridgeClient, useBridgeLocale, useBridgeTheme, useClientPushSubscription, useExtensionRuntimeTransport, useFrontendSessionToken, useHostIdentity, useMcpQuery, useMcpResource, useMcpTool, usePluginRealtimeSource };
+export { BridgeClientContext, ClientPushContext, ExtensionRuntimeProvider, HostIdentityContext, MCP_ERROR_CODES, McpToolError, PluginRealtimeContext, classifyHostError, classifyHostResponse, createPortBridgeClient, createPortMcpTransport, createRemoteRoot, decodeJwtPayload, defineDeclarativePlugin, defineEthisysPlugin, isMcpErrorCode, isMcpToolError, isRetryableMcpErrorCode, mcpErrorCodeFromHttpStatus, unwrapItems, useAuth, useBridgeClient, useBridgeLocale, useBridgeTheme, useClientPushSubscription, useExtensionRuntimeTransport, useFrontendSessionToken, useHostIdentity, useMcpQuery, useMcpResource, useMcpTool, usePluginRealtimeSource };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map