@ai-matrx/agents 0.43.18 → 0.43.19

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.43.19
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/matrx-agents/v0.43.18..npm/matrx-agents/v0.43.19 -- apps/shared/matrx-agents`).
+No source changes intended and no consumer action required.
+
 ## 0.43.18
 ### Unreleased
 ### E-signature: a drawn signature (`EsignActArgs.image_data_url`)

package/dist/content-transfer/index.cjs

@@ -640,6 +640,21 @@ var ALL_MANDATE_KEYS = Object.values(MANDATE_KEYS);
 // mandates/index.ts
 var KEY_SET = new Set(ALL_MANDATE_KEYS);
 
+// matrx/backend-errors.ts
+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";
@@ -669,10 +684,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;
@@ -681,21 +698,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;