@matheuskrumenauer/tanya 0.7.0-beta.0 → 0.9.0-beta.0

package/README.md

@@ -198,6 +198,64 @@ run directly; JavaScript and TypeScript commands export a default
 Project-local commands are arbitrary code execution and are gated by the same
 permission engine as native tools.
 
+## Sub-agent tool
+
+The `task` tool delegates a bounded child run while keeping the parent in
+control:
+
+```json
+{
+  "prompt": "Map the auth module and report blockers.",
+  "workspace": "src/auth",
+  "max_turns": 12,
+  "token_budget": { "max_tokens": 12000 },
+  "treat_failure_as": "warning"
+}
+```
+
+Children inherit the parent's skill packs, permission rules, workspace, and
+budget. They may narrow those constraints but cannot loosen them. Depth is
+capped at 2 by default (`TANYA_SUBTASK_MAX_DEPTH`), and active children share a
+default parallel cap of 3 (`TANYA_SUBTASK_MAX_PARALLEL`).
+
+Every child runs its own verifier. Failed child verdicts become parent blockers
+by default; `treat_failure_as` can demote a specific child to `warning` or
+`ignore` when the caller wants advisory work only. Child events stream into the
+parent log with a `subRunId`, and parent cancellation propagates into active
+children.
+
+See [docs/sub-agents.md](./docs/sub-agents.md) for permission inheritance,
+budget-ledger semantics, cancellation, verifier composition, and memory rollup.
+
+## Multi-model routing
+
+Tanya can route each agent step to a different provider/model. Planning and
+simple tool-call turns can use cheap chat models, while synthesis,
+verification, and reasoning turns can use stronger models only when needed.
+
+Default route profile:
+
+| Step | Route | Fallback |
+| --- | --- | --- |
+| `planning` | `deepseek/deepseek-chat` | `qwen/qwen3-coder-plus` |
+| `tool_call` | `deepseek/deepseek-chat` | `groq/llama-3.3-70b-versatile` |
+| `synthesis` | `deepseek/deepseek-reasoner` | `openai/gpt-4.1-mini` |
+| `verification` | `deepseek/deepseek-reasoner` | `openai/gpt-4.1-mini` |
+| `reasoning` | `deepseek/deepseek-reasoner` | `qwen/qwen3-coder-plus` |
+
+Project routes live in `.tania/routes.json`; user-global routes live in
+`~/.tanya/routes.json` with a legacy read fallback from `~/.tania/routes.json`.
+Use `/route` in the REPL to inspect the effective table, `/route show
+<stepType>` to inspect one step, `/route set <stepType> <provider>/<model>` for
+a session-only patch, and `/route reset` to clear session patches.
+
+Escalations are visible: if a cheap route exhausts the malformed tool-call
+repair budget, Tanya emits `escalation_event` and uses the route fallback once,
+up to `TANYA_ESCALATION_CAP` per session.
+
+See [docs/routing.md](./docs/routing.md) for schema, examples, context-window
+guards, per-tool model overrides, and sub-agent model pins.
+
 `--verify` adds required verification commands to the run context. Tanya must run and report each exact command before finishing the coding task.
 
 `tanya benchmark run --all` currently exercises 27 executable low-to-medium regression fixtures: targeted edits, new files, dependency/lockfile updates, framework-style migrations, failing-test repair, frontend smoke checks, artifact/context reuse, streaming long-tool execution, compaction-boundary recovery, run-history logging, dirty worktrees, report repair, and the CosmoHQ mobile/backend smoke profiles.