Single source of truth for all agent tunables.
Reads user-facing settings from Minga.Config.Options and defines
sensible defaults for internal tunables. No other agent module should
define @default_* constants or call Config.get(:agent_*) directly.
Call resolve/0 once at session or provider init, then thread the
resulting %Config{} through state and function arguments.
Adding a new setting
- Add the field to the struct and
@type t - Add the default value in
defstruct - If user-configurable, register it in
Minga.Config.Optionsand read it inresolve/0 - If internal-only, the struct default is sufficient
Summary
Functions
Returns the default model string (with provider prefix).
Extracts the provider prefix from a model spec string.
Normalizes raw :agent_hooks config declarations into hook structs.
Builds a %Config{} from Options with struct defaults as fallbacks.
Returns the configured model, falling back to the default.
Returns the configured provider, falling back to :auto.
Strips the "provider:" prefix from a model spec string.
Returns a config with agent hooks disabled.
Types
@type t() :: %MingaAgent.Config{ agent_hooks: [MingaAgent.Hooks.Hook.t()], api_base_url: String.t(), api_base_url_override: String.t() | nil, api_endpoints: map() | nil, append_system_prompt: String.t(), approval_timeout_ms: pos_integer(), auto_context: boolean(), compaction_keep_recent: pos_integer(), compaction_threshold: float() | nil, destructive_tools: [String.t()], diff_size_threshold: pos_integer(), max_cost: float() | nil, max_file_size: pos_integer(), max_image_size: pos_integer(), max_mention_candidates: pos_integer(), max_retries: non_neg_integer(), max_tokens: pos_integer(), max_turns: pos_integer(), mcp_servers: [MingaAgent.MCP.ServerConfig.t() | map()], memory_max_tokens: pos_integer(), model: String.t(), models: [String.t()], notifications: boolean(), notify_debounce_ms: pos_integer(), notify_on: [atom()], panel_split: pos_integer(), prompt_cache: boolean(), provider: :auto | :native | String.t(), save_debounce_ms: pos_integer(), session_retention_days: pos_integer(), shell_debounce_ms: pos_integer(), subagent_timeout_ms: pos_integer(), system_prompt: String.t(), tool_approval: :destructive | :all | :none, tool_permissions: map() | nil }
Functions
@spec default_model() :: String.t()
Returns the default model string (with provider prefix).
Extracts the provider prefix from a model spec string.
Returns the provider name, or "" if no prefix is present.
Examples
iex> MingaAgent.Config.extract_provider_prefix("openai_codex:gpt-5.3-codex-spark")
"openai_codex"
iex> MingaAgent.Config.extract_provider_prefix("claude-sonnet-4")
""@spec normalize_hooks(term()) :: [MingaAgent.Hooks.Hook.t()]
Normalizes raw :agent_hooks config declarations into hook structs.
@spec resolve() :: t()
Builds a %Config{} from Options with struct defaults as fallbacks.
Safe to call before the Options ETS table exists (e.g., in tests or standalone usage). When Options is unavailable, all fields use their struct defaults.
@spec resolve_model() :: String.t()
Returns the configured model, falling back to the default.
Safe to call before Config is running (catches exits).
@spec resolve_provider() :: :auto | :native | String.t()
Returns the configured provider, falling back to :auto.
Safe to call before Config is running (catches exits).
Strips the "provider:" prefix from a model spec string.
Returns the bare model name. If there's no prefix, returns the string unchanged.
Examples
iex> MingaAgent.Config.strip_provider_prefix("anthropic:claude-sonnet-4")
"claude-sonnet-4"
iex> MingaAgent.Config.strip_provider_prefix("claude-sonnet-4")
"claude-sonnet-4"Returns a config with agent hooks disabled.