NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →

npm · #3768 most downloaded on npm

@anthropic-ai/claude-agent-sdk

0.3.289anthropics/claude-agent-sdk-typescript ↗New releases in your daily digest, changelog included.

SDK for building AI agents with Claude Code's capabilities. Programmatically interact with Claude to build autonomous agents that can understand codebases, edit files, and execute workflows.

Last release today
03 Oct 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
313 releases · first in 2025

Release timeline

313 releases since 2025

20252026

Releases

0.3.14922 May 20262 sources agree
Fixed options.env dropping CLAUDE_AGENT_SDK_VERSION (used for User-Agent and telemetry) when a custom environment is supplied, and corrected the Optio
What's changed

Fixed options.env dropping CLAUDE_AGENT_SDK_VERSION (used for User-Agent and telemetry) when a custom environment is supplied, and corrected the Options.env docs to state that the value replaces the subprocess environment rather than merging with process.env

Update

npm install @anthropic-ai/claude-agent-sdk@0.3.149 # or yarn add @anthropic-ai/claude-agent-sdk@0.3.149 # or pnpm add @anthropic-ai/claude-agent-sdk@0.3.149 # or bun add @anthropic-ai/claude-agent-sdk@0.3.149
Open source →

0.3.14822 May 20262 sources agree

Updated to parity with Claude Code v2.1.148

What's changed

Updated to parity with Claude Code v2.1.148

Update

npm install @anthropic-ai/claude-agent-sdk@0.3.148
# or
yarn add @anthropic-ai/claude-agent-sdk@0.3.148
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.3.148
# or
bun add @anthropic-ai/claude-agent-sdk@0.3.148

0.3.14721 May 20262 sources agree

Updated to parity with Claude Code v2.1.147

What's changed

Updated to parity with Claude Code v2.1.147

Update

npm install @anthropic-ai/claude-agent-sdk@0.3.147
# or
yarn add @anthropic-ai/claude-agent-sdk@0.3.147
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.3.147
# or
bun add @anthropic-ai/claude-agent-sdk@0.3.147

Open source →

0.3.14620 May 20262 sources agree

Updated to parity with Claude Code v2.1.146

What's changed

Updated to parity with Claude Code v2.1.146

Update

npm install @anthropic-ai/claude-agent-sdk@0.3.146
# or
yarn add @anthropic-ai/claude-agent-sdk@0.3.146
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.3.146
# or
bun add @anthropic-ai/claude-agent-sdk@0.3.146

Open source →

0.3.14519 May 20262 sources agree

Updated to parity with Claude Code v2.1.145

What's changed

Updated to parity with Claude Code v2.1.145

Update

npm install @anthropic-ai/claude-agent-sdk@0.3.145
# or
yarn add @anthropic-ai/claude-agent-sdk@0.3.145
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.3.145
# or
bun add @anthropic-ai/claude-agent-sdk@0.3.145

Open source →

0.3.14418 May 20262 sources agree

Assistant messages and StopFailure hooks now report error: 'model_not_found' when the selected model doesn't exist or isn't available, instead of the

What's changed

Assistant messages and StopFailure hooks now report error: 'model_not_found' when the selected model doesn't exist or isn't available, instead of the generic 'invalid_request'. The api_error_status field on result messages is now documented.
Added @anthropic-ai/claude-agent-sdk/extract export for bun build --compile consumers: import the platform native binary with with { type: 'file' }, call extractFromBunfs(binPath) to copy it out of the compiled executable's virtual filesystem, and pass the result to options.pathToClaudeCodeExecutable

Update

npm install @anthropic-ai/claude-agent-sdk@0.3.144
# or
yarn add @anthropic-ai/claude-agent-sdk@0.3.144
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.3.144
# or
bun add @anthropic-ai/claude-agent-sdk@0.3.144

Open source →

0.3.14315 May 20262 sources agree

@anthropic-ai/sdk and @modelcontextprotocol/sdk are now peerDependencies instead of dependencies. Runtime is unaffected (both are bundled); npm/bun/pn

What's changed

