@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
5 new8 fixed4 changed
Release note
What's changed
Added
machinePolicy.didNotLoad(alpha) toresolveSettings()'s result, which tells a host when a machine policy source may be there and did not loadAdded
matchDeniedModels()(alpha), which tells a host which models adeniedModelslist blocks, by Claude Code's own entry rulesAdded the periodic
tool_progressheartbeat while a turn waits on long-running hooks;tool_nameis the hook event,tool_use_idbeginshook-,parent_tool_use_idmay name no tool callAdded
CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES: set to1to turn off subagent progress summaries even whenagentProgressSummariesistrue(available since 0.3.318)Added
tool_use_resultto a subagent's WebSearch result message when the search did not run or found nothingFixed progress notifications from SDK MCP servers being dropped for tool calls that were still running when the set of SDK MCP servers changed
Fixed
resolveSettings()keeping its first reading of a macOS MDM profile or Windows registry policy for the life of the process: it now re-reads after 30 minutes, and sooner after a read that failedFixed
forkSession()withupToMessageId: forking at a compaction summary no longer brings back the messages kept after it, and forking at a compaction boundary keeps the conversation before itFixed
getSessionMessagesleaving out a queued prompt that directly follows a compaction summaryFixed
canUseToolsuggestions including a Bash allow rule for commands that write to sensitive paths such as.gitor.claude, where the rule did not stop the next requestFixed most
initializeoptions, such as agents and skills, being ignored when aSessionStarthook supplied the first messageFixed an MCP server removed and re-added with
setMcpServers()stayingneeds-authwith no tools when a tool call had tried to reach it in betweenFixed
init.plugin_errorsomitting a plugin that only project settings enable but that isn't installed; it now reports it as not installed, with the install commandChanged
init.plugin_errorsto also list load errors of plugins that managed settings enable; a check on it can trip before the background install ends (CLAUDE_CODE_SYNC_PLUGIN_INSTALL=1waits)Changed
supersedeson assistant messages to also be sent after a response whose tool call could not be parsedChanged what happens when a tool's permission check fails with an error after a
PreToolUsehook allowed the call: it now goes tocanUseTool, or is refused when there is no callbackUpdated to parity with Claude Code v2.1.323
Update
npm install @anthropic-ai/claude-agent-sdk@0.3.323 # or yarn add @anthropic-ai/claude-agent-sdk@0.3.323 # or pnpm add @anthropic-ai/claude-agent-sdk@0.3.323 # or bun add @anthropic-ai/claude-agent-sdk@0.3.323
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.