hci-atrium 0.2.0 → 0.3.1

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,2DAA2D;AAC3D,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,KAAK,cAAc,CAAC,MAAM,IACtB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAEjF;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,OAAO;IAChD,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;QACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;KACnF,CAAA;CACF;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAED,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAA;AAErE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mEAAmE;IACnE,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACnE;AAID,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAO1E;AA+BD,kGAAkG;AAClG,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUxE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwBlC;AAED,kFAAkF;AAClF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,EAAE,CAW1E"}

package/dist/tools.js

@@ -0,0 +1,105 @@
+/**
+ * Tool descriptors for {@link ../atrium.Atrium.agent} — the TypeScript answer to Python's
+ * ``@client.tool`` decorator.
+ *
+ * Python derives a tool's OpenAI schema from the function's signature + docstring (``_tools.py``).
+ * TypeScript has neither at runtime — types are erased and there are no docstrings — so a tool is
+ * an **explicit descriptor**: ``{ name, description, parameters, execute }``. That keeps the SDK's
+ * zero-runtime-dependency promise (no schema library is pulled in to make ``agent`` work) and keeps
+ * the emitted wire honest: what you write is what the model sees.
+ *
+ * ``parameters`` accepts either shape:
+ *
+ * - **plain JSON Schema** — ``{ type: "object", properties: {…}, required: […] }``, sent verbatim.
+ * - **``{ jsonSchema, validate? }``** — the same JSON Schema, plus an optional validator. Any object
+ *   implementing the [Standard Schema](https://standardschema.dev) interface (the ``~standard``
+ *   property — Zod ≥3.24, Valibot, ArkType, …) works as the validator: the model's arguments are
+ *   run through it before ``execute`` sees them.
+ *
+ * A bare Standard-Schema object (a Zod schema on its own) is **rejected**: the SDK can validate with
+ * it but cannot emit JSON Schema from it without taking on the library as a dependency. Pass
+ * ``parameters: { jsonSchema, validate: schema }`` instead — one line, and the wire stays explicit.
+ */
+import { InvalidArgumentError } from "./errors.js";
+const EMPTY_SCHEMA = { type: "object", properties: {}, required: [] };
+/** True when ``value`` implements the Standard Schema interface. */
+export function isStandardSchema(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "~standard" in value &&
+        typeof value["~standard"]?.validate === "function");
+}
+function isToolJsonSchema(value) {
+    return "jsonSchema" in value && typeof value.jsonSchema === "object";
+}
+/** The JSON Schema a descriptor puts on the wire, and its validator (when one was given). */
+function splitParameters(tool) {
+    const params = tool.parameters;
+    if (params === undefined) {
+        return { jsonSchema: { ...EMPTY_SCHEMA } };
+    }
+    if (isToolJsonSchema(params)) {
+        return { jsonSchema: params.jsonSchema, validate: params.validate };
+    }
+    if (isStandardSchema(params)) {
+        throw new InvalidArgumentError(`tool ${JSON.stringify(tool.name)}: a ${params["~standard"].vendor} schema can validate arguments but the SDK can't derive JSON Schema from it (that would ` +
+            "mean depending on the library). Pass parameters: { jsonSchema: { type: 'object', … }, " +
+            "validate: yourSchema } — the JSON Schema goes on the wire, the schema validates the " +
+            "model's arguments.");
+    }
+    return { jsonSchema: params };
+}
+/** The OpenAI ``tools`` entry for one descriptor (the twin of Python's ``build_tool_schema``). */
+export function toolSchema(tool) {
+    const { jsonSchema } = splitParameters(tool);
+    return {
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description ?? "",
+            parameters: jsonSchema,
+        },
+    };
+}
+/**
+ * Parse (and optionally validate) the arguments of one tool call. ``raw`` is the model's
+ * ``function.arguments`` JSON string — malformed JSON or a validation failure raises
+ * {@link InvalidArgumentError}, mirroring how a bad call surfaces out of Python's ``fn(**args)``.
+ */
+export async function parseToolArguments(tool, raw) {
+    let args;
+    try {
+        args = JSON.parse(raw || "{}");
+    }
+    catch (err) {
+        throw new InvalidArgumentError(`tool ${JSON.stringify(tool.name)}: the model's arguments were not valid JSON ` +
+            `(${err.message}): ${String(raw).slice(0, 200)}`);
+    }
+    const { validate } = splitParameters(tool);
+    if (!validate) {
+        return args && typeof args === "object" ? args : {};
+    }
+    const result = await validate["~standard"].validate(args);
+    if (result.issues) {
+        const detail = result.issues.map((issue) => issue.message).join("; ");
+        throw new InvalidArgumentError(`tool ${JSON.stringify(tool.name)}: the model's arguments failed validation: ${detail}`);
+    }
+    return result.value && typeof result.value === "object"
+        ? result.value
+        : {};
+}
+/** The tool calls in an assistant message (``message.tool_calls``), or an empty list. */
+export function readToolCalls(message) {
+    const calls = message.tool_calls;
+    if (!Array.isArray(calls))
+        return [];
+    return calls.map((call) => {
+        const c = (call ?? {});
+        return {
+            id: String(c.id ?? ""),
+            name: String(c.function?.name ?? ""),
+            arguments: typeof c.function?.arguments === "string" ? c.function.arguments : "",
+        };
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/trace.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Room tracing — the machinery behind ``room.trace()``. The TypeScript port of Python's ``_trace.py``
+ * (envelope + summaries + the instrumentation seam) and its room-side sink (``_AsyncRoomTrace``).
+ *
+ * Tracing mirrors into a room, as ``trace.*`` signals, what the SDK is doing on the same client:
+ * library/model calls (``trace.<label>`` — ``trace.chat`` / ``trace.library.search`` / ``trace.play``)
+ * and SDK-internal state changes (``trace.state.<label>`` — ``trace.state.recorder`` / …). Folding the
+ * operation into the type lets a dashboard's type column and filters tell a search from a play without
+ * opening the payload; ``label`` stays in the payload for renderers and older consumers. Ephemerality
+ * is per-signal (see {@link isTraceEphemeral}). It is OFF by default — one ``room.trace()`` call arms
+ * it — and a trace failure never breaks the traced call (every emit path suppresses + logs).
+ *
+ * {@link traced} wraps a funnelled client method with a zero-cost fast path (no armed sink → straight
+ * through). The per-method *summaries* live here so every call site shares one honest one-line glance.
+ *
+ * Divergence from Python (deliberate): Python needs a ``contextvars`` re-entrancy guard because its
+ * structured-output ``chat`` recurses through the *traced* ``chat``. The TS client's structured path
+ * recurses through the **untraced** inner ``chatOnce`` instead, so one logical call emits exactly one
+ * trace with no task-local state — same contract, no guard.
+ */
+/** The state-signal namespace. A state trace folds its component label into the type as
+ * ``trace.state.<label>`` (``trace.state.recorder`` / ``trace.state.transcriber`` / …). */
+export declare const TRACE_STATE = "trace.state";
+/** The signal type for a call trace — the operation folded into the type (``trace.<label>``:
+ * ``trace.chat``, ``trace.library.search``, ``trace.play``). ``label`` still rides the payload. */
+export declare function traceCallType(label: string): string;
+/** The signal type for a state trace (``trace.state.<label>``: ``trace.state.recorder``, …). */
+export declare function traceStateType(label: string): string;
+/**
+ * Whether a trace signal rides the room ephemerally (recorders skip it) or durably (a recorder
+ * captures it into the session).
+ *
+ * The rule: a trace mirror is DURABLE unless the action it mirrors already rides the room durably.
+ *
+ * * ``trace.chat`` / ``trace.library.*`` — durable: they happen OUTSIDE the room, so the trace is
+ *   their only record; for a study it IS the record.
+ * * ``trace.play`` — ephemeral: the raw ``play`` control send already rides the room durably, so a
+ *   durable mirror would double-record every play in the session.
+ * * ``trace.state.*`` — ephemeral: liveness chatter (recorder / transcriber / offer transitions).
+ */
+export declare function isTraceEphemeral(type: string): boolean;
+/** Build the ``trace.*`` payload: a label, one glanceable summary line, an optional detail object,
+ * and a client timestamp (epoch-ms). */
+export declare function traceEnvelope(label: string, summary: string, detail?: Record<string, unknown>): Record<string, unknown>;
+/** Where a trace goes: an armed {@link RoomTrace}. Kept as an interface so the client's sink list
+ * doesn't depend on the rooms module. */
+export interface TraceSink {
+    emit(type: string, payload: Record<string, unknown>): Promise<void>;
+}
+/** A per-method summary: the traced call's arguments, its result, and the elapsed ms →
+ * ``[summary, detail]``. Must not throw (the caller suppresses regardless, but a total summary is
+ * the whole point). */
+export type Summarizer = (args: Record<string, unknown>, result: unknown, dtMs: number) => [string, Record<string, unknown>];
+/** Glance for ``library.search`` — subject (query / ``like`` operand), hit count + top match. */
+export declare const summarizeSearch: Summarizer;
+/** Glance for ``library.searchByExamples`` — example count, method, hit count + top match. */
+export declare const summarizeSearchByExamples: Summarizer;
+/** Glance for ``library.enrich`` — query + modality, plus any scalar counts the call returns. */
+export declare const summarizeEnrich: Summarizer;
+/** Glance for ``room.play`` — a ``▶`` line naming the track(s), with mode + layer detail. */
+export declare const summarizePlay: Summarizer;
+/** Glance for ``chat`` — the answering model + duration, plus a short reply preview. */
+export declare const summarizeChat: Summarizer;
+/**
+ * Run ``fn``, mirroring it into every armed ``sinks`` as a ``trace.<label>``. Zero-cost when nothing
+ * is tracing (one length check — the summarizer never runs), and a trace failure is swallowed: the
+ * traced call's result always comes back. A call that *raises* emits nothing (mirror of Python's
+ * decorator, whose emit sits after the awaited call).
+ */
+export declare function traced<T>(sinks: TraceSink[] | undefined, label: string, args: Record<string, unknown>, summarize: Summarizer, fn: () => Promise<T>): Promise<T>;
+/** How a {@link RoomTrace} publishes — the room's REST ``/signal`` POST (the WS inbound path forces
+ * ``ephemeral: false``, and trace ephemerality is per-signal). Wired by ``room.trace()``. */
+export interface RoomTraceDeps {
+    publish(type: string, payload: Record<string, unknown>, opts: {
+        ephemeral: boolean;
+    }): Promise<void>;
+    /** Unregister from the client's call sinks + the room's own list (called once, by {@link RoomTrace.stop}). */
+    onStop(): void;
+}
+/**
+ * A live tracing session on one room — the handle ``room.trace()`` returns (port of Python's
+ * ``_AsyncRoomTrace``). Stop it with ``stop()`` (idempotent), the room's ``close()``, or
+ * ``using t = room.trace()``.
+ */
+export declare class RoomTrace implements TraceSink {
+    private readonly deps;
+    private live;
+    constructor(deps: RoomTraceDeps);
+    /** True until {@link stop} (or the room's teardown) ends this tracing session. */
+    get alive(): boolean;
+    emit(type: string, payload: Record<string, unknown>): Promise<void>;
+    /** Stop tracing (idempotent) — unregisters from the client's call sinks and the room. */
+    stop(): void;
+    [Symbol.dispose]: () => void;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;2FAC2F;AAC3F,eAAO,MAAM,WAAW,gBAAgB,CAAA;AAOxC;mGACmG;AACnG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAItD;AAED;wCACwC;AACxC,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB;AAED;yCACyC;AACzC,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpE;AAED;;uBAEuB;AACvB,MAAM,MAAM,UAAU,GAAG,CACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,KACT,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAiDtC,iGAAiG;AACjG,eAAO,MAAM,eAAe,EAAE,UAe7B,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,yBAAyB,EAAE,UASvC,CAAA;AAED,iGAAiG;AACjG,eAAO,MAAM,eAAe,EAAE,UAiB7B,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,aAAa,EAAE,UAoB3B,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,aAAa,EAAE,UAO3B,CAAA;AAID;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAC9B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,UAAU,EACrB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ;AAED;6FAC6F;AAC7F,MAAM,WAAW,aAAa;IAC5B,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,8GAA8G;IAC9G,MAAM,IAAI,IAAI,CAAA;CACf;AAED;;;;GAIG;AACH,qBAAa,SAAU,YAAW,SAAS;IAG7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,IAAI,CAAO;gBAEU,IAAI,EAAE,aAAa;IAEhD,kFAAkF;IAClF,IAAI,KAAK,IAAI,OAAO,CAEnB;IAEK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzE,yFAAyF;IACzF,IAAI,IAAI,IAAI;IAOJ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrC"}

package/dist/trace.js

@@ -0,0 +1,251 @@
+/**
+ * Room tracing — the machinery behind ``room.trace()``. The TypeScript port of Python's ``_trace.py``
+ * (envelope + summaries + the instrumentation seam) and its room-side sink (``_AsyncRoomTrace``).
+ *
+ * Tracing mirrors into a room, as ``trace.*`` signals, what the SDK is doing on the same client:
+ * library/model calls (``trace.<label>`` — ``trace.chat`` / ``trace.library.search`` / ``trace.play``)
+ * and SDK-internal state changes (``trace.state.<label>`` — ``trace.state.recorder`` / …). Folding the
+ * operation into the type lets a dashboard's type column and filters tell a search from a play without
+ * opening the payload; ``label`` stays in the payload for renderers and older consumers. Ephemerality
+ * is per-signal (see {@link isTraceEphemeral}). It is OFF by default — one ``room.trace()`` call arms
+ * it — and a trace failure never breaks the traced call (every emit path suppresses + logs).
+ *
+ * {@link traced} wraps a funnelled client method with a zero-cost fast path (no armed sink → straight
+ * through). The per-method *summaries* live here so every call site shares one honest one-line glance.
+ *
+ * Divergence from Python (deliberate): Python needs a ``contextvars`` re-entrancy guard because its
+ * structured-output ``chat`` recurses through the *traced* ``chat``. The TS client's structured path
+ * recurses through the **untraced** inner ``chatOnce`` instead, so one logical call emits exactly one
+ * trace with no task-local state — same contract, no guard.
+ */
+/** The state-signal namespace. A state trace folds its component label into the type as
+ * ``trace.state.<label>`` (``trace.state.recorder`` / ``trace.state.transcriber`` / …). */
+export const TRACE_STATE = "trace.state";
+/** Cap on how many results ride a call's ``detail`` — a glanceable top-N, never the full payload. */
+const DETAIL_TOP_N = 5;
+/** Cap on a chat reply preview stashed in ``detail`` (never the whole completion). */
+const REPLY_PREVIEW = 200;
+/** The signal type for a call trace — the operation folded into the type (``trace.<label>``:
+ * ``trace.chat``, ``trace.library.search``, ``trace.play``). ``label`` still rides the payload. */
+export function traceCallType(label) {
+    return `trace.${label}`;
+}
+/** The signal type for a state trace (``trace.state.<label>``: ``trace.state.recorder``, …). */
+export function traceStateType(label) {
+    return `${TRACE_STATE}.${label}`;
+}
+/**
+ * Whether a trace signal rides the room ephemerally (recorders skip it) or durably (a recorder
+ * captures it into the session).
+ *
+ * The rule: a trace mirror is DURABLE unless the action it mirrors already rides the room durably.
+ *
+ * * ``trace.chat`` / ``trace.library.*`` — durable: they happen OUTSIDE the room, so the trace is
+ *   their only record; for a study it IS the record.
+ * * ``trace.play`` — ephemeral: the raw ``play`` control send already rides the room durably, so a
+ *   durable mirror would double-record every play in the session.
+ * * ``trace.state.*`` — ephemeral: liveness chatter (recorder / transcriber / offer transitions).
+ */
+export function isTraceEphemeral(type) {
+    return (type === traceCallType("play") || type === TRACE_STATE || type.startsWith(`${TRACE_STATE}.`));
+}
+/** Build the ``trace.*`` payload: a label, one glanceable summary line, an optional detail object,
+ * and a client timestamp (epoch-ms). */
+export function traceEnvelope(label, summary, detail) {
+    const payload = { label, summary, t: Date.now() };
+    if (detail !== undefined)
+        payload.detail = detail;
+    return payload;
+}
+function assetTitle(asset) {
+    const title = asset?.title;
+    if (title)
+        return String(title);
+    const id = asset?.id;
+    return id ? String(id).slice(0, 8) : "?";
+}
+function hitScore(hit) {
+    const score = Number(hit?.score);
+    return Number.isFinite(score) ? score : 0;
+}
+function hitLine(hit) {
+    return {
+        id: hit?.asset?.id ?? null,
+        title: assetTitle(hit?.asset),
+        score: Math.round(hitScore(hit) * 1000) / 1000,
+    };
+}
+/** `` (top: <title> <score>)`` for the best hit, or empty when there are none. */
+function topClause(hits) {
+    const top = hits[0];
+    if (!top)
+        return "";
+    return ` (top: ${assetTitle(top.asset)} ${hitScore(top).toFixed(2)})`;
+}
+/** A short glance at a ``like=`` / example operand — an id or a string, never a vector. */
+function operandRef(value) {
+    if (value === null || value === undefined)
+        return "?";
+    if (typeof value === "string")
+        return value.slice(0, 40);
+    const obj = value;
+    if (obj.asset !== undefined)
+        return String(obj.asset?.id ?? "?").slice(0, 12);
+    return obj.id ? String(obj.id).slice(0, 12) : typeof value;
+}
+function asHits(result) {
+    return Array.isArray(result) ? result : [];
+}
+/** Glance for ``library.search`` — subject (query / ``like`` operand), hit count + top match. */
+export const summarizeSearch = (args, result) => {
+    const query = args.query || "";
+    const like = args.like;
+    const hits = asHits(result);
+    const capped = hits.slice(0, DETAIL_TOP_N);
+    const subject = query
+        ? `"${query}"`
+        : like !== undefined && like !== null
+            ? `like ${operandRef(like)}`
+            : "search";
+    const summary = `${subject} → ${hits.length} hits${topClause(capped)}`;
+    const detail = { hits: capped.map(hitLine) };
+    if (query)
+        detail.query = query;
+    if (like !== undefined && like !== null)
+        detail.like = operandRef(like);
+    return [summary, detail];
+};
+/** Glance for ``library.searchByExamples`` — example count, method, hit count + top match. */
+export const summarizeSearchByExamples = (args, result) => {
+    const positives = Array.isArray(args.positives) ? args.positives : [];
+    const hits = asHits(result);
+    const capped = hits.slice(0, DETAIL_TOP_N);
+    const summary = `${positives.length} example(s) → ${hits.length} hits${topClause(capped)}`;
+    return [
+        summary,
+        { examples: positives.length, method: args.method ?? null, hits: capped.map(hitLine) },
+    ];
+};
+/** Glance for ``library.enrich`` — query + modality, plus any scalar counts the call returns. */
+export const summarizeEnrich = (args, result) => {
+    const query = args.query || "";
+    const modality = args.modality ?? null;
+    let summary = `enrich "${query}" (${modality})`;
+    const detail = { query, modality };
+    // ``enrich`` returns a free-form payload — surface only its scalar fields (counts, status), never
+    // nested candidate lists.
+    if (result && typeof result === "object" && !Array.isArray(result)) {
+        const counts = [];
+        for (const [k, v] of Object.entries(result)) {
+            if (typeof v !== "number" && typeof v !== "string" && typeof v !== "boolean")
+                continue;
+            detail[k] = v;
+            if (typeof v === "number" && Number.isInteger(v))
+                counts.push(`${k} ${v}`);
+        }
+        if (counts.length > 0)
+            summary += ` → ${counts.slice(0, 3).join(", ")}`;
+    }
+    return [summary, detail];
+};
+/** Glance for ``room.play`` — a ``▶`` line naming the track(s), with mode + layer detail. */
+export const summarizePlay = (args) => {
+    const source = args.source;
+    const layer = args.layer;
+    const mode = args.mode ?? null;
+    let desc;
+    let tracks = 1;
+    if (Array.isArray(source)) {
+        tracks = source.length;
+        desc = `${tracks} tracks`;
+    }
+    else if (typeof source === "string") {
+        desc = source.slice(0, 40);
+    }
+    else if (source && typeof source === "object") {
+        const s = source;
+        desc = String(s.title ?? s.asset_id ?? s.id ?? "track");
+    }
+    else {
+        desc = operandRef(source);
+    }
+    const detail = { tracks, mode };
+    if (layer)
+        detail.layer = layer;
+    return [`▶ ${desc}`, detail];
+};
+/** Glance for ``chat`` — the answering model + duration, plus a short reply preview. */
+export const summarizeChat = (args, result, dtMs) => {
+    const replied = result?.model;
+    const model = String(replied || args.model || "default");
+    const detail = { model, duration_ms: Math.round(dtMs) };
+    const content = result?.content;
+    if (typeof content === "string")
+        detail.reply = content.slice(0, REPLY_PREVIEW);
+    return [`chat ${model}: ${(dtMs / 1000).toFixed(1)}s`, detail];
+};
+// --- the instrumentation seam --------------------------------------------------------------------
+/**
+ * Run ``fn``, mirroring it into every armed ``sinks`` as a ``trace.<label>``. Zero-cost when nothing
+ * is tracing (one length check — the summarizer never runs), and a trace failure is swallowed: the
+ * traced call's result always comes back. A call that *raises* emits nothing (mirror of Python's
+ * decorator, whose emit sits after the awaited call).
+ */
+export async function traced(sinks, label, args, summarize, fn) {
+    if (!sinks || sinks.length === 0)
+        return fn();
+    const t0 = Date.now();
+    const result = await fn();
+    const dtMs = Date.now() - t0;
+    try {
+        const [summary, detail] = summarize(args, result, dtMs);
+        const payload = traceEnvelope(label, summary, detail);
+        for (const sink of [...sinks])
+            await sink.emit(traceCallType(label), payload);
+    }
+    catch (err) {
+        // A trace must never break the traced call.
+        console.debug(`Atrium trace: emit failed for ${label}:`, err);
+    }
+    return result;
+}
+/**
+ * A live tracing session on one room — the handle ``room.trace()`` returns (port of Python's
+ * ``_AsyncRoomTrace``). Stop it with ``stop()`` (idempotent), the room's ``close()``, or
+ * ``using t = room.trace()``.
+ */
+export class RoomTrace {
+    deps;
+    live = true;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** True until {@link stop} (or the room's teardown) ends this tracing session. */
+    get alive() {
+        return this.live;
+    }
+    async emit(type, payload) {
+        if (!this.live)
+            return;
+        try {
+            await this.deps.publish(type, payload, { ephemeral: isTraceEphemeral(type) });
+        }
+        catch (err) {
+            // A trace emit must never break the traced call or state change.
+            console.debug("Atrium trace: publish failed:", err);
+        }
+    }
+    /** Stop tracing (idempotent) — unregisters from the client's call sinks and the room. */
+    stop() {
+        if (!this.live)
+            return;
+        this.live = false;
+        this.deps.onStop();
+    }
+}
+if (typeof Symbol.dispose === "symbol") {
+    RoomTrace.prototype[Symbol.dispose] = function () {
+        this.stop();
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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

package/dist/transcribe.d.ts

@@ -50,6 +50,11 @@ export interface TranscribeStreamOptions {
     /** Injected ``WebSocket`` constructor for the stream handshake (defaults to the runtime global) —
      * the test seam / Node <22 escape hatch. */
     webSocketCtor?: WebSocketCtor;
+    /** Replace the default per-clip batch fallback (used only when the streaming route can't be
+     * reached). The seam {@link ../rooms/room.Room.audioTranscripts} uses so each degraded transcript
+     * can carry its source snippet — mirror of Python's ``_transcribe_engine(fallback=…)``. It owns the
+     * clip source, so ``clips`` is left untouched when it runs. */
+    fallback?: () => AsyncIterable<Transcript>;
 }
 /** 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. */

package/dist/transcribe.d.ts.map

@@ -1 +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"}
+{"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;IAC7B;;;mEAG+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAA;CAC3C;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

@@ -34,7 +34,7 @@ export async function* transcribeEngine(deps, clips, opts) {
     }
     catch (err) {
         if (err instanceof StreamUnavailable) {
-            yield* transcribeFallbackClips(deps, clips, opts);
+            yield* opts.fallback ? opts.fallback() : transcribeFallbackClips(deps, clips, opts);
             return;
         }
         throw err; // AuthError propagates

package/dist/transcribe.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hci-atrium",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "TypeScript SDK for the Atrium framework — multimodal asset library, semantic + cross-modal search, and capability routing.",
   "type": "module",
   "license": "MIT",