anthropic 0.74.1__tar.gz → 0.76.0__tar.gz

anthropic-0.76.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.76.0"
+}

{anthropic-0.74.1 → anthropic-0.76.0}/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## 0.76.0 (2026-01-13)
+
+Full Changelog: [v0.75.0...v0.76.0](https://github.com/anthropics/anthropic-sdk-python/compare/v0.75.0...v0.76.0)
+
+### Features
+
+* allow raw JSON schema to be passed to messages.stream() ([955c61d](https://github.com/anthropics/anthropic-sdk-python/commit/955c61dd5aae4c8a2c7b8fab1f97a0b88c0ef03b))
+* **client:** add support for binary request streaming ([5302f27](https://github.com/anthropics/anthropic-sdk-python/commit/5302f2724c9890340c1b0dd042a1e670ed00eb93))
+* **tool runner:** add support for server-side tools ([#1086](https://github.com/anthropics/anthropic-sdk-python/issues/1086)) ([1521316](https://github.com/anthropics/anthropic-sdk-python/commit/15213160a016a70538c81163c49ce5948fe06879))
+
+
+### Bug Fixes
+
+* **client:** loosen auth header validation ([5a0b89b](https://github.com/anthropics/anthropic-sdk-python/commit/5a0b89bb2c808cd0a413697a1141d4835ce00181))
+* ensure streams are always closed ([388bd0c](https://github.com/anthropics/anthropic-sdk-python/commit/388bd0cbc53c4d8d8884d17a3051623728588eb4))
+* **types:** allow pyright to infer TypedDict types within SequenceNotStr ([ede3242](https://github.com/anthropics/anthropic-sdk-python/commit/ede32426043273f9b31e70893207ad6519240591))
+* use async_to_httpx_files in patch method ([718fa8e](https://github.com/anthropics/anthropic-sdk-python/commit/718fa8e62aa939dd8c5d46430aa1d1b05a5906d9))
+
+
+### Chores
+
+* add missing docstrings ([d306605](https://github.com/anthropics/anthropic-sdk-python/commit/d306605103649320e900ab3a2413d0dbd6b118c5))
+* bump required `uv` version ([90634f3](https://github.com/anthropics/anthropic-sdk-python/commit/90634f3ef0a9d7ae5a1945f005b13aad245f6b32))
+* **ci:** Add Claude Code GitHub Workflow ([#1293](https://github.com/anthropics/anthropic-sdk-python/issues/1293)) ([83d1c4a](https://github.com/anthropics/anthropic-sdk-python/commit/83d1c4aef1ae34b1aebe4ca25de8b0cd2d37a493))
+* **deps:** mypy 1.18.1 has a regression, pin to 1.17 ([21c6374](https://github.com/anthropics/anthropic-sdk-python/commit/21c6374f3825f43e104bad4a5df71941bcf09844))
+* **docs:** use environment variables for authentication in code snippets ([87aa378](https://github.com/anthropics/anthropic-sdk-python/commit/87aa378f13f64099bec9513cba85ba9723773ec4))
+* fix docstring ([51fca79](https://github.com/anthropics/anthropic-sdk-python/commit/51fca7942b4e74e1357fb72828e8e39a8b8eea6a))
+* **internal:** add `--fix` argument to lint script ([8914b7a](https://github.com/anthropics/anthropic-sdk-python/commit/8914b7abe9b98565f08f4965f7fd0da8cd9f1f08))
+* **internal:** add missing files argument to base client ([6285abc](https://github.com/anthropics/anthropic-sdk-python/commit/6285abcba9945a7c6c6b713940ee0478dfe25008))
+* **internal:** avoid using unstable Python versions in tests ([4547171](https://github.com/anthropics/anthropic-sdk-python/commit/4547171aba17e41ff2f2e2c13d319b6bc1a13e85))
+* update lockfile ([d7ae1fc](https://github.com/anthropics/anthropic-sdk-python/commit/d7ae1fc9c06d7565b909e5c2d48ebeb63ee9d8c9))
+* update uv.lock ([746ac05](https://github.com/anthropics/anthropic-sdk-python/commit/746ac05cbb18c7d596a381e2fe89d0ee3e4e94b9))
+
+## 0.75.0 (2025-11-24)
+
+Full Changelog: [v0.74.1...v0.75.0](https://github.com/anthropics/anthropic-sdk-python/compare/v0.74.1...v0.75.0)
+
+### Features
+
+* **api:** adds support for Claude Opus 4.5, Effort, Advance Tool Use Features, Autocompaction, and Computer Use v5 ([5c3e633](https://github.com/anthropics/anthropic-sdk-python/commit/5c3e633395acc100c45e8a403f1b5be4d17a3b32))
+
+
+### Bug Fixes
+
+* **internal:** small fixes ([36c82f7](https://github.com/anthropics/anthropic-sdk-python/commit/36c82f72b588bd549770a89072dd52d6f9e5b6a5))
+
+
+### Chores
+
+* fix lint issues ([4f1fd54](https://github.com/anthropics/anthropic-sdk-python/commit/4f1fd54143b79a4a7976dfb332ec7bfc666d1598))
+
 ## 0.74.1 (2025-11-19)
 
 Full Changelog: [v0.74.0...v0.74.1](https://github.com/anthropics/anthropic-sdk-python/compare/v0.74.0...v0.74.1)

{anthropic-0.74.1 → anthropic-0.76.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anthropic
-Version: 0.74.1
+Version: 0.76.0
 Summary: The official Python library for the anthropic API
 Project-URL: Homepage, https://github.com/anthropics/anthropic-sdk-python
 Project-URL: Repository, https://github.com/anthropics/anthropic-sdk-python
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
@@ -136,6 +137,7 @@ pip install anthropic[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from anthropic import DefaultAioHttpClient
 from anthropic import AsyncAnthropic
@@ -143,7 +145,7 @@ from anthropic import AsyncAnthropic
 
 async def main() -> None:
     async with AsyncAnthropic(
-        api_key="my-anthropic-api-key",
+        api_key=os.environ.get("ANTHROPIC_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         message = await client.messages.create(

{anthropic-0.74.1 → anthropic-0.76.0}/README.md

@@ -95,6 +95,7 @@ pip install anthropic[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from anthropic import DefaultAioHttpClient
 from anthropic import AsyncAnthropic
@@ -102,7 +103,7 @@ from anthropic import AsyncAnthropic
 
 async def main() -> None:
     async with AsyncAnthropic(
-        api_key="my-anthropic-api-key",
+        api_key=os.environ.get("ANTHROPIC_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         message = await client.messages.create(

{anthropic-0.74.1 → anthropic-0.76.0}/api.md

@@ -256,6 +256,7 @@ from anthropic.types.beta import (
     BetaContextManagementConfig,
     BetaContextManagementResponse,
     BetaCountTokensContextManagementResponse,
+    BetaDirectCaller,
     BetaDocumentBlock,
     BetaFileDocumentSource,
     BetaFileImageSource,
@@ -264,9 +265,12 @@ from anthropic.types.beta import (
     BetaInputTokensClearAtLeast,
     BetaInputTokensTrigger,
     BetaJSONOutputFormat,
+    BetaMCPToolConfig,
+    BetaMCPToolDefaultConfig,
     BetaMCPToolResultBlock,
     BetaMCPToolUseBlock,
     BetaMCPToolUseBlockParam,
+    BetaMCPToolset,
     BetaMemoryTool20250818,
     BetaMemoryTool20250818Command,
     BetaMemoryTool20250818CreateCommand,
@@ -280,6 +284,7 @@ from anthropic.types.beta import (
     BetaMessageParam,
     BetaMessageTokensCount,
     BetaMetadata,
+    BetaOutputConfig,
     BetaPlainTextSource,
     BetaRawContentBlockDelta,
     BetaRawContentBlockDeltaEvent,
@@ -296,6 +301,7 @@ from anthropic.types.beta import (
     BetaRequestMCPServerURLDefinition,
     BetaRequestMCPToolResultBlockParam,
     BetaSearchResultBlockParam,
+    BetaServerToolCaller,
     BetaServerToolUsage,
     BetaServerToolUseBlock,
     BetaServerToolUseBlockParam,
@@ -335,7 +341,18 @@ from anthropic.types.beta import (
     BetaToolChoiceTool,
     BetaToolComputerUse20241022,
     BetaToolComputerUse20250124,
+    BetaToolComputerUse20251124,
+    BetaToolReferenceBlock,
+    BetaToolReferenceBlockParam,
     BetaToolResultBlockParam,
+    BetaToolSearchToolBm25_20251119,
+    BetaToolSearchToolRegex20251119,
+    BetaToolSearchToolResultBlock,
+    BetaToolSearchToolResultBlockParam,
+    BetaToolSearchToolResultError,
+    BetaToolSearchToolResultErrorParam,
+    BetaToolSearchToolSearchResultBlock,
+    BetaToolSearchToolSearchResultBlockParam,
     BetaToolTextEditor20241022,
     BetaToolTextEditor20250124,
     BetaToolTextEditor20250429,

anthropic-0.76.0/examples/auto_compaction.py

@@ -0,0 +1,77 @@
+"""Show the full summary content after compaction"""
+
+import json
+
+from anthropic import Anthropic
+from anthropic.lib.tools import beta_tool
+
+
+@beta_tool
+def search(query: str) -> str:
+    """Search for information."""
+    return json.dumps(
+        {
+            "results": [
+                {"title": f"Result for {query}", "content": "Lorem ipsum " * 100},
+                {"title": f"More on {query}", "content": "Detailed info " * 100},
+            ]
+        }
+    )
+
+
+@beta_tool
+def done(summary: str) -> str:  # noqa: ARG001
+    """Call when finished."""
+    return "Complete"
+
+
+client = Anthropic()
+
+runner = client.beta.messages.tool_runner(
+    model="claude-sonnet-4-20250514",
+    max_tokens=4096,
+    tools=[search, done],
+    messages=[
+        {
+            "role": "user",
+            "content": "You MUST search for EACH of these animals ONE BY ONE: dogs, cats, birds, fish, horses, elephants, lions, tigers, bears, wolves. After searching for ALL of them, call done.",
+        }
+    ],
+    compaction_control={
+        "enabled": True,
+        "context_token_threshold": 3000,  # Even lower threshold
+    },
+)
+
+prev_msg_count = 0
+for i, message in enumerate(runner):
+    curr_msg_count = len(list(runner._params["messages"]))
+    print(f"Turn {i + 1}: {message.usage.input_tokens} input tokens, {curr_msg_count} messages")
+
+    if curr_msg_count < prev_msg_count:
+        print("=" * 70)
+        print("🔄 COMPACTION OCCURRED!")
+        print("=" * 70)
+        print(f"Messages went from {prev_msg_count} → {curr_msg_count}")
+        print(f"Input tokens: {message.usage.input_tokens}")
+        print("\nNEW MESSAGES LIST:")
+        print("-" * 70)
+
+        for msg in runner._params["messages"]:
+            role = msg.get("role", "?")
+            content = msg.get("content", "")
+
+            if isinstance(content, list):
+                for block in content:
+                    if isinstance(block, dict) and block.get("type") == "text":
+                        print(f"\n[{role}] TEXT BLOCK:")
+                        print(block.get("text", ""))
+            elif isinstance(content, str):
+                print(f"\n[{role}]:")
+                print(content)
+
+        print("-" * 70)
+
+    prev_msg_count = curr_msg_count
+
+print("\n✅ Done!")

anthropic-0.76.0/examples/tools_runner_search_tool.py

@@ -0,0 +1,80 @@
+import json
+from typing import Any, List
+from typing_extensions import Literal
+
+import rich
+
+from anthropic import Anthropic, beta_tool
+from anthropic.lib.tools import BetaFunctionTool, BetaFunctionToolResultType
+from anthropic.types.beta import BetaToolReferenceBlockParam
+
+client = Anthropic()
+
+
+@beta_tool(defer_loading=True)
+def get_weather(location: str, units: Literal["c", "f"]) -> str:
+    """Lookup the weather for a given city in either celsius or fahrenheit
+
+    Args:
+        location: The city and state, e.g. San Francisco, CA
+        units: Unit for the output, either 'c' for celsius or 'f' for fahrenheit
+    Returns:
+        A dictionary containing the location, temperature, and weather condition.
+    """
+    # Simulate a weather API call
+    print(f"Fetching weather for {location} in {units}")
+
+    # Here you would typically make an API call to a weather service
+    # For demonstration, we return a mock response
+    if units == "c":
+        return json.dumps(
+            {
+                "location": location,
+                "temperature": "20°C",
+                "condition": "Sunny",
+            }
+        )
+    else:
+        return json.dumps(
+            {
+                "location": location,
+                "temperature": "68°F",
+                "condition": "Sunny",
+            }
+        )
+
+
+def make_tool_searcher(tools: List[BetaFunctionTool[Any]]) -> BetaFunctionTool[Any]:
+    """Returns a tool that Claude can use to search through all available tools"""
+
+    @beta_tool
+    def search_available_tools(*, keyword: str) -> BetaFunctionToolResultType:
+        """Search for useful tools using a query string"""
+
+        results: list[BetaToolReferenceBlockParam] = []
+        for tool in tools:
+            if keyword in json.dumps(tool.to_dict()):
+                results.append({"type": "tool_reference", "tool_name": tool.name})
+
+        return results
+
+    return search_available_tools
+
+
+def main() -> None:
+    tools: list[BetaFunctionTool[Any]] = [
+        get_weather,
+        # ... many more tools
+    ]
+    runner = client.beta.messages.tool_runner(
+        max_tokens=1024,
+        model="claude-sonnet-4-5-20250929",
+        tools=[*tools, make_tool_searcher(tools)],
+        messages=[{"role": "user", "content": "What is the weather in SF?"}],
+        betas=["tool-search-tool-2025-10-19"],
+    )
+    for message in runner:
+        rich.print(message)
+
+
+main()

{anthropic-0.74.1 → anthropic-0.76.0}/pyproject.toml

@@ -1,22 +1,24 @@
 [project]
 name = "anthropic"
-version = "0.74.1"
+version = "0.76.0"
 description = "The official Python library for the anthropic API"
 dynamic = ["readme"]
 license = "MIT"
 authors = [
 { name = "Anthropic", email = "support@anthropic.com" },
 ]
+
 dependencies = [
     "httpx>=0.25.0, <1",
-    "pydantic>=1.9.0, <3",
-    "typing-extensions>=4.10, <5",
-    "anyio>=3.5.0, <5",
-    "distro>=1.7.0, <2",
-    "sniffio",
+  "pydantic>=1.9.0, <3",
+  "typing-extensions>=4.10, <5",
+  "anyio>=3.5.0, <5",
+  "distro>=1.7.0, <2",
+  "sniffio",
     "jiter>=0.4.0, <1",
     "docstring-parser>=0.15,<1",
 ]
+
 requires-python = ">= 3.9"
 classifiers = [
   "Typing :: Typed",
@@ -26,6 +28,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Operating System :: OS Independent",
   "Operating System :: POSIX",
   "Operating System :: MacOS",
@@ -46,7 +49,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" },
@@ -58,7 +61,7 @@ conflicts = [
 # version pins are in uv.lock
 dev = [
     "pyright==1.1.399",
-    "mypy",
+    "mypy==1.17",
     "respx",
     "pytest",
     "pytest-asyncio",
@@ -76,7 +79,8 @@ pydantic-v1 = [
     "pydantic>=1.9.0,<2",
 ]
 pydantic-v2 = [
-    "pydantic>=2,<3",
+    "pydantic~=2.0 ; python_full_version < '3.14'",
+    "pydantic~=2.12 ; python_full_version >= '3.14'",
 ]
 
 [build-system]
@@ -160,7 +164,7 @@ show_error_codes = true
 #
 # We also exclude our `tests` as mypy doesn't always infer
 # types correctly and Pyright will still catch any type errors.
-exclude = ['src/anthropic/_files.py', '_dev/.*.py', 'tests/.*', 'examples/mcp_server_weather.py', 'examples/tools_with_mcp.py', 'examples/memory/basic.py', 'src/anthropic/lib/_parse/_transform.py']
+exclude = ['src/anthropic/_files.py', '_dev/.*.py', 'tests/.*', 'examples/mcp_server_weather.py', 'examples/tools_with_mcp.py', 'examples/memory/basic.py', 'src/anthropic/lib/_parse/_transform.py', 'src/anthropic/lib/tools/_beta_functions.py']
 
 strict_equality = true
 implicit_reexport = true

anthropic-0.76.0/requirements-dev.lock

@@ -0,0 +1,135 @@
+# This file was autogenerated by uv via the following command:
+#    uv export -o requirements-dev.lock --no-hashes
+-e .
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.12.0
+    # via
+    #   anthropic
+    #   httpx
+asttokens==3.0.1
+    # via inline-snapshot
+backports-asyncio-runner==1.2.0 ; python_full_version < '3.11'
+    # via pytest-asyncio
+boto3-stubs==1.41.5
+botocore-stubs==1.41.6
+    # via boto3-stubs
+certifi==2025.11.12
+    # via
+    #   httpcore
+    #   httpx
+colorama==0.4.6
+    # via
+    #   griffe
+    #   pytest
+dirty-equals==0.11
+distro==1.9.0
+    # via anthropic
+docstring-parser==0.17.0
+    # via anthropic
+exceptiongroup==1.3.1 ; python_full_version < '3.11'
+    # via
+    #   anyio
+    #   pytest
+execnet==2.1.2
+    # via pytest-xdist
+executing==2.2.1
+    # via inline-snapshot
+griffe==1.14.0 ; python_full_version < '3.10'
+griffe==1.15.0 ; python_full_version >= '3.10'
+h11==0.16.0
+    # via httpcore
+httpcore==1.0.9
+    # via httpx
+httpx==0.28.1
+    # via
+    #   anthropic
+    #   respx
+idna==3.11
+    # via
+    #   anyio
+    #   httpx
+importlib-metadata==8.7.0
+iniconfig==2.1.0 ; python_full_version < '3.10'
+    # via pytest
+iniconfig==2.3.0 ; python_full_version >= '3.10'
+    # via pytest
+inline-snapshot==0.31.1
+jiter==0.12.0
+    # via anthropic
+markdown-it-py==3.0.0 ; python_full_version < '3.10'
+    # via rich
+markdown-it-py==4.0.0 ; python_full_version >= '3.10'
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+mypy==1.17.0
+mypy-extensions==1.1.0
+    # via mypy
+nodeenv==1.9.1
+    # via pyright
+packaging==25.0
+    # via pytest
+pathspec==0.12.1
+    # via mypy
+pluggy==1.6.0
+    # via pytest
+pydantic==2.12.5
+    # via anthropic
+pydantic-core==2.41.5
+    # via pydantic
+pygments==2.19.2
+    # via
+    #   pytest
+    #   rich
+pyright==1.1.399
+pytest==8.4.2 ; python_full_version < '3.10'
+    # via
+    #   inline-snapshot
+    #   pytest-asyncio
+    #   pytest-xdist
+pytest==9.0.1 ; python_full_version >= '3.10'
+    # via
+    #   inline-snapshot
+    #   pytest-asyncio
+    #   pytest-xdist
+pytest-asyncio==1.2.0 ; python_full_version < '3.10'
+pytest-asyncio==1.3.0 ; python_full_version >= '3.10'
+pytest-xdist==3.8.0
+python-dateutil==2.9.0.post0 ; python_full_version < '3.10'
+    # via time-machine
+respx==0.22.0
+rich==14.2.0
+    # via inline-snapshot
+ruff==0.14.7
+six==1.17.0 ; python_full_version < '3.10'
+    # via python-dateutil
+sniffio==1.3.1
+    # via anthropic
+time-machine==2.19.0 ; python_full_version < '3.10'
+time-machine==3.1.0 ; python_full_version >= '3.10'
+tomli==2.3.0 ; python_full_version < '3.11'
+    # via
+    #   inline-snapshot
+    #   mypy
+    #   pytest
+types-awscrt==0.29.1
+    # via botocore-stubs
+types-s3transfer==0.15.0
+    # via boto3-stubs
+typing-extensions==4.15.0
+    # via
+    #   anthropic
+    #   anyio
+    #   boto3-stubs
+    #   exceptiongroup
+    #   mypy
+    #   pydantic
+    #   pydantic-core
+    #   pyright
+    #   pytest-asyncio
+    #   typing-inspection
+typing-inspection==0.4.2
+    # via pydantic
+zipp==3.23.0
+    # via importlib-metadata