Skip to content

[TRTLLM-15344][feat] nixl bounce v2 (2/6): wire protocol and transfer plan - #17604

Draft
chuangz0 wants to merge 2 commits into
NVIDIA:mainfrom
chuangz0:bounce-v2/p2-protocol
Draft

[TRTLLM-15344][feat] nixl bounce v2 (2/6): wire protocol and transfer plan#17604
chuangz0 wants to merge 2 commits into
NVIDIA:mainfrom
chuangz0:bounce-v2/p2-protocol

Conversation

@chuangz0

Copy link
Copy Markdown
Collaborator

@coderabbitai summary

Description

Part 2/6 of splitting the NIXL bounce-buffer v2 transport (#15780) into reviewable pieces. This PR adds the protocol layer:

  • BounceConfig — env-var driven configuration (byte-size suffix parsing, limits, opt-in knobs)
  • BounceMessage — control-plane wire codec (chunk grant/complete messages + the capability handshake encodeHandshake/decodeHandshake used during agent connection)
  • BounceTransferPlan — maps a TransferRequest onto bounce chunks (region splitting, size limits)

Pure logic, unit-tested, still not reachable from production paths.

Stack: part 2/6, stacked on #17603 — review only the last commit (nixl bounce v2 (2/6)); the earlier commits belong to part 1. Umbrella: #15780.

Test Coverage

  • cpp/tests/unit_tests/executor/bounce/bounceConfigTest.cpp
  • cpp/tests/unit_tests/executor/bounce/bounceMessageCodecTest.cpp
  • cpp/tests/unit_tests/executor/bounce/bounceTransferPlanTest.cpp

PR Checklist

Please review the following before submitting your PR:

  • PR description clearly explains what and why. If using CodeRabbit's summary, please make sure it makes sense.

  • PR Follows TRT-LLM CODING GUIDELINES to the best of your knowledge.

  • Test cases are provided for new code paths (see test instructions)

  • If PR introduces API changes, an appropriate PR label is added - either api-compatible or api-breaking. For api-breaking, include BREAKING in the PR title.

  • Any new dependencies have been scanned for license and vulnerabilities

  • CODEOWNERS updated if ownership changes

  • Documentation updated as needed

  • Update tava architecture diagram if there is a significant design change in PR.

  • The reviewers assigned automatically/manually are appropriate for the PR.

  • Please check this after reviewing the above items as appropriate for this PR.

GitHub Bot Help

To see a list of available CI bot commands, please comment /bot help.

🤖 Generated with Claude Code

@chuangz0 chuangz0 changed the title [None][feat] nixl bounce v2 (2/6): wire protocol and transfer plan [TRTLLM-15344][feat] nixl bounce v2 (2/6): wire protocol and transfer plan Aug 13, 2026
Buddy allocator, shared data arena, execution-context pool, and the
gather/scatter CUDA kernel, plus their unit tests. These are the
dependency-free building blocks of the NIXL bounce-buffer v2 transport;
nothing is wired into production paths yet.

Signed-off-by: Chuang Zhu <111838961+chuangz0@users.noreply.github.com>
Bounce config (env-var parsing), wire message codec (control-plane
messages + capability handshake encode/decode), and the transfer-plan
builder that maps a TransferRequest onto bounce chunks. Unit-tested;
still not reachable from production paths.

Signed-off-by: Chuang Zhu <111838961+chuangz0@users.noreply.github.com>
@chuangz0
chuangz0 force-pushed the bounce-v2/p2-protocol branch from 8724620 to 03b063a Compare August 13, 2026 05:18
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