@chai-ui/core 0.1.0

package/dist/engines/fal.js

@@ -0,0 +1,209 @@
+/**
+ * A real `GenerationEngine` backed by Fal.ai (fal.ai) — CHAI's default
+ * model marketplace as of 2026-09-24, chosen for the
+ * text/image-to-video and audio-generation coverage OpenRouter lacks.
+ * OpenRouter remains a fully-supported alternative, not deprecated by
+ * this — see the Develop page's "Model providers" section.
+ *
+ * Handles media generation only: produces real image/video media via Fal's
+ * queue API (submit → poll → fetch result). Fal's own vision/LLM access
+ * (`any-llm`, `any-llm/vision`) is itself a proxy in front of OpenRouter,
+ * not an independent catalog — for text/reasoning calls
+ * (e.g. prompt enhancement, media analysis) use `createOpenRouterEngine`
+ * instead of routing through Fal to OpenRouter.
+ *
+ * Security: this engine never sees an API key and never calls
+ * `queue.fal.run` directly. It calls a same-origin `endpoint` (default
+ * `/api/chai/fal`, served by `createChaiHandler`) that a server-side proxy owns and mirrors Fal's own queue
+ * URL shape (`/{model}`, `/{model}/requests/{id}/status`,
+ * `/{model}/requests/{id}`) — the proxy is the only thing that reads
+ * `FAL_KEY` and attaches the `Authorization: Key ...` header. Passing a
+ * key into this file would put it in the browser bundle; don't add one.
+ */
+import { abortError, abortableSleep, isAbortError, readEvaluations } from "../engine.js";
+/**
+ * Fal model ids verified live against fal.ai's own docs/catalog
+ * 2026-09-24, not invented. No default for "audio": CHAI has no audio
+ * `GenerationUseCase` yet, so guessing one
+ * here would be ahead of any real use case that needs it.
+ */
+const DEFAULT_MODEL_BY_KIND = {
+    image: "fal-ai/flux/schnell",
+    video: "minimax/h3-max/text-to-video",
+};
+const DEFAULT_POLL_INTERVAL_MS = 1500;
+const DEFAULT_TIMEOUT_MS = 120_000;
+/** Fal's error shape varies by failure type — validation errors carry `detail`, job failures carry `error`. Prefer whichever is present and stringify a non-string one. */
+export function describeFalError(json, fallback) {
+    const raw = json.error ?? json.detail;
+    if (!raw)
+        return fallback;
+    if (typeof raw === "string")
+        return raw;
+    try {
+        return JSON.stringify(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+/** Builds the one Fal request body CHAI sends — a prompt, plus an `image_url` when an attached image is available (for image-to-video / edit-shaped models). */
+export function buildFalRequestBody(args) {
+    const body = { prompt: args.prompt };
+    if (args.media?.kind === "image")
+        body.image_url = args.media.src;
+    return body;
+}
+/** Pulls the generated media URL out of Fal's result JSON for the given output kind — the response shape differs by modality. */
+export function extractFalResultSrc(json, kind) {
+    if (kind === "image")
+        return json.images?.[0]?.url;
+    if (kind === "video")
+        return json.video?.url;
+    return json.audio?.url ?? json.audio_url;
+}
+async function submitFalJob(args) {
+    const res = await args.fetchImpl(`${args.endpoint}/${args.model}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(args.body),
+    });
+    const json = (await res.json().catch(() => ({})));
+    if (!res.ok || json.error)
+        throw new Error(describeFalError(json, `${res.status} ${res.statusText}`));
+    if (!json.request_id)
+        throw new Error("submit response had no request_id");
+    return { requestId: json.request_id, status: json.status ?? "IN_QUEUE" };
+}
+/** Polls a submitted job's status until `COMPLETED`, then fetches and returns its result. */
+async function awaitFalJob(args) {
+    let status = args.status;
+    const deadline = Date.now() + args.timeoutMs;
+    while (status !== "COMPLETED") {
+        if (Date.now() > deadline) {
+            throw new Error(`timed out after ${args.timeoutMs}ms waiting for the job to complete`);
+        }
+        await abortableSleep(args.pollIntervalMs, args.signal);
+        const res = await args.fetchImpl(`${args.endpoint}/${args.model}/requests/${args.requestId}/status`);
+        const json = (await res.json().catch(() => ({})));
+        if (!res.ok || json.error)
+            throw new Error(describeFalError(json, `${res.status} ${res.statusText}`));
+        status = json.status ?? status;
+    }
+    const res = await args.fetchImpl(`${args.endpoint}/${args.model}/requests/${args.requestId}`);
+    const json = (await res.json().catch(() => ({})));
+    if (!res.ok || json.error)
+        throw new Error(describeFalError(json, `${res.status} ${res.statusText}`));
+    return json;
+}
+/**
+ * Asks Fal to drop a job (`PUT …/requests/<id>/cancel`). A queued job is
+ * removed and never runs; a running one gets a cancel signal and may still
+ * finish, depending on the model. Best effort: a failed cancel call is
+ * ignored, since the person has already stopped waiting.
+ */
+async function cancelFalJob(args) {
+    await args.fetchImpl(`${args.endpoint}/${args.model}/requests/${args.requestId}/cancel`, { method: "PUT" }).catch(() => { });
+}
+/**
+ * A media-generation `GenerationEngine` — submits the prompt (plus the
+ * first attached image, if any) to Fal's queue API and polls until the job
+ * completes, returning the real generated `src` URL. Calls the caller's
+ * `modelId` when given, otherwise `modelByKind`/`model`/the built-in default.
+ */
+export function createFalEngine(options = {}) {
+    const endpoint = options.endpoint ?? "/api/chai/fal";
+    // Called through a wrapper, never as `args.fetchImpl(...)`: browsers throw
+    // "Illegal invocation" when fetch runs with an object as `this`.
+    const fetchImpl = (input, init) => (options.fetchImpl ?? fetch)(input, init);
+    const outputKind = options.outputKind ?? "image";
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    return {
+        async generate({ modelId, prompt, attachments, signal }) {
+            const model = modelId ?? options.modelByKind?.[outputKind] ?? options.model ?? DEFAULT_MODEL_BY_KIND[outputKind];
+            if (!model) {
+                throw new Error(`falEngine: no model configured for outputKind "${outputKind}" — pass \`model\` or \`modelByKind.${outputKind}\`.`);
+            }
+            const body = buildFalRequestBody({ prompt, media: attachments[0] });
+            if (signal?.aborted)
+                throw abortError();
+            try {
+                // The submit itself isn't aborted mid-flight: without its request id
+                // there'd be nothing to cancel at Fal.
+                const { requestId, status } = await submitFalJob({ endpoint, model, body, fetchImpl });
+                if (signal?.aborted) {
+                    await cancelFalJob({ endpoint, model, requestId, fetchImpl });
+                    throw abortError();
+                }
+                const result = await awaitFalJob({
+                    endpoint,
+                    model,
+                    requestId,
+                    status,
+                    fetchImpl,
+                    pollIntervalMs,
+                    timeoutMs,
+                    signal,
+                }).catch(async (err) => {
+                    if (isAbortError(err))
+                        await cancelFalJob({ endpoint, model, requestId, fetchImpl });
+                    throw err;
+                });
+                const src = extractFalResultSrc(result, outputKind);
+                if (!src)
+                    throw new Error(`no ${outputKind} output in Fal's response`);
+                // No `usage`: Fal bills per generation, not per token — `Usage`
+                // is token-shaped (promptTokens/completionTokens), and fabricating
+                // token counts to fit it would be a worse guess than reporting
+                // nothing, per the same rule `openrouter.ts`'s
+                // `pricePerMillionTokens` comment documents for cost.
+                return { src, kind: outputKind, evaluations: readEvaluations(result) };
+            }
+            catch (err) {
+                if (isAbortError(err))
+                    throw err;
+                throw new Error(`falEngine: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    };
+}
+/**
+ * A minimal, cheap connectivity check against Fal's fastest image model —
+ * the "use real inference sparingly" path, same role as `pingOpenRouter`.
+ * Deliberately not a `GenerationEngine` and not exercised by any automated
+ * test: meant to be triggered once, by a person, from the Develop page's
+ * "Test connection" button.
+ */
+export async function pingFal(options = {}) {
+    const endpoint = options.endpoint ?? "/api/chai/fal";
+    // Called through a wrapper, never as `args.fetchImpl(...)`: browsers throw
+    // "Illegal invocation" when fetch runs with an object as `this`.
+    const fetchImpl = (input, init) => (options.fetchImpl ?? fetch)(input, init);
+    const model = options.model ?? DEFAULT_MODEL_BY_KIND.image;
+    try {
+        const { requestId, status } = await submitFalJob({
+            endpoint,
+            model,
+            body: buildFalRequestBody({ prompt: "a single red circle on a white background" }),
+            fetchImpl,
+        });
+        const result = await awaitFalJob({
+            endpoint,
+            model,
+            requestId,
+            status,
+            fetchImpl,
+            pollIntervalMs: 1000,
+            timeoutMs: 30_000,
+        });
+        const src = extractFalResultSrc(result, "image");
+        if (!src)
+            return { ok: false, error: "no image output in Fal's response" };
+        return { ok: true, src };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=fal.js.map

package/dist/engines/fal.js.map

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

package/dist/engines/openrouter.d.ts

@@ -0,0 +1,141 @@
+/**
+ * A real text/reasoning `GenerationEngine` backed by OpenRouter
+ * (openrouter.ai) — a fully-supported alternative to the default Fal.ai
+ * (see the Develop page's "Model providers" section). Returns text: prompt
+ * enhancement, media analysis (vision/video/audio understanding), and any
+ * other text-out call.
+ *
+ * Security: this engine never sees an API key and never calls
+ * `openrouter.ai` directly. It POSTs to a same-origin `endpoint` (default
+ * `/api/chai/openrouter/chat`, served by `createChaiHandler`) that a server-side proxy owns — the proxy is the
+ * only thing that reads `OPENROUTER_API_KEY` and attaches the
+ * `Authorization` header. Passing a key into this file would put it in the
+ * browser bundle; don't add one.
+ */
+import { type GenerationEngine } from "../engine.js";
+import type { DroppedMedia, Evaluation, MediaKind } from "../types.js";
+export interface OpenRouterEngineOptions {
+    /** Same-origin proxy path that attaches the real key server-side. */
+    endpoint?: string;
+    /** OpenRouter model id (e.g. "google/gemini-2.5-flash"), used when the caller passes no `modelId` and no `modelByKind` entry matches. */
+    model?: string;
+    /** Per-attached-media-kind model override, e.g. a vision model for images and a different one for audio. */
+    modelByKind?: Partial<Record<MediaKind, string>>;
+    /**
+     * Cap on the model's response length. Required in practice, not just
+     * cost hygiene: some providers/models reject a request with no cap at
+     * all (defaulting to their max, e.g. 65535) once it exceeds the
+     * account's available credits, rather than just truncating. Defaults to
+     * a one-paragraph-ish budget — enough for a "detailed" seed-prompt
+     * description.
+     */
+    maxTokens?: number;
+    /**
+     * USD per million tokens for whichever model this engine calls, if you
+     * want a real cost figure on the returned `usage` instead of just token
+     * counts. Deliberately not defaulted to anything: OpenRouter's real
+     * per-model pricing isn't tracked anywhere in this repo, and a guessed
+     * number would be worse than an honestly absent cost. Pull the real rate
+     * from OpenRouter's `/models` endpoint or your own account dashboard and
+     * pass it here if you want `usage.costUsd` populated.
+     */
+    pricePerMillionTokens?: {
+        input: number;
+        output: number;
+    };
+    /** Injectable for tests; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+type ChatContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image_url";
+    image_url: {
+        url: string;
+    };
+} | {
+    type: "video_url";
+    video_url: {
+        url: string;
+    };
+} | {
+    type: "input_audio";
+    input_audio: {
+        data: string;
+        format: string;
+    };
+};
+interface ChatCompletionResponse {
+    choices?: {
+        message?: {
+            content?: string;
+        };
+    }[];
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+    error?: {
+        message?: string;
+        metadata?: {
+            raw?: string;
+        };
+    };
+}
+/** Builds the one non-text content part for an attached image/video/audio file. */
+export declare function contentPartForMedia(media: DroppedMedia): ChatContentPart;
+/** Builds the OpenRouter chat-completions request body for a prompt plus any attached media. */
+export declare function buildChatRequest(args: {
+    model: string;
+    prompt: string;
+    media?: DroppedMedia[];
+    maxTokens?: number;
+}): {
+    model: string;
+    messages: {
+        role: "user";
+        content: ChatContentPart[];
+    }[];
+    max_tokens: number;
+};
+/**
+ * Reads an OpenRouter server-sent-events stream (`stream: true`), calling
+ * `onText` with the accumulated reply as each chunk lands. Handles the
+ * `: OPENROUTER PROCESSING` keep-alive comments and the `[DONE]` sentinel,
+ * and still works if a proxy buffered the whole stream into one body.
+ */
+export declare function readChatStream(res: Response, onText: (textSoFar: string) => void): Promise<{
+    text: string;
+    usage?: ChatCompletionResponse["usage"];
+    evaluations?: Evaluation[];
+}>;
+/**
+ * Sends the prompt plus every attached file to OpenRouter via the local
+ * proxy and returns the model's reply as `"text"`. Calls the caller's
+ * `modelId` when given, otherwise `modelByKind` (keyed on the first
+ * attachment's kind), `model`, or the built-in default. Streams (OpenRouter's
+ * `stream: true`) when the caller passes `onText`; the proxy must pass the
+ * response body through rather than buffer it for that to be incremental.
+ */
+export declare function createOpenRouterEngine(options?: OpenRouterEngineOptions): GenerationEngine;
+/**
+ * A minimal, cheap connectivity check — the "use real inference sparingly"
+ * path. Deliberately not a `GenerationEngine` and not exercised by any
+ * automated test: it's meant to be triggered once, by a person, from the
+ * Develop page's "Test connection" button.
+ */
+export declare function pingOpenRouter(options?: {
+    endpoint?: string;
+    model?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<{
+    ok: true;
+    reply: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+export {};
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/engines/openrouter.d.ts.map

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

package/dist/engines/openrouter.js

@@ -0,0 +1,220 @@
+/**
+ * A real text/reasoning `GenerationEngine` backed by OpenRouter
+ * (openrouter.ai) — a fully-supported alternative to the default Fal.ai
+ * (see the Develop page's "Model providers" section). Returns text: prompt
+ * enhancement, media analysis (vision/video/audio understanding), and any
+ * other text-out call.
+ *
+ * Security: this engine never sees an API key and never calls
+ * `openrouter.ai` directly. It POSTs to a same-origin `endpoint` (default
+ * `/api/chai/openrouter/chat`, served by `createChaiHandler`) that a server-side proxy owns — the proxy is the
+ * only thing that reads `OPENROUTER_API_KEY` and attaches the
+ * `Authorization` header. Passing a key into this file would put it in the
+ * browser bundle; don't add one.
+ */
+import { readEvaluations } from "../engine.js";
+const DEFAULT_MODEL = "google/gemini-2.5-flash";
+const DEFAULT_MAX_TOKENS = 800;
+/** Converts OpenRouter's raw `usage` into `Usage`, computing `costUsd` only when a real rate was supplied. */
+function toUsage(usage, pricePerMillionTokens) {
+    if (!usage)
+        return undefined;
+    const promptTokens = usage.prompt_tokens ?? 0;
+    const completionTokens = usage.completion_tokens ?? 0;
+    const costUsd = pricePerMillionTokens
+        ? (promptTokens * pricePerMillionTokens.input +
+            completionTokens * pricePerMillionTokens.output) /
+            1_000_000
+        : undefined;
+    return {
+        promptTokens,
+        completionTokens,
+        totalTokens: usage.total_tokens ?? promptTokens + completionTokens,
+        costUsd,
+    };
+}
+/** Prefers the upstream provider's own error message over OpenRouter's generic wrapper, when both are present. */
+function describeError(json, fallback) {
+    const base = json.error?.message ?? fallback;
+    const raw = json.error?.metadata?.raw;
+    if (!raw)
+        return base;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed.error?.message && parsed.error.message !== base) {
+            return `${base} — ${parsed.error.message}`;
+        }
+    }
+    catch {
+        // Not JSON; the generic message is all we have.
+    }
+    return base;
+}
+/** Builds the one non-text content part for an attached image/video/audio file. */
+export function contentPartForMedia(media) {
+    if (media.kind === "video") {
+        return { type: "video_url", video_url: { url: media.src } };
+    }
+    if (media.kind === "audio") {
+        // OpenRouter's input_audio wants raw base64 + a format string, not a
+        // data: URL — audio can't be passed by URL at all per OpenRouter docs.
+        const match = /^data:audio\/(\w+);base64,(.+)$/.exec(media.src);
+        if (!match) {
+            throw new Error("openRouterEngine: audio media must be a base64 data URL (data:audio/<format>;base64,...)");
+        }
+        return { type: "input_audio", input_audio: { data: match[2], format: match[1] } };
+    }
+    return { type: "image_url", image_url: { url: media.src } };
+}
+/** Builds the OpenRouter chat-completions request body for a prompt plus any attached media. */
+export function buildChatRequest(args) {
+    const content = [{ type: "text", text: args.prompt }];
+    for (const media of args.media ?? [])
+        content.push(contentPartForMedia(media));
+    return {
+        model: args.model,
+        messages: [{ role: "user", content }],
+        max_tokens: args.maxTokens ?? DEFAULT_MAX_TOKENS,
+    };
+}
+/**
+ * Reads an OpenRouter server-sent-events stream (`stream: true`), calling
+ * `onText` with the accumulated reply as each chunk lands. Handles the
+ * `: OPENROUTER PROCESSING` keep-alive comments and the `[DONE]` sentinel,
+ * and still works if a proxy buffered the whole stream into one body.
+ */
+export async function readChatStream(res, onText) {
+    let text = "";
+    let usage;
+    let evaluations;
+    let buffer = "";
+    const handleLine = (line) => {
+        if (!line.startsWith("data:"))
+            return; // blank separators and ": keep-alive" comments
+        const data = line.slice(5).trim();
+        if (!data || data === "[DONE]")
+            return;
+        let chunk;
+        try {
+            chunk = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        if (chunk.error) {
+            throw new Error(`openRouterEngine: ${describeError({ error: chunk.error }, "stream error")}`);
+        }
+        if (chunk.usage)
+            usage = chunk.usage;
+        // A backend that checks the output appends its verdicts as their own chunk.
+        evaluations = readEvaluations(chunk) ?? evaluations;
+        const delta = chunk.choices?.[0]?.delta?.content;
+        if (delta) {
+            text += delta;
+            onText(text);
+        }
+    };
+    const drain = (final) => {
+        const lines = buffer.split("\n");
+        buffer = final ? "" : lines.pop();
+        for (const line of lines)
+            handleLine(line.trimEnd());
+    };
+    if (res.body) {
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            drain(false);
+        }
+        buffer += decoder.decode();
+    }
+    else {
+        buffer = await res.text();
+    }
+    drain(true);
+    return { text, usage, evaluations };
+}
+/**
+ * Sends the prompt plus every attached file to OpenRouter via the local
+ * proxy and returns the model's reply as `"text"`. Calls the caller's
+ * `modelId` when given, otherwise `modelByKind` (keyed on the first
+ * attachment's kind), `model`, or the built-in default. Streams (OpenRouter's
+ * `stream: true`) when the caller passes `onText`; the proxy must pass the
+ * response body through rather than buffer it for that to be incremental.
+ */
+export function createOpenRouterEngine(options = {}) {
+    const endpoint = options.endpoint ?? "/api/chai/openrouter/chat";
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return {
+        async generate({ modelId, prompt, attachments, onText, signal }) {
+            const firstKind = attachments[0]?.kind;
+            const model = modelId || (firstKind && options.modelByKind?.[firstKind]) || options.model || DEFAULT_MODEL;
+            const body = buildChatRequest({ model, prompt, media: attachments, maxTokens: options.maxTokens });
+            // Aborting closes the connection. On a stream, OpenRouter then stops
+            // the model and billing for providers that support it; a
+            // non-streaming request keeps running at the provider.
+            const res = await fetchImpl(endpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(onText ? { ...body, stream: true } : body),
+                signal,
+            });
+            // A rejected request comes back as plain JSON even when streaming was
+            // asked for, so only a successful response is read as a stream.
+            if (onText && res.ok) {
+                const { text, usage, evaluations } = await readChatStream(res, onText);
+                if (!text)
+                    throw new Error("openRouterEngine: empty response from OpenRouter");
+                return { src: text, kind: "text", usage: toUsage(usage, options.pricePerMillionTokens), evaluations };
+            }
+            const json = (await res.json().catch(() => ({})));
+            if (!res.ok || json.error) {
+                throw new Error(`openRouterEngine: ${describeError(json, `${res.status} ${res.statusText}`)}`);
+            }
+            const text = json.choices?.[0]?.message?.content;
+            if (!text)
+                throw new Error("openRouterEngine: empty response from OpenRouter");
+            return {
+                src: text,
+                kind: "text",
+                usage: toUsage(json.usage, options.pricePerMillionTokens),
+                evaluations: readEvaluations(json),
+            };
+        },
+    };
+}
+/**
+ * A minimal, cheap connectivity check — the "use real inference sparingly"
+ * path. Deliberately not a `GenerationEngine` and not exercised by any
+ * automated test: it's meant to be triggered once, by a person, from the
+ * Develop page's "Test connection" button.
+ */
+export async function pingOpenRouter(options = {}) {
+    const endpoint = options.endpoint ?? "/api/chai/openrouter/chat";
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const model = options.model ?? DEFAULT_MODEL;
+    try {
+        const res = await fetchImpl(endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                model,
+                messages: [{ role: "user", content: "Reply with exactly one word: OK." }],
+                max_tokens: 5,
+            }),
+        });
+        const json = (await res.json().catch(() => ({})));
+        if (!res.ok || json.error) {
+            return { ok: false, error: describeError(json, `${res.status} ${res.statusText}`) };
+        }
+        return { ok: true, reply: json.choices?.[0]?.message?.content?.trim() ?? "" };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/engines/openrouter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./engine.js";
+export * from "./run.js";
+export * from "./media-analysis-prompts.js";
+export * from "./engines/openrouter.js";
+export * from "./engines/fal.js";
+export * from "./model-routing.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":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./engine.js";
+export * from "./run.js";
+export * from "./media-analysis-prompts.js";
+export * from "./engines/openrouter.js";
+export * from "./engines/fal.js";
+export * from "./model-routing.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,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/media-analysis-prompts.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export type MediaAnalysisKind = "image" | "video" | "audio";
+export type MediaAnalysisPromptLength = "terse" | "concise" | "detailed";
+export declare const MEDIA_ANALYSIS_PROMPTS: Record<MediaAnalysisKind, Record<MediaAnalysisPromptLength, string>>;
+export declare const DEFAULT_MEDIA_ANALYSIS_PROMPT_LENGTH: MediaAnalysisPromptLength;
+export declare const MEDIA_ANALYSIS_PROMPT_LENGTHS: {
+    value: MediaAnalysisPromptLength;
+    label: string;
+}[];
+//# sourceMappingURL=media-analysis-prompts.d.ts.map

package/dist/media-analysis-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-analysis-prompts.d.ts","sourceRoot":"","sources":["../src/media-analysis-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAC5D,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAMzE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,iBAAiB,EACjB,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAiB1C,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,yBAAqC,CAAC;AAEzF,eAAO,MAAM,6BAA6B,EAAE;IAAE,KAAK,EAAE,yBAAyB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAI9F,CAAC"}