config

func ApplyModelOverrides ¶

func ApplyModelOverrides(cfg *latest.Config, overrides []string) error

ApplyModelOverrides applies CLI model overrides to the configuration

func AutoEmbeddingModelConfigs ¶

func AutoEmbeddingModelConfigs() []latest.ModelConfig

AutoEmbeddingModelConfigs returns the ordered list of embedding-capable models to try when a RAG strategy uses `model: auto` for embeddings.

The priority is:

1. OpenAI -> text-embedding-3-small model
2. DMR -> Google's embeddinggemma model (via Docker Model Runner)

func AutoModelConfig ¶

func AutoModelConfig(ctx context.Context, modelsGateway string, env environment.Provider, defaultModel *latest.ModelConfig) latest.ModelConfig

func AvailableProviders ¶

func AvailableProviders(ctx context.Context, modelsGateway string, env environment.Provider) []string

func BuiltinAgentNames ¶

func BuiltinAgentNames() []string

BuiltinAgentNames returns the names of all built-in agents.

func CheckRequiredEnvVars ¶

func CheckRequiredEnvVars(ctx context.Context, cfg *latest.Config, modelsGateway string, env environment.Provider) error

CheckRequiredEnvVars checks which environment variables are required by the models and tools.

This allows exiting early with a proper error message instead of failing later when trying to use a model or tool.

func GatherEnvVarsForModels ¶

func GatherEnvVarsForModels(cfg *latest.Config) []string

func GatherEnvVarsForTools ¶

func GatherEnvVarsForTools(ctx context.Context, cfg *latest.Config) ([]string, error)

func HooksFromCLI ¶ added in v1.32.5

func HooksFromCLI(preToolUse, postToolUse, sessionStart, sessionEnd, onUserInput []string) *latest.HooksConfig

HooksFromCLI builds a HooksConfig from CLI flag values. Each string is treated as a shell command to run. Empty strings are silently skipped.

func IsExternalReference ¶

func IsExternalReference(input string) bool

IsExternalReference reports whether the input is an external agent reference (OCI image or URL) rather than a local agent name defined in the same config. Local agent names never contain "/", so the slash check distinguishes them from OCI references like "agentcatalog/pirate" or "docker.io/org/agent:v1". It also handles the "name:ref" syntax (e.g. "reviewer:agentcatalog/review-pr").

func IsOCIReference ¶

func IsOCIReference(input string) bool

IsOCIReference checks if the input is a valid OCI reference

func IsURLReference ¶

func IsURLReference(input string) bool

IsURLReference checks if the input is a valid HTTP/HTTPS URL.

func Load ¶

func Load(ctx context.Context, source Source) (*latest.Config, error)

func MergeHooks ¶ added in v1.32.5

func MergeHooks(base, cli *latest.HooksConfig) *latest.HooksConfig

MergeHooks merges CLI hooks into an existing HooksConfig. CLI hooks are appended after any hooks already defined in the config. When both are non-nil and non-empty, a new merged object is returned without mutating either input.

func ParseExternalAgentRef ¶ added in v1.32.5

func ParseExternalAgentRef(input string) (agentName, ref string)

ParseExternalAgentRef parses an external agent reference that may include an explicit name prefix. The syntax is "name:reference" where name is a simple identifier (no slashes) and reference is an OCI reference or URL.

If no explicit name is provided, the base name is derived from the reference:

• OCI refs: last path segment without tag (e.g. "agentcatalog/review-pr" → "review-pr")
• URLs: filename without extension (e.g. "https://example.com/agent.yaml" → "agent")

Examples:

ParseExternalAgentRef("reviewer:agentcatalog/review-pr") → ("reviewer", "agentcatalog/review-pr")
ParseExternalAgentRef("agentcatalog/review-pr") → ("review-pr", "agentcatalog/review-pr")
ParseExternalAgentRef("docker.io/myorg/myagent:v1") → ("myagent", "docker.io/myorg/myagent:v1")
ParseExternalAgentRef("https://example.com/agent.yaml") → ("agent", "https://example.com/agent.yaml")

func PreferredMaxTokens ¶

func PreferredMaxTokens(provider string) *int64

func ResolveAlias ¶

func ResolveAlias(agentFilename string) *userconfig.Alias

ResolveAlias resolves an agent reference and returns the alias if it exists and has options. Returns nil if the reference is not an alias or doesn't have options.

func ResolveModelAliases ¶

func ResolveModelAliases(ctx context.Context, cfg *latest.Config, store *modelsdev.Store)

ResolveModelAliases resolves model aliases to their pinned versions in the config. For example, "claude-sonnet-4-5" might resolve to "claude-sonnet-4-5-20250929". This modifies the config in place.

NOTE: Alias resolution is skipped for models with custom base_url configurations, either set directly on the model or inherited from a custom provider definition. This is necessary because external providers (like Azure Foundry) may use the alias names directly as deployment names rather than the pinned version names.