@framers/agentos 0.13.62 → 0.13.64

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

@@ -0,0 +1,273 @@
+import { CONTENT_EVENT_TYPES } from '../types.js';
+import { DuplicateIdempotencyKeyError, FencedError, nextAttemptAt, OUTBOX_GIVE_UP_MS, } from './types.js';
+/** The wall clock. */
+export class SystemClock {
+    now() {
+        return Date.now();
+    }
+}
+/** A clock a test sets and moves by hand. */
+export class FakeClock {
+    /** @param t - The starting time, in milliseconds. */
+    constructor(t) {
+        this.t = t;
+    }
+    now() {
+        return this.t;
+    }
+    /** Moves the clock forward by `ms`. */
+    advance(ms) {
+        this.t += ms;
+    }
+    /** Sets the clock to `t`. */
+    set(t) {
+        this.t = t;
+    }
+}
+/** Runs in memory, for tests and single-process hosts. Rows are copied in and out, so a caller never holds the stored row. */
+export class InMemoryRunStore {
+    constructor() {
+        this.runs = new Map();
+    }
+    async insert(run) {
+        if (this.runs.has(run.runId))
+            throw new Error(`run ${run.runId} exists`);
+        // one run per owner and key, with no await between the check and the write: of two sends racing with one key, the second insert fails and the sender finds the first
+        const key = run.idempotencyKey;
+        if (key !== undefined && [...this.runs.values()].some((r) => r.ownerRef === run.ownerRef && r.idempotencyKey === key)) {
+            throw new DuplicateIdempotencyKeyError(run.ownerRef, key);
+        }
+        this.runs.set(run.runId, structuredClone(run));
+    }
+    async get(runId) {
+        const r = this.runs.get(runId);
+        return r ? structuredClone(r) : undefined;
+    }
+    async update(runId, patch, expectState) {
+        const r = this.runs.get(runId);
+        if (!r)
+            return undefined;
+        if (expectState !== undefined) {
+            const allowed = Array.isArray(expectState) ? expectState : [expectState];
+            if (!allowed.includes(r.state))
+                return undefined;
+        }
+        Object.assign(r, structuredClone(patch));
+        return structuredClone(r);
+    }
+    async replace(run) {
+        this.runs.set(run.runId, structuredClone(run));
+    }
+    async list(filter) {
+        const out = [];
+        for (const r of this.runs.values()) {
+            if (filter.ownerRef !== undefined && r.ownerRef !== filter.ownerRef)
+                continue;
+            if (filter.states && !filter.states.includes(r.state))
+                continue;
+            if (filter.since !== undefined && r.requestedAt < filter.since)
+                continue;
+            out.push(structuredClone(r));
+        }
+        out.sort((a, b) => b.requestedAt - a.requestedAt);
+        return filter.limit ? out.slice(0, filter.limit) : out;
+    }
+    async findByIdempotencyKey(ownerRef, key) {
+        for (const r of this.runs.values())
+            if (r.ownerRef === ownerRef && r.idempotencyKey === key)
+                return structuredClone(r);
+        return undefined;
+    }
+}
+/** Dispatch jobs in memory, for tests and single-process hosts: its leases hold within one process. */
+export class InMemoryJobStore {
+    constructor() {
+        this.jobs = new Map();
+    }
+    async schedule(job) {
+        this.jobs.set(job.runId, { runId: job.runId, dispatchAt: job.dispatchAt, dispatched: false, cancelled: false });
+    }
+    async lease(holder, now, ttlMs) {
+        // no await between the read and the write below, so two takers in one process never hold one job
+        const due = [...this.jobs.values()]
+            .filter((j) => !j.cancelled && !j.dispatched && j.dispatchAt <= now && (j.leaseExpiresAt === undefined || j.leaseExpiresAt <= now))
+            .sort((a, b) => a.dispatchAt - b.dispatchAt);
+        const job = due[0];
+        if (!job)
+            return undefined;
+        job.leaseHolder = holder;
+        job.leaseExpiresAt = now + ttlMs;
+        return { ...job };
+    }
+    async renew(runId, holder, now, ttlMs) {
+        const job = this.jobs.get(runId);
+        if (!job || job.leaseHolder !== holder || job.leaseExpiresAt === undefined || job.leaseExpiresAt <= now)
+            return false;
+        job.leaseExpiresAt = now + ttlMs;
+        return true;
+    }
+    async markDispatched(runId, holder, workerId) {
+        const job = this.jobs.get(runId);
+        if (!job)
+            return { recorded: false, cancelled: false };
+        // a holder whose lease another holder took changes nothing: the new holder's dispatch is the job's
+        if (job.leaseHolder !== holder)
+            return { recorded: false, cancelled: job.cancelled };
+        job.dispatched = true;
+        job.workerId = workerId;
+        return { recorded: true, cancelled: job.cancelled };
+    }
+    async release(runId, holder, retryAt) {
+        const job = this.jobs.get(runId);
+        if (!job || job.leaseHolder !== holder)
+            return false;
+        job.leaseHolder = undefined;
+        job.leaseExpiresAt = undefined;
+        job.dispatchAt = retryAt;
+        return true;
+    }
+    async cancel(runId) {
+        const job = this.jobs.get(runId);
+        if (!job)
+            return 'missing';
+        if (job.dispatched)
+            return 'already_dispatched';
+        job.cancelled = true;
+        return 'cancelled';
+    }
+    async get(runId) {
+        const j = this.jobs.get(runId);
+        return j ? { ...j } : undefined;
+    }
+    async listDispatched() {
+        return [...this.jobs.values()].filter((j) => j.dispatched).map((j) => ({ ...j }));
+    }
+    async remove(runId) {
+        this.jobs.delete(runId);
+    }
+}
+/** Transcript turns in memory: for tests, single-process hosts and runs that are not kept. */
+export class InMemoryTranscriptStore {
+    constructor() {
+        this.turns = new Map();
+        this.fenced = new Set();
+    }
+    async append(turn) {
+        if (this.fenced.has(turn.runId))
+            throw new FencedError(turn.runId);
+        const list = this.turns.get(turn.runId) ?? [];
+        list.push({ ...turn });
+        this.turns.set(turn.runId, list);
+    }
+    async read(runId, fromSeq, limit = 500) {
+        return (this.turns.get(runId) ?? []).filter((t) => t.seq > fromSeq).slice(0, limit).map((t) => ({ ...t }));
+    }
+    async fence(runId) {
+        this.fenced.add(runId);
+    }
+    async isFenced(runId) {
+        return this.fenced.has(runId);
+    }
+    async purge(runId) {
+        this.turns.delete(runId);
+    }
+    /** Forgets a run whole, its turns and its fence, to free the memory of a run that is over. The manager does not call it: it removes a run's turns with `purge`, which keeps the fence. */
+    async drop(runId) {
+        this.turns.delete(runId);
+        this.fenced.delete(runId);
+    }
+}
+/**
+ * Events in memory, numbered per run and deduplicated by id: for tests, single-process hosts and runs that are not kept.
+ * Events are copied in and out, payloads included, so a caller never holds a stored event.
+ */
+export class InMemoryEventStore {
+    constructor() {
+        this.byRun = new Map();
+        this.byId = new Map();
+        this.fenced = new Set();
+    }
+    async append(event) {
+        const existing = this.byId.get(event.eventId);
+        if (existing)
+            return { inserted: false, seq: existing.seq };
+        const list = this.byRun.get(event.runId) ?? [];
+        const behindFence = this.fenced.has(event.runId) && CONTENT_EVENT_TYPES.has(event.type);
+        const stored = behindFence ? { ...event, data: undefined, purged: true, seq: list.length + 1 } : { ...structuredClone(event), seq: list.length + 1 };
+        list.push(stored);
+        this.byRun.set(event.runId, list);
+        this.byId.set(event.eventId, stored);
+        return { inserted: true, seq: stored.seq };
+    }
+    async fence(runId) {
+        this.fenced.add(runId);
+    }
+    async read(runId, fromSeq, limit = 500) {
+        return (this.byRun.get(runId) ?? []).filter((e) => e.seq > fromSeq).slice(0, limit).map((e) => structuredClone(e));
+    }
+    async purgePayloads(runId) {
+        for (const e of this.byRun.get(runId) ?? []) {
+            if (CONTENT_EVENT_TYPES.has(e.type)) {
+                delete e.data;
+                e.purged = true;
+            }
+        }
+    }
+}
+/** Outbound deliveries in memory, for tests and single-process hosts. */
+export class InMemoryOutbox {
+    constructor() {
+        this.deliveries = new Map();
+        /** The runs whose content was purged: the outbox's fence. */
+        this.purgedRuns = new Set();
+    }
+    async enqueue(d, now) {
+        // behind the purge nothing a person said or did is taken for delivery
+        if (this.purgedRuns.has(d.runId) && CONTENT_EVENT_TYPES.has(d.type))
+            return;
+        this.deliveries.set(d.id, { ...d, attempts: 0, nextAt: now, state: 'pending', purged: false });
+    }
+    async due(now, limit = 100) {
+        return [...this.deliveries.values()].filter((d) => d.state === 'pending' && d.nextAt <= now).slice(0, limit).map((d) => ({ ...d }));
+    }
+    async markDelivered(id) {
+        const d = this.deliveries.get(id);
+        if (d)
+            d.state = 'delivered';
+    }
+    async markFailed(id, now) {
+        const d = this.deliveries.get(id);
+        if (!d)
+            return;
+        d.attempts += 1;
+        d.firstAttemptAt ?? (d.firstAttemptAt = now);
+        if (now - d.firstAttemptAt >= OUTBOX_GIVE_UP_MS)
+            d.state = 'dead';
+        else
+            d.nextAt = nextAttemptAt(d.attempts, now);
+    }
+    async replay(id, now) {
+        const d = this.deliveries.get(id);
+        if (!d)
+            return;
+        d.state = 'pending';
+        d.attempts = 0;
+        d.firstAttemptAt = undefined;
+        d.nextAt = now;
+    }
+    async purgeContent(runId) {
+        this.purgedRuns.add(runId);
+        for (const d of this.deliveries.values()) {
+            // delivered rows too: a replay after the purge must send nothing of the content; a content-free delivery (`bot:done`) stays as it is
+            if (d.runId !== runId || !CONTENT_EVENT_TYPES.has(d.type))
+                continue;
+            d.payload = '';
+            d.type = 'bot:purged';
+            d.purged = true;
+        }
+    }
+    async listByRun(runId) {
+        return [...this.deliveries.values()].filter((d) => d.runId === runId).map((d) => ({ ...d }));
+    }
+}
+//# sourceMappingURL=memory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../../src/io/channels/meetings/stores/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAuF,MAAM,aAAa,CAAC;AACvI,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,aAAa,EACb,iBAAiB,GAUlB,MAAM,YAAY,CAAC;AAEpB,sBAAsB;AACtB,MAAM,OAAO,WAAW;IACtB,GAAG;QACD,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;CACF;AAED,6CAA6C;AAC7C,MAAM,OAAO,SAAS;IACpB,qDAAqD;IACrD,YAAoB,CAAS;QAAT,MAAC,GAAD,CAAC,CAAQ;IAAG,CAAC;IACjC,GAAG;QACD,OAAO,IAAI,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,uCAAuC;IACvC,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACf,CAAC;IACD,6BAA6B;IAC7B,GAAG,CAAC,CAAS;QACX,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF;AAED,8HAA8H;AAC9H,MAAM,OAAO,gBAAgB;IAA7B;QACmB,SAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IA0C9D,CAAC;IAzCC,KAAK,CAAC,MAAM,CAAC,GAAqB;QAChC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;QACzE,qKAAqK;QACrK,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC;QAC/B,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,cAAc,KAAK,GAAG,CAAC,EAAE,CAAC;YACtH,MAAM,IAAI,4BAA4B,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAgC,EAAE,WAA0D;QACtH,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAA8B,CAAC,CAAC;YAC5F,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;QACnD,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,GAAqB;QACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAiB;QAC1B,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;gBAAE,SAAS;YAC9E,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,SAAS;YAChE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK;gBAAE,SAAS;YACzE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACzD,CAAC;IACD,KAAK,CAAC,oBAAoB,CAAC,QAAgB,EAAE,GAAW;QACtD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,cAAc,KAAK,GAAG;gBAAE,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC;QACvH,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,uGAAuG;AACvG,MAAM,OAAO,gBAAgB;IAA7B;QACmB,SAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAuDxD,CAAC;IAtDC,KAAK,CAAC,QAAQ,CAAC,GAA0C;QACvD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,GAAW,EAAE,KAAa;QACpD,iGAAiG;QACjG,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aAChC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,cAAc,IAAI,GAAG,CAAC,CAAC;aAClI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC;QACzB,GAAG,CAAC,cAAc,GAAG,GAAG,GAAG,KAAK,CAAC;QACjC,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;IACpB,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc,EAAE,GAAW,EAAE,KAAa;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,GAAG,CAAC,cAAc,IAAI,GAAG;YAAE,OAAO,KAAK,CAAC;QACtH,GAAG,CAAC,cAAc,GAAG,GAAG,GAAG,KAAK,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,MAAc,EAAE,QAA4B;QAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACvD,mGAAmG;QACnG,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;QACrF,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;QACtB,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACxB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;IACtD,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,MAAc,EAAE,OAAe;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QACrD,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC;QAC5B,GAAG,CAAC,cAAc,GAAG,SAAS,CAAC;QAC/B,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,IAAI,GAAG,CAAC,UAAU;YAAE,OAAO,oBAAoB,CAAC;QAChD,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;QACrB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAClC,CAAC;IACD,KAAK,CAAC,cAAc;QAClB,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,8FAA8F;AAC9F,MAAM,OAAO,uBAAuB;IAApC;QACmB,UAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;QAC5C,WAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAwB9C,CAAC;IAvBC,KAAK,CAAC,MAAM,CAAC,IAAoB;QAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,OAAe,EAAE,KAAK,GAAG,GAAG;QACpD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7G,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,0LAA0L;IAC1L,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAA/B;QACmB,UAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;QAC1C,SAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;QACvC,WAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IA0B9C,CAAC;IAzBC,KAAK,CAAC,MAAM,CAAC,KAAgC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,QAAQ;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxF,MAAM,MAAM,GAAiB,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;IAC7C,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,OAAe,EAAE,KAAK,GAAG,GAAG;QACpD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IACrH,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,KAAa;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5C,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,CAAC,IAAI,CAAC;gBACd,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,yEAAyE;AACzE,MAAM,OAAO,cAAc;IAA3B;QACmB,eAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;QAChE,6DAA6D;QAC5C,eAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IA0ClD,CAAC;IAzCC,KAAK,CAAC,OAAO,CAAC,CAA2F,EAAE,GAAW;QACpH,sEAAsE;QACtE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO;QAC5E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAK,GAAG,GAAG;QAChC,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACtI,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,EAAU;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC;YAAE,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC;IAC/B,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,GAAW;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,cAAc,KAAhB,CAAC,CAAC,cAAc,GAAK,GAAG,EAAC;QACzB,IAAI,GAAG,GAAG,CAAC,CAAC,cAAc,IAAI,iBAAiB;YAAE,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC;;YAC7D,CAAC,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,GAAW;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QACf,CAAC,CAAC,cAAc,GAAG,SAAS,CAAC;QAC7B,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,qIAAqI;YACrI,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YACpE,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC;YACf,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC;YACtB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/F,CAAC;CACF"}

