whosellm 0.3.1__tar.gz → 0.4.0__tar.gz

{whosellm-0.3.1 → whosellm-0.4.0}/.bumpversion.toml

@@ -2,7 +2,7 @@
 # 文档 / Documentation: https://callowayproject.github.io/bump-my-version/
 
 [tool.bumpversion]
-current_version = "0.3.1"
+current_version = "0.4.0"
 parse = """(?x)
     (?P<major>0|[1-9]\\d*)\\.
     (?P<minor>0|[1-9]\\d*)\\.

{whosellm-0.3.1 → whosellm-0.4.0}/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [Unreleased]
+
+### Added
+- **工具结果多模态能力（TFROB-856）**：新增 `LLMApiSurface`（str 枚举：`claude_messages` / `openai_chat_completions` / `openai_responses` / `gemini` / `dashscope` / `glm` / `deepseek` / `deepseek_responses`）与 `ToolResultSurfaceCapability`（`modalities` / `max_inline_bytes` / `mime_types`）。`ModelCapabilities.tool_result_surfaces` 以 surface 为键登记工具结果的原生媒体能力：缺键 = 未声明，空元组 = 明确不支持。
+- 新增文档上限字段：`max_pdf_size_mb`、`max_pdf_pages`、`max_document_size_mb`（预留）、`supported_document_mime_type`。`None` 表示未声明（未知），不代表“不限”；单文件与请求级上限分层登记。
+- 新增单请求内联媒体总预算 `max_inline_media_bytes` 与文件类媒体合计上限 `max_inline_file_bytes`（媒体计数字段继续复用 `media_count_limit`）。
+- 预留 `FileApiCapability` / `ModelCapabilities.file_api`，本版本不消费。
+- 数据登记（官方文档核实 + 2026-10-29 抓取日期；未逐模型 API 实测的已显式标注）：Claude 4.x/5 工具结果支持 image + PDF；OpenAI Chat Completions tool 消息 text-only、Responses `function_call_output` 支持 image/file；Gemini 3 系支持 image，Gemini 2.x 显式标为不支持；DeepSeek Chat Completions tool 消息 text-only，Responses `function_call_output` 支持 image，PDF `input_file` 经 2026-10-29 实测为静默不投递（登记为不支持）。DashScope / GLM 的官方 API 参考将 tool 消息 content 定义为字符串，登记为显式不支持（空元组）。
+- 修正 OpenAI gpt-5.1 及更新视觉模型缺失的 `supports_pdf=True`（官方 PDF 解析要求视觉模型，gpt-4o 及更新）。
+
 ## [0.2.4] - Unreleased
 
 ### Added

{whosellm-0.3.1 → whosellm-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: whosellm
-Version: 0.3.1
+Version: 0.4.0
 Summary: A unified LLM model version and capability management library
 Author-email: JQQ <jqq1716@gmail.com>
 License: MIT
@@ -146,6 +146,35 @@ print(model.capabilities.max_video_size_mb)  # 20.0
 validated_params = model.validate_params(your_params)
 ```
 
+### 工具结果的多模态能力 / Multimodal Tool Results
+
+工具结果能否原生承载图片/文档，取决于 **provider × API surface**，而不是模型名字前缀。能力数据以 `LLMApiSurface` 为键，缺键表示「未声明」，空元组表示「明确不支持」——两者都应按不支持处理。
+
+Whether a tool result can natively carry images/documents depends on **provider × API surface**, not on a model-name prefix. Capability data is keyed by `LLMApiSurface`; a missing key means "undeclared" and an empty tuple means "explicitly unsupported" — treat both as unsupported.
+
+```python
+from whosellm import LLMApiSurface, LLMeta
+
+caps = LLMeta("claude-opus-5-5").capabilities
+surface = caps.tool_result_surfaces.get(LLMApiSurface.CLAUDE_MESSAGES)
+print(surface.modalities)          # ("image", "document")
+print(surface.supports("document"))  # True
+
+# Gemini 3 系支持；2.5 系明确不支持（会返回 400）
+print(LLMeta("gemini-3.8-flash").capabilities.tool_result_surfaces[LLMApiSurface.GEMINI].modalities)  # ("image",)
+print(LLMeta("gemini-2.5-pro").capabilities.tool_result_surfaces[LLMApiSurface.GEMINI].modalities)    # ()
+
+# DeepSeek 的 Chat Completions 与 Responses 是两个 surface：
+# Chat Completions tool 消息只能放文本；Responses 的 function_call_output 支持图片，
+# 但 PDF input_file 实测被静默丢弃（2026-10-29 探针）
+print(LLMeta("deepseek-flash").capabilities.tool_result_surfaces[LLMApiSurface.DEEPSEEK].modalities)           # ()
+print(LLMeta("deepseek-flash").capabilities.tool_result_surfaces[LLMApiSurface.DEEPSEEK_RESPONSES].modalities)  # ("image",)
+```
+
+用户消息能力仍由 `supports_vision` / `supports_audio` / `supports_video` / `supports_pdf` 表示，工具结果能力只走 `tool_result_surfaces`。文档上限见 `max_pdf_size_mb`、`max_pdf_pages`、`supported_document_mime_type`；单请求内联媒体预算见 `max_inline_media_bytes`，文件类媒体的请求级合计上限见 `max_inline_file_bytes`。
+
+User-message capability remains on `supports_vision` / `supports_audio` / `supports_video` / `supports_pdf`; tool-result capability lives only in `tool_result_surfaces`. Document limits are exposed via `max_pdf_size_mb`, `max_pdf_pages`, and `supported_document_mime_type`; the per-request inline-media budget is `max_inline_media_bytes`, and the request-level combined cap for file-type media is `max_inline_file_bytes`.
+
 ### 非法名称也不会炸 / Lenient on Unknown Names
 
 我们不想打断你的流程，即便名称不在我们的数据库里也能返回一个「未知模型占位符」。

{whosellm-0.3.1 → whosellm-0.4.0}/README.md

@@ -121,6 +121,35 @@ print(model.capabilities.max_video_size_mb)  # 20.0
 validated_params = model.validate_params(your_params)
 ```
 
+### 工具结果的多模态能力 / Multimodal Tool Results
+
+工具结果能否原生承载图片/文档，取决于 **provider × API surface**，而不是模型名字前缀。能力数据以 `LLMApiSurface` 为键，缺键表示「未声明」，空元组表示「明确不支持」——两者都应按不支持处理。
+
+Whether a tool result can natively carry images/documents depends on **provider × API surface**, not on a model-name prefix. Capability data is keyed by `LLMApiSurface`; a missing key means "undeclared" and an empty tuple means "explicitly unsupported" — treat both as unsupported.
+
+```python
+from whosellm import LLMApiSurface, LLMeta
+
+caps = LLMeta("claude-opus-5-5").capabilities
+surface = caps.tool_result_surfaces.get(LLMApiSurface.CLAUDE_MESSAGES)
+print(surface.modalities)          # ("image", "document")
+print(surface.supports("document"))  # True
+
+# Gemini 3 系支持；2.5 系明确不支持（会返回 400）
+print(LLMeta("gemini-3.8-flash").capabilities.tool_result_surfaces[LLMApiSurface.GEMINI].modalities)  # ("image",)
+print(LLMeta("gemini-2.5-pro").capabilities.tool_result_surfaces[LLMApiSurface.GEMINI].modalities)    # ()
+
+# DeepSeek 的 Chat Completions 与 Responses 是两个 surface：
+# Chat Completions tool 消息只能放文本；Responses 的 function_call_output 支持图片，
+# 但 PDF input_file 实测被静默丢弃（2026-10-29 探针）
+print(LLMeta("deepseek-flash").capabilities.tool_result_surfaces[LLMApiSurface.DEEPSEEK].modalities)           # ()
+print(LLMeta("deepseek-flash").capabilities.tool_result_surfaces[LLMApiSurface.DEEPSEEK_RESPONSES].modalities)  # ("image",)
+```
+
+用户消息能力仍由 `supports_vision` / `supports_audio` / `supports_video` / `supports_pdf` 表示，工具结果能力只走 `tool_result_surfaces`。文档上限见 `max_pdf_size_mb`、`max_pdf_pages`、`supported_document_mime_type`；单请求内联媒体预算见 `max_inline_media_bytes`，文件类媒体的请求级合计上限见 `max_inline_file_bytes`。
+
+User-message capability remains on `supports_vision` / `supports_audio` / `supports_video` / `supports_pdf`; tool-result capability lives only in `tool_result_surfaces`. Document limits are exposed via `max_pdf_size_mb`, `max_pdf_pages`, and `supported_document_mime_type`; the per-request inline-media budget is `max_inline_media_bytes`, and the request-level combined cap for file-type media is `max_inline_file_bytes`.
+
 ### 非法名称也不会炸 / Lenient on Unknown Names
 
 我们不想打断你的流程，即便名称不在我们的数据库里也能返回一个「未知模型占位符」。

{whosellm-0.3.1 → whosellm-0.4.0}/docs/add_new_model_family.md

@@ -197,6 +197,19 @@ __all__ = [
 | `max_image_pixels` | `tuple[int, int] \| None` | 最大图片像素(宽, 高) / Max image pixels (width, height) |
 | `max_video_size_mb` | `float \| None` | 最大视频大小(MB) / Max video size in MB |
 | `max_video_duration_seconds` | `int \| None` | 最大视频时长(秒) / Max video duration in seconds |
+| `media_count_limit` | `MediaCountLimit` | 单请求媒体数量上限 / Per-request media count caps |
+| `max_inline_media_bytes` | `int \| None` | 单请求内联媒体字节总预算 / Per-request inline-media byte budget |
+| `max_inline_file_bytes` | `int \| None` | 单请求文件类媒体字节合计上限 / Combined per-request file-type media byte cap |
+| `max_pdf_size_mb` | `float \| None` | PDF 大小上限(MB) / Max PDF size in MB |
+| `max_pdf_pages` | `int \| None` | PDF 页数上限 / Max PDF pages per request |
+| `max_document_size_mb` | `float \| None` | 非 PDF 文档大小上限(MB，预留) / Max non-PDF document size |
+| `supported_document_mime_type` | `list[str]` | 支持的文档 MIME / Supported document MIME types |
+| `tool_result_surfaces` | `dict[LLMApiSurface, ToolResultSurfaceCapability]` | 工具结果按 API surface 的原生媒体能力；缺键 = 未声明，空元组 = 明确不支持 / Native tool-result media capability per surface; missing = undeclared, empty tuple = unsupported |
+| `file_api` | `FileApiCapability \| None` | 文件 API 能力（预留）/ File API capability (reserved) |
+
+工具结果能力是 **provider × API surface** 维度，而不是模型维度。新增模型时应按官方文档登记 `tool_result_surfaces`，并注明来源与抓取日期；未查证的 surface 请保持缺键（内核按不支持处理），不要乐观填写。
+
+Tool-result capability is **provider × API surface**, not per-model. When adding models, register `tool_result_surfaces` from official docs with source and fetch date; leave unverified surfaces undeclared (consumers treat them as unsupported) instead of guessing.
 
 ---
 

{whosellm-0.3.1 → whosellm-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "whosellm"
-version = "0.3.1"
+version = "0.4.0"
 description = "A unified LLM model version and capability management library"
 authors = [
     {name = "JQQ", email = "jqq1716@gmail.com"}

whosellm-0.4.0/tests/test_tool_result_surfaces.py

@@ -0,0 +1,279 @@
+# filename: test_tool_result_surfaces.py
+"""
+工具结果能力与文档限制测试 / Tool-result capability and document-limit tests
+
+覆盖 W2–W5 新增字段：
+- LLMApiSurface 词表与 ToolResultSurfaceCapability
+- ModelCapabilities.tool_result_surfaces / max_inline_media_bytes
+- max_pdf_size_mb / max_pdf_pages / supported_document_mime_type
+- FileApiCapability（预留）
+
+数据来源与抓取日期见 whosellm/models/families 下各配置文件的注释。
+Data sources and fetch dates are documented in the family config modules.
+"""
+
+import json
+from dataclasses import FrozenInstanceError
+
+import pytest
+
+from whosellm import (
+    FileApiCapability,
+    LLMApiSurface,
+    LLMeta,
+    ModelCapabilities,
+    ToolResultSurfaceCapability,
+)
+
+REQUIRED_SURFACES = {
+    "claude_messages",
+    "openai_chat_completions",
+    "openai_responses",
+    "gemini",
+    "dashscope",
+    "glm",
+    "deepseek",
+    "deepseek_responses",
+}
+
+
+class TestLLMApiSurface:
+    """API surface 词表 / API surface vocabulary"""
+
+    def test_required_members_exist(self) -> None:
+        assert {surface.value for surface in LLMApiSurface} == REQUIRED_SURFACES
+
+    def test_str_enum_serializes_as_plain_string(self) -> None:
+        """str 枚举可直接作为 dict 键并 JSON 序列化 / str enum works as a dict key and serializes"""
+        assert LLMApiSurface.CLAUDE_MESSAGES == "claude_messages"
+        assert json.dumps({LLMApiSurface.CLAUDE_MESSAGES: "ok"}) == '{"claude_messages": "ok"}'
+
+    def test_value_lookup(self) -> None:
+        """可用字符串值还原枚举成员 / Members can be reconstructed from their string values"""
+        assert LLMApiSurface("claude_messages") is LLMApiSurface.CLAUDE_MESSAGES
+        assert str(LLMApiSurface.GEMINI) == "gemini"
+
+
+class TestDefaults:
+    """新增字段的空默认值 / Empty defaults for the new fields"""
+
+    def test_tool_result_surface_defaults(self) -> None:
+        surface = ToolResultSurfaceCapability()
+        assert surface.modalities == ()
+        assert surface.max_inline_bytes is None
+        assert surface.mime_types is None
+        assert surface.supports("image") is False
+
+    def test_model_capabilities_defaults(self) -> None:
+        caps = ModelCapabilities()
+        assert caps.tool_result_surfaces == {}
+        assert caps.max_inline_media_bytes is None
+        assert caps.max_inline_file_bytes is None
+        assert caps.max_pdf_size_mb is None
+        assert caps.max_pdf_pages is None
+        assert caps.max_document_size_mb is None
+        assert caps.supported_document_mime_type == []
+        assert caps.file_api is None
+
+    def test_file_api_defaults(self) -> None:
+        file_api = FileApiCapability()
+        assert file_api.supports_upload is False
+        assert file_api.max_file_size_mb is None
+        assert file_api.supported_mime_types == []
+
+    def test_surface_is_frozen(self) -> None:
+        surface = ToolResultSurfaceCapability(modalities=("image",))
+        with pytest.raises(FrozenInstanceError):
+            surface.modalities = ("audio",)  # type: ignore[misc]
+
+
+class TestClaudeToolResults:
+    """Claude Messages：工具结果原生支持 image + document / Claude Messages tool results"""
+
+    @pytest.mark.parametrize(
+        ("model_name", "expected_pages"),
+        [
+            ("claude-opus-5-5", 600),
+            ("claude-fable-5", 600),
+            ("claude-sonnet-5", 600),
+            ("claude-opus-4-8", 600),
+            ("claude-sonnet-4-6", 600),
+            ("claude-sonnet-4-5", 100),
+            ("claude-haiku-4-5", 100),
+            ("claude-opus-4-1", 100),
+        ],
+    )
+    def test_claude_4x_5x(self, model_name: str, expected_pages: int) -> None:
+        caps = LLMeta(model_name).capabilities
+        surface = caps.tool_result_surfaces[LLMApiSurface.CLAUDE_MESSAGES]
+
+        assert surface.modalities == ("image", "document")
+        assert surface.supports("image") is True
+        assert surface.supports("document") is True
+        assert surface.supports("audio") is False
+        assert surface.supports("video") is False
+        assert surface.mime_types is not None
+        assert surface.mime_types["document"] == ["application/pdf"]
+        assert surface.mime_types["image"] == ["image/jpeg", "image/png", "image/gif", "image/webp"]
+
+        # W3 文档上限 / W3 document limits
+        # 官方只公布请求级 128 MB，没有单文件上限 → max_pdf_size_mb 保持 None
+        # Only a request-level 128 MB cap is documented, so the per-file size stays None
+        assert caps.supports_pdf is True
+        assert caps.max_pdf_size_mb is None
+        assert caps.max_pdf_pages == expected_pages
+        assert caps.supported_document_mime_type == ["application/pdf"]
+        assert caps.max_inline_media_bytes == 128_000_000
+        assert caps.max_inline_file_bytes is None  # 官方无文件合计上限 / no combined file cap
+
+    def test_claude_3x_is_undeclared(self) -> None:
+        """Claude 3.x 未登记工具结果 surface 数据 / Claude 3.x leaves surfaces undeclared"""
+        caps = LLMeta("claude-3-7-sonnet").capabilities
+        assert LLMApiSurface.CLAUDE_MESSAGES not in caps.tool_result_surfaces
+        assert caps.max_pdf_size_mb is None
+        assert caps.max_pdf_pages is None
+
+
+class TestOpenAIToolResults:
+    """OpenAI：Chat Completions text-only；Responses 支持 image / document"""
+
+    @pytest.mark.parametrize("model_name", ["gpt-4o", "gpt-5.4-mini", "gpt-6-astra", "o3"])
+    def test_chat_completions_unsupported_responses_supported(self, model_name: str) -> None:
+        caps = LLMeta(model_name).capabilities
+        chat = caps.tool_result_surfaces[LLMApiSurface.OPENAI_CHAT_COMPLETIONS]
+        responses = caps.tool_result_surfaces[LLMApiSurface.OPENAI_RESPONSES]
+
+        assert chat.modalities == ()
+        assert chat.supports("image") is False
+        assert responses.modalities == ("image", "document")
+        assert responses.supports("image") is True
+        assert responses.supports("document") is True
+        assert responses.mime_types is not None
+        assert responses.mime_types["document"] == ["application/pdf"]
+
+        assert caps.supports_pdf is True
+        assert caps.max_pdf_size_mb == 50.0
+        assert caps.max_pdf_pages is None  # 官方未公布页数上限 / no documented page cap
+        assert caps.supported_document_mime_type == ["application/pdf"]
+        assert caps.max_inline_media_bytes == 512_000_000
+        assert caps.max_inline_file_bytes == 50_000_000  # 所有文件合计 <50 MB / combined files
+
+    @pytest.mark.parametrize("model_name", ["o3-mini", "gpt-4o-audio-preview"])
+    def test_non_vision_chat_only(self, model_name: str) -> None:
+        caps = LLMeta(model_name).capabilities
+        assert caps.tool_result_surfaces[LLMApiSurface.OPENAI_CHAT_COMPLETIONS].modalities == ()
+        assert LLMApiSurface.OPENAI_RESPONSES not in caps.tool_result_surfaces
+
+    def test_gpt_3_5_chat_only(self) -> None:
+        caps = LLMeta("gpt-3.5-turbo").capabilities
+        assert caps.tool_result_surfaces[LLMApiSurface.OPENAI_CHAT_COMPLETIONS].modalities == ()
+        assert caps.max_pdf_size_mb is None
+
+
+class TestGeminiToolResults:
+    """Gemini：仅 3 系支持多模态 function response；2.x 必须显式标不支持"""
+
+    @pytest.mark.parametrize(
+        "model_name",
+        ["gemini-3.8-flash", "gemini-3.1-pro-preview", "gemini-3-flash-preview", "gemini-3-pro"],
+    )
+    def test_gemini_3_supports_image(self, model_name: str) -> None:
+        caps = LLMeta(model_name).capabilities
+        surface = caps.tool_result_surfaces[LLMApiSurface.GEMINI]
+        assert surface.modalities == ("image",)
+        assert surface.supports("image") is True
+        assert surface.supports("document") is False  # 官方 FunctionResult 仅登记 image / only image is documented
+
+        # 官方未公布单文件 PDF 上限（inline payload 100 MB / PDF 50 MB 均为请求级）
+        # No per-file PDF cap is documented; the inline payload caps are request-level
+        assert caps.max_pdf_size_mb is None
+        assert caps.max_pdf_pages == 1000
+        assert caps.supported_document_mime_type == ["application/pdf"]
+        assert caps.max_inline_media_bytes == 100_000_000
+        assert caps.max_inline_file_bytes == 50_000_000
+
+    @pytest.mark.parametrize(
+        "model_name",
+        ["gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "gemini-2.0-flash"],
+    )
+    def test_gemini_2x_explicitly_unsupported(self, model_name: str) -> None:
+        """2.x 明确标为不支持（空元组），而非缺键 / 2.x is explicitly unsupported, not undeclared"""
+        caps = LLMeta(model_name).capabilities
+        surface = caps.tool_result_surfaces[LLMApiSurface.GEMINI]
+        assert surface.modalities == ()
+        assert surface.supports("image") is False
+
+    @pytest.mark.parametrize("model_name", ["gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite"])
+    def test_gemini_2_5_pdf_limits(self, model_name: str) -> None:
+        """用户消息的 PDF 能力不受工具结果限制影响 / User-message PDF capability is unaffected"""
+        caps = LLMeta(model_name).capabilities
+        assert caps.supports_pdf is True
+        assert caps.max_pdf_pages == 1000
+        assert caps.max_pdf_size_mb is None
+        assert caps.max_inline_file_bytes == 50_000_000
+
+    def test_image_only_model_has_no_surface(self) -> None:
+        """无 function calling 的模型不登记 surface / Models without function calling declare no surface"""
+        caps = LLMeta("gemini-2.5-flash-image").capabilities
+        assert LLMApiSurface.GEMINI not in caps.tool_result_surfaces
+
+
+class TestDeepSeekToolResults:
+    """DeepSeek：Chat Completions text-only；Responses 图片可用、PDF 静默丢失"""
+
+    @pytest.mark.parametrize(
+        "model_name",
+        ["deepseek-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner"],
+    )
+    def test_chat_completions_text_only(self, model_name: str) -> None:
+        caps = LLMeta(model_name).capabilities
+        surface = caps.tool_result_surfaces[LLMApiSurface.DEEPSEEK]
+        assert surface.modalities == ()
+        assert surface.supports("image") is False
+
+        # 实测 2026-10-29：PDF input_file 被接受但内容不投递 / PDF is silently dropped
+        assert caps.supports_pdf is False
+        assert caps.supported_document_mime_type == []
+        assert caps.max_pdf_size_mb is None
+        assert caps.max_pdf_pages is None
+        assert caps.max_inline_file_bytes is None
+
+    @pytest.mark.parametrize(
+        "model_name",
+        ["deepseek-flash", "deepseek-chat", "deepseek-reasoner"],
+    )
+    def test_responses_supports_image_not_document(self, model_name: str) -> None:
+        caps = LLMeta(model_name).capabilities
+        surface = caps.tool_result_surfaces[LLMApiSurface.DEEPSEEK_RESPONSES]
+        assert surface.modalities == ("image",)
+        assert surface.supports("image") is True
+        assert surface.supports("document") is False
+        assert surface.max_inline_bytes == 32 * 1024 * 1024
+        assert surface.mime_types is not None
+        assert surface.mime_types["image"] == ["image/jpeg", "image/png", "image/gif", "image/webp"]
+        assert caps.max_inline_media_bytes == 48 * 1024 * 1024
+
+    def test_responses_text_only_model(self) -> None:
+        caps = LLMeta("deepseek-v4-pro").capabilities
+        surface = caps.tool_result_surfaces[LLMApiSurface.DEEPSEEK_RESPONSES]
+        assert surface.modalities == ()
+        assert caps.max_inline_media_bytes is None
+
+
+class TestExplicitlyUnsupportedSurfaces:
+    """官方明确不支持：显式空元组 / Officially unsupported: explicit empty tuple"""
+
+    @pytest.mark.parametrize(
+        ("model_name", "surface"),
+        [
+            ("qwen3-vl-plus", LLMApiSurface.DASHSCOPE),
+            ("qwen-plus", LLMApiSurface.DASHSCOPE),
+            ("glm-4.6v", LLMApiSurface.GLM),
+            ("glm-5v-turbo", LLMApiSurface.GLM),
+        ],
+    )
+    def test_dashscope_and_glm_text_only(self, model_name: str, surface: LLMApiSurface) -> None:
+        """官方 API 参考将 tool 消息 content 定义为字符串 / Official API defines tool content as string"""
+        caps = LLMeta(model_name).capabilities
+        assert caps.tool_result_surfaces[surface].modalities == ()
+        assert caps.tool_result_surfaces[surface].supports("image") is False

{whosellm-0.3.1 → whosellm-0.4.0}/uv.lock

@@ -968,7 +968,7 @@ wheels = [
 
 [[package]]
 name = "whosellm"
-version = "0.3.1"
+version = "0.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "parse" },

{whosellm-0.3.1 → whosellm-0.4.0}/whosellm/__init__.py

@@ -7,19 +7,31 @@
 LLMeta - 统一的大语言模型版本和能力管理库 / A unified LLM model version and capability management library
 """
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"
 
-from whosellm.capabilities import UNLIMITED, MediaCountLimit, ModelCapabilities
+from whosellm.capabilities import (
+    UNLIMITED,
+    FileApiCapability,
+    LLMApiSurface,
+    MediaCountLimit,
+    ModelCapabilities,
+    ToolResultModality,
+    ToolResultSurfaceCapability,
+)
 from whosellm.model_version import LLMeta
 from whosellm.models.base import ModelFamily
 from whosellm.provider import Provider
 
 __all__ = [
     "UNLIMITED",
+    "FileApiCapability",
+    "LLMApiSurface",
     "LLMeta",
     "MediaCountLimit",
     "ModelCapabilities",
     "ModelFamily",
     "Provider",
+    "ToolResultModality",
+    "ToolResultSurfaceCapability",
     "__version__",
 ]