@ai-matrx/agents 0.36.0 → 0.37.0

package/dist/react/index.d.cts

@@ -1,4 +1,4 @@
-import { d as MatrxNdjsonIssue, e as MatrxStreamEnvelopeObservation, f as MatrxConversationStart, g as MatrxJsonValue, h as MatrxJsonObject, M as MatrxTransport, c as MatrxRuntimeExecutionStatus, b as MatrxRuntimeOperationEvent } from '../operations-BT5kKMHl.cjs';
+import { d as MatrxNdjsonIssue, e as MatrxStreamEnvelopeObservation, f as MatrxConversationStart, g as MatrxJsonValue, h as MatrxJsonObject, M as MatrxTransport, c as MatrxRuntimeExecutionStatus, b as MatrxRuntimeOperationEvent } from '../operations-DqOe2zob.cjs';
 
 /**
  * The PRODUCTION `MatrxTransport` — the full connection pipeline every Matrx
@@ -60,6 +60,8 @@ interface MatrxCallError {
     name?: string;
     /** Original exception stack. */
     stack?: string;
+    /** JSON-safe dump of the original thrown value. */
+    raw?: unknown;
 }
 
 /**

package/dist/react/index.d.ts

@@ -1,4 +1,4 @@
-import { d as MatrxNdjsonIssue, e as MatrxStreamEnvelopeObservation, f as MatrxConversationStart, g as MatrxJsonValue, h as MatrxJsonObject, M as MatrxTransport, c as MatrxRuntimeExecutionStatus, b as MatrxRuntimeOperationEvent } from '../operations-BT5kKMHl.js';
+import { d as MatrxNdjsonIssue, e as MatrxStreamEnvelopeObservation, f as MatrxConversationStart, g as MatrxJsonValue, h as MatrxJsonObject, M as MatrxTransport, c as MatrxRuntimeExecutionStatus, b as MatrxRuntimeOperationEvent } from '../operations-DqOe2zob.js';
 
 /**
  * The PRODUCTION `MatrxTransport` — the full connection pipeline every Matrx
@@ -60,6 +60,8 @@ interface MatrxCallError {
     name?: string;
     /** Original exception stack. */
     stack?: string;
+    /** JSON-safe dump of the original thrown value. */
+    raw?: unknown;
 }
 
 /**

package/dist/react/index.js

@@ -269,69 +269,43 @@ function extractMatrxErrorCode(serverDetail) {
 // matrx/client.ts
 import { isNetError } from "@ai-matrx/data";
 import { credentialToHeaders } from "@ai-matrx/data";
+import { extractErrorMessage } from "@ai-matrx/data/net";
 
-// matrx/org-context.ts
-import { isUuidShape } from "@ai-matrx/kit/uuid";
-var OrganizationContextError = class extends Error {
+// matrx/backend-errors.ts
+var BackendApiError = class extends Error {
+  /** Machine-readable error code */
   code;
-  constructor(code, message) {
-    super(message);
-    this.name = "OrganizationContextError";
-    this.code = code;
-  }
-};
-
-// matrx/client.ts
-function classifyStatus(status) {
-  return status >= 400 && status < 500 ? "validation_error" : "http_error";
-}
-function normalizeMatrxError(err) {
-  if (err instanceof MatrxApiError) {
-    return {
-      type: classifyStatus(err.status),
-      message: err.message,
-      status: err.status,
-      serverDetail: err.serverDetail,
-      ...err.code ? { code: err.code } : {},
-      name: err.name
-    };
+  /** Developer-facing detail */
+  detail;
+  /** Safe to display directly in the UI */
+  userMessage;
+  /** Extra info (validation errors, etc.) */
+  details;
+  /** Unique request ID for support/debugging */
+  requestId;
+  /** HTTP status code (if from an HTTP response) */
+  status;
+  constructor(data) {
+    super(data.userMessage);
+    this.name = "BackendApiError";
+    this.code = data.code;
+    this.detail = data.detail;
+    this.userMessage = data.userMessage;
+    this.details = data.details ?? null;
+    this.requestId = data.requestId ?? "";
+    this.status = data.status ?? null;
   }
-  if (err instanceof OrganizationContextError) {
+  /** Convert to the wire format for logging */
+  toJSON() {
     return {
-      type: "validation_error",
-      message: err.message,
-      code: err.code,
-      name: err.name,
-      ...err.stack !== void 0 ? { stack: err.stack } : {}
+      error: this.code,
+      message: this.detail,
+      user_message: this.userMessage,
+      details: this.details,
+      request_id: this.requestId
     };
   }
-  if (err instanceof DOMException && err.name === "AbortError") {
-    return { type: "abort_error", message: "Request was cancelled." };
-  }
-  if (isNetError(err)) {
-    if (err.code === "aborted") {
-      return { type: "abort_error", message: err.message };
-    }
-    if (err.code === "http") {
-      const status = err.status ?? 0;
-      return { type: classifyStatus(status), message: err.message, status };
-    }
-    return { type: "network_error", message: err.message };
-  }
-  if (err instanceof Error) {
-    const httpMatch = err.message.match(/HTTP (\d+):\s*(.*)/);
-    if (httpMatch) {
-      const status = parseInt(httpMatch[1], 10);
-      return {
-        type: classifyStatus(status),
-        message: httpMatch[2] ?? err.message,
-        status
-      };
-    }
-    return { type: "network_error", message: err.message };
-  }
-  return { type: "unknown", message: String(err ?? "Unknown error") };
-}
+};
 
 // stream/ndjson.ts
 var DEFAULT_MATRX_NDJSON_READ_AHEAD = 64;
@@ -553,6 +527,120 @@ async function* readMatrxNdjsonStream(body, options = {}) {
   }
 }
 
