admin/CC-Switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-08-02 02:05:57 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat(proxy): extend tool-result media handling to all conversion bridges

Browse Source 
Generalize the Codex Responses-to-Chat tool media mechanism from 6c9d444c
to the remaining protocol bridges, so image-bearing tool results are never
tokenized as base64 text on any conversion path:

- Claude-to-Chat: tool_result images become native image_url parts,
  batched into one synthetic user message after the tool message batch.
- Claude-to-Responses: JSON-string, MCP, and nested variants are restored
  as native input_image parts inside function_call_output.
- Codex/GrokBuild-to-Anthropic: non-standard tool images are restored as
  Anthropic image blocks (case-insensitive data:/http prefix parsing).
- Claude-to-Gemini: Gemini 3 uses multimodal functionResponse.parts;
  older models get inlineData parts in the same user turn. The new
  InlineImagesOnly scope keeps remote URLs and malformed data URLs in the
  legacy text form instead of emitting fileData the API would reject.

Shared changes in tool_media:

- Centralize the plan/queue/flush helpers used by both Chat bridges.
- strip_and_clamp_media_from_tool_value clamps residual base64 inside
  parsed JSON strings at any nesting depth before re-serialization.
- Emitted Chat parts no longer carry cache_control or
  prompt_cache_breakpoint, preserving the strip-all-cache_control
  contract that strict upstreams (GLM/Qwen) depend on.
- Media detection now requires full convertibility, keeping detection
  and extraction symmetric by construction.

The media sanitizer detects and strips the new shapes symmetrically
(Chat string tool results, Anthropic string tool results, Gemini
inlineData/fileData and functionResponse.parts); the legacy typed-block
replacement runs first so replacement stays a superset of detection and
cache_control survives on replaced Anthropic blocks.

