@srouterhq/server 0.0.0-stage → 0.9.0

package/dist/providers/sail.js

@@ -0,0 +1,302 @@
+import { BaseProvider, providerHttpError, } from './base.js';
+import { contentToString } from '../lib/content.js';
+import { resolveMaxTokens } from '../lib/sampling-params.js';
+import { recordQuotaObservationsFromResponse, } from '../services/provider-quota.js';
+import { providerTimeoutMs } from '../lib/provider-timeout.js';
+const BASE_URL = 'https://api.sailresearch.com/v1';
+const DEFAULT_TIMEOUT_MS = 10 * 60_000;
+const DEFAULT_POLL_INTERVAL_MS = 1_000;
+const POLL_REQUEST_TIMEOUT_MS = 30_000;
+/**
+ * Sail Research adapter.
+ *
+ * Sail's stable surface is the OpenAI Responses API, not streaming Chat
+ * Completions. Every request is submitted with `background: true`, then polled
+ * until terminal. That is required for its flex-only models and avoids proxy
+ * timeouts for core models that spend several minutes queued. The completed
+ * Responses object is normalized back into srouter's Chat Completions shape;
+ * streaming callers receive a small synthesized role/content/finish sequence.
+ */
+export class SailProvider extends BaseProvider {
+    platform = 'sail';
+    name = 'Sail Research';
+    timeoutMs;
+    pollIntervalMs;
+    constructor(options = {}) {
+        super();
+        this.timeoutMs = providerTimeoutMs('sail', options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    }
+    authHeaders(apiKey) {
+        return {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        };
+    }
+    completionWindow() {
+        // See the note above: 'asap' is rejected for background requests, which is
+        // all this adapter sends.
+        return 'flex';
+    }
+    reasoningEffort(modelId, options) {
+        const requested = options?.reasoning_effort;
+        if (!requested)
+            return undefined;
+        // Live API validation: gpt-oss rejects none/minimal and accepts
+        // low/medium/high/xhigh/max. Clamp the two weaker OpenAI spellings to low.
+        if (modelId === 'openai/gpt-oss-120b' && (requested === 'none' || requested === 'minimal')) {
+            return 'low';
+        }
+        return requested;
+    }
+    /** Translate Chat Completions history into Responses input items. */
+    inputItems(messages) {
+        const input = [];
+        for (const message of messages) {
+            const text = contentToString(message.content);
+            if (message.role === 'tool') {
+                input.push({
+                    type: 'function_call_output',
+                    call_id: message.tool_call_id ?? message.name ?? 'unknown_call',
+                    output: text,
+                });
+                continue;
+            }
+            if (text || !message.tool_calls?.length) {
+                input.push({ role: message.role, content: text });
+            }
+            for (const call of message.tool_calls ?? []) {
+                input.push({
+                    type: 'function_call',
+                    call_id: call.id,
+                    name: call.function.name,
+                    arguments: call.function.arguments,
+                });
+            }
+        }
+        return input;
+    }
+    toolChoice(choice) {
+        if (!choice || typeof choice === 'string')
+            return choice;
+        return { type: 'function', name: choice.function.name };
+    }
+    textFormat(options) {
+        const format = options?.response_format;
+        if (!format)
+            return undefined;
+        if (format.type === 'json_schema') {
+            return {
+                type: 'json_schema',
+                name: format.json_schema?.name ?? 'response',
+                schema: format.json_schema?.schema ?? { type: 'object' },
+                strict: format.json_schema?.strict ?? false,
+            };
+        }
+        // Sail rejects Responses `json_object`; preserve the caller's intent with
+        // a permissive JSON schema, the supported equivalent.
+        return {
+            type: 'json_schema',
+            name: 'response',
+            schema: { type: 'object', additionalProperties: true },
+            strict: false,
+        };
+    }
+    buildBody(messages, modelId, options) {
+        const maxOutputTokens = resolveMaxTokens(this.platform, options?.max_tokens, options?.contextBudget);
+        const reasoningEffort = this.reasoningEffort(modelId, options);
+        const textFormat = this.textFormat(options);
+        const tools = options?.tools?.map(tool => ({
+            type: 'function',
+            name: tool.function.name,
+            description: tool.function.description,
+            parameters: tool.function.parameters,
+            strict: tool.function.strict,
+        }));
+        return {
+            model: modelId,
+            input: this.inputItems(messages),
+            background: true,
+            metadata: { completion_window: this.completionWindow() },
+            ...(maxOutputTokens !== undefined ? { max_output_tokens: maxOutputTokens } : {}),
+            ...(options?.temperature !== undefined ? { temperature: options.temperature } : {}),
+            ...(options?.top_p !== undefined ? { top_p: options.top_p } : {}),
+            ...(reasoningEffort ? { reasoning: { effort: reasoningEffort } } : {}),
+            ...(tools?.length ? { tools } : {}),
+            ...(options?.tool_choice !== undefined ? { tool_choice: this.toolChoice(options.tool_choice) } : {}),
+            ...(textFormat ? { text: { format: textFormat } } : {}),
+            // `stop`, `parallel_tool_calls`, seed/penalties/logprobs and multimodal
+            // input are not supported on Sail's stable Responses API.
+        };
+    }
+    errorText(body, status, statusText) {
+        const parsed = body;
+        if (typeof parsed?.error?.message === 'string' && parsed.error.message)
+            return parsed.error.message;
+        if (typeof parsed?.detail === 'string' && parsed.detail)
+            return parsed.detail;
+        if (typeof parsed?.message === 'string' && parsed.message)
+            return parsed.message;
+        return statusText || `HTTP ${status}`;
+    }
+    recordQuota(res, modelId, quotaContext) {
+        recordQuotaObservationsFromResponse(res, {
+            platform: this.platform,
+            keyId: quotaContext?.keyId,
+            providerAccountId: quotaContext?.providerAccountId,
+            modelId,
+            quotaPoolKey: quotaContext?.quotaPoolKey,
+            endpoint: 'responses',
+        });
+    }
+    async parseResponse(res) {
+        const body = await res.json().catch(() => ({}));
+        if (!res.ok) {
+            throw providerHttpError(res, `${this.name} API error ${res.status}: ${this.errorText(body, res.status, res.statusText)}`, body);
+        }
+        return body;
+    }
+    async wait(ms, signal) {
+        if (ms <= 0)
+            return;
+        if (signal?.aborted)
+            throw signal.reason ?? new Error('Sail request aborted');
+        await new Promise((resolve, reject) => {
+            const finish = (error) => {
+                clearTimeout(timer);
+                signal?.removeEventListener('abort', onAbort);
+                if (error !== undefined)
+                    reject(error);
+                else
+                    resolve();
+            };
+            const onAbort = () => {
+                finish(signal?.reason ?? new Error('Sail request aborted'));
+            };
+            const timer = setTimeout(() => finish(), ms);
+            signal?.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+    async runResponse(apiKey, messages, modelId, options, quotaContext) {
+        const timeoutMs = options?.timeoutMs ?? this.timeoutMs;
+        const startedAt = Date.now();
+        const remaining = () => timeoutMs <= 0 ? POLL_REQUEST_TIMEOUT_MS : Math.max(1, timeoutMs - (Date.now() - startedAt));
+        const requestTimeout = () => Math.min(POLL_REQUEST_TIMEOUT_MS, remaining());
+        const submit = await this.fetchWithTimeout(`${BASE_URL}/responses`, {
+            method: 'POST',
+            headers: this.authHeaders(apiKey),
+            body: JSON.stringify(this.buildBody(messages, modelId, options)),
+        }, requestTimeout(), { signal: options?.signal, timeoutBounds: 'request' });
+        this.recordQuota(submit, modelId, quotaContext);
+        let response = await this.parseResponse(submit);
+        if (!response.id)
+            throw new Error(`${this.name} returned no response id`);
+        const responseId = response.id;
+        while (response.status === 'queued' || response.status === 'in_progress') {
+            if (timeoutMs > 0 && Date.now() - startedAt >= timeoutMs) {
+                throw new Error(`${this.name} response ${responseId} did not complete within ${timeoutMs}ms`);
+            }
+            await this.wait(Math.min(this.pollIntervalMs, remaining()), options?.signal);
+            const poll = await this.fetchWithTimeout(`${BASE_URL}/responses/${encodeURIComponent(responseId)}`, {
+                method: 'GET',
+                headers: this.authHeaders(apiKey),
+            }, requestTimeout(), { signal: options?.signal, timeoutBounds: 'request' });
+            this.recordQuota(poll, modelId, quotaContext);
+            response = await this.parseResponse(poll);
+        }
+        if (response.status === 'failed' || response.status === 'cancelled') {
+            const reason = response.error?.message ?? response.status;
+            throw new Error(`${this.name} response ${response.id} ${reason}`);
+        }
+        if (response.status !== 'completed' && response.status !== 'incomplete') {
+            throw new Error(`${this.name} returned unexpected response status: ${response.status ?? 'missing'}`);
+        }
+        return response;
+    }
+    usageOf(usage) {
+        return {
+            prompt_tokens: usage?.input_tokens ?? 0,
+            completion_tokens: usage?.output_tokens ?? 0,
+            total_tokens: usage?.total_tokens ?? (usage?.input_tokens ?? 0) + (usage?.output_tokens ?? 0),
+            prompt_tokens_details: { cached_tokens: usage?.input_tokens_details?.cached_tokens ?? 0 },
+            completion_tokens_details: { reasoning_tokens: usage?.output_tokens_details?.reasoning_tokens ?? 0 },
+        };
+    }
+    normalize(response, modelId) {
+        const text = (response.output ?? [])
+            .filter(item => item.type === 'message')
+            .flatMap(item => item.content ?? [])
+            .filter(content => content.type === 'output_text' && typeof content.text === 'string')
+            .map(content => content.text)
+            .join('');
+        const toolCalls = (response.output ?? [])
+            .filter(item => item.type === 'function_call' && typeof item.name === 'string')
+            .map((item, index) => ({
+            id: item.call_id ?? item.id ?? `call_sail_${index + 1}`,
+            type: 'function',
+            function: {
+                name: item.name,
+                arguments: item.arguments ?? '{}',
+            },
+        }));
+        const incomplete = response.status === 'incomplete';
+        const finishReason = toolCalls.length > 0
+            ? 'tool_calls'
+            : incomplete && response.incomplete_details?.reason === 'max_output_tokens' ? 'length' : 'stop';
+        const out = {
+            id: response.id ?? this.makeId(),
+            object: 'chat.completion',
+            created: response.created_at ?? Math.floor(Date.now() / 1000),
+            model: response.model ?? modelId,
+            choices: [{
+                    index: 0,
+                    message: {
+                        role: 'assistant',
+                        content: text,
+                        ...(toolCalls.length > 0 ? { tool_calls: toolCalls } : {}),
+                    },
+                    finish_reason: finishReason,
+                }],
+            usage: this.usageOf(response.usage),
+        };
+        out._routed_via = { platform: this.platform, model: modelId };
+        return out;
+    }
+    async chatCompletion(apiKey, messages, modelId, options, quotaContext) {
+        return this.normalize(await this.runResponse(apiKey, messages, modelId, options, quotaContext), modelId);
+    }
+    async *streamChatCompletion(apiKey, messages, modelId, options, quotaContext) {
+        const data = await this.chatCompletion(apiKey, messages, modelId, options, quotaContext);
+        const choice = data.choices[0];
+        const content = contentToString(choice.message.content);
+        const toolCalls = choice.message.tool_calls ?? [];
+        const base = {
+            id: data.id,
+            object: 'chat.completion.chunk',
+            created: data.created,
+            model: data.model,
+        };
+        yield { ...base, choices: [{ index: 0, delta: { role: 'assistant' }, finish_reason: null }] };
+        if (content)
+            yield { ...base, choices: [{ index: 0, delta: { content }, finish_reason: null }] };
+        if (toolCalls.length > 0) {
+            yield { ...base, choices: [{ index: 0, delta: { tool_calls: toolCalls }, finish_reason: null }] };
+        }
+        yield { ...base, choices: [{ index: 0, delta: {}, finish_reason: choice.finish_reason }] };
+    }
+    async validateKey(apiKey, quotaContext) {
+        const res = await this.fetchWithTimeout(`${BASE_URL}/models`, {
+            method: 'GET',
+            headers: this.authHeaders(apiKey),
+        }, POLL_REQUEST_TIMEOUT_MS, { timeoutBounds: 'request' });
+        recordQuotaObservationsFromResponse(res, {
+            platform: this.platform,
+            keyId: quotaContext?.keyId,
+            providerAccountId: quotaContext?.providerAccountId,
+            quotaPoolKey: quotaContext?.quotaPoolKey,
+            endpoint: 'models',
+        });
+        return this.validationResult(res);
+    }
+}
+//# sourceMappingURL=sail.js.map

package/dist/providers/sail.js.map

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

package/dist/providers/septor.d.ts

@@ -0,0 +1,10 @@
+import type { ChatCompletionChunk, ChatCompletionResponse, ChatMessage } from '@srouter/shared/types.js';
+import type { CompletionOptions } from './base.js';
+import type { QuotaObservationContext } from '../services/provider-quota.js';
+import { OpenAICompatProvider } from './openai-compat.js';
+export declare class SeptorProvider extends OpenAICompatProvider {
+    constructor();
+    chatCompletion(apiKey: string, messages: ChatMessage[], modelId: string, options?: CompletionOptions, quotaContext?: QuotaObservationContext): Promise<ChatCompletionResponse>;
+    streamChatCompletion(apiKey: string, messages: ChatMessage[], modelId: string, options?: CompletionOptions, quotaContext?: QuotaObservationContext): AsyncGenerator<ChatCompletionChunk>;
+}
+//# sourceMappingURL=septor.d.ts.map

package/dist/providers/septor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"septor.d.ts","sourceRoot":"","sources":["../../src/providers/septor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAY1D,qBAAa,cAAe,SAAQ,oBAAoB;;IAYvC,cAAc,CAC3B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EACxD,OAAO,CAAC,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAClE,OAAO,CAAC,sBAAsB,CAAC;IAMlB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EACxD,OAAO,CAAC,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAClE,cAAc,CAAC,mBAAmB,CAAC;CAQvC"}

package/dist/providers/septor.js

@@ -0,0 +1,36 @@
+import { OpenAICompatProvider } from './openai-compat.js';
+function checkModel(requested, returned) {
+    // Explicit auto routing may choose a model; a named model may not silently
+    // substitute another one. Live Sep 10 probes returned MiniMax M2.5 for
+    // eleven unrelated free IDs. Keep those routes out of the catalog and fail
+    // over if a previously working named route starts doing the same.
+    if (requested !== 'auto' && returned !== requested) {
+        throw Object.assign(new Error('Septor Labs returned a different or missing model identity'), { status: 502 });
+    }
+}
+export class SeptorProvider extends OpenAICompatProvider {
+    constructor() {
+        // /models rejects missing and invalid credentials (401), unlike Router9.
+        // Cloudflare in front challenges tool User-Agents (Node's default "node",
+        // curl) from datacenter IPs with a 403 HTML page, which read as a bad key
+        // on self-hosted VPS installs (#1298). A product UA passes.
+        super({
+            platform: 'septor', name: 'Septor Labs', baseUrl: 'https://api.septorlabs.com/v1',
+            extraHeaders: { 'User-Agent': 'srouter/1.0' },
+        });
+    }
+    async chatCompletion(apiKey, messages, modelId, options, quotaContext) {
+        const response = await super.chatCompletion(apiKey, messages, modelId, options, quotaContext);
+        checkModel(modelId, response.model);
+        return response;
+    }
+    async *streamChatCompletion(apiKey, messages, modelId, options, quotaContext) {
+        for await (const chunk of super.streamChatCompletion(apiKey, messages, modelId, options, quotaContext)) {
+            // Verify before yielding even a role/content/tool preamble. Never label
+            // an upstream substitution as the requested model in the client stream.
+            checkModel(modelId, chunk.model);
+            yield chunk;
+        }
+    }
+}
+//# sourceMappingURL=septor.js.map

package/dist/providers/septor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"septor.js","sourceRoot":"","sources":["../../src/providers/septor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,SAAS,UAAU,CAAC,SAAiB,EAAE,QAAgB;IACrD,2EAA2E;IAC3E,uEAAuE;IACvE,2EAA2E;IAC3E,kEAAkE;IAClE,IAAI,SAAS,KAAK,MAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnD,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAChH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,oBAAoB;IACtD;QACE,yEAAyE;QACzE,0EAA0E;QAC1E,0EAA0E;QAC1E,4DAA4D;QAC5D,KAAK,CAAC;YACJ,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,+BAA+B;YACjF,YAAY,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,cAAc,CAC3B,MAAc,EAAE,QAAuB,EAAE,OAAe,EACxD,OAA2B,EAAE,YAAsC;QAEnE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAC9F,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEQ,KAAK,CAAC,CAAC,oBAAoB,CAClC,MAAc,EAAE,QAAuB,EAAE,OAAe,EACxD,OAA2B,EAAE,YAAsC;QAEnE,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YACvG,wEAAwE;YACxE,wEAAwE;YACxE,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/providers/speechify.d.ts

@@ -0,0 +1,14 @@
+import type { ChatCompletionChunk, ChatCompletionResponse } from '@srouter/shared/types.js';
+import { BaseProvider, type KeyValidationResult } from './base.js';
+export declare const SPEECHIFY_BASE_URL = "https://api.speechify.ai/v1";
+export declare const SPEECHIFY_VERSION = "2026-09-08";
+/** Speechify is TTS-only. Synthesis is dispatched by services/media.ts;
+ * registration here provides credential management, not a fake chat API. */
+export declare class SpeechifyProvider extends BaseProvider {
+    readonly platform: "speechify";
+    readonly name = "Speechify";
+    validateKey(apiKey: string): Promise<KeyValidationResult>;
+    chatCompletion(): Promise<ChatCompletionResponse>;
+    streamChatCompletion(): AsyncGenerator<ChatCompletionChunk>;
+}
+//# sourceMappingURL=speechify.d.ts.map

package/dist/providers/speechify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechify.d.ts","sourceRoot":"","sources":["../../src/providers/speechify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAqB,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEtF,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAChE,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C;4EAC4E;AAC5E,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,QAAQ,CAAC,QAAQ,EAAG,WAAW,CAAU;IACzC,QAAQ,CAAC,IAAI,eAAe;IAEtB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAWzD,cAAc,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAMhD,oBAAoB,IAAI,cAAc,CAAC,mBAAmB,CAAC;CAGnE"}

package/dist/providers/speechify.js

@@ -0,0 +1,28 @@
+import { BaseProvider, providerHttpError } from './base.js';
+export const SPEECHIFY_BASE_URL = 'https://api.speechify.ai/v1';
+export const SPEECHIFY_VERSION = '2026-09-08';
+/** Speechify is TTS-only. Synthesis is dispatched by services/media.ts;
+ * registration here provides credential management, not a fake chat API. */
+export class SpeechifyProvider extends BaseProvider {
+    platform = 'speechify';
+    name = 'Speechify';
+    async validateKey(apiKey) {
+        const response = await this.fetchWithTimeout(`${SPEECHIFY_BASE_URL}/workspaces/current/entitlements`, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${apiKey}`, 'Speechify-Version': SPEECHIFY_VERSION },
+        });
+        if (!response.ok && ![401, 403].includes(response.status)) {
+            throw providerHttpError(response, 'Speechify key validation is temporarily inconclusive');
+        }
+        return this.validationResult(response);
+    }
+    async chatCompletion() {
+        throw Object.assign(new Error('Speechify supports /v1/audio/speech, not chat completions'), { status: 400 });
+    }
+    // An unsupported operation must reject before yielding any stream data.
+    // eslint-disable-next-line require-yield
+    async *streamChatCompletion() {
+        throw Object.assign(new Error('Speechify supports /v1/audio/speech, not chat completions'), { status: 400 });
+    }
+}
+//# sourceMappingURL=speechify.js.map

package/dist/providers/speechify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechify.js","sourceRoot":"","sources":["../../src/providers/speechify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAA4B,MAAM,WAAW,CAAC;AAEtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,6BAA6B,CAAC;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE9C;4EAC4E;AAC5E,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACxC,QAAQ,GAAG,WAAoB,CAAC;IAChC,IAAI,GAAG,WAAW,CAAC;IAE5B,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,kBAAkB,kCAAkC,EAAE;YACpG,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,mBAAmB,EAAE,iBAAiB,EAAE;SACvF,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,MAAM,iBAAiB,CAAC,QAAQ,EAAE,sDAAsD,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2DAA2D,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED,wEAAwE;IACxE,yCAAyC;IACzC,KAAK,CAAC,CAAC,oBAAoB;QACzB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2DAA2D,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/G,CAAC;CACF"}

package/dist/providers/speka.d.ts

@@ -0,0 +1,12 @@
+import { type KeyValidationResult } from './base.js';
+import { OpenAICompatProvider } from './openai-compat.js';
+import { type QuotaObservationContext } from '../services/provider-quota.js';
+export declare const SPEKA_BASE_URL = "https://speka.me/v1";
+/** OpenAI-compatible chat; model rows are delivered only by the signed catalog.
+ * Free's $1/month is shared across chat and embeddings, not a per-model grant.
+ * Docs: https://speka.me/docs and https://speka.me/pricing. */
+export declare class SpekaProvider extends OpenAICompatProvider {
+    constructor();
+    validateKey(apiKey: string, quotaContext?: QuotaObservationContext): Promise<KeyValidationResult>;
+}
+//# sourceMappingURL=speka.d.ts.map

package/dist/providers/speka.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speka.d.ts","sourceRoot":"","sources":["../../src/providers/speka.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAuC,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAElH,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAGpD;;+DAE+D;AAC/D,qBAAa,aAAc,SAAQ,oBAAoB;;IAKtC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoBjH"}

package/dist/providers/speka.js

@@ -0,0 +1,37 @@
+import { providerHttpError } from './base.js';
+import { OpenAICompatProvider } from './openai-compat.js';
+import { providerTimeoutMs } from '../lib/provider-timeout.js';
+import { recordQuotaObservationsFromResponse } from '../services/provider-quota.js';
+export const SPEKA_BASE_URL = 'https://speka.me/v1';
+const VALIDATION_MODEL = '__srouter_key_validation__';
+/** OpenAI-compatible chat; model rows are delivered only by the signed catalog.
+ * Free's $1/month is shared across chat and embeddings, not a per-model grant.
+ * Docs: https://speka.me/docs and https://speka.me/pricing. */
+export class SpekaProvider extends OpenAICompatProvider {
+    constructor() {
+        super({ platform: 'speka', name: 'Speka', baseUrl: SPEKA_BASE_URL });
+    }
+    async validateKey(apiKey, quotaContext) {
+        // /models is public, so a 200 there does not validate a key. Speka checks
+        // authentication before resolving a model: this deliberately nonexistent
+        // model returns 400/model_not_found only after auth, without generating
+        // tokens. Verified against both a valid key and an invalid-key control.
+        const res = await this.fetchWithTimeout(`${SPEKA_BASE_URL}/chat/completions`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ model: VALIDATION_MODEL, messages: [{ role: 'user', content: 'key validation' }], max_tokens: 1, stream: false }),
+        }, providerTimeoutMs('speka', 30_000), { timeoutBounds: 'request' });
+        recordQuotaObservationsFromResponse(res, { ...quotaContext, platform: 'speka', endpoint: 'key-validation' });
+        if ([401, 403].includes(res.status))
+            return this.validationResult(res);
+        if (res.status === 400) {
+            const body = await res.clone().json().catch(() => null);
+            if (body?.error?.type === 'model_not_found')
+                return true;
+        }
+        // Rate limits, exhausted allowances, malformed responses and outages are
+        // inconclusive, not proof that a key is valid or invalid.
+        throw providerHttpError(res, 'Speka key validation is temporarily inconclusive');
+    }
+}
+//# sourceMappingURL=speka.js.map

package/dist/providers/speka.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speka.js","sourceRoot":"","sources":["../../src/providers/speka.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA4B,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mCAAmC,EAAgC,MAAM,+BAA+B,CAAC;AAElH,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC;AACpD,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAEtD;;+DAE+D;AAC/D,MAAM,OAAO,aAAc,SAAQ,oBAAoB;IACrD;QACE,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IACvE,CAAC;IAEQ,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,YAAsC;QAC/E,0EAA0E;QAC1E,yEAAyE;QACzE,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,cAAc,mBAAmB,EAAE;YAC5E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAClF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;SACzI,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,mCAAmC,CAAC,GAAG,EAAE,EAAE,GAAG,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC7G,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACvE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAyC,CAAC;YAChG,IAAI,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,iBAAiB;gBAAE,OAAO,IAAI,CAAC;QAC3D,CAAC;QACD,yEAAyE;QACzE,0DAA0D;QAC1D,MAAM,iBAAiB,CAAC,GAAG,EAAE,kDAAkD,CAAC,CAAC;IACnF,CAAC;CACF"}

package/dist/providers/waterfall.d.ts

@@ -0,0 +1,11 @@
+import type { ChatCompletionChunk, ChatCompletionResponse, ChatMessage } from '@srouter/shared/types.js';
+import { type CompletionOptions, type KeyValidationResult } from './base.js';
+import type { QuotaObservationContext } from '../services/provider-quota.js';
+import { OpenAICompatProvider } from './openai-compat.js';
+export declare class WaterfallProvider extends OpenAICompatProvider {
+    protected validationResult(response: Response): Promise<KeyValidationResult>;
+    constructor();
+    chatCompletion(apiKey: string, messages: ChatMessage[], modelId: string, options?: CompletionOptions, quotaContext?: QuotaObservationContext): Promise<ChatCompletionResponse>;
+    streamChatCompletion(apiKey: string, messages: ChatMessage[], modelId: string, options?: CompletionOptions, quotaContext?: QuotaObservationContext): AsyncGenerator<ChatCompletionChunk>;
+}
+//# sourceMappingURL=waterfall.d.ts.map

package/dist/providers/waterfall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waterfall.d.ts","sourceRoot":"","sources":["../../src/providers/waterfall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAqB,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAQ1D,qBAAa,iBAAkB,SAAQ,oBAAoB;cAChC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC;;IAc5E,cAAc,CAC3B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EACxD,OAAO,CAAC,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAClE,OAAO,CAAC,sBAAsB,CAAC;IAMlB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EACxD,OAAO,CAAC,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAClE,cAAc,CAAC,mBAAmB,CAAC;CAMvC"}

package/dist/providers/waterfall.js

@@ -0,0 +1,33 @@
+import { providerHttpError } from './base.js';
+import { OpenAICompatProvider } from './openai-compat.js';
+function checkModel(requested, returned) {
+    if (!returned || returned !== requested) {
+        throw Object.assign(new Error('Waterfall returned a different or missing model identity'), { status: 502 });
+    }
+}
+export class WaterfallProvider extends OpenAICompatProvider {
+    async validationResult(response) {
+        if (!response.ok && ![401, 403].includes(response.status)) {
+            throw providerHttpError(response, 'Waterfall key validation is temporarily inconclusive');
+        }
+        return super.validationResult(response);
+    }
+    constructor() {
+        // Upstream outages arrive as 503 with a structured `detail` object
+        // ({"type":"waterfall_transport_error","code":"upstream_unavailable"});
+        // the shared error path keeps the status and falls back to statusText.
+        super({ platform: 'waterfall', name: 'Waterfall', baseUrl: 'https://api.getwaterfall.org/v1' });
+    }
+    async chatCompletion(apiKey, messages, modelId, options, quotaContext) {
+        const response = await super.chatCompletion(apiKey, messages, modelId, options, quotaContext);
+        checkModel(modelId, response.model);
+        return response;
+    }
+    async *streamChatCompletion(apiKey, messages, modelId, options, quotaContext) {
+        for await (const chunk of super.streamChatCompletion(apiKey, messages, modelId, options, quotaContext)) {
+            checkModel(modelId, chunk.model);
+            yield chunk;
+        }
+    }
+}
+//# sourceMappingURL=waterfall.js.map

package/dist/providers/waterfall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waterfall.js","sourceRoot":"","sources":["../../src/providers/waterfall.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAoD,MAAM,WAAW,CAAC;AAEhG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,SAAS,UAAU,CAAC,SAAiB,EAAE,QAAgB;IACrD,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0DAA0D,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC;AAED,MAAM,OAAO,iBAAkB,SAAQ,oBAAoB;IACtC,KAAK,CAAC,gBAAgB,CAAC,QAAkB;QAC1D,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,MAAM,iBAAiB,CAAC,QAAQ,EAAE,sDAAsD,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;QACE,mEAAmE;QACnE,wEAAwE;QACxE,uEAAuE;QACvE,KAAK,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;IAClG,CAAC;IAEQ,KAAK,CAAC,cAAc,CAC3B,MAAc,EAAE,QAAuB,EAAE,OAAe,EACxD,OAA2B,EAAE,YAAsC;QAEnE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAC9F,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEQ,KAAK,CAAC,CAAC,oBAAoB,CAClC,MAAc,EAAE,QAAuB,EAAE,OAAe,EACxD,OAA2B,EAAE,YAAsC;QAEnE,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YACvG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/providers/xkiro.d.ts

@@ -0,0 +1,71 @@
+import { OpenAICompatProvider } from './openai-compat.js';
+/**
+ * xKiro (xkiro.com) — OpenAI-compatible aggregator at api.xkiro.com/v1.
+ *
+ * Free key from xkiro.com (no card); the free plan is a 5M tokens/day budget
+ * shared across its free models. `GET /v1/models` is public (200 with no key),
+ * so `validateUrl` points at `/v1/usage`, which 401s on a missing or invalid
+ * ClientApiKey. Accepts `Authorization: Bearer` or `x-api-key`.
+ *
+ * ── Why this class exists ───────────────────────────────────────────────────
+ * xKiro's own metadata cannot be taken at face value, in two independent ways.
+ * Both were established by live probing (2026-09-26) and both matter because
+ * the generic discovery path gets each one wrong.
+ *
+ * 1. **The `:free` id suffix under-reports the free roster.** `/v1/models`
+ *    marks every row with an explicit `access_tier` (`'free' | 'paid' |
+ *    'premium'`). 58 rows are `free`, but only 28 of those carry the suffix.
+ *    A suffix-based filter therefore throws away 30 genuinely free models —
+ *    every Cohere `command-*` row, both Sensenova rows, and most Mistral ones —
+ *    while adding nothing, because no `:free` row is ever `paid`/`premium`.
+ *    So the tier field is authoritative here and the suffix is ignored.
+ *
+ * 2. **`access_tier: 'free'` is not a promise of free ACCESS.** All five
+ *    `deepseek/*` rows are labelled `access_tier: 'free'` with zero pricing,
+ *    and every one of them answers a free-plan key with
+ *    `403 "This model is available to paying customers only. Subscribe to a
+ *    plan or top up your wallet to use it."` — deterministically, on every key
+ *    (verified across 5 distinct requests). `min_plan_usd`/`min_plan_names`,
+ *    the fields that might have declared this, are `undefined` on exactly those
+ *    rows. No metadata field separates them, so the only trustworthy signal is
+ *    a live probe; see `probeFreeAccess`.
+ *
+ * Catalog rows otherwise live in the hosted catalog, but that snapshot is
+ * ~30 days old on a free install and listed only the 8 Mistral rows, so the
+ * roster is refreshed by discovery instead (services/auto-discover.ts).
+ */
+export declare class XKiroProvider extends OpenAICompatProvider {
+    /** Marks the platform whose `/v1/models` carries an authoritative per-row
+     *  `access_tier`. Read by the discovery filter in services/auto-discover.ts. */
+    readonly hasAccessTier = true;
+    constructor();
+}
+/** Outcome of probing one model with a free-plan key. */
+export type FreeAccessVerdict = 
+/** Answered — usable on the free plan. */
+'ok'
+/** Refused because the model needs a PAID plan. Safe to exclude. */
+ | 'paid'
+/** Retired/gone upstream. Safe to exclude. */
+ | 'gone'
+/** Could not tell (quota, outage, timeout). Keep — absence of evidence. */
+ | 'unknown'
+/** The KEY is rejected. Says nothing about the model; stop probing. */
+ | 'unauthorized';
+/**
+ * Ask xKiro whether one model is actually reachable on a free plan.
+ *
+ * A 1-token completion is the cheapest request that proves access: the free
+ * plan's budget is measured in tokens, so a single token costs nothing
+ * meaningful, and the verdict is about the plan rather than the output. The
+ * prompt is deliberately tiny so it cannot be mistaken for real traffic.
+ *
+ * Never throws — a transport failure is `'unknown'`, which keeps the model.
+ * Only positive evidence of a gate excludes anything.
+ */
+export declare function probeFreeAccess(apiKey: string, modelId: string, options?: {
+    baseUrl?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<FreeAccessVerdict>;
+//# sourceMappingURL=xkiro.d.ts.map

package/dist/providers/xkiro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xkiro.d.ts","sourceRoot":"","sources":["../../src/providers/xkiro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,aAAc,SAAQ,oBAAoB;IACrD;oFACgF;IAChF,QAAQ,CAAC,aAAa,QAAQ;;CAU/B;AAED,yDAAyD;AACzD,MAAM,MAAM,iBAAiB;AAC3B,0CAA0C;AACxC,IAAI;AACN,oEAAoE;GAClE,MAAM;AACR,8CAA8C;GAC5C,MAAM;AACR,2EAA2E;GACzE,SAAS;AACX,uEAAuE;GACrE,cAAc,CAAC;AAWnB;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAC3E,OAAO,CAAC,iBAAiB,CAAC,CAkD5B"}