playmaker-cli 0.5.0__tar.gz → 0.6.0__tar.gz

{playmaker_cli-0.5.0 → playmaker_cli-0.6.0}/CHANGELOG.md

@@ -5,6 +5,63 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-07-27
+
+### Added
+
+- **`opencode` agent handler — one lane, ~75 providers.** The ask was z.ai GLM
+  support, but playmaker never talks to a model API: it drives agent CLIs. So
+  rather than teach the claude handler an `ANTHROPIC_BASE_URL` override — which
+  would have *replaced* the Anthropic lane rather than added one — the handler
+  wraps [opencode](https://opencode.ai), whose `--model provider/model` already
+  reaches GLM (`zai-coding-plan/glm-5.2`), local LMStudio/MLX models, and
+  everything else on models.dev. Oneshot via `opencode run --format json`,
+  resume via `-s <id>`; every JSONL event carries `sessionID`, so a detached
+  dispatch records the id from the first line rather than at completion.
+
+  Four behaviours worth knowing. opencode resolves its working directory from
+  `process.env.PWD`, which `subprocess.Popen(cwd=…)` does not update — left
+  alone it ignores `--cwd` and writes into whatever directory the coach was
+  sitting in, so the handler passes `--dir` and corrects `PWD`.
+  opencode ≥1.18 keeps transcripts in SQLite
+  (`opencode.db`), not one file per session, so playmaker writes a pointer at
+  `~/.playmaker/opencode/<id>.session` and reads the `session`/`message`/`part`
+  tables live — which keeps `thread --follow` current rather than frozen.
+  Cost comes from opencode's own per-session accounting rather than the stream,
+  because `run --format json` can exit before its final `step_finish`
+  ([opencode#26855](https://github.com/anomalyco/opencode/issues/26855)).
+  And `[agents.opencode] model` matters more than the usual `--model` default:
+  left unset, opencode falls back to whatever its own `opencode.json` says,
+  which is typically the model you last picked interactively rather than the
+  one you meant to dispatch to.
+
+  Permissions follow agy, for the same reason: `--auto` is opencode's only
+  lever, so a detached run either auto-approves or comes back having done
+  nothing. `yolo` defaults to `true`; narrow it with the `permission` block in
+  your own opencode.json, which `--auto` still honours for denies.
+- **`zai` quota probe** — GLM Coding Plan windows (5-hour, weekly, and the
+  monthly MCP tool pool) from `api.z.ai/api/monitor/usage/quota/limit`, keyed
+  off the credential opencode already wrote to its `auth.json`, so playmaker
+  still stores no secret of its own. Reported as its own provider rather than
+  under `opencode`, because the quota belongs to the plan — an opencode lane
+  pointed at a local model spends nothing here. Degrades to *unsupported*, not
+  an error row, when no Z.ai credential exists.
+
+## [0.5.1] - 2026-07-27
+
+### Fixed
+
+- **The bundled coach skill taught agy model names agy no longer accepts.**
+  `agy models` switched from quoted display strings (`"Claude Opus 4.6
+  (Thinking)"`) to bare slugs (`claude-opus-4-6-thinking`), so every agy
+  dispatch the skill proposed failed model validation. The skill now says to
+  read the live roster from `agy models` instead of spelling names from
+  memory. It also recommended `codex -m gpt-5-codex`, which fails on accounts
+  whose plan lacks that model; codex dispatches now default to the account's
+  own default model. Both fixes landed on main just after v0.5.0 was tagged —
+  this release exists because the skill ships inside the wheel, so doc fixes
+  are not live until published.
+
 ## [0.5.0] - 2026-07-27
 
 ### Changed

{playmaker_cli-0.5.0 → playmaker_cli-0.6.0}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: playmaker-cli
-Version: 0.5.0
-Summary: Playing-coach CLI for orchestrating Claude Code, Codex and Antigravity sub-agents in parallel.
+Version: 0.6.0
+Summary: Playing-coach CLI for orchestrating Claude Code, Codex, Antigravity and opencode sub-agents in parallel.
 Project-URL: Homepage, https://github.com/vladsafedev/playmaker
 Project-URL: Repository, https://github.com/vladsafedev/playmaker
 Project-URL: Issues, https://github.com/vladsafedev/playmaker/issues
 Author-email: Vladislav Shulyugin <vladislav.shulyugin@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
-Keywords: agents,ai,antigravity,claude,claude-code,cli,codex,gemini,orchestration,subagents
+Keywords: agents,ai,antigravity,claude,claude-code,cli,codex,gemini,glm,opencode,orchestration,subagents
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -28,11 +28,11 @@ Description-Content-Type: text/markdown
 # playmaker
 
 [![CI](https://github.com/vladsafedev/playmaker/actions/workflows/ci.yml/badge.svg)](https://github.com/vladsafedev/playmaker/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/playmaker-cli.svg)](https://pypi.org/project/playmaker-cli/)
-[![Python](https://img.shields.io/pypi/pyversions/playmaker-cli.svg)](https://pypi.org/project/playmaker-cli/)
+[![PyPI](https://img.shields.io/pypi/v/playmaker-cli.svg?cacheSeconds=3600)](https://pypi.org/project/playmaker-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/playmaker-cli.svg?cacheSeconds=3600)](https://pypi.org/project/playmaker-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-**Run Claude Code, Codex and Antigravity as parallel sub-agents from one terminal — and spend three separate quotas instead of one.**
+**Run Claude Code, Codex, Antigravity and opencode as parallel sub-agents from one terminal — and spend separate quotas instead of one.**
 
 You stay in your Claude Code session doing the part only you can do. `playmaker`
 fans the rest out to other agent CLIs as detached processes, tracks them,
@@ -41,9 +41,9 @@ parses their native session files, and pings you when they land.
 ```console
 $ B=dashboard                      # one label for the whole fan-out
 
-$ playmaker dispatch codex  --batch $B --model gpt-5-codex -p "Add PATCH /users/:id …"
+$ playmaker dispatch codex  --batch $B -p "Add PATCH /users/:id …"
 session: 9f2c1a4e-…  pid: 48211  (detached)
-$ playmaker dispatch agy    --batch $B --model "Gemini 3.5 Flash (High)" -p "pytest coverage for …"
+$ playmaker dispatch agy    --batch $B --model gemini-3.6-flash-high -p "pytest coverage for …"
 session: 4b1f9c02-…  pid: 48219  (detached)
 $ playmaker dispatch claude --batch $B --model sonnet -p "Update the API docs for …"
 session: c07d5511-…  pid: 48244  (detached)
@@ -74,10 +74,12 @@ in one serial session:
 1. **Wall-clock speed.** A task that decomposes into 3–5 independent
    work-streams (schema, backend, frontend, tests, docs) finishes 2–4× faster
    when each stream runs as its own parallel agent.
-2. **Provider arbitrage.** Codex and Antigravity quotas are entirely separate
-   pools from your Anthropic plan. Every slice you hand them is capacity your
-   main session never spends — and Antigravity's roster includes Claude
-   Sonnet/Opus, so even Claude-quality work can run on Google's pool.
+2. **Provider arbitrage.** Codex, Antigravity and opencode quotas are entirely
+   separate pools from your Anthropic plan. Every slice you hand them is
+   capacity your main session never spends — and Antigravity's roster includes
+   Claude Sonnet/Opus, so even Claude-quality work can run on Google's pool.
+   `opencode` widens this the most: one CLI fronting ~75 providers, from a z.ai
+   GLM coding plan to models running locally on your own machine.
 3. **Bucket arbitrage inside one plan.** Headless `claude -p` draws on the same
    subscription as your interactive session, but per-model weekly buckets are
    separate — dispatching `--model sonnet` spends Sonnet's usually-idle bucket
@@ -134,6 +136,16 @@ The other agents differ, because their CLIs do:
   either auto-approves or comes back having done nothing. It therefore
   defaults to `yolo = true`; layer `sandbox = true` on top for agy's own
   terminal restrictions.
+- **opencode** is the same story: its only lever is `--auto`, so it also
+  defaults to `yolo = true`. The granular control lives in opencode's own
+  config rather than in playmaker — and `--auto` still honours it, because it
+  auto-approves only what you have not explicitly denied:
+
+  ```jsonc
+  // ~/.config/opencode/opencode.json
+  { "permission": { "edit": "allow", "bash": "allow", "webfetch": "deny" } }
+  ```
+
 - **gemini** (legacy) runs with `--yolo`.
 
 ## Install
@@ -168,8 +180,9 @@ playmaker agents          # which agent CLIs are reachable
 | Agent | Install | Notes |
 |---|---|---|
 | **Claude Code** | `npm i -g @anthropic-ai/claude-code` | `--model sonnet` / `opus` / `haiku` |
-| **Codex CLI** | `npm i -g @openai/codex` | `--model gpt-5-codex` |
-| **Antigravity (`agy`)** | bundled with [Antigravity](https://antigravity.google) | models are display names: `--model "Claude Opus 4.6 (Thinking)"` — see `agy models` |
+| **Codex CLI** | `npm i -g @openai/codex` | the model roster depends on your plan; omit `--model` to use the account default |
+| **Antigravity (`agy`)** | bundled with [Antigravity](https://antigravity.google) | `--model claude-opus-4-6-thinking` — the roster moves, so read it from `agy models` |
+| **opencode** | `brew install sst/tap/opencode` (or see [opencode.ai](https://opencode.ai)) | `--model provider/model`, e.g. `zai-coding-plan/glm-5.2`; roster from `opencode models`, providers from `opencode auth login` |
 | **Gemini CLI** (legacy) | `npm i -g @google/gemini-cli` | still supported, superseded by `agy` |
 
 At least one is required; `playmaker agents` tells you which it can see.
@@ -233,9 +246,11 @@ flowchart LR
     P --> A1["claude -p<br/>--model sonnet"]
     P --> A2["codex exec"]
     P --> A3["agy -p"]
+    P --> A4["opencode run<br/>-m zai-coding-plan/glm-5.2"]
     A1 --> S[("state.db<br/>outputs/ + logs/")]
     A2 --> S
     A3 --> S
+    A4 --> S
     S -->|"list / thread / summary"| C
     S -.->|"batch drained"| N["one ping"]
 ```
@@ -250,6 +265,7 @@ bookkeeping in between.
 ├── agents/           optional agent profile markdown (claude.md, codex.md, agy.md…)
 ├── outputs/          final output per session — .md, or .json if the agent returned JSON
 ├── logs/             subprocess stdout for detached runs
+├── opencode/         pointer per opencode session (its transcript lives in SQLite)
 └── quotas.json       latest capacity snapshot
 ```
 
@@ -261,6 +277,7 @@ and locates the session file the tool writes locally. Empirically:
 | Claude | `~/.claude/projects/<cwd-with-slashes-as-dashes>/<id>.jsonl` |
 | Codex | `~/.codex/sessions/<YYYY>/<MM>/<DD>/rollout-<ts>-<thread_id>.jsonl` |
 | Antigravity | `~/.gemini/antigravity-cli/brain/<conversation-id>/.system_generated/logs/transcript_full.jsonl` |
+| opencode | SQLite — `~/.local/share/opencode/opencode.db` (`session` / `message` / `part`); playmaker keeps a pointer at `~/.playmaker/opencode/<id>.session` |
 | Gemini | `~/.gemini/tmp/<cwd-basename>/chats/session-<ts>-<short_id>.{json,jsonl}` |
 
 `thread` and `summary` normalize all of them into the same turn list, so every
@@ -276,6 +293,21 @@ dispatch; and a wrong `--model` is a silent failure on both **codex** (reports
 `turn.failed` while exiting 0) and **agy** (runs its default model instead) —
 playmaker turns both into real errors.
 
+**opencode** deserves its own note, because one CLI is many providers. Models
+are `provider/model` strings from `opencode models`, and if you don't pass
+`--model` opencode falls back to the default in *its* config — often whatever
+you last picked interactively. Set the lane's default once:
+
+```toml
+[agents.opencode]
+model = "zai-coding-plan/glm-5.2"
+```
+
+It also has agy's working-directory problem in a different costume: opencode
+reads `process.env.PWD`, which a subprocess `cwd` does not update, so left
+alone it would ignore `--cwd` and write into the directory *you* were standing
+in. playmaker passes `--dir` and fixes up `PWD`, so `--cwd` means what it says.
+
 ## Notifications
 
 Every detached dispatch pings when it finishes. With
@@ -321,11 +353,16 @@ Antigravity (agy)
   Gemini weekly     ███████████████████░ 95% left
   Claude/GPT 5h     ██████████████████░░ 90% left  resets in 2h 05m
   Claude/GPT weekly ██████████████░░░░░░ 70% left  resets in 5d 1h
+
+Z.ai (GLM, via opencode)  Max
+  Session     ████████████████████ 100% left
+  Weekly      ███████████████████░ 95% left   resets in 1d 11h
+  MCP tools   ███████████████████░ 99% left   resets in 25d 11h
 ```
 
 The `Weekly` and `Sonnet` rows above are the point: they are **separate
-buckets**. So is every agy row. Routing a subtask is choosing which of them to
-spend.
+buckets**. So is every agy row, and so is the whole Z.ai block. Routing a
+subtask is choosing which of them to spend.
 
 - **Claude** — OAuth usage API; token from the Claude Code Keychain entry.
 - **Codex** — ChatGPT `wham/usage` API; token from `~/.codex/auth.json`.
@@ -336,6 +373,12 @@ spend.
   `retrieveUserQuota` on the Antigravity backend, which surfaces only coarse
   Gemini buckets and is flagged *daemon offline*. Approach ported from
   [steipete/CodexBar](https://github.com/steipete/CodexBar).
+- **Z.ai** — GLM Coding Plan usage API; key from opencode's
+  `~/.local/share/opencode/auth.json` (or `$ZAI_API_KEY`). Reported as its own
+  provider because the quota belongs to the plan, not to opencode — an opencode
+  lane pointed at a local model spends nothing here. Shows *unsupported* rather
+  than an error when no Z.ai credential exists. `MCP tools` is the monthly
+  web-search/reader pool, not inference.
 
 Reading these at *model* granularity is the point: they are the load-balancing
 input the coach skill uses to route each subtask.

{playmaker_cli-0.5.0 → playmaker_cli-0.6.0}/README.md

@@ -1,11 +1,11 @@
 # playmaker
 
 [![CI](https://github.com/vladsafedev/playmaker/actions/workflows/ci.yml/badge.svg)](https://github.com/vladsafedev/playmaker/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/playmaker-cli.svg)](https://pypi.org/project/playmaker-cli/)
-[![Python](https://img.shields.io/pypi/pyversions/playmaker-cli.svg)](https://pypi.org/project/playmaker-cli/)
+[![PyPI](https://img.shields.io/pypi/v/playmaker-cli.svg?cacheSeconds=3600)](https://pypi.org/project/playmaker-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/playmaker-cli.svg?cacheSeconds=3600)](https://pypi.org/project/playmaker-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-**Run Claude Code, Codex and Antigravity as parallel sub-agents from one terminal — and spend three separate quotas instead of one.**
+**Run Claude Code, Codex, Antigravity and opencode as parallel sub-agents from one terminal — and spend separate quotas instead of one.**
 
 You stay in your Claude Code session doing the part only you can do. `playmaker`
 fans the rest out to other agent CLIs as detached processes, tracks them,
@@ -14,9 +14,9 @@ parses their native session files, and pings you when they land.
 ```console
 $ B=dashboard                      # one label for the whole fan-out
 
-$ playmaker dispatch codex  --batch $B --model gpt-5-codex -p "Add PATCH /users/:id …"
+$ playmaker dispatch codex  --batch $B -p "Add PATCH /users/:id …"
 session: 9f2c1a4e-…  pid: 48211  (detached)
-$ playmaker dispatch agy    --batch $B --model "Gemini 3.5 Flash (High)" -p "pytest coverage for …"
+$ playmaker dispatch agy    --batch $B --model gemini-3.6-flash-high -p "pytest coverage for …"
 session: 4b1f9c02-…  pid: 48219  (detached)
 $ playmaker dispatch claude --batch $B --model sonnet -p "Update the API docs for …"
 session: c07d5511-…  pid: 48244  (detached)
@@ -47,10 +47,12 @@ in one serial session:
 1. **Wall-clock speed.** A task that decomposes into 3–5 independent
    work-streams (schema, backend, frontend, tests, docs) finishes 2–4× faster
    when each stream runs as its own parallel agent.
-2. **Provider arbitrage.** Codex and Antigravity quotas are entirely separate
-   pools from your Anthropic plan. Every slice you hand them is capacity your
-   main session never spends — and Antigravity's roster includes Claude
-   Sonnet/Opus, so even Claude-quality work can run on Google's pool.
+2. **Provider arbitrage.** Codex, Antigravity and opencode quotas are entirely
+   separate pools from your Anthropic plan. Every slice you hand them is
+   capacity your main session never spends — and Antigravity's roster includes
+   Claude Sonnet/Opus, so even Claude-quality work can run on Google's pool.
+   `opencode` widens this the most: one CLI fronting ~75 providers, from a z.ai
+   GLM coding plan to models running locally on your own machine.
 3. **Bucket arbitrage inside one plan.** Headless `claude -p` draws on the same
    subscription as your interactive session, but per-model weekly buckets are
    separate — dispatching `--model sonnet` spends Sonnet's usually-idle bucket
@@ -107,6 +109,16 @@ The other agents differ, because their CLIs do:
   either auto-approves or comes back having done nothing. It therefore
   defaults to `yolo = true`; layer `sandbox = true` on top for agy's own
   terminal restrictions.
+- **opencode** is the same story: its only lever is `--auto`, so it also
+  defaults to `yolo = true`. The granular control lives in opencode's own
+  config rather than in playmaker — and `--auto` still honours it, because it
+  auto-approves only what you have not explicitly denied:
+
+  ```jsonc
+  // ~/.config/opencode/opencode.json
+  { "permission": { "edit": "allow", "bash": "allow", "webfetch": "deny" } }
+  ```
+
 - **gemini** (legacy) runs with `--yolo`.
 
 ## Install
@@ -141,8 +153,9 @@ playmaker agents          # which agent CLIs are reachable
 | Agent | Install | Notes |
 |---|---|---|
 | **Claude Code** | `npm i -g @anthropic-ai/claude-code` | `--model sonnet` / `opus` / `haiku` |
-| **Codex CLI** | `npm i -g @openai/codex` | `--model gpt-5-codex` |
-| **Antigravity (`agy`)** | bundled with [Antigravity](https://antigravity.google) | models are display names: `--model "Claude Opus 4.6 (Thinking)"` — see `agy models` |
+| **Codex CLI** | `npm i -g @openai/codex` | the model roster depends on your plan; omit `--model` to use the account default |
+| **Antigravity (`agy`)** | bundled with [Antigravity](https://antigravity.google) | `--model claude-opus-4-6-thinking` — the roster moves, so read it from `agy models` |
+| **opencode** | `brew install sst/tap/opencode` (or see [opencode.ai](https://opencode.ai)) | `--model provider/model`, e.g. `zai-coding-plan/glm-5.2`; roster from `opencode models`, providers from `opencode auth login` |
 | **Gemini CLI** (legacy) | `npm i -g @google/gemini-cli` | still supported, superseded by `agy` |
 
 At least one is required; `playmaker agents` tells you which it can see.
@@ -206,9 +219,11 @@ flowchart LR
     P --> A1["claude -p<br/>--model sonnet"]
     P --> A2["codex exec"]
     P --> A3["agy -p"]
+    P --> A4["opencode run<br/>-m zai-coding-plan/glm-5.2"]
     A1 --> S[("state.db<br/>outputs/ + logs/")]
     A2 --> S
     A3 --> S
+    A4 --> S
     S -->|"list / thread / summary"| C
     S -.->|"batch drained"| N["one ping"]
 ```
@@ -223,6 +238,7 @@ bookkeeping in between.
 ├── agents/           optional agent profile markdown (claude.md, codex.md, agy.md…)
 ├── outputs/          final output per session — .md, or .json if the agent returned JSON
 ├── logs/             subprocess stdout for detached runs
+├── opencode/         pointer per opencode session (its transcript lives in SQLite)
 └── quotas.json       latest capacity snapshot
 ```
 
@@ -234,6 +250,7 @@ and locates the session file the tool writes locally. Empirically:
 | Claude | `~/.claude/projects/<cwd-with-slashes-as-dashes>/<id>.jsonl` |
 | Codex | `~/.codex/sessions/<YYYY>/<MM>/<DD>/rollout-<ts>-<thread_id>.jsonl` |
 | Antigravity | `~/.gemini/antigravity-cli/brain/<conversation-id>/.system_generated/logs/transcript_full.jsonl` |
+| opencode | SQLite — `~/.local/share/opencode/opencode.db` (`session` / `message` / `part`); playmaker keeps a pointer at `~/.playmaker/opencode/<id>.session` |
 | Gemini | `~/.gemini/tmp/<cwd-basename>/chats/session-<ts>-<short_id>.{json,jsonl}` |
 
 `thread` and `summary` normalize all of them into the same turn list, so every
@@ -249,6 +266,21 @@ dispatch; and a wrong `--model` is a silent failure on both **codex** (reports
 `turn.failed` while exiting 0) and **agy** (runs its default model instead) —
 playmaker turns both into real errors.
 
+**opencode** deserves its own note, because one CLI is many providers. Models
+are `provider/model` strings from `opencode models`, and if you don't pass
+`--model` opencode falls back to the default in *its* config — often whatever
+you last picked interactively. Set the lane's default once:
+
+```toml
+[agents.opencode]
+model = "zai-coding-plan/glm-5.2"
+```
+
+It also has agy's working-directory problem in a different costume: opencode
+reads `process.env.PWD`, which a subprocess `cwd` does not update, so left
+alone it would ignore `--cwd` and write into the directory *you* were standing
+in. playmaker passes `--dir` and fixes up `PWD`, so `--cwd` means what it says.
+
 ## Notifications
 
 Every detached dispatch pings when it finishes. With
@@ -294,11 +326,16 @@ Antigravity (agy)
   Gemini weekly     ███████████████████░ 95% left
   Claude/GPT 5h     ██████████████████░░ 90% left  resets in 2h 05m
   Claude/GPT weekly ██████████████░░░░░░ 70% left  resets in 5d 1h
+
+Z.ai (GLM, via opencode)  Max
+  Session     ████████████████████ 100% left
+  Weekly      ███████████████████░ 95% left   resets in 1d 11h
+  MCP tools   ███████████████████░ 99% left   resets in 25d 11h
 ```
 
 The `Weekly` and `Sonnet` rows above are the point: they are **separate
-buckets**. So is every agy row. Routing a subtask is choosing which of them to
-spend.
+buckets**. So is every agy row, and so is the whole Z.ai block. Routing a
+subtask is choosing which of them to spend.
 
 - **Claude** — OAuth usage API; token from the Claude Code Keychain entry.
 - **Codex** — ChatGPT `wham/usage` API; token from `~/.codex/auth.json`.
@@ -309,6 +346,12 @@ spend.
   `retrieveUserQuota` on the Antigravity backend, which surfaces only coarse
   Gemini buckets and is flagged *daemon offline*. Approach ported from
   [steipete/CodexBar](https://github.com/steipete/CodexBar).
+- **Z.ai** — GLM Coding Plan usage API; key from opencode's
+  `~/.local/share/opencode/auth.json` (or `$ZAI_API_KEY`). Reported as its own
+  provider because the quota belongs to the plan, not to opencode — an opencode
+  lane pointed at a local model spends nothing here. Shows *unsupported* rather
+  than an error when no Z.ai credential exists. `MCP tools` is the monthly
+  web-search/reader pool, not inference.
 
 Reading these at *model* granularity is the point: they are the load-balancing
 input the coach skill uses to route each subtask.

{playmaker_cli-0.5.0 → playmaker_cli-0.6.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "playmaker-cli"
-version = "0.5.0"
-description = "Playing-coach CLI for orchestrating Claude Code, Codex and Antigravity sub-agents in parallel."
+version = "0.6.0"
+description = "Playing-coach CLI for orchestrating Claude Code, Codex, Antigravity and opencode sub-agents in parallel."
 readme = "README.md"
 requires-python = ">=3.11"
 license = "MIT"
@@ -19,6 +19,8 @@ keywords = [
     "codex",
     "antigravity",
     "gemini",
+    "opencode",
+    "glm",
     "subagents",
 ]
 classifiers = [

{playmaker_cli-0.5.0 → playmaker_cli-0.6.0}/skills/playmaker-coach/SKILL.md

@@ -1,13 +1,15 @@
 ---
 name: playmaker-coach
-description: Playing-coach orchestration of Claude/Codex/Antigravity (agy) sub-agents via the `playmaker` CLI and in-session Task sub-agents. Triggered when the user gives a complex multi-component task where decomposition gives >2x parallel speedup (e.g. "build admin dashboard with schema, backend, FE, tests, docs"). NOT triggered for single-file refactor, single bug fix, single component, or simple Q&A — those stay in this thread without delegation.
+description: Playing-coach orchestration of Claude/Codex/Antigravity (agy)/opencode sub-agents via the `playmaker` CLI and in-session Task sub-agents. Triggered when the user gives a complex multi-component task where decomposition gives >2x parallel speedup (e.g. "build admin dashboard with schema, backend, FE, tests, docs"). NOT triggered for single-file refactor, single bug fix, single component, or simple Q&A — those stay in this thread without delegation.
 ---
 
 # playmaker-coach — playing-coach orchestration
 
-Use the `playmaker` CLI as a facade to dispatch sub-tasks to Codex / Antigravity (`agy`) / a sibling Claude, monitor them, read their threads, review their diffs, and feed back. The coach (this thread) does its own portion of the work in parallel.
+Use the `playmaker` CLI as a facade to dispatch sub-tasks to Codex / Antigravity (`agy`) / opencode / a sibling Claude, monitor them, read their threads, review their diffs, and feed back. The coach (this thread) does its own portion of the work in parallel.
 
-> **`agy` (Antigravity CLI)** does not only serve Google models: `agy models` exposes **Gemini 3.5 Flash (Low/Medium/High)**, **Gemini 3.1 Pro (Low/High)**, **Claude Sonnet 4.6 (Thinking)**, **Claude Opus 4.6 (Thinking)**, and **GPT-OSS 120B (Medium)**. Opus via agy runs on *Google's* quota pool — top-tier Claude work that does not touch the Anthropic subscription's scarce Opus weekly bucket. Model names are the exact display strings (quote them in bash): `--model "Claude Opus 4.6 (Thinking)"`.
+> **`agy` (Antigravity CLI)** does not only serve Google models: alongside the Gemini Flash and Pro tiers, `agy models` carries **Claude Sonnet and Opus** and a **GPT-OSS** mid-tier. Opus via agy runs on *Google's* quota pool — top-tier Claude work that does not touch the Anthropic subscription's scarce Opus weekly bucket: `--model claude-opus-4-6-thinking`.
+>
+> **Never write an agy model name from memory — run `agy models` and copy a line.** Both the roster *and its spelling* move with Antigravity releases: names used to be quoted display strings like `"Claude Opus 4.6 (Thinking)"` and are now bare slugs. playmaker validates `--model` against the live roster and fails the dispatch on a stale name, so a wrong guess costs you a round-trip.
 
 **The point of the coach pattern:** all available models do useful work in parallel under your direction. The coach's job is *orchestration*, not *production*. A coach that does its own implementation, runs its own codebase recon, and reviews everything line by line burns the same budget delegation was meant to save. Treat your own context window as the most expensive resource on the table — every byte you read or generate yourself is a byte that could have come from a cheaper model. Push out as much as you can: implementation, recon, summarization, even drafting the per-subtask prompts when the task is large enough.
 
@@ -21,7 +23,7 @@ All Claude work — coach, internal sub-agents, external `claude -p` — draws f
 
 3. **External dispatch — `playmaker dispatch <agent>`.** Separate OS processes, tracked in playmaker (`list`/`watch`/`thread`/`continue`):
    - **`claude -p` (sibling Claude):** same subscription. Its key lever is the model bucket — **Sonnet is a separate weekly bucket from Opus**, usually idle while Opus depletes, so default **`--model sonnet`** to spare the scarce Opus bucket (**`--model haiku`** for trivial mechanical work). It **can write files** — playmaker runs it in `acceptEdits`, so it edits and runs commands freely inside `--cwd` and is refused outside it (see §10). Use it over an internal sub-agent when you want a **tracked, detached work-stream** you can monitor/continue independently of the coach's turn.
-   - **`codex` / `agy`:** each on its own subscription/quota — the right home for **write-heavy** parallel implementation that can leave the Anthropic subscription. `agy` is special: besides Gemini tiers it carries **Claude Sonnet/Opus 4.6 (Thinking)** on Google's pool, so even "must be Claude-quality" work can leave the Anthropic quota.
+   - **`codex` / `agy` / `opencode`:** each on its own subscription/quota — the right home for **write-heavy** parallel implementation that can leave the Anthropic subscription. `agy` is special: besides Gemini tiers it carries **Claude Sonnet/Opus 4.6 (Thinking)** on Google's pool, so even "must be Claude-quality" work can leave the Anthropic quota. `opencode` is the widest lane: one CLI over ~75 providers, addressed as `provider/model` — a GLM coding plan (`zai-coding-plan/glm-5.2`), or a model running locally on this machine, which spends **no** subscription quota at all.
 
 **Routing cheat-sheet for Claude-side work:**
 
@@ -30,8 +32,10 @@ All Claude work — coach, internal sub-agents, external `claude -p` — draws f
 | writes files and the coach integrates the result directly | **internal sub-agent** (Task tool) | in-session, write-capable, returns into context |
 | is an independent stream you'll monitor / continue separately | **external `dispatch claude --model sonnet`** | tracked & detached; Sonnet's own weekly bucket spares Opus |
 | is heavy reasoning only the coach can do | **coach** | top-tier Opus, serial |
-| is write-heavy and can leave Claude | **codex / agy** | their own quotas |
-| needs top-tier Claude but the Anthropic Opus weekly is precious | **`dispatch agy --model "Claude Opus 4.6 (Thinking)"`** | Opus quality on Google's pool |
+| is write-heavy and can leave Claude | **codex / agy / opencode** | their own quotas |
+| needs top-tier Claude but the Anthropic Opus weekly is precious | **`dispatch agy --model claude-opus-4-6-thinking`** | Opus quality on Google's pool |
+| is bulk work and every subscription is running low | **`dispatch opencode --model zai-coding-plan/glm-5.2`** | a separate GLM plan, untouched by the others |
+| is mechanical and privacy-sensitive, or all quotas are spent | **`dispatch opencode --model <local provider>/<model>`** | runs on this machine; costs no quota, just wall-clock |
 
 **Sonnet is your cheap parallel Claude worker** — a separate weekly bucket that usually sits idle while Opus depletes. Reach for it (via `dispatch claude --model sonnet`, or by pointing an internal sub-agent at Sonnet) instead of burning Opus on mid-tier work.
 
@@ -59,6 +63,7 @@ playmaker quotas --refresh          # current capacity, broken out per model
 - Claude: two non-coach ways to run it — an **internal sub-agent** (Task tool; in-session, write-capable, result returns to the coach) and an **external `claude -p` dispatch** (tracked, detached stream). Both draw on the subscription; the difference is where results land, not cost. See "Execution lanes". Default external Claude to `--model sonnet` — its weekly bucket is separate from Opus and usually idle, so it spares the scarce coach (Opus) bucket.
 - Antigravity (`agy`): one Google pool split across model families — Gemini Flash tiers for cheap bulk work, Gemini 3.1 Pro for hard Gemini work, **Claude Sonnet/Opus 4.6 (Thinking)** as Anthropic-quality capacity that spends *Google's* quota, GPT-OSS 120B as a spare mid-tier. `playmaker quotas` shows the **full categorized breakdown** — `Gemini 5h` / `Gemini weekly` and `Claude/GPT 5h` / `Claude/GPT weekly`. Two things share a bucket: all Gemini models draw the Gemini bucket, and Claude *and* GPT-OSS share the Claude/GPT bucket. So dispatching Opus 4.6 via agy spends the same `Claude/GPT` bucket as Sonnet or GPT-OSS — watch the `Claude/GPT 5h` window when fanning out several agy-Claude jobs. (This needs agy's local daemon up — normally true when any agy process is running; if `playmaker quotas` tags agy "daemon offline" it fell back to a coarse Gemini-only view.)
 - Codex: top-tier vs lighter modes (where applicable).
+- Z.ai (GLM): shown as its own provider because the plan is what has the quota, not the CLI — `Session` (5h) and `Weekly` windows plus a monthly `MCP tools` pool that only web-search/reader calls touch. It appears whenever `opencode auth login` has a Z.AI credential, and reads *unsupported* when it doesn't. An `opencode` dispatch pointed at a **local** model spends none of it, so local lanes never show up in this table at all.
 
 If `quotas.json` is more than 1h old (or shows errors), say so before relying on the numbers.
 
@@ -69,7 +74,7 @@ Codebase exploration ("find where the User entity lives, list its existing field
 Pattern: dispatch a recon subtask with an explicit deliverable.
 
 ```bash
-playmaker dispatch agy --model "Gemini 3.5 Flash (Low)" --cwd $(pwd) --sync \
+playmaker dispatch agy --model gemini-3.6-flash-low --cwd $(pwd) --sync \
   --prompt "Recon only — do not edit any files. In apps/backend/, locate: (a) the User entity/schema and the migration tooling used (Prisma vs TypeORM vs other), (b) the auth middleware that resolves the current user, (c) where DTOs are defined for user PATCH endpoints if any. Report under 200 words as a numbered list with file paths and line ranges."
 ```
 
@@ -89,9 +94,9 @@ Break the task into 2-5 subtasks (don't go finer-grained than that on first run
 
 1. Sort *models* (not agents) by remaining capacity — freshest at the top. A provider with one fresh model and one depleted model is two separate buckets.
 2. **Tier-match each subtask to the cheapest model that can finish it cleanly:**
-   - **Architectural / spec judgment / cross-module integration:** top tier (Opus, agy "Claude Opus 4.6 (Thinking)" / "Gemini 3.1 Pro (High)", Codex top-tier). The coach lives here; agy-Opus is the overflow lane when the Anthropic Opus weekly is precious.
-   - **Pattern-following implementation, well-scoped CRUD, mechanical refactor, test scaffolding, writing inside an existing convention:** mid tier (Claude Sonnet, agy "Claude Sonnet 4.6 (Thinking)" / "Gemini 3.5 Flash (High)" / "Gemini 3.1 Pro (Low)", mid-tier Codex). This is where the bulk of delegated implementation goes.
-   - **Recon, summarization, mechanical loops over many files, name normalization:** cheap tier (agy "Gemini 3.5 Flash (Low)"/"(Medium)", **Claude Haiku**, Sonnet for recon-with-judgment).
+   - **Architectural / spec judgment / cross-module integration:** top tier (Opus, agy `claude-opus-4-6-thinking` / `gemini-3.1-pro-high`, Codex top-tier). The coach lives here; agy-Opus is the overflow lane when the Anthropic Opus weekly is precious.
+   - **Pattern-following implementation, well-scoped CRUD, mechanical refactor, test scaffolding, writing inside an existing convention:** mid tier (Claude Sonnet, agy `claude-sonnet-4-6` / `gemini-3.5-flash-high` / `gemini-3.1-pro-low`, mid-tier Codex). This is where the bulk of delegated implementation goes.
+   - **Recon, summarization, mechanical loops over many files, name normalization:** cheap tier (agy's lowest Flash tiers, **Claude Haiku**, Sonnet for recon-with-judgment).
 
    For Claude specifically, tier is orthogonal to **lane** (see "Execution lanes"): pick the model tier here, then decide *internal sub-agent* (coach integrates the result) vs *external `-p`* (tracked detached stream).
 3. Pass the model explicitly: `playmaker dispatch <agent> --model <name> ...`. Without `--model`, the agent CLI uses its default — which is usually fine but means the coach gives up control over tier-matching. **For sibling Claude, default to `--model sonnet`** (Haiku for trivial mechanical work); never omit it and let the CLI pick Opus — that burns the scarce shared Opus weekly bucket.
@@ -112,7 +117,7 @@ To make a subtask finishable, every dispatch must carry:
 2. **Acceptance criteria as a check the agent runs itself.** A green command — `npx prisma validate`, `pnpm test users.spec.ts`, `tsc --noEmit`, an `eslint` pass on a specific file. The agent is told to keep iterating until that command exits 0 and to surface its output in the final answer. This replaces coach-side review for ~80% of the work.
 3. **Done definition in one sentence**, written so the coach can confirm it in seconds without reading the diff line by line. "Column added, migration generated, prisma validate green." If the coach can't write such a sentence, the subtask isn't sized right yet — split or specify further before dispatching.
 4. **Context the agent needs but doesn't have.** Spec section excerpts, naming conventions, the one related file it should mirror. Paste these into the prompt; don't make the agent find them by reading half the repo. If your team keeps durable notes (a docs folder, a wiki, a notes vault), pass the *exact* paths worth reading rather than asking the agent to go looking.
-5. **Match to capability.** Codex / agy-Gemini do well on pattern-following, well-scoped CRUD, test scaffolding, mechanical refactors, and writing within an existing convention. They do poorly on architectural decisions across files they haven't been pointed at, novel API design, and judging whether a spec rule applies. Keep those for the coach — or for agy's "Claude Opus 4.6 (Thinking)" when the subtask genuinely needs top-tier judgment but should not burn the Anthropic Opus weekly. If a profile in `.playmaker/agents/<name>.md` exists, trust its guidance over these defaults.
+5. **Match to capability.** Codex / agy-Gemini do well on pattern-following, well-scoped CRUD, test scaffolding, mechanical refactors, and writing within an existing convention. They do poorly on architectural decisions across files they haven't been pointed at, novel API design, and judging whether a spec rule applies. Keep those for the coach — or for agy's `claude-opus-4-6-thinking` when the subtask genuinely needs top-tier judgment but should not burn the Anthropic Opus weekly. If a profile in `.playmaker/agents/<name>.md` exists, trust its guidance over these defaults.
 
 A useful smell test before dispatching: *"If this came back done, would I review by running one command and reading one paragraph — or would I need to read the whole diff and think hard about whether it's right?"* If the latter, re-scope before sending.
 
@@ -121,7 +126,7 @@ Output the plan as a short proposal:
 Plan:
 - Coach (me): schema design + integration glue
 - Codex: FastAPI handlers in apps/api/
-- agy (Gemini 3.5 Flash High): pytest tests + README
+- agy (gemini-3.6-flash-high): pytest tests + README
 
 Quotas: Claude session 93% / weekly 80%, Codex 100%,
         agy Gemini 5h 100% / weekly 96%, Claude/GPT 5h 88% / weekly 71%.
@@ -151,7 +156,13 @@ playmaker dispatch <agent> --model <name> --prompt "<scoped prompt>" --cwd $(pwd
 
 Always pass `--cwd $(pwd)` — `playmaker`'s default is the *coach process's* current dir, which is not always what you want.
 
-Always pass `--model` when you've made a tier-matching decision in step 3. Without it, the agent CLI uses its own default (which may be its top-tier model, defeating the load-distribution effort). Model name is what the agent's native CLI accepts: `claude --model sonnet`, `codex exec -m gpt-5-codex`, `agy --model "Gemini 3.5 Flash (High)"` — agy takes the exact display names from `agy models` and they contain spaces, so **always quote them**. Note: agy's own default is a top-tier model, another reason never to omit `--model` on agy dispatches meant to be cheap.
+Always pass `--model` when you've made a tier-matching decision in step 3. Without it, the agent CLI uses its own default (which may be its top-tier model, defeating the load-distribution effort). Model name is what the agent's native CLI accepts: `claude --model sonnet`, `agy --model gemini-3.6-flash-high` — for agy, copy the line from `agy models` rather than typing it.
+
+Two exceptions to "always pass `--model`":
+- **codex** — its model roster depends on the account plan, and an unavailable name fails the whole dispatch (`codex turn failed: … not supported when using Codex with a ChatGPT account`). Omitting `--model` uses whatever that account actually has, which is usually what you want.
+- **agy** — its own default is a top-tier model, so omitting `--model` on a dispatch meant to be cheap silently spends the expensive bucket. Always pass it here.
+
+**opencode is `provider/model`, and the default is a trap.** Names look like `zai-coding-plan/glm-5.2` or `lmstudio/qwen/qwen3-coder-30b` — **run `opencode models` and copy a line** rather than writing one from memory; playmaker validates against that roster and fails the dispatch on a name it doesn't contain. Omitting `--model` does *not* fall back to something sensible: it uses whatever is set in the user's own `~/.config/opencode/opencode.json`, which is typically the last model they picked interactively — often a small local one. So for opencode, always pass `--model` unless `[agents.opencode] model` is already set in `~/.playmaker/config.toml`.
 
 **agy prompt discipline:** the agy agent's shell lives in a private scratch directory, not the workspace. playmaker automatically prepends a workspace preamble to every agy dispatch, but reinforce it: word file instructions with paths relative to the workspace root or absolute paths, never "in the current directory".
 
@@ -163,8 +174,8 @@ Always pass `--model` when you've made a tier-matching decision in step 3. Witho
 
 ```bash
 B=admin-dashboard   # any short label shared across this fan-out
-playmaker dispatch codex --batch "$B" --model gpt-5-codex --prompt "..." --cwd $(pwd)
-playmaker dispatch agy   --batch "$B" --model "Gemini 3.5 Flash (High)" --prompt "..." --cwd $(pwd)
+playmaker dispatch codex --batch "$B" --prompt "..." --cwd $(pwd)
+playmaker dispatch agy   --batch "$B" --model gemini-3.6-flash-high --prompt "..." --cwd $(pwd)
 ```
 
 `playmaker continue <id> --model <name>` overrides the model for one follow-up turn while keeping the live session; without `--model` it inherits the parent session's model.
@@ -173,7 +184,7 @@ For sequential delegation (e.g. "I'll do schema first, then Codex builds on top"
 
 ```bash
 git commit -am "checkpoint: schema before backend dispatch"
-playmaker dispatch codex --model gpt-5-codex --prompt "..." --cwd $(pwd) --sync   # blocks, prints output
+playmaker dispatch codex --prompt "..." --cwd $(pwd) --sync   # blocks, prints output
 ```
 
 ### 6. Coach's own work
@@ -224,7 +235,7 @@ If `playmaker dispatch` returns an error (binary missing, auth bad, agent unavai
 Both Claude lanes are on the subscription, so pick by **where the work lives**, not cost:
 - **Coach folds the result in directly → internal sub-agent (Task tool).** In-session, write-capable, returns into context. Default choice for "more Claude."
 - **Independent stream you'll monitor / continue separately → `playmaker dispatch claude --model sonnet`.** Tracked, detached; Sonnet's separate weekly bucket spares Opus.
-- **Work that can leave the Claude family → Codex / agy** (their own quotas).
+- **Work that can leave the Claude family → Codex / agy / opencode** (their own quotas, or none at all for a local model).
 
 If a dispatch comes back with zero file changes, check `playmaker summary <id>`. Two common causes for Claude: the subtask tried to write outside `--cwd` and was refused (re-dispatch with the right `--cwd`), or the run needed a permission the configured mode doesn't grant — a "I need your permission" answer, not a crash. For **agy** specifically, a "done" with no file changes usually means the files landed in agy's private scratch dir (`~/.gemini/antigravity-cli/scratch/`) — the prompt referred to "the current directory" instead of workspace paths; re-dispatch with explicit paths.
 
@@ -238,7 +249,7 @@ If a dispatch comes back with zero file changes, check `playmaker summary <id>`.
 ## Quota awareness
 
 - **Read Claude quota at model granularity:** Sonnet weekly and Opus weekly are **independent buckets**. Coach and internal sub-agents on Opus spend the scarce one; Sonnet usually sits idle. Push mid-tier work to Sonnet (an internal sub-agent set to Sonnet, or `dispatch claude --model sonnet`) to spare Opus.
-- Read quotas at *model* granularity, not *agent* granularity. For agy, the probe reports four windows — `Gemini 5h/weekly` and `Claude/GPT 5h/weekly`; for Codex, top-tier vs lighter modes.
+- Read quotas at *model* granularity, not *agent* granularity. For agy, the probe reports four windows — `Gemini 5h/weekly` and `Claude/GPT 5h/weekly`; for Codex, top-tier vs lighter modes; for opencode, the quota is reported under the **provider** it is pointed at (`Z.ai`), and a local model reports nothing because it spends nothing.
 - Skip a *model* if its `*_left` is below ~10%; reroute the subtask to the same agent with a different model, or to a different agent entirely.
 - If a top-tier `weekly_*_left` is degrading toward the deadline, push as much work as possible to mid- and cheap-tier models on the same provider (which are often nowhere near depleted), instead of switching providers blindly.
 - agy's **5-hour** window is the one that bites during a fan-out: it "smooths aggregate demand", so a burst of agy dispatches drains `Gemini 5h` or `Claude/GPT 5h` well before the weekly. If a 5h window is low, spread the burst or move some slices to Codex/coach.
@@ -263,9 +274,9 @@ playmaker watch                                 # Rich live TUI of sessions
 
 Every command takes `--json` for machine-readable output.
 
-`--model NAME` is forwarded to the agent's native CLI: `claude --model sonnet`, `codex exec -m gpt-5-codex`, `agy --model "Claude Opus 4.6 (Thinking)"` (display names from `agy models`, always quoted). Without it the agent CLI uses its own default. Model is stored on the session row, so detached re-runs and `continue` inherit it; `continue --model X` overrides for that one turn.
+`--model NAME` is forwarded to the agent's native CLI: `claude --model sonnet`, `agy --model claude-opus-4-6-thinking`, `codex -m <whatever that account has>`, `opencode -m zai-coding-plan/glm-5.2`. Without it the agent CLI uses its own default. Model is stored on the session row, so detached re-runs and `continue` inherit it; `continue --model X` overrides for that one turn.
 
-agy model roster (from `agy models`): `Gemini 3.5 Flash (Low)` / `(Medium)` / `(High)`, `Gemini 3.1 Pro (Low)` / `(High)`, `Claude Sonnet 4.6 (Thinking)`, `Claude Opus 4.6 (Thinking)`, `GPT-OSS 120B (Medium)`. Re-check the roster with `agy models` when in doubt — it changes with Antigravity releases.
+**The agy roster is not documented here on purpose** — it changes with Antigravity releases, and so does the spelling convention. Run `agy models` and copy a line. At the time of writing it returns bare slugs in the shape `gemini-3.6-flash-{low,medium,high}`, `gemini-3.1-pro-{low,high}`, `claude-sonnet-4-6`, `claude-opus-4-6-thinking`, `gpt-oss-120b-medium` — but treat that as an example of the *shape*, not a list to copy from.
 
 ## Anti-patterns
 

{playmaker_cli-0.5.0 → playmaker_cli-0.6.0}/src/playmaker/agents/agy.py

@@ -1,12 +1,15 @@
 """Antigravity CLI (`agy`) handler.
 
 Empirically (agy 1.1.1):
-- oneshot: `agy -p "<prompt>" [--model "<display name>"] [--dangerously-skip-permissions]
+- oneshot: `agy -p "<prompt>" [--model <name>] [--dangerously-skip-permissions]
   [--print-timeout 60m] [--log-file <path>]`; stdout is the final response as
   plain text (no JSON envelope).
 - resume: `agy --conversation <uuid> -p "..."` — keeps the same conversation id.
-- models are addressed by *display name* from `agy models`, e.g.
-  "Claude Opus 4.6 (Thinking)", "Gemini 3.5 Flash (Low)".
+- `--model` takes a name from `agy models` verbatim, e.g.
+  "claude-opus-4-6-thinking", "gemini-3.6-flash-high". Both the roster and its
+  *spelling* move with Antigravity releases — earlier builds took display names
+  like "Claude Opus 4.6 (Thinking)" — which is why _validate_model() reads the
+  live list instead of trusting a hardcoded one.
 - the conversation id is NOT printed to stdout; it is recovered from the CLI
   debug log (`--log-file`) via the `Created conversation <uuid>` line, which
   appears a few seconds in — that is our early on_session_started signal.
@@ -53,7 +56,7 @@ class AgyHandler:
     @staticmethod
     @functools.lru_cache(maxsize=1)
     def available_models() -> tuple[str, ...]:
-        """Exact model display names agy accepts, from `agy models`.
+        """Exact model names agy accepts, from `agy models`.
 
         agy resolves an unknown `--model` to its default *silently* (no error,
         wrong model runs), so we validate against this list before dispatch.