feat: enable E2E testing with LLM Katan - 00-client-request-test (vllm-project#290)

* feat: enable E2E testing with LLM Katan and fix configuration

- Remove Ollama dependencies from E2E config as requested
- Update config.e2e.yaml to use only LLM Katan models (Qwen/Qwen2-0.5B-Instruct, TinyLlama/TinyLlama-1.1B-Chat-v1.0)
- Fix bash 3.2 compatibility in start-llm-katan.sh (replace associative arrays)
- Add required use_reasoning fields to all model entries for validation
- Fix zero scores in model configurations (0.0 → 0.1)

Testing Status:
- ✅ Router: Successfully starts with E2E config (ExtProc on :50051, API on :8080)
- ✅ LLM Katan: Running on ports 8000/8001 with correct model mapping
- ✅ Envoy: Running on port 8801
- ✅ Test: 00-client-request-test.py passes with 200 OK responses
- ✅ Pipeline: Full end-to-end flow working (Client → Envoy → ExtProc → LLM Katan)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Signed-off-by: Yossi Ovadia <[email protected]>

* fix: apply pre-commit formatting fixes

Apply black and isort formatting to LLM Katan Python files
as required by pre-commit hooks.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Signed-off-by: Yossi Ovadia <[email protected]>

* refactor: simplify model names to Model-A and Model-B for E2E testing

- Update LLM Katan configuration to use simplified model names
- Simplify 00-client-request-test.py to use Model-A as default
- Update documentation to reflect math → Model-B, creative → Model-A routing
- Improve test readability and maintainability

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Signed-off-by: Yossi Ovadia <[email protected]>

* fix: apply pre-commit formatting fixes

- Fix markdown linting issues in CLAUDE.md files
- Apply black formatting to Python files

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Signed-off-by: Yossi Ovadia <[email protected]>

---------

Signed-off-by: Yossi Ovadia <[email protected]>
Co-authored-by: Claude <[email protected]>
Signed-off-by: liuhy <[email protected]>

Author: 2 people

config/config.e2e.yaml

@@ -39,101 +39,32 @@ prompt_guard:
 
 # vLLM Endpoints Configuration - supports multiple endpoints, each can serve multiple models
 vllm_endpoints:
-  - name: "endpoint1"
-    address: "127.0.0.1"
-    port: 11434
-    models:
-      - "phi4"
-      - "gemma3:27b"
-    weight: 1  # Load balancing weight
-    health_check_path: "/health"  # Optional health check endpoint
-  - name: "endpoint2"
-    address: "127.0.0.1"
-    port: 11434
-    models:
-      - "mistral-small3.1"
-    weight: 1
-    health_check_path: "/health"
-  - name: "endpoint3"
-    address: "127.0.0.1"
-    port: 11434
-    models:
-      - "phi4"  # Same model can be served by multiple endpoints for redundancy
-      - "mistral-small3.1"
-    weight: 2  # Higher weight for more powerful endpoint
   - name: "qwen-endpoint"
     address: "127.0.0.1"
     port: 8000
     models:
-      - "Qwen/Qwen2-0.5B-Instruct"
+      - "Model-A"
     weight: 1
     health_check_path: "/health"
   - name: "tinyllama-endpoint"
     address: "127.0.0.1"
     port: 8001
     models:
-      - "TinyLlama/TinyLlama-1.1B-Chat-v1.0"
+      - "Model-B"
     weight: 1
     health_check_path: "/health"
 
 model_config:
-  phi4:
-    pricing:
-      currency: USD
-      prompt_per_1m: 0.07
-      completion_per_1m: 0.35
-    pii_policy:
-      allow_by_default: false  # Deny all PII by default
-      pii_types_allowed: ["EMAIL_ADDRESS", "PERSON", "GPE", "PHONE_NUMBER"]  # Only allow these specific PII types
-    # Specify which endpoints can serve this model (optional - if not specified, uses all endpoints that list this model)
-    preferred_endpoints: ["endpoint1", "endpoint3"]
-    # Reasoning family - phi4 doesn't support reasoning, so omit this field
 
-  # Example: DeepSeek model with custom name
-  "ds-v31-custom":
-    reasoning_family: "deepseek"  # This model uses DeepSeek reasoning syntax
-    preferred_endpoints: ["endpoint1"]
-    pii_policy:
-      allow_by_default: true
-
-  # Example: Qwen3 model with custom name
-  "my-qwen3-model":
-    reasoning_family: "qwen3"     # This model uses Qwen3 reasoning syntax
-    preferred_endpoints: ["endpoint2"]
-    pii_policy:
-      allow_by_default: true
-
-  # Example: GPT-OSS model with custom name
-  "custom-gpt-oss":
-    reasoning_family: "gpt-oss"   # This model uses GPT-OSS reasoning syntax
-    preferred_endpoints: ["endpoint1"]
-    pii_policy:
-      allow_by_default: true
-  gemma3:27b:
-    pricing:
-      currency: USD
-      prompt_per_1m: 0.067
-      completion_per_1m: 0.267
-    pii_policy:
-      allow_by_default: false  # Deny all PII by default
-      pii_types_allowed: ["EMAIL_ADDRESS", "PERSON", "GPE", "PHONE_NUMBER"]  # Only allow these specific PII types
-    preferred_endpoints: ["endpoint1"]
-  "mistral-small3.1":
-    pricing:
-      currency: USD
-      prompt_per_1m: 0.1
-      completion_per_1m: 0.3
-    pii_policy:
-      allow_by_default: false  # Deny all PII by default
-      pii_types_allowed: ["EMAIL_ADDRESS", "PERSON", "GPE", "PHONE_NUMBER"]  # Only allow these specific PII types
-    preferred_endpoints: ["endpoint2", "endpoint3"]
-  "Qwen/Qwen2-0.5B-Instruct":
+  "Model-A":
+    use_reasoning: false
     reasoning_family: "qwen3"  # This model uses Qwen reasoning syntax
     preferred_endpoints: ["qwen-endpoint"]
     pii_policy:
       allow_by_default: true
       pii_types_allowed: ["EMAIL_ADDRESS", "PERSON", "GPE", "PHONE_NUMBER"]
-  "TinyLlama/TinyLlama-1.1B-Chat-v1.0":
+  "Model-B":
+    use_reasoning: false
     preferred_endpoints: ["tinyllama-endpoint"]
     pii_policy:
       allow_by_default: true
@@ -159,148 +90,191 @@ categories:
     reasoning_description: "Business content is typically conversational"
     reasoning_effort: low  # Business conversations need low reasoning effort
     model_scores:
-      - model: phi4
+      - model: "Model-A"
         score: 0.8
-      - model: gemma3:27b
+        use_reasoning: false
+      - model: "Model-B"
         score: 0.4
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.2
+        use_reasoning: false
   - name: law
     use_reasoning: false
     reasoning_description: "Legal content is typically explanatory"
     model_scores:
-      - model: gemma3:27b
+      - model: "Model-B"
         score: 0.8
-      - model: phi4
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.6
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.4
+        use_reasoning: false
   - name: psychology
     use_reasoning: false
     reasoning_description: "Psychology content is usually explanatory"
     model_scores:
-      - model: mistral-small3.1
+      - model: "Model-A"
         score: 0.6
-      - model: gemma3:27b
+        use_reasoning: false
+      - model: "Model-B"
         score: 0.4
-      - model: phi4
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.4
+        use_reasoning: false
   - name: biology
     use_reasoning: true
     reasoning_description: "Biological processes benefit from structured analysis"
     model_scores:
-      - model: mistral-small3.1
+      - model: "Model-A"
         score: 0.8
-      - model: gemma3:27b
+        use_reasoning: false
+      - model: "Model-B"
         score: 0.6
-      - model: phi4
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.2
+        use_reasoning: false
   - name: chemistry
     use_reasoning: true
     reasoning_description: "Chemical reactions and formulas require systematic thinking"
     reasoning_effort: high  # Chemistry requires high reasoning effort
     model_scores:
-      - model: mistral-small3.1
+      - model: "Model-A"
         score: 0.8
-      - model: gemma3:27b
+        use_reasoning: true
+      - model: "Model-B"
         score: 0.6
-      - model: phi4
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.6
+        use_reasoning: false
   - name: history
     use_reasoning: false
     reasoning_description: "Historical content is narrative-based"
     model_scores:
-      - model: mistral-small3.1
+      - model: "Model-A"
         score: 0.8
-      - model: phi4
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.6
-      - model: gemma3:27b
+        use_reasoning: false
+      - model: "Model-B"
         score: 0.4
+        use_reasoning: false
   - name: other
     use_reasoning: false
     reasoning_description: "General content doesn't require reasoning"
     model_scores:
-      - model: gemma3:27b
+      - model: "Model-B"
         score: 0.8
-      - model: phi4
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.6
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.6
+        use_reasoning: false
   - name: health
     use_reasoning: false
     reasoning_description: "Health information is typically informational"
     model_scores:
-      - model: gemma3:27b
+      - model: "Model-B"
         score: 0.8
-      - model: phi4
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.8
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.6
+        use_reasoning: false
   - name: economics
     use_reasoning: false
     reasoning_description: "Economic discussions are usually explanatory"
     model_scores:
-      - model: gemma3:27b
+      - model: "Model-B"
         score: 0.8
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.8
-      - model: phi4
-        score: 0.0
+        use_reasoning: false
+      - model: "Model-A"
+        score: 0.1
+        use_reasoning: false
   - name: math
     use_reasoning: true
     reasoning_description: "Mathematical problems require step-by-step reasoning"
     reasoning_effort: high  # Math problems need high reasoning effort
     model_scores:
-      - model: TinyLlama/TinyLlama-1.1B-Chat-v1.0
+      - model: "Model-B"
         score: 1.0
-      - model: phi4
+        use_reasoning: true
+      - model: "Model-A"
         score: 0.9
-      - model: mistral-small3.1
+        use_reasoning: true
+      - model: "Model-A"
         score: 0.8
-      - model: gemma3:27b
+        use_reasoning: false
+      - model: "Model-B"
         score: 0.6
+        use_reasoning: false
   - name: physics
     use_reasoning: true
     reasoning_description: "Physics concepts need logical analysis"
     model_scores:
-      - model: gemma3:27b
+      - model: "Model-B"
         score: 0.4
-      - model: phi4
+        use_reasoning: true
+      - model: "Model-A"
         score: 0.4
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.4
+        use_reasoning: false
   - name: computer science
     use_reasoning: true
     reasoning_description: "Programming and algorithms need logical reasoning"
     model_scores:
-      - model: gemma3:27b
+      - model: "Model-B"
         score: 0.6
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.6
-      - model: phi4
-        score: 0.0
+        use_reasoning: false
+      - model: "Model-A"
+        score: 0.1
+        use_reasoning: false
   - name: philosophy
     use_reasoning: false
     reasoning_description: "Philosophical discussions are conversational"
     model_scores:
-      - model: phi4
+      - model: "Model-A"
         score: 0.6
-      - model: gemma3:27b
+        use_reasoning: false
+      - model: "Model-B"
         score: 0.2
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.2
+        use_reasoning: false
   - name: engineering
     use_reasoning: true
     reasoning_description: "Engineering problems require systematic problem-solving"
     model_scores:
-      - model: gemma3:27b
+      - model: "Model-B"
         score: 0.6
-      - model: mistral-small3.1
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.6
-      - model: phi4
+        use_reasoning: false
+      - model: "Model-A"
         score: 0.2
+        use_reasoning: false
 
-default_model: mistral-small3.1
+default_model: "Model-A"
 
 # API Configuration
 api:

e2e-tests/00-client-request-test.py

@@ -22,9 +22,7 @@
 # Constants
 ENVOY_URL = "http://localhost:8801"
 OPENAI_ENDPOINT = "/v1/chat/completions"
-DEFAULT_MODEL = (
-    "Qwen/Qwen2-0.5B-Instruct"  # Use configured model that matches router config
-)
+DEFAULT_MODEL = "Model-A"  # Use configured model that matches router config
 MAX_RETRIES = 3
 RETRY_DELAY = 2
 

e2e-tests/README.md

@@ -8,7 +8,7 @@ This test suite provides a progressive approach to testing the Semantic Router,
    - Tests sending requests to the Envoy proxy
    - Verifies basic request formatting and endpoint availability
    - Tests malformed request validation
-   - Tests content-based smart routing (math → TinyLlama, creative → Qwen)
+   - Tests content-based smart routing (math → Model-B, creative → Model-A)
 
 2. **01-envoy-extproc-test.py** - TBD (To Be Developed)
    - Tests that Envoy correctly forwards requests to the ExtProc
@@ -48,14 +48,14 @@ For fast development and testing with real tiny models (no GPU required):
 ./e2e-tests/start-llm-katan.sh
 
 # Or manually start individual servers:
-llm-katan --model Qwen/Qwen3-0.6B --port 8000 --served-model-name "Qwen/Qwen2-0.5B-Instruct"
-llm-katan --model Qwen/Qwen3-0.6B --port 8001 --served-model-name "TinyLlama/TinyLlama-1.1B-Chat-v1.0"
+llm-katan --model Qwen/Qwen3-0.6B --port 8000 --served-model-name "Model-A"
+llm-katan --model Qwen/Qwen3-0.6B --port 8001 --served-model-name "Model-B"
 
 # Terminal 2: Start Envoy proxy
 make run-envoy
 
 # Terminal 3: Start semantic router
-make run-router
+make run-router-e2e
 
 # Terminal 4: Run tests
 python e2e-tests/00-client-request-test.py    # Individual test

e2e-tests/llm-katan/llm_katan/__init__.py

@@ -8,7 +8,12 @@
 Signed-off-by: Yossi Ovadia <[email protected]>
 """
 
-__version__ = "0.1.4"
+try:
+    from importlib.metadata import PackageNotFoundError, version
+
+    __version__ = version("llm-katan")
+except PackageNotFoundError:
+    __version__ = "unknown"
 __author__ = "Yossi Ovadia"
 __email__ = "[email protected]"