Skip to content

Agent Zero AI framework

Add result extension point and migrate repeat handling

linklitifd30f33d52b9
diff --git a/agent.py b/agent.py
index 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.md
index 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.py
index 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"),
}:
return
diff --git a/extensions/python/message_loop_result/AGENTS.md b/extensions/python/message_loop_result/AGENTS.md
new file mode 100644
index 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.py
new file mode 100644
index 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"] = True
diff --git a/prompts/fw.msg_empty_response.md b/prompts/fw.msg_empty_response.md
new file mode 100644
index 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.py
new file mode 100644
index 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.py
index 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 None
agent.loop_data.iteration = 1
- assert _run(extension, agent, "repeated")["exception"] is None
+ assert _run(extension, agent, "empty response")["exception"] is None
agent.loop_data.iteration = 2
data = _run(extension, agent, "repeated")