Editing Openai/694057b6-101c-8007-9a65-c40578c7252d (section)

=== Appendix G: Tool-call loop algorithm (iteration budget) ===

==== G.1 Iteration semantics (locked) ====
* Tool budget is iterations, not calls.
* One assistant tool-emission “turn” containing any normal tool calls consumes 1 iteration, even if it includes multiple tool calls.

==== G.2 Execution rules ====

When a tool call emission is detected:
* Partition calls into: - normal tool calls (round-trip), - exit tool calls (record only), - unknown tool calls (error).
* Record exit calls into signals[] immediately (best effort).
* If unknown calls exist → fail request with tool_parse_error (preserve output).

===== Normal tool iteration processing =====

If at least one normal tool call exists:
* If tool_iters_remaining == 0 → fail with tool_execution_error (“iteration budget exhausted”).
* Otherwise: - execute all normal tool calls sequentially (order given), - append assistant tool-call message (normal calls only), - append tool result messages, - decrement tool_iters_remaining -= 1, - regenerate BIOS and continue generation.

===== Failure classification (locked) =====

A tool iteration fails (kills the request) only for actual problems:
* parse/validation failure,
* ToolRunner timeout/exception,
* non-serializable result,
* unknown tool name.

“No results found” is not failure; ToolRunner returns an empty or “not found” result.

===== Exit tool behavior (locked) =====
* Exit tools are recorded and never executed.
* Exit tools do not decrement normal tool iteration budget.
* Exit tools do not alter control flow.