The SDK's bundled Claude Code is what the API version-gates new models on:
SDK 0.3.283 bundles CC 2.1.283, and Claude Fable 5.2 needs 2.1.290+, so every
turn on it returns 400 claude_code_version_too_old. On the SDK runtime the
binary is the SDK's own, not the `claude` on PATH, so consumers can only fix
it by resolving a newer SDK. 0.3.325 is current npm latest (CC 2.1.325).
No code adaptation needed; none of the APIs changed across 0.3.303-0.3.325
are used here. Behaviour changes are listed in the changeset.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Raises the
@anthropic-ai/claude-agent-sdkfloor in@herdctl/corefrom^0.3.302to^0.3.325, the current npmlatest. That release bundles Claude Code 2.1.325.Why
The API gates new models on the client version. Paddock v0.83.2 (core 5.34.1 → SDK 0.3.283 → Claude Code 2.1.283) answers every turn on Claude Fable 5.2 with:
On the SDK runtime the CLI is the SDK's bundled binary, not the
claudeonPATH. The box'sclaudewas 2.1.325 the whole time and made no difference. So the only fix a consumer has is resolving a newer SDK, and the floor is what forces that.#472 already moved the floor to
^0.3.302(2.1.302, enough for Fable 5.2). This goes tolatestso that what herdctl's CI tests is what a consumer actually resolves: a fresh install against^0.3.302would pull 0.3.325 anyway, untested.Compatibility
No code changes. I checked herdctl's sources against every API touched across 0.3.303–0.3.325 (
FileReadOutput.file_unchanged,applyFlagSettings,canUseToolsuggestions,setMcpServers,reloadSkills,WarmQuery,resolveSettings,forkSessionwithupToMessageId, hookonFailure, sandbox settings) and found none in use. The behaviour changes are in the changeset. The one most likely to surprise is 0.3.325 routing read-onlygitthrough the permission flow, which doesn't affect an agent whoseallowed_toolsincludesBash.Verification
pnpm typecheckandpnpm buildpass.directory.test.ts › throws StateDirectoryCreateError when parent directory is not writable, is environmental: the box runs as root, so the directory is writable. It is unrelated to the SDK.node_modules/@anthropic-ai/claude-agent-sdkresolves0.3.325withclaudeCodeVersion: "2.1.325".Related
The version PR #492 has been red because of a pre-existing scheduler timing flake, not this change. #494 fixes the flake.
🤖 Generated with Claude Code
Summary by CodeRabbit