@fairyhunter13/ai-anthropic 3.0.58-fork.2 → 3.0.58-fork.21

package/dist/internal/index.d.mts

@@ -1,4 +1,4 @@
-import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, JSONSchema7, SharedV3ProviderMetadata, SharedV3Warning } from '@ai-sdk/provider';
+import { LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult, JSONSchema7, SharedV4ProviderMetadata, SharedV4Warning } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
@@ -11,15 +11,20 @@ type AnthropicMessagesConfig = {
     fetch?: FetchFunction;
     buildRequestUrl?: (baseURL: string, isStreaming: boolean) => string;
     transformRequestBody?: (args: Record<string, any>, betas: Set<string>) => Record<string, any>;
-    supportedUrls?: () => LanguageModelV3['supportedUrls'];
+    supportedUrls?: () => LanguageModelV4['supportedUrls'];
     generateId?: () => string;
     /**
      * When false, the model will use JSON tool fallback for structured outputs.
      */
     supportsNativeStructuredOutput?: boolean;
+    /**
+     * When false, `strict` on tool definitions will be ignored and a warning emitted.
+     * Defaults to true.
+     */
+    supportsStrictTools?: boolean;
 };
-declare class AnthropicMessagesLanguageModel implements LanguageModelV3 {
-    readonly specificationVersion = "v3";
+declare class AnthropicMessagesLanguageModel implements LanguageModelV4 {
+    readonly specificationVersion = "v4";
     readonly modelId: AnthropicMessagesModelId;
     private readonly config;
     private readonly generateId;
@@ -38,9 +43,21 @@ declare class AnthropicMessagesLanguageModel implements LanguageModelV3 {
     private buildRequestUrl;
     private transformRequestBody;
     private extractCitationDocuments;
-    doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
-    doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
+    doGenerate(options: LanguageModelV4CallOptions): Promise<LanguageModelV4GenerateResult>;
+    doStream(options: LanguageModelV4CallOptions): Promise<LanguageModelV4StreamResult>;
 }
+/**
+ * Returns the capabilities of a Claude model that are used for defaults and feature selection.
+ *
+ * @see https://docs.claude.com/en/docs/about-claude/models/overview#model-comparison-table
+ * @see https://platform.claude.com/docs/en/build-with-claude/structured-outputs
+ */
+declare function getModelCapabilities(modelId: string): {
+    maxOutputTokens: number;
+    supportsStructuredOutput: boolean;
+    supportsAdaptiveThinking: boolean;
+    isKnownModel: boolean;
+};
 
 declare const anthropicTools: {
     /**
@@ -699,6 +716,78 @@ declare const anthropicTools: {
         };
         retrievedAt: string | null;
     }>;
+    /**
+     * Creates a web fetch tool that gives Claude direct access to real-time web content.
+     * GA version (no beta header required). Includes caller restrictions, cache control,
+     * deferred loading, and strict mode.
+     *
+     * @param maxUses - The max_uses parameter limits the number of web fetches performed
+     * @param allowedDomains - Only fetch from these domains
+     * @param blockedDomains - Never fetch from these domains
+     * @param citations - Citations configuration for fetched documents
+     * @param maxContentTokens - Max content tokens included in context
+     * @param allowedCallers - Restrict callers (e.g. ["direct"] to prevent code_execution usage)
+     * @param useCache - Whether to use cached content (set false for fresh content)
+     * @param deferLoading - Defer loading until tool_search discovers it
+     * @param strict - Enable strict schema validation
+     */
+    webFetch_20260309: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+        url: string;
+    }, {
+        type: "web_fetch_result";
+        url: string;
+        content: {
+            type: "document";
+            title: string | null;
+            citations?: {
+                enabled: boolean;
+            };
+            source: {
+                type: "base64";
+                mediaType: "application/pdf";
+                data: string;
+            } | {
+                type: "text";
+                mediaType: "text/plain";
+                data: string;
+            };
+        };
+        retrievedAt: string | null;
+    }, {
+        maxUses?: number;
+        allowedDomains?: string[];
+        blockedDomains?: string[];
+        citations?: {
+            enabled: boolean;
+        };
+        maxContentTokens?: number;
+        allowedCallers?: Array<"direct" | "code_execution_20250825" | "code_execution_20260120">;
+        useCache?: boolean;
+        deferLoading?: boolean;
+        strict?: boolean;
+    }>>[0]) => _ai_sdk_provider_utils.Tool<{
+        url: string;
+    }, {
+        type: "web_fetch_result";
+        url: string;
+        content: {
+            type: "document";
+            title: string | null;
+            citations?: {
+                enabled: boolean;
+            };
+            source: {
+                type: "base64";
+                mediaType: "application/pdf";
+                data: string;
+            } | {
+                type: "text";
+                mediaType: "text/plain";
+                data: string;
+            };
+        };
+        retrievedAt: string | null;
+    }>;
     /**
      * Creates a web search tool that gives Claude direct access to real-time web content.
      *
@@ -762,6 +851,7 @@ declare const anthropicTools: {
             country?: string;
             timezone?: string;
         };
+        allowedCallers?: Array<"direct" | "code_execution_20250825" | "code_execution_20260120">;
     }>>[0]) => _ai_sdk_provider_utils.Tool<{
         query: string;
     }, {
@@ -901,6 +991,21 @@ type AnthropicTool = {
     };
     max_content_tokens?: number;
     cache_control: AnthropicCacheControl | undefined;
+} | {
+    type: 'web_fetch_20260309';
+    name: string;
+    max_uses?: number;
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    citations?: {
+        enabled: boolean;
+    };
+    max_content_tokens?: number;
+    allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+    use_cache?: boolean;
+    defer_loading?: boolean;
+    strict?: boolean;
+    cache_control: AnthropicCacheControl | undefined;
 } | {
     type: 'web_search_20250305' | 'web_search_20260209';
     name: string;
@@ -914,6 +1019,7 @@ type AnthropicTool = {
         country?: string;
         timezone?: string;
     };
+    allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
     cache_control: AnthropicCacheControl | undefined;
 } | {
     type: 'tool_search_tool_regex_20251119';
@@ -934,27 +1040,31 @@ type AnthropicToolChoice = {
 declare class CacheControlValidator {
     private breakpointCount;
     private warnings;
-    getCacheControl(providerMetadata: SharedV3ProviderMetadata | undefined, context: {
+    getCacheControl(providerMetadata: SharedV4ProviderMetadata | undefined, context: {
         type: string;
         canCache: boolean;
     }): AnthropicCacheControl | undefined;
-    getWarnings(): SharedV3Warning[];
+    getWarnings(): SharedV4Warning[];
 }
 
-declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, supportsStructuredOutput, }: {
-    tools: LanguageModelV3CallOptions['tools'];
-    toolChoice: LanguageModelV3CallOptions['toolChoice'] | undefined;
+declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, supportsStructuredOutput, supportsStrictTools, }: {
+    tools: LanguageModelV4CallOptions['tools'];
+    toolChoice: LanguageModelV4CallOptions['toolChoice'] | undefined;
     disableParallelToolUse?: boolean;
     cacheControlValidator?: CacheControlValidator;
     /**
-     * Whether the model supports structured output.
+     * Whether the model supports native structured output response format.
      */
     supportsStructuredOutput: boolean;
+    /**
+     * Whether the model supports strict mode on tool definitions.
+     */
+    supportsStrictTools: boolean;
 }): Promise<{
     tools: Array<AnthropicTool> | undefined;
     toolChoice: AnthropicToolChoice | undefined;
-    toolWarnings: SharedV3Warning[];
+    toolWarnings: SharedV4Warning[];
     betas: Set<string>;
 }>;
 
