chore: import upstream snapshot with attribution

2026-07-13 12:35:30 +08:00
commit 26382a7ac6
2353 changed files with 629146 additions and 0 deletions
@@ -0,0 +1,31 @@
+"""Extract plain text from an MCP tool result.
+
+Mirrors `toolText.ts` / `tool_text.rs` so all SDKs flatten tool results the same
+way: concatenate the ``text`` of every ``{"type": "text", "text": ...}`` content
+block. Non-text blocks are ignored; a bare string result is returned as-is.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+def tool_result_to_text(result: Any) -> str:
+    """Flatten an MCP tool result into a single text string."""
+    if result is None:
+        return ""
+    if isinstance(result, str):
+        return result
+    if isinstance(result, dict):
+        content = result.get("content")
+        if isinstance(content, list):
+            parts = []
+            for block in content:
+                if (
+                    isinstance(block, dict)
+                    and block.get("type") == "text"
+                    and isinstance(block.get("text"), str)
+                ):
+                    parts.append(block["text"])
+            return "".join(parts)
+    return ""