Nacos 3.2.0 Release Notes

This version focuses on plugin architecture enhancement, API modernization, AI Registry expansion, and code quality improvements.

🎯 Major Highlights

AI Registry Completes the "AI Triad"

Nacos 3.2.0 introduces Skill Registry and Prompt Registry, completing the AI control plane vision alongside existing MCP Registry and Agent Registry:

• Skill Registry: Centralized management for reusable, business-aligned capabilities composed of MCP tools with versioning, tags, and folder-based organization
• Prompt Registry: First-class prompt management with multi-version support, tag-based subscription, template management, and A/B testing capabilities
• Nacos Copilot: AI-powered assistant integrated into Nacos console, helping users optimize/create Prompts and Skills, and intelligently find existing skills from the registry

Plugin Architecture Modernization

Comprehensive plugin management system with SPI-based plugin discovery, management console UI, and cluster-wide state synchronization. PostgreSQL datasource plugin receives significant enhancements with merged implementations from nacos-plugin repository.

API Cleanup

The naming module removes legacy UDP PUSH support, moving to a cleaner HTTP API architecture with /v1 and /v2 APIs extracted to submodules for future removal.

MCP Enhancements

MCP (Model Context Protocol) support is expanded with tool _meta, annotations fields, and output scheme support.

Code Quality & Compatibility

Multiple FindBugs/SpotBugs fixes, dead code removal, and JDK 17+ compatibility enhancements.

⚠️ Breaking Changes & Migration Notes

API Legacy Adapter Plugin (Important)

Action Required: In this version, the plugins directory includes the api-legacy-adapter plugin by default to maintain compatibility with extracted /v1 and /v2 HTTP APIs. This plugin will be removed in future versions.

If you have confirmed that your deployment no longer uses the legacy /v1 or /v2 APIs, you can safely remove the api-legacy-adapter plugin from the plugins directory immediately to reduce footprint.

Feature

[#14050] Extract /v1 and /v2 HTTP APIs to submodules for future removal.
[#14052] Remove UDP PUSH support for naming module.
[#14077] Implement SPI-based plugin discovery and management API.
[#14078] Implement cluster-wide state synchronization.
[#14079] Add plugin management console UI and API.
[#14084] Support MCP Tool _meta and annotations fields.
[#14109] Introduce Prompt Registry as a core component of Nacos AI Registry.
[#14110] Introduce Skills Registry to complement Nacos AI Registry vision.
[#14122] Add JVM --add-opens options for JDK 17+ compatibility in startup scripts.
[#14245] Integrate Nacos Copilot for AI-assisted Prompt and Skill management.
[#14440] Add Prompt Registry with multi-version management support.
[#14453] Support tag-based subscription and management for Prompts.
[#14484] Add 'type' and 'md5' fields to findConfigInfoLike4PageFetchRows for plugin development.
[#14505] Refactor Prompt Registry to support parallel multi-version management.
[#14525] Add AI client proxy interface supporting HTTP and gRPC transport.
[#14534] Add find-skill-from-nacos capability for intelligent skill discovery.

Enhancement/Refactor

[#13699] Support outputSchema for MCP tools.
[#14048] Refactor datasource plugins structure and enhance PostgreSQL capabilities.
[#14056] Support output scheme and refactor the CreateTool.
[#14057] Refactor CreateTool and support output scheme.
[#14441] Refactor version comparison and JSON field handling with constants.
[#14461] Remove obsolete p3c-pmd plugin and cleanup annotations.
[#14463] Unify component scanning with custom package exclusion.
[#14468] Unify component scanning with custom package exclusion.
[#14479] Fix typo, incorrect Javadoc and improve resource management in health check processors.
[#14486] Remove unnecessary equals() override in enum classes.
[#14489] Align PostgreSQL trusted function enum and enrich tag queries.
[#14537] Normalize escaped YAML parsing and stabilize skill export/import roundtrips.
[#14545] Remove unused common.cache package (dead code from Guava removal attempt).
[#14565] Extract common RemoteServerConnector for AI services.

BugFix

[#14084] Support meta and annotation in mcp tools.
[#14117] Add plugin management console UI and API.
[#14471] Replace Long.valueOf() with Long.parseLong() to avoid unnecessary boxing.
[#14484] Add 'type' and 'md5' fields to findConfigInfoLike4PageFetchRows for plugin development.
[#14491] Fix DumpChangeGrayConfigWorker NPE.
[#14509] Fix non-short-circuit operator in for-loop condition.
[#14510] Fix clone() not calling super.clone() in ConfigForm.
[#14527] Add OIDC/OAuth2 Authentication Plugin (Server).
[#14533] Fix DM_DEFAULT_ENCODING: add explicit charset to avoid platform-dependent encoding.
[#14538] Fix DMI_RANDOM_USED_ONLY_ONCE: replace new Random() with ThreadLocalRandom.
[#14547] Fix HE_EQUALS_USE_HASHCODE: add missing hashCode() to Config model classes.
[#14548] Fix NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE: add null check in GrpcConnection callback.
[#14567] Fix console-ui TypeError in MainLayout and improve copilot module loading.

Dependencies

[#11180] Upgrade jraft-core version to 1.4.0.

Deployment Required

📚 What's New in AI Registry

Skill Registry

• Centralized Management: Create, update, and version skills via UI or API with changelogs
• Skill Composition: Chain multiple MCP tools into business-meaningful capabilities (e.g., "user_onboarding" = verify_email + create_profile + send_welcome_email)
• MCP Integration: Skills explicitly declare dependencies on registered MCP tools with integrity validation
• Folder-based Organization: Skills displayed in multi-level folder structure for better organization
• Agent-Friendly APIs: REST/gRPC APIs for agent frameworks (LangChain, CrewAI, etc.) to discover and subscribe to skills
• Upload Support: Upload skill packages (zip format, max 10MB) with authentication

Prompt Registry

• First-Class Configuration: Store prompts with metadata (agentId, modelId, version, tags) as versioned config artifacts
• Multi-Version Management: Support parallel multi-version management with template and commit message tracking
• Tag-Based Subscription: Subscribe to prompts by tags for dynamic updates
• Interactive Debugging: Test and compare prompt outputs across versions directly in console
• AI Client Proxy: Unified HTTP/gRPC client interface for prompt operations

Nacos Copilot

• AI-Powered Assistant: Integrated AI assistant to help optimize and create Prompts and Skills
• Intelligent Discovery: Automatically find relevant existing skills from the registry
• Console Integration: Accessible directly from Nacos console for seamless workflow

New Contributors

• @INotWant made their first contribution in #14009
• @QingYuanQ made their first contribution in #14020
• @echooymxq made their first contribution in #14100
• @shichaoyuan made their first contribution in #14099
• @chlch made their first contribution in #14104
• @lvren1485 made their first contribution in #14210
• @slightsharp made their first contribution in #14263
• @Cholesterol12138 made their first contribution in #14357
• @codezkk made their first contribution in #14401
• @1lck made their first contribution in #14449
• @Zjianru made their first contribution in #14461
• @qiacheng7 made their first contribution in #14465
• @aMetric made their first contribution in #14477
• @DocJlm made their first contribution in #14480
• @java-acc made their first contribution in #14485
• @FrioSea made their first contribution in #14476
• @saynoword made their first contribution in #14534

Full Changelog: 3.1.1...3.2.0-BETA