Merge branch 'anthropics:main' into main

Author: Mng-dev-ai

.github/workflows/build-and-publish.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [ubuntu-latest, ubuntu-24.04-arm, macos-latest, windows-latest]
+        os: [ubuntu-latest, ubuntu-24.04-arm, macos-latest, macos-15-intel, windows-latest]
     steps:
       - uses: actions/checkout@v4
 
@@ -67,6 +67,25 @@ jobs:
           pattern: wheel-*
           merge-multiple: true
 
+      - name: Verify all expected wheels are present
+        run: |
+          set -euo pipefail
+          ls -la dist/
+          expected=(
+            "macosx_11_0_arm64"
+            "macosx_11_0_x86_64"
+            "manylinux_2_17_x86_64"
+            "manylinux_2_17_aarch64"
+            "win_amd64"
+          )
+          for tag in "${expected[@]}"; do
+            if ! ls dist/*"${tag}".whl 2>/dev/null; then
+              echo "::error::Missing wheel for platform tag: ${tag}"
+              exit 1
+            fi
+          done
+          echo "All ${#expected[@]} expected wheels present ✓"
+
       - name: Build sdist and publish to PyPI
         run: |
           pip install build twine

.github/workflows/build-wheel-check.yml

@@ -0,0 +1,107 @@
+name: Build Wheel Check
+
+# Dry-run the wheel build on PRs so we catch packaging regressions
+# before a release, instead of discovering them at publish time.
+on:
+  pull_request:
+    paths:
+      - 'scripts/build_wheel.py'
+      - 'scripts/download_cli.py'
+      - '.github/workflows/build-and-publish.yml'
+      - '.github/workflows/build-wheel-check.yml'
+      - 'pyproject.toml'
+      - 'MANIFEST.in'
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            expected_tag: manylinux_2_17_x86_64
+          - os: ubuntu-24.04-arm
+            expected_tag: manylinux_2_17_aarch64
+          - os: macos-latest
+            expected_tag: macosx_11_0_arm64
+          - os: macos-15-intel
+            expected_tag: macosx_11_0_x86_64
+          - os: windows-latest
+            expected_tag: win_amd64
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install build dependencies
+        run: pip install build twine wheel
+        shell: bash
+
+      - name: Build wheel with bundled CLI
+        run: python scripts/build_wheel.py --skip-sdist --clean
+        shell: bash
+
+      - name: Verify wheel filename contains expected platform tag
+        shell: bash
+        run: |
+          set -euo pipefail
+          ls -la dist/
+          wheel=$(ls dist/*.whl)
+          echo "Built wheel: $wheel"
+          if [[ "$wheel" != *"${{ matrix.expected_tag }}"* ]]; then
+            echo "::error::Expected platform tag '${{ matrix.expected_tag }}' in wheel filename, got: $wheel"
+            exit 1
+          fi
+
+      - name: Verify wheel contains bundled CLI binary
+        shell: bash
+        run: |
+          set -euo pipefail
+          wheel=$(ls dist/*.whl)
+          python -m zipfile -l "$wheel" > wheel_contents.txt
+          cat wheel_contents.txt
+          if [[ "${{ runner.os }}" == "Windows" ]]; then
+            grep -q "_bundled/claude.exe" wheel_contents.txt || {
+              echo "::error::Bundled CLI (claude.exe) not found in wheel"
+              exit 1
+            }
+          else
+            grep -q "_bundled/claude" wheel_contents.txt || {
+              echo "::error::Bundled CLI (claude) not found in wheel"
+              exit 1
+            }
+          fi
+          echo "Bundled CLI found in wheel ✓"
+
+      - name: Smoke-test install and import
+        shell: bash
+        run: |
+          pip install dist/*.whl
+          python -c "import claude_agent_sdk; print('import ok')"
+          python -c "import claude_agent_sdk, pathlib, platform; cli_name = 'claude.exe' if platform.system() == 'Windows' else 'claude'; p = pathlib.Path(claude_agent_sdk.__file__).parent / '_bundled' / cli_name; assert p.exists() and p.is_file(), f'bundled CLI missing after install: {p}'; print('bundled CLI at', p)"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel-check-${{ matrix.expected_tag }}
+          path: dist/*.whl
+          retention-days: 7
+
+  verify-matrix-sync:
+    # Guard against the build matrix here drifting from the publish matrix.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check build matrices are in sync
+        run: |
+          set -euo pipefail
+          publish=$(grep -oP 'os:\s*\[\K[^\]]+' .github/workflows/build-and-publish.yml | tr -d ' ' | tr ',' '\n' | sort)
+          check=$(python3 -c "import yaml; d = yaml.safe_load(open('.github/workflows/build-wheel-check.yml')); print('\n'.join(sorted(i['os'] for i in d['jobs']['build']['strategy']['matrix']['include'])))")
+          echo "publish matrix:"; echo "$publish"
+          echo "check matrix:"; echo "$check"
+          diff <(echo "$publish") <(echo "$check") || {
+            echo "::error::build-wheel-check.yml matrix is out of sync with build-and-publish.yml"
+            exit 1
+          }

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.48
+
+### Bug Fixes
+
+- **Fine-grained tool streaming**: Fixed `include_partial_messages=True` not delivering `input_json_delta` events by enabling the `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` environment variable in the subprocess. This regression affected versions 0.1.36 through 0.1.47 for users without the server-side feature flag (#644)
+
+### Internal/Other Changes
+
+- Updated bundled Claude CLI to version 2.1.71
+
+## 0.1.47
+
+### Internal/Other Changes
+
+- Updated bundled Claude CLI to version 2.1.70
+
 ## 0.1.46
 
 ### New Features

README.md

@@ -56,9 +56,11 @@ async for message in query(prompt="Tell me a joke", options=options):
 
 ### Using Tools
 
+By default, Claude has access to the full [Claude Code toolset](https://code.claude.com/docs/en/settings#tools-available-to-claude) (Read, Write, Edit, Bash, and others). `allowed_tools` is a permission allowlist: listed tools are auto-approved, and unlisted tools fall through to `permission_mode` and `can_use_tool` for a decision. It does not remove tools from Claude's toolset. To block specific tools, use `disallowed_tools`. See the [permissions guide](https://platform.claude.com/docs/en/agent-sdk/permissions) for the full evaluation order.
+
 ```python
 options = ClaudeAgentOptions(
-    allowed_tools=["Read", "Write", "Bash"],
+    allowed_tools=["Read", "Write", "Bash"],  # auto-approve these tools
     permission_mode='acceptEdits'  # auto-accept file edits
 )
 
@@ -116,7 +118,8 @@ server = create_sdk_mcp_server(
     tools=[greet_user]
 )
 
-# Use it with Claude
+# Use it with Claude. allowed_tools pre-approves the tool so it runs
+# without a permission prompt; it does not control tool availability.
 options = ClaudeAgentOptions(
     mcp_servers={"tools": server},
     allowed_tools=["mcp__tools__greet"]
@@ -183,7 +186,7 @@ options = ClaudeAgentOptions(
 
 ### Hooks
 
-A **hook** is a Python function that the Claude Code _application_ (_not_ Claude) invokes at specific points of the Claude agent loop. Hooks can provide deterministic processing and automated feedback for Claude. Read more in [Claude Code Hooks Reference](https://docs.anthropic.com/en/docs/claude-code/hooks).
+A **hook** is a Python function that the Claude Code _application_ (_not_ Claude) invokes at specific points of the Claude agent loop. Hooks can provide deterministic processing and automated feedback for Claude. Read more in [Intercept and control agent behavior with hooks](https://platform.claude.com/docs/en/agent-sdk/hooks).
 
 For more examples, see examples/hooks.py.
 
@@ -267,7 +270,7 @@ See [src/claude_agent_sdk/\_errors.py](src/claude_agent_sdk/_errors.py) for all
 
 ## Available Tools
 
-See the [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-code/settings#tools-available-to-claude) for a complete list of available tools.
+See the [Claude Code documentation](https://code.claude.com/docs/en/settings#tools-available-to-claude) for a complete list of available tools.
 
 ## Examples
 

RELEASING.md

@@ -2,7 +2,19 @@
 
 There are two ways to release the SDK: **automatic** (triggered by a CLI version bump) and **manual** (triggered via GitHub Actions UI).
 
-Both flows call the same reusable `build-and-publish.yml` workflow, which builds platform-specific wheels on 4 OS targets (Ubuntu x86, Ubuntu ARM, macOS, Windows), publishes to PyPI, updates version files, generates a changelog entry using Claude, pushes to `main`, and creates a git tag + GitHub Release.
+Both flows call the same reusable `build-and-publish.yml` workflow, which builds platform-specific wheels on 5 OS targets, publishes to PyPI, updates version files, generates a changelog entry using Claude, pushes to `main`, and creates a git tag + GitHub Release.
+
+**Wheel targets:**
+
+| Runner | Platform tag |
+|---|---|
+| `ubuntu-latest` | `manylinux_2_17_x86_64` |
+| `ubuntu-24.04-arm` | `manylinux_2_17_aarch64` |
+| `macos-latest` | `macosx_11_0_arm64` |
+| `macos-15-intel` | `macosx_11_0_x86_64` |
+| `windows-latest` | `win_amd64` |
+
+PRs that touch the build scripts, `pyproject.toml`, or the publish workflow trigger `build-wheel-check.yml`, which dry-runs the full build matrix and verifies each wheel contains the bundled CLI before merge.
 
 ## Versioning
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "claude-agent-sdk"
-version = "0.1.46"
+version = "0.1.48"
 description = "Python SDK for Claude Code"
 readme = "README.md"
 requires-python = ">=3.10"

src/claude_agent_sdk/__init__.py

@@ -13,6 +13,7 @@
     CLINotFoundError,
     ProcessError,
 )
+from ._internal.session_mutations import rename_session, tag_session
 from ._internal.sessions import get_session_messages, list_sessions
 from ._internal.transport import Transport
 from ._version import __version__
@@ -54,6 +55,10 @@
     PostToolUseHookInput,
     PreCompactHookInput,
     PreToolUseHookInput,
+    RateLimitEvent,
+    RateLimitInfo,
+    RateLimitStatus,
+    RateLimitType,
     ResultMessage,
     SandboxIgnoreViolations,
     SandboxNetworkConfig,
@@ -64,6 +69,7 @@
     SessionMessage,
     SettingSource,
     StopHookInput,
+    StreamEvent,
     SubagentStartHookInput,
     SubagentStartHookSpecificOutput,
     SubagentStopHookInput,
@@ -361,6 +367,11 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> Any:
     "TaskNotificationStatus",
     "TaskUsage",
     "ResultMessage",
+    "RateLimitEvent",
+    "RateLimitInfo",
+    "RateLimitStatus",
+    "RateLimitType",
+    "StreamEvent",
     "Message",
     "ClaudeAgentOptions",
     "TextBlock",
@@ -410,6 +421,9 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> Any:
     "get_session_messages",
     "SDKSessionInfo",
     "SessionMessage",
+    # Session mutations
+    "rename_session",
+    "tag_session",
     # Beta support
     "SdkBeta",
     # Sandbox support

src/claude_agent_sdk/_cli_version.py

@@ -1,3 +1,3 @@
 """Bundled Claude Code CLI version."""
 
-__cli_version__ = "2.1.69"
+__cli_version__ = "2.1.76"

src/claude_agent_sdk/_internal/message_parser.py

@@ -8,6 +8,8 @@
     AssistantMessage,
     ContentBlock,
     Message,
+    RateLimitEvent,
+    RateLimitInfo,
     ResultMessage,
     StreamEvent,
     SystemMessage,
@@ -220,6 +222,28 @@ def parse_message(data: dict[str, Any]) -> Message | None:
                     f"Missing required field in stream_event message: {e}", data
                 ) from e
 
+        case "rate_limit_event":
+            try:
+                info = data["rate_limit_info"]
+                return RateLimitEvent(
+                    rate_limit_info=RateLimitInfo(
+                        status=info["status"],
+                        resets_at=info.get("resetsAt"),
+                        rate_limit_type=info.get("rateLimitType"),
+                        utilization=info.get("utilization"),
+                        overage_status=info.get("overageStatus"),
+                        overage_resets_at=info.get("overageResetsAt"),
+                        overage_disabled_reason=info.get("overageDisabledReason"),
+                        raw=info,
+                    ),
+                    uuid=data["uuid"],
+                    session_id=data["session_id"],
+                )
+            except KeyError as e:
+                raise MessageParseError(
+                    f"Missing required field in rate_limit_event message: {e}", data
+                ) from e
+
         case _:
             # Forward-compatible: skip unrecognized message types so newer
             # CLI versions don't crash older SDK versions.