anthropic_sdk_dart

anthropic_sdk_dart v7.0.0

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Adds the beta Dreams API (client.dreams) for asynchronous memory-consolidation jobs over memory stores and session transcripts, mid-conversation tool changes that add or remove tools between turns via tool_addition/tool_removal blocks while preserving the prompt cache, and a strict/best_effort redemption mode for fallback credit tokens, with the outcome reported on the new Usage.fallbackCredit field. Breaking: MessageCreateRequest.fallbackCreditToken changed from String? to FallbackCreditTokenParam? to carry the new redemption mode. Also adds managed-agent effort levels, initialEvents session seeding, and new environment/memory-store webhook events, and switches memory store endpoints to the agent-memory-2026-07-22 beta header (replacing managed-agents-2026-04-01).

• BREAKING FEAT: Dreams API, tool changes, fallback credits (#283). (9dde9c91)
• FIX: Adopt agent-memory-2026-07-22 beta header (#279). (7e57914f)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Syncs to Anthropic OpenAPI spec 506a5ad7, adding Claude Sonnet 5 (claude-sonnet-5), the web_search_20260318/web_fetch_20260318 built-in tool versions with the new responseInclusion control, and Managed Agents parity: event-delta streaming, credential injection location for env-var vault credentials, per-session agent overrides, backward session pagination, and 13 new agent/deployment webhook events. Breaking: user_profile_id moved from the message request body to the anthropic-user-profile-id header (now a userProfileId method parameter), and two closed-enum String fields are now typed enums (SpanModelUsage.speed, WebSearchResultError.errorCode). Also fixes two buildUrl edge cases with custom base URLs: a trailing slash no longer produces a double slash in the path (which some gateways 404 on), and query params embedded in the base URL (including repeated keys) are now preserved instead of being dropped or collapsed.

• BREAKING FEAT: Sonnet 5, web tool 20260318 & Managed Agents parity (#268). (04d74218)
• FIX: Preserve repeated base URL query params in buildUrl (#278). (b5dbb725)
• FIX: Avoid double slash when base URL has a trailing slash (#271). (d35d49bf)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Syncs to the latest Anthropic OpenAPI spec (cross-checked field-for-field against anthropic-sdk-python). Adds the new code_execution_20260521 code-execution tool version — now the default for both the GA BuiltInTool.codeExecution(...) and the beta CodeExecutionTool — plus the fallback refusal trigger (FallbackBlock.trigger, a new FallbackRefusalTrigger that explains why a model handed over at a fallback hop) and the session.updated webhook event (WebhookSessionUpdatedEventData). The breaking surface is small and won't affect most users: FallbackBlock/FallbackInputBlock are normally consumed via fromJson, so pure-deserialization callers are unaffected; the only behavioral change is the code-execution default version, which you can pin by passing type explicitly. See the Migration Guide for details.

• BREAKING FEAT: Fallback refusal trigger + code-exec tool (#262). (d2a57c88)

Adds scheduled deployments for Managed Agents — run an agent session on a cron schedule (or on demand) through the new client.deployments and client.deploymentRuns beta resources, with each firing producing a deployment run. Also introduces the beta Fallback API for Messages — supply a fallbacks chain to automatically re-run a refused request on another model (e.g. Fable 5) or retry manually with a refusal credit token — plus environment-variable vault credentials for Managed Agents. Also fixes a latent runtime crash where passing an untyped empty literal (e.g. UpdateSessionParams(vaultIds: [])) to the Update*Params family threw a TypeError.

• FEAT: Scheduled deployments (Managed Agents) (#259). (a784bc63)
• FEAT: Fallback API and env-var vault credentials (#258). (5b2ca762)
• FIX: Safe casts for Update*Params sentinel collections (#260). (34e24c73)

Completes field-level parity for the advisor and computer-use built-in beta tools, whose parameters were previously dropped on the Dart side and silently lost on serialization. AdvisorTool now carries allowedCallers, deferLoading, and strict; ComputerUseTool adds those plus inputExamples (all versions) and enableZoom (only on the computer_20251124 tool version). See the Anthropic API release notes for the underlying tool updates.

• FEAT: Add advisor & computer-use tool fields (#253). (9cc55a80)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Refreshes the package to the latest Anthropic OpenAPI spec for the Claude Opus 4.8 release. Adds mid-conversation system messages — the new mid_conv_system content block (via InputContentBlock.midConversationSystem) updates system instructions inside the messages array without a separate user turn or disrupting prompt caching — plus the spec's new system message role (MessageRole.system, InputMessage.system(...) / systemBlocks(...)), an outputTokensDetails reasoning-token breakdown on Usage/MessageDeltaUsage, and a nullable stopReason on advisor results. The breaking surface is very small and won't affect most users: the only breaks are one new variant on the exported sealed union InputContentBlock and one new value (system) on the MessageRole enum, which affect only code that switches over those types exhaustively without a wildcard or Unknown*/default branch. Pure-deserialization consumers are unaffected.

• BREAKING FEAT: Mid-conversation system + token details (#241). (e833e07f)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Completes the four-part Anthropic spec refresh and layers on several beta capabilities: prompt-cache diagnostics (pass DiagnosticsParam.previousMessageId and read Message.diagnostics?.cacheMissReason to learn why a cache prefix diverged), full request- and response-side search-result citations for grounding answers in your own RAG content, multiagent orchestration with outcome evaluations and rubrics, Session Threads (CRUD + streaming), inbound webhook event parsing, and MCP-OAuth credential validation. Also tolerates missing/null signature on streamed ThinkingBlocks from Anthropic-compatible servers (e.g. MiniMax). Breaking: the surface is small and mostly forward-compatibility hardening — new variants were added to the exported sealed unions Citation, InputContentBlock, SessionEvent, and EventParams, so only code with exhaustive switch statements that lack a wildcard/Unknown* branch needs updating; additionally UserProfile.relationship is now a required constructor parameter. Pure-deserialization consumers are unaffected.

• BREAKING FEAT: Cache diagnostics, session & skill updates (#236). (6d1d488f)
• BREAKING FEAT: Request-side search_result blocks & per-citation locations (#235). (1f10a79f)
• BREAKING FEAT: Support search_result_location citations and add Unknown fallback (#233). (68e0f797)
• BREAKING FEAT: Add multiagent orchestration, outcome evaluations & rubrics (#230). (d7ac4376)
• BREAKING FEAT: Spec refresh, relationship + thread IDs (#223). (3c6a4bdc)
• FEAT: Add webhook events & credential validation (#231). (075005a6)
• FEAT: Add Session Threads (CRUD + streaming) (#224). (5367e35b)
• FIX: Tolerate missing/null signature on ThinkingBlock.fromJson (#226). (9e17743a)
• CHORE: Fix use_null_aware_elements lint flagged by Dart 3.12 (#232). (31ac5efc)

Adds the Memory Stores beta API — 14 new endpoints exposed under client.memoryStores with child accessors for memories and memory versions. Memory Stores let you persist named memories that can be mounted into agent sessions, with append-only versioning, content-SHA preconditions, view modes (basic/full), and per-version redaction. Surfaces the full data model (MemoryStore, Memory, MemoryVersion, sealed MemoryListItem/MemoryPrecondition, ManagedAgentActor), three new enums, patch-style update params with null-as-delete metadata semantics, and three memory-specific error classes. SessionResource is extended with a new memory_store variant for mounting stores into agent sessions.

• FEAT: Add Memory Stores beta API (#207). (3e8d88d3)

Adds support for Claude Opus 4.7 and refreshes the package to the latest Anthropic OpenAPI spec. Introduces the User Profiles beta API — 5 endpoints exposed as client.userProfiles for registering end-user profiles with metadata, per-feature trust grants, and short-lived enrollment URLs. Also extends EffortLevel with xhigh, adds TokenTaskBudget and OutputConfig.taskBudget for client-side compaction budgets, wires optional encrypted_content through compaction blocks, and adds MessageCreateRequest.userProfileId for end-user profile routing.

• FEAT: Add User Profiles beta API (#193). (c2d74a9f)
• FEAT: Add Claude Opus 4.7 and refresh OpenAPI spec (#191). (b291f445)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

Adds the beta advisor tool for pairing a faster executor model with a stronger advisor model in a single request, plus MCPToolUseBlock/MCPToolResultBlock content types for mid-generation MCP tool calls. All examples migrate from deprecated claude-sonnet-4-20250514 to claude-sonnet-4-6 ahead of the June 15, 2026 end-of-life. Breaking: six Session fields moved from nullable to required non-nullable in the constructor — direct instantiation requires updates.

• BREAKING FEAT: Fix verify gaps and add MCP content blocks (#184). (85177cc3)
• FEAT: Add advisor tool support (#182). (f5268a38)
• FEAT: Annotate llms.txt with token counts and tighten agent-facing docs (#181). (a1e82aca)
• CHORE: Update OpenAPI spec and migrate deprecated model IDs (#183). (e5876e22)

Adds full support for the Managed Agents API (beta) with 33 endpoints across agents, sessions, vaults, and credentials — including SSE streaming for session events. Also adds structured refusal details (RefusalStopDetails, RefusalCategory) to messages and deltas when stopReason is refusal, and session-scoped file filtering via FileScope and scopeId.

• FEAT: Add managed agents API support (#180). (edb3d6df)
• FEAT: Add stop_details, file scope, and refresh spec (#177). (e03084c5)

Adds an extra overflow field to InputSchema for passing additional JSON Schema keywords (like additionalProperties: false) that the Anthropic API now requires on object-type tool input schemas. All examples and integration tests have been updated accordingly.

• FIX: Add extra field to InputSchema for additionalProperties (#168). (164cad60)

Adds README Usage sections for models, files, and skills resources, and adds a strict semver bullet to the package README.

• DOCS: Add models, files, and skills Usage sections (#156). (d9b683cc)
• DOCS: Overhaul root README and add semver bullet to all packages (#151). (e6af33dd)

Aligns with the latest Anthropic OpenAPI spec, adding model capabilities (ModelCapabilities, CapabilitySupport), thinking display modes (ThinkingDisplayMode), and WebFetchTool v20260309 with cache bypass control. Also standardizes equality helper locations and overhauls documentation with llms.txt ecosystem files.

• FEAT: Align with latest Anthropic OpenAPI spec (#129). (9160bb13)
• REFACTOR: Standardize equality helpers location across packages (#123). (34086102)
• DOCS: Overhaul READMEs and add llms.txt ecosystem (#149). (98f11483)

Complete McpToolset.toString() to include all fields (authorizationToken, cacheControl) that were previously missing.

• FIX: Complete toString() and update spec metadata (#103). (7b316954)

Fixed verification warnings in generated model classes.

• FIX: Resolve verification warnings (#97). (a145eca1)

This release adds inline streaming error detection and top-level cache control support for request parameters.

• FEAT: Detect inline streaming errors (#91). (9f0eaf37)
• FEAT: Add top-level cache control to request params (#86). (e619516e)
• DOCS: Improve READMEs with badges, sponsor section, and vertex_ai deprecation (#90). (5741f2f3)

Internal improvements to build tooling and package publishing configuration.

• REFACTOR: Migrate API skills to the shared api-toolkit CLI (#74). (923cc83e)
• CHORE: Add .pubignore to exclude .agents/ and specs/ from publishing (#78). (0ff199bf)

Added baseUrl and defaultHeaders parameters to withApiKey constructors, fixed WebSearchToolResultBlock.fromJson crash, and improved hashCode for list fields.

• FEAT: Add baseUrl and defaultHeaders to withApiKey constructors (#57). (f0dd0caa)
• FIX: Fix WebSearchToolResultBlock.fromJson crash (#63). (227b44f3)
• FIX: Use Object.hashAll() for list fields in hashCode (#65). (4b19abd9)
• REFACTOR: Unify equality_helpers.dart across packages (#67). (ec2897f8)

Added withApiKey convenience constructors for simplified client initialization and convenience methods for common API patterns like single-message responses and streaming text.

• FEAT: Add withApiKey convenience constructors (#56). (b06e3df3)
• FEAT: Add convenience methods for common API patterns (#55). (68cb17d3)
• CHORE: Bump googleapis from 15.0.0 to 16.0.0 and Dart SDK to 3.9.0 (#52). (eae130b7)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

TL;DR: Complete reimplementation with a new architecture, minimal dependencies, resource-based API, and improved developer experience. Hand-crafted models (no code generation), interceptor-driven architecture, comprehensive error handling, full Anthropic API coverage, and alignment with the latest Anthropic OpenAPI (2026-02-19).

What's new

• Resource-based API organization:
  • client.messages — Message creation, streaming, token counting
  • client.messages.batches — Batch message processing
  • client.models — Model listing and retrieval
  • client.files — File upload/management
  • client.skills — Custom skills management
• Architecture:
  • Interceptor chain (Auth → Logging → Error → Transport with Retry wrapper).
  • Authentication: API key or custom via AuthProvider interface.
  • Retry with exponential backoff + jitter (only for idempotent methods on 429, 5xx, timeouts).
  • Abortable requests via abortTrigger parameter.
  • SSE streaming parser for real-time responses.
  • Central AnthropicConfig (timeouts, retry policy, log level, baseUrl, auth).
• Hand-crafted models:
  • No code generation dependencies (no freezed, json_serializable).
  • Minimal runtime dependencies (http, logging, meta only).
  • Immutable models with copyWith using sentinel pattern.
  • Full type safety with sealed exception hierarchy.
• Improved DX:
  • Simplified message creation (e.g., InputMessage.user(), InputMessage.assistant()).
  • Explicit streaming methods (createStream() vs create()).
  • Response helpers (.text, .hasToolUse, .toolUseBlocks, .thinkingBlocks).
  • Rich logging with field redaction for sensitive data.
• Full API coverage:
  • Messages with tool calling, vision, documents, and citations.
  • Extended thinking with budget control.
  • Built-in tools (web search, bash, text editor, computer use, code execution, MCP).
  • Message batches with JSONL results streaming.
  • Files and Skills APIs (Beta).

Breaking Changes

• Resource-based API: Methods reorganized under strongly-typed resources:
  • client.createMessage() → client.messages.create()
  • client.createMessageStream() → client.messages.createStream()
  • client.countMessageTokens() → client.messages.countTokens()
  • client.createMessageBatch() → client.messages.batches.create()
  • client.listMessageBatches() → client.messages.batches.list()
  • client.listModels() → client.models.list()
  • client.retrieveModel() → client.models.retrieve()
• Model class renames:
  • CreateMessageRequest → MessageCreateRequest
  • Message → InputMessage
  • MessageContent.text() → InputMessage.user() / InputMessage.assistant()
  • Block.text() → TextInputBlock
  • Block.image() → ImageInputBlock
  • Block.toolResult() → InputContentBlock.toolResult()
  • Model.model(Models.xxx) → String model ID (e.g., 'claude-sonnet-4-20250514')
• Configuration: New AnthropicConfig with AuthProvider pattern:
  • AnthropicClient(apiKey: 'KEY') → AnthropicClient(config: AnthropicConfig(authProvider: ApiKeyProvider('KEY')))
  • Or use AnthropicClient.fromEnvironment() to read ANTHROPIC_API_KEY.
• Exceptions: Replaced AnthropicClientException with typed hierarchy:
  • ApiException, AuthenticationException, RateLimitException, ValidationException, TimeoutException, AbortedException.
• Streaming: Pattern matching replaces .map() callbacks:
  • event.map(contentBlockDelta: (e) => ...) → if (event is ContentBlockDeltaEvent) ...
• Enum type changes for better type safety:
  • Skill.source: String → SkillSource enum (SkillSource.custom, SkillSource.anthropic)
  • Message.role: String → MessageRole enum (MessageRole.assistant)
  • SkillsResource.list() source parameter: String? → SkillSource?
• Tooling API changes for improved type safety:
  • tools parameter: List<Map<String, dynamic>> → List<ToolDefinition>
  • toolChoice parameter: Map<String, dynamic> → ToolChoice
• Session cleanup: endSession() → close().
• Dependencies: Removed freezed, json_serializable; now minimal (http, logging, meta).

See MIGRATION.md for step-by-step examples and mapping tables.

Commits

• BREAKING FEAT: Complete v1.0.0 reimplementation (#5). (a0623960)
• BREAKING FEAT: Add typed ToolDefinition and SkillSource for improved type safety (#19). (48311502)
• FEAT: Add speed controls, new built-in tools, tool governance, and ToolCaller type (#35). (ad3c34c6)
• FEAT: Enhance models with documentation and add examples (#13). (bfd99bc6)
• FIX: Pre-release documentation and test fixes (#42). (2fb37b06)
• REFACTOR: Align client package architecture across SDK packages (#37). (cf741ee1)
• REFACTOR: Align API surface across all SDK packages (#36). (ed969cc7)
• DOCS: Refactors repository URLs to new location. (76835268)

• FIX: Add signature_delta support to BlockDelta (fixes #811) (#878). (1d281837)
• FIX: Update tool types and fix analyzer warnings (#876). (17613b1e)
• FEAT: Add citations_delta support to BlockDelta (#880). (4da916bf)
• FEAT: Add beta features support (#874). (28e4a23a)
• FEAT: Add schema enhancements (#873). (424d3225)
• FEAT: Add Models API (#872). (7962a867)
• FEAT: Add get message batch results endpoint (#871). (46fb2a5d)
• FEAT: Add delete message batch endpoint (#870). (6611e175)
• FEAT: Add cancel message batch endpoint (#869). (b7aa8602)
• FEAT: Add list message batches endpoint (#868). (745e369d)
• FEAT: Add token counting API (#858). (b0d61c92)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

• FIX: Handle optional space after colon in SSE parser (#790). (b31fbead)
• FEAT: Add extended thinking support (#803). (1ccb74a6)
• FEAT: Upgrade to http v1.5.0 (#785). (f7c87790)
• BREAKING BUILD: Require Dart >=3.8.0 (#792). (b887f5c6)

• REFACTOR: Fix pub format warnings (#809). (640cdefb)

• FEAT: Migrate to Freezed v3 (#773). (f87c8c03)

• BUILD: Update dependencies (#751). (250a3c6)

• FEAT: Update dependencies (requires Dart 3.6.0) (#709). (9e3467f7)
• REFACTOR: Remove fetch_client dependency in favor of http v1.3.0 (#659). (0e0a685c)
• FIX: Fix linter issues (#656). (88a79c65)

[!CAUTION] This release has breaking changes. See the Migration Guide for upgrade instructions.

• FEAT: Add support for Message Batches (#585). (a41270a0)
• FEAT: Add claude-3-5-sonnet-20241022 to model catalog (#583). (0cc59e13)
• BREAKING FEAT: Add support for prompt caching (#587). (79dabaa5)
• BREAKING FEAT: Add computer use support (#586). (36c4a3e3)
• DOCS: Update anthropic_sdk_dart readme. (78b7bccf)

• REFACTOR: Add new lint rules and fix issues (#621). (60b10e00)
• REFACTOR: Upgrade api clients generator version (#610). (0c8750e8)

• FEAT: Add support for tool use (#469). (81896cfd)
• FEAT: Add extensions on ToolResultBlockContent (#476). (8d92d9b0)
• REFACTOR: Improve schemas names (#475). (8ebeacde)
• REFACTOR: Migrate conditional imports to js_interop (#453). (a6a78cfe)

• FEAT: Implement anthropic_sdk_dart, a Dart client for Anthropic API (#433). (e5412b)

• Bootstrap package.