Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

Propagate model capabilities to coding harnesses (#1604)

Ali Khokharb9aadeb4ac10
diff --git a/pyproject.toml b/pyproject.toml
index 675b0735..651e3824 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "5.15.10"
+version = "5.16.0"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/src/free_claude_code/api/model_catalog.py b/src/free_claude_code/api/model_catalog.py
index dd42c263..ecd5b4db 100644
--- a/src/free_claude_code/api/model_catalog.py
+++ b/src/free_claude_code/api/model_catalog.py
@@ -14,6 +14,7 @@ from free_claude_code.core.gateway_model_ids import (
gateway_model_id,
no_thinking_gateway_model_id,
)
+from free_claude_code.core.model_capabilities import ModelInputModality
DISCOVERED_MODEL_CREATED_AT = "1970-01-01T00:00:00Z"
_INFERENCE_IDLE_TIMEOUT_MARGIN_SECONDS = 60
@@ -46,6 +47,12 @@ class ModelResponse(BaseModel):
supports_reasoning_effort: bool | None = Field(
default=None, serialization_alias="supportsReasoningEffort"
)
+ supports_reasoning: bool | None = Field(
+ default=None, serialization_alias="supportsReasoning"
+ )
+ input_modalities: tuple[ModelInputModality, ...] | None = Field(
+ default=None, serialization_alias="inputModalities"
+ )
reasoning_efforts: tuple[str, ...] | None = Field(
default=None, serialization_alias="reasoningEfforts"
)
@@ -110,6 +117,7 @@ SUPPORTED_CLAUDE_MODELS = [
class _InventoryModel:
provider_model_ref: str
supports_thinking: bool | None
+ input_modalities: frozenset[ModelInputModality] | None
def build_models_list_response(
@@ -132,14 +140,14 @@ def _build_claude_models_response(
seen: set[str] = set()
for ref in configured_chat_model_refs(settings):
- supports_thinking = runtime.cached_model_supports_thinking(
- ref.provider_id, ref.model_id
- )
+ model_info = runtime.cached_model_info(ref.provider_id, ref.model_id)
_append_provider_model_variants(
models,
seen,
ref.model_ref,
- supports_thinking=supports_thinking,
+ supports_thinking=(
+ model_info.supports_thinking if model_info is not None else None
+ ),
)
for model_info in runtime.cached_prefixed_model_infos():
@@ -196,6 +204,10 @@ def _build_direct_models_response(
"responses" if view is ModelCatalogView.RESPONSES else None
),
max_retries=0 if view is ModelCatalogView.RESPONSES else None,
+ supports_reasoning=inventory_model.supports_thinking,
+ input_modalities=_serialize_input_modalities(
+ inventory_model.input_modalities
+ ),
supports_reasoning_effort=(
allows_reasoning if view is ModelCatalogView.RESPONSES else None
),
@@ -226,11 +238,15 @@ def _collect_inventory(
if ref.model_ref in seen:
continue
seen.add(ref.model_ref)
+ model_info = runtime.cached_model_info(ref.provider_id, ref.model_id)
inventory.append(
_InventoryModel(
provider_model_ref=ref.model_ref,
- supports_thinking=runtime.cached_model_supports_thinking(
- ref.provider_id, ref.model_id
+ supports_thinking=(
+ model_info.supports_thinking if model_info is not None else None
+ ),
+ input_modalities=(
+ model_info.input_modalities if model_info is not None else None
),
)
)
@@ -243,12 +259,21 @@ def _collect_inventory(
_InventoryModel(
provider_model_ref=model_info.model_id,
supports_thinking=model_info.supports_thinking,
+ input_modalities=model_info.input_modalities,
)
)
return tuple(inventory)
+def _serialize_input_modalities(
+ modalities: frozenset[ModelInputModality] | None,
+) -> tuple[ModelInputModality, ...] | None:
+ if modalities is None:
+ return None
+ return tuple(modality for modality in ModelInputModality if modality in modalities)
+
+
def _responses_inference_idle_timeout_seconds(provider_progress_timeout: float) -> int:
return math.ceil(provider_progress_timeout) + _INFERENCE_IDLE_TIMEOUT_MARGIN_SECONDS
diff --git a/src/free_claude_code/application/model_metadata.py b/src/free_claude_code/application/model_metadata.py
index 5ebc310b..edfb2d47 100644
--- a/src/free_claude_code/application/model_metadata.py
+++ b/src/free_claude_code/application/model_metadata.py
@@ -2,6 +2,8 @@
from dataclasses import dataclass
+from free_claude_code.core.model_capabilities import ModelInputModality
+
@dataclass(frozen=True, slots=True)
class ProviderModelInfo:
@@ -9,6 +11,7 @@ class ProviderModelInfo:
model_id: str
supports_thinking: bool | None = None
+ input_modalities: frozenset[ModelInputModality] | None = None
@dataclass(frozen=True, slots=True)
diff --git a/src/free_claude_code/application/ports.py b/src/free_claude_code/application/ports.py
index 6c3affc4..4fa63463 100644
--- a/src/free_claude_code/application/ports.py
+++ b/src/free_claude_code/application/ports.py
@@ -76,9 +76,9 @@ class RequestRuntimePort(Protocol):
def current_settings(self) -> Settings: ...
- def cached_model_supports_thinking(
+ def cached_model_info(
self, provider_id: str, model_id: str
- ) -> bool | None: ...
+ ) -> ProviderModelInfo | None: ...
def cached_prefixed_model_infos(self) -> tuple[ProviderModelInfo, ...]: ...
diff --git a/src/free_claude_code/cli/launchers/aider_config.py b/src/free_claude_code/cli/launchers/aider_config.py
index 0a0212c4..abf07f9a 100644
--- a/src/free_claude_code/cli/launchers/aider_config.py
+++ b/src/free_claude_code/cli/launchers/aider_config.py
@@ -4,6 +4,7 @@ import re
from dataclasses import dataclass, field
from free_claude_code.core.json_types import JsonObject
+from free_claude_code.core.model_capabilities import ModelInputModality
from .model_catalog import ClientModel
@@ -41,11 +42,27 @@ def build_aider_config(
},
}
]
- metadata: JsonObject = {
- f"anthropic/{model.wire_slug}": {
- "litellm_provider": "anthropic",
- "mode": "chat",
+ settings.extend(
+ {
+ "name": f"anthropic/{model.wire_slug}",
+ "accepts_settings": (
+ ["reasoning_effort"] if model.supports_reasoning else []
+ ),
}
for model in models
+ if model.supports_reasoning is not None
+ )
+ metadata: JsonObject = {
+ f"anthropic/{model.wire_slug}": _model_metadata(model) for model in models
}
return AiderConfig(settings=settings, metadata=metadata)
+
+
+def _model_metadata(model: ClientModel) -> JsonObject:
+ metadata: JsonObject = {
+ "litellm_provider": "anthropic",
+ "mode": "chat",
+ }
+ if model.input_modalities is not None:
+ metadata["supports_vision"] = ModelInputModality.IMAGE in model.input_modalities
+ return metadata
diff --git a/src/free_claude_code/cli/launchers/cline_config.py b/src/free_claude_code/cli/launchers/cline_config.py
index 3b7d23b0..95fb9c46 100644
--- a/src/free_claude_code/cli/launchers/cline_config.py
+++ b/src/free_claude_code/cli/launchers/cline_config.py
@@ -4,6 +4,7 @@ from dataclasses import dataclass, field
from datetime import UTC, datetime
from free_claude_code.core.json_types import JsonObject
+from free_claude_code.core.model_capabilities import ModelInputModality
from .common import proxy_v1_url
from .model_catalog import ClientModel
@@ -47,17 +48,7 @@ def build_cline_config(
"capabilities": ["streaming", "tools"],
}
model_entries: JsonObject = {
- model.wire_slug: {
- "name": model.display_name,
- "capabilities": [
- "streaming",
- "tools",
- *(["reasoning"] if model.allows_reasoning else []),
- ],
- "supportsReasoning": model.allows_reasoning,
- "apiFormat": "openai-responses",
- }
- for model in models
+ model.wire_slug: _model_entry(model) for model in models
}
return ClineConfig(
@@ -90,3 +81,36 @@ def build_cline_config(
},
},
)
+
+
+def _model_entry(model: ClientModel) -> JsonObject:
+ supports_reasoning = model.supports_reasoning is not False
+ supports_vision = (
+ model.input_modalities is not None
+ and ModelInputModality.IMAGE in model.input_modalities
+ )
+ capabilities = ["streaming", "tools"]
+ if supports_reasoning:
+ capabilities.append("reasoning")
+ if supports_vision:
+ capabilities.append("images")
+
+ entry: JsonObject = {
+ "name": model.display_name,
+ "capabilities": capabilities,
+ "supportsReasoning": supports_reasoning,
+ "apiFormat": "openai-responses",
+ }
+ if model.input_modalities is not None:
+ entry.update(
+ {
+ "supportsVision": supports_vision,
+ "inputModalities": [
+ modality.value
+ for modality in ModelInputModality
+ if modality in model.input_modalities
+ ],
+ "outputModalities": ["text"],
+ }
+ )
+ return entry
diff --git a/src/free_claude_code/cli/launchers/codex_model_catalog.py b/src/free_claude_code/cli/launchers/codex_model_catalog.py
index 6fd00684..f2954bd3 100644
--- a/src/free_claude_code/cli/launchers/codex_model_catalog.py
+++ b/src/free_claude_code/cli/launchers/codex_model_catalog.py
@@ -6,6 +6,7 @@ from collections.abc import Mapping
from pathlib import Path
from free_claude_code.core.json_types import JsonObject, JsonValue
+from free_claude_code.core.model_capabilities import ModelInputModality
from .model_catalog import ClientModel, client_models_from_response
@@ -65,12 +66,17 @@ def write_codex_model_catalog(
def _codex_catalog_entry(candidate: ClientModel, *, priority: int) -> JsonObject:
- return {
+ supports_reasoning = candidate.supports_reasoning is not False
+ input_modalities = candidate.input_modalities or frozenset(
+ {ModelInputModality.TEXT}
+ )
+ entry: JsonObject = {
"slug": candidate.wire_slug,
"display_name": candidate.display_name,
"description": "Free Claude Code provider model",
- "default_reasoning_level": "medium",
- "supported_reasoning_levels": SUPPORTED_REASONING_LEVELS,
+ "supported_reasoning_levels": (
+ SUPPORTED_REASONING_LEVELS if supports_reasoning else []
+ ),
"shell_type": "shell_command",
"visibility": "list",
"supported_in_api": True,
@@ -78,8 +84,7 @@ def _codex_catalog_entry(candidate: ClientModel, *, priority: int) -> JsonObject
"additional_speed_tiers": [],
"service_tiers": [],
"base_instructions": CODEX_BASE_INSTRUCTIONS,
- "supports_reasoning_summaries": True,
- "default_reasoning_summary": "none",
+ "supports_reasoning_summaries": supports_reasoning,
"support_verbosity": True,
"default_verbosity": "low",
"apply_patch_tool_type": "freeform",
@@ -91,7 +96,15 @@ def _codex_catalog_entry(candidate: ClientModel, *, priority: int) -> JsonObject
"max_context_window": 200000,
"effective_context_window_percent": 95,
"experimental_supported_tools": [],
- "input_modalities": ["text"],
+ "input_modalities": [
+ modality.value
+ for modality in ModelInputModality
+ if modality in input_modalities
+ ],
"supports_search_tool": True,
"use_responses_lite": False,
}
+ if supports_reasoning:
+ entry["default_reasoning_level"] = "medium"
+ entry["default_reasoning_summary"] = "none"
+ return entry
diff --git a/src/free_claude_code/cli/launchers/dsh_config.py b/src/free_claude_code/cli/launchers/dsh_config.py
index 52c17c99..6985b94b 100644
--- a/src/free_claude_code/cli/launchers/dsh_config.py
+++ b/src/free_claude_code/cli/launchers/dsh_config.py
@@ -5,6 +5,7 @@ from dataclasses import dataclass, field
from pathlib import Path
from free_claude_code.core.json_types import JsonObject
+from free_claude_code.core.model_capabilities import ModelInputModality
from .common import proxy_v1_url
from .model_catalog import ClientModel
@@ -112,8 +113,14 @@ def _model_profile(model: ClientModel) -> JsonObject:
"name": model.display_name,
}
profile["reasoningEfforts"] = (
- dict(_REASONING_EFFORTS) if model.allows_reasoning else False
+ dict(_REASONING_EFFORTS) if model.supports_reasoning is not False else False
)
+ if model.input_modalities is not None:
+ profile["input"] = [
+ modality.value
+ for modality in ModelInputModality
+ if modality in model.input_modalities
+ ]
return profile
diff --git a/src/free_claude_code/cli/launchers/hermes_config.py b/src/free_claude_code/cli/launchers/hermes_config.py
index 4d7d5eee..799e523a 100644
--- a/src/free_claude_code/cli/launchers/hermes_config.py
+++ b/src/free_claude_code/cli/launchers/hermes_config.py
@@ -3,6 +3,7 @@
from dataclasses import dataclass, field
from free_claude_code.core.json_types import JsonObject
+from free_claude_code.core.model_capabilities import ModelInputModality
from .common import proxy_v1_url
from .model_catalog import ClientModel
@@ -68,6 +69,11 @@ def build_hermes_managed_config(
auxiliary: JsonObject = {
task: _auxiliary_task_config(task) for task in _AUXILIARY_TASKS
}
+ model_overrides = {
+ model.wire_slug: override
+ for model in models
+ if (override := _model_override(model))
+ }
config: JsonObject = {
"providers": {
provider_key: {
@@ -91,6 +97,8 @@ def build_hermes_managed_config(
"fallback_model": [],
"auxiliary": auxiliary,
}
+ if model_overrides:
+ config["model_overrides"] = {"custom": model_overrides}
return HermesManagedConfig(
config=config,
provider_key=provider_key,
@@ -112,3 +120,12 @@ def _auxiliary_task_config(task: str) -> JsonObject:
if task == "title_generation":
config["prefer_fast_model"] = False
return config
+
+
+def _model_override(model: ClientModel) -> JsonObject:
+ override: JsonObject = {}
+ if model.supports_reasoning is not None:
+ override["supports_reasoning"] = model.supports_reasoning
+ if model.input_modalities is not None:
+ override["supports_vision"] = ModelInputModality.IMAGE in model.input_modalities
+ return override
diff --git a/src/free_claude_code/cli/launchers/model_catalog.py b/src/free_claude_code/cli/launchers/model_catalog.py
index ea5741d9..41a783a4 100644
--- a/src/free_claude_code/cli/launchers/model_catalog.py
+++ b/src/free_claude_code/cli/launchers/model_catalog.py
@@ -8,6 +8,7 @@ from urllib.request import Request
from free_claude_code.cli.local_http import open_local_request
from free_claude_code.core.json_types import JsonObject, JsonValue
+from free_claude_code.core.model_capabilities import ModelInputModality
from .common import PROXY_PREFLIGHT_TIMEOUT_SECONDS
@@ -19,7 +20,8 @@ class ClientModel:
wire_slug: str
provider_model_ref: str
display_name: str
- allows_reasoning: bool
+ supports_reasoning: bool | None
+ input_modalities: frozenset[ModelInputModality] | None = None
def client_models_from_response(
@@ -104,7 +106,8 @@ def _catalog_candidates(
wire_slug=model_id,
provider_model_ref=provider_model_ref,
display_name=_nonempty_string(item.get("display_name")) or model_id,
- allows_reasoning=model_id == provider_model_ref,
+ supports_reasoning=_optional_boolean(item.get("supportsReasoning")),
+ input_modalities=_input_modalities(item.get("inputModalities")),
)
)
return candidates
@@ -117,6 +120,22 @@ def _nonempty_string(value: object) -> str | None:
return stripped or None
+def _optional_boolean(value: object) -> bool | None:
+ return value if isinstance(value, bool) else None
+
+
+def _input_modalities(value: object) -> frozenset[ModelInputModality] | None:
+ if not isinstance(value, list) or not value:
+ return None
+ try:
+ modalities = frozenset(ModelInputModality(item) for item in value)
+ except TypeError, ValueError:
+ return None
+ if ModelInputModality.TEXT not in modalities:
+ return None
+ return modalities
+
+
def _provider_model_ref(value: object) -> str | None:
ref = _nonempty_string(value)
if ref is None:
diff --git a/src/free_claude_code/cli/launchers/opencode_config.py b/src/free_claude_code/cli/launchers/opencode_config.py
index a8727d87..332c2255 100644
--- a/src/free_claude_code/cli/launchers/opencode_config.py
+++ b/src/free_claude_code/cli/launchers/opencode_config.py
@@ -3,6 +3,7 @@
from dataclasses import dataclass
from free_claude_code.core.json_types import JsonObject
+from free_claude_code.core.model_capabilities import ModelInputModality
from .common import proxy_v1_url
from .model_catalog import ClientModel
@@ -28,11 +29,7 @@ def build_opencode_config(
raise ValueError("OpenCode requires at least one routable FCC model")
model_config: JsonObject = {
- model.wire_slug: {
- "name": model.display_name,
- "reasoning": model.allows_reasoning,
- }
- for model in models
+ model.wire_slug: _model_config(model) for model in models
}
provider_config: JsonObject = {
"name": "Free Claude Code",
@@ -61,3 +58,19 @@ def build_opencode_config(
"small_model": default_model,
},
)
+
+
+def _model_config(model: ClientModel) -> JsonObject:
+ config: JsonObject = {
+ "name": model.display_name,
+ "reasoning": model.supports_reasoning is not False,
+ }
+ if model.input_modalities is not None:
+ config["modalities"] = {
+ "input": [
+ modality.value
+ for modality in ModelInputModality
+ if modality in model.input_modalities
+ ]
+ }
+ return config
diff --git a/src/free_claude_code/cli/launchers/pi_extension.ts b/src/free_claude_code/cli/launchers/pi_extension.ts
index e443a456..2f648865 100644
--- a/src/free_claude_code/cli/launchers/pi_extension.ts
+++ b/src/free_claude_code/cli/launchers/pi_extension.ts
@@ -33,12 +33,28 @@ function isRecord(value: unknown): value is Record<string, unknown> {
return typeof value === "object" && value !== null && !Array.isArray(value);
}
-function modelDefinition(id: string, providerModel: string): ProviderModelConfig {
+function optionalBoolean(value: unknown): boolean | undefined {
+ return typeof value === "boolean" ? value : undefined;
+}
+
+function inputModalities(value: unknown): ("text" | "image")[] | undefined {
+ if (!Array.isArray(value) || value.length === 0) return undefined;
+ if (value.some((item) => item !== "text" && item !== "image")) return undefined;
+ const modalities = (["text", "image"] as const).filter((item) => value.includes(item));
+ return modalities.includes("text") ? modalities : undefined;
+}
+
+function modelDefinition(
+ id: string,
+ providerModel: string,
+ supportsReasoning: boolean | undefined,
+ input: ("text" | "image")[] | undefined,
+): ProviderModelConfig {
return {
id,
name: providerModel,
- reasoning: id === providerModel,
- input: ["text"],
+ reasoning: supportsReasoning ?? true,
+ input: input ?? ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: DEFAULT_CONTEXT_WINDOW,
maxTokens: DEFAULT_MAX_TOKENS,
@@ -57,7 +73,14 @@ export function projectFccModels(payload: unknown): ProviderModelConfig[] {
const providerModel = entry.provider_model_ref.trim();
if (!id || !providerModel.includes("/") || seen.has(id)) continue;
seen.add(id);
- models.push(modelDefinition(id, providerModel));
+ models.push(
+ modelDefinition(
+ id,
+ providerModel,
+ optionalBoolean(entry.supportsReasoning),
+ inputModalities(entry.inputModalities),
+ ),
+ );
}
if (models.length === 0) {
diff --git a/src/free_claude_code/core/model_capabilities.py b/src/free_claude_code/core/model_capabilities.py
new file mode 100644
index 00000000..4da8d10e
--- /dev/null
+++ b/src/free_claude_code/core/model_capabilities.py
@@ -0,0 +1,10 @@
+"""Neutral capability values shared by model discovery and client catalogs."""
+
+from enum import StrEnum
+
+
+class ModelInputModality(StrEnum):
+ """Input media that FCC can preserve across supported protocol paths."""
+
+ TEXT = "text"
+ IMAGE = "image"
diff --git a/src/free_claude_code/providers/mistral/client.py b/src/free_claude_code/providers/mistral/client.py
index db16d4be..8695ca6b 100644
--- a/src/free_claude_code/providers/mistral/client.py
+++ b/src/free_claude_code/providers/mistral/client.py
@@ -6,6 +6,7 @@ from typing import Any
from loguru import logger
from free_claude_code.core.anthropic import ReasoningReplayMode
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningPolicy
from free_claude_code.providers.admission import ProviderAdmissionController
from free_claude_code.providers.base import ProviderConfig
@@ -14,6 +15,7 @@ from free_claude_code.providers.openai_chat import (
OpenAIChatProfile,
OpenAIChatProvider,
OpenAIChatRequestPolicy,
+ OpenAIModelListing,
)
from .reasoning import (
@@ -27,7 +29,19 @@ _REQUEST_POLICY = OpenAIChatRequestPolicy(
provider_name="MISTRAL",
reasoning_replay=ReasoningReplayMode.REASONING_CONTENT,
)
-_PROFILE = OpenAIChatProfile(_REQUEST_POLICY, NO_REASONING)
+_PROFILE = OpenAIChatProfile(
+ _REQUEST_POLICY,
+ NO_REASONING,
+ model_listing=OpenAIModelListing(
+ input_modality_boolean_paths=(
+ (
+ ModelInputModality.TEXT,
+ ("capabilities", "completion_chat"),
+ ),
+ (ModelInputModality.IMAGE, ("capabilities", "vision")),
+ ),
+ ),
+)
class MistralProvider(OpenAIChatProvider):
diff --git a/src/free_claude_code/providers/model_listing.py b/src/free_claude_code/providers/model_listing.py
index d950f891..852d68c0 100644
--- a/src/free_claude_code/providers/model_listing.py
+++ b/src/free_claude_code/providers/model_listing.py
@@ -1,16 +1,19 @@
"""Provider model-list response parsing helpers."""
from collections.abc import Iterable, Mapping, Sequence
-from typing import Any
+from dataclasses import replace
+from typing import Any, TypeIs
from free_claude_code.application.model_metadata import (
ProviderModelInfo as _ProviderModelInfo,
)
+from free_claude_code.core.model_capabilities import ModelInputModality
type ModelListScalar = str | bool
type RequiredPathValues = tuple[
tuple[tuple[str, ...], tuple[ModelListScalar, ...]], ...
]
+type InputModalityBooleanPaths = tuple[tuple[ModelInputModality, tuple[str, ...]], ...]
class ModelListResponseError(ValueError):
@@ -47,6 +50,10 @@ def extract_openai_model_infos(
thinking_tag: str = "reasoning",
non_thinking_tag: str | None = None,
thinking_boolean_path: tuple[str, ...] | None = None,
+ input_modalities_path: tuple[str, ...] | None = None,
+ thinking_sequence_path: tuple[str, ...] | None = None,
+ fixed_input_modalities: frozenset[ModelInputModality] | None = None,
+ input_modality_boolean_paths: InputModalityBooleanPaths = (),
) -> frozenset[_ProviderModelInfo]:
"""Extract routable IDs from an OpenAI-compatible model-list response."""
model_infos: dict[str, _ProviderModelInfo] = {}
@@ -115,37 +122,40 @@ def extract_openai_model_infos(
supports_thinking: bool | None = None
if tags_field is not None:
tags_value = _field(item, tags_field)
- if not _is_sequence(tags_value) or any(
- not isinstance(tag, str) or not tag.strip() for tag in tags_value
- ):
- raise _malformed(
- provider_name,
- f"expected every {item_location} item to include "
- f"{tags_field} string array",
- )
- tags = frozenset(tags_value)
- if thinking_tag in tags:
- supports_thinking = True
- elif non_thinking_tag is not None and non_thinking_tag in tags:
- supports_thinking = False
+ tags = _optional_string_sequence(tags_value)
+ if tags is not None:
+ tag_set = frozenset(tags)
+ if thinking_tag in tag_set:
+ supports_thinking = True
+ elif non_thinking_tag is not None and non_thinking_tag in tag_set:
+ supports_thinking = False
if thinking_boolean_path is not None:
capability = _path(item, thinking_boolean_path)
- if capability is not _MISSING:
- if not isinstance(capability, bool):
- raise _malformed(
- provider_name,
- f"expected {'.'.join(thinking_boolean_path)} to be boolean",
- )
+ if isinstance(capability, bool):
supports_thinking = capability
+ if thinking_sequence_path is not None:
+ values = _optional_string_sequence(_path(item, thinking_sequence_path))
+ if values is not None:
+ supports_thinking = thinking_tag in values
+
+ input_modalities = _input_modalities(
+ item,
+ sequence_path=input_modalities_path,
+ fixed=fixed_input_modalities,
+ boolean_paths=input_modality_boolean_paths,
+ )
+
if not included:
continue
- model_infos.setdefault(
- model_id,
- _ProviderModelInfo(model_id=model_id, supports_thinking=supports_thinking),
+ model_info = _ProviderModelInfo(
+ model_id=model_id,
+ supports_thinking=supports_thinking,
+ input_modalities=input_modalities,
)
+ model_infos.setdefault(model_id, model_info)
if aliases_field is not None:
aliases = _field(item, aliases_field)
if not _is_sequence(aliases):
@@ -162,9 +172,7 @@ def extract_openai_model_infos(
)
model_infos.setdefault(
alias,
- _ProviderModelInfo(
- model_id=alias, supports_thinking=supports_thinking
- ),
+ replace(model_info, model_id=alias),
)
if not model_infos:
@@ -192,10 +200,18 @@ def extract_tool_capable_model_infos(
}
if supported_parameter_names.isdisjoint({"tools", "tool_choice"}):
continue
+ capability_parameters = _optional_string_sequence(supported_parameters)
model_infos.add(
_ProviderModelInfo(
model_id=model_id,
- supports_thinking="reasoning" in supported_parameter_names,
+ supports_thinking=(
+ "reasoning" in capability_parameters
+ if capability_parameters is not None
+ else None
+ ),
+ input_modalities=optional_input_modalities(
+ _path(item, ("architecture", "input_modalities"))
+ ),
)
)
@@ -312,12 +328,67 @@ def _path(item: Any, path: tuple[str, ...]) -> Any:
return current
-def _is_sequence(value: Any) -> bool:
+def _is_sequence(value: object) -> TypeIs[Sequence[object]]:
return isinstance(value, Sequence) and not isinstance(
value, str | bytes | bytearray
)
+def _optional_string_sequence(value: object) -> tuple[str, ...] | None:
+ if value is _MISSING or value is None or not _is_sequence(value):
+ return None
+ strings: list[str] = []
+ for item in value:
+ if not isinstance(item, str) or not item.strip():
+ return None
+ strings.append(item)
+ return tuple(strings)
+
+
+_INPUT_MODALITY_BY_VALUE = {modality.value: modality for modality in ModelInputModality}
+
+
+def optional_input_modalities(
+ value: object,
+) -> frozenset[ModelInputModality] | None:
+ """Normalize a provider's optional input-modality string sequence."""
+ values = _optional_string_sequence(value)
+ if values is None:
+ return None
+ modalities = frozenset(
+ _INPUT_MODALITY_BY_VALUE[item]
+ for item in values
+ if item in _INPUT_MODALITY_BY_VALUE
+ )
+ if ModelInputModality.TEXT not in modalities:
+ return None
+ return modalities
+
+
+def _input_modalities(
+ item: object,
+ *,
+ sequence_path: tuple[str, ...] | None,
+ fixed: frozenset[ModelInputModality] | None,
+ boolean_paths: InputModalityBooleanPaths,
+) -> frozenset[ModelInputModality] | None:
+ if sequence_path is not None:
+ return optional_input_modalities(_path(item, sequence_path))
+ if not boolean_paths:
+ return fixed
+
+ modalities = set(fixed or ())
+ for modality, path in boolean_paths:
+ enabled = _path(item, path)
+ if not isinstance(enabled, bool):
+ return None
+ if enabled:
+ modalities.add(modality)
+ else:
+ modalities.discard(modality)
+ return frozenset(modalities)
+
+
def _scalar_type_name(value: ModelListScalar) -> str:
return type(value).__name__
diff --git a/src/free_claude_code/providers/openai_chat/__init__.py b/src/free_claude_code/providers/openai_chat/__init__.py
index a6e81991..e6e5a019 100644
--- a/src/free_claude_code/providers/openai_chat/__init__.py
+++ b/src/free_claude_code/providers/openai_chat/__init__.py
@@ -8,7 +8,7 @@ from .extra_body import (
validate_extra_body_does_not_override_canonical_fields,
validate_extra_body_does_not_override_reasoning_fields,
)
-from .profiles import OPENAI_CHAT_PROFILES, OpenAIChatProfile
+from .profiles import OPENAI_CHAT_PROFILES, OpenAIChatProfile, OpenAIModelListing
from .provider import OpenAIAsyncCredentialProvider, OpenAIChatProvider
from .reasoning import (
NO_REASONING,
@@ -55,6 +55,7 @@ __all__ = [
"OpenAIChatProfile",
"OpenAIChatProvider",
"OpenAIChatRequestPolicy",
+ "OpenAIModelListing",
"ReasoningObject",
"apply_openai_chat_body_policy",
"apply_reasoning_details_replay",
diff --git a/src/free_claude_code/providers/openai_chat/profiles.py b/src/free_claude_code/providers/openai_chat/profiles.py
index 49d8be05..398b2e78 100644
--- a/src/free_claude_code/providers/openai_chat/profiles.py
+++ b/src/free_claude_code/providers/openai_chat/profiles.py
@@ -9,8 +9,12 @@ from free_claude_code.application.errors import InvalidRequestError
from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
from free_claude_code.core.anthropic import ReasoningReplayMode
from free_claude_code.core.anthropic.models import MessagesRequest
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicy
-from free_claude_code.providers.model_listing import RequiredPathValues
+from free_claude_code.providers.model_listing import (
+ InputModalityBooleanPaths,
+ RequiredPathValues,
+)
from .base_url import openai_v1_base_url
from .extra_body import (
@@ -63,6 +67,7 @@ _KIMI_CODE_EFFORTS = (
(ReasoningEffort.XHIGH, "max"),
(ReasoningEffort.MAX, "max"),
)
+_TEXT_INPUT_MODALITIES = frozenset({ModelInputModality.TEXT})
@dataclass(frozen=True, slots=True)
@@ -94,6 +99,10 @@ class OpenAIModelListing:
thinking_tag: str = "reasoning"
non_thinking_tag: str | None = None
thinking_boolean_path: tuple[str, ...] | None = None
+ input_modalities_path: tuple[str, ...] | None = None
+ thinking_sequence_path: tuple[str, ...] | None = None
+ fixed_input_modalities: frozenset[ModelInputModality] | None = None
+ input_modality_boolean_paths: InputModalityBooleanPaths = ()
pagination: OpenAIModelPagination | None = None
@@ -242,6 +251,7 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
path="/language-models",
collection_field="models",
aliases_field="aliases",
+ input_modalities_path=("input_modalities",),
),
),
"qwencloud": OpenAIChatProfile(
@@ -326,6 +336,7 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
path="/models",
query_params=(("verbose", "true"),),
required_path_values=((("architecture", "modality"), ("text->text",)),),
+ fixed_input_modalities=_TEXT_INPUT_MODALITIES,
),
),
"chutes": OpenAIChatProfile(
@@ -344,6 +355,7 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
),
exclude_missing_sequence_fields=True,
tags_field="supported_features",
+ input_modalities_path=("input_modalities",),
),
),
"featherless": OpenAIChatProfile(
@@ -368,6 +380,10 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
(("is_gated",), (False,)),
(("available_on_current_plan",), (True,)),
),
+ fixed_input_modalities=_TEXT_INPUT_MODALITIES,
+ input_modality_boolean_paths=(
+ (ModelInputModality.IMAGE, ("features", "image_input")),
+ ),
pagination=OpenAIModelPagination(),
),
),
@@ -398,6 +414,7 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
("output_modalities", "text"),
),
thinking_boolean_path=("capabilities", "reasoning"),
+ input_modalities_path=("input_modalities",),
),
reasoning_delta_field="reasoning",
reasoning_delta_fallback_field="reasoning_content",
@@ -431,6 +448,15 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
"mistral_codestral": OpenAIChatProfile(
_policy("CODESTRAL", ReasoningReplayMode.THINK_TAGS),
NO_REASONING,
+ model_listing=OpenAIModelListing(
+ input_modality_boolean_paths=(
+ (
+ ModelInputModality.TEXT,
+ ("capabilities", "completion_chat"),
+ ),
+ (ModelInputModality.IMAGE, ("capabilities", "vision")),
+ ),
+ ),
),
"vercel": OpenAIChatProfile(
_policy(
@@ -440,6 +466,10 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
extra_body_validator=validate_extra_body_does_not_override_reasoning_fields,
),
ReasoningObject(_ALL_EFFORTS),
+ model_listing=OpenAIModelListing(
+ input_modalities_path=("modalities", "input"),
+ thinking_sequence_path=("supported_parameters",),
+ ),
),
"bedrock": OpenAIChatProfile(
_policy("BEDROCK", ReasoningReplayMode.THINK_TAGS),
@@ -454,6 +484,9 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
extra_body_validator=validate_extra_body_does_not_override_reasoning_fields,
),
NO_REASONING,
+ model_listing=OpenAIModelListing(
+ input_modalities_path=("architecture", "input_modalities"),
+ ),
),
"cohere": OpenAIChatProfile(
_policy(
@@ -611,6 +644,9 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
_LOW_MEDIUM_HIGH,
enabled_value="medium",
),
+ model_listing=OpenAIModelListing(
+ thinking_boolean_path=("reasoning",),
+ ),
),
"poolside": OpenAIChatProfile(
_policy(
@@ -638,6 +674,7 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {
(("tools_calling",), (True,)),
),
thinking_boolean_path=("reasoning",),
+ input_modalities_path=("modalities", "input"),
),
),
"ollama_cloud": OpenAIChatProfile(
diff --git a/src/free_claude_code/providers/openai_chat/provider.py b/src/free_claude_code/providers/openai_chat/provider.py
index a113b64c..376e8c36 100644
--- a/src/free_claude_code/providers/openai_chat/provider.py
+++ b/src/free_claude_code/providers/openai_chat/provider.py
@@ -549,6 +549,10 @@ class OpenAIChatProvider(BaseProvider):
thinking_tag=listing.thinking_tag,
non_thinking_tag=listing.non_thinking_tag,
thinking_boolean_path=listing.thinking_boolean_path,
+ input_modalities_path=listing.input_modalities_path,
+ thinking_sequence_path=listing.thinking_sequence_path,
+ fixed_input_modalities=listing.fixed_input_modalities,
+ input_modality_boolean_paths=listing.input_modality_boolean_paths,
)
model_infos_by_id = {
model_info.model_id: model_info for model_info in live_model_infos
diff --git a/src/free_claude_code/providers/openai_codex/provider.py b/src/free_claude_code/providers/openai_codex/provider.py
index cc02e3c3..8e18c93c 100644
--- a/src/free_claude_code/providers/openai_codex/provider.py
+++ b/src/free_claude_code/providers/openai_codex/provider.py
@@ -48,6 +48,7 @@ from free_claude_code.providers.failure_policy import (
is_retryable_stream_error,
)
from free_claude_code.providers.http import ProviderAttemptScope, maybe_await_aclose
+from free_claude_code.providers.model_listing import optional_input_modalities
from free_claude_code.providers.openai_responses.presentation import (
MessagesResponsesPresenter,
NativeResponsesPresenter,
@@ -604,7 +605,10 @@ def _model_infos(payload: Any) -> frozenset[ProviderModelInfo]:
infos.add(
ProviderModelInfo(
model_id=model_id,
- supports_thinking=bool(efforts) if isinstance(efforts, list) else None,
+ supports_thinking=_supports_reasoning(efforts),
+ input_modalities=optional_input_modalities(
+ model.get("input_modalities")
+ ),
)
)
if not infos:
@@ -612,6 +616,18 @@ def _model_infos(payload: Any) -> frozenset[ProviderModelInfo]:
return frozenset(infos)
+def _supports_reasoning(levels: object) -> bool | None:
+ if not isinstance(levels, list):
+ return None
+ for level in levels:
+ if not isinstance(level, dict):
+ return None
+ effort = level.get("effort")
+ if not isinstance(effort, str) or not effort.strip():
+ return None
+ return bool(levels)
+
+
def _effective_error(error: Exception) -> Exception:
if isinstance(error, OpenAIReconnectRequired):
return ExecutionFailure(
diff --git a/src/free_claude_code/providers/opencode/catalog.py b/src/free_claude_code/providers/opencode/catalog.py
index 3bce0943..037236dc 100644
--- a/src/free_claude_code/providers/opencode/catalog.py
+++ b/src/free_claude_code/providers/opencode/catalog.py
@@ -9,13 +9,17 @@ from types import MappingProxyType
import httpx
from free_claude_code.application.model_metadata import ProviderModelInfo
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.providers.admission import (
ProviderAdmissionController,
ProviderOperationKind,
)
from free_claude_code.providers.base import ProviderConfig
from free_claude_code.providers.failure_policy import classify_provider_failure
-from free_claude_code.providers.model_listing import ModelListResponseError
+from free_claude_code.providers.model_listing import (
+ ModelListResponseError,
+ optional_input_modalities,
+)
OPENCODE_CATALOG_URL = "https://models.opencode.ai/api.json"
_DEFAULT_PACKAGE = "@ai-sdk/openai-compatible"
@@ -39,6 +43,7 @@ class OpenCodeModelRoute:
upstream_model_id: str
transport: OpenCodeUpstreamTransport
supports_thinking: bool | None
+ input_modalities: frozenset[ModelInputModality] | None
@dataclass(frozen=True, slots=True)
@@ -115,10 +120,12 @@ def parse_open_code_catalog(
provider_name=provider_name,
location=f"model {selector_id!r} provider npm",
)
- supports_thinking = _optional_boolean(
- model.get("reasoning"),
- provider_name=provider_name,
- location=f"model {selector_id!r} reasoning",
+ supports_thinking = _optional_boolean(model.get("reasoning"))
+ raw_modalities = model.get("modalities")
+ input_modalities = (
+ optional_input_modalities(raw_modalities.get("input"))
+ if isinstance(raw_modalities, Mapping)
+ else None
)
effective_package = model_package or provider_package or _DEFAULT_PACKAGE
route = OpenCodeModelRoute(
@@ -130,6 +137,7 @@ def parse_open_code_catalog(
else OpenCodeUpstreamTransport.CHAT_COMPLETIONS
),
supports_thinking=supports_thinking,
+ input_modalities=input_modalities,
)
routes[selector_id] = route
@@ -139,6 +147,7 @@ def parse_open_code_catalog(
ProviderModelInfo(
model_id=route.selector_id,
supports_thinking=route.supports_thinking,
+ input_modalities=route.input_modalities,
)
for route in routes.values()
)
@@ -277,15 +286,8 @@ def _optional_package(
)
-def _optional_boolean(
- value: object,
- *,
- provider_name: str,
- location: str,
-) -> bool | None:
- if value is None or isinstance(value, bool):
- return value
- raise _catalog_error(provider_name, f"expected boolean {location}")
+def _optional_boolean(value: object) -> bool | None:
+ return value if isinstance(value, bool) else None
def _model_status(
diff --git a/src/free_claude_code/providers/runtime/model_cache.py b/src/free_claude_code/providers/runtime/model_cache.py
index 3c5191ea..aa9c99c8 100644
--- a/src/free_claude_code/providers/runtime/model_cache.py
+++ b/src/free_claude_code/providers/runtime/model_cache.py
@@ -1,6 +1,7 @@
"""Provider model-list metadata cache."""
from collections.abc import Iterable
+from dataclasses import replace
from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.provider_catalog import SUPPORTED_PROVIDER_IDS
@@ -58,14 +59,11 @@ class ProviderModelCache:
"""Return whether this provider has any cached model-list result."""
return provider_id in self._model_infos_by_provider
- def cached_model_supports_thinking(
+ def cached_model_info(
self, provider_id: str, model_id: str
- ) -> bool | None:
- """Return cached thinking support when a provider exposes it."""
- info = self._model_infos_by_provider.get(provider_id, {}).get(model_id)
- if info is None:
- return None
- return info.supports_thinking
+ ) -> ProviderModelInfo | None:
+ """Return the complete cached record for one provider model."""
+ return self._model_infos_by_provider.get(provider_id, {}).get(model_id)
def cached_prefixed_model_infos(self) -> tuple[ProviderModelInfo, ...]:
"""Return cached provider models with user-selectable prefixed ids."""
@@ -73,10 +71,7 @@ class ProviderModelCache:
for provider_id in SUPPORTED_PROVIDER_IDS:
provider_infos = self._model_infos_by_provider.get(provider_id, {})
infos.extend(
- ProviderModelInfo(
- model_id=f"{provider_id}/{info.model_id}",
- supports_thinking=info.supports_thinking,
- )
+ replace(info, model_id=f"{provider_id}/{info.model_id}")
for info in sorted(
provider_infos.values(), key=lambda item: item.model_id
)
diff --git a/src/free_claude_code/runtime/provider_manager.py b/src/free_claude_code/runtime/provider_manager.py
index 8afee284..7f04cb60 100644
--- a/src/free_claude_code/runtime/provider_manager.py
+++ b/src/free_claude_code/runtime/provider_manager.py
@@ -141,11 +141,11 @@ class ProviderRuntimeManager:
self._synchronize_model_cache_scope()
return self._model_cache.cached_model_ids()
- def cached_model_supports_thinking(
+ def cached_model_info(
self, provider_id: str, model_id: str
- ) -> bool | None:
+ ) -> ProviderModelInfo | None:
self._synchronize_model_cache_scope()
- return self._model_cache.cached_model_supports_thinking(provider_id, model_id)
+ return self._model_cache.cached_model_info(provider_id, model_id)
def cached_prefixed_model_infos(self) -> tuple[ProviderModelInfo, ...]:
self._synchronize_model_cache_scope()
diff --git a/tests/api/test_model_listing.py b/tests/api/test_model_listing.py
index 8a06ff14..09fed0e5 100644
--- a/tests/api/test_model_listing.py
+++ b/tests/api/test_model_listing.py
@@ -4,6 +4,7 @@ from fastapi.testclient import TestClient
from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.settings import Settings
+from free_claude_code.core.model_capabilities import ModelInputModality
from tests.api.support import create_test_app, provider_manager_for_app
@@ -225,6 +226,72 @@ def test_direct_model_views_exclude_claude_aliases_and_duplicate_variants():
assert "reasoningEfforts" not in plain
+def test_direct_model_views_serialize_known_capabilities_and_omit_unknowns():
+ app = create_test_app(_settings(model_opus=None, model_haiku=None))
+ provider_manager_for_app(app).cache_model_infos(
+ "open_router",
+ {
+ ProviderModelInfo(
+ "vision-reasoning",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "text-only",
+ supports_thinking=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ProviderModelInfo("unknown"),
+ },
+ )
+ client = TestClient(app)
+
+ messages = {
+ row["provider_model_ref"]: row
+ for row in client.get("/v1/models?view=messages").json()["data"]
+ }
+ responses = {
+ row["provider_model_ref"]: row
+ for row in client.get("/v1/models?view=responses").json()["data"]
+ }
+
+ assert messages["open_router/vision-reasoning"]["supportsReasoning"] is True
+ assert messages["open_router/vision-reasoning"]["inputModalities"] == [
+ "text",
+ "image",
+ ]
+ assert messages["open_router/text-only"]["supportsReasoning"] is False
+ assert messages["open_router/text-only"]["inputModalities"] == ["text"]
+ assert "supportsReasoning" not in messages["open_router/unknown"]
+ assert "inputModalities" not in messages["open_router/unknown"]
+ assert responses["open_router/text-only"]["supportsReasoningEffort"] is False
+ assert "reasoningEfforts" not in responses["open_router/text-only"]
+
+
+def test_claude_model_view_does_not_expose_capability_fields():
+ app = create_test_app(_settings(model_opus=None, model_haiku=None))
+ provider_manager_for_app(app).cache_model_infos(
+ "open_router",
+ {
+ ProviderModelInfo(
+ "vision-reasoning",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ )
+ },
+ )
+
+ rows = TestClient(app).get("/v1/models").json()["data"]
+
+ assert all(
+ "supportsReasoning" not in row and "inputModalities" not in row for row in rows
+ )
+
+
def test_muse_model_catalog_is_the_fixed_responses_projection():
app = create_test_app(_settings(model_opus=None, model_haiku=None))
manager = provider_manager_for_app(app)
diff --git a/tests/api/test_request_lifetime.py b/tests/api/test_request_lifetime.py
index 97c4cb18..8074ee88 100644
--- a/tests/api/test_request_lifetime.py
+++ b/tests/api/test_request_lifetime.py
@@ -470,11 +470,11 @@ class _Requests:
def current_settings(self) -> Settings:
return self._lease.settings
- def cached_model_supports_thinking(
+ def cached_model_info(
self,
provider_id: str,
model_id: str,
- ) -> bool | None:
+ ) -> ProviderModelInfo | None:
del provider_id, model_id
return None
diff --git a/tests/application/test_model_metadata.py b/tests/application/test_model_metadata.py
new file mode 100644
index 00000000..7fce6e84
--- /dev/null
+++ b/tests/application/test_model_metadata.py
@@ -0,0 +1,18 @@
+from dataclasses import replace
+
+from free_claude_code.application.model_metadata import ProviderModelInfo
+from free_claude_code.core.model_capabilities import ModelInputModality
+
+
+def test_provider_model_info_preserves_capabilities_when_identity_is_replaced() -> None:
+ info = ProviderModelInfo(
+ model_id="vendor/model",
+ supports_thinking=True,
+ input_modalities=frozenset({ModelInputModality.TEXT, ModelInputModality.IMAGE}),
+ )
+
+ assert replace(info, model_id="provider/vendor/model") == ProviderModelInfo(
+ model_id="provider/vendor/model",
+ supports_thinking=True,
+ input_modalities=frozenset({ModelInputModality.TEXT, ModelInputModality.IMAGE}),
+ )
diff --git a/tests/cli/test_aider_config.py b/tests/cli/test_aider_config.py
index 513846c6..407efb1d 100644
--- a/tests/cli/test_aider_config.py
+++ b/tests/cli/test_aider_config.py
@@ -6,6 +6,7 @@ import pytest
from free_claude_code.cli.launchers.aider_config import build_aider_config
from free_claude_code.cli.launchers.model_catalog import ClientModel
+from free_claude_code.core.model_capabilities import ModelInputModality
def _models() -> tuple[ClientModel, ...]:
@@ -14,13 +15,23 @@ def _models() -> tuple[ClientModel, ...]:
wire_slug="nvidia_nim/vendor/model",
provider_model_ref="nvidia_nim/vendor/model",
display_name="Nested model",
- allows_reasoning=True,
+ supports_reasoning=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
),
ClientModel(
wire_slug="ollama_cloud/qwen3-coder:480b",
provider_model_ref="ollama_cloud/qwen3-coder:480b",
display_name="Colon model",
- allows_reasoning=False,
+ supports_reasoning=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ClientModel(
+ wire_slug="future_provider/unknown-model",
+ provider_model_ref="future_provider/unknown-model",
+ display_name="Unknown model",
+ supports_reasoning=None,
),
)
@@ -39,20 +50,35 @@ def test_aider_config_projects_messages_route_and_canonical_catalog() -> None:
"api_base": "http://127.0.0.1:9191/v1/messages",
"api_key": "os.environ/FCC_AIDER_PROXY_AUTH_A1B2C3",
},
- }
+ },
+ {
+ "name": "anthropic/nvidia_nim/vendor/model",
+ "accepts_settings": ["reasoning_effort"],
+ },
+ {
+ "name": "anthropic/ollama_cloud/qwen3-coder:480b",
+ "accepts_settings": [],
+ },
]
assert list(config.metadata) == [
"anthropic/nvidia_nim/vendor/model",
"anthropic/ollama_cloud/qwen3-coder:480b",
+ "anthropic/future_provider/unknown-model",
]
assert config.metadata == {
"anthropic/nvidia_nim/vendor/model": {
"litellm_provider": "anthropic",
"mode": "chat",
+ "supports_vision": True,
},
"anthropic/ollama_cloud/qwen3-coder:480b": {
"litellm_provider": "anthropic",
"mode": "chat",
+ "supports_vision": False,
+ },
+ "anthropic/future_provider/unknown-model": {
+ "litellm_provider": "anthropic",
+ "mode": "chat",
},
}
@@ -67,7 +93,6 @@ def test_aider_config_projects_messages_route_and_canonical_catalog() -> None:
"max_tokens",
"input_cost_per_token",
"output_cost_per_token",
- "reasoning",
"edit_format",
):
assert fabricated_key not in serialized
diff --git a/tests/cli/test_aider_launcher.py b/tests/cli/test_aider_launcher.py
index 60229664..feaaddfa 100644
--- a/tests/cli/test_aider_launcher.py
+++ b/tests/cli/test_aider_launcher.py
@@ -30,13 +30,13 @@ def _models() -> tuple[ClientModel, ...]:
wire_slug="nvidia_nim/vendor/main-model",
provider_model_ref="nvidia_nim/vendor/main-model",
display_name="Main model",
- allows_reasoning=True,
+ supports_reasoning=True,
),
ClientModel(
wire_slug="ollama_cloud/qwen3-coder:480b",
provider_model_ref="ollama_cloud/qwen3-coder:480b",
display_name="Colon model",
- allows_reasoning=False,
+ supports_reasoning=False,
),
)
diff --git a/tests/cli/test_cline_launcher.py b/tests/cli/test_cline_launcher.py
index 50664ea1..32f68c69 100644
--- a/tests/cli/test_cline_launcher.py
+++ b/tests/cli/test_cline_launcher.py
@@ -18,6 +18,7 @@ from free_claude_code.cli.launchers.cline_config import (
from free_claude_code.cli.launchers.model_catalog import ClientModel
from free_claude_code.config.settings import Settings
from free_claude_code.core.json_types import JsonObject
+from free_claude_code.core.model_capabilities import ModelInputModality
def _settings(*, token: str = "proxy-token") -> Settings:
@@ -54,13 +55,23 @@ def test_cline_config_uses_responses_and_only_known_metadata() -> None:
wire_slug="nvidia_nim/vendor/model",
provider_model_ref="nvidia_nim/vendor/model",
display_name="Nested model",
- allows_reasoning=True,
+ supports_reasoning=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
),
ClientModel(
wire_slug="claude-3-freecc-no-thinking/open_router/plain-model",
provider_model_ref="open_router/plain-model",
display_name="No-thinking model",
- allows_reasoning=False,
+ supports_reasoning=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ClientModel(
+ wire_slug="future_provider/unknown-model",
+ provider_model_ref="future_provider/unknown-model",
+ display_name="Unknown model",
+ supports_reasoning=None,
),
),
proxy_root_url="http://127.0.0.1:9191/",
@@ -102,14 +113,31 @@ def test_cline_config_uses_responses_and_only_known_metadata() -> None:
"models": {
"nvidia_nim/vendor/model": {
"name": "Nested model",
- "capabilities": ["streaming", "tools", "reasoning"],
+ "capabilities": [
+ "streaming",
+ "tools",
+ "reasoning",
+ "images",
+ ],
"supportsReasoning": True,
+ "supportsVision": True,
+ "inputModalities": ["text", "image"],
+ "outputModalities": ["text"],
"apiFormat": "openai-responses",
},
"claude-3-freecc-no-thinking/open_router/plain-model": {
"name": "No-thinking model",
"capabilities": ["streaming", "tools"],
"supportsReasoning": False,
+ "supportsVision": False,
+ "inputModalities": ["text"],
+ "outputModalities": ["text"],
+ "apiFormat": "openai-responses",
+ },
+ "future_provider/unknown-model": {
+ "name": "Unknown model",
+ "capabilities": ["streaming", "tools", "reasoning"],
+ "supportsReasoning": True,
"apiFormat": "openai-responses",
},
},
diff --git a/tests/cli/test_codex_model_catalog.py b/tests/cli/test_codex_model_catalog.py
index 723185b4..8e8d3ecf 100644
--- a/tests/cli/test_codex_model_catalog.py
+++ b/tests/cli/test_codex_model_catalog.py
@@ -148,6 +148,52 @@ def test_codex_catalog_accepts_direct_provider_slugs_without_a_provider_registry
]
+def test_codex_catalog_projects_known_capabilities_and_preserves_unknown_defaults() -> (
+ None
+):
+ catalog = build_codex_model_catalog(
+ {
+ "data": [
+ {
+ "id": "provider/vision-reasoning",
+ "provider_model_ref": "provider/vision-reasoning",
+ "supportsReasoning": True,
+ "inputModalities": ["text", "image"],
+ },
+ {
+ "id": "claude-3-freecc-no-thinking/provider/text-only",
+ "provider_model_ref": "provider/text-only",
+ "supportsReasoning": False,
+ "inputModalities": ["text"],
+ },
+ {
+ "id": "provider/unknown",
+ "provider_model_ref": "provider/unknown",
+ },
+ ]
+ }
+ )
+
+ vision, text_only, unknown = _catalog_models(catalog)
+ assert vision["input_modalities"] == ["text", "image"]
+ assert vision["default_reasoning_level"] == "medium"
+ assert vision["supported_reasoning_levels"]
+ assert vision["supports_reasoning_summaries"] is True
+ assert vision["default_reasoning_summary"] == "none"
+
+ assert text_only["input_modalities"] == ["text"]
+ assert "default_reasoning_level" not in text_only
+ assert text_only["supported_reasoning_levels"] == []
+ assert text_only["supports_reasoning_summaries"] is False
+ assert "default_reasoning_summary" not in text_only
+
+ assert unknown["input_modalities"] == ["text"]
+ assert unknown["default_reasoning_level"] == "medium"
+ assert unknown["supported_reasoning_levels"]
+ assert unknown["supports_reasoning_summaries"] is True
+ assert unknown["default_reasoning_summary"] == "none"
+
+
def test_launcher_config_composes_with_persistent_codex_config(
tmp_path: Path,
) -> None:
diff --git a/tests/cli/test_dsh_config.py b/tests/cli/test_dsh_config.py
index ef50eef5..b68d9d5f 100644
--- a/tests/cli/test_dsh_config.py
+++ b/tests/cli/test_dsh_config.py
@@ -8,6 +8,7 @@ import pytest
from free_claude_code.cli.launchers.dsh_config import build_dsh_launch_config
from free_claude_code.cli.launchers.model_catalog import ClientModel
+from free_claude_code.core.model_capabilities import ModelInputModality
def _models() -> tuple[ClientModel, ...]:
@@ -16,13 +17,23 @@ def _models() -> tuple[ClientModel, ...]:
wire_slug="nvidia_nim/vendor/model",
provider_model_ref="nvidia_nim/vendor/model",
display_name="Nested model",
- allows_reasoning=True,
+ supports_reasoning=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
),
ClientModel(
wire_slug="claude-3-freecc-no-thinking/open_router/plain-model",
provider_model_ref="open_router/plain-model",
display_name="No-thinking model",
- allows_reasoning=False,
+ supports_reasoning=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ClientModel(
+ wire_slug="future_provider/unknown-model",
+ provider_model_ref="future_provider/unknown-model",
+ display_name="Unknown model",
+ supports_reasoning=None,
),
)
@@ -80,11 +91,26 @@ def test_dsh_config_pins_responses_models_retries_and_private_state(
"xhigh": "xhigh",
"max": "max",
},
+ "input": ["text", "image"],
},
{
"id": "claude-3-freecc-no-thinking/open_router/plain-model",
"name": "No-thinking model",
"reasoningEfforts": False,
+ "input": ["text"],
+ },
+ {
+ "id": "future_provider/unknown-model",
+ "name": "Unknown model",
+ "reasoningEfforts": {
+ "off": "none",
+ "minimal": "minimal",
+ "low": "low",
+ "medium": "medium",
+ "high": "high",
+ "xhigh": "xhigh",
+ "max": "max",
+ },
},
],
"defaultInput": ["text"],
@@ -116,7 +142,6 @@ def test_dsh_config_pins_responses_models_retries_and_private_state(
for unsupported in (
"contextWindow",
"maxTokens",
- "input",
"compat",
"headers",
"telemetry",
diff --git a/tests/cli/test_dsh_launcher.py b/tests/cli/test_dsh_launcher.py
index 8bd28f42..f54e4ae1 100644
--- a/tests/cli/test_dsh_launcher.py
+++ b/tests/cli/test_dsh_launcher.py
@@ -49,7 +49,7 @@ def _models() -> tuple[ClientModel, ...]:
wire_slug="nvidia_nim/vendor/model",
provider_model_ref="nvidia_nim/vendor/model",
display_name="Nested model",
- allows_reasoning=True,
+ supports_reasoning=True,
),
)
diff --git a/tests/cli/test_grok_launcher.py b/tests/cli/test_grok_launcher.py
index 0f565610..86de1daf 100644
--- a/tests/cli/test_grok_launcher.py
+++ b/tests/cli/test_grok_launcher.py
@@ -28,13 +28,13 @@ def _models() -> tuple[ClientModel, ...]:
wire_slug="nvidia_nim/vendor/model",
provider_model_ref="nvidia_nim/vendor/model",
display_name="Nested model",
- allows_reasoning=True,
+ supports_reasoning=True,
),
ClientModel(
wire_slug="claude-3-freecc-no-thinking/open_router/plain-model",
provider_model_ref="open_router/plain-model",
display_name="Plain model",
- allows_reasoning=False,
+ supports_reasoning=False,
),
)
diff --git a/tests/cli/test_hermes_config.py b/tests/cli/test_hermes_config.py
index 3d0b23d5..68a22b18 100644
--- a/tests/cli/test_hermes_config.py
+++ b/tests/cli/test_hermes_config.py
@@ -8,6 +8,7 @@ from free_claude_code.cli.launchers.hermes_config import (
build_hermes_managed_config,
)
from free_claude_code.cli.launchers.model_catalog import ClientModel
+from free_claude_code.core.model_capabilities import ModelInputModality
def _models() -> tuple[ClientModel, ...]:
@@ -16,13 +17,23 @@ def _models() -> tuple[ClientModel, ...]:
wire_slug="nvidia_nim/vendor/model",
provider_model_ref="nvidia_nim/vendor/model",
display_name="Nested model",
- allows_reasoning=True,
+ supports_reasoning=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
),
ClientModel(
wire_slug="claude-3-freecc-no-thinking/open_router/plain-model",
provider_model_ref="open_router/plain-model",
display_name="No-thinking model",
- allows_reasoning=False,
+ supports_reasoning=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ClientModel(
+ wire_slug="future_provider/unknown-model",
+ provider_model_ref="future_provider/unknown-model",
+ display_name="Unknown model",
+ supports_reasoning=None,
),
)
@@ -51,6 +62,7 @@ def test_hermes_config_pins_responses_catalog_and_fallbacks() -> None:
"models": {
"nvidia_nim/vendor/model": {},
"claude-3-freecc-no-thinking/open_router/plain-model": {},
+ "future_provider/unknown-model": {},
},
"discover_models": False,
}
@@ -64,6 +76,18 @@ def test_hermes_config_pins_responses_catalog_and_fallbacks() -> None:
}
assert managed.config["fallback_providers"] == []
assert managed.config["fallback_model"] == []
+ assert managed.config["model_overrides"] == {
+ "custom": {
+ "nvidia_nim/vendor/model": {
+ "supports_reasoning": True,
+ "supports_vision": True,
+ },
+ "claude-3-freecc-no-thinking/open_router/plain-model": {
+ "supports_reasoning": False,
+ "supports_vision": False,
+ },
+ }
+ }
auxiliary = managed.config["auxiliary"]
assert isinstance(auxiliary, dict)
diff --git a/tests/cli/test_hermes_launcher.py b/tests/cli/test_hermes_launcher.py
index 277c7028..e33ce0c5 100644
--- a/tests/cli/test_hermes_launcher.py
+++ b/tests/cli/test_hermes_launcher.py
@@ -50,7 +50,7 @@ def _models() -> tuple[ClientModel, ...]:
wire_slug="nvidia_nim/vendor/model",
provider_model_ref="nvidia_nim/vendor/model",
display_name="Nested model",
- allows_reasoning=True,
+ supports_reasoning=True,
),
)
diff --git a/tests/cli/test_model_catalog.py b/tests/cli/test_model_catalog.py
index ecd1178c..a05e61ff 100644
--- a/tests/cli/test_model_catalog.py
+++ b/tests/cli/test_model_catalog.py
@@ -9,6 +9,7 @@ from free_claude_code.cli.launchers.model_catalog import (
fetch_proxy_models_response,
)
from free_claude_code.core.json_types import JsonObject
+from free_claude_code.core.model_capabilities import ModelInputModality
def test_client_models_project_nested_direct_refs_in_source_order() -> None:
@@ -32,13 +33,13 @@ def test_client_models_project_nested_direct_refs_in_source_order() -> None:
wire_slug="nvidia_nim/nvidia/nemotron-3-super",
provider_model_ref="nvidia_nim/nvidia/nemotron-3-super",
display_name="Display 0",
- allows_reasoning=True,
+ supports_reasoning=None,
),
ClientModel(
wire_slug="open_router/meta-llama/llama-3.3-70b",
provider_model_ref="open_router/meta-llama/llama-3.3-70b",
display_name="Display 1",
- allows_reasoning=True,
+ supports_reasoning=None,
),
)
@@ -51,6 +52,7 @@ def test_client_models_keep_no_thinking_direct_route() -> None:
"id": "claude-3-freecc-no-thinking/nvidia_nim/provider-model",
"provider_model_ref": "nvidia_nim/provider-model",
"display_name": "Display 0",
+ "supportsReasoning": False,
}
]
}
@@ -61,7 +63,7 @@ def test_client_models_keep_no_thinking_direct_route() -> None:
wire_slug="claude-3-freecc-no-thinking/nvidia_nim/provider-model",
provider_model_ref="nvidia_nim/provider-model",
display_name="Display 0",
- allows_reasoning=False,
+ supports_reasoning=False,
),
)
@@ -74,6 +76,7 @@ def test_client_models_keep_no_thinking_only_route() -> None:
"id": "claude-3-freecc-no-thinking/open_router/plain-model",
"provider_model_ref": "open_router/plain-model",
"display_name": "Display 0",
+ "supportsReasoning": False,
}
]
}
@@ -82,11 +85,49 @@ def test_client_models_keep_no_thinking_only_route() -> None:
wire_slug="claude-3-freecc-no-thinking/open_router/plain-model",
provider_model_ref="open_router/plain-model",
display_name="Display 0",
- allows_reasoning=False,
+ supports_reasoning=False,
),
)
+def test_client_models_parse_capabilities_without_deriving_reasoning_from_slug() -> (
+ None
+):
+ models = client_models_from_response(
+ {
+ "data": [
+ {
+ "id": "provider/reasoning",
+ "provider_model_ref": "provider/reasoning",
+ "supportsReasoning": False,
+ "inputModalities": ["text"],
+ },
+ {
+ "id": "claude-3-freecc-no-thinking/provider/unknown",
+ "provider_model_ref": "provider/unknown",
+ "supportsReasoning": "not-a-bool",
+ "inputModalities": ["text", "image"],
+ },
+ {
+ "id": "provider/malformed-media",
+ "provider_model_ref": "provider/malformed-media",
+ "supportsReasoning": True,
+ "inputModalities": ["text", 7],
+ },
+ ]
+ }
+ )
+
+ assert [(model.supports_reasoning, model.input_modalities) for model in models] == [
+ (False, frozenset({ModelInputModality.TEXT})),
+ (
+ None,
+ frozenset({ModelInputModality.TEXT, ModelInputModality.IMAGE}),
+ ),
+ (True, None),
+ ]
+
+
def test_client_models_ignore_compatibility_unknown_and_malformed_entries() -> None:
payload: JsonObject = {
"data": [
@@ -195,7 +236,7 @@ def _client_model(wire_slug: str, provider_model_ref: str) -> ClientModel:
wire_slug=wire_slug,
provider_model_ref=provider_model_ref,
display_name=provider_model_ref,
- allows_reasoning=wire_slug == provider_model_ref,
+ supports_reasoning=wire_slug == provider_model_ref,
)
diff --git a/tests/cli/test_opencode_launcher.py b/tests/cli/test_opencode_launcher.py
index 56c57c14..dac1cd52 100644
--- a/tests/cli/test_opencode_launcher.py
+++ b/tests/cli/test_opencode_launcher.py
@@ -13,6 +13,7 @@ from free_claude_code.cli.launchers.model_catalog import ClientModel
from free_claude_code.cli.launchers.opencode_config import build_opencode_config
from free_claude_code.config.settings import Settings
from free_claude_code.core.json_types import JsonObject
+from free_claude_code.core.model_capabilities import ModelInputModality
def _settings() -> Settings:
@@ -49,13 +50,23 @@ def test_opencode_config_uses_responses_sdk_and_only_known_metadata() -> None:
wire_slug="nvidia_nim/vendor/model",
provider_model_ref="nvidia_nim/vendor/model",
display_name="Nested model",
- allows_reasoning=True,
+ supports_reasoning=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
),
ClientModel(
wire_slug="claude-3-freecc-no-thinking/open_router/plain-model",
provider_model_ref="open_router/plain-model",
display_name="No-thinking model",
- allows_reasoning=False,
+ supports_reasoning=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ClientModel(
+ wire_slug="future_provider/unknown-model",
+ provider_model_ref="future_provider/unknown-model",
+ display_name="Unknown model",
+ supports_reasoning=None,
),
),
proxy_root_url="http://127.0.0.1:9191",
@@ -74,10 +85,16 @@ def test_opencode_config_uses_responses_sdk_and_only_known_metadata() -> None:
"nvidia_nim/vendor/model": {
"name": "Nested model",
"reasoning": True,
+ "modalities": {"input": ["text", "image"]},
},
"claude-3-freecc-no-thinking/open_router/plain-model": {
"name": "No-thinking model",
"reasoning": False,
+ "modalities": {"input": ["text"]},
+ },
+ "future_provider/unknown-model": {
+ "name": "Unknown model",
+ "reasoning": True,
},
}
assert config.overlay == {
diff --git a/tests/cli/test_pi_extension.py b/tests/cli/test_pi_extension.py
new file mode 100644
index 00000000..182fb031
--- /dev/null
+++ b/tests/cli/test_pi_extension.py
@@ -0,0 +1,70 @@
+"""Executable contracts for Pi's bundled TypeScript extension."""
+
+import json
+import shutil
+import subprocess
+
+import pytest
+
+from free_claude_code.cli.launchers.pi import pi_extension_path
+
+
+def test_pi_extension_projects_known_capabilities_and_preserves_unknown_defaults() -> (
+ None
+):
+ node = shutil.which("node")
+ if node is None:
+ pytest.skip("Node.js is not installed")
+
+ payload = {
+ "object": "list",
+ "data": [
+ {
+ "id": "provider/vision-reasoning",
+ "provider_model_ref": "provider/vision-reasoning",
+ "supportsReasoning": True,
+ "inputModalities": ["text", "image"],
+ },
+ {
+ "id": "claude-3-freecc-no-thinking/provider/text-only",
+ "provider_model_ref": "provider/text-only",
+ "supportsReasoning": False,
+ "inputModalities": ["text"],
+ },
+ {
+ "id": "provider/unknown",
+ "provider_model_ref": "provider/unknown",
+ },
+ ],
+ }
+ script = """
+const { projectFccModels } = await import(process.argv[1]);
+const payload = JSON.parse(process.argv[2]);
+console.log(JSON.stringify(projectFccModels(payload)));
+"""
+
+ result = subprocess.run(
+ [
+ node,
+ "--experimental-strip-types",
+ "--input-type=module",
+ "--eval",
+ script,
+ pi_extension_path().as_uri(),
+ json.dumps(payload),
+ ],
+ capture_output=True,
+ check=False,
+ encoding="utf-8",
+ errors="replace",
+ text=True,
+ timeout=10,
+ )
+
+ assert result.returncode == 0, result.stderr
+ projected = json.loads(result.stdout)
+ assert [(model["reasoning"], model["input"]) for model in projected] == [
+ (True, ["text", "image"]),
+ (False, ["text"]),
+ (True, ["text"]),
+ ]
diff --git a/tests/providers/test_chutes.py b/tests/providers/test_chutes.py
index 9d89497c..3a3ce438 100644
--- a/tests/providers/test_chutes.py
+++ b/tests/providers/test_chutes.py
@@ -9,6 +9,7 @@ from openai import AsyncOpenAI
from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.provider_catalog import CHUTES_DEFAULT_BASE
from free_claude_code.core.anthropic.models import MessagesRequest
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningPolicy
from free_claude_code.providers.model_listing import ModelListResponseError
from free_claude_code.providers.openai_chat import OpenAIChatProvider
@@ -131,7 +132,7 @@ async def test_lists_only_semantically_agent_capable_models(
chutes_provider._client.get = AsyncMock(
return_value={
"data": [
- _catalog_model(),
+ _catalog_model(input_modalities=("text", "image")),
_catalog_model(
"plain-agent",
supported_features=("tools",),
@@ -153,8 +154,17 @@ async def test_lists_only_semantically_agent_capable_models(
assert model_infos == frozenset(
{
- ProviderModelInfo(_MODEL, supports_thinking=True),
- ProviderModelInfo("plain-agent"),
+ ProviderModelInfo(
+ _MODEL,
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "plain-agent",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
}
)
@@ -242,7 +252,15 @@ async def test_model_catalog_uses_documented_url_and_bearer_auth(
finally:
await chutes_provider.cleanup()
- assert model_infos == frozenset({ProviderModelInfo(_MODEL, supports_thinking=True)})
+ assert model_infos == frozenset(
+ {
+ ProviderModelInfo(
+ _MODEL,
+ supports_thinking=True,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ )
+ }
+ )
assert len(requests) == 1
assert str(requests[0].url) == "https://llm.chutes.ai/v1/models"
assert requests[0].headers["authorization"] == "Bearer wire-chutes-key"
diff --git a/tests/providers/test_codestral.py b/tests/providers/test_codestral.py
index 83b373c3..6910b0a5 100644
--- a/tests/providers/test_codestral.py
+++ b/tests/providers/test_codestral.py
@@ -4,7 +4,9 @@ from unittest.mock import AsyncMock, MagicMock, patch
import pytest
+from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.provider_catalog import CODESTRAL_DEFAULT_BASE
+from free_claude_code.core.model_capabilities import ModelInputModality
from tests.providers.request_factory import make_messages_request
from tests.providers.support import (
immediate_admission,
@@ -81,6 +83,69 @@ def test_build_request_body_global_disable_blocks_reasoning_mapping():
assert "assistant_reasoning_content" not in roles
+async def test_model_catalog_extracts_exact_input_modalities(codestral_provider):
+ codestral_provider._client.models.list = AsyncMock(
+ return_value={
+ "data": [
+ {
+ "id": "vision-model",
+ "capabilities": {
+ "completion_chat": True,
+ "vision": True,
+ },
+ },
+ {
+ "id": "text-model",
+ "capabilities": {
+ "completion_chat": True,
+ "vision": False,
+ },
+ },
+ ]
+ }
+ )
+
+ assert await codestral_provider.list_model_infos() == frozenset(
+ {
+ ProviderModelInfo(
+ "vision-model",
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "text-model",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ }
+ )
+
+
+ "capabilities",
+ [
+ None,
+ {},
+ {"completion_chat": True},
+ {"completion_chat": True, "vision": "yes"},
+ ],
+)
+async def test_model_catalog_degrades_incomplete_capabilities_to_unknown(
+ codestral_provider,
+ capabilities,
+):
+ model = {"id": "model"}
+ if capabilities is not None:
+ model["capabilities"] = capabilities
+ codestral_provider._client.models.list = AsyncMock(return_value={"data": [model]})
+
+ assert await codestral_provider.list_model_infos() == frozenset(
+ {ProviderModelInfo("model")}
+ )
+
+
@pytest.mark.asyncio
async def test_stream_messages_text(codestral_provider):
"""Text content deltas are emitted as text blocks."""
diff --git a/tests/providers/test_deepinfra.py b/tests/providers/test_deepinfra.py
index b844e987..5d4160f9 100644
--- a/tests/providers/test_deepinfra.py
+++ b/tests/providers/test_deepinfra.py
@@ -313,8 +313,6 @@ async def test_model_catalog_uses_absolute_public_url() -> None:
([_catalog_model(reported_type=_MISSING)], "include reported_type as str"),
([_catalog_model(reported_type=7)], "include reported_type as str"),
([_catalog_model(deprecated=_MISSING)], "include deprecated"),
- ([_catalog_model(tags=_MISSING)], "include tags string array"),
- ([_catalog_model(tags=[7])], "include tags string array"),
([], "did not include any model ids"),
(
[_catalog_model("image", reported_type="text-to-image")],
@@ -338,6 +336,19 @@ async def test_rejects_malformed_or_unusable_catalog_atomically(
await deepinfra_provider.list_model_infos()
[email protected]("tags", [_MISSING, None, [7], "reasoning"])
+async def test_malformed_optional_tags_leave_reasoning_unknown(
+ deepinfra_provider: OpenAIChatProvider,
+ tags: object,
+) -> None:
+ deepinfra_provider._client.get = AsyncMock(return_value=[_catalog_model(tags=tags)])
+
+ assert await deepinfra_provider.list_model_infos() == frozenset(
+ {ProviderModelInfo("model")}
+ )
+
+
@pytest.mark.asyncio
async def test_model_catalog_uses_shared_retry_admission(
deepinfra_provider: OpenAIChatProvider,
diff --git a/tests/providers/test_featherless.py b/tests/providers/test_featherless.py
index 3cf21f6d..e6aaebe6 100644
--- a/tests/providers/test_featherless.py
+++ b/tests/providers/test_featherless.py
@@ -12,6 +12,7 @@ from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
from free_claude_code.config.provider_catalog import FEATHERLESS_DEFAULT_BASE
from free_claude_code.core.anthropic.models import MessagesRequest
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningPolicy
from free_claude_code.providers.model_listing import ModelListResponseError
from free_claude_code.providers.openai_chat import OpenAIChatProvider
@@ -59,10 +60,14 @@ def _catalog_model(
tool_use: object = True,
gated: object = False,
available: object = True,
+ image_input: object = False,
) -> dict[str, object]:
return {
"id": model_id,
- "features": {"tool_use": tool_use},
+ "features": {
+ "tool_use": tool_use,
+ "image_input": image_input,
+ },
"is_gated": gated,
"available_on_current_plan": available,
}
@@ -244,7 +249,7 @@ async def test_catalog_fetches_all_pages_filters_strictly_and_deduplicates_overl
1,
2,
[
- _catalog_model(),
+ _catalog_model(image_input=True),
_catalog_model("gated", gated=True),
_catalog_model("unavailable", available=False),
],
@@ -266,8 +271,16 @@ async def test_catalog_fetches_all_pages_filters_strictly_and_deduplicates_overl
assert model_infos == frozenset(
{
- ProviderModelInfo(_MODEL),
- ProviderModelInfo("plain-agent"),
+ ProviderModelInfo(
+ _MODEL,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "plain-agent",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
}
)
assert featherless_provider._client.get.await_count == 2
@@ -336,6 +349,20 @@ async def test_catalog_validates_overlapping_records_before_deduplicating(
await featherless_provider.list_model_infos()
[email protected]("image_input", [None, "yes", 1, []])
+async def test_catalog_degrades_invalid_optional_image_capability_to_unknown(
+ featherless_provider: OpenAIChatProvider,
+ image_input: object,
+) -> None:
+ model = _catalog_model(image_input=image_input)
+ featherless_provider._client.get = AsyncMock(return_value=_page(1, 1, [model]))
+
+ assert await featherless_provider.list_model_infos() == frozenset(
+ {ProviderModelInfo(_MODEL)}
+ )
+
+
@pytest.mark.parametrize(
("current_page", "total_pages", "message"),
[
@@ -430,7 +457,16 @@ async def test_catalog_uses_documented_url_query_and_bearer_auth(
await featherless_provider.cleanup()
assert model_infos == frozenset(
- {ProviderModelInfo(_MODEL), ProviderModelInfo("second-agent")}
+ {
+ ProviderModelInfo(
+ _MODEL,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ProviderModelInfo(
+ "second-agent",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ }
)
assert len(requests) == 2
assert [request.url.params["page"] for request in requests] == ["1", "2"]
diff --git a/tests/providers/test_huggingface.py b/tests/providers/test_huggingface.py
index 461e9df2..9a39e100 100644
--- a/tests/providers/test_huggingface.py
+++ b/tests/providers/test_huggingface.py
@@ -1,12 +1,15 @@
"""Tests for Hugging Face Inference Providers."""
from dataclasses import replace
+from types import SimpleNamespace
from unittest.mock import AsyncMock, MagicMock, patch
import pytest
+from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.provider_catalog import HUGGINGFACE_DEFAULT_BASE
from free_claude_code.core.anthropic import ReasoningReplayMode
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicy
from tests.providers.request_factory import make_messages_request
from tests.providers.support import (
@@ -65,6 +68,38 @@ def test_init_strips_trailing_slash(huggingface_config):
assert provider._base_url == HUGGINGFACE_DEFAULT_BASE
+async def test_model_catalog_extracts_exact_input_modalities(
+ huggingface_provider,
+) -> None:
+ huggingface_provider._client.models.list = AsyncMock(
+ return_value=SimpleNamespace(
+ data=[
+ {
+ "id": "vision-model",
+ "architecture": {"input_modalities": ["text", "image", "audio"]},
+ },
+ {
+ "id": "unknown-model",
+ "architecture": {"input_modalities": ["image"]},
+ },
+ ]
+ )
+ )
+
+ assert await huggingface_provider.list_model_infos() == frozenset(
+ {
+ ProviderModelInfo(
+ "vision-model",
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo("unknown-model"),
+ }
+ )
+
+
def test_build_request_body_keeps_max_tokens(huggingface_provider):
with patch(
"free_claude_code.providers.openai_chat.request_policy.build_base_request_body"
diff --git a/tests/providers/test_kilo.py b/tests/providers/test_kilo.py
index cd26da8f..11749c6e 100644
--- a/tests/providers/test_kilo.py
+++ b/tests/providers/test_kilo.py
@@ -15,6 +15,7 @@ from free_claude_code.core.anthropic.stream_contracts import (
text_content,
thinking_content,
)
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningPolicy
from free_claude_code.providers.kilo import KiloProvider
from free_claude_code.providers.model_listing import ModelListResponseError
@@ -374,7 +375,10 @@ async def test_model_list_filters_to_chat_tool_models_with_capabilities(kilo_pro
{
"id": "anthropic/tool-reasoning",
"supported_parameters": ["tools", "reasoning"],
- "architecture": {"output_modalities": ["text"]},
+ "architecture": {
+ "input_modalities": ["text", "image"],
+ "output_modalities": ["text"],
+ },
"opencode": {"ai_sdk_provider": "anthropic"},
},
{
@@ -387,6 +391,11 @@ async def test_model_list_filters_to_chat_tool_models_with_capabilities(kilo_pro
"id": "missing-optional-metadata",
"supported_parameters": ["tools"],
},
+ {
+ "id": "malformed-optional-metadata",
+ "supported_parameters": ["tools", 7],
+ "architecture": {"input_modalities": ["text"]},
+ },
{
"id": "chat-only",
"supported_parameters": ["reasoning"],
@@ -411,12 +420,22 @@ async def test_model_list_filters_to_chat_tool_models_with_capabilities(kilo_pro
assert await kilo_provider.list_model_infos() == frozenset(
{
- ProviderModelInfo("anthropic/tool-reasoning", supports_thinking=True),
+ ProviderModelInfo(
+ "anthropic/tool-reasoning",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
ProviderModelInfo("plain-tool", supports_thinking=False),
ProviderModelInfo(
"missing-optional-metadata",
supports_thinking=False,
),
+ ProviderModelInfo(
+ "malformed-optional-metadata",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
}
)
diff --git a/tests/providers/test_llm7.py b/tests/providers/test_llm7.py
index 6ba3a3a7..09524b0b 100644
--- a/tests/providers/test_llm7.py
+++ b/tests/providers/test_llm7.py
@@ -11,6 +11,7 @@ from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKEN
from free_claude_code.config.provider_catalog import LLM7_DEFAULT_BASE
from free_claude_code.core.anthropic.models import MessagesRequest
from free_claude_code.core.json_types import JsonObject, JsonValue
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningPolicy
from free_claude_code.providers.model_listing import ModelListResponseError
from free_claude_code.providers.openai_chat import OpenAIChatProvider
@@ -69,12 +70,14 @@ def _catalog_model(
stream: object = True,
tools_calling: object = True,
reasoning: bool | None = None,
+ input_modalities: object = ("text",),
) -> dict[str, object]:
model: dict[str, object] = {
"id": model_id,
"model_type": model_type,
"stream": stream,
"tools_calling": tools_calling,
+ "modalities": {"input": input_modalities},
}
if reasoning is not None:
model["reasoning"] = reasoning
@@ -175,7 +178,11 @@ async def test_filters_catalog_and_adds_live_authoritative_selectors(
llm7_provider._client.get = AsyncMock(
return_value={
"data": [
- _catalog_model("reasoning-model", reasoning=True),
+ _catalog_model(
+ "reasoning-model",
+ reasoning=True,
+ input_modalities=("text", "image"),
+ ),
_catalog_model("plain-model", reasoning=False),
_catalog_model("unknown-reasoning-model"),
_catalog_model("default", reasoning=True),
@@ -191,10 +198,27 @@ async def test_filters_catalog_and_adds_live_authoritative_selectors(
assert model_infos == frozenset(
{
- ProviderModelInfo("reasoning-model", supports_thinking=True),
- ProviderModelInfo("plain-model", supports_thinking=False),
- ProviderModelInfo("unknown-reasoning-model"),
- ProviderModelInfo("default", supports_thinking=True),
+ ProviderModelInfo(
+ "reasoning-model",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "plain-model",
+ supports_thinking=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ProviderModelInfo(
+ "unknown-reasoning-model",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ProviderModelInfo(
+ "default",
+ supports_thinking=True,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
ProviderModelInfo("fast"),
ProviderModelInfo("pro"),
}
@@ -232,15 +256,24 @@ async def test_rejects_missing_or_wrongly_typed_required_catalog_metadata(
@pytest.mark.asyncio
-async def test_rejects_wrongly_typed_reasoning_metadata(
+async def test_wrongly_typed_optional_reasoning_metadata_is_unknown(
llm7_provider: OpenAIChatProvider,
) -> None:
item = _catalog_model()
item["reasoning"] = "true"
llm7_provider._client.get = AsyncMock(return_value={"data": [item]})
- with pytest.raises(ModelListResponseError, match="reasoning to be boolean"):
- await llm7_provider.list_model_infos()
+ assert await llm7_provider.list_model_infos() == frozenset(
+ {
+ ProviderModelInfo(
+ _MODEL,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ProviderModelInfo("default"),
+ ProviderModelInfo("fast"),
+ ProviderModelInfo("pro"),
+ }
+ )
@pytest.mark.asyncio
@@ -278,7 +311,12 @@ async def test_model_catalog_uses_documented_url_and_bearer_auth(
await llm7_provider.cleanup()
assert model_infos == frozenset(
- {ProviderModelInfo(_MODEL)}
+ {
+ ProviderModelInfo(
+ _MODEL,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ )
+ }
| {ProviderModelInfo(selector) for selector in _SELECTOR_IDS}
)
assert len(requests) == 1
diff --git a/tests/providers/test_mistral.py b/tests/providers/test_mistral.py
index a9571a87..346eaa59 100644
--- a/tests/providers/test_mistral.py
+++ b/tests/providers/test_mistral.py
@@ -7,8 +7,10 @@ import openai
import pytest
from httpx2 import Request, Response
+from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.provider_catalog import MISTRAL_DEFAULT_BASE
from free_claude_code.core.failures import ExecutionFailure
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.providers.mistral import MistralProvider
from tests.providers.request_factory import make_messages_request
from tests.providers.support import (
@@ -53,6 +55,69 @@ def test_default_base_url():
assert MISTRAL_DEFAULT_BASE == "https://api.mistral.ai/v1"
+async def test_model_catalog_extracts_exact_input_modalities(mistral_provider):
+ mistral_provider._client.models.list = AsyncMock(
+ return_value={
+ "data": [
+ {
+ "id": "vision-model",
+ "capabilities": {
+ "completion_chat": True,
+ "vision": True,
+ },
+ },
+ {
+ "id": "text-model",
+ "capabilities": {
+ "completion_chat": True,
+ "vision": False,
+ },
+ },
+ ]
+ }
+ )
+
+ assert await mistral_provider.list_model_infos() == frozenset(
+ {
+ ProviderModelInfo(
+ "vision-model",
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "text-model",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ }
+ )
+
+
+ "capabilities",
+ [
+ None,
+ {},
+ {"completion_chat": True},
+ {"completion_chat": True, "vision": "yes"},
+ ],
+)
+async def test_model_catalog_degrades_incomplete_capabilities_to_unknown(
+ mistral_provider,
+ capabilities,
+):
+ model = {"id": "model"}
+ if capabilities is not None:
+ model["capabilities"] = capabilities
+ mistral_provider._client.models.list = AsyncMock(return_value={"data": [model]})
+
+ assert await mistral_provider.list_model_infos() == frozenset(
+ {ProviderModelInfo("model")}
+ )
+
+
def test_build_request_body_basic(mistral_provider):
"""Basic request body conversion works for Mistral."""
req = make_request()
diff --git a/tests/providers/test_model_discovery.py b/tests/providers/test_model_discovery.py
index 8b8dcdf7..7a817221 100644
--- a/tests/providers/test_model_discovery.py
+++ b/tests/providers/test_model_discovery.py
@@ -640,10 +640,12 @@ def test_runtime_metadata_cache_exposes_ids_and_prefixed_infos() -> None:
assert cache.cached_model_ids() == {
"open_router": frozenset({"reasoning-model", "plain-model"})
}
- assert (
- cache.cached_model_supports_thinking("open_router", "reasoning-model") is True
+ assert cache.cached_model_info(
+ "open_router", "reasoning-model"
+ ) == ProviderModelInfo("reasoning-model", supports_thinking=True)
+ assert cache.cached_model_info("open_router", "plain-model") == ProviderModelInfo(
+ "plain-model", supports_thinking=False
)
- assert cache.cached_model_supports_thinking("open_router", "plain-model") is False
assert cache.cached_prefixed_model_infos() == (
ProviderModelInfo("open_router/plain-model", supports_thinking=False),
ProviderModelInfo("open_router/reasoning-model", supports_thinking=True),
@@ -670,7 +672,9 @@ def test_runtime_metadata_cache_keeps_unknown_thinking_support() -> None:
cache.cache_model_infos("open_router", _infos("plain-model"))
assert cache.cached_model_ids() == {"open_router": frozenset({"plain-model"})}
- assert cache.cached_model_supports_thinking("open_router", "plain-model") is None
+ assert cache.cached_model_info("open_router", "plain-model") == ProviderModelInfo(
+ "plain-model"
+ )
assert cache.cached_prefixed_model_infos() == (
ProviderModelInfo("open_router/plain-model", supports_thinking=None),
)
diff --git a/tests/providers/test_nararoute.py b/tests/providers/test_nararoute.py
new file mode 100644
index 00000000..533604d0
--- /dev/null
+++ b/tests/providers/test_nararoute.py
@@ -0,0 +1,51 @@
+"""Tests for NaraRoute's OpenAI-compatible model catalog."""
+
+from types import SimpleNamespace
+from unittest.mock import AsyncMock
+
+import pytest
+
+from free_claude_code.application.model_metadata import ProviderModelInfo
+from free_claude_code.config.provider_catalog import NARAROUTE_DEFAULT_BASE
+from tests.providers.support import (
+ immediate_admission,
+ make_provider_config,
+ profiled_provider,
+)
+
+
+async def test_model_catalog_extracts_strict_optional_reasoning_boolean() -> None:
+ provider = profiled_provider(
+ "nararoute",
+ make_provider_config(
+ api_key="test-nararoute-key",
+ base_url=NARAROUTE_DEFAULT_BASE,
+ rate_limit=10,
+ rate_window=60,
+ ),
+ admission=immediate_admission(provider_name="nararoute"),
+ )
+ provider._client.models.list = AsyncMock(
+ return_value=SimpleNamespace(
+ data=[
+ {"id": "reasoning", "reasoning": True},
+ {"id": "plain", "reasoning": False},
+ {"id": "unknown"},
+ {"id": "malformed", "reasoning": "true"},
+ ]
+ )
+ )
+ try:
+ infos = await provider.list_model_infos()
+ finally:
+ await provider.cleanup()
+
+ assert infos == frozenset(
+ {
+ ProviderModelInfo("reasoning", supports_thinking=True),
+ ProviderModelInfo("plain", supports_thinking=False),
+ ProviderModelInfo("unknown"),
+ ProviderModelInfo("malformed"),
+ }
+ )
diff --git a/tests/providers/test_nebius.py b/tests/providers/test_nebius.py
index 8e446e2e..dcc708b2 100644
--- a/tests/providers/test_nebius.py
+++ b/tests/providers/test_nebius.py
@@ -10,6 +10,7 @@ from openai import AsyncOpenAI
from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.provider_catalog import NEBIUS_DEFAULT_BASE
from free_claude_code.core.anthropic.models import MessagesRequest
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicy
from free_claude_code.providers.model_listing import ModelListResponseError
from free_claude_code.providers.openai_chat import OpenAIChatProvider
@@ -127,7 +128,14 @@ async def test_lists_only_text_output_models(
model_infos = await nebius_provider.list_model_infos()
- assert model_infos == frozenset({ProviderModelInfo(_MODEL)})
+ assert model_infos == frozenset(
+ {
+ ProviderModelInfo(
+ _MODEL,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ )
+ }
+ )
nebius_provider._client.get.assert_awaited_once_with(
"/models",
cast_to=object,
@@ -216,7 +224,14 @@ async def test_model_catalog_uses_documented_url_auth_and_verbose_query(
finally:
await nebius_provider.cleanup()
- assert model_infos == frozenset({ProviderModelInfo(_MODEL)})
+ assert model_infos == frozenset(
+ {
+ ProviderModelInfo(
+ _MODEL,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ )
+ }
+ )
assert len(requests) == 1
assert str(requests[0].url) == (
"https://api.tokenfactory.nebius.com/v1/models?verbose=true"
diff --git a/tests/providers/test_open_router.py b/tests/providers/test_open_router.py
index df0ac23d..e31ece72 100644
--- a/tests/providers/test_open_router.py
+++ b/tests/providers/test_open_router.py
@@ -7,6 +7,7 @@ from unittest.mock import AsyncMock, MagicMock, patch
import pytest
from free_claude_code.application.errors import InvalidRequestError
+from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
from free_claude_code.core.anthropic.models import MessagesRequest
from free_claude_code.core.anthropic.stream_contracts import (
@@ -14,6 +15,7 @@ from free_claude_code.core.anthropic.stream_contracts import (
text_content,
thinking_content,
)
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.providers.open_router import OpenRouterProvider
from free_claude_code.providers.openai_chat import OpenAIChatProvider
from tests.providers.request_factory import make_messages_request
@@ -341,6 +343,12 @@ async def test_model_infos_filter_tool_models_and_thinking_metadata(
SimpleNamespace(
id="tool-model",
supported_parameters=["tools", "reasoning"],
+ architecture=SimpleNamespace(input_modalities=["text", "image"]),
+ ),
+ SimpleNamespace(
+ id="tool-model-with-malformed-capabilities",
+ supported_parameters=["tools", 7],
+ architecture=SimpleNamespace(input_modalities=["text"]),
),
SimpleNamespace(id="plain-model", supported_parameters=[]),
]
@@ -349,9 +357,21 @@ async def test_model_infos_filter_tool_models_and_thinking_metadata(
infos = await open_router_provider.list_model_infos()
- assert {(info.model_id, info.supports_thinking) for info in infos} == {
- ("tool-model", True)
- }
+ assert infos == frozenset(
+ {
+ ProviderModelInfo(
+ "tool-model",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "tool-model-with-malformed-capabilities",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ }
+ )
@pytest.mark.asyncio
diff --git a/tests/providers/test_openai_codex_provider.py b/tests/providers/test_openai_codex_provider.py
index 746cb797..5606f57d 100644
--- a/tests/providers/test_openai_codex_provider.py
+++ b/tests/providers/test_openai_codex_provider.py
@@ -8,6 +8,7 @@ import httpx
import pytest
from free_claude_code.application.errors import InvalidRequestError
+from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.core.anthropic.models import MessagesRequest
from free_claude_code.core.anthropic.stream_contracts import (
assert_anthropic_stream_contract,
@@ -16,6 +17,7 @@ from free_claude_code.core.anthropic.stream_contracts import (
)
from free_claude_code.core.diagnostics import ERROR_DETAIL_DISPLAY_CAP_BYTES
from free_claude_code.core.failures import ExecutionFailure
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.openai_responses import OpenAIResponsesRequest
from free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicy
from free_claude_code.providers.admission import ProviderAdmissionController
@@ -194,6 +196,17 @@ async def test_provider_uses_subscription_headers_and_visible_model_catalog() ->
"visibility": "list",
"supported_in_api": False,
"supported_reasoning_levels": [{"effort": "high"}],
+ "input_modalities": ["text", "image"],
+ },
+ {
+ "slug": "gpt-no-reasoning",
+ "visibility": "list",
+ "supported_reasoning_levels": [],
+ },
+ {
+ "slug": "gpt-malformed-reasoning",
+ "visibility": "list",
+ "supported_reasoning_levels": [None],
},
{"slug": "gpt-hidden", "visibility": "hide"},
]
@@ -227,9 +240,19 @@ async def test_provider_uses_subscription_headers_and_visible_model_catalog() ->
)
)
- assert {(info.model_id, info.supports_thinking) for info in infos} == {
- ("gpt-visible", True)
- }
+ assert infos == frozenset(
+ {
+ ProviderModelInfo(
+ "gpt-visible",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo("gpt-no-reasoning", supports_thinking=False),
+ ProviderModelInfo("gpt-malformed-reasoning"),
+ }
+ )
response_request = requests[-1]
assert response_request.headers["authorization"] == "Bearer access_1"
assert response_request.headers["chatgpt-account-id"] == "account_1"
diff --git a/tests/providers/test_openai_model_listing_filters.py b/tests/providers/test_openai_model_listing_filters.py
index aef12129..98c292a7 100644
--- a/tests/providers/test_openai_model_listing_filters.py
+++ b/tests/providers/test_openai_model_listing_filters.py
@@ -3,10 +3,12 @@
import pytest
from free_claude_code.application.model_metadata import ProviderModelInfo
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.providers.model_listing import (
ModelListResponseError,
RequiredPathValues,
extract_openai_model_infos,
+ extract_tool_capable_model_infos,
)
@@ -86,3 +88,140 @@ def test_duplicate_model_ids_preserve_first_validated_capability() -> None:
assert model_infos == frozenset(
{ProviderModelInfo("overlap", supports_thinking=True)}
)
+
+
+def test_optional_model_capabilities_are_normalized_and_copied_to_aliases() -> None:
+ model_infos = extract_openai_model_infos(
+ {
+ "data": [
+ {
+ "id": "vision-reasoning",
+ "aliases": ["latest"],
+ "architecture": {"input_modalities": ["text", "image", "audio"]},
+ "supported_parameters": ["tools", "reasoning"],
+ },
+ {
+ "id": "text-only",
+ "aliases": [],
+ "architecture": {"input_modalities": ["text"]},
+ "supported_parameters": ["tools"],
+ },
+ ]
+ },
+ provider_name="TEST",
+ aliases_field="aliases",
+ input_modalities_path=("architecture", "input_modalities"),
+ thinking_sequence_path=("supported_parameters",),
+ )
+
+ vision = ProviderModelInfo(
+ "vision-reasoning",
+ supports_thinking=True,
+ input_modalities=frozenset({ModelInputModality.TEXT, ModelInputModality.IMAGE}),
+ )
+ assert model_infos == frozenset(
+ {
+ vision,
+ ProviderModelInfo(
+ "latest",
+ supports_thinking=True,
+ input_modalities=vision.input_modalities,
+ ),
+ ProviderModelInfo(
+ "text-only",
+ supports_thinking=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ }
+ )
+
+
+ ("field", "value", "expected"),
+ [
+ ("modalities", ["image"], (True, None)),
+ ("modalities", "text", (True, None)),
+ ("reasoning", "true", (None, frozenset({ModelInputModality.TEXT}))),
+ ("reasoning", ["reasoning", 7], (None, frozenset({ModelInputModality.TEXT}))),
+ ],
+)
+def test_malformed_optional_capability_degrades_only_that_field(
+ field: str,
+ value: object,
+ expected: tuple[bool | None, frozenset[ModelInputModality] | None],
+) -> None:
+ item: dict[str, object] = {
+ "id": "model",
+ "architecture": {"input_modalities": ["text"]},
+ "supported_parameters": ["reasoning"],
+ }
+ if field == "modalities":
+ item["architecture"] = {"input_modalities": value}
+ else:
+ item["supported_parameters"] = value
+
+ [info] = extract_openai_model_infos(
+ {"data": [item]},
+ provider_name="TEST",
+ input_modalities_path=("architecture", "input_modalities"),
+ thinking_sequence_path=("supported_parameters",),
+ )
+
+ assert (info.supports_thinking, info.input_modalities) == expected
+
+
+def test_malformed_optional_boolean_and_tags_are_unknown_not_catalog_failures() -> None:
+ boolean_info = next(
+ iter(
+ extract_openai_model_infos(
+ {"data": [{"id": "model", "capabilities": {"reasoning": "yes"}}]},
+ provider_name="TEST",
+ thinking_boolean_path=("capabilities", "reasoning"),
+ )
+ )
+ )
+ tags_info = next(
+ iter(
+ extract_openai_model_infos(
+ {"data": [{"id": "model", "tags": ["reasoning", 7]}]},
+ provider_name="TEST",
+ tags_field="tags",
+ )
+ )
+ )
+
+ assert boolean_info.supports_thinking is None
+ assert tags_info.supports_thinking is None
+
+
+def test_tool_capable_parser_retains_exact_input_modalities() -> None:
+ infos = extract_tool_capable_model_infos(
+ {
+ "data": [
+ {
+ "id": "vision",
+ "supported_parameters": ["tools", "reasoning"],
+ "architecture": {"input_modalities": ["text", "image", "audio"]},
+ },
+ {
+ "id": "unknown-media",
+ "supported_parameters": ["tool_choice"],
+ "architecture": {"input_modalities": "text"},
+ },
+ ]
+ },
+ provider_name="TEST",
+ )
+
+ assert infos == frozenset(
+ {
+ ProviderModelInfo(
+ "vision",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo("unknown-media", supports_thinking=False),
+ }
+ )
diff --git a/tests/providers/test_opencode.py b/tests/providers/test_opencode.py
index 43b943aa..fd4f78a0 100644
--- a/tests/providers/test_opencode.py
+++ b/tests/providers/test_opencode.py
@@ -27,6 +27,7 @@ from free_claude_code.core.anthropic.stream_contracts import (
text_content,
)
from free_claude_code.core.failures import ExecutionFailure
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.openai_responses import OpenAIResponsesRequest
from free_claude_code.core.reasoning import DEFAULT_REASONING_POLICY
from free_claude_code.providers.model_listing import ModelListResponseError
@@ -324,12 +325,17 @@ def test_catalog_resolves_package_precedence_status_alias_and_reasoning() -> Non
snapshot = parse_open_code_catalog(
_catalog_payload(
{
- "provider-default": {"id": "provider-default", "reasoning": False},
+ "provider-default": {
+ "id": "provider-default",
+ "reasoning": False,
+ "modalities": {"input": ["text"]},
+ },
"responses-alias": {
"id": "actual-responses-id",
"provider": {"npm": "@ai-sdk/openai"},
"status": "beta",
"reasoning": True,
+ "modalities": {"input": ["text", "image"]},
},
"anthropic": {
"id": "anthropic-id",
@@ -372,8 +378,18 @@ def test_catalog_resolves_package_precedence_status_alias_and_reasoning() -> Non
assert route.transport is OpenCodeUpstreamTransport.CHAT_COMPLETIONS
assert snapshot.model_infos == frozenset(
{
- ProviderModelInfo("provider-default", supports_thinking=False),
- ProviderModelInfo("responses-alias", supports_thinking=True),
+ ProviderModelInfo(
+ "provider-default",
+ supports_thinking=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ProviderModelInfo(
+ "responses-alias",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
ProviderModelInfo("anthropic"),
ProviderModelInfo("google"),
ProviderModelInfo("unknown-package"),
@@ -404,7 +420,6 @@ def test_catalog_defaults_missing_package_to_chat_completions() -> None:
(_catalog_payload({" ": {"id": "x"}}), "model selector"),
(_catalog_payload({"x": {"id": " "}}), "model 'x' id"),
(_catalog_payload({"x": {"id": "x", "status": "future"}}), "status"),
- (_catalog_payload({"x": {"id": "x", "reasoning": "yes"}}), "reasoning"),
(
_catalog_payload({"x": {"id": "x", "provider": {"npm": " "}}}),
"provider npm",
@@ -427,6 +442,24 @@ def test_catalog_rejects_malformed_route_critical_data(
)
+def test_catalog_degrades_malformed_optional_capabilities_to_unknown() -> None:
+ snapshot = parse_open_code_catalog(
+ _catalog_payload(
+ {
+ "x": {
+ "id": "x",
+ "reasoning": "yes",
+ "modalities": {"input": ["text", 7]},
+ }
+ }
+ ),
+ provider_key="opencode",
+ provider_name="OPENCODE_ZEN",
+ )
+
+ assert snapshot.model_infos == frozenset({ProviderModelInfo("x")})
+
+
def test_catalog_rejects_duplicate_normalized_selectors() -> None:
with pytest.raises(ModelListResponseError, match="duplicate normalized"):
parse_open_code_catalog(
diff --git a/tests/providers/test_vercel.py b/tests/providers/test_vercel.py
index 6c245ff2..8dfba9f1 100644
--- a/tests/providers/test_vercel.py
+++ b/tests/providers/test_vercel.py
@@ -1,11 +1,14 @@
"""Tests for Vercel AI Gateway provider."""
from dataclasses import replace
+from types import SimpleNamespace
from unittest.mock import AsyncMock, MagicMock, patch
import pytest
+from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.provider_catalog import VERCEL_AI_GATEWAY_DEFAULT_BASE
+from free_claude_code.core.model_capabilities import ModelInputModality
from tests.providers.request_factory import make_messages_request
from tests.providers.support import (
immediate_admission,
@@ -69,6 +72,51 @@ def test_init_strips_trailing_slash(vercel_config):
assert provider._base_url == VERCEL_AI_GATEWAY_DEFAULT_BASE
+async def test_model_catalog_extracts_modalities_and_exhaustive_reasoning_support(
+ vercel_provider,
+) -> None:
+ vercel_provider._client.models.list = AsyncMock(
+ return_value=SimpleNamespace(
+ data=[
+ {
+ "id": "vision-reasoning",
+ "modalities": {"input": ["text", "image"]},
+ "supported_parameters": ["tools", "reasoning"],
+ },
+ {
+ "id": "text-only",
+ "modalities": {"input": ["text"]},
+ "supported_parameters": ["tools"],
+ },
+ {
+ "id": "malformed-optional",
+ "modalities": {"input": "text"},
+ "supported_parameters": "reasoning",
+ },
+ ]
+ )
+ )
+
+ assert await vercel_provider.list_model_infos() == frozenset(
+ {
+ ProviderModelInfo(
+ "vision-reasoning",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "text-only",
+ supports_thinking=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ProviderModelInfo("malformed-optional"),
+ }
+ )
+
+
def test_build_request_body_keeps_max_tokens(vercel_provider):
with patch(
"free_claude_code.providers.openai_chat.request_policy.build_base_request_body"
diff --git a/tests/providers/test_xai.py b/tests/providers/test_xai.py
index fe3caabd..8c156250 100644
--- a/tests/providers/test_xai.py
+++ b/tests/providers/test_xai.py
@@ -12,6 +12,7 @@ from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
from free_claude_code.config.provider_catalog import XAI_DEFAULT_BASE
from free_claude_code.core.anthropic.models import MessagesRequest
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.providers.model_listing import ModelListResponseError
from free_claude_code.providers.openai_chat import OpenAIChatProvider
from tests.providers.support import (
@@ -163,8 +164,13 @@ async def test_lists_language_models_and_routable_aliases(
{
"id": "latest",
"aliases": ["grok-4.5", "grok-latest"],
+ "input_modalities": ["text", "image"],
+ },
+ {
+ "id": "grok-4.5",
+ "aliases": [],
+ "input_modalities": ["text"],
},
- {"id": "grok-4.5", "aliases": []},
]
}
)
@@ -174,9 +180,24 @@ async def test_lists_language_models_and_routable_aliases(
assert model_infos == frozenset(
{
- ProviderModelInfo("latest"),
- ProviderModelInfo("grok-4.5"),
- ProviderModelInfo("grok-latest"),
+ ProviderModelInfo(
+ "latest",
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "grok-4.5",
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "grok-latest",
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
}
)
xai_provider._client.get.assert_awaited_once_with(
diff --git a/tests/providers/test_zenmux.py b/tests/providers/test_zenmux.py
index 8621a42e..e2b0a3e3 100644
--- a/tests/providers/test_zenmux.py
+++ b/tests/providers/test_zenmux.py
@@ -18,6 +18,7 @@ from free_claude_code.core.anthropic.stream_contracts import (
text_content,
thinking_content,
)
+from free_claude_code.core.model_capabilities import ModelInputModality
from free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicy
from free_claude_code.providers.model_listing import ModelListResponseError
from free_claude_code.providers.openai_chat import OpenAIChatProvider
@@ -392,9 +393,22 @@ async def test_model_catalog_filters_modalities_and_maps_reasoning_capability(
assert model_infos == frozenset(
{
- ProviderModelInfo("reasoning-chat", supports_thinking=True),
- ProviderModelInfo("plain-chat", supports_thinking=False),
- ProviderModelInfo("unknown-chat"),
+ ProviderModelInfo(
+ "reasoning-chat",
+ supports_thinking=True,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ ProviderModelInfo(
+ "plain-chat",
+ supports_thinking=False,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
+ ProviderModelInfo(
+ "unknown-chat",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ ),
}
)
@@ -453,6 +467,7 @@ async def test_model_catalog_uses_documented_endpoint_and_auth() -> None:
ProviderModelInfo(
"deepseek/deepseek-v4-flash-free",
supports_thinking=True,
+ input_modalities=frozenset({ModelInputModality.TEXT}),
)
}
)
@@ -481,15 +496,6 @@ async def test_model_catalog_uses_documented_endpoint_and_auth() -> None:
},
"output_modalities string array",
),
- (
- {
- "id": "bad-reasoning-capability",
- "input_modalities": ["text"],
- "output_modalities": ["text"],
- "capabilities": {"reasoning": "yes"},
- },
- "capabilities.reasoning to be boolean",
- ),
],
)
@pytest.mark.asyncio
@@ -510,3 +516,35 @@ async def test_model_catalog_rejects_malformed_documented_fields(
pytest.raises(ModelListResponseError, match=message),
):
await zenmux_provider.list_model_infos()
+
+
+async def test_model_catalog_degrades_malformed_optional_reasoning_to_unknown(
+ zenmux_provider: OpenAIChatProvider,
+) -> None:
+ payload = SimpleNamespace(
+ data=[
+ {
+ "id": "bad-reasoning-capability",
+ "input_modalities": ["text"],
+ "output_modalities": ["text"],
+ "capabilities": {"reasoning": "yes"},
+ }
+ ]
+ )
+ with patch.object(
+ zenmux_provider._client.models,
+ "list",
+ new_callable=AsyncMock,
+ return_value=payload,
+ ):
+ infos = await zenmux_provider.list_model_infos()
+
+ assert infos == frozenset(
+ {
+ ProviderModelInfo(
+ "bad-reasoning-capability",
+ input_modalities=frozenset({ModelInputModality.TEXT}),
+ )
+ }
+ )
diff --git a/tests/runtime/test_codex_catalog.py b/tests/runtime/test_codex_catalog.py
index 9b3d6bd5..81cc68c1 100644
--- a/tests/runtime/test_codex_catalog.py
+++ b/tests/runtime/test_codex_catalog.py
@@ -29,9 +29,10 @@ class FakeRequestRuntime(RequestRuntimePort):
def current_settings(self) -> Settings:
return self._settings
- def cached_model_supports_thinking(
+ def cached_model_info(
self, provider_id: str, model_id: str
- ) -> bool | None:
+ ) -> ProviderModelInfo | None:
+ del provider_id, model_id
return None
def cached_prefixed_model_infos(self) -> tuple[ProviderModelInfo, ...]:
diff --git a/tests/runtime/test_model_cache.py b/tests/runtime/test_model_cache.py
new file mode 100644
index 00000000..477f1fda
--- /dev/null
+++ b/tests/runtime/test_model_cache.py
@@ -0,0 +1,26 @@
+from free_claude_code.application.model_metadata import ProviderModelInfo
+from free_claude_code.core.model_capabilities import ModelInputModality
+from free_claude_code.providers.runtime.model_cache import ProviderModelCache
+
+
+def test_model_cache_returns_and_prefixes_complete_model_metadata() -> None:
+ cache = ProviderModelCache(("open_router",))
+ info = ProviderModelInfo(
+ model_id="vendor/model",
+ supports_thinking=False,
+ input_modalities=frozenset({ModelInputModality.TEXT, ModelInputModality.IMAGE}),
+ )
+
+ cache.cache_model_infos("open_router", (info,))
+
+ assert cache.cached_model_info("open_router", "vendor/model") == info
+ assert cache.cached_model_info("open_router", "missing") is None
+ assert cache.cached_prefixed_model_infos() == (
+ ProviderModelInfo(
+ model_id="open_router/vendor/model",
+ supports_thinking=False,
+ input_modalities=frozenset(
+ {ModelInputModality.TEXT, ModelInputModality.IMAGE}
+ ),
+ ),
+ )
diff --git a/tests/runtime/test_provider_manager.py b/tests/runtime/test_provider_manager.py
index 5ad2c2b2..21331474 100644
--- a/tests/runtime/test_provider_manager.py
+++ b/tests/runtime/test_provider_manager.py
@@ -790,7 +790,10 @@ async def test_application_catalog_survives_generation_replacement() -> None:
)
assert manager.cached_model_ids() == {"lmstudio": frozenset({"persisted"})}
- assert manager.cached_model_supports_thinking("lmstudio", "persisted") is True
+ assert manager.cached_model_info("lmstudio", "persisted") == ProviderModelInfo(
+ "persisted",
+ supports_thinking=True,
+ )
await manager.close()
diff --git a/uv.lock b/uv.lock
index 2deae094..2033b1e7 100644
--- a/uv.lock
+++ b/uv.lock
@@ -607,7 +607,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "5.15.10"
+version = "5.16.0"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },