agentpool-cli 0.1.10__tar.gz → 0.1.12__tar.gz

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 ## Unreleased
 
+## 0.1.12 - 2026-06-06
+
+- Add optional Terminal Control runtime support while keeping tmux as the
+  default worker runtime.
+- Fix Claude Code steering submission by using provider-specific submit keys
+  for both initial prompts and live `send_worker_message` calls.
+- Restore MCP capacity/cache compatibility aliases, add searchable MCP tool
+  descriptions and annotations, and make Cursor Agent CLI detection robust when
+  MCP hosts launch AgentPool with a minimal `PATH`.
+- Add real-provider and fake-provider coverage for tmux and Terminal Control,
+  plus focused regression coverage for MCP aliases and provider binary lookup.
+
+## 0.1.11 - 2026-06-05
+
+- Refresh provider model catalogs from current Claude Code, Codex, Cursor,
+  Droid, and OpenCode surfaces, including Claude Opus 4.8, Claude Code 1M
+  suffixes, and Cursor's explicit 1M/reasoning variants.
+- Forward provider reasoning controls for Claude Code (`--effort`) and Droid
+  (`--reasoning-effort`) while keeping Codex reasoning/service-tier overrides
+  process-local.
+- Refresh stale installed catalog metadata from the embedded catalog without
+  overriding user-selected default or smoke models.
+
 ## 0.1.10 - 2026-06-03
 
 - Add an AI-agent start section to root help pointing agents at bundled skill

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpool-cli
-Version: 0.1.10
+Version: 0.1.12
 Summary: Make full use of every coding-agent subscription you pay for: a local CLI + MCP server that surfaces live usage limits and offloads work to providers with headroom.
 Author: AgentPool contributors
 License-Expression: MIT
@@ -40,7 +40,7 @@ informed, never automatic.
 
 The v0.1 alpha posture is conservative:
 
-- tmux is the required runtime.
+- tmux is the default runtime; Terminal Control is optional when configured.
 - Provider selection is explicit; `provider=auto` is rejected.
 - Usage/capacity summaries are confidence-tagged and keyed by provider id.
 - CodexBar and ccusage are optional usage helpers when installed or configured.
@@ -51,8 +51,10 @@ The v0.1 alpha posture is conservative:
 
 - Python 3.11 or newer.
 - tmux on `PATH`.
+- Optional: `termctrl` on `PATH` for the Terminal Control runtime.
 - Git for worktree isolation and diff collection.
-- macOS or Linux. Windows is not a v0.1 target except through WSL-like shells.
+- macOS or Linux for live runtimes. Windows is not a v0.1 target except through
+  WSL-like shells.
 
 ## Install
 
