@haikit/postgres 0.12.0 → 0.14.0

package/README.md

@@ -40,7 +40,7 @@ exactly one to win.
 
 ## Schema
 
-Two tables, `haikit_conversations` and `haikit_payloads`. `migrate()` creates
+Three tables, `haikit_conversations`, `haikit_payloads` and `haikit_notices`. `migrate()` creates
 them if they do not exist and brings existing ones up to date; if you use your
 own migration tool, the statements are exported as `schema`.
 
@@ -52,9 +52,46 @@ With your own migration tool, apply the new `ALTER TABLE` from `schema` before
 deploying. Rows written before the column existed are held to the window your
 code declares.
 
+**Upgrading to 0.12:** `migrate()` adds `haikit_notices`, and `notice_seq` and
+`noticed_through` to `haikit_conversations`, for `hai.notify`. As before, if
+you call `migrate()` at startup there is nothing to do.
+
+**Upgrading to 0.13:** `migrate()` adds `kind` to `haikit_notices`, and
+`wakes` and `woke_through` to `haikit_conversations`, for wake notices.
+
 Handles are numbered per conversation, so every conversation's digests start at
 `ui_01`.
 
+## Notices
+
+A notice is one `INSERT … SELECT`, numbered under the conversation's row lock,
+so two notices in one conversation always commit in the order they were
+numbered and a reader resuming after one can never miss an earlier. It takes no
+lease token: a notice lands whoever holds the turn. The same statement sends a
+`NOTIFY` on `haikit_notices` with the conversation id.
+
+Give the store a connection that can `LISTEN`, and the events route hears of a
+notice the moment it lands, rather than at its next two-second read. It needs a
+connection of its own: a pooled one goes back to the pool and stops listening.
+PGlite fits as it is (`pgStore(db, { listen: db })`). With `pg`:
+
+```ts
+const listener = new pg.Client({ connectionString: process.env.DATABASE_URL });
+await listener.connect();
+
+const store = pgStore(pool, {
+  listen: {
+    async listen(channel, onNotify) {
+      listener.on("notification", (msg) => msg.channel === channel && onNotify(msg.payload ?? ""));
+      await listener.query(`LISTEN ${channel}`);
+    },
+  },
+});
+```
+
+A notice belongs to its conversation and goes when it does: deleting a
+conversation deletes its notices. `sweepOrphans` never touches them.
+
 ## Cleaning up
 
 A turn that is overtaken mid-flight can leave payload rows that the surviving

package/dist/index.d.ts

@@ -32,7 +32,23 @@ export interface PgStoreOptions {
      * which is safe (its writes are fenced out) but wasteful.
      */
     leaseMs?: number;
+    /**
+     * A connection that can `LISTEN`, so the events route hears of a notice the
+     * moment it lands, rather than at its next read a couple of seconds on. It needs a
+     * connection of its own: a pooled one goes back to the pool and stops
+     * listening. PGlite's `listen` fits as it is; see the README for `pg`.
+     */
+    listen?: Listener;
+}
+/**
+ * Something that can `LISTEN` on a channel and report each `NOTIFY` payload.
+ * Resolves once listening, to a function that stops.
+ */
+export interface Listener {
+    listen(channel: string, onNotify: (payload: string) => void): Promise<unknown>;
 }
+/** The channel `putNotice` notifies on, with the conversation id as payload. */
+export declare const NOTICE_CHANNEL = "haikit_notices";
 /**
  * The schema, one statement per entry. `migrate()` runs these; export them to
  * your own migration tool instead if you have one.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,MAAM,EAmCnC,CAAC;AAEF,8FAA8F;AAC9F,wBAAsB,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1D;AA8CD,wBAAgB,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CAkJjF;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAYrG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF;AAID,gFAAgF;AAChF,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,MAAM,EA8DnC,CAAC;AAEF,8FAA8F;AAC9F,wBAAsB,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1D;AAkED,wBAAgB,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CAuPjF;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAYrG"}

package/dist/index.js

@@ -12,6 +12,8 @@
  */
 import { ConversationBusy, StaleLease, } from "@haikit/core";
 const LEASE_MS = 120_000;
