@anthropic-ai/claude-agent-sdk
0.3.330 · 20 Nov 2026SEE LICENSE IN README.md20.7M / weekRepositorynpmAtom feed
Summary· from the note as AI read it
Migration neededRead before upgrading: 1 change to make.
Before you upgrade
- query() now throws on unparseable JSON settings strings; ensure settings parse.
New
- Added a
system/informationalwarning, taggedsettings_not_in_effect, whensettingsor a user, project or local settings file fails validation and is not in effect
In short
1 breaking1 new5 fixed1 internal
- Breaking
Changed the TypeScript SDK's
query()to fail with an error whensettingsis a JSON string that doesn't parse
Release note
What's changed
Added a
system/informationalwarning, taggedsettings_not_in_effect, whensettingsor a user, project or local settings file fails validation and is not in effectFixed Claude still waiting for a background agent that
stopTask()stopped just as it finishedFixed variables that a
SessionStarthook writes toCLAUDE_ENV_FILEnot reaching the Bash tool with thecontinueoptionFixed Google Cloud's Agent Platform sessions ignoring
fastModeinsettingswhen the model comes fromANTHROPIC_MODELor a settings file; such sessions now bill at the fast mode priceFixed the initialize response's
fast_mode_statedescribing the default model instead of the model the session runsFixed a lost or swapped tool result from an SDK MCP server when a call overlapped a reconnect; while an earlier request is unanswered, a new one can carry an
idof 1,048,576 or moreChanged the TypeScript SDK's
query()to fail with an error whensettingsis a JSON string that doesn't parseUpdated to parity with Claude Code v2.1.330
Update
npm install @anthropic-ai/claude-agent-sdk@0.3.330 # or yarn add @anthropic-ai/claude-agent-sdk@0.3.330 # or pnpm add @anthropic-ai/claude-agent-sdk@0.3.330 # or bun add @anthropic-ai/claude-agent-sdk@0.3.330
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.