offrouter-core 0.2.1 → 0.2.2

package/src/providers/catalog.ts

@@ -1,483 +0,0 @@
-/**
- * Static provider/model catalog for offline subscription-first routing tests.
- * No credential scraping; entries describe discovery shapes only.
- */
-
-import type {
-  AuthScope,
-  AuthTier,
-  ProviderCandidate,
-  ProviderHealth,
-  SubscriptionStatus,
-} from "../types.js";
-import {
-  selectBuiltinProviders,
-  type BuiltinCatalogConfig,
-  type BuiltinProviderEntry,
-} from "./catalog-data.js";
-
-/** Logical model family shared across auth tiers for preference testing. */
-export type LogicalModelFamily =
-  "frontier-coder" | "fast-coder" | "local-coder" | "vision-helper";
-
-export interface CatalogEntry {
-  providerId: string;
-  modelId: string;
-  displayName: string;
-  family: LogicalModelFamily;
-  authTier: AuthTier;
-  authScope: AuthScope;
-  subscriptionStatus?: SubscriptionStatus;
-  health: ProviderHealth;
-  supportsTools: boolean;
-  supportsStreaming: boolean;
-  supportsJson: boolean;
-  supportsImages: boolean;
-  contextWindowTokens?: number;
-  maxOutputTokens?: number;
-  estimatedCostUsd?: number;
-  notes?: string;
-}
-
-/**
- * Built-in catalog: for several families, ship subscription + local + api-key
- * candidates so routing prefers subscription without live credentials.
- */
-export const STATIC_CATALOG: readonly CatalogEntry[] = [
-  // 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,
-  },
-] as const;
-
-export interface LoadCatalogOptions {
-  /** Optional filter by provider id. */
-  providerIds?: string[];
-  /** Optional filter by logical family. */
-  families?: LogicalModelFamily[];
-  /** Optional filter by auth tier. */
-  authTiers?: AuthTier[];
-  /** Include degraded/dead by default true. */
-  includeUnhealthy?: boolean;
-}
-
-export function loadStaticCatalog(
-  options: LoadCatalogOptions = {},
-): CatalogEntry[] {
-  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: readonly CatalogEntry[] = STATIC_CATALOG,
-): ProviderCandidate[] {
-  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: readonly LogicalModelFamily[] = [
-  "frontier-coder",
-  "fast-coder",
-  "local-coder",
-  "vision-helper",
-];
-
-export function familyAuthTiers(family: LogicalModelFamily): Set<AuthTier> {
-  const tiers = new Set<AuthTier>();
-  for (const e of STATIC_CATALOG) {
-    if (e.family === family) tiers.add(e.authTier);
-  }
-  return tiers;
-}
-
-// ---------------------------------------------------------------------------
-// Built-in catalog: merge static entries with built-in provider metadata.
-// Keeps existing static loading behavior intact; subscription-first invariant
-// is preserved because builtin entries only add api-key/local candidates and
-// never replace the subscription rows already present in STATIC_CATALOG.
-// ---------------------------------------------------------------------------
-
-export interface LoadBuiltinCatalogOptions {
-  /** Per-provider overrides keyed by providerId (mirrors config providers map). */
-  providers?: BuiltinCatalogConfig;
-  /** Optional filter by logical family. */
-  families?: LogicalModelFamily[];
-  /** Optional filter by auth tier. */
-  authTiers?: AuthTier[];
-  /** Include degraded/dead by default true. */
-  includeUnhealthy?: boolean;
-}
-
-/** Flatten built-in provider metadata into catalog rows (copies). */
-function builtinProvidersToEntries(
-  providers: readonly BuiltinProviderEntry[],
-): CatalogEntry[] {
-  const entries: CatalogEntry[] = [];
-  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: CatalogEntry): string {
-  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: LoadBuiltinCatalogOptions = {},
-): CatalogEntry[] {
-  const includeUnhealthy = options.includeUnhealthy ?? true;
-  const config = options.providers ?? {};
-  const providerEnabled = (providerId: string): boolean =>
-    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: CatalogEntry[] = [];
-  const seen = new Set<string>();
-  const sources: readonly CatalogEntry[] = [
-    ...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;
-  });
-}