feat: add static model list support for endpoints

- Add list_of_models field to EndpointConfig for static model lists
- Update config parsing and validation to handle static model lists
- Modify endpoint manager to use static lists when provided
- Update providers.json.example to demonstrate static model usage
- Refactor goose tool to use centralized fetch_models method

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

Co-Authored-By: Claude <noreply@anthropic.com>

Author: James Zhu

code_assistant_manager/config.py

@@ -416,9 +416,12 @@ def get_endpoint_config(self, endpoint_name: str) -> Dict[str, str]:
 
         config = endpoints[endpoint_name].copy()
 
-        # Convert all values to strings for compatibility
+        # Convert values to strings for compatibility, except for lists
         for key, value in config.items():
-            if isinstance(value, bool):
+            if isinstance(value, list):
+                # Keep lists as-is (e.g., list_of_models)
+                config[key] = value
+            elif isinstance(value, bool):
                 config[key] = str(value).lower()
             elif isinstance(value, (int, float)):
                 config[key] = str(value)
@@ -578,6 +581,16 @@ def _validate_endpoint(endpoint_name: str, endpoint_config: dict) -> List[str]:
     if list_models_cmd and not validate_command(list_models_cmd):
         errors.append(f"Invalid list_models_cmd for {endpoint_name}: {list_models_cmd}")
 
+    # Validate list_of_models if present
+    list_of_models = endpoint_config.get("list_of_models", None)
+    if list_of_models is not None:
+        if not isinstance(list_of_models, list):
+            errors.append(f"Invalid list_of_models for {endpoint_name}: must be a list")
+        else:
+            for model in list_of_models:
+                if not validate_model_id(str(model)):
+                    errors.append(f"Invalid model ID in list_of_models for {endpoint_name}: {model}")
+
     # Validate boolean fields
     boolean_fields = ["keep_proxy_config", "use_proxy"]
     for field_name in boolean_fields:

code_assistant_manager/domain_models.py

@@ -46,6 +46,7 @@ class EndpointConfig:
     use_proxy: bool = False
     keep_proxy_config: bool = False
     list_models_cmd: Optional[str] = None
+    list_of_models: Optional[List[str]] = None
     cache_ttl_seconds: int = 86400
 
     def supports_client(self, client_name: str) -> bool:
@@ -66,6 +67,10 @@ def get_api_key_value(self) -> Optional[str]:
     def has_list_command(self) -> bool:
         """Check if endpoint has a model list command configured."""
         return bool(self.list_models_cmd and self.list_models_cmd.strip())
+    
+    def has_static_models(self) -> bool:
+        """Check if endpoint has a static list of models configured."""
+        return bool(self.list_of_models and len(self.list_of_models) > 0)
 
     def should_use_proxy(self) -> bool:
         """Determine if proxy should be used."""

code_assistant_manager/endpoints.py

@@ -292,10 +292,21 @@ def fetch_models(
             if cache_result.should_use:
                 return True, cache_result.models
 
-        # Fetch fresh models
+        # Check if static list of models is provided
+        list_of_models = endpoint_config.get("list_of_models", None)
+        if list_of_models is not None:
+            if isinstance(list_of_models, list):
+                print(f"Using static model list ({len(list_of_models)} models)")
+                models = [m for m in list_of_models if validate_model_id(str(m))]
+                self._model_cache.write_cache(endpoint_name, models)
+                return True, models
+            else:
+                print("Warning: list_of_models is not a list, ignoring")
+
+        # Fetch fresh models using command
         list_cmd = endpoint_config.get("list_models_cmd", "")
         if not list_cmd:
-            print("Warning: No list_models_cmd configured, using empty model list")
+            print("Warning: No list_models_cmd or list_of_models configured, using empty model list")
             return True, []
 
         print("Fetching model list...")

code_assistant_manager/repositories.py

@@ -155,6 +155,9 @@ def _parse_endpoint(self, name: str, data: Dict) -> EndpointConfig:
         # Parse other fields
         keep_proxy = str(data.get("keep_proxy_config", "false")).lower() == "true"
         list_models_cmd = data.get("list_models_cmd", "")
+        list_of_models = data.get("list_of_models", None)
+        if list_of_models is not None and not isinstance(list_of_models, list):
+            list_of_models = None
         cache_ttl = 86400
         if self._common_cache is not None:
             cache_ttl = int(self._common_cache.get("cache_ttl_seconds", "86400"))
@@ -169,6 +172,7 @@ def _parse_endpoint(self, name: str, data: Dict) -> EndpointConfig:
             use_proxy=use_proxy,
             keep_proxy_config=keep_proxy,
             list_models_cmd=list_models_cmd,
+            list_of_models=list_of_models,
             cache_ttl_seconds=cache_ttl,
         )
 

code_assistant_manager/tools/goose.py

@@ -168,36 +168,15 @@ def _get_available_models(self, endpoint_name: str) -> Optional[List[str]]:
         if not success:
             return None
 
-        # Get models from list_models_cmd
-        models = []
-        if "list_models_cmd" in endpoint_config:
-            try:
-                import subprocess
-                import shlex
-
-                env = os.environ.copy()
-                env["endpoint"] = endpoint_config.get("endpoint", "")
-                env["api_key"] = endpoint_config.get("actual_api_key", "")
-
-                cmd_parts = shlex.split(endpoint_config["list_models_cmd"])
-                result = subprocess.run(
-                    cmd_parts,
-                    shell=False,
-                    capture_output=True,
-                    text=True,
-                    timeout=30,
-                    env=env,
-                )
-                if result.returncode == 0 and result.stdout.strip():
-                    models = [line.strip() for line in result.stdout.split('\n') if line.strip()]
-            except Exception as e:
-                print(f"Warning: Failed to execute list_models_cmd for {endpoint_name}: {e}")
-                return None
-        else:
-            # Fallback if no list_models_cmd
-            models = [endpoint_name.replace(":", "-").replace("_", "-")]
+        # Use the endpoint_manager's fetch_models method for consistency
+        success, models = self.endpoint_manager.fetch_models(
+            endpoint_name, endpoint_config, use_cache_if_available=False
+        )
+        
+        if not success or not models:
+            return None
 
