post_update
Post progress, notes, interfaces, dependency needs, acknowledgements, and usage reports to a shared blackboard so agents can coordinate tasks and unblock waiting work.
Instructions
Post to the blackboard. kind progress: percent and text. note: a broadcast note (topic, refs). interface: publish an interface you own (name, text = its definition, path), which unblocks tasks waiting on it. need: say you are waiting for a task, interface or artifact (name; topic = task | interface | artifact), which blocks your task until it arrives. ack: acknowledge a directive (directive_id). usage (external workers only): report what you have used since your last report (tokens, usd, model); it is recorded as reported, not measured, and counts toward the budget.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"execution_id": "<execution_id>",
"agent_token": "<agent_token>",
"kind": "<kind>"
},
"name": "post_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| usd | No | usage: the cost in US dollars since your last report, if you know it (else it is priced from the table). | |
| kind | Yes | ||
| name | No | interface: its name; need: the task, interface or artifact you wait for. | |
| path | No | interface: where it lives in the repository. | |
| refs | No | ||
| text | No | Required for every kind except usage. | |
| model | No | usage: the model that did the work. | |
| owner | No | need: expected publishing task. | |
| topic | No | ||
| tokens | No | usage: tokens used since your last report. | |
| percent | No | ||
| agent_token | Yes | The agent token join_execution returned (once). | |
| directive_id | No | ||
| execution_id | Yes | The heads-down run (exe-…). |