@agent-wechat/agent-wechat 0.15.0 → 0.15.1

package/dist/index.js

@@ -5563,6 +5563,9 @@ function attachmentKindForMessageType(baseType) {
   if (baseType === 49) return "file";
   return void 0;
 }
+function mediaRequestQuality(baseType) {
+  return baseType === 3 ? "best" : "full";
+}
 function attachmentKindForResult(result, fallback) {
   if (result.type === "image" || result.type === "emoji") return "image";
   if (result.type === "voice") return "audio";
@@ -5615,8 +5618,11 @@ function renderAttachmentBody(originalBody, attachment, exposeNonVisualPath = tr
       return appendReference(originalBody || "<media:video>", `[Video file: ${attachment.path}]`);
     }
   }
-  if (!originalBody) return attachment.kind === "image" ? "<media:image>" : originalBody;
-  return originalBody;
+  const body = originalBody || (attachment.kind === "image" ? "<media:image>" : originalBody);
+  if (attachment.kind === "image" && attachment.quality === "thumbnail") {
+    return appendReference(body, "[Image preview only: thumbnail quality]");
+  }
+  return body;
 }
 function applyLiveAttachment(message, originalBody, attachment) {
   const attachable = attachment?.status === "ready" && attachment.path && attachment.kind !== "file";
@@ -5889,6 +5895,41 @@ async function sendWeChatMedia(cfg, to, text, mediaUrl, audioAsVoice = false, id
   return `agent-wechat:${to}:${Date.now()}`;
 }
 
+// src/media-poll.ts
+function rejectsBestQuality(error) {
+  return error instanceof Error && /^(400|422)\b/.test(error.message) && /\bbest\b/i.test(error.message);
+}
+async function pollMedia(client, chatId, localId, quality, log, maxAttempts = 15, intervalMs = 1e3) {
+  let lastResult = null;
+  let legacyImageServer = false;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    let result;
+    if (legacyImageServer) {
+      const full = await client.getMedia(chatId, localId, "full");
+      if (full.data || full.type === "unsupported") return full;
+      const preview = await client.getMedia(chatId, localId, "thumbnail");
+      result = preview.data ? { ...preview, quality: "thumbnail" } : full;
+    } else {
+      try {
+        result = await client.getMedia(chatId, localId, quality);
+      } catch (error) {
+        if (quality !== "best" || !rejectsBestQuality(error)) throw error;
+        legacyImageServer = true;
+        log?.info?.("[media] Server does not support best image quality; trying full then thumbnail");
+        attempt--;
+        continue;
+      }
+    }
+    lastResult = result;
+    if (result.type === "unsupported" || result.data) return result;
+    if (attempt < maxAttempts) {
+      log?.info?.(`[media] Attempt ${attempt}/${maxAttempts} for ${chatId}:${localId} returned no data, retrying...`);
+      await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+  }
+  return lastResult;
+}
+
 // src/access-control.ts
 import {
   buildChannelKeyCandidates,
@@ -6117,24 +6158,6 @@ function sleep(ms, signal) {
     });
   });
 }
-async function pollMedia(client, chatId, localId, log, maxAttempts = 15, intervalMs = 1e3) {
-  let lastResult = null;
-  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-    const result = await client.getMedia(chatId, localId, "full");
-    lastResult = result;
-    if (result.type === "unsupported") {
-      return result;
-    }
-    if (result.data) {
-      return result;
-    }
-    if (attempt < maxAttempts) {
-      log?.info?.(`[media] Attempt ${attempt}/${maxAttempts} for ${chatId}:${localId} returned no data, retrying...`);
-      await new Promise((r) => setTimeout(r, intervalMs));
-    }
-  }
-  return lastResult;
-}
 function enqueueWeChatSystemEvent(text, contextKey) {
   try {
     const core = getWeChatRuntime();
@@ -6151,7 +6174,7 @@ async function retrieveAttachment(client, chatId, msg, liveAccount, log, maxAtte
   if (!expectedKind) return void 0;
   const fallbackFilename = attachmentFallbackFilename(expectedKind, msg.localId, msg.content);
   try {
-    const result = await pollMedia(client, chatId, msg.localId, log, maxAttempts);
+    const result = await pollMedia(client, chatId, msg.localId, mediaRequestQuality(baseType), log, maxAttempts);
     if (!result) {
       return { kind: expectedKind, status: "unavailable", filename: fallbackFilename };
     }
@@ -6173,9 +6196,9 @@ async function retrieveAttachment(client, chatId, msg, liveAccount, log, maxAtte
       saveMediaBuffer: getWeChatRuntime().channel.media.saveMediaBuffer
     });
     log?.info?.(
-      `[wechat:${liveAccount.accountId}] Saved ${kind} attachment for msg ${msg.localId} (${saved.size} bytes)`
+      `[wechat:${liveAccount.accountId}] Saved ${kind} attachment for msg ${msg.localId} (${saved.size} bytes${result.quality ? `, ${result.quality} quality` : ""})`
     );
-    return { kind, status: "ready", filename: saved.filename, mime, path: saved.path };
+    return { kind, status: "ready", filename: saved.filename, mime, path: saved.path, quality: result.quality };
   } catch (error) {
     const status = error instanceof AttachmentTooLargeError ? "too_large" : "error";
     log?.error?.(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-wechat/agent-wechat",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "type": "module",
   "files": [
     "dist",
@@ -11,7 +11,7 @@
     "esbuild": "^0.25.0",
     "openclaw": "^2026.8.1",
     "typescript": "^5.4.5",
-    "@agent-wechat/shared": "0.3.0"
+    "@agent-wechat/shared": "0.3.1"
   },
   "openclaw": {
     "extensions": [