hci-atrium 0.1.0

package/dist/rooms/standing-source.js

@@ -0,0 +1,431 @@
+/**
+ * The shared harness for the two peer-toggleable standing offers (``offerTranscription`` /
+ * ``offerAudioCapture``) — the TypeScript port of Python's ``_StandingSource`` (aio.py). Everything
+ * the multi-mic scoping needs that isn't specific to *what* a source's frames do (transcribe vs
+ * record):
+ *
+ * * the {@link ArmedSet} and the ``maxSources`` cap admission ({@link StandingSource.tryArm}) plus
+ *   warn-once cap logging;
+ * * the ``active`` roster + {@link StandingSource.status}, built on the **armed set** (not on audio
+ *   flow — a source appears the moment it is armed; an all-arm enumerates every currently-connected
+ *   ``capture-source`` from the presence roster, kept current on join/leave);
+ * * broadcast dedup + fire-and-forget spawn, over the REST ``/signal`` POST (the WS inbound path
+ *   forces ``ephemeral: false``, so an ephemeral ``*.available`` broadcast must ride REST);
+ * * the departed-source grace bookkeeping and the **single** periodic sweeper (one timer — not a
+ *   timer per departure) that finalizes/expires grace;
+ * * arm **migration** on a same-name reconnect so a per-source-armed device that drops and returns
+ *   within grace stays admitted;
+ * * the generic scoped ``start`` / ``stopRequest`` shells, dispatching to per-offer hooks.
+ *
+ * Subclasses provide ``signal`` / ``logName`` / ``identityPrefix`` and override the hooks:
+ * {@link StandingSource.run}, {@link StandingSource.stop}, {@link StandingSource.stopSource},
+ * {@link StandingSource.beforeArm}, {@link StandingSource.onEngage}, {@link StandingSource.activeExtra},
+ * {@link StandingSource.onPresenceSource}, {@link StandingSource.onGraceExpired}.
+ */
+import { ArmedSet } from "./armed-set.js";
+import { mergeRoles } from "./participant.js";
+import { randomId } from "./room.js";
+import { AUDIO_SNIPPET_CONSUMER_ROLE, CAPTURE_SOURCE_ROLE } from "./snippet.js";
+import { RoomSocket } from "./transport.js";
+/** Max clips buffered per source before an offered transcription's demux drops the *oldest* (live
+ * captions favour recency; a stalled engine must not grow memory without bound). */
+export const OFFER_CLIP_QUEUE_MAX = 8;
+/** Safety bound on the pre-demux frame queue — only BINARY frames are dropped (oldest-first) past
+ * this; control/presence/end frames are never dropped (they carry roster + teardown state). Generous
+ * because the demux normally drains it at once; it exists to cap a pathological producer flood. */
+export const OFFER_EVENT_QUEUE_MAX = 256;
+/** Consecutive failed recording-creates for one capture source before it is dropped. */
+export const CAPTURE_CREATE_MAX_FAILURES = 3;
+/** Default cap on concurrently-active sources per offer (multi-mic safety). */
+export const OFFER_MAX_SOURCES = 8;
+/** Grace window (seconds) an offered-capture recording stays open after its source departs, so a
+ * same-name reconnect within it resumes the very same file. Elapsed with no return → it finalizes. */
+export const SOURCE_GRACE_SECONDS = 120;
+/** How often the single grace sweeper wakes to scan departure timestamps (coarse — grace is minutes). */
+export const GRACE_SWEEP_SECONDS = 5;
+/** A minimal async mutex — serializes state transitions (start / stop / grace-finalize / disengage),
+ * the port of the offers' ``asyncio.Lock``. */
+export class Mutex {
+    tail = Promise.resolve();
+    run(fn) {
+        const result = this.tail.then(fn);
+        this.tail = result.then(() => { }, () => { });
+        return result;
+    }
+}
+// A monotonic clock in ms — the mirror of Python's ``time.monotonic()`` (the grace machinery's clock).
+// Sub-millisecond resolution (unlike ``Date.now()``'s integer ms), so ``now - left`` is > 0 the instant
+// after a departure even with grace 0 (an integer-ms clock could read equal in the same tick and never
+// expire the source), and it's immune to wall-clock/NTP jumps. All grace timestamps use THIS, never
+// ``Date.now()``, so the comparisons stay consistent.
+function monotonicMs() {
+    const perf = globalThis.performance;
+    return perf?.now ? perf.now() : Date.now();
+}
+function announcedName(announce) {
+    const name = announce?.name;
+    return typeof name === "string" ? name : null;
+}
+function announcedRoles(announce) {
+    return mergeRoles(announce ?? {});
+}
+export class StandingSource {
+    signal = "standing.available";
+    logName = "standing offer";
+    identityPrefix = "standing-offer";
+    deps;
+    maxSources;
+    armed = new ArmedSet();
+    lock = new Mutex();
+    /** Grace window (seconds) — a per-instance override of {@link SOURCE_GRACE_SECONDS} (tests set 0). */
+    graceSeconds = SOURCE_GRACE_SECONDS;
+    /** Sweeper interval (seconds) — overridable for tests. */
+    sweepSeconds = GRACE_SWEEP_SECONDS;
+    ws = null;
+    runPromise = null;
+    settled = false;
+    err = null;
+    /** Set when the offer wound down because the room rotated its connect code (a controlled end, not
+     * an error — {@link error} stays ``null``). */
+    stoppedReason = null;
+    /** True once the frame stream ended via a ``room.code_rotated`` advance-signal / close. */
+    codeRotated = false;
+    /** Connection ids refused admission by the source cap — warned once each. */
+    cappedWarned = new Set();
+    /** Background broadcast promises spun off the (sync) presence hook — settled at teardown. */
+    bg = [];
+    /** The last ``(available, active)`` broadcast — dedupes the ``*.available`` signal. */
+    lastBroadcast = null;
+    /** connection id → last-known announced name, kept across a leave for the grace window. */
+    sourceNames = new Map();
+    /** departed connection id → leave time (ms) — the grace window a same-name return resumes within. */
+    departed = new Map();
+    /** The offer's OWN point-in-time roster (name + roles), seeded from the ready snapshot and folded
+     * in loop order by {@link onPresence} — the port of ``RoomWebSocket``'s own ``_names`` / ``_roles``.
+     * Read (not the transport's live roster) so a burst of presence + binary resolves each frame's
+     * source against the roster *as it was when that frame was processed*. */
+    roster = new Map();
+    rosterSeeded = false;
+    eventQueue = [];
+    // Count of BINARY frames currently in eventQueue — the drop-oldest bound is on binary only.
+    binaryQueued = 0;
+    eventWake = null;
+    sweepTimer = null;
+    constructor(deps, maxSources = OFFER_MAX_SOURCES) {
+        this.deps = deps;
+        this.maxSources = maxSources;
+    }
+    // --- state ---------------------------------------------------------------------------------------
+    /** True while the offer is engaged (the snippet subscription loop runs). */
+    get alive() {
+        return this.runPromise !== null && !this.settled;
+    }
+    /** The error that ended the offer for good (``null`` while armed or after ``stop()``). */
+    get error() {
+        return this.err;
+    }
+    /** Availability as it rides ``<service>.status`` / ``<service>.available``. The default
+     * (transcription) is available unless the loop died on a terminal error; capture overrides to also
+     * require an active recorder. */
+    available() {
+        return !(this.err !== null && !this.alive);
+    }
+    isDeparted(cid) {
+        const left = this.departed.get(cid);
+        return left !== undefined && monotonicMs() - left <= this.graceSeconds * 1000;
+    }
+    // --- the active roster (the ARMED set, not the audio-flow set) -----------------------------------
+    nameFor(cid) {
+        return this.roster.get(cid)?.name ?? null;
+    }
+    connectionIdsWithRole(role) {
+        const out = [];
+        for (const [cid, entry] of this.roster)
+            if (entry.roles.includes(role))
+                out.push(cid);
+        return out;
+    }
+    armedActive() {
+        const ids = new Set([...this.armed.explicit].filter((c) => !this.isDeparted(c)));
+        if (this.armed.allArmed && this.ws) {
+            for (const cid of this.connectionIdsWithRole(CAPTURE_SOURCE_ROLE)) {
+                if (this.armed.isArmed(cid))
+                    ids.add(cid);
+            }
+        }
+        return [...ids].sort().map((cid) => ({
+            source: cid,
+            name: this.nameFor(cid) ?? this.sourceNames.get(cid) ?? null,
+        }));
+    }
+    /** Per-offer additions to the armed roster (the honesty entry for a v1 id-less source). */
+    activeExtra() {
+        return [];
+    }
+    active() {
+        return [...this.armedActive(), ...this.activeExtra()];
+    }
+    /** The ``<service>.status`` reply payload (sans the outer ``ok``). */
+    status() {
+        return { available: this.available(), active: this.active() };
+    }
+    // --- broadcast -----------------------------------------------------------------------------------
+    async broadcast() {
+        const available = this.available();
+        const active = this.active();
+        const snapshot = JSON.stringify([available, active.map((a) => [a.source, a.name])]);
+        if (snapshot === this.lastBroadcast)
+            return;
+        this.lastBroadcast = snapshot;
+        try {
+            await this.deps.publishSignal(this.signal, { available, active }, { ephemeral: true });
+        }
+        catch {
+            // best-effort — a teardown broadcast may race the transport
+        }
+    }
+    clearLastBroadcast() {
+        this.lastBroadcast = null;
+    }
+    spawnBroadcast() {
+        this.bg.push(this.broadcast());
+    }
+    // --- cap admission -------------------------------------------------------------------------------
+    tryArm(source, armAll) {
+        if (!armAll &&
+            source !== null &&
+            !this.armed.explicit.has(source) &&
+            this.armed.explicit.size >= this.maxSources) {
+            throw new Error(`too many active sources (max ${this.maxSources})`);
+        }
+        if (armAll || source === null)
+            this.armed.armAll();
+        else
+            this.armed.arm(source);
+    }
+    warnCapped(cid) {
+        if (this.cappedWarned.has(cid))
+            return;
+        this.cappedWarned.add(cid);
+        console.warn(`Atrium ${this.logName} for room ${this.deps.roomId}: too many active sources ` +
+            `(max ${this.maxSources}) — dropping frames from ${JSON.stringify(cid)}`);
+    }
+    // --- the shared WS setup + grace sweeper ---------------------------------------------------------
+    /** Open the snippet-subscription WebSocket, seed the departed-name roster, and launch the single
+     * grace sweeper. Each ``run`` calls this at its top. */
+    async openWs() {
+        const socket = new RoomSocket({
+            roomId: this.deps.roomId,
+            code: this.deps.getCode(),
+            baseUrl: this.deps.baseUrl,
+            identity: `${this.identityPrefix}:${randomId().slice(0, 8)}`,
+            announce: { role: AUDIO_SNIPPET_CONSUMER_ROLE },
+            reconnect: this.deps.reconnect,
+            WebSocketCtor: this.deps.WebSocketCtor,
+            // Seed the offer's own roster from the ready snapshot (fires during the ``ready`` message,
+            // before any later frame) — so a synchronous burst can't move the transport's roster ahead of
+            // this seed. Folding thereafter is the loop's job (below).
+            onReady: () => this.seedRoster(socket),
+            onBinary: (data) => this.pushEvent({ kind: "binary", data }),
+            onSignal: (sig) => this.foldPresence(sig),
+            onEnd: (reason) => {
+                if (reason === "code-rotated")
+                    this.codeRotated = true;
+                this.pushEvent({ kind: "end" });
+            },
+        });
+        this.ws = socket;
+        await socket.connect();
+        this.startSweeper();
+        return socket;
+    }
+    seedRoster(socket) {
+        if (this.rosterSeeded)
+            return;
+        this.rosterSeeded = true;
+        for (const p of socket.participants()) {
+            this.roster.set(p.connectionId, {
+                name: announcedName(p.announce),
+                roles: announcedRoles(p.announce),
+            });
+            this.sourceNames.set(p.connectionId, announcedName(p.announce));
+        }
+    }
+    foldPresence(sig) {
+        const payload = sig.payload;
+        const cid = payload?.connection_id;
+        if (typeof cid !== "string")
+            return;
+        if (sig.type === "presence.join") {
+            this.pushEvent({
+                kind: "presence",
+                event: "join",
+                cid,
+                announce: payload?.announce,
+            });
+        }
+        else if (sig.type === "presence.leave") {
+            this.pushEvent({ kind: "presence", event: "leave", cid });
+        }
+    }
+    pushEvent(ev) {
+        if (ev.kind === "binary") {
+            if (this.binaryQueued >= OFFER_EVENT_QUEUE_MAX) {
+                // Drop the OLDEST binary frame (recency over completeness) — never a control/presence/end
+                // frame (those carry roster + teardown state the loop must see).
+                const idx = this.eventQueue.findIndex((e) => e.kind === "binary");
+                if (idx >= 0) {
+                    this.eventQueue.splice(idx, 1);
+                    this.binaryQueued -= 1;
+                }
+            }
+            this.binaryQueued += 1;
+        }
+        this.eventQueue.push(ev);
+        this.eventWake?.();
+        this.eventWake = null;
+    }
+    /** Yield the snippet-consumer socket's binary frames while folding ``presence.join`` /
+     * ``presence.leave`` into the live roster + arm migration (the port of Python's
+     * ``RoomWebSocket.frames(on_presence=...)``). Ends when the socket ends. */
+    async *frames() {
+        while (true) {
+            while (this.eventQueue.length > 0) {
+                const item = this.eventQueue.shift();
+                if (item.kind === "binary") {
+                    this.binaryQueued -= 1;
+                    yield item.data;
+                }
+                else if (item.kind === "presence") {
+                    this.onPresence(item.event, item.cid, item.event === "join" ? item.announce : undefined);
+                }
+                else
+                    return; // end sentinel
+            }
+            await new Promise((resolve) => {
+                this.eventWake = resolve;
+            });
+        }
+    }
+    startSweeper() {
+        if (this.sweepTimer !== null)
+            return;
+        this.sweepTimer = setInterval(() => void this.sweepOnce(), this.sweepSeconds * 1000);
+        this.sweepTimer.unref?.();
+    }
+    stopSweeper() {
+        if (this.sweepTimer !== null) {
+            clearInterval(this.sweepTimer);
+            this.sweepTimer = null;
+        }
+    }
+    /** One grace pass: finalize/expire each source whose grace window elapsed with no return. Public
+     * so a test can drive a pass directly (mirror of Python's ``_sweep_once``). */
+    async sweepOnce() {
+        const now = monotonicMs();
+        const graceMs = this.graceSeconds * 1000;
+        const expired = [...this.departed]
+            .filter(([, left]) => now - left > graceMs)
+            .map(([cid]) => cid);
+        for (const cid of expired) {
+            await this.onGraceExpired(cid);
+            this.departed.delete(cid);
+            this.sourceNames.delete(cid);
+            this.armed.explicit.delete(cid); // a departed per-source arm that never came back
+        }
+        if (expired.length > 0)
+            await this.broadcast();
+    }
+    /** Per-offer grace-expiry action (capture finalizes the departed recording; default: none). */
+    async onGraceExpired(_cid) {
+        return;
+    }
+    // --- the presence hook (name tracking + arm migration + re-broadcast) ----------------------------
+    onPresence(event, cid, announce) {
+        if (event === "join") {
+            const name = announcedName(announce);
+            this.roster.set(cid, { name, roles: announcedRoles(announce) });
+            this.sourceNames.set(cid, name);
+            this.migrateArmOnRejoin(cid, name);
+            this.departed.delete(cid); // a same-id return is live again
+        }
+        else {
+            // Drop the roster entry (so an all-arm stops enumerating it) but keep sourceNames for the grace
+            // window — a departed source still resolves a human label + arm-migration match.
+            this.roster.delete(cid);
+            this.departed.set(cid, monotonicMs());
+        }
+        this.cappedWarned.delete(cid);
+        this.onPresenceSource(event, cid);
+        this.spawnBroadcast();
+    }
+    migrateArmOnRejoin(newCid, name) {
+        if (!name)
+            return;
+        for (const oldCid of [...this.armed.explicit]) {
+            if (oldCid === newCid)
+                continue;
+            if (this.isDeparted(oldCid) && this.sourceNames.get(oldCid) === name) {
+                this.armed.migrate(oldCid, newCid);
+                return;
+            }
+        }
+    }
+    /** Per-offer presence bookkeeping (transcription reaps the source's engine on leave; capture
+     * leans on the shared grace machinery, so it's a no-op). Default: none. */
+    onPresenceSource(_event, _cid) {
+        return;
+    }
+    // --- the generic scoped start / stop shells ------------------------------------------------------
+    /** Arm a source (idempotent) and launch the frame loop on the first arm. Scoped to ``source``
+     * unless ``all`` (or an unscoped ``source=null`` — the v1 rule). Refuses a new per-source arm past
+     * the cap; a per-offer {@link beforeArm} may refuse for another reason (capture: no recorder).
+     * Broadcasts the armed-set change immediately, so a device sees itself active before a frame. */
+    async start({ source = null, all = false, } = {}) {
+        await this.lock.run(async () => {
+            // Refuse before arming/engaging if the handle is SSE-latched — binary audio can't ride SSE, so
+            // opening the snippet socket would spin a doomed WS reconnect. The `<service>.start` handler
+            // turns this into a clean `{ error }` reply (like the "no active recorder" refusal).
+            this.deps.requireWsAudio?.();
+            const ctx = await this.beforeArm(all);
+            this.tryArm(source, all);
+            if (this.runPromise === null || this.settled) {
+                this.onEngage(ctx);
+                this.err = null;
+                this.settled = false;
+                this.runPromise = this.run().finally(() => {
+                    this.settled = true;
+                });
+            }
+        });
+        await this.broadcast();
+    }
+    /** Per-offer pre-arm check, returning a context passed to {@link onEngage} on first launch. */
+    async beforeArm(_armAll) {
+        return null;
+    }
+    /** Per-offer first-launch setup under the lock (capture binds the recorder; else none). */
+    onEngage(_ctx) {
+        return;
+    }
+    /** The wire ``<service>.stop``. ``all`` (or an unscoped call) is the full teardown; otherwise
+     * disarm ``source`` alone, leaving the rest. */
+    async stopRequest({ source = null, all = false, } = {}) {
+        if (all || source === null) {
+            await this.stop();
+            return;
+        }
+        await this.stopSource(source);
+    }
+}
+if (typeof Symbol.dispose === "symbol") {
+    StandingSource.prototype[Symbol.dispose] = function () {
+        void this.stop();
+    };
+}
+if (typeof Symbol.asyncDispose === "symbol") {
+    StandingSource.prototype[Symbol.asyncDispose] = async function () {
+        await this.stop();
+    };
+}
+//# sourceMappingURL=standing-source.js.map

