Skip to main content

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.

Returned By

crowdyStudioAgentCancelRun mutation ● crowdyStudioAgentSendMessage mutation

Member Of

AgentSession object