resolveModel

resolveModel(model, options): string

Defined in: core/model-shortcuts.ts:135

Resolves a model name to its full provider:model format.

Supports:

• Direct aliases: ‘gpt5’, ‘sonnet’, ‘flash’
• Auto-detection: ‘gpt-5-nano’ → ‘openai:gpt-5-nano’
• Pass-through: ‘openai:gpt-5’ → ‘openai:gpt-5’

Warnings:

• Logs a warning when an unknown model name falls back to OpenAI
• Use { strict: true } to throw an error instead
• Use { silent: true } to suppress warnings

Parameters

model

string

Model name or alias

options

ResolveModelOptions = {}

Resolution options

Returns

string

Full provider:model-id string

Example

resolveModel('gpt5')              // → 'openai:gpt-5'
resolveModel('sonnet')            // → 'anthropic:claude-sonnet-4-5'
resolveModel('gpt-5-nano')        // → 'openai:gpt-5-nano'
resolveModel('openai:gpt-5')      // → 'openai:gpt-5' (passthrough)
resolveModel('claude-3-5-sonnet') // → 'anthropic:claude-3-5-sonnet'

// Typo detection
resolveModel('gp5')  // ⚠️ Warning: Unknown model 'gp5', falling back to 'openai:gp5'

// Strict mode (throws on typos)
resolveModel('gp5', { strict: true })  // ❌ Error: Unknown model 'gp5'