Skip to content

AGENTS.md: require wire-compatible proto changes - #189

Merged
shawnburke merged 1 commit into
mainfrom
shawn/agents-md-wire-compat
Nov 10, 2026
Merged

shawnburke merged 1 commit into
mainfrom
shawn/agents-md-wire-compat

Conversation

@shawnburke

Copy link
Copy Markdown
Collaborator

Summary

Adds a Protocol compatibility section to AGENTS.md. Tunnel servers and agents deploy independently and run mixed versions, so changes under proto/ must be wire compatible in both directions. Existing functionality must never depend on which side is upgraded first.

  • Change by adding: new fields, new enum values, new oneof members. Never renumber, reuse, or change the type or meaning of an existing field. A retired field's number and name are reserved.
  • New features may need both sides before they work, but an older peer must degrade gracefully: existing behavior continues, and nothing fails, hangs, or tears down the stream.
    • Treat a new field's zero value as "the peer didn't say".
    • Ignore unrecognized oneof members instead of treating them as a protocol error.
    • Bound anything that waits on a newer peer.

#186 follows these rules: its CallCancel fields 3–7 and its agent-report grace period are the examples.

Test plan

  • Docs only

🤖 Generated with Claude Code

Tunnel servers and agents deploy independently and run mixed versions, so
a proto change must never make existing functionality depend on which side
is upgraded first. New features may need both sides before they light up,
but an older peer must degrade gracefully, not fail.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@keithfz keithfz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

stat padding

@shawnburke
shawnburke enabled auto-merge (squash) November 10, 2026 01:22
@shawnburke
shawnburke merged commit 2f2233f into main Nov 10, 2026
27 checks passed
@shawnburke
shawnburke deleted the shawn/agents-md-wire-compat branch November 10, 2026 01:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants