Errors

Reference for every error class in the Kumiko framework.

Framework

Error	Type	When it fires
delete_restricted	ConflictError	Cascade-delete guard refused because dependent rows exist
feature_disabled	FeatureDisabledError	Handler’s owning feature is globally disabled
field_access_denied	AccessDeniedError	Dispatcher’s field-level write check blocked a field
invalid_transition	UnprocessableError	GuardTransition rejected a state-machine transition
stale_state	ConflictError	Atomic UPDATE lost the race (another writer moved the row)

AI agent

Reasons the agent runtime surfaces, tool dispatch, the permission gate and the risk gate, rather than a handler’s own domain logic. See The Assistant.

Error	Type	When it fires
agent.high_risk_no_always	UnprocessableError	An always permission rule was requested for an agent: { risk: "high" } handler; use per-call approval instead
agent.iteration_limit	UnprocessableError	The agent loop hit its maximum round count before producing a final answer
agent.tool_not_allowed	UnprocessableError	The model requested a tool outside the run’s catalog, or a permission rule names a handler the caller cannot see