Skip to content

The agent that grows with you

docs(delegation): is_available() and the config example describe fail-closed backends

Teknium9799efea7153
diff --git a/cli-config.yaml.example b/cli-config.yaml.example
index 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.md
index 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 |
|---|---|