| # 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. |
|
|
| <!-- SERVICE_ERROR_CODES_START --> |
| 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 |
| <!-- SERVICE_ERROR_CODES_END --> |
| |