@@ -72,9 +74,21 @@ agentpool setup codex
 agentpool doctor --deep --privacy
 ```
 
-The `agentpool-cli` package installs on macOS, Linux, and Windows, but the
-runtime requires `tmux`, so the supported runtime is macOS or Linux (Windows
-via WSL).
+The `agentpool-cli` package installs on macOS, Linux, and Windows, but live
+terminal runtimes are supported on macOS or Linux (Windows via WSL).
+
+Optional Terminal Control config:
+
+```yaml
+runtime:
+  default: tmux
+  terminal_control:
+    enabled: true
+    binary: termctrl
+    session_prefix: agentpool
+    cols: 120
+    rows: 36
+```
 
 Install from source:
 
@@ -147,9 +161,10 @@ agentpool terminate <session-id> --json
 
 `spawn` defaults `--initial-prompt-mode` to `provider_default`. For Codex CLI
 this resolves to `arg`, which passes the first task as the Codex prompt argument
-instead of relying on a paste-and-submit startup cycle. Codex workers also
-accept process-local overrides such as `--reasoning-effort high` and
-`--service-tier fast`; AgentPool does not edit your Codex config.
+instead of relying on a paste-and-submit startup cycle. Providers that expose
+reasoning controls also accept process-local overrides such as
+`--reasoning-effort high`; Codex also accepts `--service-tier priority`.
+AgentPool does not edit your provider config.
 
 For AgentPool-created edit isolation, choose worktrees explicitly:
 
@@ -184,8 +199,8 @@ agentpool usage-summary --refresh --backend ccusage --provider claude-code --jso
 ordered and it is not a recommendation list. Each row includes `usable`,
 `unusable_reason`, quota windows, confidence, age/staleness, and reset timing when
 the provider exposes it. The older CLI `capacity-summary` command is retained
-as a human convenience alias; the MCP surface only exposes `get_usage_snapshot`
-and the opt-in `get_usage_summary` tool.
+as a human convenience alias; MCP also exposes `get_capacity_summary` as a
+compatibility alias for `get_usage_summary`.
 
 The default buffer is `policy.min_remaining_percent = 10`. If any reported
 quota window is below that buffer, the provider row is marked unusable for the
@@ -203,13 +218,13 @@ shell script must avoid provider TUI fallback probes.
 
 | Provider id | Command | Usage status in v0.1 | Model pinning |
 | --- | --- | --- | --- |
-| `codex-cli` | `codex` | native local app-server rate-limit probe; CodexBar optional | `--model` |
+| `codex-cli` | `codex` | native local app-server rate-limit probe; CodexBar optional | `--model` + config-scoped reasoning/service tier |
 | `cursor-cli` | `agent` or `cursor-agent` | optional CodexBar Cursor usage; native CLI usage is interactive `/usage` only | `--model` + read-only `--mode ask` |
-| `claude-code` | `claude` | temporary `/usage` probe; ccusage telemetry optional | `--model` |
+| `claude-code` | `claude` | temporary `/usage` probe; ccusage telemetry optional | `--model` + `--effort` |
 | `devin-cli` | `devin` | Devin/Windsurf plan-status API from existing CLI auth, with `/usage` fallback | `--model` |
 | `copilot-cli` | `gh copilot` | GitHub Copilot usage API from env or `gh auth token` | forwarded `--model` |
-| `droid-cli` | `droid` | unknown unless surfaced by future safe probe | process-local settings file |
-| `opencode` | `opencode` | configured adapter; usage unknown in this alpha | catalog-driven |
+| `droid-cli` | `droid` | unknown unless surfaced by future safe probe | process-local settings file + `--reasoning-effort` |
+| `opencode` | `opencode` | configured adapter; usage unknown in this alpha | `--model` with provider/model ids |
 
 Compatibility note: the PRD calls Factory's coding product `factory-droid`, but
 AgentPool exposes it as `droid-cli` because the installed command is `droid`.

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/README.md

@@ -19,7 +19,7 @@ informed, never automatic.
 
 The v0.1 alpha posture is conservative:
 
-- tmux is the required runtime.
+- tmux is the default runtime; Terminal Control is optional when configured.
 - Provider selection is explicit; `provider=auto` is rejected.
 - Usage/capacity summaries are confidence-tagged and keyed by provider id.
 - CodexBar and ccusage are optional usage helpers when installed or configured.
@@ -30,8 +30,10 @@ The v0.1 alpha posture is conservative:
 
 - Python 3.11 or newer.
 - tmux on `PATH`.
+- Optional: `termctrl` on `PATH` for the Terminal Control runtime.
 - Git for worktree isolation and diff collection.
-- macOS or Linux. Windows is not a v0.1 target except through WSL-like shells.
+- macOS or Linux for live runtimes. Windows is not a v0.1 target except through
+  WSL-like shells.
 
 ## Install
 
@@ -51,9 +53,21 @@ agentpool setup codex
 agentpool doctor --deep --privacy
 ```
 
