179 commits

This branch

This branch

All branches

Author	SHA1	Message	Date
Michael Dworsky	8934ae09ea	Fixed ruff ... 🏠 Remote-Dev: homespace	2025-11-24 16:21:51 +00:00
Michael Dworsky	7dd64ff237	Fix trio compatibility with owner task pattern for cancel scopes ... 🏠 Remote-Dev: homespace	2025-11-24 16:19:06 +00: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
Suzanne Wang	ff425b293d	Add fallback model handling for parity with TypeScript SDK (#317) ... Add support for automatic model fallback when primary model is overloaded. The Python SDK passes the fallback_model parameter to the Claude CLI, which handles the validation and fallback logic. Changes: - Add fallback_model parameter to ClaudeAgentOptions - Pass --fallback-model to CLI subprocess - Add test for fallback model command building The validation that fallback_model != model happens at the CLI layer, keeping the SDK implementation simple and focused on parameter passing. --------- Co-authored-by: Claude <noreply@anthropic.com>	2025-11-07 11:25:45 -08:00
Ashwin Bhat	5a4cc2f41a	feat: add support for Claude CLI at ~/.claude/local/claude (#302) ... Add ~/.claude/local/claude to the list of locations checked when finding the Claude CLI binary. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-31 08:52:17 -07:00
github-actions[bot]	c30ffbeb56	chore: release v0.1.6 (#301) ... This PR updates the version to 0.1.6 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.6/ - Install with: `pip install claude-agent-sdk==0.1.6` 🤖 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-10-30 22:40:51 -07:00
yokomotod	841f8c0614	fix: uses empty system prompt by default (#290) ... fix #289	2025-10-30 22:03:42 -07:00
Ashwin Bhat	5256af2dac	Update publish.yml (#300)	2025-10-30 17:05:10 -07:00
Ashwin Bhat	edad138cb0	Limit CI examples to Python 3.13 only (#299) ... Reduce CI job count by only running examples on Python 3.13 instead of all Python versions (3.10-3.13). This reduces the combinatorial explosion while still ensuring examples work on the latest Python version. Co-authored-by: Claude <noreply@anthropic.com>	2025-10-30 17:05:01 -07:00
Ashwin Bhat	ae800c5ec8	feat: add max_budget_usd option to Python SDK (#293) ... Add support for limiting API costs using the max_budget_usd option, mirroring the TypeScript SDK functionality. When the budget is exceeded, query execution stops and returns a result with subtype 'error_max_budget_usd'. - Add max_budget_usd field to ClaudeAgentOptions - Pass --max-budget-usd flag to Claude Code CLI - Add test coverage for budget limit behavior 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-30 16:45:35 -07:00
blois	7be296f12e	feat: add max_thinking_tokens option to ClaudeAgentOptions (#298) ... Add support for controlling the maximum number of tokens allocated to extended thinking blocks via the max_thinking_tokens parameter. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-30 15:14:42 -07:00
Ashwin Bhat	fd4e33d4b9	feat: add /generate-changelog slash command (#287) ... Move changelog generation prompt from publish.yml into a reusable slash command at .claude/commands/generate-changelog.md. Update workflow to call the command with version parameters. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-24 16:21:55 -07:00
github-actions[bot]	68eb68b740	chore: release v0.1.5 (#286) ... This PR updates the version to 0.1.5 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.5/ - Install with: `pip install claude-agent-sdk==0.1.5` 🤖 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-10-24 16:04:33 -07:00
Ashwin Bhat	c5957634ac	feat: add plugin support to Python SDK (#285) ... Add SdkPluginConfig type and plugins field to ClaudeAgentOptions. Plugins can be loaded using the local type with a path to the plugin directory. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-24 15:29:01 -07:00
github-actions[bot]	5656aeadd6	chore: release v0.1.4 (#260) ... This PR updates the version to 0.1.4 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.4/ - Install with: `pip install claude-agent-sdk==0.1.4` 🤖 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-10-23 16:10:13 -07:00
Ashwin Bhat	9b8576158d	fix: fetch all git history including tags in publish workflow (#284) ... The changelog generation step was failing to get the previous release tag because the checkout action was doing a shallow clone. Adding fetch-depth: 0 ensures all tags are available for git describe. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-23 15:03:41 -07:00
KuaaMU	41e220cc2c	fix: handle Windows command line length limit for --agents option (#245) ... ## Summary Fixes #238 - Resolves "command line too long" error on Windows when using multiple subagents with long prompts. ## Problem On Windows, the command line length is limited to 8191 characters (cmd.exe). When using multiple subagents with long prompts, the `--agents` JSON argument can easily exceed this limit, causing the error: ``` 命令行太长。 (command line too long) Fatal error in message reader: Command failed with exit code 1 ``` ## Solution This PR implements automatic detection and handling of command line length limits: 1. **Platform-specific limits**: - Windows: 8000 characters (safe margin below 8191) - Other platforms: 100,000 characters 2. **Automatic fallback**: When the command line would exceed the limit: - Write agents JSON to a temporary file - Use Claude CLI's `@filepath` syntax to reference the file - Clean up temp files when transport is closed 3. **Zero breaking changes**: The fix is transparent to users - it automatically activates only when needed ## Changes - Add `platform` and `tempfile` imports - Add `_CMD_LENGTH_LIMIT` constant with platform-specific values - Track temporary files in `self._temp_files` list - Modify `_build_command()` to detect long command lines and use temp files - Clean up temp files in `close()` method ## Testing - ✅ All existing tests pass (122 tests) - ✅ Linting and type checking pass - ✅ Minimal changes - only 47 lines added/modified - ✅ Solution transparently handles the Windows command line limit ## Test plan - [x] Test on Windows with multiple subagents and long prompts - [x] Verify temp files are created and cleaned up properly - [x] Verify normal operation (short command lines) is unaffected - [x] Test cross-platform compatibility (limit only applies on Windows) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-23 10:16:47 -07:00
Ashwin Bhat	923d3d4620	feat: add CLAUDE_AGENT_SDK_SKIP_VERSION_CHECK env var (#257) ... Adds environment variable to allow skipping the Claude Code version check. Users can set CLAUDE_AGENT_SDK_SKIP_VERSION_CHECK to disable the check. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-15 14:17:04 -07:00
Arash Dabiri	f27c4ab4c7	feat: Added base64 image handling to sdk_mcp_server tool calling (#175) ... With this change claude_code_sdk tools can now also return base64 images, in addition to text, following the MCP standard. For example: ``` import base64 @tool("make_response", "prompt", {"foo": str}) def make_response(args): fake_bytes = b"someimagebytes" encoded_image = base64.b64encode(fake_bytes).decode("utf-8") return { "content": [ {"type": "text", "text": "Hello world!"}, { "type": "image", "mimeType": "image/jpeg", "data": encoded_image, }, ] } ``` The image will now be sent to Claude Code when calling the function, allowing it to react to it. --------- Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-10-15 07:22:14 -07:00
Ashwin Bhat	f896cd6f7f	feat: add pre-push hook for lint checks (#254) ... Adds a committable pre-push hook that runs ruff checks before pushing, matching the CI lint workflow. Developers run ./scripts/initial-setup.sh to install the hook locally. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-14 09:26:49 -07:00
Chase Naples	aebcf9d6a4	feat: add cli_path support to ClaudeAgentOptions (#235) ... ## Summary Adds support for passing custom Claude Code CLI paths through `ClaudeAgentOptions`, allowing organizations with non-standard installation locations to specify the CLI path explicitly. ## Motivation As noted in #214, organizations may install Claude Code CLI (or wrapped versions) at custom locations and prefer to provide those paths instead of relying on the SDK's default search logic. The transport layer already supported `cli_path`, but it was never exposed through the public API. ## Changes 1. **types.py**: Added `cli_path: str | Path | None = None` parameter to `ClaudeAgentOptions` dataclass 2. **_internal/client.py**: Pass `cli_path` from `configured_options.cli_path` to `SubprocessCLITransport` 3. **client.py**: Pass `cli_path` from `options.cli_path` to `SubprocessCLITransport` ## Implementation Details The `SubprocessCLITransport` constructor already accepted a `cli_path` parameter (line 40 of subprocess_cli.py), but it was never passed from the client layers. This PR completes the wiring by: - Adding the option to the public `ClaudeAgentOptions` interface - Extracting and passing it through both client implementations (`InternalClient.process_query` and `ClaudeSDKClient.connect`) ## Usage Example ```python from claude_agent_sdk import query, ClaudeAgentOptions # Specify custom CLI path options = ClaudeAgentOptions( cli_path="/custom/path/to/claude" ) result = await query("Hello!", options=options) ``` ## Testing - No new tests added as this is a straightforward parameter pass-through - Existing tests should continue to work (default behavior unchanged) - CI will validate the changes don't break existing functionality Fixes #214 --------- Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-10-12 23:19:53 -07:00
github-actions[bot]	20c1b89734	chore: release v0.1.3 (#242) ... This PR updates the version to 0.1.3 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.3/ - Install with: `pip install claude-agent-sdk==0.1.3` 🤖 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-10-10 17:23:14 -07:00
Ashwin Bhat	1f080748d4	Revert "chore: temporarily disable Windows CI in test-e2e workflow" (#241) ... Reverts anthropics/claude-agent-sdk-python#234	2025-10-10 16:40:58 -07:00
Ashwin Bhat	d754e5cc1d	feat: add strongly-typed hook inputs with TypedDict (#240) ... Add typed hook input structures (PreToolUseHookInput, PostToolUseHookInput, etc.) to provide better IDE autocomplete and type safety for hook callbacks. Also convert HookContext from dataclass to TypedDict to match runtime behavior. Changes: - Add BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, UserPromptSubmitHookInput, StopHookInput, SubagentStopHookInput, and PreCompactHookInput TypedDict classes - Update HookCallback signature to use HookInput union type - Convert HookContext from dataclass to TypedDict (fixes type mismatch) - Export all new hook input types from __init__.py - Update all examples and tests to use typed hook inputs Benefits: - Zero breaking changes (TypedDict is dict-compatible at runtime) - Full type safety and IDE autocomplete for hook callbacks - Matches TypeScript SDK structure exactly - Self-documenting hook input fields 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-10 16:22:13 -07:00
Ashwin Bhat	48b62a05a3	fix: convert Python-safe field names (async_, continue_) to CLI format (#239) ... Fixes critical bug where hook outputs using `async_` and `continue_` (Python-safe names avoiding keyword conflicts) were not being converted to `async` and `continue` as expected by the CLI. This caused hook control fields like `{"decision": "block"}` or `{"continue_": False}` to be silently ignored. Changes: - Add _convert_hook_output_for_cli() to handle field name conversion - Apply conversion in hook callback handling - Update type documentation to clarify field name usage - Add comprehensive test coverage for field name conversion - Update existing tests to verify conversion occurs correctly 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-10 10:25:35 -07:00
github-actions[bot]	67e77e928a	chore: release v0.1.2 (#236) ... This PR updates the version to 0.1.2 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.2/ - Install with: `pip install claude-agent-sdk==0.1.2` 🤖 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-10-09 19:56:53 -07:00
Ashwin Bhat	e8d7e71a0a	Add missing hook output fields to match TypeScript SDK (#226) ... Closes the gap between Python and TypeScript SDK hook output types by adding: - `reason` field for explaining decisions - `continue_` field for controlling execution flow - `suppressOutput` field for hiding stdout - `stopReason` field for stop explanations - `decision` now supports both "approve" and "block" (not just "block") - `AsyncHookJSONOutput` type for deferred hook execution - Proper typing for `hookSpecificOutput` with discriminated unions Also adds comprehensive examples and tests: - New examples in hooks.py demonstrating all new fields - Unit tests in test_tool_callbacks.py for new output types - E2E tests in e2e-tests/test_hooks.py with real API calls - CI integration in .github/workflows/test.yml 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com>	2025-10-09 18:13:23 -07:00
Ashwin Bhat	5bea2dc27d	chore: temporarily disable Windows CI in test-e2e workflow (#234) ... Temporarily removes windows-latest from the test-e2e job matrix to disable Windows end-to-end testing. Unit tests continue to run on Windows. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-09 17:01:14 -07:00
Victor Mota	dcd51c9ecb	fix #227: Fix PermissionResultAllow conversion to control_response (#232) ... https://github.com/anthropics/claude-agent-sdk-python/issues/227 Fixes zod issues returned by cli subprocess transport - example now runs correctly to completion: ``` ============================================================ Tool Permission Callback Example ============================================================ This example demonstrates how to: 1. Allow/deny tools based on type 2. Modify tool inputs for safety 3. Log tool usage 4. Prompt for unknown tools ============================================================ 📝 Sending query to Claude... 📨 Receiving response... 💬 Claude: I'll help you with these tasks. Let me execute them in sequence. 💬 Claude: Now I'll create a simple Python hello world script: 🔧 Tool Permission Request: Write Input: { "file_path": "/Users/vimota/code/claude-agent-sdk-python/hello.py", "content": "#!/usr/bin/env python3\n\nprint(\"Hello, World!\")\n" } ⚠️ Redirecting write from /Users/vimota/code/claude-agent-sdk-python/hello.py to ./safe_output/hello.py 💬 Claude: Now let's run the script: 🔧 Tool Permission Request: Bash Input: { "command": "python hello.py", "description": "Run hello.py script" } ✅ Allowing bash command: python hello.py 💬 Claude: Let me check where the file was created: 💬 Claude: I see the file was created in the `safe_output` directory. Let me run it from there: 🔧 Tool Permission Request: Bash Input: { "command": "python ./safe_output/hello.py", "description": "Run hello.py from safe_output" } ✅ Allowing bash command: python ./safe_output/hello.py 💬 Claude: Perfect! All tasks completed successfully: 1. **Listed files** - The directory contains a Python SDK project with source code in `src/`, tests, examples, and configuration files. 2. **Created hello.py** - A simple Python script was created at `./safe_output/hello.py` with a basic "Hello, World!" print statement. 3. **Ran the script** - The script executed successfully and printed "Hello, World!" to the console. Note: The file was created in the `safe_output/` subdirectory rather than the root directory. ✅ Task completed! Duration: 31158ms Cost: $0.0736 Messages processed: 18 ============================================================ Tool Usage Summary ============================================================ 1. Tool: Write Input: { "file_path": "/Users/vimota/code/claude-agent-sdk-python/hello.py", "content": "#!/usr/bin/env python3\n\nprint(\"Hello, World!\")\n" } Suggestions: [{'type': 'setMode', 'mode': 'acceptEdits', 'destination': 'session'}] 2. Tool: Bash Input: { "command": "python hello.py", "description": "Run hello.py script" } Suggestions: [{'type': 'addRules', 'rules': [{'toolName': 'Bash', 'ruleContent': 'python:*'}], 'behavior': 'allow', 'destination': 'localSettings'}] 3. Tool: Bash Input: { "command": "python ./safe_output/hello.py", "description": "Run hello.py from safe_output" } Suggestions: [{'type': 'addRules', 'rules': [{'toolName': 'Bash', 'ruleContent': 'python:*'}], 'behavior': 'allow', 'destination': 'localSettings'}] ```	2025-10-09 12:24:13 -07:00
Ashwin Bhat	71a85ac9aa	feat: automate changelog updates in release workflow (#231) ... Replace GitHub API-based commits with local git workflow and integrate claude-code-action to automatically generate changelog entries. The workflow now: - Creates release branch locally with version commits - Uses Claude to review changes and update CHANGELOG.md - Pushes complete branch with all commits together 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com>	2025-10-09 10:36:54 -07:00
Ashwin Bhat	c2b72f1cc5	Add CHANGELOG entry for version 0.1.1 (#229) ... Document the features and improvements released in version 0.1.1, including minimum Claude Code version check, updated PermissionResult types, and simplified model references. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-09 08:27:58 -07:00
Ashwin Bhat	6793e40264	Add Windows support to test workflows (#222) ... Add cross-platform testing for Windows alongside Linux across all test jobs (unit tests, e2e tests, and examples). Uses native Windows installation via PowerShell script and platform-specific timeout handling for example scripts. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com>	2025-10-07 17:28:24 -07:00
KuaaMU	14f0714a8c	Fix Windows test failures due to path separator issues (#219) ... - Make test_cli_path_accepts_pathlib_path platform-aware by comparing with str(path) - Fix test_build_command_with_add_dirs to check directories individually - Fix test_build_command_with_mcp_servers_as_file_path to handle Path conversion - Fix test_query_with_async_iterable to properly execute Python scripts on Windows All tests now pass on both Windows and Unix-like systems (110/110 tests passing). Fixes the issue #217 where pathlib.Path automatically converts path separators based on the operating system, causing test assertions to fail on Windows.	2025-10-07 16:18:30 -07:00