hci-atrium 0.1.0 → 0.3.0

package/dist/dash.js

@@ -0,0 +1,302 @@
+/**
+ * Observation-dashboard state — the host-side helper (the TypeScript port of Python's ``dash.py``,
+ * on the **v2 tile wire**).
+ *
+ * An app drives a live dashboard by holding its state here as a grid of **tiles**. The helper answers
+ * each dashboard's ``presence.join`` with a full snapshot (host-answers-join) and broadcasts a delta
+ * on every change, over the room's ephemeral ``dash.*`` signals. The dialect is normative in
+ * ``docs/reference/dash-dialect.md``; the hosted renderer is ``/tools/dashboard``.
+ *
+ * One source of truth (the app), two channels. The **live dashboard** is what a researcher watches
+ * *now*: tiles for state, and {@link Dashboard.error} for a prominent, persistent error strip — both
+ * ephemeral, so the room stores nothing and a late joiner sees only the current snapshot (never a past
+ * error). The **session** is the durable record: log notable events *and* errors there yourself (a
+ * ``session.event``) so they survive the room. Notable failures usually want both.
+ *
+ * Tiles (``kind``): ``status`` (a labelled value) · ``text`` (fit-to-box prose) · ``image`` /
+ * ``sound`` (link an asset by ``assetId``) · ``decision`` (candidates considered / picked / why).
+ * Every tile takes an optional ``title``, a ``colSpan`` / ``rowSpan`` (1..3) and a ``group`` (a titled
+ * row break in the grid). Structure lives in the grid — the room's event log (the dashboard's
+ * sidebar) is a strict chronological feed the app does not lay out.
+ *
+ * Controls: {@link Dashboard.button} (fires an action back to the app) and {@link Dashboard.textInput}
+ * (a labelled send). A dashboard fires a control as a ``dash.action`` request and toasts the handler's
+ * return; a researcher note arrives as a fire-and-forget ``dash.note``.
+ *
+ * ```ts
+ * await using room = await atrium.rooms.open({ name: "study" })
+ * await room.connect()                       // the app is the snapshot's `host`
+ * const dash = room.dashboard({ title: "Reactive Soundscape" })
+ * await dash.status("phase", "Phase", "Calibration")
+ * await dash.text("brief", "Welcome — settle in.", { colSpan: 2 })
+ * dash.button("advance", "Start next phase", async () => {
+ *   await dash.status("phase", "Phase", "Running", { style: "good" })  // broadcasts a delta
+ *   return { message: "Phase advanced" }
+ * })
+ * ```
+ */
+import { InvalidArgumentError } from "./errors.js";
+function span(name, value) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isInteger(value) || value < 1 || value > 3) {
+        throw new InvalidArgumentError(`${name} must be an integer between 1 and 3 (got ${value})`);
+    }
+    return value;
+}
+function normalizeCandidate(c) {
+    if (typeof c === "string")
+        return { label: c };
+    const out = { label: c.label };
+    if (c.detail !== undefined)
+        out.detail = c.detail;
+    if (c.score !== undefined)
+        out.score = c.score;
+    return out;
+}
+/**
+ * Live observation-dashboard state for one connected room.
+ *
+ * Build it on a room (ideally after ``connect()``, so ``host`` resolves) — usually via
+ * ``room.dashboard({ title })``. It registers a ``presence.join`` handler that answers each joining
+ * dashboard with the current snapshot. Mutating methods update the snapshot **and** broadcast a delta
+ * once connected. All ``dash.*`` traffic is ephemeral — nothing is stored; keep the durable record in
+ * the session.
+ */
+export class Dashboard {
+    room;
+    title;
+    hostOverride;
+    publish;
+    tiles = [];
+    pos = new Map();
+    controls = [];
+    controlPos = new Map();
+    // control id → [handler, wantsValue] (a text control's handler takes the submitted value)
+    handlers = new Map();
+    noteHandler = null;
+    constructor(room, opts = {}) {
+        this.room = room;
+        this.title = opts.title;
+        this.hostOverride = opts.host;
+        this.publish =
+            opts.publish ?? ((type, payload, o) => room.send(type, payload, o));
+        room.on("presence.join", (e) => this.handleJoin(e));
+        room.on("dash.action", (e) => this.handleAction(e));
+        room.on("dash.note", (e) => this.handleNote(e));
+    }
+    // --- snapshot / transport ------------------------------------------------
+    /** The full current state a joining dashboard receives (``components`` is THE tile carrier). */
+    snapshot() {
+        const snap = { components: this.tiles.map((t) => ({ ...t })) };
+        if (this.title !== undefined)
+            snap.title = this.title;
+        const host = this.hostOverride ?? this.room.identity ?? undefined;
+        if (host != null)
+            snap.host = host;
+        if (this.controls.length > 0)
+            snap.controls = this.controls.map((c) => ({ ...c }));
+        return snap;
+    }
+    // A dashboard connected — retell the full state to just that connection (ephemeral, so recorders
+    // don't store repeated snapshots).
+    async handleJoin(event) {
+        const to = event.payload.connection_id ?? event.payload.identity;
+        if (typeof to === "string" && to) {
+            await this.publish("dash.snapshot", this.snapshot(), { to, ephemeral: true });
+        }
+    }
+    // Broadcast a patch to every connected dashboard (once we have a connection to send from).
+    async delta(delta) {
+        if (this.room.connectionId === null)
+            return;
+        await this.publish("dash.delta", delta, { ephemeral: true });
+    }
+    // A dashboard fired a control (a request); the returned value is what the room dispatcher replies
+    // with. Buttons pass no value; a text control passes its submitted `value`.
+    async handleAction(event) {
+        const id = event.payload.id;
+        const entry = typeof id === "string" ? this.handlers.get(id) : undefined;
+        if (!entry)
+            return { ok: false, message: `unknown control: ${String(id)}` };
+        const [handler, wantsValue] = entry;
+        try {
+            const result = await (wantsValue
+                ? handler(String(event.payload.value ?? ""))
+                : handler());
+            return result && typeof result === "object" ? result : { ok: true };
+        }
+        catch (err) {
+            // A failing handler becomes an error toast, not a dead request.
+            return { ok: false, message: err.message || String(err) };
+        }
+    }
+    // A researcher note (fire-and-forget). The helper doesn't own a session, so recording it is the
+    // app's job — we just hand off the text.
+    async handleNote(event) {
+        if (!this.noteHandler)
+            return;
+        const text = event.payload.text;
+        if (typeof text !== "string")
+            return;
+        await this.noteHandler(text);
+    }
+    baseTile(id, kind, opts) {
+        const tile = { id, kind };
+        if (opts.title !== undefined)
+            tile.title = opts.title;
+        const col = span("colSpan", opts.colSpan);
+        if (col !== undefined)
+            tile.col_span = col;
+        const row = span("rowSpan", opts.rowSpan);
+        if (row !== undefined)
+            tile.row_span = row;
+        if (opts.group !== undefined)
+            tile.group = opts.group;
+        return tile;
+    }
+    async upsert(tile) {
+        const id = tile.id;
+        const at = this.pos.get(id);
+        if (at !== undefined)
+            this.tiles[at] = tile;
+        else {
+            this.pos.set(id, this.tiles.length);
+            this.tiles.push(tile);
+        }
+        await this.delta({ upsert: [tile] });
+    }
+    // --- tiles ---------------------------------------------------------------
+    /** Add or update a labelled status tile (``style``: good/warn/bad). */
+    async status(id, label, value, opts = {}) {
+        const tile = this.baseTile(id, "status", opts);
+        tile.label = label;
+        tile.value = value;
+        if (opts.style !== undefined)
+            tile.style = opts.style;
+        await this.upsert(tile);
+    }
+    /** Add or update a text tile — prose that fills the box: the tool shrinks the font through measured
+     * tiers until the whole text fits, scrolling inward only if even the floor can't hold it. */
+    async text(id, text, opts = {}) {
+        const tile = this.baseTile(id, "text", opts);
+        tile.text = text;
+        await this.upsert(tile);
+    }
+    /** Add or update an image tile — link a library asset by ``assetId`` (public thumbnail,
+     * click-through to the platform) or a raw ``url``. */
+    async image(id, opts = {}) {
+        const tile = this.baseTile(id, "image", opts);
+        if (opts.assetId !== undefined)
+            tile.asset_id = opts.assetId;
+        if (opts.url !== undefined)
+            tile.url = opts.url;
+        if (opts.caption !== undefined)
+            tile.caption = opts.caption;
+        await this.upsert(tile);
+    }
+    /** Add or update a sound tile — link a library asset by ``assetId`` (inline player); ``playing``
+     * reflects whether it's currently sounding. */
+    async sound(id, opts = {}) {
+        const tile = this.baseTile(id, "sound", opts);
+        if (opts.assetId !== undefined)
+            tile.asset_id = opts.assetId;
+        if (opts.playing !== undefined)
+            tile.playing = opts.playing;
+        await this.upsert(tile);
+    }
+    /** Add or update a decision tile — the agentic debug shape: what was **considered** (each candidate
+     * an optional ``detail`` / ``score``), which was **picked** (a candidate label), and the
+     * **reasoning**. The picked candidate renders prominent, the rest dimmed. The tool renders a
+     * decision tile **two rows tall by default** (its content wants the room); pass ``rowSpan`` to
+     * override. */
+    async decision(id, candidates, opts = {}) {
+        const tile = this.baseTile(id, "decision", opts);
+        tile.candidates = candidates.map(normalizeCandidate);
+        if (opts.picked !== undefined)
+            tile.picked = opts.picked;
+        if (opts.reasoning !== undefined)
+            tile.reasoning = opts.reasoning;
+        await this.upsert(tile);
+    }
+    /** Remove a tile. */
+    async remove(id) {
+        const at = this.pos.get(id);
+        if (at === undefined)
+            return;
+        this.pos.delete(id);
+        this.tiles.splice(at, 1);
+        for (const [tileId, p] of this.pos)
+            if (p > at)
+                this.pos.set(tileId, p - 1);
+        await this.delta({ remove: [id] });
+    }
+    // --- errors --------------------------------------------------------------
+    /**
+     * Surface an error prominently on the live dashboard — a sticky, dismissable strip, **not** a tile.
+     * Broadcasts a ``dash.error`` signal ``{ message, detail?, at }`` (``at`` = epoch-ms) to every
+     * connected dashboard; the tool pins it above the grid until the researcher dismisses it.
+     *
+     * This is the **live prominent surface** — what makes a failure impossible to miss *while the study
+     * runs*. It is not durable: like all ``dash.*`` traffic it's ephemeral, a late joiner won't see a
+     * past error, and the room stores nothing. To keep the error in the permanent record, also record
+     * it to the **session** yourself (a ``session.event``).
+     */
+    async error(message, detail) {
+        if (this.room.connectionId === null)
+            return;
+        const payload = { message, at: Date.now() };
+        if (detail !== undefined)
+            payload.detail = detail;
+        await this.publish("dash.error", payload, { ephemeral: true });
+    }
+    // --- controls ------------------------------------------------------------
+    // Controls ride the snapshot (not deltas): declare them at setup, before dashboards join. A
+    // dashboard that joins later re-receives the whole snapshot, so it always sees the full set.
+    addControl(control) {
+        const id = control.id;
+        const at = this.controlPos.get(id);
+        if (at !== undefined)
+            this.controls[at] = control;
+        else {
+            this.controlPos.set(id, this.controls.length);
+            this.controls.push(control);
+        }
+    }
+    /** Declare a button and bind its handler. The handler (sync or async, no args) may return
+     * ``{ ok?, message? }`` — toasted on the dashboard — or nothing (a success toast). Chainable. */
+    button(id, label, handler, opts = {}) {
+        const control = { id, type: "button", label };
+        if (opts.variant !== undefined)
+            control.variant = opts.variant;
+        if (opts.confirm)
+            control.confirm = true;
+        if (opts.disabled)
+            control.disabled = true;
+        this.addControl(control);
+        this.handlers.set(id, [handler, false]);
+        return this;
+    }
+    /** Declare a text-send control and bind its handler. The handler (sync or async) receives the
+     * submitted value and may return ``{ ok?, message? }`` — toasted on the dashboard — or nothing.
+     * (Named ``textInput`` to leave the ``text`` tile the natural name.) Chainable. */
+    textInput(id, handler, opts = {}) {
+        const control = { id, type: "text" };
+        if (opts.label !== undefined)
+            control.label = opts.label;
+        if (opts.placeholder !== undefined)
+            control.placeholder = opts.placeholder;
+        if (opts.disabled)
+            control.disabled = true;
+        this.addControl(control);
+        this.handlers.set(id, [handler, true]);
+        return this;
+    }
+    /** Register the handler for researcher notes. It receives the note text; record it to your session
+     * — the dashboard is live-only and stores nothing. Chainable. */
+    onNote(handler) {
+        this.noteHandler = handler;
+        return this;
+    }
+}
+//# sourceMappingURL=dash.js.map

