Class: ValidationException

Defined in: lib/utils/validation.ts:69

Thrown when input fails schema validation.

Remarks

Carries the full details array from the underlying ValidationError so callers can surface field-level messages without unwrapping the cause manually.

Extends

• BaseException

Constructors

Constructor

new ValidationException(reason: ValidationError): ValidationException;

Defined in: lib/utils/validation.ts:81

Parameters

Parameter	Type	Description
reason	ValidationError	The ValidationError thrown by the schema; its details are surfaced directly on this exception and its messages are joined to form the human-readable message.

Returns

ValidationException

Overrides

BaseException.constructor

Properties

Property	Modifier	Type	Default value	Description	Overrides	Inherited from	Defined in
code?	public	string	undefined	Machine-readable error code for narrowing exception-handling logic.	-	BaseException.code	lib/classes/base_exception.ts:78
details?	readonly	ValidationErrorItem[]	undefined	The raw field-level error details from the underlying ValidationError.	-	-	lib/utils/validation.ts:75
fatal?	public	boolean	undefined	When true, the ADK treats this error as unrecoverable and should halt the agent loop.	-	BaseException.fatal	lib/classes/base_exception.ts:88
help?	public	string	undefined	Human-readable guidance for resolving or reporting this error.	-	BaseException.help	lib/classes/base_exception.ts:73
name	public	string	undefined	Name of the class that raised the exception.	-	BaseException.name	lib/classes/base_exception.ts:68
status?	public	number	undefined	HTTP status code associated with this error.	-	BaseException.status	lib/classes/base_exception.ts:83
code	static	string	'VALIDATION_EXCEPTION'	Default machine-readable error code inherited by all instances.	BaseException.code	-	lib/utils/validation.ts:71
fatal	static	boolean	false	Whether exceptions of this class are fatal by default.	BaseException.fatal	-	lib/utils/validation.ts:72
help?	static	string	undefined	Default help text inherited by all instances unless overridden at the throw site.	-	BaseException.help	lib/classes/base_exception.ts:47
message?	static	string	undefined	Default message used when no message is supplied to the constructor.	-	BaseException.message	lib/classes/base_exception.ts:63
status	static	number	422	Default HTTP status code inherited by all instances.	BaseException.status	-	lib/utils/validation.ts:70

Accessors

[toStringTag]

Get Signature

get toStringTag: string;

Defined in: lib/classes/base_exception.ts:130

Returns

string

Inherited from

BaseException.[toStringTag]

Methods

toString()

toString(): string;

Defined in: lib/classes/base_exception.ts:134

Returns a string representation of an object.

Returns

string

Inherited from

BaseException.toString

---

isBaseException()

static isBaseException(value: unknown): value is BaseException;

Defined in: lib/classes/base_exception.ts:29

Returns true if value is a BaseException instance.

Parameters

Parameter	Type	Description
value	unknown	The value to test.

Returns

value is BaseException

true when value is a BaseException instance.

Remarks

Performs cross-realm-safe detection: tries instanceof, then Symbol.hasInstance, then constructor-name comparison. The ADK does not export the BaseException class itself as a constructable value — use this guard plus the BaseException type for runtime detection and TypeScript narrowing.

Inherited from

BaseException.isBaseException