transport_register
Register a public transport run to start tracking caller-owned work, allocate artifact paths, and persist state without executing work.
Instructions
Register a public transport run.
Creates a state-only run record, allocates report/output/log artifact paths under the workspace transport
substrate, persists state atomically, and appends a transport event.
When to use:
- Start tracking caller-owned work through public transport state.
- Allocate artifact paths before an external runtime begins work.
When NOT to use:
- Do not use this to execute work; public transport is state-only.
- Do not use this for lightweight event logging; use post_event for that.
Examples:
>>> transport_register("import-audit", brief_id="brief-123")
{"schema": "nogra.transport.run.v1", "runId": "transport-...", "status": "queued", ...}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | Free-form runtime target label supplied by the caller. | |
| brief_id | No | Optional public brief id this run is associated with. | |
| metadata | No | Optional caller-owned metadata for this run. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||