package/dist/io/channels/meetings/stores/types.d.ts

@@ -0,0 +1,224 @@
+import type { MeetingEvent, MeetingEventType, MeetingPlatform, MeetingRunRecord, MeetingRunState, TranscriptTurn } from '../types.js';
+/** Thrown by a store that refuses content for a run behind the fence. */
+export declare class FencedError extends Error {
+    readonly runId: string;
+    /** @param runId - The run whose content was refused. */
+    constructor(runId: string);
+}
+/** Thrown by {@link IRunStore.insert} when the owner already has a run with the idempotency key: a send that loses that race answers the run the key has ({@link IRunStore.findByIdempotencyKey}). */
+export declare class DuplicateIdempotencyKeyError extends Error {
+    readonly ownerRef: string;
+    readonly idempotencyKey: string;
+    /**
+     * @param ownerRef - The owner the key belongs to.
+     * @param idempotencyKey - The key the owner already has a run with.
+     */
+    constructor(ownerRef: string, idempotencyKey: string);
+}
+/** Which runs {@link IRunStore.list} returns: every condition given holds. */
+export interface RunFilter {
+    /** Only this owner's runs. */
+    ownerRef?: string;
+    /** Only runs in one of these states. */
+    states?: readonly MeetingRunState[];
+    /** Only runs requested at or after this time, in milliseconds. */
+    since?: number;
+    /** At most this many runs. */
+    limit?: number;
+}
+/** The run's row. An implementation seals `meetingUrl` at rest. */
+export interface IRunStore {
+    /**
+     * Adds a new run. A run id that exists is an error, and so is an idempotency key the owner already used: that insert
+     * stores nothing and rejects with {@link DuplicateIdempotencyKeyError}, so of two sends racing with one key only one run
+     * is made, and the other finds it with `findByIdempotencyKey`.
+     */
+    insert(run: MeetingRunRecord): Promise<void>;
+    /** The run, or undefined when there is none. */
+    get(runId: string): Promise<MeetingRunRecord | undefined>;
+    /** Applies the patch when the run is in one of `expectState` (any state when absent); returns the row after, or undefined when the state did not match. */
+    update(runId: string, patch: Partial<MeetingRunRecord>, expectState?: MeetingRunState | readonly MeetingRunState[]): Promise<MeetingRunRecord | undefined>;
+    /** Rewrites the whole row (the content-free form at the end of a purge). */
+    replace(run: MeetingRunRecord): Promise<void>;
+    /** The runs the filter selects, newest first. */
+    list(filter: RunFilter): Promise<MeetingRunRecord[]>;
+    /** The run an owner sent with this idempotency key, if there is one (there is at most one: see `insert`). */
+    findByIdempotencyKey(ownerRef: string, key: string): Promise<MeetingRunRecord | undefined>;
+}
+/** A run's dispatch job: when it is due, who holds its lease, and whether it was dispatched or cancelled. */
+export interface MeetingJob {
+    /** The run the job dispatches. */
+    runId: string;
+    /** When the job is due, in milliseconds. */
+    dispatchAt: number;
+    /** The manager instance holding the dispatch lease. */
+    leaseHolder?: string;
+    /** When the lease runs out, in milliseconds. */
+    leaseExpiresAt?: number;
+    /** The worker the provider dispatched to. */
+    workerId?: string;
+    /** Set when the dispatch was recorded. */
+    dispatched: boolean;
+    /** Set by a cancel. A cancelled job is never leased. */
+    cancelled: boolean;
+}
+/** Delayed dispatch with leases. `lease` is atomic: two takers never hold one job. */
+export interface IJobStore {
+    /** Adds the run's job, due at `dispatchAt`. */
+    schedule(job: {
+        runId: string;
+        dispatchAt: number;
+    }): Promise<void>;
+    /** The next due, uncancelled, undispatched job whose lease is absent or expired, leased to `holder` until `now + ttlMs`. */
+    lease(holder: string, now: number, ttlMs: number): Promise<MeetingJob | undefined>;
+    /** Extends a lease the holder still holds; false when it expired or another holder took it, and then the holder must stop. */
+    renew(runId: string, holder: string, now: number, ttlMs: number): Promise<boolean>;
+    /**
+     * Records the dispatch for the lease's holder and answers whether a cancel arrived meanwhile (then the dispatcher tells
+     * the bot to leave at once). A dispatch can outlive its lease and another holder can take the job: when `holder` no
+     * longer holds the lease, or the job is gone, nothing is recorded and `recorded` is false.
+     */
+    markDispatched(runId: string, holder: string, workerId: string | undefined): Promise<{
+        recorded: boolean;
+        cancelled: boolean;
+    }>;
+    /**
+     * Releases the holder's lease without dispatching (the dispatch failed and will be retried), moving the job's due time
+     * to `retryAt`. False, and nothing changes, when `holder` no longer holds the lease or the job is gone.
+     */
+    release(runId: string, holder: string, retryAt: number): Promise<boolean>;
+    /** Marks the job cancelled. `already_dispatched` when the bot is out: the caller tells it to leave instead. A job under a live lease is cancelled too, and its dispatcher learns it from `markDispatched`. */
+    cancel(runId: string): Promise<'cancelled' | 'already_dispatched' | 'missing'>;
+    /** The run's job, or undefined when there is none. */
+    get(runId: string): Promise<MeetingJob | undefined>;
+    /** Every dispatched job: what reconciliation compares with the providers' usage. */
+    listDispatched(): Promise<MeetingJob[]>;
+    /** Deletes the run's job. */
+    remove(runId: string): Promise<void>;
+}
+/** A run's transcript turns. Behind the fence it refuses new turns; a purge removes the turns and keeps the fence. */
+export interface ITranscriptStore {
+    /** Adds a turn; rejects with {@link FencedError} once the run is fenced. */
+    append(turn: TranscriptTurn): Promise<void>;
+    /** The run's turns after `fromSeq`, in order, at most `limit` of them. */
+    read(runId: string, fromSeq: number, limit?: number): Promise<TranscriptTurn[]>;
+    /** The fence: from now on the run takes no new turn. */
+    fence(runId: string): Promise<void>;
+    /** Whether the run is fenced. */
+    isFenced(runId: string): Promise<boolean>;
+    /** Removes the run's turns; the fence stays. */
+    purge(runId: string): Promise<void>;
+}
+/** A run's events: stable ids, a sequence number per run, and payloads a purge removes. */
+export interface IEventStore {
+    /** Inserts with the next sequence number of the run; a repeated `eventId` is not inserted and answers the existing sequence. Behind the fence a content event is stored without its payload, marked `purged`. */
+    append(event: Omit<MeetingEvent, 'seq'>): Promise<{
+        inserted: boolean;
+        seq: number;
+    }>;
+    /** The run's events after `fromSeq`, in sequence order, at most `limit` of them. */
+    read(runId: string, fromSeq: number, limit?: number): Promise<MeetingEvent[]>;
+    /** The fence: from now on no payload of a content event is stored for the run. */
+    fence(runId: string): Promise<void>;
+    /** Removes the payload of every content event of the run; type, time and sequence stay. */
+    purgePayloads(runId: string): Promise<void>;
+}
+/** One event's delivery to one destination. */
+export interface OutboxDelivery {
+    /** The delivery's id. */
+    id: string;
+    /** The run the event belongs to. */
+    runId: string;
+    /** The product's reference for where it goes (a webhook registration). */
+    destinationRef: string;
+    /** The event the delivery carries. */
+    eventId: string;
+    /** The event's type; `bot:purged` once a purge emptied the delivery. */
+    type: MeetingEventType;
+    /** The body to send; empty once a purge emptied the delivery. */
+    payload: string;
+    /** The failed attempts so far. */
+    attempts: number;
+    /** When the first failed attempt was recorded; a delivery still failing a day later is given up. */
+    firstAttemptAt?: number;
+    /** When the next attempt is due. */
+    nextAt: number;
+    /** `pending` until the destination takes it, or until it is given up as `dead`. */
+    state: 'pending' | 'delivered' | 'dead';
+    /** Set when a purge emptied the delivery. */
+    purged: boolean;
+}
+/** Outbound deliveries: retried with backoff for a day, replayable, content-free after a purge. */
+export interface IOutbox {
+    /**
+     * Adds a pending delivery, due at `now`. After `purgeContent` for the run, a delivery of a content event (a type in
+     * `CONTENT_EVENT_TYPES`) is not stored: the purge is the outbox's fence. A delivery of any other type (`bot:left`,
+     * `bot:purged`, `bot:done` and the rest) is stored.
+     */
+    enqueue(delivery: Pick<OutboxDelivery, 'id' | 'runId' | 'destinationRef' | 'eventId' | 'type' | 'payload'>, now: number): Promise<void>;
+    /** The pending deliveries due at `now`, at most `limit` of them. */
+    due(now: number, limit?: number): Promise<OutboxDelivery[]>;
+    /** Records that the destination took the delivery. */
+    markDelivered(id: string): Promise<void>;
+    /** Records a failed attempt: due again after the backoff of {@link nextAttemptAt}, or `dead` a day after the first failed attempt. */
+    markFailed(id: string, now: number): Promise<void>;
+    /** Makes a delivery pending again, due at `now`, with its attempts counted afresh (a manual replay). */
+    replay(id: string, now: number): Promise<void>;
+    /**
+     * Empties every content delivery of the run (a type in `CONTENT_EVENT_TYPES`), delivered ones included, so a replay
+     * after a purge sends the content-free `bot:purged` in its place. A delivery of any other type (`bot:done`,
+     * `bot:left` and the rest) carries no content and keeps its type and payload. From then on the run takes no content
+     * delivery (see `enqueue`).
+     */
+    purgeContent(runId: string): Promise<void>;
+    /** Every delivery of the run, whatever its state. */
+    listByRun(runId: string): Promise<OutboxDelivery[]>;
+}
+/** A reservation's answer: its id and the seconds it covers, or why it was refused. */
+export type ReserveResult = {
+    ok: true;
+    reservationId: string;
+    maxSeconds: number;
+} | {
+    ok: false;
+    reason: 'allowance' | 'permission_denied';
+    message: string;
+};
+/**
+ * The product's billing. The library reserves before a run exists, meters every minute, settles at the end, releases an
+ * unbilled run. `settle` and `release` are idempotent per reservation: the manager retries them until they resolve, and a
+ * repeated call after a success changes nothing.
+ */
+export interface IEntitlementHook {
+    /** Reserves at most `maxSeconds` for a run about to be made; the answer's `maxSeconds` is what it covers, and the run's limit is cut to it. A refusal sends no bot. */
+    reserve(input: {
+        ownerRef: string;
+        runId: string;
+        platform: MeetingPlatform;
+        maxSeconds: number;
+    }): Promise<ReserveResult>;
+    /** A scheduled run, at dispatch: still paid, still has the hours. */
+    revalidate(reservationId: string): Promise<boolean>;
+    /** The seconds the run has used so far, every minute: a running total, not an increment. */
+    meter(reservationId: string, seconds: number): Promise<void>;
+    /** Settles the run at the seconds it is billed. */
+    settle(reservationId: string, billedSeconds: number): Promise<void>;
+    /** Frees a reservation nothing is billed against: a run that ends unbilled, or a send refused after its reservation. */
+    release(reservationId: string): Promise<void>;
+}
+/** The manager's clock; a test passes a fake. */
+export interface IClock {
+    /** The current time, in milliseconds. */
+    now(): number;
+}
+/**
+ * Backoff: 5 s, 10 s, 20 s ... up to an hour between attempts, dead a day after the first attempt.
+ *
+ * @param attempts - The failed attempts so far, the one just recorded included.
+ * @param now - When that failure was recorded, in milliseconds.
+ * @returns When the next attempt is due.
+ */
+export declare function nextAttemptAt(attempts: number, now: number): number;
+/** How long after its first failed attempt a delivery is given up as `dead`: a day. */
+export declare const OUTBOX_GIVE_UP_MS = 86400000;
+//# sourceMappingURL=types.d.ts.map

