@ouispec/agent-realtime 0.1.0

package/dist/oui/results.d.ts

@@ -0,0 +1,46 @@
+/**
+ * OUI action results, held for the agent worker that asked (ADR-0209 D2).
+ *
+ * The worker sends a UI action to the turn's room and then waits here for the
+ * client's answer. The answer arrives on whichever realtime instance holds the
+ * client's socket, and the worker's wait may be served by another, so both
+ * meet in Redis:
+ *
+ *   oui:result:{requestId}        → JSON { userId, result }, TTL 5 min, first answer wins
+ *   oui:result:{requestId}:final  → JSON { userId, result }, TTL 35 min, the final answer
+ *   channel oui:results           → the key's id (`{requestId}` or `{requestId}:final`),
+ *                                   published when an answer is stored
+ *
+ * An async action (a GPU job, an export) is answered twice: acknowledged
+ * (`interim: true`, "started"), then finished (`interim: false`) once its
+ * output exists or it has failed. The first answer is what a worker's first
+ * wait gets. The final answer is kept apart, for as long as the longest job
+ * may run, so a worker can wait on to it and tell the person the work is done
+ * only once it is. A synchronous action's one answer is both.
+ *
+ * An answer is kept under the user of the socket that sent it, and handed only
+ * to a wait for that same user.
+ */
+import type { OUIActionResult } from 'oui-spec/spec';
+import type { RealtimeLogger } from '../logger.js';
+import { type ResultsRedis, type ResultsSubscriber } from '../redis-waits.js';
+export type { ResultsRedis, ResultsSubscriber };
+export interface OUIResultStore {
+    /** Keep a client's answer. Returns false when an answer for the request was already kept. */
+    store(userId: string, result: OUIActionResult): Promise<boolean>;
+    /**
+     * The answer for `requestId` given by `userId`, waiting up to `waitMs` for it
+     * to arrive: the first answer, or with `final` the final one (never an
+     * acknowledgment).
+     */
+    await(requestId: string, userId: string, waitMs: number, options?: {
+        final?: boolean;
+    }): Promise<OUIActionResult | null>;
+    /** Waits in progress on this instance. */
+    pendingCount(): number;
+}
+export declare const RESULT_TTL_SEC: number;
+/** As long as the longest job an action follows may run (an export, a recipient batch: 30 min), with margin. */
+export declare const FINAL_RESULT_TTL_SEC: number;
+export declare function createOUIResultStore(redis: ResultsRedis, subscriber: ResultsSubscriber, logger: RealtimeLogger): OUIResultStore;
+//# sourceMappingURL=results.d.ts.map

package/dist/oui/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/oui/results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE7F,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACzH,0CAA0C;IAC1C,YAAY,IAAI,MAAM,CAAC;CACxB;AAGD,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,gHAAgH;AAChH,eAAO,MAAM,oBAAoB,QAAU,CAAC;AAW5C,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,cAAc,GACrB,cAAc,CAmDhB"}

package/dist/oui/results.js

