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	AccessDeniedError	An agent.risk: "high" handler was invoked without the required explicit confirmation
agent.iteration_limit	UnprocessableError	The agent loop hit its maximum round count before producing a final answer
agent.permission_denied	AccessDeniedError	The tool exists, but the caller’s roles don’t cover the handler behind it
agent.tool_not_allowed	AccessDeniedError	The agent called a tool name outside its allowed catalog for this run