Patch release (2.1.241 → 2.1.243) with a new built-in MCP tool, richer Read/artifact and document results, clearer agent handoff bookkeeping, and ongoing work on background sessions, bridge reattach, and directory sync.
Changelog
[new] Added a built-in Mcp tool for MCP-related agent actions.
[new] Read results can record when a saved Artifact source file was completed (artifactRead with slug and version), so viewed artifact versions are tracked explicitly.
[new] Document reads can surface extracted page images (with first-page labeling) in the model-facing tool result, including per-page errors when a page cannot be rendered.
[new] Task/tool aggregation reports when inner Read images, failed page notes, or PDFs were dropped by per-result caps (imagesOmitted, imagePagesFailed / imagePagesFailedOmitted, documentsOmitted).
[new] Dynamic loop / wakeup tools accept a required noop flag (unless stopping) so empty ticks can be collapsed in the terminal and tracked as a streak.
[changed] Agent outputs carry internal hand-back provenance fields (harness section counts/hash and whether handoff review was skipped) so rewritten handoffs stay correctly framed.
[changed] Remote trigger and related status payloads can include extra detail / server_message context on failures and lifecycle events.
[changed] Computer-use access guidance now treats Finder like any other app (desktop, Dock, and Finder windows need an explicit grant) and clarifies retry behavior when permissions are still missing, including teach-access flows.
[changed] Plan-mode rejection handling still recognizes local ultraplan teleport feedback and tells the user to continue in their terminal instead of implementing remotely.
[changed] Cloud/session file-sync and worktree messaging is clearer when files are still downloading, when a worktree binding has been cleared, and when publish conflicts need a merge rather than a blind force overwrite.
[changed] Feedback / bug-report field copy tightened slightly (evidence, failure mode, and task category wording).
[changed] SDK wrapper compatibility range updated (older 0.3.204–0.3.206 entries dropped; 0.3.225 added among tested versions).
Models & prompts
Built-in coding and migration guidance continues to steer off retired fast-mode model strings and toward current Opus / Sonnet IDs, with notes on tokenizer and image-token cost differences where those migrations apply.
Prompt and skill text for design-system sync, managed agents, and API usage received wording and consistency updates (including scoped plugin customization and artifact edit “creation only” rules); behavior is aligned with existing product flows rather than a new default model cutover in this release.
Additional model identifier strings are present in the build for upcoming or alternate listings; no default model change is announced in this patch.
Under the hood
Background session / daemon paths expanded (attach, respawn, roster, spare workers, stall give-up), with related settings such as background backend, rendezvous socket/auth, and post-clear respawn controls.
Bridge reattach options grew (grouping, outbound-only, owner account, session ingress URL) for more reliable session bridging.
Directory sync gained engine / fast-forward oriented controls and telemetry around git worker lifecycle and reachability.
Prompt-cache TTL controls for primary and subagent paths, stream first-byte timeout, runner stall give-up, hooks-on-same-thread, fork-subagent, and bundled-skills / home-settings seed toggles landed for operability and experimentation.
Feature work and gates continue for cloud plugin admission/consent/reload, device hooks (consent, templates, forwarding), Android emulator and iOS simulator integration, and API no-response timeouts.
New API beta header support: forth-2025-04-20.
Package resolve path includes https://npm.pkg.github.com for GitHub npm registry access.
Native binaries are larger across platforms, reflecting the expanded embedded tool and prompt surface.
Upgrade notes
If you parse agent or Read tool results in automation, allow for the new optional fields (artifactRead, page image metadata, omission counts, harness provenance, noop on loop ticks). Treat harness bookkeeping fields as internal unless you deliberately depend on them.
Computer-use flows that touch Finder need an explicit Finder permission grant; missing permissions should be fixed in the Claude desktop app rather than retried blindly in-session.
Teams pinning very old SDK wrapper versions (0.3.204–0.3.206) should move to a currently tested wrapper (0.3.207+; 0.3.225 is newly listed).
content/
Browse captured content/
Same tree as claude-code/latest/content for this version. Open the full browser for sidebar navigation between docs and other files.
