mirror of
https://github.com/agent0ai/agent-zero.git
synced 2026-10-19 07:23:51 +00:00
51a02bd4f5
Improve code quality of context doctor. Add handling of Reasoning kvps. Bump json_repair version
34 lines
1.4 KiB
Markdown
34 lines
1.4 KiB
Markdown
# Context Doctor Plugin DOX
|
|
|
|
## Purpose
|
|
|
|
- Repair malformed Agent Zero tool-call JSON and preserve raw output as compact thoughts JSON when repair cannot produce a tool call.
|
|
|
|
## Ownership
|
|
|
|
- `helpers/context_doctor.py` transforms output and refreshes log fields.
|
|
- `hooks.py` installs the exact root-pinned repair dependency in the framework runtime.
|
|
- `extensions/python/startup_migration/` prepares that dependency after startup and self-update.
|
|
- `extensions/python/message_loop_result/` normalizes completed model output before default processing.
|
|
- `webui/config.html` exposes XML suppression and log-detail settings.
|
|
|
|
## Local Contracts
|
|
|
|
- Repaired and fallback JSON is always minified.
|
|
- Nonempty non-tool output becomes `{"thoughts":[raw]}`; XML-like output becomes `{}` only when suppression is enabled.
|
|
- Log kvps retain streamed `reasoning` and add transformed output; `update_log` controls only View Details content.
|
|
- A repaired `response` tool call refreshes the response log item when streaming did not create it.
|
|
- Runtime setup reads the `json_repair` pin from root `requirements.txt`; do not duplicate its version in plugin code.
|
|
|
|
## Work Guidance
|
|
|
|
- Keep repair scoped to complete tool-call JSON.
|
|
- Use framework-installed `json_repair`; apply plugin-local parser patch before repair. Do not vendor dependencies.
|
|
|
|
## Verification
|
|
|
|
- Run `pytest plugins/_context_doctor/tests`.
|
|
|
|
## Child DOX Index
|
|
|
|
No child DOX files.
|