@ai-matrx/agents 0.43.18 → 0.43.19

package/dist/react/index.js

@@ -197,6 +197,55 @@ function projectAgentEvent(current, event) {
   }
 }
 
+// matrx/backend-errors.ts
+var BackendApiError = class extends Error {
+  /** Machine-readable error code */
+  code;
+  /** 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;
+  }
+  /** Convert to the wire format for logging */
+  toJSON() {
+    return {
+      error: this.code,
+      message: this.detail,
+      user_message: this.userMessage,
+      details: this.details,
+      request_id: this.requestId
+    };
+  }
+};
+var GENERIC_MESSAGE_PATTERNS = [
+  /failed unexpectedly/i,
+  /^\s*something went wrong/i,
+  /please try again(\s+later)?\.?\s*$/i,
+  /^\s*request failed\b/i,
+  /^\s*unknown (streaming )?error/i,
+  /^\s*internal server error\.?\s*$/i
+];
+function isGenericUserMessage(message) {
+  const value = (message ?? "").trim();
+  if (!value) return true;
+  return GENERIC_MESSAGE_PATTERNS.some((pattern) => pattern.test(value));
+}
+
 // matrx/transport.ts
 var MatrxApiError = class extends Error {
   name = "MatrxApiError";
@@ -226,10 +275,12 @@ function nonBlankString(value) {
 }
 function extractMatrxErrorMessage(serverDetail) {
   if (!isRecord(serverDetail)) return void 0;
-  const userMessage = nonBlankString(serverDetail.user_message);
-  if (userMessage) return userMessage;
-  const message = nonBlankString(serverDetail.message);
-  if (message) return message;
+  const candidates = [];
+  const push = (value) => {
+    if (value) candidates.push(value);
+  };
+  push(nonBlankString(serverDetail.user_message));
+  push(nonBlankString(serverDetail.message));
   if (Array.isArray(serverDetail.details)) {
     const messages = serverDetail.details.map((entry) => {
       if (!isRecord(entry)) return void 0;
@@ -238,21 +289,20 @@ function extractMatrxErrorMessage(serverDetail) {
       const field = nonBlankString(entry.field);
       return field ? `${field}: ${detailMessage}` : detailMessage;
     }).filter((m) => typeof m === "string");
-    if (messages.length > 0) return messages.join("; ");
+    if (messages.length > 0) push(messages.join("; "));
   }
   const detail = serverDetail.detail;
   if (isRecord(detail)) {
-    const detailMessage = nonBlankString(detail.message) ?? nonBlankString(detail.user_message);
-    if (detailMessage) return detailMessage;
+    push(nonBlankString(detail.message) ?? nonBlankString(detail.user_message));
   }
-  if (typeof detail === "string" && detail.trim()) return detail;
+  if (typeof detail === "string" && detail.trim()) push(detail);
   if (Array.isArray(detail)) {
     const messages = detail.map(
       (entry) => isRecord(entry) ? nonBlankString(entry.msg) : void 0
     ).filter((m) => typeof m === "string");
-    if (messages.length > 0) return messages.join("; ");
+    if (messages.length > 0) push(messages.join("; "));
   }
-  return void 0;
+  return candidates.find((c) => !isGenericUserMessage(c)) ?? candidates[0];
 }
 function extractMatrxErrorCode(serverDetail) {
   if (!isRecord(serverDetail)) return null;
@@ -271,42 +321,6 @@ import { isNetError } from "@ai-matrx/data";
 import { credentialToHeaders } from "@ai-matrx/data";
 import { extractErrorMessage } from "@ai-matrx/data/net";
 
-// matrx/backend-errors.ts
-var BackendApiError = class extends Error {
-  /** Machine-readable error code */
-  code;
-  /** 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;
-  }
-  /** Convert to the wire format for logging */
-  toJSON() {
-    return {
-      error: this.code,
-      message: this.detail,
-      user_message: this.userMessage,
-      details: this.details,
-      request_id: this.requestId
-    };
-  }
-};
-
 // stream/ndjson.ts
 var DEFAULT_MATRX_NDJSON_READ_AHEAD = 64;
 function isRecord2(value) {