diff --git a/packages/wbot/CHANGELOG.md b/packages/wbot/CHANGELOG.md
index f9b63c3..d6b371a 100644
--- a/packages/wbot/CHANGELOG.md
+++ b/packages/wbot/CHANGELOG.md
@@ -24,8 +24,9 @@ All notable changes to the public wbot client are documented in this file.
 
 - Poll incrementally with `messages.updates` and the saved cursor, or use webhooks. Do not loop over
   `conversations.list`; `messages.history` is for looking back, not polling.
-- `captureFreshness.asOfMs` is now rounded to the minute by the Platform; do not rely on
-  sub-minute precision.
+- `captureFreshness.status` is authoritative; `asOfMs` is a lower bound on the last successful
+  scan (exact at status changes, otherwise refreshed at most every 10 minutes). Do not derive
+  freshness from `asOfMs` yourself.
 
 ## 0.2.5 - 2026-11-02
 
diff --git a/packages/wbot/README.md b/packages/wbot/README.md
index d295eec..052fb4e 100644
--- a/packages/wbot/README.md
+++ b/packages/wbot/README.md
@@ -80,8 +80,10 @@ Polling guidance:
   them, then follow each conversation's updates cursor.
 - `messages.history` is for looking back at older context, not for polling.
 
-`captureFreshness.asOfMs` is rounded to the minute so read results stay cacheable; do not compare
-it at sub-minute precision.
+`captureFreshness` is maintained by the Platform so read results stay cacheable: `status` is
+authoritative, and `asOfMs` is a lower bound on the last successful capture scan. It is exact when
+the status changes and otherwise refreshed at most every 10 minutes, so do not compute freshness
+yourself from `asOfMs`.
 
 ## Send a JPEG image from the CLI