feat(tool runner): add support for server-side tools

Author: karpetrosyan

.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: '0.8.11'
+          version: '0.9.13'
 
       - name: Install dependencies
         run: uv sync --all-extras
@@ -46,7 +46,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: '0.8.11'
+          version: '0.9.13'
 
       - name: Install dependencies
         run: uv sync --all-extras
@@ -80,7 +80,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: '0.8.11'
+          version: '0.9.13'
 
       - name: Bootstrap
         run: ./scripts/bootstrap

.github/workflows/create-releases.yml

@@ -26,7 +26,7 @@ jobs:
         if: ${{ steps.release.outputs.releases_created }}
         uses: astral-sh/setup-uv@v5
         with:
-          version: '0.8.11'
+          version: '0.9.13'
 
       - name: Publish to PyPI
         if: ${{ steps.release.outputs.releases_created }}

.github/workflows/detect-breaking-changes.yml

@@ -23,7 +23,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: '0.8.11'
+          version: '0.9.13'
       - name: Install dependencies
         run: uv sync --all-extras
       - name: Detect removed symbols

.github/workflows/publish-pypi.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: '0.8.11'
+          version: '0.9.13'
 
       - name: Publish to PyPI
         run: |

pyproject.toml

@@ -47,7 +47,7 @@ Repository = "https://github.com/anthropics/anthropic-sdk-python"
 
 [tool.uv]
 managed = true
