@agent-wechat/agent-wechat 1.0.0-beta.11 → 1.0.0-beta.12

package/README.md

@@ -159,6 +159,36 @@ Run `node scripts/native-model-smoke.mjs` and `node scripts/native-media-model-s
 
 Native text/media sends retain daemon intent/job identity and caller idempotency. Text waits for accepted submission; media jobs preserve partial and uncertain outcomes rather than resending. Ordinary audio remains a file; only explicit `audioAsVoice` requests independently encoded voice. Sender/group/mention gates run before retrieval/transcription. Verified voice may use the configured OpenClaw transcription runtime after admission. Native QR login uses a durable daemon operation and authenticated PNG retrieval. Logout commits local inhibition before at most one authenticated native logout, reporting the remote outcome separately; saved-device revocation remains unverified. Explicitly confirmed forgetting removes local auth while retaining history; disconnect retains reusable trust.
 
+## Outgoing attachment sizes
+
+`channels.agent-wechat.mediaMaxMb` limits both incoming retained attachments and
+outgoing sources in MiB. Outgoing sources must also fit the selected kind's
+native limit: ordinary files have a 512 MiB ceiling (536,870,912 bytes);
+video sources allow 50 MiB; images and voice retain 26,214,383 bytes. Native File Transfer PDFs passed
+acceptance, recipient opening and cold byte verification at 32 MiB and 50 MiB.
+Full-client 512 MiB send validation remains pending. The 50 MiB file also passed
+real OpenClaw storage; see the [native capability checklist](../native-client-rust/FEATURES.md).
+Raising `mediaMaxMb` cannot extend the kind-specific limit. Kind selection occurs
+before staging, using the local extension or HTTP content type. Ordinary audio
+is a file unless `audioAsVoice` selects voice.
+
+For ordinary files above 26,214,383 bytes, the adapter polls the same submitted
+job for up to an hour, allowing upload and exact readback before final
+message submission. A timeout or status-poll failure preserves the job ID and idempotency key and never
+automatically sends another copy. Unsupported cache-hit responses or uncertain
+reservations/submissions require inspection. See [Send attachments](https://thisnick.github.io/agent-wechat/use/media/)
+for CLI, HTTP API and SDK examples.
+
+Video sends default to a prepared H.264/AAC playback copy and thumbnail. For one
+video attachment, the regular message tool accepts
+`channelData: { "agent-wechat": { "videoQuality": "original" } }` to include the
+unchanged source too; `"normal"` selects playback only. Set `mediaMaxMb` to allow
+the source size. `forceDocument` (or host alias `asDocument`) sends the media as
+an ordinary file and cannot be combined with video quality. Video jobs poll the
+same job for up to an hour. See the native capability checklist for separate
+server, recipient and local-writeback validation.
+
+
 ## Optional Gateway facade
 
 Set `native.gatewayFacade: {"enabled": true}` to register `/plugins/agent-wechat/native` on the Gateway. The default is disabled. A custom prefix must remain namespaced under `/plugins/...`; changing daemon configuration requires a Gateway reload.