# Model Domain

Models are either external endpoints or managed deployments.

## Core Fields

All models share these core fields:

- identity: id, name
- presentation: icon, description, tags
- classification: mode, category
- metadata: info

## Metadata (info)

Model metadata is grouped under info.

- common metadata: family, baseModelId, releaseDate, parameterCount, languages
- language metadata: contextWindow, inputs, outputs, capabilities
- embedding metadata: embeddingDimensions, maxInputTokens

## External Model

External models define how to call a provider-hosted model.

- provider and providerModel
- optional endpoint overrides: apiBase, apiVersion
- auth configuration
- optional default inference settings
- optional availability status

## Managed Model

Managed models define deployment/runtime configuration.

- optional huggingFace source info (endpoint, repo, revision, fileName)
- runtime template
- optional runtime inference settings
- optional deployment status

## Model Union

- Model = ExternalModel | ManagedModel