failecho-autoreport

Automatic failure reporting for agents that are not Claude Code.

Claude Code reports tool failures through a hook that fires after every call, with no model deciding anything. Everywhere else -- LangChain, LlamaIndex, a cron job, a local model driving a scraper -- reporting depends on the model choosing to call a tool, and a small model reliably will not. This removes the decision: wrap the call site once.

from failecho_autoreport import FailEcho

fe = FailEcho()

tools = fe.wrap(tools, service="github-mcp")          # a framework's tool list

@fe.watch(service="api.github.com", operation="create_issue")
def create_issue(title):                              # or one call site
    ...

fe.recovered("api.github.com", "create_issue", "refresh_schema")  # what fixed it

What it sends is a failure's shape: service, operation, a short error class, an HTTP-ish code when there is one, and duration. Never arguments, never return values, never the prompt, never a credential. Error text is off unless FAILECHO_SEND_ERRORS=1.

Three properties it has, each with a test rather than a promise:

• Never raises. A reporting bug cannot become your application's exception.
• Never blocks. Reports go to a worker thread; an unreachable FailEcho costs the caller about 3 ms, not a timeout.
• Never changes behaviour. Returns and re-raises exactly what your code did.

The recovered() line is the one worth bothering with. Failures alone give the network a failure rate; only an outcome records what fixed it, which is the half another agent can act on. It cannot be inferred, so it stays one explicit call.

Zero dependencies. FAILECHO_DISABLED=1 turns it off. Point endpoint= at your own server to send nothing to anyone else. The network at failecho.com is public and, as of this release, empty -- the front page says so. Works on your own history alone from five recoveries.

MIT. Source: https://github.com/FailEcho/failecho