## Summary
Grok Build and GitHub Copilot now get a named failure for each
connection problem the sheet asks about. The command in each sentence is
one that CLI's own help prints.
- Not installed: `npm i -g @xai-official/grok` and `npm i -g
@github/copilot`, unchanged.
- Installed, but not on the login PATH Raven launches with: the row says
where the binary is, instead of saying it is not installed. Checked for
`grok` and `copilot` only, under Homebrew's prefix, `/usr/local/bin` and
`~/.local/bin`.
- No provider: Copilot's own line "Offline mode requires a local model
provider" says to set `COPILOT_PROVIDER_BASE_URL`. No command is
attached. Offline mode does not authenticate, and `setup` with no
command renders as a sign-in.
- Invalid API key and an expired sign-in are different sentences. A
GitHub token still runs `grok login` or `copilot login`. A Copilot
provider key (HTTP 401 or 403, naming `COPILOT_PROVIDER_API_KEY`) stays
in the record and has no remedy: `api_key` is the sheet's key field, and
this row is ACP, so that control is not there.
- Model not served: `model`, with no command. `grok models` only lists
models, and `copilot --model` applies to that process only, so neither
changes the next ACP launch.
- Out of credit: billing. An expired Copilot subscription: `plan`, not
billing. Billing tells the reader to add provider credit or switch
models, and neither renews the subscription.
- Rate limit or spent quota, and a prompt that times out: `grok -p hi`
or `copilot -p hi`, the one-shot flags their help names. Copilot's 429
was still retrying when the connect wait ended.
- DNS, proxy, or a provider that cannot be reached: the network
sentence, including Copilot's "Could not connect", tunnel error, and
"error sending request for url".
- ACP server did not start: a handshake that times out on `initialize`
says so.
- Too old to speak ACP: Copilot's `unexpected argument '--acp'` (the
wording `copilot --not-a-flag` uses) and Grok's `unrecognized subcommand
'agent'` (the wording `grok agent nosuch` uses) name `npm i -g
<package>@latest`.
- Quit on start for another reason: the stderr is kept. Copilot's "no
platform package found" names the reinstall.
Grok Build is a native binary, and Copilot's package declares no
`engines.node`. An old Node.js is not given an invented version number.
A Copilot model-call refusal that arrives as the assistant text of a
finished turn is still a failure, not a success.
## Type
- [x] Fix
- [ ] Feature
- [ ] Docs
- [ ] CI / tooling
- [ ] Refactor
- [ ] Other
## Verification
- `uv run --frozen --python 3.12 --extra dev ruff check` on the touched
Python files: clean. `ruff format --check` on the same files: clean.
- `uv run --frozen --python 3.12 --all-extras ty check raven evolver
agents plugins-dist scripts`: all checks passed.
- `COLORTERM=truecolor uv run --frozen --python 3.12 --extra dev pytest
-q tests/test_subagent_github_copilot.py
tests/test_subagent_third_party.py tests/test_subagent_probe_state.py
tests/test_subagent_node_runtime.py tests/test_subagent_acp.py
tests/test_rpc_subagents.py`: 726 passed.
- Reverting `raven/agent/subagent/probe.py` to `origin/main` makes
`test_a_finished_turn_whose_message_is_the_refusal_is_not_a_success`
fail (`ok=True`, detail `it ran and replied`).
- `PYTHONPATH=. uv run --frozen --python 3.12 --extra dev python
scripts/check_source_language.py origin/main...HEAD`: exit 0.
- `git merge-tree --write-tree HEAD origin/main`: clean. `git diff
--check origin/main...HEAD`: clean.
The full suite was not run. `make lint-imports` and `make lint-deps`
were not rerun locally; the python lint job runs them.
- [x] Relevant tests pass locally
- [x] Relevant lint / type checks pass locally
- [ ] User-facing docs or screenshots are updated when needed
The page uses remedy kinds it already has. No new kind was added.
## Risk
- [x] Security impact considered
- [x] Backward compatibility considered
- [x] Rollback path is clear for risky changes
The PATH check and the new sentences apply only to the `grok` and
`github_copilot` presets. A reply that is not one of the measured
Copilot sentences stays a success. Qwen and Kimi keep their own
commands.
Rollback: revert the squash commit. There is no migration.
## Related Issues
N/A