-The `agentpool-cli` package installs on macOS, Linux, and Windows, but the
-runtime requires `tmux`, so the supported runtime is macOS or Linux (Windows
-via WSL).
+The `agentpool-cli` package installs on macOS, Linux, and Windows, but live
+terminal runtimes are supported on macOS or Linux (Windows via WSL).
+
+Optional Terminal Control config:
+
+```yaml
+runtime:
+  default: tmux
+  terminal_control:
+    enabled: true
+    binary: termctrl
+    session_prefix: agentpool
+    cols: 120
+    rows: 36
+```
 
 Install from source:
 
@@ -126,9 +140,10 @@ agentpool terminate <session-id> --json
 
 `spawn` defaults `--initial-prompt-mode` to `provider_default`. For Codex CLI
 this resolves to `arg`, which passes the first task as the Codex prompt argument
-instead of relying on a paste-and-submit startup cycle. Codex workers also
-accept process-local overrides such as `--reasoning-effort high` and
-`--service-tier fast`; AgentPool does not edit your Codex config.
+instead of relying on a paste-and-submit startup cycle. Providers that expose
+reasoning controls also accept process-local overrides such as
+`--reasoning-effort high`; Codex also accepts `--service-tier priority`.
+AgentPool does not edit your provider config.
 
 For AgentPool-created edit isolation, choose worktrees explicitly:
 
@@ -163,8 +178,8 @@ agentpool usage-summary --refresh --backend ccusage --provider claude-code --jso
 ordered and it is not a recommendation list. Each row includes `usable`,
 `unusable_reason`, quota windows, confidence, age/staleness, and reset timing when
 the provider exposes it. The older CLI `capacity-summary` command is retained
-as a human convenience alias; the MCP surface only exposes `get_usage_snapshot`
-and the opt-in `get_usage_summary` tool.
+as a human convenience alias; MCP also exposes `get_capacity_summary` as a
+compatibility alias for `get_usage_summary`.
 
 The default buffer is `policy.min_remaining_percent = 10`. If any reported
 quota window is below that buffer, the provider row is marked unusable for the
@@ -182,13 +197,13 @@ shell script must avoid provider TUI fallback probes.
 
 | Provider id | Command | Usage status in v0.1 | Model pinning |
 | --- | --- | --- | --- |
-| `codex-cli` | `codex` | native local app-server rate-limit probe; CodexBar optional | `--model` |
+| `codex-cli` | `codex` | native local app-server rate-limit probe; CodexBar optional | `--model` + config-scoped reasoning/service tier |
 | `cursor-cli` | `agent` or `cursor-agent` | optional CodexBar Cursor usage; native CLI usage is interactive `/usage` only | `--model` + read-only `--mode ask` |
-| `claude-code` | `claude` | temporary `/usage` probe; ccusage telemetry optional | `--model` |
+| `claude-code` | `claude` | temporary `/usage` probe; ccusage telemetry optional | `--model` + `--effort` |
 | `devin-cli` | `devin` | Devin/Windsurf plan-status API from existing CLI auth, with `/usage` fallback | `--model` |
 | `copilot-cli` | `gh copilot` | GitHub Copilot usage API from env or `gh auth token` | forwarded `--model` |
-| `droid-cli` | `droid` | unknown unless surfaced by future safe probe | process-local settings file |
-| `opencode` | `opencode` | configured adapter; usage unknown in this alpha | catalog-driven |
+| `droid-cli` | `droid` | unknown unless surfaced by future safe probe | process-local settings file + `--reasoning-effort` |
+| `opencode` | `opencode` | configured adapter; usage unknown in this alpha | `--model` with provider/model ids |
 
 Compatibility note: the PRD calls Factory's coding product `factory-droid`, but
 AgentPool exposes it as `droid-cli` because the installed command is `droid`.

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/agentpool-skill.md

@@ -96,7 +96,9 @@ that directory is acceptable. Then observe again.
 When spawning Codex workers, leave `initial_prompt_mode` unset unless you have a
 reason to force it. The provider default uses the Codex CLI prompt argument path.
 Pass `reasoning_effort="high"` or another explicit value when the task needs a
