@agent-wechat/cli 0.15.0 → 0.15.2

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

@@ -7870,11 +7870,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),
@@ -7921,6 +7925,14 @@ function createSubscriptionClient(options) {
   };
 }
 
+// src/lib/media-status.ts
+function expiredMediaMessage(result) {
+  if (result.type !== "expired" || result.data) return void 0;
+  const expiry = typeof result.expiresAt === "number" ? new Date(result.expiresAt * 1e3) : void 0;
+  const when = expiry && Number.isFinite(expiry.getTime()) ? ` (${expiry.toISOString()})` : "";
+  return `Media has expired${when} and no cached copy is available. Ask the sender to resend; automatic retries will not recover it.`;
+}
+
 // src/cli.ts
 import { spawn, execSync } from "child_process";
 import { randomBytes } from "crypto";
@@ -7929,7 +7941,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.2";
 var CONTAINER_NAME = "agent-wechat";
 var GHCR_IMAGE = "ghcr.io/thisnick/agent-wechat";
 var DEFAULT_PORT = 6174;
@@ -8075,8 +8087,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 +8407,13 @@ 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);
+  const expired = expiredMediaMessage(result);
+  if (expired) {
+    console.error(expired);
+    process.exit(1);
+  }
   if (result.type === "unsupported") {
     console.error("No media found for this message (unsupported type or not found).");
     process.exit(1);
@@ -8404,9 +8426,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.2",
   "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",
@@ -30,6 +30,7 @@
   },
   "scripts": {
     "build": "node build.js",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "node --test --experimental-strip-types src/lib/*.test.mjs"
   }
 }