@agent-wechat/agent-wechat 1.0.0-beta.4 → 1.0.0-beta.5

package/dist/index.js

@@ -22,7 +22,7 @@ var nativeConfigSchema = {
       }
     }] },
     consumerStateDir: { type: "string" },
-    readPolicy: { type: "string", enum: ["never", "on_model_dispatch"] },
+    readPolicy: { type: "string", enum: ["never", "on_inbound", "on_model_dispatch"] },
     gatewayFacade: { type: "object", additionalProperties: false, required: ["enabled"], properties: { enabled: { type: "boolean" }, prefix: { type: "string" } } }
   }
 };
@@ -734,7 +734,7 @@ function collectWeChatStatusIssues(accounts) {
         accountId: snapshot.accountId,
         kind: "runtime",
         message: "Prepared model handoff was not confirmed by this OpenClaw host; automatic read state remains unchanged.",
-        fix: "Use a compatible prepared-run SDK hook, or select native.readPolicy=never while retaining explicit local read control."
+        fix: "Select native.readPolicy=on_inbound to mark successfully handled conversations read without model hooks, or use a compatible prepared-run SDK hook."
       });
     }
     if ((snapshot.needsReview ?? 0) > 0) {
@@ -1573,7 +1573,7 @@ function nativeWasMentioned(message) {
   return message.mentions?.state === "known" && message.mentions.self === true;
 }
 async function projectNativeRead(client, accountId, state) {
-  const pending2 = state.items().filter((value) => value.readPending && value.runId);
+  const pending2 = state.items().filter((value) => value.readPending);
   const threads = [...new Set(pending2.map((item) => item.message.threadId))];
   for (const threadId of threads) {
     for (let attempt = 0; attempt < 2; attempt++) {
@@ -1604,6 +1604,7 @@ async function projectNativeRead(client, accountId, state) {
 }
 async function dispatchNativeMessage(params) {
   const { client, state, account, message, cfg, core } = params;
+  const readPolicy = account.native?.readPolicy ?? "on_inbound";
   const custody = state.get(message.id);
   if (!custody || custody.state !== "received") return "needs_review";
   if (custody.origin !== "live" || message.direction !== "incoming" || ![1, 3, 34, 43, 47, 49].includes(message.type) || message.type === 1 && !message.body || !message.senderId) {
@@ -1698,7 +1699,7 @@ async function dispatchNativeMessage(params) {
     assets: preparedMedia.suppliedAssets ?? []
   });
   state.update(message.id, { state: "dispatching", dispatchManifest });
-  const callback = message.type === 1 || preparedMedia.attachment?.status === "ready" && preparedMedia.suppliedAssets?.length ? state.preparedCallback([message.id], account.native?.readPolicy ?? "on_model_dispatch") : void 0;
+  const callback = readPolicy !== "on_inbound" && (message.type === 1 || 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;
@@ -1732,8 +1733,12 @@ async function dispatchNativeMessage(params) {
       // and media-snapshot bridge; unsupported or ambiguous handoffs leave reads unchanged.
       replyOptions: { runId: dispatchManifest.runId, onModelSelected, onPreparedAgentRunStart: callback }
     });
-    const prepared = Boolean(state.get(message.id)?.runId);
-    state.update(message.id, { state: failed ? "needs_review" : "completed", handoffUnconfirmed: !prepared });
+    const readPending = readPolicy === "on_inbound" && !failed && ingress.ingress.admission === "dispatch" ? true : state.get(message.id)?.readPending;
+    state.update(message.id, {
+      state: failed ? "needs_review" : "completed",
+      readPending,
+      handoffUnconfirmed: readPolicy === "on_model_dispatch" && !state.get(message.id)?.runId
+    });
     return failed ? "needs_review" : "completed";
   } catch {
     state.update(message.id, { state: "needs_review" });
@@ -1767,9 +1772,12 @@ async function startNativeMonitor(opts) {
   const core = getWeChatRuntime();
   let backoff = 250;
   let readTask;
-  const flushRead = () => readTask ??= projectNativeRead(host2.client, native.accountId, state).finally(() => {
-    readTask = void 0;
-  });
+  const flushRead = () => {
+    if (native.readPolicy === "never") return Promise.resolve();
+    return readTask ??= projectNativeRead(host2.client, native.accountId, state).finally(() => {
+      readTask = void 0;
+    });
+  };
   const process2 = async () => {
     const cfg = core.config.current();
     const account = resolveWeChatAccount(cfg, opts.account.accountId) ?? opts.account;
@@ -1788,10 +1796,10 @@ async function startNativeMonitor(opts) {
     try {
       await flushRead();
     } catch {
-      opts.log?.error?.("Native read projection is pending; prepared thread receipt retained for retry");
+      opts.log?.error?.("Native read projection is pending; thread read receipt retained for retry");
     }
     const needsReview = state.items().filter((value) => value.state === "needs_review" || value.phoneReadState === "needs_review" || value.phoneReadState === "rejected").length;
-    const handoffUnconfirmed = native.readPolicy !== "never" && state.items().some((value) => value.handoffUnconfirmed);
+    const handoffUnconfirmed = native.readPolicy === "on_model_dispatch" && state.items().some((value) => value.handoffUnconfirmed);
     const accountStatus = await host2.client.account(native.accountId);
     opts.setStatus({
       accountId: account.accountId,
@@ -1807,9 +1815,9 @@ async function startNativeMonitor(opts) {
     await flushRead();
     if (!opts.abortSignal.aborted) opts.setStatus({
       accountId: opts.account.accountId,
-      handoffUnconfirmed: native.readPolicy !== "never" && state.items().some((value) => value.handoffUnconfirmed)
+      handoffUnconfirmed: native.readPolicy === "on_model_dispatch" && state.items().some((value) => value.handoffUnconfirmed)
     });
-  }, () => opts.log?.error?.("Native read projection remains pending; prepared thread receipts retained"));
+  }, () => opts.log?.error?.("Native read projection remains pending; thread read receipts retained"));
   try {
     while (!opts.abortSignal.aborted) {
       try {
@@ -2361,7 +2369,8 @@ var plugin = {
     api.registerChannel({ plugin: wechatPlugin });
     const stopFacade = selected?.native ? registerNativeFacade(api, selected.native) : () => {
     };
-    const stopPreparedBoundary = registerNativePreparedBoundary(api);
+    const stopPreparedBoundary = selected?.native?.readPolicy && selected.native.readPolicy !== "on_inbound" ? registerNativePreparedBoundary(api) : () => {
+    };
     api.registerService({
       id: "agent-wechat-native",
       reload: { configPrefixes: ["plugins.entries.agent-wechat.config", "channels.agent-wechat", "secrets"] },

package/openclaw.plugin.json

@@ -95,6 +95,7 @@
             "type": "string",
             "enum": [
               "never",
+              "on_inbound",
               "on_model_dispatch"
             ]
           },
@@ -274,6 +275,7 @@
                 "type": "string",
                 "enum": [
                   "never",
+                  "on_inbound",
                   "on_model_dispatch"
                 ]
               },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-wechat/agent-wechat",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.5",
   "type": "module",
   "files": [
     "dist",
@@ -183,6 +183,7 @@
                   "type": "string",
                   "enum": [
                     "never",
+                    "on_inbound",
                     "on_model_dispatch"
                   ]
                 },