-different Codex reasoning setting from the catalog default.
+different provider reasoning setting from the catalog default. AgentPool
+forwards that to Codex config overrides, Claude Code `--effort`, or Droid
+`--reasoning-effort` depending on the selected provider.
 
 ## Safety Boundaries
 

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/architecture.md

@@ -15,7 +15,8 @@ Core modules:
 - `models.py`: Pydantic response and persistence models.
 - `config.py`: `~/.agentpool/config.yaml` loader and defaults.
 - `providers/`: conservative CLI detection and launch templates.
-- `runtimes/tmux.py`: required v0.1 runtime.
+- `runtimes/tmux.py`: default worker runtime.
+- `runtimes/terminal_control.py`: optional named-session Terminal Control runtime.
 - `store.py`: SQLite sessions, events, usage snapshots, artifacts, and leases.
 - `session_manager.py`: policy enforcement and worker lifecycle orchestration.
 - `mcp_server.py`: MCP tools and resources.

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/install.md

@@ -1,16 +1,17 @@
 # Install AgentPool
 
 AgentPool is a local CLI and MCP server. Install it on the same machine where
-your coding-agent CLIs are logged in and where `tmux` is available.
+your coding-agent CLIs are logged in and where your selected runtime is
+available.
 
 ## Requirements
 
 - Python 3.11 or newer.
-- `tmux` on `PATH`.
+- `tmux` on `PATH` for the default runtime.
+- Optional: `termctrl` on `PATH` for the Terminal Control runtime.
 - Git on `PATH`.
-- macOS or Linux for the runtime. The `agentpool-cli` package installs on
-  Windows too, but `tmux` is not native there, so Windows is supported only
-  through WSL.
+- macOS or Linux for live runtimes. The `agentpool-cli` package installs on
+  Windows too, but terminal runtimes are supported only through WSL.
 
 ## Install From PyPI
 

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/mcp-tools.md

@@ -32,7 +32,9 @@ The default toolset is the smallest worker lifecycle surface:
 
 - `get_inventory`
 - `get_usage_summary`
+- `get_capacity_summary`
 - `get_usage_snapshot`
+- `get_cached_usage_snapshot`
 - `get_provider_models`
 - `get_delegation_preferences`
 - `spawn_worker`
@@ -44,11 +46,10 @@ The default toolset is the smallest worker lifecycle surface:
 - `read_worker_transcript`
 - `terminate_worker`
 
-Removed MCP aliases:
+Compatibility aliases:
 
-- `send_message`
-- `get_capacity_summary`
-- `get_cached_usage_snapshot`
+- `get_capacity_summary`: alias for `get_usage_summary`
+- `get_cached_usage_snapshot`: alias for `get_usage_snapshot(refresh=false)`
 
 Use `get_usage_summary(refresh=false)` for the compact provider-capacity view.
 Use `get_usage_snapshot(refresh=false)` only when you need raw snapshots; cached
@@ -100,8 +101,10 @@ initial prompt as a process argument and avoids first-turn paste/submission
 drift.
 
 `spawn_worker.reasoning_effort` and `spawn_worker.service_tier` are optional
-provider controls. For `codex-cli`, they become process-local Codex overrides;
-AgentPool does not edit the user's Codex config.
+provider controls. For `claude-code`, reasoning becomes `--effort`; for
+`droid-cli`, it becomes `--reasoning-effort`; for `codex-cli`, reasoning and
+service tier become process-local Codex overrides. AgentPool does not edit the
+user's provider config.
 
 ## Output Detail And Lockdown
 

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/model-catalog.md

@@ -8,6 +8,7 @@ It is not a ranking table and it must not be used to implement `provider=auto`.
 
 ```bash
 agentpool models
+agentpool models --provider claude-code
 agentpool models --provider droid-cli
 agentpool models --provider codex-cli --json
 agentpool models validate --path ~/.agentpool/models.json
@@ -20,7 +21,9 @@ Each provider entry can describe:
 - `models`: known model slugs, display names, aliases, confidence, and metadata.
 - `model_arg`: the CLI flag used by providers with native model selection.
 - `model_selection`: non-flag pinning mode, such as Droid runtime settings.
-- `submit_keys`: tmux keys needed for interactive submit quirks.
+- `reasoning_effort_arg`: the CLI flag used by providers with native effort
+  selection, such as Claude Code `--effort` or Droid `--reasoning-effort`.
+- `submit_keys`: runtime keys needed for interactive submit quirks.
 - `quirks`: operator-facing notes for harness behavior.
 
 ## Override
@@ -79,10 +82,18 @@ This lets a user or a primary agent pin a local default without changing the
 provider adapter. Explicit `--model` on `agentpool spawn` or `agentpool smoke`
 still overrides both catalog and provider config.
 
-Compatibility note: the PRD calls the Factory coding product `factory-droid`,
-but AgentPool exposes it as `droid-cli` because the installed command is
-`droid`. Keep the catalog keyed by `droid-cli` unless a separate Factory Droid
-binary or harness appears.
+## Claude Code
+
+Claude Code supports aliases such as `sonnet`, `opus`, `haiku`, and `opusplan`,
+plus full model names such as `claude-opus-4-8`. The catalog also includes
+supported `[1m]` suffix entries, for example `claude-opus-4-8[1m]`. Account and
+plan access still belongs to Claude Code; AgentPool only forwards the selected
+model with `--model`.
+
+Claude Code effort is model-dependent. AgentPool stores the supported effort
+levels per model and forwards `--reasoning-effort` as Claude Code `--effort`.
+When you pass an explicit Claude model without an effort, AgentPool uses that
+model's catalog default.
 
 ## Droid
 
@@ -92,6 +103,18 @@ the configured or requested model by writing a process-local settings file under
 This avoids mutating the user's global Factory settings and avoids accidentally
 using a custom default model backed by a local proxy.
 
+Compatibility note: the PRD calls the Factory coding product `factory-droid`,
+but AgentPool exposes it as `droid-cli` because the installed command is
+`droid`. Keep the catalog keyed by `droid-cli` unless a separate Factory Droid
+binary or harness appears.
+
+## Cursor And OpenCode
+
+Cursor Agent CLI exposes reasoning and 1M context variants as model ids from
+`agent models`, so AgentPool lists those explicit ids instead of inventing a
+separate effort flag. OpenCode model ids use provider/model form, for example
+`opencode/claude-opus-4-8`, and AgentPool forwards them with `--model`.
+
 ## Catalog Confidence
 
 Model lists are conservative. Providers that expose a complete local list, such

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/provider-adapters.md

@@ -8,7 +8,8 @@ Default real-provider behavior is intentionally limited:
 - Probe version with a short timeout.
 - Report auth as `unknown` unless a safe probe exists.
 - Report usage as `unknown` unless a safe explicit probe exists.
-- Launch through tmux using the provider's normal CLI command.
+- Launch through the selected runtime using the provider's normal CLI command;
+  tmux is the default runtime and Terminal Control is optional.
 - Pin a requested model only when the provider exposes a safe process-local
   mechanism for it.
 
@@ -37,18 +38,30 @@ Model pinning behavior:
 - `cursor-cli` uses `agent` or `cursor-agent`, adds `--workspace <path>`, and
   uses `--mode ask` for `read_only` isolation because Cursor documents Ask mode
   as read-only Q&A. Its provider default initial prompt mode is `arg`, matching
-  Cursor's documented `[prompt...]` argument.
+  Cursor's documented `[prompt...]` argument. Cursor's reasoning and 1M context
+  variants are explicit model ids from `agent models`, not a separate effort
+  flag.
+- `claude-code` uses `--model` for model pinning and `--effort` for supported
+  Claude Code effort levels. Full model names such as `claude-opus-4-8` and
+  `[1m]` suffixes are catalog entries, but account and plan access still belong
+  to Claude Code.
 - `droid-cli` does not expose interactive `--model`; AgentPool
   writes a minimal `~/.agentpool/runtime-settings/droid-<model>.json` and starts
-  Droid with `--settings <path>`.
+  Droid with `--settings <path>`. Droid `exec` exposes reasoning through
+  `--reasoning-effort`, which AgentPool forwards when requested.
 - AgentPool does not edit or persist provider credentials or user defaults.
 
-Tmux submit behavior:
+Runtime submit behavior:
 
 - Most providers submit pasted text with terminal Enter.
 - `codex-cli` submits with `C-m` in tmux.
+- `claude-code` receives an explicit `Enter` after pasted steering so
+  multi-line messages ending in a newline are submitted instead of left in the
+  composer.
 - Short menu selections such as startup trust or update prompts still use normal
   Enter so they do not go through provider composer shortcuts.
+- Terminal Control maps the same submit keys onto its named key vocabulary, for
+  example `C-m` to `enter` and `C-c` to `ctrl-c`.
 
 Fake providers under `src/agentpool/fixtures/fake_agents/` are the executable contract for v0.1.
 They are packaged with AgentPool so `agentpool smoke --provider fake-question`

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/provider-lifecycle-matrix.md

@@ -37,12 +37,12 @@ Cursor has two separate surfaces: `cursor` is an MCP host integration, while
 | `fake-limit` | native fake | yes | yes | pending | pending | pending | pending | pending | tests | Limit warning fixture. |
 | `fake-patch` | native fake | yes | yes | pending | pending | pending | pending | pending | tests | Worktree/edit fixture; use only with explicit mutating tests. |
 | `codex-cli` | native + CodexBar combined | yes | yes | yes | yes | yes | yes | yes | 2026-05-09 | Verified with explicit `--model gpt-5.5` on Codex CLI v0.130.0. Known startup trust prompts can be accepted only for the smoke temp repo. The harness detects Codex update prompts and skips them before sending task text. Codex tmux submit uses `C-m`. Codex usage supports 5h and weekly windows. |
-| `cursor-cli` | CodexBar cursor optional, native unknown | partial | yes | pending | yes | yes | yes | yes | 2026-05-24 | Local command is `agent` v2026.05.24-dda726e. Adapter pins models with `--model`, sets `--workspace`, and uses `--mode ask` for read-only. Local smoke reached Cursor login/auth prompt and was terminated cleanly; full completion requires `agent login` to make the installed CLI usable. `agent models` returned no account models on this machine. CodexBar cursor usage returned primary/secondary/tertiary windows through the optional backend. |
-| `claude-code` | native `/usage` + CodexBar cli | yes | yes | yes | n/a | yes | yes | yes | 2026-05-09 | Verified with explicit `--model sonnet`; generated `AGENTPOOL_SMOKE_DONE`, collected, terminated, and left git clean. Startup can show Warp/tmux focus and optional MCP warnings; they did not block lifecycle detection. CodexBar safe source gives 5h usage; native `/usage` is interactive. |
+| `cursor-cli` | CodexBar cursor optional, native unknown | partial | yes | pending | yes | yes | yes | yes | 2026-06-05 | Local command is `agent` v2026.06.02-8c11d9f. Adapter pins models with `--model`, sets `--workspace`, and uses `--mode ask` for read-only. `agent models` returned account models including Composer 2.5, Claude Opus 4.8 1M variants, and GPT 5.5/5.4 variants. CodexBar cursor usage returned primary/secondary/tertiary windows through the optional backend. |
+| `claude-code` | native `/usage` + CodexBar cli | yes | yes | yes | n/a | yes | yes | yes | 2026-06-05 | Verified previously with explicit `--model sonnet`; generated `AGENTPOOL_SMOKE_DONE`, collected, terminated, and left git clean. Local Claude Code v2.1.165 documents `--model` full names such as `claude-opus-4-8` and `--effort low/medium/high/xhigh/max`; AgentPool forwards both. Startup can show Warp/tmux focus and optional MCP warnings; they did not block lifecycle detection. CodexBar safe source gives 5h usage; native `/usage` is interactive. |
 | `copilot-cli` | native GitHub API + CodexBar api | yes | yes | yes | n/a | yes | yes | yes | 2026-05-09 | Verified with explicit `--model gpt-5.5`; GitHub Copilot CLI generated `AGENTPOOL_SMOKE_DONE`, collected, terminated, and left git clean. Usage percentages are available through native/CodexBar API paths. |
 | `devin-cli` | native plan-status API | yes | yes | yes | n/a | yes | yes | yes | 2026-05-09 | Verified with explicit `--model codex`; generated `AGENTPOOL_SMOKE_DONE`, collected, terminated, and left git clean. Native usage includes daily, weekly, and on-demand balance. |
-| `droid-cli` | unknown | yes | yes | yes | n/a | yes | yes | yes | 2026-05-09 | Verified with explicit `--model glm-5.1`, which AgentPool applies through a process-local Droid `--settings` file. This avoids the user's custom default localhost-backed model. No safe subscription quota probe confirmed. |
-| `opencode` | CodexBar mapped, native unknown | skipped | skipped | skipped | skipped | skipped | skipped | skipped | skipped | Skipped for now because no OpenCode Go plan is available. CodexBar is mapped as a safe optional usage backend; native usage remains unknown. |
+| `droid-cli` | unknown | yes | yes | yes | n/a | yes | yes | yes | 2026-06-05 | Verified previously with explicit `--model glm-5.1`, which AgentPool applies through a process-local Droid `--settings` file. This avoids the user's custom default localhost-backed model. Local Droid v0.122.0 exposes `--reasoning-effort`; AgentPool forwards it. No safe subscription quota probe confirmed. |
+| `opencode` | native unknown | skipped | skipped | skipped | skipped | skipped | skipped | skipped | 2026-06-05 | Local `opencode models` returned provider/model ids, and AgentPool can forward them with `--model`. Real lifecycle smoke remains skipped; native usage remains unknown. |
 
 ## Smoke Commands
 

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/quickstart.md

@@ -20,8 +20,8 @@ agentpool init
 agentpool doctor --deep --privacy
 ```
 
