mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-30 06:41:51 +00:00
5f309ae685
Three small extractions into focused modules:
* agent/process_bootstrap.py — \_OpenAIProxy (lazy openai.OpenAI import),
\_SafeWriter (broken-pipe-resistant stdio wrapper), \_install_safe_stdio,
\_get_proxy_from_env, \_get_proxy_for_base_url. All process / IO bootstrap.
* agent/iteration_budget.py — IterationBudget class (thread-safe consume/
refund counter shared by parent agent and subagents).
run_agent re-exports every name so existing test patches like
patch('run_agent.OpenAI', ...) and 'from run_agent import IterationBudget'
keep working unchanged. Verified the patch-rebinding contract for OpenAI
explicitly.
tests/run_agent/ + tests/agent/test_gemini_fast_fallback.py:
1347 passed, 3 skipped.
run_agent.py: 15427 -> 15261 lines (-166).
62 lines
1.9 KiB
Python
62 lines
1.9 KiB
Python
"""Per-agent iteration budget — thread-safe consume/refund counter.
|
|
|
|
Extracted from ``run_agent.py``. Each ``AIAgent`` instance (parent or
|
|
subagent) holds an :class:`IterationBudget`; the parent's cap comes from
|
|
``max_iterations`` (default 90), each subagent's cap comes from
|
|
``delegation.max_iterations`` (default 50).
|
|
|
|
``run_agent`` re-exports ``IterationBudget`` so existing
|
|
``from run_agent import IterationBudget`` imports keep working unchanged.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import threading
|
|
|
|
|
|
class IterationBudget:
|
|
"""Thread-safe iteration counter for an agent.
|
|
|
|
Each agent (parent or subagent) gets its own ``IterationBudget``.
|
|
The parent's budget is capped at ``max_iterations`` (default 90).
|
|
Each subagent gets an independent budget capped at
|
|
``delegation.max_iterations`` (default 50) — this means total
|
|
iterations across parent + subagents can exceed the parent's cap.
|
|
Users control the per-subagent limit via ``delegation.max_iterations``
|
|
in config.yaml.
|
|
|
|
``execute_code`` (programmatic tool calling) iterations are refunded via
|
|
:meth:`refund` so they don't eat into the budget.
|
|
"""
|
|
|
|
def __init__(self, max_total: int):
|
|
self.max_total = max_total
|
|
self._used = 0
|
|
self._lock = threading.Lock()
|
|
|
|
def consume(self) -> bool:
|
|
"""Try to consume one iteration. Returns True if allowed."""
|
|
with self._lock:
|
|
if self._used >= self.max_total:
|
|
return False
|
|
self._used += 1
|
|
return True
|
|
|
|
def refund(self) -> None:
|
|
"""Give back one iteration (e.g. for execute_code turns)."""
|
|
with self._lock:
|
|
if self._used > 0:
|
|
self._used -= 1
|
|
|
|
@property
|
|
def used(self) -> int:
|
|
with self._lock:
|
|
return self._used
|
|
|
|
@property
|
|
def remaining(self) -> int:
|
|
with self._lock:
|
|
return max(0, self.max_total - self._used)
|
|
|
|
|
|
__all__ = ["IterationBudget"]
|