-        return models if models else None
+        return models
 
     def _select_models_from_endpoint(self, endpoint_name: str, available_models: List[str]) -> Optional[List[str]]:
         """Let user select multiple models from the given endpoint."""

code_assistant_manager/validators.py

@@ -218,19 +218,30 @@ def _do_validate(self, data: Dict) -> Tuple[bool, List[str]]:
 
 
 class CommandValidator(ValidationHandler):
-    """Validates command strings."""
+    """Validates command strings and model lists."""
 
     def _do_validate(self, data: Dict) -> Tuple[bool, List[str]]:
-        """Validate command string if present."""
+        """Validate command string and list of models if present."""
+        errors = []
+        
+        # Validate list_models_cmd if present
         command = data.get("list_models_cmd", "")
-
-        # Command is optional
-        if not command:
-            return True, []
-
-        if not self._is_safe_command(command):
-            return False, ["Command contains potentially dangerous patterns"]
-
+        if command and not self._is_safe_command(command):
+            errors.append("Command contains potentially dangerous patterns")
+        
+        # Validate list_of_models if present
+        list_of_models = data.get("list_of_models", None)
+        if list_of_models is not None:
+            if not isinstance(list_of_models, list):
+                errors.append("list_of_models must be a list")
+            else:
+                from .config import validate_model_id
+                for model in list_of_models:
+                    if not validate_model_id(str(model)):
+                        errors.append(f"Invalid model ID in list_of_models: {model}")
+        
+        if errors:
+            return False, errors
         return True, []
 
     def _is_safe_command(self, command: str) -> bool:

providers.json.example

@@ -25,41 +25,50 @@
     "openai-compatible:dashscope-qwen3-models": {
       "endpoint": "https://dashscope.aliyuncs.com/compatible-mode/v1",
       "api_key_env": "API_KEY_QWEN",
-      "list_models_cmd": "qwen3-max qwen3-coder-plus",
+      "list_of_models": ["qwen3-max", "qwen3-coder-plus"],
       "use_proxy": false,
-      "description": "Alibaba Dashscope Endpoint",
+      "description": "Alibaba Dashscope Endpoint - using static model list",
       "supported_client": "qwen,droid,iflow,crush"
     },
     "azure-openai:east2": {
       "endpoint": "https://azure-openai-gpt-o1-east2.openai.azure.com/openai/v1",
       "api_key_env": "API_KEY_AZURE_OPENAI",
-      "list_models_cmd": "model-router",
+      "list_of_models": ["model-router"],
       "use_proxy": false,
-      "description": "Azure Openai Endpoint",
+      "description": "Azure Openai Endpoint - using static model list",
       "supported_client": "codex"
     },
     "azure-openai:zhujian0003-1688-resource": {
       "endpoint": "https://zhujian0003-1688-resource.services.ai.azure.com/openai/v1/",
       "api_key_env": "zhujian0003_1688_resource_API_KEY_AZURE_OPENAI",
-      "list_models_cmd": "grok-3",
+      "list_of_models": ["grok-3"],
       "use_proxy": false,
-      "description": "Azure Openai Endpoint",
+      "description": "Azure Openai Endpoint - using static model list",
       "supported_client": "codex"
     },
     "qwen-claude-proxy:dashscope-qwen3-coder-plus": {
       "endpoint": "https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy",
       "api_key_env": "API_KEY_QWEN",
-      "list_models_cmd": "qwen3-coder-plus",
+      "list_of_models": ["qwen3-coder-plus"],
       "use_proxy": false,
-      "description": "Alibaba Dashscope Endpoint Claude Proxy",
+      "description": "Alibaba Dashscope Endpoint Claude Proxy - using static model list",
       "supported_client": "claude"
     },
     "blackbox-official": {
       "endpoint": "https://api.blackbox.ai",
       "api_key_env": "BLACKBOX_API_KEY",
-      "list_models_cmd": "echo 'blackboxai/anthropic/claude-sonnet-4.5\nblackboxai/anthropic/claude-opus-4.5\nblackboxai/anthropic/claude-sonnet-4\nblackboxai/anthropic/claude-opus-4\nblackboxai/google/gemini-2.5-flash\nblackboxai/meta-llama/llama-3.3-70b-instruct\nblackboxai/openai/gpt-4o\nblackboxai/x-ai/grok-code-fast-1:free'",
+      "list_of_models": [
+        "blackboxai/anthropic/claude-sonnet-4.5",
+        "blackboxai/anthropic/claude-opus-4.5",
+        "blackboxai/anthropic/claude-sonnet-4",
+        "blackboxai/anthropic/claude-opus-4",
+        "blackboxai/google/gemini-2.5-flash",
+        "blackboxai/meta-llama/llama-3.3-70b-instruct",
+        "blackboxai/openai/gpt-4o",
+        "blackboxai/x-ai/grok-code-fast-1:free"
+      ],
       "use_proxy": false,
-      "description": "Blackbox AI Official API",
+      "description": "Blackbox AI Official API - using static model list",
       "supported_client": "blackbox"
     }
   }