post_event
Record a visible workspace activity event with event type and message, optionally linked to a brief or run id, for pinboard or workflow notes.
Instructions
Append a workspace activity event.
Writes one JSONL event into the configured workspace .nogra events log with schema, id, timestamp,
workspace id, event type, message, and optional brief/run links, then returns the event id and events
resource URI.
When to use:
- Record a visible workspace activity note for pinboard or workflow surfaces.
- Attach a lightweight event to a brief id, run id, or both.
When NOT to use:
- Do not use this for run status history; use update_run for run updates.
- Do not use this to store large reports or artifacts; it appends a compact event message.
Examples:
>>> post_event("dispatch", "Queued analytics audit", brief_id="brief-123", run_id="run-456")
{"status": "ok", "eventId": "event-...", "resourceUri": "nogra://workspace/local/pinboard/events"}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | No | Optional run id to associate with the event; sanitized before storage. | |
| message | Yes | Human-readable event message to append to the workspace event log. | |
| brief_id | No | Optional brief id to associate with the event; sanitized before storage. | |
| event_type | Yes | Short event category. Blank input is stored as note. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||