update_run
Append a run status update to the workspace timeline, recording changes like queued, running, or failed with optional notes and brief association.
Instructions
Append a workspace run status update.
Writes one JSONL status entry under the configured workspace .nogra runs directory for the sanitized run id,
including schema, timestamp, workspace id, status, notes, and optional brief id, then returns the run resource
URI.
When to use:
- Record that a run moved to a new status such as queued, running, complete, blocked, or failed.
- Attach notes to a run timeline without changing any external transport state.
When NOT to use:
- Do not use this for general activity notes; use post_event for non-run events.
- Do not use this to dispatch work or submit report artifacts; this only appends a public run update.
Examples:
>>> update_run("run-456", "running", notes="Audit started", brief_id="brief-123")
{"status": "ok", "runId": "run-456", "resourceUri": "nogra://workspace/local/runs/run-456"}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Optional human-readable notes for this run status update. | |
| run_id | Yes | Run id to update; sanitized before storage and used as the run JSONL filename. | |
| status | Yes | Run status text to append. Blank input is stored as updated. | |
| brief_id | No | Optional brief id to associate with the run update; sanitized before storage. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||