hci-atrium 0.1.0

package/dist/shaping/assets.js.map

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

package/dist/shaping/chat.d.ts

@@ -0,0 +1,39 @@
+/** Chat-completions + embeddings + transcription request shaping (mirror of ``_shaping``). */
+import type { FileSource } from "../files.js";
+import type { ShapedRequest } from "./request.js";
+/** An OpenAI-style chat message. */
+export interface ChatMessage {
+    role: string;
+    content: unknown;
+    [key: string]: unknown;
+}
+/** Build the ``/v1/chat/completions`` body. A bare string becomes a single user message. */
+export declare function chatBody(messages: string | ChatMessage[], model: string | undefined, params?: Record<string, unknown>): Record<string, unknown>;
+/** Build a ``POST /v1/chat/completions`` request from a shaped body. */
+export declare function buildChat(body: Record<string, unknown>): ShapedRequest;
+/** A media input for embeddings, already read to base64 by the client (shaping stays I/O-free). */
+export interface EncodedMedia {
+    kind: "image" | "audio" | "video";
+    data: string;
+    format?: string;
+}
+/**
+ * Build a ``POST /v1/embeddings`` request. Enforces the exactly-one-input contract (``text`` XOR one
+ * media input); the client resolves a media {@link FileSource} to {@link EncodedMedia} first.
+ */
+export declare function buildEmbed(model: string, text: string | undefined, media: EncodedMedia | undefined): ShapedRequest;
+export interface BuildTranscribeInput {
+    audio: FileSource;
+    model?: string;
+    language?: string;
+    prompt?: string;
+    verbose?: boolean;
+    format?: string;
+}
+/**
+ * Build the ``POST /v1/audio/transcriptions`` request — a multipart audio upload. ``verbose`` asks
+ * for segment timings (``response_format=verbose_json``); ``format`` names the file part for
+ * nameless bytes.
+ */
+export declare function buildTranscribe(input: BuildTranscribeInput): ShapedRequest;
+//# sourceMappingURL=chat.d.ts.map

package/dist/shaping/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/shaping/chat.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAG9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,EAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAEtE;AAED,mGAAmG;AACnG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,YAAY,GAAG,SAAS,GAC9B,aAAa,CASf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,aAAa,CA2B1E"}

package/dist/shaping/chat.js

