Files
Nick Vigilante b9741840eb docs: update Agent Relay docs for v0.16.0 (#32094)
Brings the Agent Relay docs up to v0.16.0, per Atif's request for a pass
against the new release.

Of the seven PRs in v0.16.0, only
[agent-relay#155](https://github.com/coder/agent-relay/pull/155) changes
behavior users see. `main` already described most of it ahead of the
release (#31896) as "newer than v0.15.0". This PR fills the remaining
gaps:

- `setup.md`, `troubleshooting.md`: "newer than v0.15.0" becomes
"v0.16.0 and later". Both pages now say Claude Code skips its one retry
when the failure comes later than `dispatch_deadline` after the build
was created.
- `setup.md` **Workspace lifecycle**: a row for failed or timed-out
startup scripts, and a note that these don't wait for the startup grace.
- `configuration.md` `--reap-startup-grace`: the "fails after this
grace" bullet notes the faster startup-script failure.
- `claude-code.md` **Build budget**: when a build succeeds but the
runner never starts, Anthropic retries only on the session's first
delivery and only within `dispatch_deadline`. Otherwise the session
fails. In v0.15.0 that nack was always retryable.

Verification notes (agent-relay `v0.15.0...v0.16.0`):
- `serviceclaudecoderunners/reap.go`: for a `pending` runner, `retryable
= !redelivered(attempt) && (dispatchDeadline == 0 || obs.Age <
dispatchDeadline)`. `obs.Age` counts from the latest build's creation,
not from the work order's issue.
- `workspacereaper/reaper.go` `confirmStartupFailure`: the first
`pending` read after `start_error` or `start_timeout` is stored. A later
sweep confirms only when its sample's `CollectedAt` is newer, and a
sweep that re-reads the same sample doesn't reset it. So the docs say
"two `pending` reads, the second from a newer sample", not "two sweeps
in a row".
- `workspacereaper/lifecycle.go` `StartupFailure`: applies only to
running builds whose status is `pending`.

Not documented:
- The example templates (agent-relay#157), because the repository is
internal.
- The older-coderd `include_agent_metadata` detection fix
(agent-relay#146), which is a bug fix with no setting or behavior
change.
- The agent lifecycle in nack failure details, a minor diagnostic
change.

Stack 6/6. Review and merge in order:
- #31834 (merged)
- #31984
- #31985
- #31986
- #31987
- #32094

Refs DOCS-1171

> Generated by Coder Agents on behalf of @nickvigilante.
2026-11-12 13:56:35 -05:00
..