AgentRunEvent

Typed run lifecycle event.

type AgentRunEvent implements AgentEventBase {
  protocolVersion: String!
  eventId: String!
  sessionId: String!
  seq: BigInt!
  type: CrowdyStudioAgentEventType!
  runId: String
  version: String!
  createdAt: DateTime!
  status: CrowdyStudioAgentRunStatus!
  code: String
  reason: String
  error: AgentError
}

Fields

AgentRunEvent.protocolVersion ● String! non-null scalar

Event envelope version; always 'crowdy.agent-event/1'.

AgentRunEvent.eventId ● String! non-null scalar

Stable event UUID for deduplication.

AgentRunEvent.sessionId ● String! non-null scalar

Owning session UUID.

AgentRunEvent.seq ● BigInt! non-null scalar

Strictly increasing session sequence as a decimal BigInt.

AgentRunEvent.type ● CrowdyStudioAgentEventType! non-null enum

Stable version 1 event discriminator.

AgentRunEvent.runId ● String scalar

Related run UUID, or null for session-only facts.

AgentRunEvent.version ● String! non-null scalar

Versioned event payload contract.

AgentRunEvent.createdAt ● DateTime! non-null scalar

Commit timestamp.

AgentRunEvent.status ● CrowdyStudioAgentRunStatus! non-null enum

Required durable run status carried by this event.

AgentRunEvent.code ● String scalar

Stable terminal error code, or null.

AgentRunEvent.reason ● String scalar

Stable terminal/preemption reason, or null.

AgentRunEvent.error ● AgentError object

Safe typed error envelope when present.

Interfaces

AgentEventBase interface

Common identity/order fields on every typed durable agent event variant.

Implemented By

CrowdyStudioAgentEvent union