Get run event summary - Veryfront

getRunEventsSummary(command: RunsGetRunEventsSummaryCommand!): RunsEventSummary!

Arguments

Argument	Type	Required
`command`	`RunsGetRunEventsSummaryCommand!`	Yes

Input fields

command

RunsGetRunEventsSummaryCommand

Field	Type	Required	Description
`runId`	`ID!`	Yes
`buckets`	`Float`	No	Number of time buckets spanning first_event_at up to 1 ms past last_event_at (1-500, default 60). Bucket boundaries are whole milliseconds and every bucket is at least 1 ms wide, so the response holds at most as many buckets as the span has milliseconds and may return fewer than requested (a 10 ms span returns at most 10).
`eventClass`	`String`	No	Event class to include: `fact` for state changes or `delta` for streaming fragments. If omitted, returns both.
`eventType`	`[String!]`	No
`isError`	`Boolean`	No	If true, returns only events with `is_error: true`. If false, returns other events. If omitted, returns both.
`start`	`String`	No	Only events created at or after this instant (ISO 8601 with a UTC offset, inclusive). A summary bucket start can be sent as is.
`end`	`String`	No	Only events created before this instant (ISO 8601 with a UTC offset, exclusive). Must be later than start. A summary bucket end can be sent as is.
`spanId`	`ID`	No	Only events whose envelope span_id, as served to the caller, is exactly this value (tool:<id>, message:<id>, step:<id>, input_request:<id>, run:<id>, with a non-empty <id>).
`turnId`	`ID`	No	Only events whose envelope turn_id, as served to the caller, is exactly this value (message:<id>, with a non-empty <id>).
`search`	`String`	No	Case-insensitive substring of the event payload JSON as served to the caller (1-200 characters after trimming, matched literally).
`includeDescendants`	`Boolean`	No	If true, includes events from readable descendant runs, up to 16 generations. Results share one `event_id` order and cursor. Each event retains its `run_id` and the payload visibility permitted for that run. Runs the caller cannot read are excluded. Defaults to false. If at least one descendant is included, task or workflow runs without stored events do not contribute synthetic lifecycle events. Event IDs are allocated before commit. During active writes, ascending pagination can pass an ID that another run commits later.

Response

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

Field	Type
`runId`	`ID!`
`total`	`Float!`
`errorCount`	`Float!`
`firstEventId`	`Float`
`lastEventId`	`Float`
`firstEventAt`	`String`
`lastEventAt`	`String`
`byEventClass`	`RunsEventSummaryByEventClass!`

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

Example

query GetRunEventsSummary($command: RunsGetRunEventsSummaryCommand!) {
  getRunEventsSummary(command: $command) {
    runId
    errorCount
    firstEventAt
    firstEventId
    lastEventAt
  }
}

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