@agent-wechat/cli 0.15.0 → 0.15.1

package/README.md

@@ -90,6 +90,12 @@ Send options:
 
 Media options:
 - `--output <path>` — save to a specific file path
+- `--full` — require an original-resolution image
+- `--thumbnail` — save the cached preview
+- `--best` — explicitly choose the default best-available image behavior
+
+Media retrieval does not open a chat. Use `wx chats open <chatId>` separately
+if WeChat needs to cache a regular photo's standard-size copy.
 
 ### Sessions
 

package/dist/cli.js

@@ -7929,7 +7929,7 @@ import qrTerminal from "qrcode-terminal";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var VERSION = "0.15.0";
+var VERSION = "0.15.1";
 var CONTAINER_NAME = "agent-wechat";
 var GHCR_IMAGE = "ghcr.io/thisnick/agent-wechat";
 var DEFAULT_PORT = 6174;
@@ -8075,8 +8075,13 @@ var messagesCmd = program2.command("messages").description("Message commands");
 messagesCmd.command("list <chatId>").description("List messages for a chat").option("-l, --limit <number>", "Maximum number of messages", "50").option("-o, --offset <number>", "Skip first N messages", "0").option("-j, --json", "Output as JSON").action(async (chatId, opts) => {
   await cmdMessages(getClient(), chatId, parseInt(opts.limit, 10), parseInt(opts.offset, 10), opts.json ?? false);
 });
-messagesCmd.command("media <chatId> <localId>").description("Save a media attachment (full-resolution image, file, or voice)").option("--thumbnail", "Retrieve an image thumbnail instead of full resolution").option("-o, --output <path>", "Output file path").action(async (chatId, localIdStr, opts) => {
-  await cmdMedia(getClient(), chatId, parseInt(localIdStr, 10), opts.output, opts.thumbnail);
+messagesCmd.command("media <chatId> <localId>").description("Save a media attachment (best available image, file, or voice)").option("--full", "Require the original-resolution image").option("--thumbnail", "Retrieve an image thumbnail instead of full resolution").option("--best", "Retrieve the best available image (default)").option("-o, --output <path>", "Output file path").action(async (chatId, localIdStr, opts) => {
+  if (Number(!!opts.full) + Number(!!opts.thumbnail) + Number(!!opts.best) > 1) {
+    console.error("Choose only one of --full, --thumbnail, or --best.");
+    process.exit(1);
+  }
+  const quality = opts.full ? "full" : opts.thumbnail ? "thumbnail" : "best";
+  await cmdMedia(getClient(), chatId, parseInt(localIdStr, 10), opts.output, quality);
 });
 messagesCmd.command("send <chatId>").description("Send a message to a chat").option("--text <text>", "Text message to send").option("--image <path>", "Image file to send").option("--file <path>", "File to send").option("--voice <path>", "Record audio as one or more voice notes").option("--detach", "Return after the voice job is queued").action(async (chatId, opts) => {
   if (!opts.text && !opts.image && !opts.file && !opts.voice) {
@@ -8390,8 +8395,8 @@ async function cmdMessages(client, chatId, limit = 50, offset = 0, json = false)
   console.log(`
 ${messages.length} message(s) shown.`);
 }
-async function cmdMedia(client, chatId, localId, outputPath, thumbnail = false) {
-  const result = await client.getMedia(chatId, localId, thumbnail ? "thumbnail" : "full");
+async function cmdMedia(client, chatId, localId, outputPath, quality = "best") {
+  const result = await client.getMedia(chatId, localId, quality);
   if (result.type === "unsupported") {
     console.error("No media found for this message (unsupported type or not found).");
     process.exit(1);
@@ -8404,9 +8409,10 @@ async function cmdMedia(client, chatId, localId, outputPath, thumbnail = false)
   if (result.data) {
     const buffer = Buffer.from(result.data, "base64");
     fs.writeFileSync(outFile, buffer);
-    console.log(`Saved ${result.type} to ${outFile} (${buffer.length} bytes)`);
+    const variant = result.type === "image" && result.quality ? ` (${result.quality})` : "";
+    console.log(`Saved ${result.type}${variant} to ${outFile} (${buffer.length} bytes)`);
   } else if (result.type === "image") {
-    console.error(`Requested image ${thumbnail ? "thumbnail" : "full resolution"} is not yet available.`);
+    console.error(`Requested image ${quality} is not yet available.${quality === "full" ? " Regular phone sends may have no Original copy; try without --full." : ""}`);
     process.exit(1);
   } else if (result.type === "video") {
     console.error("Video not yet downloaded by WeChat. Try playing the video in the app first.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-wechat/cli",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "type": "module",
   "bin": {
     "wx": "./dist/cli.js"
@@ -17,7 +17,7 @@
     "@types/node": "^22",
     "@types/qrcode-terminal": "^0.12.2",
     "typescript": "^5.4.5",
-    "@agent-wechat/shared": "0.3.0"
+    "@agent-wechat/shared": "0.3.1"
   },
   "publishConfig": {
     "access": "public",