AgentRun

Summary of one durable session run.

type AgentRun {
  runId: String!
  status: CrowdyStudioAgentRunStatus!
  providerRounds: Int!
  toolCalls: Int!
  errorCode: String
  terminalReason: String
  reason: String
  startedAt: DateTime
  finishedAt: DateTime
  createdAt: DateTime!
  cancelled: Boolean!
}

Fields

AgentRun.runId ● String! non-null scalar

Stable run UUID.

AgentRun.status ● CrowdyStudioAgentRunStatus! non-null enum

Current serialized state.

AgentRun.providerRounds ● Int! non-null scalar

Provider rounds already attempted in this run.

AgentRun.toolCalls ● Int! non-null scalar

Descriptor-pinned tool calls already recorded.

AgentRun.errorCode ● String scalar

Stable terminal error code, or null while non-terminal/successful.

AgentRun.terminalReason ● String scalar

Stable preemption/cancellation reason, or null.

AgentRun.reason ● String scalar

SDK-compatible terminal/preemption reason, or null.

AgentRun.startedAt ● DateTime scalar

Worker start timestamp, or null while queued.

AgentRun.finishedAt ● DateTime scalar

Terminal timestamp, or null while active.

AgentRun.createdAt ● DateTime! non-null scalar

Run acceptance timestamp.

AgentRun.cancelled ● Boolean! non-null scalar

True when the durable run status is CANCELLED.

Member Of

AgentSession object