@ai-sdk/anthropic 4.0.54 → 4.0.56

package/src/tool/web-search_20260318.ts

@@ -0,0 +1,143 @@
+import {
+  createProviderExecutedToolFactory,
+  lazySchema,
+  zodSchema,
+} from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+export const webSearch_20260318ArgsSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      maxUses: z.number().optional(),
+      allowedDomains: z.array(z.string()).optional(),
+      blockedDomains: z.array(z.string()).optional(),
+      userLocation: z
+        .object({
+          type: z.literal('approximate'),
+          city: z.string().optional(),
+          region: z.string().optional(),
+          country: z.string().optional(),
+          timezone: z.string().optional(),
+        })
+        .optional(),
+      responseInclusion: z.enum(['full', 'excluded']).optional(),
+    }),
+  ),
+);
+
+export const webSearch_20260318OutputSchema = lazySchema(() =>
+  zodSchema(
+    z.array(
+      z.object({
+        url: z.string(),
+        title: z.string().nullable(),
+        pageAge: z.string().nullable(),
+        encryptedContent: z.string(),
+        type: z.literal('web_search_result'),
+      }),
+    ),
+  ),
+);
+
+const webSearch_20260318InputSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      query: z.string(),
+    }),
+  ),
+);
+
+const factory = createProviderExecutedToolFactory<
+  {
+    /**
+     * The search query to execute.
+     */
+    query: string;
+  },
+  Array<{
+    type: 'web_search_result';
+
+    /**
+     * The URL of the source page.
+     */
+    url: string;
+
+    /**
+     * The title of the source page.
+     */
+    title: string | null;
+
+    /**
+     * When the site was last updated
+     */
+    pageAge: string | null;
+
+    /**
+     * Encrypted content that must be passed back in multi-turn conversations for citations
+     */
+    encryptedContent: string;
+  }>,
+  {
+    /**
+     * Maximum number of web searches Claude can perform during the conversation.
+     */
+    maxUses?: number;
+
+    /**
+     * Optional list of domains that Claude is allowed to search.
+     */
+    allowedDomains?: string[];
+
+    /**
+     * Optional list of domains that Claude should avoid when searching.
+     */
+    blockedDomains?: string[];
+
+    /**
+     * Optional user location information to provide geographically relevant search results.
+     */
+    userLocation?: {
+      /**
+       * The type of location (must be approximate)
+       */
+      type: 'approximate';
+
+      /**
+       * The city name
+       */
+      city?: string;
+
+      /**
+       * The region or state
+       */
+      region?: string;
+
+      /**
+       * The country
+       */
+      country?: string;
+
+      /**
+       * The IANA timezone ID.
+       */
+      timezone?: string;
+    };
+
+    /**
+     * Controls whether web search result blocks consumed by completed code
+     * execution calls are included in the response. Defaults to `full`.
+     */
+    responseInclusion?: 'full' | 'excluded';
+  }
+>({
+  id: 'anthropic.web_search_20260318',
+  inputSchema: webSearch_20260318InputSchema,
+  outputSchema: webSearch_20260318OutputSchema,
+  supportsDeferredResults: true,
+});
+
+export const webSearch_20260318 = (
+  args: Parameters<typeof factory>[0] = {}, // default
+) => {
+  return factory(args);
+};