Skip to content

[ISSUE #14804] Add Agent and RAD contract models - #15551

Merged
KomachiSion merged 1 commit into
alibaba:developfrom
KomachiSion:codex/agent-rad-models
Jul 21, 2026
Merged

KomachiSion merged 1 commit into
alibaba:developfrom
KomachiSion:codex/agent-rad-models

Conversation

@KomachiSion

Copy link
Copy Markdown
Collaborator

Please do not create a Pull Request without creating an issue first.

What is the purpose of the change

For #14804

Implement the first code batch for the Agent management and Remote Agent Discovery (RAD) 0.1.0 specifications merged in #15545. This establishes the Java contract models and deterministic local validation needed before server storage, API, and runtime implementation.

Brief changelog

  • Add protocol-neutral Agent management and RAD discovery/publication DTOs.
  • Add strict Agent version and range parsing, Endpoint canonicalization and natural keys, and aggregate validators under ai.utils.
  • Represent lifecycle status as String values backed by AiConstants.Agent, keeping validation independent of Jackson-specific mapping annotations.
  • Add complete serialization/deserialization and validation unit tests, and document the deferred Java SDK IT scope until an SDK service and transport exist.

Verifying this change

  • mvn -pl api test: 1,151 tests passed.
  • Focused Agent/RAD test suite: 90 tests passed.
  • JaCoCo line coverage for the new Agent/RAD models and utilities: 1,587/1,587 (100%).
  • mvn -B clean compile apache-rat:check checkstyle:check spotbugs:check spotless:check -e -Dorg.slf4j.simpleLogger.log.org.apache.maven.cli.transfer.Slf4jMavenTransferListener=warn: all 60 reactor modules passed.

Follow this checklist to help us incorporate your contribution quickly and easily:

  • Make sure there is a Github issue filed for the change (usually before you start working on it). Trivial changes like typos do not require a Github issue. Your pull request should address just this issue, without pulling in other changes - one PR resolves one issue.
  • Format the pull request title like [ISSUE #123] Fix UnknownException when host config not exist. Each commit in the pull request should have a meaningful subject line and body.
  • Write a pull request description that is detailed enough to understand what the pull request does, how, and why.
  • Write necessary unit-test to verify your logic correction, more mock a little better when cross module dependency exist. This batch exposes models and local validation only; Java SDK integration scenarios are recorded as pending until the SDK service and transport implementation.
  • Run the relevant compile, RAT, Checkstyle, SpotBugs, Spotless, unit-test, and coverage checks described above.

Introduce protocol-neutral Agent management and RAD discovery models, deterministic endpoint and version utilities, validators, and comprehensive tests.

Assisted-by: OpenAI Codex
@KomachiSion KomachiSion added this to the 3.3.0 milestone Jul 21, 2026
@KomachiSion
KomachiSion merged commit 80bee61 into alibaba:develop Jul 21, 2026
7 of 9 checks passed
@KomachiSion
KomachiSion deleted the codex/agent-rad-models branch July 21, 2026 12:44
@github-actions

Copy link
Copy Markdown

Thanks for your this PR. 🙏
Please check again for your PR changes whether contains any usage/api/configuration change such as Add new API , Add new configuration, Change default value of configuration.
If so, please add or update documents(markdown type) in docs/next/ for repository nacos-group/nacos-group.github.io


感谢您提交的PR。 🙏
请再次查看您的PR内容,确认是否包含任何使用方式/API/配置参数的变更,如:新增API、新增配置参数、修改默认配置等操作。
如果是,请确保在提交之前,在仓库nacos-group/nacos-group.github.io中的docs/next/目录下添加或更新文档(markdown格式)。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants