AgentExpressError

Base error class for all Agent Express errors.

Every error in the framework extends this class, providing a machine-readable code, a retryable flag for middleware like turn.retry(), and an optional cause for error chaining.

Example

try {
  await agent.run({ input: "test" }).result
} catch (err) {
  if (err instanceof AgentExpressError) {
    console.log(err.code, err.retryable)
  }
}

Extends

• Error

Extended by

• AbortError
• ModelError
• ToolDeniedError
• ToolExecutionError
• SessionClosedError
• SessionBusyError
• StructuredOutputParseError
• StructuredOutputValidationError
• BudgetExceededError
• InputGuardrailError
• OutputGuardrailError
• TurnTimeoutError

Constructors

Constructor

new AgentExpressError(message, code, retryable, cause?): AgentExpressError

Parameters

message

string

code

string

retryable

boolean

cause?

Error

Returns

AgentExpressError

Overrides

Error.constructor

Properties

cause?

readonly optional cause?: Error

Original error that caused this one, if any.

Overrides

Error.cause

---

code

code: string

Machine-readable error code (e.g., “ABORT”, “RATE_LIMIT”, “TOOL_DENIED”).

---

retryable

readonly retryable: boolean

Whether this error can be retried by retry middleware.