hci-atrium 0.1.0

package/dist/transcribe.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The shared live-transcription engine — the TypeScript port of Python's ``AsyncAtrium``
+ * ``_transcribe_engine`` / ``_transcribe_stream`` / ``_transcribe_fallback_clips`` (aio.py).
+ *
+ * It tries the streaming route ({@link ./transcribe-stream.TranscriptionStream}) and, on a connect-time
+ * {@link ./transcribe-stream.StreamUnavailable}, degrades to per-clip batch transcription (POST each
+ * self-contained clip; a continuous PCM stream is first re-windowed into WAV clips). An
+ * {@link ./errors.AuthError} from the handshake propagates untouched — retrying won't heal it.
+ *
+ * The degradation is **connect-time only**: once the stream is live, a mid-session failure (an abrupt
+ * disconnect, a server crash, a close that never delivered ``done``) raises rather than silently
+ * degrading, so a truncated transcript can't masquerade as a clean end.
+ *
+ * Both {@link ../atrium.Atrium.transcribeLive} and {@link ../rooms/room.Room.transcribe} run on this
+ * one engine.
+ */
+import type { FileSource } from "./files.js";
+import type { Transcript } from "./models.js";
+import type { WebSocketCtor } from "./rooms/transport.js";
+/** One input audio chunk — an in-memory buffer or a browser ``Blob`` (a ``MediaRecorder`` slice). */
+export type AudioChunk = ArrayBuffer | ArrayBufferView | Blob;
+/** The client capabilities the engine needs: a credential for the stream WS and the batch route for
+ * the fallback. Supplied by the {@link ../atrium.Atrium} client. */
+export interface TranscribeStreamDeps {
+    baseUrl: string;
+    /** A valid bearer/API-key credential for the stream handshake. */
+    token(): Promise<string>;
+    /** The batch ``transcribe`` route — the per-clip fallback POSTs each clip through it. */
+    transcribe(audio: FileSource, opts: {
+        model?: string;
+        language?: string;
+        format?: string;
+    }): Promise<Transcript>;
+    /** Injected ``WebSocket`` constructor (defaults to the runtime global) — the test seam / Node <22. */
+    webSocketCtor?: WebSocketCtor;
+}
+/** Engine options (shared by the streaming and fallback paths). */
+export interface TranscribeStreamOptions {
+    model?: string;
+    language?: string;
+    /** ``"pcm16"`` for a raw headerless stream (needs ``sampleRate``), else a container format. */
+    format: string;
+    sampleRate?: number;
+    /** Also yield revisable partial hypotheses (streaming path only). */
+    partials: boolean;
+    /** Drop finalized sentences that transcribe to empty text. */
+    skipEmpty: boolean;
+    /** Aborting tears the stream down cleanly — the {@link ../rooms/transcriber.Transcriber} stop path. */
+    signal?: AbortSignal;
+    /** Injected ``WebSocket`` constructor for the stream handshake (defaults to the runtime global) —
+     * the test seam / Node <22 escape hatch. */
+    webSocketCtor?: WebSocketCtor;
+}
+/** Run the shared engine over ``clips``, yielding a {@link Transcript} per finalized sentence (and,
+ * with ``partials``, per live partial). Streaming when the backend offers it, per-clip batch otherwise. */
+export declare function transcribeEngine(deps: TranscribeStreamDeps, clips: AsyncIterable<AudioChunk>, opts: TranscribeStreamOptions): AsyncGenerator<Transcript>;
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../src/transcribe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,qGAAqG;AACrG,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,IAAI,CAAA;AAE7D;oEACoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,yFAAyF;IACzF,UAAU,CACR,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,OAAO,CAAC,UAAU,CAAC,CAAA;IACtB,sGAAsG;IACtG,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qEAAqE;IACrE,QAAQ,EAAE,OAAO,CAAA;IACjB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAA;IAClB,uGAAuG;IACvG,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;gDAC4C;IAC5C,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAKD;2GAC2G;AAC3G,wBAAuB,gBAAgB,CACrC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,IAAI,EAAE,uBAAuB,GAC5B,cAAc,CAAC,UAAU,CAAC,CAmB5B"}

