AgentError

Stable safe error envelope carried inside tool/run events. Branch on code, never message.

type AgentError {
  code: String!
  message: String!
  retryable: Boolean!
  remediation: String
  field: String
  requiredScope: String
}

Fields

AgentError.code ● String! non-null scalar

Stable additive error code.

AgentError.message ● String! non-null scalar

Safe bounded human-readable detail.

AgentError.retryable ● Boolean! non-null scalar

Whether policy permits a deliberate retry.

AgentError.remediation ● String scalar

Optional safe human remediation, never a command to execute.

AgentError.field ● String scalar

Optional invalid input field path.

AgentError.requiredScope ● String scalar

Optional missing agent scope.

Member Of

AgentRunEvent object ● AgentToolCall object ● AgentToolEvent object ● AgentToolResultEnvelope object