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.tomlindex 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.pyindex 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 ModelInputModalityDISCOVERED_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: strsupports_thinking: bool | None+ input_modalities: frozenset[ModelInputModality] | Nonedef 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:continueseen.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_SECONDSdiff --git a/src/free_claude_code/application/model_metadata.py b/src/free_claude_code/application/model_metadata.pyindex 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: strsupports_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.pyindex 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.pyindex 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 refrom dataclasses import dataclass, fieldfrom free_claude_code.core.json_types import JsonObject+from free_claude_code.core.model_capabilities import ModelInputModalityfrom .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 metadatadiff --git a/src/free_claude_code/cli/launchers/cline_config.py b/src/free_claude_code/cli/launchers/cline_config.pyindex 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, fieldfrom datetime import UTC, datetimefrom free_claude_code.core.json_types import JsonObject+from free_claude_code.core.model_capabilities import ModelInputModalityfrom .common import proxy_v1_urlfrom .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 entrydiff --git a/src/free_claude_code/cli/launchers/codex_model_catalog.py b/src/free_claude_code/cli/launchers/codex_model_catalog.pyindex 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 Mappingfrom pathlib import Pathfrom free_claude_code.core.json_types import JsonObject, JsonValue+from free_claude_code.core.model_capabilities import ModelInputModalityfrom .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 entrydiff --git a/src/free_claude_code/cli/launchers/dsh_config.py b/src/free_claude_code/cli/launchers/dsh_config.pyindex 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, fieldfrom pathlib import Pathfrom free_claude_code.core.json_types import JsonObject+from free_claude_code.core.model_capabilities import ModelInputModalityfrom .common import proxy_v1_urlfrom .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 profilediff --git a/src/free_claude_code/cli/launchers/hermes_config.py b/src/free_claude_code/cli/launchers/hermes_config.pyindex 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, fieldfrom free_claude_code.core.json_types import JsonObject+from free_claude_code.core.model_capabilities import ModelInputModalityfrom .common import proxy_v1_urlfrom .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"] = Falsereturn 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 overridediff --git a/src/free_claude_code/cli/launchers/model_catalog.py b/src/free_claude_code/cli/launchers/model_catalog.pyindex 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 Requestfrom free_claude_code.cli.local_http import open_local_requestfrom free_claude_code.core.json_types import JsonObject, JsonValue+from free_claude_code.core.model_capabilities import ModelInputModalityfrom .common import PROXY_PREFLIGHT_TIMEOUT_SECONDS@@ -19,7 +20,8 @@ class ClientModel:wire_slug: strprovider_model_ref: strdisplay_name: str- allows_reasoning: bool+ supports_reasoning: bool | None+ input_modalities: frozenset[ModelInputModality] | None = Nonedef 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.pyindex 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 dataclassfrom free_claude_code.core.json_types import JsonObject+from free_claude_code.core.model_capabilities import ModelInputModalityfrom .common import proxy_v1_urlfrom .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 configdiff --git a/src/free_claude_code/cli/launchers/pi_extension.ts b/src/free_claude_code/cli/launchers/pi_extension.tsindex 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.pynew file mode 100644index 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.pyindex 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 Anyfrom loguru import loggerfrom free_claude_code.core.anthropic import ReasoningReplayMode+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.core.reasoning import ReasoningPolicyfrom free_claude_code.providers.admission import ProviderAdmissionControllerfrom 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.pyindex 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, TypeIsfrom free_claude_code.application.model_metadata import (ProviderModelInfo as _ProviderModelInfo,)+from free_claude_code.core.model_capabilities import ModelInputModalitytype ModelListScalar = str | booltype 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 = Noneif 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 = Falseif 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__.pyindex 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, OpenAIModelListingfrom .provider import OpenAIAsyncCredentialProvider, OpenAIChatProviderfrom .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.pyindex 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 InvalidRequestErrorfrom free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENSfrom free_claude_code.core.anthropic import ReasoningReplayModefrom free_claude_code.core.anthropic.models import MessagesRequest+from free_claude_code.core.model_capabilities import ModelInputModalityfrom 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_urlfrom .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 = Nonethinking_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.pyindex 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_infosdiff --git a/src/free_claude_code/providers/openai_codex/provider.py b/src/free_claude_code/providers/openai_codex/provider.pyindex 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_modalitiesfrom 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.pyindex 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 MappingProxyTypeimport httpxfrom free_claude_code.application.model_metadata import ProviderModelInfo+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.providers.admission import (ProviderAdmissionController,ProviderOperationKind,)from free_claude_code.providers.base import ProviderConfigfrom 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: strtransport: OpenCodeUpstreamTransportsupports_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_PACKAGEroute = 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 Nonedef _model_status(diff --git a/src/free_claude_code/providers/runtime/model_cache.py b/src/free_claude_code/providers/runtime/model_cache.pyindex 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 replacefrom free_claude_code.application.model_metadata import ProviderModelInfofrom 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.pyindex 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.pyindex 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 TestClientfrom free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.config.settings import Settings+from free_claude_code.core.model_capabilities import ModelInputModalityfrom 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.pyindex 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_idreturn Nonediff --git a/tests/application/test_model_metadata.py b/tests/application/test_model_metadata.pynew file mode 100644index 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.pyindex 513846c6..407efb1d 100644--- a/tests/cli/test_aider_config.py+++ b/tests/cli/test_aider_config.py@@ -6,6 +6,7 @@ import pytestfrom free_claude_code.cli.launchers.aider_config import build_aider_configfrom free_claude_code.cli.launchers.model_catalog import ClientModel+from free_claude_code.core.model_capabilities import ModelInputModalitydef _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 serializeddiff --git a/tests/cli/test_aider_launcher.py b/tests/cli/test_aider_launcher.pyindex 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.pyindex 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 ClientModelfrom free_claude_code.config.settings import Settingsfrom free_claude_code.core.json_types import JsonObject+from free_claude_code.core.model_capabilities import ModelInputModalitydef _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.pyindex 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.pyindex ef50eef5..b68d9d5f 100644--- a/tests/cli/test_dsh_config.py+++ b/tests/cli/test_dsh_config.py@@ -8,6 +8,7 @@ import pytestfrom free_claude_code.cli.launchers.dsh_config import build_dsh_launch_configfrom free_claude_code.cli.launchers.model_catalog import ClientModel+from free_claude_code.core.model_capabilities import ModelInputModalitydef _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.pyindex 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.pyindex 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.pyindex 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 ModelInputModalitydef _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.pyindex 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.pyindex 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 ModelInputModalitydef 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.pyindex 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 ClientModelfrom free_claude_code.cli.launchers.opencode_config import build_opencode_configfrom free_claude_code.config.settings import Settingsfrom free_claude_code.core.json_types import JsonObject+from free_claude_code.core.model_capabilities import ModelInputModalitydef _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.pynew file mode 100644index 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.pyindex 9d89497c..3a3ce438 100644--- a/tests/providers/test_chutes.py+++ b/tests/providers/test_chutes.py@@ -9,6 +9,7 @@ from openai import AsyncOpenAIfrom free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.config.provider_catalog import CHUTES_DEFAULT_BASEfrom free_claude_code.core.anthropic.models import MessagesRequest+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.core.reasoning import ReasoningPolicyfrom free_claude_code.providers.model_listing import ModelListResponseErrorfrom 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) == 1assert 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.pyindex 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, patchimport pytest+from free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.config.provider_catalog import CODESTRAL_DEFAULT_BASE+from free_claude_code.core.model_capabilities import ModelInputModalityfrom tests.providers.request_factory import make_messages_requestfrom 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.asyncioasync 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.pyindex 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.asyncioasync def test_model_catalog_uses_shared_retry_admission(deepinfra_provider: OpenAIChatProvider,diff --git a/tests/providers/test_featherless.py b/tests/providers/test_featherless.pyindex 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 ProviderModelInfofrom free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENSfrom free_claude_code.config.provider_catalog import FEATHERLESS_DEFAULT_BASEfrom free_claude_code.core.anthropic.models import MessagesRequest+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.core.reasoning import ReasoningPolicyfrom free_claude_code.providers.model_listing import ModelListResponseErrorfrom 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_overl1,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_overlassert 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) == 2assert [request.url.params["page"] for request in requests] == ["1", "2"]diff --git a/tests/providers/test_huggingface.py b/tests/providers/test_huggingface.pyindex 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 SimpleNamespacefrom unittest.mock import AsyncMock, MagicMock, patchimport pytest+from free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.config.provider_catalog import HUGGINGFACE_DEFAULT_BASEfrom free_claude_code.core.anthropic import ReasoningReplayMode+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicyfrom tests.providers.request_factory import make_messages_requestfrom 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.pyindex 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 ModelInputModalityfrom free_claude_code.core.reasoning import ReasoningPolicyfrom free_claude_code.providers.kilo import KiloProviderfrom 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_proassert 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.pyindex 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_TOKENfrom free_claude_code.config.provider_catalog import LLM7_DEFAULT_BASEfrom free_claude_code.core.anthropic.models import MessagesRequestfrom free_claude_code.core.json_types import JsonObject, JsonValue+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.core.reasoning import ReasoningPolicyfrom free_claude_code.providers.model_listing import ModelListResponseErrorfrom 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) == 1diff --git a/tests/providers/test_mistral.py b/tests/providers/test_mistral.pyindex a9571a87..346eaa59 100644--- a/tests/providers/test_mistral.py+++ b/tests/providers/test_mistral.py@@ -7,8 +7,10 @@ import openaiimport pytestfrom httpx2 import Request, Response+from free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.config.provider_catalog import MISTRAL_DEFAULT_BASEfrom free_claude_code.core.failures import ExecutionFailure+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.providers.mistral import MistralProviderfrom tests.providers.request_factory import make_messages_requestfrom 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.pyindex 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 Falseassert 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.pynew file mode 100644index 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.pyindex 8e446e2e..dcc708b2 100644--- a/tests/providers/test_nebius.py+++ b/tests/providers/test_nebius.py@@ -10,6 +10,7 @@ from openai import AsyncOpenAIfrom free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.config.provider_catalog import NEBIUS_DEFAULT_BASEfrom free_claude_code.core.anthropic.models import MessagesRequest+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicyfrom free_claude_code.providers.model_listing import ModelListResponseErrorfrom 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) == 1assert 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.pyindex 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, patchimport pytestfrom free_claude_code.application.errors import InvalidRequestError+from free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENSfrom free_claude_code.core.anthropic.models import MessagesRequestfrom 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 ModelInputModalityfrom free_claude_code.providers.open_router import OpenRouterProviderfrom free_claude_code.providers.openai_chat import OpenAIChatProviderfrom 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.asynciodiff --git a/tests/providers/test_openai_codex_provider.py b/tests/providers/test_openai_codex_provider.pyindex 746cb797..5606f57d 100644--- a/tests/providers/test_openai_codex_provider.py+++ b/tests/providers/test_openai_codex_provider.py@@ -8,6 +8,7 @@ import httpximport pytestfrom free_claude_code.application.errors import InvalidRequestError+from free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.core.anthropic.models import MessagesRequestfrom 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_BYTESfrom free_claude_code.core.failures import ExecutionFailure+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.core.openai_responses import OpenAIResponsesRequestfrom free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicyfrom 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.pyindex 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 pytestfrom free_claude_code.application.model_metadata import ProviderModelInfo+from free_claude_code.core.model_capabilities import ModelInputModalityfrom 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.pyindex 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 ModelInputModalityfrom free_claude_code.core.openai_responses import OpenAIResponsesRequestfrom free_claude_code.core.reasoning import DEFAULT_REASONING_POLICYfrom free_claude_code.providers.model_listing import ModelListResponseError@@ -324,12 +325,17 @@ def test_catalog_resolves_package_precedence_status_alias_and_reasoning() -> Nonsnapshot = 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() -> Nonassert route.transport is OpenCodeUpstreamTransport.CHAT_COMPLETIONSassert 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.pyindex 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 SimpleNamespacefrom unittest.mock import AsyncMock, MagicMock, patchimport pytest+from free_claude_code.application.model_metadata import ProviderModelInfofrom free_claude_code.config.provider_catalog import VERCEL_AI_GATEWAY_DEFAULT_BASE+from free_claude_code.core.model_capabilities import ModelInputModalityfrom tests.providers.request_factory import make_messages_requestfrom 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.pyindex 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 ProviderModelInfofrom free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENSfrom free_claude_code.config.provider_catalog import XAI_DEFAULT_BASEfrom free_claude_code.core.anthropic.models import MessagesRequest+from free_claude_code.core.model_capabilities import ModelInputModalityfrom free_claude_code.providers.model_listing import ModelListResponseErrorfrom free_claude_code.providers.openai_chat import OpenAIChatProviderfrom 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.pyindex 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 ModelInputModalityfrom free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicyfrom free_claude_code.providers.model_listing import ModelListResponseErrorfrom 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.pyindex 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_idreturn Nonedef cached_prefixed_model_infos(self) -> tuple[ProviderModelInfo, ...]:diff --git a/tests/runtime/test_model_cache.py b/tests/runtime/test_model_cache.pynew file mode 100644index 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.pyindex 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.lockindex 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" },