+/** The channel `putNotice` notifies on, with the conversation id as payload. */
+export const NOTICE_CHANNEL = "haikit_notices";
 /**
  * The schema, one statement per entry. `migrate()` runs these; export them to
  * your own migration tool instead if you have one.
@@ -27,8 +29,35 @@ export const schema = [
      lease_until  timestamptz,
      lease_token  text,
      handle_seq   integer NOT NULL DEFAULT 0,
+     -- the last notice number given out, and the last one its history took in
+     notice_seq      integer NOT NULL DEFAULT 0,
+     noticed_through integer NOT NULL DEFAULT 0,
+     -- when recent wake turns started, and the last notice that may no longer start one
+     wakes           jsonb NOT NULL DEFAULT '[]',
+     woke_through    integer NOT NULL DEFAULT 0,
      updated_at   timestamptz NOT NULL DEFAULT now()
    )`,
+    // a table created before notices existed gains the columns
+    `ALTER TABLE haikit_conversations ADD COLUMN IF NOT EXISTS notice_seq integer NOT NULL DEFAULT 0`,
+    `ALTER TABLE haikit_conversations ADD COLUMN IF NOT EXISTS noticed_through integer NOT NULL DEFAULT 0`,
+    `ALTER TABLE haikit_conversations ADD COLUMN IF NOT EXISTS wakes jsonb NOT NULL DEFAULT '[]'`,
+    `ALTER TABLE haikit_conversations ADD COLUMN IF NOT EXISTS woke_through integer NOT NULL DEFAULT 0`,
+    // Append-only, and never an orphan: a notice belongs to a conversation that
+    // exists, and goes when it does.
+    `CREATE TABLE IF NOT EXISTS haikit_notices (
+     conversation_id text NOT NULL REFERENCES haikit_conversations(id) ON DELETE CASCADE,
+     seq             integer NOT NULL,
+     created_at      timestamptz NOT NULL DEFAULT now(),
+     name            text NOT NULL,
+     version         integer NOT NULL,
+     payload         jsonb NOT NULL,
+     model           text,
+     handle          text,
+     -- 'wake', or NULL for a passive notice
+     kind            text,
+     PRIMARY KEY (conversation_id, seq)
+   )`,
+    `ALTER TABLE haikit_notices ADD COLUMN IF NOT EXISTS kind text`,
     // Write-once. Nothing about a payload changes after insert — everything that
     // does lives on the fenced conversation row (see Conversation.frozen).
     `CREATE TABLE IF NOT EXISTS haikit_payloads (
@@ -65,8 +94,12 @@ export async function migrate(db) {
 // a second time throws. Taking text every time removes the guess.
 const CONVERSATION_COLUMNS = `
   id, status, messages::text AS messages, handles::text AS handles,
-  frozen::text AS frozen, pending::text AS pending, lease_token,
+  frozen::text AS frozen, pending::text AS pending, lease_token, noticed_through,
+  wakes::text AS wakes, woke_through,
   (extract(epoch FROM lease_until) * 1000)::float8 AS lease_until_ms`;
+const NOTICE_COLUMNS = `
+  conversation_id, seq, name, version, payload::text AS payload, model, handle, kind,
+  (extract(epoch FROM created_at) * 1000)::float8 AS created_at_ms`;
 // The window is read as text too: 'Infinity' is how "never" is stored, and
 // drivers need not agree on turning it into a number.
 const PAYLOAD_COLUMNS = `
@@ -83,6 +116,20 @@ const toConversation = (row) => ({
     pending: row.pending == null ? null : json(row.pending),
     leaseUntil: row.lease_until_ms == null ? null : Number(row.lease_until_ms),
     leaseToken: row.lease_token,
+    noticedThrough: Number(row.noticed_through ?? 0),
+    wakes: row.wakes == null ? [] : json(row.wakes),
+    wokeThrough: Number(row.woke_through ?? 0),
+});
+const toNotice = (row) => ({
+    conversationId: row.conversation_id,
+    seq: Number(row.seq),
+    createdAt: Number(row.created_at_ms),
+    name: row.name,
+    version: Number(row.version),
+    payload: json(row.payload),
+    model: row.model,
+    ...(row.handle == null ? {} : { handle: row.handle }),
+    ...(row.kind === "wake" ? { kind: "wake" } : {}),
 });
 const toPayload = (row) => ({
     handle: row.handle,
@@ -105,6 +152,56 @@ export function pgStore(db, options = {}) {
     if (!Number.isFinite(leaseMs) || leaseMs <= 0) {
         throw new RangeError(`leaseMs must be a positive, finite number of milliseconds (got ${leaseMs})`);
     }
+    // One LISTEN for the whole store, taken when something first watches, and
+    // each notification handed to whoever is watching that conversation.
+    const waiting = new Map();
+    let listening = null;
+    const listen = (listener) => (listening ??= listener
+        .listen(NOTICE_CHANNEL, (id) => {
+        for (const wake of waiting.get(id) ?? [])
+            wake();
+    })
+        .catch((err) => {
+        // try again on the next watch, rather than never
+        listening = null;
+        throw err;
+    }));
+    async function* watch(conversationId, signal) {
+        // One wake-up stands for any number of notices: a step resolves once
+        // something has landed since the last, and the caller reads them all.
+        let landed = false;
+        let wake = null;
+        const listener = () => {
+            landed = true;
+            wake?.();
+        };
+        const onAbort = () => wake?.();
+        const set = waiting.get(conversationId) ?? new Set();
+        set.add(listener);
+        waiting.set(conversationId, set);
+        signal.addEventListener("abort", onAbort);
+        try {
+            await listen(options.listen);
+            // A notice that landed before LISTEN took hold sent its NOTIFY to no
+            // one, so the first step is free: the caller reads once now.
+            landed = true;
+            while (!signal.aborted) {
+                if (!landed)
+                    await new Promise((r) => (wake = r));
+                wake = null;
+                if (signal.aborted)
+                    return;
+                landed = false;
+                yield;
+            }
+        }
+        finally {
+            signal.removeEventListener("abort", onAbort);
+            set.delete(listener);
+            if (!set.size)
+                waiting.delete(conversationId);
+        }
+    }
     /** A fenced write matched nothing. Say which of the two reasons applies. */
     async function stale(conversationId) {
         const { rows } = await db.query(`SELECT 1 FROM haikit_conversations WHERE id = $1`, [conversationId]);
@@ -150,6 +247,9 @@ export function pgStore(db, options = {}) {
                 frozen      = $6::jsonb,
                 pending     = $7::jsonb,
                 lease_until = to_timestamp($8::float8 / 1000),
+                noticed_through = $9::integer,
+                wakes       = $10::jsonb,
+                woke_through = $11::integer,
                 updated_at  = now()
           WHERE id = $1 AND lease_token = $2
           RETURNING id`, [
@@ -162,6 +262,9 @@ export function pgStore(db, options = {}) {
                 // SQL NULL, not the JSON value null — keep "no pending turn" queryable
                 conversation.pending == null ? null : JSON.stringify(conversation.pending),
                 conversation.leaseUntil,
+                conversation.noticedThrough ?? 0,
+                JSON.stringify(conversation.wakes ?? []),
+                conversation.wokeThrough ?? 0,
             ]);
             if (!rows.length)
                 await stale(conversation.id);
@@ -220,6 +323,46 @@ export function pgStore(db, options = {}) {
                 return record ? [structuredClone(record)] : [];
             });
         },
+        async putNotice(record) {
+            // Number, insert and notify in one statement. The UPDATE takes the next
+            // number under the conversation's row lock, so two notices in one
+            // conversation commit in the order they were numbered and a reader never
+            // sees a later one before an earlier. No conversation, no row from
+            // `next`, nothing inserted. Unfenced: no lease token is checked.
+            const { rows } = await db.query(`WITH next AS (
+           UPDATE haikit_conversations SET notice_seq = notice_seq + 1
+            WHERE id = $1::text
+            RETURNING notice_seq
+         ), stored AS (
+           INSERT INTO haikit_notices (conversation_id, seq, name, version, payload, model, handle, kind)
+           SELECT $1::text, notice_seq, $2::text, $3::integer, $4::jsonb, $5::text, $6::text, $7::text FROM next
+           RETURNING ${NOTICE_COLUMNS}
+         )
+         SELECT stored.*, pg_notify('${NOTICE_CHANNEL}', $1::text) FROM stored`, [
+                record.conversationId,
+                record.name,
+                record.version,
+                JSON.stringify(record.payload ?? null),
+                record.model,
+                record.handle ?? null,
+                record.kind === "wake" ? "wake" : null,
+            ]);
+            if (!rows.length)
+                throw new Error(`conversation ${record.conversationId} does not exist`);
+            return toNotice(rows[0]);
+        },
+        async getNotices(conversationId, after, limit) {
+            const { rows } = await db.query(`SELECT ${NOTICE_COLUMNS} FROM haikit_notices
+          WHERE conversation_id = $1 AND seq > $2::bigint
+          ORDER BY seq
+          LIMIT $3::integer`, [conversationId, after, limit ?? null]);
+            if (rows.length)
+                return rows.map(toNotice);
+            // nothing to return: say which of the two reasons applies
+            const exists = await db.query(`SELECT 1 FROM haikit_conversations WHERE id = $1`, [conversationId]);
+            return exists.rows.length ? [] : null;
+        },
+        ...(options.listen ? { watch } : {}),
     };
 }
 /**

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haikit/postgres",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Postgres store adapter for haikit: durable conversations, fenced turn leases, write-once payloads. Bring your own driver.",
   "keywords": [
     "haikit",
@@ -34,7 +34,7 @@
     "prepack": "npm --prefix ../.. run build"
   },
   "dependencies": {
-    "@haikit/core": "0.12.0"
+    "@haikit/core": "0.14.0"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -15,6 +15,7 @@ import {
   ConversationBusy,
   StaleLease,
   type Conversation,
+  type NoticeRecord,
   type PayloadRecord,
   type StoreAdapter,
 } from "@haikit/core";
@@ -39,10 +40,28 @@ export interface PgStoreOptions {
    * which is safe (its writes are fenced out) but wasteful.
    */
   leaseMs?: number;
+  /**
+   * A connection that can `LISTEN`, so the events route hears of a notice the
+   * moment it lands, rather than at its next read a couple of seconds on. It needs a
+   * connection of its own: a pooled one goes back to the pool and stops
+   * listening. PGlite's `listen` fits as it is; see the README for `pg`.
+   */
+  listen?: Listener;
+}
+
+/**
+ * Something that can `LISTEN` on a channel and report each `NOTIFY` payload.
+ * Resolves once listening, to a function that stops.
+ */
+export interface Listener {
+  listen(channel: string, onNotify: (payload: string) => void): Promise<unknown>;
 }
 
 const LEASE_MS = 120_000;
 
+/** The channel `putNotice` notifies on, with the conversation id as payload. */
+export const NOTICE_CHANNEL = "haikit_notices";
+
 /**
  * The schema, one statement per entry. `migrate()` runs these; export them to
  * your own migration tool instead if you have one.
@@ -58,8 +77,35 @@ export const schema: readonly string[] = [
      lease_until  timestamptz,
      lease_token  text,
      handle_seq   integer NOT NULL DEFAULT 0,
+     -- the last notice number given out, and the last one its history took in
+     notice_seq      integer NOT NULL DEFAULT 0,
+     noticed_through integer NOT NULL DEFAULT 0,
+     -- when recent wake turns started, and the last notice that may no longer start one
+     wakes           jsonb NOT NULL DEFAULT '[]',
+     woke_through    integer NOT NULL DEFAULT 0,
      updated_at   timestamptz NOT NULL DEFAULT now()
    )`,
+  // a table created before notices existed gains the columns
+  `ALTER TABLE haikit_conversations ADD COLUMN IF NOT EXISTS notice_seq integer NOT NULL DEFAULT 0`,
+  `ALTER TABLE haikit_conversations ADD COLUMN IF NOT EXISTS noticed_through integer NOT NULL DEFAULT 0`,
+  `ALTER TABLE haikit_conversations ADD COLUMN IF NOT EXISTS wakes jsonb NOT NULL DEFAULT '[]'`,
+  `ALTER TABLE haikit_conversations ADD COLUMN IF NOT EXISTS woke_through integer NOT NULL DEFAULT 0`,
+  // Append-only, and never an orphan: a notice belongs to a conversation that
+  // exists, and goes when it does.
+  `CREATE TABLE IF NOT EXISTS haikit_notices (
+     conversation_id text NOT NULL REFERENCES haikit_conversations(id) ON DELETE CASCADE,
+     seq             integer NOT NULL,
+     created_at      timestamptz NOT NULL DEFAULT now(),
+     name            text NOT NULL,
+     version         integer NOT NULL,
+     payload         jsonb NOT NULL,
+     model           text,
+     handle          text,
+     -- 'wake', or NULL for a passive notice
+     kind            text,
+     PRIMARY KEY (conversation_id, seq)
+   )`,
+  `ALTER TABLE haikit_notices ADD COLUMN IF NOT EXISTS kind text`,
   // Write-once. Nothing about a payload changes after insert — everything that
   // does lives on the fenced conversation row (see Conversation.frozen).
   `CREATE TABLE IF NOT EXISTS haikit_payloads (
@@ -97,9 +143,14 @@ export async function migrate(db: Queryable): Promise<void> {
 // a second time throws. Taking text every time removes the guess.
 const CONVERSATION_COLUMNS = `
   id, status, messages::text AS messages, handles::text AS handles,
-  frozen::text AS frozen, pending::text AS pending, lease_token,
+  frozen::text AS frozen, pending::text AS pending, lease_token, noticed_through,
+  wakes::text AS wakes, woke_through,
   (extract(epoch FROM lease_until) * 1000)::float8 AS lease_until_ms`;
 
+const NOTICE_COLUMNS = `
+  conversation_id, seq, name, version, payload::text AS payload, model, handle, kind,
+  (extract(epoch FROM created_at) * 1000)::float8 AS created_at_ms`;
+
 // The window is read as text too: 'Infinity' is how "never" is stored, and
 // drivers need not agree on turning it into a number.
 const PAYLOAD_COLUMNS = `
@@ -118,6 +169,21 @@ const toConversation = (row: any): Conversation => ({
   pending: row.pending == null ? null : json(row.pending),
   leaseUntil: row.lease_until_ms == null ? null : Number(row.lease_until_ms),
   leaseToken: row.lease_token,
+  noticedThrough: Number(row.noticed_through ?? 0),
+  wakes: row.wakes == null ? [] : json(row.wakes),
+  wokeThrough: Number(row.woke_through ?? 0),
+});
+
+const toNotice = (row: any): NoticeRecord => ({
+  conversationId: row.conversation_id,
+  seq: Number(row.seq),
+  createdAt: Number(row.created_at_ms),
+  name: row.name,
+  version: Number(row.version),
+  payload: json(row.payload),
+  model: row.model,
+  ...(row.handle == null ? {} : { handle: row.handle }),
+  ...(row.kind === "wake" ? { kind: "wake" as const } : {}),
 });
 
 const toPayload = (row: any): PayloadRecord => ({
@@ -145,6 +211,54 @@ export function pgStore(db: Queryable, options: PgStoreOptions = {}): StoreAdapt
     throw new RangeError(`leaseMs must be a positive, finite number of milliseconds (got ${leaseMs})`);
   }
 
+  // One LISTEN for the whole store, taken when something first watches, and
+  // each notification handed to whoever is watching that conversation.
+  const waiting = new Map<string, Set<() => void>>();
+  let listening: Promise<unknown> | null = null;
+  const listen = (listener: Listener) =>
+    (listening ??= listener
+      .listen(NOTICE_CHANNEL, (id) => {
+        for (const wake of waiting.get(id) ?? []) wake();
+      })
+      .catch((err) => {
+        // try again on the next watch, rather than never
+        listening = null;
+        throw err;
+      }));
+
+  async function* watch(conversationId: string, signal: AbortSignal): AsyncIterable<void> {
+    // One wake-up stands for any number of notices: a step resolves once
+    // something has landed since the last, and the caller reads them all.
+    let landed = false;
+    let wake: (() => void) | null = null;
+    const listener = () => {
+      landed = true;
+      wake?.();
+    };
+    const onAbort = () => wake?.();
+    const set = waiting.get(conversationId) ?? new Set();
+    set.add(listener);
+    waiting.set(conversationId, set);
+    signal.addEventListener("abort", onAbort);
+    try {
+      await listen(options.listen!);
+      // A notice that landed before LISTEN took hold sent its NOTIFY to no
+      // one, so the first step is free: the caller reads once now.
+      landed = true;
+      while (!signal.aborted) {
+        if (!landed) await new Promise<void>((r) => (wake = r));
+        wake = null;
+        if (signal.aborted) return;
+        landed = false;
+        yield;
+      }
+    } finally {
+      signal.removeEventListener("abort", onAbort);
+      set.delete(listener);
+      if (!set.size) waiting.delete(conversationId);
+    }
+  }
+
   /** A fenced write matched nothing. Say which of the two reasons applies. */
   async function stale(conversationId: string): Promise<never> {
     const { rows } = await db.query(`SELECT 1 FROM haikit_conversations WHERE id = $1`, [conversationId]);
@@ -199,6 +313,9 @@ export function pgStore(db: Queryable, options: PgStoreOptions = {}): StoreAdapt
                 frozen      = $6::jsonb,
                 pending     = $7::jsonb,
                 lease_until = to_timestamp($8::float8 / 1000),
+                noticed_through = $9::integer,
+                wakes       = $10::jsonb,
+                woke_through = $11::integer,
                 updated_at  = now()
           WHERE id = $1 AND lease_token = $2
           RETURNING id`,
@@ -212,6 +329,9 @@ export function pgStore(db: Queryable, options: PgStoreOptions = {}): StoreAdapt
           // SQL NULL, not the JSON value null — keep "no pending turn" queryable
           conversation.pending == null ? null : JSON.stringify(conversation.pending),
           conversation.leaseUntil,
+          conversation.noticedThrough ?? 0,
+          JSON.stringify(conversation.wakes ?? []),
+          conversation.wokeThrough ?? 0,
         ],
       );
       if (!rows.length) await stale(conversation.id);
@@ -280,6 +400,53 @@ export function pgStore(db: Queryable, options: PgStoreOptions = {}): StoreAdapt
         return record ? [structuredClone(record)] : [];
       });
     },
+
+    async putNotice(record) {
+      // Number, insert and notify in one statement. The UPDATE takes the next
+      // number under the conversation's row lock, so two notices in one
+      // conversation commit in the order they were numbered and a reader never
+      // sees a later one before an earlier. No conversation, no row from
+      // `next`, nothing inserted. Unfenced: no lease token is checked.
+      const { rows } = await db.query(
+        `WITH next AS (
+           UPDATE haikit_conversations SET notice_seq = notice_seq + 1
+            WHERE id = $1::text
+            RETURNING notice_seq
+         ), stored AS (
+           INSERT INTO haikit_notices (conversation_id, seq, name, version, payload, model, handle, kind)
+           SELECT $1::text, notice_seq, $2::text, $3::integer, $4::jsonb, $5::text, $6::text, $7::text FROM next
+           RETURNING ${NOTICE_COLUMNS}
+         )
+         SELECT stored.*, pg_notify('${NOTICE_CHANNEL}', $1::text) FROM stored`,
+        [
+          record.conversationId,
+          record.name,
+          record.version,
+          JSON.stringify(record.payload ?? null),
+          record.model,
+          record.handle ?? null,
+          record.kind === "wake" ? "wake" : null,
+        ],
+      );
+      if (!rows.length) throw new Error(`conversation ${record.conversationId} does not exist`);
+      return toNotice(rows[0]);
+    },
+
+    async getNotices(conversationId, after, limit) {
+      const { rows } = await db.query(
+        `SELECT ${NOTICE_COLUMNS} FROM haikit_notices
+          WHERE conversation_id = $1 AND seq > $2::bigint
+          ORDER BY seq
+          LIMIT $3::integer`,
+        [conversationId, after, limit ?? null],
+      );
+      if (rows.length) return rows.map(toNotice);
+      // nothing to return: say which of the two reasons applies
+      const exists = await db.query(`SELECT 1 FROM haikit_conversations WHERE id = $1`, [conversationId]);
+      return exists.rows.length ? [] : null;
+    },
+
+    ...(options.listen ? { watch } : {}),
   };
 }