Read the setup journal
get_setup_journalRead this Project's setup journal and human-action links. Administrator-only. Without wait_for_step, since returns unchanged when nothing moved. since is ignored when wait_for_step is set; a wait always returns the full entry list, subject to filtering and limit. include_complete and include_superseded default to false; failed entries remain visible. limit defaults to 200 and sets truncated when applied; raise it to read more. Hidden entries are omitted unless explicitly watched. A watched entry always remains in the result, even when hidden. wait_for_step returns when that entry changes state or timeout_seconds expires (default 25; negative refused; 0 reads once without waiting; positive budgets clamped to 1..25), including its current state and timed_out. If timed_out is true, call again with the same wait_for_step instead of increasing timeout_seconds. Completions without a journal write are observed on a few-second cadence (every five unchanged ticks and once before expiry). The first read precedes the wait budget; transient polling failures retry until timeout and return last_error with the last known state. Observes components without seeding connectors.
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": "get_setup_journal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Positive integer entry limit, default 200; truncated indicates omitted entries. Raise it to read more. | |
| since | No | Version returned by an earlier journal read; ignored when wait_for_step is set (still validated). A wait always returns the full entry list, subject to filtering and limit | |
| wait_for_step | No | Step UUID to wait for; hidden entries remain watchable and are included in the result; already-terminal steps return immediately; with application_id, that Application's steps from earlier rounds are watchable too, but a step outside its view belonging to the Project or another Application, even one a call for this build returned, only without it | |
| application_id | No | Optional Application UUID. Selects its current build: its goal, builder and app steps, the Project's agent connection and builder invitations, and the shared steps opened for it in this round; cursors are tagged with this view. Read without application_id for every Project step. | |
| timeout_seconds | No | Wait budget: negative is invalid; 0 reads once without waiting; positive values clamp to 1..25 seconds (default 25) | |
| include_complete | No | Include completed entries, default false | |
| include_superseded | No | Include superseded entries, default false |