Packages

@anthropic-ai/claude-agent-sdk

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

Your version

0.3.330

Latest20 Nov 2026Where it was published

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/informational warning, tagged settings_not_in_effect, when settings or 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 when settings is a JSON string that doesn't parse

Release note

What's changed

  • Added a system/informational warning, tagged settings_not_in_effect, when settings or a user, project or local settings file fails validation and is not in effect

  • Fixed Claude still waiting for a background agent that stopTask() stopped just as it finished

  • Fixed variables that a SessionStart hook writes to CLAUDE_ENV_FILE not reaching the Bash tool with the continue option

  • Fixed Google Cloud's Agent Platform sessions ignoring fastMode in settings when the model comes from ANTHROPIC_MODEL or a settings file; such sessions now bill at the fast mode price

  • Fixed the initialize response's fast_mode_state describing the default model instead of the model the session runs

  • Fixed 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 id of 1,048,576 or more

  • Changed the TypeScript SDK's query() to fail with an error when settings is a JSON string that doesn't parse

  • Updated 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.