No-media tool outputs keep byte-identical legacy representations on all
bridges to protect prompt-cache prefixes.
This commit is contained in:
Jason
2026-07-24 12:12:22 +08:00
parent 6c9d444c8a
commit 878c26f31e
8 changed files with 1666 additions and 185 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src-tauri/src/proxy/providers/transform_gemini.rs
+386 -3
View File
@@ -7,6 +7,9 @@
use super::gemini_schema::build_gemini_function_declaration;
use super::gemini_shadow::{GeminiAssistantTurn, GeminiShadowStore, GeminiToolCallMeta};
use crate::proxy::error::ProxyError;
use crate::proxy::tool_media::{
strip_and_clamp_media_from_tool_value, ToolMediaScope, TOOL_RESULT_MEDIA_ATTACHED_MARKER,
};
use serde_json::{json, Map, Value};
use std::collections::{HashMap, HashSet};
@@ -61,6 +64,10 @@ pub fn anthropic_to_gemini_with_shadow(
.and_then(|((store, provider_id), session_id)| store.get_session(provider_id, session_id))
.map(|snapshot| snapshot.turns)
.unwrap_or_default();
let supports_multimodal_function_response = body
.get("model")
.and_then(Value::as_str)
.is_some_and(is_gemini_3_series);
let messages = body.get("messages").and_then(|value| value.as_array());
@@ -73,7 +80,11 @@ pub fn anthropic_to_gemini_with_shadow(
}
if let Some(messages) = messages {
result["contents"] = json!(convert_messages_to_contents(messages, &shadow_turns)?);
result["contents"] = json!(convert_messages_to_contents(
messages,
&shadow_turns,
supports_multimodal_function_response,
)?);
}
if let Some(generation_config) = build_generation_config(&body) {
@@ -361,6 +372,7 @@ fn build_generation_config(body: &Value) -> Option<Value> {
fn convert_messages_to_contents(
messages: &[Value],
shadow_turns: &[GeminiAssistantTurn],
supports_multimodal_function_response: bool,
) -> Result<Vec<Value>, ProxyError> {
let mut contents = Vec::new();
let mut used_shadow_indices = HashSet::new();
@@ -446,6 +458,7 @@ fn convert_messages_to_contents(
role,
&mut tool_name_by_id,
&thought_signature_by_id,
supports_multimodal_function_response,
)?
}
} else {
@@ -454,6 +467,7 @@ fn convert_messages_to_contents(
role,
&mut tool_name_by_id,
&thought_signature_by_id,
supports_multimodal_function_response,
)?
}
} else {
@@ -462,6 +476,7 @@ fn convert_messages_to_contents(
role,
&mut tool_name_by_id,
&thought_signature_by_id,
supports_multimodal_function_response,
)?
};
@@ -560,6 +575,7 @@ fn convert_message_content_to_parts(
role: &str,
tool_name_by_id: &mut std::collections::HashMap<String, String>,
thought_signature_by_id: &std::collections::HashMap<String, String>,
supports_multimodal_function_response: bool,
) -> Result<Vec<Value>, ProxyError> {
let Some(content) = content else {
return Ok(Vec::new());
@@ -705,16 +721,31 @@ fn convert_message_content_to_parts(
))
})?;
let (response, media_parts) = plan_gemini_tool_result(block.get("content"));
// See `tool_use` above: synthesized ids must not leak upstream.
let mut function_response = json!({
"name": name,
"response": normalize_tool_result_response(block.get("content"))
"response": response
});
if !tool_use_id.is_empty() && !is_synthesized_tool_call_id(tool_use_id) {
function_response["id"] = json!(tool_use_id);
}
parts.push(json!({ "functionResponse": function_response }));
if supports_multimodal_function_response && !media_parts.is_empty() {
function_response["parts"] = Value::Array(media_parts);
parts.push(json!({ "functionResponse": function_response }));
} else {
parts.push(json!({ "functionResponse": function_response }));
if !media_parts.is_empty() {
parts.push(json!({
"text": format!(
"[cc-switch: media output of tool call {tool_use_id}]"
)
}));
parts.extend(media_parts);
}
}
}
"thinking" | "redacted_thinking" => {}
_ => {}
@@ -745,6 +776,74 @@ fn normalize_tool_result_response(content: Option<&Value>) -> Value {
}
}
fn plan_gemini_tool_result(content: Option<&Value>) -> (Value, Vec<Value>) {
let Some(content) = content else {
return (normalize_tool_result_response(None), Vec::new());
};
let mut cleaned = content.clone();
let replacement_block = json!({
"type":"text",
"text":TOOL_RESULT_MEDIA_ATTACHED_MARKER
});
let mut chat_media_parts = Vec::new();
let replaced = strip_and_clamp_media_from_tool_value(
&mut cleaned,
&mut chat_media_parts,
ToolMediaScope::InlineImagesOnly,
&replacement_block,
TOOL_RESULT_MEDIA_ATTACHED_MARKER,
);
if replaced == 0 {
return (normalize_tool_result_response(Some(content)), Vec::new());
}
let mut gemini_parts = Vec::new();
gemini_parts.extend(
chat_media_parts
.iter()
.filter_map(gemini_part_from_chat_image),
);
(normalize_tool_result_response(Some(&cleaned)), gemini_parts)
}
fn is_gemini_3_series(model: &str) -> bool {
let normalized = model.trim().to_ascii_lowercase();
normalized.starts_with("gemini-3")
|| normalized
.rsplit('/')
.next()
.is_some_and(|tail| tail.starts_with("gemini-3"))
}
fn gemini_part_from_chat_image(part: &Value) -> Option<Value> {
let image_url = part
.pointer("/image_url/url")
.and_then(Value::as_str)
.filter(|url| !url.trim().is_empty())?;
if image_url
.get(..5)
.is_some_and(|prefix| prefix.eq_ignore_ascii_case("data:"))
{
let rest = &image_url[5..];
let (meta, data) = rest.split_once(',')?;
if data.is_empty() || !meta.to_ascii_lowercase().contains(";base64") {
return None;
}
let mime_type = meta.split(';').next().unwrap_or("image/png");
return Some(json!({
"inlineData": {
"mimeType": mime_type,
"data": data
}
}));
}
None
}
fn shadow_parts(content: &Value) -> Option<Vec<Value>> {
let mut parts = content
.get("parts")
@@ -1266,6 +1365,290 @@ mod tests {
);
}
#[test]
fn anthropic_to_gemini_moves_mixed_tool_result_image_to_native_part() {
let input = json!({
"messages": [
{
"role": "assistant",
"content": [{
"type": "tool_use",
"id": "call_image",
"name": "inspect",
"input": {}
}]
},
{
"role": "user",
"content": [{
"type": "tool_result",
"tool_use_id": "call_image",
"content": [
{"type": "text", "text": "caption"},
{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/png",
"data": "GEMINI_TOOL_IMAGE_SENTINEL"
}
}
]
}]
}
]
});
let result = anthropic_to_gemini(input).unwrap();
let parts = result["contents"][1]["parts"].as_array().unwrap();
let response = &parts[0]["functionResponse"]["response"]["content"];
assert!(response.as_str().unwrap().contains("caption"));
assert!(response
.as_str()
.unwrap()
.contains("tool result media attached"));
assert!(!response
.as_str()
.unwrap()
.contains("GEMINI_TOOL_IMAGE_SENTINEL"));
assert_eq!(
parts[1]["text"],
"[cc-switch: media output of tool call call_image]"
);
assert_eq!(parts[2]["inlineData"]["mimeType"], "image/png");
assert_eq!(parts[2]["inlineData"]["data"], "GEMINI_TOOL_IMAGE_SENTINEL");
}
#[test]
fn anthropic_to_gemini_clamps_json_string_residual_base64_before_serializing() {
let residual_base64 = "A".repeat(20_000);
let encoded = json!({
"content": [
{
"type": "image_url",
"image_url": {
"url": "data:image/png;base64,GEMINI_STRING_IMAGE_SENTINEL"
}
},
{"type": "video", "data": residual_base64}
]
})
.to_string();
let input = json!({
"messages": [
{
"role": "assistant",
"content": [{
"type": "tool_use",
"id": "call_string",
"name": "inspect",
"input": {}
}]
},
{
"role": "user",
"content": [{
"type": "tool_result",
"tool_use_id": "call_string",
"content": encoded
}]
}
]
});
let result = anthropic_to_gemini(input).unwrap();
let serialized = result.to_string();
assert!(serialized.contains("[cc-switch: omitted 20000 bytes]"));
assert!(!serialized.contains(&"A".repeat(64)));
assert_eq!(
result["contents"][1]["parts"][2]["inlineData"]["data"],
"GEMINI_STRING_IMAGE_SENTINEL"
);
}
#[test]
fn anthropic_to_gemini_keeps_remote_tool_image_in_legacy_response() {
let remote_image = json!({
"type": "image",
"source": {
"type": "url",
"url": "https://example.com/tool-image.png"
}
});
let input = json!({
"messages": [
{
"role": "assistant",
"content": [{
"type": "tool_use",
"id": "call_remote",
"name": "inspect",
"input": {}
}]
},
{
"role": "user",
"content": [{
"type": "tool_result",
"tool_use_id": "call_remote",
"content": [remote_image.clone()]
}]
}
]
});
let result = anthropic_to_gemini(input).unwrap();
let parts = result["contents"][1]["parts"].as_array().unwrap();
assert_eq!(parts.len(), 1);
assert_eq!(
parts[0]["functionResponse"]["response"]["content"][0],
remote_image
);
assert!(!result.to_string().contains("fileData"));
assert!(!result
.to_string()
.contains(TOOL_RESULT_MEDIA_ATTACHED_MARKER));
}
#[test]
fn anthropic_to_gemini_does_not_strip_unconvertible_tool_data_url() {
let malformed_image = json!({
"type": "image_url",
"image_url": {
"url": "data:image/png,NOT_BASE64"
}
});
let input = json!({
"messages": [
{
"role": "assistant",
"content": [{
"type": "tool_use",
"id": "call_malformed",
"name": "inspect",
"input": {}
}]
},
{
"role": "user",
"content": [{
"type": "tool_result",
"tool_use_id": "call_malformed",
"content": [malformed_image.clone()]
}]
}
]
});
let result = anthropic_to_gemini(input).unwrap();
let parts = result["contents"][1]["parts"].as_array().unwrap();
assert_eq!(parts.len(), 1);
assert_eq!(
parts[0]["functionResponse"]["response"]["content"][0],
malformed_image
);
assert!(!result.to_string().contains("inlineData"));
assert!(!result
.to_string()
.contains(TOOL_RESULT_MEDIA_ATTACHED_MARKER));
}
#[test]
fn anthropic_to_gemini_does_not_embed_image_only_tool_result_as_json() {
let input = json!({
"messages": [
{
"role": "assistant",
"content": [{
"type": "tool_use",
"id": "call_image",
"name": "inspect",
"input": {}
}]
},
{
"role": "user",
"content": [{
"type": "tool_result",
"tool_use_id": "call_image",
"content": [{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/webp",
"data": "IMAGE_ONLY_SENTINEL"
}
}]
}]
}
]
});
let result = anthropic_to_gemini(input).unwrap();
let parts = result["contents"][1]["parts"].as_array().unwrap();
let response = &parts[0]["functionResponse"]["response"]["content"];
assert!(response.is_string());
assert!(!response.as_str().unwrap().contains("IMAGE_ONLY_SENTINEL"));
assert_eq!(parts[2]["inlineData"]["mimeType"], "image/webp");
assert_eq!(parts[2]["inlineData"]["data"], "IMAGE_ONLY_SENTINEL");
}
#[test]
fn anthropic_to_gemini_3_uses_multimodal_function_response_parts() {
let input = json!({
"model": "gemini-3-pro-preview",
"messages": [
{
"role": "assistant",
"content": [{
"type": "tool_use",
"id": "call_image",
"name": "inspect",
"input": {}
}]
},
{
"role": "user",
"content": [{
"type": "tool_result",
"tool_use_id": "call_image",
"content": [{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/jpeg",
"data": "GEMINI_3_IMAGE_SENTINEL"
}
}]
}]
}
]
});
let result = anthropic_to_gemini(input).unwrap();
let parts = result["contents"][1]["parts"].as_array().unwrap();
let function_response = &parts[0]["functionResponse"];
assert_eq!(parts.len(), 1);
assert_eq!(
function_response["parts"][0]["inlineData"]["mimeType"],
"image/jpeg"
);
assert_eq!(
function_response["parts"][0]["inlineData"]["data"],
"GEMINI_3_IMAGE_SENTINEL"
);
assert!(!function_response["response"]["content"]
.as_str()
.unwrap()
.contains("GEMINI_3_IMAGE_SENTINEL"));
}
#[test]
fn anthropic_to_gemini_resolves_tool_result_name_from_shadow_content() {
let store = GeminiShadowStore::with_limits(8, 4);