package/dist/dash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.js","sourceRoot":"","sources":["../src/dash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAoHlD,SAAS,IAAI,CAAC,IAAY,EAAE,KAAyB;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,oBAAoB,CAAC,GAAG,IAAI,4CAA4C,KAAK,GAAG,CAAC,CAAA;IAC7F,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAgB;IAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IAC9C,MAAM,GAAG,GAA4B,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAA;IACjD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IAC9C,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAS;IACH,IAAI,CAAe;IACnB,KAAK,CAAoB;IACzB,YAAY,CAAoB;IAChC,OAAO,CAA0C;IACjD,KAAK,GAAW,EAAE,CAAA;IAClB,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC/B,QAAQ,GAAc,EAAE,CAAA;IACxB,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvD,0FAA0F;IACzE,QAAQ,GAAG,IAAI,GAAG,EAA0D,CAAA;IACrF,WAAW,GAA2B,IAAI,CAAA;IAElD,YAAY,IAAmB,EAAE,OAAyB,EAAE;QAC1D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAA;QAC7B,IAAI,CAAC,OAAO;YACV,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAA4B,CAAC,CAAC,CAAA;QAChG,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,4EAA4E;IAE5E,gGAAgG;IAChG,QAAQ;QACN,MAAM,IAAI,GAA4B,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;QACvF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAA;QACjE,IAAI,IAAI,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAClF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,iGAAiG;IACjG,mCAAmC;IAC3B,KAAK,CAAC,UAAU,CAAC,KAAgB;QACvC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAA;QAChE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/E,CAAC;IACH,CAAC;IAED,2FAA2F;IACnF,KAAK,CAAC,KAAK,CAAC,KAA8B;QAChD,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAM;QAC3C,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,kGAAkG;IAClG,4EAA4E;IACpE,KAAK,CAAC,YAAY,CAAC,KAAgB;QACzC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAA;QAC3B,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACxE,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAA;QAC3E,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAA;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU;gBAC9B,CAAC,CAAE,OAA2B,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBACjE,CAAC,CAAE,OAA6B,EAAE,CAAC,CAAA;YACrC,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,gEAAgE;YAChE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;QACtE,CAAC;IACH,CAAC;IAED,gGAAgG;IAChG,yCAAyC;IACjC,KAAK,CAAC,UAAU,CAAC,KAAgB;QACvC,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAM;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAA;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAM;QACpC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAEO,QAAQ,CAAC,EAAU,EAAE,IAAY,EAAE,IAAiB;QAC1D,MAAM,IAAI,GAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QAC/B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACzC,IAAI,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAA;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACzC,IAAI,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAA;QAC1C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACrD,OAAO,IAAI,CAAA;IACb,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,IAAU;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,EAAY,CAAA;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC3B,IAAI,EAAE,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAA;aACtC,CAAC;YACJ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACtC,CAAC;IAED,4EAA4E;IAE5E,uEAAuE;IACvE,KAAK,CAAC,MAAM,CACV,EAAU,EACV,KAAa,EACb,KAAa,EACb,OAA0B,EAAE;QAE5B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACrD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED;iGAC6F;IAC7F,KAAK,CAAC,IAAI,CAAC,EAAU,EAAE,IAAY,EAAE,OAAoB,EAAE;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED;0DACsD;IACtD,KAAK,CAAC,KAAK,CAAC,EAAU,EAAE,OAAyB,EAAE;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QAC7C,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5D,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QAC/C,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3D,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED;mDAC+C;IAC/C,KAAK,CAAC,KAAK,CAAC,EAAU,EAAE,OAAyB,EAAE;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QAC7C,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5D,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3D,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED;;;;mBAIe;IACf,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,UAA2B,EAC3B,OAA4B,EAAE;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;QAChD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;QACpD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACxD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;QACjE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,qBAAqB;IACrB,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC3B,IAAI,EAAE,KAAK,SAAS;YAAE,OAAM;QAC5B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QACxB,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,GAAG,EAAE;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QAC3E,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACpC,CAAC;IAED,4EAA4E;IAE5E;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,MAAe;QAC1C,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAM;QAC3C,MAAM,OAAO,GAA4B,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;QACpE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAA;QACjD,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAChE,CAAC;IAED,4EAA4E;IAC5E,4FAA4F;IAC5F,6FAA6F;IAErF,UAAU,CAAC,OAAgB;QACjC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAY,CAAA;QAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAClC,IAAI,EAAE,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAA;aAC5C,CAAC;YACJ,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC7C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAED;qGACiG;IACjG,MAAM,CAAC,EAAU,EAAE,KAAa,EAAE,OAA0B,EAAE,OAAsB,EAAE;QACpF,MAAM,OAAO,GAAY,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;QACtD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC9D,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAA;QACxC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAA;QAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;uFAEmF;IACnF,SAAS,CAAC,EAAU,EAAE,OAAwB,EAAE,OAAyB,EAAE;QACzE,MAAM,OAAO,GAAY,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;QAC7C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;QAC1E,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAA;QAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;QACtC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;qEACiE;IACjE,MAAM,CAAC,OAAwB;QAC7B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAA;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/direct.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Client-side direct-model overlay — route a chat call to an OpenAI-compatible endpoint.
+ *
+ * The SDK holds a small **direct registry**: a map of model *name* → {@link DirectEndpoint}. A
+ * chat/agent call naming a registered model is POSTed **directly** to that endpoint (a local Ollama
+ * / LM Studio, or a remote OpenAI-compatible server), bypassing Atrium; every other name goes to
+ * Atrium as usual. This is the client-side twin of the server-side per-user providers (BYOM-A).
+ *
+ * Only **chat** is routed here. Embeddings are never — a stored vector's model is a data contract
+ * with the library's vector space, so ``atrium.embed`` never consults this registry even on a name
+ * collision. Library search / sessions / rooms have no LLM hop, so there is nothing to intercept.
+ *
+ * The Atrium bearer token **never** reaches these endpoints: this module owns the request, builds
+ * the headers from the endpoint's own key (or none), and the client's direct branch calls the global
+ * ``fetch`` rather than the authenticated transport.
+ *
+ * Python's ``DirectTransports`` (a cached ``httpx.Client`` per endpoint) has no counterpart here —
+ * ``fetch`` is stateless, so there is nothing to pool or close; the per-endpoint ``timeout`` becomes
+ * an ``AbortSignal.timeout`` on each call.
+ */
+/** Default per-request timeout for a direct endpoint, in **milliseconds** (Python's 30 seconds). */
+export declare const DEFAULT_DIRECT_TIMEOUT_MS = 30000;
+/** The construction form of a {@link DirectEndpoint} (what ``addDirectModel`` takes). */
+export interface DirectEndpointInit {
+    /** The endpoint root, including the OpenAI path prefix (e.g. ``http://localhost:11434/v1``). */
+    baseUrl: string;
+    /** Bearer key for the endpoint, or omitted for keyless local servers. */
+    apiKey?: string;
+    /** Per-request timeout in **milliseconds** (default {@link DEFAULT_DIRECT_TIMEOUT_MS}) — raise it
+     * for slow local models. */
+    timeout?: number;
+}
+/**
+ * An OpenAI-compatible endpoint that one or more direct models live at.
+ *
+ * ``apiKey`` rides the endpoint (shared by every model name registered on it, matching how one
+ * server hosts many names); many local servers need none. Chat is POSTed to
+ * ``{baseUrl}/chat/completions`` and ``atrium.discoverModels`` reads ``{baseUrl}/models``.
+ */
+export declare class DirectEndpoint {
+    readonly baseUrl: string;
+    readonly apiKey: string | undefined;
+    readonly timeout: number;
+    constructor(init: DirectEndpointInit);
+    /** The chat-completions URL (absolute — no base_url join ambiguity on the transport). */
+    get chatUrl(): string;
+    /** The model-listing URL for ``atrium.discoverModels``. */
+    get modelsUrl(): string;
+    /**
+     * Auth headers for this endpoint (empty when it needs no key). The Atrium bearer token is
+     * deliberately absent — a direct call must never leak it to a third-party or local endpoint.
+     */
+    headers(): Record<string, string>;
+}
+/**
+ * Accept a {@link DirectEndpoint} or its plain-object construction form; coerce to one. A plain
+ * object without its own ``timeout`` inherits ``defaultTimeout``; an instance is taken as-is.
+ */
+export declare function toDirectEndpoint(value: DirectEndpoint | DirectEndpointInit, defaultTimeout?: number): DirectEndpoint;
+/**
+ * A map of model name → {@link DirectEndpoint}. Explicit per-name registration only.
+ *
+ * A registered name **shadows** an Atrium model of the same name — intentional, and the reason
+ * registration is never auto-enumerated from an endpoint's catalogue.
+ */
+export declare class DirectRegistry {
+    private readonly byName;
+    constructor(models?: Record<string, DirectEndpoint | DirectEndpointInit>, defaultTimeout?: number);
+    /** Register (or overwrite) one name → endpoint mapping. */
+    register(name: string, endpoint: DirectEndpoint): void;
+    /** Remove a name mapping (idempotent — unknown names are ignored). */
+    remove(name: string): void;
+    /** The endpoint a name routes to, or ``undefined`` when it should go to Atrium. */
+    resolve(name: string | undefined): DirectEndpoint | undefined;
+    /** A snapshot of the current name → endpoint mappings. */
+    list(): Record<string, DirectEndpoint>;
+}
+/** Extract model ids from an OpenAI ``GET /models`` response (``{"data": [{"id": …}, …]}``). */
+export declare function parseModelNames(data: unknown): string[];
+/**
+ * POST a chat body to a direct endpoint over the raw global ``fetch`` — never the client's
+ * authenticated transport, so no Atrium credential can ride along. Non-2xx raises {@link APIError},
+ * exactly like the Atrium path. ``signal`` is already linked with the endpoint's timeout.
+ */
+export declare function directFetch(endpoint: DirectEndpoint, url: string, init: RequestInit): Promise<Response>;
+//# sourceMappingURL=direct.d.ts.map

package/dist/direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct.d.ts","sourceRoot":"","sources":["../src/direct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,oGAAoG;AACpG,eAAO,MAAM,yBAAyB,QAAS,CAAA;AAE/C,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAA;IACf,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;gCAC4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;gBAEZ,IAAI,EAAE,kBAAkB;IAMpC,yFAAyF;IACzF,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,2DAA2D;IAC3D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGlC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,GAAG,kBAAkB,EAC1C,cAAc,CAAC,EAAE,MAAM,GACtB,cAAc,CAKhB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAGzD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,CAAC,EAC5D,cAAc,CAAC,EAAE,MAAM;IAOzB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAItD,sEAAsE;IACtE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,mFAAmF;IACnF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS;IAI7D,0DAA0D;IAC1D,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;CAGvC;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAMvD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC,CASnB"}

package/dist/direct.js

@@ -0,0 +1,121 @@
+/**
+ * Client-side direct-model overlay — route a chat call to an OpenAI-compatible endpoint.
+ *
+ * The SDK holds a small **direct registry**: a map of model *name* → {@link DirectEndpoint}. A
+ * chat/agent call naming a registered model is POSTed **directly** to that endpoint (a local Ollama
+ * / LM Studio, or a remote OpenAI-compatible server), bypassing Atrium; every other name goes to
+ * Atrium as usual. This is the client-side twin of the server-side per-user providers (BYOM-A).
+ *
+ * Only **chat** is routed here. Embeddings are never — a stored vector's model is a data contract
+ * with the library's vector space, so ``atrium.embed`` never consults this registry even on a name
+ * collision. Library search / sessions / rooms have no LLM hop, so there is nothing to intercept.
+ *
+ * The Atrium bearer token **never** reaches these endpoints: this module owns the request, builds
+ * the headers from the endpoint's own key (or none), and the client's direct branch calls the global
+ * ``fetch`` rather than the authenticated transport.
+ *
+ * Python's ``DirectTransports`` (a cached ``httpx.Client`` per endpoint) has no counterpart here —
+ * ``fetch`` is stateless, so there is nothing to pool or close; the per-endpoint ``timeout`` becomes
+ * an ``AbortSignal.timeout`` on each call.
+ */
+import { APIError } from "./errors.js";
+import { httpFetch } from "./http.js";
+/** Default per-request timeout for a direct endpoint, in **milliseconds** (Python's 30 seconds). */
+export const DEFAULT_DIRECT_TIMEOUT_MS = 30_000;
+/**
+ * An OpenAI-compatible endpoint that one or more direct models live at.
+ *
+ * ``apiKey`` rides the endpoint (shared by every model name registered on it, matching how one
+ * server hosts many names); many local servers need none. Chat is POSTed to
+ * ``{baseUrl}/chat/completions`` and ``atrium.discoverModels`` reads ``{baseUrl}/models``.
+ */
+export class DirectEndpoint {
+    baseUrl;
+    apiKey;
+    timeout;
+    constructor(init) {
+        this.baseUrl = init.baseUrl.replace(/\/+$/, "");
+        this.apiKey = init.apiKey;
+        this.timeout = init.timeout ?? DEFAULT_DIRECT_TIMEOUT_MS;
+    }
+    /** The chat-completions URL (absolute — no base_url join ambiguity on the transport). */
+    get chatUrl() {
+        return `${this.baseUrl}/chat/completions`;
+    }
+    /** The model-listing URL for ``atrium.discoverModels``. */
+    get modelsUrl() {
+        return `${this.baseUrl}/models`;
+    }
+    /**
+     * Auth headers for this endpoint (empty when it needs no key). The Atrium bearer token is
+     * deliberately absent — a direct call must never leak it to a third-party or local endpoint.
+     */
+    headers() {
+        return this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {};
+    }
+}
+/**
+ * Accept a {@link DirectEndpoint} or its plain-object construction form; coerce to one. A plain
+ * object without its own ``timeout`` inherits ``defaultTimeout``; an instance is taken as-is.
+ */
+export function toDirectEndpoint(value, defaultTimeout) {
+    if (value instanceof DirectEndpoint) {
+        return value;
+    }
+    return new DirectEndpoint({ ...value, timeout: value.timeout ?? defaultTimeout });
+}
+/**
+ * A map of model name → {@link DirectEndpoint}. Explicit per-name registration only.
+ *
+ * A registered name **shadows** an Atrium model of the same name — intentional, and the reason
+ * registration is never auto-enumerated from an endpoint's catalogue.
+ */
+export class DirectRegistry {
+    byName = new Map();
+    constructor(models, defaultTimeout) {
+        for (const [name, endpoint] of Object.entries(models ?? {})) {
+            this.register(name, toDirectEndpoint(endpoint, defaultTimeout));
+        }
+    }
+    /** Register (or overwrite) one name → endpoint mapping. */
+    register(name, endpoint) {
+        this.byName.set(name, endpoint);
+    }
+    /** Remove a name mapping (idempotent — unknown names are ignored). */
+    remove(name) {
+        this.byName.delete(name);
+    }
+    /** The endpoint a name routes to, or ``undefined`` when it should go to Atrium. */
+    resolve(name) {
+        return name === undefined ? undefined : this.byName.get(name);
+    }
+    /** A snapshot of the current name → endpoint mappings. */
+    list() {
+        return Object.fromEntries(this.byName);
+    }
+}
+/** Extract model ids from an OpenAI ``GET /models`` response (``{"data": [{"id": …}, …]}``). */
+export function parseModelNames(data) {
+    const items = data?.data;
+    if (!Array.isArray(items))
+        return [];
+    return items
+        .filter((item) => item && typeof item === "object" && "id" in item)
+        .map((item) => String(item.id));
+}
+/**
+ * POST a chat body to a direct endpoint over the raw global ``fetch`` — never the client's
+ * authenticated transport, so no Atrium credential can ride along. Non-2xx raises {@link APIError},
+ * exactly like the Atrium path. ``signal`` is already linked with the endpoint's timeout.
+ */
+export async function directFetch(endpoint, url, init) {
+    const res = await httpFetch(url, {
+        ...init,
+        headers: { ...endpoint.headers(), ...init.headers },
+    });
+    if (!res.ok) {
+        throw new APIError(res.status, await res.text().catch(() => ""));
+    }
+    return res;
+}
+//# sourceMappingURL=direct.js.map

