@funkai/models 0.1.0

package/src/providers/fireworks-ai.ts

@@ -0,0 +1,65 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { FIREWORKS_AI_MODELS } from "../catalog/providers/fireworks-ai.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for Fireworks AI.
+ *
+ * @example
+ * ```typescript
+ * import type { FireworksModelId } from '@funkai/models/fireworks-ai'
+ *
+ * const id: FireworksModelId = 'accounts/fireworks/models/kimi-k2-instruct'
+ * ```
+ */
+export type FireworksModelId = (typeof FIREWORKS_AI_MODELS)[number]["id"];
+
+/**
+ * All Fireworks AI models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { fireworksModels } from '@funkai/models/fireworks-ai'
+ *
+ * for (const m of fireworksModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const fireworksModels = FIREWORKS_AI_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(FIREWORKS_AI_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up a Fireworks AI model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { fireworksModel } from '@funkai/models/fireworks-ai'
+ *
+ * const m = fireworksModel('accounts/fireworks/models/kimi-k2-instruct')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function fireworksModel(id: LiteralUnion<FireworksModelId, string>): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/google-vertex.ts

@@ -0,0 +1,67 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { GOOGLE_VERTEX_MODELS } from "../catalog/providers/google-vertex.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for Google Vertex AI.
+ *
+ * @example
+ * ```typescript
+ * import type { GoogleVertexModelId } from '@funkai/models/google-vertex'
+ *
+ * const id: GoogleVertexModelId = 'gemini-embedding-001'
+ * ```
+ */
+export type GoogleVertexModelId = (typeof GOOGLE_VERTEX_MODELS)[number]["id"];
+
+/**
+ * All Google Vertex AI models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { googleVertexModels } from '@funkai/models/google-vertex'
+ *
+ * for (const m of googleVertexModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const googleVertexModels = GOOGLE_VERTEX_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(GOOGLE_VERTEX_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up a Google Vertex AI model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { googleVertexModel } from '@funkai/models/google-vertex'
+ *
+ * const m = googleVertexModel('gemini-embedding-001')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function googleVertexModel(
+  id: LiteralUnion<GoogleVertexModelId, string>,
+): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/google.ts

@@ -0,0 +1,65 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { GOOGLE_MODELS } from "../catalog/providers/google.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for Google.
+ *
+ * @example
+ * ```typescript
+ * import type { GoogleModelId } from '@funkai/models/google'
+ *
+ * const id: GoogleModelId = 'gemini-embedding-001'
+ * ```
+ */
+export type GoogleModelId = (typeof GOOGLE_MODELS)[number]["id"];
+
+/**
+ * All Google models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { googleModels } from '@funkai/models/google'
+ *
+ * for (const m of googleModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const googleModels = GOOGLE_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(GOOGLE_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up a Google model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { googleModel } from '@funkai/models/google'
+ *
+ * const m = googleModel('gemini-embedding-001')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function googleModel(id: LiteralUnion<GoogleModelId, string>): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/groq.ts

@@ -0,0 +1,65 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { GROQ_MODELS } from "../catalog/providers/groq.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for Groq.
+ *
+ * @example
+ * ```typescript
+ * import type { GroqModelId } from '@funkai/models/groq'
+ *
+ * const id: GroqModelId = 'llama3-70b-8192'
+ * ```
+ */
+export type GroqModelId = (typeof GROQ_MODELS)[number]["id"];
+
+/**
+ * All Groq models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { groqModels } from '@funkai/models/groq'
+ *
+ * for (const m of groqModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const groqModels = GROQ_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(GROQ_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up a Groq model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { groqModel } from '@funkai/models/groq'
+ *
+ * const m = groqModel('llama3-70b-8192')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function groqModel(id: LiteralUnion<GroqModelId, string>): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/huggingface.ts

@@ -0,0 +1,67 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { HUGGINGFACE_MODELS } from "../catalog/providers/huggingface.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for Hugging Face.
+ *
+ * @example
+ * ```typescript
+ * import type { HuggingFaceModelId } from '@funkai/models/huggingface'
+ *
+ * const id: HuggingFaceModelId = 'zai-org/GLM-4.7-Flash'
+ * ```
+ */
+export type HuggingFaceModelId = (typeof HUGGINGFACE_MODELS)[number]["id"];
+
+/**
+ * All Hugging Face models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { huggingFaceModels } from '@funkai/models/huggingface'
+ *
+ * for (const m of huggingFaceModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const huggingFaceModels = HUGGINGFACE_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(HUGGINGFACE_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up a Hugging Face model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { huggingFaceModel } from '@funkai/models/huggingface'
+ *
+ * const m = huggingFaceModel('zai-org/GLM-4.7-Flash')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function huggingFaceModel(
+  id: LiteralUnion<HuggingFaceModelId, string>,
+): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/inception.ts

@@ -0,0 +1,65 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { INCEPTION_MODELS } from "../catalog/providers/inception.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for Inception (Mercury).
+ *
+ * @example
+ * ```typescript
+ * import type { InceptionModelId } from '@funkai/models/inception'
+ *
+ * const id: InceptionModelId = 'mercury-2'
+ * ```
+ */
+export type InceptionModelId = (typeof INCEPTION_MODELS)[number]["id"];
+
+/**
+ * All Inception (Mercury) models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { inceptionModels } from '@funkai/models/inception'
+ *
+ * for (const m of inceptionModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const inceptionModels = INCEPTION_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(INCEPTION_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up an Inception (Mercury) model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { inceptionModel } from '@funkai/models/inception'
+ *
+ * const m = inceptionModel('mercury-2')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function inceptionModel(id: LiteralUnion<InceptionModelId, string>): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/llama.ts

@@ -0,0 +1,65 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { LLAMA_MODELS } from "../catalog/providers/llama.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for Meta Llama.
+ *
+ * @example
+ * ```typescript
+ * import type { LlamaModelId } from '@funkai/models/llama'
+ *
+ * const id: LlamaModelId = 'cerebras-llama-4-maverick-17b-128e-instruct'
+ * ```
+ */
+export type LlamaModelId = (typeof LLAMA_MODELS)[number]["id"];
+
+/**
+ * All Meta Llama models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { llamaModels } from '@funkai/models/llama'
+ *
+ * for (const m of llamaModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const llamaModels = LLAMA_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(LLAMA_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up a Meta Llama model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { llamaModel } from '@funkai/models/llama'
+ *
+ * const m = llamaModel('cerebras-llama-4-maverick-17b-128e-instruct')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function llamaModel(id: LiteralUnion<LlamaModelId, string>): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/mistral.ts

@@ -0,0 +1,65 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { MISTRAL_MODELS } from "../catalog/providers/mistral.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for Mistral.
+ *
+ * @example
+ * ```typescript
+ * import type { MistralModelId } from '@funkai/models/mistral'
+ *
+ * const id: MistralModelId = 'devstral-medium-2507'
+ * ```
+ */
+export type MistralModelId = (typeof MISTRAL_MODELS)[number]["id"];
+
+/**
+ * All Mistral models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { mistralModels } from '@funkai/models/mistral'
+ *
+ * for (const m of mistralModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const mistralModels = MISTRAL_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(MISTRAL_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up a Mistral model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { mistralModel } from '@funkai/models/mistral'
+ *
+ * const m = mistralModel('devstral-medium-2507')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function mistralModel(id: LiteralUnion<MistralModelId, string>): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/nvidia.ts

@@ -0,0 +1,65 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { NVIDIA_MODELS } from "../catalog/providers/nvidia.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for NVIDIA NIM.
+ *
+ * @example
+ * ```typescript
+ * import type { NvidiaModelId } from '@funkai/models/nvidia'
+ *
+ * const id: NvidiaModelId = 'nvidia/llama-3.1-nemotron-70b-instruct'
+ * ```
+ */
+export type NvidiaModelId = (typeof NVIDIA_MODELS)[number]["id"];
+
+/**
+ * All NVIDIA NIM models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { nvidiaModels } from '@funkai/models/nvidia'
+ *
+ * for (const m of nvidiaModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const nvidiaModels = NVIDIA_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(NVIDIA_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up a NVIDIA NIM model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { nvidiaModel } from '@funkai/models/nvidia'
+ *
+ * const m = nvidiaModel('nvidia/llama-3.1-nemotron-70b-instruct')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function nvidiaModel(id: LiteralUnion<NvidiaModelId, string>): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}

package/src/providers/openai.ts

@@ -0,0 +1,65 @@
+// ──────────────────────────────────────────────────────────────
+// ███████╗██╗   ██╗███╗   ██╗██╗  ██╗ █████╗ ██╗
+// ██╔════╝██║   ██║████╗  ██║██║ ██╔╝██╔══██╗██║
+// █████╗  ██║   ██║██╔██╗ ██║█████╔╝ ███████║██║
+// ██╔══╝  ██║   ██║██║╚██╗██║██╔═██╗ ██╔══██║██║
+// ██║     ╚██████╔╝██║ ╚████║██║  ██╗██║  ██║██║
+// ╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝
+//
+// AUTO-GENERATED — DO NOT EDIT
+// Source: https://models.dev
+// Update: pnpm --filter=@funkai/models generate:models
+// ──────────────────────────────────────────────────────────────
+
+import type { LiteralUnion } from "type-fest";
+
+import { OPENAI_MODELS } from "../catalog/providers/openai.js";
+import type { ModelDefinition } from "../catalog/types.js";
+
+/**
+ * Known model identifiers for OpenAI.
+ *
+ * @example
+ * ```typescript
+ * import type { OpenAIModelId } from '@funkai/models/openai'
+ *
+ * const id: OpenAIModelId = 'gpt-4o-2024-11-20'
+ * ```
+ */
+export type OpenAIModelId = (typeof OPENAI_MODELS)[number]["id"];
+
+/**
+ * All OpenAI models in the catalog.
+ *
+ * @example
+ * ```typescript
+ * import { openAIModels } from '@funkai/models/openai'
+ *
+ * for (const m of openAIModels) {
+ *   console.log(m.id, m.pricing.input)
+ * }
+ * ```
+ */
+export const openAIModels = OPENAI_MODELS;
+
+const MODEL_INDEX = new Map<string, ModelDefinition>(OPENAI_MODELS.map((m) => [m.id, m]));
+
+/**
+ * Look up an OpenAI model by ID.
+ *
+ * @param id - The provider-native model identifier.
+ * @returns The matching model definition, or `null`.
+ *
+ * @example
+ * ```typescript
+ * import { openAIModel } from '@funkai/models/openai'
+ *
+ * const m = openAIModel('gpt-4o-2024-11-20')
+ * if (m) {
+ *   console.log(m.pricing.input)
+ * }
+ * ```
+ */
+export function openAIModel(id: LiteralUnion<OpenAIModelId, string>): ModelDefinition | null {
+  return MODEL_INDEX.get(id) ?? null;
+}