@anthropic-ai/sdk and @modelcontextprotocol/sdk are now peerDependencies instead of dependencies. Runtime is unaffected (both are bundled); npm/bun/pnpm auto-install them. yarn classic users should add them explicitly for full TypeScript type resolution

Update

npm install @anthropic-ai/claude-agent-sdk@0.3.143
# or
yarn add @anthropic-ai/claude-agent-sdk@0.3.143
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.3.143
# or
bun add @anthropic-ai/claude-agent-sdk@0.3.143

Open source →

0.3.14214 May 2026Deprecated2 sources agree

…SDKSession, SDKSessionOptions), deprecated since 0.2.133. Use query() — pass an AsyncIterable for multi-turn, or options.resume to continue a session.

What's changed

Breaking: Removed the v2 session API (unstable_v2_createSession, unstable_v2_resumeSession, unstable_v2_prompt, SDKSession, SDKSessionOptions), deprecated since 0.2.133. Use query() — pass an AsyncIterable<SDKUserMessage> for multi-turn, or options.resume to continue a session.
Breaking: MCP servers now connect in the background by default; sessions start immediately and slow servers report status: "pending" in init until ready. Set MCP_CONNECTION_NONBLOCKING=0 to restore the old behavior of waiting up to 5s before the first query, or mark a server alwaysLoad: true to require it in turn 1.
Breaking: Headless and SDK sessions now use Task tools (TaskCreate / TaskUpdate / TaskGet / TaskList) instead of TodoWrite, deprecated since 0.2.136. Tool consumers should accumulate by task ID instead of replacing a snapshot list.
Surfaced request_id, subagent_type, and task_description on SDK message types and task system events
Headless --sdk-url sessions now exit non-zero with a stderr diagnostic when the remote transport closes permanently (401/403/404 or WS permanent close), instead of silently exiting 0

Update

npm install @anthropic-ai/claude-agent-sdk@0.3.142
# or
yarn add @anthropic-ai/claude-agent-sdk@0.3.142
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.3.142
# or
bun add @anthropic-ai/claude-agent-sdk@0.3.142

Open source →

0.2.14113 May 20262 sources agree

TaskCreateInput, TaskCreateOutput, TaskGetInput, TaskGetOutput, TaskUpdateInput, TaskUpdateOutput, TaskListInput, and TaskListOutput types are now exp

What's changed

TaskCreateInput, TaskCreateOutput, TaskGetInput, TaskGetOutput, TaskUpdateInput, TaskUpdateOutput, TaskListInput, and TaskListOutput types are now exported from @anthropic-ai/claude-agent-sdk/sdk-tools and included in the ToolInputSchemas/ToolOutputSchemas unions
Aligned @anthropic-ai/sdk dependency to ^0.93.0

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.141
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.141
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.141
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.141

Open source →

0.2.14012 May 20262 sources agree

Updated to parity with Claude Code v2.1.140

What's changed

Updated to parity with Claude Code v2.1.140

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.140
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.140
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.140
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.140

Open source →

0.2.13911 May 20262 sources agree

Updated to parity with Claude Code v2.1.139

What's changed

Updated to parity with Claude Code v2.1.139

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.139
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.139
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.139
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.139

Open source →

0.2.1389 May 20262 sources agree

Updated to parity with Claude Code v2.1.138

What's changed

Updated to parity with Claude Code v2.1.138

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.138
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.138
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.138
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.138

Open source →

0.2.1379 May 20262 sources agree

Updated to parity with Claude Code v2.1.137

What's changed

Updated to parity with Claude Code v2.1.137

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.137
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.137
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.137
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.137

Open source →

0.2.1368 May 2026Deprecated2 sources agree

Deprecated TodoWrite tool — future versions will switch to Task tools (TaskCreate, TaskGet, TaskUpdate, TaskList)

What's changed

Added resolveSettings() (alpha) to inspect effective merged settings without spawning the Claude CLI; reads MDM (plist/HKLM/HKCU) for parity with CLI startup
Deprecated TodoWrite tool — future versions will switch to Task tools (TaskCreate, TaskGet, TaskUpdate, TaskList)

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.136
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.136
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.136
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.136

Open source →

0.2.1337 May 2026Deprecated2 sources agree

