AgentLifecycleEvent

Typed session/client/mode/context lifecycle event.

type AgentLifecycleEvent implements AgentEventBase {
  protocolVersion: String!
  eventId: String!
  sessionId: String!
  seq: BigInt!
  type: CrowdyStudioAgentEventType!
  runId: String
  version: String!
  createdAt: DateTime!
  mode: CrowdyStudioAgentMode
  clientEpoch: BigInt
  replayAfterSeq: BigInt
  reason: String
  contextVersion: String
}

Fields

AgentLifecycleEvent.protocolVersion ● String! non-null scalar

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

AgentLifecycleEvent.eventId ● String! non-null scalar

Stable event UUID for deduplication.

AgentLifecycleEvent.sessionId ● String! non-null scalar

Owning session UUID.

AgentLifecycleEvent.seq ● BigInt! non-null scalar

Strictly increasing session sequence as a decimal BigInt.

AgentLifecycleEvent.type ● CrowdyStudioAgentEventType! non-null enum

Stable version 1 event discriminator.

AgentLifecycleEvent.runId ● String scalar

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

AgentLifecycleEvent.version ● String! non-null scalar

Versioned event payload contract.

AgentLifecycleEvent.createdAt ● DateTime! non-null scalar

Commit timestamp.

AgentLifecycleEvent.mode ● CrowdyStudioAgentMode enum

Selected mode when this event carries one.

AgentLifecycleEvent.clientEpoch ● BigInt scalar

Attached client epoch when this event carries one.

AgentLifecycleEvent.replayAfterSeq ● BigInt scalar

Replay cursor returned by attach, or null.

AgentLifecycleEvent.reason ● String scalar

Stable lifecycle/preemption reason, or null.

AgentLifecycleEvent.contextVersion ● String scalar

New context version when carried by this event.

Interfaces

AgentEventBase interface

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

Implemented By

CrowdyStudioAgentEvent union