ai-sdk-json-schema

Purpose

ai-sdk-json-schema turns the models.dev provider catalog into shipped generated data, Zod-first JSON config schemas, and runtime helpers for planning, resolving, and loading text or transcription models from provider packages.

The shipped JSON Schema files enumerate known providers and use model-id examples for autocomplete, while still allowing any string model id for known providers.

Installation

pnpm add ai-sdk-json-schema

Quick Example

import { resolveModel, textModelConfigSchema } from 'ai-sdk-json-schema'

const config = textModelConfigSchema.parse({
  provider: 'openai',
  model: 'gpt-4.1',
})

const descriptor = resolveModel('text', config)

console.log({
  catalogMatch: descriptor.catalogMatch,
  packageName: descriptor.packageName,
})

Documentation Map

• Conceptual model, API selection, invariants, and recommended patterns: docs/context.md
• Runnable usage patterns: examples/validate-config.ts, examples/resolve-load-plan.ts, examples/execute-load-plan.ts, examples/load-text-model.ts, examples/load-transcription-model.ts
• Release notes for downstream users: CHANGELOG.md
• Exact exported signatures: dist/index.d.mts
• Shipped JSON Schema files after build: dist/schemas/text-model-config.schema.json, dist/schemas/transcription-model-config.schema.json