Deprecated the unstable V2 session API (unstable_v2_createSession / unstable_v2_resumeSession / unstable_v2_prompt) — use query() instead

What's changed

Deprecated the unstable V2 session API (unstable_v2_createSession / unstable_v2_resumeSession / unstable_v2_prompt) — use query() instead
Deprecated passing 'Skill' in allowedTools — use the skills option instead
Updated to parity with Claude Code v2.1.133

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.133
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.133
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.133
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.133

Open source →

0.2.1326 May 20262 sources agree

Documented applyFlagSettings() in the TypeScript Agent SDK reference and added support for null on top-level keys to clear flag-settings overrides

What's changed

Documented applyFlagSettings() in the TypeScript Agent SDK reference and added support for null on top-level keys to clear flag-settings overrides
Updated to parity with Claude Code v2.1.132

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.132
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.132
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.132
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.132

Open source →

0.2.1316 May 20262 sources agree

Updated to parity with Claude Code v2.1.131

What's changed

Updated to parity with Claude Code v2.1.131

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.131
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.131
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.131
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.131

Open source →

0.2.1295 May 20262 sources agree

Updated to parity with Claude Code v2.1.129

What's changed

Updated to parity with Claude Code v2.1.129

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.129
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.129
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.129
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.129

Open source →

0.2.1284 May 20262 sources agree

Updated to parity with Claude Code v2.1.128

What's changed

Updated to parity with Claude Code v2.1.128

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.128
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.128
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.128
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.128

Open source →

0.2.12630 Apr 20262 sources agree

Added origin to result messages (SDKResultSuccess / SDKResultError) — forwards the triggering message's SDKMessageOrigin so consumers can distinguish

What's changed

Added origin to result messages (SDKResultSuccess / SDKResultError) — forwards the triggering message's SDKMessageOrigin so consumers can distinguish user-prompted results from task-notification followups

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.126
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.126
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.126
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.126

Open source →

0.2.12329 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.123

What's changed

Updated to parity with Claude Code v2.1.123

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.123
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.123
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.123
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.123

Open source →

0.2.12228 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.122

What's changed

Updated to parity with Claude Code v2.1.122

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.122
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.122
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.122
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.122

Open source →

0.2.12127 Apr 2026Deprecated2 sources agree

Added updatedToolOutput to PostToolUseHookSpecificOutput for replacing tool output on all tools. updatedMCPToolOutput is deprecated.

What's changed

Added updatedToolOutput to PostToolUseHookSpecificOutput for replacing tool output on all tools. updatedMCPToolOutput is deprecated.

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.121
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.121
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.121
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.121

Open source →

0.2.11923 Apr 2026

excludeDynamicSections now keeps static auto-memory instructions in the cacheable system-prompt block; only the per-user memory directory path and per

What's changed

excludeDynamicSections now keeps static auto-memory instructions in the cacheable system-prompt block; only the per-user memory directory path and per-machine environment values are relocated to the first user message
Long-running SDK sessions now reconnect claude.ai-proxied MCP servers after a transport-stream abort
SessionStore.append() failures are now retried up to 3 times with short backoff before the batch is dropped and mirror_error is emitted

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.119
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.119
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.119
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.119

Open source →

Additional notes

Added forwardSubagentText option to stream subagent text deltas to SDK consumers
excludeDynamicSections now keeps static auto-memory instructions in the cacheable system-prompt block; only the per-user memory directory path and per-machine environment values are relocated to the first user message
Long-running SDK sessions now reconnect claude.ai-proxied MCP servers after a transport-stream abort
SessionStore.append() failures are now retried up to 3 times with short backoff before the batch is dropped and mirror_error is emitted

Open source →

0.2.11822 Apr 20262 sources agree

Added Options.managedSettings for embedders to pass policy-tier settings to the spawned CLI in-memory, honored below IT-controlled managed sources

What's changed

Added Options.managedSettings for embedders to pass policy-tier settings to the spawned CLI in-memory, honored below IT-controlled managed sources

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.118
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.118
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.118
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.118

Open source →

0.2.11721 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.117

What's changed

