@funkai/models 0.1.0

package/src/catalog/providers/perplexity.ts

@@ -0,0 +1,61 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { ModelDefinition } from "../types.js";
+
+export const PERPLEXITY_MODELS = [
+  {
+    id: "sonar-reasoning-pro",
+    name: "Sonar Reasoning Pro",
+    provider: "perplexity",
+    family: "sonar-reasoning",
+    pricing: { input: 0.000002, output: 0.000008 },
+    contextWindow: 128000,
+    maxOutput: 4096,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: false, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "sonar",
+    name: "Sonar",
+    provider: "perplexity",
+    family: "sonar",
+    pricing: { input: 0.000001, output: 0.000001 },
+    contextWindow: 128000,
+    maxOutput: 4096,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: false, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "sonar-deep-research",
+    name: "Perplexity Sonar Deep Research",
+    provider: "perplexity",
+    family: "",
+    pricing: { input: 0.000002, output: 0.000008, reasoning: 0.000003 },
+    contextWindow: 128000,
+    maxOutput: 32768,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: false, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "sonar-pro",
+    name: "Sonar Pro",
+    provider: "perplexity",
+    family: "sonar-pro",
+    pricing: { input: 0.000003, output: 0.000015 },
+    contextWindow: 200000,
+    maxOutput: 8192,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: false, attachment: true, structuredOutput: false },
+  },
+] as const satisfies readonly ModelDefinition[];

package/src/catalog/providers/togetherai.ts

@@ -0,0 +1,204 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { ModelDefinition } from "../types.js";
+
+export const TOGETHERAI_MODELS = [
+  {
+    id: "zai-org/GLM-4.6",
+    name: "GLM 4.6",
+    provider: "togetherai",
+    family: "glm",
+    pricing: { input: 6e-7, output: 0.0000022 },
+    contextWindow: 200000,
+    maxOutput: 200000,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "zai-org/GLM-4.7",
+    name: "GLM-4.7",
+    provider: "togetherai",
+    family: "glm",
+    pricing: { input: 4.5e-7, output: 0.000002 },
+    contextWindow: 200000,
+    maxOutput: 200000,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "zai-org/GLM-5",
+    name: "GLM-5",
+    provider: "togetherai",
+    family: "glm",
+    pricing: { input: 0.000001, output: 0.0000032 },
+    contextWindow: 202752,
+    maxOutput: 131072,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: true },
+  },
+  {
+    id: "essentialai/Rnj-1-Instruct",
+    name: "Rnj-1 Instruct",
+    provider: "togetherai",
+    family: "rnj",
+    pricing: { input: 1.5e-7, output: 1.5e-7 },
+    contextWindow: 32768,
+    maxOutput: 32768,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "MiniMaxAI/MiniMax-M2.5",
+    name: "MiniMax-M2.5",
+    provider: "togetherai",
+    family: "minimax",
+    pricing: { input: 3e-7, output: 0.0000012, cacheRead: 6e-8 },
+    contextWindow: 204800,
+    maxOutput: 131072,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "deepseek-ai/DeepSeek-V3-1",
+    name: "DeepSeek V3.1",
+    provider: "togetherai",
+    family: "deepseek",
+    pricing: { input: 6e-7, output: 0.0000017 },
+    contextWindow: 131072,
+    maxOutput: 131072,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "deepseek-ai/DeepSeek-R1",
+    name: "DeepSeek R1",
+    provider: "togetherai",
+    family: "deepseek-thinking",
+    pricing: { input: 0.000003, output: 0.000007 },
+    contextWindow: 163839,
+    maxOutput: 163839,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: false, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "deepseek-ai/DeepSeek-V3",
+    name: "DeepSeek V3",
+    provider: "togetherai",
+    family: "deepseek",
+    pricing: { input: 0.00000125, output: 0.00000125 },
+    contextWindow: 131072,
+    maxOutput: 131072,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "moonshotai/Kimi-K2-Instruct",
+    name: "Kimi K2 Instruct",
+    provider: "togetherai",
+    family: "kimi",
+    pricing: { input: 0.000001, output: 0.000003 },
+    contextWindow: 131072,
+    maxOutput: 131072,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "moonshotai/Kimi-K2.5",
+    name: "Kimi K2.5",
+    provider: "togetherai",
+    family: "kimi",
+    pricing: { input: 5e-7, output: 0.0000028 },
+    contextWindow: 262144,
+    maxOutput: 262144,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+    name: "Llama 3.3 70B",
+    provider: "togetherai",
+    family: "llama",
+    pricing: { input: 8.8e-7, output: 8.8e-7 },
+    contextWindow: 131072,
+    maxOutput: 131072,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "Qwen/Qwen3-Next-80B-A3B-Instruct",
+    name: "Qwen3-Next-80B-A3B-Instruct",
+    provider: "togetherai",
+    family: "qwen",
+    pricing: { input: 1.5e-7, output: 0.0000015 },
+    contextWindow: 262144,
+    maxOutput: 262144,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "Qwen/Qwen3-235B-A22B-Instruct-2507-tput",
+    name: "Qwen3 235B A22B Instruct 2507 FP8",
+    provider: "togetherai",
+    family: "qwen",
+    pricing: { input: 2e-7, output: 6e-7 },
+    contextWindow: 262144,
+    maxOutput: 262144,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "Qwen/Qwen3.5-397B-A17B",
+    name: "Qwen3.5 397B A17B",
+    provider: "togetherai",
+    family: "qwen",
+    pricing: { input: 6e-7, output: 0.0000036 },
+    contextWindow: 262144,
+    maxOutput: 130000,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "Qwen/Qwen3-Coder-Next-FP8",
+    name: "Qwen3 Coder Next FP8",
+    provider: "togetherai",
+    family: "qwen",
+    pricing: { input: 5e-7, output: 0.0000012 },
+    contextWindow: 262144,
+    maxOutput: 262144,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8",
+    name: "Qwen3 Coder 480B A35B Instruct",
+    provider: "togetherai",
+    family: "qwen",
+    pricing: { input: 0.000002, output: 0.000002 },
+    contextWindow: 262144,
+    maxOutput: 262144,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "openai/gpt-oss-120b",
+    name: "GPT OSS 120B",
+    provider: "togetherai",
+    family: "gpt-oss",
+    pricing: { input: 1.5e-7, output: 6e-7 },
+    contextWindow: 131072,
+    maxOutput: 131072,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+] as const satisfies readonly ModelDefinition[];

