@haikit/client 0.15.0 → 0.16.0

package/README.md

@@ -129,7 +129,15 @@ The server closes a conversation once any surface passes its freshness window.
 The client knows each window too, so a tab left open closes on time instead of
 looking live until a click is refused: `state.expired` holds the notice,
 `send` and `interact` stop sending, and each surface's element is made `inert`
-with `data-expired` set. `chat.reset()` starts a new conversation; the default
+with `data-expired` set.
+
+The browser counts each window from when it sent the request that rendered
+the surface, which is never later than the server's own stamp, so its
+deadline is never later than the server's. Each surface also comes with
+`ageMs`, how long ago the server stored it: the time its digest took, plus,
+for one replayed to a stream that joined a wake turn part way, how long it
+waited. The window is counted from whichever is earlier. That's a duration,
+not a time, so the two clocks are never compared. `chat.reset()` starts a new conversation; the default
 transcript renders the notice with a button that calls it.
 
 ## Serving it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haikit/client",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "The haikit browser runtime: streams tool payloads into interactive UI surfaces. Plain ESM, no build step, no dependencies.",
   "keywords": [
     "haikit",

package/src/index.js

@@ -293,7 +293,11 @@ export function createChat({ endpoint = "/hai", registry, notices = {} }) {
           state.blocks.push(early);
         }
         if (typeof event.staleAfterMs === "number") {
-          const at = sentAt + event.staleAfterMs;
+          // From when the request that rendered it was sent, or, for a surface
+          // replayed to a stream that joined a wake turn part way, from when
+          // it was stored, by its age: whichever is earlier.
+          const from = typeof event.ageMs === "number" ? Math.min(sentAt, Date.now() - event.ageMs) : sentAt;
+          const at = from + event.staleAfterMs;
           if (state.expiresAt === null || at < state.expiresAt) {
             state.expiresAt = at;
             closingWindow = event.staleAfterMs;