package/dist/rooms/standing-source.js.map

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

package/dist/rooms/transcriber.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A running transcription of a room's live audio into ``transcript.*`` signals — the handle
+ * {@link ./room.Room.transcribe} returns. The TypeScript port of Python's ``_AsyncTranscriber`` +
+ * ``_publish_room_transcription`` (aio.py).
+ *
+ * It consumes the room's shared ``audio.snippet`` stream, pushes it through the client's shared
+ * transcription engine (on *your* credentials/compute), and publishes back:
+ *
+ * * ``transcript.partial`` — ``{ text }``, **ephemeral** (a live caption the recorder skips).
+ *   Wholesale-replaced — render the latest, don't append.
+ * * ``transcript.final`` — ``{ text, start, end, seq }``, durable (a {@link ./recorder.Recorder}
+ *   bridge persists it — no new recording API). ``seq`` is a per-handle counter from 0; the signal's
+ *   ``source`` is ``"transcriber"``.
+ *
+ * A **side effect**, like {@link ./room.Room.record}: it starts in the background and is stopped when
+ * the room closes, or via ``await handle.stop()`` / ``await using``. A fatal error (a rejected
+ * credential, the snippet stream refused) ends it and is held on {@link Transcriber.error}.
+ */
+import type { Transcript } from "../models.js";
+/** The signal-level ``source`` every ``transcript.*`` message carries. */
+export declare const TRANSCRIBER_SOURCE = "transcriber";
+/** What a {@link Transcriber} is wired with (filled by {@link ./room.Room.transcribe}). */
+export interface TranscriberDeps {
+    model?: string;
+    language?: string;
+    /** The room's raw snippet bytes (a dedicated consumer socket); ends when ``signal`` aborts. */
+    snippetBytes(signal: AbortSignal): AsyncIterable<ArrayBuffer>;
+    /** The client's shared transcription engine over those bytes. */
+    engine(clips: AsyncIterable<ArrayBuffer>, opts: {
+        model?: string;
+        language?: string;
+        signal?: AbortSignal;
+    }): AsyncIterable<Transcript>;
+    /** Publish one ``transcript.*`` signal back into the room (as ``source: "transcriber"``). */
+    publish(type: string, payload: Record<string, unknown>, opts: {
+        ephemeral?: boolean;
+    }): Promise<void>;
+}
+export declare class Transcriber {
+    private readonly deps;
+    private readonly abort;
+    private loop;
+    private settled;
+    private stopped;
+    private _error;
+    constructor(deps: TranscriberDeps);
+    /** True while the transcription loop runs. */
+    get alive(): boolean;
+    /** The error that ended the transcription for good (``null`` while alive or after a clean stop). */
+    get error(): Error | null;
+    /** Begin transcribing (idempotent). */
+    start(): void;
+    private run;
+    /** Stop transcribing (idempotent) — aborts the loop, closing the snippet stream and the engine. */
+    stop(): Promise<void>;
+    [Symbol.asyncDispose]: () => Promise<void>;
+}
+/** The one body behind {@link Transcriber} and every per-source engine of
+ * {@link ./offer-transcription.OfferedTranscription} — the shared port of Python's
+ * ``_publish_room_transcription``. Runs the shared transcription ``engine`` over ``clips`` and
+ * publishes each result: ``transcript.final`` (``{ text, start, end, seq, …attribution }``, durable —
+ * ``seq`` counts finals from 0) and ``transcript.partial`` (``{ text, …attribution }``, ephemeral live
+ * caption). ``attribution`` adds the producer's ``source`` / ``source_name`` for the offer's
+ * per-source publishes; the plain in-room transcriber leaves it empty (byte-identical to its former
+ * inline body). */
+export declare function publishRoomTranscripts(opts: {
+    clips: AsyncIterable<ArrayBuffer>;
+    engine: (clips: AsyncIterable<ArrayBuffer>, o: {
+        model?: string;
+        language?: string;
+        signal?: AbortSignal;
+    }) => AsyncIterable<Transcript>;
+    publish: (type: string, payload: Record<string, unknown>, o: {
+        ephemeral?: boolean;
+    }) => Promise<void>;
+    model?: string;
+    language?: string;
+    signal?: AbortSignal;
+    attribution?: Record<string, unknown>;
+}): Promise<void>;
+//# sourceMappingURL=transcriber.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber.d.ts","sourceRoot":"","sources":["../../src/rooms/transcriber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,gBAAgB,CAAA;AAE/C,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+FAA+F;IAC/F,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC,CAAA;IAC7D,iEAAiE;IACjE,MAAM,CACJ,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,EACjC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAChE,aAAa,CAAC,UAAU,CAAC,CAAA;IAC5B,6FAA6F;IAC7F,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAAA;CACjB;AAED,qBAAa,WAAW;IAOV,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAqB;gBAEN,IAAI,EAAE,eAAe;IAElD,8CAA8C;IAC9C,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,oGAAoG;IACpG,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED,uCAAuC;IACvC,KAAK,IAAI,IAAI;YAIC,GAAG;IAqBjB,mGAAmG;IAC7F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AAQD;;;;;;;mBAOmB;AACnB,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;IACjC,MAAM,EAAE,CACN,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,EACjC,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAC3D,aAAa,CAAC,UAAU,CAAC,CAAA;IAC9B,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KACvB,OAAO,CAAC,IAAI,CAAC,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BhB"}

