Agent Zero AI framework
Add Context Doctor plugin
linklitidac39537c9e5
diff --git a/plugins/AGENTS.md b/plugins/AGENTS.mdindex ddc1cf8b4..d206d4fae 100644--- a/plugins/AGENTS.md+++ b/plugins/AGENTS.md@@ -75,6 +75,7 @@ Direct child DOX files:| [_chat_compaction/AGENTS.md](_chat_compaction/AGENTS.md) | Full-chat compaction into a summary message. || [_chat_naming/AGENTS.md](_chat_naming/AGENTS.md) | Built-in manual and Utility Model-assisted chat naming. || [_commands/AGENTS.md](_commands/AGENTS.md) | Built-in slash command manager, command file discovery, and chat composer slash picker. |+| [_context_doctor/AGENTS.md](_context_doctor/AGENTS.md) | Tool-call JSON repair and compact persistence before default dispatch. || [_context_window/AGENTS.md](_context_window/AGENTS.md) | Context-window token accounting, API, composer indicator, and visibility control. || [_code_execution/AGENTS.md](_code_execution/AGENTS.md) | Terminal, Python, and Node.js execution tools and shell runtimes. || [_desktop/AGENTS.md](_desktop/AGENTS.md) | Linux desktop runtime, sessions, and desktop surface. |diff --git a/plugins/_context_doctor/AGENTS.md b/plugins/_context_doctor/AGENTS.mdnew file mode 100644index 000000000..e287e37fe--- /dev/null+++ b/plugins/_context_doctor/AGENTS.md@@ -0,0 +1,30 @@+# Context Doctor Plugin DOX++## Purpose++- Repair malformed Agent Zero tool-call JSON and persist compact repaired output.++## Ownership++- `helpers/context_doctor.py` validates and repairs tool-call JSON.+- `extensions/python/message_loop_result/` normalizes completed model output before default processing.+- `webui/config.html` exposes XML-output suppression only.++## Local Contracts++- Repaired tool-call JSON is always minified.+- Invalid non-tool output is unchanged; native processing retains ownership.+- Do not write settings that alter repair mode or log content.++## Work Guidance++- Keep repair scoped to complete tool-call JSON.+- Use framework-installed `json_repair`; apply the plugin-local parser patch before repair. Do not vendor dependencies.++## Verification++- Run `pytest plugins/_context_doctor/tests`.++## Child DOX Index++No child DOX files.diff --git a/plugins/_context_doctor/README.md b/plugins/_context_doctor/README.mdnew file mode 100644index 000000000..5ae705be2--- /dev/null+++ b/plugins/_context_doctor/README.md@@ -0,0 +1,10 @@+# Context Doctor++Repairs model tool call JSON before sending it to history and tool processing.++## Behavior++- Uses `json_repair` after native parsing has completed.+- Accepts only complete Agent Zero tool calls (`tool_name` and object `tool_args`).+- Stores and displays repaired tool calls as compact JSON.+- Optionally replaces XML-like output with `{}` in cases where model uses native XML tool calls.diff --git a/plugins/_context_doctor/default_config.yaml b/plugins/_context_doctor/default_config.yamlnew file mode 100644index 000000000..aa5543214--- /dev/null+++ b/plugins/_context_doctor/default_config.yaml@@ -0,0 +1,2 @@+update_log: false+suppress_xml: truediff --git a/plugins/_context_doctor/extensions/python/message_loop_result/_10_context_doctor.py b/plugins/_context_doctor/extensions/python/message_loop_result/_10_context_doctor.pynew file mode 100644index 000000000..902efcb01--- /dev/null+++ b/plugins/_context_doctor/extensions/python/message_loop_result/_10_context_doctor.py@@ -0,0 +1,34 @@+"""Repair and minify model tool-call JSON before default processing."""++from __future__ import annotations++from typing import Any, override++from helpers.extension import Extension+from helpers.plugins import get_plugin_config+from plugins._context_doctor.helpers.context_doctor import repair_and_minify, update_log_item+++class ContextDoctor(Extension):+ @override+ def execute(self, result_data: dict[str, Any] | None = None, **kwargs: Any) -> None:+ if not self.agent or not isinstance(result_data, dict):+ return++ llm_result = result_data.get("llm_result")+ response = getattr(llm_result, "response", None)+ if not isinstance(response, str):+ return++ config = get_plugin_config("_context_doctor", agent=self.agent) or {}+ repaired = repair_and_minify(+ response, suppress_xml=config.get("suppress_xml", True)+ )+ if repaired is None:+ return++ llm_result.response = repaired+ params = getattr(getattr(self.agent, "loop_data", None), "params_temporary", None)+ log_item = params.get("log_item_generating") if isinstance(params, dict) else None+ if log_item is not None and config.get("update_log", False):+ update_log_item(self.agent, log_item, repaired)diff --git a/plugins/_context_doctor/helpers/context_doctor.py b/plugins/_context_doctor/helpers/context_doctor.pynew file mode 100644index 000000000..cc09ccd0d--- /dev/null+++ b/plugins/_context_doctor/helpers/context_doctor.py@@ -0,0 +1,59 @@+"""Repair complete Agent Zero tool-call JSON into compact JSON."""++from __future__ import annotations++import json+from typing import Any+++def _is_tool_call(value: Any) -> bool:+ return (+ isinstance(value, dict)+ and isinstance(value.get("tool_name"), str)+ and isinstance(value.get("tool_args"), dict)+ and (+ "thoughts" not in value+ or (+ isinstance(value["thoughts"], list)+ and all(isinstance(item, str) for item in value["thoughts"])+ )+ )+ and ("headline" not in value or isinstance(value["headline"], str))+ )+++def repair_and_minify(response: str, *, suppress_xml: bool) -> str | None:+ """Return compact tool-call JSON, XML fallback, or ``None`` for other output."""+ if not response:+ return None++ try:+ from plugins._context_doctor.helpers.json_repair_patch import apply_patch+ from json_repair import repair_json++ apply_patch()+ repaired = repair_json(response, return_objects=True)+ except Exception:+ return "{}" if suppress_xml and "<" in response and ">" in response else None++ if isinstance(repaired, list):+ repaired = next((item for item in repaired if _is_tool_call(item)), None)+ if _is_tool_call(repaired):+ return json.dumps(repaired, ensure_ascii=False, separators=(",", ":"))+ return "{}" if suppress_xml and "<" in response and ">" in response else None+++def update_log_item(agent: Any, log_item: Any, response: str) -> None:+ """Replace final log details with repaired JSON and derived display fields."""+ try:+ parsed = json.loads(response)+ if not _is_tool_call(parsed):+ return+ heading = parsed.get("headline") or f"Using {parsed['tool_name']}"+ log_item.update(+ content=response,+ kvps=parsed,+ heading=f"{getattr(agent, 'agent_name', 'A0')}: {heading}",+ )+ except (AttributeError, TypeError, ValueError):+ passdiff --git a/plugins/_context_doctor/helpers/json_repair_patch.py b/plugins/_context_doctor/helpers/json_repair_patch.pynew file mode 100644index 000000000..2b996a1da--- /dev/null+++ b/plugins/_context_doctor/helpers/json_repair_patch.py@@ -0,0 +1,182 @@+"""Monkeypatch installed json_repair classify_object_value_comma.++Guards all 4 classification paths against false member-boundary detection+when unescaped quotes, backtick+colon patterns, or timestamp injections+appear inside string values.++Safe assumptions for A0 tool_args keys:+- Letters and underscore only (no digits, hyphens, or other symbols)+- Length <= 24 characters++TODO: Replace with checks against actual tool schemas+"""++from __future__ import annotations++from typing import TYPE_CHECKING++if TYPE_CHECKING:+ from collections.abc import Callable++ from json_repair.json_parser import JSONParser++_MAX_KEY_LENGTH = 24+++def _load_string_delimiters() -> tuple[str, ...]:+ try:+ from json_repair.utils.constants import STRING_DELIMITERS++ return tuple(STRING_DELIMITERS)+ except Exception:+ return ('"', "'")+++STRING_DELIMITERS_CACHE: tuple[str, ...] = _load_string_delimiters()+++def _has_four_consecutive_digits(text: str) -> bool:+ count = 0+ for char in text:+ if char.isdigit():+ count += 1+ if count >= 4:+ return True+ else:+ count = 0+ return False+++def _key_text_is_plausible(parser: JSONParser, key_start: int, key_end: int) -> bool:+ if key_end - key_start > _MAX_KEY_LENGTH:+ return False+ text = parser.json_str[key_start:key_end]+ if "\n" in text:+ return False+ if _has_four_consecutive_digits(text):+ return False+ return True+++def _colon_follows(parser: JSONParser, idx: int) -> bool:+ return parser.get_char_at(parser.scroll_whitespaces(idx=idx)) == ":"+++def _has_recoverable_value(+ parser: JSONParser,+ value_start: int,+ skip_to_character: Callable[[str | list[str], int], int],+) -> bool:+ """Delegate to original _bare_member_has_recoverable_value, but at EOF treat+ as recoverable only when stream_stable=False (default streaming mode)."""+ from json_repair.parse_string_helpers.object_value_context import (+ _bare_member_has_recoverable_value,+ )++ if _bare_member_has_recoverable_value(parser, value_start, skip_to_character):+ return True+ # Original returns False at EOF; override for streaming mode+ value_start_idx = parser.scroll_whitespaces(idx=value_start)+ value_end_idx = skip_to_character([*STRING_DELIMITERS_CACHE, "}"], value_start_idx)+ if parser.get_char_at(value_end_idx) is None:+ return not parser.stream_stable+ return False+++def _patched_classify_object_value_comma(+ parser: JSONParser,+ cached_skip_to_character: Callable[[str | list[str], int], int] | None = None,+) -> str:+ from json_repair.utils.constants import STRING_DELIMITERS++ skip_to_character = cached_skip_to_character or parser.skip_to_character+ next_idx = parser.scroll_whitespaces(idx=1)+ next_c = parser.get_char_at(next_idx)+ if next_c in ["}", None]:+ return "member"++ # Quoted key+ if next_c in STRING_DELIMITERS:+ key_end_idx = parser.skip_to_character(character=next_c, idx=next_idx + 1)+ if not parser.get_char_at(key_end_idx):+ return "string"+ abs_start = parser.index + next_idx + 1+ abs_end = parser.index + key_end_idx+ if _key_text_is_plausible(parser, abs_start, abs_end) and _colon_follows(+ parser, key_end_idx + 1+ ):+ return "member"+ return "string"++ # Backtick key+ if next_c == "`":+ bare_key_idx = next_idx + 1+ while True:+ key_char = parser.get_char_at(bare_key_idx)+ if not key_char or not (key_char.isalnum() or key_char in ["_", "-"]):+ break+ bare_key_idx += 1+ abs_start = parser.index + next_idx + 1+ abs_end = parser.index + bare_key_idx+ if (+ _key_text_is_plausible(parser, abs_start, abs_end)+ and _colon_follows(parser, bare_key_idx)+ and _has_recoverable_value(parser, bare_key_idx + 1, skip_to_character)+ ):+ return "member"+ return "string"++ # Bare alnum/underscore key+ if next_c and (next_c.isalnum() or next_c == "_"):+ bare_key_idx = next_idx+ while True:+ key_char = parser.get_char_at(bare_key_idx)+ if not key_char or not (key_char.isalnum() or key_char in ["_", "-"]):+ break+ bare_key_idx += 1+ abs_start = parser.index + next_idx+ abs_end = parser.index + bare_key_idx+ if (+ _key_text_is_plausible(parser, abs_start, abs_end)+ and _colon_follows(parser, bare_key_idx)+ and _has_recoverable_value(parser, bare_key_idx + 1, skip_to_character)+ ):+ return "member"++ if next_c in ["{", "["]:+ return "container"++ # Fallback: skip to next string delimiter+ next_special_idx = skip_to_character([*STRING_DELIMITERS, "{", "["], next_idx)+ next_special = parser.get_char_at(next_special_idx)+ if not next_special:+ return "string_no_future_delimiter"+ if next_special in ["{", "["]:+ return "string"++ key_end_idx = skip_to_character(next_special, next_special_idx + 1)+ if not parser.get_char_at(key_end_idx):+ return "string"+ abs_start = parser.index + next_special_idx + 1+ abs_end = parser.index + key_end_idx+ if _key_text_is_plausible(parser, abs_start, abs_end) and _colon_follows(+ parser, key_end_idx + 1+ ):+ return "member"+ return "string"+++_applied = False+++def apply_patch() -> None:+ global _applied+ if _applied:+ return++ from json_repair.parse_string_helpers import object_value_context as ovc+ from json_repair import parse_string as ps++ ovc.classify_object_value_comma = _patched_classify_object_value_comma+ ps.classify_object_value_comma = _patched_classify_object_value_comma+ _applied = Truediff --git a/plugins/_context_doctor/plugin.yaml b/plugins/_context_doctor/plugin.yamlnew file mode 100644index 000000000..e05e6ae65--- /dev/null+++ b/plugins/_context_doctor/plugin.yaml@@ -0,0 +1,7 @@+name: _context_doctor+title: Context Doctor+description: Repairs model tool call JSON before sending it to history and tool processing.+version: 2.0.0+settings_sections: []+per_project_config: true+per_agent_config: truediff --git a/plugins/_context_doctor/tests/conftest.py b/plugins/_context_doctor/tests/conftest.pynew file mode 100644index 000000000..4ed02237f--- /dev/null+++ b/plugins/_context_doctor/tests/conftest.py@@ -0,0 +1,19 @@+from __future__ import annotations++from unittest.mock import patch++import pytest++_DEFAULT_CONFIG = {+ "update_log": False,+ "suppress_xml": True,+}++[email protected](autouse=True)+def _mock_plugin_config():+ with patch(+ "helpers.plugins.get_plugin_config",+ return_value=_DEFAULT_CONFIG,+ ):+ yielddiff --git a/plugins/_context_doctor/tests/test_context_doctor.py b/plugins/_context_doctor/tests/test_context_doctor.pynew file mode 100644index 000000000..bddee63f9--- /dev/null+++ b/plugins/_context_doctor/tests/test_context_doctor.py@@ -0,0 +1,78 @@+from types import SimpleNamespace++from plugins._context_doctor.helpers.context_doctor import repair_and_minify, update_log_item+from plugins._context_doctor.extensions.python.message_loop_result._10_context_doctor import (+ ContextDoctor,+)+++def test_repairs_and_minifies_tool_call():+ response = '{"tool_name":"response","tool_args":{"text":"ok",},}'++ assert repair_and_minify(response, suppress_xml=True) == (+ '{"tool_name":"response","tool_args":{"text":"ok"}}'+ )+++def test_ignores_non_tool_json():+ assert repair_and_minify('{"message":"ok"}', suppress_xml=True) is None+++def test_suppresses_xml_when_enabled():+ assert repair_and_minify('<tool>response</tool>', suppress_xml=True) == "{}"+ assert repair_and_minify('<tool>response</tool>', suppress_xml=False) is None+++def test_extension_replaces_completed_result(monkeypatch):+ monkeypatch.setattr(+ "plugins._context_doctor.extensions.python.message_loop_result._10_context_doctor.get_plugin_config",+ lambda *args, **kwargs: {"suppress_xml": True},+ )+ llm_result = SimpleNamespace(+ response='{"tool_name":"response","tool_args":{"text":"ok",},}'+ )+ agent = SimpleNamespace(loop_data=SimpleNamespace(params_temporary={}))++ ContextDoctor(agent).execute({"llm_result": llm_result})++ assert llm_result.response == '{"tool_name":"response","tool_args":{"text":"ok"}}'+++def test_updates_log_with_repaired_tool_call():+ log_item = SimpleNamespace(update=lambda **kwargs: setattr(log_item, "data", kwargs))++ update_log_item(+ SimpleNamespace(agent_name="A0"),+ log_item,+ '{"headline":"Done","tool_name":"response","tool_args":{"text":"ok"}}',+ )++ assert log_item.data["content"] == (+ '{"headline":"Done","tool_name":"response","tool_args":{"text":"ok"}}'+ )+ assert log_item.data["heading"] == "A0: Done"+++def test_extension_updates_log_only_when_enabled(monkeypatch):+ llm_result = SimpleNamespace(+ response='{"tool_name":"response","tool_args":{"text":"ok",},}'+ )+ log_item = SimpleNamespace(update=lambda **kwargs: setattr(log_item, "data", kwargs))+ agent = SimpleNamespace(+ agent_name="A0",+ loop_data=SimpleNamespace(params_temporary={"log_item_generating": log_item}),+ )++ monkeypatch.setattr(+ "plugins._context_doctor.extensions.python.message_loop_result._10_context_doctor.get_plugin_config",+ lambda *args, **kwargs: {"suppress_xml": True, "update_log": False},+ )+ ContextDoctor(agent).execute({"llm_result": llm_result})+ assert not hasattr(log_item, "data")++ monkeypatch.setattr(+ "plugins._context_doctor.extensions.python.message_loop_result._10_context_doctor.get_plugin_config",+ lambda *args, **kwargs: {"suppress_xml": True, "update_log": True},+ )+ ContextDoctor(agent).execute({"llm_result": llm_result})+ assert log_item.data["content"] == llm_result.responsediff --git a/plugins/_context_doctor/webui/config.html b/plugins/_context_doctor/webui/config.htmlnew file mode 100644index 000000000..14328e3f6--- /dev/null+++ b/plugins/_context_doctor/webui/config.html@@ -0,0 +1,45 @@+<html>+ <head>+ <title>Context Doctor Settings</title>+ </head>+ <body>+ <div x-data>+ <template x-if="config">+ <div>+ <div class="section-title">Context Doctor</div>+ <div class="section">+ <div class="section-title">Debug</div>+ <div class="field">+ <div class="field-label">+ <div class="field-title">Update log content</div>+ <div class="field-description">+ Replace the View Details content shown in the WebUI log with repaired JSON instead of model response.+ </div>+ </div>+ <div class="field-control">+ <label class="toggle">+ <input type="checkbox" x-model="config.update_log" />+ <span class="toggler"></span>+ </label>+ </div>+ </div>+ <div class="field">+ <div class="field-label">+ <div class="field-title">Suppress XML output</div>+ <div class="field-description">+ Replace malformed XML-like output without JSON object in cases where model uses native XML tool calls.+ </div>+ </div>+ <div class="field-control">+ <label class="toggle">+ <input type="checkbox" x-model="config.suppress_xml" />+ <span class="toggler"></span>+ </label>+ </div>+ </div>+ </div>+ </div>+ </template>+ </div>+ </body>+</html>diff --git a/plugins/_context_doctor/webui/thumbnail.webp b/plugins/_context_doctor/webui/thumbnail.webpnew file mode 100644index 000000000..c8c803d4eBinary files /dev/null and b/plugins/_context_doctor/webui/thumbnail.webp differdiff --git a/requirements.txt b/requirements.txtindex fb90e1e44..7c3e78fdc 100644--- a/requirements.txt+++ b/requirements.txt@@ -12,6 +12,7 @@ flaredantic==0.1.5GitPython==3.1.43giturlparse==0.14.0inputimeout==1.0.4+json_repair==0.63.3kokoro>=0.9.2simpleeval==1.0.3langchain-core==0.3.49