Skip to content

chore(deps): bump @anthropic-ai/claude-agent-sdk to ^0.3.325 - #493

Merged
edspencer merged 1 commit into
mainfrom
chore/bump-claude-agent-sdk-0.3.325
Nov 14, 2026
Merged

edspencer merged 1 commit into
mainfrom
chore/bump-claude-agent-sdk-0.3.325

Conversation

@edspencer

@edspencer edspencer commented Nov 14, 2026 •

Copy link
Copy Markdown
Owner

Raises the @anthropic-ai/claude-agent-sdk floor in @herdctl/core from ^0.3.302 to ^0.3.325, the current npm latest. 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:

API Error: 400 Claude Code 2.1.283 does not support this model; version 2.1.290 or newer is required. (apiError: claude_code_version_too_old)

On the SDK runtime the CLI is the SDK's bundled binary, not the claude on PATH. The box's claude was 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 to latest so that what herdctl's CI tests is what a consumer actually resolves: a fresh install against ^0.3.302 would 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, canUseTool suggestions, setMcpServers, reloadSkills, WarmQuery, resolveSettings, forkSession with upToMessageId, hook onFailure, 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-only git through the permission flow, which doesn't affect an agent whose allowed_tools includes Bash.

Verification

  • pnpm typecheck and pnpm build pass.
  • Core tests: 3777 passed. One failure, 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.
  • Bundled binary confirmed: node_modules/@anthropic-ai/claude-agent-sdk resolves 0.3.325 with claudeCodeVersion: "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

  • Compatibility
    • Updated the AI agent integration to align with newer permission handling.
    • The minimum supported Node.js version is now 18.14.0.
  • Changes
    • File-read responses no longer indicate when a file is unchanged.

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>
@coderabbitai

coderabbitai Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Explain Change →

No actionable comments were generated in the recent review.

Walkthrough

The core package’s Claude Agent SDK dependency range changes from ^0.3.302 to ^0.3.325. A changeset declares a patch release and describes SDK changes.

Changes: Claude Agent SDK Update

Layer / File(s) Summary
Dependency range and release note
packages/core/package.json, .changeset/bump-claude-agent-sdk-0-3-325.md
The core package dependency range changes to ^0.3.325. The changeset declares a patch release and describes SDK changes, including permission flow, FileReadOutput, and the Node.js minimum version.

Estimated code review effort: 1 (Trivial) | ~4 minutes

Change: Other

Merge Risk: Minimal · up to 1af77

This is a small dependency bump with no code changes. The declared Node floor is slightly looser than the SDK's, which only affects strict installs on very old Node 18 releases.

Pre-merge checks: Passed 4

Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title names the main change: the dependency bump of @anthropic-ai/claude-agent-sdk to ^0.3.325 in the core package. It follows the conventional commit style. The title does not mention the changes…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Title check

Explanation

The title names the main change: the dependency bump of @anthropic-ai/claude-agent-sdk to ^0.3.325 in the core package. It follows the conventional commit style. The title does not mention the changeset or the minimum Node.js note, which is expected for a title.

Finishing Touches

Generate unit tests (beta)

  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Recent review info

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 34103697-01f9-4f32-a1df-68a36cb63245
Commits

Reviewing files that changed from the base of the PR and between 82628ac and 1af7769.

Files ignored due to path filters: 1

  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
Files selected for processing: 2

  • .changeset/bump-claude-agent-sdk-0-3-325.md
  • packages/core/package.json

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying herdctl with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1af7769
Status: ✅  Deploy successful!
Preview URL: https://fccfad30.herdctl.pages.dev
Branch Preview URL: https://chore-bump-claude-agent-sdk-hg15.herdctl.pages.dev

View logs

@edspencer
edspencer merged commit 82a4997 into main Nov 14, 2026
8 checks passed
@edspencer
edspencer deleted the chore/bump-claude-agent-sdk-0.3.325 branch November 14, 2026 17:31
@github-actions github-actions Bot mentioned this pull request Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant