@agent-wechat/agent-wechat 0.15.0 → 0.15.2

package/dist/index.js

@@ -5521,11 +5521,15 @@ var getMediaParamsSchema = external_exports.object({
   quality: external_exports.enum(["full", "thumbnail"]).optional()
 });
 var mediaResultSchema = external_exports.object({
-  type: external_exports.enum(["image", "emoji", "voice", "video", "file", "pending", "unsupported"]),
+  type: external_exports.enum(["image", "emoji", "voice", "video", "file", "pending", "expired", "unsupported"]),
   data: external_exports.string().optional(),
   url: external_exports.string().optional(),
   format: external_exports.string(),
-  filename: external_exports.string()
+  filename: external_exports.string(),
+  quality: external_exports.enum(["full", "standard", "thumbnail"]).optional(),
+  reason: external_exports.string().optional(),
+  expiresAt: external_exports.number().int().positive().optional(),
+  retryable: external_exports.boolean().optional()
 });
 var agentConfigSchema = external_exports.object({
   maxTurns: external_exports.number().int().positive().default(30),
@@ -5563,6 +5567,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";
@@ -5600,6 +5607,9 @@ function renderAttachmentBody(originalBody, attachment, exposeNonVisualPath = tr
     if (attachment.status === "pending") {
       return appendReference(originalBody, `[${label} pending: ${name}]`);
     }
+    if (attachment.status === "expired") {
+      return appendReference(originalBody, `[${label} expired: ${name}; no cached copy available. Ask the sender to resend.]`);
+    }
     return appendReference(originalBody, `[${label} unavailable: ${name} (${attachment.status})]`);
   }
   if (attachment.kind === "file") {
@@ -5615,8 +5625,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 +5902,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" || full.type === "expired") 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.type === "expired" || 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 +6165,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,10 +6181,18 @@ 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 };
     }
+    if (result.type === "expired") {
+      return {
+        kind: expectedKind,
+        status: "expired",
+        filename: result.filename || fallbackFilename,
+        expiresAt: result.expiresAt
+      };
+    }
     if (result.type === "unsupported") {
       if (baseType === 49) return void 0;
       return { kind: expectedKind, status: "unsupported", filename: fallbackFilename };
@@ -6173,9 +6211,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?.(
@@ -6392,6 +6430,7 @@ ${replyBlock}` : replyBlock;
 }
 async function refreshAttachment(message, client, chatId, liveAccount, log) {
   if (!message.attachment) return message;
+  if (message.attachment.status === "expired") return message;
   if (message.attachment.status === "ready" && await attachmentPathExists(message.attachment.path)) {
     return message;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-wechat/agent-wechat",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "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": [