@srouterhq/server 0.0.0-stage → 0.9.0

package/dist/services/embeddings.d.ts

@@ -0,0 +1,76 @@
+import type { Db } from '../db/types.js';
+export interface EmbeddingModelRow {
+    id: number;
+    family: string;
+    platform: string;
+    model_id: string;
+    display_name: string;
+    dimensions: number;
+    max_input_tokens: number | null;
+    priority: number;
+    enabled: number;
+    quota_label: string;
+    key_id: number | null;
+}
+export interface EmbeddingsResult {
+    family: string;
+    platform: string;
+    modelId: string;
+    dimensions: number;
+    vectors: number[][];
+    inputTokens: number;
+}
+export declare class EmbeddingsError extends Error {
+    status: number;
+    code?: string;
+    /** Back-off the upstream provider stated (`Retry-After` header or a
+     *  retry-delay field in the error body), in milliseconds. Kept separate from
+     *  the message so the route can answer the client with a real Retry-After
+     *  instead of a bare 429, the same way the chat router benches keys. */
+    retryAfterMs?: number;
+    constructor(message: string, status: number, code?: string, retryAfterMs?: number);
+}
+export declare function listEmbeddingModels(): EmbeddingModelRow[];
+export declare function getDefaultFamily(): string;
+/** Map the request's `model` to a family: 'auto'/empty → default; a family
+ * name → itself; a provider-specific model id → its family. */
+export declare function resolveFamily(model: string | undefined): string | null;
+/** Provider adapters that can safely receive catalog-managed embedding rows. */
+export declare const EMBEDDING_PLATFORMS: Set<string>;
+export declare function probeEmbeddingDimensions(baseUrl: string, key: string, modelId: string): Promise<number>;
+export interface CustomEmbeddingRegistration {
+    keyId: number;
+    modelId: string;
+    displayName: string | null;
+    family: string;
+    dimensions: number;
+    maxInputTokens: number | null;
+    quotaLabel: string;
+}
+/**
+ * Upsert one custom embedding model bound to an endpoint credential — the
+ * shared write path behind POST /api/embeddings/custom and the bulk key
+ * importer (#382). Throws EmbeddingsError(400) when the family already exists
+ * at a different dimension: vectors from mismatched spaces must never mix, so
+ * the caller has to pick a new family name instead.
+ */
+export declare function registerCustomEmbeddingModel(db: Db, reg: CustomEmbeddingRegistration): {
+    modelDbId: number;
+    created: boolean;
+};
+/** Embed `inputs` via the family's provider chain, failing over within the
+ * family on any provider error. Throws EmbeddingsError when the chain is dry.
+ *
+ * `dimensions` (optional): client-supplied output-dimension override forwarded to
+ * providers that support MRL truncation (NVIDIA NeMo NIM, Google Gemini Embedding,
+ * OpenAI text-embedding-3-*). Providers that ignore the field see an identical
+ * request body. The override is independent of the model's native dimension — the
+ * family registry still pins the canonical dimension, this just lets callers ask
+ * for a smaller vector at the cost of some accuracy. */
+export declare function runEmbeddings(model: string | undefined, inputs: string[], dimensions?: number): Promise<EmbeddingsResult>;
+/** Whole seconds the client should wait before retrying an embeddings request:
+ *  the soonest upstream back-off when the whole chain was rate limited, else the
+ *  monthly-budget reset for a local quota block. Undefined means the caller
+ *  shouldn't set the header. */
+export declare function embeddingsRetryAfterSec(err: EmbeddingsError): number | undefined;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/services/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/services/embeddings.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAGzC,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;4EAGwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;gBACV,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAMlF;AAeD,wBAAgB,mBAAmB,IAAI,iBAAiB,EAAE,CAIzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;+DAC+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAMtE;AAeD,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,aAU9B,CAAC;AA8CH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7G;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,2BAA2B,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAyD9H;AA2FD;;;;;;;;wDAQwD;AACxD,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6D/H;AAED;;;gCAGgC;AAChC,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAIhF"}

package/dist/services/embeddings.js

@@ -0,0 +1,319 @@
+// Embeddings routing. Unlike chat, embeddings can NOT fail over across models:
+// vectors from different models live in incompatible spaces, and silently
+// switching models would corrupt any vector store built on top of us. So the
+// routing unit is a "family" (one model identity + dimension) and failover only
+// walks the providers serving that same family.
+//
+// `model: "auto"` (or empty) routes to the configured default family — so auto
+// always works: with one provider it just uses that one, with several it gets
+// cross-provider redundancy for free.
+import { getDb, getSetting } from '../db/index.js';
+import { secondsUntilNextMonth } from './key-budget.js';
+import { parseRetryAfterMs } from '../providers/base.js';
+import { RetryHintTracker, retryAfterSeconds } from '../lib/retry-hint.js';
+import { getClientContext } from '../lib/client-context.js';
+import { reserveProviderCredential } from './provider-credential.js';
+import { proxyFetch } from '../lib/proxy.js';
+import { bearerAuthHeader } from '../lib/credential.js';
+import { customEndpointKeyIds } from './custom-endpoint.js';
+import { SPEKA_BASE_URL } from '../providers/speka.js';
+export class EmbeddingsError extends Error {
+    status;
+    code;
+    /** Back-off the upstream provider stated (`Retry-After` header or a
+     *  retry-delay field in the error body), in milliseconds. Kept separate from
+     *  the message so the route can answer the client with a real Retry-After
+     *  instead of a bare 429, the same way the chat router benches keys. */
+    retryAfterMs;
+    constructor(message, status, code, retryAfterMs) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+/** EmbeddingsError for a non-OK upstream response: status, truncated body and
+ *  any stated back-off read off the `Retry-After` header before the body is
+ *  consumed. */
+async function upstreamEmbeddingsError(r) {
+    const retryAfterMs = parseRetryAfterMs(r.headers?.get('retry-after') ?? null);
+    return new EmbeddingsError(`upstream ${r.status}: ${(await r.text()).slice(0, 200)}`, r.status, undefined, retryAfterMs);
+}
+export function listEmbeddingModels() {
+    return getDb().prepare('SELECT * FROM embedding_models ORDER BY family, priority').all();
+}
+export function getDefaultFamily() {
+    return getSetting('embeddings_default_family') ?? 'gemini-embedding-001';
+}
+/** Map the request's `model` to a family: 'auto'/empty → default; a family
+ * name → itself; a provider-specific model id → its family. */
+export function resolveFamily(model) {
+    if (!model || model === 'auto')
+        return getDefaultFamily();
+    const rows = listEmbeddingModels();
+    if (rows.some(r => r.family === model))
+        return model;
+    const byModelId = rows.find(r => r.model_id === model);
+    return byModelId?.family ?? null;
+}
+// Rough token estimate when the provider doesn't report usage (~4 chars/token).
+function estimateTokens(inputs) {
+    return Math.ceil(inputs.reduce((n, s) => n + s.length, 0) / 4);
+}
+const FETCH_TIMEOUT_MS = 30_000;
+/** Provider adapters that can safely receive catalog-managed embedding rows. */
+export const EMBEDDING_PLATFORMS = new Set([
+    'google',
+    'nvidia',
+    'openrouter',
+    'github',
+    'cloudflare',
+    'huggingface',
+    'cohere',
+    'sealion',
+    'speka',
+]);
+async function openAiStyleEmbed(url, platform, key, modelId, inputs, extra = {}, dimensions) {
+    const body = { model: modelId, input: inputs, ...extra };
+    // Some providers (NVIDIA NeMo NIM, Google Gemini Embedding, OpenAI v3) support
+    // Matryoshka Representation Learning (MRL) — a smaller output_dim is valid and
+    // truncates the vector rather than failing. Others (HuggingFace feature-extraction,
+    // Cloudflare BGE) ignore unknown fields silently. We only forward the param when
+    // the caller asked for an explicit override, so providers that don't accept it
+    // see a request body identical to today.
+    if (dimensions !== undefined)
+        body.dimensions = dimensions;
+    const r = await proxyFetch(url, {
+        method: 'POST',
+        // A custom endpoint with auth off holds the `no-key` sentinel: omit the
+        // header instead of sending `Bearer no-key` (#1331).
+        headers: { 'Content-Type': 'application/json', ...bearerAuthHeader(key) },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+    }, platform, 'embedding', FETCH_TIMEOUT_MS);
+    if (!r.ok) {
+        throw await upstreamEmbeddingsError(r);
+    }
+    const j = (await r.json());
+    const data = [...(j.data ?? [])].sort((a, b) => (a.index ?? 0) - (b.index ?? 0));
+    return {
+        vectors: data.map(d => d.embedding),
+        inputTokens: j.usage?.prompt_tokens ?? j.usage?.total_tokens ?? null,
+    };
+}
+export async function probeEmbeddingDimensions(baseUrl, key, modelId) {
+    const out = await openAiStyleEmbed(`${baseUrl.trim().replace(/\/+$/, '')}/embeddings`, 'custom', key, modelId, ['dimension probe']);
+    const vector = out.vectors[0];
+    if (!Array.isArray(vector) || vector.length === 0) {
+        throw new EmbeddingsError('upstream returned malformed embeddings', 502);
+    }
+    return vector.length;
+}
+/**
+ * Upsert one custom embedding model bound to an endpoint credential — the
+ * shared write path behind POST /api/embeddings/custom and the bulk key
+ * importer (#382). Throws EmbeddingsError(400) when the family already exists
+ * at a different dimension: vectors from mismatched spaces must never mix, so
+ * the caller has to pick a new family name instead.
+ */
+export function registerCustomEmbeddingModel(db, reg) {
+    const sibling = db.prepare(`
+    SELECT dimensions
+      FROM embedding_models
+     WHERE family = ?
+       AND NOT (platform = 'custom' AND model_id = ?)
+     LIMIT 1
+  `).get(reg.family, reg.modelId);
+    if (sibling && sibling.dimensions !== reg.dimensions) {
+        throw new EmbeddingsError(`Embedding family '${reg.family}' is ${sibling.dimensions} dimensions, but '${reg.modelId}' returned ${reg.dimensions}. Use a new family name.`, 400);
+    }
+    const endpointKeyIds = customEndpointKeyIds(db, reg.keyId);
+    const existingModel = db.prepare(`
+    SELECT id, priority, key_id
+      FROM embedding_models
+     WHERE platform = 'custom' AND model_id = ?
+     LIMIT 1
+  `).get(reg.modelId);
+    // A model already on this endpoint keeps the key it has; only a move to a
+    // different endpoint re-binds it.
+    const bindKeyId = existingModel?.key_id != null && endpointKeyIds.has(existingModel.key_id)
+        ? existingModel.key_id
+        : reg.keyId;
+    const priority = existingModel?.priority ?? (db.prepare('SELECT COALESCE(MAX(priority), 0) AS maxPriority FROM embedding_models WHERE family = ?')
+        .get(reg.family).maxPriority + 1);
+    // `display_name` is optional: a new model takes its id, and a model already
+    // on record keeps the name it has instead of being reset by a submit that
+    // simply left the field blank (#704).
+    if (existingModel) {
+        db.prepare(`
+      UPDATE embedding_models
+         SET family = ?,
+             display_name = COALESCE(?, display_name),
+             dimensions = ?,
+             max_input_tokens = ?,
+             priority = ?,
+             enabled = 1,
+             quota_label = ?,
+             key_id = ?
+       WHERE id = ?
+    `).run(reg.family, reg.displayName, reg.dimensions, reg.maxInputTokens, priority, reg.quotaLabel, bindKeyId, existingModel.id);
+        return { modelDbId: existingModel.id, created: false };
+    }
+    const model = db.prepare(`
+    INSERT INTO embedding_models
+      (family, platform, model_id, display_name, dimensions, max_input_tokens, priority, enabled, quota_label, key_id)
+    VALUES (?, 'custom', ?, ?, ?, ?, ?, 1, ?, ?)
+  `).run(reg.family, reg.modelId, reg.displayName ?? reg.modelId, reg.dimensions, reg.maxInputTokens, priority, reg.quotaLabel, bindKeyId);
+    return { modelDbId: Number(model.lastInsertRowid), created: true };
+}
+async function callProvider(row, credential, inputs, dimensions) {
+    const { key } = credential;
+    switch (row.platform) {
+        case 'custom':
+            if (!credential.baseUrl)
+                throw new EmbeddingsError('custom embedding provider is missing base_url', 500);
+            return openAiStyleEmbed(`${credential.baseUrl}/embeddings`, row.platform, key, row.model_id, inputs, {}, dimensions);
+        case 'google':
+            return openAiStyleEmbed('https://generativelanguage.googleapis.com/v1beta/openai/embeddings', row.platform, key, row.model_id, inputs, {}, dimensions);
+        case 'nvidia':
+            // NeMo Retriever NIMs require input_type; 'query' is the symmetric-safe
+            // choice for a gateway that can't know whether this is index or query time.
+            // MRL models (e.g. llama-nemotron-embed-1b-v2) accept dimensions and truncate.
+            return openAiStyleEmbed('https://integrate.api.nvidia.com/v1/embeddings', row.platform, key, row.model_id, inputs, { input_type: 'query' }, dimensions);
+        case 'openrouter':
+            return openAiStyleEmbed('https://openrouter.ai/api/v1/embeddings', row.platform, key, row.model_id, inputs, {}, dimensions);
+        case 'github':
+            return openAiStyleEmbed('https://models.github.ai/inference/embeddings', row.platform, key, row.model_id, inputs, {}, dimensions);
+        case 'sealion':
+            return openAiStyleEmbed('https://api.sea-lion.ai/v1/embeddings', row.platform, key, row.model_id, inputs, {}, dimensions);
+        case 'speka':
+            return openAiStyleEmbed(`${SPEKA_BASE_URL}/embeddings`, row.platform, key, row.model_id, inputs, { encoding_format: 'float' }, dimensions);
+        case 'cloudflare': {
+            // Key is stored as "account_id:token".
+            const sep = key.indexOf(':');
+            if (sep === -1)
+                throw new EmbeddingsError('cloudflare key is not in account_id:token form', 500);
+            const accountId = key.slice(0, sep);
+            const token = key.slice(sep + 1);
+            return openAiStyleEmbed(`https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/v1/embeddings`, row.platform, token, row.model_id, inputs, {});
+        }
+        case 'huggingface': {
+            // HF serves embeddings as the feature-extraction task, not /v1/embeddings.
+            const r = await proxyFetch(`https://router.huggingface.co/hf-inference/models/${row.model_id}/pipeline/feature-extraction`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` },
+                body: JSON.stringify({ inputs }),
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            }, row.platform, 'embedding', FETCH_TIMEOUT_MS);
+            if (!r.ok)
+                throw await upstreamEmbeddingsError(r);
+            const j = await r.json();
+            const vectors = Array.isArray(j[0]) ? j : [j];
+            return { vectors, inputTokens: null };
+        }
+        case 'cohere': {
+            const r = await proxyFetch('https://api.cohere.com/v2/embed', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` },
+                body: JSON.stringify({
+                    model: row.model_id,
+                    texts: inputs,
+                    input_type: 'search_document',
+                    embedding_types: ['float'],
+                }),
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            }, row.platform, 'embedding', FETCH_TIMEOUT_MS);
+            if (!r.ok)
+                throw await upstreamEmbeddingsError(r);
+            const j = (await r.json());
+            return { vectors: j.embeddings?.float ?? [], inputTokens: j.meta?.billed_units?.input_tokens ?? null };
+        }
+        default:
+            throw new EmbeddingsError(`no embeddings adapter for platform '${row.platform}'`, 500);
+    }
+}
+function logEmbeddingRequest(row, keyId, status, inputTokens, latencyMs, error) {
+    try {
+        const client = getClientContext();
+        getDb().prepare(`
+      INSERT INTO requests (platform, model_id, key_id, status, input_tokens, output_tokens, latency_ms, error, request_type, client_ip, client_user_agent, client_agent)
+      VALUES (?, ?, ?, ?, ?, 0, ?, ?, 'embedding', ?, ?, ?)
+    `).run(row.platform, row.model_id, keyId, status, inputTokens, latencyMs, error, client.ip, client.userAgent, client.agent);
+    }
+    catch (e) {
+        console.error('Failed to log embedding request:', e);
+    }
+}
+/** Embed `inputs` via the family's provider chain, failing over within the
+ * family on any provider error. Throws EmbeddingsError when the chain is dry.
+ *
+ * `dimensions` (optional): client-supplied output-dimension override forwarded to
+ * providers that support MRL truncation (NVIDIA NeMo NIM, Google Gemini Embedding,
+ * OpenAI text-embedding-3-*). Providers that ignore the field see an identical
+ * request body. The override is independent of the model's native dimension — the
+ * family registry still pins the canonical dimension, this just lets callers ask
+ * for a smaller vector at the cost of some accuracy. */
+export async function runEmbeddings(model, inputs, dimensions) {
+    const family = resolveFamily(model);
+    if (!family) {
+        throw new EmbeddingsError(`Unknown embedding model '${model}'. Use 'auto', a family name, or a provider model id.`, 400);
+    }
+    const chain = getDb().prepare('SELECT * FROM embedding_models WHERE family = ? AND enabled = 1 ORDER BY priority').all(family);
+    if (chain.length === 0) {
+        throw new EmbeddingsError(`No enabled providers for embedding family '${family}'.`, 503);
+    }
+    let lastError = null;
+    // Upstream back-offs across the whole chain: only a chain that was rate
+    // limited end to end earns a Retry-After, and then the soonest one.
+    const hints = new RetryHintTracker();
+    for (const row of chain) {
+        const { credential, budgetBlocked, budgetRetryAfterMs } = reserveProviderCredential(row, estimateTokens(inputs));
+        if (!credential) {
+            if (budgetBlocked) {
+                lastError = new EmbeddingsError('Key budget exhausted', 429, 'quota_exceeded');
+                hints.record(429, budgetRetryAfterMs ?? secondsUntilNextMonth() * 1000);
+            }
+            continue;
+        }
+        const started = Date.now();
+        try {
+            const out = await callProvider(row, credential, inputs, dimensions);
+            if (out.vectors.length !== inputs.length || out.vectors.some(v => !Array.isArray(v) || v.length === 0)) {
+                throw new EmbeddingsError('upstream returned malformed embeddings', 502);
+            }
+            const tokens = out.inputTokens ?? estimateTokens(inputs);
+            logEmbeddingRequest(row, credential.id, 'success', tokens, Date.now() - started, null);
+            return {
+                family,
+                platform: row.platform,
+                modelId: row.model_id,
+                dimensions: out.vectors[0].length,
+                vectors: out.vectors,
+                inputTokens: tokens,
+            };
+        }
+        catch (err) {
+            const e = err instanceof EmbeddingsError ? err : new EmbeddingsError(String(err?.message ?? err), 502);
+            logEmbeddingRequest(row, credential.id, 'error', 0, Date.now() - started, e.message.slice(0, 300));
+            lastError = e;
+            hints.record(e.status, e.retryAfterMs);
+            // fall through to the next provider in the family
+        }
+        finally {
+            credential.release();
+        }
+    }
+    throw new EmbeddingsError(`All providers for embedding family '${family}' failed${lastError ? ` (last: ${lastError.message.slice(0, 160)})` : ' (no usable keys)'}.`, lastError && lastError.status === 429 ? 429 : 502, lastError?.code, lastError && lastError.status === 429 ? hints.retryAfterMs() : undefined);
+}
+/** Whole seconds the client should wait before retrying an embeddings request:
+ *  the soonest upstream back-off when the whole chain was rate limited, else the
+ *  monthly-budget reset for a local quota block. Undefined means the caller
+ *  shouldn't set the header. */
+export function embeddingsRetryAfterSec(err) {
+    if (err.retryAfterMs !== undefined)
+        return retryAfterSeconds(err.retryAfterMs);
+    if (err.code === 'quota_exceeded')
+        return secondsUntilNextMonth();
+    return undefined;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/services/embeddings.js.map

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

package/dist/services/fusion.d.ts

@@ -0,0 +1,162 @@
+import { z } from 'zod';
+import type { ChatMessage, ChatCompletionChoice, ChatCompletionResponse, ChatToolCall, TokenUsage } from '@srouter/shared/types.js';
+import { type FusionCandidate } from './router.js';
+import type { CompletionOptions } from '../providers/base.js';
+export declare const FUSION_MODEL_ID = "fusion";
+export declare function isFusionModel(modelId: string | undefined): boolean;
+export declare const fusionConfigSchema: z.ZodObject<{
+    models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    k: z.ZodOptional<z.ZodNumber>;
+    judge: z.ZodOptional<z.ZodString>;
+    strategy: z.ZodOptional<z.ZodEnum<["synthesize", "best_of"]>>;
+    expose_panel: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    models?: string[] | undefined;
+    k?: number | undefined;
+    judge?: string | undefined;
+    strategy?: "synthesize" | "best_of" | undefined;
+    expose_panel?: boolean | undefined;
+}, {
+    models?: string[] | undefined;
+    k?: number | undefined;
+    judge?: string | undefined;
+    strategy?: "synthesize" | "best_of" | undefined;
+    expose_panel?: boolean | undefined;
+}>;
+export type FusionConfig = z.infer<typeof fusionConfigSchema>;
+export declare function getFusionMaxK(): number;
+export declare const savedFusionConfigSchema: z.ZodObject<{
+    mode: z.ZodEnum<["auto", "explicit"]>;
+    models: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    judge: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    k: z.ZodNumber;
+    strategy: z.ZodEnum<["synthesize", "best_of"]>;
+    expose_panel: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    mode: "auto" | "explicit";
+    models: string[];
+    k: number;
+    judge: string | null;
+    strategy: "synthesize" | "best_of";
+    expose_panel: boolean;
+}, {
+    mode: "auto" | "explicit";
+    k: number;
+    strategy: "synthesize" | "best_of";
+    expose_panel: boolean;
+    models?: string[] | undefined;
+    judge?: string | null | undefined;
+}>;
+export type SavedFusionConfig = z.infer<typeof savedFusionConfigSchema>;
+export declare function getSavedFusionConfig(): SavedFusionConfig;
+export declare function setSavedFusionConfig(input: SavedFusionConfig): SavedFusionConfig;
+export declare function pruneUnavailableSavedFusionConfig(): SavedFusionConfig;
+/**
+ * Merge a request's inline fusion config over the saved dashboard default.
+ * Each field present on the request wins; otherwise the saved default applies.
+ * An explicit panel only comes from the saved config when its mode is
+ * 'explicit' — in 'auto' mode the saved `models` are ignored so the panel is
+ * picked fresh off the Fallback Chain.
+ */
+export declare function resolveEffectiveConfig(req: FusionConfig): FusionConfig;
+interface PanelAnswer {
+    modelDbId: number;
+    platform: string;
+    modelId: string;
+    displayName: string;
+    status: 'ok' | 'failed';
+    content?: string;
+    toolCalls?: ChatToolCall[];
+    rawChoice?: ChatCompletionChoice;
+    error?: string;
+    usage?: TokenUsage;
+}
+/**
+ * Collapse a provider-specific model id to its rough model FAMILY: drop the
+ * provider prefix (everything up to the last '/') and any ':tag'/':free' suffix,
+ * so e.g. `qwen/qwen3-coder:free` and `qwen3-coder:480b` map to one family.
+ * Deliberately a SIMPLE heuristic, not a maintained alias map — cross-provider
+ * id naming drifts constantly, so we only want a good-enough signal to avoid
+ * stacking the panel with the same model served under two providers.
+ */
+export declare function familyKey(modelId: string): string;
+/**
+ * Order a strategy-sorted servable chain for panel diversity along TWO axes:
+ * provider (platform) AND model family. Fusion's value comes from genuinely
+ * DIFFERENT perspectives (issue #326 spike: a panel only beats the best single
+ * model when its members actually disagree); the same model family served by
+ * two providers is platform-distinct but perspective-redundant — one viewpoint
+ * filling two slots.
+ *
+ * Two stable passes, each preserving the routing-strategy order it's handed:
+ *  1. Provider-first (the existing invariant): one model per distinct platform
+ *     before doubling up, so the panel spans different backends / failure
+ *     domains.
+ *  2. Family-dedup: within that provider-diverse order, demote any model whose
+ *     family already appeared — a fresh family takes the slot first, and the
+ *     redundant copy sinks to the refill tail rather than being dropped.
+ * Pure function of its input (unit-tested directly).
+ */
+export declare function diversifyChain(ordered: FusionCandidate[]): FusionCandidate[];
+/**
+ * Build the panel plus a refill queue:
+ *  - `panel`    — the K models to run first (explicit list, or provider-diverse
+ *                 picks off the strategy-sorted chain).
+ *  - `overflow` — the next servable models from the chain, used to refill a slot
+ *                 when a panel model fails outright (auto mode only; an explicit
+ *                 panel is run as-is with no substitution).
+ * Diversity = distinct provider AND model family first (see diversifyChain), so
+ * both the panel and its refills span genuinely different perspectives before
+ * doubling up on either axis.
+ */
+export declare function selectPanel(config: FusionConfig, requirements: {
+    requireTools?: boolean;
+    requireVision?: boolean;
+    estimatedTokens: number;
+}): {
+    panel: FusionCandidate[];
+    overflow: FusionCandidate[];
+    dropped: string[];
+};
+export declare function buildJudgeMessages(original: ChatMessage[], answers: PanelAnswer[], stripImages?: boolean): ChatMessage[];
+export interface FusionResult {
+    response: ChatCompletionResponse & {
+        x_fusion?: unknown;
+    };
+    routedVia: string;
+}
+/**
+ * Orchestrate a fusion request end to end: select the panel, fan out in
+ * parallel, then synthesize survivors with a judge (or best-of). Throws a
+ * FusionError when nothing usable comes back so the route can map it to an
+ * HTTP status.
+ */
+export declare class FusionError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export interface FusionHooks {
+    onPanel?: (a: {
+        platform: string;
+        model: string;
+        status: 'ok' | 'failed';
+        content?: string;
+        tool_calls?: ChatToolCall[];
+        error?: string;
+    }) => void;
+    onJudge?: (j: {
+        platform: string;
+        model: string;
+    }) => void;
+    onJudgeDelta?: (text: string) => void;
+}
+export declare function runFusion(params: {
+    messages: ChatMessage[];
+    config: FusionConfig;
+    options: CompletionOptions;
+    estimatedTokens: number;
+    hooks?: FusionHooks;
+    vision?: boolean;
+}): Promise<FusionResult>;
+export {};
+//# sourceMappingURL=fusion.d.ts.map

package/dist/services/fusion.d.ts.map

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