209 commits

This branch

This branch

All branches

Author	SHA1	Message	Date
Claude	ad08ac005e	fix: prevent command injection in download_cli.py ... Add strict validation to CLAUDE_CLI_VERSION environment variable to prevent command injection vulnerability during CLI download process. Security Issue: - Unsanitized environment variable was interpolated into PowerShell and Bash commands at lines 75 and 85 - Severity: MEDIUM - Category: command_injection Fix: - Added regex validation to only allow semantic versions (X.Y.Z) or "latest" - Pattern: ^([0-9]+\.[0-9]+\.[0-9]+|latest)$ - Raises ValueError for invalid input Testing: - Created comprehensive test suite (tests/test_download_cli.py) - Verified valid versions accepted (1.0.0, latest) - Verified malicious inputs rejected (injection attempts, invalid formats) - Full backward compatibility maintained Changes: - scripts/download_cli.py: Add validation in get_cli_version() - tests/test_download_cli.py: New test suite with 70+ test cases - SECURITY_FIX_SUMMARY.md: Documentation of vulnerability and fix	2025-12-12 22:18:35 +00:00
lif	3cbb9e56be	fix: parse error field in AssistantMessage to enable rate limit detection (#405) ... ## Summary Fixes #401 Enables applications to detect API errors (especially `rate_limit` errors) by properly parsing the `error` field in `AssistantMessage`. ## Problem The SDK defines `AssistantMessage.error` (including `"rate_limit"`), but the message parser never extracted this field from the CLI response. This made it impossible for applications to: - Detect when rate limits are hit - Implement retry logic - Handle other API errors gracefully ## Solution Added error field extraction in the message parser: ```python return AssistantMessage( content=content_blocks, model=data["message"]["model"], parent_tool_use_id=data.get("parent_tool_use_id"), error=data["message"].get("error"), # ← Now extracts error field ) ``` ## Changes **Modified: `src/claude_agent_sdk/_internal/message_parser.py`** The parser now extracts the `error` field from API responses and populates it in the `AssistantMessage` object. ## Usage Example Applications can now detect and handle rate limits: ```python async for message in client.receive_response(): if isinstance(message, AssistantMessage): if message.error == "rate_limit": print("Rate limit hit! Implementing backoff...") await asyncio.sleep(60) # Retry logic here elif message.error: print(f"API error: {message.error}") ``` ## Testing - ✅ Passed ruff linting and formatting - ✅ Passed mypy type checking - ✅ All existing tests pass ## Type of Change - [x] Bug fix (non-breaking change which fixes an issue) - [ ] New feature (non-breaking change which adds functionality) - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected) ## Impact This fix enables production applications to: - Implement proper error handling for API errors - Build robust retry logic for rate limits - Provide better user feedback when errors occur - Avoid silent failures when the API returns errors --- 🤖 Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering> Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: Happy <yesreply@happy.engineering>	2025-12-11 10:55:01 -08:00
github-actions[bot]	5b912962e2	chore: release v0.1.15 (#408) ... This PR updates the version to 0.1.15 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.15 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.15 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.15/ - Bundled CLI version: 2.0.62 - Install with: `pip install claude-agent-sdk==0.1.15` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com>	2025-12-11 10:53:45 -08:00
Noah Zweben	53482d8955	feat: add file checkpointing and rewind_files support (#395) ... ## Summary - Add `enable_file_checkpointing` option to `ClaudeAgentOptions` - Add `rewind_files(user_message_id)` method to `ClaudeSDKClient` and `Query` - Add `SDKControlRewindFilesRequest` type for the control protocol - Set `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING` env var when enabled This adds Python SDK support for the file rewind feature from claude-cli-internal PR #11265. ## Test plan - [x] Verified imports work correctly - [x] Verified linting passes (`ruff check`) - [x] Verified existing tests still pass (106 passed, pre-existing failures unrelated to this change) 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-12-09 10:16:03 -08:00
sarahdeaton	4acfcc2d39	Add license and terms section to README. (#399) ... Add "License and terms" section to README clarifying that use of the SDK is governed by Anthropic's Commercial Terms of Service	2025-12-09 09:33:42 -08:00
github-actions[bot]	b5447d999d	chore: release v0.1.14 (#398) ... This PR updates the version to 0.1.14 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.14 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.14 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.14/ - Bundled CLI version: 2.0.62 - Install with: `pip install claude-agent-sdk==0.1.14` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>	2025-12-09 08:22:21 -08:00
GitHub Actions	ccff8ddf48	chore: bump bundled CLI version to 2.0.62	2025-12-09 02:12:13 +00:00
GitHub Actions	db4a6f7c28	chore: bump bundled CLI version to 2.0.61	2025-12-07 10:47:47 +00:00
Ashwin Bhat	5625286212	fix: move fetch-depth to publish job and use claude-opus-4-5 for changelog (#394) ... The fetch-depth: 0 was on build-wheels but changelog generation happens in the publish job. Moved it to the correct location and upgraded the model for better changelog generation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-12-06 16:52:09 -08:00
github-actions[bot]	cf6b85fc5d	chore: release v0.1.13 (#393) ... This PR updates the version to 0.1.13 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.13 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.13 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.13/ - Bundled CLI version: 2.0.59 - Install with: `pip install claude-agent-sdk==0.1.13` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Ashwin Bhat <ashwin@anthropic.com> Co-authored-by: Claude <noreply@anthropic.com>	2025-12-05 16:33:33 -08:00
GitHub Actions	00b5730be6	chore: bump bundled CLI version to 2.0.60	2025-12-06 00:10:43 +00:00
GitHub Actions	1b3e35d14e	chore: bump bundled CLI version to 2.0.59	2025-12-04 23:09:33 +00:00
Ramazan Rakhmatullin	69a310cc3f	fix: propagate CLI errors to pending control requests (#388) ... ## Summary When the CLI exits with an error (e.g., invalid session ID passed to `--resume`), signal all pending control requests immediately instead of waiting for the 60-second timeout. **The fix adds 4 lines** to the exception handler in `_read_messages`: ```python # Signal all pending control requests so they fail fast instead of timing out for request_id, event in list(self.pending_control_responses.items()): if request_id not in self.pending_control_results: self.pending_control_results[request_id] = e event.set() ``` ## Problem When the CLI exits with an error, the SDK's message reader catches it but doesn't notify pending control requests. This causes `initialize()` to wait for the full 60-second timeout even though the error is known within seconds. Example scenario: 1. User passes invalid session ID via `ClaudeAgentOptions(resume="invalid-id")` 2. CLI prints `No conversation found with session ID: xxx` and exits with code 1 3. SDK message reader catches the error after ~3 seconds 4. But `initialize()` keeps waiting for 60 seconds before timing out ## Solution The existing code at `_send_control_request` lines 361-362 already handles exceptions in results: ```python if isinstance(result, Exception): raise result ``` The fix simply signals all pending control events when an error occurs, allowing them to fail fast with the actual error instead of timing out. ## Test Plan - [ ] Test with invalid session ID - should fail fast (~3s) instead of timing out (60s) - [ ] Test normal flow still works - [ ] Test multiple pending requests all get signaled Fixes #387	2025-12-04 14:28:36 -08:00
梨梨果	6791efec93	fix: add McpServer runtime placeholder for Pydantic 2.12+ compatibility (#385) ... ## Summary - Add runtime placeholder for `McpServer` type to fix Pydantic 2.12+ compatibility - `McpServer` was only imported under `TYPE_CHECKING`, causing `PydanticUserError` at runtime Fixes #384 Co-authored-by: lyrica <lyrica@example.com>	2025-12-04 14:28:24 -08:00
Carlos Cuevas	2d67166cae	fix: add write lock to prevent concurrent transport writes (#391) ... ## TL;DR Adds a write lock to `SubprocessCLITransport` to prevent concurrent writes from parallel subagents. --- ## Overview When multiple subagents run in parallel and invoke MCP tools, the CLI sends concurrent `control_request` messages. Each handler tries to write a response back to the subprocess stdin at the same time. Trio's `TextSendStream` isn't thread-safe for concurrent access, so this causes `BusyResourceError`. This PR adds an `anyio.Lock` around all write operations (`write()`, `end_input()`, and the stdin-closing part of `close()`). The lock serializes concurrent writes so they happen one at a time. The `_ready` flag is now set inside the lock during `close()` to prevent a TOCTOU race where `write()` checks `_ready`, then `close()` sets it and closes the stream before `write()` actually sends data. --- ## Call Flow ```mermaid flowchart TD A["write()<br/>subprocess_cli.py:505"] --> B["acquire _write_lock<br/>subprocess_cli.py:507"] B --> C["check _ready & stream<br/>subprocess_cli.py:509"] C --> D["_stdin_stream.send()<br/>subprocess_cli.py:523"] E["close()<br/>subprocess_cli.py:458"] --> F["acquire _write_lock<br/>subprocess_cli.py:478"] F --> G["set _ready = False<br/>subprocess_cli.py:479"] G --> H["close _stdin_stream<br/>subprocess_cli.py:481"] I["end_input()<br/>subprocess_cli.py:531"] --> J["acquire _write_lock<br/>subprocess_cli.py:533"] J --> K["close _stdin_stream<br/>subprocess_cli.py:535"] ```	2025-12-04 14:27:01 -08:00
github-actions[bot]	00332f32dc	chore: release v0.1.12 (#392) ... This PR updates the version to 0.1.12 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.12 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.12 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.12/ - Bundled CLI version: 2.0.58 - Install with: `pip install claude-agent-sdk==0.1.12` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-12-04 10:30:12 -08:00
Ashwin Bhat	ea0ef25e71	feat: add tools option to ClaudeAgentOptions (#389) ... Add support for the `tools` option matching the TypeScript SDK, which controls the base set of available tools separately from allowed/disallowed tool filtering. Supports three modes: - Array of tool names: `["Read", "Edit", "Bash"]` - Empty array: `[]` (disables all built-in tools) - Preset object: `{"type": "preset", "preset": "claude_code"}` 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com>	2025-12-04 09:27:02 -08:00
Ashwin Bhat	4e56cb12a9	feat: add SDK beta support with SdkBeta type and betas option (#390) ... Port the SdkBeta type and betas option from the TypeScript SDK to enable SDK users to pass beta feature flags (e.g., 1M context window) to the CLI. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-12-04 09:26:01 -08:00
GitHub Actions	243703531b	chore: bump bundled CLI version to 2.0.58	2025-12-03 20:09:56 +00:00
github-actions[bot]	9809fb6b54	chore: release v0.1.11 (#383) ... This PR updates the version to 0.1.11 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.11 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.11 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.11/ - Bundled CLI version: 2.0.57 - Install with: `pip install claude-agent-sdk==0.1.11` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>	2025-12-03 11:42:09 -08:00
GitHub Actions	afa39dc1bf	chore: bump bundled CLI version to 2.0.57	2025-12-03 05:24:28 +00:00
GitHub Actions	2a53aba5b9	chore: bump bundled CLI version to 2.0.56	2025-12-02 01:35:15 +00:00
John Ott	6e1769f8fd	feat: bundle claude code CLI for linux arm64 (#373) ... Currently wheels with packaged claude-code CLI are only published for windows amd64, linux x86_64 and macos arm64. For version 0.1.10, we can see the following download files are available on pypi contain the following artifacts: https://pypi.org/project/claude-agent-sdk/0.1.10/#files - claude_agent_sdk-0.1.10.tar.gz - claude_agent_sdk-0.1.10-py3-none-win_amd64.whl - claude_agent_sdk-0.1.10-py3-none-manylinux_2_17_x86_64.whl - claude_agent_sdk-0.1.10-py3-none-macosx_11_0_arm64.whl The existing publishing code should support adding a new linux arm64 wheel builder, using the Github ARM runners: https://github.blog/changelog/2025-08-07-arm64-hosted-runners-for-public-repositories-are-now-generally-available/ Unfortunately, there's no `ubuntu-latest-arm` label similar to the one we use for the other builds, so I'm using the `ubuntu-24.04-arm` label.	2025-12-01 12:44:57 -08:00
Dalton Flanagan	a2f24a3101	fix: wait for first result before closing stdin if SDK MCP present (#380) ... Port SDK MCP fix from TypeScript to Python. Now, when SDK MCP servers or hooks are present, stream_input() waits for the first result message before closing stdin, allowing bidirectional control protocol communication to complete. Fixes repro in https://github.com/anthropics/claude-agent-sdk-python/issues/266. The `query()` design requires input streams to be held open by the user for SDK MCP bidirectional communication to work. This has confused a lot of folks, so we're moving towards a more explicit lifecycle design. In the meantime, this is the way we've addressed it with V1 APIs in https://github.com/anthropics/claude-agent-sdk-typescript. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-12-01 10:19:51 -08:00
Ashwin Bhat	49482e1dfd	fix: correct mypy type ignore error codes for MCP decorators (#379) ... Update type: ignore comments to use `untyped-decorator` instead of `misc` to match the actual mypy error codes reported in CI. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-12-01 08:40:58 -08:00
ollie-anthropic	f21f63e181	Create sandbox adapter interface for Python SDK (#363) ... Adds programmatic sandbox configuration to the Python SDK, matching the TypeScript SDK's approach. Changes: - Add SandboxSettings, SandboxNetworkConfig, SandboxIgnoreViolations types - Add sandbox field to ClaudeAgentOptions - Merge sandbox into --settings CLI flag in SubprocessCLITransport - Export sandbox types from package __init__.py - Add comprehensive tests for sandbox settings **Important:** Filesystem and network restrictions are configured via permission rules (Read/Edit/WebFetch), not via these sandbox settings. The sandbox settings control sandbox behavior (enabled, auto-allow, excluded commands, etc.). Example usage: ```python from claude_agent_sdk import query, SandboxSettings result = query( prompt='Build and test the project', options=ClaudeAgentOptions( sandbox={ 'enabled': True, 'autoAllowBashIfSandboxed': True, 'excludedCommands': ['docker'], 'network': { 'allowLocalBinding': True, 'allowUnixSockets': ['/var/run/docker.sock'] } } ) ) ``` Co-authored-by: Claude <noreply@anthropic.com>	2025-12-01 01:44:59 -08:00
GitHub Actions	d553184ef6	chore: bump bundled CLI version to 2.0.55	2025-11-27 00:01:24 +00:00
github-actions[bot]	e2f8d814ea	chore: release v0.1.10 (#369) ... This PR updates the version to 0.1.10 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.10 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.10 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.10/ - Bundled CLI version: 2.0.53 - Install with: `pip install claude-agent-sdk==0.1.10` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>	2025-11-25 12:58:54 -05:00
GitHub Actions	be915896af	chore: bump bundled CLI version to 2.0.53	2025-11-25 01:55:19 +00:00
GitHub Actions	d15f26da91	chore: bump bundled CLI version to 2.0.52	2025-11-24 23:32:15 +00:00
GitHub Actions	112f3aa959	chore: bump bundled CLI version to 2.0.51	2025-11-24 18:48:28 +00:00
Noah Zweben	493f49fad9	Added slack issue notifier for new opened issues (#356) ... Posts new issues to claude-agent-sdk-feedback. Can't use the default github slack bot as it's too noisy (all comments and issue updates such as comments, closing, etc...) --------- Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-11-23 21:24:25 -08:00
Harutaka Kawamura	7a5b413159	Fix: Fix HookMatcher.timeout type to float (#357) ... According to https://www.schemastore.org/claude-code-settings.json, the `timeout` type is `number`, not `integer` Signed-off-by: harupy <17039389+harupy@users.noreply.github.com>	2025-11-23 18:22:12 -05:00
GitHub Actions	23183a2698	chore: bump bundled CLI version to 2.0.50	2025-11-21 23:16:27 +00:00
Michael Dworsky	41ceacd807	Use CLAUDE_CODE_STREAM_CLOSE_TIMEOUT (if present) to override initialize() timeout (#354)	2025-11-21 16:46:22 -05:00
github-actions[bot]	f446e3e42a	chore: release v0.1.9 (#353) ... This PR updates the version to 0.1.9 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.9 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.9 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.9/ - Bundled CLI version: 2.0.49 - Install with: `pip install claude-agent-sdk==0.1.9` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>	2025-11-21 12:51:05 -08:00
GitHub Actions	36c75374ec	chore: bump bundled CLI version to 2.0.49	2025-11-21 01:31:38 +00:00
shawnm-anthropic	b0fb5b082a	Add AssistantMessageError type (#352) ... This brings Python to parity with https://github.com/anthropics/claude-cli-internal/pull/10358.	2025-11-19 19:23:10 -05:00
GitHub Actions	ab83878f5a	chore: bump bundled CLI version to 2.0.47	2025-11-19 23:12:47 +00:00
GitHub Actions	179818235a	chore: bump bundled CLI version to 2.0.46	2025-11-19 22:56:34 +00:00
Dickson Tsai	84edd73041	feat: add timeout parameter to HookMatcher (#351) ... ## Summary - Adds optional `timeout` field to `HookMatcher` dataclass in `types.py` that allows users to specify a custom timeout (in seconds) for hooks - Propagates the timeout value through: - `client.py` and `_internal/client.py`: `_convert_hooks_to_internal()` method - `_internal/query.py`: hook config sent to CLI ## Test plan - [x] Verify hooks work without timeout specified (default behavior) - [x] Verify custom timeout is passed to CLI when specified in HookMatcher 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-19 13:50:33 -08:00
Ashwin Bhat	bf528a1221	refactor: source CLI version from code in publish workflow (#350) ... Remove the claude_code_version workflow input and instead read the CLI version directly from src/claude_agent_sdk/_cli_version.py. This allows the version to be managed separately and updated by automation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-19 09:49:35 -08:00
github-actions[bot]	d5dc615bd4	chore: release v0.1.8 (#346) ... This PR updates the version to 0.1.8 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.8 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.8 - Updated bundled CLI version in `src/claude_agent_sdk/_cli_version.py` to 2.0.45 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.8/ - Bundled CLI version: 2.0.45 - Install with: `pip install claude-agent-sdk==0.1.8` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-11-18 21:21:57 -08:00
Ashwin Bhat	bab98e717e	fix: install wheel package for retagging platform-specific wheels (#345) ... The build_wheel.py script uses `python -m wheel tags` to retag wheels with platform-specific tags, but `wheel` wasn't explicitly installed. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 21:05:18 -08:00
Ashwin Bhat	ddc37c7330	fix: disable artifact compression to prevent wheel corruption (#344) ... Wheels are already ZIP files - double compression via GitHub Actions artifacts can cause "Mis-matched data size" errors on PyPI upload. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 20:55:17 -08:00
Ashwin Bhat	58cfffc623	fix: use PowerShell installer for Windows CLI download (#343) ... The bash install script (install.sh) explicitly rejects Windows. Use the PowerShell installer (install.ps1) instead when running on Windows, matching the approach used in test.yml. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 20:47:26 -08:00
Ashwin Bhat	35dd5b4bcc	fix: remove emojis from build_wheel.py for Windows compatibility (#342) ... Windows console encoding (cp1252) doesn't support Unicode emoji characters, causing UnicodeEncodeError in CI. Replaced all emoji characters with plain text equivalents. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 17:59:48 -08:00
Ashwin Bhat	ce99e9d2eb	feat: bundle Claude Code CLI in pip package (#283) ... Bundle platform-specific Claude Code CLI binaries directly in the Python package, eliminating the need for separate CLI installation. ## Changes ### Build System - Created `scripts/download_cli.py` to fetch CLI during build - Created `scripts/build_wheel.py` for building platform-specific wheels - Created `scripts/update_cli_version.py` to track bundled CLI version - Updated `pyproject.toml` to properly bundle CLI without duplicate file warnings - Made twine check non-blocking (License-File warnings are false positives) ### Runtime - Modified `subprocess_cli.py` to check for bundled CLI first - Added `_cli_version.py` to track which CLI version is bundled - SDK automatically uses bundled CLI, falling back to system installation if not found - Users can still override with `cli_path` option ### Release Workflow - Updated GitHub workflow to build separate wheels per platform (macOS, Linux, Windows) - Workflow now accepts two inputs: - `version`: Package version to publish (e.g., `0.1.5`) - `claude_code_version`: CLI version to bundle (e.g., `2.0.0` or `latest`) - Workflow builds platform-specific wheels with bundled CLI - Creates release PR that updates: - `pyproject.toml` version - `src/claude_agent_sdk/_version.py` - `src/claude_agent_sdk/_cli_version.py` with bundled CLI version - `CHANGELOG.md` with auto-generated release notes ### Documentation - Updated README to reflect bundled CLI (removed Node.js requirement) - Added release workflow documentation - Added local wheel building instructions ## Benefits - **Zero external dependencies**: No need for Node.js or npm - **Easier installation**: Single `pip install` gets everything - **Version control**: Track exactly which CLI version is bundled - **Flexible releases**: Can release new package versions with updated CLI without code changes - **Better user experience**: Works out of the box with no setup Platform-specific wheels are automatically selected by pip during installation based on the user's OS and architecture. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 17:21:15 -08:00
github-actions[bot]	6f209075bc	chore: release v0.1.7 (#341) ... This PR updates the version to 0.1.7 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` - Updated version in `src/claude_agent_sdk/_version.py` - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.7/ - Install with: `pip install claude-agent-sdk==0.1.7` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: inigo <bogini@users.noreply.github.com>	2025-11-18 11:13:45 -08:00
bogini	50d68409c6	feat: add structured output support (#340) ... Add structured output support to Python SDK. ## Usage ```python from claude_agent_sdk import query, ClaudeAgentOptions schema = { "type": "object", "properties": {"count": {"type": "number"}}, "required": ["count"] } async for msg in query( prompt="Count files in src/", options=ClaudeAgentOptions( output_format={"type": "json_schema", "schema": schema} ) ): if hasattr(msg, 'structured_output'): print(msg.structured_output) ``` ## Documentation https://docs.claude.com/en/docs/agent-sdk/structured-outputs ## Tests - Unit tests: `tests/test_integration.py::TestIntegration::test_structured_output` - E2E tests: `e2e-tests/test_structured_output.py` (4 tests)	2025-11-18 11:01:17 -08:00