package/dist/direct.js.map

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

package/dist/index.d.ts

@@ -4,14 +4,20 @@
  * The default entry exposes the framework-agnostic core. React bindings live at the
  * ``hci-atrium/react`` subpath so importing this entry never pulls in React.
  */
-export { type AssetListOptions, Assets, Atrium, type AtriumOptions, type ChatOptions, type CompareOptions, DEFAULT_BASE_URL, type EmbedOptions, type EnrichOptions, Library, type LibraryVectorsOptions, type LiveRoomOptions, type RoomOpenOptions, Rooms, type SearchByExamplesOptions, type SearchOptions, type SessionEventOptions, type SessionEventsOptions, type SessionExportFormat, type SessionListOptions, type SessionStartOptions, Sessions, type SourceImportOptions, Sources, type SourcesSearchOptions, type TagOptions, type TranscribeLiveOptions, type TranscribeOptions, type UploadOptions, } from "./atrium.js";
+export type { AssetMeta } from "./asset-meta.js";
+export { fetchAssetMeta } from "./asset-meta.js";
+export { type AgentOptions, type AssetListOptions, Assets, Atrium, type AtriumOptions, type ChatOptions, type CompareOptions, DEFAULT_BASE_URL, type EmbedOptions, type EnrichOptions, Library, type LibraryVectorsOptions, type LiveRoomOptions, type RoomOpenOptions, Rooms, type SearchByExamplesOptions, type SearchOptions, type SessionEventOptions, type SessionEventsOptions, type SessionExportFormat, type SessionListOptions, type SessionStartOptions, Sessions, type SourceImportOptions, Sources, type SourcesSearchOptions, type SurveyResponsesOptions, type SurveyStartOptions, Surveys, type SurveyTemplateOptions, type SurveyUploadOptions, type TagOptions, type TranscribeLiveOptions, type TranscribeOptions, type UploadOptions, } from "./atrium.js";
 export type { ChangeListener, ErrorListener, SignInOptions } from "./auth.js";
 export { Auth } from "./auth.js";
 export { type AnchorLike, type AssetOperand, by, type ConceptOperand, type FileOperand, type Operand, type OperandLike, type TextOperand, toAnchorMembers, type VectorOperand, } from "./by.js";
