@haikit/server 0.17.0 → 0.18.0

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,YAAY,CA0L1E"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,YAAY,CA2L1E"}

package/dist/store.js

@@ -87,6 +87,7 @@ export function memoryStore(options = {}) {
                 wokeThrough: 0,
                 wakeTurns: 0,
                 superseded: {},
+                announcing: null,
             };
             conversations.set(conversation.id, conversation);
             return copy(conversation);

package/dist/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haikit/server",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "The haikit server runtime: agent loop, elicit state machine, derived query_ui, and the interaction security boundary.",
   "keywords": [
     "haikit",
@@ -36,7 +36,7 @@
     "prepack": "npm --prefix ../.. run build"
   },
   "dependencies": {
-    "@haikit/core": "0.17.0",
+    "@haikit/core": "0.18.0",
     "@types/node": ">=22"
   },
   "publishConfig": {

package/src/routes.ts

@@ -232,6 +232,33 @@ async function streamNotices(hai: Hai, req: IncomingMessage, res: ServerResponse
       });
   };
 
+  // An update notice goes out as the revision it announces: the surface, with
+  // how long ago it was stored, and its props. Only the last frame carries the
+  // notice's id, so a stream cut off between the two resumes with both. A
+  // revision whose payload is gone, swept with an old conversation's, is
+  // passed over with its id alone, so a browser resumes after it rather than
+  // being sent it again on every reconnect.
+  const sendRevision = async (handle: string, replaces: string, seq: number) => {
+    const record = await store.getPayload(handle, conversationId);
+    if (signal.aborted) return;
+    if (!record) return write(`id: ${seq}\n\n`);
+    const window = typeof record.staleAfterMs === "number" ? record.staleAfterMs : undefined;
+    const open: WireEvent = {
+      type: "ui_open",
+      handle,
+      // no tool call made it: the browser keeps the row of the one it replaces
+      toolId: "",
+      component: record.component,
+      version: record.version,
+      mode: record.mode,
+      ...(window === undefined ? {} : { staleAfterMs: window }),
+      ageMs: Math.max(0, Date.now() - record.createdAt),
+      replaces,
+    };
+    await write(`data: ${JSON.stringify(open)}\n\n`);
+    await write(`id: ${seq}\ndata: ${JSON.stringify({ type: "ui_props", handle, props: record.props } satisfies WireEvent)}\n\n`);
+  };
+
   // Everything after `after`, a page at a time, until a page comes back short.
   // A conversation deleted since the stream opened ends it: there is nothing
   // more to wait for, and the browser's reconnect is then refused.