package/dist/rooms/transcriber.js

@@ -0,0 +1,111 @@
+/**
+ * A running transcription of a room's live audio into ``transcript.*`` signals — the handle
+ * {@link ./room.Room.transcribe} returns. The TypeScript port of Python's ``_AsyncTranscriber`` +
+ * ``_publish_room_transcription`` (aio.py).
+ *
+ * It consumes the room's shared ``audio.snippet`` stream, pushes it through the client's shared
+ * transcription engine (on *your* credentials/compute), and publishes back:
+ *
+ * * ``transcript.partial`` — ``{ text }``, **ephemeral** (a live caption the recorder skips).
+ *   Wholesale-replaced — render the latest, don't append.
+ * * ``transcript.final`` — ``{ text, start, end, seq }``, durable (a {@link ./recorder.Recorder}
+ *   bridge persists it — no new recording API). ``seq`` is a per-handle counter from 0; the signal's
+ *   ``source`` is ``"transcriber"``.
+ *
+ * A **side effect**, like {@link ./room.Room.record}: it starts in the background and is stopped when
+ * the room closes, or via ``await handle.stop()`` / ``await using``. A fatal error (a rejected
+ * credential, the snippet stream refused) ends it and is held on {@link Transcriber.error}.
+ */
+import { asError } from "../http.js";
+/** The signal-level ``source`` every ``transcript.*`` message carries. */
+export const TRANSCRIBER_SOURCE = "transcriber";
+export class Transcriber {
+    deps;
+    abort = new AbortController();
+    loop = null;
+    settled = false;
+    stopped = false;
+    _error = null;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** True while the transcription loop runs. */
+    get alive() {
+        return this.loop !== null && !this.settled;
+    }
+    /** The error that ended the transcription for good (``null`` while alive or after a clean stop). */
+    get error() {
+        return this._error;
+    }
+    /** Begin transcribing (idempotent). */
+    start() {
+        if (!this.loop)
+            this.loop = this.run();
+    }
+    async run() {
+        try {
+            await publishRoomTranscripts({
+                clips: this.deps.snippetBytes(this.abort.signal),
+                engine: this.deps.engine,
+                publish: this.deps.publish,
+                model: this.deps.model,
+                language: this.deps.language,
+                signal: this.abort.signal,
+            });
+        }
+        catch (err) {
+            // A deliberate stop() aborts the engine cleanly; only an unexpected failure is terminal.
+            if (!this.stopped) {
+                this._error = asError(err);
+                console.error("Atrium transcriber died:", err);
+            }
+        }
+        finally {
+            this.settled = true;
+        }
+    }
+    /** Stop transcribing (idempotent) — aborts the loop, closing the snippet stream and the engine. */
+    async stop() {
+        this.stopped = true;
+        this.abort.abort();
+        if (this.loop)
+            await this.loop.catch(() => { });
+    }
+}
+if (typeof Symbol.asyncDispose === "symbol") {
+    Transcriber.prototype[Symbol.asyncDispose] = async function () {
+        await this.stop();
+    };
+}
+/** The one body behind {@link Transcriber} and every per-source engine of
+ * {@link ./offer-transcription.OfferedTranscription} — the shared port of Python's
+ * ``_publish_room_transcription``. Runs the shared transcription ``engine`` over ``clips`` and
+ * publishes each result: ``transcript.final`` (``{ text, start, end, seq, …attribution }``, durable —
+ * ``seq`` counts finals from 0) and ``transcript.partial`` (``{ text, …attribution }``, ephemeral live
+ * caption). ``attribution`` adds the producer's ``source`` / ``source_name`` for the offer's
+ * per-source publishes; the plain in-room transcriber leaves it empty (byte-identical to its former
+ * inline body). */
+export async function publishRoomTranscripts(opts) {
+    let seq = 0;
+    const attribution = opts.attribution ?? {};
+    for await (const said of opts.engine(opts.clips, {
+        model: opts.model,
+        language: opts.language,
+        signal: opts.signal,
+    })) {
+        if (said.final) {
+            await opts.publish("transcript.final", {
+                text: said.text,
+                start: said.raw.start ?? null,
+                end: said.raw.end ?? null,
+                seq,
+                ...attribution,
+            }, {});
+            seq += 1;
+        }
+        else {
+            await opts.publish("transcript.partial", { text: said.text, ...attribution }, { ephemeral: true });
+        }
+    }
+}
+//# sourceMappingURL=transcriber.js.map

package/dist/rooms/transcriber.js.map

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