@chai-ui/core 0.6.0 → 0.6.1

package/dist/media-analyzer.d.ts

@@ -0,0 +1,55 @@
+import { type GenerationEngine } from "./engine.js";
+import { type MediaAnalysisPromptLength } from "./media-analysis-prompts.js";
+import { type ModelRoutingInput, type ModelRoutingResult } from "./model-routing.js";
+import { type Reasoning } from "./reasoning.js";
+import type { DroppedMedia, ModelOption } from "./types.js";
+export interface MediaAnalyzerAttachment extends DroppedMedia {
+    id: string;
+}
+export interface MediaAnalyzerSubmitPayload {
+    attachments: MediaAnalyzerAttachment[];
+    modelId: string | null;
+    /** When true, the analyzer routes among `models` at submit instead of using `modelId`. */
+    autoSelectModel: boolean;
+    /** The models offered for the attached media's kind. */
+    models: ModelOption[];
+    /** `null` until a person actually picks one — see `MediaAnalyzer`'s `promptLength` prop for why this doesn't default to "concise". */
+    promptLength: MediaAnalysisPromptLength | null;
+}
+export interface MediaAnalyzerOptions {
+    /**
+     * Overrides the nearest `ChaiProvider`'s reasoning engine. With neither,
+     * a mock text engine answers, so a first render works with no key.
+     */
+    engine?: GenerationEngine;
+    /** The model when the person hasn't picked one. Defaults to the provider's reasoning model for the media's kind. */
+    model?: string;
+    onResult?: (prompt: string) => void;
+    onError?: (message: string) => void;
+    /** Auto-select: fires with the routed model so the trigger shows it. Wire it to `MediaAnalyzer`'s `onModelChange` state. */
+    onModelChange?: (modelId: string) => void;
+    /** Replaces the routing instruction (`buildModelRoutingPrompt`). */
+    routingPrompt?: (input: ModelRoutingInput) => string;
+    /** Fires when auto-select fell back to the first listed model (no reasoning model, a failed call, or an unlisted reply). Analysis still runs. */
+    onRoutingFallback?: (result: Extract<ModelRoutingResult, {
+        status: "fallback";
+    }>) => void;
+}
+export interface MediaAnalyzerState {
+    analyzing: boolean;
+    error: string | null;
+    prompt: string | null;
+}
+/**
+ * `getOptions` is read on every call, so options can change between
+ * renders; `getProvided` is the nearest provider's reasoning, if any.
+ */
+export declare function createMediaAnalyzerStore(getOptions: () => MediaAnalyzerOptions, getProvided?: () => Reasoning | undefined): {
+    getState: () => MediaAnalyzerState;
+    subscribe(listener: () => void): () => undefined;
+    submit: (payload: MediaAnalyzerSubmitPayload) => void;
+    cancel: () => void;
+    reset: () => void;
+};
+export type MediaAnalyzerStore = ReturnType<typeof createMediaAnalyzerStore>;
+//# sourceMappingURL=media-analyzer.d.ts.map

package/dist/media-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-analyzer.d.ts","sourceRoot":"","sources":["../src/media-analyzer.ts"],"names":[],"mappings":"AASA,OAAO,EAA4D,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAc,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0FAA0F;IAC1F,eAAe,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,sIAAsI;IACtI,YAAY,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,oHAAoH;IACpH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4HAA4H;IAC5H,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,oEAAoE;IACpE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,MAAM,CAAC;IACrD,iJAAiJ;IACjJ,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;CAC3F;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,oBAAoB,EACtC,WAAW,GAAE,MAAM,SAAS,GAAG,SAA2B;;wBAyGpC,MAAM,IAAI;sBA3FP,0BAA0B;;;EAmGpD;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/media-analyzer.js

@@ -0,0 +1,124 @@
+/**
+ * The Media Analyzer's behavior with no framework: sends the attached media
+ * and the instruction for its kind and prompt length
+ * (`MEDIA_ANALYSIS_PROMPTS`) to the reasoning engine, and keeps the
+ * generated prompt, which fills in as the text streams. A small store
+ * (`getState` + `subscribe`) that `useMediaAnalyzer` (React) and the Vue
+ * composable wrap.
+ */
+import { warnNoReasoningOnce } from "./composer.js";
+import { createMockEngine, isAbortError, normalizeGenerationError } from "./engine.js";
+import { DEFAULT_MEDIA_ANALYSIS_PROMPT_LENGTH, MEDIA_ANALYSIS_PROMPTS, } from "./media-analysis-prompts.js";
+import { routeModel } from "./model-routing.js";
+import { reasoningModelFor } from "./reasoning.js";
+const mockTextEngine = createMockEngine({ outputKind: "text" });
+/**
+ * `getOptions` is read on every call, so options can change between
+ * renders; `getProvided` is the nearest provider's reasoning, if any.
+ */
+export function createMediaAnalyzerStore(getOptions, getProvided = () => undefined) {
+    let state = { analyzing: false, error: null, prompt: null };
+    const listeners = new Set();
+    const set = (next) => {
+        state = { ...state, ...next };
+        for (const l of listeners)
+            l();
+    };
+    // Each submit gets an id; a late reply from an earlier submit is dropped,
+    // and its call aborted.
+    let callId = 0;
+    let controller = null;
+    function submit(payload) {
+        const opts = getOptions();
+        const reasoning = getProvided();
+        const id = ++callId;
+        controller?.abort();
+        const { signal } = (controller = new AbortController());
+        set({ error: null, prompt: null });
+        const kind = payload.attachments[0]?.kind;
+        if (kind !== "image" && kind !== "video" && kind !== "audio") {
+            const message = "Attach an image, video, or audio file to analyze.";
+            set({ error: message });
+            opts.onError?.(message);
+            return;
+        }
+        const engine = opts.engine ?? reasoning?.engine ?? mockTextEngine;
+        const defaultModel = opts.model ?? (reasoning ? reasoningModelFor(reasoning, payload.attachments) : undefined);
+        const instruction = MEDIA_ANALYSIS_PROMPTS[kind][payload.promptLength ?? DEFAULT_MEDIA_ANALYSIS_PROMPT_LENGTH];
+        const current = () => id === callId;
+        const autoSelect = payload.autoSelectModel && payload.models.length > 0;
+        const analyze = (modelId) => engine
+            .generate({
+            modelId,
+            prompt: instruction,
+            attachments: payload.attachments,
+            onText: (text) => current() && set({ prompt: text }),
+            signal,
+        })
+            .then(({ src }) => {
+            if (!current())
+                return;
+            set({ prompt: src });
+            getOptions().onResult?.(src);
+        }, (err) => {
+            if (!current() || isAbortError(err))
+                return;
+            const { message } = normalizeGenerationError(err);
+            set({ error: message });
+            getOptions().onError?.(message);
+        })
+            .finally(() => current() && set({ analyzing: false }));
+        set({ analyzing: true });
+        if (!autoSelect) {
+            void analyze(payload.modelId ?? defaultModel);
+            return;
+        }
+        // Auto-select: the reasoning model looks at the media and picks the
+        // analysis model first. A routing problem falls back, never blocks.
+        void routeModel({
+            prompt: "",
+            outputKind: "text",
+            attachmentKinds: payload.attachments.map((a) => a.kind),
+            attachments: payload.attachments,
+            models: payload.models,
+            engine: opts.engine ?? reasoning?.engine,
+            model: defaultModel,
+            routingPrompt: opts.routingPrompt,
+            signal,
+        }).then((routed) => {
+            if (!current() || signal.aborted)
+                return;
+            const latest = getOptions();
+            if (routed.status === "fallback") {
+                if (routed.reason === "no-reasoning")
+                    warnNoReasoningOnce("analysis runs on the first listed model");
+                latest.onRoutingFallback?.(routed);
+            }
+            latest.onModelChange?.(routed.modelId);
+            return analyze(routed.modelId);
+        });
+    }
+    /** Stops the analysis in flight (cancelling at the provider where it can), keeping any text that already streamed in. */
+    function cancel() {
+        callId += 1;
+        controller?.abort();
+        controller = null;
+        set({ analyzing: false });
+    }
+    /** Stops anything in flight and clears the prompt and error, e.g. when the person changes their media. */
+    function reset() {
+        cancel();
+        set({ error: null, prompt: null });
+    }
+    return {
+        getState: () => state,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => void listeners.delete(listener);
+        },
+        submit,
+        cancel,
+        reset,
+    };
+}
+//# sourceMappingURL=media-analyzer.js.map

