feat(nacos): For #293, add Nacos integration for AgentScope A2A registry and discovery.

[KomachiSion]

AgentScope-Java Version

1.0.5

Description

For #293 .

Checklist

Please check the following items before code is ready to be reviewed.

• Code has been formatted with mvn spotless:apply
• All tests are passing (mvn test)
• Javadoc comments are complete and follow project conventions
• Related documentation has been updated (e.g. links, examples, etc.)
• Code is ready for review

[Copilot]

Pull request overview

This PR adds Nacos integration for AgentScope's A2A (Agent-to-Agent) protocol, enabling automatic service registry and discovery functionality. The implementation follows established patterns and includes comprehensive test coverage.

Key Changes

• Nacos-based service discovery through NacosAgentCardResolver for client-side agent card resolution
• Nacos-based service registry through NacosAgentRegistry and NacosA2aRegistry for server-side agent registration
• Environment variable-based transport configuration with automatic parsing
• Bidirectional conversion utilities between Nacos and A2A specification formats

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
docs/zh/task/a2a.md	Added Chinese documentation for Nacos integration usage examples and configuration
docs/en/task/a2a.md	Added English documentation for Nacos integration usage examples and configuration
agentscope-extensions/pom.xml	Added Nacos extension module to parent POM
agentscope-extensions/agentscope-extensions-nacos/pom.xml	Created parent POM for Nacos extensions
agentscope-extensions/agentscope-extensions-nacos/agentscope-extensions-nacos-a2a/pom.xml	Configured A2A Nacos extension dependencies including nacos-client
agentscope-dependencies-bom/pom.xml	Added nacos-client version 3.1.1 to dependency management
NacosAgentCardResolver.java	Implements AgentCardResolver for retrieving agent cards from Nacos with caching and subscription
NacosAgentRegistry.java	Implements AgentRegistry for registering agent cards and endpoints to Nacos
NacosA2aRegistry.java	Core registry implementation handling Nacos API interactions
AgentCardConverterUtil.java	Utility for bidirectional conversion between Nacos and A2A spec AgentCard formats
NacosA2aTransportPropertiesEnvParser.java	Parses environment variables for transport configuration overrides
NacosA2aRegistryTransportProperties.java	Properties record for transport endpoint configuration
NacosA2aRegistryProperties.java	Properties record for A2A registry configuration
Constants.java	Defines constants and enums for transport attributes and environment variable prefixes
Test files	Comprehensive unit tests with good coverage of edge cases and error scenarios

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

❌ Patch coverage is 96.64269% with 14 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...pe/core/nacos/a2a/registry/NacosAgentRegistry.java	92.24%	1 Missing and 8 partials ⚠️
...e/core/nacos/a2a/registry/constants/Constants.java	88.23%	2 Missing ⚠️
...e/core/nacos/a2a/utils/AgentCardConverterUtil.java	98.26%	1 Missing and 1 partial ⚠️
...registry/NacosA2aTransportPropertiesEnvParser.java	97.91%	0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!