package/dist/io/channels/meetings/stores/types.d.ts.map

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

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

@@ -0,0 +1,35 @@
+/** Thrown by a store that refuses content for a run behind the fence. */
+export class FencedError extends Error {
+    /** @param runId - The run whose content was refused. */
+    constructor(runId) {
+        super(`run ${runId} is being purged; no content is accepted`);
+        this.runId = runId;
+        this.name = 'FencedError';
+    }
+}
+/** Thrown by {@link IRunStore.insert} when the owner already has a run with the idempotency key: a send that loses that race answers the run the key has ({@link IRunStore.findByIdempotencyKey}). */
+export class DuplicateIdempotencyKeyError extends Error {
+    /**
+     * @param ownerRef - The owner the key belongs to.
+     * @param idempotencyKey - The key the owner already has a run with.
+     */
+    constructor(ownerRef, idempotencyKey) {
+        super(`the owner already has a run with idempotency key ${idempotencyKey}`);
+        this.ownerRef = ownerRef;
+        this.idempotencyKey = idempotencyKey;
+        this.name = 'DuplicateIdempotencyKeyError';
+    }
+}
+/**
+ * Backoff: 5 s, 10 s, 20 s ... up to an hour between attempts, dead a day after the first attempt.
+ *
+ * @param attempts - The failed attempts so far, the one just recorded included.
+ * @param now - When that failure was recorded, in milliseconds.
+ * @returns When the next attempt is due.
+ */
+export function nextAttemptAt(attempts, now) {
+    return now + Math.min(5000 * 2 ** Math.max(0, attempts - 1), 3600000);
+}
+/** How long after its first failed attempt a delivery is given up as `dead`: a day. */
+export const OUTBOX_GIVE_UP_MS = 86400000;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/io/channels/meetings/stores/types.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,wDAAwD;IACxD,YAAqB,KAAa;QAChC,KAAK,CAAC,OAAO,KAAK,0CAA0C,CAAC,CAAC;QAD3C,UAAK,GAAL,KAAK,CAAQ;QAEhC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,sMAAsM;AACtM,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD;;;OAGG;IACH,YAAqB,QAAgB,EAAW,cAAsB;QACpE,KAAK,CAAC,oDAAoD,cAAc,EAAE,CAAC,CAAC;QADzD,aAAQ,GAAR,QAAQ,CAAQ;QAAW,mBAAc,GAAd,cAAc,CAAQ;QAEpE,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AA6LD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,GAAW;IACzD,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAK,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,EAAE,OAAS,CAAC,CAAC;AAC3E,CAAC;AACD,uFAAuF;AACvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAU,CAAC"}