catalog

Documentation

Index

• Constants
• func GetAnthropicAPIVersion(model string) string
• func GetDisplayName(provider, model string) string
• func GetMaxTokens(provider, model string, override int) int
• func HasCapability(provider, model, capability string) bool
• type ModelMeta
  • func ListAll() []ModelMeta
  • func Resolve(provider, model string) (ModelMeta, bool)
• type PreferredAPI
  • func GetPreferredAPI(provider, model string) PreferredAPI

Constants

const (
	ProviderOpenAI          = "OPENAI"
	ProviderOpenAIAssistant = "OPENAI_ASSISTANT"
	ProviderClaudeAI        = "CLAUDEAI"
	ProviderStackSpot       = "STACKSPOT"
	ProviderGoogleAI        = "GOOGLEAI"
	ProviderXAI             = "XAI"
	ProviderOllama          = "OLLAMA"
)

Provider names (alinhado com o restante do projeto)

Functions

func GetAnthropicAPIVersion

func GetAnthropicAPIVersion(model string) string

GetAnthropicAPIVersion retorna a versão da API para Anthropic (Claude), priorizando meta.APIVersion; se não houver, retorna o default configurado.

func GetDisplayName

func GetDisplayName(provider, model string) string

GetDisplayName tenta retornar um nome amigável a partir do registry. Se não houver match, retorna o próprio model ID.

func GetMaxTokens

func GetMaxTokens(provider, model string, override int) int

GetMaxTokens sugere maxTokens com prioridade: 1) override > 0 2) registry.MaxOutputTokens (se disponível) 3) fallback conservador por provedor/modelo

func HasCapability

func HasCapability(provider, model, capability string) bool

HasCapability verifica se o modelo anuncia determinada capacidade (best-effort).

Types

type ModelMeta

type ModelMeta struct {
	ID              string       // ID oficial ou base
	Aliases         []string     // apelidos/variações aceitas (prefixos, variantes com datas)
	DisplayName     string       // Nome legível para UI
	Provider        string       // OPENAI, CLAUDEAI, etc.
	ContextWindow   int          // tokens de contexto (se conhecido; usar valor conservador caso contrário)
	MaxOutputTokens int          // limite recomendado de output (para chunking/limites)
	PreferredAPI    PreferredAPI // API preferida
	APIVersion      string       // versão de API (Anthropic), se aplicável
	Capabilities    []string     // ex.: ["tools","vision","json_mode"]
}

ModelMeta guarda metadados estáticos e seguros

func ListAll

func ListAll() []ModelMeta

Lista (best-effort) de todos ModelMeta cadastrados (pode ser útil para debug).

func Resolve

func Resolve(provider, model string) (ModelMeta, bool)

Resolve procura metadados por provedor e string de modelo (case-insensitive), aceitando match exato, por prefixo ou por aliases.

type PreferredAPI

type PreferredAPI string

PreferredAPI define qual API é preferida para o modelo - "chat_completions": OpenAI Chat Completions - "responses": OpenAI Responses API - "assistants": OpenAI Assistants API - "anthropic_messages": Anthropic Messages API

const (
	APIChatCompletions   PreferredAPI = "chat_completions"
	APIResponses         PreferredAPI = "responses"
	APIAssistants        PreferredAPI = "assistants"
	APIAnthropicMessages PreferredAPI = "anthropic_messages"
)

func GetPreferredAPI

func GetPreferredAPI(provider, model string) PreferredAPI

GetPreferredAPI expõe a API preferida (para uso futuro na Parte 3).