The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
docs(delegation): is_available() and the config example describe fail-closed backends
Teknium9799efea7153
diff --git a/cli-config.yaml.example b/cli-config.yaml.exampleindex 4e483a0cf72..5343b2acf7c 100644--- a/cli-config.yaml.example+++ b/cli-config.yaml.example@@ -1844,10 +1844,12 @@ code_execution:# Supports single tasks and batch mode (default 3 parallel, configurable).delegation:# backend: "default" # Strategy routing each delegate_task task: "default" = the keys below,- # else the parent's route. A plugin backend (model_map, profile_routes)- # that is missing or disabled falls back to "default" with one warning.+ # else the parent's route. model_map / profile_routes come from the+ # advanced-delegation plugin; a backend that is missing, disabled or+ # unavailable fails closed (tool error naming it; /delegation default or+ # `hermes config set delegation.backend default` restores the default).# backends: # Each plugin backend's own settings, keyed by its backend name.- # model_map: # delegation-model-map plugin (backend: model_map)+ # model_map: # backend: model_map (advanced-delegation)# options:# - name: fast# description: "Cheap and quick; lookups, summaries, simple edits."@@ -1858,9 +1860,10 @@ delegation:# provider: "anthropic"# model: "claude-opus-5"# reasoning_effort: "high"- # service_tier: "fast" # optional: refused at spawn when the route has no such tier+ # service_tier: "fast" # optional: that task is refused when the route has no such tier+ # # fallback_providers: [...] # optional; absent = delegation.fallback_providers, [] = none# default: fast # optional: option for tasks that set none- # profile_routes: # delegation-profiles plugin (backend: profile_routes). A listed+ # profile_routes: # backend: profile_routes (advanced-delegation). A listed# profiles: # profile's subagents use ITS credentials, pool, SOUL.md and terminal policy.# - name: coder# description: "Writes and refactors code; runs tests."diff --git a/website/docs/developer-guide/delegation-provider-plugin.md b/website/docs/developer-guide/delegation-provider-plugin.mdindex 8b654173c54..dc3d374c087 100644--- a/website/docs/developer-guide/delegation-provider-plugin.md+++ b/website/docs/developer-guide/delegation-provider-plugin.md@@ -92,7 +92,7 @@ is the default route, and `self.settings(config)` is your backend's own block,| `route_task(task, config)` | yes | Return the route dict for one task. `task` carries `goal`, `context`, `index` and the values the model supplied for your parameters. Raise `DelegationRouteError` to refuse; its message is the tool error the model reads. || `task_parameters(config)` | no | `{name: json_schema}` merged into `tasks.items.properties`. Core enforces `enum` before `route_task` runs and refuses core-owned names (`goal`, `context`, `index`, `output_schema`, `images`, `group`, `role`, `toolsets`, `provider`, `model`, `base_url`, `api_key`, `api_mode`, `acp_command`, `acp_args`). || `description(config)` | no | Guidance appended to the `delegate_task` description. |-| `is_available()` | no | No network calls. `False` makes delegation use `default`. |+| `is_available()` | no | No network calls. `False` fails delegation closed while your backend is selected: `delegate_task` returns a tool error naming it and the fix (`/delegation default`, or `hermes config set delegation.backend default`); it never switches to `default` on its own. || `settings(config)` | inherited | `delegation.backends.<name>` as a mapping (empty when unset). Do not override. |### Routes@@ -151,8 +151,9 @@ when a fallback provider took over. The `default` backend's children leave the r## Picker metadata and session switching`display_name` and `summary` (one user-facing line; never shown to the model) label your backend in-pickers such as `/delegation`. `agent.delegation_backends` is the public API a picker or slash command-uses:+pickers such as `/delegation`. A plugin uses `ctx.delegation_backends` (same methods; `list_backends()` returns+plain dicts). It is a host remote facade, so under `plugins.isolation: host` it acts on the Hermes process, not+the plugin host. Core code calls `agent.delegation_backends` directly:| Call | Does ||---|---|