Skip to content

Public exceptions

Catch these exported exception classes to handle failures. Each entry links to its complete public API contract.

kyvvu.GateDenied

Raised by a decorated step.gate function to deny.

Complete API contract.

kyvvu.KyvvuAPIError

Raised when API request fails.

Complete API contract.

kyvvu.KyvvuBlockedError

Raised by KyvvuRunner.evaluate() when the engine returns Action.block.

Complete API contract.

kyvvu.KyvvuClientUpgradeRequired

The platform refused this client as too old to serve.

Complete API contract.

kyvvu.KyvvuConfigError

Raised when the Python client is misconfigured.

Complete API contract.

kyvvu.KyvvuError

Base exception for all Kyvvu Python client errors.

Complete API contract.

kyvvu.KyvvuKeyRevokedError

Raised when the API key has been disabled or revoked.

Complete API contract.

kyvvu.KyvvuRateLimitError

Raised when rate limit is exceeded.

Complete API contract.

kyvvu.KyvvuTimeoutError

Raised when API request times out.

Complete API contract.

kyvvu.KyvvuValidationError

Raised when data validation fails.

Complete API contract.

kyvvu.PolicyLoadError

A policy, or a manifest of policies, was refused at load time.

Complete API contract.

kyvvu.TaskClosedError

Raised when a write names a task that is closing or closed.

Complete API contract.

kyvvu.TaskStateError

Raised when a write does not fit the task lifecycle.

Complete API contract.

kyvvu_engine.AgentBindingError

Raised when a caller uses an engine or runner bound to another agent.

Complete API contract.

kyvvu_engine.KyvvuBlockedError

Raised by KyvvuRunner.evaluate() when the engine returns Action.block.

Complete API contract.

kyvvu_engine.KyvvuClientUpgradeRequired

The platform refused this client as too old to serve.

Complete API contract.

kyvvu_engine.KyvvuConfigError

Raised when KyvvuRunner is misconfigured (e.g. missing API key when needed).

Complete API contract.

kyvvu_engine.PolicyLoadError

A policy, or a manifest of policies, was refused at load time.

Complete API contract.

kyvvu_engine.TaskClosedError

Raised when a write names a task that is closing or closed.

Complete API contract.

kyvvu_engine.TaskStateError

Raised when a write does not fit the task lifecycle.

Complete API contract.