agent-zero/plugins/_error_retry
frdel f9743cb736 fix: reset retry counter on handled exceptions and add text to vision tool results
- Reset retry counter to 0 when exception is None or already handled (HandledException, RepairableException)
- Add text message to vision_load tool results to prevent model provider errors with image-only messages
2026-03-22 10:44:08 +01:00
..
extensions/python fix: reset retry counter on handled exceptions and add text to vision tool results 2026-03-22 10:44:08 +01:00
webui generated logos for builtin plugins 2026-03-19 17:35:03 +01:00
default_config.yaml refactor - plugin names and builtin plugins 2026-03-10 22:20:53 +01:00
plugin.yaml refactor - plugin names and builtin plugins 2026-03-10 22:20:53 +01:00
README.md refactor: normalize plugin paths, add README viewer to plugin info modal, and update plugin hub filters 2026-03-22 08:05:32 +01:00

Error Retry

Retry once after an unexpected critical exception so the agent has a chance to recover instead of failing immediately.

What It Does

This plugin hooks into the agent lifecycle and automatically retries the current loop once when an unhandled critical exception occurs.

It does not retry exceptions that are already treated as controlled agent flow, such as:

  • HandledException
  • RepairableException

Main Behavior

  • Counter reset per monologue
    • Clears the retry counter at the start of a new monologue.
  • Critical exception retry
    • On an unexpected exception, logs a warning, waits briefly, injects an agent-facing critical error message into history, and suppresses the original exception once.
  • Single retry only
    • Uses an internal counter so the retry happens at most one time per monologue.

Key Files

  • extensions/python/agent_Agent_monologue_start/_10_reset_critical_exception_counter.py
  • extensions/python/agent_Agent_handle_exception_end/_80_retry_critical_exception.py

Configuration Scope

  • Settings section: agent
  • Per-project config: true
  • Per-agent config: true
  • Always enabled: false

Plugin Metadata

  • Name: _error_retry
  • Title: Error Retry
  • Description: Retry on critical exceptions before failing.