[AgentX] vLLM Deepseek-V4 B200/B300 agg

.github/codeowner-signoff-verify-prompt.md

@@ -121,7 +121,7 @@ For the commit that passed Check 1, confirm the eval numbers are real and meet t
   the same inference-engine image as this PR's config. FAIL if evals are
   skipped/failed/empty/below bar, or the image differs — say exactly which.
 
-## Check 3 — Recipe linked AND complete (SINGLE-NODE recipes only)
+## Check 3 — Recipe linked, MERGED, AND complete (SINGLE-NODE recipes only)
 APPLICABILITY — read this first: the recipe-link requirement covers SINGLE-NODE
 recipes only, because the official upstream recipe sources (vLLM recipes, SGLang
 cookbook) publish single-node serve commands. Disaggregated / multi-node
@@ -134,23 +134,31 @@ exclusively multi-node/disagg — files under `benchmarks/multi_node/**` (includ
 single-node recipes only` and DO NOT fail it. A sign-off note like "this is a
 disagg submission, no recipe update required" is a legitimate statement of that
 fact, not a violation. If the PR touches BOTH single-node and multi-node recipes,
-apply (a)/(b) below to the single-node portion only.
+apply (a)/(b)/(c) below to the single-node portion only.
 
 The InferenceX "recipe" for this PR = the files it changes under
 `benchmarks/single_node/**` plus its entry in `configs/*-master.yaml`. The merge
-standard is: the community must be able to reproduce this benchmark from a public
-recipe.
+standard is: the community must be able to reproduce this benchmark from merged,
+public upstream documentation.
 - (a) LINK PRESENT: The sign-off's "Additional detail section" MUST contain a link to
-  the corresponding recipe — a PR/commit in
+  the corresponding merged recipe PR in
   `https://github.com/vllm-project/recipes` or
   `https://github.com/sgl-project/sglang` (cookbook under `docs_new`), or the
   published recipe page (`https://recipes.vllm.ai/` or
   `https://docs.sglang.io/cookbook/...`). If no such link is present, FAIL.
-- (b) MAJOR SERVER ARGS MATCH: Fetch the linked recipe (use the `fetch` MCP tool or
-  WebFetch; for a recipe PR, read its diff via `gh pr diff` against that repo if
-  accessible) and compare it to this PR's launch command. The recipe only needs to
-  match the MAJOR, deployment-defining server args — NOT every flag, and explicitly
-  NOT the knobs that are specific to InferenceX benchmark/harness tuning.
+- (b) UPSTREAM CHANGE MERGED: For a linked GitHub PR, query the upstream repository
+  directly (for example, `gh pr view <URL> --json state,mergedAt,url`) and require
+  `state: MERGED` with a non-null `mergedAt`. An open PR, draft PR, closed-unmerged
+  PR, bare branch, or bare commit does NOT pass. A published recipe/cookbook page
+  containing the required recipe counts as merged upstream documentation. If the
+  linked artifact's merge/publication status cannot be verified, FAIL; never infer
+  that it merged from an approval, a green check, or the sign-off author's claim.
+- (c) MAJOR SERVER ARGS MATCH: Fetch the merged or published recipe (use the `fetch`
+  MCP tool or WebFetch; for a merged recipe PR, read its diff via `gh pr diff` against
+  that repo if accessible) and compare it to this PR's launch command. The recipe
+  only needs to match the MAJOR, deployment-defining server args — NOT every flag,
+  and explicitly NOT the knobs that are specific to InferenceX benchmark/harness
+  tuning.
     MAJOR (must match — these define the model, parallelism, precision, and which
     kernels run, so they determine the perf profile):
       - model / model-path, hardware/SKU
@@ -165,13 +173,14 @@ recipe.
     `--scheduler-recv-interval`, `--chunked-prefill-size`, `--disable-piecewise-cuda-graph`,
     `SGLANG_RADIX_FORCE_MISS` and similar env toggles, concurrency / sequence-length
     sweep ranges, ports, result filenames, and image tag/version.
-  FAIL only if a MAJOR arg in this PR is missing from (or contradicts) the recipe;
-  list exactly those. Treat the InferenceX-specific diffs as expected and mention them
-  only as a brief informational note, not as blockers. If a flag's effect is
-  equivalent to a recipe default (e.g. quantization auto-detected from an FP4 model),
-  say so and do not count it against the recipe.
+  FAIL if a MAJOR arg in this PR is missing from (or contradicts) the merged/published
+  recipe; list exactly those. Treat the InferenceX-specific diffs as expected and
+  mention them only as a brief informational note, not as blockers. If a flag's effect
+  is equivalent to a recipe default (e.g. quantization auto-detected from an FP4
+  model), say so and do not count it against the recipe.
 - Note: a bare "recipes are already similar to the official ones" claim WITHOUT a
-  link does not pass this workflow's standard — a link is required.
+  link to merged/published upstream documentation does not pass this workflow's
+  standard.
 
 ## Check 4 — Reuse-sweep command explicitly posted
 The supported merge path for an approved PR is reuse (`utils/merge_with_reuse.sh`),

benchmarks/single_node/agentic/dsv4_fp4_b200_vllm.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-set -euo pipefail
+set -eo pipefail
 set -x
 
 # Agentic trace replay benchmark for DeepSeek-V4-Pro FP4 on B200 using vLLM.
@@ -14,21 +14,25 @@ set -x
 #       Highest aggregate throughput at large CONC.
 #
 # Image is configured in nvidia-master.yaml. block_size=256,
-# kv-cache-dtype=fp8, FP4 indexer cache enabled, FULL_AND_PIECEWISE cudagraph
-# capture with custom_ops=all (per the vLLM blog recipe at
-# https://vllm.ai/blog/deepseek-v4).
+# kv-cache-dtype=fp8, FLASHINFER_MLA_SPARSE_DSV4 attention with the FP4 indexer
+# cache, FULL_DECODE_ONLY cudagraph capture, and (in EP tiers) mega-MoE backend.
 #
 # Required env vars:
 #   MODEL, TP, CONC, KV_OFFLOADING, TOTAL_CPU_DRAM_GB, RESULT_DIR
 #
-# KV_OFFLOADING=dram requires KV_OFFLOAD_BACKEND=mooncake.
+# Pure TP is GPU-resident (KV_OFFLOADING=none). DEP tiers offload KV to host
+# DRAM: KV_OFFLOADING=dram requires KV_OFFLOAD_BACKEND=vllm-simple or mooncake.
 
 source "$(dirname "$0")/../../benchmark_lib.sh"
 
 check_env_vars MODEL TP CONC KV_OFFLOADING TOTAL_CPU_DRAM_GB RESULT_DIR DURATION EP_SIZE DP_ATTENTION
 
-DCP_SIZE="${DCP_SIZE:-1}"
-PCP_SIZE="${PCP_SIZE:-1}"
+if [ -z "$DCP_SIZE" ]; then
+    DCP_SIZE=1
+fi
+if [ -z "$PCP_SIZE" ]; then
+    PCP_SIZE=1
+fi
 VLLM_CP_ARGS=()
 if [ "$DCP_SIZE" -gt 1 ]; then
     VLLM_CP_ARGS+=(--decode-context-parallel-size "$DCP_SIZE")
@@ -37,21 +41,21 @@ if [ "$PCP_SIZE" -gt 1 ]; then
     VLLM_CP_ARGS+=(--prefill-context-parallel-size "$PCP_SIZE")
 fi
 
-GPU_COUNT="${GPU_COUNT:-$((TP * PCP_SIZE))}"
+GPU_COUNT=$TP
 if [[ ! "$GPU_COUNT" =~ ^[1-9][0-9]*$ ]]; then
     echo "Error: GPU_COUNT must be a positive integer, got '$GPU_COUNT'" >&2
     exit 1
 fi
 export GPU_COUNT
 
-if [[ -n "${SLURM_JOB_ID:-}" ]]; then
-    echo "JOB $SLURM_JOB_ID running on ${SLURMD_NODENAME:-unknown}"
+if [[ -n "$SLURM_JOB_ID" ]]; then
+    echo "JOB $SLURM_JOB_ID running on $SLURMD_NODENAME"
 fi
 
 # `hf download` creates the target dir if missing and is itself idempotent.
 # When MODEL_PATH is unset (stand-alone runs), fall back to the HF_HUB_CACHE
 # Either way, MODEL_PATH is what the server is launched with.
-if [[ -n "${MODEL_PATH:-}" ]]; then
+if [[ -n "$MODEL_PATH" ]]; then
     if [[ ! -d "$MODEL_PATH" || -z "$(ls -A "$MODEL_PATH" 2>/dev/null)" ]]; then
         hf download "$MODEL" --local-dir "$MODEL_PATH"
     fi
@@ -65,12 +69,6 @@ nvidia-smi
 resolve_trace_source
 install_agentic_deps
 
-# vLLM v0.22.1 can ship CUTLASS DSL 4.5.2 with stale native MLIR bindings,
-# which fails DSV4 indexer compilation with mlir_global_dtors(..., data).
-# Reinstall the matching native wheel until NVIDIA/cutlass#3259 is resolved.
-agentic_pip_install --quiet --force-reinstall --no-deps \
-    'nvidia-cutlass-dsl-libs-cu13==4.5.2'
-
 # vllm-project/router expands the one HTTP backend into one logical worker per
 # DP rank and sends X-data-parallel-rank on forwarded requests. aiperf's
 # X-Correlation-ID is stable for every turn of a conversation; alias it to the
@@ -94,6 +92,10 @@ export VLLM_ENGINE_READY_TIMEOUT_S=3600
 # vllm-project/vllm#44774 applies the same reachability policy to Mooncake's
 # store mask. 32k matches the trace-replay tuning validated for this workload.
 export VLLM_PREFIX_CACHE_RETENTION_INTERVAL=32768
+export VLLM_USE_V2_MODEL_RUNNER=1
+export VLLM_USE_RUST_FRONTEND=1
+export VLLM_DSV4_MEGA_FP8_COMBINE=1
+export VLLM_RPC_TIMEOUT=600000
 
 # ---- Server config ----------------------------------------------------------
 SERVER_LOG="$RESULT_DIR/server.log"
@@ -106,8 +108,34 @@ ROUTER_PID=""
 MOONCAKE_MASTER_PID=""
 
 OFFLOAD_ARGS=()
-
-if require_agentic_kv_offload_backend mooncake; then
+case "$KV_OFFLOAD_BACKEND" in
+    "")
+        require_agentic_kv_offload_none
+        ;;
+    vllm-simple)
+        require_agentic_kv_offload_backend vllm-simple
+        CPU_BYTES_PER_RANK=$(( TOTAL_CPU_DRAM_GB * 1000 * 1000 * 1000 / GPU_COUNT ))
+        # Identical prefixes must hash to identical block keys across DP ranks.
+        export PYTHONHASHSEED=42
+        OFFLOAD_CONFIG=$(cat <<EOF
+{
+  "kv_connector": "SimpleCPUOffloadConnector",
+  "kv_role": "kv_both",
+  "kv_connector_extra_config": {
+    "cpu_bytes_to_use_per_rank": ${CPU_BYTES_PER_RANK},
+    "lazy_offload": false,
+    "enable_cross_layers_blocks": "true"
+  }
+}
+EOF
+)
+        OFFLOAD_ARGS=(
+            --kv-transfer-config
+            "$OFFLOAD_CONFIG"
+        )
+        ;;
+    mooncake)
+        require_agentic_kv_offload_backend mooncake
         # Embedded mode contributes one segment per GPU rank to a shared
         # distributed store, so pre-divide the aggregate host-memory budget.
         PER_RANK_GB=$((TOTAL_CPU_DRAM_GB / GPU_COUNT))
@@ -127,16 +155,14 @@ if require_agentic_kv_offload_backend mooncake; then
   "global_segment_size": "${PER_RANK_GB}GB",
   "local_buffer_size": "4GB",
   "protocol": "rdma",
-  "device_name": "mlx5_0",
+  "device_name": "",
   "enable_offload": false
 }
 EOF
         export MOONCAKE_CONFIG_PATH
+        export MC_ENABLE_DEST_DEVICE_AFFINITY=1
         # Identical prefixes must hash to identical store keys across DP ranks.
         export PYTHONHASHSEED=0
-        # B200 GPU memory registration works through DMA-BUF, but the compute
-        # nodes do not expose nvidia_peermem. Force Mooncake's DMA-BUF
-        # GPUDirect RDMA path instead of its legacy ibv_reg_mr path.
         export WITH_NVIDIA_PEERMEM=0
         export MC_SLICE_SIZE=1048576
         export MC_WORKERS_PER_CTX=4
@@ -167,16 +193,27 @@ EOF
             --kv-transfer-config
             '{"kv_connector":"MooncakeStoreConnector","kv_role":"kv_both","kv_connector_extra_config":{"load_async":true}}'
         )
-fi
+        ;;
+    *)
+        echo "Error: unsupported B200 KV_OFFLOAD_BACKEND='$KV_OFFLOAD_BACKEND'" >&2
+        exit 1
+        ;;
+esac
 
 PARALLEL_ARGS=(--tensor-parallel-size "$TP" --data-parallel-size 1)
 if [ "$DP_ATTENTION" = "true" ]; then
     PARALLEL_ARGS=(--tensor-parallel-size 1 --data-parallel-size "$TP")
 fi
 
 EP_ARGS=()
+FAST_MOE_ARGS=()
 if [ "$EP_SIZE" -gt 1 ]; then
     EP_ARGS=(--enable-expert-parallel)
+    FAST_MOE_ARGS=(
+        --moe-backend deep_gemm_amxf4_mega_moe
+        --enable-ep-weight-filter
+        --prefill-schedule-interval 16
+    )
 fi
 
 # AgentX concurrency counts live session trees, not individual requests.
@@ -197,18 +234,23 @@ VLLM_CMD=(
     --trust-remote-code
     --kv-cache-dtype fp8
     --block-size 256
-    "${PARALLEL_ARGS[@]}"
-    "${VLLM_CP_ARGS[@]}"
-    "${EP_ARGS[@]}"
-    --compilation-config '{"cudagraph_mode":"FULL_AND_PIECEWISE","custom_ops":["all"]}'
-    --attention_config.use_fp4_indexer_cache=True
+    --max-model-len 1048576
+    --gpu-memory-utilization 0.92
+    --numa-bind
+    --enable-cumem-allocator
+    --no-enable-flashinfer-autotune
     --tokenizer-mode deepseek_v4
-    --tool-call-parser deepseek_v4
-    --enable-auto-tool-choice
     --reasoning-parser deepseek_v4
-    --enable-prefix-caching
+    --attention-config '{"backend":"FLASHINFER_MLA_SPARSE_DSV4","use_prefill_query_quantization":true,"use_fp4_indexer_cache":true}'
     --no-disable-hybrid-kv-cache-manager
+    --disable-uvicorn-access-log
+    --compilation-config '{"cudagraph_mode":"FULL_DECODE_ONLY","mode":0}'
     --max-num-seqs "$MAX_NUM_SEQS"
+    --max-cudagraph-capture-size "$MAX_NUM_SEQS"
+    "${PARALLEL_ARGS[@]}"
+    "${VLLM_CP_ARGS[@]}"
+    "${EP_ARGS[@]}"
+    "${FAST_MOE_ARGS[@]}"
     "${OFFLOAD_ARGS[@]}"
 )
 printf '%q ' "${VLLM_CMD[@]}" | tee "$RESULT_DIR/vllm_command.txt"