@@ -0,0 +1,56 @@
+import { createWaitHub } from '../redis-waits.js';
+const CHANNEL = 'oui:results';
+export const RESULT_TTL_SEC = 5 * 60;
+/** As long as the longest job an action follows may run (an export, a recipient batch: 30 min), with margin. */
+export const FINAL_RESULT_TTL_SEC = 35 * 60;
+/** What a wait is for, as the channel and the waiters name it: the first answer, or the final one. */
+const waitId = (requestId, final) => (final ? `${requestId}:final` : requestId);
+const resultKey = (id) => `oui:result:${id}`;
+export function createOUIResultStore(redis, subscriber, logger) {
+    const hub = createWaitHub(subscriber, CHANNEL, logger, 'OUI results');
+    async function read(requestId, userId, id) {
+        const raw = await redis.get(resultKey(id));
+        if (!raw)
+            return null;
+        const stored = JSON.parse(raw);
+        if (stored.userId !== userId) {
+            // Another user's answer for this id is not an answer to this user.
+            logger.warn({ requestId, askedFor: userId, answeredBy: stored.userId }, 'OUI result belongs to another user');
+            return null;
+        }
+        return stored.result;
+    }
+    /** Keep a final answer, the first one only, and wake its waits. */
+    async function storeFinal(stored) {
+        const id = waitId(stored.result.requestId, true);
+        const written = await redis.set(resultKey(id), JSON.stringify(stored), 'EX', FINAL_RESULT_TTL_SEC, 'NX');
+        if (written !== 'OK') {
+            logger.debug({ requestId: stored.result.requestId }, 'OUI final result already held; later answer not kept');
+            return;
+        }
+        await redis.publish(CHANNEL, id);
+    }
+    return {
+        async store(userId, result) {
+            const stored = { userId, result };
+            if (result.interim !== true)
+                await storeFinal(stored);
+            const written = await redis.set(resultKey(result.requestId), JSON.stringify(stored), 'EX', RESULT_TTL_SEC, 'NX');
+            if (written !== 'OK') {
+                // An async action is answered twice (acknowledged, then finished). The
+                // first wait gets the first; the finished answer is kept as the final
+                // one (above), for a worker that waits on to it.
+                logger.debug({ requestId: result.requestId, interim: result.interim }, 'OUI result already held; later answer not kept');
+                return false;
+            }
+            await redis.publish(CHANNEL, result.requestId);
+            return true;
+        },
+        async await(requestId, userId, waitMs, options = {}) {
+            const id = waitId(requestId, options.final === true);
+            return hub.wait(id, waitMs, () => read(requestId, userId, id), (err) => logger.error({ err, requestId }, 'OUI result read failed'));
+        },
+        pendingCount: () => hub.pendingCount(),
+    };
+}
+//# sourceMappingURL=results.js.map

package/dist/oui/results.js.map

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

package/dist/redis-waits.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Waiting on something another instance may store: the mechanism the UI
+ * action result store and the settlement store share.
+ *
+ * A value is stored in Redis and its id published on a channel. A wait reads
+ * it at once, then again each time its id is published, and once more at its
+ * deadline in case a notification was missed. Waits on one instance share one
+ * subscription.
+ */
+import type { RealtimeLogger } from './logger.js';
+/** The Redis commands the stores use. ioredis satisfies it. */
+export interface ResultsRedis {
+    set(key: string, value: string, ex: 'EX', seconds: number, nx: 'NX'): Promise<'OK' | null>;
+    get(key: string): Promise<string | null>;
+    publish(channel: string, message: string): Promise<number>;
+}
+/** A connection in subscriber mode. ioredis satisfies it. */
+export interface ResultsSubscriber {
+    subscribe(channel: string): Promise<unknown>;
+    on(event: 'message', listener: (channel: string, message: string) => void): unknown;
+}
+export interface WaitHub {
+    /**
+     * `read()`'s value once it has one, reading at once, on every publish of
+     * `id`, and at the deadline; null when it has none by `waitMs`.
+     */
+    wait<T>(id: string, waitMs: number, read: () => Promise<T | null>, onReadError: (err: unknown) => void): Promise<T | null>;
+    /** Waits in progress on this instance. */
+    pendingCount(): number;
+}
+export declare function createWaitHub(subscriber: ResultsSubscriber, channel: string, logger: RealtimeLogger, label: string): WaitHub;
+//# sourceMappingURL=redis-waits.d.ts.map

package/dist/redis-waits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-waits.d.ts","sourceRoot":"","sources":["../src/redis-waits.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC3F,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;CACrF;AAED,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3H,0CAA0C;IAC1C,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAyD5H"}

package/dist/redis-waits.js

@@ -0,0 +1,62 @@
+export function createWaitHub(subscriber, channel, logger, label) {
+    const waiters = new Map();
+    subscriber.on('message', (ch, id) => {
+        if (ch !== channel)
+            return;
+        const pending = waiters.get(id);
+        if (!pending)
+            return;
+        for (const wake of [...pending])
+            wake();
+    });
+    subscriber.subscribe(channel).catch((err) => {
+        logger.error({ err }, `${label}: subscribe failed — waits will only see what was stored before they began`);
+    });
+    return {
+        async wait(id, waitMs, read, onReadError) {
+            const now = await read();
+            if (now || waitMs <= 0)
+                return now;
+            return new Promise((resolve) => {
+                let done = false;
+                const finish = (value) => {
+                    if (done)
+                        return;
+                    done = true;
+                    clearTimeout(timer);
+                    const set = waiters.get(id);
+                    set?.delete(wake);
+                    if (set && set.size === 0)
+                        waiters.delete(id);
+                    resolve(value);
+                };
+                const wake = () => {
+                    read().then((r) => {
+                        if (r)
+                            finish(r);
+                    }, onReadError);
+                };
+                const timer = setTimeout(() => {
+                    // One last look before giving up, in case the notification was missed.
+                    read().then(finish, () => finish(null));
+                }, waitMs);
+                let set = waiters.get(id);
+                if (!set) {
+                    set = new Set();
+                    waiters.set(id, set);
+                }
+                set.add(wake);
+                // Close the gap between the first read and registering the waiter: a
+                // value stored in between was published before anyone was listening.
+                wake();
+            });
+        },
+        pendingCount() {
+            let n = 0;
+            for (const set of waiters.values())
+                n += set.size;
+            return n;
+        },
+    };
+}
+//# sourceMappingURL=redis-waits.js.map

package/dist/redis-waits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-waits.js","sourceRoot":"","sources":["../src/redis-waits.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,aAAa,CAAC,UAA6B,EAAE,OAAe,EAAE,MAAsB,EAAE,KAAa;IACjH,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QAClC,IAAI,EAAE,KAAK,OAAO;YAAE,OAAO;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACnD,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,KAAK,4EAA4E,CAAC,CAAC;IAC9G,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,IAAI,CAAI,EAAU,EAAE,MAAc,EAAE,IAA6B,EAAE,WAAmC;YAC1G,MAAM,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC;YACzB,IAAI,GAAG,IAAI,MAAM,IAAI,CAAC;gBAAE,OAAO,GAAG,CAAC;YAEnC,OAAO,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,EAAE;gBACvC,IAAI,IAAI,GAAG,KAAK,CAAC;gBACjB,MAAM,MAAM,GAAG,CAAC,KAAe,EAAE,EAAE;oBACjC,IAAI,IAAI;wBAAE,OAAO;oBACjB,IAAI,GAAG,IAAI,CAAC;oBACZ,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAC5B,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAClB,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;wBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAC9C,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC,CAAC;gBACF,MAAM,IAAI,GAAG,GAAG,EAAE;oBAChB,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;wBAChB,IAAI,CAAC;4BAAE,MAAM,CAAC,CAAC,CAAC,CAAC;oBACnB,CAAC,EAAE,WAAW,CAAC,CAAC;gBAClB,CAAC,CAAC;gBACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,uEAAuE;oBACvE,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1C,CAAC,EAAE,MAAM,CAAC,CAAC;gBAEX,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;oBAChB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBACvB,CAAC;gBACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACd,qEAAqE;gBACrE,qEAAqE;gBACrE,IAAI,EAAE,CAAC;YACT,CAAC,CAAC,CAAC;QACL,CAAC;QAED,YAAY;YACV,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE;gBAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;YAClD,OAAO,CAAC,CAAC;QACX,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/rooms/join.d.ts

@@ -0,0 +1,13 @@
+import type { AuthResult, RoomPolicy } from '../types.js';
+import type { RoomTokenSigner } from './room-token.js';
+/**
+ * Why `user` may not join `room`, or null when it may.
+ *
+ * - An invalid room is refused.
+ * - A room that `requiresToken` needs a token binding this user to this exact
+ *   room. Tokens are minted only after the product's own authorization for
+ *   the resource (see `RoomPolicy`), so the token is the whole check.
+ * - Any other room is the policy's `canJoin`.
+ */
+export declare function joinRefusal(policy: RoomPolicy, tokens: RoomTokenSigner, room: string, user: AuthResult, roomToken?: string): string | null;
+//# sourceMappingURL=join.d.ts.map

package/dist/rooms/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../src/rooms/join.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAWf"}

package/dist/rooms/join.js

@@ -0,0 +1,27 @@
+/**
+ * Why `user` may not join `room`, or null when it may.
+ *
+ * - An invalid room is refused.
+ * - A room that `requiresToken` needs a token binding this user to this exact
+ *   room. Tokens are minted only after the product's own authorization for
+ *   the resource (see `RoomPolicy`), so the token is the whole check.
+ * - Any other room is the policy's `canJoin`.
+ */
+export function joinRefusal(policy, tokens, room, user, roomToken) {
+    if (!policy.isValidRoom(room))
+        return 'invalid room';
+    if (policy.requiresToken(room)) {
+        if (!roomToken)
+            return 'room token required';
+        const payload = tokens.verify(roomToken);
+        if (!payload)
+            return 'room token invalid or expired';
+        if (payload.userId !== user.userId)
+            return 'room token belongs to another user';
+        if (payload.room !== room)
+            return 'room token is for another room';
+        return null;
+    }
+    return policy.canJoin(room, user) ? null : 'not allowed';
+}
+//# sourceMappingURL=join.js.map

package/dist/rooms/join.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.js","sourceRoot":"","sources":["../../src/rooms/join.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,MAAkB,EAClB,MAAuB,EACvB,IAAY,EACZ,IAAgB,EAChB,SAAkB;IAElB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,cAAc,CAAC;IACrD,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS;YAAE,OAAO,qBAAqB,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO,+BAA+B,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO,oCAAoC,CAAC;QAChF,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,gCAAgC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;AAC3D,CAAC"}

package/dist/rooms/room-token.d.ts

@@ -0,0 +1,19 @@
+export interface RoomTokenPayload {
+    userId: string;
+    room: string;
+    /** Expiry, epoch milliseconds. */
+    exp: number;
+}
+export interface RoomTokenSigner {
+    sign(userId: string, room: string): string;
+    /** The payload of a valid, unexpired token, or null for anything else. */
+    verify(token: string): RoomTokenPayload | null;
+    readonly ttlMs: number;
+}
+export declare const DEFAULT_ROOM_TOKEN_TTL_MS: number;
+export declare const MIN_ROOM_TOKEN_SECRET_LENGTH = 32;
+export declare function createRoomTokenSigner(options: {
+    secret: string;
+    ttlMs?: number;
+}): RoomTokenSigner;
+//# sourceMappingURL=room-token.d.ts.map

package/dist/rooms/room-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-token.d.ts","sourceRoot":"","sources":["../../src/rooms/room-token.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,0EAA0E;IAC1E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AACxD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CA2ClG"}

package/dist/rooms/room-token.js

@@ -0,0 +1,55 @@
+/**
+ * Room tokens: a signed statement that one user may join one room, until a
+ * time. HMAC-SHA256 over the JSON payload, `base64url(payload + "." + hexsig)`.
+ *
+ * The server signs a token only when the product's API asks for it
+ * (`POST /internal/room-token`, internal key), and the product asks only after
+ * its own authorization accepted the user for that resource. The server
+ * checks the token on join, against the joining socket's verified identity.
+ */
+import crypto from 'node:crypto';
+export const DEFAULT_ROOM_TOKEN_TTL_MS = 15 * 60 * 1000;
+export const MIN_ROOM_TOKEN_SECRET_LENGTH = 32;
+export function createRoomTokenSigner(options) {
+    const { secret } = options;
+    if (typeof secret !== 'string' || secret.length < MIN_ROOM_TOKEN_SECRET_LENGTH) {
+        throw new Error(`[agent-sdk-realtime] roomTokens.secret must be at least ${MIN_ROOM_TOKEN_SECRET_LENGTH} characters: it signs every room token`);
+    }
+    const ttlMs = options.ttlMs ?? DEFAULT_ROOM_TOKEN_TTL_MS;
+    if (!Number.isFinite(ttlMs) || ttlMs <= 0)
+        throw new Error('[agent-sdk-realtime] roomTokens.ttlMs must be a positive number');
+    const hmac = (payload) => crypto.createHmac('sha256', secret).update(payload).digest('hex');
+    return {
+        ttlMs,
+        sign(userId, room) {
+            const payload = JSON.stringify({ userId, room, exp: Date.now() + ttlMs });
+            return Buffer.from(`${payload}.${hmac(payload)}`).toString('base64url');
+        },
+        verify(token) {
+            try {
+                const decoded = Buffer.from(token, 'base64url').toString('utf-8');
+                const dot = decoded.lastIndexOf('.');
+                if (dot === -1)
+                    return null;
+                const payloadStr = decoded.slice(0, dot);
+                const sig = decoded.slice(dot + 1);
+                const expected = hmac(payloadStr);
+                // Constant-time: both are hex strings of one length when valid.
+                if (sig.length !== expected.length || !crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
+                    return null;
+                }
+                const payload = JSON.parse(payloadStr);
+                if (typeof payload.userId !== 'string' || typeof payload.room !== 'string' || typeof payload.exp !== 'number') {
+                    return null;
+                }
+                if (Date.now() > payload.exp)
+                    return null;
+                return payload;
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=room-token.js.map

package/dist/rooms/room-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-token.js","sourceRoot":"","sources":["../../src/rooms/room-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,MAAM,MAAM,aAAa,CAAC;AAgBjC,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACxD,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C,MAAM,UAAU,qBAAqB,CAAC,OAA2C;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,4BAA4B,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CACb,2DAA2D,4BAA4B,wCAAwC,CAChI,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,yBAAyB,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IAE9H,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpG,OAAO;QACL,KAAK;QAEL,IAAI,CAAC,MAAM,EAAE,IAAI;YACf,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAA6B,CAAC,CAAC;YACrG,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,CAAC,KAAK;YACV,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAClE,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBACrC,IAAI,GAAG,KAAK,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACzC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;gBAClC,gEAAgE;gBAChE,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;oBACvG,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAqB,CAAC;gBAC3D,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;oBAC9G,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG;oBAAE,OAAO,IAAI,CAAC;gBAC1C,OAAO,OAAO,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The realtime server: one implementation for every product (ADR-0227 §2.1).
+ *
+ * It carries turn events and the product's declared events to rooms, holds
+ * UI action results for the agent worker (ADR-0209), keeps the approvals an
+ * irreversible action waits on (ADR-0228), signs and checks room tokens, and
+ * accepts only declared client events. The product supplies the
+ * seams (types.ts); nothing here belongs to one product.
+ */
+import http from 'node:http';
+import { Server } from 'socket.io';
+import type { RealtimeServerConfig } from './types.js';
+import { type RoomTokenSigner } from './rooms/room-token.js';
+import { type OUIResultStore } from './oui/results.js';
+import { type ApprovalStore } from './approvals/store.js';
+import { type SettlementStore } from './events/settlements.js';
+export interface RealtimeServerInstance {
+    io: Server;
+    httpServer: http.Server;
+    /** The port the server listens on (the one picked, when configured with 0). */
+    port: number;
+    /** Signs and checks room tokens with the configured secret. */
+    roomTokens: RoomTokenSigner;
+    /** The UI action result store. */
+    results: OUIResultStore;
+    /** The approval store (ADR-0228). */
+    approvals: ApprovalStore;
+    /** Job settlements, when the server has event declarations. */
+    settlements: SettlementStore | null;
+    close(): Promise<void>;
+}
+export declare function createRealtimeServer(config: RealtimeServerConfig): Promise<RealtimeServerInstance>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKvD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE7E,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI/E,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAWtF,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IACxB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,eAAe,CAAC;IAC5B,kCAAkC;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,qCAAqC;IACrC,SAAS,EAAE,aAAa,CAAC;IACzB,+DAA+D;IAC/D,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAqBD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkIxG"}

package/dist/server.js

@@ -0,0 +1,168 @@
+/**
+ * The realtime server: one implementation for every product (ADR-0227 §2.1).
+ *
+ * It carries turn events and the product's declared events to rooms, holds
+ * UI action results for the agent worker (ADR-0209), keeps the approvals an
+ * irreversible action waits on (ADR-0228), signs and checks room tokens, and
+ * accepts only declared client events. The product supplies the
+ * seams (types.ts); nothing here belongs to one product.
+ */
+import http from 'node:http';
+import express from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import { Server } from 'socket.io';
+import { Redis } from 'ioredis';
+import { createAdapter } from '@socket.io/redis-adapter';
+import { assertRealtimeServerConfig } from './config.js';
+import { createConsoleLogger } from './logger.js';
+import { registerClientEvents, assertUniqueClientEvents } from './client-events/chain.js';
+import { createBuiltinClientEvents } from './client-events/builtin.js';
+import { createRoomTokenSigner } from './rooms/room-token.js';
+import { createOUIResultStore } from './oui/results.js';
+import { createApprovalTokenSigner } from './approvals/token.js';
+import { createApprovalStore } from './approvals/store.js';
+import { createApprovalDecideEvent } from './approvals/client-event.js';
+import { approvalRouter } from './approvals/routes.js';
+import { createDeclaredEvents } from './events/declared.js';
+import { createSettlementStore } from './events/settlements.js';
+import { createInternalKeyCheck, emitRouter, healthRouter, ouiResultsRouter, roomTokenRouter, settlementsRouter, } from './http/routes.js';
+function connectRedis(config, label, logger) {
+    const client = new Redis({
+        host: config.host,
+        port: config.port,
+        username: config.username,
+        password: config.password,
+        tls: config.tls ? {} : undefined,
+        maxRetriesPerRequest: null,
+        lazyConnect: true,
+        retryStrategy(times) {
+            const delay = Math.min(times * 500, 10_000);
+            logger.warn({ label, attempt: times, nextRetryMs: delay }, 'Redis retry');
+            return delay;
+        },
+    });
+    client.on('error', (err) => logger.error({ err, label }, 'Redis client error'));
+    return client;
+}
+export async function createRealtimeServer(config) {
+    assertRealtimeServerConfig(config);
+    const logger = config.logger ?? createConsoleLogger();
+    const roomTokens = createRoomTokenSigner(config.roomTokens);
+    const approvalTokens = createApprovalTokenSigner(config.approvals);
+    // Compiled before anything connects: a payload schema that cannot compile
+    // fails start-up, naming the event.
+    const declared = config.events ? createDeclaredEvents(config.events) : null;
+    // Redis first: without it there is no result store and no fan-out, so the
+    // server does not accept connections it cannot serve.
+    const pub = connectRedis(config.redis, 'pub', logger);
+    const sub = connectRedis(config.redis, 'sub', logger);
+    // Subscriber mode takes over a connection, and `sub` belongs to the socket.io
+    // adapter, so UI action results get a subscriber of their own.
+    const resultsSub = connectRedis(config.redis, 'oui-results-sub', logger);
+    const redisClients = [pub, sub, resultsSub];
+    try {
+        await Promise.all(redisClients.map((c) => c.connect()));
+    }
+    catch (err) {
+        redisClients.forEach((c) => c.disconnect());
+        throw new Error(`[agent-sdk-realtime] Redis at ${config.redis.host}:${config.redis.port} is unreachable: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    const results = createOUIResultStore(pub, resultsSub, logger);
+    const approvals = createApprovalStore(pub, approvalTokens, logger);
+    const settlements = declared ? createSettlementStore(pub, resultsSub, logger) : null;
+    const clientEvents = [
+        ...createBuiltinClientEvents({
+            roomPolicy: config.roomPolicy,
+            roomTokens,
+            relay: config.relay ?? {},
+            declared,
+            results: () => results,
+        }),
+        createApprovalDecideEvent(() => approvals),
+        ...(config.clientEvents ?? []),
+    ];
+    assertUniqueClientEvents(clientEvents);
+    const app = express();
+    app.use(helmet());
+    app.use(cors({ origin: config.corsOrigins, credentials: true }));
+    app.use(express.json({ limit: '1mb' }));
+    const httpServer = http.createServer(app);
+    const io = new Server(httpServer, {
+        cors: { origin: config.corsOrigins, methods: ['GET', 'POST'], credentials: true },
+        pingInterval: config.pingInterval ?? 25_000,
+        pingTimeout: config.pingTimeout ?? 20_000,
+    });
+    io.adapter(createAdapter(pub, sub));
+    const deps = {
+        io,
+        roomPolicy: config.roomPolicy,
+        roomTokens,
+        results: () => results,
+        declared,
+        settlements: () => settlements,
+        isInternalKey: createInternalKeyCheck(config.internalApiKey),
+        logger,
+    };
+    app.use(healthRouter(deps));
+    app.use(emitRouter(deps));
+    app.use(roomTokenRouter(deps));
+    app.use(ouiResultsRouter(deps));
+    app.use(approvalRouter({ approvals, isInternalKey: deps.isInternalKey }));
+    app.use(settlementsRouter(deps));
+    // Authentication, once per socket, through the product's verifier.
+    io.use(async (socket, next) => {
+        const token = socket.handshake.auth?.token ||
+            socket.handshake.headers.authorization?.replace(/^Bearer\s+/i, '');
+        if (!token) {
+            next(new Error('Authentication required'));
+            return;
+        }
+        try {
+            const user = await config.auth.verify(token);
+            if (!user || typeof user.userId !== 'string' || !user.userId)
+                throw new Error('verifier returned no userId');
+            socket.data = { user };
+            next();
+        }
+        catch (err) {
+            logger.warn({ err, socketId: socket.id }, 'Socket authentication failed');
+            next(new Error('Authentication failed'));
+        }
+    });
+    io.on('connection', (raw) => {
+        const socket = raw;
+        const { user } = socket.data;
+        const identityRooms = config.roomPolicy.identityRooms(user);
+        for (const room of identityRooms)
+            socket.join(room);
+        logger.info({ socketId: socket.id, userId: user.userId, accountId: user.accountId, rooms: identityRooms }, 'Client connected');
+        registerClientEvents(io, socket, clientEvents, logger);
+        socket.on('disconnect', (reason) => {
+            logger.info({ socketId: socket.id, userId: user.userId, reason }, 'Client disconnected');
+        });
+    });
+    await new Promise((resolve, reject) => {
+        httpServer.once('error', reject);
+        httpServer.listen(config.port, () => {
+            httpServer.off('error', reject);
+            resolve();
+        });
+    });
+    const port = httpServer.address().port;
+    logger.info({ port, declaredEvents: config.events?.names().length ?? null }, 'Realtime server listening');
+    return {
+        io,
+        httpServer,
+        port,
+        roomTokens,
+        results,
+        approvals,
+        settlements,
+        async close() {
+            await new Promise((resolve) => io.close(() => resolve()));
+            await Promise.all(redisClients.map((c) => c.quit().catch(() => c.disconnect())));
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,7 @@
+import type { RedisConfig } from '../types.js';
+export interface TestRedis {
+    config: RedisConfig;
+    stop(): Promise<void>;
+}
+export declare function startTestRedis(): Promise<TestRedis>;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AA0BD,wBAAsB,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC,CAqDzD"}