-required-version = ">=0.5.0"
+required-version = ">=0.9"
 conflicts = [
     [
       { group = "pydantic-v1" },

src/anthropic/resources/beta/messages/messages.py

@@ -47,7 +47,14 @@
 from ....lib._parse._response import ResponseFormatT, parse_response
 from ....lib._parse._transform import transform_schema
 from ....types.beta.beta_message import BetaMessage
-from ....lib.tools._beta_functions import BetaRunnableTool, BetaAsyncRunnableTool
+from ....lib.tools._beta_functions import (
+    BetaFunctionTool,
+    BetaRunnableTool,
+    BetaAsyncFunctionTool,
+    BetaAsyncRunnableTool,
+    BetaBuiltinFunctionTool,
+    BetaAsyncBuiltinFunctionTool,
+)
 from ....types.anthropic_beta_param import AnthropicBetaParam
 from ....types.beta.beta_message_param import BetaMessageParam
 from ....types.beta.beta_metadata_param import BetaMetadataParam
@@ -1174,7 +1181,7 @@ def tool_runner(
         max_tokens: int,
         messages: Iterable[BetaMessageParam],
         model: ModelParam,
-        tools: Iterable[BetaRunnableTool],
+        tools: Iterable[BetaRunnableTool | BetaToolUnionParam],
         compaction_control: CompactionControl | Omit = omit,
         container: Optional[message_create_params.Container] | Omit = omit,
         context_management: Optional[BetaContextManagementConfigParam] | Omit = omit,
@@ -1208,7 +1215,7 @@ def tool_runner(
         max_tokens: int,
         messages: Iterable[BetaMessageParam],
         model: ModelParam,
-        tools: Iterable[BetaRunnableTool],
+        tools: Iterable[BetaRunnableTool | BetaToolUnionParam],
         compaction_control: CompactionControl | Omit = omit,
         stream: Literal[True],
         max_iterations: int | Omit = omit,
@@ -1242,7 +1249,7 @@ def tool_runner(
         max_tokens: int,
         messages: Iterable[BetaMessageParam],
         model: ModelParam,
-        tools: Iterable[BetaRunnableTool],
+        tools: Iterable[BetaRunnableTool | BetaToolUnionParam],
         compaction_control: CompactionControl | Omit = omit,
         stream: bool,
         max_iterations: int | Omit = omit,
@@ -1275,7 +1282,7 @@ def tool_runner(
         max_tokens: int,
         messages: Iterable[BetaMessageParam],
         model: ModelParam,
-        tools: Iterable[BetaRunnableTool],
+        tools: Iterable[BetaRunnableTool | BetaToolUnionParam],
         compaction_control: CompactionControl | Omit = omit,
         max_iterations: int | Omit = omit,
         container: Optional[message_create_params.Container] | Omit = omit,
@@ -1315,6 +1322,15 @@ def tool_runner(
             **(extra_headers or {}),
         }
 
+        runnable_tools: list[BetaRunnableTool] = []
+        regular_tools: list[BetaToolUnionParam] = []
+
+        for tool in tools:
+            if isinstance(tool, (BetaFunctionTool, BetaBuiltinFunctionTool)):
+                runnable_tools.append(tool)
+            else:
+                regular_tools.append(tool)
+
         params = cast(
             message_create_params.ParseMessageCreateParamsBase[ResponseFormatT],
             {
@@ -1333,15 +1349,15 @@ def tool_runner(
                 "temperature": temperature,
                 "thinking": thinking,
                 "tool_choice": tool_choice,
-                "tools": [tool.to_dict() for tool in tools],
+                "tools": [*[tool.to_dict() for tool in runnable_tools], *regular_tools],
                 "top_k": top_k,
                 "top_p": top_p,
             },
         )
 
         if stream:
             return BetaStreamingToolRunner[ResponseFormatT](
-                tools=tools,
+                tools=runnable_tools,
                 params=params,
                 options={
                     "extra_headers": extra_headers,
@@ -1354,7 +1370,7 @@ def tool_runner(
                 compaction_control=compaction_control if is_given(compaction_control) else None,
             )
         return BetaToolRunner[ResponseFormatT](
-            tools=tools,
+            tools=runnable_tools,
             params=params,
             options={
                 "extra_headers": extra_headers,
@@ -2821,7 +2837,7 @@ def tool_runner(
         max_tokens: int,
         messages: Iterable[BetaMessageParam],
         model: ModelParam,
-        tools: Iterable[BetaAsyncRunnableTool],
+        tools: Iterable[BetaAsyncRunnableTool | BetaToolUnionParam],
         compaction_control: CompactionControl | Omit = omit,
         max_iterations: int | Omit = omit,
         container: Optional[message_create_params.Container] | Omit = omit,
@@ -2855,7 +2871,7 @@ def tool_runner(
         max_tokens: int,
         messages: Iterable[BetaMessageParam],
         model: ModelParam,
-        tools: Iterable[BetaAsyncRunnableTool],
+        tools: Iterable[BetaAsyncRunnableTool | BetaToolUnionParam],
         compaction_control: CompactionControl | Omit = omit,
         stream: Literal[True],
         max_iterations: int | Omit = omit,
@@ -2889,7 +2905,7 @@ def tool_runner(
         max_tokens: int,
         messages: Iterable[BetaMessageParam],
         model: ModelParam,
-        tools: Iterable[BetaAsyncRunnableTool],
+        tools: Iterable[BetaAsyncRunnableTool | BetaToolUnionParam],
         compaction_control: CompactionControl | Omit = omit,
         stream: bool,
         max_iterations: int | Omit = omit,
@@ -2922,7 +2938,7 @@ def tool_runner(
         max_tokens: int,
         messages: Iterable[BetaMessageParam],
         model: ModelParam,
-        tools: Iterable[BetaAsyncRunnableTool],
+        tools: Iterable[BetaAsyncRunnableTool | BetaToolUnionParam],
         compaction_control: CompactionControl | Omit = omit,
         max_iterations: int | Omit = omit,
         container: Optional[message_create_params.Container] | Omit = omit,
@@ -2962,6 +2978,15 @@ def tool_runner(
             **(extra_headers or {}),
         }
 
+        runnable_tools: list[BetaAsyncRunnableTool] = []
+        regular_tools: list[BetaToolUnionParam] = []
+
+        for tool in tools:
+            if isinstance(tool, (BetaAsyncFunctionTool, BetaAsyncBuiltinFunctionTool)):
+                runnable_tools.append(tool)
+            else:
+                regular_tools.append(tool)
+
         params = cast(
             message_create_params.ParseMessageCreateParamsBase[ResponseFormatT],
             {
@@ -2980,15 +3005,15 @@ def tool_runner(
                 "temperature": temperature,
                 "thinking": thinking,
                 "tool_choice": tool_choice,
-                "tools": [tool.to_dict() for tool in tools],
+                "tools": [*[tool.to_dict() for tool in runnable_tools], *regular_tools],
                 "top_k": top_k,
                 "top_p": top_p,
             },
         )
 
         if stream:
             return BetaAsyncStreamingToolRunner[ResponseFormatT](
-                tools=tools,
+                tools=runnable_tools,
                 params=params,
                 options={
                     "extra_headers": extra_headers,
@@ -3001,7 +3026,7 @@ def tool_runner(
                 compaction_control=compaction_control if is_given(compaction_control) else None,
             )
         return BetaAsyncToolRunner[ResponseFormatT](
-            tools=tools,
+            tools=runnable_tools,
             params=params,
             options={
                 "extra_headers": extra_headers,

tests/lib/tools/__inline_snapshot__/test_runners/TestSyncRunTools.test_server_side_tool/a0a711eb-ee0e-4a42-88d6-5c7f83c0f25a.txt

@@ -510,6 +510,43 @@ def tool_runner(client: Anthropic) -> BetaToolRunner[None]:
             ]
         )
 
+    @pytest.mark.parametrize("client", [False], indirect=True)
+    @pytest.mark.respx(base_url=base_url)
+    def test_server_side_tool(
+        self,
+        client: Anthropic,
+        respx_mock: MockRouter,
+    ) -> None:
+        def tool_runner(client: Anthropic) -> BetaToolRunner[None]:
+            runner = client.beta.messages.tool_runner(
+                model="claude-haiku-4-5",
+                messages=[{"role": "user", "content": "What is the weather in SF?"}],
+                tools=[
+                    {
+                        "type": "web_search_20250305",
+                        "name": "web_search",
+                    }
+                ],
+                max_tokens=1024,
+            )
+
+            message = next(runner)
+
+            content_types = [content.type for content in message.content]
+
+            assert "server_tool_use" in content_types
+            assert "web_search_tool_result" in content_types
+
+            return runner
+
+        make_snapshot_request(
+            tool_runner,
+            content_snapshot=external("uuid:a0a711eb-ee0e-4a42-88d6-5c7f83c0f25a.txt"),
+            path="/v1/messages",
+            mock_client=client,
+            respx_mock=respx_mock,
+        )
+
 
 @pytest.mark.skipif(PYDANTIC_V1, reason="tool runner not supported with pydantic v1")
 @pytest.mark.respx(base_url=base_url)