package/src/catalog/providers/xai.ts

@@ -0,0 +1,292 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { ModelDefinition } from "../types.js";
+
+export const XAI_MODELS = [
+  {
+    id: "grok-2-1212",
+    name: "Grok 2 (1212)",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.00001, cacheRead: 0.000002 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-4.20-beta-latest-non-reasoning",
+    name: "Grok 4.20 Beta (Non-Reasoning)",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.000006, cacheRead: 2e-7 },
+    contextWindow: 2000000,
+    maxOutput: 30000,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-2",
+    name: "Grok 2",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.00001, cacheRead: 0.000002 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-3-fast-latest",
+    name: "Grok 3 Fast Latest",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000005, output: 0.000025, cacheRead: 0.00000125 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-2-vision",
+    name: "Grok 2 Vision",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.00001, cacheRead: 0.000002 },
+    contextWindow: 8192,
+    maxOutput: 4096,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-3",
+    name: "Grok 3",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000003, output: 0.000015, cacheRead: 7.5e-7 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-code-fast-1",
+    name: "Grok Code Fast 1",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 2e-7, output: 0.0000015, cacheRead: 2e-8 },
+    contextWindow: 256000,
+    maxOutput: 10000,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-2-vision-1212",
+    name: "Grok 2 Vision (1212)",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.00001, cacheRead: 0.000002 },
+    contextWindow: 8192,
+    maxOutput: 4096,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-4-1-fast-non-reasoning",
+    name: "Grok 4.1 Fast (Non-Reasoning)",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 2e-7, output: 5e-7, cacheRead: 5e-8 },
+    contextWindow: 2000000,
+    maxOutput: 30000,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-beta",
+    name: "Grok Beta",
+    provider: "xai",
+    family: "grok-beta",
+    pricing: { input: 0.000005, output: 0.000015, cacheRead: 0.000005 },
+    contextWindow: 131072,
+    maxOutput: 4096,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-3-mini-fast",
+    name: "Grok 3 Mini Fast",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 6e-7, output: 0.000004, cacheRead: 1.5e-7, reasoning: 0.000004 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-4-fast",
+    name: "Grok 4 Fast",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 2e-7, output: 5e-7, cacheRead: 5e-8 },
+    contextWindow: 2000000,
+    maxOutput: 30000,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-4",
+    name: "Grok 4",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000003, output: 0.000015, cacheRead: 7.5e-7, reasoning: 0.000015 },
+    contextWindow: 256000,
+    maxOutput: 64000,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-4.20-multi-agent-beta-latest",
+    name: "Grok 4.20 Multi-Agent Beta",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.000006, cacheRead: 2e-7 },
+    contextWindow: 2000000,
+    maxOutput: 30000,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-3-latest",
+    name: "Grok 3 Latest",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000003, output: 0.000015, cacheRead: 7.5e-7 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-4-1-fast",
+    name: "Grok 4.1 Fast",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 2e-7, output: 5e-7, cacheRead: 5e-8 },
+    contextWindow: 2000000,
+    maxOutput: 30000,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-2-vision-latest",
+    name: "Grok 2 Vision Latest",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.00001, cacheRead: 0.000002 },
+    contextWindow: 8192,
+    maxOutput: 4096,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-3-mini-latest",
+    name: "Grok 3 Mini Latest",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 3e-7, output: 5e-7, cacheRead: 7.5e-8, reasoning: 5e-7 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-3-mini",
+    name: "Grok 3 Mini",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 3e-7, output: 5e-7, cacheRead: 7.5e-8, reasoning: 5e-7 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-3-mini-fast-latest",
+    name: "Grok 3 Mini Fast Latest",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 6e-7, output: 0.000004, cacheRead: 1.5e-7, reasoning: 0.000004 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-2-latest",
+    name: "Grok 2 Latest",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.00001, cacheRead: 0.000002 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-4-fast-non-reasoning",
+    name: "Grok 4 Fast (Non-Reasoning)",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 2e-7, output: 5e-7, cacheRead: 5e-8 },
+    contextWindow: 2000000,
+    maxOutput: 30000,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-vision-beta",
+    name: "Grok Vision Beta",
+    provider: "xai",
+    family: "grok-vision",
+    pricing: { input: 0.000005, output: 0.000015, cacheRead: 0.000005 },
+    contextWindow: 8192,
+    maxOutput: 4096,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: true, structuredOutput: false },
+  },
+  {
+    id: "grok-3-fast",
+    name: "Grok 3 Fast",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000005, output: 0.000025, cacheRead: 0.00000125 },
+    contextWindow: 131072,
+    maxOutput: 8192,
+    modalities: { input: ["text"], output: ["text"] },
+    capabilities: { reasoning: false, toolCall: true, attachment: false, structuredOutput: false },
+  },
+  {
+    id: "grok-4.20-beta-latest-reasoning",
+    name: "Grok 4.20 Beta (Reasoning)",
+    provider: "xai",
+    family: "grok",
+    pricing: { input: 0.000002, output: 0.000006, cacheRead: 2e-7 },
+    contextWindow: 2000000,
+    maxOutput: 30000,
+    modalities: { input: ["text", "image"], output: ["text"] },
+    capabilities: { reasoning: true, toolCall: true, attachment: true, structuredOutput: false },
+  },
+] as const satisfies readonly ModelDefinition[];

