Skip to content

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

Python

Preserve DeepSeek images through shared conversion (#1793)

Ali Khokharfcdec0752f96
diff --git a/pyproject.toml b/pyproject.toml
index c71d9746..b12bc473 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "6.2.25"
+version = "6.2.26"
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/providers/deepseek/compat.py b/src/free_claude_code/providers/deepseek/compat.py
index 2376ec3e..bfa4febb 100644
--- a/src/free_claude_code/providers/deepseek/compat.py
+++ b/src/free_claude_code/providers/deepseek/compat.py
@@ -10,7 +10,6 @@ from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKEN
from free_claude_code.core.anthropic import (
ReasoningReplayMode,
dump_messages_request,
- serialize_tool_result_content,
)
from free_claude_code.core.anthropic.models import MessagesRequest
from free_claude_code.core.reasoning import (
@@ -29,30 +28,10 @@ DEEPSEEK_REQUEST_POLICY = OpenAIChatRequestPolicy(
include_extra_body=True,
)
-_UNSUPPORTED_MESSAGE_BLOCK_TYPES = frozenset(
- {
- "image",
- "document",
- }
+_OMITTED_DOCUMENT_TEXT = (
+ "[attachment omitted: DeepSeek does not support document inputs]"
)
-_STRIPPABLE_MESSAGE_BLOCK_TYPES = frozenset({"image", "document"})
-_FORWARDABLE_ATTACHMENT_BLOCK_TYPES = frozenset({"image"})
-_OMITTED_ATTACHMENT_TEXT = (
- "[attachment omitted: DeepSeek does not support image or document inputs]"
-)
-_OMITTED_ATTACHMENT_BLOCK = {"type": "text", "text": _OMITTED_ATTACHMENT_TEXT}
-
-
-def _is_vision_capable_model(model: str | None) -> bool:
- """True when the DeepSeek model accepts OpenAI image parts.
-
- DeepSeek's vision models (e.g. ``deepseek-v4-flash-vision-exp``) support
- image inputs natively. Document blocks are still stripped because the
- shared OpenAI conversion path has no document parts.
- """
- if not model:
- return False
- return "vision" in str(model).rsplit("/", 1)[-1].lower()
+_OMITTED_DOCUMENT_BLOCK = {"type": "text", "text": _OMITTED_DOCUMENT_TEXT}
def build_deepseek_request_body(
@@ -65,15 +44,10 @@ def build_deepseek_request_body(
len(request_data.messages),
)
- vision_capable = _is_vision_capable_model(request_data.model)
data = dump_messages_request(request_data)
if "messages" in data:
- data["messages"] = _strip_unsupported_attachment_blocks(
- data["messages"], allow_attachments=vision_capable
- )
- _validate_deepseek_request_dict(data, allow_attachments=vision_capable)
- if "messages" in data:
- data["messages"] = _normalize_tool_result_content(data["messages"])
+ data["messages"] = _strip_document_blocks(data["messages"])
+ _validate_deepseek_request_dict(data)
sanitized_request = MessagesRequest.model_validate(data)
body = build_openai_chat_request_body(
@@ -129,9 +103,7 @@ def _downgrade_chat_forced_tool_choice(body: dict[str, Any]) -> None:
body["tool_choice"] = "auto"
-def _strip_unsupported_attachment_blocks(
- messages: Any, *, allow_attachments: bool = False
-) -> Any:
+def _strip_document_blocks(messages: Any) -> Any:
if not isinstance(messages, list):
return messages
@@ -150,51 +122,36 @@ def _strip_unsupported_attachment_blocks(
continue
new_content: list[Any] = []
- message_dropped_attachment = False
+ message_dropped_document = False
for block in content:
if isinstance(block, dict):
btype = block.get("type")
- if btype in _STRIPPABLE_MESSAGE_BLOCK_TYPES:
- if (
- allow_attachments
- and btype in _FORWARDABLE_ATTACHMENT_BLOCK_TYPES
- ):
- new_content.append(block)
- continue
+ if btype == "document":
top_level_dropped[btype] = top_level_dropped.get(btype, 0) + 1
- message_dropped_attachment = True
+ message_dropped_document = True
continue
if btype == "tool_result":
inner = block.get("content")
if isinstance(inner, list):
filtered_inner: list[Any] = []
for sub in inner:
- if (
- isinstance(sub, dict)
- and sub.get("type") in _STRIPPABLE_MESSAGE_BLOCK_TYPES
- ):
+ if isinstance(sub, dict) and sub.get("type") == "document":
sub_type = sub["type"]
- if (
- allow_attachments
- and sub_type in _FORWARDABLE_ATTACHMENT_BLOCK_TYPES
- ):
- filtered_inner.append(sub)
- continue
nested_dropped[sub_type] = (
nested_dropped.get(sub_type, 0) + 1
)
continue
filtered_inner.append(sub)
if not filtered_inner:
- filtered_inner = [_OMITTED_ATTACHMENT_BLOCK]
+ filtered_inner = [_OMITTED_DOCUMENT_BLOCK]
placeholder_replacements += 1
new_block = dict(block)
new_block["content"] = filtered_inner
new_content.append(new_block)
continue
new_content.append(block)
- if not new_content and message_dropped_attachment:
- new_content = [_OMITTED_ATTACHMENT_BLOCK]
+ if not new_content and message_dropped_document:
+ new_content = [_OMITTED_DOCUMENT_BLOCK]
placeholder_replacements += 1
new_msg = dict(message)
new_msg["content"] = new_content
@@ -202,9 +159,9 @@ def _strip_unsupported_attachment_blocks(
if top_level_dropped or nested_dropped:
logger.warning(
- "DEEPSEEK_REQUEST: stripped unsupported attachment blocks "
+ "DEEPSEEK_REQUEST: stripped unsupported document blocks "
"(top_level={} nested_in_tool_result={} placeholder_tool_results={}). "
- "DeepSeek has no vision/document support; the model will not see this content.",
+ "The model will not see the omitted document content.",
dict(top_level_dropped),
dict(nested_dropped),
placeholder_replacements,
@@ -222,18 +179,14 @@ def _is_server_listed_tool(tool: Mapping[str, Any]) -> bool:
return False
-def _walk_block_list_for_unsupported(
- blocks: Any, *, where: str, allow_attachments: bool = False
-) -> None:
+def _walk_block_list_for_unsupported(blocks: Any, *, where: str) -> None:
if not isinstance(blocks, list):
return
for block in blocks:
if not isinstance(block, dict):
continue
btype = block.get("type")
- if btype in _UNSUPPORTED_MESSAGE_BLOCK_TYPES:
- if allow_attachments and btype in _FORWARDABLE_ATTACHMENT_BLOCK_TYPES:
- continue
+ if btype == "document":
raise InvalidRequestError(
f"DeepSeek native does not support {btype!r} blocks ({where})."
)
@@ -241,13 +194,10 @@ def _walk_block_list_for_unsupported(
_walk_block_list_for_unsupported(
block["content"],
where=f"{where} (tool_result content)",
- allow_attachments=allow_attachments,
)
-def _validate_deepseek_request_dict(
- data: dict[str, Any], *, allow_attachments: bool = False
-) -> None:
+def _validate_deepseek_request_dict(data: dict[str, Any]) -> None:
mcp = data.get("mcp_servers")
if mcp:
raise InvalidRequestError("DeepSeek does not support mcp_servers on requests.")
@@ -269,51 +219,11 @@ def _validate_deepseek_request_dict(
_walk_block_list_for_unsupported(
content,
where=f"messages[{i}].content",
- allow_attachments=allow_attachments,
)
system = data.get("system")
if isinstance(system, list):
- _walk_block_list_for_unsupported(
- system, where="system", allow_attachments=allow_attachments
- )
-
-
-def _normalize_tool_result_content(messages: Any) -> Any:
- if not isinstance(messages, list):
- return messages
-
- normalized: list[Any] = []
- for message in messages:
- if not isinstance(message, dict):
- normalized.append(message)
- continue
-
- content = message.get("content")
- if not isinstance(content, list):
- normalized.append(message)
- continue
-
- new_content: list[Any] = []
- for block in content:
- if not isinstance(block, dict):
- new_content.append(block)
- continue
-
- if block.get("type") == "tool_result":
- normalized_block = dict(block)
- normalized_block["content"] = serialize_tool_result_content(
- block.get("content")
- )
- new_content.append(normalized_block)
- else:
- new_content.append(block)
-
- new_msg = dict(message)
- new_msg["content"] = new_content
- normalized.append(new_msg)
-
- return normalized
+ _walk_block_list_for_unsupported(system, where="system")
def _apply_deepseek_chat_extras(body: dict[str, Any], policy: ReasoningPolicy) -> None:
diff --git a/tests/providers/test_deepseek.py b/tests/providers/test_deepseek.py
index ab2c1358..aedd7dd0 100644
--- a/tests/providers/test_deepseek.py
+++ b/tests/providers/test_deepseek.py
@@ -1,10 +1,13 @@
"""Tests for DeepSeek OpenAI-compatible Chat Completions provider."""
+import json
import logging
from types import SimpleNamespace
from unittest.mock import AsyncMock, patch
+import httpx2
import pytest
+from openai import BadRequestError
from free_claude_code.application.errors import InvalidRequestError
from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
@@ -17,6 +20,8 @@ from free_claude_code.core.anthropic.models import (
Tool,
)
from free_claude_code.core.anthropic.stream_contracts import parse_sse_text
+from free_claude_code.core.failures import ExecutionFailure, FailureKind
+from free_claude_code.core.openai_chat import is_synthetic_chat_tool_turn_boundary
from free_claude_code.core.openai_responses.models import OpenAIResponsesRequest
from free_claude_code.providers.deepseek import DeepSeekProvider
from tests.providers.support import (
@@ -788,91 +793,51 @@ def test_passthrough_tool_use_and_result(deepseek_provider):
assert body["messages"][1]["role"] == "tool"
-def test_startup_strips_user_image():
- """Image blocks are silently stripped (DeepSeek lacks vision); request must not fail."""
- request = MessagesRequest(
- model="m",
- messages=[
- Message(
- role="user",
- content=[
- ContentBlockImage(
- type="image",
- source={
- "type": "base64",
- "media_type": "image/png",
- "data": "YQ==",
- },
- )
- ],
- )
- ],
- )
- provider = DeepSeekProvider(
- make_provider_config(
- api_key="k",
- base_url=DEEPSEEK_DEFAULT_BASE,
- rate_limit=1,
- rate_window=1,
+ "model",
+ [
+ "deepseek-flash",
+ "deepseek-v4-flash-vision-exp",
+ "deepseek-v4-flash",
+ "deepseek-chat",
+ "gateway/future-model",
+ ],
+)
+ ("source", "expected_url"),
+ [
+ (
+ {"type": "base64", "media_type": "image/png", "data": "YQ=="},
+ "data:image/png;base64,YQ==",
),
- admission=immediate_admission(),
- )
- # Should not raise; image is stripped.
- provider.stream_messages(request, reasoning=REASONING_ON)
- body = provider._chat._build_request_body(request, reasoning=reasoning_for(request))
- content = body["messages"][0]["content"]
- assert "attachment omitted" in content.lower()
- assert "image or document inputs" in content.lower()
-
-
-def test_vision_model_forwards_user_image():
- """Vision-capable DeepSeek models receive image blocks as OpenAI image_url parts."""
+ (
+ {"type": "url", "url": "https://images.example.test/shot.png"},
+ "https://images.example.test/shot.png",
+ ),
+ ],
+)
+def test_forwards_user_image_for_any_model(
+ deepseek_provider, model, source, expected_url
+):
request = MessagesRequest(
- model="deepseek-v4-flash-vision-exp",
+ model=model,
messages=[
Message(
role="user",
- content=[
- ContentBlockImage(
- type="image",
- source={
- "type": "base64",
- "media_type": "image/png",
- "data": "YQ==",
- },
- ),
- {"type": "text", "text": "Describe this image"},
- ],
+ content=[ContentBlockImage(type="image", source=source)],
)
],
)
- provider = DeepSeekProvider(
- make_provider_config(
- api_key="k",
- base_url=DEEPSEEK_DEFAULT_BASE,
- rate_limit=1,
- rate_window=1,
- ),
- admission=immediate_admission(),
+ body = deepseek_provider._chat._build_request_body(
+ request, reasoning=reasoning_for(request)
)
- # Must not raise on validation (no InvalidRequestError for image blocks).
- provider.stream_messages(request, reasoning=REASONING_ON)
- body = provider._chat._build_request_body(request, reasoning=reasoning_for(request))
- content = body["messages"][0]["content"]
- assert isinstance(content, list)
- image_parts = [
- part
- for part in content
- if isinstance(part, dict) and part.get("type") == "image_url"
- ]
- assert len(image_parts) == 1
- assert image_parts[0]["image_url"]["url"] == "data:image/png;base64,YQ=="
- text_parts = [
- part
- for part in content
- if isinstance(part, dict) and part.get("type") == "text"
+ assert body["model"] == model
+ assert body["messages"] == [
+ {
+ "role": "user",
+ "content": [{"type": "image_url", "image_url": {"url": expected_url}}],
+ }
]
- assert text_parts[0]["text"] == "Describe this image"
def test_vision_model_strips_user_document():
@@ -922,7 +887,8 @@ def test_vision_model_strips_user_document():
for part in content
)
assert "attachment omitted" in lowered
- assert "image or document inputs" in lowered
+ assert "document inputs" in lowered
+ assert "image" not in lowered
def test_startup_rejects_mcp_servers():
@@ -1373,8 +1339,7 @@ def test_strips_document_blocks_for_deepseek(deepseek_provider):
}
-def test_strips_image_blocks_for_deepseek(deepseek_provider):
- """Image blocks are stripped for DeepSeek since it doesn't support vision."""
+def test_preserves_user_image_and_text_order(deepseek_provider):
request = MessagesRequest.model_validate(
{
"model": "m",
@@ -1388,9 +1353,10 @@ def test_strips_image_blocks_for_deepseek(deepseek_provider):
"source": {
"type": "base64",
"media_type": "image/png",
- "data": "abc",
+ "data": "YQ==",
},
},
+ {"type": "text", "text": "then explain"},
],
},
],
@@ -1401,7 +1367,19 @@ def test_strips_image_blocks_for_deepseek(deepseek_provider):
request, reasoning=reasoning_for(request)
)
- assert body["messages"][0] == {"role": "user", "content": "describe this"}
+ assert body["messages"] == [
+ {
+ "role": "user",
+ "content": [
+ {"type": "text", "text": "describe this"},
+ {
+ "type": "image_url",
+ "image_url": {"url": "data:image/png;base64,YQ=="},
+ },
+ {"type": "text", "text": "then explain"},
+ ],
+ }
+ ]
def test_normalizes_tool_result_content_dict_to_string(deepseek_provider):
@@ -1446,11 +1424,11 @@ def test_normalizes_tool_result_content_dict_to_string(deepseek_provider):
assert "success" in tool_result["content"]
-def test_strips_image_block_inside_tool_result(deepseek_provider):
- """Image blocks nested inside tool_result.content are stripped, not rejected."""
[email protected]("model", ["deepseek-flash", "deepseek-v4-flash-vision-exp"])
+def test_preserves_image_and_text_inside_tool_result(deepseek_provider, model):
request = MessagesRequest.model_validate(
{
- "model": "m",
+ "model": model,
"messages": [
{
"role": "assistant",
@@ -1476,9 +1454,10 @@ def test_strips_image_block_inside_tool_result(deepseek_provider):
"source": {
"type": "base64",
"media_type": "image/png",
- "data": "abc",
+ "data": "YQ==",
},
},
+ {"type": "text", "text": "inspect the screenshot"},
],
}
],
@@ -1491,17 +1470,27 @@ def test_strips_image_block_inside_tool_result(deepseek_provider):
request, reasoning=reasoning_for(request)
)
- tool_result = body["messages"][1]
- assert tool_result["role"] == "tool"
- # After stripping + string-normalization, no base64/image marker survives.
- assert isinstance(tool_result["content"], str)
- assert "screenshot saved" in tool_result["content"]
- assert "base64" not in tool_result["content"]
- assert "abc" not in tool_result["content"]
+ assert [message["role"] for message in body["messages"]] == [
+ "assistant",
+ "tool",
+ "assistant",
+ "user",
+ ]
+ assert body["messages"][1] == {
+ "role": "tool",
+ "tool_call_id": "t1",
+ "content": "[Image-bearing tool output follows in user content.]",
+ }
+ assert is_synthetic_chat_tool_turn_boundary(body["messages"][2])
+ assert body["messages"][3]["content"] == [
+ {"type": "text", "text": 'Image-bearing output for tool call "t1":'},
+ {"type": "text", "text": "screenshot saved"},
+ {"type": "image_url", "image_url": {"url": "data:image/png;base64,YQ=="}},
+ {"type": "text", "text": "inspect the screenshot"},
+ ]
-def test_image_only_tool_result_replaced_with_placeholder(deepseek_provider):
- """A tool_result whose only inner block is an image becomes a placeholder string."""
+def test_image_only_tool_result_reaches_user_content(deepseek_provider):
request = MessagesRequest.model_validate(
{
"model": "m",
@@ -1527,9 +1516,8 @@ def test_image_only_tool_result_replaced_with_placeholder(deepseek_provider):
{
"type": "image",
"source": {
- "type": "base64",
- "media_type": "image/png",
- "data": "abc",
+ "type": "url",
+ "url": "https://images.example.test/shot.png",
},
},
],
@@ -1544,18 +1532,39 @@ def test_image_only_tool_result_replaced_with_placeholder(deepseek_provider):
request, reasoning=reasoning_for(request)
)
- tool_result = body["messages"][1]
- assert tool_result["role"] == "tool"
- assert isinstance(tool_result["content"], str)
- assert tool_result["content"] != ""
- assert "attachment omitted" in tool_result["content"].lower()
- assert "image or document inputs" in tool_result["content"].lower()
+ assert [message["role"] for message in body["messages"]] == [
+ "assistant",
+ "tool",
+ "assistant",
+ "user",
+ ]
+ assert body["messages"][1] == {
+ "role": "tool",
+ "tool_call_id": "t1",
+ "content": "[Image-bearing tool output follows in user content.]",
+ }
+ assert is_synthetic_chat_tool_turn_boundary(body["messages"][2])
+ assert body["messages"][3]["content"] == [
+ {"type": "text", "text": 'Image-bearing output for tool call "t1":'},
+ {
+ "type": "image_url",
+ "image_url": {"url": "https://images.example.test/shot.png"},
+ },
+ ]
-def test_document_only_tool_result_replaced_with_generic_placeholder(
+ "tool_content",
+ [
+ [],
+ [{"type": "document", "source": {"type": "file", "file_id": "file_pdf"}}],
+ ],
+)
+def test_document_or_empty_tool_result_keeps_placeholder(
deepseek_provider,
+ tool_content,
):
- """A document-only tool_result uses the generic attachment placeholder."""
+ """Document-only and empty tool results retain their omission marker."""
request = MessagesRequest.model_validate(
{
"model": "m",
@@ -1577,15 +1586,7 @@ def test_document_only_tool_result_replaced_with_generic_placeholder(
{
"type": "tool_result",
"tool_use_id": "t1",
- "content": [
- {
- "type": "document",
- "source": {
- "type": "file",
- "file_id": "file_pdf",
- },
- },
- ],
+ "content": tool_content,
}
],
},
@@ -1605,38 +1606,6 @@ def test_document_only_tool_result_replaced_with_generic_placeholder(
assert "image omitted" not in tool_result["content"].lower()
-def test_image_only_message_replaced_with_placeholder(deepseek_provider):
- """A top-level image-only message remains non-empty after stripping."""
- request = MessagesRequest.model_validate(
- {
- "model": "m",
- "messages": [
- {
- "role": "user",
- "content": [
- {
- "type": "image",
- "source": {
- "type": "base64",
- "media_type": "image/png",
- "data": "abc",
- },
- },
- ],
- },
- ],
- }
- )
-
- body = deepseek_provider._chat._build_request_body(
- request, reasoning=reasoning_for(request)
- )
-
- content = body["messages"][0]["content"]
- assert "attachment omitted" in content.lower()
- assert "image or document inputs" in content.lower()
-
-
def test_document_only_message_replaced_with_placeholder(deepseek_provider):
"""A top-level document-only message remains non-empty after stripping."""
request = MessagesRequest.model_validate(
@@ -1665,8 +1634,8 @@ def test_document_only_message_replaced_with_placeholder(deepseek_provider):
assert "document inputs" in content.lower()
-def test_warns_when_stripping_attachment_blocks(deepseek_provider, caplog):
- """A warning is emitted when image/document blocks are dropped so users notice."""
+def test_warns_when_stripping_document_blocks(deepseek_provider, caplog):
+ """A warning identifies documents omitted from user and tool content."""
request = MessagesRequest.model_validate(
{
"model": "m",
@@ -1676,10 +1645,10 @@ def test_warns_when_stripping_attachment_blocks(deepseek_provider, caplog):
"content": [
{"type": "text", "text": "look"},
{
- "type": "image",
+ "type": "document",
"source": {
"type": "base64",
- "media_type": "image/png",
+ "media_type": "application/pdf",
"data": "abc",
},
},
@@ -1704,10 +1673,10 @@ def test_warns_when_stripping_attachment_blocks(deepseek_provider, caplog):
"tool_use_id": "t1",
"content": [
{
- "type": "image",
+ "type": "document",
"source": {
"type": "base64",
- "media_type": "image/png",
+ "media_type": "application/pdf",
"data": "abc",
},
},
@@ -1725,15 +1694,30 @@ def test_warns_when_stripping_attachment_blocks(deepseek_provider, caplog):
)
warnings = [r for r in caplog.records if r.levelno == logging.WARNING]
- assert any("stripped unsupported attachment blocks" in r.message for r in warnings)
+ assert any("stripped unsupported document blocks" in r.message for r in warnings)
+ assert not any("no vision" in r.message for r in warnings)
-def test_no_warning_when_no_attachments(deepseek_provider, caplog):
- """No warning is emitted on plain text-only requests."""
+ "content",
+ [
+ "hello",
+ [
+ {
+ "type": "image",
+ "source": {
+ "type": "url",
+ "url": "https://images.example.test/shot.png",
+ },
+ }
+ ],
+ ],
+)
+def test_no_warning_when_no_documents(deepseek_provider, caplog, content):
request = MessagesRequest.model_validate(
{
"model": "m",
- "messages": [{"role": "user", "content": "hello"}],
+ "messages": [{"role": "user", "content": content}],
}
)
@@ -1742,8 +1726,260 @@ def test_no_warning_when_no_attachments(deepseek_provider, caplog):
request, reasoning=reasoning_for(request)
)
- assert not any(
- "stripped unsupported attachment blocks" in r.message
- for r in caplog.records
- if r.levelno == logging.WARNING
+ assert not any(r.levelno == logging.WARNING for r in caplog.records)
+
+
+def test_parallel_tool_results_close_before_image_content(deepseek_provider):
+ request = MessagesRequest.model_validate(
+ {
+ "model": "deepseek-flash",
+ "tools": [{"name": "Read", "input_schema": {"type": "object"}}],
+ "messages": [
+ {
+ "role": "assistant",
+ "content": [
+ {"type": "tool_use", "id": "t1", "name": "Read", "input": {}},
+ {"type": "tool_use", "id": "t2", "name": "Read", "input": {}},
+ ],
+ },
+ {
+ "role": "user",
+ "content": [
+ {
+ "type": "tool_result",
+ "tool_use_id": "t2",
+ "content": "text result",
+ },
+ {
+ "type": "tool_result",
+ "tool_use_id": "t1",
+ "content": [
+ {
+ "type": "image",
+ "source": {
+ "type": "base64",
+ "media_type": "image/png",
+ "data": "YQ==",
+ },
+ }
+ ],
+ },
+ ],
+ },
+ ],
+ }
+ )
+
+ body = deepseek_provider._chat._build_request_body(request, reasoning=REASONING_ON)
+
+ messages = body["messages"]
+ assert [message["role"] for message in messages] == [
+ "assistant",
+ "tool",
+ "tool",
+ "assistant",
+ "user",
+ ]
+ assert [message["tool_call_id"] for message in messages[1:3]] == ["t1", "t2"]
+ assert (
+ messages[1]["content"] == "[Image-bearing tool output follows in user content.]"
+ )
+ assert messages[2]["content"] == "text result"
+ assert is_synthetic_chat_tool_turn_boundary(messages[3])
+ assert messages[3]["reasoning_content"] == ""
+ assert messages[4]["content"] == [
+ {"type": "text", "text": 'Image-bearing output for tool call "t1":'},
+ {"type": "image_url", "image_url": {"url": "data:image/png;base64,YQ=="}},
+ ]
+
+
[email protected]("inside_tool_result", [False, True])
+def test_mixed_attachment_content_omits_only_document(
+ deepseek_provider, inside_tool_result
+):
+ content = [
+ {
+ "type": "image",
+ "source": {"type": "base64", "media_type": "image/png", "data": "YQ=="},
+ },
+ {"type": "document", "source": {"type": "file", "file_id": "private_pdf"}},
+ ]
+ messages = [{"role": "user", "content": content}]
+ if inside_tool_result:
+ messages = [
+ {
+ "role": "assistant",
+ "content": [
+ {"type": "tool_use", "id": "t1", "name": "Read", "input": {}}
+ ],
+ },
+ {
+ "role": "user",
+ "content": [
+ {"type": "tool_result", "tool_use_id": "t1", "content": content}
+ ],
+ },
+ ]
+ request = MessagesRequest.model_validate(
+ {"model": "deepseek-flash", "messages": messages}
+ )
+ original = request.model_dump()
+
+ body = deepseek_provider._chat._build_request_body(request, reasoning=REASONING_OFF)
+
+ images = [
+ part
+ for message in body["messages"]
+ if isinstance(message.get("content"), list)
+ for part in message["content"]
+ if part.get("type") == "image_url"
+ ]
+ assert images == [
+ {"type": "image_url", "image_url": {"url": "data:image/png;base64,YQ=="}}
+ ]
+ assert "private_pdf" not in json.dumps(body["messages"])
+ assert request.model_dump() == original
+
+
+ ("source", "error"),
+ [
+ (
+ {
+ "type": "base64",
+ "media_type": "image/png",
+ "data": "private_invalid_base64",
+ },
+ "Image data is not valid base64",
+ ),
+ (
+ {"type": "file", "file_id": "private_file"},
+ "cannot cross this protocol boundary",
+ ),
+ ({"type": "url", "url": ""}, "Image URL must be a non-empty string"),
+ ],
+)
+def test_rejects_unportable_image_without_exposing_source(
+ deepseek_provider, source, error
+):
+ request = MessagesRequest(
+ model="deepseek-flash",
+ messages=[
+ Message(
+ role="user", content=[ContentBlockImage(type="image", source=source)]
+ )
+ ],
)
+
+ with pytest.raises(InvalidRequestError, match=error) as exc_info:
+ deepseek_provider._chat._build_request_body(request, reasoning=REASONING_OFF)
+
+ assert "private_" not in str(exc_info.value)
+
+
+def test_shared_conversion_rejects_assistant_image(deepseek_provider):
+ image = {
+ "type": "image",
+ "source": {"type": "url", "url": "https://images.example.test/shot.png"},
+ }
+ request = MessagesRequest.model_validate(
+ {
+ "model": "deepseek-flash",
+ "messages": [{"role": "assistant", "content": [image]}],
+ }
+ )
+
+ with pytest.raises(InvalidRequestError, match="Assistant image blocks"):
+ deepseek_provider._chat._build_request_body(request, reasoning=REASONING_OFF)
+
+
[email protected]("wire_api", ["messages", "responses"])
+async def test_upstream_image_rejection_preserves_image_and_fails_once(
+ deepseek_provider, wire_api
+):
+ if wire_api == "messages":
+ request = MessagesRequest(
+ model="deepseek-flash",
+ messages=[
+ Message(
+ role="user",
+ content=[
+ ContentBlockImage(
+ type="image",
+ source={
+ "type": "base64",
+ "media_type": "image/png",
+ "data": "YQ==",
+ },
+ )
+ ],
+ )
+ ],
+ )
+ stream = deepseek_provider.stream_messages(request, reasoning=REASONING_OFF)
+ else:
+ responses_request = OpenAIResponsesRequest.model_validate(
+ {
+ "model": "deepseek-flash",
+ "input": [
+ {
+ "role": "user",
+ "content": [
+ {
+ "type": "input_image",
+ "image_url": "data:image/png;base64,YQ==",
+ }
+ ],
+ }
+ ],
+ }
+ )
+ stream = deepseek_provider.stream_responses(
+ responses_request, reasoning=REASONING_OFF
+ )
+ error = BadRequestError(
+ "This model does not support image inputs",
+ response=httpx2.Response(
+ 400,
+ request=httpx2.Request("POST", "https://provider.invalid/chat/completions"),
+ ),
+ body={
+ "error": {
+ "type": "invalid_request_error",
+ "message": "This model does not support image inputs",
+ }
+ },
+ )
+
+ try:
+ with (
+ patch.object(
+ deepseek_provider._client.chat.completions,
+ "create",
+ new_callable=AsyncMock,
+ side_effect=error,
+ ) as create,
+ pytest.raises(ExecutionFailure) as exc_info,
+ ):
+ async for _ in stream:
+ pass
+
+ assert create.call_count == 1
+ assert create.call_args.kwargs["messages"] == [
+ {
+ "role": "user",
+ "content": [
+ {
+ "type": "image_url",
+ "image_url": {"url": "data:image/png;base64,YQ=="},
+ }
+ ],
+ }
+ ]
+ assert exc_info.value.kind is FailureKind.INVALID_REQUEST
+ assert exc_info.value.status_code == 400
+ assert exc_info.value.retryable is False
+ assert "does not support image inputs" in exc_info.value.message
+ finally:
+ await deepseek_provider.cleanup()
diff --git a/uv.lock b/uv.lock
index 1b7eee52..409cdeb6 100644
--- a/uv.lock
+++ b/uv.lock
@@ -598,7 +598,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "6.2.25"
+version = "6.2.26"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },