agentic-python-coder 2.0.1__tar.gz → 2.1.0__tar.gz

{agentic_python_coder-2.0.1 → agentic_python_coder-2.1.0}/.gitignore

@@ -164,7 +164,11 @@ TRASH/
 LOCAL/
 ASP/
 CPBENCH/
+CPMPY/
 PAPER/
+PAPER-ASP/
+ZEBRA/
+.mcp.json
 examples/cpmpy/cpmpy_v*.md
 examples/cpmpy/cpmpy.md.backup-*
 examples/clingo/clingo_v*.md

{agentic_python_coder-2.0.1 → agentic_python_coder-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-python-coder
-Version: 2.0.1
+Version: 2.1.0
 Summary: A lightweight Python coding agent that writes, executes, and iterates on code through natural language instructions
 Author: Stefan Szeider
 License: Apache-2.0
@@ -105,7 +105,7 @@ import agentic_python_coder as coder
 messages, stats, log_path = coder.solve_task(
     "Write a fibonacci function",
     working_directory="/tmp/workspace",
-    model="sonnet",
+    model="sonnet45",
     quiet=True,  # Suppress console output
 )
 
@@ -128,7 +128,7 @@ from agentic_python_coder import solve_task
 messages, stats, log_path = solve_task(
     task="Your task description",
     working_directory=".",           # Where to run and save files
-    model=None,                      # Model alias: "sonnet", "opus", "deepseek", etc.
+    model=None,                      # Model name: "sonnet45", "opus45", or JSON file
     system_prompt=None,              # Custom system prompt (string)
     system_prompt_path=None,         # Path to system prompt file
     project_prompt=None,             # Domain-specific context
@@ -158,7 +158,7 @@ from agentic_python_coder import create_coding_agent, run_agent, get_final_respo
 agent = create_coding_agent(
     working_directory="/tmp/workspace",
     system_prompt="You are a Python expert.",
-    model="deepseek",
+    model="deepseek31",
     with_packages=["pandas"],
 )
 
@@ -175,14 +175,17 @@ print(get_final_response(messages2))
 Get a configured LangChain LLM instance for custom use.
 
 ```python
-from agentic_python_coder import get_openrouter_llm, MODEL_REGISTRY
+from agentic_python_coder import get_openrouter_llm, list_available_models
 
-# Get LLM by alias
-llm = get_openrouter_llm(model="sonnet")
+# Get LLM by model name
+llm = get_openrouter_llm(model="sonnet45")
 
 # See available models
-print(MODEL_REGISTRY.keys())
-# dict_keys(['deepseek', 'sonnet', 'opus', 'default', 'grok', 'qwen', 'gemini', 'gpt'])
+print(list_available_models())
+# ['deepseek31', 'gemini25', 'gpt5', 'grok41', 'opus45', 'qwen3', 'sonnet45']
+
+# Use a custom model JSON file
+llm = get_openrouter_llm(model="./mymodel.json")
 ```
 
 ---
@@ -212,7 +215,7 @@ coder -i
 | `--version`, `-V` | Show version and exit |
 | `--init [TEMPLATE]` | Initialize example templates (cpmpy, clingo, regex, or all) |
 | `--task`, `-t FILE` | Load task from markdown file |
-| `--model MODEL` | Model to use (default: sonnet) |
+| `--model MODEL` | Model name or JSON file (default: sonnet45) |
 | `--project`, `-p FILE` | Project template for domain-specific prompts |
 | `--with PACKAGE` | Add packages dynamically (repeatable) |
 | `--dir`, `-d DIR` | Working directory |
@@ -225,13 +228,17 @@ coder -i
 ### Model Selection
 
 ```bash
-coder --model sonnet "task"     # Claude Sonnet 4.5 (default)
-coder --model opus "task"       # Claude Opus 4.5
-coder --model deepseek "task"   # DeepSeek v3.1
-coder --model grok "task"       # X.AI Grok
-coder --model qwen "task"       # Qwen3 Coder
-coder --model gemini "task"     # Gemini Pro 2.5
-coder --model gpt "task"        # GPT-5
+# Built-in models (versioned names)
+coder --model sonnet45 "task"   # Claude Sonnet 4.5 (default)
+coder --model opus45 "task"     # Claude Opus 4.5
+coder --model deepseek31 "task" # DeepSeek v3.1
+coder --model grok41 "task"     # X.AI Grok 4.1
+coder --model qwen3 "task"      # Qwen3 Coder
+coder --model gemini25 "task"   # Gemini Pro 2.5
+coder --model gpt5 "task"       # GPT-5
+
+# Custom model (JSON file)
+coder --model ./mymodel.json "task"
 ```
 
 ### Project Templates

{agentic_python_coder-2.0.1 → agentic_python_coder-2.1.0}/README.md

@@ -70,7 +70,7 @@ import agentic_python_coder as coder
 messages, stats, log_path = coder.solve_task(
     "Write a fibonacci function",
     working_directory="/tmp/workspace",
-    model="sonnet",
+    model="sonnet45",
     quiet=True,  # Suppress console output
 )
 
@@ -93,7 +93,7 @@ from agentic_python_coder import solve_task
 messages, stats, log_path = solve_task(
     task="Your task description",
     working_directory=".",           # Where to run and save files
-    model=None,                      # Model alias: "sonnet", "opus", "deepseek", etc.
+    model=None,                      # Model name: "sonnet45", "opus45", or JSON file
     system_prompt=None,              # Custom system prompt (string)
     system_prompt_path=None,         # Path to system prompt file
     project_prompt=None,             # Domain-specific context
@@ -123,7 +123,7 @@ from agentic_python_coder import create_coding_agent, run_agent, get_final_respo
 agent = create_coding_agent(
     working_directory="/tmp/workspace",
     system_prompt="You are a Python expert.",
-    model="deepseek",
+    model="deepseek31",
     with_packages=["pandas"],
 )
 
@@ -140,14 +140,17 @@ print(get_final_response(messages2))
 Get a configured LangChain LLM instance for custom use.
 
 ```python
-from agentic_python_coder import get_openrouter_llm, MODEL_REGISTRY
+from agentic_python_coder import get_openrouter_llm, list_available_models
 
-# Get LLM by alias
-llm = get_openrouter_llm(model="sonnet")
+# Get LLM by model name
+llm = get_openrouter_llm(model="sonnet45")
 
 # See available models
-print(MODEL_REGISTRY.keys())
-# dict_keys(['deepseek', 'sonnet', 'opus', 'default', 'grok', 'qwen', 'gemini', 'gpt'])
+print(list_available_models())
+# ['deepseek31', 'gemini25', 'gpt5', 'grok41', 'opus45', 'qwen3', 'sonnet45']
+
+# Use a custom model JSON file
+llm = get_openrouter_llm(model="./mymodel.json")
 ```
 
 ---
@@ -177,7 +180,7 @@ coder -i
 | `--version`, `-V` | Show version and exit |
 | `--init [TEMPLATE]` | Initialize example templates (cpmpy, clingo, regex, or all) |
 | `--task`, `-t FILE` | Load task from markdown file |
-| `--model MODEL` | Model to use (default: sonnet) |
+| `--model MODEL` | Model name or JSON file (default: sonnet45) |
 | `--project`, `-p FILE` | Project template for domain-specific prompts |
 | `--with PACKAGE` | Add packages dynamically (repeatable) |
 | `--dir`, `-d DIR` | Working directory |
@@ -190,13 +193,17 @@ coder -i
 ### Model Selection
 
 ```bash
-coder --model sonnet "task"     # Claude Sonnet 4.5 (default)
-coder --model opus "task"       # Claude Opus 4.5
-coder --model deepseek "task"   # DeepSeek v3.1
-coder --model grok "task"       # X.AI Grok
-coder --model qwen "task"       # Qwen3 Coder
-coder --model gemini "task"     # Gemini Pro 2.5
-coder --model gpt "task"        # GPT-5
+# Built-in models (versioned names)
+coder --model sonnet45 "task"   # Claude Sonnet 4.5 (default)
+coder --model opus45 "task"     # Claude Opus 4.5
+coder --model deepseek31 "task" # DeepSeek v3.1
+coder --model grok41 "task"     # X.AI Grok 4.1
+coder --model qwen3 "task"      # Qwen3 Coder
+coder --model gemini25 "task"   # Gemini Pro 2.5
+coder --model gpt5 "task"       # GPT-5
+
+# Custom model (JSON file)
+coder --model ./mymodel.json "task"
 ```
 
 ### Project Templates

{agentic_python_coder-2.0.1 → agentic_python_coder-2.1.0}/coder/src/agentic_python_coder/__init__.py

@@ -1,6 +1,6 @@
 """Python Coding Agent - A minimal coding assistant using LangGraph and OpenRouter."""
 
-__version__ = "2.0.1"
+__version__ = "2.1.0"
 
 # High-level API (recommended for most users)
 from agentic_python_coder.runner import solve_task
@@ -14,7 +14,12 @@ from agentic_python_coder.agent import (
 )
 
 # LLM utilities
-from agentic_python_coder.llm import get_openrouter_llm, MODEL_REGISTRY, MODEL_STRING
+from agentic_python_coder.llm import (
+    get_openrouter_llm,
+    load_model_config,
+    list_available_models,
+    DEFAULT_MODEL,
+)
 
 __all__ = [
     # Version
@@ -28,6 +33,7 @@ __all__ = [
     "DEFAULT_STEP_LIMIT",
     # LLM
     "get_openrouter_llm",
-    "MODEL_REGISTRY",
-    "MODEL_STRING",
+    "load_model_config",
+    "list_available_models",
+    "DEFAULT_MODEL",
 ]

{agentic_python_coder-2.0.1 → agentic_python_coder-2.1.0}/coder/src/agentic_python_coder/cli.py

@@ -4,7 +4,6 @@ import argparse
 import os
 import sys
 import re
-import shutil
 from pathlib import Path
 from typing import Optional, Dict, Any
 from importlib import resources
@@ -24,7 +23,7 @@ from agentic_python_coder.project_md import (
     check_packages_available,
     create_project_prompt,
 )
-from agentic_python_coder.llm import MODEL_STRING, MODEL_REGISTRY
+from agentic_python_coder.llm import DEFAULT_MODEL, list_available_models, load_model_config
 from agentic_python_coder import __version__
 
 
@@ -107,7 +106,7 @@ def parse_args():
         help="Path to task file (creates {basename}_code.py and {basename}.jsonl)",
     )
 
-    parser.add_argument("--model", help=f"Model to use (default: {MODEL_STRING})")
+    parser.add_argument("--model", help=f"Model name or JSON file (default: {DEFAULT_MODEL})")
 
     parser.add_argument(
         "--interactive", "-i", action="store_true", help="Interactive mode"
@@ -239,13 +238,17 @@ def validate_packages(packages):
 
 
 def validate_model(model):
-    """Validate model name."""
-    if model and model not in MODEL_REGISTRY and "/" not in model:
-        available = sorted([m for m in MODEL_REGISTRY.keys() if m != "default"])
-        print(f"Error: Unknown model: '{model}'")
-        print("\nAvailable models:")
-        for m in available:
+    """Validate model name or JSON file."""
+    if not model:
+        return
+    try:
+        load_model_config(model)
+    except FileNotFoundError as e:
+        print(f"Error: {e}")
+        print("\nAvailable built-in models:")
+        for m in list_available_models():
             print(f"  - {m}")
+        print("\nOr provide a path to a custom model JSON file.")
         sys.exit(1)
 
 
@@ -434,7 +437,7 @@ def main():
             if not args.quiet:
                 if args.with_packages:
                     print(f"Dynamic packages: {', '.join(args.with_packages)}")
-                print(f"Creating agent with model: {args.model or MODEL_STRING}")
+                print(f"Creating agent with model: {args.model or DEFAULT_MODEL}")
 
             task_basename = task_file_path.stem if task_file_path else None
 

agentic_python_coder-2.1.0/coder/src/agentic_python_coder/llm.py

@@ -0,0 +1,190 @@
+"""LLM configuration for OpenRouter."""
+
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Any
+
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+
+# Default model name (without .json)
+DEFAULT_MODEL = "sonnet45"
+
+
+def get_api_key() -> str:
+    """Get API key from environment or config file.
+
+    Returns:
+        API key string
+
+    Raises:
+        ValueError: If no API key found
+    """
+    # Load from ~/.config/coder/.env (don't override shell env vars)
+    config_env = Path.home() / ".config" / "coder" / ".env"
+    if config_env.exists():
+        load_dotenv(dotenv_path=config_env, override=False)
+
+    # Get API key from environment
+    api_key = os.getenv("OPENROUTER_API_KEY")
+
+    if not api_key:
+        print("Warning: No API key found. Set up with:", file=sys.stderr)
+        print("  mkdir -p ~/.config/coder", file=sys.stderr)
+        print("  echo 'OPENROUTER_API_KEY=sk-or-...' > ~/.config/coder/.env", file=sys.stderr)
+        print("\nOr use: --api-key sk-or-...", file=sys.stderr)
+        raise ValueError("OPENROUTER_API_KEY not configured")
+
+    return api_key
+
+
+def _load_json_file(path: Path, model: str) -> dict[str, Any]:
+    """Load and validate a model JSON file."""
+    try:
+        with open(path, encoding="utf-8") as f:
+            config = json.load(f)
+    except json.JSONDecodeError as e:
+        raise ValueError(f"Invalid JSON in model config '{model}': {e}") from e
+
+    if "path" not in config:
+        raise ValueError(f"Model config '{model}' missing required key: 'path'")
+
+    return config
+
+
+def load_model_config(model: str) -> dict[str, Any]:
+    """Load model configuration from JSON file.
+
+    Lookup order:
+    1. If model ends with .json, treat as explicit path
+    2. Local file: ./{model}.json
+    3. Bundled default: <package>/models/{model}.json
+
+    Args:
+        model: Model name (e.g., "sonnet45") or path to JSON file
+
+    Returns:
+        Model configuration dict
+
+    Raises:
+        FileNotFoundError: If model config not found
+        ValueError: If JSON is invalid or missing required keys
+    """
+    # Explicit JSON path
+    if model.endswith(".json"):
+        path = Path(model).expanduser()
+        if not path.exists():
+            raise FileNotFoundError(f"Model config not found: {model}")
+        return _load_json_file(path, model)
+
+    # Local override: ./{model}.json
+    local_path = Path(f"./{model}.json")
+    if local_path.exists():
+        return _load_json_file(local_path, model)
+
+    # Bundled default: <package>/models/{model}.json
+    package_dir = Path(__file__).parent
+    bundled_path = package_dir / "models" / f"{model}.json"
+    if bundled_path.exists():
+        return _load_json_file(bundled_path, model)
+
+    # List available models for error message
+    available = list_available_models()
+    raise FileNotFoundError(
+        f"Model '{model}' not found. Available: {', '.join(available)}"
+    )
+
+
+def list_available_models() -> list[str]:
+    """List all available model names (bundled defaults).
+
+    Returns:
+        List of model names (without .json extension)
+    """
+    package_dir = Path(__file__).parent
+    models_dir = package_dir / "models"
+    if not models_dir.exists():
+        return []
+    return sorted(p.stem for p in models_dir.glob("*.json"))
+
+
+def get_openrouter_llm(
+    model: str = DEFAULT_MODEL,
+    api_key: str | None = None,
+    verbose: bool = False,
+) -> ChatOpenAI:
+    """Create a fully configured OpenRouter LLM instance.
+
+    Args:
+        model: Model name (e.g., "sonnet45") or path to JSON file
+        api_key: Optional API key
+        verbose: If True, print model info to console
+
+    Returns:
+        Fully configured ChatOpenAI instance
+
+    Raises:
+        FileNotFoundError: If model config not found
+        ValueError: If API key not configured
+    """
+    # Load config from JSON
+    config = load_model_config(model)
+    model_path = config["path"]
+
+    if verbose:
+        print(f"Using model: {model_path}")
+        if os.getenv("CODER_VERBOSE"):
+            for key, value in config.items():
+                if key != "path":
+                    print(f"   {key}: {value}")
+
+    # Get API key
+    if not api_key:
+        api_key = get_api_key()
+
+    # Create base kwargs
+    streaming = config.get("streaming", True)
+    llm_kwargs = {
+        "model": model_path,
+        "openai_api_key": api_key,
+        "openai_api_base": "https://openrouter.ai/api/v1",
+        "default_headers": {
+            "HTTP-Referer": "https://github.com/szeider/agentic-python-coder",
+            "X-Title": "Agentic Python Coder",
+        },
+        "streaming": streaming,
+    }
+
+    # Only include stream_options when streaming is enabled
+    if streaming:
+        llm_kwargs["model_kwargs"] = {"stream_options": {"include_usage": True}}
+    else:
+        llm_kwargs["model_kwargs"] = {}
+
+    # Handle models that don't accept sampling parameters (e.g., GPT-5)
+    if config.get("no_sampling_params"):
+        if "max_tokens" in config:
+            llm_kwargs["max_tokens"] = config["max_tokens"]
+    else:
+        # Standard parameters
+        if "temperature" in config:
+            llm_kwargs["temperature"] = config["temperature"]
+        if "max_tokens" in config:
+            llm_kwargs["max_tokens"] = config["max_tokens"]
+        if "top_p" in config:
+            llm_kwargs["top_p"] = config["top_p"]
+        if "top_k" in config:
+            # Pass via model_kwargs for OpenRouter compatibility
+            llm_kwargs["model_kwargs"]["top_k"] = config["top_k"]
+        if "frequency_penalty" in config:
+            llm_kwargs["frequency_penalty"] = config["frequency_penalty"]
+        if "presence_penalty" in config:
+            llm_kwargs["presence_penalty"] = config["presence_penalty"]
+
+    # Add request_timeout for models that need it
+    if "request_timeout" in config:
+        llm_kwargs["request_timeout"] = config["request_timeout"]
+
+    return ChatOpenAI(**llm_kwargs)

agentic_python_coder-2.1.0/coder/src/agentic_python_coder/models/deepseek31.json

@@ -0,0 +1,7 @@
+{
+  "path": "deepseek/deepseek-chat-v3.1",
+  "temperature": 0.2,
+  "max_tokens": 8192,
+  "streaming": true,
+  "top_p": 1.0
+}

agentic_python_coder-2.1.0/coder/src/agentic_python_coder/models/gemini25.json

@@ -0,0 +1,8 @@
+{
+  "path": "google/gemini-2.5-pro",
+  "temperature": 0.3,
+  "max_tokens": 2048,
+  "streaming": true,
+  "top_p": 0.9,
+  "request_timeout": 60
+}

agentic_python_coder-2.1.0/coder/src/agentic_python_coder/models/gpt5.json

@@ -0,0 +1,6 @@
+{
+  "path": "openai/gpt-5",
+  "max_tokens": 3000,
+  "streaming": true,
+  "no_sampling_params": true
+}

agentic_python_coder-2.1.0/coder/src/agentic_python_coder/models/grok41.json

@@ -0,0 +1,7 @@
+{
+  "path": "x-ai/grok-4.1-fast",
+  "temperature": 0.15,
+  "max_tokens": 2000,
+  "streaming": true,
+  "top_p": 0.9
+}

agentic_python_coder-2.1.0/coder/src/agentic_python_coder/models/opus45.json

@@ -0,0 +1,6 @@
+{
+  "path": "anthropic/claude-opus-4.5",
+  "temperature": 0.0,
+  "max_tokens": 16384,
+  "streaming": true
+}

agentic_python_coder-2.1.0/coder/src/agentic_python_coder/models/qwen3.json

@@ -0,0 +1,7 @@
+{
+  "path": "qwen/qwen3-coder",
+  "temperature": 0.15,
+  "max_tokens": 2048,
+  "streaming": true,
+  "top_p": 0.9
+}

agentic_python_coder-2.1.0/coder/src/agentic_python_coder/models/sonnet45.json

@@ -0,0 +1,6 @@
+{
+  "path": "anthropic/claude-sonnet-4.5",
+  "temperature": 0.0,
+  "max_tokens": 16384,
+  "streaming": true
+}

{agentic_python_coder-2.0.1 → agentic_python_coder-2.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentic-python-coder"
-version = "2.0.1"
+version = "2.1.0"
 description = "A lightweight Python coding agent that writes, executes, and iterates on code through natural language instructions"
 readme = "README.md"
 requires-python = ">=3.13,<3.14"

agentic_python_coder-2.0.1/coder/src/agentic_python_coder/llm.py

@@ -1,230 +0,0 @@
-"""LLM configuration for OpenRouter."""
-
-import os
-from typing import Optional
-from langchain_openai import ChatOpenAI
-from dotenv import load_dotenv
-from pathlib import Path
-
-# Model aliases to full OpenRouter paths
-MODEL_REGISTRY = {
-    "deepseek": "deepseek/deepseek-chat-v3.1",
-    "sonnet": "anthropic/claude-sonnet-4.5",
-    "opus": "anthropic/claude-opus-4.5",
-    "default": "anthropic/claude-sonnet-4.5",
-    "grok": "x-ai/grok-4.1-fast",
-    "qwen": "qwen/qwen3-coder",
-    "gemini": "google/gemini-2.5-pro",
-    "gpt": "openai/gpt-5",
-}
-
-# Model-specific configurations
-MODEL_CONFIGS = {
-    "deepseek/deepseek-chat-v3.1": {
-        "temperature": 0.2,  # Low for deterministic code generation with tool calls
-        "max_tokens": 8192,  # Beta API supports up to 8192
-        "streaming": True,
-        "context_window": 128000,  # Full context window
-        "top_p": 1.0,  # Keep at 1.0 with low temperature
-        "frequency_penalty": 0,  # Don't use for coding
-        "presence_penalty": 0,  # Don't use for coding
-        "model_kwargs": {
-            "stream_options": {"include_usage": True},
-        },
-    },
-    "anthropic/claude-sonnet-4.5": {
-        "temperature": 0.0,  # Default for deterministic output
-        "streaming": True,
-        "max_tokens": 16384,  # Sonnet 4.5 supports up to 64K
-        "model_kwargs": {"stream_options": {"include_usage": True}},
-    },
-    "anthropic/claude-opus-4.5": {
-        "temperature": 0.0,
-        "streaming": True,
-        "max_tokens": 16384,  # Opus 4.5 supports up to 32K output
-        "model_kwargs": {"stream_options": {"include_usage": True}},
-    },
-    # Other model configurations
-    "x-ai/grok-code-fast-1": {
-        "temperature": 0.15,
-        "max_tokens": 2000,
-        "streaming": True,
-        "context_window": 256000,
-        "top_p": 0.9,
-        # Note: Grok doesn't accept frequency_penalty or presence_penalty
-        "model_kwargs": {
-            "stream_options": {"include_usage": True}
-            # Reasoning mode may be added later when supported
-        },
-    },
-    "qwen/qwen3-coder": {
-        "temperature": 0.15,
-        "max_tokens": 2048,
-        "streaming": True,
-        "context_window": 256000,
-        "top_p": 0.9,
-        "model_kwargs": {
-            "stream_options": {"include_usage": True}
-            # Provider filtering would be added via headers if needed
-        },
-    },
-    "google/gemini-2.5-pro": {
-        "temperature": 0.3,
-        "max_tokens": 2048,  # Will be mapped to max_output_tokens
-        "streaming": True,
-        "context_window": 1048576,
-        "top_p": 0.9,
-        # Note: No top_k or set to 64 (Google's fixed value)
-        "request_timeout": 60,  # Handle slow responses on free tier
-        "model_kwargs": {"stream_options": {"include_usage": True}},
-    },
-    "openai/gpt-5": {
-        # NO temperature, top_p, or penalty parameters for GPT-5
-        "max_tokens": 3000,
-        "streaming": True,
-        "context_window": 400000,
-        "model_kwargs": {
-            "stream_options": {"include_usage": True},
-            "parallel_tool_calls": False,
-            # Additional parameters can be added when supported
-        },
-    },
-}
-
-# Default configuration for unknown models
-DEFAULT_CONFIG = {
-    "temperature": 0.0,
-    "max_tokens": 4096,
-    "streaming": True,
-    "context_window": 32000,
-    "model_kwargs": {"stream_options": {"include_usage": True}},
-}
-
-# Keep old constant for backward compatibility
-MODEL_STRING = "anthropic/claude-sonnet-4.5"
-
-
-def get_api_key() -> str:
-    """Get API key from environment or config file.
-
-    Returns:
-        API key string
-
-    Raises:
-        ValueError: If no API key found
-    """
-    # Load from ~/.config/coder/.env
-    config_env = Path.home() / ".config" / "coder" / ".env"
-    if config_env.exists():
-        load_dotenv(dotenv_path=config_env, override=True)
-
-    # Get API key from environment
-    api_key = os.getenv("OPENROUTER_API_KEY")
-
-    if not api_key:
-        print("Warning: No API key found. Set up with:")
-        print("  mkdir -p ~/.config/coder")
-        print("  echo 'OPENROUTER_API_KEY=sk-or-...' > ~/.config/coder/.env")
-        print("\nOr use: --api-key sk-or-...")
-        raise ValueError("OPENROUTER_API_KEY not configured")
-
-    return api_key
-
-
-def get_openrouter_llm(
-    model: str = "default",
-    temperature: Optional[float] = None,
-    api_key: Optional[str] = None,
-    verbose: bool = False,
-) -> ChatOpenAI:
-    """Create a fully configured OpenRouter LLM instance.
-    Special handling for GPT-5 which doesn't accept sampling parameters.
-
-    Args:
-        model: Model alias (e.g., "deepseek", "claude") or full path
-        temperature: Optional temperature override
-        api_key: Optional API key
-        verbose: If True, print model info to console (default False for library use)
-
-    Returns:
-        Fully configured ChatOpenAI instance
-
-    Raises:
-        ValueError: If model alias is not recognized
-    """
-    # Handle direct model path (backward compatibility)
-    if "/" in model:
-        model_path = model
-        # Get config for this path or use default
-        config = MODEL_CONFIGS.get(model_path, DEFAULT_CONFIG.copy())
-    else:
-        # Resolve alias to full path
-        if model not in MODEL_REGISTRY:
-            available = ", ".join(sorted(MODEL_REGISTRY.keys()))
-            raise ValueError(f"Unknown model: '{model}'. Available models: {available}")
-
-        model_path = MODEL_REGISTRY[model]
-
-        # Get hardcoded config for this model
-        config = MODEL_CONFIGS.get(model_path, DEFAULT_CONFIG.copy())
-
-    # Print model info only if verbose
-    if verbose and model != "default":
-        print(f"Using model: {model_path}")
-        if os.getenv("CODER_VERBOSE"):
-            # Special handling for GPT-5 which has no temperature
-            if model_path == "openai/gpt-5":
-                print(f"   Max tokens: {config.get('max_tokens', 'default')}")
-                print(f"   Streaming: {config['streaming']}")
-            else:
-                print(f"   Temperature: {config.get('temperature', 'default')}")
-                print(f"   Max tokens: {config.get('max_tokens', 'default')}")
-                print(f"   Streaming: {config['streaming']}")
-
-    # Get API key
-    if not api_key:
-        api_key = get_api_key()
-
-    # Create base kwargs
-    llm_kwargs = {
-        "model": model_path,
-        "openai_api_key": api_key,
-        "openai_api_base": "https://openrouter.ai/api/v1",
-        "default_headers": {
-            "HTTP-Referer": "https://github.com/szeider/agentic-python-coder",
-            "X-Title": "Agentic Python Coder",
-        },
-        "streaming": config["streaming"],
-        "model_kwargs": config.get("model_kwargs", {}),
-    }
-
-    # Special case for GPT-5: NO sampling parameters
-    if model_path == "openai/gpt-5":
-        # Only add max_tokens for GPT-5
-        if "max_tokens" in config:
-            llm_kwargs["max_tokens"] = config["max_tokens"]
-    else:
-        # All other models get standard parameters
-        llm_kwargs["temperature"] = config.get("temperature", 0.0)
-        if temperature is not None:  # Allow override
-            llm_kwargs["temperature"] = temperature
-
-        # Add optional parameters
-        if "max_tokens" in config:
-            llm_kwargs["max_tokens"] = config["max_tokens"]
-        if "top_p" in config:
-            llm_kwargs["top_p"] = config["top_p"]
-        if "top_k" in config:
-            llm_kwargs["top_k"] = config["top_k"]
-        if "frequency_penalty" in config:
-            llm_kwargs["frequency_penalty"] = config["frequency_penalty"]
-        if "presence_penalty" in config:
-            llm_kwargs["presence_penalty"] = config["presence_penalty"]
-
-    # Add request_timeout for models that need it (e.g., Gemini)
-    if "request_timeout" in config:
-        llm_kwargs["request_timeout"] = config["request_timeout"]
-
-    llm = ChatOpenAI(**llm_kwargs)
-
-    return llm