@@ -0,0 +1,62 @@
+/** Chat-completions + embeddings + transcription request shaping (mirror of ``_shaping``). */
+import { InvalidArgumentError } from "../errors.js";
+/** Build the ``/v1/chat/completions`` body. A bare string becomes a single user message. */
+export function chatBody(messages, model, params = {}) {
+    const msgs = typeof messages === "string" ? [{ role: "user", content: messages }] : [...messages];
+    const body = { messages: msgs, ...params };
+    if (model !== undefined) {
+        body.model = model;
+    }
+    return body;
+}
+/** Build a ``POST /v1/chat/completions`` request from a shaped body. */
+export function buildChat(body) {
+    return { method: "POST", path: "/v1/chat/completions", json: body };
+}
+/**
+ * Build a ``POST /v1/embeddings`` request. Enforces the exactly-one-input contract (``text`` XOR one
+ * media input); the client resolves a media {@link FileSource} to {@link EncodedMedia} first.
+ */
+export function buildEmbed(model, text, media) {
+    if ((text !== undefined ? 1 : 0) + (media !== undefined ? 1 : 0) !== 1) {
+        throw new InvalidArgumentError("pass exactly one of text, image, audio, or video");
+    }
+    const body = text !== undefined
+        ? { model, input: text }
+        : { model, input: [{ type: media?.kind, data: media?.data, format: media?.format }] };
+    return { method: "POST", path: "/v1/embeddings", json: body };
+}
+/**
+ * Build the ``POST /v1/audio/transcriptions`` request — a multipart audio upload. ``verbose`` asks
+ * for segment timings (``response_format=verbose_json``); ``format`` names the file part for
+ * nameless bytes.
+ */
+export function buildTranscribe(input) {
+    const fields = {};
+    if (input.model !== undefined) {
+        fields.model = input.model;
+    }
+    if (input.language !== undefined) {
+        fields.language = input.language;
+    }
+    if (input.prompt !== undefined) {
+        fields.prompt = input.prompt;
+    }
+    if (input.verbose) {
+        fields.response_format = "verbose_json";
+    }
+    return {
+        method: "POST",
+        path: "/v1/audio/transcriptions",
+        multipart: {
+            fields,
+            files: {
+                file: {
+                    source: input.audio,
+                    filename: input.format ? `audio.${input.format}` : undefined,
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=chat.js.map

package/dist/shaping/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/shaping/chat.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAWnD,4FAA4F;AAC5F,MAAM,UAAU,QAAQ,CACtB,QAAgC,EAChC,KAAyB,EACzB,SAAkC,EAAE;IAEpC,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAA;IACjG,MAAM,IAAI,GAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAA;IACnE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,IAA6B;IACrD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACrE,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,IAAwB,EACxB,KAA+B;IAE/B,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,oBAAoB,CAAC,kDAAkD,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,IAAI,GACR,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;QACxB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,CAAA;IACzF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AAC/D,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;IAClC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;IAC9B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,CAAC,eAAe,GAAG,cAAc,CAAA;IACzC,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,0BAA0B;QAChC,SAAS,EAAE;YACT,MAAM;YACN,KAAK,EAAE;gBACL,IAAI,EAAE;oBACJ,MAAM,EAAE,KAAK,CAAC,KAAK;oBACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;iBAC7D;aACF;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/shaping/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The pure request-shaping layer (decision 12: shape-once, orchestrate-twice). No I/O lives here —
+ * every builder returns a {@link ShapedRequest} the client turns into a ``fetch``. This is also the
+ * single seam where camelCase SDK names become the wire's snake_case (decision 5).
+ */
+export * from "./assets.js";
+export * from "./chat.js";
+export * from "./library.js";
+export type { FilePart, HttpMethod, Multipart, ShapedRequest } from "./request.js";
+export { applyScope } from "./request.js";
+export * from "./rooms.js";
+export * from "./sources.js";
+export * from "./structured.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shaping/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shaping/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA"}

package/dist/shaping/index.js

@@ -0,0 +1,13 @@
+/**
+ * The pure request-shaping layer (decision 12: shape-once, orchestrate-twice). No I/O lives here —
+ * every builder returns a {@link ShapedRequest} the client turns into a ``fetch``. This is also the
+ * single seam where camelCase SDK names become the wire's snake_case (decision 5).
+ */
+export * from "./assets.js";
+export * from "./chat.js";
+export * from "./library.js";
+export { applyScope } from "./request.js";
+export * from "./rooms.js";
+export * from "./sources.js";
+export * from "./structured.js";
+//# sourceMappingURL=index.js.map

package/dist/shaping/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shaping/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA"}

package/dist/shaping/library.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Library search + search-by-examples request shaping (the mirror of ``_shaping`` search helpers).
+ *
+ * This is the one seam where camelCase SDK names become the wire's historical snake_case
+ * (``matchBy`` → ``match_by``, ``allKinds`` → ``all_kinds``, …). Nothing downstream re-translates.
+ */
+import type { Operand } from "../by.js";
+import type { FileSource } from "../files.js";
+import type { Filters } from "../models.js";
+import { type ShapedRequest } from "./request.js";
+export interface SearchFilterInput {
+    limit: number;
+    tags?: string[];
+    anyTags?: string[];
+    excludeTags?: string[];
+    provider?: string | string[];
+    filters?: Filters;
+    space?: string;
+    project?: string;
+    collection?: string;
+}
+export interface BuildSearchInput extends SearchFilterInput {
+    query?: string;
+    like?: string;
+    likeBy?: string;
+    modality?: string;
+    media?: FileSource;
+    vector?: number[];
+    /** Inline one vector per hit: ``true`` (the scoring vector) or an already-resolved space id.
+     * Falsy → omitted, request byte-for-byte unchanged. */
+    includeVectors?: boolean | string;
+}
+/**
+ * Build a library-search request — a text query, a "find similar" (``like``) query, a multipart
+ * file query, or a raw-vector query. ``like``, ``space``, ``project`` and ``collection`` are
+ * already resolved by the caller.
+ */
+export declare function buildSearch(input: BuildSearchInput): ShapedRequest;
+export interface BuildSearchByExamplesInput {
+    positives: string[];
+    negatives?: string[];
+    method: string;
+    spaces?: string[];
+    limit: number;
+    contrastSamples?: number;
+    features?: Record<string, unknown>;
+    matchBy?: string[] | Record<string, number>;
+    filters?: Filters;
+    project?: string;
+    collection?: string;
+}
+/**
+ * Build a search-by-examples (mood-board) request. All narrowing rides on ``filters``; a Filters
+ * field with no wire slot here raises, as does ``matchBy`` given both as an argument and on
+ * ``filters``. ``spaces`` and the scope are already resolved.
+ */
+export declare function buildSearchByExamples(input: BuildSearchByExamplesInput): ShapedRequest;
+/**
+ * Build a pairwise compare request (``POST /v1/library/compare``). A file operand becomes a
+ * multipart part (``a_file`` / ``b_file``); every other kind becomes a JSON-descriptor form field
+ * (``a`` / ``b``). With no file operand the body is ``application/x-www-form-urlencoded``. ``space``
+ * is already resolved by the caller.
+ */
+export declare function buildCompare(a: Operand, b: Operand, space?: string, breakdown?: boolean): ShapedRequest;
+export interface BuildEnrichInput {
+    query: string;
+    modality: string;
+    tags?: string[];
+    total?: number;
+    preview?: boolean;
+    wait?: boolean;
+}
+/** Build an enrichment request — the ``preview`` dry-run, or the staging/enqueue endpoint. */
+export declare function buildEnrich(input: BuildEnrichInput): ShapedRequest;
+/** Build a ``GET /v1/library/tags`` listing request (scoped to the collection chain / root). */
+export declare function buildTagsList(opts?: {
+    collection?: string;
+}): ShapedRequest;
+/** Build a ``GET /v1/library/tags/{ref}`` request (name- or id-addressed within scope). */
+export declare function buildTagGet(ref: string, opts?: {
+    includeSnapshot?: boolean;
+    collection?: string;
+}): ShapedRequest;
+//# sourceMappingURL=library.d.ts.map

package/dist/shaping/library.d.ts.map

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

package/dist/shaping/library.js

@@ -0,0 +1,288 @@
+/**
+ * Library search + search-by-examples request shaping (the mirror of ``_shaping`` search helpers).
+ *
+ * This is the one seam where camelCase SDK names become the wire's historical snake_case
+ * (``matchBy`` → ``match_by``, ``allKinds`` → ``all_kinds``, …). Nothing downstream re-translates.
+ */
+import { InvalidArgumentError } from "../errors.js";
+import { applyScope } from "./request.js";
+function rangesToWire(ranges) {
+    return Object.entries(ranges).map(([key, [lo, hi]]) => `${key}:${lo === null ? "" : lo}:${hi === null ? "" : hi}`);
+}
+/** The filter fields shared by every search shape (text / media / vector / like). */
+function searchFilterBody(input) {
+    const body = { limit: input.limit };
+    if (input.tags?.length) {
+        body.all_labels = input.tags;
+    }
+    if (input.anyTags?.length) {
+        body.any_labels = input.anyTags;
+    }
+    if (input.excludeTags?.length) {
+        body.none_labels = input.excludeTags;
+    }
+    if (input.provider !== undefined) {
+        body.provider = typeof input.provider === "string" ? [input.provider] : [...input.provider];
+    }
+    const f = input.filters;
+    if (f) {
+        if (f.allKinds?.length)
+            body.all_kinds = f.allKinds;
+        if (f.anyKinds?.length)
+            body.any_kinds = f.anyKinds;
+        if (f.noneKinds?.length)
+            body.none_kinds = f.noneKinds;
+        if (f.allLabels?.length)
+            body.all_labels = f.allLabels;
+        if (f.anyLabels?.length)
+            body.any_labels = f.anyLabels;
+        if (f.noneLabels?.length)
+            body.none_labels = f.noneLabels;
+        if (f.contentKind?.length)
+            body.content_kind = f.contentKind;
+        if (f.statuses?.length)
+            body.any_statuses = f.statuses;
+        if (f.ranges && Object.keys(f.ranges).length)
+            body.ranges = rangesToWire(f.ranges);
+        if (f.uploader?.length)
+            body.uploader = f.uploader;
+        if (f.maxSeconds !== undefined)
+            body.max_seconds = f.maxSeconds;
+        if (f.matchBy !== undefined)
+            body.match_by = f.matchBy; // [] is meaningful: match every signal
+        if (f.dataMatch && Object.keys(f.dataMatch).length)
+            body.data_match = f.dataMatch;
+        if (f.excludeIds?.length)
+            body.exclude_ids = f.excludeIds;
+    }
+    if (input.space !== undefined) {
+        body.space = input.space;
+    }
+    applyScope(body, input.project, input.collection);
+    return body;
+}
+/** Append ``modality`` to ``all_kinds`` (result-kind filter; the ranking space stays cross-modal). */
+function mergeModalityIntoAllKinds(body, modality) {
+    const kinds = Array.isArray(body.all_kinds) ? body.all_kinds : [];
+    if (!kinds.includes(modality)) {
+        body.all_kinds = [...kinds, modality];
+    }
+}
+/**
+ * Build a library-search request — a text query, a "find similar" (``like``) query, a multipart
+ * file query, or a raw-vector query. ``like``, ``space``, ``project`` and ``collection`` are
+ * already resolved by the caller.
+ */
+export function buildSearch(input) {
+    const { query = "", like, likeBy, modality, media, vector } = input;
+    if (like !== undefined && (query || media !== undefined || vector !== undefined)) {
+        throw new InvalidArgumentError("like is mutually exclusive with a text query / image / audio / video / vector — " +
+            "pass exactly one query input");
+    }
+    if (likeBy !== undefined && like === undefined) {
+        throw new InvalidArgumentError("likeBy only applies with like");
+    }
+    const body = searchFilterBody(input);
+    if (input.includeVectors) {
+        // Falsy (default) omits it — the request stays byte-for-byte unchanged.
+        body.include_vectors = input.includeVectors;
+    }
+    if (like !== undefined) {
+        body.like = like;
+        if (likeBy !== undefined) {
+            body.like_by = likeBy;
+        }
+        if (modality !== undefined) {
+            mergeModalityIntoAllKinds(body, modality);
+        }
+        return { method: "POST", path: "/v1/library/search", json: body };
+    }
+    if (vector !== undefined) {
+        body.vector = vector.map(Number);
+        if (modality !== undefined) {
+            body.modality = modality;
+        }
+        return { method: "POST", path: "/v1/library/search", json: body };
+    }
+    if (media !== undefined) {
+        if (modality !== undefined) {
+            mergeModalityIntoAllKinds(body, modality);
+        }
+        return {
+            method: "POST",
+            path: "/v1/library/search/file",
+            multipart: {
+                fields: { params: JSON.stringify(body) },
+                files: { file: { source: media } },
+            },
+        };
+    }
+    body.query = query;
+    if (modality !== undefined) {
+        body.modality = modality;
+    }
+    return { method: "POST", path: "/v1/library/search", json: body };
+}
+// Filters fields ``searchByExamples`` has no wire slot for — setting one is a mistake worth naming.
+const SEARCH_BY_EXAMPLES_UNSUPPORTED = [
+    "statuses",
+    "ranges",
+    "uploader",
+    "maxSeconds",
+    "dataMatch",
+    "excludeIds",
+];
+// Filters fields that map straight onto the search-by-examples body (camelCase → snake wire name).
+const SEARCH_BY_EXAMPLES_MAPPED = [
+    ["allKinds", "all_kinds"],
+    ["anyKinds", "any_kinds"],
+    ["noneKinds", "none_kinds"],
+    ["allLabels", "all_labels"],
+    ["anyLabels", "any_labels"],
+    ["noneLabels", "none_labels"],
+    ["contentKind", "content_kind"],
+];
+/**
+ * Build a search-by-examples (mood-board) request. All narrowing rides on ``filters``; a Filters
+ * field with no wire slot here raises, as does ``matchBy`` given both as an argument and on
+ * ``filters``. ``spaces`` and the scope are already resolved.
+ */
+export function buildSearchByExamples(input) {
+    const body = {
+        positives: input.positives,
+        method: input.method,
+        limit: input.limit,
+    };
+    if (input.negatives?.length) {
+        body.negatives = input.negatives;
+    }
+    if (input.spaces !== undefined) {
+        body.spaces = input.spaces;
+    }
+    if (input.contrastSamples !== undefined) {
+        body.contrast_samples = input.contrastSamples;
+    }
+    if (input.features !== undefined) {
+        body.features = input.features;
+    }
+    let matchBy = input.matchBy;
+    const f = input.filters;
+    if (f) {
+        for (const field of SEARCH_BY_EXAMPLES_UNSUPPORTED) {
+            if (f[field] !== undefined) {
+                throw new InvalidArgumentError(`${field} is not supported by searchByExamples`);
+            }
+        }
+        if (f.matchBy !== undefined) {
+            if (matchBy !== undefined) {
+                throw new InvalidArgumentError("matchBy is set both as an argument and on filters — pass just one");
+            }
+            matchBy = f.matchBy;
+        }
+        for (const [field, wire] of SEARCH_BY_EXAMPLES_MAPPED) {
+            const value = f[field];
+            if (Array.isArray(value) ? value.length : value !== undefined) {
+                body[wire] = value;
+            }
+        }
+    }
+    if (matchBy !== undefined) {
+        body.match_by = matchBy;
+    }
+    applyScope(body, input.project, input.collection);
+    return { method: "POST", path: "/v1/library/search-by-examples", json: body };
+}
+/** The JSON descriptor for a non-file operand (a file operand rides as a multipart part instead). */
+function operandDescriptor(op) {
+    switch (op.kind) {
+        case "asset":
+            return { asset: op.assetId };
+        case "vector":
+            return { vector: op.vector };
+        case "text":
+            return { text: op.text };
+        case "concept": {
+            const desc = { concept: op.name };
+            if (op.collection !== undefined) {
+                desc.collection = op.collection;
+            }
+            return desc;
+        }
+        default:
+            throw new InvalidArgumentError(`operand kind ${op.kind} has no JSON descriptor`);
+    }
+}
+/**
+ * Build a pairwise compare request (``POST /v1/library/compare``). A file operand becomes a
+ * multipart part (``a_file`` / ``b_file``); every other kind becomes a JSON-descriptor form field
+ * (``a`` / ``b``). With no file operand the body is ``application/x-www-form-urlencoded``. ``space``
+ * is already resolved by the caller.
+ */
+export function buildCompare(a, b, space, breakdown) {
+    const fields = {};
+    const files = {};
+    for (const [name, op] of [
+        ["a", a],
+        ["b", b],
+    ]) {
+        if (op.kind === "file") {
+            files[`${name}_file`] = {
+                source: op.file,
+                filename: op.format ? `${name}.${op.format}` : undefined,
+            };
+        }
+        else {
+            fields[name] = JSON.stringify(operandDescriptor(op));
+        }
+    }
+    if (space !== undefined) {
+        fields.space = space;
+    }
+    if (breakdown) {
+        fields.breakdown = "true";
+    }
+    if (Object.keys(files).length) {
+        return { method: "POST", path: "/v1/library/compare", multipart: { fields, files } };
+    }
+    return { method: "POST", path: "/v1/library/compare", form: fields };
+}
+/** Build an enrichment request — the ``preview`` dry-run, or the staging/enqueue endpoint. */
+export function buildEnrich(input) {
+    const body = {
+        query: input.query,
+        modality: input.modality,
+        tags: input.tags ?? [],
+    };
+    if (input.total !== undefined) {
+        body.total = input.total;
+    }
+    if (input.preview) {
+        return { method: "POST", path: "/v1/library/enrich/preview", json: body };
+    }
+    body.wait = input.wait ?? false;
+    return { method: "POST", path: "/v1/library/enrich", json: body };
+}
+/** Build a ``GET /v1/library/tags`` listing request (scoped to the collection chain / root). */
+export function buildTagsList(opts = {}) {
+    const req = { method: "GET", path: "/v1/library/tags" };
+    if (opts.collection !== undefined) {
+        req.query = { collection: opts.collection };
+    }
+    return req;
+}
+/** Build a ``GET /v1/library/tags/{ref}`` request (name- or id-addressed within scope). */
+export function buildTagGet(ref, opts = {}) {
+    const query = {};
+    if (opts.includeSnapshot) {
+        query.include_snapshot = "true";
+    }
+    if (opts.collection !== undefined) {
+        query.collection = opts.collection;
+    }
+    const req = { method: "GET", path: `/v1/library/tags/${encodeURIComponent(ref)}` };
+    if (Object.keys(query).length) {
+        req.query = query;
+    }
+    return req;
+}
+//# sourceMappingURL=library.js.map

package/dist/shaping/library.js.map

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

package/dist/shaping/request.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The shaped-request type the pure builders emit (the ``_shaping.Request`` analog).
+ *
+ * A builder returns ``{ method, path }`` plus exactly one payload channel:
+ * - ``json`` — a JSON body (the common case),
+ * - ``query`` — URL query params (GET listings),
+ * - ``multipart`` — a ``multipart/form-data`` upload (file inputs).
+ *
+ * The client's I/O layer turns this into a real ``fetch`` call; the builders themselves do no I/O
+ * (a URL-string {@link FileSource} is carried through and fetched by the client, not here).
+ */
+import type { FileSource } from "../files.js";
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
+/** One file part of a multipart upload. ``filename`` / ``contentType`` are hints for the client. */
+export interface FilePart {
+    source: FileSource;
+    filename?: string;
+    contentType?: string;
+}
+/** A ``multipart/form-data`` payload: string form fields plus named file parts. */
+export interface Multipart {
+    fields: Record<string, string>;
+    files: Record<string, FilePart>;
+}
+export interface ShapedRequest {
+    method: HttpMethod;
+    path: string;
+    /** A JSON request body. */
+    json?: unknown;
+    /** URL query parameters (arrays become repeated keys). */
+    query?: Record<string, string | number | Array<string | number>>;
+    /** An ``application/x-www-form-urlencoded`` body (``compare``'s non-file operands). */
+    form?: Record<string, string>;
+    /** A multipart upload body. */
+    multipart?: Multipart;
+    /** A raw byte body (a room recording's chunk-append PUT — the offer capture wire). */
+    content?: ArrayBuffer;
+    /** The ``Content-Type`` for a {@link content} body (defaults to ``application/octet-stream``). */
+    contentType?: string;
+}
+/**
+ * Add project/collection scoping to a body or query dict (in place), matching the Python SDK's
+ * ``_apply_scope``: the projects filter is a list (one project scopes to it), collection is a
+ * scalar. Shared by the search and asset-list builders.
+ */
+export declare function applyScope(target: Record<string, unknown>, project?: string, collection?: string): void;
+//# sourceMappingURL=request.d.ts.map

package/dist/shaping/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/shaping/request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE1D,oGAAoG;AACpG,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAA;IAChE,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,sFAAsF;IACtF,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,kGAAkG;IAClG,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAON"}

package/dist/shaping/request.js

@@ -0,0 +1,25 @@
+/**
+ * The shaped-request type the pure builders emit (the ``_shaping.Request`` analog).
+ *
+ * A builder returns ``{ method, path }`` plus exactly one payload channel:
+ * - ``json`` — a JSON body (the common case),
+ * - ``query`` — URL query params (GET listings),
+ * - ``multipart`` — a ``multipart/form-data`` upload (file inputs).
+ *
+ * The client's I/O layer turns this into a real ``fetch`` call; the builders themselves do no I/O
+ * (a URL-string {@link FileSource} is carried through and fetched by the client, not here).
+ */
+/**
+ * Add project/collection scoping to a body or query dict (in place), matching the Python SDK's
+ * ``_apply_scope``: the projects filter is a list (one project scopes to it), collection is a
+ * scalar. Shared by the search and asset-list builders.
+ */
+export function applyScope(target, project, collection) {
+    if (project !== undefined) {
+        target.projects = [project];
+    }
+    if (collection !== undefined) {
+        target.collection = collection;
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/shaping/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/shaping/request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoCH;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,MAA+B,EAC/B,OAAgB,EAChB,UAAmB;IAEnB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,CAAC,QAAQ,GAAG,CAAC,OAAO,CAAC,CAAA;IAC7B,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,UAAU,GAAG,UAAU,CAAA;IAChC,CAAC;AACH,CAAC"}