pi-umbra-subagents 0.1.0 → 0.1.1

package/README.md

@@ -38,9 +38,12 @@ model. The results arrive as a follow-up message at the start of the next turn.
 | Command or key | Effect |
 |---|---|
 | `/umb-fan [spec]` | start a run yourself; with no argument an editor opens with a template |
-| `/umb-agents`, `alt+a`, `↓` from the last input line | open the agent panel |
-| `↑` `↓` in the panel | select a branch |
-| `x` in the panel | stop the selected branch |
+| `/umb-agents`, `alt+a` | open the agent panel |
+| `↓` from the last input line | move the `❯` from `main` into the agent list under the input box |
+| `↑` `↓`, then `enter` in that list | pick an agent and open the panel on it; `↑` past the first agent or `esc` goes back |
+| `↑` `↓` in the panel | move between phases, or between the agents of one phase |
+| `→` `←` in the panel | go into a phase's agents, and back out to the phases |
+| `x` in the panel | stop the selected phase, or the selected agent |
 | `esc` in the panel | back to the input box, unsent text kept |
 | `/umb-loop [count\|duration] [prompt]` | send the prompt again after each reply; run it again to stop |
 
@@ -65,11 +68,21 @@ wrote stays on disk.
 |---|---|---|
 | `FAN_MODEL` | the session's model | model for `fan` branches that do not name one |
 | `FAN_TOOLS` | `read,grep,find,ls` | tools a branch may use |
-| `FAN_LOAD` | empty | extra `-e <path>` flags; branches start with `--no-extensions`, so a provider that comes from an extension has to be listed here |
-| `FAN_TIMEOUT_MS` | `300000` | a branch still running after this long is cut off |
+| `FAN_LOAD` | `$LOAD` from `delegate.env` | extra `-e <path>` flags; branches start with `--no-extensions`, so a provider that comes from an extension has to be listed here |
+| `FAN_TIMEOUT_MS` | `$DELEGATE_TIMEOUT` × 1000, else `300000` | a branch still running after this long is cut off |
 
-The `delegate` skill reads the same knobs as `FAST`, `LOAD` and `DELEGATE_TIMEOUT` from its
-`delegate.env`, then from `~/.pi/agent/delegate.env`.
+Both ways in share one settings file: the packaged `delegate.env`, then
+`~/.pi/agent/delegate.env`, which wins.
+
+A branch starts without extensions, so a model that only an extension provides is not there
+for it. When no branch can start on its model, you get a warning and the model is told to ask
+you which one to use. The suggestions are your scoped models (`enabledModels`) that a branch
+can reach; if none can, free models; if there are none, the first few a branch can reach.
+Name the choice per branch with `label@provider/model`, set `FAN_MODEL`, or load the extension
+through `LOAD`.
+
+A model id may carry a colon, as in `label@openrouter/some-model:free: task`; the key ends at
+the first colon followed by a space.
 
 ## The patch