Enrich external API failure audit metadata

packages/shared/src/http.ts

@@ -227,3 +227,31 @@ export function parseApiErrorMessage(rawText: string, fallbackMessage: string) {
 
   return rawText.trim() || fallbackMessage;
 }
+
+export function appendApiErrorRequestId(
+  message: string,
+  requestId: string | null | undefined,
+) {
+  const trimmedMessage = message.trim() || '请求失败';
+  const trimmedRequestId =
+    typeof requestId === 'string' && requestId.trim()
+      ? requestId.trim()
+      : '';
+
+  if (!trimmedRequestId || trimmedMessage.includes(trimmedRequestId)) {
+    return trimmedMessage;
+  }
+
+  return `${trimmedMessage}（requestId: ${trimmedRequestId}）`;
+}
+
+export function parseApiErrorMessageWithRequestId(
+  rawText: string,
+  fallbackMessage: string,
+  requestId: string | null | undefined,
+) {
+  return appendApiErrorRequestId(
+    parseApiErrorMessage(rawText, fallbackMessage),
+    requestId,
+  );
+}