language-models 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * language-models - Model listing and resolution
+ *
+ * Lists all available models and resolves aliases to full model IDs.
+ *
+ * @packageDocumentation
+ */
+export { resolve, resolveWithProvider, list, get, search, DIRECT_PROVIDERS, type ModelInfo, type ProviderEndpoint, type ResolvedModel, type DirectProvider } from './models.js';
+export { ALIASES } from './aliases.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * language-models - Model listing and resolution
+ *
+ * Lists all available models and resolves aliases to full model IDs.
+ *
+ * @packageDocumentation
+ */
+export { resolve, resolveWithProvider, list, get, search, DIRECT_PROVIDERS } from './models.js';
+export { ALIASES } from './aliases.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,gBAAgB,EAKjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/models.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Model listing and resolution
+ */
+/**
+ * Provider endpoint information for direct API access
+ */
+export interface ProviderEndpoint {
+    /** Provider's API base URL (e.g., https://api.anthropic.com/v1) */
+    baseUrl: string;
+    /** Provider's model ID (e.g., claude-opus-4-5-20251101) */
+    modelId: string;
+}
+export interface ModelInfo {
+    id: string;
+    name: string;
+    description?: string;
+    context_length: number;
+    pricing: {
+        prompt: string;
+        completion: string;
+    };
+    architecture?: {
+        modality: string;
+        input_modalities: string[];
+        output_modalities: string[];
+    };
+    /** Provider slug (e.g., 'anthropic', 'openai', 'google') */
+    provider?: string;
+    /** Provider's native model ID for direct API calls */
+    provider_model_id?: string;
+    /** Provider endpoint info for direct routing */
+    endpoint?: ProviderEndpoint;
+}
+/**
+ * List all available models
+ */
+export declare function list(): ModelInfo[];
+/**
+ * Get a model by exact ID
+ */
+export declare function get(id: string): ModelInfo | undefined;
+/**
+ * Search models by query string
+ * Searches in id and name fields
+ */
+export declare function search(query: string): ModelInfo[];
+/**
+ * Resolve a model alias or partial name to a full model ID
+ *
+ * Resolution order:
+ * 1. Check aliases (e.g., 'opus' -> 'anthropic/claude-opus-4.5')
+ * 2. Check if it's already a full ID (contains '/')
+ * 3. Search for first matching model
+ *
+ * @example
+ * resolve('opus')           // 'anthropic/claude-opus-4.5'
+ * resolve('gpt-4o')         // 'openai/gpt-4o'
+ * resolve('claude-sonnet')  // 'anthropic/claude-sonnet-4.5'
+ * resolve('llama-70b')      // 'meta-llama/llama-3.3-70b-instruct'
+ */
+export declare function resolve(input: string): string;
+/**
+ * Providers that support direct SDK access (not via OpenRouter)
+ * These providers have special capabilities like MCP, extended thinking, etc.
+ */
+export declare const DIRECT_PROVIDERS: readonly ["openai", "anthropic", "google"];
+export type DirectProvider = typeof DIRECT_PROVIDERS[number];
+/**
+ * Result of resolving a model with provider routing info
+ */
+export interface ResolvedModel {
+    /** OpenRouter-style model ID (e.g., 'anthropic/claude-opus-4.5') */
+    id: string;
+    /** Provider slug (e.g., 'anthropic', 'openai', 'google') */
+    provider: string;
+    /** Provider's native model ID (e.g., 'claude-opus-4-5-20251101') */
+    providerModelId?: string;
+    /** Whether this provider supports direct SDK routing */
+    supportsDirectRouting: boolean;
+    /** Full model info if available */
+    model?: ModelInfo;
+}
+/**
+ * Resolve a model alias and get full routing information
+ *
+ * @example
+ * const info = resolveWithProvider('opus')
+ * // {
+ * //   id: 'anthropic/claude-opus-4.5',
+ * //   provider: 'anthropic',
+ * //   providerModelId: 'claude-opus-4-5-20251101',
+ * //   supportsDirectRouting: true,
+ * //   model: { ... }
+ * // }
+ */
+export declare function resolveWithProvider(input: string): ResolvedModel;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,EAAE,CAAA;QAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAA;KAC5B,CAAA;IACD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAeD;;GAEG;AACH,wBAAgB,IAAI,IAAI,SAAS,EAAE,CAElC;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAErD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAMjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB7C;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,4CAA6C,CAAA;AAC1E,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAA;IACV,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,qBAAqB,EAAE,OAAO,CAAA;IAC9B,mCAAmC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAiBhE"}

