@srouterhq/server 0.0.0-stage → 0.9.0

package/dist/providers/opencode-free.js

@@ -0,0 +1,262 @@
+import { BaseProvider, providerHttpError, } from './base.js';
+import { resolveMaxTokens } from '../lib/sampling-params.js';
+import { providerTimeoutMs } from '../lib/provider-timeout.js';
+import { recordQuotaObservationsFromResponse } from '../services/provider-quota.js';
+import { extractThinkFromMessage } from '../lib/think-tags.js';
+// -- OpenCode Free Tier Identity --------------------------------------------
+//
+// Since 2026-09, OpenCode's zen free tier (Bearer public) rejects requests
+// that don't look like the official OpenCode CLI. The gate checks:
+//
+//   1. User-Agent: opencode/<major.minor[.patch]> with version >= 1.17
+//   2. stream: true  (stream:false => 403 FreeTierError)
+//   3. tools must include the fingerprint quartet: bash, glob, grep, read
+//   4. Authorization: Bearer public
+//
+// Additional headers improve fidelity: x-opencode-client, x-opencode-session,
+// x-opencode-request, x-opencode-project. This adapter spoofs all of them.
+const UPSTREAM_BASE = 'https://opencode.ai/zen/v1';
+const USER_AGENT = 'opencode/1.18.31 ai-sdk/provider-utils/4.0.23 runtime/bun/1.3.14';
+// -- Session / Request ID generation ----------------------------------------
+const BASE62 = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+function cryptoHex(n) {
+    const b = new Uint8Array(n);
+    globalThis.crypto.getRandomValues(b);
+    return Array.from(b, (x) => x.toString(16).padStart(2, '0')).join('');
+}
+function cryptoBase62(n) {
+    const b = new Uint8Array(n);
+    globalThis.crypto.getRandomValues(b);
+    return Array.from(b, (x) => BASE62[x % 62]).join('');
+}
+function genSessionId() {
+    return `ses_${cryptoHex(6)}${cryptoBase62(14)}`;
+}
+function genRequestId() {
+    return `msg_${cryptoHex(6)}${cryptoBase62(14)}`;
+}
+// -- Fingerprint tools ------------------------------------------------------
+// The free-tier gate demands these four tools in body.tools.
+const FINGERPRINT_QUARTET = [
+    { name: 'bash', description: 'OpenCode built-in bash tool' },
+    { name: 'glob', description: 'OpenCode built-in glob tool' },
+    { name: 'grep', description: 'OpenCode built-in grep tool' },
+    { name: 'read', description: 'OpenCode built-in read tool' },
+];
+function fpTool(name, description) {
+    return {
+        type: 'function',
+        function: {
+            name,
+            description,
+            parameters: { type: 'object', properties: {} },
+        },
+    };
+}
+function ensureFingerprintTools(body) {
+    const present = new Set();
+    let callerCount = 0;
+    if (Array.isArray(body.tools)) {
+        callerCount = body.tools.length;
+        for (const t of body.tools) {
+            const n = t?.function?.name ?? t?.name;
+            if (typeof n === 'string')
+                present.add(n.trim().toLowerCase());
+        }
+    }
+    else {
+        body.tools = [];
+    }
+    for (const fp of FINGERPRINT_QUARTET) {
+        if (!present.has(fp.name)) {
+            body.tools.push(fpTool(fp.name, fp.description));
+            present.add(fp.name);
+        }
+    }
+    if (callerCount === 0 && !body.tool_choice) {
+        body.tool_choice = 'none';
+    }
+}
+// -- Provider ---------------------------------------------------------------
+const CHAT_TIMEOUT_MS = providerTimeoutMs('opencode-free', 60_000);
+/**
+ * OpenCode Free � keyless provider that spoofs the official OpenCode CLI
+ * identity to access the zen free tier without a real API key.
+ *
+ * The upstream ALWAYS requires stream: true; stream: false or omitted
+ * results in 403 FreeTierError.  Non-streaming callers get a synthetic
+ * single-chunk response assembled from the SSE stream.
+ */
+export class OpenCodeFreeProvider extends BaseProvider {
+    platform = 'opencode-free';
+    name = 'OpenCode Free';
+    keyless = true;
+    // -- Auth headers ------------------------------------------------------
+    identityHeaders() {
+        return {
+            'Authorization': 'Bearer public',
+            'User-Agent': USER_AGENT,
+            'x-opencode-client': 'desktop',
+            'x-opencode-session': genSessionId(),
+            'x-opencode-request': genRequestId(),
+            'x-opencode-project': 'global',
+            'Accept': 'text/event-stream',
+        };
+    }
+    // -- Key validation ----------------------------------------------------
+    // Always succeeds (keyless). A lightweight models-list call validates
+    // network connectivity to the upstream.
+    async validateKey(_apiKey, _quotaContext) {
+        try {
+            const res = await this.fetchWithTimeout(`${UPSTREAM_BASE}/models`, { method: 'GET', headers: this.identityHeaders() }, 10_000, { timeoutBounds: 'request' });
+            if (res.ok || res.status === 404)
+                return true;
+            return { valid: false, error: `OpenCode Free models probe returned HTTP ${res.status}` };
+        }
+        catch (e) {
+            return { valid: false, error: `OpenCode Free network error: ${e?.message ?? e}` };
+        }
+    }
+    // -- Build the upstream body -------------------------------------------
+    buildBody(messages, modelId, options) {
+        const body = {
+            model: modelId,
+            messages,
+            temperature: options?.temperature ?? 0.7,
+            stream: true, // mandatory � upstream 403s without it
+            store: false,
+        };
+        if (options?.top_p !== undefined)
+            body.top_p = options.top_p;
+        if (options?.tools)
+            body.tools = options.tools;
+        if (options?.tool_choice)
+            body.tool_choice = options.tool_choice;
+        if (options?.parallel_tool_calls !== undefined) {
+            body.parallel_tool_calls = options.parallel_tool_calls;
+        }
+        const resolved = resolveMaxTokens(this.platform, options?.max_tokens, options?.contextBudget);
+        if (resolved !== null)
+            body.max_tokens = resolved;
+        ensureFingerprintTools(body);
+        return body;
+    }
+    // -- Shared fetch ------------------------------------------------------
+    async fetchChat(body, options) {
+        const timeout = options?.timeoutMs ?? CHAT_TIMEOUT_MS;
+        const res = await this.fetchWithTimeout(`${UPSTREAM_BASE}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                ...this.identityHeaders(),
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        }, timeout, { signal: options?.signal, timeoutBounds: 'headers' });
+        if (!res.ok) {
+            const errBody = await res.text().catch(() => '');
+            throw providerHttpError(res, `OpenCode Free HTTP ${res.status}: ${errBody.slice(0, 300)}`, errBody);
+        }
+        return res;
+    }
+    // -- Non-streaming completion ------------------------------------------
+    // Reads the SSE stream, assembles a single response.
+    async chatCompletion(_apiKey, messages, modelId, options, quotaContext) {
+        const body = this.buildBody(messages, modelId, options);
+        const res = await this.fetchChat(body, options);
+        recordQuotaObservationsFromResponse(res, {
+            platform: this.platform,
+            keyId: quotaContext?.keyId,
+            providerAccountId: quotaContext?.providerAccountId,
+            modelId,
+            quotaPoolKey: quotaContext?.quotaPoolKey,
+            endpoint: 'chat/completions',
+        });
+        const chunks = [];
+        for await (const chunk of this.readSseStream(res)) {
+            chunks.push(chunk);
+        }
+        return this.assembleResponse(modelId, chunks);
+    }
+    // -- Streaming completion ----------------------------------------------
+    async *streamChatCompletion(_apiKey, messages, modelId, options, quotaContext) {
+        const body = this.buildBody(messages, modelId, options);
+        const res = await this.fetchChat(body, options);
+        recordQuotaObservationsFromResponse(res, {
+            platform: this.platform,
+            keyId: quotaContext?.keyId,
+            providerAccountId: quotaContext?.providerAccountId,
+            modelId,
+            quotaPoolKey: quotaContext?.quotaPoolKey,
+            endpoint: 'chat/completions',
+        });
+        yield* this.readSseStream(res);
+    }
+    // -- Stream -> single response assembler -------------------------------
+    assembleResponse(modelId, chunks) {
+        let content = '';
+        let finishReason = null;
+        let reasoningContent = null;
+        let model = modelId;
+        const toolCalls = new Map();
+        const usage = { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
+        for (const chunk of chunks) {
+            if (chunk.model)
+                model = chunk.model;
+            if (chunk.usage) {
+                usage.prompt_tokens += chunk.usage.prompt_tokens ?? 0;
+                usage.completion_tokens += chunk.usage.completion_tokens ?? 0;
+                usage.total_tokens += chunk.usage.total_tokens ?? 0;
+            }
+            for (const choice of chunk.choices ?? []) {
+                if (choice.finish_reason)
+                    finishReason = choice.finish_reason;
+                const delta = choice.delta;
+                if (!delta)
+                    continue;
+                if (delta.content)
+                    content += delta.content;
+                if (delta.reasoning_content) {
+                    reasoningContent = delta.reasoning_content;
+                }
+                if (delta.tool_calls) {
+                    for (const tc of delta.tool_calls) {
+                        const idx = tc.index ?? toolCalls.size;
+                        if (!toolCalls.has(idx)) {
+                            toolCalls.set(idx, {
+                                id: tc.id ?? `call_${idx}`,
+                                type: 'function',
+                                function: { name: tc.function?.name ?? '', arguments: '' },
+                            });
+                        }
+                        const existing = toolCalls.get(idx);
+                        if (tc.id)
+                            existing.id = tc.id;
+                        if (tc.function?.name)
+                            existing.function.name += tc.function.name;
+                        if (tc.function?.arguments)
+                            existing.function.arguments += tc.function.arguments;
+                    }
+                }
+            }
+        }
+        const message = {
+            role: 'assistant',
+            content: content || null,
+            ...(reasoningContent ? { reasoning_content: reasoningContent } : {}),
+            ...(toolCalls.size > 0
+                ? { tool_calls: Array.from(toolCalls.values()) }
+                : {}),
+        };
+        extractThinkFromMessage(message);
+        return {
+            id: `free-${Date.now()}-${cryptoHex(4)}`,
+            object: 'chat.completion',
+            created: Math.floor(Date.now() / 1000),
+            model,
+            choices: [{ index: 0, message, finish_reason: finishReason }],
+            usage,
+            _routed_via: { platform: 'opencode-free', model: modelId },
+        };
+    }
+}
+//# sourceMappingURL=opencode-free.js.map

package/dist/providers/opencode-free.js.map

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

package/dist/providers/pollinations.d.ts

@@ -0,0 +1,32 @@
+import { OpenAICompatProvider } from './openai-compat.js';
+import type { KeyValidationResult } from './base.js';
+import { type QuotaObservationContext } from '../services/provider-quota.js';
+/**
+ * Pollinations — OpenAI-compatible shared-capacity tier.
+ *
+ * Everything except key validation is stock OpenAI-compat. validateKey is
+ * overridden because Pollinations serves its catalog without auth:
+ *
+ *   GET /v1/models answers 200 for a revoked key (and for no key at all —
+ *   verified live 2026-07-28), while POST /v1/chat/completions answers 401.
+ *   The default openai-compat probe therefore reported dead keys as healthy
+ *   and routing degraded silently. See issue #608.
+ *
+ * The probe is GET /account/key instead, which enforces auth (401 for a
+ * garbage bearer, verified the same day) and costs no generation quota.
+ * Response classification, all of it deliberate:
+ *   200 → authenticated, key is live.
+ *   401 → revoked/invalid; surfaces the upstream reason and feeds the
+ *         consecutive-failure auto-disable, same as every other provider.
+ *   402 → authenticated but out of pollen. The credential is fine; benching
+ *         it belongs to the router's quota path, not to key validation.
+ *   403 → Pollinations uses 403 for insufficient PERMISSIONS, so a restricted
+ *         (but live) key can be refused this endpoint. Inconclusive: throw so
+ *         health.ts keeps the previous verdict instead of disabling a good key.
+ *   other non-2xx (endpoint moved, provider 5xx) → inconclusive, same as above.
+ */
+export declare class PollinationsProvider extends OpenAICompatProvider {
+    constructor();
+    validateKey(apiKey: string, quotaContext?: QuotaObservationContext): Promise<KeyValidationResult>;
+}
+//# sourceMappingURL=pollinations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pollinations.d.ts","sourceRoot":"","sources":["../../src/providers/pollinations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAuC,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAMlH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,oBAAqB,SAAQ,oBAAoB;;IAS7C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA6BjH"}

package/dist/providers/pollinations.js

@@ -0,0 +1,65 @@
+import { OpenAICompatProvider } from './openai-compat.js';
+import { recordQuotaObservationsFromResponse } from '../services/provider-quota.js';
+const POLLINATIONS_BASE_URL = 'https://gen.pollinations.ai/v1';
+/** Authenticated key-introspection endpoint — note it sits OUTSIDE /v1. */
+const POLLINATIONS_ACCOUNT_KEY_URL = 'https://gen.pollinations.ai/account/key';
+/**
+ * Pollinations — OpenAI-compatible shared-capacity tier.
+ *
+ * Everything except key validation is stock OpenAI-compat. validateKey is
+ * overridden because Pollinations serves its catalog without auth:
+ *
+ *   GET /v1/models answers 200 for a revoked key (and for no key at all —
+ *   verified live 2026-07-28), while POST /v1/chat/completions answers 401.
+ *   The default openai-compat probe therefore reported dead keys as healthy
+ *   and routing degraded silently. See issue #608.
+ *
+ * The probe is GET /account/key instead, which enforces auth (401 for a
+ * garbage bearer, verified the same day) and costs no generation quota.
+ * Response classification, all of it deliberate:
+ *   200 → authenticated, key is live.
+ *   401 → revoked/invalid; surfaces the upstream reason and feeds the
+ *         consecutive-failure auto-disable, same as every other provider.
+ *   402 → authenticated but out of pollen. The credential is fine; benching
+ *         it belongs to the router's quota path, not to key validation.
+ *   403 → Pollinations uses 403 for insufficient PERMISSIONS, so a restricted
+ *         (but live) key can be refused this endpoint. Inconclusive: throw so
+ *         health.ts keeps the previous verdict instead of disabling a good key.
+ *   other non-2xx (endpoint moved, provider 5xx) → inconclusive, same as above.
+ */
+export class PollinationsProvider extends OpenAICompatProvider {
+    constructor() {
+        super({
+            platform: 'pollinations',
+            name: 'Pollinations',
+            baseUrl: POLLINATIONS_BASE_URL,
+        });
+    }
+    async validateKey(apiKey, quotaContext) {
+        // Transport errors (DNS / timeout / TLS) propagate — health.ts marks
+        // status='error' without counting toward auto-disable; only a confirmed
+        // 401 disables a key.
+        const res = await this.fetchWithTimeout(POLLINATIONS_ACCOUNT_KEY_URL, {
+            method: 'GET',
+            headers: { 'Authorization': `Bearer ${apiKey}` },
+        }, 30000, { timeoutBounds: 'request' });
+        recordQuotaObservationsFromResponse(res, {
+            platform: this.platform,
+            keyId: quotaContext?.keyId,
+            providerAccountId: quotaContext?.providerAccountId,
+            quotaPoolKey: quotaContext?.quotaPoolKey,
+            endpoint: 'account/key',
+        });
+        if (res.status === 401)
+            return this.validationResult(res);
+        if (res.ok || res.status === 402)
+            return true;
+        if (res.status === 403) {
+            throw new Error(`Pollinations key validation inconclusive: HTTP 403 from /account/key. ` +
+                `The key authenticated but lacks permission for the introspection endpoint, ` +
+                `so it is NOT treated as revoked.`);
+        }
+        throw new Error(`Pollinations /account/key returned HTTP ${res.status} — key validity unknown`);
+    }
+}
+//# sourceMappingURL=pollinations.js.map

package/dist/providers/pollinations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pollinations.js","sourceRoot":"","sources":["../../src/providers/pollinations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,mCAAmC,EAAgC,MAAM,+BAA+B,CAAC;AAElH,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAC/D,2EAA2E;AAC3E,MAAM,4BAA4B,GAAG,yCAAyC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,oBAAoB;IAC5D;QACE,KAAK,CAAC;YACJ,QAAQ,EAAE,cAAc;YACxB,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,qBAAqB;SAC/B,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,YAAsC;QAC/E,qEAAqE;QACrE,wEAAwE;QACxE,sBAAsB;QACtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,4BAA4B,EAAE;YACpE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,MAAM,EAAE,EAAE;SACjD,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QAExC,mCAAmC,CAAC,GAAG,EAAE;YACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,YAAY,EAAE,KAAK;YAC1B,iBAAiB,EAAE,YAAY,EAAE,iBAAiB;YAClD,YAAY,EAAE,YAAY,EAAE,YAAY;YACxC,QAAQ,EAAE,aAAa;SACxB,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAE9C,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACxE,6EAA6E;gBAC7E,kCAAkC,CACnC,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,CAAC,MAAM,yBAAyB,CAAC,CAAC;IAClG,CAAC;CACF"}

package/dist/providers/router9.d.ts

@@ -0,0 +1,16 @@
+import type { KeyValidationResult } from './base.js';
+import { OpenAICompatProvider } from './openai-compat.js';
+import { type QuotaObservationContext } from '../services/provider-quota.js';
+/** Router9's public /models returns 200 even for a bogus key. Authenticate
+ * with a deliberately incomplete chat request instead: no model or prompt
+ * can reach inference. Verified 2026-09-10: invalid keys get 401; a valid key
+ * gets 404 model_not_found PLUS account credit headers. This consumes one
+ * request from the provider's burst allowance, but no inference credits.
+ *
+ * The inherited adapter already splits inline <think> blocks and accepts
+ * streams ending at EOF after finish_reason (Router9 omits [DONE]). */
+export declare class Router9Provider extends OpenAICompatProvider {
+    constructor();
+    validateKey(apiKey: string, quotaContext?: QuotaObservationContext): Promise<KeyValidationResult>;
+}
+//# sourceMappingURL=router9.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router9.d.ts","sourceRoot":"","sources":["../../src/providers/router9.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAuC,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAIlH;;;;;;;uEAOuE;AACvE,qBAAa,eAAgB,SAAQ,oBAAoB;;IAKxC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA0BjH"}

package/dist/providers/router9.js

@@ -0,0 +1,42 @@
+import { OpenAICompatProvider } from './openai-compat.js';
+import { recordQuotaObservationsFromResponse } from '../services/provider-quota.js';
+const BASE_URL = 'https://api.router9.com/v1';
+/** Router9's public /models returns 200 even for a bogus key. Authenticate
+ * with a deliberately incomplete chat request instead: no model or prompt
+ * can reach inference. Verified 2026-09-10: invalid keys get 401; a valid key
+ * gets 404 model_not_found PLUS account credit headers. This consumes one
+ * request from the provider's burst allowance, but no inference credits.
+ *
+ * The inherited adapter already splits inline <think> blocks and accepts
+ * streams ending at EOF after finish_reason (Router9 omits [DONE]). */
+export class Router9Provider extends OpenAICompatProvider {
+    constructor() {
+        super({ platform: 'router9', name: 'Router9', baseUrl: BASE_URL });
+    }
+    async validateKey(apiKey, quotaContext) {
+        const res = await this.fetchWithTimeout(`${BASE_URL}/chat/completions`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ messages: [] }),
+        }, 30_000, { timeoutBounds: 'request' });
+        recordQuotaObservationsFromResponse(res, {
+            platform: this.platform, keyId: quotaContext?.keyId,
+            providerAccountId: quotaContext?.providerAccountId, quotaPoolKey: quotaContext?.quotaPoolKey,
+            endpoint: 'chat/completions:auth-probe',
+        });
+        if (res.status === 401)
+            return this.validationResult(res);
+        const body = await res.json().catch(() => null);
+        const accountHeaders = ['x-credits-limit', 'x-credits-remaining'].every(name => {
+            const value = res.headers.get(name);
+            return value !== null && value.trim() !== '' && Number.isFinite(Number(value));
+        });
+        // A generic 404/429 from a proxy or public route is not authentication.
+        // Account headers are required; quota exhaustion does not revoke a key.
+        if (accountHeaders && ((res.status === 404 && body?.error?.code === 'model_not_found') ||
+            res.status === 402 || res.status === 429))
+            return true;
+        throw new Error(`Router9 key validation inconclusive (HTTP ${res.status}); no authenticated probe verdict`);
+    }
+}
+//# sourceMappingURL=router9.js.map

package/dist/providers/router9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router9.js","sourceRoot":"","sources":["../../src/providers/router9.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mCAAmC,EAAgC,MAAM,+BAA+B,CAAC;AAElH,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAE9C;;;;;;;uEAOuE;AACvE,MAAM,OAAO,eAAgB,SAAQ,oBAAoB;IACvD;QACE,KAAK,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAEQ,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,YAAsC;QAC/E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,QAAQ,mBAAmB,EAAE;YACtE,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,QAAQ,EAAE,EAAE,EAAE,CAAC;SACvC,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QACzC,mCAAmC,CAAC,GAAG,EAAE;YACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK;YACnD,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY;YAC5F,QAAQ,EAAE,6BAA6B;SACxC,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAE1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAyC,CAAC;QACxF,MAAM,cAAc,GAAG,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;YAC7E,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QACH,wEAAwE;QACxE,wEAAwE;QACxE,IAAI,cAAc,IAAI,CACpB,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,iBAAiB,CAAC;YAC/D,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CACzC;YAAE,OAAO,IAAI,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,CAAC,MAAM,mCAAmC,CAAC,CAAC;IAC9G,CAAC;CACF"}

package/dist/providers/sail.d.ts

@@ -0,0 +1,44 @@
+import type { ChatCompletionChunk, ChatCompletionResponse, ChatMessage, Platform } from '@srouter/shared/types.js';
+import { BaseProvider, type CompletionOptions, type KeyValidationResult } from './base.js';
+import { type QuotaObservationContext } from '../services/provider-quota.js';
+interface SailProviderOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+/**
+ * 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 declare class SailProvider extends BaseProvider {
+    readonly platform: Platform;
+    readonly name = "Sail Research";
+    private readonly timeoutMs;
+    private readonly pollIntervalMs;
+    constructor(options?: SailProviderOptions);
+    private authHeaders;
+    private completionWindow;
+    private reasoningEffort;
+    /** Translate Chat Completions history into Responses input items. */
+    private inputItems;
+    private toolChoice;
+    private textFormat;
+    private buildBody;
+    private errorText;
+    private recordQuota;
+    private parseResponse;
+    private wait;
+    private runResponse;
+    private usageOf;
+    private normalize;
+    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>;
+    validateKey(apiKey: string, quotaContext?: QuotaObservationContext): Promise<KeyValidationResult>;
+}
+export {};
+//# sourceMappingURL=sail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sail.d.ts","sourceRoot":"","sources":["../../src/providers/sail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EAGX,QAAQ,EAET,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,YAAY,EAEZ,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AAkDvC,UAAU,mBAAmB;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAU;IACrC,QAAQ,CAAC,IAAI,mBAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,GAAE,mBAAwB;IAM7C,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,eAAe;IAWvB,qEAAqE;IACrE,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,SAAS;IA6BjB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,WAAW;YAWL,aAAa;YAYb,IAAI;YAkBJ,WAAW;IA6CzB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,SAAS;IAyCX,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,EAC3B,YAAY,CAAC,EAAE,uBAAuB,GACrC,OAAO,CAAC,sBAAsB,CAAC;IAO3B,oBAAoB,CACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,EAC3B,YAAY,CAAC,EAAE,uBAAuB,GACrC,cAAc,CAAC,mBAAmB,CAAC;IAmBhC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAcxG"}