@@ -243,6 +270,12 @@ async function streamNotices(hai: Hai, req: IncomingMessage, res: ServerResponse
       for (const n of records) {
         if (signal.aborted) return;
         if (n.seq <= after) continue;
+        if (n.replaces !== undefined && n.handle !== undefined) {
+          await sendRevision(n.handle, n.replaces, n.seq);
+          after = n.seq;
+          woken ||= n.kind === "wake";
+          continue;
+        }
         const event: WireEvent = {
           type: "notice",
           seq: n.seq,
@@ -338,7 +371,15 @@ function remember(shown: WireEvent[], event: WireEvent) {
     else {
       // A revision of a surface this turn showed takes its place: a stream
       // joining later sees the surface once, as it is now. Its old props go.
-      delete copy.replaces;
+      // It keeps `replaces`, so a browser that did see the old one swaps it in
+      // place rather than adding a second, and the old one's tool row, which
+      // the browser keeps through a revision too.
+      const before = shown[replaced] as Extract<WireEvent, { type: "ui_open" }>;
+      copy.toolId = before.toolId;
+      // and every handle the surface had before, for a browser that last saw
+      // one of those and missed the revisions between
+      const earlier = [...(before.alsoReplaces ?? []), ...(before.replaces === undefined ? [] : [before.replaces])];
+      if (earlier.length) copy.alsoReplaces = earlier;
       shown[replaced] = copy;
       for (let i = shown.length - 1; i >= 0; i--) {
         const e = shown[i];

package/src/runtime.ts

@@ -14,6 +14,8 @@ import {
   type Tool,
   type ToolCtx,
   type ToolReturn,
+  type Update,
+  type UpdateOptions,
   type WireEvent,
 } from "@haikit/core";
 
@@ -65,6 +67,13 @@ export interface HaiConfig {
    * browser still shows it at once.
    */
   maxWakes?: { count: number; perMs: number };
+  /**
+   * Set when app code revises surfaces with `hai.update`, which refuses
+   * without it. The browser then opens the events stream, which is how a
+   * revision reaches it, and the events route starts the turns an update sent
+   * with `wake` asks for.
+   */
+  updates?: boolean;
 }
 
 /**
@@ -111,9 +120,37 @@ interface Hop {
    * so two renders at once cannot both ask; the handle is known once it shows,
    * and `settled` resolves when its render has shown it or failed.
    */
-  asking: { handle: string | null; settled: Promise<void> } | null;
+  asking: {
+    handle: string | null;
+    settled: Promise<void>;
+    /** The digest it was asked under, and its latest, once a later call in the reply has revised it. */
+    question?: string;
+    digest?: string;
+  } | null;
+}
+
+/** A `hai.update` write, and every call it answers. */
+interface UpdateJob {
+  props: unknown;
+  model: string | undefined;
+  wake: boolean;
+  timeoutMs: number;
+  waiters: { resolve: (written: { handle: string }) => void; reject: (err: unknown) => void }[];
+}
+
+/** The `hai.update` calls for one surface: the next to write, once the one writing is done. */
+interface UpdateQueue {
+  next: UpdateJob | null;
 }
 
+/** How long `hai.update` waits for a turn to let the conversation go, by default. */
+const UPDATE_TIMEOUT_MS = 30_000;
+/** How many conversations `hai.update` remembers its surfaces' handles for. */
+const UPDATE_NAMES_KEPT = 10_000;
+/** The first wait before `hai.update` tries a busy conversation again, and the longest. */
+const UPDATE_RETRY_MS = 100;
+const UPDATE_RETRY_MAX_MS = 2_000;
+
 /** An elicit surface a tool call showed, and the digest its answer goes out under. */
 interface Question {
   handle: string;
@@ -130,6 +167,15 @@ export class Hai {
   private readonly queryUi: Tool;
   /** Handles each conversation has a revision of in flight, so two calls can't revise one at once. */
   private readonly revising = new WeakMap<Conversation, Set<string>>();
+  /** `hai.update` calls by conversation and surface: one writing, and the newest waiting behind it. */
+  private readonly updating = new Map<string, UpdateQueue>();
+  /**
+   * The surfaces `hai.update` has revised, by conversation: each one's first
+   * handle and its latest, both mapped to the first, so calls naming either
+   * share a queue. Kept for the most recent conversations only; one let go of
+   * costs coalescing, never correctness, since every write revises the latest.
+   */
+  private readonly surfaceNames = new Map<string, Map<string, string>>();
   /** What the model gets as its system prompt: the app's, then the scope. */
   readonly system: string;
   private seq = 0;
@@ -171,14 +217,20 @@ export class Hai {
     }
   }
 
-  /** Whether this app sends notices, so the browser should open the events stream. */
+  /**
+   * Whether this app sends notices, `hai.update`'s included, so the browser
+   * should open the events stream.
+   */
   get sendsNotices(): boolean {
-    return this.notices.size > 0;
+    return this.notices.size > 0 || this.config.updates === true;
   }
 
-  /** Whether any of its notices are `wake` notices, which the events route starts turns for. */
+  /**
+   * Whether any of its notices may be `wake` notices, which the events route
+   * starts turns for: a registered one, or an update sent with `wake`.
+   */
   get wakes(): boolean {
-    return [...this.notices.values()].some((n) => n.notice.kind === "wake");
+    return this.config.updates === true || [...this.notices.values()].some((n) => n.notice.kind === "wake");
   }
 
   /**
@@ -225,6 +277,233 @@ export class Hai {
     return { seq: record.seq };
   };
 
+  /**
+   * Revise a surface from outside any turn: a webhook, a job, a price feed.
+   * The revision is stored and attached as `ctx.update` does, under the
+   * conversation's lease, so a click can never act on props the server doesn't
+   * hold. Then an *update notice* tells both sides: the events stream sends
+   * the browser the revision, which it swaps into the component on screen,
+   * and the model hears which handle replaced which, with the new digest, in
+   * the next user message (or at once, with `wake`).
+   *
+   * `handle` may be any handle the surface has had: the revision replaces the
+   * latest. It throws if that one was answered, if the conversation is out of
+   * date, and, after waiting `timeoutMs` for a turn to let the conversation
+   * go, with `ConversationBusy`. A question waiting on the surface waits on
+   * the revision.
+   *
+   * One write per surface is in flight at a time. A call made meanwhile
+   * replaces any still waiting behind it, and every call it replaced resolves
+   * to the handle it writes; a wake any of them asked for still wakes.
+   */
+  readonly update: Update = (conversationId, surface, handle, props, options = {}) => {
+    const impl = surface as AnySurfaceImpl;
+    const name = impl?.surface?.name;
+    if (this.surfaces.get(name) !== impl) {
+      return Promise.reject(new Error(`surface "${name}" is not registered: list it in createHai({ surfaces })`));
+    }
+    // Required even when notices open the events stream: it is also what has
+    // the events route start the turn an update sent with `wake` asks for.
+    if (this.config.updates !== true) {
+      return Promise.reject(new Error("hai.update is off: set createHai({ updates: true })"));
+    }
+    const { timeoutMs = UPDATE_TIMEOUT_MS, model, wake } = options as UpdateOptions;
+    if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs < 0) {
+      return Promise.reject(new RangeError(`timeoutMs must be a finite number of milliseconds, zero or more (got ${String(timeoutMs)})`));
+    }
+    if (model !== undefined && typeof model !== "string") return Promise.reject(new TypeError("model must be a string"));
+    let parsed: unknown;
+    try {
+      // Validated before anything waits: props may come from outside this process.
+      parsed = impl.surface.props.parse(props);
+    } catch (err) {
+      return Promise.reject(err);
+    }
+
+    return new Promise((resolve, reject) => {
+      // the surface's first handle, when it is one `hai.update` has revised here
+      const first = this.surfaceNames.get(conversationId)?.get(handle) ?? handle;
+      const key = `${conversationId}\u0000${first}`;
+      const waiter = { resolve, reject };
+      const queue = this.updating.get(key);
+      if (queue) {
+        const behind = queue.next;
+        queue.next = {
+          props: parsed,
+          model,
+          wake: wake === true || behind?.wake === true,
+          timeoutMs,
+          waiters: [...(behind?.waiters ?? []), waiter],
+        };
+        return;
+      }
+      const fresh: UpdateQueue = { next: { props: parsed, model, wake: wake === true, timeoutMs, waiters: [waiter] } };
+      this.updating.set(key, fresh);
+      void (async () => {
+        for (let job = fresh.next; job; job = fresh.next) {
+          fresh.next = null;
+          try {
+            const { replaced, ...written } = await this.revise(conversationId, impl, handle, job);
+            this.name(conversationId, first, replaced, written.handle);
+            for (const w of job.waiters) w.resolve(written);
+          } catch (err) {
+            for (const w of job.waiters) w.reject(err);
+          }
+        }
+        this.updating.delete(key);
+      })();
+    });
+  };
+
+  /** Record that `first`'s surface went from `replaced` to `latest`, for the next call's queue. */
+  private name(conversationId: string, first: string, replaced: string, latest: string) {
+    const names = this.surfaceNames.get(conversationId) ?? new Map<string, string>();
+    // only the first and the latest are kept: what a caller is likely to hold
+    if (replaced !== first) names.delete(replaced);
+    names.set(first, first).set(latest, first);
+    // most recently revised last, so the oldest conversation goes first
+    this.surfaceNames.delete(conversationId);
+    this.surfaceNames.set(conversationId, names);
+    if (this.surfaceNames.size > UPDATE_NAMES_KEPT) this.surfaceNames.delete(this.surfaceNames.keys().next().value!);
+  }
+
+  /**
+   * Append the update notice this conversation owes, if any, before anything
+   * else is done with it: a revision whose own attempt to append it failed.
+   * One a holder appended before its save failed is not appended again.
+   */
+  private async announce(conversation: Conversation): Promise<void> {
+    const owed = conversation.announcing;
+    if (!owed) return;
+    // The model hasn't taken it in either way: that commits with clearing this.
+    const unread = (await this.config.store.getNotices(conversation.id, conversation.noticedThrough ?? 0)) ?? [];
+    if (!unread.some((n) => n.handle === owed.handle && n.replaces === owed.replaces)) await this.config.store.putNotice(owed);
+    conversation.announcing = null;
+  }
+
+  /** One `hai.update` write: take the lease, revise, let the conversation go. */
+  private async revise(
+    conversationId: string,
+    impl: AnySurfaceImpl,
+    handle: string,
+    job: UpdateJob,
+  ): Promise<{ handle: string; replaced: string }> {
+    const { store } = this.config;
+    // Loading an unknown id would start a new conversation, so make sure it
+    // exists first, with the cheapest read there is.
+    if ((await store.getNotices(conversationId, Number.MAX_SAFE_INTEGER, 1)) === null) {
+      throw new Error(`no conversation ${conversationId}`);
+    }
+    // A turn in progress lands first: wait for it, backing off, up to the timeout.
+    const deadline = Date.now() + job.timeoutMs;
+    let conversation: Conversation | null = null;
+    for (let wait = UPDATE_RETRY_MS; !conversation; wait = Math.min(wait * 2, UPDATE_RETRY_MAX_MS)) {
+      try {
+        conversation = await store.loadConversation(conversationId);
+      } catch (err) {
+        const left = deadline - Date.now();
+        if (!isConversationBusy(err) || left <= 0) throw err;
+        await new Promise((r) => setTimeout(r, Math.min(wait, left)));
+        // not another try once the timeout has passed, even if the turn has gone
+        if (Date.now() >= deadline) throw err;
+      }
+    }
+
+    let failure: unknown = null;
+    let written: { handle: string; replaced: string } | null = null;
+    try {
+      // one an earlier update still owes goes first, in order
+      await this.announce(conversation);
+      written = await this.reviseHeld(conversation, impl, handle, job);
+    } catch (err) {
+      failure = err;
+    }
+    // As a route does at the end of a request: let the conversation go, with
+    // the token kept so the save can prove this is still the rightful holder.
+    conversation.leaseUntil = null;
+    if (!isStaleLease(failure)) {
+      try {
+        await store.saveConversation(conversation);
+      } catch (err) {
+        failure ??= err;
+      }
+    }
+    if (failure) throw failure;
+    return written!;
+  }
+
+  private async reviseHeld(
+    conversation: Conversation,
+    impl: AnySurfaceImpl,
+    handle: string,
+    job: UpdateJob,
+  ): Promise<{ handle: string; replaced: string }> {
+    const { store } = this.config;
+    if (!conversation.handles.includes(handle)) throw new Error(`no surface ${handle} in conversation ${conversation.id}`);
+    // the surface as it is now: updates queued one behind another each revise the last
+    const current = currentHandle(conversation, handle);
+    if (conversation.frozen.includes(current)) throw new Error(`${current} was answered, so it can't be revised`);
+    const record = await store.getPayload(current, conversation.id);
+    if (!record) throw new Error(`no surface ${current} in conversation ${conversation.id}`);
+    if (record.component !== impl.surface.name) throw new Error(`${current} is a ${record.component}, not a ${impl.surface.name}`);
+    // After the reads, right before the write, as for `ctx.update`: a revision
+    // must not bring an out-of-date conversation back by superseding the
+    // surface that closed it.
+    if (await this.refuseIfExpired(conversation, () => {})) {
+      throw new Error("this conversation is out of date; nothing more can be revised in it");
+    }
+
+    const next = await store.putPayload(
+      {
+        conversationId: conversation.id,
+        component: impl.surface.name,
+        version: impl.surface.version,
+        props: job.props,
+        mode: record.mode,
+        staleAfterMs: windowOf(impl),
+      },
+      conversation.leaseToken,
+    );
+    const digest = impl.impl.digest(job.props, { handle: next });
+    // …and once more as it takes effect: the write and the digest take a while too
+    const window = strictest(record.staleAfterMs, windowOf(impl));
+    if (window !== "never" && !(Number.isFinite(record.createdAt) && window !== undefined && record.createdAt + window > Date.now())) {
+      throw new Error("this conversation went out of date while the revision was made; it was not applied");
+    }
+
+    conversation.handles.push(next);
+    (conversation.superseded ??= {})[current] = next;
+    // A question waiting on the surface waits on its revision. Its digest stays
+    // as the model was shown it: the update's text rides in the same message as
+    // the answer, after it, saying what changed.
+    if (conversation.pending?.handle === current) conversation.pending = { ...conversation.pending, handle: next };
+    // The notice it owes commits with it, in one fenced save, so the revision
+    // and its notice can't come apart. Saved before the notice is appended,
+    // which proves the lease is still held: a notice for a revision the history
+    // lost would show the browser a surface every click on is refused.
+    const notice = {
+      conversationId: conversation.id,
+      name: impl.surface.name,
+      version: impl.surface.version,
+      payload: null,
+      model: `${job.model ? `${job.model} ` : ""}${current} was replaced by ${next}; its earlier digest is out of date. Now: ${digest}`,
+      handle: next,
+      replaces: current,
+      ...(job.wake ? { kind: "wake" as const } : {}),
+    };
+    conversation.announcing = notice;
+    await store.saveConversation(conversation);
+    try {
+      await store.putNotice(notice);
+    } catch (err) {
+      // Still owed, and appended by whoever holds the conversation next, before
+      // anything else: the model hears of the revision before it runs again.
+      throw new Error(`${next} is saved, but its update notice could not be stored yet: it goes out with the conversation's next request (${(err as Error).message})`);
+    }
+    conversation.announcing = null;
+    return { handle: next, replaced: current };
+  }
+
   /**
    * Start a turn for the `wake` notices this conversation hasn't taken in, if
    * it can take one now. The events route calls this, and streams the turn
@@ -279,6 +558,7 @@ export class Hai {
   }
 
   private async wakeTurn(conversation: Conversation, emit: Emit): Promise<WakeOutcome> {
+    await this.announce(conversation);
     // a load of an unknown id starts a new conversation, which has not begun either
     if (!conversation.messages.length || conversation.status === "awaiting") return "idle";
     if (await this.refuseIfExpired(conversation, () => {})) return "idle";
@@ -373,11 +653,13 @@ export class Hai {
     conversation: Conversation,
   ): Promise<{ blocks: TextBlock[]; through: number; wake: number }> {
     const through = conversation.noticedThrough ?? 0;
-    if (!this.notices.size) return { blocks: [], through, wake: 0 };
+    if (!this.sendsNotices) return { blocks: [], through, wake: 0 };
     const fresh = (await this.config.store.getNotices(conversation.id, through)) ?? [];
     return {
       blocks: fresh.flatMap((n) =>
-        n.model === null ? [] : [{ type: "text" as const, text: `[App notification: ${n.name}] ${n.model}` }],
+        n.model === null
+          ? []
+          : [{ type: "text" as const, text: n.replaces === undefined ? `[App notification: ${n.name}] ${n.model}` : `[UI update] ${n.model}` }],
       ),
       through: fresh.at(-1)?.seq ?? through,
       // the newest unread wake notice, or 0
@@ -474,6 +756,7 @@ export class Hai {
   // ─────────────────────────────────────────────────── public API
 
   async send(conversation: Conversation, text: string, emit: Emit): Promise<void> {
+    await this.announce(conversation);
     if (await this.refuseIfExpired(conversation, emit)) return;
 
     // The first message is the one that starts the conversation.
@@ -523,6 +806,7 @@ export class Hai {
    */
   async start(conversation: Conversation, emit: Emit): Promise<void> {
     if (!this.config.init || conversation.messages.length > 0) return;
+    await this.announce(conversation);
     const unread = await this.unreadNotices(conversation);
     if (await this.runInit(conversation, withText(unread.blocks, STARTED), emit, unread.through)) return; // parked on its surface
     conversation.status = "idle";
@@ -619,6 +903,7 @@ export class Hai {
     input: { handle: string; action: string; value: unknown },
     emit: Emit,
   ): Promise<void> {
+    await this.announce(conversation);
     if (await this.refuseIfExpired(conversation, emit)) return;
 
     // The payload row carries a conversation id, but that alone is not enough.
@@ -757,8 +1042,9 @@ export class Hai {
    */
   private async refuseIfExpired(conversation: Conversation, emit: Emit): Promise<boolean> {
     if (!conversation.handles.length) return false;
-    const now = Date.now();
     const records = await this.config.store.getPayloads(conversation.handles, conversation.id);
+    // after the read, so a window that ran out while it was in flight counts
+    const now = Date.now();
 
     // the surface that went out of date first is the one that closed it
     let first: { expiredAt: number; age: number; window: number | undefined } | null = null;
@@ -866,8 +1152,18 @@ export class Hai {
         // Hold the resolved siblings too — the API is all-or-nothing per batch.
         conversation.status = "awaiting";
         // At the question's latest revision: a later call in this reply may
-        // have revised it.
-        conversation.pending = { ...parked, handle: currentHandle(conversation, parked.handle), results };
+        // have revised it, and then its answer goes out under the revision's
+        // digest, not the original's.
+        // Only the question's part is replaced: anything the asking call said
+        // after it rides along as before.
+        const handle = currentHandle(conversation, parked.handle);
+        const asking = hop.asking;
+        let digest = parked.digest;
+        if (handle !== parked.handle && asking?.handle === handle && asking.digest !== undefined) {
+          const asked = asking.question;
+          digest = asked !== undefined && parked.digest.startsWith(asked) ? asking.digest + parked.digest.slice(asked.length) : asking.digest;
+        }
+        conversation.pending = { ...parked, handle, digest, results };
         emit({ type: "status", status: "awaiting" });
         await this.emitContext(conversation, emit);
         return;
@@ -916,6 +1212,9 @@ export class Hai {
       surfaceMode: "display" | "elicit",
       // the handle this revises in place, for `update`
       replaces?: string,
+      // last word before the surface is attached and sent: throwing leaves the
+      // stored payload unreferenced, inert as an overtaken turn's
+      beforeAttach?: () => void,
     ) => {
       // Validate before storing: props may originate outside this process.
       const parsed = impl.surface.props.parse(props);
@@ -941,6 +1240,7 @@ export class Hai {
 
       // The split, in two lines. Digest -> model. Payload -> browser.
       const digest = impl.impl.digest(parsed, { handle });
+      beforeAttach?.();
       // Recorded only once the digest is in hand. A surface that fails here is
       // never shown, and a handle in the history counts toward its freshness,
       // so it could otherwise close the conversation over something unseen.
@@ -1000,6 +1300,7 @@ export class Hai {
       try {
         const ret = await show(impl, props, "elicit");
         claim.handle = ret.handle;
+        claim.question = ret.model;
         asked = { handle: ret.handle, digest: ret.model };
         return ret;
       } catch (err) {
@@ -1028,11 +1329,33 @@ export class Hai {
         if (record.component !== impl.surface.name) {
           throw new Error(`${handle} is a ${record.component}, not a ${impl.surface.name}`);
         }
-        const ret = await show(impl, props, record.mode, handle);
+        // Freshness again, last, right before the write: a long turn can
+        // outlast a window that was open when it began, and so can the reads
+        // above. A revision must not bring an out-of-date conversation back
+        // by superseding the surface that closed it.
+        if (await this.refuseIfExpired(conversation, () => {})) {
+          throw new Error("this conversation is out of date; nothing more can be revised in it");
+        }
+        // …and once more as it takes effect: the write and the digest above can
+        // take a while too, and the browser closes the conversation at the old
+        // surface's deadline whether or not a revision is on its way.
+        const window = strictest(record.staleAfterMs, windowOf(impl));
+        const stillFresh = () => {
+          if (window === "never") return;
+          if (!(Number.isFinite(record.createdAt) && window !== undefined && record.createdAt + window > Date.now())) {
+            throw new Error("this conversation went out of date while the revision was made; it was not applied");
+          }
+        };
+        const ret = await show(impl, props, record.mode, handle, stillFresh);
         (conversation.superseded ??= {})[handle] = ret.handle!;
-        // a question waiting on the old surface waits on the new one
-        if (asked?.handle === handle) asked = { handle: ret.handle!, digest: ret.model };
-        if (hop.asking?.handle === handle) hop.asking.handle = ret.handle!;
+        // a question waiting on the old surface waits on the new one; when this
+        // call asked it, its result starts with the revision's digest now, so
+        // that is the part a later call's revision replaces
+        const mine = asked?.handle === handle;
+        if (mine) asked = { handle: ret.handle!, digest: ret.model };
+        if (hop.asking?.handle === handle) {
+          Object.assign(hop.asking, { handle: ret.handle!, digest: ret.model }, mine ? { question: ret.model } : {});
+        }
         return ret;
       } finally {
         revising.delete(handle);

package/src/store.ts

@@ -109,6 +109,7 @@ export function memoryStore(options: MemoryStoreOptions = {}): StoreAdapter {
         wokeThrough: 0,
         wakeTurns: 0,
         superseded: {},
+        announcing: null,
       };
       conversations.set(conversation.id, conversation);
       return copy(conversation);