Updated to parity with Claude Code v2.1.117

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.117
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.117
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.117
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.117

Open source →

0.2.11620 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.116

What's changed

Updated to parity with Claude Code v2.1.116

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.116
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.116
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.116
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.116

Open source →

0.2.11417 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.114

What's changed

Updated to parity with Claude Code v2.1.114

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.114
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.114
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.114
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.114

Open source →

0.2.11317 Apr 20262 sources agree

Changed the SDK to spawn a native Claude Code binary (via a per-platform optional dependency) instead of bundled JavaScript

What's changed

Changed the SDK to spawn a native Claude Code binary (via a per-platform optional dependency) instead of bundled JavaScript
Added sessionStore option (alpha) to query() and session helpers for mirroring session transcripts to external storage, with SessionStore/SessionKey/SessionStoreEntry types, InMemorySessionStore reference implementation, and importSessionToStore() for migrating existing sessions
Added deleteSession() for removing a session from disk or a SessionStore
Added SDKMirrorErrorMessage (subtype: 'mirror_error') to the SDKMessage union — emitted when a sessionStore.append() batch fails
Breaking: options.env once again replaces process.env for the CLI subprocess instead of overlaying it. To add or override individual variables, pass env: { ...process.env, MY_VAR: "x" }
Added title option to query() — sets the session title and skips auto-generation
Added OpenTelemetry trace context propagation — the caller's active trace context is forwarded to the CLI subprocess so spans parent under your distributed trace

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.113
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.113
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.113
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.113

Open source →

0.2.11216 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.112

What's changed

Updated to parity with Claude Code v2.1.112

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.112
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.112
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.112
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.112

Open source →

0.2.11116 Apr 20262 sources agree

Opus 4.7 is now available! This version of the SDK is required to use it.

What's changed

Opus 4.7 is now available! This version of the SDK is required to use it.
mcp_set_servers control request: remote (http/sse) server entries can now carry per-tool permission_policy values, which are applied to the session's allow/deny rules
startup() and WarmQuery are now part of the public TypeScript API
Changed options.env to overlay the inherited process.env instead of replacing it

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.111
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.111
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.111
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.111

Open source →

0.2.11015 Apr 20262 sources agree

Fixed unstable_v2_createSession not respecting cwd, settingSources, and allowDangerouslySkipPermissions options

What's changed

Fixed unstable_v2_createSession not respecting cwd, settingSources, and allowDangerouslySkipPermissions options
Added optional shouldQuery field to SDKUserMessage — set to false to append a user message without triggering an assistant turn; fixed shouldQuery: false messages incorrectly triggering auto-title generation, prompt suggestions, and UserPromptSubmit hooks
Auto session-title generation now respects CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC and CLAUDE_CODE_DISABLE_TERMINAL_TITLE

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.110
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.110
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.110
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.110

Open source →

0.2.10915 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.109

What's changed

Updated to parity with Claude Code v2.1.109

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.109
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.109
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.109
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.109

Open source →

0.2.10814 Apr 20262 sources agree

SDKStatus now includes 'requesting'; when includePartialMessages is enabled, a {type:'system', subtype:'status', status:'requesting'} message is emitt

What's changed

SDKStatus now includes 'requesting'; when includePartialMessages is enabled, a {type:'system', subtype:'status', status:'requesting'} message is emitted before each API request in the stream

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.108
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.108
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.108
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.108

Open source →

0.2.10714 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.107

What's changed

Updated to parity with Claude Code v2.1.107

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.107
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.107
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.107
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.107

Open source →

0.2.10513 Apr 20262 sources agree

Added system/memory_recall event and memory_paths on system/init for SDK renderers to surface memory operations

What's changed

Added system/memory_recall event and memory_paths on system/init for SDK renderers to surface memory operations
Fixed error_max_structured_output_retries being emitted when the final retry attempt succeeded, discarding valid structured output

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.105
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.105
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.105
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.105

Open source →

0.2.10110 Apr 20262 sources agree

Security: bumped @anthropic-ai/sdk to ^0.81.0 and @modelcontextprotocol/sdk to ^1.29.0 to resolve GHSA-5474-4w2j-mq4c and transitive hono advisories

