@agent-wechat/agent-wechat 1.0.0-beta.6 → 1.0.0-beta.8

package/dist/index.js

@@ -377,6 +377,13 @@ var NativeWeChatClient = class {
       throw new Error("Invalid native message identity");
     return message;
   }
+  /** Resolve only the stored original in this message's own conversation. */
+  async quotedMessage(accountId, messageId) {
+    const quote = await this.request(`v1/accounts/${id(accountId)}/messages/${id(messageId)}/quote`);
+    if (quote.accountId !== accountId || quote.messageId !== messageId || typeof quote.threadId !== "string" || !["resolved", "embedded", "missing", "invalid", "unsupported", "ambiguous"].includes(quote.state) || (quote.state === "resolved" ? !quote.message || quote.message.accountId !== accountId || quote.message.threadId !== quote.threadId || quote.message.id === messageId : quote.message != null))
+      throw new Error("Invalid native quote identity");
+    return quote;
+  }
   /** Account-wide local search, with the daemon's query-bound opaque cursor. */
   async searchMessages(accountId, options) {
     const result = await this.request(`v1/accounts/${id(accountId)}/messages${listQuery(options)}`);
@@ -441,15 +448,16 @@ var NativeWeChatClient = class {
   }
   async mediaContent(accountId, assetId, options = {}) {
     const max = options.maxBytes ?? 128 * 1024 * 1024;
-    if (!Number.isInteger(max) || max < 1 || max > 128 * 1024 * 1024 || options.range && !/^bytes=(?:\d+-\d*|-\d+)$/.test(options.range))
+    if (!Number.isInteger(max) || max < 1 || max > 128 * 1024 * 1024 || options.range && !/^bytes=(?:\d+-\d*|-\d+)$/.test(options.range) || options.representation != null && !["original", "preview"].includes(options.representation))
       throw new Error("Invalid bounded content request");
-    const response = await this.response(`v1/accounts/${id(accountId)}/media/${id(assetId)}/content`, { signal: options.signal, headers: options.range ? { Range: options.range } : {} });
+    const query = options.representation === "preview" ? "?representation=preview" : "";
+    const response = await this.response(`v1/accounts/${id(accountId)}/media/${id(assetId)}/content${query}`, { signal: options.signal, headers: options.range ? { Range: options.range } : {} });
     const length = response.headers.get("content-length");
     if (length && (!/^\d+$/.test(length) || Number(length) > max)) {
       await response.body?.cancel();
       throw new Error("Native media response exceeds its bound");
     }
-    return { bytes: await this.readBounded(response, max), contentType: response.headers.get("content-type") ?? "application/octet-stream", etag: response.headers.get("etag"), contentRange: response.headers.get("content-range"), status: response.status };
+    return { bytes: await this.readBounded(response, max), contentType: response.headers.get("content-type") ?? "application/octet-stream", etag: response.headers.get("etag"), contentRange: response.headers.get("content-range"), sourceSha256: response.headers.get("x-source-sha256"), status: response.status };
   }
   markRead(accountId, threadId2, expectedVersion) {
     if (typeof expectedVersion !== "string" || !expectedVersion || expectedVersion.length > 128)
@@ -1095,6 +1103,84 @@ async function prepareImageRepresentation(bytes, mime, cfg) {
   }
   throw Error("Native model image representation exceeds its bound");
 }
+async function prepareNativeQuote(params) {
+  const { client, account, message } = params;
+  const guard = () => {
+    params.signal?.throwIfAborted();
+    params.assertCurrent?.();
+  };
+  guard();
+  const comment = (message.body ?? "").slice(0, 16384);
+  const unavailable = (state) => ({ body: `${comment}${comment ? "\n\n" : ""}[Quoted message ${state}; original lookup is confined to this chat]`, pending: false, retryable: state === "unavailable", quote: { state } });
+  if (!message.quote) return unavailable("invalid");
+  await params.beforeMediaAccess?.();
+  guard();
+  let resolution;
+  try {
+    resolution = await client.quotedMessage(account.native.accountId, message.id);
+  } catch (error) {
+    guard();
+    if (!(error instanceof NativeApiError)) throw error;
+    return unavailable("unavailable");
+  }
+  guard();
+  if (resolution.accountId !== message.accountId || resolution.messageId !== message.id || resolution.threadId !== message.threadId) throw Error("Native quote identity does not match its message");
+  if (resolution.state === "embedded") {
+    if (resolution.message != null || (message.quote.type === 1 ? typeof resolution.embeddedText !== "string" || resolution.embeddedText.length > 16384 : message.quote.type !== 3 || resolution.embeddedImage !== true)) throw Error("Invalid embedded quote resolution");
+    const author = { senderId: resolution.senderId ?? null, direction: null };
+    if (params.allowQuotedMessage && !await params.allowQuotedMessage(author)) return unavailable("not permitted");
+    guard();
+    const quote2 = { state: "embedded", senderId: resolution.senderId ?? void 0, type: message.quote.type };
+    const prefix2 = `${comment}${comment ? "\n\n" : ""}[Quoted ${message.quote.type === 3 ? "image" : "text"} from ${resolution.senderId ?? "unknown sender"}; embedded in quote, original not stored]
+`;
+    if (message.quote.type === 1) return { body: `${prefix2}${resolution.embeddedText}
+[/Quoted message]`, pending: false, quote: quote2 };
+    const beforeMediaAccess2 = async () => {
+      await params.beforeMediaAccess?.();
+      guard();
+      if (params.allowQuotedMessage && !await params.allowQuotedMessage(author)) throw Error("Quoted message is no longer permitted");
+      guard();
+    };
+    const prepared2 = await prepareNativeAttachment({ ...params, message: { ...message, type: 3, appMessageType: void 0, quote: void 0 }, beforeMediaAccess: beforeMediaAccess2 });
+    return {
+      ...prepared2,
+      body: `${prefix2}${prepared2.body}
+[/Quoted message]`,
+      pending: false,
+      quote: quote2,
+      ...prepared2.pending ? { attachment: { kind: "image", status: "pending", filename: "quoted-image" } } : {}
+    };
+  }
+  if (resolution.state !== "resolved") {
+    if (!["missing", "invalid", "unsupported", "ambiguous"].includes(resolution.state) || resolution.message != null) throw Error("Invalid native quote resolution");
+    return unavailable(resolution.state);
+  }
+  const original = resolution.message;
+  if (!original || original.accountId !== message.accountId || original.threadId !== message.threadId || original.id === message.id || original.serverId !== message.quote.serverId || original.type !== message.quote.type || ![1, 3].includes(original.type)) throw Error("Native quoted original crosses its message boundary");
+  if (params.allowQuotedMessage && !await params.allowQuotedMessage(original)) return unavailable("not permitted");
+  guard();
+  const quote = { state: "resolved", messageId: original.id, senderId: original.senderId ?? void 0, type: original.type };
+  const prefix = `${comment}${comment ? "\n\n" : ""}[Quoted ${original.type === 3 ? "image" : "text"} from ${original.senderId ?? "unknown sender"}; message ${original.id}]
+`;
+  if (original.type === 1) return { body: `${prefix}${(original.body ?? "").slice(0, 16384)}
+[/Quoted message]`, pending: false, quote };
+  const beforeMediaAccess = async () => {
+    await params.beforeMediaAccess?.();
+    guard();
+    if (params.allowQuotedMessage && !await params.allowQuotedMessage(original)) throw Error("Quoted message is no longer permitted");
+    guard();
+  };
+  const prepared = await prepareNativeAttachment({ ...params, message: original, beforeMediaAccess });
+  return {
+    ...prepared,
+    body: `${prefix}${prepared.body}
+[/Quoted message]`,
+    pending: false,
+    quote,
+    ...prepared.pending ? { attachment: { kind: "image", status: "pending", filename: "quoted-image" } } : {},
+    suppliedAssets: prepared.suppliedAssets?.map((asset) => ({ ...asset, sourceMessageId: original.id }))
+  };
+}
 async function prepareNativeAttachment(params) {
   const { client, account, message, core } = params;
   const attachmentKind = kind(message.type);
@@ -1108,6 +1194,9 @@ async function prepareNativeAttachment(params) {
     await params.beforeMediaAccess?.();
     guard();
   };
+  if (message.type === 49 && message.appMessageType === 57) return prepareNativeQuote(params);
+  if (message.type === 49 && message.appMessageType === 19) return { body: message.body?.slice(0, 65536) || "[Forwarded chat history unavailable]", pending: false };
+  if (message.type === 49 && message.appMessageType != null && message.appMessageType !== 6) return { body: `[Unsupported WeChat app message subtype ${message.appMessageType}]`, pending: false, retryable: false };
   if (!attachmentKind) return { body: message.type === 1 ? message.body ?? "" : `[Unsupported WeChat message type ${message.type}]`, pending: false };
   const accountId = account.native.accountId;
   const maxBytes = Math.min(account.mediaMaxMb * 1024 * 1024, 128 * 1024 * 1024);
@@ -1197,13 +1286,27 @@ async function prepareNativeAttachment(params) {
   };
   let suppliedPath = saved.path, suppliedMime = mime, suppliedHash = hash, suppliedLength = content.bytes.length;
   let body = renderAttachmentBody("", attachment);
-  if (attachmentKind === "image" && params.cfg) {
-    const representation = await prepareImageRepresentation(Buffer.from(content.bytes), mime, params.cfg);
-    if (representation.preview) {
+  if (attachmentKind === "image" && (params.cfg || mime === "image/x-wxgf")) {
+    let imageBytes = Buffer.from(content.bytes), imageMime = mime;
+    const wxgf = mime === "image/x-wxgf";
+    if (wxgf) {
+      const preview = asset.preview;
+      if (!preview || preview.sourceSha256 !== hash || !/^[a-f0-9]{64}$/.test(preview.sha256) || !Number.isInteger(preview.byteLength) || preview.byteLength <= 0 || preview.byteLength > 16 * 1024 * 1024 || !["image/jpeg", "image/png"].includes(preview.contentType)) throw Error("Native WXGF preview metadata did not verify");
+      await authorize();
+      const derived = await client.mediaContent(accountId, asset.id, { maxBytes: preview.byteLength, representation: "preview", signal: params.signal });
+      guard();
+      const derivedMime = derived.contentType.split(";", 1)[0].trim().toLowerCase();
+      if (derived.sourceSha256 !== hash || derivedMime !== preview.contentType || derived.bytes.length !== preview.byteLength || createHash4("sha256").update(derived.bytes).digest("hex") !== preview.sha256) throw Error("Native WXGF preview integrity did not verify");
+      imageBytes = Buffer.from(derived.bytes);
+      imageMime = derivedMime;
+    }
+    const representation = await prepareImageRepresentation(imageBytes, imageMime, params.cfg);
+    if (wxgf || representation.preview) {
+      const extension = representation.mime === "image/png" ? "png" : "jpg";
       const normalized = await saveManagedAttachment({
         data: representation.bytes.toString("base64"),
         mime: representation.mime,
-        filename: `${filename}.model.jpg`,
+        filename: `${filename}.model.${extension}`,
         maxBytes: 5 * 1024 * 1024,
         saveMediaBuffer: core.channel.media.saveMediaBuffer
       });
@@ -1211,7 +1314,8 @@ async function prepareNativeAttachment(params) {
       suppliedMime = representation.mime;
       suppliedHash = normalized.sha256;
       suppliedLength = normalized.size;
-      body += `
+      body += wxgf ? `
+[Model image: WXGF still preview; original retained separately; animation and transparency are not represented]` : `
 [Model image: prepared still preview; original retained separately]`;
     }
   }
@@ -1511,7 +1615,7 @@ function nativeDispatchManifest(params) {
   const history = params.history ?? [];
   if (history.length > 200 || history.some((message) => message.accountId !== params.message.accountId || message.threadId !== params.message.threadId || message.id === params.message.id)) throw Error("Invalid native history manifest");
   const assets = Object.freeze((params.assets ?? []).map((asset) => {
-    if (typeof asset.id !== "string" || !asset.id || asset.id.length > 2048 || !/^[a-f0-9]{64}$/.test(asset.sha256) || !Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > 128 * 1024 * 1024 || typeof asset.path !== "string" || !isAbsolute3(asset.path) || asset.path.length > 4096 || typeof asset.mime !== "string" || asset.mime.length > 128 || !/^[a-z0-9.+-]+\/[a-z0-9.+-]+$/.test(asset.mime) || !["image", "audio", "video", "file"].includes(asset.kind) || !["model_image", "file_reference"].includes(asset.role) || asset.role === "model_image" && (asset.kind !== "image" || !asset.mime.startsWith("image/") || !asset.runtimeMedia) || !["trigger", "history"].includes(asset.contextRole) || asset.contextRole === "history" && !history.some((message) => message.id === asset.messageId)) throw Error("Invalid native supplied asset manifest");
+    if (typeof asset.id !== "string" || !asset.id || asset.id.length > 2048 || !/^[a-f0-9]{64}$/.test(asset.sha256) || !Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > 128 * 1024 * 1024 || typeof asset.path !== "string" || !isAbsolute3(asset.path) || asset.path.length > 4096 || typeof asset.mime !== "string" || asset.mime.length > 128 || !/^[a-z0-9.+-]+\/[a-z0-9.+-]+$/.test(asset.mime) || !["image", "audio", "video", "file"].includes(asset.kind) || !["model_image", "file_reference"].includes(asset.role) || asset.role === "model_image" && (asset.kind !== "image" || !asset.mime.startsWith("image/") || !asset.runtimeMedia) || !["trigger", "history"].includes(asset.contextRole) || asset.sourceMessageId != null && (typeof asset.sourceMessageId !== "string" || !asset.sourceMessageId || asset.sourceMessageId.length > 8192 || ![params.message, ...history].some((message) => message.id === asset.messageId && message.type === 49 && message.appMessageType === 57 && message.quote?.type === 3)) || asset.contextRole === "history" && !history.some((message) => message.id === asset.messageId)) throw Error("Invalid native supplied asset manifest");
     return Object.freeze({ ...asset });
   }));
   const messageSid = `wechat-native:${params.message.accountId}:${params.message.id}`;
@@ -1537,14 +1641,16 @@ function nativeDispatchManifest(params) {
         params.message.type,
         params.message.body,
         params.message.mentions,
-        params.message.serverId
+        params.message.serverId,
+        params.message.appMessageType,
+        params.message.quote
       ])),
       role: "trigger"
     })]),
     ...history.length ? { historyInputs: Object.freeze(history.map((message) => Object.freeze({
       id: message.id,
       version: message.version ?? "",
-      contentSha256: digest(JSON.stringify([message.id, message.version, message.senderId, message.type, message.body, message.mentions, message.serverId])),
+      contentSha256: digest(JSON.stringify([message.id, message.version, message.senderId, message.type, message.body, message.mentions, message.serverId, message.appMessageType, message.quote])),
       role: "history"
     }))) } : {},
     assets,
@@ -1842,8 +1948,9 @@ async function dispatchNativeMessage(params) {
     return "ignored";
   }
   let preparedMedia;
+  const allowQuotedMessage = async (original) => original.direction === "outgoing" || !!original.senderId && (await senderAdmission(original.senderId)).ingress.admission === "dispatch";
   try {
-    preparedMedia = await (params.prepareAttachment ?? prepareNativeAttachment)({ client, account, message, core, cfg });
+    preparedMedia = await (params.prepareAttachment ?? prepareNativeAttachment)({ client, account, message, core, cfg, allowQuotedMessage });
   } catch {
     state.update(message.id, { state: "needs_review" });
     return "needs_review";
@@ -1856,7 +1963,7 @@ async function dispatchNativeMessage(params) {
     if (item.message.senderId && (await senderAdmission(item.message.senderId)).ingress.admission === "dispatch") admitted.push(item.message);
   }
   const history = await prepareNativeHistory(admitted, async (historical) => transcribeNativeAttachment(
-    await (params.prepareAttachment ?? prepareNativeAttachment)({ client, account, message: historical, core, cfg }),
+    await (params.prepareAttachment ?? prepareNativeAttachment)({ client, account, message: historical, core, cfg, allowQuotedMessage }),
     core,
     cfg
   ));
@@ -1912,7 +2019,7 @@ async function dispatchNativeMessage(params) {
     history: admitted
   });
   state.beginDispatch(message.id, dispatchManifest, buffered.map((item) => item.message.id));
-  const callback = readPolicy !== "on_inbound" && (message.type === 1 || preparedMedia.attachment?.status === "ready" && preparedMedia.suppliedAssets?.length) ? state.preparedCallback([message.id], readPolicy) : void 0;
+  const callback = readPolicy !== "on_inbound" && (message.type === 1 || message.type === 49 && message.appMessageType === 19 && !!message.body || preparedMedia.quote?.type === 1 && ["resolved", "embedded"].includes(preparedMedia.quote.state) || preparedMedia.attachment?.status === "ready" && preparedMedia.suppliedAssets?.length) ? state.preparedCallback([message.id], readPolicy) : void 0;
   if (callback) trackNativePreparedInput(dispatchManifest, callback);
   let failed = false;
   let delivery = 0;
@@ -2590,8 +2697,11 @@ function threadId(value) {
   return string(string(value, "thread ID").replace(/^(?:agent-)?wechat:(?:group:)?/i, ""), "thread ID");
 }
 function messageResult(message, retrievalTool = "wechat_media") {
-  const kind2 = message.type === 3 ? "image" : message.type === 47 ? "sticker" : message.type === 34 ? "voice" : message.type === 43 ? "video" : message.type === 49 ? "file" : "unsupported";
-  const body = message.type === 1 ? message.body ?? "" : `[WeChat ${kind2} message; attachment content has not been retrieved by this tool]`;
+  const isQuote = message.type === 49 && message.appMessageType === 57;
+  const isForward = message.type === 49 && message.appMessageType === 19;
+  const kind2 = isQuote ? "quote" : isForward ? "forwarded_history" : message.type === 3 ? "image" : message.type === 47 ? "sticker" : message.type === 34 ? "voice" : message.type === 43 ? "video" : message.type === 49 && (message.appMessageType == null || message.appMessageType === 6) ? "file" : "unsupported";
+  const body = message.type === 1 || isForward ? message.body ?? "" : isQuote ? `${message.body ?? ""}
+[Quoted original not retrieved; use ${retrievalTool} with this message ID]` : `[WeChat ${kind2} message; attachment content has not been retrieved by this tool]`;
   return {
     id: message.id,
     threadId: message.threadId,
@@ -2599,10 +2709,12 @@ function messageResult(message, retrievalTool = "wechat_media") {
     senderId: message.senderId,
     direction: message.direction,
     type: message.type,
+    appMessageType: message.appMessageType,
+    quote: message.quote,
     createdAt: message.createdAt,
     body: body.slice(0, 4e3),
     bodyTruncated: body.length > 4e3,
-    attachment: message.type !== 1 && kind2 !== "unsupported" ? { kind: kind2, retrievalTool, messageId: message.id } : void 0
+    attachment: message.type !== 1 && !isForward && kind2 !== "unsupported" ? { kind: kind2, retrievalTool, messageId: message.id } : void 0
   };
 }
 function createNativeHistoryTools(context, dependencies = {}) {
@@ -2720,6 +2832,7 @@ function createLookupTools(context, dependencies, archive) {
               waitMs: 2e3,
               signal,
               assertCurrent: guard,
+              allowQuotedMessage: async (original) => original.direction === "outgoing" || await allowed(original.senderId ?? void 0),
               beforeMediaAccess: async () => {
                 if (!await allowed(requesterSenderId) || message.direction !== "outgoing" && !await allowed(message.senderId ?? void 0)) throw Error("WeChat conversation access is no longer allowed");
               }
@@ -2741,8 +2854,9 @@ function createLookupTools(context, dependencies, archive) {
           const details = {
             messageId: message.id,
             threadId: message.threadId,
-            status: prepared.pending ? "pending" : prepared.attachment?.status ?? "unsupported",
+            status: prepared.pending ? "pending" : prepared.attachment?.status ?? prepared.quote?.state ?? "unsupported",
             attachment: prepared.attachment,
+            quote: prepared.quote,
             variant: prepared.variant,
             jobId: prepared.jobId,
             retryable: prepared.retryable ?? false,
@@ -2786,13 +2900,13 @@ function createLookupTools(context, dependencies, archive) {
     tool(archiveNames[1], "search", "Search locally stored messages across every thread in the configured WeChat account, including other senders. Optional threadId narrows the search. Follow nextCursor with the same query and thread selection; no remote backfill or read marking.", { query: querySchema, threadId: messageIdSchema, ...pageSchema }, ["query"]),
     tool(archiveNames[2], "history", "Read the locally stored history of any thread in the configured WeChat account, newest first, without sender filtering or read marking. Use wechat_archive_threads to find thread IDs.", { threadId: messageIdSchema, ...pageSchema }, ["threadId"]),
     tool(archiveNames[3], "message", "Look up a stored message in any thread of the configured WeChat account by its exact opaque message ID. Use wechat_archive_media to retrieve its attachment.", { messageId: messageIdSchema }, ["messageId"]),
-    tool(archiveNames[4], "media", "Retrieve an attachment from any thread in the configured WeChat account by its message ID. Returns verified managed file paths and an image preview for vision. Cached bytes first; missing media requests a bounded server-owned download unless download=false. Preserve pending/expired/unavailable results and never automatically retry retryable=false. No sends or read marking.", mediaSchema, ["messageId"])
+    tool(archiveNames[4], "media", "Retrieve an attachment or quoted text/image from any thread in the configured WeChat account by its message ID. Use the parent quote message ID for quotes. Returns verified managed file paths and an image preview for vision. Cached bytes first; missing media requests a bounded server-owned download unless download=false. Preserve pending/expired/unavailable results and never automatically retry retryable=false. No sends or read marking.", mediaSchema, ["messageId"])
   ];
   return [
     tool(names[0], "history", "Read the current WeChat conversation's locally stored messages, newest first, beyond the recent inbound buffer. Follow nextCursor for older history; no remote history backfill or read marking.", { ...pageSchema }),
     tool(names[1], "search", "Search the current WeChat conversation's locally stored message text by case-insensitive substring, beyond buffered messages. Follow nextCursor with the same query in this conversation.", { query: querySchema, ...pageSchema }, ["query"]),
     tool(names[2], "message", "Look up a stored message by its exact opaque message ID in the current WeChat conversation. Media is described without downloading it; use wechat_media to retrieve its attachment. Long text is bounded.", { messageId: messageIdSchema }, ["messageId"]),
-    tool(names[3], "media", "Retrieve a message attachment from the current WeChat conversation. Returns a verified local file path and an image preview for vision when applicable. Uses cached bytes first; download defaults to true and requests a bounded server-owned transfer if missing. Pending results may be checked again; never automatically retry confirmed expiry or retryable=false. Does not send messages or mark the thread read.", mediaSchema, ["messageId"])
+    tool(names[3], "media", "Retrieve a message attachment or quoted text/image from the current WeChat conversation. Use the parent quote message ID for quotes. Returns a verified local file path and an image preview for vision when applicable. Uses cached bytes first; download defaults to true and requests a bounded server-owned transfer if missing. Pending results may be checked again; never automatically retry confirmed expiry or retryable=false. Does not send messages or mark the thread read.", mediaSchema, ["messageId"])
   ];
 }
 function registerNativeHistoryTools(api) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-wechat/agent-wechat",
-  "version": "1.0.0-beta.6",
+  "version": "1.0.0-beta.8",
   "type": "module",
   "files": [
     "dist",