Exceptions

Safe, shared-root errors for miscellaneous SDK operations.

Custom messages are deliberately ignored. Diagnostics contain only the normalized class name and an optional operation from the fixed catalog below. Reference IDs belong to the consuming application; misc never generates them.

BaseMiscError(message=None, *, debug_info=None, recovery=None)

Bases: BaseError, ValueError

Concrete fallback with safe rendering and ValueError compatibility.

Attributes:

Name	Type	Description
code	str	Stable misc code, or a vetted originating SDK code after translation.
default_message	str	Reviewed default display message.
message	str	Reviewed display message; caller text is never used.
debug_info	DebugInfo	Class name, controlled operation, and vetted origin code only.
recovery	RecoveryInfo	Validated recovery guidance; construction disables retries.
reference_id	str | None	Application-owned diagnostic reference, initially None.

Construct a safe error without trusting caller display or recovery data.

Parameters:

Name	Type	Description	Default
message	str | None	Ignored custom message. Defaults to None.	None
debug_info	DebugInfo | None	Only a catalog operation is retained. Defaults to None.	None
recovery	RecoveryInfo | None	Ignored; only the resolver enables recovery. Defaults to None.	None

JsonRepairDependencyMissingError(message=None, *, debug_info=None, recovery=None)

Bases: MiscDependencyMissingError

Missing json_repair dependency with its established installation guidance.

MiscConfigurationError(message=None, *, debug_info=None, recovery=None)

Bases: BaseMiscError

Component configuration rejected by existing validation.

MiscDependencyError(message=None, *, debug_info=None, recovery=None)

Bases: BaseMiscError

External dependency failure with reviewed category-specific translation.

MiscDependencyMissingError(message=None, *, debug_info=None, recovery=None)

Bases: BaseMiscError, ImportError

Missing optional dependency, also catchable as ImportError.

MiscInputError(message=None, *, debug_info=None, recovery=None)

Bases: BaseMiscError

Input rejected by existing validation.

MiscOutputError(message=None, *, debug_info=None, recovery=None)

Bases: BaseMiscError

Generated output could not be processed.

MiscRuntimeError(message=None, *, debug_info=None, recovery=None)

Bases: BaseMiscError

Unexpected ordinary failure at a supported operation boundary.