Packages

@anthropic-ai/claude-agent-sdk

0.3.330 · 20 Nov 2026SEE LICENSE IN README.md20.7M / weekRepositorynpmAtom feed

Your version

0.3.317

3 Nov 2026Where it was published

0.3.330 is the newest release of 0.3.x.

In short

6 new1 fixed2 changed

Release note

What's changed

  • Added onFailure to hook matchers: with "block", a hook that throws or returns invalid output blocks the action

  • Added a warning message in the stream when a hook callback fails

  • Added a session_writes_lost system message, sent after the last result when a full disk or disk quota kept the CLI from saving the session transcript or ~/.claude.json

  • Added initialize_not_first to startup_failure_reason, for a --await-initialize launch whose first stdin line is not the initialize request

  • Added task.description to the TaskCreate tool's tool_use_result: the description the task was created with

  • Added lossy to readFile() utf-8 answers: true when decoding replaced bytes that are not valid UTF-8

  • Removed the file_unchanged variant of FileReadOutput in sdk-tools.d.ts; a repeated Read now returns the file content

  • Fixed setMcpServers closing a folder's .mcp.json and local-scope MCP servers in sessions started with prewarm() and bound with SpareProcess.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.