-export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, prepareTools };
+export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, getModelCapabilities, prepareTools };

package/dist/internal/index.d.ts

@@ -1,4 +1,4 @@
-import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, JSONSchema7, SharedV3ProviderMetadata, SharedV3Warning } from '@ai-sdk/provider';
+import { LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult, JSONSchema7, SharedV4ProviderMetadata, SharedV4Warning } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
@@ -11,15 +11,20 @@ type AnthropicMessagesConfig = {
     fetch?: FetchFunction;
     buildRequestUrl?: (baseURL: string, isStreaming: boolean) => string;
     transformRequestBody?: (args: Record<string, any>, betas: Set<string>) => Record<string, any>;
-    supportedUrls?: () => LanguageModelV3['supportedUrls'];
+    supportedUrls?: () => LanguageModelV4['supportedUrls'];
     generateId?: () => string;
     /**
      * When false, the model will use JSON tool fallback for structured outputs.
      */
     supportsNativeStructuredOutput?: boolean;
+    /**
+     * When false, `strict` on tool definitions will be ignored and a warning emitted.
+     * Defaults to true.
+     */
+    supportsStrictTools?: boolean;
 };
-declare class AnthropicMessagesLanguageModel implements LanguageModelV3 {
-    readonly specificationVersion = "v3";
+declare class AnthropicMessagesLanguageModel implements LanguageModelV4 {
+    readonly specificationVersion = "v4";
     readonly modelId: AnthropicMessagesModelId;
     private readonly config;
     private readonly generateId;
@@ -38,9 +43,21 @@ declare class AnthropicMessagesLanguageModel implements LanguageModelV3 {
     private buildRequestUrl;
     private transformRequestBody;
     private extractCitationDocuments;
-    doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
-    doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
+    doGenerate(options: LanguageModelV4CallOptions): Promise<LanguageModelV4GenerateResult>;
+    doStream(options: LanguageModelV4CallOptions): Promise<LanguageModelV4StreamResult>;
 }
+/**
+ * Returns the capabilities of a Claude model that are used for defaults and feature selection.
+ *
+ * @see https://docs.claude.com/en/docs/about-claude/models/overview#model-comparison-table
+ * @see https://platform.claude.com/docs/en/build-with-claude/structured-outputs
+ */
+declare function getModelCapabilities(modelId: string): {
+    maxOutputTokens: number;
+    supportsStructuredOutput: boolean;
+    supportsAdaptiveThinking: boolean;
+    isKnownModel: boolean;
+};
 
 declare const anthropicTools: {
     /**
@@ -699,6 +716,78 @@ declare const anthropicTools: {
         };
         retrievedAt: string | null;
     }>;
+    /**
+     * Creates a web fetch tool that gives Claude direct access to real-time web content.
+     * GA version (no beta header required). Includes caller restrictions, cache control,
+     * deferred loading, and strict mode.
+     *
+     * @param maxUses - The max_uses parameter limits the number of web fetches performed
+     * @param allowedDomains - Only fetch from these domains
+     * @param blockedDomains - Never fetch from these domains
+     * @param citations - Citations configuration for fetched documents
+     * @param maxContentTokens - Max content tokens included in context
+     * @param allowedCallers - Restrict callers (e.g. ["direct"] to prevent code_execution usage)
+     * @param useCache - Whether to use cached content (set false for fresh content)
+     * @param deferLoading - Defer loading until tool_search discovers it
+     * @param strict - Enable strict schema validation
+     */
+    webFetch_20260309: (args?: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{
+        url: string;
+    }, {
+        type: "web_fetch_result";
+        url: string;
+        content: {
+            type: "document";
+            title: string | null;
+            citations?: {
+                enabled: boolean;
+            };
+            source: {
+                type: "base64";
+                mediaType: "application/pdf";
+                data: string;
+            } | {
+                type: "text";
+                mediaType: "text/plain";
+                data: string;
+            };
+        };
+        retrievedAt: string | null;
+    }, {
+        maxUses?: number;
+        allowedDomains?: string[];
+        blockedDomains?: string[];
+        citations?: {
+            enabled: boolean;
+        };
+        maxContentTokens?: number;
+        allowedCallers?: Array<"direct" | "code_execution_20250825" | "code_execution_20260120">;
+        useCache?: boolean;
+        deferLoading?: boolean;
+        strict?: boolean;
+    }>>[0]) => _ai_sdk_provider_utils.Tool<{
+        url: string;
+    }, {
+        type: "web_fetch_result";
+        url: string;
+        content: {
+            type: "document";
+            title: string | null;
+            citations?: {
+                enabled: boolean;
+            };
+            source: {
+                type: "base64";
+                mediaType: "application/pdf";
+                data: string;
+            } | {
+                type: "text";
+                mediaType: "text/plain";
+                data: string;
+            };
+        };
+        retrievedAt: string | null;
+    }>;
     /**
      * Creates a web search tool that gives Claude direct access to real-time web content.
      *
@@ -762,6 +851,7 @@ declare const anthropicTools: {
             country?: string;
             timezone?: string;
         };
+        allowedCallers?: Array<"direct" | "code_execution_20250825" | "code_execution_20260120">;
     }>>[0]) => _ai_sdk_provider_utils.Tool<{
         query: string;
     }, {
@@ -901,6 +991,21 @@ type AnthropicTool = {
     };
     max_content_tokens?: number;
     cache_control: AnthropicCacheControl | undefined;
+} | {
+    type: 'web_fetch_20260309';
+    name: string;
+    max_uses?: number;
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    citations?: {
+        enabled: boolean;
+    };
+    max_content_tokens?: number;
+    allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+    use_cache?: boolean;
+    defer_loading?: boolean;
+    strict?: boolean;
+    cache_control: AnthropicCacheControl | undefined;
 } | {
     type: 'web_search_20250305' | 'web_search_20260209';
     name: string;
@@ -914,6 +1019,7 @@ type AnthropicTool = {
         country?: string;
         timezone?: string;
     };
+    allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
     cache_control: AnthropicCacheControl | undefined;
 } | {
     type: 'tool_search_tool_regex_20251119';
@@ -934,27 +1040,31 @@ type AnthropicToolChoice = {
 declare class CacheControlValidator {
     private breakpointCount;
     private warnings;
-    getCacheControl(providerMetadata: SharedV3ProviderMetadata | undefined, context: {
+    getCacheControl(providerMetadata: SharedV4ProviderMetadata | undefined, context: {
         type: string;
         canCache: boolean;
     }): AnthropicCacheControl | undefined;
-    getWarnings(): SharedV3Warning[];
+    getWarnings(): SharedV4Warning[];
 }
 
-declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, supportsStructuredOutput, }: {
-    tools: LanguageModelV3CallOptions['tools'];
-    toolChoice: LanguageModelV3CallOptions['toolChoice'] | undefined;
+declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, supportsStructuredOutput, supportsStrictTools, }: {
+    tools: LanguageModelV4CallOptions['tools'];
+    toolChoice: LanguageModelV4CallOptions['toolChoice'] | undefined;
     disableParallelToolUse?: boolean;
     cacheControlValidator?: CacheControlValidator;
     /**
-     * Whether the model supports structured output.
+     * Whether the model supports native structured output response format.
      */
     supportsStructuredOutput: boolean;
+    /**
+     * Whether the model supports strict mode on tool definitions.
+     */
+    supportsStrictTools: boolean;
 }): Promise<{
     tools: Array<AnthropicTool> | undefined;
     toolChoice: AnthropicToolChoice | undefined;
-    toolWarnings: SharedV3Warning[];
+    toolWarnings: SharedV4Warning[];
     betas: Set<string>;
 }>;
 
-export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, prepareTools };
+export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, getModelCapabilities, prepareTools };