hci-atrium 0.1.0

package/dist/by.js

@@ -0,0 +1,87 @@
+/**
+ * The ``by`` operand grammar — how ``searchByExamples`` (and, later, ``compare``) names a thing to
+ * embed. The TypeScript mirror of ``hci_atrium._operands``.
+ *
+ * Decision 9: no bare ``number[]`` heuristic. A raw vector is *always* explicit — ``by.vector([…])``
+ * — because a bare array is otherwise ambiguous (a few-shot list vs. a vector). Every operand is a
+ * member of a discriminated union keyed on ``kind``. ``by.text`` / ``by.asset`` disambiguate the
+ * two cases whose bare form clashes (a text string vs. an id string; a text string vs. a file);
+ * ``by.file`` / ``by.concept`` have no bare form.
+ *
+ * ```ts
+ * import { by } from "hci-atrium"
+ * client.library.searchByExamples([hit.asset, by.asset("uuid")])
+ * ```
+ */
+import { InvalidArgumentError } from "./errors.js";
+/** Explicit operand constructors. */
+export const by = {
+    /** An existing library asset, by object or id. */
+    asset(asset) {
+        return { kind: "asset", assetId: typeof asset === "string" ? asset : asset.id };
+    },
+    /** A file to embed in-flight. Pass ``format`` (e.g. ``"wav"``) for raw bytes with no type. */
+    file(source, opts = {}) {
+        return { kind: "file", file: source, format: opts.format };
+    },
+    /** A text query (the explicit form of a bare string). */
+    text(text) {
+        return { kind: "text", text };
+    },
+    /** A raw embedding vector (the explicit form there is no bare form for). */
+    vector(vector) {
+        return { kind: "vector", vector: vector.map(Number) };
+    },
+    /** A tag's concept classifier, by name (scoped to ``collection``'s chain) or id. */
+    concept(nameOrId, opts = {}) {
+        return { kind: "concept", name: nameOrId, collection: opts.collection };
+    },
+};
+function isAsset(value) {
+    return typeof value === "object" && "id" in value && !("kind" in value);
+}
+/** Normalize a call-site value to an {@link Operand} using the bare-value rules. */
+export function toOperand(value) {
+    if (typeof value === "string") {
+        return { kind: "text", text: value };
+    }
+    if (isAsset(value)) {
+        return { kind: "asset", assetId: value.id };
+    }
+    return value;
+}
+/** Whether a bare array is a raw vector (all plain finite numbers) rather than a few-shot list of
+ * anchor members — the same bare-value rule {@link toOperand} applies to a plain array. */
+function isVector(value) {
+    return value.length === 0 || value.every((x) => typeof x === "number");
+}
+/**
+ * Resolve one ``audioScores`` anchor's value to its member {@link Operand}(s): a scalar is a
+ * single-member anchor; an array that *isn't* a raw vector is a few-shot category (each member
+ * resolved by the normal bare-value rules, so a nested ``number[]`` member is still a vector).
+ * Mirror of Python's ``to_anchor_members``.
+ */
+export function toAnchorMembers(value) {
+    if (Array.isArray(value) && !isVector(value)) {
+        if (value.length === 0) {
+            throw new InvalidArgumentError("an anchor's few-shot list must not be empty");
+        }
+        return value.map(toOperand);
+    }
+    // A scalar or a raw vector (``number[]``), both an OperandLike.
+    return [toOperand(value)];
+}
+/**
+ * Resolve a ``searchByExamples`` seed to an asset id. v1 seeds are assets only — an {@link Asset}
+ * object or ``by.asset(id)``. A bare string is a *text* query in the grammar (not a valid seed
+ * yet), so it is rejected with a pointer to ``by.asset(...)``.
+ */
+export function seedAssetId(value) {
+    const op = toOperand(value);
+    if (op.kind !== "asset") {
+        throw new InvalidArgumentError("searchByExamples seeds must be assets — pass an Asset object or by.asset(id) " +
+            `(got a ${op.kind} operand)`);
+    }
+    return op.assetId;
+}
+//# sourceMappingURL=by.js.map

package/dist/by.js.map

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