What's changed

Security: bumped @anthropic-ai/sdk to ^0.81.0 and @modelcontextprotocol/sdk to ^1.29.0 to resolve GHSA-5474-4w2j-mq4c and transitive hono advisories
Fixed resume-session temp directory leaking on Windows when subprocess file handles weren't released before cleanup, and on macOS/APFS when await using disposal raced its own cleanup callback
Fixed MaxListenersExceededWarning when running 11+ concurrent query() calls

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.101
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.101
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.101
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.101

Open source →

0.2.989 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.98

What's changed

Updated to parity with Claude Code v2.1.98

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.98
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.98
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.98
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.98

Open source →

0.2.978 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.97

What's changed

Updated to parity with Claude Code v2.1.97

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.97
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.97
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.97
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.97

Open source →

0.2.968 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.96

What's changed

Updated to parity with Claude Code v2.1.96

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.96
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.96
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.96
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.96

Open source →

0.2.947 Apr 20262 sources agree

Fixed getContextUsage() to include agents passed via options.agents in the agents breakdown

What's changed

Fixed getContextUsage() to include agents passed via options.agents in the agents breakdown
Fixed CJK and other multibyte text being corrupted with U+FFFD in stream-json input/output when chunk boundaries split a UTF-8 sequence
Fixed MCP server child processes not being cleaned up when an SDK query() session ends
Fixed a failed error-report write crashing the SDK process with unhandledRejection
Updated to parity with Claude Code v2.1.94

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.94
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.94
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.94
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.94

Open source →

0.2.924 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.92

What's changed

Updated to parity with Claude Code v2.1.92

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.92
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.92
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.92
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.92

Open source →

0.2.912 Apr 20262 sources agree

