mirror of
https://github.com/agent0ai/agent-zero.git
synced 2026-07-14 19:38:29 +00:00
Add comprehensive file-level DOX documentation across the repo and update directory AGENTS.md indexes. Many new `*.py.dox.md` files were added under api, helpers, tools, plugins, extensions, webui, and other dirs to document endpoint purpose, ownership, runtime contracts, work guidance, and verification. Several AGENTS.md files were created or updated (agents profiles, api, docker, extensions, helpers, plugins, skills, webui components, etc.) to list child DOX files and clarify documentation/work guidance. Also add example and bundled profile DOX files (agent0, default, developer, hacker, researcher) and minor updates to helpers/dirty_json.py and its tests. These changes improve on-disk documentation coverage and establish the convention that each direct runtime file should have a matching `*.dox.md` describing its contracts and verification steps.
1.1 KiB
1.1 KiB
Model Configuration Plugin DOX
Purpose
- Own LLM model selection, presets, API-key checks, scoped overrides, and model settings UI.
Ownership
helpers/model_config.pyowns config resolution, presets, overrides, and runtime model object construction.api/owns model config, override, preset, search, and API-key endpoints.webui/owns model settings, summaries, switcher, and API-key UI.default_config.yaml,default_presets.yaml,provider_metadata.yaml,hooks.py, andplugin.yamlown defaults, metadata, hooks, and manifest.
Local Contracts
- Preserve global, project, agent, and chat override resolution order.
- Keep provider metadata and API-key checks safe around secrets.
- Coordinate OAuth-backed providers with
_oauthinstead of hardcoding provider-specific auth here.
Work Guidance
- Keep backend model config shape and frontend settings fields synchronized.
Verification
- Run model-config and onboarding-related tests when model provider, preset, or API-key behavior changes.
Child DOX Index
No child DOX files.