package/dist/decider.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Reactive helpers — a small, framework-free stateful policy over a live score stream (e.g. the
+ * per-anchor scores a soundscape derives each frame). No transport dependency; pure and easy to
+ * unit-test. A line-for-line port of ``hci_atrium.reactive`` (Python SDK).
+ */
+/**
+ * N-way winner selection with hysteresis over a live ``Record<string, number>`` score stream.
+ *
+ * A new winner must beat the current one by ``margin`` **and** at least ``dwell`` seconds must have
+ * passed since the last switch, or nothing changes. Call {@link update} once per frame; it returns
+ * the new winner's name only on an actual change — every call that keeps the same winner returns
+ * ``null``. The first call always fires (there's no current winner to beat yet). With two anchors
+ * this degrades to a plain binary hysteresis switch — the same margin/dwell rule *is* that switch.
+ *
+ * ``Decider`` only decides *when* to switch, not what the incoming scores mean — no smoothing here;
+ * ease/debounce the stream upstream if you want that (EMA is caller policy, not SDK).
+ *
+ * With a single anchor there's nothing to switch *to*: the first call still fires (returning that
+ * one name), but every call after it returns ``null`` forever (``null`` means "no change", and the
+ * lone anchor can never stop being the winner).
+ */
+export declare class Decider {
+    readonly margin: number;
+    readonly dwell: number;
+    private currentWinner;
+    private switchedAt;
+    constructor(opts?: {
+        margin?: number;
+        dwell?: number;
+    });
+    /** The current winner (``null`` before the first {@link update}). */
+    get current(): string | null;
+    /**
+     * Feed one frame of named scores. Returns the new winner's name when the current one changes,
+     * else ``null``. ``now`` overrides the clock (monotonic seconds by default) — mainly for
+     * deterministic tests.
+     */
+    update(scores: Record<string, number>, now?: number): string | null;
+}
+//# sourceMappingURL=decider.d.ts.map

package/dist/decider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decider.d.ts","sourceRoot":"","sources":["../src/decider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,UAAU,CAAsB;gBAE5B,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAK1D,qEAAqE;IACrE,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CA0BpE"}

package/dist/decider.js

@@ -0,0 +1,76 @@
+/**
+ * Reactive helpers — a small, framework-free stateful policy over a live score stream (e.g. the
+ * per-anchor scores a soundscape derives each frame). No transport dependency; pure and easy to
+ * unit-test. A line-for-line port of ``hci_atrium.reactive`` (Python SDK).
+ */
+/** Monotonic seconds — ``performance.now()`` where available, else the wall clock. */
+function monotonicSeconds() {
+    const perf = globalThis.performance;
+    return (perf ? perf.now() : Date.now()) / 1000;
+}
+/**
+ * N-way winner selection with hysteresis over a live ``Record<string, number>`` score stream.
+ *
+ * A new winner must beat the current one by ``margin`` **and** at least ``dwell`` seconds must have
+ * passed since the last switch, or nothing changes. Call {@link update} once per frame; it returns
+ * the new winner's name only on an actual change — every call that keeps the same winner returns
+ * ``null``. The first call always fires (there's no current winner to beat yet). With two anchors
+ * this degrades to a plain binary hysteresis switch — the same margin/dwell rule *is* that switch.
+ *
+ * ``Decider`` only decides *when* to switch, not what the incoming scores mean — no smoothing here;
+ * ease/debounce the stream upstream if you want that (EMA is caller policy, not SDK).
+ *
+ * With a single anchor there's nothing to switch *to*: the first call still fires (returning that
+ * one name), but every call after it returns ``null`` forever (``null`` means "no change", and the
+ * lone anchor can never stop being the winner).
+ */
+export class Decider {
+    margin;
+    dwell;
+    currentWinner = null;
+    switchedAt = null;
+    constructor(opts = {}) {
+        this.margin = opts.margin ?? 0.1;
+        this.dwell = opts.dwell ?? 0.0;
+    }
+    /** The current winner (``null`` before the first {@link update}). */
+    get current() {
+        return this.currentWinner;
+    }
+    /**
+     * Feed one frame of named scores. Returns the new winner's name when the current one changes,
+     * else ``null``. ``now`` overrides the clock (monotonic seconds by default) — mainly for
+     * deterministic tests.
+     */
+    update(scores, now) {
+        const names = Object.keys(scores);
+        if (names.length === 0)
+            return null;
+        const moment = now ?? monotonicSeconds();
+        let best = names[0];
+        let bestScore = scores[best];
+        for (const name of names) {
+            const s = scores[name];
+            if (s > bestScore) {
+                best = name;
+                bestScore = s;
+            }
+        }
+        if (this.currentWinner === null) {
+            this.currentWinner = best;
+            this.switchedAt = moment;
+            return best;
+        }
+        if (best === this.currentWinner)
+            return null;
+        if (this.switchedAt !== null && moment - this.switchedAt < this.dwell)
+            return null;
+        const currentScore = scores[this.currentWinner] ?? Number.NEGATIVE_INFINITY;
+        if (bestScore - currentScore < this.margin)
+            return null;
+        this.currentWinner = best;
+        this.switchedAt = moment;
+        return best;
+    }
+}
+//# sourceMappingURL=decider.js.map

