Stream run events - Veryfront

streamRunEvents(command: RunsStreamRunEventsCommand!, lastEventId: String): RunsStreamFrame!

Arguments

Argument	Type	Required
`command`	`RunsStreamRunEventsCommand!`	Yes
`lastEventId`	`String`	No

Input fields

command

RunsStreamRunEventsCommand

Field	Type	Required	Description
`runId`	`ID!`	Yes	Canonical run UUID. Normal callers need access to the run owner and project.runs.read. A bound eval runtime may instead read its authorized direct agent child.
`eventRepresentation`	`String`	No	Use `run-events-v1` to receive Agent Events Protocol CloudEvents, or `ag-ui` for receipt-backed AG-UI events from Agent runs. Omit it to keep the released run-event row stream contract.

Response

Returns RunsStreamFrame!. Open the type for its fields and nested types.

Field	Type	Description
`eventId`	`Float`	Durable reconnect cursor; null for transient frames.
`eventType`	`String!`	Stored event type used for the SSE event name.
`payload`	`JSON!`
`isError`	`Boolean!`	Error classification from the stored row.
`createdAt`	`String`	Stored timestamp; null when the frame has no stored timestamp.
`runId`	`ID`
`eventClass`	`String`
`spanId`	`ID`

All fields of RunsStreamFrame. Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

subscription StreamRunEvents($command: RunsStreamRunEventsCommand!, $lastEventId: String) {
  streamRunEvents(command: $command, lastEventId: $lastEventId) {
    spanId
    runId
    createdAt
    eventClass
    eventId
  }
}

{
  "command": {
    "runId": "11111111-1111-4111-8111-111111111111"
  },
  "lastEventId": "12"
}