package/dist/media-analyzer.js.map

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

package/dist/reasoning.d.ts

@@ -0,0 +1,59 @@
+import type { GenerationEngine } from "./engine.js";
+import type { DroppedMedia, MediaKind } from "./types.js";
+/**
+ * The suggested reasoning model for text and images: prompt enhancement,
+ * auto-select routing and image analysis. A default, not a requirement —
+ * pass any model id `reasoningEngine` can run.
+ */
+export declare const DEFAULT_REASONING_MODEL = "anthropic/claude-opus-5";
+/**
+ * Suggested per-kind overrides for media Claude can't read. Gemini takes
+ * video and audio directly. For a cheaper option, swap in
+ * `"qwen/qwen3.8-omni-flash"`, which takes both too.
+ */
+export declare const DEFAULT_REASONING_MODEL_BY_KIND: Partial<Record<MediaKind, string>>;
+/** The reasoning engine and models every CHAI component shares. */
+export interface Reasoning {
+    engine: GenerationEngine;
+    /** The model for text and any attachment kind without its own entry in `modelByKind`. */
+    model: string;
+    modelByKind: Partial<Record<MediaKind, string>>;
+}
+/** What a `ChaiProvider` takes, in any framework. */
+export interface ReasoningConfig {
+    /** Text, image and routing model. Defaults to `DEFAULT_REASONING_MODEL`. */
+    reasoningModel?: string;
+    /**
+     * Per-attachment-kind models, merged over `DEFAULT_REASONING_MODEL_BY_KIND`
+     * one kind at a time, e.g. `{ video: "qwen/qwen3.8-omni-flash" }` keeps
+     * the default for audio. Map a kind to `reasoningModel`'s value to use
+     * one model for everything.
+     */
+    reasoningModelByKind?: Partial<Record<MediaKind, string>>;
+    /**
+     * The engine the reasoning models run on. Defaults to OpenRouter,
+     * independent of the generation engine: Fal's own LLM access is an
+     * OpenRouter proxy, so defaulting to it would double-proxy.
+     */
+    reasoningEngine?: GenerationEngine;
+}
+/** A provider's `Reasoning`, from its config and the engine it holds (`config.reasoningEngine`, else one OpenRouter engine it created once). */
+export declare function createReasoning(config: ReasoningConfig, engine: GenerationEngine): Reasoning;
+/** The reasoning engine a provider uses: the one passed, else OpenRouter's. */
+export declare function reasoningEngineFor(config: ReasoningConfig): GenerationEngine;
+/**
+ * A hook's or composable's own pair wins, but only as a pair: half of one
+ * never mixes with half of the provider's (e.g. a hook engine with the
+ * provider's model). Half a pair means no reasoning.
+ */
+export declare function pickReasoning(own: {
+    reasoningEngine?: GenerationEngine;
+    reasoningModel?: string;
+}, provided: Reasoning | undefined): Reasoning | undefined;
+/**
+ * The reasoning model for a call with these attachments: the first
+ * attachment whose kind has its own model wins (a clip plus a still goes
+ * to the model that can read the clip), else `reasoning.model`.
+ */
+export declare function reasoningModelFor(reasoning: Reasoning, attachments?: DroppedMedia[]): string;
+//# sourceMappingURL=reasoning.d.ts.map

package/dist/reasoning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.d.ts","sourceRoot":"","sources":["../src/reasoning.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAG9E,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;IACzB,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;OAIG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,gJAAgJ;AAChJ,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAQ5F;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE;IAAE,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EACpE,QAAQ,EAAE,SAAS,GAAG,SAAS,GAC9B,SAAS,GAAG,SAAS,CAIvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,GAAE,YAAY,EAAO,GAAG,MAAM,CAMhG"}

package/dist/reasoning.js

@@ -0,0 +1,55 @@
+import { createOpenRouterEngine } from "./engines/openrouter.js";
+/**
+ * The suggested reasoning model for text and images: prompt enhancement,
+ * auto-select routing and image analysis. A default, not a requirement —
+ * pass any model id `reasoningEngine` can run.
+ */
+export const DEFAULT_REASONING_MODEL = "anthropic/claude-opus-5";
+/**
+ * Suggested per-kind overrides for media Claude can't read. Gemini takes
+ * video and audio directly. For a cheaper option, swap in
+ * `"qwen/qwen3.8-omni-flash"`, which takes both too.
+ */
+export const DEFAULT_REASONING_MODEL_BY_KIND = {
+    video: "google/gemini-3.8-flash",
+    audio: "google/gemini-3.8-flash",
+};
+/** A provider's `Reasoning`, from its config and the engine it holds (`config.reasoningEngine`, else one OpenRouter engine it created once). */
+export function createReasoning(config, engine) {
+    const byKind = config.reasoningModelByKind ?? {};
+    const overrides = Object.fromEntries(Object.entries(byKind).filter(([, v]) => v !== undefined));
+    return {
+        engine,
+        model: config.reasoningModel ?? DEFAULT_REASONING_MODEL,
+        modelByKind: { ...DEFAULT_REASONING_MODEL_BY_KIND, ...overrides },
+    };
+}
+/** The reasoning engine a provider uses: the one passed, else OpenRouter's. */
+export function reasoningEngineFor(config) {
+    return config.reasoningEngine ?? createOpenRouterEngine();
+}
+/**
+ * A hook's or composable's own pair wins, but only as a pair: half of one
+ * never mixes with half of the provider's (e.g. a hook engine with the
+ * provider's model). Half a pair means no reasoning.
+ */
+export function pickReasoning(own, provided) {
+    const { reasoningEngine, reasoningModel } = own;
+    if (!reasoningEngine && !reasoningModel)
+        return provided;
+    return reasoningEngine && reasoningModel ? { engine: reasoningEngine, model: reasoningModel, modelByKind: {} } : undefined;
+}
+/**
+ * The reasoning model for a call with these attachments: the first
+ * attachment whose kind has its own model wins (a clip plus a still goes
+ * to the model that can read the clip), else `reasoning.model`.
+ */
+export function reasoningModelFor(reasoning, attachments = []) {
+    for (const { kind } of attachments) {
+        const model = reasoning.modelByKind[kind];
+        if (model)
+            return model;
+    }
+    return reasoning.model;
+}
+//# sourceMappingURL=reasoning.js.map

package/dist/reasoning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.js","sourceRoot":"","sources":["../src/reasoning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAIjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAuC;IACjF,KAAK,EAAE,yBAAyB;IAChC,KAAK,EAAE,yBAAyB;CACjC,CAAC;AA6BF,gJAAgJ;AAChJ,MAAM,UAAU,eAAe,CAAC,MAAuB,EAAE,MAAwB;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IAChG,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,cAAc,IAAI,uBAAuB;QACvD,WAAW,EAAE,EAAE,GAAG,+BAA+B,EAAE,GAAG,SAAS,EAAE;KAClE,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACxD,OAAO,MAAM,CAAC,eAAe,IAAI,sBAAsB,EAAE,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAoE,EACpE,QAA+B;IAE/B,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC;IAChD,IAAI,CAAC,eAAe,IAAI,CAAC,cAAc;QAAE,OAAO,QAAQ,CAAC;IACzD,OAAO,eAAe,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7H,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoB,EAAE,cAA8B,EAAE;IACtF,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chai-ui/core",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "CHAI UI headless core — the Request/Run/Result data model and pluggable generation engines (Fal.ai, OpenRouter, mock). No framework, no rendering.",
   "license": "MIT",
   "author": "kazarazat",