[CI/Build][Router] Enable lmcache 0.5.4 for the kvaware router stack

docker/Dockerfile.kvaware

@@ -1,4 +1,9 @@
-FROM lmcache/vllm-openai:2025-05-27-v1
+# The base image supplies the lmcache + vllm pair the router runs with.
+# It MUST match the engines' image versions: lmcache's controller<->worker
+# ZMQ messages are version-locked, and kv-aware chunk hashes are rooted in
+# vLLM's NONE_HASH - a mismatch on either side makes every KV lookup miss
+# silently (routing degrades to session/QPS with no error).
+FROM lmcache/vllm-openai:v0.5.4
 
 WORKDIR /app
 

pyproject.toml

@@ -47,13 +47,21 @@ semantic_cache = [
     "huggingface-hub==0.34.0",
 ]
 lmcache = [
-    "lmcache==0.3.11",
-    "vllm==0.13.0",
+    # lmcache's controller<->worker ZMQ messages are NOT a stable protocol
+    # across versions (a 0.3.x controller rejects a 0.4+/0.5+ worker's
+    # RegisterMsg as an unknown type), so the router-side lmcache MUST match
+    # the engines' lmcache exactly - keep this pin in lockstep with the
+    # engine images you deploy. vllm is required for hash parity: kv-aware
+    # chunk hashes are rooted in vLLM's NONE_HASH and hash fn, and a router
+    # without the engines' vllm derives a different chain (every lookup
+    # silently misses).
+    "lmcache==0.5.4",
+    "vllm==0.22.0",
 ]
 test = [
     "pytest>=8.3.4",
     "pytest-asyncio>=0.25.3",
-    "vllm==0.13.0"
+    "vllm==0.22.0"
 ]
 
 [build-system]

tutorials/assets/values-17-kv-aware.yaml

@@ -3,7 +3,7 @@ servingEngineSpec:
   modelSpec:
   - name: "gpt-oss-20b"
     repository: "lmcache/vllm-openai"
-    tag: "v0.3.9post2"
+    tag: "v0.5.4"
     modelURL: "openai/gpt-oss-20b"
     replicaCount: 2
     requestCPU: 8