@acquiredintelligence/attend 0.0.0-stage → 0.2.0

package/dist/memory.js.map

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

package/dist/postgres.d.ts

@@ -0,0 +1,25 @@
+import type { EventLog } from './types.js';
+import type { PostgresClient } from './store/postgres.js';
+export { postgresStore } from './store/postgres.js';
+export type { PostgresClient, PostgresListener, PostgresStoreOptions } from './store/postgres.js';
+export interface PostgresOptions {
+    /**
+     * Prepended to the table names. Lowercase letters, digits and underscores, since Postgres
+     * folds unquoted names to lowercase and the append lock is keyed by the name as written.
+     * Default 'attend_'. To put the tables in another schema, set the connection's `search_path`.
+     */
+    prefix?: string;
+}
+export declare function migrate(client: PostgresClient, options?: PostgresOptions): Promise<void>;
+/**
+ * Positions come from one bigserial, so a reader could see position 11 commit before 10 and
+ * skip 10 for good. Each append therefore takes a transaction-scoped advisory lock on its
+ * scope before drawing any position, in the same statement: appends to one scope draw and
+ * commit one at a time, and the lock is released only after the commit is visible.
+ *
+ * `read` with `blockMs` polls every `pollMs` (default 100) until an entry arrives or the time is up.
+ */
+export declare function postgresLog(client: PostgresClient, options?: PostgresOptions & {
+    pollMs?: number;
+}): EventLog;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../src/postgres.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIlG,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9F;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CA+B7G"}

package/dist/postgres.js

@@ -0,0 +1,56 @@
+/**
+ * `attend/postgres`: a ScopeStore and an EventLog over a client with `query(text, values)`.
+ * Run `migrate()` before either adapter. It calls the store migration, then creates the
+ * separate EventLog table and index that `postgresLog` still needs.
+ */
+import { boundary } from './internal/adapter.js';
+import { migrate as migrateStore } from './store/postgres.js';
+export { postgresStore } from './store/postgres.js';
+const { column, formatPosition, parseEvent, parsePosition, tablePrefix } = boundary('attend/postgres');
+export async function migrate(client, options) {
+    await migrateStore(client, options);
+    const log = `${tablePrefix(options?.prefix, { lowercase: true })}log`;
+    await client.query(`SELECT pg_advisory_xact_lock(hashtext('attend.migrate'));
+    CREATE TABLE IF NOT EXISTS ${log} (position bigserial PRIMARY KEY, scope text NOT NULL, event json NOT NULL);
+    CREATE INDEX IF NOT EXISTS ${log}_scope ON ${log} (scope, position);`);
+}
+/**
+ * Positions come from one bigserial, so a reader could see position 11 commit before 10 and
+ * skip 10 for good. Each append therefore takes a transaction-scoped advisory lock on its
+ * scope before drawing any position, in the same statement: appends to one scope draw and
+ * commit one at a time, and the lock is released only after the commit is visible.
+ *
+ * `read` with `blockMs` polls every `pollMs` (default 100) until an entry arrives or the time is up.
+ */
+export function postgresLog(client, options) {
+    const log = `${tablePrefix(options?.prefix, { lowercase: true })}log`;
+    const pollMs = options?.pollMs ?? 100;
+    const page = async (scope, after, limit) => {
+        const { rows } = await client.query(`SELECT position, event FROM ${log} WHERE scope = $1 AND position > $2 ORDER BY position LIMIT $3`, [
+            scope,
+            after === null ? '0' : parsePosition(after),
+            limit,
+        ]);
+        return rows.map((row) => ({ position: formatPosition(column(row, 'position')), event: parseEvent(column(row, 'event')) }));
+    };
+    return {
+        async append(scope, events) {
+            if (events.length === 0)
+                return;
+            await client.query(`WITH turn AS (SELECT pg_advisory_xact_lock(hashtext($1), hashtext($2)))
+         INSERT INTO ${log} (scope, event)
+         SELECT $2, e.event::json FROM turn, unnest($3::text[]) WITH ORDINALITY AS e(event, n) ORDER BY e.n`, [log, scope, events.map((event) => JSON.stringify(event))]);
+        },
+        async read(scope, after, { limit, blockMs }) {
+            const deadline = Date.now() + (blockMs ?? 0);
+            for (;;) {
+                const entries = await page(scope, after, limit);
+                const left = deadline - Date.now();
+                if (entries.length > 0 || left <= 0)
+                    return entries;
+                await new Promise((resolve) => setTimeout(resolve, Math.min(pollMs, left)));
+            }
+        },
+    };
+}
+//# sourceMappingURL=postgres.js.map

package/dist/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../src/postgres.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAWvG,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAsB,EAAE,OAAyB;IAC7E,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC;IACtE,MAAM,MAAM,CAAC,KAAK,CAAC;iCACY,GAAG;iCACH,GAAG,aAAa,GAAG,qBAAqB,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAsB,EAAE,OAA+C;IACjG,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC;IACtE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC;IACtC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAa,EAAE,KAAoB,EAAE,KAAa,EAAuB,EAAE;QAC7F,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,gEAAgE,EAAE;YACtI,KAAK;YACL,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC;YAC3C,KAAK;SACN,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7H,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM;YACxB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAChC,MAAM,MAAM,CAAC,KAAK,CAChB;uBACe,GAAG;4GACkF,EACpG,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAC3D,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;YAC7C,SAAS,CAAC;gBACR,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;gBAChD,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACnC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;oBAAE,OAAO,OAAO,CAAC;gBACpD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/redis.d.ts

@@ -0,0 +1,20 @@
+import type { EventLog } from './types.js';
+import type { RedisSend } from './store/redis.js';
+export { redisStore } from './store/redis.js';
+export type { RedisSend, RedisStoreOptions } from './store/redis.js';
+export interface RedisOptions {
+    /** Prepended to every key. Default 'attend:'. */
+    prefix?: string;
+}
+/**
+ * One stream per scope. Positions are stream ids with both parts padded to twenty digits, so
+ * they compare as strings in read order; a raw id puts `…-10` before `…-9`.
+ *
+ * `read` waits with XREAD BLOCK only when `blockingSend` is given, because a blocked command
+ * holds its connection. Give each blocking reader a connection of its own. Without it, `read`
+ * returns at once and `logSource` paces the loop.
+ */
+export declare function redisLog(send: RedisSend, options?: RedisOptions & {
+    blockingSend?: RedisSend;
+}): EventLog;
+//# sourceMappingURL=redis.d.ts.map

package/dist/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../src/redis.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrE,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG;IAAE,YAAY,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,QAAQ,CAiBzG"}

package/dist/redis.js

@@ -0,0 +1,83 @@
+/**
+ * `attend/redis`: a ScopeStore and an EventLog over Redis 6.2 or later. Takes a function
+ * that sends one command and resolves with its reply, so importing this module loads no client:
+ *
+ *   node-redis: (args) => client.sendCommand(args)
+ *   ioredis:    ([command, ...args]) => client.call(command, ...args)
+ *
+ * Replies are parsed whether the client hands back strings or Buffers, over RESP2 or RESP3.
+ * On Redis Cluster, put a hash tag in the prefix, such as 'attend:{app}:', so that every key a
+ * script touches lands in one slot.
+ */
+import { boundary } from './internal/adapter.js';
+export { redisStore } from './store/redis.js';
+const { parseEvent, text } = boundary('attend/redis');
+/** KEYS: stream. ARGV: event JSON, in order. */
+const APPEND = `
+for i = 1, #ARGV do redis.call('XADD', KEYS[1], '*', 'event', ARGV[i]) end
+return #ARGV`;
+/**
+ * One stream per scope. Positions are stream ids with both parts padded to twenty digits, so
+ * they compare as strings in read order; a raw id puts `…-10` before `…-9`.
+ *
+ * `read` waits with XREAD BLOCK only when `blockingSend` is given, because a blocked command
+ * holds its connection. Give each blocking reader a connection of its own. Without it, `read`
+ * returns at once and `logSource` paces the loop.
+ */
+export function redisLog(send, options) {
+    const prefix = options?.prefix ?? 'attend:';
+    const blockingSend = options?.blockingSend;
+    const key = (scope) => `${prefix}log:${scope}`;
+    return {
+        async append(scope, events) {
+            if (events.length === 0)
+                return;
+            await send(['EVAL', APPEND, '1', key(scope), ...events.map((event) => JSON.stringify(event))]);
+        },
+        async read(scope, after, { limit, blockMs }) {
+            const stream = key(scope);
+            const entries = parseEntries(await send(['XRANGE', stream, after === null ? '-' : `(${streamId(after)}`, '+', 'COUNT', String(limit)]));
+            if (entries.length > 0 || blockingSend === undefined || blockMs === undefined || blockMs <= 0)
+                return entries;
+            const reply = await blockingSend(['XREAD', 'COUNT', String(limit), 'BLOCK', String(Math.ceil(blockMs)), 'STREAMS', stream, after === null ? '0-0' : streamId(after)]);
+            return reply === null || reply === undefined ? [] : parseEntries(onlyStream(reply));
+        },
+    };
+}
+function list(reply) {
+    if (!Array.isArray(reply))
+        throw new Error(`attend/redis: expected an array reply, got ${typeof reply}`);
+    return reply;
+}
+/** XREAD answers per stream: `[[key, entries]]` over RESP2, a map over RESP3, which clients decode as an object, a Map or a flat array. */
+function onlyStream(reply) {
+    if (reply instanceof Map)
+        return [...reply.values()][0];
+    if (Array.isArray(reply))
+        return Array.isArray(reply[0]) ? list(reply[0])[1] : reply[1];
+    if (typeof reply === 'object' && reply !== null)
+        return Object.values(reply)[0];
+    throw new Error(`attend/redis: unexpected XREAD reply, got ${typeof reply}`);
+}
+function parseEntries(reply) {
+    return list(reply).map((item) => {
+        const [id, fields] = list(item);
+        const [name, value] = list(fields);
+        if (text(name) !== 'event')
+            throw new Error('attend/redis: corrupt log entry');
+        return { position: toPosition(text(id)), event: parseEvent(value) };
+    });
+}
+function toPosition(id) {
+    const [, ms, seq] = /^(\d{1,20})-(\d{1,20})$/.exec(id) ?? [];
+    if (ms === undefined || seq === undefined)
+        throw new Error(`attend/redis: expected a stream id, got "${id}"`);
+    return `${ms.padStart(20, '0')}-${seq.padStart(20, '0')}`;
+}
+function streamId(position) {
+    const [, ms, seq] = /^(\d{20})-(\d{20})$/.exec(position) ?? [];
+    if (ms === undefined || seq === undefined)
+        throw new Error(`attend/redis: not a position from this log: "${position}"`);
+    return `${BigInt(ms)}-${BigInt(seq)}`;
+}
+//# sourceMappingURL=redis.js.map

package/dist/redis.js.map

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

package/dist/server/compat.d.ts

@@ -0,0 +1,13 @@
+import type { JsonObject } from '../core/types.js';
+import type { EventsErrorObject } from './types.js';
+export declare const ERROR_CODES: {
+    readonly InvalidParams: -32602;
+    readonly NotFound: -32023;
+    readonly Forbidden: -32024;
+    readonly ResourceExhausted: -32025;
+    readonly Unsupported: -32026;
+    readonly Transient: -32603;
+};
+export type EventsErrorName = keyof typeof ERROR_CODES;
+export declare function eventsError(name: EventsErrorName, message: string, data?: JsonObject): EventsErrorObject;
+//# sourceMappingURL=compat.d.ts.map

package/dist/server/compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../src/server/compat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,WAAW;aAAK,aAAa,EAAE,CAAC,KAAK;aAAE,QAAQ,EAAE,CAAC,KAAK;aAAE,SAAS,EAAE,CAAC,KAAK;aAAE,iBAAiB,EAAE,CAAC,KAAK;aAAE,WAAW,EAAE,CAAC,KAAK;aAAE,SAAS,EAAE,CAAC,KAAK;CAAW,CAAC;AACtK,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,WAAW,CAAC;AAEvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAExG"}

package/dist/server/compat.js

@@ -0,0 +1,5 @@
+export const ERROR_CODES = { InvalidParams: -32602, NotFound: -32023, Forbidden: -32024, ResourceExhausted: -32025, Unsupported: -32026, Transient: -32603 };
+export function eventsError(name, message, data) {
+    throw new Error('attend: eventsError is not implemented');
+}
+//# sourceMappingURL=compat.js.map

package/dist/server/compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.js","sourceRoot":"","sources":["../../src/server/compat.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,aAAa,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,KAAK,EAAW,CAAC;AAGtK,MAAM,UAAU,WAAW,CAAC,IAAqB,EAAE,OAAe,EAAE,IAAiB;IACnF,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/server/cursor.d.ts

@@ -0,0 +1,15 @@
+import type { DecisionLog, DecisionPage, Position } from '../store/types.js';
+import type { CursorParts } from './types.js';
+/** Encodes a store position without interpreting it. */
+export declare function encodeCursor(parts: CursorParts): string;
+/** Null for a malformed cursor or one with another version prefix. */
+export declare function decodeCursor(cursor: string): CursorParts | null;
+/** Where a read starts: the head for a null cursor, the floor for another epoch or an empty position, else the cursor's own position. */
+export declare function resolveStart(log: DecisionLog, epoch: string, cursor: string | null | undefined): Promise<{
+    after: Position | null;
+    truncated: boolean;
+    fromNow: boolean;
+}>;
+/** Whether rows past `after` were gone when `page` was read from it: below the retention floor, or decided before `sinceAt`. A page that found nothing past `after` needs no store call, since retention never drops the head. */
+export declare function lostBefore(log: DecisionLog, after: Position | null, page: DecisionPage, sinceAt: number | undefined): Promise<boolean>;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/server/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/server/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAGvD;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAI/D;AAED,yIAAyI;AACzI,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAShL;AAED,kOAAkO;AAClO,wBAAsB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAW5I"}

package/dist/server/cursor.js

@@ -0,0 +1,50 @@
+import { eventsError } from './events.js';
+/** Encodes a store position without interpreting it. */
+export function encodeCursor(parts) {
+    if (!parts.epoch || parts.epoch.includes('.'))
+        throw new TypeError('Invalid cursor epoch');
+    return `v1.${parts.epoch}.${parts.position}`;
+}
+/** Null for a malformed cursor or one with another version prefix. */
+export function decodeCursor(cursor) {
+    if (!cursor.startsWith('v1.'))
+        return null;
+    const dot = cursor.indexOf('.', 3);
+    return dot > 3 ? { epoch: cursor.slice(3, dot), position: cursor.slice(dot + 1) } : null;
+}
+/** Where a read starts: the head for a null cursor, the floor for another epoch or an empty position, else the cursor's own position. */
+export async function resolveStart(log, epoch, cursor) {
+    if (cursor == null)
+        return { after: (await log.bounds()).last, truncated: false, fromNow: true };
+    const invalid = () => eventsError('InvalidParams', 'Invalid cursor', { field: 'cursor', reason: 'malformed' });
+    const parts = decodeCursor(cursor);
+    if (!parts)
+        throw invalid();
+    if (parts.epoch !== epoch)
+        return { after: null, truncated: true, fromNow: false };
+    if (parts.position === '')
+        return { after: null, truncated: false, fromNow: false };
+    try {
+        log.compare(parts.position, parts.position);
+    }
+    catch {
+        throw invalid();
+    }
+    return { after: parts.position, truncated: false, fromNow: false };
+}
+/** Whether rows past `after` were gone when `page` was read from it: below the retention floor, or decided before `sinceAt`. A page that found nothing past `after` needs no store call, since retention never drops the head. */
+export async function lostBefore(log, after, page, sinceAt) {
+    if (page.checked === null || (after !== null && log.compare(page.checked, after) === 0))
+        return false;
+    if (after !== null) {
+        const first = (await log.bounds()).first;
+        if (first !== null && log.compare(after, first) < 0)
+            return true;
+    }
+    if (sinceAt !== undefined) {
+        const row = (await log.read({ after, limit: 1 })).rows[0];
+        return row !== undefined && row.at < sinceAt;
+    }
+    return false;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/server/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/server/cursor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAC3F,OAAO,MAAM,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3F,CAAC;AAED,yIAAyI;AACzI,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAgB,EAAE,KAAa,EAAE,MAAiC;IACnG,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjG,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,eAAe,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC/G,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,MAAM,OAAO,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACnF,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpF,IAAI,CAAC;QAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,OAAO,EAAE,CAAC;IAAC,CAAC;IAC/E,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACrE,CAAC;AAED,kOAAkO;AAClO,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAgB,EAAE,KAAsB,EAAE,IAAkB,EAAE,OAA2B;IACxH,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACtG,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC;QACzC,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/server/events.d.ts

@@ -0,0 +1,42 @@
+import type { JsonObject } from '../core/types.js';
+import type { DecisionQuery, DecisionRow } from '../store/types.js';
+import type { AttentionDeadLetterData, AttentionDecisionData, EventDescriptor, EventOccurrence, EventsErrorObject, Principal, SubscriptionFilter } from './types.js';
+/** SEP-3415 error codes. */
+export declare const ERROR_CODES: {
+    readonly InvalidParams: -32602;
+    readonly NotFound: -32023;
+    readonly Forbidden: -32024;
+    readonly ResourceExhausted: -32025;
+    readonly Unsupported: -32026;
+    readonly Transient: -32603;
+};
+/** A named SEP-3415 error. */
+export type EventsErrorName = keyof typeof ERROR_CODES;
+/** A JSON-RPC error the SDK sends verbatim: the SEP code, a message and typed data. */
+export declare class EventsError extends Error implements EventsErrorObject {
+    readonly code: number;
+    readonly data?: JsonObject;
+    constructor(name: EventsErrorName, message: string, data?: JsonObject);
+    toJSON(): EventsErrorObject;
+}
+/** Makes an error the SDK can send without translation. */
+export declare function eventsError(name: EventsErrorName, message: string, data?: JsonObject): EventsError;
+/** Describes settled decisions delivered to an agent. */
+export declare function decisionDescriptor(): EventDescriptor;
+/** Describes windows whose judge or sink gave up. */
+export declare function deadLetterDescriptor(): EventDescriptor;
+/** Validates the event arguments and applies the principal's granted prefixes. */
+export declare function compileFilter(name: string, args: unknown, principal: Principal): SubscriptionFilter;
+/** Checks the row against every subscription constraint. */
+export declare function matches(filter: SubscriptionFilter, row: DecisionRow): boolean;
+/** The store-side part of a filter, for `DecisionLog.read`. */
+export declare function queryFor(filter: SubscriptionFilter): Pick<DecisionQuery, 'scope' | 'scopePrefix' | 'kinds' | 'routes'>;
+/** Parses an events/poll or events/stream request's subscription part; throws an EventsError. */
+export declare function parseSubscription(params: unknown, principal: Principal): {
+    filter: SubscriptionFilter;
+    cursor: string | null;
+    maxAgeMs: number | undefined;
+};
+/** Builds a detached payload; large windows carry an omission marker. */
+export declare function occurrenceFor(row: DecisionRow, include: 'notice' | 'events', maxEventsBytes?: number): EventOccurrence<AttentionDecisionData | AttentionDeadLetterData>;
+//# sourceMappingURL=events.d.ts.map

package/dist/server/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/server/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErK,4BAA4B;AAC5B,eAAO,MAAM,WAAW;aAAK,aAAa,EAAE,CAAC,KAAK;aAAE,QAAQ,EAAE,CAAC,KAAK;aAAE,SAAS,EAAE,CAAC,KAAK;aAAE,iBAAiB,EAAE,CAAC,KAAK;aAAE,WAAW,EAAE,CAAC,KAAK;aAAE,SAAS,EAAE,CAAC,KAAK;CAAW,CAAC;AACtK,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,WAAW,CAAC;AAEvD,uFAAuF;AACvF,qBAAa,WAAY,SAAQ,KAAM,YAAW,iBAAiB;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAE3B,YAAY,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,EAKpE;IAED,MAAM,IAAI,iBAAiB,CAE1B;CACF;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,CAElG;AAUD,yDAAyD;AACzD,wBAAgB,kBAAkB,IAAI,eAAe,CAsBpD;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,IAAI,eAAe,CAatD;AAcD,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,kBAAkB,CA6BnG;AAED,4DAA4D;AAC5D,wBAAgB,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAO7E;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC,CAOtH;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAO5J;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,GAAG,QAAQ,EAAE,cAAc,SAAY,GAAG,eAAe,CAAC,qBAAqB,GAAG,uBAAuB,CAAC,CAuB1K"}

package/dist/server/events.js

@@ -0,0 +1,189 @@
+import { defaultNotice } from '../attend.js';
+import { DECISION_EVENT, DEAD_LETTER_EVENT } from './types.js';
+/** SEP-3415 error codes. */
+export const ERROR_CODES = { InvalidParams: -32602, NotFound: -32023, Forbidden: -32024, ResourceExhausted: -32025, Unsupported: -32026, Transient: -32603 };
+/** A JSON-RPC error the SDK sends verbatim: the SEP code, a message and typed data. */
+export class EventsError extends Error {
+    code;
+    data;
+    constructor(name, message, data) {
+        super(message);
+        this.name = 'EventsError';
+        this.code = ERROR_CODES[name];
+        if (data !== undefined)
+            this.data = data;
+    }
+    toJSON() {
+        return { code: this.code, message: this.message, ...(this.data === undefined ? {} : { data: this.data }) };
+    }
+}
+/** Makes an error the SDK can send without translation. */
+export function eventsError(name, message, data) {
+    return new EventsError(name, message, data);
+}
+const routes = ['interrupt', 'queue', 'note', 'ask'];
+const bits = { interrupt: 1, queue: 2, note: 4, ask: 8 };
+const reasons = ['closing', 'flush', 'stream_quiet', 'passive_quiet', 'overflow', 'age', 'forced', 'size'];
+const scopeProperties = {
+    scope: { type: 'string', description: 'Exactly this scope.' },
+    scopePrefix: { type: 'string', description: 'Every scope that starts with this. Omit both scope and scopePrefix for every scope the principal may read.' },
+};
+/** Describes settled decisions delivered to an agent. */
+export function decisionDescriptor() {
+    return {
+        name: DECISION_EVENT,
+        description: 'A settled window of events that a judge routed to the agent: interrupt, queue, note or ask. One occurrence per decision; skip is never emitted.',
+        delivery: ['poll', 'push'],
+        inputSchema: {
+            type: 'object', additionalProperties: false,
+            properties: { ...scopeProperties, routes: { type: 'array', items: { enum: [...routes] }, uniqueItems: true }, minProbability: { type: 'number', minimum: 0, maximum: 1 }, include: { enum: ['notice', 'events'], default: 'notice' } },
+            not: { required: ['scope', 'scopePrefix'] },
+        },
+        payloadSchema: {
+            type: 'object',
+            required: ['decisionId', 'scope', 'route', 'probabilities', 'predicates', 'confidence', 'reason', 'settledAt', 'decidedAt', 'eventCount', 'eventIds', 'dropped', 'gap', 'waits', 'notice'],
+            properties: {
+                decisionId: { type: 'string' }, scope: { type: 'string' }, route: { enum: [...routes] },
+                probabilities: { type: 'object', additionalProperties: { type: 'number' } }, predicates: { type: 'object', additionalProperties: { type: 'number' } },
+                confidence: { type: ['number', 'null'] }, reason: { enum: [...reasons] },
+                settledAt: { type: 'string', format: 'date-time' }, decidedAt: { type: 'string', format: 'date-time' },
+                eventCount: { type: 'integer' }, eventIds: { type: 'array', items: { type: 'string' } }, dropped: { type: 'integer' }, gap: { type: 'boolean' }, waits: { type: 'integer' }, notice: { type: 'string' }, events: { type: 'array', items: { type: 'object' } },
+            },
+        },
+    };
+}
+/** Describes windows whose judge or sink gave up. */
+export function deadLetterDescriptor() {
+    return {
+        name: DEAD_LETTER_EVENT,
+        description: 'A window no judge or sink could take: the judge gave up (stage judge) or the sink did (stage sink).',
+        delivery: ['poll', 'push'],
+        inputSchema: { type: 'object', additionalProperties: false, properties: { ...scopeProperties, stage: { enum: ['judge', 'sink'] } }, not: { required: ['scope', 'scopePrefix'] } },
+        payloadSchema: {
+            type: 'object', required: ['letterId', 'scope', 'stage', 'message', 'permanent', 'attempts', 'decisionId', 'route', 'reason', 'eventCount', 'eventIds', 'at'],
+            properties: {
+                letterId: { type: 'string' }, scope: { type: 'string' }, stage: { enum: ['judge', 'sink'] }, message: { type: 'string' }, permanent: { type: 'boolean' }, attempts: { type: 'integer' }, decisionId: { type: ['string', 'null'] }, route: { enum: [...routes, null] }, reason: { enum: [...reasons] }, eventCount: { type: 'integer' }, eventIds: { type: 'array', items: { type: 'string' } }, at: { type: 'string', format: 'date-time' },
+            },
+        },
+    };
+}
+function object(value) {
+    return typeof value === 'object' && value !== null && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+function invalid(field, reason) {
+    throw eventsError('InvalidParams', `Invalid ${field}: ${reason}`, { field, reason });
+}
+function delivered(value) {
+    return value === 'interrupt' || value === 'queue' || value === 'note' || value === 'ask';
+}
+/** Validates the event arguments and applies the principal's granted prefixes. */
+export function compileFilter(name, args, principal) {
+    if (name !== DECISION_EVENT && name !== DEAD_LETTER_EVENT)
+        throw eventsError('NotFound', 'Unknown event', { kind: 'event' });
+    const value = args === undefined ? {} : args;
+    if (!object(value))
+        invalid('arguments', 'must be an object');
+    const allowed = name === DECISION_EVENT ? ['scope', 'scopePrefix', 'routes', 'minProbability', 'include'] : ['scope', 'scopePrefix', 'stage'];
+    for (const key of Object.keys(value))
+        if (!allowed.includes(key))
+            invalid(`arguments.${key}`, 'unknown');
+    for (const key of ['scope', 'scopePrefix'])
+        if (key in value && typeof value[key] !== 'string')
+            invalid(`arguments.${key}`, 'must be a string');
+    if ('scope' in value && 'scopePrefix' in value)
+        invalid('arguments', 'scope and scopePrefix are exclusive');
+    let mask = 15;
+    if ('routes' in value) {
+        if (!Array.isArray(value.routes) || !value.routes.every(delivered) || new Set(value.routes).size !== value.routes.length)
+            invalid('arguments.routes', 'must be unique delivered routes');
+        mask = value.routes.reduce((sum, route) => sum | bits[route], 0);
+    }
+    if ('minProbability' in value && (typeof value.minProbability !== 'number' || !Number.isFinite(value.minProbability) || value.minProbability < 0 || value.minProbability > 1))
+        invalid('arguments.minProbability', 'must be a finite number between 0 and 1');
+    if ('include' in value && value.include !== 'notice' && value.include !== 'events')
+        invalid('arguments.include', 'must be notice or events');
+    if ('stage' in value && value.stage !== 'judge' && value.stage !== 'sink')
+        invalid('arguments.stage', 'must be judge or sink');
+    const filter = { name, routes: mask, minProbability: typeof value.minProbability === 'number' ? value.minProbability : 0, include: value.include === 'events' ? 'events' : 'notice' };
+    if (typeof value.scope === 'string')
+        filter.scope = value.scope;
+    if (typeof value.scopePrefix === 'string')
+        filter.scopePrefix = value.scopePrefix;
+    if (value.stage === 'judge' || value.stage === 'sink')
+        filter.stage = value.stage;
+    const requested = filter.scope ?? filter.scopePrefix;
+    if (principal.scopes.length === 0 || (requested !== undefined && !principal.scopes.some((grant) => requested.startsWith(grant)))) {
+        throw eventsError('Forbidden', 'Scope is outside the principal grants', { reason: 'scope is outside granted prefixes' });
+    }
+    if (requested === undefined && !principal.scopes.includes('')) {
+        if (principal.scopes.length === 1)
+            filter.scopePrefix = principal.scopes[0];
+        else
+            filter.grants = [...principal.scopes];
+    }
+    return filter;
+}
+/** Checks the row against every subscription constraint. */
+export function matches(filter, row) {
+    if ((row.kind === 'decision' ? DECISION_EVENT : DEAD_LETTER_EVENT) !== filter.name)
+        return false;
+    if (filter.scope !== undefined && row.scope !== filter.scope)
+        return false;
+    if (filter.scopePrefix !== undefined && !row.scope.startsWith(filter.scopePrefix))
+        return false;
+    if (filter.grants && !filter.grants.some((grant) => row.scope.startsWith(grant)))
+        return false;
+    if (row.kind === 'deadLetter')
+        return filter.stage === undefined || row.body.stage === filter.stage;
+    return row.route !== null && (filter.routes & bits[row.body.route]) !== 0 && row.body.probabilities[row.body.route] >= filter.minProbability;
+}
+/** The store-side part of a filter, for `DecisionLog.read`. */
+export function queryFor(filter) {
+    return {
+        kinds: [filter.name === DECISION_EVENT ? 'decision' : 'deadLetter'],
+        ...(filter.scope === undefined ? {} : { scope: filter.scope }),
+        ...(filter.scopePrefix === undefined ? {} : { scopePrefix: filter.scopePrefix }),
+        ...(filter.routes === 15 ? {} : { routes: routes.filter((route) => (filter.routes & bits[route]) !== 0) }),
+    };
+}
+/** Parses an events/poll or events/stream request's subscription part; throws an EventsError. */
+export function parseSubscription(params, principal) {
+    if (!object(params))
+        invalid('params', 'must be an object');
+    if (typeof params.name !== 'string')
+        invalid('name', 'required');
+    const filter = compileFilter(params.name, params.arguments, principal);
+    if (params.cursor !== undefined && params.cursor !== null && typeof params.cursor !== 'string')
+        invalid('cursor', 'must be a string or null');
+    if (params.maxAgeMs !== undefined && (typeof params.maxAgeMs !== 'number' || !Number.isSafeInteger(params.maxAgeMs) || params.maxAgeMs < 0))
+        invalid('maxAgeMs', 'must be a non-negative safe integer');
+    return { filter, cursor: params.cursor ?? null, maxAgeMs: params.maxAgeMs };
+}
+/** Builds a detached payload; large windows carry an omission marker. */
+export function occurrenceFor(row, include, maxEventsBytes = 1_048_576) {
+    const body = row.body;
+    const w = body.window;
+    if (row.kind === 'deadLetter') {
+        const letter = row.body;
+        return { eventId: row.id, name: DEAD_LETTER_EVENT, timestamp: new Date(letter.at).toISOString(), data: {
+                letterId: letter.id, scope: letter.scope, stage: letter.stage, message: letter.message, permanent: letter.permanent, attempts: letter.attempts,
+                decisionId: letter.decision?.id ?? null, route: letter.decision?.route ?? null, reason: w.reason, eventCount: w.events.length, eventIds: w.events.map((e) => e.id), at: new Date(letter.at).toISOString(),
+            } };
+    }
+    const decision = row.body;
+    const data = {
+        decisionId: decision.id, scope: decision.scope, route: decision.route, probabilities: { ...decision.probabilities }, predicates: { ...decision.predicates }, confidence: decision.confidence,
+        reason: w.reason, settledAt: new Date(w.settledAt).toISOString(), decidedAt: new Date(decision.at).toISOString(), eventCount: w.events.length, eventIds: w.events.map((e) => e.id), dropped: w.dropped, gap: w.gap, waits: w.waits,
+        notice: defaultNotice(decision),
+    };
+    const occurrence = { eventId: row.id, name: DECISION_EVENT, timestamp: new Date(decision.at).toISOString(), data };
+    if (include === 'events') {
+        const json = JSON.stringify(w.events);
+        if (new TextEncoder().encode(json).length <= maxEventsBytes)
+            data.events = JSON.parse(json);
+        else
+            occurrence._meta = { 'attend/eventsOmitted': true };
+    }
+    return occurrence;
+}
+//# sourceMappingURL=events.js.map

package/dist/server/events.js.map

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

package/dist/server/fanout.d.ts

@@ -0,0 +1,28 @@
+import type { DecisionLog, DecisionPage, DecisionRow, Position } from '../store/types.js';
+import { type StreamNotification, type SubscriptionFilter } from './types.js';
+interface Subscriber {
+    filter: SubscriptionFilter;
+    row: (row: DecisionRow) => void;
+    change?: () => void;
+    error?: (error: unknown) => void;
+    gap?: () => void;
+}
+export interface Fanout {
+    subscribe(filter: SubscriptionFilter, onRow: (row: DecisionRow) => void, hooks?: Pick<Subscriber, 'change' | 'error' | 'gap'>): () => void;
+    checked(): Position | null;
+    /** Resolves once the reader knows where it starts, so a stream can tell which rows it missed. */
+    readonly ready: Promise<void>;
+    cached(after: Position | null): DecisionPage | null;
+    readonly size: number;
+    close(): void;
+}
+/** Encodes notifications once; event payload bytes are shared across subscribers. */
+export declare function notificationJSON(notification: StreamNotification): string;
+/** Splices a subscription's envelope around the shared row payload. */
+export declare function eventNotification(row: DecisionRow, filter: SubscriptionFilter, maxBytes: number | undefined, epoch: string, id: string | number): Extract<StreamNotification, {
+    method: 'notifications/events/event';
+}>;
+/** The process's tail cache and indexed, nonblocking subscription reader. */
+export declare function createFanout(log: DecisionLog): Fanout;
+export {};
+//# sourceMappingURL=fanout.d.ts.map