+export { type ButtonOptions, type CandidateLike, type DashButtonHandler, Dashboard, type DashboardOptions, type DashboardRoom, type DashControlResult, type DashNoteHandler, type DashTextHandler, type DecisionCandidate, type DecisionTileOptions, type ImageTileOptions, type SoundTileOptions, type StatusTileOptions, type TextInputOptions, type TileOptions, } from "./dash.js";
 export { Decider } from "./decider.js";
+export { DEFAULT_DIRECT_TIMEOUT_MS, DirectEndpoint, type DirectEndpointInit, DirectRegistry, } from "./direct.js";
 export { APIError, AtriumError, AuthError, InvalidArgumentError, StructuredOutputError, TransientAuthError, } from "./errors.js";
 export type { FileSource } from "./files.js";
-export { Asset, type AssetBinder, type AssetPage, type AssetRef, type AssetVector, type AssetVectorsOptions, assetCapabilities, assetPlayback, type Candidate, type ChatReply, type CompareFeature, type CompareResult, type Event, type Filters, type IndexEntry, type OperandInfo, type RoomInfo, type SearchByExamplesHit, type SearchHit, type SegmentRef, type Session, type SessionEvent, type SessionInfo, type SourceInfo, type SourceSearchResult, type SourceSkip, type Space, type TagDefinition, type TagSnapshot, type TagSnapshotFeature, type Transcript, type User, } from "./models.js";
+export { Asset, type AssetBinder, type AssetPage, type AssetRef, type AssetVector, type AssetVectorsOptions, assetCapabilities, assetPlayback, type Candidate, type ChatReply, type CompareFeature, type CompareResult, type Event, type Filters, type IndexEntry, type OperandInfo, type ProjectFile, type RoomInfo, type SearchByExamplesHit, type SearchHit, type SegmentRef, type Session, type SessionEvent, type SessionInfo, type SourceInfo, type SourceSearchResult, type SourceSkip, type Space, type Survey, type SurveyResponse, type SurveyTemplate, type TagDefinition, type TagSnapshot, type TagSnapshotFeature, type Transcript, type User, } from "./models.js";
 export { type ActiveSource, ArmedSet, AUDIO_ROLE, AUDIO_SIGNAL, AUDIO_SNIPPET_CONSUMER_ROLE, AUDIO_SNIPPET_MAGIC, AUDIO_SNIPPET_SOURCE_ROLE, AUDIO_SNIPPET_VERSION, AUDIO_SNIPPET_VERSION_2, type AudioAnnounce, type AudioBeatEvent, type AudioClip, type AudioFrame, type AudioInputKind, type AudioSignal, type AudioSnippetFrame, type AudioTrack, type AudioVector, BrokerError, CAPTURE_OFFER_ROLE, CAPTURE_SOURCE_ROLE, type CaptureOfferDeps, type CaptureRecorder, CHAT_BROKER_ROLE, DEFAULT_CHAT_MAX_TOKENS, DEFAULT_MAX_ANCHORS, decodeAudioFrame, decodeAudioSnippetFrame, EMBED_BROKER_ROLE, encodeAudioFrame, type FetchImpl, type Handler, isAudioFrame, isAudioSnippetFrame, type JoinRoomOptions, joinRoom, OFFER_MAX_SOURCES, type OfferDeps, OfferedCapture, OfferedTranscription, type Participant, type ParticipantPredicate, Recorder, type RecorderStopReason, Room, type RoomAudioClient, type RoomDeps, type RoomEndReason, type RoomEvent, RoomEventStream, type RoomSignal, type RoomTransport, type RoomTransportMode, type RosterEntry, type ScoredAudio, StandingSource, TRANSCRIBER_SOURCE, TRANSCRIPTION_OFFER_ROLE, Transcriber, type TranscriberDeps, type TranscriptionOfferDeps, validateChatMessages, type WebSocketCtor, type WebSocketLike, } from "./rooms/index.js";