package/dist/transcribe.js

@@ -0,0 +1,267 @@
+/**
+ * The shared live-transcription engine — the TypeScript port of Python's ``AsyncAtrium``
+ * ``_transcribe_engine`` / ``_transcribe_stream`` / ``_transcribe_fallback_clips`` (aio.py).
+ *
+ * It tries the streaming route ({@link ./transcribe-stream.TranscriptionStream}) and, on a connect-time
+ * {@link ./transcribe-stream.StreamUnavailable}, degrades to per-clip batch transcription (POST each
+ * self-contained clip; a continuous PCM stream is first re-windowed into WAV clips). An
+ * {@link ./errors.AuthError} from the handshake propagates untouched — retrying won't heal it.
+ *
+ * The degradation is **connect-time only**: once the stream is live, a mid-session failure (an abrupt
+ * disconnect, a server crash, a close that never delivered ``done``) raises rather than silently
+ * degrading, so a truncated transcript can't masquerade as a clean end.
+ *
+ * Both {@link ../atrium.Atrium.transcribeLive} and {@link ../rooms/room.Room.transcribe} run on this
+ * one engine.
+ */
+import { APIError, AtriumError } from "./errors.js";
+import { StreamUnavailable, TranscriptionStream } from "./transcribe-stream.js";
+// PCM fallback window (Python's ``_PCM_FALLBACK_WINDOW_S``): raw PCM is re-windowed into ~5s WAV clips.
+const PCM_FALLBACK_WINDOW_S = 5;
+/** Run the shared engine over ``clips``, yielding a {@link Transcript} per finalized sentence (and,
+ * with ``partials``, per live partial). Streaming when the backend offers it, per-clip batch otherwise. */
+export async function* transcribeEngine(deps, clips, opts) {
+    let stream;
+    try {
+        stream = await TranscriptionStream.open(deps.baseUrl, {
+            token: await deps.token(),
+            model: opts.model,
+            language: opts.language,
+            format: opts.format,
+            sampleRate: opts.sampleRate,
+            WebSocketCtor: deps.webSocketCtor,
+        });
+    }
+    catch (err) {
+        if (err instanceof StreamUnavailable) {
+            yield* transcribeFallbackClips(deps, clips, opts);
+            return;
+        }
+        throw err; // AuthError propagates
+    }
+    yield* transcribeStreamGen(stream, clips, opts);
+}
+// Pump `clips` up (a background feeder) while reading events down, mapping `final` (always) and
+// `partial` (only when `partials`) to Transcripts and ending on `done`. A stream that ends WITHOUT a
+// `done` — a clean 1000 that skipped it or any abnormal close — is a failure, not a completion, so it
+// raises; the degradation ladder is connect-time only. Aborting (Transcriber.stop) tears down cleanly.
+async function* transcribeStreamGen(stream, clips, opts) {
+    const aborted = () => Boolean(opts.signal?.aborted);
+    const onAbort = () => stream.close(); // unblock the events read so teardown proceeds at once
+    // Guard aborted-before-add (the handshake may already have run past a ≤10s abort while the stream
+    // was opening — the listener would then never fire): close now, and only listen otherwise.
+    if (opts.signal) {
+        if (opts.signal.aborted)
+            onAbort();
+        else
+            opts.signal.addEventListener("abort", onAbort);
+    }
+    const feeder = feedStream(stream, clips);
+    let doneSeen = false;
+    try {
+        for await (const event of stream.events()) {
+            const type = event.type;
+            if (type === "final") {
+                const text = String(event.text ?? "");
+                if (text || !opts.skipEmpty)
+                    yield transcriptFromEvent(event, true);
+            }
+            else if (type === "partial") {
+                if (opts.partials)
+                    yield transcriptFromEvent(event, false);
+            }
+            else if (type === "done") {
+                doneSeen = true;
+                break;
+            }
+            else if (type === "error") {
+                throw new AtriumError(`transcription stream error: ${String(event.detail ?? "")}`);
+            }
+            // unknown types (incl. 'ready') are ignored — frozen-safe contract
+        }
+    }
+    catch (err) {
+        if (!aborted())
+            throw err; // a deliberate teardown closes the socket → swallow the close error
+    }
+    finally {
+        opts.signal?.removeEventListener("abort", onAbort);
+        // Always stop the feeder before awaiting it — a normal `done` arrives after the feeder drained
+        // (a no-op stop), but a *spurious* `done` (one with no preceding client `stop`) would otherwise
+        // leave an infinite clips source pumping forever and wedge `await feeder.done`.
+        feeder.stop();
+        await feeder.done.catch(() => { });
+        stream.close();
+    }
+    if (!doneSeen && !aborted()) {
+        throw new AtriumError("transcription stream ended unexpectedly (no done event)");
+    }
+}
+// Send every chunk as a binary frame, then `stop` (so the server flushes and sends `done`). `stop()`
+// ends the pull early (an early teardown), nudging the input iterator's own `return` so a well-behaved
+// generator closes its source.
+function feedStream(stream, clips) {
+    const iterator = clips[Symbol.asyncIterator]();
+    let stopped = false;
+    const done = (async () => {
+        try {
+            while (!stopped) {
+                const next = await iterator.next();
+                if (next.done || stopped)
+                    break;
+                try {
+                    stream.sendBytes(await toArrayBuffer(next.value));
+                }
+                catch {
+                    break; // socket gone — nothing left to feed
+                }
+            }
+            if (!stopped) {
+                try {
+                    stream.sendStop();
+                }
+                catch {
+                    // the socket may already be closing — the server ends the stream regardless
+                }
+            }
+        }
+        catch {
+            // input iteration failed / was torn down — the engine's teardown owns the cleanup
+        }
+    })();
+    return {
+        done,
+        stop() {
+            stopped = true;
+            void iterator.return?.().catch(() => { });
+        },
+    };
+}
+// Wrap one stream `final`/`partial` event as a Transcript. `.raw` carries the whole event (a `final`
+// brings `start`/`end`); `.final` marks settled vs revisable. Mirror of Python's `_transcript_from_event`.
+function transcriptFromEvent(event, final) {
+    return {
+        text: String(event.text ?? ""),
+        language: null,
+        duration: null,
+        segments: [],
+        raw: event,
+        final,
+    };
+}
+// The default per-clip batch fallback: POST each self-contained clip. Continuous PCM (`format="pcm16"`)
+// is first re-windowed into ~5s WAV clips.
+async function* transcribeFallbackClips(deps, clips, opts) {
+    if (opts.format === "pcm16") {
+        // transcribeLive validated sampleRate is present for pcm16.
+        for await (const wav of wavWindows(clips, opts.sampleRate)) {
+            const said = await transcribeOne(deps, wav, opts, "wav");
+            if (said)
+                yield said;
+        }
+    }
+    else {
+        for await (const clip of clips) {
+            const said = await transcribeOne(deps, clip, opts, opts.format);
+            if (said)
+                yield said;
+        }
+    }
+}
+// Transcribe one self-contained clip with the live-stream skip rules. Returns the Transcript, or null
+// for a clip to drop: one the server couldn't transcribe (a bad/empty frame, a transient error) or —
+// when skipEmpty — one whose text is empty. Auth errors (401/403) still propagate.
+async function transcribeOne(deps, chunk, opts, format) {
+    let said;
+    try {
+        said = await deps.transcribe(await toBlob(chunk), {
+            model: opts.model,
+            language: opts.language,
+            format,
+        });
+    }
+    catch (err) {
+        if (err instanceof APIError && (err.status === 401 || err.status === 403))
+            throw err;
+        return null; // a frame the server couldn't transcribe — skip, keep the stream alive
+    }
+    return said.text || !opts.skipEmpty ? said : null;
+}
+// Batch a continuous PCM16LE-mono byte stream into ~5s self-contained WAV clips, so the batch fallback
+// works for the same raw-mic input the streaming path takes headerless.
+async function* wavWindows(clips, sampleRate) {
+    const target = PCM_FALLBACK_WINDOW_S * sampleRate * 2; // 2 bytes/sample, mono
+    const parts = [];
+    let size = 0;
+    for await (const chunk of clips) {
+        const bytes = await toBytes(chunk);
+        parts.push(bytes);
+        size += bytes.length;
+        if (size >= target) {
+            yield pcm16ToWav(concat(parts, size), sampleRate);
+            parts.length = 0;
+            size = 0;
+        }
+    }
+    if (size > 0)
+        yield pcm16ToWav(concat(parts, size), sampleRate);
+}
+// Wrap raw PCM16LE-mono samples in a minimal WAV container (a 44-byte header + the samples). Mirror of
+// Python's `_pcm16_to_wav` (stdlib `wave`).
+function pcm16ToWav(pcm, sampleRate) {
+    const byteRate = sampleRate * 2; // mono, 16-bit
+    const buffer = new ArrayBuffer(44 + pcm.length);
+    const view = new DataView(buffer);
+    const ascii = (offset, text) => {
+        for (let i = 0; i < text.length; i++)
+            view.setUint8(offset + i, text.charCodeAt(i));
+    };
+    ascii(0, "RIFF");
+    view.setUint32(4, 36 + pcm.length, true);
+    ascii(8, "WAVE");
+    ascii(12, "fmt ");
+    view.setUint32(16, 16, true); // PCM fmt chunk size
+    view.setUint16(20, 1, true); // audio format = PCM
+    view.setUint16(22, 1, true); // channels = mono
+    view.setUint32(24, sampleRate, true);
+    view.setUint32(28, byteRate, true);
+    view.setUint16(32, 2, true); // block align
+    view.setUint16(34, 16, true); // bits per sample
+    ascii(36, "data");
+    view.setUint32(40, pcm.length, true);
+    new Uint8Array(buffer, 44).set(pcm);
+    return buffer;
+}
+function concat(parts, size) {
+    const out = new Uint8Array(size);
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.length;
+    }
+    return out;
+}
+async function toBytes(chunk) {
+    if (chunk instanceof Uint8Array)
+        return chunk;
+    if (chunk instanceof ArrayBuffer)
+        return new Uint8Array(chunk);
+    if (ArrayBuffer.isView(chunk)) {
+        return new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+    }
+    return new Uint8Array(await chunk.arrayBuffer()); // Blob
+}
+async function toArrayBuffer(chunk) {
+    if (chunk instanceof ArrayBuffer)
+        return chunk;
+    if (ArrayBuffer.isView(chunk)) {
+        return chunk.buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength);
+    }
+    return chunk.arrayBuffer(); // Blob
+}
+async function toBlob(chunk) {
+    if (chunk instanceof Blob)
+        return chunk;
+    return new Blob([await toArrayBuffer(chunk)]);
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/transcribe.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+/** Public data shapes returned by the SDK. */
+/**
+ * The signed-in user, as returned by ``GET /v1/users/me``.
+ *
+ * Field names mirror the server JSON verbatim (snake_case). Extra fields the server may add in the
+ * future are preserved via the index signature, so a newer server never breaks an older client.
+ */
+export interface User {
+    id: string;
+    email: string;
+    role: string;
+    auth_method: string;
+    is_active: boolean;
+    created_at: string;
+    authenticated_via: "bearer" | "api_key" | "app";
+    key_project_id: string | null;
+    effective_project_id: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;IAC/C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** Public data shapes returned by the SDK. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8CAA8C"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "hci-atrium",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Atrium framework — multimodal asset library, semantic + cross-modal search, and capability routing.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Anders Petruschke",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.4"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    }
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "zod": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.16",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^26.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "biome check .",
+    "format": "biome check --write ."
+  }
+}