cyberneticlibrary
← library

Enforce token budgets per agent convoy

token-budgetskillsetup L2★64
Tibsfox/gsd-skill-creator ↗
What it does

Enforce hard token budgets per convoy and per agent with pre-execution checking

Best for

Multi-agent Gastown convoys needing hard token gates to prevent runaway spend and cascade failures

Inputs
  • · convoy ID
  • · max tokens per convoy (default 500K)
  • · max tokens per agent (default 100K)
  • · warning threshold (default 80%)
  • · estimated token cost before API call
Outputs
  • · BudgetCheckResult (allowed bool, reason, remainingTokens, usagePercent)
  • · persisted TokenBudget JSON
Preconditions

.chipset/state/budgets/ directory writable; agent must call checkBudget() BEFORE making API call

Failure modes

Token overspend if checkBudget() skipped; budgets lost if not saved to disk; projection mismatch if estimated tokens wildly off

Trust signals
  • · Check-before-execute pattern prevents overspend
  • · Structured stop reasons (convoy_budget_exceeded vs agent_budget_exceeded)
  • · v1.49.621 calibration shows ~26% of historical projection