wallet-guard v0.1.0: 에이전트를 위한 루프 및 예산 가드레일

진행 없는 재시도 루프를 차단하고, 합법적인 확인 요청으로 영구적으로 막히지 않도록 지출 한도를 강제합니다.

문제점

에이전트는 결코 진전하지 않는 재시도 루프에 빠지거나, 허가된 금액 이상을 지출할 수 있습니다. 반대 위험은 영구적인 차단입니다: 사용자로부터의 간단한 확인 요청조차 오류로 처리되면, 에이전트는 영원히 멈춥니다.

기능

wallet-guard는 LoopGuard와 예산(budget)을 노출합니다. 테스트를 통해 검증된 두 가지 동작 방식은 다음과 같습니다:

• 루프 차단: N번의 재시도가 측정 가능한 진전을 가져오지 못하면 중단합니다.
• 예산: 지출/설정 한도를 준수합니다.
• 확인 요청으로 인한 차단 방지: 사용자 확인 요청은 되돌릴 수 없는 실패(irreversible failure)로 간주되지 않습니다 (감사 과정에서 발견 및 수정된 버그).

작동 방식

from wallet_guard.guard import LoopGuard
guard = LoopGuard(max_retries=3, progress_fn=lambda s: s.done)
guard.observe(state)          # 시도 기록
...

감사 결과

• wallet-guard에서 8개의 테스트가 모두 녹색(green)이며, ruff는 깨끗합니다.
• 새 클론(main 브랜치, 커밋 372b2a9)에서 감사되었습니다.

제한 사항 (솔직히)

진전은 통합자가 정의해야 하는 술어(predicate)로 측정됩니다. 이 패키지 자체는