-`doctor` confirms `tmux`, SQLite, and the artifact root, and lists each
-provider's install/auth state.
+`doctor` confirms runtime availability, SQLite, and the artifact root, and lists
+each provider's install/auth state.
 
 ## 2. Smoke test without a real provider
 

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/setup-claude-code.md

@@ -75,7 +75,14 @@ agentpool usage-summary --provider claude-code --refresh --json
 agentpool models --provider claude-code
 agentpool spawn \
   --provider claude-code \
+  --model claude-opus-4-8 \
+  --reasoning-effort high \
   --repo . \
   --task "Inspect this repo read-only and summarize the main entry points." \
   --isolation read_only
 ```
+
+Claude Code accepts aliases such as `sonnet` and `opus`, full names such as
+`claude-opus-4-8`, and supported `[1m]` suffixes such as
+`claude-opus-4-8[1m]`. Availability of 1M context depends on the Claude account
+and plan; AgentPool only forwards the explicit model id.

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/setup-cursor-cli.md

@@ -50,4 +50,6 @@ agentpool spawn \
 
 AgentPool launches Cursor with `--workspace <repo>` and uses `--mode ask` for
 read-only isolation. Cursor's `--trust` flag is documented for headless print
-mode, so AgentPool does not use it for interactive tmux workers.
+mode, so AgentPool does not use it for interactive tmux workers. Cursor exposes
+reasoning and 1M context as explicit model ids from `agent models`; choose those
+ids with `--model` when you want them.

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/setup-droid.md

@@ -45,6 +45,7 @@ agentpool models --provider droid-cli
 agentpool spawn \
   --provider droid-cli \
   --model glm-5.1 \
+  --reasoning-effort high \
   --repo . \
   --task "Inspect this repo read-only and summarize the main entry points." \
   --isolation read_only
@@ -52,4 +53,5 @@ agentpool spawn \
 
 AgentPool pins Droid models through a process-local `--settings` file under
 `~/.agentpool/runtime-settings/` so it does not mutate your global Factory
-settings.
+settings. Droid reasoning effort is forwarded with `--reasoning-effort` when
+you provide it.

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/docs/usage-detection.md

@@ -7,8 +7,9 @@ Allowed confidence values include `official`, `local_cli`, `local_config`, `prov
 Live probes are only run by explicit usage requests. Inventory remains non-invasive and reports whether a provider supports an explicit usage probe. Successful explicit probes are persisted to SQLite; `agentpool usage --cached`, `get_usage_summary(refresh=false)`, and `get_usage_snapshot(refresh=false)` read the latest persisted snapshots without refreshing providers. MCP refreshes do not run interactive provider TUI probes, because those can interfere with the host agent that is calling AgentPool. CLI callers can use `--no-interactive` on `usage` / `usage-summary`, or set `AGENTPOOL_NO_INTERACTIVE_USAGE=1`, to take the same headless posture. MCP refreshes are also bounded by a short server-side budget; if a provider is slow, AgentPool returns a partial response with an unknown row instead of holding the MCP connection open.
 
 `agentpool usage-summary` returns a `providers` map keyed by provider id. The
