Skip to content

Conversation

@agents-git-bot
Copy link

@agents-git-bot agents-git-bot bot commented Nov 21, 2025

Summary

This sync updates the MCP client documentation to reflect changes from cloudflare/agents PR #672:

Breaking Changes

  • Documented new connection state machine with separate CONNECTED and READY states
  • ClientConnection.init() no longer automatically discovers capabilities

New Features

  • Added MCPConnectionState enum documentation with all possible states
  • Documented new CONNECTED state for transport connection without capabilities
  • Added detailed state transition flows for OAuth and non-OAuth connections

Improvements

  • Updated error handling section to reflect fail-fast behavior with Promise.all
  • Added explanations for each connection state
  • Clarified the difference between CONNECTED and READY states

Related PR

cloudflare/agents#672

🤖 Generated with Claude Code

@github-actions github-actions bot added the product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. label Nov 21, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 21, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/pcx-technical-writing
/src/content/docs/agents/ @irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @cloudflare/pcx-technical-writing

@agents-git-bot agents-git-bot bot requested a review from a team as a code owner November 21, 2025 18:54
@agents-git-bot agents-git-bot bot changed the title docs: sync MCP client API changes from cloudflare/agents#672 docs: Add MCPConnectionState enum and update MCP documentation (sync PR #672) Nov 21, 2025
@agents-git-bot agents-git-bot bot changed the title docs: Add MCPConnectionState enum and update MCP documentation (sync PR #672) feat: enums connection state Nov 23, 2025
@agents-git-bot
Copy link
Author

Added additional enhancements to the documentation:

  • ✅ Added comprehensive changelog entry for MCP connection state improvements (new file: 2025-11-24-mcp-connection-state-improvements.mdx)
  • ✅ Enhanced connection state descriptions with clearer explanations
  • ✅ Added version note about v0.0.24 changes
  • ✅ Improved formatting with "Connection States" subsection header

The documentation now includes:

  • All 6 connection states with detailed descriptions
  • Clear explanation of the new connected state
  • Version-specific notes for developers upgrading
  • Changelog documenting breaking changes and improvements

Synced from cloudflare/agents PR #672

- Document new MCPConnectionState enum with type-safe constants
- Add new 'connected' state to connection state machine
- Update state transition documentation
- Document improved discovery error handling
- Add changelog entry for breaking changes and new features

Related PR: cloudflare/agents#672

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@agents-git-bot agents-git-bot bot changed the title feat: enums connection state feat: enums connection state and standardise tool discovery Nov 25, 2025
This sync updates the documentation to reflect changes from cloudflare/agents PR #672:

- Documented new connection state machine with separate CONNECTED and READY states
- ClientConnection.init() no longer automatically discovers capabilities

- Added MCPConnectionState enum documentation with all possible states
- Documented new CONNECTED state for transport connection without capabilities
- Added detailed state transition flows for OAuth and non-OAuth connections

- Updated error handling section to reflect fail-fast behavior with Promise.all
- Added explanations for each connection state
- Clarified the difference between CONNECTED and READY states

Related PR: cloudflare/agents#672

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants