@framers/agentos 0.13.79 → 0.13.81

package/dist/io/channels/meetings/stores/sql.js

@@ -0,0 +1,497 @@
+import { CONTENT_EVENT_TYPES } from '../types.js';
+import { DuplicateIdempotencyKeyError, FencedError, nextAttemptAt, OUTBOX_GIVE_UP_MS } from './types.js';
+/** Default prefix for all meeting tables and indexes. */
+export const DEFAULT_TABLE_PREFIX = 'agentos_meeting';
+/** A lower-case letter then at most 37 lower-case letters, digits or underscores: `idx_<prefix>_events_id` stays within 63 bytes. */
+const TABLE_PREFIX = /^[a-z][a-z0-9_]{0,37}$/;
+/** Builds the table names, rejecting a prefix outside the identifier length and character bounds. */
+export function meetingStoreTables(tablePrefix = DEFAULT_TABLE_PREFIX) {
+    if (!TABLE_PREFIX.test(tablePrefix))
+        throw new Error(`A meeting store's tablePrefix is a lower-case letter and at most 37 more lower-case letters, digits or underscores; got ${JSON.stringify(tablePrefix)}.`);
+    return { runs: `${tablePrefix}_runs`, jobs: `${tablePrefix}_jobs`, turns: `${tablePrefix}_turns`, events: `${tablePrefix}_events`, outbox: `${tablePrefix}_outbox`, locks: `${tablePrefix}_run_locks` };
+}
+/** The six tables and their indexes under one prefix. A product copies this text into its migration. */
+export function meetingStoresDdl(tablePrefix = DEFAULT_TABLE_PREFIX) {
+    const t = meetingStoreTables(tablePrefix);
+    const p = tablePrefix;
+    return `
+CREATE TABLE IF NOT EXISTS ${t.runs} (
+  run_id TEXT PRIMARY KEY,
+  owner_ref TEXT NOT NULL,
+  provider_name TEXT NOT NULL,
+  platform TEXT NOT NULL,
+  state TEXT NOT NULL,
+  keep TEXT NOT NULL,
+  meeting_url TEXT NOT NULL,
+  bot_name TEXT NOT NULL,
+  notice_text TEXT NOT NULL,
+  notice_version TEXT NOT NULL,
+  notice_late_text TEXT NOT NULL,
+  stop_phrase TEXT NOT NULL,
+  limits_json TEXT NOT NULL,
+  idempotency_key TEXT,
+  transcriber TEXT,
+  requested_at BIGINT NOT NULL,
+  join_at BIGINT NOT NULL,
+  dispatched_at BIGINT,
+  joined_at BIGINT,
+  notice_posted_at BIGINT,
+  capture_started_at BIGINT,
+  left_at BIGINT,
+  done_at BIGINT,
+  reason TEXT,
+  billed_seconds INTEGER NOT NULL DEFAULT 0,
+  reservation_id TEXT,
+  consent_record_id TEXT,
+  dispatch_json TEXT,
+  page_seen_at BIGINT,
+  last_usage_at BIGINT,
+  monitor_seen_at BIGINT,
+  participant_count INTEGER,
+  leave_commanded_at BIGINT,
+  capture_suspended_at BIGINT,
+  alone_since BIGINT,
+  reported_seconds INTEGER,
+  cleanup_pending BOOLEAN NOT NULL DEFAULT FALSE,
+  purged_at BIGINT
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_${p}_runs_idem ON ${t.runs} (owner_ref, idempotency_key) WHERE idempotency_key IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_${p}_runs_owner ON ${t.runs} (owner_ref, requested_at DESC);
+CREATE INDEX IF NOT EXISTS idx_${p}_runs_state ON ${t.runs} (state);
+CREATE TABLE IF NOT EXISTS ${t.jobs} (
+  run_id TEXT PRIMARY KEY,
+  dispatch_at BIGINT NOT NULL,
+  lease_holder TEXT,
+  lease_expires_at BIGINT,
+  worker_id TEXT,
+  dispatched BOOLEAN NOT NULL DEFAULT FALSE,
+  cancelled BOOLEAN NOT NULL DEFAULT FALSE
+);
+CREATE INDEX IF NOT EXISTS idx_${p}_jobs_due ON ${t.jobs} (dispatch_at) WHERE NOT dispatched AND NOT cancelled;
+CREATE TABLE IF NOT EXISTS ${t.locks} (
+  run_id TEXT PRIMARY KEY,
+  event_seq INTEGER NOT NULL DEFAULT 0,
+  turn_seq INTEGER NOT NULL DEFAULT 0,
+  fenced_at BIGINT
+);
+CREATE TABLE IF NOT EXISTS ${t.turns} (
+  run_id TEXT NOT NULL,
+  seq INTEGER NOT NULL,
+  turn_id TEXT NOT NULL,
+  at BIGINT NOT NULL,
+  text TEXT NOT NULL,
+  speaker TEXT,
+  start_ms INTEGER,
+  end_ms INTEGER,
+  PRIMARY KEY (run_id, seq)
+);
+CREATE TABLE IF NOT EXISTS ${t.events} (
+  run_id TEXT NOT NULL,
+  seq INTEGER NOT NULL,
+  event_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  at BIGINT NOT NULL,
+  data_json TEXT,
+  purged BOOLEAN NOT NULL DEFAULT FALSE,
+  PRIMARY KEY (run_id, seq)
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_${p}_events_id ON ${t.events} (event_id);
+CREATE TABLE IF NOT EXISTS ${t.outbox} (
+  id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  destination_ref TEXT NOT NULL,
+  event_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  attempts INTEGER NOT NULL DEFAULT 0,
+  first_attempt_at BIGINT,
+  next_at BIGINT NOT NULL,
+  state TEXT NOT NULL,
+  purged BOOLEAN NOT NULL DEFAULT FALSE
+);
+CREATE INDEX IF NOT EXISTS idx_${p}_outbox_due ON ${t.outbox} (next_at) WHERE state = 'pending';
+CREATE INDEX IF NOT EXISTS idx_${p}_outbox_run ON ${t.outbox} (run_id);
+`;
+}
+/** Schema under {@link DEFAULT_TABLE_PREFIX}; apply it before constructing the stores. */
+export const MEETING_STORES_DDL = meetingStoresDdl();
+/** These stores are Postgres stores: `FOR UPDATE SKIP LOCKED`, `ON CONFLICT ... RETURNING` and the row lock an upsert takes are what they rest on. */
+function checkPostgres(db, what) {
+    if (!/postgres/i.test(db.kind))
+        throw new Error(`${what} is a Postgres store; "${db.kind}" is not Postgres.`);
+    const caps = db.capabilities;
+    if (!(caps.has('transactions') && caps.has('persistence') && caps.has('concurrent'))) {
+        throw new Error(`${what} needs a store several processes share (transactions, persistence and concurrent access); "${db.kind}" lacks one.`);
+    }
+}
+const num = (v) => (v === null || v === undefined ? undefined : typeof v === 'number' ? v : Number(v));
+const bool = (v) => v === true || v === 1 || v === '1' || v === 't' || v === 'true';
+/**
+ * Takes the run's anchor row for the rest of the transaction (an upsert locks the row it touches, so every content write
+ * of one run runs after the one before it) and answers the fence. The row is made on first use.
+ */
+async function lockRun(trx, locks, runId) {
+    const row = await trx.get(`INSERT INTO ${locks} (run_id) VALUES (?) ON CONFLICT (run_id) DO UPDATE SET run_id = EXCLUDED.run_id RETURNING fenced_at, event_seq`, [runId]);
+    return { fencedAt: num(row?.fenced_at), eventSeq: num(row?.event_seq) ?? 0 };
+}
+async function fenceRun(db, locks, runId, now) {
+    await db.run(`INSERT INTO ${locks} (run_id, fenced_at) VALUES (?, ?) ON CONFLICT (run_id) DO UPDATE SET fenced_at = COALESCE(${locks}.fenced_at, EXCLUDED.fenced_at)`, [runId, now]);
+}
+/** Durable run records with sealed URLs and expected-state updates under the run anchor. */
+export class SqlRunStore {
+    /** Checks the adapter capabilities and prefix; the caller applies the exported DDL. */
+    constructor(opts) {
+        this.opts = opts;
+        checkPostgres(opts.db, 'SqlRunStore');
+        this.t = meetingStoreTables(opts.tablePrefix);
+    }
+    /** Serialises no options, database or box; persistence uses only the explicit row fields. */
+    toJSON() {
+        return '[SqlRunStore redacted]';
+    }
+    row(run) {
+        return [run.runId, run.ownerRef, run.providerName, run.platform, run.state, run.keep, run.meetingUrl === '' ? '' : this.opts.box.seal(run.meetingUrl, run.runId), run.botName, run.notice.text, run.notice.version, run.notice.lateArrivalText, run.stopPhrase, JSON.stringify(run.limits), run.idempotencyKey ?? null, run.transcriber ?? null, run.requestedAt, run.joinAt, run.dispatchedAt ?? null, run.joinedAt ?? null, run.noticePostedAt ?? null, run.captureStartedAt ?? null, run.leftAt ?? null, run.doneAt ?? null, run.reason ?? null, run.billedSeconds, run.reservationId ?? null, run.consentRecordId ?? null, run.dispatch ? JSON.stringify(run.dispatch) : null, run.pageSeenAt ?? null, run.lastUsageAt ?? null, run.monitorSeenAt ?? null, run.participantCount ?? null, run.leaveCommandedAt ?? null, run.captureSuspendedAt ?? null, run.aloneSince ?? null, run.reportedSeconds ?? null, run.cleanupPending ?? false, run.purgedAt ?? null];
+    }
+    fromRow(r) {
+        const sealed = String(r.meeting_url ?? '');
+        const run = {
+            runId: String(r.run_id), ownerRef: String(r.owner_ref), providerName: String(r.provider_name), platform: r.platform, state: r.state, keep: r.keep,
+            meetingUrl: sealed === '' ? '' : this.opts.box.open(sealed, String(r.run_id)), botName: String(r.bot_name), notice: { text: String(r.notice_text), version: String(r.notice_version), lateArrivalText: String(r.notice_late_text) }, stopPhrase: String(r.stop_phrase),
+            limits: JSON.parse(String(r.limits_json)), requestedAt: num(r.requested_at), joinAt: num(r.join_at), billedSeconds: num(r.billed_seconds) ?? 0,
+        };
+        const opt = (key, value) => { if (value !== undefined && value !== null)
+            run[key] = value; };
+        opt('idempotencyKey', r.idempotency_key);
+        opt('transcriber', r.transcriber);
+        opt('dispatchedAt', num(r.dispatched_at));
+        opt('joinedAt', num(r.joined_at));
+        opt('noticePostedAt', num(r.notice_posted_at));
+        opt('captureStartedAt', num(r.capture_started_at));
+        opt('leftAt', num(r.left_at));
+        opt('doneAt', num(r.done_at));
+        opt('reason', r.reason);
+        opt('reservationId', r.reservation_id);
+        opt('consentRecordId', r.consent_record_id);
+        opt('dispatch', r.dispatch_json ? JSON.parse(String(r.dispatch_json)) : undefined);
+        opt('pageSeenAt', num(r.page_seen_at));
+        opt('lastUsageAt', num(r.last_usage_at));
+        opt('monitorSeenAt', num(r.monitor_seen_at));
+        opt('participantCount', num(r.participant_count));
+        opt('leaveCommandedAt', num(r.leave_commanded_at));
+        opt('captureSuspendedAt', num(r.capture_suspended_at));
+        opt('aloneSince', num(r.alone_since));
+        opt('reportedSeconds', num(r.reported_seconds));
+        opt('purgedAt', num(r.purged_at));
+        if (bool(r.cleanup_pending))
+            run.cleanupPending = true;
+        return run;
+    }
+    /** Inserts a run, mapping an owner's repeated idempotency key to the public conflict error. */
+    async insert(run) {
+        const marks = SqlRunStore.COLUMNS.split(', ').map(() => '?').join(', ');
+        try {
+            await this.opts.db.transaction(async (trx) => {
+                await lockRun(trx, this.t.locks, run.runId);
+                await trx.run(`INSERT INTO ${this.t.runs} (${SqlRunStore.COLUMNS}) VALUES (${marks})`, this.row(run));
+            });
+        }
+        catch (err) {
+            const conflict = err;
+            const index = `idx_${this.opts.tablePrefix ?? DEFAULT_TABLE_PREFIX}_runs_idem`;
+            if (conflict.code === '23505' && conflict.constraint === index && run.idempotencyKey !== undefined) {
+                throw new DuplicateIdempotencyKeyError(run.ownerRef, run.idempotencyKey);
+            }
+            throw err;
+        }
+    }
+    /** Reads a run, opening its URL with its run id as authenticated context. */
+    async get(runId) {
+        const r = await this.opts.db.get(`SELECT * FROM ${this.t.runs} WHERE run_id = ?`, [runId]);
+        return r ? this.fromRow(r) : undefined;
+    }
+    /** Re-reads and patches under the anchor, setting the content fence atomically on entry to purging. */
+    async update(runId, patch, expectState) {
+        return this.opts.db.transaction(async (trx) => {
+            await lockRun(trx, this.t.locks, runId);
+            const r = await trx.get(`SELECT * FROM ${this.t.runs} WHERE run_id = ? FOR UPDATE`, [runId]);
+            if (!r)
+                return undefined;
+            const current = this.fromRow(r);
+            if (expectState !== undefined) {
+                const allowed = Array.isArray(expectState) ? expectState : [expectState];
+                if (!allowed.includes(current.state))
+                    return undefined;
+            }
+            if (patch.state === 'purging') {
+                await trx.run(`UPDATE ${this.t.locks} SET fenced_at = COALESCE(fenced_at, ?) WHERE run_id = ?`, [Date.now(), runId]);
+            }
+            const next = { ...current, ...patch };
+            const row = this.row(next);
+            const sets = SqlRunStore.COLUMNS.split(', ').map((c) => `${c} = ?`).join(', ');
+            await trx.run(`UPDATE ${this.t.runs} SET ${sets} WHERE run_id = ?`, [...row, runId]);
+            return next;
+        });
+    }
+    /** Rewrites an existing row under the anchor, including its content-free form after a purge. */
+    async replace(run) {
+        const sets = SqlRunStore.COLUMNS.split(', ').map((c) => `${c} = ?`).join(', ');
+        await this.opts.db.transaction(async (trx) => {
+            await lockRun(trx, this.t.locks, run.runId);
+            await trx.run(`UPDATE ${this.t.runs} SET ${sets} WHERE run_id = ?`, [...this.row(run), run.runId]);
+        });
+    }
+    /** Lists matching runs by requested time descending, then run id ascending. */
+    async list(filter) {
+        const where = [];
+        const params = [];
+        if (filter.ownerRef !== undefined) {
+            where.push('owner_ref = ?');
+            params.push(filter.ownerRef);
+        }
+        if (filter.states?.length) {
+            where.push(`state IN (${filter.states.map(() => '?').join(', ')})`);
+            params.push(...filter.states);
+        }
+        if (filter.since !== undefined) {
+            where.push('requested_at >= ?');
+            params.push(filter.since);
+        }
+        const rows = await this.opts.db.all(`SELECT * FROM ${this.t.runs}${where.length ? ` WHERE ${where.join(' AND ')}` : ''} ORDER BY requested_at DESC, run_id ASC LIMIT ?`, [...params, filter.limit ?? 500]);
+        return rows.map((r) => this.fromRow(r));
+    }
+    /** Finds the owner's run for a previously used idempotency key. */
+    async findByIdempotencyKey(ownerRef, key) {
+        const r = await this.opts.db.get(`SELECT * FROM ${this.t.runs} WHERE owner_ref = ? AND idempotency_key = ?`, [ownerRef, key]);
+        return r ? this.fromRow(r) : undefined;
+    }
+}
+SqlRunStore.COLUMNS = 'run_id, owner_ref, provider_name, platform, state, keep, meeting_url, bot_name, notice_text, notice_version, notice_late_text, stop_phrase, limits_json, idempotency_key, transcriber, requested_at, join_at, dispatched_at, joined_at, notice_posted_at, capture_started_at, left_at, done_at, reason, billed_seconds, reservation_id, consent_record_id, dispatch_json, page_seen_at, last_usage_at, monitor_seen_at, participant_count, leave_commanded_at, capture_suspended_at, alone_since, reported_seconds, cleanup_pending, purged_at';
+/** Postgres dispatch jobs with atomic leases and holder-checked writes. */
+export class SqlJobStore {
+    /** Checks the adapter capabilities and prefix without creating tables. */
+    constructor(opts) {
+        this.opts = opts;
+        checkPostgres(opts.db, 'SqlJobStore');
+        this.t = meetingStoreTables(opts.tablePrefix);
+    }
+    fromRow(r) {
+        return { runId: String(r.run_id), dispatchAt: num(r.dispatch_at), leaseHolder: r.lease_holder ?? undefined, leaseExpiresAt: num(r.lease_expires_at), workerId: r.worker_id ?? undefined, dispatched: bool(r.dispatched), cancelled: bool(r.cancelled) };
+    }
+    /** Schedules a job; an existing job keeps its lease, dispatch and cancellation fields. */
+    async schedule(job) {
+        await this.opts.db.run(`INSERT INTO ${this.t.jobs} (run_id, dispatch_at) VALUES (?, ?) ON CONFLICT (run_id) DO UPDATE SET dispatch_at = EXCLUDED.dispatch_at`, [job.runId, job.dispatchAt]);
+    }
+    /** One statement: the row is locked, skipped by any other taker, and leased in the same UPDATE. */
+    async lease(holder, now, ttlMs) {
+        const r = await this.opts.db.get(`UPDATE ${this.t.jobs} SET lease_holder = ?, lease_expires_at = ?
+       WHERE run_id = (
+         SELECT run_id FROM ${this.t.jobs}
+         WHERE NOT dispatched AND NOT cancelled AND dispatch_at <= ? AND (lease_expires_at IS NULL OR lease_expires_at <= ?)
+         ORDER BY dispatch_at LIMIT 1 FOR UPDATE SKIP LOCKED
+       ) RETURNING *`, [holder, now + ttlMs, now, now]);
+        return r ? this.fromRow(r) : undefined;
+    }
+    /** Extends an unexpired lease only for its current holder. */
+    async renew(runId, holder, now, ttlMs) {
+        const res = await this.opts.db.run(`UPDATE ${this.t.jobs} SET lease_expires_at = ? WHERE run_id = ? AND lease_holder = ? AND lease_expires_at > ?`, [now + ttlMs, runId, holder, now]);
+        return res.changes > 0;
+    }
+    /** Records the holder's dispatch and reports a cancellation that arrived during it. */
+    async markDispatched(runId, holder, workerId) {
+        return this.opts.db.transaction(async (trx) => {
+            const job = await trx.get(`SELECT lease_holder, cancelled FROM ${this.t.jobs} WHERE run_id = ? FOR UPDATE`, [runId]);
+            if (!job)
+                return { recorded: false, cancelled: false };
+            if (job.lease_holder !== holder)
+                return { recorded: false, cancelled: bool(job.cancelled) };
+            await trx.run(`UPDATE ${this.t.jobs} SET dispatched = TRUE, worker_id = ? WHERE run_id = ? AND lease_holder = ?`, [workerId ?? null, runId, holder]);
+            return { recorded: true, cancelled: bool(job.cancelled) };
+        });
+    }
+    /** Releases the holder's lease and moves the job's due time to its retry. */
+    async release(runId, holder, retryAt) {
+        const result = await this.opts.db.run(`UPDATE ${this.t.jobs} SET lease_holder = NULL, lease_expires_at = NULL, dispatch_at = ? WHERE run_id = ? AND lease_holder = ?`, [retryAt, runId, holder]);
+        return result.changes > 0;
+    }
+    /** Cancels a pending job or reports that the caller must leave an already dispatched bot. */
+    async cancel(runId) {
+        return this.opts.db.transaction(async (trx) => {
+            const r = await trx.get(`SELECT dispatched FROM ${this.t.jobs} WHERE run_id = ? FOR UPDATE`, [runId]);
+            if (!r)
+                return 'missing';
+            if (bool(r.dispatched))
+                return 'already_dispatched';
+            await trx.run(`UPDATE ${this.t.jobs} SET cancelled = TRUE WHERE run_id = ?`, [runId]);
+            return 'cancelled';
+        });
+    }
+    /** Reads one dispatch job. */
+    async get(runId) {
+        const r = await this.opts.db.get(`SELECT * FROM ${this.t.jobs} WHERE run_id = ?`, [runId]);
+        return r ? this.fromRow(r) : undefined;
+    }
+    /** Lists the dispatched jobs reconciliation compares with provider usage. */
+    async listDispatched() {
+        return (await this.opts.db.all(`SELECT * FROM ${this.t.jobs} WHERE dispatched`)).map((r) => this.fromRow(r));
+    }
+    /** Removes a run's job. */
+    async remove(runId) {
+        await this.opts.db.run(`DELETE FROM ${this.t.jobs} WHERE run_id = ?`, [runId]);
+    }
+}
+/** Durable transcript turns, allocated and written under the same anchor as the content fence. */
+export class SqlTranscriptStore {
+    /** Checks the adapter capabilities and prefix without creating tables. */
+    constructor(opts) {
+        this.opts = opts;
+        checkPostgres(opts.db, 'SqlTranscriptStore');
+        this.t = meetingStoreTables(opts.tablePrefix);
+    }
+    /** The anchor row is locked first, so an append and a fence of one run never interleave: a fence that commits first is seen, a fence that waits sees the turn and purges it. */
+    async append(turn) {
+        await this.opts.db.transaction(async (trx) => {
+            const { fencedAt } = await lockRun(trx, this.t.locks, turn.runId);
+            if (fencedAt !== undefined)
+                throw new FencedError(turn.runId);
+            await trx.run(`INSERT INTO ${this.t.turns} (run_id, seq, turn_id, at, text, speaker, start_ms, end_ms) VALUES (?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`, [turn.runId, turn.seq, turn.turnId, turn.at, turn.text, turn.speaker ?? null, turn.startMs ?? null, turn.endMs ?? null]);
+            await trx.run(`UPDATE ${this.t.locks} SET turn_seq = GREATEST(turn_seq, ?) WHERE run_id = ?`, [turn.seq, turn.runId]);
+        });
+    }
+    /** Allocates the next run sequence and stores the turn atomically, rejecting fenced runs. */
+    async appendNext(input) {
+        return this.opts.db.transaction(async (trx) => {
+            const { fencedAt } = await lockRun(trx, this.t.locks, input.runId);
+            if (fencedAt !== undefined)
+                throw new FencedError(input.runId);
+            const row = await trx.get(`UPDATE ${this.t.locks} SET turn_seq = GREATEST(turn_seq, COALESCE((SELECT MAX(seq) FROM ${this.t.turns} WHERE run_id = ?), 0)) + 1 WHERE run_id = ? RETURNING turn_seq`, [input.runId, input.runId]);
+            const seq = num(row?.turn_seq);
+            const turn = { ...input, seq, turnId: `${input.runId}:${seq}` };
+            await trx.run(`INSERT INTO ${this.t.turns} (run_id, seq, turn_id, at, text, speaker, start_ms, end_ms) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [turn.runId, seq, turn.turnId, turn.at, turn.text, turn.speaker ?? null, turn.startMs ?? null, turn.endMs ?? null]);
+            return turn;
+        });
+    }
+    /** Reads turns after the cursor in sequence order. */
+    async read(runId, fromSeq, limit = 500) {
+        const rows = await this.opts.db.all(`SELECT * FROM ${this.t.turns} WHERE run_id = ? AND seq > ? ORDER BY seq LIMIT ?`, [runId, fromSeq, limit]);
+        return rows.map((r) => ({ runId: String(r.run_id), seq: num(r.seq), turnId: String(r.turn_id), at: num(r.at), text: String(r.text), speaker: r.speaker ?? undefined, startMs: num(r.start_ms), endMs: num(r.end_ms) }));
+    }
+    /** Fences the run against further transcript and content writes. */
+    async fence(runId) {
+        await fenceRun(this.opts.db, this.t.locks, runId, Date.now());
+    }
+    /** Reports whether the run's durable fence is set. */
+    async isFenced(runId) {
+        const r = await this.opts.db.get(`SELECT fenced_at FROM ${this.t.locks} WHERE run_id = ?`, [runId]);
+        return num(r?.fenced_at) !== undefined;
+    }
+    /** Removes turns under the anchor, retaining its fence and sequence counters. */
+    async purge(runId) {
+        await this.opts.db.transaction(async (trx) => {
+            await lockRun(trx, this.t.locks, runId);
+            await trx.run(`DELETE FROM ${this.t.turns} WHERE run_id = ?`, [runId]);
+        });
+    }
+}
+/** Durable per-run event sequences with idempotent event ids and payload fencing. */
+export class SqlEventStore {
+    /** Checks the adapter capabilities and prefix without creating tables. */
+    constructor(opts) {
+        this.opts = opts;
+        checkPostgres(opts.db, 'SqlEventStore');
+        this.t = meetingStoreTables(opts.tablePrefix);
+    }
+    /**
+     * One transaction: the run's anchor row is locked (so sequence numbers of one run are handed out one at a time and the
+     * fence is read under the same lock), a repeated event id answers its existing sequence, the counter advances, the row
+     * is written; behind the fence a content event is written without its payload.
+     */
+    async append(event) {
+        return this.opts.db.transaction(async (trx) => {
+            const { fencedAt } = await lockRun(trx, this.t.locks, event.runId);
+            const existing = await trx.get(`SELECT seq FROM ${this.t.events} WHERE event_id = ?`, [event.eventId]);
+            if (existing)
+                return { inserted: false, seq: num(existing.seq) };
+            const next = await trx.get(`UPDATE ${this.t.locks} SET event_seq = event_seq + 1 WHERE run_id = ? RETURNING event_seq`, [event.runId]);
+            const seq = num(next?.event_seq);
+            const behindFence = fencedAt !== undefined && CONTENT_EVENT_TYPES.has(event.type);
+            await trx.run(`INSERT INTO ${this.t.events} (run_id, seq, event_id, type, at, data_json, purged) VALUES (?, ?, ?, ?, ?, ?, ?)`, [event.runId, seq, event.eventId, event.type, event.at, behindFence || event.data === undefined ? null : JSON.stringify(event.data), behindFence]);
+            return { inserted: true, seq };
+        });
+    }
+    /** Reads events after the cursor in sequence order. */
+    async read(runId, fromSeq, limit = 500) {
+        const rows = await this.opts.db.all(`SELECT * FROM ${this.t.events} WHERE run_id = ? AND seq > ? ORDER BY seq LIMIT ?`, [runId, fromSeq, limit]);
+        return rows.map((r) => ({ runId: String(r.run_id), seq: num(r.seq), eventId: String(r.event_id), type: r.type, at: num(r.at), ...(r.data_json ? { data: JSON.parse(String(r.data_json)) } : {}), ...(bool(r.purged) ? { purged: true } : {}) }));
+    }
+    /** Prevents further content payloads from being stored for the run. */
+    async fence(runId) {
+        await fenceRun(this.opts.db, this.t.locks, runId, Date.now());
+    }
+    /** Scrubs content payloads under the anchor, preserving event ids, types, times and sequences. */
+    async purgePayloads(runId) {
+        const types = [...CONTENT_EVENT_TYPES];
+        await this.opts.db.transaction(async (trx) => {
+            await lockRun(trx, this.t.locks, runId);
+            await trx.run(`UPDATE ${this.t.events} SET data_json = NULL, purged = TRUE WHERE run_id = ? AND type IN (${types.map(() => '?').join(', ')})`, [runId, ...types]);
+        });
+    }
+}
+/** Durable outbound deliveries with retry backoff, manual replay and content scrubbing. */
+export class SqlOutbox {
+    /** Checks the adapter capabilities and prefix without creating tables. */
+    constructor(opts) {
+        this.opts = opts;
+        checkPostgres(opts.db, 'SqlOutbox');
+        this.t = meetingStoreTables(opts.tablePrefix);
+    }
+    fromRow(r) {
+        return { id: String(r.id), runId: String(r.run_id), destinationRef: String(r.destination_ref), eventId: String(r.event_id), type: r.type, payload: String(r.payload), attempts: num(r.attempts) ?? 0, firstAttemptAt: num(r.first_attempt_at), nextAt: num(r.next_at), state: r.state, purged: bool(r.purged) };
+    }
+    /** Enqueues once per delivery id, refusing new content behind the run's fence. */
+    async enqueue(d, now) {
+        await this.opts.db.transaction(async (trx) => {
+            const { fencedAt } = await lockRun(trx, this.t.locks, d.runId);
+            if (fencedAt !== undefined && CONTENT_EVENT_TYPES.has(d.type))
+                return;
+            await trx.run(`INSERT INTO ${this.t.outbox} (id, run_id, destination_ref, event_id, type, payload, next_at, state) VALUES (?, ?, ?, ?, ?, ?, ?, 'pending') ON CONFLICT (id) DO NOTHING`, [d.id, d.runId, d.destinationRef, d.eventId, d.type, d.payload, now]);
+        });
+    }
+    /** Lists pending deliveries due at now, ordered by due time and id. */
+    async due(now, limit = 100) {
+        return (await this.opts.db.all(`SELECT * FROM ${this.t.outbox} WHERE state = 'pending' AND next_at <= ? ORDER BY next_at, id LIMIT ?`, [now, limit])).map((r) => this.fromRow(r));
+    }
+    /** Marks a delivery accepted by its destination. */
+    async markDelivered(id) {
+        await this.opts.db.run(`UPDATE ${this.t.outbox} SET state = 'delivered' WHERE id = ?`, [id]);
+    }
+    /** Advances retry backoff, giving up a day after the first failed attempt. */
+    async markFailed(id, now) {
+        await this.opts.db.transaction(async (trx) => {
+            const r = await trx.get(`SELECT attempts, first_attempt_at FROM ${this.t.outbox} WHERE id = ? FOR UPDATE`, [id]);
+            if (!r)
+                return;
+            const attempts = (num(r.attempts) ?? 0) + 1;
+            const first = num(r.first_attempt_at) ?? now;
+            const dead = now - first >= OUTBOX_GIVE_UP_MS;
+            await trx.run(`UPDATE ${this.t.outbox} SET attempts = ?, first_attempt_at = ?, next_at = ?, state = ? WHERE id = ?`, [attempts, first, dead ? now : nextAttemptAt(attempts, now), dead ? 'dead' : 'pending', id]);
+        });
+    }
+    /** Resets attempts and makes a delivery due now without restoring any purged payload. */
+    async replay(id, now) {
+        await this.opts.db.run(`UPDATE ${this.t.outbox} SET state = 'pending', attempts = 0, first_attempt_at = NULL, next_at = ? WHERE id = ?`, [now, id]);
+    }
+    /** Fences new content and scrubs content deliveries, including delivered rows; content-free deliveries keep their type and payload. */
+    async purgeContent(runId) {
+        await this.opts.db.transaction(async (trx) => {
+            await lockRun(trx, this.t.locks, runId);
+            await trx.run(`UPDATE ${this.t.locks} SET fenced_at = COALESCE(fenced_at, ?) WHERE run_id = ?`, [Date.now(), runId]);
+            const types = [...CONTENT_EVENT_TYPES];
+            await trx.run(`UPDATE ${this.t.outbox} SET payload = '', type = 'bot:purged', purged = TRUE WHERE run_id = ? AND type IN (${types.map(() => '?').join(', ')})`, [runId, ...types]);
+        });
+    }
+    /** Lists all deliveries of a run, including delivered and dead ones. */
+    async listByRun(runId) {
+        return (await this.opts.db.all(`SELECT * FROM ${this.t.outbox} WHERE run_id = ? ORDER BY next_at, id`, [runId])).map((r) => this.fromRow(r));
+    }
+}
+//# sourceMappingURL=sql.js.map

package/dist/io/channels/meetings/stores/sql.js.map

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

package/dist/io/voice-pipeline/LiveKitStreamTransport.d.ts

@@ -55,6 +55,8 @@ export interface LiveKitStreamTransportOptions {
      * least one sample at `sampleRate`; rtc-node's default when omitted.
      */
     frameSizeMs?: number;
+    /** While the consumer has asked for a pause, frames are held up to this much audio; beyond it the oldest are dropped and a `gap` is emitted on resume. Default 2000. */
+    bufferMs?: number;
     /** The `@livekit/rtc-node` module the host imports; imported on first use when omitted. */
     rtc?: LiveKitRtcModule;
 }
@@ -67,6 +69,7 @@ export interface LiveKitStreamTransportOptions {
  * | Event       | Payload                   | Description                                   |
  * |-------------|---------------------------|-----------------------------------------------|
  * | `'audio'`   | `AudioFrame`              | The participant's audio, mono Float32.        |
+ * | `'gap'`     | `{ droppedMs: number, reason: 'paused' }` | Audio dropped beyond the paused buffer, reported on resume before held frames. |
  * | `'message'` | {@link ClientTextMessage} | A JSON message from the participant on the topic. |
  * | `'close'`   | *(none)*                  | The transport closed (or the room disconnected). |
  * | `'error'`   | `Error`                   | A message that is not JSON, a text stream of the participant's that fails while it is read, or a failure to read audio (the peer missing among them). |
@@ -91,6 +94,11 @@ export declare class LiveKitStreamTransport extends EventEmitter implements IStr
     private _state;
     private readonly topic;
     private readonly source;
+    private paused;
+    private readonly held;
+    private heldMs;
+    private droppedMs;
+    private readonly bufferMs;
     /** The participant's text streams being read; {@link close} closes them. */
     private readonly readers;
     /**

package/dist/io/voice-pipeline/LiveKitStreamTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LiveKitStreamTransport.d.ts","sourceRoot":"","sources":["../../../src/io/voice-pipeline/LiveKitStreamTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,sCAAsC,CAAC;AAE9C,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAE/D,iDAAiD;AACjD,MAAM,WAAW,6BAA6B;IAC5C,2DAA2D;IAC3D,IAAI,EAAE,eAAe,CAAC;IACtB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,sBAAuB,SAAQ,YAAa,YAAW,gBAAgB;IActE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAbpC,QAAQ,CAAC,EAAE,sDAAgB;IAC3B,OAAO,CAAC,MAAM,CAAwD;IACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE;;;;;OAKG;gBAC0B,OAAO,EAAE,6BAA6B;IAgBnE,IAAI,KAAK,IAAI,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAExD;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAW7C,yEAAyE;YAC3D,IAAI;IAYlB,OAAO,CAAC,QAAQ,CAAC,MAAM,CA2BrB;IAEF;;;OAGG;IACH,OAAO,CAAC,aAAa;CAOtB"}
+{"version":3,"file":"LiveKitStreamTransport.d.ts","sourceRoot":"","sources":["../../../src/io/voice-pipeline/LiveKitStreamTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAEV,gBAAgB,EAChB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,sCAAsC,CAAC;AAE9C,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAE/D,iDAAiD;AACjD,MAAM,WAAW,6BAA6B;IAC5C,2DAA2D;IAC3D,IAAI,EAAE,eAAe,CAAC;IACtB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wKAAwK;IACxK,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,sBAAuB,SAAQ,YAAa,YAAW,gBAAgB;IAmBtE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAlBpC,QAAQ,CAAC,EAAE,sDAAgB;IAC3B,OAAO,CAAC,MAAM,CAAwD;IACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE;;;;;OAKG;gBAC0B,OAAO,EAAE,6BAA6B;IA6BnE,IAAI,KAAK,IAAI,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAExD;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAW7C,yEAAyE;YAC3D,IAAI;IAwBlB,OAAO,CAAC,QAAQ,CAAC,MAAM,CA2BrB;IAEF;;;OAGG;IACH,OAAO,CAAC,aAAa;CAOtB"}

package/dist/io/voice-pipeline/LiveKitStreamTransport.js

@@ -56,6 +56,7 @@ function closeTextReader(reader) {
  * | Event       | Payload                   | Description                                   |
  * |-------------|---------------------------|-----------------------------------------------|
  * | `'audio'`   | `AudioFrame`              | The participant's audio, mono Float32.        |
+ * | `'gap'`     | `{ droppedMs: number, reason: 'paused' }` | Audio dropped beyond the paused buffer, reported on resume before held frames. |
  * | `'message'` | {@link ClientTextMessage} | A JSON message from the participant on the topic. |
  * | `'close'`   | *(none)*                  | The transport closed (or the room disconnected). |
  * | `'error'`   | `Error`                   | A message that is not JSON, a text stream of the participant's that fails while it is read, or a failure to read audio (the peer missing among them). |
@@ -86,6 +87,10 @@ export class LiveKitStreamTransport extends EventEmitter {
         this.options = options;
         this.id = randomUUID();
         this._state = 'open';
+        this.paused = false;
+        this.held = [];
+        this.heldMs = 0;
+        this.droppedMs = 0;
         /** The participant's text streams being read; {@link close} closes them. */
         this.readers = new Set();
         this.onText = (reader, participant) => {
@@ -118,6 +123,20 @@ export class LiveKitStreamTransport extends EventEmitter {
             });
         };
         this.topic = options.topic ?? LIVEKIT_TRANSPORT_DEFAULT_TOPIC;
+        this.bufferMs = options.bufferMs ?? 2000;
+        this.on('pause', () => {
+            this.paused = true;
+        });
+        this.on('resume', () => {
+            this.paused = false;
+            if (this.droppedMs > 0) {
+                this.emit('gap', { droppedMs: this.droppedMs, reason: 'paused' });
+                this.droppedMs = 0;
+            }
+            for (const f of this.held.splice(0))
+                this.emit('audio', f);
+            this.heldMs = 0;
+        });
         // The source checks the options before the topic is taken, so a refused
         // option leaves the topic free; until it is read, the source holds nothing.
         this.source = new LiveKitRoomAudioSource({
@@ -184,7 +203,19 @@ export class LiveKitStreamTransport extends EventEmitter {
     async pump() {
         try {
             for await (const frame of this.source) {
-                this.emit('audio', frame);
+                if (!this.paused) {
+                    this.emit('audio', frame);
+                    continue;
+                }
+                const ms = (frame.samples.length / frame.sampleRate) * 1000;
+                this.held.push(frame);
+                this.heldMs += ms;
+                while (this.heldMs > this.bufferMs && this.held.length) {
+                    const old = this.held.shift();
+                    const oldMs = (old.samples.length / old.sampleRate) * 1000;
+                    this.heldMs -= oldMs;
+                    this.droppedMs += oldMs;
+                }
             }
         }
         catch (err) {