+// matrx/org-context.ts
+import { isUuidShape } from "@ai-matrx/kit/uuid";
+var OrganizationContextError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "OrganizationContextError";
+    this.code = code;
+  }
+};
+
+// matrx/call.ts
+var BARE_TRANSPORT_CODE = /^\s*(?:HTTP|HTTP\s*Error|Status(?:\s*Code)?)?\s*[:\-]?\s*\d{3}\s*[.:!]?\s*$/i;
+function isBareTransportCode(text) {
+  if (!text) return false;
+  return BARE_TRANSPORT_CODE.test(text);
+}
+function bareStatusSentence(status) {
+  if (status === 401 || status === 403) {
+    return "The server would not let this request through \u2014 your session may have expired, or this account may not have access here. Sign in again, and if it repeats, ask an administrator.";
+  }
+  if (status === 404) {
+    return "The server has nothing at that address. Reload the page; if it repeats, report it \u2014 a client asking for something that no longer exists is a defect, not your mistake.";
+  }
+  if (status === 429) {
+    return "The server is rate-limiting this request. Wait a few seconds and try again.";
+  }
+  if (status >= 500) {
+    return "The server failed while answering this, and sent no explanation. Try again in a moment; if it repeats, report it with the request id above.";
+  }
+  return "The server refused this request and sent no reason with it \u2014 the missing reason is itself a defect worth reporting. Reload the page and try once more; if it repeats, report it with the request id above.";
+}
+function honestTransportMessage(raw, status) {
+  if (raw && !isBareTransportCode(raw)) return raw;
+  return bareStatusSentence(status ?? 0);
+}
+
+// matrx/client.ts
+function classifyStatus(status) {
+  return status >= 400 && status < 500 ? "validation_error" : "http_error";
+}
+function normalizeMatrxError(err) {
+  if (err instanceof OrganizationContextError) {
+    return {
+      type: "validation_error",
+      message: err.message,
+      code: err.code,
+      name: err.name,
+      ...err.stack !== void 0 ? { stack: err.stack } : {}
+    };
+  }
+  if (err instanceof DOMException && err.name === "AbortError") {
+    return { type: "abort_error", message: "Request was cancelled." };
+  }
+  if (err instanceof MatrxApiError) {
+    return {
+      type: classifyStatus(err.status),
+      message: honestTransportMessage(err.message, err.status),
+      status: err.status,
+      serverDetail: err.serverDetail,
+      ...err.code ? { code: err.code } : {},
+      name: err.name
+    };
+  }
+  if (err instanceof BackendApiError) {
+    return {
+      type: "network_error",
+      message: honestTransportMessage(
+        err.detail || err.userMessage,
+        err.status ?? void 0
+      ),
+      code: err.code,
+      name: err.name,
+      ...err.status !== null ? { status: err.status } : {},
+      ...err.details !== null ? { serverDetail: err.details } : {}
+    };
+  }
+  if (isNetError(err)) {
+    if (err.code === "aborted") {
+      return { type: "abort_error", message: err.message };
+    }
+    if (err.code === "http") {
+      const status = err.status ?? 0;
+      return {
+        type: classifyStatus(status),
+        message: honestTransportMessage(err.message, status),
+        status
+      };
+    }
+    return { type: "network_error", message: err.message };
+  }
+  if (err instanceof Error) {
+    const httpMatch = err.message.match(/HTTP (\d+):\s*(.*)/);
+    if (httpMatch) {
+      const status = parseInt(httpMatch[1], 10);
+      return {
+        type: classifyStatus(status),
+        message: honestTransportMessage(httpMatch[2] ?? err.message, status),
+        status
+      };
+    }
+    if (isBareTransportCode(err.message)) {
+      const status = Number.parseInt(err.message.replace(/\D+/g, ""), 10);
+      return {
+        type: classifyStatus(status),
+        message: bareStatusSentence(status),
+        status
+      };
+    }
+    return { type: "network_error", message: err.message };
+  }
+  return { type: "unknown", message: extractErrorMessage(err) };
+}
+
 // matrx/internal.ts
 function encodePathSegment(value) {
   return encodeURIComponent(value);