@ai-sdk/anthropic 4.0.58 → 4.0.60

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @ai-sdk/anthropic
 
+## 4.0.60
+
+### Patch Changes
+
+- 49295bb: feat(anthropic): add Claude Opus 5.5 support
+
+  - add the `claude-opus-5-5` model ID to `@ai-sdk/anthropic` and `anthropic/claude-opus-5.5` to `@ai-sdk/gateway`
+  - models that always use adaptive thinking (`claude-opus-5-5`, `claude-fable-5`, `claude-fable-5-1`) no longer receive `thinking: { type: 'disabled' }` or budget-based thinking; the provider drops the unsupported setting, maps `reasoning: 'none'` to `effort: 'low'`, and emits a warning
+  - models that reject forced tool use (`claude-opus-5-5`, `claude-fable-5-1`) fall back to `auto` tool choice for `required` and named tool choices, and to native structured outputs when `structuredOutputMode: 'jsonTool'` is requested, each with a warning
+  - add the `computerToolset_20260801` computer use tool (`computer_toolset_20260801`), which is required for computer use on `claude-opus-5-5`
+  - use the documented `mid-conversation-output-config-2026-07-01` beta header for per-message effort
+
+## 4.0.59
+
+### Patch Changes
+
+- f7b7b2a: feat(provider/anthropic): add `safeguards` provider option and `safeguardResults` provider metadata (dangerous tool use classifier)
+
 ## 4.0.58
 
 ### Patch Changes

package/dist/index.d.ts

@@ -3,6 +3,19 @@ import { z } from 'zod/v4';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { ToolExecuteFunction, Tool, Experimental_SandboxSession, ProviderDefinedTool, FetchFunction } from '@ai-sdk/provider-utils';
 
+declare const anthropicSafeguardResultSchema: z.ZodObject<{
+    type: z.ZodString;
+    status: z.ZodObject<{
+        type: z.ZodString;
+        tool_uses: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodString;
+            outcome: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            explanation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type AnthropicSafeguardResult = z.infer<typeof anthropicSafeguardResultSchema>;
+
 /**
  * Represents a single iteration in the usage breakdown.
  *
@@ -57,6 +70,18 @@ interface AnthropicMessageMetadata {
         path: string;
         reason: string;
     }>;
+    /**
+     * Verdicts of the server-side safeguards requested with
+     * `providerOptions.anthropic.safeguards`, one entry per requested safeguard.
+     * For `dangerous_tool_use`, `status.type` is `'available'` when the
+     * classifier ran and `status.tool_uses` maps each tool call id to its
+     * verdict (`type: 'evaluated'` with an `outcome` of `'not_flagged'` or
+     * `'flagged'` plus an `explanation`, `'skipped'`, or `'unavailable'`).
+     *
+     * Kept in the API's wire shape (snake_case), since consumers such as Claude
+     * Code read the verdicts verbatim.
+     */
+    safeguardResults?: AnthropicSafeguardResult[];
     /**
      * Details about why the request stopped. Present only when the API returns
      * a `refusal` stop reason together with a `stop_details` object (a
@@ -194,7 +219,7 @@ interface AnthropicMessageMetadata {
     } | null;
 }
 
-type AnthropicModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-opus-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | (string & {});
+type AnthropicModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-opus-5' | 'claude-opus-5-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | (string & {});
 /**
  * Anthropic provider options for system messages.
  */
@@ -219,9 +244,9 @@ type AnthropicSystemMessageProviderOptions = z.infer<typeof anthropicSystemMessa
 declare const anthropicLanguageModelOptions: z.ZodObject<{
     sendReasoning: z.ZodOptional<z.ZodBoolean>;
     structuredOutputMode: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
         outputFormat: "outputFormat";
         jsonTool: "jsonTool";
-        auto: "auto";
     }>>;
     thinking: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"adaptive">;
@@ -316,6 +341,10 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
         }>>;
     }, z.core.$strip>>]>>;
     anthropicBeta: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    safeguards: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"dangerous_tool_use">;
+        classifierContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
     contextManagement: z.ZodOptional<z.ZodObject<{
         edits: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<"clear_tool_uses_20250919">;
@@ -361,6 +390,14 @@ interface AnthropicToolOptions {
     eagerInputStreaming?: boolean;
 }
 
+/**
+ * Member tools of the computer toolset. Each member is returned by the API as
+ * its own `tool_use` block; the AI SDK exposes it as the `action` of a single
+ * computer tool call.
+ */
+declare const computerToolset_20260801Members: readonly ["screenshot", "zoom", "left_click", "right_click", "middle_click", "double_click", "triple_click", "left_click_drag", "mouse_move", "left_mouse_down", "left_mouse_up", "cursor_position", "scroll", "type", "key", "hold_key", "wait"];
+type ComputerToolset_20260801Member = (typeof computerToolset_20260801Members)[number];
+
 type Bash20241022Input = {
     /**
      * The bash command to run. Required unless the tool is being restarted.
@@ -888,6 +925,44 @@ declare const anthropicTools: {
         displayNumber?: number;
         enableZoom?: boolean;
     }, {}>;
+    /**
+     * The computer toolset lets Claude control a computer through screenshots,
+     * mouse, and keyboard. It replaces the versioned computer tools
+     * (`computer_20251124` and earlier) on newer models.
+     *
+     * The API returns each computer action as its own `tool_use` block with
+     * `toolset_name: 'computer'`. The AI SDK maps every member call to this tool
+     * and exposes the member name as `action`, so `execute` receives the same
+     * input shape as the older computer tools. Claude may return several actions
+     * in one turn.
+     *
+     * Coordinates are always in the pixel space of the screenshots you return;
+     * there are no display size parameters. Zoom is enabled by default.
+     *
+     * Does not require a beta header.
+     *
+     * Supported models: Claude Opus 5.5 (required; older computer tool types
+     * are rejected), Opus 5, Sonnet 5, Fable 5, Fable 5.1, Opus 4.8.
+     *
+     * @param configs - Per-member settings keyed by member name, e.g.
+     * `{ zoom: { enabled: false } }`. Omitted members keep their defaults.
+     */
+    computerToolset_20260801: _ai_sdk_provider_utils.ProviderDefinedToolFactory<{
+        action: ComputerToolset_20260801Member;
+        coordinate?: [number, number];
+        duration?: number;
+        region?: [number, number, number, number];
+        repeat?: number;
+        scroll_amount?: number;
+        scroll_direction?: "up" | "down" | "left" | "right";
+        start_coordinate?: [number, number];
+        text?: string;
+    }, {
+        configs?: Partial<Record<ComputerToolset_20260801Member, {
+            enabled?: boolean;
+            deferLoading?: boolean;
+        }>>;
+    }, {}>;
     /**
      * The memory tool enables Claude to store and retrieve information across conversations through a memory file directory.
      * Claude can create, read, update, and delete files that persist between sessions,