Added optional terminal_reason field to result messages, exposing why the query loop terminated (completed, aborted_tools, max_turns, blocking_limit,

What's changed

Added optional terminal_reason field to result messages, exposing why the query loop terminated (completed, aborted_tools, max_turns, blocking_limit, etc.)
Added 'auto' to the public PermissionMode type
Changed sandbox option to default failIfUnavailable to true when enabled: true is passed — query() will emit an error result and exit if sandbox dependencies are missing, instead of silently running unsandboxed. Set failIfUnavailable: false to allow graceful degradation.
Updated to parity with Claude Code v2.1.91

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.91
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.91
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.91
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.91

Open source →

0.2.901 Apr 20262 sources agree

Updated to parity with Claude Code v2.1.90

What's changed

Updated to parity with Claude Code v2.1.90

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.90
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.90
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.90
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.90

Open source →

0.2.8931 Mar 20262 sources agree

Added startup() to pre-warm the CLI subprocess before query(), making the first query ~20x faster when startup cost can be paid upfront

What's changed

Added startup() to pre-warm the CLI subprocess before query(), making the first query ~20x faster when startup cost can be paid upfront
Added includeSystemMessages option to getSessionMessages() to optionally include system messages in session history
Added listSubagents() and getSubagentMessages() functions to retrieve subagent conversation history from sessions
Added includeHookEvents option to enable hook lifecycle messages (hook_started, hook_progress, hook_response) for all hook event types
Fixed ERR_STREAM_WRITE_AFTER_END errors when single-turn queries with SDK MCP servers or hooks have control responses arriving after the result message
Fixed Zod v4 field .describe() metadata being dropped from createSdkMcpServer tool schemas
Fixed side_question returning null on resume before the first turn completes
Fixed settingSources empty array causing --setting-sources "" to consume the next CLI flag
Fixed error result messages (error_during_execution, error_max_turns, error_max_budget_usd) to correctly set is_error: true with descriptive messages
Fixed MCP servers getting permanently stuck in a failed state after a connection race — they now retry on the next message

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.89
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.89
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.89
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.89

Open source →

0.2.8729 Mar 20262 sources agree

Updated to parity with Claude Code v2.1.87

What's changed

Updated to parity with Claude Code v2.1.87

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.87
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.87
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.87
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.87

Open source →

0.2.8627 Mar 20262 sources agree

Added getContextUsage() control method to retrieve a breakdown of context window usage by category

What's changed

Added getContextUsage() control method to retrieve a breakdown of context window usage by category
Made session_id optional in SDKUserMessage type — callers no longer need to provide a session ID when sending user messages, as the SDK assigns one automatically
Fixed TypeScript types resolving to any by adding @anthropic-ai/sdk and @modelcontextprotocol/sdk as dependencies
Updated to parity with Claude Code v2.1.86

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.86
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.86
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.86
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.86

Open source →

0.2.8526 Mar 20262 sources agree

Added reloadPlugins() SDK method to reload plugins and receive refreshed commands, agents, and MCP server status

What's changed

Added reloadPlugins() SDK method to reload plugins and receive refreshed commands, agents, and MCP server status
Fixed PreToolUse hooks with permissionDecision: "ask" being ignored in SDK mode
Updated to parity with Claude Code v2.1.85

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.85
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.85
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.85
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.85

Open source →

0.2.8426 Mar 20262 sources agree

Added taskBudget option for API-side token budget awareness, allowing the model to pace tool use within a token limit

What's changed

Added taskBudget option for API-side token budget awareness, allowing the model to pace tool use within a token limit
Added enableChannel() method and capabilities field on McpServerStatus for SDK-driven MCP channel activation
Exported EffortLevel type ('low' | 'medium' | 'high' | 'max') for consumers to reference effort values directly
Fixed showing "[Request interrupted by user]" for errors that were not caused by user interruption
Updated to parity with Claude Code v2.1.84

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.84
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.84
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.84
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.84

Open source →

0.2.8325 Mar 20262 sources agree

Added seed_read_state control subtype to seed readFileState with {path, mtime} so Edit works after the originating Read was removed from context

What's changed

Added seed_read_state control subtype to seed readFileState with {path, mtime} so Edit works after the originating Read was removed from context
Changed session_state_changed events to opt-in: set CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1 to receive them
Updated to parity with Claude Code v2.1.83

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.83
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.83
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.83
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.83

Open source →

0.2.8120 Mar 20262 sources agree

Fixed canUseTool not providing a working addRules suggestion when a write under .claude/skills/{name}/ hits the bypass-immune safety check

What's changed

Fixed canUseTool not providing a working addRules suggestion when a write under .claude/skills/{name}/ hits the bypass-immune safety check
Updated to parity with Claude Code v2.1.81

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.81
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.81
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.81
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.81

Open source →

0.2.8019 Mar 20262 sources agree

Fixed getSessionMessages() dropping parallel tool results — sessions with parallel tool calls now return all tool_use/tool_result pairs

What's changed

Fixed getSessionMessages() dropping parallel tool results — sessions with parallel tool calls now return all tool_use/tool_result pairs
Updated to parity with Claude Code v2.1.80

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.80
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.80
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.80
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.80

Open source →

0.2.7918 Mar 20262 sources agree

Added 'resume' to the ExitReason type for distinguishing resume-triggered session ends in hooks

What's changed

Added 'resume' to the ExitReason type for distinguishing resume-triggered session ends in hooks
Updated to parity with Claude Code v2.1.79

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.79
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.79
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.79
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.79

Open source →

0.2.7716 Mar 20262 sources agree

Added api_retry system messages when retrying transient API errors, exposing attempt count, max retries, delay, and error status

What's changed

Added api_retry system messages when retrying transient API errors, exposing attempt count, max retries, delay, and error status
Updated to parity with Claude Code v2.1.77

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.77
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.77
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.77
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.77

Open source →

0.2.7614 Mar 20262 sources agree

Added forkSession(sessionId, opts?) for branching conversations from a point

What's changed

Added forkSession(sessionId, opts?) for branching conversations from a point
Added cancel_async_message control subtype to drop a queued user message by UUID before execution
Added planFilePath field to ExitPlanMode tool input for hooks and SDK consumers
Added MCP elicitation hook types and SDKElicitationCompleteMessage system message for handling MCP server input requests programmatically
Updated to parity with Claude Code v2.1.76

Update

npm install @anthropic-ai/claude-agent-sdk@0.2.76
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.76
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.76
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.76

Open source →