usage
Reports token and cost totals by agent, platform, execution, or session; stops selected agents or writes handoff documents when needed.
Instructions
Who is using what, on which platform, for the heads-down runs and the sessions at the table. action report (default) returns the usage view: totals, platforms (provider and models), and one entry per agent with its tokens and money, where it works (heads-down, at-the-table or the host), its state and whether it can be stopped, plus recent stops. Each agent's calls list bounded-call provenance (source, dissent id, execution/task, charged identity, provider/model), estimated USD and outstanding reservations; usage reports replace reservations by call id. Every figure says whether it is measured (counted by whoever did the work), reported (told to us by an agent or the host) or estimated (worked out by us); a total that mixes them shows the split. Money for a model with no price is absent: you get its tokens instead. Narrow it with execution_id, session_id or agent ("what has cfo cost so far?"). Nothing in it is message text, a prompt, a diff or command output. stop (only when the human asks you to stop an agent): stops agent, a heads-down worker (the runner stops it, keeps its work, and wakes you with two choices) or an at-the-table session (its turn in flight is cut and the session ends; name execution_id or session_id when the agent is in more than one place). A stopped session answers {status: "stopped", …} to its next tool call. Stopping a micro-huddle participant routes its unresolved escalation, retains dispatched unreported spend as estimated, releases unused allowance and preserves dissent holds for explicit resolution. handoff: write a handoff document, for a stopped or ended session (session_id: sessions/.handoff.md) or for a heads-down run (execution_id: HANDOFF.md, without pausing it; control_execution(action: "handoff") pauses first).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | report: only this agent (persona or worker id). stop: the agent to stop (required). | |
| action | No | report (default), stop or handoff. | |
| reason | No | stop: why (recorded on the stop and shown to the orchestrator). | |
| session_id | No | Only this at-the-table session. | |
| execution_id | No | Only this heads-down run (exe-…). |