How it works
Reserve. Allow or block. Close the tab.
The money path is the product. If this page is longer than five minutes, we failed.
- 01
Open a tab
Name the agent. Set a hard cap and a window. Issue ft_live_... The tab is open.
- 02
Point the SDK
Same OpenAI client. base_url = https://proxy.flocktab.com/v1. Header x-flocktab-agent if you want the name on the wire.
- 03
Reserve
FlockTab estimates cents from model and max_tokens, then holds that against the tab. Fail closed if the ledger is down.
- 04
Allow or block
Policy order: tab state, cap, velocity, model allowlist. BLOCKED never reaches the provider. FLAGGED still forwards.
- 05
Settle
After the response, unused reserve is released. Actual cents hit the ledger. One line per decision.
- 06
Close
At cap, or by hand, the tab closes. Next call: 402 tab_closed, x-flocktab-reason: cap.day. Reopen on the window, manually, or never.