Skip to content

[None][fix] Log and validate transceiver runtime selection for hybrid managers#4

Open
lingjiew wants to merge 1 commit into
nv-guomingz:user/guomingz/qwen3.5_agentxfrom
lingjiew:user/lingjiew/fix-transceiver-selection-logging
Open

[None][fix] Log and validate transceiver runtime selection for hybrid managers#4
lingjiew wants to merge 1 commit into
nv-guomingz:user/guomingz/qwen3.5_agentxfrom
lingjiew:user/lingjiew/fix-transceiver-selection-logging

Conversation

@lingjiew

@lingjiew lingjiew commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

Bug

Two silent-selection gaps in create_kv_cache_transceiver:

  1. Silent CPP override. With V2MambaHybridCacheManager, the isinstance branch overrides an explicit transceiver_runtime='CPP' and instantiates KvCacheTransceiverV2 with no message. The LlmArgs dump in the worker log still prints transceiver_runtime='CPP', so the log actively misleads anyone debugging which transceiver ran (we lost time to exactly this on the Qwen3.5 GB300 bring-up — the config echo said CPP while the runtime was the python transceiver).

  2. Late failure on an unsupported pairing. transceiver_runtime='PYTHON' combined with CppMambaHybridCacheManager (reachable via TLLM_MAMBA_MANAGER_PREFERENCE=CPP) fails deep inside the python transceiver on an unsupported manager type instead of at selection time.

Fix

  • Emit a logger.warning when an explicit 'CPP' request is overridden by the V2-hybrid isinstance route.
  • Raise an actionable ValueError for PYTHON + CppMambaHybridCacheManager at the factory, naming the two valid alternatives.

No behavior change for any currently-working configuration — additions are a warning and an early error on a pairing that could not work anyway.

Related: #2, and a sibling PR removing the stale PYTHON->Mixed manager rule in _util.py.

🤖 Generated with Claude Code

… managers

Two silent-selection gaps in create_kv_cache_transceiver:

1. When the KV manager is V2MambaHybridCacheManager, the factory
   overrides an explicit transceiver_runtime='CPP' and instantiates
   KvCacheTransceiverV2 with no message — the LlmArgs dump still shows
   runtime='CPP', which misleads debugging. Emit a warning when the
   explicit CPP request is overridden.

2. transceiver_runtime='PYTHON' combined with
   CppMambaHybridCacheManager (e.g. via
   TLLM_MAMBA_MANAGER_PREFERENCE=CPP) fails deep inside the python
   transceiver on an unsupported manager type. Fail fast with an
   actionable ValueError instead.

Signed-off-by: Lingjie Wu <lingjiew@nvidia.com>
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