offrouter-core 0.2.0 → 0.2.2

package/dist/providers/catalog.js

@@ -0,0 +1,394 @@
+/**
+ * Static provider/model catalog for offline subscription-first routing tests.
+ * No credential scraping; entries describe discovery shapes only.
+ */
+import { selectBuiltinProviders, } from "./catalog-data.js";
+/**
+ * Built-in catalog: for several families, ship subscription + local + api-key
+ * candidates so routing prefers subscription without live credentials.
+ */
+export const STATIC_CATALOG = [
+    // frontier-coder across all three tiers
+    {
+        providerId: "claude-subscription",
+        modelId: "claude-sonnet-4",
+        displayName: "Claude Sonnet (subscription)",
+        family: "frontier-coder",
+        authTier: "subscription",
+        authScope: "first-party",
+        subscriptionStatus: "active",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: true,
+        contextWindowTokens: 200_000,
+        maxOutputTokens: 32_000,
+        estimatedCostUsd: 0,
+        notes: "Official harness subscription capacity",
+    },
+    {
+        providerId: "ollama",
+        modelId: "qwen2.5-coder:32b",
+        displayName: "Qwen2.5 Coder 32B (local)",
+        family: "frontier-coder",
+        authTier: "local",
+        authScope: "first-party",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 32_768,
+        maxOutputTokens: 8_192,
+        estimatedCostUsd: 0,
+    },
+    {
+        providerId: "openrouter",
+        modelId: "anthropic/claude-sonnet-4",
+        displayName: "Claude Sonnet via OpenRouter",
+        family: "frontier-coder",
+        authTier: "api-key",
+        authScope: "third-party",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: true,
+        contextWindowTokens: 200_000,
+        maxOutputTokens: 32_000,
+        estimatedCostUsd: 0.03,
+    },
+    {
+        providerId: "xai",
+        modelId: "grok-code-fast-1",
+        displayName: "Grok Code Fast (api-key)",
+        family: "frontier-coder",
+        authTier: "api-key",
+        authScope: "first-party",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 131_072,
+        maxOutputTokens: 16_384,
+        estimatedCostUsd: 0.02,
+    },
+    // fast-coder across tiers
+    {
+        providerId: "codex-subscription",
+        modelId: "gpt-5-codex",
+        displayName: "GPT Codex (subscription)",
+        family: "fast-coder",
+        authTier: "subscription",
+        authScope: "first-party",
+        subscriptionStatus: "active",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 128_000,
+        maxOutputTokens: 16_384,
+        estimatedCostUsd: 0,
+    },
+    {
+        providerId: "lmstudio",
+        modelId: "local-fast-coder",
+        displayName: "Local Fast Coder",
+        family: "fast-coder",
+        authTier: "local",
+        authScope: "first-party",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 16_384,
+        maxOutputTokens: 4_096,
+        estimatedCostUsd: 0,
+    },
+    {
+        providerId: "openrouter",
+        modelId: "openai/gpt-4.1-mini",
+        displayName: "GPT-4.1 Mini (OpenRouter)",
+        family: "fast-coder",
+        authTier: "api-key",
+        authScope: "third-party",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 128_000,
+        maxOutputTokens: 16_384,
+        estimatedCostUsd: 0.005,
+    },
+    // local-coder family (local preferred; still include subscription / api-key siblings)
+    {
+        providerId: "ollama",
+        modelId: "deepseek-coder-v2:lite",
+        displayName: "DeepSeek Coder Lite (local)",
+        family: "local-coder",
+        authTier: "local",
+        authScope: "first-party",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 16_384,
+        maxOutputTokens: 4_096,
+        estimatedCostUsd: 0,
+    },
+    {
+        providerId: "gemini-subscription",
+        modelId: "gemini-2.5-flash",
+        displayName: "Gemini Flash (subscription)",
+        family: "local-coder",
+        authTier: "subscription",
+        authScope: "first-party",
+        subscriptionStatus: "active",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 1_000_000,
+        maxOutputTokens: 8_192,
+        estimatedCostUsd: 0,
+    },
+    {
+        providerId: "openrouter",
+        modelId: "deepseek/deepseek-coder",
+        displayName: "DeepSeek Coder (OpenRouter)",
+        family: "local-coder",
+        authTier: "api-key",
+        authScope: "third-party",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 64_000,
+        maxOutputTokens: 8_192,
+        estimatedCostUsd: 0.002,
+    },
+    // vision-helper
+    {
+        providerId: "claude-subscription",
+        modelId: "claude-sonnet-4-vision",
+        displayName: "Claude Vision (subscription)",
+        family: "vision-helper",
+        authTier: "subscription",
+        authScope: "first-party",
+        subscriptionStatus: "active",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: true,
+        contextWindowTokens: 200_000,
+        maxOutputTokens: 16_384,
+        estimatedCostUsd: 0,
+    },
+    {
+        providerId: "openrouter",
+        modelId: "openai/gpt-4o",
+        displayName: "GPT-4o Vision (api-key)",
+        family: "vision-helper",
+        authTier: "api-key",
+        authScope: "third-party",
+        health: "healthy",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: true,
+        contextWindowTokens: 128_000,
+        maxOutputTokens: 16_384,
+        estimatedCostUsd: 0.04,
+    },
+    {
+        providerId: "ollama",
+        modelId: "llava:latest",
+        displayName: "LLaVA (local vision)",
+        family: "vision-helper",
+        authTier: "local",
+        authScope: "first-party",
+        health: "healthy",
+        supportsTools: false,
+        supportsStreaming: true,
+        supportsJson: false,
+        supportsImages: true,
+        contextWindowTokens: 4_096,
+        maxOutputTokens: 2_048,
+        estimatedCostUsd: 0,
+    },
+    // Degraded / unconfigured samples for status tests
+    {
+        providerId: "claude-subscription",
+        modelId: "claude-opus-4",
+        displayName: "Claude Opus (subscription exhausted)",
+        family: "frontier-coder",
+        authTier: "subscription",
+        authScope: "first-party",
+        subscriptionStatus: "exhausted",
+        health: "degraded",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: true,
+        contextWindowTokens: 200_000,
+        maxOutputTokens: 32_000,
+        estimatedCostUsd: 0,
+    },
+    {
+        providerId: "codex-subscription",
+        modelId: "o3",
+        displayName: "o3 (subscription unconfigured)",
+        family: "fast-coder",
+        authTier: "subscription",
+        authScope: "first-party",
+        subscriptionStatus: "unconfigured",
+        health: "dead",
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsJson: true,
+        supportsImages: false,
+        contextWindowTokens: 200_000,
+        maxOutputTokens: 32_000,
+        estimatedCostUsd: 0,
+    },
+];
+export function loadStaticCatalog(options = {}) {
+    const includeUnhealthy = options.includeUnhealthy ?? true;
+    return STATIC_CATALOG.filter((entry) => {
+        if (options.providerIds &&
+            !options.providerIds.includes(entry.providerId)) {
+            return false;
+        }
+        if (options.families && !options.families.includes(entry.family)) {
+            return false;
+        }
+        if (options.authTiers && !options.authTiers.includes(entry.authTier)) {
+            return false;
+        }
+        if (!includeUnhealthy && entry.health !== "healthy") {
+            return false;
+        }
+        return true;
+    }).map((e) => ({ ...e }));
+}
+export function catalogToCandidates(entries = STATIC_CATALOG) {
+    return entries.map((e) => ({
+        providerId: e.providerId,
+        modelId: e.modelId,
+        displayName: e.displayName,
+        authTier: e.authTier,
+        authScope: e.authScope,
+        subscriptionStatus: e.subscriptionStatus,
+        health: e.health,
+        supportsTools: e.supportsTools,
+        supportsStreaming: e.supportsStreaming,
+        supportsJson: e.supportsJson,
+        supportsImages: e.supportsImages,
+        contextWindowTokens: e.contextWindowTokens,
+        maxOutputTokens: e.maxOutputTokens,
+        estimatedCostUsd: e.estimatedCostUsd,
+    }));
+}
+/** Families that must expose all three auth tiers for offline preference tests. */
+export const MULTI_TIER_FAMILIES = [
+    "frontier-coder",
+    "fast-coder",
+    "local-coder",
+    "vision-helper",
+];
+export function familyAuthTiers(family) {
+    const tiers = new Set();
+    for (const e of STATIC_CATALOG) {
+        if (e.family === family)
+            tiers.add(e.authTier);
+    }
+    return tiers;
+}
+/** Flatten built-in provider metadata into catalog rows (copies). */
+function builtinProvidersToEntries(providers) {
+    const entries = [];
+    for (const provider of providers) {
+        for (const model of provider.knownModels) {
+            entries.push({
+                providerId: provider.providerId,
+                modelId: model.modelId,
+                displayName: model.displayName ??
+                    `${provider.displayName} ${model.modelId}`,
+                family: model.family,
+                authTier: provider.defaultAuthTier,
+                authScope: provider.defaultAuthScope,
+                health: "healthy",
+                supportsTools: model.supportsTools ?? true,
+                supportsStreaming: model.supportsStreaming ?? true,
+                supportsJson: model.supportsJson ?? true,
+                supportsImages: model.supportsImages ?? false,
+                contextWindowTokens: model.contextWindowTokens,
+                maxOutputTokens: model.maxOutputTokens,
+                notes: provider.subscriptionSurfaceNote,
+            });
+        }
+    }
+    return entries;
+}
+/**
+ * Structured dedup key for catalog rows. Serializes the discriminating fields
+ * as a JSON tuple so there is no ad hoc delimiter parsing or collision risk.
+ */
+function catalogEntryDedupKey(entry) {
+    return JSON.stringify([
+        entry.providerId,
+        entry.modelId,
+        entry.authTier,
+        entry.family,
+    ]);
+}
+/**
+ * Load the merged built-in catalog: static rows plus built-in provider
+ * metadata, with provider enable/disable and base URL overrides applied.
+ * Existing static loading behavior (loadStaticCatalog) is unchanged.
+ */
+export function loadBuiltinCatalog(options = {}) {
+    const includeUnhealthy = options.includeUnhealthy ?? true;
+    const config = options.providers ?? {};
+    const providerEnabled = (providerId) => config[providerId]?.enabled ?? true;
+    const builtinEntries = builtinProvidersToEntries(selectBuiltinProviders(config));
+    // Merge static catalog with built-in entries, applying the provider
+    // enable/disable filter to both sources and deduping identical rows.
+    const merged = [];
+    const seen = new Set();
+    const sources = [
+        ...STATIC_CATALOG.map((entry) => ({ ...entry })),
+        ...builtinEntries,
+    ];
+    for (const entry of sources) {
+        if (!providerEnabled(entry.providerId))
+            continue;
+        const key = catalogEntryDedupKey(entry);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        merged.push(entry);
+    }
+    return merged.filter((entry) => {
+        if (options.families && !options.families.includes(entry.family)) {
+            return false;
+        }
+        if (options.authTiers && !options.authTiers.includes(entry.authTier)) {
+            return false;
+        }
+        if (!includeUnhealthy && entry.health !== "healthy") {
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=catalog.js.map

package/dist/providers/catalog.js.map

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

package/dist/providers/fake.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Deterministic fake provider adapter for offline tests and MCP demos.
+ * Supports one-shot, streaming, configured errors, and cancellation.
+ */
+import type { AuthTier, RouteRequest } from "../types.js";
+import { ProviderError, type AuthStatus, type CostEstimate, type LimitSnapshot, type ModelCapability, type ProviderAdapter, type ProviderEvent, type ProviderInvokeRequest } from "./adapter.js";
+export interface FakeModelConfig extends ModelCapability {
+    authTier?: AuthTier;
+}
+export interface FakeProviderOptions {
+    id?: string;
+    authTier?: AuthTier;
+    /** Presence-only flag; never stores a secret value. */
+    hasApiKey?: boolean;
+    limitsDiscoverable?: boolean;
+    opaqueLimits?: boolean;
+    remaining?: number;
+    limit?: number;
+    models?: FakeModelConfig[];
+    /** Fixed one-shot body when stream is false/omitted. */
+    responseText?: string;
+    /** Chunks for streaming invokes (token-ish pieces). */
+    streamChunks?: string[];
+    /** Delay between stream chunks in ms (default 0). */
+    streamDelayMs?: number;
+    /** If set, invoke throws/errors with this ProviderError. */
+    error?: ProviderError;
+    /** When true, delay long enough for cancel to win (default false). */
+    hangUntilCancel?: boolean;
+    estimatedCostUsd?: number;
+}
+export declare class FakeProviderAdapter implements ProviderAdapter {
+    readonly id: string;
+    private readonly options;
+    private readonly active;
+    private cancelled;
+    constructor(options?: FakeProviderOptions);
+    listModels(): Promise<ModelCapability[]>;
+    checkAuth(): Promise<AuthStatus>;
+    queryLimits(authTier: AuthTier): Promise<LimitSnapshot>;
+    estimate(request: RouteRequest, model: string, authTier: AuthTier): Promise<CostEstimate>;
+    invoke(request: ProviderInvokeRequest): AsyncIterable<ProviderEvent>;
+    cancel(callId: string): Promise<void>;
+}
+export declare function createFakeProvider(options?: FakeProviderOptions): FakeProviderAdapter;
+//# sourceMappingURL=fake.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/providers/fake.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAgDD,qBAAa,mBAAoB,YAAW,eAAe;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAcF;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,SAAS,CAAqB;gBAE1B,OAAO,GAAE,mBAAwB;IAgBvC,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIxC,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAiBhC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBvD,QAAQ,CACZ,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,YAAY,CAAC;IAYjB,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAAC,aAAa,CAAC;IAgHrE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5C;AAED,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,mBAAmB,CAErB"}