package/dist/models.js

@@ -0,0 +1,109 @@
+/**
+ * Model listing and resolution
+ */
+import { createRequire } from 'module';
+import { ALIASES } from './aliases.js';
+const require = createRequire(import.meta.url);
+// Load models from JSON
+let modelsCache = null;
+function loadModels() {
+    if (modelsCache)
+        return modelsCache;
+    try {
+        modelsCache = require('../data/models.json');
+        return modelsCache;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * List all available models
+ */
+export function list() {
+    return loadModels();
+}
+/**
+ * Get a model by exact ID
+ */
+export function get(id) {
+    return loadModels().find(m => m.id === id);
+}
+/**
+ * Search models by query string
+ * Searches in id and name fields
+ */
+export function search(query) {
+    const q = query.toLowerCase();
+    return loadModels().filter(m => m.id.toLowerCase().includes(q) ||
+        m.name.toLowerCase().includes(q));
+}
+/**
+ * Resolve a model alias or partial name to a full model ID
+ *
+ * Resolution order:
+ * 1. Check aliases (e.g., 'opus' -> 'anthropic/claude-opus-4.5')
+ * 2. Check if it's already a full ID (contains '/')
+ * 3. Search for first matching model
+ *
+ * @example
+ * resolve('opus')           // 'anthropic/claude-opus-4.5'
+ * resolve('gpt-4o')         // 'openai/gpt-4o'
+ * resolve('claude-sonnet')  // 'anthropic/claude-sonnet-4.5'
+ * resolve('llama-70b')      // 'meta-llama/llama-3.3-70b-instruct'
+ */
+export function resolve(input) {
+    const normalized = input.toLowerCase().trim();
+    // Check aliases first
+    if (ALIASES[normalized]) {
+        return ALIASES[normalized];
+    }
+    // Already a full ID with provider prefix
+    if (input.includes('/')) {
+        // Verify it exists or return as-is
+        const model = get(input);
+        return model?.id || input;
+    }
+    // Search for matching model
+    const matches = search(normalized);
+    const firstMatch = matches[0];
+    if (firstMatch) {
+        return firstMatch.id;
+    }
+    // Return as-is if nothing found
+    return input;
+}
+/**
+ * Providers that support direct SDK access (not via OpenRouter)
+ * These providers have special capabilities like MCP, extended thinking, etc.
+ */
+export const DIRECT_PROVIDERS = ['openai', 'anthropic', 'google'];
+/**
+ * Resolve a model alias and get full routing information
+ *
+ * @example
+ * const info = resolveWithProvider('opus')
+ * // {
+ * //   id: 'anthropic/claude-opus-4.5',
+ * //   provider: 'anthropic',
+ * //   providerModelId: 'claude-opus-4-5-20251101',
+ * //   supportsDirectRouting: true,
+ * //   model: { ... }
+ * // }
+ */
+export function resolveWithProvider(input) {
+    const id = resolve(input);
+    const model = get(id);
+    // Extract provider from ID (e.g., 'anthropic' from 'anthropic/claude-opus-4.5')
+    const slashIndex = id.indexOf('/');
+    const provider = slashIndex > 0 ? id.substring(0, slashIndex) : 'unknown';
+    const supportsDirectRouting = DIRECT_PROVIDERS.includes(provider);
+    return {
+        id,
+        provider,
+        providerModelId: model?.provider_model_id,
+        supportsDirectRouting,
+        model
+    };
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "language-models",
+  "version": "0.0.1",
+  "description": "Model listing and resolution for LLM providers",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && cp -r data dist/",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "rm -rf dist",
+    "fetch-models": "npx tsx scripts/fetch-models.ts"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "language-models",
+    "openrouter",
+    "primitives"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "rpc.do": "^0.1.0"
+  }
+}

package/scripts/fetch-models.ts

@@ -0,0 +1,115 @@
+#!/usr/bin/env npx tsx
+/**
+ * Fetch models from OpenRouter API and save to data/models.json
+ *
+ * Fetches from both:
+ * - /api/v1/models - Basic model info
+ * - /api/frontend/models - Provider routing info (provider_model_id, endpoint)
+ *
+ * Usage: npx tsx scripts/fetch-models.ts
+ */
+
+import { writeFileSync } from 'fs'
+import { dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const OUTPUT_PATH = join(__dirname, '..', 'data', 'models.json')
+
+interface FrontendModel {
+  slug: string
+  endpoint?: {
+    provider_model_id?: string
+    provider_slug?: string
+    provider_info?: {
+      baseUrl?: string
+    }
+  }
+}
+
+async function fetchModels() {
+  console.log('Fetching models from OpenRouter API...')
+
+  // Fetch basic model info
+  const modelsResponse = await fetch('https://openrouter.ai/api/v1/models')
+  if (!modelsResponse.ok) {
+    throw new Error(`Failed to fetch models: ${modelsResponse.status} ${modelsResponse.statusText}`)
+  }
+  const modelsData = await modelsResponse.json()
+  const models = modelsData.data || modelsData
+
+  console.log(`Found ${models.length} models from v1 API`)
+
+  // Fetch frontend models for provider routing info
+  console.log('Fetching provider routing info from frontend API...')
+  let frontendModels: FrontendModel[] = []
+  try {
+    const frontendResponse = await fetch('https://openrouter.ai/api/frontend/models')
+    if (frontendResponse.ok) {
+      const frontendData = await frontendResponse.json()
+      frontendModels = Array.isArray(frontendData) ? frontendData : (frontendData.data || [])
+      console.log(`Found ${frontendModels.length} models from frontend API`)
+    }
+  } catch (err) {
+    console.warn('Could not fetch frontend models, continuing without provider routing info')
+  }
+
+  // Create a map of frontend models by slug for quick lookup
+  const frontendMap = new Map<string, FrontendModel>()
+  for (const fm of frontendModels) {
+    if (fm.slug) {
+      frontendMap.set(fm.slug, fm)
+    }
+  }
+
+  // Merge frontend data into models
+  let enrichedCount = 0
+  for (const model of models) {
+    const frontend = frontendMap.get(model.id)
+    if (frontend?.endpoint) {
+      // Add provider routing info from nested endpoint
+      if (frontend.endpoint.provider_model_id) {
+        model.provider_model_id = frontend.endpoint.provider_model_id
+      }
+      if (frontend.endpoint.provider_slug) {
+        model.provider = frontend.endpoint.provider_slug
+      }
+      if (frontend.endpoint.provider_info?.baseUrl) {
+        model.endpoint = {
+          baseUrl: frontend.endpoint.provider_info.baseUrl,
+          modelId: frontend.endpoint.provider_model_id || model.id.split('/')[1]
+        }
+      }
+      enrichedCount++
+    } else {
+      // Extract provider from ID as fallback
+      const slashIndex = model.id.indexOf('/')
+      if (slashIndex > 0) {
+        model.provider = model.id.substring(0, slashIndex)
+      }
+    }
+  }
+
+  console.log(`Enriched ${enrichedCount} models with provider routing info`)
+
+  // Sort by created date (newest first)
+  models.sort((a: any, b: any) => (b.created || 0) - (a.created || 0))
+
+  writeFileSync(OUTPUT_PATH, JSON.stringify(models, null, 2))
+  console.log(`Saved to ${OUTPUT_PATH}`)
+
+  // Print some stats
+  const providers = new Set(models.map((m: any) => m.id.split('/')[0]))
+  console.log(`\nProviders: ${[...providers].join(', ')}`)
+
+  // Show which direct providers have routing info
+  const directProviders = ['openai', 'anthropic', 'google']
+  for (const provider of directProviders) {
+    const withRouting = models.filter((m: any) =>
+      m.id.startsWith(`${provider}/`) && m.provider_model_id
+    )
+    console.log(`${provider}: ${withRouting.length} models with provider_model_id`)
+  }
+}
+
+fetchModels().catch(console.error)