errors

const (
	// CategoryTransient indicates a temporary failure that should be retried.
	// Examples: network timeout, connection reset, 502 gateway errors.
	CategoryTransient ErrorCategory = iota

	// CategoryRateLimited indicates rate limit or quota exhaustion.
	// Should be retried with exponential backoff and key rotation if available.
	CategoryRateLimited

	// CategorySecurity indicates a security violation.
	// Should NOT be retried. Examples: blocked commands, unauthorized access.
	CategorySecurity

	// CategoryInvalidInput indicates invalid parameters or malformed requests.
	// Should NOT be retried without fixing the input.
	CategoryInvalidInput

	// CategoryProvider indicates provider-specific failures.
	// Retryability depends on the underlying cause. Examples: auth errors, model not found.
	CategoryProvider

	// CategoryContext indicates context window exceeded.
	// Should be retried after conversation compaction.
	CategoryContext

	// CategoryPermanent indicates non-recoverable errors.
	// Should NOT be retried.
	CategoryPermanent
)

const (
	// CodeUnknown indicates an unrecognized or unclassified error.
	CodeUnknown ErrorCode = "unknown"
	// CodeValidation indicates the input failed validation (bad parameters, malformed request).
	CodeValidation ErrorCode = "validation"
	// CodeNotFound indicates the requested resource does not exist.
	CodeNotFound ErrorCode = "not_found"
	// CodePermission indicates the caller lacks authorization for the operation.
	CodePermission ErrorCode = "permission"
	// CodeTimeout indicates the operation exceeded its time limit.
	CodeTimeout ErrorCode = "timeout"
	// CodeNetwork indicates a network-level failure (connect, DNS, transport).
	CodeNetwork ErrorCode = "network"
	// CodeConfig indicates a configuration error (missing, invalid, or conflicting settings).
	CodeConfig ErrorCode = "config"
	// CodeAgent indicates an agent-level failure (runner crash, internal error).
	CodeAgent ErrorCode = "agent"
	// CodeTool indicates a tool execution failure.
	CodeTool ErrorCode = "tool"
	// CodeApproval indicates an approval gate blocked the operation.
	CodeApproval ErrorCode = "approval"
)

const (
	// SeverityInfo indicates informational events.
	// Reserved for future non-error informational events. No constructor currently emits this severity.
	SeverityInfo Severity = "info"
	// SeverityWarning indicates a recoverable issue that may need attention.
	SeverityWarning Severity = "warning"
	// SeverityError indicates a standard error condition.
	SeverityError Severity = "error"
	// SeverityCritical indicates a configuration or system-level failure requiring immediate attention.
	SeverityCritical Severity = "critical"
)