+export { isStandardSchema, type StandardSchemaV1, type ToolDescriptor, type ToolJsonSchema, type ToolParameters, toolSchema, } from "./tools.js";
+export { isTraceEphemeral, RoomTrace, TRACE_STATE, type TraceSink, traceCallType, traceEnvelope, traceStateType, } from "./trace.js";
 export type { AudioChunk } from "./transcribe.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -4,11 +4,16 @@
  * The default entry exposes the framework-agnostic core. React bindings live at the
  * ``hci-atrium/react`` subpath so importing this entry never pulls in React.
  */
-export { Assets, Atrium, DEFAULT_BASE_URL, Library, Rooms, Sessions, Sources, } from "./atrium.js";
+export { fetchAssetMeta } from "./asset-meta.js";
+export { Assets, Atrium, DEFAULT_BASE_URL, Library, Rooms, Sessions, Sources, Surveys, } from "./atrium.js";
 export { Auth } from "./auth.js";
 export { by, toAnchorMembers, } from "./by.js";
+export { Dashboard, } from "./dash.js";
 export { Decider } from "./decider.js";
+export { DEFAULT_DIRECT_TIMEOUT_MS, DirectEndpoint, DirectRegistry, } from "./direct.js";
 export { APIError, AtriumError, AuthError, InvalidArgumentError, StructuredOutputError, TransientAuthError, } from "./errors.js";
 export { Asset, assetCapabilities, assetPlayback, } from "./models.js";
 export { ArmedSet, AUDIO_ROLE, AUDIO_SIGNAL, AUDIO_SNIPPET_CONSUMER_ROLE, AUDIO_SNIPPET_MAGIC, AUDIO_SNIPPET_SOURCE_ROLE, AUDIO_SNIPPET_VERSION, AUDIO_SNIPPET_VERSION_2, BrokerError, CAPTURE_OFFER_ROLE, CAPTURE_SOURCE_ROLE, CHAT_BROKER_ROLE, DEFAULT_CHAT_MAX_TOKENS, DEFAULT_MAX_ANCHORS, decodeAudioFrame, decodeAudioSnippetFrame, EMBED_BROKER_ROLE, encodeAudioFrame, isAudioFrame, isAudioSnippetFrame, joinRoom, OFFER_MAX_SOURCES, OfferedCapture, OfferedTranscription, Recorder, Room, RoomEventStream, StandingSource, TRANSCRIBER_SOURCE, TRANSCRIPTION_OFFER_ROLE, Transcriber, validateChatMessages, } from "./rooms/index.js";
