AgentApprovalEvent

Typed exact-argument human approval event.

type AgentApprovalEvent implements AgentEventBase {
  protocolVersion: String!
  eventId: String!
  sessionId: String!
  seq: BigInt!
  type: CrowdyStudioAgentEventType!
  runId: String
  version: String!
  createdAt: DateTime!
  approvalId: String!
  toolCallId: String!
  argumentHash: String!
  status: CrowdyStudioAgentApprovalStatus!
  safeSummary: String!
  reasons: [String!]!
  expiresAt: DateTime!
}

Fields

AgentApprovalEvent.protocolVersion ● String! non-null scalar

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

AgentApprovalEvent.eventId ● String! non-null scalar

Stable event UUID for deduplication.

AgentApprovalEvent.sessionId ● String! non-null scalar

Owning session UUID.

AgentApprovalEvent.seq ● BigInt! non-null scalar

Strictly increasing session sequence as a decimal BigInt.

AgentApprovalEvent.type ● CrowdyStudioAgentEventType! non-null enum

Stable version 1 event discriminator.

AgentApprovalEvent.runId ● String scalar

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

AgentApprovalEvent.version ● String! non-null scalar

Versioned event payload contract.

AgentApprovalEvent.createdAt ● DateTime! non-null scalar

Commit timestamp.

AgentApprovalEvent.approvalId ● String! non-null scalar

Stable approval UUID.

AgentApprovalEvent.toolCallId ● String! non-null scalar

Bound tool call UUID.

AgentApprovalEvent.argumentHash ● String! non-null scalar

Canonical displayed argument hash.

AgentApprovalEvent.status ● CrowdyStudioAgentApprovalStatus! non-null enum

Required approval lifecycle status.

AgentApprovalEvent.safeSummary ● String! non-null scalar

Safe domain summary retained without raw arguments.

AgentApprovalEvent.reasons ● [String!]! non-null scalar

Bounded server-authored reasons for requiring approval.

AgentApprovalEvent.expiresAt ● DateTime! non-null scalar

Hard approval expiry.

Interfaces

AgentEventBase interface

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

Implemented By

CrowdyStudioAgentEvent union