@haikit/server 0.12.0 → 0.14.0

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.12.0",
+  "version": "0.14.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.12.0",
+    "@haikit/core": "0.14.0",
     "@types/node": ">=22"
   },
   "publishConfig": {

package/src/index.ts

@@ -1,4 +1,4 @@
-export { Hai, DEFAULT_SCOPE, type HaiConfig } from "./runtime.js";
+export { Hai, DEFAULT_SCOPE, type HaiConfig, type WakeOutcome } from "./runtime.js";
 export { memoryStore } from "./store.js";
 export { nodeHandler } from "./routes.js";
 

package/src/routes.ts

@@ -1,23 +1,33 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { isConversationBusy, isStaleLease } from "@haikit/core";
-import type { Emit, WireEvent } from "@haikit/core";
+import type { Emit, NoticeRecord, WireEvent } from "@haikit/core";
 import type { Hai } from "./runtime.js";
 
 /**
- * Node http handler for the three routes. Returns true if it handled the
- * request.
+ * Node http handler for the three routes, and a fourth when the app sends
+ * notices. Returns true if it handled the request.
  *
- * All three stream SSE: chat and interact because both can resume the agent
- * loop, start because the init tool it runs can render surfaces. Note what the
- * interact route accepts: {handle, action, value} and nothing else. The client
- * cannot name a tool, a handler, or an action target.
+ * The three POST routes stream SSE: chat and interact because both can resume
+ * the agent loop, start because the init tool it runs can render surfaces.
+ * Note what the interact route accepts: {handle, action, value} and nothing
+ * else. The client cannot name a tool, a handler, or an action target.
+ *
+ * `GET /events` streams a conversation's notices, and the turns `wake`
+ * notices start. It accepts nothing from the browser beyond which
+ * conversation, and where to resume.
  */
 export function nodeHandler(hai: Hai, basePath = "/hai") {
   return async function handle(req: IncomingMessage, res: ServerResponse): Promise<boolean> {
     const url = new URL(req.url ?? "/", "http://localhost");
-    if (req.method !== "POST" || !url.pathname.startsWith(basePath)) return false;
-
+    if (!url.pathname.startsWith(basePath)) return false;
     const route = url.pathname.slice(basePath.length);
+
+    if (req.method === "GET" && route === "/events" && hai.sendsNotices) {
+      await streamNotices(hai, req, res, url);
+      return true;
+    }
+
+    if (req.method !== "POST") return false;
     if (route !== "/chat" && route !== "/interact" && route !== "/start") return false;
 
     const body = await readJson(req);
@@ -45,7 +55,12 @@ export function nodeHandler(hai: Hai, basePath = "/hai") {
 
     const emit = openSSE(res);
     if (route === "/chat" || route === "/start") {
-      emit({ type: "hello", conversationId: conversation.id, model: hai.config.model.id });
+      emit({
+        type: "hello",
+        conversationId: conversation.id,
+        model: hai.config.model.id,
+        ...(hai.sendsNotices ? { events: true as const } : {}),
+      });
     }
 
     let superseded = false;
@@ -91,6 +106,289 @@ export function nodeHandler(hai: Hai, basePath = "/hai") {
   };
 }
 
+/**
+ * The longest a notice waits to be read. A store's `watch` makes it sooner;
+ * this is what still finds a notice whose wake-up was lost.
+ */
+const POLL_MS = 2_000;
+/** Proxies drop a stream that says nothing for long; a comment keeps it open. */
+const HEARTBEAT_MS = 25_000;
+
+/** Notices read from the store at a time, so a long backlog goes out page by page. */
+const PAGE = 100;
+
+/**
+ * Stream a conversation's notices: every one after where the browser has got
+ * to (`Last-Event-ID` on a reconnect, else `?after=`), then each as it lands.
+ * Takes no lease and writes nothing. Each notice goes out as its payload; its
+ * model text is not in it: that reaches the browser only as part of the
+ * history, in the `context` event, once a turn has taken it in.
+ *
+ * Bounded both ways. The store is read a page at a time, so a conversation
+ * with years of notices is never held in memory at once, and nothing more is
+ * written while the socket is still taking what was, so a reader that is slow
+ * cannot make the server buffer every notice for it.
+ */
+async function streamNotices(hai: Hai, req: IncomingMessage, res: ServerResponse, url: URL) {
+  const { store } = hai.config;
+  const conversationId = url.searchParams.get("conversationId") ?? "";
+  const resume = Number(req.headers["last-event-id"] ?? url.searchParams.get("after") ?? 0);
+  let after = Number.isSafeInteger(resume) && resume > 0 ? resume : 0;
+
+  const first = await store.getNotices(conversationId, after, PAGE);
+  if (first === null) {
+    res.writeHead(404, { "content-type": "application/json" });
+    res.end(JSON.stringify({ error: "unknown conversation" }));
+    return;
+  }
+
+  res.writeHead(200, {
+    "content-type": "text/event-stream",
+    "cache-control": "no-cache",
+    connection: "keep-alive",
+  });
+  // Sent now, not with the first frame: with nothing to catch up on, that is a
+  // heartbeat away, and the browser's request would hang open until then.
+  res.flushHeaders();
+  const aborter = new AbortController();
+  const { signal } = aborter;
+  res.on("close", () => aborter.abort());
+
+  // Resolves once the socket has taken what is queued, or the browser has gone.
+  const write = async (chunk: string) => {
+    if (res.write(chunk)) return;
+    await new Promise<void>((resolve) => {
+      const done = () => {
+        res.off("drain", done);
+        signal.removeEventListener("abort", done);
+        resolve();
+      };
+      res.on("drain", done);
+      signal.addEventListener("abort", done);
+    });
+  };
+
+  // A wake turn's events go out as they come, one frame each, and a stream
+  // the browser has left takes no more.
+  const emit: Emit = (event) => {
+    if (!signal.aborted && !res.writableEnded) res.write(`data: ${JSON.stringify(event)}\n\n`);
+  };
+  // Every stream this process has open for the conversation hears a wake
+  // turn, not only the one whose attempt won the lease: another tab shows the
+  // reply too, and holds its requests until the turn lets go.
+  const watchers = watchersOf(hai, conversationId);
+  watchers.streams.add(emit);
+  // Joining while a wake turn runs: what it has shown so far, starting with
+  // its `streaming` status, so the browser holds requests until it lets go,
+  // and the reply's later text has a block to land in.
+  if (watchers.live) for (const event of watchers.shown) emit(event);
+
+  // Wake turns run beside the notice loop, so a notice never waits behind a
+  // turn, nor behind the retries while another request holds the
+  // conversation. One attempt at a time; a wake notice that lands meanwhile
+  // asks for another once it is done.
+  let waking: Promise<void> | null = null;
+  let again = false;
+  const wake = () => {
+    if (!hai.wakes || signal.aborted) return;
+    if (waking) {
+      again = true;
+      return;
+    }
+    waking = (async () => {
+      do {
+        again = false;
+        let wait = WAKE_RETRY_MS;
+        while (!signal.aborted && (await hai.wake(conversationId, watchers.broadcast)) === "busy") {
+          await pause(wait, signal);
+          wait = Math.min(wait * 2, WAKE_RETRY_MAX_MS);
+        }
+      } while (again && !signal.aborted);
+    })()
+      .catch((err) => emit({ type: "error", message: (err as Error).message }))
+      .finally(() => {
+        waking = null;
+        // a notice that asked between the loop's last look and now
+        if (again) wake();
+      });
+  };
+
+  // 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.
+  const catchUp = async (page: NoticeRecord[] | null = null) => {
+    let woken = false;
+    for (;;) {
+      const records = page ?? (await store.getNotices(conversationId, after, PAGE));
+      if (records === null) return aborter.abort();
+      for (const n of records) {
+        if (signal.aborted) return;
+        if (n.seq <= after) continue;
+        const event: WireEvent = {
+          type: "notice",
+          seq: n.seq,
+          name: n.name,
+          version: n.version,
+          payload: n.payload,
+          ...(n.handle === undefined ? {} : { handle: n.handle }),
+        };
+        await write(`id: ${n.seq}\ndata: ${JSON.stringify(event)}\n\n`);
+        after = n.seq;
+        woken ||= n.kind === "wake";
+      }
+      if (records.length < PAGE || signal.aborted) break;
+      page = null;
+    }
+    if (woken) wake();
+  };
+
+  // a heartbeat is only for a stream gone quiet, never one already backed up
+  const heartbeat = setInterval(() => res.writableNeedDrain || res.write(": ping\n\n"), HEARTBEAT_MS);
+  const wakes = wakeups(store.watch?.(conversationId, signal), signal)[Symbol.asyncIterator]();
+  try {
+    await catchUp(first);
+    // A wake notice may be waiting from before this browser connected: one
+    // that arrived while nobody watched, or while the conversation was busy.
+    wake();
+    // Watching starts before the next read, so a notice that landed after the
+    // backlog was read is either in that read or wakes the loop.
+    let next = wakes.next();
+    await catchUp();
+    while (!signal.aborted) {
+      if ((await next).done) break;
+      next = wakes.next();
+      await catchUp();
+    }
+  } finally {
+    clearInterval(heartbeat);
+    aborter.abort();
+    watchers.streams.delete(emit);
+    if (!watchers.streams.size) forgetWatchers(hai, conversationId, watchers);
+    await wakes.return?.();
+    res.end();
+  }
+}
+
+/** The events streams one process has open for a conversation, and the wake turn running there, if any. */
+interface Watchers {
+  streams: Set<Emit>;
+  live: boolean;
+  /**
+   * What the running wake turn has shown so far, as the frames a stream that
+   * joins now needs: each block once, with its text and status up to date,
+   * then everything else in order. A turn's worth, dropped when it ends.
+   */
+  shown: WireEvent[];
+  broadcast: Emit;
+}
+
+/** Fold a wake turn's frame into what it has shown so far. */
+function remember(shown: WireEvent[], event: WireEvent) {
+  const block = (id: string) =>
+    shown.find((e): e is Extract<WireEvent, { type: "block_start" }> => e.type === "block_start" && e.block.id === id)?.block;
+  if (event.type === "block_start") shown.push({ ...event, block: { ...event.block } });
+  else if (event.type === "text_delta") {
+    const b = block(event.id);
+    if (b && "text" in b) b.text += event.text;
+  } else if (event.type === "block_update") {
+    const b = block(event.id);
+    if (b) Object.assign(b, { status: event.status, ms: event.ms, result: event.result });
+  } else if (event.type === "progress") {
+    const { type, toolId, ...fields } = event;
+    const b = block(toolId);
+    if (b?.kind === "tool") b.progress = { ...b.progress, ...fields };
+  } else shown.push(event);
+}
+
+const watching = new WeakMap<Hai, Map<string, Watchers>>();
+
+function watchersOf(hai: Hai, conversationId: string): Watchers {
+  let byConversation = watching.get(hai);
+  if (!byConversation) watching.set(hai, (byConversation = new Map()));
+  const map = byConversation;
+  let watchers = byConversation.get(conversationId);
+  if (!watchers) {
+    const fresh: Watchers = {
+      streams: new Set(),
+      live: false,
+      shown: [],
+      // A wake turn's frames, to every stream. `live` from its first
+      // `streaming` until `released`, with what it has shown kept meanwhile,
+      // for a stream that joins part way.
+      broadcast: (event) => {
+        if (event.type === "status" && event.status === "streaming" && !fresh.live) {
+          fresh.live = true;
+          fresh.shown = [];
+        }
+        if (fresh.live) remember(fresh.shown, event);
+        if (event.type === "released") {
+          fresh.live = false;
+          fresh.shown = [];
+        }
+        for (const send of fresh.streams) send(event);
+        // the turn outlived every stream that watched it: nothing left to keep
+        if (!fresh.live && !fresh.streams.size && map.get(conversationId) === fresh) map.delete(conversationId);
+      },
+    };
+    byConversation.set(conversationId, (watchers = fresh));
+  }
+  return watchers;
+}
+
+function forgetWatchers(hai: Hai, conversationId: string, watchers: Watchers) {
+  // a wake turn still running keeps its entry, so a stream that joins later still hears it
+  if (!watchers.live && watching.get(hai)?.get(conversationId) === watchers) watching.get(hai)!.delete(conversationId);
+}
+
+/** The first wait before trying a wake turn again on a busy conversation, and the longest. */
+const WAKE_RETRY_MS = 250;
+const WAKE_RETRY_MAX_MS = 5_000;
+
+/** Wait `ms`, or until `signal` aborts. */
+const pause = (ms: number, signal: AbortSignal) =>
+  new Promise<void>((resolve) => {
+    const done = () => {
+      clearTimeout(timer);
+      signal.removeEventListener("abort", done);
+      resolve();
+    };
+    const timer = setTimeout(done, ms);
+    signal.addEventListener("abort", done);
+  });
+
+/**
+ * When the events route reads next: every POLL_MS, and sooner whenever the
+ * store's `watch` says a notice may have landed. `watch` alone is not enough.
+ * A wake-up can be lost, and a LISTEN connection can drop, and either would
+ * leave the stream open on heartbeats with a notice it never reads. A `watch`
+ * that ends or fails leaves the reads every POLL_MS to carry on.
+ */
+async function* wakeups(watch: AsyncIterable<void> | undefined, signal: AbortSignal): AsyncIterable<void> {
+  const steps = watch?.[Symbol.asyncIterator]();
+  // started now, so the watch is listening before the caller's next read
+  let step: Promise<unknown> | null = steps?.next().then((r) => !r.done, () => false) ?? null;
+  try {
+    while (!signal.aborted) {
+      let timer: ReturnType<typeof setTimeout> | undefined;
+      let onAbort: (() => void) | undefined;
+      const tick = new Promise<"tick">((resolve) => {
+        onAbort = () => resolve("tick");
+        timer = setTimeout(onAbort, POLL_MS);
+        signal.addEventListener("abort", onAbort);
+      });
+      const woke = await Promise.race(step ? [tick, step] : [tick]);
+      clearTimeout(timer);
+      signal.removeEventListener("abort", onAbort!);
+      if (signal.aborted) return;
+      // the watch stepped: listen for the next; it ended or failed: stop listening
+      if (woke !== "tick") step = woke ? steps!.next().then((r) => !r.done, () => false) : null;
+      yield;
+    }
+  } finally {
+    await steps?.return?.();
+  }
+}
+
 function openSSE(res: ServerResponse): Emit {
   res.writeHead(200, {
     "content-type": "text/event-stream",