agent-policy-kit 0.5.0 → 0.5.1

package/AGENT_INSTALL.md

@@ -20,7 +20,7 @@ Obey these rules in every step:
 In the steps below, `agent-policy` means the pinned command for the requested release:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy
+npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy
 ```
 
 ## Step 1: Select the release
@@ -30,7 +30,7 @@ The package version is the configuration release. Use the version that the owner
 1. Read the release notes:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy release --json
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy release --json
    ```
 
 2. Read the entry for this version in [CHANGELOG.md](CHANGELOG.md): what changed, why, and the migration limits.
@@ -41,7 +41,7 @@ The package version is the configuration release. Use the version that the owner
 For several commands, you can install the package into a temporary or user-owned prefix:
 
 ```sh
-npm install --prefix PREFIX agent-policy-kit@0.5.0 --ignore-scripts --no-audit --no-fund
+npm install --prefix PREFIX agent-policy-kit@0.5.1 --ignore-scripts --no-audit --no-fund
 ```
 
 Then run `PREFIX/node_modules/.bin/agent-policy`. If the owner gives you a verified local `.tgz` file of a version that is not on npm, install that file in the same way. You need no sudo, no fixed prefix and no shell profile change.
@@ -51,7 +51,7 @@ More: [updates and removal](docs/guide/updates-and-removal.md), [presets](docs/r
 ## Step 2: Detect
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy detect --json
+npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy detect --json
 ```
 
 1. Read the status of each assistant: `detected`, `not_found`, `invalid` or `timeout`.
@@ -112,7 +112,7 @@ APK updates owned files in a transaction for each client, without a removal gap.
 1. Run `doctor`:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy doctor --json
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy doctor --json
    ```
 
    Each client reports its saved release, source and preset from its receipt, independent of the version that runs `doctor`. `verified` means that the owned files match the receipt.
@@ -120,7 +120,7 @@ APK updates owned files in a transaction for each client, without a removal gap.
 2. Run `show` to read the current user-level subagent settings, including manual edits:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy show --json
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy show --json
    ```
 
    `show` does not resolve project, managed or session settings. It exits with code 3 when a client needs attention, and it keeps the results of the other clients.
@@ -134,7 +134,7 @@ A verified configuration does not prove that a model runs. After verification, y
 1. Plan the removal:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy uninstall --json
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy uninstall --json
    ```
 
 2. Review the plan.

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 Each npm version is one configuration release: its presets, native role definitions, instructions and configuration page. Published versions are not rewritten. Applying another release is explicit; package installation alone changes no settings.
 
+## 0.5.1 — 2026-11-01
+
+### Why this release
+
+The Grok Reviewer and Code explorer roles were not read-only (#30). Releases 0.4.0 and 0.5.0 wrote `permission_mode: plan` in their role files. Grok Build reads the fields of an agent file in camelCase, so it ignored this key without a warning, and the prompt was the only restriction. A role file template reaches your setup only through a new release.
+
+### Who should update
+
+- Anyone who uses Grok Build with APK and wants the Reviewer and the Code explorer to be read-only.
+- Other assistants get no configuration change. Their role files, presets and the model catalog are the same as in 0.5.0.
+
+### Migration and rollback
+
+Assistant IDs, preset ids, share-link format v2 and receipt format v4 are unchanged. `doctor` and `show` of 0.5.1 read installations and receipts from 0.4.0 and 0.5.0. Setup with 0.5.1 and `--release`, `--preset`, `--config` or explicit tool arguments replaces their Grok role files in place. A setup without these options reports `unchanged` and keeps the old role files. Setup with 0.5.0 or 0.4.0 moves Grok back in place and writes `permission_mode: plan` again. `uninstall` of 0.5.1 removes a 0.4.0, 0.5.0 or 0.5.1 installation. This was checked for Grok with the published 0.4.0 and 0.5.0 packages in isolated homes and with `grok inspect --json` of Grok Build 1.0.70. The [migration boundaries](docs/guide/updates-and-removal.md#migration-boundaries) of earlier releases still apply.
+
+### What changed
+
+- Grok: the Reviewer and the Code explorer role files have `capabilityMode: read-only` instead of `permission_mode: plan` (#30). When Grok Build starts a subagent of this type, it removes the built-in tools that edit, write, delete or move files and the shell tool. A capability mode requested at spawn cannot widen it. Tools from MCP servers stay, and image or video tools can stay when they are enabled. See [Grok read-only roles](docs/reference/assistants.md#grok-read-only-roles).
+- Grok: APK does not write `permissionMode: plan`. Grok Build reads this field, but at spawn it uses only `bypassPermissions`.
+- `show` reports `UNSUPPORTED_ROLE_CAPABILITY` for a Grok agent file whose `capabilityMode` Grok Build does not accept. Grok Build drops such an agent without a warning.
+- Not checked: a live Grok model task with a read-only role.
+- Configuration page: when you edit Kimi, Gemini or Grok alone, a short note above the model table tells how that assistant applies effort. Kimi shares one effort among the roles that use the same model alias. Gemini has native tiers only and no effort per role. Grok applies an effort only for models that support it, and a role without one runs at its model default. The **All** view shows no note. The unused note text in the page source is removed (#21).
+
 ## 0.5.0 — 2026-11-01
 
 ### Why this release

package/README.md

@@ -22,7 +22,7 @@ Created and maintained by [Mykola Maksymenko](https://www.linkedin.com/in/nick-m
 One command removes the APK settings. It restores the settings that you had before APK and keeps your unrelated edits:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy uninstall --apply
+npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy uninstall --apply
 ```
 
 To preview the removal first, run the command without `--apply`. Removal uses the receipts in `~/.agent-policy-kit`, so keep that folder. [Updates and removal](docs/guide/updates-and-removal.md#remove-apk) gives the details and the exceptions.
@@ -32,7 +32,7 @@ To preview the removal first, run the command without `--apply`. Removal uses th
 - Your main agent and its model do not change. The main agent still decides when to delegate.
 - APK configures the coding agent of each assistant: Codex in ChatGPT, Claude Code in Claude, Kimi Code, Antigravity for Gemini, and Grok Build. Plain chats do not change. [Assistants](docs/reference/assistants.md) lists the details, also for the desktop apps.
 - APK adds no proxy and no background process. You can delete the npm package after setup.
-- `npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy show` reads your current settings.
+- `npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy show` reads your current settings.
 - Apart from the npm download, APK makes no network requests. [Privacy](docs/guide/privacy.md) tells what it reads and writes.
 
 ## Documentation

package/docs/design/2026-11-01-grok-build-support.md

@@ -28,7 +28,8 @@ Many programmers use Grok Build next to Codex, Claude Code, Kimi Code and Antigr
 ## Later corrections
 
 - 0.5.0: Grok Build 1.0.70 does read a per-role effort from the `effort` field of an agent file, and a model pinned in `[subagents.models]` runs at that model's default effort, not at the main session's effort (#27). APK now writes `effort` when a role pins one. See the AI assistants reference.
-- Grok Build reads agent fields in camelCase, so it ignores `permission_mode: plan`. The Reviewer and Code explorer roles are therefore not read-only in Grok (#30).
+- 0.5.0: Grok Build reads agent fields in camelCase, so it ignores `permission_mode: plan`. The Reviewer and Code explorer roles are therefore not read-only in Grok (#30).
+- 0.5.1: APK writes `capabilityMode: read-only` for the Reviewer and the Code explorer instead of `permission_mode: plan` (#30). Grok Build applies this field when it starts the subagent and removes the built-in tools that edit, write, delete or move files and the shell tool. `permissionMode: plan` has no effect at spawn, so APK does not write it. The bundled read-only agents mentioned above use the same ignored snake_case key. See the AI assistants reference.
 
 ## Out of scope
 

package/docs/guide/commands.md

@@ -9,10 +9,10 @@ APK needs Node.js 22.13 or later in the 22 line, or Node.js 24 or later.
 Run a pinned release with `npx`:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy <command> [options]
+npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy <command> [options]
 ```
 
-- `--package agent-policy-kit@0.5.0` selects the configuration release. The package version is the release version.
+- `--package agent-policy-kit@0.5.1` selects the configuration release. The package version is the release version.
 - `--ignore-scripts` prevents npm install scripts.
 - `--yes` lets npx download the package without a prompt.
 

package/docs/guide/configurator.md

@@ -76,6 +76,8 @@ The **Models & effort** table shows one row for each selected role. It is visibl
 
 Any change to a model or effort sets the assistant to **Custom**. Selecting **Custom** without a change does not change any value. A model ID can have 1 to 128 ASCII characters and no spaces.
 
+When you edit Kimi, Gemini or Grok, a short note above the table tells how that assistant applies effort. Screen readers read the note with the model and effort controls of each role. The **All** view shows no note, because it has no model table.
+
 For Kimi, roles that use the same model alias share one effort. A change to one of these roles changes all of them. For Grok, the page offers the effort levels of the model: low, medium, high and xhigh for Grok 4.7, and none for Grok 4.6, Grok 4.5 and Grok Build 0.1. A custom Grok model ID offers every level that Grok Build accepts. Grok Build applies an effort only when the model supports effort. A Grok role without an effort runs at the default effort of its model. The [assistants reference](../reference/assistants.md) explains these limits.
 
 ### Use the top models switch
@@ -114,7 +116,7 @@ The command always lists every selected assistant and role with its model and ef
 A generated command has this form:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy setup \
+npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy setup \
   --roles 'reviewer,explorer' \
   --max-concurrent 3 \
   --chatgpt 'reviewer=gpt-6.1-sol:high,explorer=gpt-6-luna:high' \
@@ -136,7 +138,7 @@ The [Commands](commands.md#explicit-tool-arguments) reference describes this syn
 Under step 4, the box **You can undo the setup** shows the command that removes the APK settings. The command is pinned to the release of the page, for example:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy uninstall --apply
+npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy uninstall --apply
 ```
 
 The removal restores the settings that you had before APK and keeps your unrelated edits. It uses the receipts that setup saves in the state directory, `~/.agent-policy-kit` by default. Keep this directory.

package/docs/guide/getting-started.md

@@ -49,13 +49,13 @@ For each control on the page, see [Configurator](configurator.md).
 1. Run `doctor` to verify the configuration that APK owns:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy doctor
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy doctor
    ```
 
 2. Run `show` to read the subagent settings that your assistants use now, including settings that you made yourself:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy show
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy show
    ```
 
 A verified configuration does not prove that a provider runs a specific model. For all command options, see [Commands](commands.md).
@@ -91,7 +91,7 @@ Each assistant gets its own native role files and instructions. No central servi
 Run setup with the release input mode:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy setup --release
+npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy setup --release
 ```
 
 This previews the Standard mode. Add `--preset fast` for Light or `--preset quality` for Top-tier. Add `--apply` to write the files. For details, see [Commands](commands.md#release-presets---release-and---preset).

package/docs/guide/preferences.md

@@ -18,7 +18,7 @@ Preferences apply only when the main agent decides to delegate. They do not turn
 1. Create a file with the Standard preset of the release:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy init --policy ./preferences.json
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy init --policy ./preferences.json
    ```
 
 2. Edit the file. Use the rules below.
@@ -112,7 +112,7 @@ Some conditions can only be checked against the native files, for example missin
 APK has no separate validation command. A preview checks the file and writes nothing:
 
 ```sh
-npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy setup --policy ./preferences.json
+npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy setup --policy ./preferences.json
 ```
 
 If the file is not valid, the command fails with `INVALID_POLICY`. The file must be a regular file of at most 64 KiB, not a symbolic link.
@@ -126,13 +126,13 @@ Use one of these methods.
 1. Preview the setup:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy setup --policy ./preferences.json
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy setup --policy ./preferences.json
    ```
 
 2. Apply it:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy setup --policy ./preferences.json --apply
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy setup --policy ./preferences.json --apply
    ```
 
 `--policy` is conservative. If APK already has a setup with other values, it stops with `INSTALLATION_CONFLICT` or `POLICY_CONFLICT`.
@@ -150,7 +150,7 @@ To replace saved values with the values of a file, send the file as `--config`:
 2. Preview the setup with the encoded value:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy setup --config ENCODED_VALUE
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy setup --config ENCODED_VALUE
    ```
 
 3. Run the same command with `--apply`.

package/docs/guide/updates-and-removal.md

@@ -21,7 +21,7 @@ Installing or updating the npm package does not change your native files. Only `
 2. Show the release and its notes with the `release` command:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy release
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy release
    ```
 
 3. Check the installed versions of your assistants and the models that your account can use.
@@ -37,7 +37,7 @@ A release that is not published yet has the heading `VERSION — Unreleased` in
 1. Preview the setup with the release that you want:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy setup --release
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy setup --release
    ```
 
 2. To select another preset, add `--preset fast` (Light) or `--preset quality` (Top-tier). The default is `balanced` (Standard).
@@ -85,7 +85,7 @@ These boundaries are known:
 1. Remove the Claude settings with the installed release (0.4.0 or later), for example:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy uninstall --client claude --apply
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy uninstall --client claude --apply
    ```
 
 2. Set up Claude with 0.3.0.
@@ -124,14 +124,14 @@ APK has no background updater and requests no live model catalog. Your configure
 1. Preview the removal:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy uninstall
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy uninstall
    ```
 
 2. Read the preview.
 3. Remove the configuration:
 
    ```sh
-   npx --yes --ignore-scripts --package agent-policy-kit@0.5.0 agent-policy uninstall --apply
+   npx --yes --ignore-scripts --package agent-policy-kit@0.5.1 agent-policy uninstall --apply
    ```
 
 4. Run `show` to check the current settings.

package/docs/maintainers/verification.md

@@ -14,6 +14,21 @@ A configuration check does not prove native loading. Native loading does not pro
 
 Each record names the platform and the date. Browser evidence, temporary homes, raw configuration fixtures and logs stay outside Git and npm.
 
+## 0.5.1
+
+macOS arm64, 2026-11-01.
+
+| Layer | Evidence |
+|---|---|
+| Full Node 26.5.1 suite | PASS: 387/387. New tests cover the Grok read-only role files, 0.4.0 and 0.5.0 Grok installs that verify, update in place and uninstall, the `show` capability warning, and the assistant notes on the page |
+| Hosted CI | PASS on main 6691f94: macOS Node 22.13.0 and Ubuntu Node 24 suites and the site build ([run](https://github.com/automatis-tools/agent-policy-kit/actions/runs/41381777278)) |
+| Published 0.5.0 to 0.5.1 | PASS in isolated homes with the npm 0.5.0 package and the 0.5.1 tarball, Standard preset. ChatGPT, Claude, Gemini and Grok upgrade to 0.5.1 and move back to 0.5.0 in place. The Grok `apk-reviewer.md` has `capabilityMode: read-only` with 0.5.1 and `permission_mode: plan` again after the move back. Kimi NOT CHECKED with a provisioned model pool: both versions return a prerequisite in an empty home |
+| Grok read-only roles | PASS by source reading and a non-live `grok inspect --json` of Grok Build 1.0.70 with an isolated profile: `capabilityMode` is parsed (an invalid value drops the agent) and `read-only` is listed. A live model task with a read-only role is NOT CHECKED |
+| Browser | PASS in a local Chromium preview: the Kimi, Gemini and Grok notes in their details views, none for ChatGPT and the All view (#33) |
+| Native ChatGPT, Claude, Kimi, Gemini and Grok loading and provider execution | NOT CHECKED for 0.5.1. No live model tasks were used as configuration proof |
+| npm packaging | PASS: `npm pack --dry-run` lists 50 files. No private evidence or configuration |
+| Model catalog | Unchanged from 0.5.0 |
+
 ## 0.5.0
 
 macOS arm64, 2026-11-01.

package/docs/reference/assistants.md

@@ -161,6 +161,25 @@ Issue #27 tested whether a named agent such as `apk-reviewer` can have its own e
 - Grok Build uses this order: a spawn override from the harness, then a Grok role with the same name as the agent (`[subagents.roles.apk-<role>]` or `~/.grok/roles/apk-<role>.toml`), then the agent frontmatter, then the default of the model. The parent model cannot select an effort when it spawns a subagent. APK writes no Grok roles.
 - Not checked: a live model task. Grok Build has no command that shows the resolved subagent effort without a model run. The source is a public sync from 2026-09-29, and the error and log text of these code paths occurs in the 1.0.70 program.
 
+#### Grok read-only roles
+
+Issue #30 tested which field makes the Reviewer and the Code explorer read-only in Grok Build. The result comes from the Grok Build source and from a check with Grok Build 1.0.70:
+
+- Grok Build reads the fields of an agent file in camelCase. It ignores a snake_case key such as `permission_mode` without a warning. Releases 0.4.0 and 0.5.0 wrote `permission_mode: plan`, so their Grok Reviewer and Code explorer had only the prompt as a restriction.
+- Since 0.5.1, APK writes `capabilityMode: read-only` in `~/.grok/agents/apk-reviewer.md` and `~/.grok/agents/apk-explorer.md`.
+- When Grok Build starts a subagent of this type, it removes every built-in tool whose kind is not allowed in read-only mode: the tools that edit, write, delete or move files, the shell tool, the image and video tools, and messages to other active agents. The tools that read, list and search files, the LSP, web search and web fetch, the plan tools and skills stay. Because no edit tool stays, Grok Build also does not add its separate file write tool.
+- The agent file sets an upper limit. A capability mode that the parent or a Grok role requests at spawn cannot widen it: read-only combined with any other mode gives read-only.
+- Grok Build accepts `read-only`, `read-write`, `execute` and `all`, and some spellings of them such as `readOnly`. For any other value, Grok Build drops the whole agent without a warning. `grok inspect --json` with an isolated `GROK_HOME` confirmed both cases. `agent-policy show` reports `UNSUPPORTED_ROLE_CAPABILITY` for such an agent file.
+- `permissionMode: plan` does not make a subagent read-only. Grok Build reads the field, but at spawn it uses only `bypassPermissions`. APK therefore does not write `permissionMode`.
+
+These limits apply:
+
+- Tools from MCP servers have no tool kind, so read-only mode keeps them. An MCP tool that changes files or other systems stays available to the role.
+- If image or video generation is enabled in Grok Build, the source adds these tools to the subagent after the filter. A read-only role can then still generate images or videos.
+- By default a subagent cannot start its own subagents. If you raise the Grok Build subagent depth, it is not checked whether a subagent that a read-only role starts is also read-only.
+- Installs made by 0.4.0 or 0.5.0 keep `permission_mode: plan` until a setup replaces the role files. Use 0.5.1 or later with `--release`, `--preset`, `--config` or explicit tool arguments. A setup without these options reports `unchanged` and keeps the old files.
+- Not checked: a live model task. The spawn path runs only when a model starts a subagent. The source is a public sync from 2026-09-29, and the log text of the capability filter occurs in the 1.0.70 program.
+
 ## Desktop apps
 
 Some desktop apps include their own copy of a CLI and do not put it on `PATH`. On macOS, detection also checks these copies, after `PATH` and the conventional locations:

package/docs/reference/roles.md

@@ -65,7 +65,7 @@ Prompt: "Execute only the prescribed commands or clearly specified mechanical ed
 
 ## Permissions
 
-The Reviewer and the Code explorer are read-only roles. Their prompts tell them not to edit files. Two assistants also restrict them natively:
+The Reviewer and the Code explorer are read-only roles. Their prompts tell them not to edit files. Three assistants also restrict them natively:
 
 | Assistant | Native read-only setting for Reviewer and Code explorer |
 |---|---|
@@ -73,10 +73,12 @@ The Reviewer and the Code explorer are read-only roles. Their prompts tell them
 | Claude | `tools: Read, Grep, Glob` |
 | Kimi | `tools: [Read, Grep, Glob]` |
 | Gemini | None. The prompt is the only restriction. |
-| Grok | None in effect. APK writes `permission_mode: plan`, but Grok Build 1.0.70 reads agent fields in camelCase and ignores this field. The prompt is the only restriction until #30 is fixed. |
+| Grok | `capabilityMode: read-only`. When Grok Build starts the subagent, it removes the tools that edit, write, delete or move files and the shell tool. Tools from MCP servers stay. See [AI assistants](assistants.md#grok-read-only-roles). |
 
 The other four roles get no tool restriction. They use the permissions of the native client.
 
+Grok installs made by 0.4.0 or 0.5.0 have `permission_mode: plan` in these two role files. Grok Build ignores this field, so the prompt is their only restriction. A setup with 0.5.1 or later and `--release`, `--preset`, `--config` or explicit tool arguments replaces the files. See [Updates and removal](../guide/updates-and-removal.md#what-happens-during-an-update).
+
 ## Role file contents
 
 For the file paths, see [AI assistants](assistants.md#files-written). Each file has these fields:
@@ -87,7 +89,7 @@ For the file paths, see [AI assistants](assistants.md#files-written). Each file
 | Claude | Markdown with frontmatter | `name`, `description`, `model`, `effort` (only when pinned), `tools` (read-only roles); the body is the prompt |
 | Kimi | Markdown with frontmatter | `name`, `description`, `tools` (read-only roles); the body is the prompt and a routing note |
 | Gemini | Markdown with frontmatter | `name`, `description`, `model` (the tier), `subagent: true`; the body is the prompt |
-| Grok | Markdown with frontmatter | `name`, `description`, `effort` (only when pinned), `permission_mode: plan` (read-only roles); the body is the prompt |
+| Grok | Markdown with frontmatter | `name`, `description`, `effort` (only when pinned), `capabilityMode: read-only` (read-only roles); the body is the prompt |
 
 - Kimi frontmatter does not select a model. The routing note in the body names the pool alias and the requested effort. The parent selects the alias when it spawns the subagent.
 - Grok takes the model of each role from `[subagents.models]` in `config.toml`, not from the role file.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-policy-kit",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Configure native subagent settings across AI assistants, then exit",
   "type": "module",
   "license": "MIT",
@@ -65,5 +65,5 @@
   "bugs": {
     "url": "https://github.com/automatis-tools/agent-policy-kit/issues"
   },
-  "homepage": "https://agent-policy-kit.trymenow.io/v/0.5.0/"
+  "homepage": "https://agent-policy-kit.trymenow.io/v/0.5.1/"
 }

package/site/index.html

@@ -7,9 +7,9 @@
 <meta name="description" content="Configure local subagent roles, models and effort with Agent Policy Kit, an open source tool by Mykola Maksymenko.">
 <meta name="author" content="Mykola Maksymenko">
 <link rel="author" href="https://www.linkedin.com/in/nick-maximenko/">
-<link rel="canonical" href="https://agent-policy-kit.trymenow.io/v/0.5.0/">
+<link rel="canonical" href="https://agent-policy-kit.trymenow.io/v/0.5.1/">
 <title>Agent Policy Kit — by Mykola Maksymenko</title>
-<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"Person","@id":"https://www.linkedin.com/in/nick-maximenko/#person","name":"Mykola Maksymenko","url":"https://www.linkedin.com/in/nick-maximenko/"},{"@type":"SoftwareSourceCode","@id":"https://github.com/automatis-tools/agent-policy-kit#software","name":"Agent Policy Kit","description":"Configure native subagent settings across AI assistants, then exit","url":"https://agent-policy-kit.trymenow.io/","codeRepository":"https://github.com/automatis-tools/agent-policy-kit","author":{"@id":"https://www.linkedin.com/in/nick-maximenko/#person"}},{"@type":"WebPage","@id":"https://agent-policy-kit.trymenow.io/v/0.5.0/#webpage","name":"Agent Policy Kit — by Mykola Maksymenko","url":"https://agent-policy-kit.trymenow.io/v/0.5.0/","author":{"@id":"https://www.linkedin.com/in/nick-maximenko/#person"},"mainEntity":{"@id":"https://github.com/automatis-tools/agent-policy-kit#software"},"mentions":[{"@type":"SoftwareSourceCode","name":"Agents Can Communicate","codeRepository":"https://github.com/automatis-tools/agents-can-communicate"},{"@type":"SoftwareSourceCode","name":"Automatis Skills","codeRepository":"https://github.com/automatis-tools/automatis-skills"}]}]}</script>
+<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"Person","@id":"https://www.linkedin.com/in/nick-maximenko/#person","name":"Mykola Maksymenko","url":"https://www.linkedin.com/in/nick-maximenko/"},{"@type":"SoftwareSourceCode","@id":"https://github.com/automatis-tools/agent-policy-kit#software","name":"Agent Policy Kit","description":"Configure native subagent settings across AI assistants, then exit","url":"https://agent-policy-kit.trymenow.io/","codeRepository":"https://github.com/automatis-tools/agent-policy-kit","author":{"@id":"https://www.linkedin.com/in/nick-maximenko/#person"}},{"@type":"WebPage","@id":"https://agent-policy-kit.trymenow.io/v/0.5.1/#webpage","name":"Agent Policy Kit — by Mykola Maksymenko","url":"https://agent-policy-kit.trymenow.io/v/0.5.1/","author":{"@id":"https://www.linkedin.com/in/nick-maximenko/#person"},"mainEntity":{"@id":"https://github.com/automatis-tools/agent-policy-kit#software"},"mentions":[{"@type":"SoftwareSourceCode","name":"Agents Can Communicate","codeRepository":"https://github.com/automatis-tools/agents-can-communicate"},{"@type":"SoftwareSourceCode","name":"Automatis Skills","codeRepository":"https://github.com/automatis-tools/automatis-skills"}]}]}</script>
 <!-- Public Sans is embedded under the SIL Open Font License.
 Copyright 2015 The Public Sans Project Authors (https://github.com/uswds/public-sans)
 
@@ -224,7 +224,7 @@ header,main,footer{width:min(calc(100% - 64px),920px);margin-inline:auto}header{
 .tag-box{display:flex;flex-wrap:wrap;align-items:center;gap:8px;min-height:56px;padding:10px 12px;background:var(--white);border:1px solid var(--line);border-radius:7px}.tag-box:focus-within{outline:2px solid var(--accent);outline-offset:2px}.empty{padding:5px 1px;font-size:var(--text-ui);color:var(--muted)}.suggestions{display:flex;flex-wrap:wrap;gap:8px;margin-top:10px;min-height:34px}.suggestion{padding:6px 11px;border:1px dashed var(--line);border-radius:5px;background:var(--white);color:var(--ink);font-size:var(--text-ui);line-height:1.4;font-weight:400}.suggestion:hover{border-color:var(--brand-blue);background:var(--control-hover);color:var(--accent)}.plus{color:var(--accent);margin-right:5px}
 .tag{display:inline-flex;align-items:center;min-height:32px;overflow:hidden;border:1px solid var(--line);border-radius:5px;background:var(--control-hover);color:var(--ink);font-size:var(--text-ui);line-height:1.4;font-weight:500}.tag-label{padding:5px 10px}.remove{display:grid;place-items:center;align-self:stretch;width:26px;border:0;border-left:1px solid var(--line);background:transparent;color:inherit;font-size:16px;font-weight:400}.remove:hover{background:var(--control-hover)}
 .tool-group{display:flex;gap:4px;min-height:54px;padding:4px;border:1px solid var(--line);border-radius:7px;background:var(--paper)}.tool-group .tool-scope{flex:1;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:3px;min-width:0;min-height:44px;padding:8px 28px 8px 13px;border:0;border-radius:5px;background:transparent;color:var(--ink);font-size:var(--text-ui);font-weight:500;line-height:1.4}.tool-group .tool-scope small{border-radius:3px;font-size:var(--text-meta);font-weight:400;line-height:1.5;color:var(--muted)}.tool-group .tool-scope:hover{background:var(--control-hover);color:var(--accent)}.tool-item.active .tool-scope{background:transparent;color:var(--accent);font-weight:600}.tool-item.active{box-shadow:inset 0 -2px 0 var(--brand-blue)}.tool-item{position:relative;display:flex;flex:1;min-width:0;border:1px solid var(--line);border-radius:5px;background:var(--control-hover)}.tool-item .tool-scope{width:100%}.tool-remove{position:absolute;right:4px;top:50%;transform:translateY(-50%);display:grid;place-items:center;width:24px;height:30px;border:0;border-radius:4px;background:transparent;color:var(--muted);font-size:15px;opacity:.8}.tool-item.active .tool-remove{color:var(--muted)}.tool-remove:hover{background:var(--control-hover);opacity:1}.tool-item.active .tool-remove:hover{background:var(--control-hover);color:var(--accent)}
-.mode-heading{display:flex;align-items:center;justify-content:space-between;margin:0 0 16px}.scope-label{display:inline-block;padding:3px 6px;margin-left:-6px;border-radius:4px;color:var(--muted);font-size:var(--text-support);line-height:1.5}.mode-placeholder{padding:20px;border:1px dashed var(--line);border-radius:7px;color:var(--muted);font-size:var(--text-support)}#mode-options{position:relative;display:grid;grid-template-columns:repeat(4,minmax(0,1fr));margin:0 0 16px}#mode-options::before{content:"";position:absolute;top:13px;left:12.5%;right:12.5%;height:2px;background:var(--line)}.mode-option{position:relative;z-index:1;display:grid;grid-template-rows:20px auto;align-content:start;align-items:center;justify-items:center;gap:10px;padding:4px;text-align:center;font-size:var(--text-ui);font-weight:400;line-height:1.5;cursor:pointer}.mode-option input{appearance:none;position:relative;z-index:1;width:10px;height:10px;margin:0;border:0;border-radius:50%;background:var(--muted);cursor:pointer}.mode-option input:checked{width:18px;height:18px;border:3px solid var(--white);box-shadow:0 0 0 2px var(--brand-blue);background:var(--brand-blue)}.mode-option input:checked+span{color:var(--accent);font-weight:600}.mode-option:has(input:disabled){cursor:default}.notice{padding:0;margin:0 0 14px;color:var(--muted);font-size:var(--text-support);line-height:1.6}.tools-notice{margin:12px 0 0}
+.mode-heading{display:flex;align-items:center;justify-content:space-between;margin:0 0 16px}.scope-label{display:inline-block;padding:3px 6px;margin-left:-6px;border-radius:4px;color:var(--muted);font-size:var(--text-support);line-height:1.5}.mode-placeholder{padding:20px;border:1px dashed var(--line);border-radius:7px;color:var(--muted);font-size:var(--text-support)}#mode-options{position:relative;display:grid;grid-template-columns:repeat(4,minmax(0,1fr));margin:0 0 16px}#mode-options::before{content:"";position:absolute;top:13px;left:12.5%;right:12.5%;height:2px;background:var(--line)}.mode-option{position:relative;z-index:1;display:grid;grid-template-rows:20px auto;align-content:start;align-items:center;justify-items:center;gap:10px;padding:4px;text-align:center;font-size:var(--text-ui);font-weight:400;line-height:1.5;cursor:pointer}.mode-option input{appearance:none;position:relative;z-index:1;width:10px;height:10px;margin:0;border:0;border-radius:50%;background:var(--muted);cursor:pointer}.mode-option input:checked{width:18px;height:18px;border:3px solid var(--white);box-shadow:0 0 0 2px var(--brand-blue);background:var(--brand-blue)}.mode-option input:checked+span{color:var(--accent);font-weight:600}.mode-option:has(input:disabled){cursor:default}.notice{padding:0;margin:0 0 14px;color:var(--muted);font-size:var(--text-support);line-height:1.6}.tools-notice{margin:12px 0 0}.assistant-note{margin:0;max-width:70ch}
 .advanced{border-top:1px solid var(--line);padding-top:12px}.advanced summary{width:fit-content;color:var(--accent);font-size:var(--text-support);line-height:1.5;cursor:pointer}.editor{display:grid;grid-template-columns:140px minmax(0,1fr) minmax(0,1fr);gap:16px;align-items:end;margin-top:16px}.editor label{display:block;margin-bottom:7px;color:var(--muted);font-size:var(--text-support);line-height:1.4}.editor select{appearance:none;width:100%;min-width:0;height:42px;padding:0 32px 0 10px;border:1px solid var(--line);border-radius:5px;background:var(--white) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none'%3E%3Cpath d='m4 6 4 4 4-4' stroke='%2359657a' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") no-repeat right 10px center/16px 16px;color:var(--ink);font-size:var(--text-ui)}.efforts{display:flex;gap:3px;align-items:center;min-height:42px;padding:3px;border:1px solid var(--line);border-radius:6px;background:var(--paper)}.efforts button{flex:1;min-height:32px;padding:5px;border:0;border-radius:4px;background:transparent;color:var(--muted);font-size:var(--text-support)}.efforts button[aria-pressed=true]{background:var(--control-hover);color:var(--accent);font-weight:600;box-shadow:inset 0 0 0 1px var(--brand-blue)}.unavailable{width:100%;text-align:center;color:var(--muted);font-size:var(--text-support)}.role-description{margin:10px 0 0;color:var(--muted);font-size:var(--text-support);line-height:1.6}
 .output{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:start;gap:12px 20px;padding:18px 20px;border:1px solid var(--line);border-radius:6px;background:var(--paper)}.output[data-ready=true]{border-color:var(--brand-blue)}.output strong{font-size:var(--text-ui);font-weight:600;line-height:1.5}.output p{margin:5px 0 0;color:var(--muted);font-size:var(--text-support);line-height:1.6}.output p:empty{display:none}.output p a{color:var(--accent);text-underline-offset:3px}.output[data-ready=false] .primary{background:var(--line);border-color:var(--line);color:var(--muted);opacity:1}.primary{white-space:nowrap}
 footer{display:grid;gap:14px;margin-top:20px;padding:16px 0 24px;border-top:1px solid var(--line);color:var(--muted);font-size:var(--text-meta);line-height:1.6}.footer-row{display:flex;justify-content:space-between;align-items:baseline;gap:8px 24px;flex-wrap:wrap}.footer-attribution{display:flex;align-items:baseline;gap:4px 24px;flex-wrap:wrap;font-size:var(--text-meta)}.footer-attribution nav{display:flex;align-items:baseline;gap:4px 10px;flex-wrap:wrap}
@@ -316,7 +316,7 @@ section[aria-labelledby=helpers-heading]{view-transition-name:step-helpers}secti
 <div class="builder">
 <section aria-labelledby="helpers-heading"><div class="step-heading"><span class="step-number">1</span><h2 id="helpers-heading" tabindex="-1">Subagent roles</h2></div><div class="tag-box" id="selected-helpers" role="group" aria-label="Selected subagent roles"></div><div class="suggestions" id="helper-options" role="group" aria-label="Available subagent roles"></div></section>
 <section aria-labelledby="tools-heading"><div class="step-heading"><span class="step-number">2</span><h2 id="tools-heading" tabindex="-1">AI assistants</h2></div><div class="tool-group" id="selected-tools" role="group" aria-label="Selected AI assistants"></div><div class="suggestions" id="tool-options" role="group" aria-label="Available AI assistants"></div><p class="notice tools-notice" id="tools-notice" role="note" hidden></p></section>
-<section aria-labelledby="mode-heading"><div class="step-heading"><span class="step-number">3</span><h2 id="mode-heading" tabindex="-1">Work mode</h2></div><div id="mode-empty" class="mode-placeholder">Choose subagent roles and AI assistants above.</div><div id="mode-panel" hidden><div class="mode-heading"><span class="scope-label" id="scope-label">All selected AI assistants</span></div><div id="mode-options" role="radiogroup" aria-label="Work mode"></div><p class="notice" id="mode-notice" hidden></p><div class="top-models" id="top-models" hidden><button type="button" role="switch" id="top-models-toggle" aria-checked="false"><span class="switch-track" aria-hidden="true"></span><span id="top-models-label">Use top models for code, review and tests</span></button></div><section class="advanced" id="advanced" aria-label="Models and effort"><h3>Models &amp; effort</h3><div id="editor"></div><div class="concurrency" id="concurrency-panel" hidden><h3>Parallel subagents</h3><div class="concurrency-row"><label for="max-concurrent" id="concurrency-label">Max per session</label><div class="concurrency-stepper" role="group" aria-label="Maximum concurrent subagents"><button id="decrease-concurrency" type="button" aria-label="Decrease maximum concurrent subagents">−</button><input id="max-concurrent" type="number" min="1" max="32" step="1" value="3" inputmode="numeric" aria-describedby="concurrency-error"><button id="increase-concurrency" type="button" aria-label="Increase maximum concurrent subagents">+</button></div></div><p class="field-error" id="concurrency-error" role="status" hidden>Enter a whole number from 1 to 32.</p></div></section></div></section>
+<section aria-labelledby="mode-heading"><div class="step-heading"><span class="step-number">3</span><h2 id="mode-heading" tabindex="-1">Work mode</h2></div><div id="mode-empty" class="mode-placeholder">Choose subagent roles and AI assistants above.</div><div id="mode-panel" hidden><div class="mode-heading"><span class="scope-label" id="scope-label">All selected AI assistants</span></div><div id="mode-options" role="radiogroup" aria-label="Work mode"></div><p class="notice" id="mode-notice" hidden></p><div class="top-models" id="top-models" hidden><button type="button" role="switch" id="top-models-toggle" aria-checked="false"><span class="switch-track" aria-hidden="true"></span><span id="top-models-label">Use top models for code, review and tests</span></button></div><section class="advanced" id="advanced" aria-label="Models and effort"><h3>Models &amp; effort</h3><p class="notice assistant-note" id="assistant-note" role="note" hidden></p><div id="editor"></div><div class="concurrency" id="concurrency-panel" hidden><h3>Parallel subagents</h3><div class="concurrency-row"><label for="max-concurrent" id="concurrency-label">Max per session</label><div class="concurrency-stepper" role="group" aria-label="Maximum concurrent subagents"><button id="decrease-concurrency" type="button" aria-label="Decrease maximum concurrent subagents">−</button><input id="max-concurrent" type="number" min="1" max="32" step="1" value="3" inputmode="numeric" aria-describedby="concurrency-error"><button id="increase-concurrency" type="button" aria-label="Increase maximum concurrent subagents">+</button></div></div><p class="field-error" id="concurrency-error" role="status" hidden>Enter a whole number from 1 to 32.</p></div></section></div></section>
 
 <section aria-labelledby="setup-heading"><div class="step-heading"><span class="step-number">4</span><h2 id="setup-heading">Copy setup command</h2><span class="step-hint" id="step-hint-4" role="status" aria-live="polite" aria-atomic="true" hidden></span></div><div class="output" data-ready="false"><div class="setup-result"><div aria-live="polite" aria-atomic="true"><strong id="setup-summary">Complete the steps above.</strong><p id="setup-description">Choose a subagent role in step 1 and an AI assistant in step 2.</p></div><textarea class="setup-command" id="setup-command" readonly aria-label="Setup command" wrap="soft" rows="1" hidden></textarea><p id="copy-feedback" role="status" hidden></p></div><button class="button primary" id="copy" type="button" aria-describedby="setup-description" disabled>Copy command</button></div><div class="setup-footer"><p class="release-status" id="release-status"></p><button type="button" class="reset-form" id="reset-form">Reset form</button></div><div class="undo" role="group" aria-labelledby="undo-title" aria-describedby="undo-text"><strong id="undo-title">You can undo the setup</strong><p id="undo-text">Removal restores the settings you had before APK and keeps your unrelated edits.</p><div class="undo-command"><code id="undo-command"></code><button type="button" class="quiet-button" id="copy-undo" aria-label="Copy the uninstall command">Copy</button></div><p class="undo-feedback" id="undo-feedback" role="status"></p></div></section>
 </div>
@@ -325,7 +325,7 @@ section[aria-labelledby=helpers-heading]{view-transition-name:step-helpers}secti
 <footer><div class="footer-row footer-details"><span class="show-settings">Check current settings <button type="button" class="quiet-button" id="copy-show" aria-label="Copy the command that shows current settings">Copy</button><code id="show-command" hidden></code></span><div class="footer-attribution"><span>by <a rel="author" href="https://www.linkedin.com/in/nick-maximenko/">Mykola Maksymenko</a></span><nav aria-label="Related projects"><span>More tools:</span><a href="https://github.com/automatis-tools/agents-can-communicate">Agents Can Communicate</a> <a href="https://github.com/automatis-tools/automatis-skills">Automatis Skills</a></nav></div></div></footer>
 <script>
 'use strict';
-const RELEASE = {"schemaVersion":1,"version":"0.5.0","preset":"balanced","presets":[{"id":"fast","label":"Light","description":"Light models for every role. Limits last longest.","preferences":{"schemaVersion":1,"maxConcurrent":2,"clients":{"chatgpt":{"code":{"model":"gpt-6-luna","effort":"high"},"light":{"model":"gpt-6-luna","effort":"low"},"avoidModels":[]},"claude":{"code":{"model":"claude-haiku-5-5","effort":"medium"},"light":{"model":"claude-haiku-5-5","effort":"low"},"roles":{"reviewer":{"model":"claude-haiku-5-5","effort":"high"},"tester":{"model":"claude-haiku-5-5","effort":"high"}},"avoidModels":[]},"kimi":{"code":{"model":"kimi-code/kimi-for-coding","effort":"low"},"light":{"model":"kimi-code/kimi-for-coding","effort":"low"},"avoidModels":[]},"gemini":{"code":{"model":"flash","effort":null},"light":{"model":"flash_lite","effort":null},"avoidModels":[]},"grok":{"code":{"model":"grok-build-0.1","effort":null},"light":{"model":"grok-build-0.1","effort":null},"avoidModels":[]}}}},{"id":"balanced","label":"Standard","description":"Stronger models for code, review, tests and docs. Fits most plans.","preferences":{"schemaVersion":1,"maxConcurrent":3,"clients":{"chatgpt":{"code":{"model":"gpt-6.1-sol","effort":"medium"},"light":{"model":"gpt-6-luna","effort":"low"},"roles":{"reviewer":{"model":"gpt-6.1-sol","effort":"high"},"explorer":{"model":"gpt-6-luna","effort":"high"},"tester":{"model":"gpt-6.1-sol","effort":"high"},"writer":{"model":"gpt-6.1-terra","effort":"medium"}},"avoidModels":[]},"claude":{"code":{"model":"claude-sonnet-5-5","effort":"high"},"light":{"model":"claude-haiku-5-5","effort":"low"},"roles":{"explorer":{"model":"claude-haiku-5-5","effort":"medium"},"writer":{"model":"claude-sonnet-5-5","effort":"medium"}},"avoidModels":[]},"kimi":{"code":{"model":"kimi-code/k3-256k","effort":"high"},"light":{"model":"kimi-code/kimi-for-coding","effort":"low"},"roles":{"writer":{"model":"kimi-code/k3-256k","effort":"high"}},"avoidModels":[]},"gemini":{"code":{"model":"pro","effort":null},"light":{"model":"flash_lite","effort":null},"roles":{"explorer":{"model":"flash","effort":null},"writer":{"model":"flash","effort":null}},"avoidModels":[]},"grok":{"code":{"model":"grok-4.7","effort":null},"light":{"model":"grok-build-0.1","effort":null},"roles":{"writer":{"model":"grok-4.7","effort":null}},"avoidModels":[]}}}},{"id":"quality","label":"Top-tier","description":"High-end models for most roles. Uses limits fastest.","topModels":{"chatgpt":{"model":"gpt-6-astra","effort":"high"},"claude":{"model":"claude-opus-5-5","effort":"xhigh"},"kimi":{"model":"kimi-code/k3.1-pro","effort":"high"}},"preferences":{"schemaVersion":1,"maxConcurrent":2,"clients":{"chatgpt":{"code":{"model":"gpt-6.1-sol","effort":"high"},"light":{"model":"gpt-6.1-sol","effort":"medium"},"avoidModels":[]},"claude":{"code":{"model":"claude-opus-5-5","effort":"high"},"light":{"model":"claude-sonnet-5-5","effort":"medium"},"roles":{"explorer":{"model":"claude-opus-5-5","effort":"medium"},"writer":{"model":"claude-opus-5-5","effort":"medium"}},"avoidModels":[]},"kimi":{"code":{"model":"kimi-code/k3","effort":"high"},"light":{"model":"kimi-code/kimi-for-coding","effort":"high"},"roles":{"explorer":{"model":"kimi-code/k3","effort":"high"},"writer":{"model":"kimi-code/k3","effort":"high"}},"avoidModels":[]},"gemini":{"code":{"model":"pro","effort":null},"light":{"model":"flash","effort":null},"roles":{"explorer":{"model":"pro","effort":null},"writer":{"model":"pro","effort":null}},"avoidModels":[]},"grok":{"code":{"model":"grok-4.7","effort":null},"light":{"model":"grok-build-0.1","effort":null},"roles":{"explorer":{"model":"grok-4.7","effort":null},"writer":{"model":"grok-4.7","effort":null}},"avoidModels":[]}}}}],"catalogReviewedAt":"2026-11-02","preferencesHash":"87086ab43ff48d4b30fefc0989ea9b86684f0374369486ba197900c13a9eb1ce","notes":"# Changelog\n\nEach npm version is one configuration release: its presets, native role definitions, instructions and configuration page. Published versions are not rewritten. Applying another release is explicit; package installation alone changes no settings.\n\n## 0.5.0 — 2026-11-01\n\n### Why this release\n\nThree follow-ups from the 2026-11-01 model review needed released configuration changes. Primary Anthropic data showed that Sonnet 5.5 at medium is too weak for the Standard Coder (#29). Grok Build turned out to accept a reasoning effort per role, and APK described its Grok effort behavior wrongly (#27). Claude 4.5 models approach retirement, and the `sonnet` alias still points at Sonnet 4.5 on some providers (#28). The release also makes undo visible, so people can apply a setup without fear, and keeps the share link short until a setup is complete.\n\n### Who should update\n\n- Anyone who uses the Standard preset with Claude.\n- Anyone who uses Grok Build and wants a different effort per role.\n- Everyone else can update for the clearer undo guidance and the corrected Grok and Claude information. Light and Top-tier values do not change.\n\n### Migration and rollback\n\nAssistant IDs, preset ids, share-link format v2 and receipt format v4 are unchanged. Setup with 0.5.0 replaces a 0.4.0 installation in place, and setup with 0.4.0 moves back in place, for ChatGPT, Claude, Gemini and Grok. A Grok role effort written by 0.5.0 is removed when 0.4.0 writes its role files. Kimi was not checked with a provisioned model pool. The Claude boundary to 0.3.0 and earlier from 0.4.0 still applies to receipts from 0.5.0: see the [migration boundaries](docs/guide/updates-and-removal.md#migration-boundaries).\n\n### Presets and model catalog\n\n- **Standard, Claude:** the Coder uses Sonnet 5.5 at high instead of medium (#29). Anthropic's per-effort data puts Sonnet 5.5 at medium 8.6 to 14.2 points below high on Terminal-Bench 4.0, FrontierCode and CursorBench, and Opus 5.5 at medium costs more per solved task on every measurement. Claude subagents without a named role in Standard also move from medium to high, so they use more of the plan. Reviewer and Test writer keep Sonnet 5.5 at high.\n- **Grok:** Grok 4.7 lists the native levels low, medium, high and xhigh, with high as its default. Grok 4.6, Grok 4.5 and Grok Build 0.1 offer no effort. Grok presets keep the native default, and there is still no Grok top choice (#27).\n- **Claude lifecycle:** Sonnet 4.5 is labelled \"Sonnet 4.5 (retires 2026-11-30)\" and records its deprecation date, its replacement and the partner schedules: Bedrock Legacy with end of life 2027-04-08, and no date on Google managed. Opus 4.5 and Haiku 4.5 stay active as legacy models without a deprecation notice (#28). The catalog review date is 2026-11-02.\n\nConfiguration checks are not model-quality evaluations.\n\n### What changed\n\n- Grok: each role can pin a reasoning effort. Setup writes `effort: \u003clevel>` in `~/.grok/agents/apk-\u003crole>.md`; a role without an effort gets no line. `--grok` accepts `role=model:effort` and `role=model:native`; `role=model` still means the native default and produces the same files as before. The configurator offers effort buttons for Grok 4.7 and custom model IDs, share links keep a Grok effort, and `agent-policy show` reports the effort of each Grok agent.\n- Fixed: APK no longer says that Grok subagents use the main session effort. APK pins each role's model, so a role without an effort runs at that model's default (Grok 4.7: high). The setup warning `grok-per-role-effort-unsupported` is replaced by `grok-effort-model-dependent`.\n- The README and step 4 of the configurator show how to undo a setup: the uninstall command pinned to the release, with a copy button. Removal restores the settings you had before APK and keeps your unrelated edits.\n- The configurator puts a `#setup=` share link in the address only when steps 1–3 are complete. Opening the page, Reset form, or a change that leaves a step incomplete removes the link. Existing links, including links to unfinished forms, still open as before.\n- Docs: the AI assistants reference shows which 4.5 models the Claude `sonnet`, `haiku` and `default` aliases resolve to on Bedrock, Google Agent Platform, Microsoft Foundry and Claude Platform on AWS, and tells Foundry users to pin a newer Sonnet before 2026-11-30. The model review cites primary sources for the Opus 5.5 and Sonnet 5.5 equal-effort numbers and records the Standard Claude Coder decision.\n- Docs: Grok Build ignores the `permission_mode` field that APK writes for read-only roles, so the Grok Reviewer and Code explorer are not read-only yet (#30).\n\n## 0.4.0 — 2026-11-01\n\n### Why this release\n\nThe presets and the model catalog were checked again on 2026-11-01 against the installed native clients and current vendor documentation. No vendor released or retired a subagent model since 2026-10-30. The new evidence changes where effort is spent, and it shows that Claude's top model is Opus 5.5, not Fable 5.1.\n\n### Who should update\n\n- Anyone who uses ChatGPT or Claude presets and wants the revised effort levels.\n- Anyone who uses the Top-tier top models switch in Claude.\n- Claude Code 2.1.316+ users who want subagents without a named role to stop inheriting the main session effort.\n\nKimi, Gemini and Grok preset values do not change, so their 0.3.0 installations need no update.\n\n### Migration and rollback\n\nAssistant IDs, preset ids (`fast`, `balanced`, `quality`), share-link format v2 and receipt format v4 are unchanged. Setup with 0.4.0 replaces a 0.3.0 installation in place, and receipts written by 0.3.0 still validate and uninstall. Setup with 0.3.0 moves ChatGPT, Kimi, Gemini and Grok back.\n\nClaude has a migration boundary in the downgrade direction. A 0.4.0 Claude receipt owns a third setting, `CLAUDE_CODE_SUBAGENT_EFFORT`, whenever the Coder effort is pinned, and every preset pins it. Version 0.3.0 does not know this setting, so its setup reports `INVALID_RECEIPT` and changes nothing. To move Claude back to 0.3.0, first remove its settings with 0.4.0: `npx --yes --ignore-scripts --package agent-policy-kit@0.4.0 agent-policy uninstall --client claude --apply`. Then set up with 0.3.0. This was checked with the 0.3.0 source in an isolated home. Removal restores the value that the setting had before setup, or removes it. Share links of 0.3.0 open on the 0.3.0 page.\n\n### Presets and model catalog\n\nRe-running setup applies these values. Installations keep their current values until then.\n\n- **Light, ChatGPT:** the Coder runs Luna at high instead of medium, the starting level OpenAI suggests for Luna. Luna stays the cheapest Codex model.\n- **Standard, ChatGPT:** the Docs writer uses GPT-6.1 Terra at medium instead of GPT-6.1 Sol. OpenAI positions Terra for clear writing, at half of Sol's usage.\n- **Top-tier, ChatGPT and Claude:** the Code explorer and Docs writer keep GPT-6.1 Sol and Opus 5.5 but run at medium instead of high. Implementation, review and tests stay at high.\n- **Top models switch, Claude:** Coder, Reviewer and Test writer use Opus 5.5 at xhigh instead of Fable 5.1 at high. Anthropic's own benchmarks put Opus 5.5 ahead of Fable 5.1 on every published coding benchmark at 2.5 times lower price, and Anthropic suggests a higher Opus effort before Fable. Fable 5.1 stays available in Custom. The switch now sets a model and an effort; ChatGPT and Kimi keep GPT-6 Astra and K3.1 Pro at high.\n\nThe catalog snapshot is dated 2026-11-01:\n\n- GPT-5.5 is marked retired from Codex for ChatGPT sign-in on 2026-10-14; it remains for API-key sign-in.\n- GPT-6 Astra's native default effort is medium in the signed-in server catalog; the bundled value low is kept as `bundledDefaultEffort`. The hidden, undocumented `gpt-reserve` selector is excluded.\n- Claude Code 2.1.316, Kimi Code 2.4.1 and Antigravity 1.4.12 are the observed client versions. Opus 4.5 and Haiku 4.5 record their earliest retirement dates.\n- Kimi records plan requirements: K3 and K3.1 Pro need Plus or higher, and the 1M context of K3 needs Pro or higher.\n- Antigravity's Flash Lite tier is marked undocumented: the CLI accepts it, but the subagent documentation lists only inherit, Flash and Pro.\n- Grok 4.7's reasoning levels (low to xhigh) are recorded as API capabilities. APK still writes only a model for each Grok role, so subagents use the main session effort.\n\nConfiguration checks are not model-quality evaluations.\n\n### What changed\n\n- Claude: setup also writes `CLAUDE_CODE_SUBAGENT_EFFORT`, the effort for subagents that name none, from the Coder effort capped at high. Claude Code 2.1.316 added this setting; earlier versions ignore it. Before, those subagents kept the main session effort.\n- `agent-policy show` reports the stored Claude default subagent effort and a `CLAUDE_CODE_SUBAGENT_EFFORT` environment override.\n- The top models switch label shows each tool's model and effort.\n- The website deployment guard also compares `src/release.mjs` with the release tag, because the page embeds its preset labels and top choices.\n- The configurator shows a note when Gemini is selected: APK configures Antigravity, not Gemini CLI. The README and the AI assistants reference say the same.\n- The documentation is reorganized into independent documents by audience: `docs/guide/` for people who use APK, `docs/reference/` for facts about assistants, roles, presets, the catalog and ownership, `docs/research/` for the evidence behind presets, and `docs/maintainers/` for development, releases and the website. [docs/README.md](docs/README.md) is the index. Old `docs/*.md` paths are removed without redirects. The 2026-11-01 model review is documented in [docs/research/2026-11-01-model-review.md](docs/research/2026-11-01-model-review.md).\n\n## 0.3.0 — 2026-11-01\n\n### Why this release\n\nPeople know their assistants as ChatGPT, Claude, Kimi, Gemini and Grok, not by the names of the coding agents inside them. The configurator and the CLI now use those names. Some people use only the desktop apps, and they have no CLI on PATH. Before this release, setup found nothing for them.\n\n### Who should update\n\n- Anyone who uses Codex in ChatGPT Desktop or Claude Code in the Code tab of Claude Desktop on macOS without a separate CLI.\n- Anyone who wants the general assistant names on the page and in the terminal.\n\nPreset values do not change, so an installation of 0.2.0 keeps working without an update.\n\n### Breaking change\n\nAI assistants now have general names: ChatGPT, Claude, Kimi, Gemini and Grok. APK still configures their coding agents: Codex, Claude Code, Kimi Code, Antigravity and Grok Build. Two technical IDs changed, and there is no migration:\n\n- `codex` is now `chatgpt`: `--chatgpt`, `--chatgpt-max-concurrent`, `--avoid-chatgpt`, `--client chatgpt` and the `clients.chatgpt` policy key.\n- `agy` is now `gemini`: `--gemini`, `--gemini-max-concurrent`, `--avoid-gemini`, `--client gemini` and the `clients.gemini` policy key.\n- Warning and error codes follow the new IDs, for example `chatgpt-native-precedence-limits` and `CHATGPT_CAP_ALIAS_CONFLICT`.\n\nBefore you use this version, remove the APK settings for these two assistants with the version that created them: `npx --yes --ignore-scripts --package agent-policy-kit@0.2.0 agent-policy uninstall --apply`. This version does not read the old `codex` and `agy` installation receipts, so its setup refuses the existing `apk-*` files as unowned. Policy files and share links that use the old IDs are refused too. Claude, Kimi and Grok keep their IDs.\n\n### Migration and rollback\n\nThe two renamed IDs set a migration boundary. These results come from tests with the published 0.2.0 package and this release:\n\n- **ChatGPT (Codex) and Gemini (Antigravity):** remove the APK settings with the version that created them before you set up with the other version. A move in either direction without removal reports `OWNERSHIP_CONFLICT` and changes nothing. After removal, setup with the other version succeeds.\n- **Claude, Kimi and Grok:** their IDs and receipt format v4 are unchanged. In the tests, setup with 0.3.0 upgraded 0.2.0 installations of Claude and Grok in place, and setup with 0.2.0 moved Claude back. Kimi uses the same receipt format, but it was not tested with a provisioned model pool.\n\n`uninstall --apply` removes the settings of every assistant. Run setup again afterwards for the assistants you use.\n\n### Presets and model catalog\n\nPreset models, effort levels and parallel limits are the same as in 0.2.0. Only the keys `codex` and `agy` became `chatgpt` and `gemini`, and the catalog labels became the general names. The model catalog snapshot is still dated 2026-10-30, with the Grok entries checked on 2026-11-01. Configuration checks are not model-quality evaluations.\n\n### What changed\n\n- The configurator calls the second step \"AI assistants\" and shows the general names. Readable CLI output uses the same names.\n- On macOS, setup finds the Codex that ChatGPT Desktop includes and the Claude Code in the Code tab of Claude Desktop, also when no CLI is on PATH. Both apps read the same settings as their CLIs. A CLI on PATH or in a conventional location still has priority. Detect output reports these clients with `origin: \"desktop_app\"`. Claude Cowork reads its settings from the Claude account, so APK does not configure it.\n\n## 0.2.0 — 2026-11-01\n\n### Why this release\n\nSubagents draw on the same plan limits as the main session, and every parallel session adds to that usage. Without explicit choices, subagents can inherit the most expensive model and use up a weekly limit within days. This release names the work modes by how much of a plan subagents may use, adds per-tool parallel limits, a read-only settings check and Grok Build support.\n\n### Who should update\n\nAnyone who wants Grok Build roles, per-tool parallel limits or the renamed modes. Re-running setup with 0.2.0 applies the new preset values: Top-tier now uses Opus 5.5, GPT-6.1 Sol and K3 at high effort, with top models behind an opt-in switch, and Kimi's Standard Docs writer uses K3 256K. Installations of 0.1.0 keep working unchanged until setup is run again.\n\n### Migration and rollback\n\nPreset ids (`fast`, `balanced`, `quality`), receipt format v4 and ownership, drift and rollback behavior are unchanged. Version 1 share links still open; new links use version 2 and carry each tool's parallel limit. Applying 0.1.0 again restores its owned settings, as the synthetic upgrade/downgrade gate verifies. Grok Build is new, so it has nothing to migrate.\n\n### Presets and model catalog\n\nThe model catalog snapshot is dated 2026-10-30; Grok Build entries were checked on 2026-11-01 against the Grok Build 1.0.70 user guide and the xAI model list. An independent audit compared every preset, tool and role with the catalog and the documentation tables, and a test now keeps those tables in sync. Configuration checks are not model-quality evaluations.\n\n### What changed\n\n- Add Grok Build as a fifth coding tool, listed after Antigravity. APK writes `agents/apk-\u003crole>.md` role files (Reviewer and Code explorer use the read-only `permission_mode: plan`), per-role models and a `general-purpose` fallback copied from the first selected role (the Coder when selected) in `config.toml` `[subagents.models]`, a native `[subagents] max_concurrent` cap and a delegation block in `AGENTS.md` under `$GROK_HOME` (default `~/.grok`). Per-role effort is not configurable, so every Grok choice has effort null and the page shows no effort controls. Presets use Grok Build 0.1, xAI's fast coding model, for light work and Grok 4.7 for stronger roles; Grok 4.6 and 4.5 stay available in Custom. Explicit commands use `--grok`, `--grok-max-concurrent` and `--avoid-grok`. Removal restores the original settings and refuses on local edits.\n\n- Rename work modes to Light, Standard and Top-tier and describe them by how much of a plan's limits subagents use. Preset ids and share-link ids are unchanged. Top-tier now uses Opus 5.5, GPT-6.1 Sol and K3 at high effort for code, review and tests. A per-tool switch under Top-tier opts those roles into Fable 5.1, GPT-6 Astra or K3.1 Pro; it is off by default. Top models no longer run at xhigh/max, because native default subagent settings copy the first selected role (the Coder when selected) to subagents started without a named role.\n\n- Explain each configuration step with a short ? note, and stop repeating vendor billing or version documentation in the work-mode notice.\n\n- Start a fresh or reset form with every subagent role selected, and give the empty coding-tool field the same appearance as the empty role field.\n\n- Automatically deploy the latest website from verified main while preserving exact tagged release pages and older share links. Configuration guards keep commands pinned to published package capabilities; npm releases remain explicit.\n\n- Credit Mykola Maksymenko in the configuration page and package metadata. Link the supplied LinkedIn profile and related projects, with static author/project structured data and a release-specific canonical URL.\n\n- Interactive terminals get readable setup, doctor, release and show output; captured output keeps the existing JSON contract, and `--json` forces JSON.\n\n- `agent-policy show` reads the current user-level subagent settings of every tool, before or after APK installation, without writing files. The page footer offers it as \"Check current settings\" with a copy button.\n\n- Each tool has its own parallel limit from 1 to 32, set in its details on the page or with `--TOOL-max-concurrent`; policies accept `clients[tool].maxConcurrent`.\n\n- The page adds Add all for roles and tools, a GitHub link in the header, Reset form beside the release line, and preset switching for a single selected tool without a needless confirmation.\n\n## 0.1.0 — 2026-10-30\n\n### Why this release\n\nUse a common approach to optional delegation across Codex, Claude Code, Kimi and Antigravity, without an extra process in normal agent operation. Configure once and remove the installer afterward.\n\n### What it configures\n\nSix focused roles cover implementation, read-only review, code discovery, test creation, documentation and prescribed execution. Each preset assigns a model and supported effort to every role; the [preset matrix](docs/reference/presets.md) explains the choices.\n\nThese are starting preferences, not model-quality benchmarks. Native model formats and alias behavior were reviewed against the official sources linked in [support](docs/reference/assistants.md) and [model maintenance](docs/maintainers/model-review.md). Model availability must be checked before applying. Provider aliases and tiers may resolve differently over time.\n\n### Presets and model catalog\n\nAll three presets were rebuilt for public use. Personal Astra/Opus/Fable and other avoid lists were removed. Fast gives review and testing more reasoning than simple execution. Balanced separates implementation, verification, discovery, documentation and mechanics. Quality uses Astra/Fable for demanding work and regular K3.1 Pro at max for Kimi code/review/tests. Claude recommendations pin current versioned IDs; Kimi Balanced uses the quota-conscious K3 256K variant. These are editable recommendations, not benchmark results.\n\nThe release contains a dated model/effort catalog from official documentation and native selector observations, including native-default effort and account-dependent availability. Antigravity role choices are native tiers, with no invented per-role effort setting.\n\nCatalog audit, 2026-10-30 UTC: Kimi now lists all six current models, including K3.1 Pro and Pro Highspeed. Quality first now uses regular K3.1 Pro at max effort for implementation/review/tests; other roles have separate choices described in the preset matrix. Highspeed remains optional because its faster output consumes about twice regular Pro's quota, according to Kimi. Setup requires provisioned access and does not silently fall back to another model.\n\nBoth Pro variants require compatible thinking settings. Even with unpinned effort, setup refuses an explicit thinking-disabled setting without modifying it.\n\nCodex effort choices/defaults now follow CLI 0.166.0 rather than API defaults; API metadata remains separate, and Ultra stays separate from ordinary effort. Claude Opus 4.5 no longer advertises an API-only native effort override. Existing custom inputs using levels outside the current native catalog require review before reapplication; owned inspection/removal remains independent of current recommendations. Sonnet 4.5 remains selectable with its Anthropic deprecation status marked. Antigravity CLI's four tier choices are unchanged.\n\n### What changed\n\n- Added Test writer and Docs writer; clarified Code explorer and Task runner. Old four-role native v2/v3 receipts remain supported, including explicit expansion to six, owned removal, drift refusal and late rollback. New v4 snapshots support six independently configured Kimi aliases.\n\n- Readable type uses a compact 36/20/15/13 px scale with more spacing; narrow layouts stack model controls and command actions.\n- A short collapsible explanation introduces role-specific models, native setup and optional delegation, using the same wording as the README.\n- The builder now starts with no roles, tools or chosen modes. Green checks track completed selections and successful copy, and Reset form restores a blank state. URL fragments restore visible settings without a backend. Conditional section hints and changed step markers use a two-second highlight hold plus two-second fade, respecting reduced motion. Selection controls share a soft treatment; Copy remains the primary action.\n- Page commands always list every selected role/model/effort under its tool, including presets. Explicit --roles, --max-concurrent and optional --avoid-TOOL preserve the existing selection, cap and guidance. :native represents unpinned effort; Antigravity remains tier-only. The shared codec validates complete role maps and rejects duplicate/mixed input before writes. Legacy release/config/policy inputs remain supported.\n- The four-step page now selects subagent roles and coding tools before mode/model/effort configuration. It generates and copies a real pinned command. Tool additions preserve All or a manually selected view. Role help uses the same prompt definitions as native generation.\n- Optional selectedRoles creates only the requested native roles. Receipt v4 binds that role set to owned files and supports safe expansion, reduction and removal. Earlier v2/v3 native receipts retain their historical four-role ownership boundary. Unselected Kimi aliases do not need provisioning or effort pins.\n- Native role files and routing instructions apply only when the main agent chooses delegation. Main models and disabled delegation features are preserved.\n- A static page lets each tool use its own mode and per-task models/effort. All shows mixed settings as Custom and can apply one preset to every tool. Scope warnings protect individual and global replacements; the page generates one pinned command.\n- Explicit release application supports safe upgrade/downgrade of owned settings; per-client receipts record the actual applied version and custom choices.\n- Ownership/drift checks, private backups and rollback preserve unrelated settings and earlier user values.\n- No custom hooks, proxy, plugin, launcher, daemon or normal-operation runtime is installed.\n\n### Who should use it\n\nPeople who want consistent subagent preferences across their installed coding tools. You can keep the recommendations or select different native models in the configuration page.\n\n### Applying this version\n\n```sh\nnpx --yes --ignore-scripts --package agent-policy-kit@0.1.0 agent-policy setup --release --apply\n```\n\nWithout --apply the same command previews the changes. The page-generated explicit tool arguments apply the visible choices using this release's native templates. See [release usage](docs/guide/updates-and-removal.md).\n\n### Migration and limits\n\nThis is the first public release. Synthetic versions in tests are not real releases. Experimental runtime receipts from older development commits require their original owned removal. Supported native snapshot formats can be updated safely; unknown future formats/layouts are refused.\n\nKimi/Antigravity concurrency guidance and native tier/precedence limits remain explicit. A pinned release reproduces declared configuration, not provider weights, entitlement or model quality.\n","packageSpec":"agent-policy-kit@0.5.0","preferences":{"schemaVersion":1,"maxConcurrent":3,"clients":{"chatgpt":{"code":{"model":"gpt-6.1-sol","effort":"medium"},"light":{"model":"gpt-6-luna","effort":"low"},"roles":{"reviewer":{"model":"gpt-6.1-sol","effort":"high"},"explorer":{"model":"gpt-6-luna","effort":"high"},"tester":{"model":"gpt-6.1-sol","effort":"high"},"writer":{"model":"gpt-6.1-terra","effort":"medium"}},"avoidModels":[]},"claude":{"code":{"model":"claude-sonnet-5-5","effort":"high"},"light":{"model":"claude-haiku-5-5","effort":"low"},"roles":{"explorer":{"model":"claude-haiku-5-5","effort":"medium"},"writer":{"model":"claude-sonnet-5-5","effort":"medium"}},"avoidModels":[]},"kimi":{"code":{"model":"kimi-code/k3-256k","effort":"high"},"light":{"model":"kimi-code/kimi-for-coding","effort":"low"},"roles":{"writer":{"model":"kimi-code/k3-256k","effort":"high"}},"avoidModels":[]},"gemini":{"code":{"model":"pro","effort":null},"light":{"model":"flash_lite","effort":null},"roles":{"explorer":{"model":"flash","effort":null},"writer":{"model":"flash","effort":null}},"avoidModels":[]},"grok":{"code":{"model":"grok-4.7","effort":null},"light":{"model":"grok-build-0.1","effort":null},"roles":{"writer":{"model":"grok-4.7","effort":null}},"avoidModels":[]}}},"hostedReleases":[],"catalog":{"schemaVersion":1,"reviewedAt":"2026-11-02","scope":"Documented/native coding-tool selectors at this release; account access and custom deployment IDs vary.","clients":{"chatgpt":{"label":"ChatGPT","efforts":["none","minimal","low","medium","high","xhigh","max"],"observedClientVersion":"0.166.0","observation":"codex debug models --bundled: 9 visible selectors; 3 hidden specialized/utility entries excluded. The signed-in server catalog (2026-11-01) lists 8 visible selectors without GPT-5.5, the hidden gpt-reserve entry and a medium default for GPT-6 Astra.","models":[{"id":"gpt-6-astra","label":"GPT-6 Astra","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-6-astra","kind":"model","apiEfforts":["low","medium","high","xhigh","max"],"apiDefaultEffort":null,"nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"],"bundledDefaultEffort":"low"},{"id":"gpt-6.1-sol","label":"GPT-6.1 Sol","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"low","source":"https://developers.openai.com/api/docs/models/gpt-6.1-sol","kind":"model","apiEfforts":["low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-6.1-terra","label":"GPT-6.1 Terra","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"low","source":"https://developers.openai.com/api/docs/models/gpt-6.1-terra","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-6-sol","label":"GPT-6 Sol","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-6-sol","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-6-luna","label":"GPT-6 Luna","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-6-luna","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models"},{"id":"gpt-5.6-sol","label":"GPT-5.6 Sol","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"low","source":"https://developers.openai.com/api/docs/models/gpt-5.6-sol","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-5.6-terra","label":"GPT-5.6 Terra","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-5.6-terra","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-5.6-luna","label":"GPT-5.6 Luna","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-5.6-luna","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models"},{"id":"gpt-5.5","label":"GPT-5.5 (API key only)","efforts":["low","medium","high","xhigh"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-5.5","kind":"model","apiEfforts":["none","low","medium","high","xhigh"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","lifecycle":{"status":"retired","retirementDate":"2026-10-14","scope":"Codex with ChatGPT sign-in; API-key sign-in keeps access","source":"https://learn.chatgpt.com/docs/models"}}],"excluded":[{"id":"gpt-daybreak-blue-latest","reason":"hidden specialized selector"},{"id":"gpt-daybreak-red-latest","reason":"hidden specialized selector"},{"id":"codex-auto-review","reason":"hidden internal utility selector"},{"id":"gpt-reserve","reason":"hidden undocumented selector in the server catalog"}],"note":"Efforts follow the bundled Codex CLI 0.166.0 catalog. Defaults follow the signed-in server catalog of 2026-11-01 where it differs (bundledDefaultEffort keeps the bundled value). API capabilities are separate apiEfforts/apiDefaultEffort metadata. Ultra is a delegating execution mode, recorded separately and not offered as ordinary subagent effort. An API-supported level absent from the native catalog is unverified for manual per-role configuration, not proven runtime-rejected. GPT-5.5 left Codex for ChatGPT sign-in on 2026-10-14 and remains for API-key sign-in."},"claude":{"label":"Claude","efforts":["low","medium","high","xhigh","max"],"observedClientVersion":"2.1.316","models":[{"id":"sonnet","label":"Sonnet (alias)","efforts":["low","medium","high","xhigh","max"],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"alias","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."},{"id":"opus","label":"Opus (alias)","efforts":["low","medium","high","xhigh","max"],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"alias","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."},{"id":"haiku","label":"Haiku (alias)","efforts":["low","medium","high","xhigh","max"],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"alias","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."},{"id":"fable","label":"Fable (alias)","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/sub-agents#choose-a-model","kind":"alias","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."},{"id":"claude-fable-5-1","label":"Fable 5.1","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-5-5","label":"Opus 5.5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-sonnet-5-5","label":"Sonnet 5.5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-haiku-5-5","label":"Haiku 5.5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-fable-5","label":"Fable 5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-5","label":"Opus 5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-sonnet-5","label":"Sonnet 5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-4-8","label":"Opus 4.8","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-4-7","label":"Opus 4.7","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"xhigh","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-4-6","label":"Opus 4.6","efforts":["low","medium","high","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-sonnet-4-6","label":"Sonnet 4.6","efforts":["low","medium","high","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-4-5-20251101","label":"Opus 4.5","efforts":[],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config#adjust-effort-level","kind":"model","apiEfforts":["low","medium","high"],"apiDefaultEffort":null,"apiSource":"https://platform.claude.com/docs/en/build-with-claude/effort","lifecycle":{"status":"active","earliestRetirement":"2026-11-24","scope":"Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) and Microsoft Foundry","note":"Legacy model with no deprecation notice. The date is a floor, not a scheduled retirement; Anthropic gives at least 60 days' notice.","partners":[{"platform":"Google Cloud (Google managed)","earliestRetirement":"2026-11-24","source":"https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deprecations/partner-models"}],"source":"https://platform.claude.com/docs/en/about-claude/model-deprecations"}},{"id":"claude-sonnet-4-5-20250929","label":"Sonnet 4.5 (retires 2026-11-30)","efforts":[],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"model","lifecycle":{"status":"deprecated","deprecationDate":"2026-09-30","retirementDate":"2026-11-30","replacement":"claude-sonnet-5-5","scope":"Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) and Microsoft Foundry","partners":[{"platform":"Amazon Bedrock","status":"legacy","endOfLife":"2027-04-08","source":"https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle-legacy.html"},{"platform":"Google Cloud (Google managed)","note":"No retirement date announced. The earliest retirement date, 2026-09-29, passed.","source":"https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude/sonnet-4-5"}],"source":"https://platform.claude.com/docs/en/about-claude/model-deprecations"}},{"id":"claude-haiku-4-5-20251001","label":"Haiku 4.5","efforts":[],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"model","lifecycle":{"status":"active","earliestRetirement":"2026-10-15","scope":"Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) and Microsoft Foundry","note":"Legacy model with no deprecation notice. The earliest retirement date passed without an announcement.","partners":[{"platform":"Google Cloud (Google managed)","earliestRetirement":"2026-12-07","source":"https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deprecations/partner-models"}],"source":"https://platform.claude.com/docs/en/about-claude/model-deprecations"}},{"id":"inherit","label":"Inherit main model","efforts":["low","medium","high","xhigh","max"],"defaultEffort":null,"source":"https://code.claude.com/docs/en/sub-agents","kind":"inherit","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."}],"note":"Full model IDs use the current Claude Code native effort table, which differs from API support for Opus 4.5. Alias/inherit efforts are possible requested levels, not a guarantee for every resolved provider model; unsupported levels can clamp or be ignored. Current account access and provider alias resolution vary. Claude Code 2.1.316 adds CLAUDE_CODE_SUBAGENT_EFFORT for subagents that name no effort; earlier versions ignore it. CLAUDE_CODE_EFFORT_LEVEL still overrides subagent effort frontmatter.","excluded":[{"id":"best","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"},{"id":"default","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"},{"id":"opus[1m]","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"},{"id":"opusplan","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"},{"id":"sonnet[1m]","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"}]},"kimi":{"label":"Kimi","efforts":["low","medium","high","xhigh","max"],"models":[{"id":"kimi-code/k3.1-pro","label":"K3.1 Pro","efforts":["low","high","max"],"defaultEffort":"high","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"k3.1-pro","thinkingRequired":true},{"id":"kimi-code/k3.1-pro-highspeed","label":"K3.1 Pro Highspeed","efforts":["low","high","max"],"defaultEffort":"high","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"k3.1-pro-highspeed","thinkingRequired":true},{"id":"kimi-code/k3","label":"K3","efforts":["low","high","max"],"defaultEffort":"high","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"k3","planRequirement":"Plus (Moderato) or higher; 1M context requires Pro (Allegretto) or higher"},{"id":"kimi-code/k3-256k","label":"K3 · 256K","efforts":["low","high","max"],"defaultEffort":"high","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"k3-256k"},{"id":"kimi-code/kimi-for-coding","label":"K2.8 Preview","efforts":["low","high","max"],"defaultEffort":"max","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"kimi-for-coding"},{"id":"kimi-code/kimi-for-coding-highspeed","label":"K2.7 Code HighSpeed","efforts":[],"defaultEffort":null,"source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"kimi-for-coding-highspeed"}],"note":"Current Kimi Code docs list six model IDs; the older kimi.ai/help page still lists four. K3.1 Pro and Highspeed require thinking and support low/high/max, default high. These are preferred native aliases: setup resolves a missing preferred alias only to a unique provisioned match; no provider identity is invented. Account tier controls access. K3 and K3.1 Pro require the Plus (Moderato) plan or higher. The 1M context of K3 and every Highspeed model require Pro (Allegretto) or higher; on Plus, k3 stays at 256K context and uses about twice the quota of k3-256k. K2.7 Code HighSpeed uses about three times the quota.","observedClientVersion":"2.4.1","observation":"Kimi Code CLI 2.4.0 and 2.4.1: all six documented preferred aliases and native effort/default capabilities corroborated through whitelisted provisioned metadata; no credentials or custom account aliases retained."},"gemini":{"label":"Gemini","efforts":[],"observedClientVersion":"1.4.12","models":[{"id":"pro","label":"Pro","efforts":[],"defaultEffort":null,"source":"https://antigravity.google/docs/subagents?tab=cli","kind":"tier"},{"id":"flash","label":"Flash","efforts":[],"defaultEffort":null,"source":"https://antigravity.google/docs/subagents?tab=cli","kind":"tier"},{"id":"flash_lite","label":"Flash Lite","efforts":[],"defaultEffort":null,"source":"https://antigravity.google/docs/subagents?tab=cli","kind":"tier","documented":false,"nativeSource":"Antigravity CLI 1.4.12 agent-file parser"},{"id":"inherit","label":"Inherit main model","efforts":[],"defaultEffort":null,"source":"https://antigravity.google/docs/subagents?tab=cli","kind":"tier"}],"note":"Native per-subagent selectors are tiers, not the session model inventory. The CLI 1.4.12 parser accepts inherit/flash_lite/flash/pro; the public subagent documentation lists only inherit, flash and pro, so flash_lite is undocumented. Google does not document which Gemini model each tier uses; the server sets it per account. Per-role effort is not exposed by the agent-file schema; --effort and /effort apply to the whole session."},"grok":{"label":"Grok","efforts":["low","medium","high","xhigh","max"],"observedClientVersion":"1.0.70","models":[{"id":"grok-4.7","label":"Grok 4.7","efforts":["low","medium","high","xhigh"],"defaultEffort":"high","source":"https://docs.x.ai/developers/models","nativeSource":"https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md","kind":"model","apiEfforts":["low","medium","high","xhigh"],"apiDefaultEffort":"high"},{"id":"grok-4.6","label":"Grok 4.6","efforts":[],"defaultEffort":null,"source":"https://docs.x.ai/developers/models","nativeSource":"https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md","kind":"model"},{"id":"grok-4.5","label":"Grok 4.5","efforts":[],"defaultEffort":null,"source":"https://docs.x.ai/developers/models","nativeSource":"https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md","kind":"model"},{"id":"grok-build-0.1","label":"Grok Build 0.1","efforts":[],"defaultEffort":null,"source":"https://docs.x.ai/developers/models","nativeSource":"https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md","kind":"model"}],"note":"Per-subagent models are set in config.toml [subagents.models]; model IDs follow the documented xAI model list and account access varies. APK writes a role effort as effort in the agent frontmatter (agents/apk-\u003crole>.md); Grok Build 1.0.70 accepts low/medium/high/xhigh/max there and drops the whole agent for any other value. The effort applies only when the model supports effort: Grok 4.7 lists low/medium/high/xhigh with default high, Grok Build 0.1 has no configurable effort, and the effort levels of Grok 4.6 and 4.5 are not verified. A role without an effort runs at the default effort of its pinned model, not at the main session effort; a role named like the agent ([subagents.roles.\u003cagent>] reasoning_effort) or a harness spawn override wins over the frontmatter. [subagents] max_concurrent is a native cap."}}},"roles":[{"id":"worker","name":"Coder","kind":"code","assignment":"scoped implementation and fixes","description":"Implements scoped changes, preserves peers' edits, and verifies the result.","prompt":"Implement the assigned change or fix within the assigned files. You share the workspace with other agents: preserve their edits. Verify the result and report changes, checks, and remaining limitations. Do not create child agents; return any need for further delegation to the parent."},{"id":"reviewer","name":"Reviewer","kind":"code","assignment":"read-only correctness, security and regression review","description":"Reviews correctness, security and regressions without edits; reports actionable evidence.","prompt":"Review the assigned change without editing files. Find actionable correctness, security, and regression issues. Report each finding with file and line evidence and explain its impact; distinguish confirmed issues from uncertainty. Do not create child agents; return any need for further delegation to the parent."},{"id":"explorer","name":"Code explorer","kind":"light","assignment":"read-only code and documentation discovery","description":"Maps code and documentation, cites sources, and separates facts from uncertainty.","prompt":"Explore the assigned code and documentation without editing files. Return a concise map or factual answer with source paths or citations. Distinguish verified facts from assumptions and unknowns. Do not create child agents; return any need for further delegation to the parent."},{"id":"tester","name":"Test writer","kind":"code","assignment":"test creation and targeted execution","description":"Writes behavior and edge-case tests, reproduces issues, and runs targeted checks.","prompt":"Own the assigned tests and targeted execution. Reproduce the issue or establish a baseline, then test observable behavior and edge cases. Never weaken checks to make them pass. Do not edit application code unless explicitly assigned. Preserve peers' edits and report results and limitations. Do not create child agents; return any need for further delegation to the parent."},{"id":"writer","name":"Docs writer","kind":"light","assignment":"assigned documentation, examples and release notes","description":"Updates assigned docs and examples, verifies claims, and keeps terminology consistent.","prompt":"Update only the assigned documentation, examples, or release notes. Verify claims against code or cited sources and use consistent terminology. Do not edit application code. Preserve peers' edits and report changes and unknowns. Do not create child agents; return any need for further delegation to the parent."},{"id":"routine","name":"Task runner","kind":"light","assignment":"explicit commands and mechanical edits","description":"Runs prescribed commands and mechanical edits; returns ambiguous decisions to the parent.","prompt":"Execute only the prescribed commands or clearly specified mechanical edits. Preserve other agents' work and report the outcome. Do not make ambiguous design or behavior decisions; return those decisions to the parent. Do not create child agents; return any need for further delegation to the parent."}],"unreleased":false};
+const RELEASE = {"schemaVersion":1,"version":"0.5.1","preset":"balanced","presets":[{"id":"fast","label":"Light","description":"Light models for every role. Limits last longest.","preferences":{"schemaVersion":1,"maxConcurrent":2,"clients":{"chatgpt":{"code":{"model":"gpt-6-luna","effort":"high"},"light":{"model":"gpt-6-luna","effort":"low"},"avoidModels":[]},"claude":{"code":{"model":"claude-haiku-5-5","effort":"medium"},"light":{"model":"claude-haiku-5-5","effort":"low"},"roles":{"reviewer":{"model":"claude-haiku-5-5","effort":"high"},"tester":{"model":"claude-haiku-5-5","effort":"high"}},"avoidModels":[]},"kimi":{"code":{"model":"kimi-code/kimi-for-coding","effort":"low"},"light":{"model":"kimi-code/kimi-for-coding","effort":"low"},"avoidModels":[]},"gemini":{"code":{"model":"flash","effort":null},"light":{"model":"flash_lite","effort":null},"avoidModels":[]},"grok":{"code":{"model":"grok-build-0.1","effort":null},"light":{"model":"grok-build-0.1","effort":null},"avoidModels":[]}}}},{"id":"balanced","label":"Standard","description":"Stronger models for code, review, tests and docs. Fits most plans.","preferences":{"schemaVersion":1,"maxConcurrent":3,"clients":{"chatgpt":{"code":{"model":"gpt-6.1-sol","effort":"medium"},"light":{"model":"gpt-6-luna","effort":"low"},"roles":{"reviewer":{"model":"gpt-6.1-sol","effort":"high"},"explorer":{"model":"gpt-6-luna","effort":"high"},"tester":{"model":"gpt-6.1-sol","effort":"high"},"writer":{"model":"gpt-6.1-terra","effort":"medium"}},"avoidModels":[]},"claude":{"code":{"model":"claude-sonnet-5-5","effort":"high"},"light":{"model":"claude-haiku-5-5","effort":"low"},"roles":{"explorer":{"model":"claude-haiku-5-5","effort":"medium"},"writer":{"model":"claude-sonnet-5-5","effort":"medium"}},"avoidModels":[]},"kimi":{"code":{"model":"kimi-code/k3-256k","effort":"high"},"light":{"model":"kimi-code/kimi-for-coding","effort":"low"},"roles":{"writer":{"model":"kimi-code/k3-256k","effort":"high"}},"avoidModels":[]},"gemini":{"code":{"model":"pro","effort":null},"light":{"model":"flash_lite","effort":null},"roles":{"explorer":{"model":"flash","effort":null},"writer":{"model":"flash","effort":null}},"avoidModels":[]},"grok":{"code":{"model":"grok-4.7","effort":null},"light":{"model":"grok-build-0.1","effort":null},"roles":{"writer":{"model":"grok-4.7","effort":null}},"avoidModels":[]}}}},{"id":"quality","label":"Top-tier","description":"High-end models for most roles. Uses limits fastest.","topModels":{"chatgpt":{"model":"gpt-6-astra","effort":"high"},"claude":{"model":"claude-opus-5-5","effort":"xhigh"},"kimi":{"model":"kimi-code/k3.1-pro","effort":"high"}},"preferences":{"schemaVersion":1,"maxConcurrent":2,"clients":{"chatgpt":{"code":{"model":"gpt-6.1-sol","effort":"high"},"light":{"model":"gpt-6.1-sol","effort":"medium"},"avoidModels":[]},"claude":{"code":{"model":"claude-opus-5-5","effort":"high"},"light":{"model":"claude-sonnet-5-5","effort":"medium"},"roles":{"explorer":{"model":"claude-opus-5-5","effort":"medium"},"writer":{"model":"claude-opus-5-5","effort":"medium"}},"avoidModels":[]},"kimi":{"code":{"model":"kimi-code/k3","effort":"high"},"light":{"model":"kimi-code/kimi-for-coding","effort":"high"},"roles":{"explorer":{"model":"kimi-code/k3","effort":"high"},"writer":{"model":"kimi-code/k3","effort":"high"}},"avoidModels":[]},"gemini":{"code":{"model":"pro","effort":null},"light":{"model":"flash","effort":null},"roles":{"explorer":{"model":"pro","effort":null},"writer":{"model":"pro","effort":null}},"avoidModels":[]},"grok":{"code":{"model":"grok-4.7","effort":null},"light":{"model":"grok-build-0.1","effort":null},"roles":{"explorer":{"model":"grok-4.7","effort":null},"writer":{"model":"grok-4.7","effort":null}},"avoidModels":[]}}}}],"catalogReviewedAt":"2026-11-02","preferencesHash":"87086ab43ff48d4b30fefc0989ea9b86684f0374369486ba197900c13a9eb1ce","notes":"# Changelog\n\nEach npm version is one configuration release: its presets, native role definitions, instructions and configuration page. Published versions are not rewritten. Applying another release is explicit; package installation alone changes no settings.\n\n## 0.5.1 — 2026-11-01\n\n### Why this release\n\nThe Grok Reviewer and Code explorer roles were not read-only (#30). Releases 0.4.0 and 0.5.0 wrote `permission_mode: plan` in their role files. Grok Build reads the fields of an agent file in camelCase, so it ignored this key without a warning, and the prompt was the only restriction. A role file template reaches your setup only through a new release.\n\n### Who should update\n\n- Anyone who uses Grok Build with APK and wants the Reviewer and the Code explorer to be read-only.\n- Other assistants get no configuration change. Their role files, presets and the model catalog are the same as in 0.5.0.\n\n### Migration and rollback\n\nAssistant IDs, preset ids, share-link format v2 and receipt format v4 are unchanged. `doctor` and `show` of 0.5.1 read installations and receipts from 0.4.0 and 0.5.0. Setup with 0.5.1 and `--release`, `--preset`, `--config` or explicit tool arguments replaces their Grok role files in place. A setup without these options reports `unchanged` and keeps the old role files. Setup with 0.5.0 or 0.4.0 moves Grok back in place and writes `permission_mode: plan` again. `uninstall` of 0.5.1 removes a 0.4.0, 0.5.0 or 0.5.1 installation. This was checked for Grok with the published 0.4.0 and 0.5.0 packages in isolated homes and with `grok inspect --json` of Grok Build 1.0.70. The [migration boundaries](docs/guide/updates-and-removal.md#migration-boundaries) of earlier releases still apply.\n\n### What changed\n\n- Grok: the Reviewer and the Code explorer role files have `capabilityMode: read-only` instead of `permission_mode: plan` (#30). When Grok Build starts a subagent of this type, it removes the built-in tools that edit, write, delete or move files and the shell tool. A capability mode requested at spawn cannot widen it. Tools from MCP servers stay, and image or video tools can stay when they are enabled. See [Grok read-only roles](docs/reference/assistants.md#grok-read-only-roles).\n- Grok: APK does not write `permissionMode: plan`. Grok Build reads this field, but at spawn it uses only `bypassPermissions`.\n- `show` reports `UNSUPPORTED_ROLE_CAPABILITY` for a Grok agent file whose `capabilityMode` Grok Build does not accept. Grok Build drops such an agent without a warning.\n- Not checked: a live Grok model task with a read-only role.\n- Configuration page: when you edit Kimi, Gemini or Grok alone, a short note above the model table tells how that assistant applies effort. Kimi shares one effort among the roles that use the same model alias. Gemini has native tiers only and no effort per role. Grok applies an effort only for models that support it, and a role without one runs at its model default. The **All** view shows no note. The unused note text in the page source is removed (#21).\n\n## 0.5.0 — 2026-11-01\n\n### Why this release\n\nThree follow-ups from the 2026-11-01 model review needed released configuration changes. Primary Anthropic data showed that Sonnet 5.5 at medium is too weak for the Standard Coder (#29). Grok Build turned out to accept a reasoning effort per role, and APK described its Grok effort behavior wrongly (#27). Claude 4.5 models approach retirement, and the `sonnet` alias still points at Sonnet 4.5 on some providers (#28). The release also makes undo visible, so people can apply a setup without fear, and keeps the share link short until a setup is complete.\n\n### Who should update\n\n- Anyone who uses the Standard preset with Claude.\n- Anyone who uses Grok Build and wants a different effort per role.\n- Everyone else can update for the clearer undo guidance and the corrected Grok and Claude information. Light and Top-tier values do not change.\n\n### Migration and rollback\n\nAssistant IDs, preset ids, share-link format v2 and receipt format v4 are unchanged. Setup with 0.5.0 replaces a 0.4.0 installation in place, and setup with 0.4.0 moves back in place, for ChatGPT, Claude, Gemini and Grok. A Grok role effort written by 0.5.0 is removed when 0.4.0 writes its role files. Kimi was not checked with a provisioned model pool. The Claude boundary to 0.3.0 and earlier from 0.4.0 still applies to receipts from 0.5.0: see the [migration boundaries](docs/guide/updates-and-removal.md#migration-boundaries).\n\n### Presets and model catalog\n\n- **Standard, Claude:** the Coder uses Sonnet 5.5 at high instead of medium (#29). Anthropic's per-effort data puts Sonnet 5.5 at medium 8.6 to 14.2 points below high on Terminal-Bench 4.0, FrontierCode and CursorBench, and Opus 5.5 at medium costs more per solved task on every measurement. Claude subagents without a named role in Standard also move from medium to high, so they use more of the plan. Reviewer and Test writer keep Sonnet 5.5 at high.\n- **Grok:** Grok 4.7 lists the native levels low, medium, high and xhigh, with high as its default. Grok 4.6, Grok 4.5 and Grok Build 0.1 offer no effort. Grok presets keep the native default, and there is still no Grok top choice (#27).\n- **Claude lifecycle:** Sonnet 4.5 is labelled \"Sonnet 4.5 (retires 2026-11-30)\" and records its deprecation date, its replacement and the partner schedules: Bedrock Legacy with end of life 2027-04-08, and no date on Google managed. Opus 4.5 and Haiku 4.5 stay active as legacy models without a deprecation notice (#28). The catalog review date is 2026-11-02.\n\nConfiguration checks are not model-quality evaluations.\n\n### What changed\n\n- Grok: each role can pin a reasoning effort. Setup writes `effort: \u003clevel>` in `~/.grok/agents/apk-\u003crole>.md`; a role without an effort gets no line. `--grok` accepts `role=model:effort` and `role=model:native`; `role=model` still means the native default and produces the same files as before. The configurator offers effort buttons for Grok 4.7 and custom model IDs, share links keep a Grok effort, and `agent-policy show` reports the effort of each Grok agent.\n- Fixed: APK no longer says that Grok subagents use the main session effort. APK pins each role's model, so a role without an effort runs at that model's default (Grok 4.7: high). The setup warning `grok-per-role-effort-unsupported` is replaced by `grok-effort-model-dependent`.\n- The README and step 4 of the configurator show how to undo a setup: the uninstall command pinned to the release, with a copy button. Removal restores the settings you had before APK and keeps your unrelated edits.\n- The configurator puts a `#setup=` share link in the address only when steps 1–3 are complete. Opening the page, Reset form, or a change that leaves a step incomplete removes the link. Existing links, including links to unfinished forms, still open as before.\n- Docs: the AI assistants reference shows which 4.5 models the Claude `sonnet`, `haiku` and `default` aliases resolve to on Bedrock, Google Agent Platform, Microsoft Foundry and Claude Platform on AWS, and tells Foundry users to pin a newer Sonnet before 2026-11-30. The model review cites primary sources for the Opus 5.5 and Sonnet 5.5 equal-effort numbers and records the Standard Claude Coder decision.\n- Docs: Grok Build ignores the `permission_mode` field that APK writes for read-only roles, so the Grok Reviewer and Code explorer are not read-only yet (#30).\n\n## 0.4.0 — 2026-11-01\n\n### Why this release\n\nThe presets and the model catalog were checked again on 2026-11-01 against the installed native clients and current vendor documentation. No vendor released or retired a subagent model since 2026-10-30. The new evidence changes where effort is spent, and it shows that Claude's top model is Opus 5.5, not Fable 5.1.\n\n### Who should update\n\n- Anyone who uses ChatGPT or Claude presets and wants the revised effort levels.\n- Anyone who uses the Top-tier top models switch in Claude.\n- Claude Code 2.1.316+ users who want subagents without a named role to stop inheriting the main session effort.\n\nKimi, Gemini and Grok preset values do not change, so their 0.3.0 installations need no update.\n\n### Migration and rollback\n\nAssistant IDs, preset ids (`fast`, `balanced`, `quality`), share-link format v2 and receipt format v4 are unchanged. Setup with 0.4.0 replaces a 0.3.0 installation in place, and receipts written by 0.3.0 still validate and uninstall. Setup with 0.3.0 moves ChatGPT, Kimi, Gemini and Grok back.\n\nClaude has a migration boundary in the downgrade direction. A 0.4.0 Claude receipt owns a third setting, `CLAUDE_CODE_SUBAGENT_EFFORT`, whenever the Coder effort is pinned, and every preset pins it. Version 0.3.0 does not know this setting, so its setup reports `INVALID_RECEIPT` and changes nothing. To move Claude back to 0.3.0, first remove its settings with 0.4.0: `npx --yes --ignore-scripts --package agent-policy-kit@0.4.0 agent-policy uninstall --client claude --apply`. Then set up with 0.3.0. This was checked with the 0.3.0 source in an isolated home. Removal restores the value that the setting had before setup, or removes it. Share links of 0.3.0 open on the 0.3.0 page.\n\n### Presets and model catalog\n\nRe-running setup applies these values. Installations keep their current values until then.\n\n- **Light, ChatGPT:** the Coder runs Luna at high instead of medium, the starting level OpenAI suggests for Luna. Luna stays the cheapest Codex model.\n- **Standard, ChatGPT:** the Docs writer uses GPT-6.1 Terra at medium instead of GPT-6.1 Sol. OpenAI positions Terra for clear writing, at half of Sol's usage.\n- **Top-tier, ChatGPT and Claude:** the Code explorer and Docs writer keep GPT-6.1 Sol and Opus 5.5 but run at medium instead of high. Implementation, review and tests stay at high.\n- **Top models switch, Claude:** Coder, Reviewer and Test writer use Opus 5.5 at xhigh instead of Fable 5.1 at high. Anthropic's own benchmarks put Opus 5.5 ahead of Fable 5.1 on every published coding benchmark at 2.5 times lower price, and Anthropic suggests a higher Opus effort before Fable. Fable 5.1 stays available in Custom. The switch now sets a model and an effort; ChatGPT and Kimi keep GPT-6 Astra and K3.1 Pro at high.\n\nThe catalog snapshot is dated 2026-11-01:\n\n- GPT-5.5 is marked retired from Codex for ChatGPT sign-in on 2026-10-14; it remains for API-key sign-in.\n- GPT-6 Astra's native default effort is medium in the signed-in server catalog; the bundled value low is kept as `bundledDefaultEffort`. The hidden, undocumented `gpt-reserve` selector is excluded.\n- Claude Code 2.1.316, Kimi Code 2.4.1 and Antigravity 1.4.12 are the observed client versions. Opus 4.5 and Haiku 4.5 record their earliest retirement dates.\n- Kimi records plan requirements: K3 and K3.1 Pro need Plus or higher, and the 1M context of K3 needs Pro or higher.\n- Antigravity's Flash Lite tier is marked undocumented: the CLI accepts it, but the subagent documentation lists only inherit, Flash and Pro.\n- Grok 4.7's reasoning levels (low to xhigh) are recorded as API capabilities. APK still writes only a model for each Grok role, so subagents use the main session effort.\n\nConfiguration checks are not model-quality evaluations.\n\n### What changed\n\n- Claude: setup also writes `CLAUDE_CODE_SUBAGENT_EFFORT`, the effort for subagents that name none, from the Coder effort capped at high. Claude Code 2.1.316 added this setting; earlier versions ignore it. Before, those subagents kept the main session effort.\n- `agent-policy show` reports the stored Claude default subagent effort and a `CLAUDE_CODE_SUBAGENT_EFFORT` environment override.\n- The top models switch label shows each tool's model and effort.\n- The website deployment guard also compares `src/release.mjs` with the release tag, because the page embeds its preset labels and top choices.\n- The configurator shows a note when Gemini is selected: APK configures Antigravity, not Gemini CLI. The README and the AI assistants reference say the same.\n- The documentation is reorganized into independent documents by audience: `docs/guide/` for people who use APK, `docs/reference/` for facts about assistants, roles, presets, the catalog and ownership, `docs/research/` for the evidence behind presets, and `docs/maintainers/` for development, releases and the website. [docs/README.md](docs/README.md) is the index. Old `docs/*.md` paths are removed without redirects. The 2026-11-01 model review is documented in [docs/research/2026-11-01-model-review.md](docs/research/2026-11-01-model-review.md).\n\n## 0.3.0 — 2026-11-01\n\n### Why this release\n\nPeople know their assistants as ChatGPT, Claude, Kimi, Gemini and Grok, not by the names of the coding agents inside them. The configurator and the CLI now use those names. Some people use only the desktop apps, and they have no CLI on PATH. Before this release, setup found nothing for them.\n\n### Who should update\n\n- Anyone who uses Codex in ChatGPT Desktop or Claude Code in the Code tab of Claude Desktop on macOS without a separate CLI.\n- Anyone who wants the general assistant names on the page and in the terminal.\n\nPreset values do not change, so an installation of 0.2.0 keeps working without an update.\n\n### Breaking change\n\nAI assistants now have general names: ChatGPT, Claude, Kimi, Gemini and Grok. APK still configures their coding agents: Codex, Claude Code, Kimi Code, Antigravity and Grok Build. Two technical IDs changed, and there is no migration:\n\n- `codex` is now `chatgpt`: `--chatgpt`, `--chatgpt-max-concurrent`, `--avoid-chatgpt`, `--client chatgpt` and the `clients.chatgpt` policy key.\n- `agy` is now `gemini`: `--gemini`, `--gemini-max-concurrent`, `--avoid-gemini`, `--client gemini` and the `clients.gemini` policy key.\n- Warning and error codes follow the new IDs, for example `chatgpt-native-precedence-limits` and `CHATGPT_CAP_ALIAS_CONFLICT`.\n\nBefore you use this version, remove the APK settings for these two assistants with the version that created them: `npx --yes --ignore-scripts --package agent-policy-kit@0.2.0 agent-policy uninstall --apply`. This version does not read the old `codex` and `agy` installation receipts, so its setup refuses the existing `apk-*` files as unowned. Policy files and share links that use the old IDs are refused too. Claude, Kimi and Grok keep their IDs.\n\n### Migration and rollback\n\nThe two renamed IDs set a migration boundary. These results come from tests with the published 0.2.0 package and this release:\n\n- **ChatGPT (Codex) and Gemini (Antigravity):** remove the APK settings with the version that created them before you set up with the other version. A move in either direction without removal reports `OWNERSHIP_CONFLICT` and changes nothing. After removal, setup with the other version succeeds.\n- **Claude, Kimi and Grok:** their IDs and receipt format v4 are unchanged. In the tests, setup with 0.3.0 upgraded 0.2.0 installations of Claude and Grok in place, and setup with 0.2.0 moved Claude back. Kimi uses the same receipt format, but it was not tested with a provisioned model pool.\n\n`uninstall --apply` removes the settings of every assistant. Run setup again afterwards for the assistants you use.\n\n### Presets and model catalog\n\nPreset models, effort levels and parallel limits are the same as in 0.2.0. Only the keys `codex` and `agy` became `chatgpt` and `gemini`, and the catalog labels became the general names. The model catalog snapshot is still dated 2026-10-30, with the Grok entries checked on 2026-11-01. Configuration checks are not model-quality evaluations.\n\n### What changed\n\n- The configurator calls the second step \"AI assistants\" and shows the general names. Readable CLI output uses the same names.\n- On macOS, setup finds the Codex that ChatGPT Desktop includes and the Claude Code in the Code tab of Claude Desktop, also when no CLI is on PATH. Both apps read the same settings as their CLIs. A CLI on PATH or in a conventional location still has priority. Detect output reports these clients with `origin: \"desktop_app\"`. Claude Cowork reads its settings from the Claude account, so APK does not configure it.\n\n## 0.2.0 — 2026-11-01\n\n### Why this release\n\nSubagents draw on the same plan limits as the main session, and every parallel session adds to that usage. Without explicit choices, subagents can inherit the most expensive model and use up a weekly limit within days. This release names the work modes by how much of a plan subagents may use, adds per-tool parallel limits, a read-only settings check and Grok Build support.\n\n### Who should update\n\nAnyone who wants Grok Build roles, per-tool parallel limits or the renamed modes. Re-running setup with 0.2.0 applies the new preset values: Top-tier now uses Opus 5.5, GPT-6.1 Sol and K3 at high effort, with top models behind an opt-in switch, and Kimi's Standard Docs writer uses K3 256K. Installations of 0.1.0 keep working unchanged until setup is run again.\n\n### Migration and rollback\n\nPreset ids (`fast`, `balanced`, `quality`), receipt format v4 and ownership, drift and rollback behavior are unchanged. Version 1 share links still open; new links use version 2 and carry each tool's parallel limit. Applying 0.1.0 again restores its owned settings, as the synthetic upgrade/downgrade gate verifies. Grok Build is new, so it has nothing to migrate.\n\n### Presets and model catalog\n\nThe model catalog snapshot is dated 2026-10-30; Grok Build entries were checked on 2026-11-01 against the Grok Build 1.0.70 user guide and the xAI model list. An independent audit compared every preset, tool and role with the catalog and the documentation tables, and a test now keeps those tables in sync. Configuration checks are not model-quality evaluations.\n\n### What changed\n\n- Add Grok Build as a fifth coding tool, listed after Antigravity. APK writes `agents/apk-\u003crole>.md` role files (Reviewer and Code explorer use the read-only `permission_mode: plan`), per-role models and a `general-purpose` fallback copied from the first selected role (the Coder when selected) in `config.toml` `[subagents.models]`, a native `[subagents] max_concurrent` cap and a delegation block in `AGENTS.md` under `$GROK_HOME` (default `~/.grok`). Per-role effort is not configurable, so every Grok choice has effort null and the page shows no effort controls. Presets use Grok Build 0.1, xAI's fast coding model, for light work and Grok 4.7 for stronger roles; Grok 4.6 and 4.5 stay available in Custom. Explicit commands use `--grok`, `--grok-max-concurrent` and `--avoid-grok`. Removal restores the original settings and refuses on local edits.\n\n- Rename work modes to Light, Standard and Top-tier and describe them by how much of a plan's limits subagents use. Preset ids and share-link ids are unchanged. Top-tier now uses Opus 5.5, GPT-6.1 Sol and K3 at high effort for code, review and tests. A per-tool switch under Top-tier opts those roles into Fable 5.1, GPT-6 Astra or K3.1 Pro; it is off by default. Top models no longer run at xhigh/max, because native default subagent settings copy the first selected role (the Coder when selected) to subagents started without a named role.\n\n- Explain each configuration step with a short ? note, and stop repeating vendor billing or version documentation in the work-mode notice.\n\n- Start a fresh or reset form with every subagent role selected, and give the empty coding-tool field the same appearance as the empty role field.\n\n- Automatically deploy the latest website from verified main while preserving exact tagged release pages and older share links. Configuration guards keep commands pinned to published package capabilities; npm releases remain explicit.\n\n- Credit Mykola Maksymenko in the configuration page and package metadata. Link the supplied LinkedIn profile and related projects, with static author/project structured data and a release-specific canonical URL.\n\n- Interactive terminals get readable setup, doctor, release and show output; captured output keeps the existing JSON contract, and `--json` forces JSON.\n\n- `agent-policy show` reads the current user-level subagent settings of every tool, before or after APK installation, without writing files. The page footer offers it as \"Check current settings\" with a copy button.\n\n- Each tool has its own parallel limit from 1 to 32, set in its details on the page or with `--TOOL-max-concurrent`; policies accept `clients[tool].maxConcurrent`.\n\n- The page adds Add all for roles and tools, a GitHub link in the header, Reset form beside the release line, and preset switching for a single selected tool without a needless confirmation.\n\n## 0.1.0 — 2026-10-30\n\n### Why this release\n\nUse a common approach to optional delegation across Codex, Claude Code, Kimi and Antigravity, without an extra process in normal agent operation. Configure once and remove the installer afterward.\n\n### What it configures\n\nSix focused roles cover implementation, read-only review, code discovery, test creation, documentation and prescribed execution. Each preset assigns a model and supported effort to every role; the [preset matrix](docs/reference/presets.md) explains the choices.\n\nThese are starting preferences, not model-quality benchmarks. Native model formats and alias behavior were reviewed against the official sources linked in [support](docs/reference/assistants.md) and [model maintenance](docs/maintainers/model-review.md). Model availability must be checked before applying. Provider aliases and tiers may resolve differently over time.\n\n### Presets and model catalog\n\nAll three presets were rebuilt for public use. Personal Astra/Opus/Fable and other avoid lists were removed. Fast gives review and testing more reasoning than simple execution. Balanced separates implementation, verification, discovery, documentation and mechanics. Quality uses Astra/Fable for demanding work and regular K3.1 Pro at max for Kimi code/review/tests. Claude recommendations pin current versioned IDs; Kimi Balanced uses the quota-conscious K3 256K variant. These are editable recommendations, not benchmark results.\n\nThe release contains a dated model/effort catalog from official documentation and native selector observations, including native-default effort and account-dependent availability. Antigravity role choices are native tiers, with no invented per-role effort setting.\n\nCatalog audit, 2026-10-30 UTC: Kimi now lists all six current models, including K3.1 Pro and Pro Highspeed. Quality first now uses regular K3.1 Pro at max effort for implementation/review/tests; other roles have separate choices described in the preset matrix. Highspeed remains optional because its faster output consumes about twice regular Pro's quota, according to Kimi. Setup requires provisioned access and does not silently fall back to another model.\n\nBoth Pro variants require compatible thinking settings. Even with unpinned effort, setup refuses an explicit thinking-disabled setting without modifying it.\n\nCodex effort choices/defaults now follow CLI 0.166.0 rather than API defaults; API metadata remains separate, and Ultra stays separate from ordinary effort. Claude Opus 4.5 no longer advertises an API-only native effort override. Existing custom inputs using levels outside the current native catalog require review before reapplication; owned inspection/removal remains independent of current recommendations. Sonnet 4.5 remains selectable with its Anthropic deprecation status marked. Antigravity CLI's four tier choices are unchanged.\n\n### What changed\n\n- Added Test writer and Docs writer; clarified Code explorer and Task runner. Old four-role native v2/v3 receipts remain supported, including explicit expansion to six, owned removal, drift refusal and late rollback. New v4 snapshots support six independently configured Kimi aliases.\n\n- Readable type uses a compact 36/20/15/13 px scale with more spacing; narrow layouts stack model controls and command actions.\n- A short collapsible explanation introduces role-specific models, native setup and optional delegation, using the same wording as the README.\n- The builder now starts with no roles, tools or chosen modes. Green checks track completed selections and successful copy, and Reset form restores a blank state. URL fragments restore visible settings without a backend. Conditional section hints and changed step markers use a two-second highlight hold plus two-second fade, respecting reduced motion. Selection controls share a soft treatment; Copy remains the primary action.\n- Page commands always list every selected role/model/effort under its tool, including presets. Explicit --roles, --max-concurrent and optional --avoid-TOOL preserve the existing selection, cap and guidance. :native represents unpinned effort; Antigravity remains tier-only. The shared codec validates complete role maps and rejects duplicate/mixed input before writes. Legacy release/config/policy inputs remain supported.\n- The four-step page now selects subagent roles and coding tools before mode/model/effort configuration. It generates and copies a real pinned command. Tool additions preserve All or a manually selected view. Role help uses the same prompt definitions as native generation.\n- Optional selectedRoles creates only the requested native roles. Receipt v4 binds that role set to owned files and supports safe expansion, reduction and removal. Earlier v2/v3 native receipts retain their historical four-role ownership boundary. Unselected Kimi aliases do not need provisioning or effort pins.\n- Native role files and routing instructions apply only when the main agent chooses delegation. Main models and disabled delegation features are preserved.\n- A static page lets each tool use its own mode and per-task models/effort. All shows mixed settings as Custom and can apply one preset to every tool. Scope warnings protect individual and global replacements; the page generates one pinned command.\n- Explicit release application supports safe upgrade/downgrade of owned settings; per-client receipts record the actual applied version and custom choices.\n- Ownership/drift checks, private backups and rollback preserve unrelated settings and earlier user values.\n- No custom hooks, proxy, plugin, launcher, daemon or normal-operation runtime is installed.\n\n### Who should use it\n\nPeople who want consistent subagent preferences across their installed coding tools. You can keep the recommendations or select different native models in the configuration page.\n\n### Applying this version\n\n```sh\nnpx --yes --ignore-scripts --package agent-policy-kit@0.1.0 agent-policy setup --release --apply\n```\n\nWithout --apply the same command previews the changes. The page-generated explicit tool arguments apply the visible choices using this release's native templates. See [release usage](docs/guide/updates-and-removal.md).\n\n### Migration and limits\n\nThis is the first public release. Synthetic versions in tests are not real releases. Experimental runtime receipts from older development commits require their original owned removal. Supported native snapshot formats can be updated safely; unknown future formats/layouts are refused.\n\nKimi/Antigravity concurrency guidance and native tier/precedence limits remain explicit. A pinned release reproduces declared configuration, not provider weights, entitlement or model quality.\n","packageSpec":"agent-policy-kit@0.5.1","preferences":{"schemaVersion":1,"maxConcurrent":3,"clients":{"chatgpt":{"code":{"model":"gpt-6.1-sol","effort":"medium"},"light":{"model":"gpt-6-luna","effort":"low"},"roles":{"reviewer":{"model":"gpt-6.1-sol","effort":"high"},"explorer":{"model":"gpt-6-luna","effort":"high"},"tester":{"model":"gpt-6.1-sol","effort":"high"},"writer":{"model":"gpt-6.1-terra","effort":"medium"}},"avoidModels":[]},"claude":{"code":{"model":"claude-sonnet-5-5","effort":"high"},"light":{"model":"claude-haiku-5-5","effort":"low"},"roles":{"explorer":{"model":"claude-haiku-5-5","effort":"medium"},"writer":{"model":"claude-sonnet-5-5","effort":"medium"}},"avoidModels":[]},"kimi":{"code":{"model":"kimi-code/k3-256k","effort":"high"},"light":{"model":"kimi-code/kimi-for-coding","effort":"low"},"roles":{"writer":{"model":"kimi-code/k3-256k","effort":"high"}},"avoidModels":[]},"gemini":{"code":{"model":"pro","effort":null},"light":{"model":"flash_lite","effort":null},"roles":{"explorer":{"model":"flash","effort":null},"writer":{"model":"flash","effort":null}},"avoidModels":[]},"grok":{"code":{"model":"grok-4.7","effort":null},"light":{"model":"grok-build-0.1","effort":null},"roles":{"writer":{"model":"grok-4.7","effort":null}},"avoidModels":[]}}},"hostedReleases":[],"catalog":{"schemaVersion":1,"reviewedAt":"2026-11-02","scope":"Documented/native coding-tool selectors at this release; account access and custom deployment IDs vary.","clients":{"chatgpt":{"label":"ChatGPT","efforts":["none","minimal","low","medium","high","xhigh","max"],"observedClientVersion":"0.166.0","observation":"codex debug models --bundled: 9 visible selectors; 3 hidden specialized/utility entries excluded. The signed-in server catalog (2026-11-01) lists 8 visible selectors without GPT-5.5, the hidden gpt-reserve entry and a medium default for GPT-6 Astra.","models":[{"id":"gpt-6-astra","label":"GPT-6 Astra","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-6-astra","kind":"model","apiEfforts":["low","medium","high","xhigh","max"],"apiDefaultEffort":null,"nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"],"bundledDefaultEffort":"low"},{"id":"gpt-6.1-sol","label":"GPT-6.1 Sol","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"low","source":"https://developers.openai.com/api/docs/models/gpt-6.1-sol","kind":"model","apiEfforts":["low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-6.1-terra","label":"GPT-6.1 Terra","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"low","source":"https://developers.openai.com/api/docs/models/gpt-6.1-terra","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-6-sol","label":"GPT-6 Sol","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-6-sol","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-6-luna","label":"GPT-6 Luna","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-6-luna","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models"},{"id":"gpt-5.6-sol","label":"GPT-5.6 Sol","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"low","source":"https://developers.openai.com/api/docs/models/gpt-5.6-sol","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-5.6-terra","label":"GPT-5.6 Terra","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-5.6-terra","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","delegationModes":["ultra"]},{"id":"gpt-5.6-luna","label":"GPT-5.6 Luna","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-5.6-luna","kind":"model","apiEfforts":["none","low","medium","high","xhigh","max"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models"},{"id":"gpt-5.5","label":"GPT-5.5 (API key only)","efforts":["low","medium","high","xhigh"],"defaultEffort":"medium","source":"https://developers.openai.com/api/docs/models/gpt-5.5","kind":"model","apiEfforts":["none","low","medium","high","xhigh"],"apiDefaultEffort":"medium","nativeSource":"https://learn.chatgpt.com/docs/models","lifecycle":{"status":"retired","retirementDate":"2026-10-14","scope":"Codex with ChatGPT sign-in; API-key sign-in keeps access","source":"https://learn.chatgpt.com/docs/models"}}],"excluded":[{"id":"gpt-daybreak-blue-latest","reason":"hidden specialized selector"},{"id":"gpt-daybreak-red-latest","reason":"hidden specialized selector"},{"id":"codex-auto-review","reason":"hidden internal utility selector"},{"id":"gpt-reserve","reason":"hidden undocumented selector in the server catalog"}],"note":"Efforts follow the bundled Codex CLI 0.166.0 catalog. Defaults follow the signed-in server catalog of 2026-11-01 where it differs (bundledDefaultEffort keeps the bundled value). API capabilities are separate apiEfforts/apiDefaultEffort metadata. Ultra is a delegating execution mode, recorded separately and not offered as ordinary subagent effort. An API-supported level absent from the native catalog is unverified for manual per-role configuration, not proven runtime-rejected. GPT-5.5 left Codex for ChatGPT sign-in on 2026-10-14 and remains for API-key sign-in."},"claude":{"label":"Claude","efforts":["low","medium","high","xhigh","max"],"observedClientVersion":"2.1.316","models":[{"id":"sonnet","label":"Sonnet (alias)","efforts":["low","medium","high","xhigh","max"],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"alias","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."},{"id":"opus","label":"Opus (alias)","efforts":["low","medium","high","xhigh","max"],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"alias","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."},{"id":"haiku","label":"Haiku (alias)","efforts":["low","medium","high","xhigh","max"],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"alias","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."},{"id":"fable","label":"Fable (alias)","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/sub-agents#choose-a-model","kind":"alias","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."},{"id":"claude-fable-5-1","label":"Fable 5.1","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-5-5","label":"Opus 5.5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-sonnet-5-5","label":"Sonnet 5.5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-haiku-5-5","label":"Haiku 5.5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"medium","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-fable-5","label":"Fable 5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-5","label":"Opus 5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-sonnet-5","label":"Sonnet 5","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-4-8","label":"Opus 4.8","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-4-7","label":"Opus 4.7","efforts":["low","medium","high","xhigh","max"],"defaultEffort":"xhigh","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-4-6","label":"Opus 4.6","efforts":["low","medium","high","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-sonnet-4-6","label":"Sonnet 4.6","efforts":["low","medium","high","max"],"defaultEffort":"high","source":"https://code.claude.com/docs/en/model-config","kind":"model"},{"id":"claude-opus-4-5-20251101","label":"Opus 4.5","efforts":[],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config#adjust-effort-level","kind":"model","apiEfforts":["low","medium","high"],"apiDefaultEffort":null,"apiSource":"https://platform.claude.com/docs/en/build-with-claude/effort","lifecycle":{"status":"active","earliestRetirement":"2026-11-24","scope":"Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) and Microsoft Foundry","note":"Legacy model with no deprecation notice. The date is a floor, not a scheduled retirement; Anthropic gives at least 60 days' notice.","partners":[{"platform":"Google Cloud (Google managed)","earliestRetirement":"2026-11-24","source":"https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deprecations/partner-models"}],"source":"https://platform.claude.com/docs/en/about-claude/model-deprecations"}},{"id":"claude-sonnet-4-5-20250929","label":"Sonnet 4.5 (retires 2026-11-30)","efforts":[],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"model","lifecycle":{"status":"deprecated","deprecationDate":"2026-09-30","retirementDate":"2026-11-30","replacement":"claude-sonnet-5-5","scope":"Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) and Microsoft Foundry","partners":[{"platform":"Amazon Bedrock","status":"legacy","endOfLife":"2027-04-08","source":"https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle-legacy.html"},{"platform":"Google Cloud (Google managed)","note":"No retirement date announced. The earliest retirement date, 2026-09-29, passed.","source":"https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude/sonnet-4-5"}],"source":"https://platform.claude.com/docs/en/about-claude/model-deprecations"}},{"id":"claude-haiku-4-5-20251001","label":"Haiku 4.5","efforts":[],"defaultEffort":null,"source":"https://code.claude.com/docs/en/model-config","kind":"model","lifecycle":{"status":"active","earliestRetirement":"2026-10-15","scope":"Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) and Microsoft Foundry","note":"Legacy model with no deprecation notice. The earliest retirement date passed without an announcement.","partners":[{"platform":"Google Cloud (Google managed)","earliestRetirement":"2026-12-07","source":"https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deprecations/partner-models"}],"source":"https://platform.claude.com/docs/en/about-claude/model-deprecations"}},{"id":"inherit","label":"Inherit main model","efforts":["low","medium","high","xhigh","max"],"defaultEffort":null,"source":"https://code.claude.com/docs/en/sub-agents","kind":"inherit","effortResolution":"Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."}],"note":"Full model IDs use the current Claude Code native effort table, which differs from API support for Opus 4.5. Alias/inherit efforts are possible requested levels, not a guarantee for every resolved provider model; unsupported levels can clamp or be ignored. Current account access and provider alias resolution vary. Claude Code 2.1.316 adds CLAUDE_CODE_SUBAGENT_EFFORT for subagents that name no effort; earlier versions ignore it. CLAUDE_CODE_EFFORT_LEVEL still overrides subagent effort frontmatter.","excluded":[{"id":"best","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"},{"id":"default","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"},{"id":"opus[1m]","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"},{"id":"opusplan","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"},{"id":"sonnet[1m]","reason":"session/context selector rather than a distinct documented subagent model; custom native ID remains available"}]},"kimi":{"label":"Kimi","efforts":["low","medium","high","xhigh","max"],"models":[{"id":"kimi-code/k3.1-pro","label":"K3.1 Pro","efforts":["low","high","max"],"defaultEffort":"high","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"k3.1-pro","thinkingRequired":true},{"id":"kimi-code/k3.1-pro-highspeed","label":"K3.1 Pro Highspeed","efforts":["low","high","max"],"defaultEffort":"high","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"k3.1-pro-highspeed","thinkingRequired":true},{"id":"kimi-code/k3","label":"K3","efforts":["low","high","max"],"defaultEffort":"high","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"k3","planRequirement":"Plus (Moderato) or higher; 1M context requires Pro (Allegretto) or higher"},{"id":"kimi-code/k3-256k","label":"K3 · 256K","efforts":["low","high","max"],"defaultEffort":"high","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"k3-256k"},{"id":"kimi-code/kimi-for-coding","label":"K2.8 Preview","efforts":["low","high","max"],"defaultEffort":"max","source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"kimi-for-coding"},{"id":"kimi-code/kimi-for-coding-highspeed","label":"K2.7 Code HighSpeed","efforts":[],"defaultEffort":null,"source":"https://www.kimi.com/code/docs/en/kimi-code/models","kind":"native-alias","upstreamModelId":"kimi-for-coding-highspeed"}],"note":"Current Kimi Code docs list six model IDs; the older kimi.ai/help page still lists four. K3.1 Pro and Highspeed require thinking and support low/high/max, default high. These are preferred native aliases: setup resolves a missing preferred alias only to a unique provisioned match; no provider identity is invented. Account tier controls access. K3 and K3.1 Pro require the Plus (Moderato) plan or higher. The 1M context of K3 and every Highspeed model require Pro (Allegretto) or higher; on Plus, k3 stays at 256K context and uses about twice the quota of k3-256k. K2.7 Code HighSpeed uses about three times the quota.","observedClientVersion":"2.4.1","observation":"Kimi Code CLI 2.4.0 and 2.4.1: all six documented preferred aliases and native effort/default capabilities corroborated through whitelisted provisioned metadata; no credentials or custom account aliases retained."},"gemini":{"label":"Gemini","efforts":[],"observedClientVersion":"1.4.12","models":[{"id":"pro","label":"Pro","efforts":[],"defaultEffort":null,"source":"https://antigravity.google/docs/subagents?tab=cli","kind":"tier"},{"id":"flash","label":"Flash","efforts":[],"defaultEffort":null,"source":"https://antigravity.google/docs/subagents?tab=cli","kind":"tier"},{"id":"flash_lite","label":"Flash Lite","efforts":[],"defaultEffort":null,"source":"https://antigravity.google/docs/subagents?tab=cli","kind":"tier","documented":false,"nativeSource":"Antigravity CLI 1.4.12 agent-file parser"},{"id":"inherit","label":"Inherit main model","efforts":[],"defaultEffort":null,"source":"https://antigravity.google/docs/subagents?tab=cli","kind":"tier"}],"note":"Native per-subagent selectors are tiers, not the session model inventory. The CLI 1.4.12 parser accepts inherit/flash_lite/flash/pro; the public subagent documentation lists only inherit, flash and pro, so flash_lite is undocumented. Google does not document which Gemini model each tier uses; the server sets it per account. Per-role effort is not exposed by the agent-file schema; --effort and /effort apply to the whole session."},"grok":{"label":"Grok","efforts":["low","medium","high","xhigh","max"],"observedClientVersion":"1.0.70","models":[{"id":"grok-4.7","label":"Grok 4.7","efforts":["low","medium","high","xhigh"],"defaultEffort":"high","source":"https://docs.x.ai/developers/models","nativeSource":"https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md","kind":"model","apiEfforts":["low","medium","high","xhigh"],"apiDefaultEffort":"high"},{"id":"grok-4.6","label":"Grok 4.6","efforts":[],"defaultEffort":null,"source":"https://docs.x.ai/developers/models","nativeSource":"https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md","kind":"model"},{"id":"grok-4.5","label":"Grok 4.5","efforts":[],"defaultEffort":null,"source":"https://docs.x.ai/developers/models","nativeSource":"https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md","kind":"model"},{"id":"grok-build-0.1","label":"Grok Build 0.1","efforts":[],"defaultEffort":null,"source":"https://docs.x.ai/developers/models","nativeSource":"https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md","kind":"model"}],"note":"Per-subagent models are set in config.toml [subagents.models]; model IDs follow the documented xAI model list and account access varies. APK writes a role effort as effort in the agent frontmatter (agents/apk-\u003crole>.md); Grok Build 1.0.70 accepts low/medium/high/xhigh/max there and drops the whole agent for any other value. The effort applies only when the model supports effort: Grok 4.7 lists low/medium/high/xhigh with default high, Grok Build 0.1 has no configurable effort, and the effort levels of Grok 4.6 and 4.5 are not verified. A role without an effort runs at the default effort of its pinned model, not at the main session effort; a role named like the agent ([subagents.roles.\u003cagent>] reasoning_effort) or a harness spawn override wins over the frontmatter. [subagents] max_concurrent is a native cap."}}},"roles":[{"id":"worker","name":"Coder","kind":"code","assignment":"scoped implementation and fixes","description":"Implements scoped changes, preserves peers' edits, and verifies the result.","prompt":"Implement the assigned change or fix within the assigned files. You share the workspace with other agents: preserve their edits. Verify the result and report changes, checks, and remaining limitations. Do not create child agents; return any need for further delegation to the parent."},{"id":"reviewer","name":"Reviewer","kind":"code","assignment":"read-only correctness, security and regression review","description":"Reviews correctness, security and regressions without edits; reports actionable evidence.","prompt":"Review the assigned change without editing files. Find actionable correctness, security, and regression issues. Report each finding with file and line evidence and explain its impact; distinguish confirmed issues from uncertainty. Do not create child agents; return any need for further delegation to the parent."},{"id":"explorer","name":"Code explorer","kind":"light","assignment":"read-only code and documentation discovery","description":"Maps code and documentation, cites sources, and separates facts from uncertainty.","prompt":"Explore the assigned code and documentation without editing files. Return a concise map or factual answer with source paths or citations. Distinguish verified facts from assumptions and unknowns. Do not create child agents; return any need for further delegation to the parent."},{"id":"tester","name":"Test writer","kind":"code","assignment":"test creation and targeted execution","description":"Writes behavior and edge-case tests, reproduces issues, and runs targeted checks.","prompt":"Own the assigned tests and targeted execution. Reproduce the issue or establish a baseline, then test observable behavior and edge cases. Never weaken checks to make them pass. Do not edit application code unless explicitly assigned. Preserve peers' edits and report results and limitations. Do not create child agents; return any need for further delegation to the parent."},{"id":"writer","name":"Docs writer","kind":"light","assignment":"assigned documentation, examples and release notes","description":"Updates assigned docs and examples, verifies claims, and keeps terminology consistent.","prompt":"Update only the assigned documentation, examples, or release notes. Verify claims against code or cited sources and use consistent terminology. Do not edit application code. Preserve peers' edits and report changes and unknowns. Do not create child agents; return any need for further delegation to the parent."},{"id":"routine","name":"Task runner","kind":"light","assignment":"explicit commands and mechanical edits","description":"Runs prescribed commands and mechanical edits; returns ambiguous decisions to the parent.","prompt":"Execute only the prescribed commands or clearly specified mechanical edits. Preserve other agents' work and report the outcome. Do not make ambiguous design or behavior decisions; return those decisions to the parent. Do not create child agents; return any need for further delegation to the parent."}],"unreleased":false};
 // Pure command codec, also embedded in the offline configuration page.
 const TOOL_FLAGS=Object.freeze({chatgpt:'chatgpt',claude:'claude',kimi:'kimi',gemini:'gemini',grok:'grok'});
 const EXPLICIT_FIELDS=Object.freeze(['roles','max-concurrent',...Object.keys(TOOL_FLAGS),...Object.keys(TOOL_FLAGS).map(flag=>'avoid-'+flag),...Object.keys(TOOL_FLAGS).map(flag=>flag+'-max-concurrent')]);
@@ -604,7 +604,16 @@ function archivedReleaseUrl(error,href,hostedReleases=[]){
   function assistantNotices(selected) {
     return selected.filter(client => Object.hasOwn(SCOPE_NOTES, client)).map(client => SCOPE_NOTES[client]);
   }
-  const NOTES = {chatgpt: '', claude: '', kimi: 'Effort changes apply to every task using the same alias.', gemini: 'Native tiers only; per-task effort is unavailable.', grok: 'Effort applies only to models that support it; native default uses the model default.'};
+  // How an assistant applies the model and effort of a role; shown next to its own model table only.
+  const ASSISTANT_NOTES = {
+    kimi: 'Kimi sets one effort for each model alias. Roles that use the same alias share it, so an effort change applies to all of them.',
+    gemini: 'Gemini uses its native tiers only. Effort cannot be set for each role.',
+    grok: 'Grok applies an effort only when the model supports it: Grok 4.7 offers low to xhigh; Grok 4.6, Grok 4.5 and Grok Build 0.1 offer none. A role without an effort runs at the default effort of its model.'
+  };
+  function assistantNote(state) {
+    const client = state.active;
+    return Object.hasOwn(ASSISTANT_NOTES, client) && state.profiles?.[client]?.modeSelected !== false ? ASSISTANT_NOTES[client] : '';
+  }
   const clone = value => JSON.parse(JSON.stringify(value));
   const addAll = (selected, available) => [...selected, ...available.filter(id => !selected.includes(id))];
   function effective(config, role) {
@@ -820,7 +829,7 @@ function archivedReleaseUrl(error,href,hostedReleases=[]){
     if(!hash.startsWith('#setup='))return hash;
     return opened?.hash===hash&&opened.fragment===fragment?hash:'';
   }
-  globalThis.APKConfigurator = Object.freeze({initialState, assistantNotices, modeFor, presetModelSummary, topModelRoles, topModelsOn, setTopModels, applyPreset, effective, allowedEfforts, preferenceForModel, updateEffort, updateConcurrency, stepConcurrency, concurrencyFor, restoreState, addAll, buildConfig, encodeConfig, buildCommand, stepProgress, shareAddress});
+  globalThis.APKConfigurator = Object.freeze({initialState, assistantNotices, assistantNote, modeFor, presetModelSummary, topModelRoles, topModelsOn, setTopModels, applyPreset, effective, allowedEfforts, preferenceForModel, updateEffort, updateConcurrency, stepConcurrency, concurrencyFor, restoreState, addAll, buildConfig, encodeConfig, buildCommand, stepProgress, shareAddress});
   if (typeof document === 'undefined') return;
 
 (() => {
@@ -981,20 +990,21 @@ function archivedReleaseUrl(error,href,hostedReleases=[]){
   notice.hidden=!message;
  }
  function renderEditor(){
-  const parent=$('editor');parent.replaceChildren();if(!helpers.length||!state.active||state.active==='all'||state.profiles[state.active].modeSelected===false)return;
+  const parent=$('editor'),note=$('assistant-note');parent.replaceChildren();note.hidden=true;note.textContent='';if(!helpers.length||!state.active||state.active==='all'||state.profiles[state.active].modeSelected===false)return;
   const client=state.active,catalog=RELEASE.catalog.clients[client],profile=state.profiles[client].preferences;
+  const noteText=A.assistantNote(state),described=noteText?{'aria-describedby':'assistant-note'}:{};note.textContent=noteText;note.hidden=!noteText;
   const header=el('div',{class:'editor-head','aria-hidden':'true'});for(const label of ['Role','Model','Effort'])header.append(el('span',{},label));parent.append(header);
   for(const role of roles.filter(role=>helpers.includes(role.id))){
    const choice=state.jobs[client][role.id],row=el('div',{class:'editor editor-row','data-helper-id':role.id,role:'group','aria-label':`${role.name} settings for ${toolName(client)}`});
    row.style.viewTransitionName=`config-${client}-${role.id}`;
    const name=el('div',{class:'editor-name'});name.append(el('span',{},role.name),roleInfo(role));row.append(name);
-   const modelControl=el('div',{class:'model-control'}),modelSelect=el('select',{'aria-label':`${role.name} model`,'data-model-role':role.id});catalog.models.forEach(model=>modelSelect.append(el('option',{value:model.id},model.label)));if(client!=='gemini')modelSelect.append(el('option',{value:'__custom__'},'Custom model…'));
+   const modelControl=el('div',{class:'model-control'}),modelSelect=el('select',{'aria-label':`${role.name} model`,'data-model-role':role.id,...described});catalog.models.forEach(model=>modelSelect.append(el('option',{value:model.id},model.label)));if(client!=='gemini')modelSelect.append(el('option',{value:'__custom__'},'Custom model…'));
    const known=catalog.models.some(model=>model.id===choice.model);modelSelect.value=known?choice.model:'__custom__';
    const custom=el('input',{type:'text',class:'custom-model','aria-label':`${role.name} custom model ID`,placeholder:'Native model ID',autocomplete:'off',spellcheck:'false',maxlength:'128'});custom.hidden=known;custom.value=known?'':choice.model;
    modelSelect.addEventListener('change',()=>{if(modelSelect.value==='__custom__'){state.jobs[client][role.id]={model:'',effort:choice.effort};state.profiles[client].custom=true;state.profiles[client].modeSelected=true;render();const focus=()=>{if(state.active===client)document.querySelector(`[aria-label="${role.name} custom model ID"]`)?.focus();};if(activeTransition)activeTransition.finished.then(focus);else focus();return;}state.jobs[client][role.id]=A.preferenceForModel(profile,role.id,modelSelect.value,state.jobs[client],catalog,client==='kimi');state.profiles[client].custom=true;state.profiles[client].modeSelected=true;render();});
    custom.addEventListener('input',()=>{state.jobs[client][role.id]=A.preferenceForModel(profile,role.id,custom.value.trim(),state.jobs[client],catalog,client==='kimi');state.profiles[client].custom=true;state.profiles[client].modeSelected=true;custom.setAttribute('aria-invalid',String(!IDENTIFIER.test(custom.value.trim())||(client==='kimi'&&custom.value.trim()==='primary')));renderEfforts();renderResult();});
    modelControl.append(modelSelect,custom);row.append(modelControl);
-   const group=el('div',{class:'efforts',role:'group','aria-label':`${role.name} effort`});
+   const group=el('div',{class:'efforts',role:'group','aria-label':`${role.name} effort`,...described});
    function renderEfforts(){
     group.replaceChildren();const current=state.jobs[client][role.id],levels=A.allowedEfforts(catalog,current.model).filter(level=>level!==null);
     if(!levels.length)group.append(el('span',{class:'unavailable',title:'Native effort setting unavailable for this model'},'—'));

package/src/inspect.mjs

@@ -43,7 +43,7 @@ async function readFile(file,budget){
  finally{await handle?.close();}
 }
 function warning(client,error){
- const allowed=['UNSAFE_FILE','INSPECTION_LIMIT','CONFIG_CHANGED_DURING_READ','UNSUPPORTED_NATIVE_SETTING','UNSUPPORTED_ROLE_FORMAT','UNSUPPORTED_ROLE_EFFORT','INVALID_TOML','INVALID_JSON','EACCES','EPERM','NATIVE_CAP_CONFLICT','EXTERNAL_ROLE_REFERENCES_NOT_READ'];
+ const allowed=['UNSAFE_FILE','INSPECTION_LIMIT','CONFIG_CHANGED_DURING_READ','UNSUPPORTED_NATIVE_SETTING','UNSUPPORTED_ROLE_FORMAT','UNSUPPORTED_ROLE_EFFORT','UNSUPPORTED_ROLE_CAPABILITY','INVALID_TOML','INVALID_JSON','EACCES','EPERM','NATIVE_CAP_CONFLICT','EXTERNAL_ROLE_REFERENCES_NOT_READ'];
  const code=allowed.includes(error?.code)?error.code:'NATIVE_READ_FAILED';
  if(!client.warnings.includes(code))client.warnings.push(code);
  client.status='attention';
@@ -56,7 +56,9 @@ function scalar(value){
  if(!match)throw failure('UNSUPPORTED_ROLE_FORMAT');
  return match[1];
 }
-function frontmatter(text){
+// Values that Grok Build 1.0.70 accepts for capabilityMode (serde kebab-case names and aliases of SubagentCapabilityMode).
+const GROK_CAPABILITY_MODES=['read-only','readonly','readOnly','read_only','ReadOnly','read-write','readwrite','readWrite','read_write','ReadWrite','execute','Execute','EXECUTE','all','All','ALL'];
+function frontmatter(text,id){
  const match=text.replace(/^\uFEFF/,'').match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
  if(!match)throw failure('UNSUPPORTED_ROLE_FORMAT');
  const fields={};
@@ -64,13 +66,17 @@ function frontmatter(text){
   // YAML merges, quoted keys and flow mappings can supply model fields that
   // this deliberately small scalar reader cannot resolve safely.
   if(/^(?:<<\s*:|["'{\[])/.test(line))throw failure('UNSUPPORTED_ROLE_FORMAT');
-  const field=line.match(/^(name|model|effort|subagent)[ \t]*:\s*(.*)$/);
+  const field=line.match(id==='grok'?/^(name|model|effort|subagent|capabilityMode)[ \t]*:\s*(.*)$/:/^(name|model|effort|subagent)[ \t]*:\s*(.*)$/);
   if(!field)continue;
   if(Object.hasOwn(fields,field[1]))throw failure('UNSUPPORTED_ROLE_FORMAT');
   if(field[1]==='subagent'){
    const boolean=field[2].trim().match(/^(true|false)(?:\s+#.*)?$/);
    if(!boolean)throw failure('UNSUPPORTED_ROLE_FORMAT');
    fields.subagent=boolean[1]==='true';
+  }else if(field[1]==='capabilityMode'){
+   // Keep a value Grok Build would reject without echoing it; it only selects a warning.
+   const raw=field[2].trim().replace(/\s+#.*$/,''),quoted=raw.match(/^(["'])(.*)\1$/),value=quoted?quoted[2]:raw;
+   fields.capabilityMode=GROK_CAPABILITY_MODES.includes(value)?value:null;
   }else fields[field[1]]=scalar(field[2]);
  }
  if(!fields.name)throw failure('UNSUPPORTED_ROLE_FORMAT');
@@ -139,7 +145,7 @@ async function rolesIn(directory,client,id,budget,models,depth=0){
    }
    if(!entry.name.endsWith(id==='chatgpt'?'.toml':'.md'))continue;
    const body=await readFile(file,budget);if(body===null)throw failure('CONFIG_CHANGED_DURING_READ');
-   const fields=id==='chatgpt'?parseToml(body):frontmatter(body);
+   const fields=id==='chatgpt'?parseToml(body):frontmatter(body,id);
    const role={name:safeString(fields.name,namePattern),model:optionalString(fields.model),effort:optionalString(id==='chatgpt'?fields.model_reasoning_effort:fields.effort)};
    if(id==='kimi'){
     // APK's Markdown role files contain explicit routing guidance, not a
@@ -155,6 +161,8 @@ async function rolesIn(directory,client,id,budget,models,depth=0){
     role.model=models.get(role.name)??role.model;
     // Grok Build drops an agent whose frontmatter effort is not a level it accepts.
     if(role.effort!==null&&!NATIVE_EFFORTS.grok.includes(role.effort))warning(client,failure('UNSUPPORTED_ROLE_EFFORT'));
+    // It also drops an agent whose capabilityMode is not a mode it accepts. The snake_case key is not a Grok field.
+    if(fields.capabilityMode===null)warning(client,failure('UNSUPPORTED_ROLE_CAPABILITY'));
    }
    if(id==='gemini'){
     if(role.model!==null&&!['pro','flash','flash_lite','inherit'].includes(role.model))throw failure('UNSUPPORTED_NATIVE_SETTING');

package/src/native.mjs

@@ -25,10 +25,12 @@ export function nativeRoles(client,config,selectedRoles=ROLE_IDS) {
     if(client==='chatgpt') return Object.entries({name,description,model:selected.model,...(selected.effort===null?{}:{model_reasoning_effort:selected.effort}),developer_instructions:prompt}).map(([k,v])=>`${k} = ${JSON.stringify(v)}\n`).join('');
     const fields=[`name: ${name}`,`description: ${JSON.stringify(description)}`];
     // Grok selects the model from config.toml [subagents.models] and reads a role effort from the agent frontmatter;
-    // a null effort writes nothing, so the role keeps its model's native default. Read-only roles use the bundled plan permission mode.
+    // a null effort writes nothing, so the role keeps its model's native default. Grok Build reads camelCase agent fields:
+    // capabilityMode read-only removes the edit, write, delete and shell tools when a subagent of this type starts.
+    // Releases 0.4.0 and 0.5.0 wrote `permission_mode: plan`, which Grok Build ignores; `permissionMode: plan` has no effect at spawn.
     if(client==='grok') {
       if(selected.effort!==null)fields.push(`effort: ${selected.effort}`);
-      if(['reviewer','explorer'].includes(role))fields.push('permission_mode: plan');
+      if(['reviewer','explorer'].includes(role))fields.push('capabilityMode: read-only');
     } else if(client==='kimi') {
       if(['reviewer','explorer'].includes(role))fields.push('tools: [Read, Grep, Glob]');
     } else {