Agent Zero AI framework
Add result extension point and migrate repeat handling
linklitifd30f33d52b9
diff --git a/agent.py b/agent.pyindex 62beb8bc1..d88e681ae 100644--- a/agent.py+++ b/agent.py@@ -491,40 +491,27 @@ class Agent:await self.handle_intervention(agent_response)- if (- self.loop_data.last_response == agent_response- ): # if assistant_response is the same as last message in history, let him know- # Append the assistant's response to the history- log_item = self.loop_data.params_temporary.get("log_item_generating")- assistant_message = self.hist_add_ai_response(- agent_response,- id=log_item.id if log_item else "",- llm_result=llm_result,- )- self._remember_llm_result_state(llm_result, assistant_message)- # Append warning message to the history- warning_msg = self.read_prompt("fw.msg_repeat.md")- wmsg = self.hist_add_warning(message=warning_msg)- PrintStyle(font_color="orange", padding=True).print(- warning_msg- )- self.context.log.log(type="warning", content=warning_msg, id=wmsg.id)-- else: # otherwise proceed with tool- # Append the assistant's response to the history- log_item = self.loop_data.params_temporary.get("log_item_generating")- assistant_message = self.hist_add_ai_response(- agent_response,- id=log_item.id if log_item else "",- llm_result=llm_result,- )- self._remember_llm_result_state(llm_result, assistant_message)- # process tools requested in agent message- tools_result = await self.process_llm_result_tools(- llm_result- )- if tools_result: # final response of message loop available- return tools_result # break the execution if the task is done+ result_data = {"llm_result": llm_result}+ await extension.call_extensions_async(+ "message_loop_result",+ self,+ loop_data=self.loop_data,+ result_data=result_data,+ )+ if result_data.get("skip_default_processing"):+ continue++ agent_response = llm_result.response+ log_item = self.loop_data.params_temporary.get("log_item_generating")+ assistant_message = self.hist_add_ai_response(+ agent_response,+ id=log_item.id if log_item else "",+ llm_result=llm_result,+ )+ self._remember_llm_result_state(llm_result, assistant_message)+ tools_result = await self.process_llm_result_tools(llm_result)+ if tools_result: # final response of message loop available+ return tools_result # break the execution if the task is done# exceptions inside message loop:except Exception as e:diff --git a/extensions/python/AGENTS.md b/extensions/python/AGENTS.mdindex ec66eb1ab..5138c919c 100644--- a/extensions/python/AGENTS.md+++ b/extensions/python/AGENTS.md@@ -44,6 +44,7 @@ Direct child DOX files:| [hist_add_tool_result/AGENTS.md](hist_add_tool_result/AGENTS.md) | Tool-result history side effects. || [job_loop/AGENTS.md](job_loop/AGENTS.md) | Periodic backend maintenance jobs. || [message_loop_end/AGENTS.md](message_loop_end/AGENTS.md) | End-of-message-loop history and persistence behavior. |+| [message_loop_result/AGENTS.md](message_loop_result/AGENTS.md) | Completed model-result normalization and default-processing interception. || [message_loop_prompts_after/AGENTS.md](message_loop_prompts_after/AGENTS.md) | Prompt protocol and extras assembled around message-loop prompt construction. || [message_loop_prompts_before/AGENTS.md](message_loop_prompts_before/AGENTS.md) | Pre-prompt-construction message-loop gates. || [message_loop_start/AGENTS.md](message_loop_start/AGENTS.md) | Start-of-message-loop iteration state. |diff --git a/extensions/python/_functions/agent/Agent/hist_add_warning/end/_90_stop_unusable_response_loop.py b/extensions/python/_functions/agent/Agent/hist_add_warning/end/_90_stop_unusable_response_loop.pyindex 2c44a910c..87670a273 100644--- a/extensions/python/_functions/agent/Agent/hist_add_warning/end/_90_stop_unusable_response_loop.py+++ b/extensions/python/_functions/agent/Agent/hist_add_warning/end/_90_stop_unusable_response_loop.py@@ -22,6 +22,7 @@ class StopUnusableResponseLoop(Extension):if message not in {self.agent.read_prompt("fw.msg_misformat.md"),self.agent.read_prompt("fw.msg_repeat.md"),+ self.agent.read_prompt("fw.msg_empty_response.md"),}:returndiff --git a/extensions/python/message_loop_result/AGENTS.md b/extensions/python/message_loop_result/AGENTS.mdnew file mode 100644index 000000000..e043366a0--- /dev/null+++ b/extensions/python/message_loop_result/AGENTS.md@@ -0,0 +1,28 @@+# Message Loop Result Extensions DOX++## Purpose++- Own normalization and policy handling after a model turn completes, before default assistant-history and tool-dispatch processing.++## Ownership++- Extensions receive mutable `result_data` with `llm_result` and may set `skip_default_processing` after fully handling the turn.++## Local Contracts++- Files run in deterministic filename order.+- A handler that sets `skip_default_processing` owns needed history and UI side effects for that turn.+- Do not use this point to mutate streamed partial content.++## Work Guidance++- Normalize a completed result before policy extensions compare or persist it.+- Keep loop-control policy independent from optional plugins.++## Verification++- Run message-loop and unusable-response regression tests.++## Child DOX Index++No child DOX files.diff --git a/extensions/python/message_loop_result/_20_loop_control.py b/extensions/python/message_loop_result/_20_loop_control.pynew file mode 100644index 000000000..b3f68fcc3--- /dev/null+++ b/extensions/python/message_loop_result/_20_loop_control.py@@ -0,0 +1,43 @@+"""Handle completed model turns that should retry instead of dispatching tools."""++from __future__ import annotations++from typing import Any++from helpers.extension import Extension+from helpers.print_style import PrintStyle+++class LoopControl(Extension):+ 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", "")+ reasoning = getattr(llm_result, "reasoning", "")+ if not isinstance(response, str) or not isinstance(reasoning, str):+ return++ if not response.strip():+ if reasoning.strip():+ return+ warning = self.agent.read_prompt("fw.msg_empty_response.md")+ elif response != self.agent.loop_data.last_response:+ return+ else:+ warning = self.agent.read_prompt("fw.msg_repeat.md")++ log_item = self.agent.loop_data.params_temporary.get("log_item_generating")+ assistant_message = self.agent.hist_add_ai_response(+ response,+ id=log_item.id if log_item else "",+ llm_result=llm_result,+ )+ self.agent._remember_llm_result_state(llm_result, assistant_message)+ warning_message = self.agent.hist_add_warning(message=warning)+ PrintStyle(font_color="orange", padding=True).print(warning)+ self.agent.context.log.log(+ type="warning", content=warning, id=warning_message.id+ )+ result_data["skip_default_processing"] = Truediff --git a/prompts/fw.msg_empty_response.md b/prompts/fw.msg_empty_response.mdnew file mode 100644index 000000000..2fa6d55b2--- /dev/null+++ b/prompts/fw.msg_empty_response.md@@ -0,0 +1 @@+Model returned an empty response (no reasoning, no content).diff --git a/tests/test_message_loop_result.py b/tests/test_message_loop_result.pynew file mode 100644index 000000000..23d056db9--- /dev/null+++ b/tests/test_message_loop_result.py@@ -0,0 +1,63 @@+from types import SimpleNamespace++from extensions.python.message_loop_result._20_loop_control import LoopControl+++class FakeAgent:+ def __init__(self, response: str, reasoning: str = "", last_response: str = ""):+ self.loop_data = SimpleNamespace(+ last_response=last_response,+ params_temporary={},+ )+ self.context = SimpleNamespace(log=SimpleNamespace(log=lambda **kwargs: None))+ self.response = response+ self.reasoning = reasoning+ self.warnings = []+ self.history = []++ def read_prompt(self, name):+ return {+ "fw.msg_empty_response.md": "empty",+ "fw.msg_repeat.md": "repeat",+ }[name]++ def hist_add_ai_response(self, response, **kwargs):+ self.history.append(response)+ return SimpleNamespace(id="assistant")++ def _remember_llm_result_state(self, *args):+ pass++ def hist_add_warning(self, message):+ self.warnings.append(message)+ return SimpleNamespace(id="warning")+++def _run(agent):+ result_data = {+ "llm_result": SimpleNamespace(response=agent.response, reasoning=agent.reasoning)+ }+ LoopControl(agent).execute(result_data)+ return result_data+++def test_empty_result_skips_default_processing():+ agent = FakeAgent("")++ assert _run(agent)["skip_default_processing"] is True+ assert agent.history == [""]+ assert agent.warnings == ["empty"]+++def test_repeat_skips_default_processing():+ agent = FakeAgent('{"tool_name":"response"}', last_response='{"tool_name":"response"}')++ assert _run(agent)["skip_default_processing"] is True+ assert agent.warnings == ["repeat"]+++def test_result_with_reasoning_uses_default_processing():+ agent = FakeAgent("", reasoning="thinking")++ assert "skip_default_processing" not in _run(agent)+ assert agent.history == []diff --git a/tests/test_unusable_response_loop.py b/tests/test_unusable_response_loop.pyindex c170f9d9b..6c0343387 100644--- a/tests/test_unusable_response_loop.py+++ b/tests/test_unusable_response_loop.py@@ -21,6 +21,7 @@ def _agent():prompts = {"fw.msg_misformat.md": "misformatted","fw.msg_repeat.md": "repeated",+ "fw.msg_empty_response.md": "empty response",}def read_prompt(name, **kwargs):@@ -53,7 +54,7 @@ def test_stops_at_configured_failure_limit(monkeypatch):assert _run(extension, agent, "misformatted")["exception"] is Noneagent.loop_data.iteration = 1- assert _run(extension, agent, "repeated")["exception"] is None+ assert _run(extension, agent, "empty response")["exception"] is Noneagent.loop_data.iteration = 2data = _run(extension, agent, "repeated")