package/dist/decider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decider.js","sourceRoot":"","sources":["../src/decider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sFAAsF;AACtF,SAAS,gBAAgB;IACvB,MAAM,IAAI,GAAI,UAAkD,CAAC,WAAW,CAAA;IAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAA;AAChD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,OAAO;IACT,MAAM,CAAQ;IACd,KAAK,CAAQ;IACd,aAAa,GAAkB,IAAI,CAAA;IACnC,UAAU,GAAkB,IAAI,CAAA;IAExC,YAAY,OAA4C,EAAE;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAA;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAA;IAChC,CAAC;IAED,qEAAqE;IACrE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAA8B,EAAE,GAAY;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACnC,MAAM,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAA;QACxC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAW,CAAA;QAC7B,IAAI,SAAS,GAAG,MAAM,CAAC,IAAI,CAAW,CAAA;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAW,CAAA;YAChC,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC;gBAClB,IAAI,GAAG,IAAI,CAAA;gBACX,SAAS,GAAG,CAAC,CAAA;YACf,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;YACzB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAA;YACxB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAA;QAC5C,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QAClF,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAA;QAC3E,IAAI,SAAS,GAAG,YAAY,GAAG,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QACvD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAA;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/discovery.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Authorization-server endpoint discovery (RFC 8414).
+ *
+ * The SDK resolves the authorize/token/revoke endpoints from
+ * ``{baseUrl}/.well-known/oauth-authorization-server`` and falls back to Atrium's conventional
+ * paths when discovery is unreachable or incomplete.
+ */
+export interface Endpoints {
+    authorization: string;
+    token: string;
+    revocation: string;
+}
+/** Resolve the OAuth endpoints for ``baseUrl``, falling back to the conventional paths. */
+export declare function discoverEndpoints(baseUrl: string): Promise<Endpoints>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACnB;AAcD,2FAA2F;AAC3F,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAgB3E"}

package/dist/discovery.js

@@ -0,0 +1,38 @@
+/**
+ * Authorization-server endpoint discovery (RFC 8414).
+ *
+ * The SDK resolves the authorize/token/revoke endpoints from
+ * ``{baseUrl}/.well-known/oauth-authorization-server`` and falls back to Atrium's conventional
+ * paths when discovery is unreachable or incomplete.
+ */
+import { httpFetch } from "./http.js";
+function conventional(baseUrl) {
+    return {
+        authorization: `${baseUrl}/oauth/authorize`,
+        token: `${baseUrl}/oauth/token`,
+        revocation: `${baseUrl}/oauth/revoke`,
+    };
+}
+function pick(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+/** Resolve the OAuth endpoints for ``baseUrl``, falling back to the conventional paths. */
+export async function discoverEndpoints(baseUrl) {
+    const fallback = conventional(baseUrl);
+    try {
+        const res = await httpFetch(`${baseUrl}/.well-known/oauth-authorization-server`);
+        if (!res.ok) {
+            return fallback;
+        }
+        const doc = (await res.json());
+        return {
+            authorization: pick(doc.authorization_endpoint, fallback.authorization),
+            token: pick(doc.token_endpoint, fallback.token),
+            revocation: pick(doc.revocation_endpoint, fallback.revocation),
+        };
+    }
+    catch {
+        return fallback;
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAQrC,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO;QACL,aAAa,EAAE,GAAG,OAAO,kBAAkB;QAC3C,KAAK,EAAE,GAAG,OAAO,cAAc;QAC/B,UAAU,EAAE,GAAG,OAAO,eAAe;KACtC,CAAA;AACH,CAAC;AAED,SAAS,IAAI,CAAC,KAAc,EAAE,QAAgB;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;AACzE,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe;IACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,OAAO,yCAAyC,CAAC,CAAA;QAChF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAA;QACzD,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,QAAQ,CAAC,aAAa,CAAC;YACvE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC;YAC/C,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,QAAQ,CAAC,UAAU,CAAC;SAC/D,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAA;IACjB,CAAC;AACH,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,11 @@
+/** Best-effort, guarded reads of build-time / runtime environment variables. */
+/** The deployed instance — the default when neither an explicit ``baseUrl`` nor
+ * ``ATRIUM_BASE_URL`` is set (mirrors the Python SDK's ``DEFAULT_BASE_URL``). */
+export declare const DEFAULT_BASE_URL = "https://atrium.hci.rwth-aachen.de";
+/**
+ * Read ``key`` from ``import.meta.env`` (Vite/bundlers) then ``process.env`` (Node), returning
+ * ``undefined`` if neither has it. Both lookups are guarded so importing the SDK never throws in an
+ * environment that lacks one of them.
+ */
+export declare function readEnv(key: string): string | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF;iFACiF;AACjF,eAAO,MAAM,gBAAgB,sCAAsC,CAAA;AAEnE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAevD"}

package/dist/env.js

@@ -0,0 +1,28 @@
+/** Best-effort, guarded reads of build-time / runtime environment variables. */
+/** The deployed instance — the default when neither an explicit ``baseUrl`` nor
+ * ``ATRIUM_BASE_URL`` is set (mirrors the Python SDK's ``DEFAULT_BASE_URL``). */
+export const DEFAULT_BASE_URL = "https://atrium.hci.rwth-aachen.de";
+/**
+ * Read ``key`` from ``import.meta.env`` (Vite/bundlers) then ``process.env`` (Node), returning
+ * ``undefined`` if neither has it. Both lookups are guarded so importing the SDK never throws in an
+ * environment that lacks one of them.
+ */
+export function readEnv(key) {
+    let value;
+    try {
+        value = import.meta.env?.[key];
+    }
+    catch {
+        // ``import.meta.env`` is not defined outside a bundler — fall through to process.env.
+    }
+    if (value == null) {
+        try {
+            value = globalThis.process?.env?.[key];
+        }
+        catch {
+            // No ``process`` in this environment.
+        }
+    }
+    return value == null ? undefined : String(value);
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF;iFACiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,mCAAmC,CAAA;AAEnE;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,KAAc,CAAA;IAClB,IAAI,CAAC;QACH,KAAK,GAAI,MAAM,CAAC,IAAqD,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,sFAAsF;IACxF,CAAC;IACD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,KAAK,GAAI,UAA8D,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;QAC7F,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAClD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Exception hierarchy for the Atrium SDK — the TypeScript mirror of ``hci_atrium.errors``.
+ *
+ * Everything the SDK throws derives from {@link AtriumError}, so one ``catch`` covers the whole
+ * surface. Two conventions to know:
+ *
+ * - **HTTP failures** surface as {@link APIError} (or its {@link AuthError} /
+ *   {@link TransientAuthError} subclasses), carrying the status, response detail, and request id.
+ * - **Bad arguments** (the Python ``ValueError`` / ``TypeError`` cases in the shaping and operand
+ *   layers — mutually-exclusive inputs, an unsupported filter, an un-coercible operand) surface as
+ *   {@link InvalidArgumentError}. This is the single, documented convention for caller mistakes; we
+ *   do not reach for the platform ``TypeError`` / ``RangeError`` so that every SDK throw stays
+ *   catchable under ``AtriumError``.
+ */
+/** Base class for every error the SDK raises. */
+export declare class AtriumError extends Error {
+    constructor(message: string);
+}
+/** A caller-side mistake — the analog of Python's ``ValueError`` / ``TypeError`` at the API edge. */
+export declare class InvalidArgumentError extends AtriumError {
+}
+/**
+ * The Atrium API returned a non-2xx response.
+ *
+ * ``status`` is the HTTP status; ``detail`` is the (truncated) response body; ``requestId`` is the
+ * server's ``x-request-id`` when present, for correlating with server logs.
+ */
+export declare class APIError extends AtriumError {
+    readonly status: number;
+    readonly detail: string;
+    readonly requestId?: string | undefined;
+    constructor(status: number, detail: string, requestId?: string | undefined);
+}
+/** Authentication failed — sign-in, token exchange, or refresh could not complete (401 / 403). */
+export declare class AuthError extends APIError {
+}
+/**
+ * A token operation failed *transiently* (429, 5xx, or a network error), not permanently.
+ *
+ * Distinct from a plain {@link AuthError} (a genuinely revoked/expired credential): the credential
+ * may still be valid, so the right response is to retry — never to drop the user into an
+ * interactive sign-in. Derives from {@link AuthError} so existing ``catch (AuthError)`` handlers
+ * still catch it.
+ */
+export declare class TransientAuthError extends AuthError {
+}
+/**
+ * A ``responseFormat`` (Zod schema) call could not produce schema-valid output.
+ *
+ * Thrown by ``chat`` when, even after one repair turn, the model's reply isn't valid JSON for the
+ * requested schema. The raw text and the validation detail are attached for debugging.
+ */
+export declare class StructuredOutputError extends AtriumError {
+    readonly schema: string;
+    readonly raw: string;
+    readonly detail: string;
+    constructor(schema: string, raw: string, detail: string);
+}
+/**
+ * Raise for a non-ok {@link Response} on the general request path — a plain {@link APIError} for
+ * every status ``>= 400`` (mirror of Python's ``Atrium._request``, which raises ``APIError`` for
+ * everything). Auth-specific mapping ({@link AuthError} / {@link TransientAuthError}) lives only in
+ * the OAuth token flow (``auth.ts``), matching Python's split. Reads the body once for ``detail`` and
+ * keeps the server's ``x-request-id`` for log correlation.
+ */
+export declare function raiseForStatus(res: Response): Promise<never>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,iDAAiD;AACjD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAM5B;AAED,qGAAqG;AACrG,qBAAa,oBAAqB,SAAQ,WAAW;CAAG;AAExD;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,WAAW;IAErC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;gBAFlB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,YAAA;CAI9B;AAED,kGAAkG;AAClG,qBAAa,SAAU,SAAQ,QAAQ;CAAG;AAE1C;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;CAAG;AAEpD;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IAElD,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAFd,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM;CAI1B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAIlE"}

package/dist/errors.js

@@ -0,0 +1,86 @@
+/**
+ * Exception hierarchy for the Atrium SDK — the TypeScript mirror of ``hci_atrium.errors``.
+ *
+ * Everything the SDK throws derives from {@link AtriumError}, so one ``catch`` covers the whole
+ * surface. Two conventions to know:
+ *
+ * - **HTTP failures** surface as {@link APIError} (or its {@link AuthError} /
+ *   {@link TransientAuthError} subclasses), carrying the status, response detail, and request id.
+ * - **Bad arguments** (the Python ``ValueError`` / ``TypeError`` cases in the shaping and operand
+ *   layers — mutually-exclusive inputs, an unsupported filter, an un-coercible operand) surface as
+ *   {@link InvalidArgumentError}. This is the single, documented convention for caller mistakes; we
+ *   do not reach for the platform ``TypeError`` / ``RangeError`` so that every SDK throw stays
+ *   catchable under ``AtriumError``.
+ */
+/** Base class for every error the SDK raises. */
+export class AtriumError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+        // Restore the prototype chain across the ES5 target so ``instanceof`` works.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** A caller-side mistake — the analog of Python's ``ValueError`` / ``TypeError`` at the API edge. */
+export class InvalidArgumentError extends AtriumError {
+}
+/**
+ * The Atrium API returned a non-2xx response.
+ *
+ * ``status`` is the HTTP status; ``detail`` is the (truncated) response body; ``requestId`` is the
+ * server's ``x-request-id`` when present, for correlating with server logs.
+ */
+export class APIError extends AtriumError {
+    status;
+    detail;
+    requestId;
+    constructor(status, detail, requestId) {
+        super(`HTTP ${status}: ${detail.slice(0, 500)}`);
+        this.status = status;
+        this.detail = detail;
+        this.requestId = requestId;
+    }
+}
+/** Authentication failed — sign-in, token exchange, or refresh could not complete (401 / 403). */
+export class AuthError extends APIError {
+}
+/**
+ * A token operation failed *transiently* (429, 5xx, or a network error), not permanently.
+ *
+ * Distinct from a plain {@link AuthError} (a genuinely revoked/expired credential): the credential
+ * may still be valid, so the right response is to retry — never to drop the user into an
+ * interactive sign-in. Derives from {@link AuthError} so existing ``catch (AuthError)`` handlers
+ * still catch it.
+ */
+export class TransientAuthError extends AuthError {
+}
+/**
+ * A ``responseFormat`` (Zod schema) call could not produce schema-valid output.
+ *
+ * Thrown by ``chat`` when, even after one repair turn, the model's reply isn't valid JSON for the
+ * requested schema. The raw text and the validation detail are attached for debugging.
+ */
+export class StructuredOutputError extends AtriumError {
+    schema;
+    raw;
+    detail;
+    constructor(schema, raw, detail) {
+        super(`output did not match schema ${schema}: ${detail}`);
+        this.schema = schema;
+        this.raw = raw;
+        this.detail = detail;
+    }
+}
+/**
+ * Raise for a non-ok {@link Response} on the general request path — a plain {@link APIError} for
+ * every status ``>= 400`` (mirror of Python's ``Atrium._request``, which raises ``APIError`` for
+ * everything). Auth-specific mapping ({@link AuthError} / {@link TransientAuthError}) lives only in
+ * the OAuth token flow (``auth.ts``), matching Python's split. Reads the body once for ``detail`` and
+ * keeps the server's ``x-request-id`` for log correlation.
+ */
+export async function raiseForStatus(res) {
+    const detail = await res.text().catch(() => "");
+    const requestId = res.headers.get("x-request-id") ?? undefined;
+    throw new APIError(res.status, detail, requestId);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,iDAAiD;AACjD,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAA;QAC3B,6EAA6E;QAC7E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACnD,CAAC;CACF;AAED,qGAAqG;AACrG,MAAM,OAAO,oBAAqB,SAAQ,WAAW;CAAG;AAExD;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IAE5B;IACA;IACA;IAHX,YACW,MAAc,EACd,MAAc,EACd,SAAkB;QAE3B,KAAK,CAAC,QAAQ,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QAJvC,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAS;IAG7B,CAAC;CACF;AAED,kGAAkG;AAClG,MAAM,OAAO,SAAU,SAAQ,QAAQ;CAAG;AAE1C;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,SAAS;CAAG;AAEpD;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IAEzC;IACA;IACA;IAHX,YACW,MAAc,EACd,GAAW,EACX,MAAc;QAEvB,KAAK,CAAC,+BAA+B,MAAM,KAAK,MAAM,EAAE,CAAC,CAAA;QAJhD,WAAM,GAAN,MAAM,CAAQ;QACd,QAAG,GAAH,GAAG,CAAQ;QACX,WAAM,GAAN,MAAM,CAAQ;IAGzB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAa;IAChD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;IAC/C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS,CAAA;IAC9D,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;AACnD,CAAC"}

package/dist/files.d.ts

@@ -0,0 +1,7 @@
+/**
+ * File inputs stay browser-safe (decision 10): a ``Blob`` / ``File`` (in-memory bytes) or a URL
+ * string. No filesystem paths in core — a Node caller wraps a Buffer in a ``Blob``. Turning a URL
+ * string into bytes is I/O, so it happens in the client's request layer, never in shaping.
+ */
+export type FileSource = Blob | string;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,CAAA"}

package/dist/files.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,11 @@
+/** Environment-guarded primitives shared across the SDK. */
+/**
+ * Call the global ``fetch`` at request time (not import time), so importing the package in an
+ * environment without ``fetch`` never throws — only actually making a request does.
+ */
+export declare function httpFetch(input: string, init?: RequestInit): Promise<Response>;
+/** True when running in a DOM environment (a real browser or jsdom). */
+export declare function isBrowser(): boolean;
+/** Coerce an unknown thrown value into an ``Error``. */
+export declare function asError(err: unknown): Error;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAM9E;AAED,wEAAwE;AACxE,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAE3C"}

package/dist/http.js

@@ -0,0 +1,21 @@
+/** Environment-guarded primitives shared across the SDK. */
+/**
+ * Call the global ``fetch`` at request time (not import time), so importing the package in an
+ * environment without ``fetch`` never throws — only actually making a request does.
+ */
+export function httpFetch(input, init) {
+    const f = globalThis.fetch;
+    if (!f) {
+        throw new Error("Atrium: global fetch is unavailable in this environment");
+    }
+    return f(input, init);
+}
+/** True when running in a DOM environment (a real browser or jsdom). */
+export function isBrowser() {
+    return typeof window !== "undefined" && typeof window.document !== "undefined";
+}
+/** Coerce an unknown thrown value into an ``Error``. */
+export function asError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,IAAkB;IACzD,MAAM,CAAC,GAAI,UAAuC,CAAC,KAAK,CAAA;IACxD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;IAC5E,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;AACvB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW,CAAA;AAChF,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ``hci-atrium`` — the Atrium TypeScript SDK.
+ *
+ * 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 { 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 { Decider } from "./decider.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 { 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 type { AudioChunk } from "./transcribe.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * ``hci-atrium`` — the Atrium TypeScript SDK.
+ *
+ * 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 { Auth } from "./auth.js";
+export { by, toAnchorMembers, } from "./by.js";
+export { Decider } from "./decider.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";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}