avatar.config

Harness configuration.

Loaded from defaults, then overridden by environment variables (prefix AVATAR_) or a local .env. This is the single, explicit config object threaded through RunDeps (§8) — never read from globals.

Classes

HarnessConfig

The single, explicit run configuration: budgets, session, workspace, endpoint (§8).

HarnessConfig(_case_sensitive: 'bool | None' = None, _nested_model_default_partial_update: 'bool | None' = None, _env_prefix: 'str | None' = None, _env_prefix_target: 'EnvPrefixTarget | None' = None, _env_file: 'DotenvType | None' = PosixPath('.'), _env_file_encoding: 'str | None' = None, _env_ignore_empty: 'bool | None' = None, _env_nested_delimiter: 'str | None' = None, _env_nested_max_split: 'int | None' = None, _env_parse_none_str: 'str | None' = None, _env_parse_enums: 'bool | None' = None, _cli_prog_name: 'str | None' = None, _cli_parse_args: 'bool | list[str] | tuple[str, ...] | None' = None, _cli_settings_source: 'CliSettingsSource[Any] | None' = None, _cli_parse_none_str: 'str | None' = None, _cli_hide_none_type: 'bool | None' = None, _cli_avoid_json: 'bool | None' = None, _cli_enforce_required: 'bool | None' = None, _cli_use_class_docs_for_groups: 'bool | None' = None, _cli_exit_on_error: 'bool | None' = None, _cli_prefix: 'str | None' = None, _cli_flag_prefix_char: 'str | None' = None, _cli_implicit_flags: "bool | Literal['dual', 'toggle'] | None" = None, _cli_ignore_unknown_args: 'bool | None' = None, _cli_kebab_case: "bool | Literal['all', 'no_enums'] | None" = None, _cli_shortcuts: 'Mapping[str, str | list[str]] | None' = None, _secrets_dir: 'PathType | None' = None, _build_sources: 'tuple[tuple[PydanticBaseSettingsSource, ...], dict[str, Any]] | None' = None, *, max_iterations: int = 50, max_wall_clock_seconds: int | None = 1800, max_consecutive_failures: int = 5, max_repair_attempts: int = 3, max_context_tokens: int = 100000, max_declaration_nudges: int = 3, approval_timeout_seconds: float | None = None, autonomous_amendment_policy: Literal['deny', 'approve'] = 'deny', autonomous_escalation_policy: Literal['deny', 'approve'] = 'deny', escalation_thrash_repeats: Annotated[int, Ge(ge=1)] = 3, test_command: str = '', lint_command: str = '', command_timeout_seconds: int = 120, request_timeout_seconds: Annotated[float, Gt(gt=0)] = 0, request_idle_timeout_seconds: Annotated[float, Gt(gt=0)] = 0, stream_model_calls: bool = True, transport_max_retries: Annotated[int, Ge(ge=0)] = 2, command_output_budget: Annotated[int, Ge(ge=256)] = 16000, planner_model: str | None = None, interactive: bool = True, log_path: str | None = None, workspace_root: str = '.', sandbox_mode: Literal['none', 'hermetic-env', 'sandbox-exec', 'bwrap', 'container'] = 'hermetic-env', sandbox_allow_network: bool = False, sandbox_rlimits: bool = False, sandbox_image: str = '', sandbox_container_runtime: Literal['podman', 'docker'] = 'podman', sensitive_path_globs: list[str] = <factory>, model: str = 'openai/gpt-4o-mini', base_url: str = 'https://ai/api/v1', api_key: str | None = None, native_tool_calls: bool = True, temperature: float = 0, context_max_detail_chars: int = 16000, context_detail_char_budget: int = 48000, context_verifier_pin_count: int = 2, classifier_model: str | None = 'openai/gpt-5-nano') -> None

Fields

Field	Type	Required
max_iterations	int	no
max_wall_clock_seconds	`int	None`	no
max_consecutive_failures	int	no
max_repair_attempts	int	no
max_context_tokens	int	no
max_declaration_nudges	int	no
approval_timeout_seconds	`float	None`	no
autonomous_amendment_policy	Literal['deny', 'approve']	no
autonomous_escalation_policy	Literal['deny', 'approve']	no
escalation_thrash_repeats	int	no
test_command	str	no
lint_command	str	no
command_timeout_seconds	int	no
request_timeout_seconds	float	no
request_idle_timeout_seconds	float	no
stream_model_calls	bool	no
transport_max_retries	int	no
command_output_budget	int	no
planner_model	`str	None`	no
interactive	bool	no
log_path	`str	None`	no
workspace_root	str	no
sandbox_mode	Literal['none', 'hermetic-env', 'sandbox-exec', 'bwrap', 'container']	no
sandbox_allow_network	bool	no
sandbox_rlimits	bool	no
sandbox_image	str	no
sandbox_container_runtime	Literal['podman', 'docker']	no
sensitive_path_globs	list[str]	no
model	str	no
base_url	str	no
api_key	`str	None`	no
native_tool_calls	bool	no
temperature	float	no
context_max_detail_chars	int	no
context_detail_char_budget	int	no
context_verifier_pin_count	int	no
classifier_model	`str	None`	no