@anthropic-ai/claude-agent-sdk
0.3.330 · 20 Nov 2026SEE LICENSE IN README.md20.7M / weekRepositorynpmAtom feed
0.3.330 is the newest release of 0.3.x.
In short
6 new1 fixed2 changed
Release note
What's changed
Added
onFailureto hook matchers: with"block", a hook that throws or returns invalid output blocks the actionAdded a warning message in the stream when a hook callback fails
Added a
session_writes_lostsystem message, sent after the last result when a full disk or disk quota kept the CLI from saving the session transcript or ~/.claude.jsonAdded
initialize_not_firsttostartup_failure_reason, for a--await-initializelaunch whose first stdin line is not the initialize requestAdded
task.descriptionto the TaskCreate tool'stool_use_result: the description the task was created withAdded
lossytoreadFile()utf-8 answers:truewhen decoding replaced bytes that are not valid UTF-8Removed the
file_unchangedvariant ofFileReadOutputinsdk-tools.d.ts; a repeated Read now returns the file contentFixed
setMcpServersclosing a folder's.mcp.jsonand local-scope MCP servers in sessions started withprewarm()and bound withSpareProcess.claim()Updated to parity with Claude Code v2.1.317
Update
npm install @anthropic-ai/claude-agent-sdk@0.3.317 # or yarn add @anthropic-ai/claude-agent-sdk@0.3.317 # or pnpm add @anthropic-ai/claude-agent-sdk@0.3.317 # or bun add @anthropic-ai/claude-agent-sdk@0.3.317
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.