jarvis / docs /operations /error-taxonomy.md
Jonathan Haas
Add per-integration circuit breakers with status reporting
3f8c864
|
Raw
History Blame Contribute Delete
4.61 kB

Error Taxonomy Reference

Canonical tool error taxonomy shared by service tools and telemetry.

Ownership by Tool Family

Error code Owning tool families
api_error pushover_notify, reminder_notify_due
auth smart_home, smart_home_state, home_assistant_capabilities, home_assistant_conversation, home_assistant_todo, home_assistant_timer, home_assistant_area_entities, calendar_*, todoist_*, pushover_notify, slack_notify, discord_notify, email_send, webhook_trigger
cancelled smart_home*, home_assistant_capabilities, home_assistant_conversation, home_assistant_todo, home_assistant_timer, home_assistant_area_entities, calendar_*, todoist_*, pushover_notify, slack_notify, discord_notify, weather_lookup, webhook_trigger
circuit_open integrations guarded by circuit breaker (home_assistant*, todoist_*, pushover_notify, weather_lookup, webhook_trigger, slack_notify, discord_notify, email_send)
http_error smart_home*, home_assistant_capabilities, home_assistant_conversation, home_assistant_todo, home_assistant_timer, home_assistant_area_entities, calendar_*, todoist_*, pushover_notify, slack_notify, discord_notify, weather_lookup, webhook_trigger
invalid_data smart_home, home_assistant_conversation, home_assistant_todo, home_assistant_timer, media_control, weather_lookup, webhook_trigger, timer_*, reminder_*, calendar_*, task_plan_*, memory_*
invalid_json smart_home*, home_assistant_capabilities, home_assistant_conversation, home_assistant_todo, home_assistant_timer, home_assistant_area_entities, calendar_*, todoist_*, pushover_notify, weather_lookup
invalid_plan task_plan_*
invalid_status task_plan_update
invalid_steps task_plan_create
missing_config smart_home*, home_assistant_capabilities, home_assistant_conversation, home_assistant_todo, home_assistant_timer, home_assistant_area_entities, calendar_*, todoist_*, pushover_notify, slack_notify, discord_notify, email_send, reminder_notify_due
missing_entity smart_home_state, home_assistant_capabilities
missing_fields smart_home, home_assistant_conversation, home_assistant_todo, home_assistant_timer, home_assistant_area_entities, weather_lookup, webhook_trigger, timer_cancel, reminder_create, reminder_complete, todoist_add_task, pushover_notify, slack_notify, discord_notify, email_send
missing_plan task_plan_*
missing_query memory_search
missing_store memory_*, task_plan_*
missing_text memory_add
network_client_error smart_home*, home_assistant_capabilities, home_assistant_conversation, home_assistant_todo, home_assistant_timer, home_assistant_area_entities, calendar_*, todoist_*, pushover_notify, slack_notify, discord_notify, email_send, weather_lookup, webhook_trigger
not_found smart_home*, home_assistant_capabilities, home_assistant_conversation, home_assistant_todo, home_assistant_timer, timer_cancel, reminder_complete, task_plan_*, calendar_*
policy cross-cutting tool policy enforcement (smart_home*, home_assistant_conversation, home_assistant_todo, home_assistant_timer, media_control, slack_notify, discord_notify, email_send, memory_add PII guardrails, webhook_trigger, reminder_notify_due, allow/deny lists)
storage_error memory_*, task_plan_*, timer_*, reminder_*
summary_unavailable tool_summary*, system_status
timeout smart_home*, home_assistant_capabilities, home_assistant_conversation, home_assistant_todo, home_assistant_timer, home_assistant_area_entities, calendar_*, todoist_*, pushover_notify, slack_notify, discord_notify, weather_lookup, webhook_trigger
unexpected cross-cutting runtime guard
unknown_error fallback normalization bucket

Canonical Code Set (Machine-Checked)

Do not edit this list without updating src/jarvis/tool_errors.py and tests.

api_error auth cancelled circuit_open http_error invalid_data invalid_json invalid_plan invalid_status invalid_steps missing_config missing_entity missing_fields missing_plan missing_query missing_store missing_text network_client_error not_found policy storage_error summary_unavailable timeout unexpected unknown_error