-CLI `capacity-summary` command is a human convenience alias; MCP does not expose
-a capacity alias. Each row includes `usable`, `unusable_reason`, `stale`, and
+CLI `capacity-summary` command and MCP `get_capacity_summary` tool are
+compatibility aliases for `usage-summary` / `get_usage_summary`. Each row
+includes `usable`, `unusable_reason`, `stale`, and
 `age_seconds`. `stale` is informational age metadata only; it does not by
 itself make a provider unusable. `usable` is derived from install/auth status,
 provider usage status, confidence, and reported quota windows. The default

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentpool-cli"
-version = "0.1.10"
+version = "0.1.12"
 description = "Make full use of every coding-agent subscription you pay for: a local CLI + MCP server that surfaces live usage limits and offloads work to providers with headroom."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -57,3 +57,10 @@ include = [
 "docs/examples.md" = "agentpool/docs/examples.md"
 "docs/onboarding.md" = "agentpool/docs/onboarding.md"
 "docs/quickstart.md" = "agentpool/docs/quickstart.md"
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+  "/.firecrawl",
+  "/demo",
+  "/dist",
+]

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.sidduHERE/agentpool",
   "title": "AgentPool",
   "description": "See each coding-agent subscription's live limits and offload work to one with headroom.",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "repository": {
     "url": "https://github.com/sidduHERE/agentpool",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "pypi",
       "identifier": "agentpool-cli",
-      "version": "0.1.10",
+      "version": "0.1.12",
       "transport": {
         "type": "stdio"
       },

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/src/agentpool/__init__.py

@@ -1,3 +1,3 @@
 """AgentPool local agent control plane."""
 
-__version__ = "0.1.10"
+__version__ = "0.1.12"

{agentpool_cli-0.1.10 → agentpool_cli-0.1.12}/src/agentpool/artifacts.py

@@ -13,6 +13,7 @@ from agentpool.utils import repo_hash, sha256_file, write_json
 def create_artifact_dir(root: Path, repo_path: Path, session_id: str) -> Path:
     artifact_dir = root / repo_hash(repo_path) / session_id
     (artifact_dir / "raw" / "tmux-captures").mkdir(parents=True, exist_ok=True)
+    (artifact_dir / "raw" / "terminal-control").mkdir(parents=True, exist_ok=True)
     return artifact_dir