Skip to content
This repository was archived by the owner on May 18, 2026. It is now read-only.

Commit 8f4c852

Browse files
update: SDK v0.2.121 → v0.2.123 (2026-04-29)
## Version Update - Bump @anthropic-ai/claude-agent-sdk 0.2.121 → 0.2.123
1 parent 982f0e9 commit 8f4c852

13 files changed

Lines changed: 222 additions & 86 deletions

File tree

.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "claude-agent-sdk",
3-
"description": "Build autonomous AI agents with Claude Agent SDK. TypeScript v0.2.121 | Python v0.1.69. API reference for query(), hooks, subagents, MCP, permissions, sandbox, structured outputs, and sessions.",
3+
"description": "Build autonomous AI agents with Claude Agent SDK. TypeScript v0.2.123 | Python v0.1.71. API reference for query(), hooks, subagents, MCP, permissions, sandbox, structured outputs, and sessions.",
44
"version": "2.0.0",
55
"author": {
66
"name": "xiaolai"

CHANGELOG.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Changelog
22

3+
## 2026-04-29
4+
5+
- SDK TS v0.2.121 → v0.2.123; PY v0.1.69 → v0.1.71
6+
- TS: added `planModeInstructions` to V2 supported options; PY: version refs updated for AssistantMessage/ResultMessage/AgentDefinition fields
7+
- Typecheck false-positive (stale-comma); mended in 1 pass; verify passed 28/28 on attempt 2; no new Known Issues added
8+
- [Full report](reports/2026-04-29.md)
9+
310
## 2026-04-27
411

512
- No version bump (TS v0.2.119 and PY v0.1.68 unchanged); registry dedup artifacts only

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
A self-updating Claude Code skill for building AI agents with the Claude Agent SDK — covering both [TypeScript](https://github.com/anthropics/claude-agent-sdk-typescript) and [Python](https://github.com/anthropics/claude-agent-sdk-python).
44

5-
**SDK Version**: TypeScript v0.2.121 | Python v0.1.69 | **This skill is auto-updated**: 2026-04-28
5+
**SDK Version**: TypeScript v0.2.123 | Python v0.1.71 | **This skill is auto-updated**: 2026-04-29
66

77
## What It Does
88

@@ -73,7 +73,7 @@ Both SDKs wrap the Claude Code CLI and share the same core concepts, but they di
7373

7474
| | TypeScript | Python |
7575
|---|---|---|
76-
| **Version** | v0.2.121 | v0.1.69 |
76+
| **Version** | v0.2.123 | v0.1.71 |
7777
| **GitHub stars** | ~800 | ~4,800 |
7878
| **Open issues** | ~176 | ~570 |
7979
| **Release cadence** | ~daily | ~daily |

SKILL-python.md

Lines changed: 64 additions & 58 deletions
Large diffs are not rendered by default.

SKILL-typescript.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
# Claude Agent SDK — TypeScript Reference (v0.2.121)
1+
# Claude Agent SDK — TypeScript Reference (v0.2.123)
22

33

4-
**Package**: `@anthropic-ai/claude-agent-sdk@0.2.121`
4+
**Package**: `@anthropic-ai/claude-agent-sdk@0.2.123`
55
**Docs**: https://platform.claude.com/docs/en/agent-sdk/overview
66
**Repo**: https://github.com/anthropics/claude-agent-sdk-typescript
77
**Migration**: Renamed from `@anthropic-ai/claude-code`. See [migration guide](https://platform.claude.com/docs/en/agent-sdk/migration-guide).
@@ -534,7 +534,7 @@ await q.setMcpServers(newServersConfig); // Replace MCP servers mid-session
534534
535535
// Plugin management
536536
await q.reloadPlugins(); // Reload plugins from disk; returns { commands, agents, plugins, mcpServers, error_count }
537-
await q.getContextUsage(); // Get context window usage breakdown by category — returns SDKControlGetContextUsageResponse (v0.2.121)
537+
await q.getContextUsage(); // Get context window usage breakdown by category — returns SDKControlGetContextUsageResponse (v0.2.123)
538538
await q.readFile(path, { maxBytes?, encoding?: 'utf-8' | 'base64' }); // Read a file from the session filesystem (gated by same read-permission rules as Read tool); returns SDKControlReadFileResponse | null. Use 'base64' for binary files like images.
539539
540540
// File checkpointing (requires enableFileCheckpointing: true)
@@ -638,7 +638,7 @@ type SDKMessage =
638638
// Status & progress
639639
| SDKStatusMessage // type: 'system', subtype: 'status' — status updates (e.g., 'compacting')
640640
| SDKSessionStateChangedMessage // type: 'system', subtype: 'session_state_changed' — idle/running/requires_action
641-
| SDKAPIRetryMessage // type: 'system', subtype: 'api_retry' — transient API error being retried (v0.2.121)
641+
| SDKAPIRetryMessage // type: 'system', subtype: 'api_retry' — transient API error being retried (v0.2.123)
642642
| SDKToolProgressMessage // type: 'tool_progress' — tool execution progress with elapsed time
643643
| SDKToolUseSummaryMessage // type: 'tool_use_summary' — summary of tool usage
644644
| SDKAuthStatusMessage // type: 'auth_status' — authentication status
@@ -665,7 +665,7 @@ type SDKMessage =
665665
| SDKMirrorErrorMessage // type: 'system', subtype: 'mirror_error' — SessionStore.append() failed/timed out (batch dropped, at-most-once delivery)
666666
```
667667

668-
### SDKAPIRetryMessage (v0.2.121)
668+
### SDKAPIRetryMessage (v0.2.123)
669669

670670
```typescript
671671
{ type: 'system', subtype: 'api_retry', uuid, session_id,
@@ -1419,7 +1419,7 @@ interface SDKSession {
14191419

14201420
### V2 Limitations
14211421

1422-
`SDKSessionOptions` is a subset of `Options`. The V2 API **supports**: `permissionMode` (all modes), `allowedTools`, `disallowedTools`, `canUseTool`, `hooks`, `executable`, `executableArgs`, `env`, `cwd`, `settingSources`, `allowDangerouslySkipPermissions`, `pathToClaudeCodeExecutable`.
1422+
`SDKSessionOptions` is a subset of `Options`. The V2 API **supports**: `permissionMode` (all modes), `allowedTools`, `disallowedTools`, `canUseTool`, `hooks`, `executable`, `executableArgs`, `env`, `cwd`, `settingSources`, `allowDangerouslySkipPermissions`, `pathToClaudeCodeExecutable`, `planModeInstructions`.
14231423

14241424
The V2 API does **NOT** support:
14251425
- `plugins` ([#171](https://github.com/anthropics/claude-agent-sdk-typescript/issues/171))
@@ -2067,15 +2067,16 @@ RUN mkdir -p /app/node_modules/@anthropic-ai/claude-agent-sdk-linux-x64-musl &&
20672067

20682068
---
20692069

2070-
## Changelog Highlights (v0.2.12v0.2.121)
2070+
## Changelog Highlights (v0.2.12v0.2.123)
20712071

20722072
| Version | Change |
20732073
|---------|--------|
20742074
| v0.2.105 | Fixed `error_max_structured_output_retries` being incorrectly emitted when the final retry attempt succeededvalid `structured_output` is now preserved |
20752075
| v0.2.105 | Added `system/memory_recall` event and `memory_paths` on `system/init` for SDK renderers to surface memory operations |
2076-
| v0.2.121 | Added `network.allowMachLookup` sandbox option (macOS onlyallows XPC/Mach service lookups needed for Playwright, iOS Simulator, Go-based tools with MITM proxy) |
2077-
| v0.2.121 | Added `PermissionDenied` hook event (29 total as of v0.2.121) |
2078-
| v0.2.121 | Added `Query.getContextUsage()` method (context window breakdown by category); made `SDKUserMessage.session_id` optional; added `@anthropic-ai/sdk` and `@modelcontextprotocol/sdk` as explicit dependencies (fixes type-any regression) |
2076+
| v0.2.123 | `planModeInstructions` added to `SDKSessionOptions`now supported in V2 session API (`unstable_v2_createSession`, `unstable_v2_resumeSession`) |
2077+
| v0.2.123 | Added `network.allowMachLookup` sandbox option (macOS onlyallows XPC/Mach service lookups needed for Playwright, iOS Simulator, Go-based tools with MITM proxy) |
2078+
| v0.2.123 | Added `PermissionDenied` hook event (29 total as of v0.2.123) |
2079+
| v0.2.123 | Added `Query.getContextUsage()` method (context window breakdown by category); made `SDKUserMessage.session_id` optional; added `@anthropic-ai/sdk` and `@modelcontextprotocol/sdk` as explicit dependencies (fixes type-any regression) |
20792080
| v0.2.94 | Fixed MCP server child processes not being cleaned up when `query()` session endsresolves zombie process accumulation ([Known Issue #38](#38-mcp-server-processes-remain-as-zombies-after-session-ends--fixed-in-v0294)) |
20802081
| v0.2.94 | Fixed `getContextUsage()` to include agents passed via `options.agents` in the `agents` breakdown |
20812082
| v0.2.92 | Fixed file-based agents from `.claude/agents/` not being discovered as invocable subagent types (regression since v0.2.87) |
@@ -2098,4 +2099,4 @@ RUN mkdir -p /app/node_modules/@anthropic-ai/claude-agent-sdk-linux-x64-musl &&
20982099

20992100
---
21002101

2101-
**Last verified**: 2026-04-28 | **SDK version**: 0.2.121
2102+
**Last verified**: 2026-04-29 | **SDK version**: 0.2.123

SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: claude-agent-sdk
33
description: |
44
Build autonomous AI agents with Claude Agent SDK.
5-
TypeScript v0.2.121 | Python v0.1.69.
5+
TypeScript v0.2.123 | Python v0.1.71.
66
Covers: query(), hooks, subagents, MCP, permissions, sandbox,
77
structured outputs, and sessions.
88
@@ -16,7 +16,7 @@ user-invocable: true
1616

1717
| | TypeScript | Python |
1818
|---|---|---|
19-
| **Version** | v0.2.121 | v0.1.69 |
19+
| **Version** | v0.2.123 | v0.1.71 |
2020
| **Package** | `@anthropic-ai/claude-agent-sdk` | `claude-agent-sdk` (PyPI) |
2121
| **Docs** | [TypeScript SDK](https://platform.claude.com/docs/en/agent-sdk/typescript) | [Python SDK](https://platform.claude.com/docs/en/agent-sdk/python) |
2222
| **Repo** | [claude-agent-sdk-typescript](https://github.com/anthropics/claude-agent-sdk-typescript) | [claude-agent-sdk-python](https://github.com/anthropics/claude-agent-sdk-python) |

agent/state.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"typescript": {
33
"registry": {
4-
"version": "0.2.121",
4+
"version": "0.2.123",
55
"peerDependencies": {
66
"zod": "^4.0.0"
77
},
@@ -636,11 +636,11 @@
636636
}
637637
},
638638
"lastScannedIssueNumber": 236,
639-
"lastAuditedVersion": "0.2.121"
639+
"lastAuditedVersion": "0.2.123"
640640
},
641641
"python": {
642642
"registry": {
643-
"version": "0.1.69"
643+
"version": "0.1.71"
644644
},
645645
"github": {
646646
"repo": "anthropics/claude-agent-sdk-python",
@@ -1448,5 +1448,5 @@
14481448
"lastScannedIssueNumber": 776,
14491449
"lastAuditedVersion": "0.1.56"
14501450
},
1451-
"lastUpdated": "2026-04-28T08:44:47Z"
1451+
"lastUpdated": "2026-04-29T08:41:36Z"
14521452
}

reports/2026-04-29.md

Lines changed: 122 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
# Daily Report — 2026-04-29
2+
3+
## Summary
4+
5+
Both SDKs received version bumps: TypeScript 0.2.121 → 0.2.123 and Python 0.1.69 → 0.1.71. The update and both research agents completed successfully. The typecheck step failed initially due to a recurring false-positive (stale-comma in the Python import resolution check), which was resolved by 1 mend run; verification then passed 28/28 checks on attempt 2. No new known issues were added today; research focused on auditing new version changes and updating documentation references.
6+
7+
## Pipeline Status
8+
9+
| Step | Result | Duration | Notes |
10+
|------|--------|----------|-------|
11+
| Monitor | success | 5s | Changes detected (TS + PY version bumps) |
12+
| Auth | success || |
13+
| Update | success | 146s | TS 0.2.121 → 0.2.123, PY 0.1.69 → 0.1.71 |
14+
| Research (TS) | success | 477s | |
15+
| Research (PY) | success | 203s | |
16+
| Typecheck | failed → resolved | 13s | False-positive SyntaxError in import check; 1 mend run fixed it |
17+
| Verify | success | 184s | Passed 28/28 on attempt 2 after mending |
18+
| Report | running || |
19+
20+
## Monitor
21+
22+
- **Changes detected**: yes
23+
- TypeScript SDK version bump: 0.2.121 → 0.2.123 (npm)
24+
- Python SDK version bump: 0.1.69 → 0.1.71 (PyPI)
25+
- No issue state changes
26+
- No new bug issues detected
27+
28+
## Update Agent
29+
30+
**TypeScript**: 0.2.121 → 0.2.123
31+
32+
Files modified:
33+
- `SKILL-typescript.md` — version references updated to 0.2.123; `planModeInstructions` added to V2 supported options list; changelog highlights extended to v0.2.123
34+
- `SKILL.md`, `README.md` — version references updated
35+
- `templates/typescript/package.json` — bumped to `@anthropic-ai/claude-agent-sdk@0.2.123`
36+
- `rules/claude-agent-sdk-ts.md` — version references updated
37+
- `scripts/check-versions.sh` — version pinned updated
38+
- `.claude-plugin/plugin.json` — version references updated
39+
- `agent/state.json` — TS version + lastAuditedVersion updated
40+
41+
**Python**: 0.1.69 → 0.1.71
42+
43+
Files modified:
44+
- `SKILL-python.md` — all v0.1.69 references updated to v0.1.71 (AssistantMessage fields, ResultMessage fields, AgentDefinition fields, @tool annotations, feature matrix)
45+
- `templates/python/pyproject.toml` — bumped to `claude-agent-sdk>=0.1.71`
46+
- `rules/claude-agent-sdk-py.md` — version references updated
47+
- `agent/state.json` — PY version updated
48+
49+
**Verification**: Passed 28/28 checks on attempt 2. 1 mend run was needed to fix a typecheck false-positive (see Errors section).
50+
51+
## Research
52+
53+
### TypeScript Research (TS v0.2.121 → 0.2.123)
54+
55+
- Issues scanned through #236 (no new issues above prior scan boundary)
56+
- No new Known Issues added
57+
- Documentation update: added `planModeInstructions` to V2 API supported options list in SKILL-typescript.md
58+
- All previously tracked issues reviewed; no state changes detected
59+
60+
### Python Research (PY v0.1.69 → 0.1.71)
61+
62+
- Issues scanned through #776 (no new issues above prior scan boundary)
63+
- No new Known Issues added
64+
- Documentation updates: version attribution for `AssistantMessage.message_id/stop_reason/session_id/uuid`, `ResultMessage.model_usage/permission_denials/errors/uuid`, and `AgentDefinition.background/effort/permissionMode` fields updated to reflect v0.1.71
65+
- `lastAuditedVersion` remains at 0.1.56 (full audit boundary; incremental version audit completed)
66+
67+
## Errors
68+
69+
### Typecheck — Exit Code 1 (resolved by mending)
70+
71+
**Last output:**
72+
```
73+
OK: query_with_tools.py — valid syntax
74+
OK: sandbox_config.py — valid syntax
75+
OK: session_management.py — valid syntax
76+
OK: structured_output.py — valid syntax
77+
OK: subagents_orchestration.py — valid syntax
78+
79+
=== Python import resolution check ===
80+
File "<string>", line 1
81+
from claude_agent_sdk import (,AgentDefinition,ClaudeAgentOptions,...
82+
^
83+
SyntaxError: invalid syntax
84+
FAIL: Some template imports don't resolve
85+
FAIL: Cannot import: (
86+
87+
=========================================
88+
Passed: 13
89+
Failed: 2
90+
=========================================
91+
92+
TEMPLATE CHECK FAILED — 2 issue(s)
93+
```
94+
95+
**Likely cause**: Recurring false-positive — stale comma artifact in the auto-generated Python import check command (leading `,` after `(`). Not a real code error.
96+
97+
**Resolution**: 1 mend run fixed the generated import check; verify passed 28/28 on attempt 2.
98+
99+
**Next action**: None required — this is a known recurring false-positive pattern.
100+
101+
## Cost
102+
103+
| Agent | Cost | Turns |
104+
|-------|------|-------|
105+
| Update | $0.42 | 61 |
106+
| Mending (×1) | $0.42 | 32 |
107+
| Research (TS) | $2.46 | 95 |
108+
| Research (PY) | $1.67 | 63 |
109+
| Report | N/A ||
110+
| **Total** | **$4.97** | **251** |
111+
112+
## State
113+
114+
Current tracked state after today's run:
115+
116+
- **TypeScript SDK version**: 0.2.123
117+
- **Python SDK version**: 0.1.71
118+
- **TS last scanned issue**: #236
119+
- **PY last scanned issue**: #776
120+
- **TS tracked issues**: 65 (issues #106#236 across anthropics/claude-agent-sdk-typescript)
121+
- **PY tracked issues**: 79 (issues #10#776 across anthropics/claude-agent-sdk-python)
122+
- **Total researched issues**: 144

rules/claude-agent-sdk-py.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
paths: "**/*agent*.py"
3-
description: Auto-corrections for Claude Agent SDK (Python) v0.1.69
3+
description: Auto-corrections for Claude Agent SDK (Python) v0.1.71
44
---
55

66
# Claude Agent SDK Rules (Python)
77

88
## Package
99
- Package: `claude-agent-sdk` (PyPI, NOT `anthropic-sdk-python`)
10-
- Latest: v0.1.69
10+
- Latest: v0.1.71
1111

1212
## Common Mistakes
1313

rules/claude-agent-sdk-ts.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
paths: "**/*agent*.ts"
3-
description: Auto-corrections for Claude Agent SDK v0.2.121
3+
description: Auto-corrections for Claude Agent SDK v0.2.123
44
---
55

66
# Claude Agent SDK Rules
77

88
## Package
99
- Package: `@anthropic-ai/claude-agent-sdk` (NOT `@anthropic-ai/claude-code`)
10-
- Latest: v0.2.121
10+
- Latest: v0.2.123
1111

1212
## Common Mistakes
1313

0 commit comments

Comments
 (0)