errors

Kitaru exception hierarchy and shared failure helpers.

functraceback_last_line(traceback) -> str | None

Return the last non-empty traceback line when available.

paramtracebackstr | None

Returns

str | None

functraceback_exception_type(traceback) -> str | None

Extract the exception type name from traceback tail text.

paramtracebackstr | None

Returns

str | None

funcclassify_failure_origin(*, status_reason, traceback, default=FailureOrigin.UNKNOWN) -> FailureOrigin

Classify failure origin conservatively from available failure text.

paramstatus_reasonstr | None

paramtracebackstr | None

paramdefaultFailureOrigin

= FailureOrigin.UNKNOWN

Returns

kitaru.errors.FailureOrigin

funcexecution_error_from_failure(message, *, exec_id, status, origin) -> KitaruExecutionError

Construct a typed execution error from classified failure origin.

parammessagestr

paramexec_idstr

paramstatusstr

paramoriginFailureOrigin

Returns

kitaru.errors.KitaruExecutionError

funcbuild_recovery_command(exec_id, *, status) -> str | None

Return the CLI recovery command appropriate for a given run status.

paramexec_idstr

Execution identifier.

paramstatusstr

Raw run status value (e.g. "failed").

Returns

str | None

Copy-pasteable CLI command string, or None when no recovery

funcformat_recovery_hint(exec_id, *, status) -> str | None

Format a user-facing recovery hint for a non-successful execution.

paramexec_idstr

Execution identifier.

paramstatusstr

Raw run status value.

Returns

str | None

Multi-line hint string, or None when no recovery action

FailureOrigin

KitaruError

KitaruUsageError

KitaruContextError

KitaruStateError

KitaruRuntimeError

KitaruExecutionError

KitaruUserCodeError

KitaruBackendError

KitaruLogRetrievalError

KitaruDivergenceError

KitaruWaitValidationError

KitaruFeatureNotAvailableError