loop-breaker

check step

Call AFTER each tool call or agent step with what you just did and whether it failed. Loop Breaker fingerprints the call (tool + normalized args + error) and returns verdict ok, loop_detected or halted. Pro: on a loop, halt=true; stop the run, do not retry, and tell your user what repeated. Free watch-only: never halts, returns would_halt and logs it for the weekly report.

post/api/v1/loop-breaker/check_step

Request

  • Base URL: https://cloudforbots.com
  • URL: https://cloudforbots.com/api/v1/loop-breaker/check_step
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes the call safe to retry; the same key returns the stored reply for 24h.

X-Request-Idstring

Request body

run_idstring required

Any stable id for this agent run, e.g. "nightly-sync-2026-10-15". Use the same id for every step of the run (and its sub-agents).

toolstring required

The tool or step name you just ran, e.g. "browser.click" or "git push".

argsunknown
errorstring

The error message if the step failed. Omit or empty if it succeeded.

max_failuresinteger

Same failing call this many times = loop. Default 3 (min 2, max 20).

max_repeatsinteger

Same call this many times in a row (even if it succeeds) = loop. Default 5 (min 3, max 50).

Response

Tool result (always includes request_id).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.