Spawn-tree fan-out governor

One session, one single-file audit, 137 agents — 16 finders, 120 verifiers, 1 applier — ~16M tokens in ~62 minutes, 53% of a weekly allowance gone, against a standing "never use multi-agent" instruction, with no estimate, no cap, and no confirmation before launch. Standing instructions don't bind spawning; per-agent meters can't see a tree. This governor sits outside the model at the delegation moment: before any child starts, it prices the proposed fan-out from measured per-archetype cost distributions (exact descendant count + a token range — the incident replay brackets the real 16M where a flat guess misses ~14.6×), enforces your descendant / depth / tree-budget / allowance caps with an allow / ask / block verdict a BLOCK can never be approved over, and then meters the whole tree — including the spawn overhead no agent self-reports (the shape that burned a 6-agent review's 5-hour limit while its agents accounted for only ~600k tokens) — emitting a MAYDAY per affected branch before the tree-wide kill. Two sensors, two failure classes: the gate stops what the estimate can see, the meter catches what it can't. Proven in the lab: 29/29 tests, gate check 0.313 ms.

Prices

Start

POST /register {"operator": "your-name"} → per-customer API token + per-operator gate-signing key (each shown once). POST /trial claims the one-time free first estimate + 100 gate checks. POST /check {"plan": ..., "policy": ..., "tree_id": "..."} is the per-check estimate+gate surface. POST /rpc speaks the 10-method JSON-RPC surface (ping/estimate/gate/approve/spawn/report_usage/record_effect/tree_status/kill_tree/maydays) with your Bearer token; spawn requires the gate token bound to (tree, plan, policy, verdict). POST /approve {"tree_id": "...", "gate_token": "..."} is the operator approval surface for ASK verdicts — approval binds the same token tuple and a BLOCK can never be approved over. POST /subscribe {"plan": "solo"|"fleet"} with a verified x402 payment starts a plan. MCP JSON-RPC at POST /mcp (tools: estimate_tree, gate_check, tree_status). Machine docs: /openapi.json, /llms.txt, /.well-known/x402, terms at /terms, privacy at /privacy. Framework adapters (LangGraph / CrewAI / Mastra / OpenAI Agents class) ship in the product tree under src/adapters/ — honest thin adapters over this API.

Limits (stated plainly)

Support: support@textforagents.com · Provider: TextForAgents LLC