Skip to content

Rename protocol to "Synadia Agent Protocol for NATS"#103

Merged
M64GitHub merged 2 commits into
mainfrom
rename-protocol
May 11, 2026
Merged

Rename protocol to "Synadia Agent Protocol for NATS"#103
M64GitHub merged 2 commits into
mainfrom
rename-protocol

Conversation

@M64GitHub
Copy link
Copy Markdown
Contributor

Summary

  • Renames the protocol to Synadia Agent Protocol for NATS across all user-facing prose (READMEs, CHANGELOGs, package descriptions) and source-file headers/docstrings.
  • Mechanical 1:1 name swap — 60 occurrences across 52 files. No behaviour change.
  • Wire shape, protocol version (0.3), published package names (@synadia-ai/agents, synadia-ai-agents, etc.), and the synadia-ai/nats-agent-sdk-docs GitHub URL slug are all unchanged.

Test plan

  • git grep "NATS Agent Protocol" returns nothing
  • TS workflows (client-sdk-typescript.yml, agent-sdk-typescript.yml) green — prose-only diff, no code paths touched
  • Python workflows (client-sdk-python.yml, client-sdk-python-agent-service.yml) green
  • Spot-check rendered READMEs on GitHub for awkward sentences after the substitution

🤖 Generated with Claude Code

Mechanical rename across READMEs, CHANGELOGs, package descriptions,
and source-file headers/docstrings. No behaviour change — protocol
wire shape, version (0.3), package names, and GitHub repo URLs are
all unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@synadia-claude-reviewer
Copy link
Copy Markdown

synadia-claude-reviewer Bot commented May 11, 2026

Claude finished @M64GitHub's task in 2m 35s —— View job


PR Review

  • Gather PR diff and context
  • Check for missed/inconsistent renames
  • Verify no code behavior changes snuck in
  • Check CLAUDE.md alignment
  • Post review summary

Summary: Pure prose rename, mechanically consistent. No behaviour change, no wire shape change, no API surface change. The test plan's git grep "NATS Agent Protocol" passes cleanly on the committed HEAD.

One phrasing nit worth fixing before merge:

agents/open-agent/README.md line 3 now reads:

A Synadia Agent Protocol for NATS bridge for vercel-labs/open-agents

The double "for" ("for NATS bridge for vercel-labs") is awkward. Consider:

A bridge implementing the Synadia Agent Protocol for NATS for vercel-labs/open-agents

or just restructure to sidestep the collision:

An Synadia Agent Protocol for NATS bridge to vercel-labs/open-agents

Fix this →

Everything else looks correct:

  • All 60 occurrences renamed; NatsAgentError/ProtocolError class names and all package identifiers are intentionally unchanged.
  • errors.py docstring updated correctly without touching the class name.
  • .github/workflows/claude.yml review-focus text updated consistently.
  • Wire protocol version (0.3), subject namespace, and service names are untouched throughout.

Comment thread agents/open-agent/README.md Outdated
# `@synadia-ai/open-agent`

A NATS Agent Protocol bridge for
A Synadia Agent Protocol for NATS bridge for
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Double "for" reads awkwardly: "for NATS bridge for vercel-labs". Consider restructuring:

Suggested change
A Synadia Agent Protocol for NATS bridge for
A bridge implementing the **Synadia Agent Protocol for NATS** for

- client-sdk/python/src/synadia_ai/agents/errors.py: split ProtocolError
  docstring to fit the 100-char line limit.
- agents/open-agent/README.md: reword "Synadia Agent Protocol for NATS
  bridge for vercel-labs/open-agents" to avoid the awkward double "for"
  (per reviewer suggestion).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@M64GitHub
Copy link
Copy Markdown
Contributor Author

@claude - please review again, we have fixed the issues ...

@synadia-claude-reviewer
Copy link
Copy Markdown

synadia-claude-reviewer Bot commented May 11, 2026

Claude finished @M64GitHub's task in 58s —— View job


Re-review

  • Check the fixed file (agents/open-agent/README.md)
  • Scan diff for any new changes
  • Post review summary

The previous nit has been addressed. agents/open-agent/README.md line 3 now reads:

A bridge implementing the Synadia Agent Protocol for NATS for vercel-labs/open-agents

That's the exact restructure suggested in the prior review — clean, no more double "for".

Everything else remains correct:

  • git grep "NATS Agent Protocol" on the committed branch state returns nothing (the sole hit in the working tree is a local CLAUDE.md modification that isn't part of the PR commits).
  • The errors.py +4/-1 delta is a pure docstring reformat splitting one long line into a multi-line form — class name ProtocolError and all behaviour are unchanged.
  • 52 files, 60 occurrences renamed, no code paths touched, no wire shape change, no API surface change.

This PR is ready to merge.

@M64GitHub M64GitHub merged commit c95ab54 into main May 11, 2026
20 checks passed
M64GitHub added a commit that referenced this pull request May 11, 2026
* release prep: 0.5.x patch wave for protocol rename

Bumps six @synadia-ai/* packages to refresh their npmjs.com
descriptions after PR #103's protocol-name sweep. No API, wire shape,
or protocol version (0.3) changes ship here.

Versions:

- @synadia-ai/agents:                      0.5.0 → 0.5.1
- @synadia-ai/agent-service:               0.5.1 → 0.5.2  (also rolls
                                            in §6.4 leading-ack work
                                            currently in [Unreleased])
- @synadia-ai/nats-channel (openclaw):     0.5.5 → 0.5.6
- @synadia-ai/nats-pi-channel:             0.5.2 → 0.5.3
- @synadia-ai/nats-pi-headless:            0.5.3 → 0.5.4
- @synadia-ai/nats-claude-code-headless:   0.5.3 → 0.5.4

file: links are preserved (main's default dev state). The publish
ladder runs `./devtools/devmode.sh off` locally before publish, then
`on` after — see README-DEV.md §"Releasing the SDKs".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(agents/{pi,openclaw}): rename stale "nats-agent-protocol" keyword

Per PR reviewer: the rename sweep missed the kebab-case keyword in
these two package.json files. Replace with "synadia-agent-protocol"
so npm discoverability matches the new protocol name.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.

1 participant