Skip to content

docs: document Claude Code dispatch_deadline for Agent Relay - #31834

Merged
nickvigilante merged 3 commits into
mainfrom
docs/agent-relay-claude-dispatch-deadline
Nov 9, 2026
Merged

nickvigilante merged 3 commits into
mainfrom
docs/agent-relay-claude-dispatch-deadline

Conversation

@coder

@coder coder Bot commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

Agent Relay v0.15.0 replaced the fixed 300-second Claude Code spawn budget with a per-pool dispatch_deadline (agent-relay#147).

  • claude-code.md: rewrite Build budget (default 5m, 10s to 15m, whole seconds, can't be turned off, sent to Anthropic as the hint TTL, needs v0.15.0) and add the field to both pool examples.
  • configuration.md: add dispatch_deadline to the Claude Code pool fields.
  • troubleshooting.md, monitoring/siem.md: drop the fixed 300-second wording.

Verification notes:

  • Checked against internal/services/serviceclaudecoderunners (parseDispatchDeadline, poller.go constants) at v0.15.0 (9b96578).
  • The old text said Agent Relay returns a missed-budget session as retryable. In v0.15.0, Claude requests use TerminalOnDeadline (agent-relay#138), so a failure at or after the deadline is nacked non-retryable. The page now says Agent Relay "reports the failure" and doesn't claim either way.

Stack 1/5. Review and merge in order:

Refs DOCS-1171

Generated by Coder Agents.

Agent Relay v0.15.0 (coder/agent-relay#147) replaces the fixed 300-second Claude Code spawn budget with a per-pool dispatch_deadline.
@linear-code

linear-code Bot commented Nov 6, 2026

Copy link
Copy Markdown

DOCS-1171

@nickvigilante nickvigilante left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

UUID and TTL are common enough knowledge that they can be added as exceptions to the Vale rule. Otherwise, it just creates excess noise.

@nickvigilante
nickvigilante marked this pull request as ready for review November 6, 2026 18:24
Per Atif's review, the docs point to the latest Agent Relay release
instead of tying options to versions.
> [!WARNING]
> Provisioner shortages feed themselves.
> A build that misses the budget is returned to Anthropic and its workspace is deleted, and Anthropic then sends the session again.
> A build that misses the budget fails, Agent Relay deletes its workspace, and Anthropic sends the session again.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@nickvigilante
nickvigilante merged commit f457b34 into main Nov 9, 2026
28 of 29 checks passed
@nickvigilante
nickvigilante deleted the docs/agent-relay-claude-dispatch-deadline branch November 9, 2026 19:09
@nickvigilante
nickvigilante temporarily deployed to main November 9, 2026 19:09 — with GitHub Actions Inactive
@github-actions github-actions Bot locked and limited conversation to collaborators Nov 9, 2026

This branch was previously deployed

1 inactive deployment
main — 0d05837c Deployed Nov 9, 2026 by nickvigilante via cla #252701
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

community Pull Requests and issues created by the community.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants