@chai-ui/core 0.1.0

package/dist/media-analysis-prompts.js

@@ -0,0 +1,35 @@
+/**
+ * The instruction text `MediaAnalyzer` sends to an analysis model — one
+ * complete, final string per (media kind × prompt length), not a template
+ * with placeholders, so tuning the wording is just editing English.
+ *
+ * Phrase optimization (rewriting for the target model's known prompt
+ * style) is folded directly into every prompt's wording below rather than
+ * modeled as a separate option.
+ */
+const OPTIMIZE_CLAUSE = "Rewrite the description for the selected model's known prompt style before finishing.";
+const RESPOND_ONLY = "Respond only with the description, no preamble.";
+export const MEDIA_ANALYSIS_PROMPTS = {
+    image: {
+        terse: `Analyze the attached image and produce a terse, single-sentence description suitable as a generation seed prompt — subject and composition only. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+        concise: `Analyze the attached image and produce a concise description suitable as a generation seed prompt — subject, composition, and lighting in a few sentences. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+        detailed: `Analyze the attached image and produce a detailed description suitable as a generation seed prompt — subject, composition, lighting, color palette, and style, thorough enough to reproduce it closely. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+    },
+    video: {
+        terse: `Analyze the attached video's key frames and motion and produce a terse, single-sentence description suitable as a generation seed prompt — subject and camera movement only. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+        concise: `Analyze the attached video's key frames and motion — subject, action, camera movement, pacing — and produce a concise description suitable as a generation seed prompt. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+        detailed: `Analyze the attached video's key frames and motion — subject, action, camera movement, pacing, lighting, and style — and produce a detailed description suitable as a generation seed prompt, thorough enough to reproduce the shot closely. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+    },
+    audio: {
+        terse: `Analyze the attached audio and produce a terse, single-sentence description suitable as a generation seed prompt — content and voice/instrumentation only. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+        concise: `Analyze the attached audio — content, voice/instrumentation, tone, pacing — and produce a concise description suitable as a generation seed prompt. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+        detailed: `Analyze the attached audio — content, voice/instrumentation, tone, pacing, and production style — and produce a detailed description suitable as a generation seed prompt, thorough enough to reproduce it closely. ${OPTIMIZE_CLAUSE} ${RESPOND_ONLY}`,
+    },
+};
+export const DEFAULT_MEDIA_ANALYSIS_PROMPT_LENGTH = "concise";
+export const MEDIA_ANALYSIS_PROMPT_LENGTHS = [
+    { value: "terse", label: "Terse" },
+    { value: "concise", label: "Concise" },
+    { value: "detailed", label: "Detailed" },
+];
+//# sourceMappingURL=media-analysis-prompts.js.map

package/dist/media-analysis-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-analysis-prompts.js","sourceRoot":"","sources":["../src/media-analysis-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,eAAe,GACnB,uFAAuF,CAAC;AAC1F,MAAM,YAAY,GAAG,iDAAiD,CAAC;AAEvE,MAAM,CAAC,MAAM,sBAAsB,GAG/B;IACF,KAAK,EAAE;QACL,KAAK,EAAE,oJAAoJ,eAAe,IAAI,YAAY,EAAE;QAC5L,OAAO,EAAE,8JAA8J,eAAe,IAAI,YAAY,EAAE;QACxM,QAAQ,EAAE,2MAA2M,eAAe,IAAI,YAAY,EAAE;KACvP;IACD,KAAK,EAAE;QACL,KAAK,EAAE,gLAAgL,eAAe,IAAI,YAAY,EAAE;QACxN,OAAO,EAAE,2KAA2K,eAAe,IAAI,YAAY,EAAE;QACrN,QAAQ,EAAE,gPAAgP,eAAe,IAAI,YAAY,EAAE;KAC5R;IACD,KAAK,EAAE;QACL,KAAK,EAAE,8JAA8J,eAAe,IAAI,YAAY,EAAE;QACtM,OAAO,EAAE,uJAAuJ,eAAe,IAAI,YAAY,EAAE;QACjM,QAAQ,EAAE,uNAAuN,eAAe,IAAI,YAAY,EAAE;KACnQ;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oCAAoC,GAA8B,SAAS,CAAC;AAEzF,MAAM,CAAC,MAAM,6BAA6B,GAA0D;IAClG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;CACzC,CAAC"}

package/dist/model-routing.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Auto-select model routing: a reasoning model reads the request and picks
+ * one model from the builder's own list. The instruction is plain English
+ * in `buildModelRoutingPrompt` below, so tuning it is just editing text;
+ * pass your own builder to the hooks' `routingPrompt` option to replace it.
+ */
+import { type GenerationEngine } from "./engine.js";
+import type { DroppedMedia, MediaKind, ModelOption } from "./types.js";
+export interface ModelRoutingInput {
+    /** What the person typed. Empty for media-only requests (e.g. Media Analyzer). */
+    prompt: string;
+    /** What the request produces, e.g. "image" for Create image, "text" for analysis. */
+    outputKind: MediaKind;
+    /** Kinds of media attached, if any. */
+    attachmentKinds: MediaKind[];
+    /** The candidates: only models the builder offers for this request. */
+    models: ModelOption[];
+}
+export declare function buildModelRoutingPrompt({ prompt, outputKind, attachmentKinds, models }: ModelRoutingInput): string;
+/** Finds the model id in a reasoning model's reply, or `undefined` if it named none of `models`. */
+export declare function parseModelRoutingReply(reply: string, models: ModelOption[]): string | undefined;
+export type ModelRoutingResult = {
+    status: "routed";
+    modelId: string;
+} | {
+    status: "fallback";
+    modelId: string;
+    reason: "no-reasoning" | "request-failed" | "invalid-reply";
+    /** The provider's own message when the reasoning call failed. */
+    error?: string;
+};
+export interface RouteModelArgs extends ModelRoutingInput {
+    /** The reasoning engine and model. Omit both and routing falls back without a call. */
+    engine?: GenerationEngine;
+    model?: string;
+    attachments?: DroppedMedia[];
+    /** Replaces `buildModelRoutingPrompt`. */
+    routingPrompt?: (input: ModelRoutingInput) => string;
+    /** Stops the reasoning call; the result is then a `"request-failed"` fallback. */
+    signal?: AbortSignal;
+}
+/**
+ * Asks the reasoning model to pick from `models`. Never throws: when it
+ * can't route (no reasoning model, a failed call, an answer not in the
+ * list) it falls back to the first listed model and says why, so a
+ * routing problem never blocks the request itself.
+ */
+export declare function routeModel(args: RouteModelArgs): Promise<ModelRoutingResult>;
+//# sourceMappingURL=model-routing.d.ts.map

package/dist/model-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-routing.d.ts","sourceRoot":"","sources":["../src/model-routing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,UAAU,EAAE,SAAS,CAAC;IACtB,uCAAuC;IACvC,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,uEAAuE;IACvE,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,iBAAiB,GAAG,MAAM,CAgBlH;AAED,oGAAoG;AACpG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,SAAS,CAO/F;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,GAAG,gBAAgB,GAAG,eAAe,CAAC;IAC5D,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,uFAAuF;IACvF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,MAAM,CAAC;IACrD,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2BlF"}

package/dist/model-routing.js

@@ -0,0 +1,72 @@
+/**
+ * Auto-select model routing: a reasoning model reads the request and picks
+ * one model from the builder's own list. The instruction is plain English
+ * in `buildModelRoutingPrompt` below, so tuning it is just editing text;
+ * pass your own builder to the hooks' `routingPrompt` option to replace it.
+ */
+import { normalizeGenerationError } from "./engine.js";
+export function buildModelRoutingPrompt({ prompt, outputKind, attachmentKinds, models }) {
+    const roster = models.map((m) => `- ${m.id}: ${m.label} (${m.provider}, ${m.speed})`).join("\n");
+    const attached = attachmentKinds.length ? attachmentKinds.join(", ") : "none";
+    const request = prompt.trim() ? prompt.trim() : "(no text; the attached media is the request)";
+    return [
+        `Pick the one model best suited to this request. The output is ${outputKind}.`,
+        `Weigh what the request needs (subject, detail, style, length, attached media) against each model's strengths. Prefer a faster model when the request is simple.`,
+        ``,
+        `Request: ${request}`,
+        `Attached media: ${attached}`,
+        ``,
+        `Models:`,
+        roster,
+        ``,
+        `Reply with only the chosen model id, exactly as written above, and nothing else.`,
+    ].join("\n");
+}
+/** Finds the model id in a reasoning model's reply, or `undefined` if it named none of `models`. */
+export function parseModelRoutingReply(reply, models) {
+    const cleaned = reply.trim().replace(/^[`"'*\s]+|[`"'*.\s]+$/g, "");
+    const exact = models.find((m) => m.id === cleaned);
+    if (exact)
+        return exact.id;
+    // A chatty reply ("I'd pick openai/gpt-5.2 because…"): take the longest
+    // id it contains, so "x/model-pro" wins over its prefix "x/model".
+    return [...models].sort((a, b) => b.id.length - a.id.length).find((m) => reply.includes(m.id))?.id;
+}
+/**
+ * Asks the reasoning model to pick from `models`. Never throws: when it
+ * can't route (no reasoning model, a failed call, an answer not in the
+ * list) it falls back to the first listed model and says why, so a
+ * routing problem never blocks the request itself.
+ */
+export async function routeModel(args) {
+    const fallback = args.models[0]?.id;
+    if (!fallback)
+        throw new Error("routeModel: `models` is empty; there's nothing to pick from.");
+    if (args.models.length === 1)
+        return { status: "routed", modelId: fallback };
+    if (!args.engine || !args.model)
+        return { status: "fallback", modelId: fallback, reason: "no-reasoning" };
+    const input = {
+        prompt: args.prompt,
+        outputKind: args.outputKind,
+        attachmentKinds: args.attachmentKinds,
+        models: args.models,
+    };
+    try {
+        const { src } = await args.engine.generate({
+            modelId: args.model,
+            prompt: (args.routingPrompt ?? buildModelRoutingPrompt)(input),
+            // The media itself helps (e.g. a photo needing an edit-capable model).
+            attachments: args.attachments ?? [],
+            signal: args.signal,
+        });
+        const picked = parseModelRoutingReply(src, args.models);
+        return picked
+            ? { status: "routed", modelId: picked }
+            : { status: "fallback", modelId: fallback, reason: "invalid-reply" };
+    }
+    catch (err) {
+        return { status: "fallback", modelId: fallback, reason: "request-failed", error: normalizeGenerationError(err).message };
+    }
+}
+//# sourceMappingURL=model-routing.js.map

package/dist/model-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-routing.js","sourceRoot":"","sources":["../src/model-routing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAyB,MAAM,aAAa,CAAC;AAc9E,MAAM,UAAU,uBAAuB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAqB;IACxG,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjG,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,8CAA8C,CAAC;IAC/F,OAAO;QACL,iEAAiE,UAAU,GAAG;QAC9E,iKAAiK;QACjK,EAAE;QACF,YAAY,OAAO,EAAE;QACrB,mBAAmB,QAAQ,EAAE;QAC7B,EAAE;QACF,SAAS;QACT,MAAM;QACN,EAAE;QACF,kFAAkF;KACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,MAAqB;IACzE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,EAAE,CAAC;IAC3B,wEAAwE;IACxE,mEAAmE;IACnE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;AACrG,CAAC;AAuBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAoB;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC/F,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC7E,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAE1G,MAAM,KAAK,GAAsB;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACF,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACzC,OAAO,EAAE,IAAI,CAAC,KAAK;YACnB,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,IAAI,uBAAuB,CAAC,CAAC,KAAK,CAAC;YAC9D,uEAAuE;YACvE,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO,MAAM;YACX,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE;YACvC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3H,CAAC;AACH,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The the design data model — Request/Run/Result — plus the pure state
+ * transitions over it: pure, framework-free logic here; `useComposer`
+ * (`@chai-ui/react`) is the thin React binding on top.
+ */
+import type { DroppedMedia, Evaluation, GenerationUseCase, MediaKind, Usage } from "./types.js";
+export interface Request {
+    /** The specific generation use case, when one could be derived — see `deriveGenerationUseCase`. Undefined when the use case (or its kind) has no `GenerationUseCase` match yet, e.g. audio. */
+    mode?: GenerationUseCase;
+    prompt: string;
+    attachments: DroppedMedia[];
+    modelIds: string[];
+    params: Record<string, unknown>;
+    presetId?: string;
+}
+/** `"cancelled"`: the person stopped it. A streamed text result keeps the text that arrived. */
+export type ResultStatus = "queued" | "running" | "done" | "error" | "cancelled";
+export interface Result {
+    id: string;
+    runId: string;
+    modelId: string;
+    status: ResultStatus;
+    output?: {
+        src: string;
+        kind: MediaKind;
+    };
+    usage?: Usage;
+    /** Verdicts from the builder's own backend checks on this output — see `Evaluation`. */
+    evaluations?: Evaluation[];
+    error?: {
+        message: string;
+        reasons?: string[];
+    };
+    /** Set by `startResult` — internal bookkeeping for `durationMs`, not meant to be read directly by a consumer (it's a raw `Date.now()`, not itself a duration). */
+    startedAt?: number;
+    /** How long this result took from `startResult` to `resolveResult`/`failResult`, in ms — `undefined` if it resolved without ever going through `startResult` (e.g. resolved directly from `"queued"`). ResultCard's info-flip is what actually surfaces this (reference: the Figma mock's "3.03s" chip). */
+    durationMs?: number;
+}
+export interface Run {
+    id: string;
+    request: Request;
+    createdAt: number;
+    results: Result[];
+}
+/**
+ * Fans a `Request` out into one `"queued"` `Result` per model — a run's
+ * results all exist from the start, so a caller can render "3 of 4 done"
+ * immediately rather than watching the list grow.
+ */
+export declare function createRun(request: Request): Run;
+export declare function startResult(run: Run, resultId: string): Run;
+/**
+ * Folds partial streamed text into a running result: `output` fills in
+ * while `status` stays `"running"`, so "running with output" is what a
+ * streaming result looks like. A no-op once the result has settled, so a
+ * late chunk can't overwrite a final `resolveResult`/`failResult`.
+ */
+export declare function streamResult(run: Run, resultId: string, textSoFar: string): Run;
+export declare function resolveResult(run: Run, resultId: string, output: Result["output"], usage?: Usage, evaluations?: Evaluation[]): Run;
+export declare function failResult(run: Run, resultId: string, error: Result["error"]): Run;
+/** Marks a queued or running result as stopped by the person. A settled result is left as it is. */
+export declare function cancelResult(run: Run, resultId: string): Run;
+/**
+ * Derives a `GenerationUseCase` from Composer's own `{ kind, label }` use
+ * case plus whether anything is attached — this is real derivation logic,
+ * not just plumbing: the same `kind: "video"` means `"text-to-video"` with
+ * nothing attached but `"image-to-video"` once an image is. Returns
+ * `undefined` for "audio" (no `GenerationUseCase` member exists yet;
+ * audio generation is planned). `"text"` is a text request: a reply to
+ * the prompt, or a description of the attached media ("vision").
+ */
+export declare function deriveGenerationUseCase(useCase: {
+    kind: MediaKind;
+} | null | undefined, attachments: DroppedMedia[]): GenerationUseCase | undefined;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEhG,MAAM,WAAW,OAAO;IACtB,+LAA+L;IAC/L,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gGAAgG;AAChG,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEjF,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC;IAC1C,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wFAAwF;IACxF,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChD,kKAAkK;IAClK,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4SAA4S;IAC5S,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAQD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAa/C;AAMD,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CAI/E;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,EACxB,KAAK,CAAC,EAAE,KAAK,EACb,WAAW,CAAC,EAAE,UAAU,EAAE,GACzB,GAAG,CASL;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAOlF;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAM5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EAC/C,WAAW,EAAE,YAAY,EAAE,GAC1B,iBAAiB,GAAG,SAAS,CAO/B"}

package/dist/run.js

@@ -0,0 +1,90 @@
+/**
+ * The the design data model — Request/Run/Result — plus the pure state
+ * transitions over it: pure, framework-free logic here; `useComposer`
+ * (`@chai-ui/react`) is the thin React binding on top.
+ */
+let idCounter = 0;
+function nextId(prefix) {
+    idCounter += 1;
+    return `${prefix}_${idCounter}_${Math.random().toString(36).slice(2, 7)}`;
+}
+/**
+ * Fans a `Request` out into one `"queued"` `Result` per model — a run's
+ * results all exist from the start, so a caller can render "3 of 4 done"
+ * immediately rather than watching the list grow.
+ */
+export function createRun(request) {
+    const id = nextId("run");
+    return {
+        id,
+        request,
+        createdAt: Date.now(),
+        results: request.modelIds.map((modelId) => ({
+            id: nextId("result"),
+            runId: id,
+            modelId,
+            status: "queued",
+        })),
+    };
+}
+function updateResult(run, resultId, fn) {
+    return { ...run, results: run.results.map((r) => (r.id === resultId ? fn(r) : r)) };
+}
+export function startResult(run, resultId) {
+    return updateResult(run, resultId, (r) => ({ ...r, status: "running", startedAt: Date.now() }));
+}
+/**
+ * Folds partial streamed text into a running result: `output` fills in
+ * while `status` stays `"running"`, so "running with output" is what a
+ * streaming result looks like. A no-op once the result has settled, so a
+ * late chunk can't overwrite a final `resolveResult`/`failResult`.
+ */
+export function streamResult(run, resultId, textSoFar) {
+    return updateResult(run, resultId, (r) => r.status === "running" ? { ...r, output: { src: textSoFar, kind: "text" } } : r);
+}
+export function resolveResult(run, resultId, output, usage, evaluations) {
+    return updateResult(run, resultId, (r) => ({
+        ...r,
+        status: "done",
+        output,
+        usage,
+        evaluations,
+        durationMs: r.startedAt != null ? Date.now() - r.startedAt : undefined,
+    }));
+}
+export function failResult(run, resultId, error) {
+    return updateResult(run, resultId, (r) => ({
+        ...r,
+        status: "error",
+        error,
+        durationMs: r.startedAt != null ? Date.now() - r.startedAt : undefined,
+    }));
+}
+/** Marks a queued or running result as stopped by the person. A settled result is left as it is. */
+export function cancelResult(run, resultId) {
+    return updateResult(run, resultId, (r) => r.status === "queued" || r.status === "running"
+        ? { ...r, status: "cancelled", durationMs: r.startedAt != null ? Date.now() - r.startedAt : undefined }
+        : r);
+}
+/**
+ * Derives a `GenerationUseCase` from Composer's own `{ kind, label }` use
+ * case plus whether anything is attached — this is real derivation logic,
+ * not just plumbing: the same `kind: "video"` means `"text-to-video"` with
+ * nothing attached but `"image-to-video"` once an image is. Returns
+ * `undefined` for "audio" (no `GenerationUseCase` member exists yet;
+ * audio generation is planned). `"text"` is a text request: a reply to
+ * the prompt, or a description of the attached media ("vision").
+ */
+export function deriveGenerationUseCase(useCase, attachments) {
+    if (!useCase)
+        return undefined;
+    const hasMedia = attachments.length > 0;
+    if (useCase.kind === "video")
+        return hasMedia ? "image-to-video" : "text-to-video";
+    if (useCase.kind === "image")
+        return hasMedia ? "image-edit" : "text-to-image";
+    if (useCase.kind === "text")
+        return hasMedia ? "vision" : "text-to-text";
+    return undefined;
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/server/chai-handler.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `createChaiHandler`: the one server route the built-in engines call.
+ * The browser never sees an API key. `createFalEngine()` and
+ * `createOpenRouterEngine()` post to this route (default `/api/chai/...`),
+ * and it adds the key and forwards the request to the provider.
+ *
+ * Built on the web-standard `Request` → `Response`, so the same handler
+ * runs in Next.js, React Router (Remix), Hono, Cloudflare Workers, Bun and
+ * Deno. `toNodeHandler` (./node.ts) adapts it for Express and plain Node.
+ */
+export type ChaiProviderId = "fal" | "openrouter";
+export interface ChaiHandlerOptions {
+    /** Defaults to the `FAL_KEY` environment variable. */
+    falKey?: string;
+    /** Defaults to the `OPENROUTER_API_KEY` environment variable. */
+    openRouterKey?: string;
+    /**
+     * Who may use this route. Return false to reject with 403. Without it,
+     * anyone who can reach your site can spend your API credit: check your
+     * own login or session here before going live.
+     */
+    authorize?: (request: Request) => boolean | Promise<boolean>;
+    /**
+     * The only model ids this route will run, across both providers (e.g.
+     * `"fal-ai/flux/schnell"`, `"anthropic/claude-opus-5"`). Anything else is
+     * rejected with 403, so nobody can run an expensive model through you.
+     * Omit to allow every model.
+     */
+    allowedModels?: string[];
+    /** Injectable for tests; defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+}
+export interface ChaiHandler {
+    /** Handles any request under the route. */
+    handle: (request: Request) => Promise<Response>;
+    /** The same function, named for frameworks that export one per method (Next.js). */
+    GET: (request: Request) => Promise<Response>;
+    POST: (request: Request) => Promise<Response>;
+    /** Fal's cancel call. */
+    PUT: (request: Request) => Promise<Response>;
+}
+export declare function createChaiHandler(options?: ChaiHandlerOptions): ChaiHandler;
+//# sourceMappingURL=chai-handler.d.ts.map

package/dist/server/chai-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chai-handler.d.ts","sourceRoot":"","sources":["../../src/server/chai-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,YAAY,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,oFAAoF;IACpF,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,yBAAyB;IACzB,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC9C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAmD/E"}

package/dist/server/chai-handler.js

@@ -0,0 +1,106 @@
+/**
+ * `createChaiHandler`: the one server route the built-in engines call.
+ * The browser never sees an API key. `createFalEngine()` and
+ * `createOpenRouterEngine()` post to this route (default `/api/chai/...`),
+ * and it adds the key and forwards the request to the provider.
+ *
+ * Built on the web-standard `Request` → `Response`, so the same handler
+ * runs in Next.js, React Router (Remix), Hono, Cloudflare Workers, Bun and
+ * Deno. `toNodeHandler` (./node.ts) adapts it for Express and plain Node.
+ */
+const FAL_QUEUE_BASE = "https://queue.fal.run";
+const OPENROUTER_CHAT_URL = "https://openrouter.ai/api/v1/chat/completions";
+export function createChaiHandler(options = {}) {
+    const fetchImpl = options.fetch ?? fetch;
+    async function handle(request) {
+        const route = parseRoute(new URL(request.url).pathname);
+        if (!route) {
+            return Response.json({ error: { message: "chai-handler: expected a path ending in /fal/<model…> or /openrouter/chat." } }, { status: 404 });
+        }
+        const fail = (status, message) => errorResponse(route.provider, status, message);
+        if (options.authorize && !(await options.authorize(request)))
+            return fail(403, "Not authorized.");
+        if (route.provider === "openrouter") {
+            if (route.rest !== "chat")
+                return fail(404, `Unknown OpenRouter path "${route.rest}".`);
+            if (request.method !== "POST")
+                return fail(405, "Use POST.");
+            const key = options.openRouterKey ?? readEnv("OPENROUTER_API_KEY");
+            if (!key)
+                return fail(500, "OPENROUTER_API_KEY isn't set on the server.");
+            const body = await request.text();
+            const model = readModel(body);
+            if (options.allowedModels && !(model && options.allowedModels.includes(model))) {
+                return fail(403, `Model "${model ?? "(none)"}" isn't allowed on this server.`);
+            }
+            return forward(fetchImpl, route.provider, OPENROUTER_CHAT_URL, {
+                signal: request.signal,
+                method: "POST",
+                headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
+                body,
+            });
+        }
+        // Fal's queue API: POST /<model> submits, GET /<model>/requests/<id>[/status]
+        // polls, PUT /<model>/requests/<id>/cancel cancels.
+        const isCancel = request.method === "PUT" && route.rest.endsWith("/cancel");
+        if (request.method !== "GET" && request.method !== "POST" && !isCancel)
+            return fail(405, "Use GET or POST.");
+        const key = options.falKey ?? readEnv("FAL_KEY");
+        if (!key)
+            return fail(500, "FAL_KEY isn't set on the server.");
+        if (options.allowedModels && !options.allowedModels.some((m) => route.rest === m || route.rest.startsWith(`${m}/`))) {
+            return fail(403, `Model "${falModel(route.rest)}" isn't allowed on this server.`);
+        }
+        return forward(fetchImpl, route.provider, `${FAL_QUEUE_BASE}/${route.rest}${new URL(request.url).search}`, {
+            signal: request.signal,
+            method: request.method,
+            headers: { Authorization: `Key ${key}`, "Content-Type": "application/json" },
+            body: request.method === "POST" ? await request.text() : undefined,
+        });
+    }
+    return { handle, GET: handle, POST: handle, PUT: handle };
+}
+/** Finds the provider segment anywhere in the path, so the route can be mounted at any prefix. */
+function parseRoute(pathname) {
+    const parts = pathname.split("/").filter(Boolean);
+    const i = parts.findIndex((p) => p === "fal" || p === "openrouter");
+    if (i === -1 || i === parts.length - 1)
+        return null;
+    return { provider: parts[i], rest: parts.slice(i + 1).join("/") };
+}
+/** Passes the provider's response straight through, streaming included. */
+async function forward(fetchImpl, provider, url, init) {
+    try {
+        const upstream = await fetchImpl(url, init);
+        return new Response(upstream.body, {
+            status: upstream.status,
+            headers: { "Content-Type": upstream.headers.get("content-type") ?? "application/json" },
+        });
+    }
+    catch (err) {
+        return errorResponse(provider, 502, `Couldn't reach ${provider === "fal" ? "Fal.ai" : "OpenRouter"}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** Errors in the shape each engine already reads: Fal's `{ error }`, OpenRouter's `{ error: { message } }`. */
+function errorResponse(provider, status, message) {
+    const body = provider === "fal" ? { error: message } : { error: { message } };
+    return Response.json(body, { status });
+}
+function readModel(body) {
+    try {
+        const model = JSON.parse(body).model;
+        return typeof model === "string" ? model : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The model part of a Fal queue path, for error messages: everything before `/requests/`. */
+function falModel(rest) {
+    return rest.split("/requests/")[0];
+}
+function readEnv(name) {
+    const env = globalThis.process?.env;
+    return env?.[name] || undefined;
+}
+//# sourceMappingURL=chai-handler.js.map

package/dist/server/chai-handler.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./chai-handler.js";
+export * from "./node.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,4 @@
+// @chai-ui/core/server: server-only. Never import this from browser code.
+export * from "./chai-handler.js";
+export * from "./node.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}

package/dist/server/node.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Runs a `ChaiHandler` on Node's own request/response objects, for Express
+ * and plain `http.createServer` (and dev servers built on them, like
+ * Vite's). Typed structurally, so this package needs no Node types.
+ */
+import type { ChaiHandler } from "./chai-handler.js";
+interface NodeRequest extends AsyncIterable<Uint8Array | string> {
+    method?: string;
+    url?: string;
+    /** Express keeps the full path here when the route is mounted at a prefix. */
+    originalUrl?: string;
+    headers: Record<string, string | string[] | undefined>;
+}
+interface NodeResponse {
+    statusCode: number;
+    writableEnded?: boolean;
+    on?(event: "close", listener: () => void): unknown;
+    setHeader(name: string, value: string): unknown;
+    write(chunk: Uint8Array): unknown;
+    end(chunk?: string | Uint8Array): unknown;
+}
+export declare function toNodeHandler(handler: ChaiHandler): (req: NodeRequest, res: NodeResponse) => Promise<void>;
+export {};
+//# sourceMappingURL=node.d.ts.map

package/dist/server/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/server/node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,UAAU,WAAY,SAAQ,aAAa,CAAC,UAAU,GAAG,MAAM,CAAC;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACxD;AAED,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACnD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAClC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;CAC3C;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,IAClC,KAAK,WAAW,EAAE,KAAK,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAsClE"}

package/dist/server/node.js

@@ -0,0 +1,60 @@
+/**
+ * Runs a `ChaiHandler` on Node's own request/response objects, for Express
+ * and plain `http.createServer` (and dev servers built on them, like
+ * Vite's). Typed structurally, so this package needs no Node types.
+ */
+export function toNodeHandler(handler) {
+    return async (req, res) => {
+        const host = String(req.headers.host ?? "localhost");
+        const url = new URL(req.originalUrl ?? req.url ?? "/", `http://${host}`);
+        const method = req.method ?? "GET";
+        const headers = new Headers();
+        for (const [name, value] of Object.entries(req.headers)) {
+            if (value !== undefined)
+                headers.set(name, Array.isArray(value) ? value.join(", ") : value);
+        }
+        let body;
+        if (method !== "GET" && method !== "HEAD") {
+            const chunks = [];
+            for await (const chunk of req)
+                chunks.push(typeof chunk === "string" ? new TextEncoder().encode(chunk) : chunk);
+            body = concat(chunks);
+        }
+        // When the browser disconnects (e.g. the person pressed stop), abort the
+        // provider call too, so a stream stops at the provider.
+        const controller = new AbortController();
+        res.on?.("close", () => {
+            if (!res.writableEnded)
+                controller.abort();
+        });
+        const response = await handler.handle(new Request(url, { method, headers, body, signal: controller.signal }));
+        res.statusCode = response.status;
+        response.headers.forEach((value, name) => res.setHeader(name, value));
+        if (!response.body)
+            return void res.end();
+        // Streamed through as it arrives, so streaming text renders live.
+        const reader = response.body.getReader();
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                res.write(value);
+            }
+        }
+        catch {
+            // The provider stream was aborted because the browser left; nothing to send.
+        }
+        res.end();
+    };
+}
+function concat(chunks) {
+    const out = new Uint8Array(chunks.reduce((n, c) => n + c.length, 0));
+    let offset = 0;
+    for (const c of chunks) {
+        out.set(c, offset);
+        offset += c.length;
+    }
+    return out;
+}
+//# sourceMappingURL=node.js.map

package/dist/server/node.js.map

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