+export { isStandardSchema, toolSchema, } from "./tools.js";
+export { isTraceEphemeral, RoomTrace, TRACE_STATE, traceCallType, traceEnvelope, traceStateType, } from "./trace.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,MAAM,EACN,MAAM,EAIN,gBAAgB,EAGhB,OAAO,EAIP,KAAK,EAQL,QAAQ,EAER,OAAO,GAMR,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAGL,EAAE,EAMF,eAAe,GAEhB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,KAAK,EAML,iBAAiB,EACjB,aAAa,GAyBd,MAAM,aAAa,CAAA;AACpB,OAAO,EAEL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,2BAA2B,EAC3B,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EAUvB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EAGnB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAGhB,YAAY,EACZ,mBAAmB,EAEnB,QAAQ,EACR,iBAAiB,EAEjB,cAAc,EACd,oBAAoB,EAGpB,QAAQ,EAER,IAAI,EAKJ,eAAe,EAMf,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,EAGX,oBAAoB,GAGrB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAGL,MAAM,EACN,MAAM,EAIN,gBAAgB,EAGhB,OAAO,EAIP,KAAK,EAQL,QAAQ,EAER,OAAO,EAIP,OAAO,GAOR,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAGL,EAAE,EAMF,eAAe,GAEhB,MAAM,SAAS,CAAA;AAChB,OAAO,EAIL,SAAS,GAaV,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACL,yBAAyB,EACzB,cAAc,EAEd,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,KAAK,EAML,iBAAiB,EACjB,aAAa,GA6Bd,MAAM,aAAa,CAAA;AACpB,OAAO,EAEL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,2BAA2B,EAC3B,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EAUvB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EAGnB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAGhB,YAAY,EACZ,mBAAmB,EAEnB,QAAQ,EACR,iBAAiB,EAEjB,cAAc,EACd,oBAAoB,EAGpB,QAAQ,EAER,IAAI,EAKJ,eAAe,EAMf,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,EAGX,oBAAoB,GAGrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,gBAAgB,EAKhB,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,WAAW,EAEX,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAA"}