package/src/catalog/types.ts

@@ -0,0 +1,86 @@
+/**
+ * Per-model pricing in USD per token.
+ *
+ * All rates are per-token. The generation script converts models.dev
+ * per-million-token rates at code-gen time so runtime {@link calculateCost}
+ * can multiply directly.
+ */
+export interface ModelPricing {
+  /** Cost per input token. */
+  readonly input: number;
+
+  /** Cost per output token. */
+  readonly output: number;
+
+  /** Cost per cached input token (read). */
+  readonly cacheRead?: number;
+
+  /** Cost per cached input token (write). */
+  readonly cacheWrite?: number;
+
+  /** Cost per reasoning token. */
+  readonly reasoning?: number;
+}
+
+/**
+ * Model input/output modality descriptors.
+ *
+ * Values come directly from the models.dev API (e.g. `"text"`,
+ * `"image"`, `"audio"`, `"video"`, `"pdf"`).
+ */
+export interface ModelModalities {
+  /** Accepted input modalities. */
+  readonly input: readonly string[];
+
+  /** Produced output modalities. */
+  readonly output: readonly string[];
+}
+
+/**
+ * Boolean capability flags for a model.
+ */
+export interface ModelCapabilities {
+  /** Supports chain-of-thought / extended thinking. */
+  readonly reasoning: boolean;
+
+  /** Supports tool (function) calling. */
+  readonly toolCall: boolean;
+
+  /** Supports file/image attachments. */
+  readonly attachment: boolean;
+
+  /** Supports structured (JSON) output. */
+  readonly structuredOutput: boolean;
+}
+
+/**
+ * Model definition with metadata, pricing, and capabilities.
+ */
+export interface ModelDefinition {
+  /** Provider-native model identifier (e.g. `"gpt-4.1"`, `"claude-sonnet-4"`). */
+  readonly id: string;
+
+  /** Human-readable display name (e.g. `"GPT-4.1"`). */
+  readonly name: string;
+
+  /** Provider slug matching the key in `providers.json` (e.g. `"openai"`). */
+  readonly provider: string;
+
+  /** Model family (e.g. `"gpt"`, `"claude-sonnet"`). */
+  readonly family: string;
+
+  /** Token pricing rates (per-token, converted from per-million at generation time). */
+  readonly pricing: ModelPricing;
+
+  /** Maximum context window size in tokens. */
+  readonly contextWindow: number;
+
+  /** Maximum output tokens. */
+  readonly maxOutput: number;
+
+  /** Supported input/output modalities. */
+  readonly modalities: ModelModalities;
+
+  /** Model capability flags. */
+  readonly capabilities: ModelCapabilities;
+}