Configuration for an agent run.
Built from the options passed to Alloy.run/2. Request inputs can be
updated through Alloy.Agent.State.prepare/2 in middleware.
Summary
Functions
Builds a config from Alloy.run/2 options.
Returns an updated config with a new provider while preserving unrelated options.
Types
@type compaction() :: %{ optional(:summary_system_prompt) => String.t(), optional(:summary_prompt) => String.t(), reserve_tokens: pos_integer(), keep_recent_tokens: pos_integer(), fallback: :truncate, clear_tool_results: boolean(), keep_recent_tool_results: non_neg_integer() }
@type t() :: %Alloy.Agent.Config{ code_execution: boolean(), compaction: compaction(), compaction_explicit: %{ reserve_tokens: boolean(), keep_recent_tokens: boolean() }, context: map(), fallback_providers: [{module(), map()}], max_retries: non_neg_integer(), max_tokens: pos_integer(), max_tokens_explicit?: boolean(), max_turns: pos_integer(), middleware: [module()], model_catalog: module(), model_metadata_overrides: map(), on_compaction: (list(), Alloy.Agent.State.t() -> any()) | nil, provider: module(), provider_config: map(), retry_backoff_ms: pos_integer(), stop_after_tool: String.t() | nil, system_prompt: String.t() | nil, timeout_ms: pos_integer(), tool_concurrency: pos_integer() | nil, tool_timeout: pos_integer(), tool_validation: :required | :schema, tools: [module() | Alloy.Tool.Inline.t()], until_tool: String.t() | nil, working_directory: String.t() }
Functions
Builds a config from Alloy.run/2 options.
Returns an updated config with a new provider while preserving unrelated options.
If max_tokens was not set explicitly, the budget is re-derived from the new
provider model, current model_metadata_overrides, and model_catalog.