aieo 0.1.35 → 0.1.36

package/dist/index.cjs

@@ -36,12 +36,15 @@ __export(index_exports, {
   OUTRO: () => OUTRO,
   PROVIDERS: () => PROVIDERS,
   SYSTEM: () => SYSTEM,
+  WEB_SEARCH_TOOL_NAME: () => WEB_SEARCH_TOOL_NAME,
   addUsage: () => addUsage,
   callGenerateObject: () => callGenerateObject,
   callGenerateText: () => callGenerateText,
   callModel: () => callModel,
+  captureNativeResults: () => captureNativeResults,
   computeSessionCost: () => computeSessionCost,
   consoleLogger: () => consoleLogger,
+  createWebSearch: () => createWebSearch,
   emptyUsage: () => emptyUsage,
   gatewayEnvForProviders: () => gatewayEnvForProviders,
   gatewayUrlFor: () => gatewayUrlFor,
@@ -55,13 +58,19 @@ __export(index_exports, {
   getProviderForModel: () => getProviderForModel,
   getProviderOptions: () => getProviderOptions,
   getProviderTool: () => getProviderTool,
+  getSearchApiKey: () => getSearchApiKey,
   getTokenPricing: () => getTokenPricing,
   hasApiKeyForProvider: () => hasApiKeyForProvider,
+  hasSearchApiKey: () => hasSearchApiKey,
+  linkifyCitations: () => linkifyCitations,
   loadModelPricing: () => loadModelPricing,
   normalizeApiKey: () => normalizeApiKey,
   normalizeCallerBaseURL: () => normalizeCallerBaseURL,
   normalizeUsage: () => normalizeUsage,
   resolveLLMConfig: () => resolveLLMConfig,
+  resolveSearchBackend: () => resolveSearchBackend,
+  searchWeb: () => searchWeb,
+  stripCitations: () => stripCitations,
   withLegacyUsage: () => withLegacyUsage,
   withProviderCacheUsage: () => withProviderCacheUsage
 });
@@ -4181,35 +4190,35 @@ async function prepareTools({
     return { tools: void 0, toolChoice: void 0, toolWarnings, betas };
   }
   const anthropicTools2 = [];
-  for (const tool4 of tools) {
-    switch (tool4.type) {
+  for (const tool5 of tools) {
+    switch (tool5.type) {
       case "function": {
-        const cacheControl = validator.getCacheControl(tool4.providerOptions, {
+        const cacheControl = validator.getCacheControl(tool5.providerOptions, {
           type: "tool definition",
           canCache: true
         });
-        const anthropicOptions = (_a20 = tool4.providerOptions) == null ? void 0 : _a20.anthropic;
+        const anthropicOptions = (_a20 = tool5.providerOptions) == null ? void 0 : _a20.anthropic;
         const eagerInputStreaming = (_b20 = anthropicOptions == null ? void 0 : anthropicOptions.eagerInputStreaming) != null ? _b20 : defaultEagerInputStreaming;
         const deferLoading = anthropicOptions == null ? void 0 : anthropicOptions.deferLoading;
         const allowedCallers = anthropicOptions == null ? void 0 : anthropicOptions.allowedCallers;
-        if (!supportsStrictTools && tool4.strict != null) {
+        if (!supportsStrictTools && tool5.strict != null) {
           toolWarnings.push({
             type: "unsupported",
             feature: "strict",
-            details: `Tool '${tool4.name}' has strict: ${tool4.strict}, but strict mode is not supported by this provider. The strict property will be ignored.`
+            details: `Tool '${tool5.name}' has strict: ${tool5.strict}, but strict mode is not supported by this provider. The strict property will be ignored.`
           });
         }
         anthropicTools2.push({
-          name: tool4.name,
-          description: tool4.description,
-          input_schema: tool4.inputSchema,
+          name: tool5.name,
+          description: tool5.description,
+          input_schema: tool5.inputSchema,
           cache_control: cacheControl,
           ...eagerInputStreaming ? { eager_input_streaming: true } : {},
-          ...supportsStrictTools === true && tool4.strict != null ? { strict: tool4.strict } : {},
+          ...supportsStrictTools === true && tool5.strict != null ? { strict: tool5.strict } : {},
           ...deferLoading != null ? { defer_loading: deferLoading } : {},
           ...allowedCallers != null ? { allowed_callers: allowedCallers } : {},
-          ...tool4.inputExamples != null ? {
-            input_examples: tool4.inputExamples.map(
+          ...tool5.inputExamples != null ? {
+            input_examples: tool5.inputExamples.map(
               (example) => example.input
             )
           } : {}
@@ -4217,13 +4226,13 @@ async function prepareTools({
         if (supportsStructuredOutput === true) {
           betas.add("structured-outputs-2025-11-13");
         }
-        if (tool4.inputExamples != null || allowedCallers != null) {
+        if (tool5.inputExamples != null || allowedCallers != null) {
           betas.add("advanced-tool-use-2025-11-20");
         }
         break;
       }
       case "provider": {
-        switch (tool4.id) {
+        switch (tool5.id) {
           case "anthropic.code_execution_20250522": {
             betas.add("code-execution-2025-05-22");
             anthropicTools2.push({
@@ -4253,9 +4262,9 @@ async function prepareTools({
             anthropicTools2.push({
               name: "computer",
               type: "computer_20250124",
-              display_width_px: tool4.args.displayWidthPx,
-              display_height_px: tool4.args.displayHeightPx,
-              display_number: tool4.args.displayNumber,
+              display_width_px: tool5.args.displayWidthPx,
+              display_height_px: tool5.args.displayHeightPx,
+              display_number: tool5.args.displayNumber,
               cache_control: void 0
             });
             break;
@@ -4265,10 +4274,10 @@ async function prepareTools({
             anthropicTools2.push({
               name: "computer",
               type: "computer_20251124",
-              display_width_px: tool4.args.displayWidthPx,
-              display_height_px: tool4.args.displayHeightPx,
-              display_number: tool4.args.displayNumber,
-              enable_zoom: tool4.args.enableZoom,
+              display_width_px: tool5.args.displayWidthPx,
+              display_height_px: tool5.args.displayHeightPx,
+              display_number: tool5.args.displayNumber,
+              enable_zoom: tool5.args.enableZoom,
               cache_control: void 0
             });
             break;
@@ -4278,9 +4287,9 @@ async function prepareTools({
             anthropicTools2.push({
               name: "computer",
               type: "computer_20241022",
-              display_width_px: tool4.args.displayWidthPx,
-              display_height_px: tool4.args.displayHeightPx,
-              display_number: tool4.args.displayNumber,
+              display_width_px: tool5.args.displayWidthPx,
+              display_height_px: tool5.args.displayHeightPx,
+              display_number: tool5.args.displayNumber,
               cache_control: void 0
             });
             break;
@@ -4314,7 +4323,7 @@ async function prepareTools({
           }
           case "anthropic.text_editor_20250728": {
             const args = await validateTypes({
-              value: tool4.args,
+              value: tool5.args,
               schema: textEditor_20250728ArgsSchema
             });
             anthropicTools2.push({
@@ -4354,7 +4363,7 @@ async function prepareTools({
           case "anthropic.web_fetch_20250910": {
             betas.add("web-fetch-2025-09-10");
             const args = await validateTypes({
-              value: tool4.args,
+              value: tool5.args,
               schema: webFetch_20250910ArgsSchema
             });
             anthropicTools2.push({
@@ -4372,7 +4381,7 @@ async function prepareTools({
           case "anthropic.web_fetch_20260209": {
             betas.add("code-execution-web-tools-2026-02-09");
             const args = await validateTypes({
-              value: tool4.args,
+              value: tool5.args,
               schema: webFetch_20260209ArgsSchema
             });
             anthropicTools2.push({
@@ -4389,7 +4398,7 @@ async function prepareTools({
           }
           case "anthropic.web_search_20250305": {
             const args = await validateTypes({
-              value: tool4.args,
+              value: tool5.args,
               schema: webSearch_20250305ArgsSchema
             });
             anthropicTools2.push({
@@ -4406,7 +4415,7 @@ async function prepareTools({
           case "anthropic.web_search_20260209": {
             betas.add("code-execution-web-tools-2026-02-09");
             const args = await validateTypes({
-              value: tool4.args,
+              value: tool5.args,
               schema: webSearch_20260209ArgsSchema
             });
             anthropicTools2.push({
@@ -4437,7 +4446,7 @@ async function prepareTools({
           case "anthropic.advisor_20260301": {
             betas.add("advisor-tool-2026-03-01");
             const args = await validateTypes({
-              value: tool4.args,
+              value: tool5.args,
               schema: advisor_20260301ArgsSchema
             });
             anthropicTools2.push({
@@ -4452,7 +4461,7 @@ async function prepareTools({
           default: {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool4.id}`
+              feature: `provider-defined tool ${tool5.id}`
             });
             break;
           }
@@ -4462,7 +4471,7 @@ async function prepareTools({
       default: {
         toolWarnings.push({
           type: "unsupported",
-          feature: `tool ${tool4}`
+          feature: `tool ${tool5}`
         });
         break;
       }
@@ -6432,7 +6441,7 @@ var AnthropicMessagesLanguageModel = class {
       betas.add("skills-2025-10-02");
       betas.add("files-api-2025-04-14");
       if (!(tools == null ? void 0 : tools.some(
-        (tool4) => tool4.type === "provider" && (tool4.id === "anthropic.code_execution_20250825" || tool4.id === "anthropic.code_execution_20260120")
+        (tool5) => tool5.type === "provider" && (tool5.id === "anthropic.code_execution_20250825" || tool5.id === "anthropic.code_execution_20260120")
       ))) {
         warnings.push({
           type: "other",
@@ -8035,12 +8044,12 @@ function hasWebTool20260209WithoutCodeExecution(tools) {
   }
   let hasWebTool20260209 = false;
   let hasCodeExecutionTool = false;
-  for (const tool4 of tools) {
-    if ("type" in tool4 && (tool4.type === "web_fetch_20260209" || tool4.type === "web_search_20260209")) {
+  for (const tool5 of tools) {
+    if ("type" in tool5 && (tool5.type === "web_fetch_20260209" || tool5.type === "web_search_20260209")) {
       hasWebTool20260209 = true;
       continue;
     }
-    if (tool4.name === "code_execution") {
+    if (tool5.name === "code_execution") {
       hasCodeExecutionTool = true;
       break;
     }
@@ -11749,8 +11758,8 @@ function prepareTools2({
   if (tools == null) {
     return { tools: void 0, toolConfig: void 0, toolWarnings };
   }
-  const hasFunctionTools = tools.some((tool4) => tool4.type === "function");
-  const hasProviderTools = tools.some((tool4) => tool4.type === "provider");
+  const hasFunctionTools = tools.some((tool5) => tool5.type === "function");
+  const hasProviderTools = tools.some((tool5) => tool5.type === "provider");
   if (hasFunctionTools && hasProviderTools && !isGemini3orNewer) {
     toolWarnings.push({
       type: "unsupported",
@@ -11759,16 +11768,16 @@ function prepareTools2({
   }
   if (hasProviderTools) {
     const googleTools2 = [];
-    const ProviderTools = tools.filter((tool4) => tool4.type === "provider");
-    ProviderTools.forEach((tool4) => {
-      switch (tool4.id) {
+    const ProviderTools = tools.filter((tool5) => tool5.type === "provider");
+    ProviderTools.forEach((tool5) => {
+      switch (tool5.id) {
         case "google.google_search":
           if (isGemini2orNewer) {
-            googleTools2.push({ googleSearch: { ...tool4.args } });
+            googleTools2.push({ googleSearch: { ...tool5.args } });
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool4.id}`,
+              feature: `provider-defined tool ${tool5.id}`,
               details: "Google Search requires Gemini 2.0 or newer."
             });
           }
@@ -11779,7 +11788,7 @@ function prepareTools2({
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool4.id}`,
+              feature: `provider-defined tool ${tool5.id}`,
               details: "Enterprise Web Search requires Gemini 2.0 or newer."
             });
           }
@@ -11790,7 +11799,7 @@ function prepareTools2({
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool4.id}`,
+              feature: `provider-defined tool ${tool5.id}`,
               details: "The URL context tool is not supported with other Gemini models than Gemini 2."
             });
           }
@@ -11801,18 +11810,18 @@ function prepareTools2({
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool4.id}`,
+              feature: `provider-defined tool ${tool5.id}`,
               details: "The code execution tool is not supported with other Gemini models than Gemini 2."
             });
           }
           break;
         case "google.file_search":
           if (supportsFileSearch) {
-            googleTools2.push({ fileSearch: { ...tool4.args } });
+            googleTools2.push({ fileSearch: { ...tool5.args } });
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool4.id}`,
+              feature: `provider-defined tool ${tool5.id}`,
               details: "The file search tool is only supported with Gemini 2.5 models and Gemini 3 models."
             });
           }
@@ -11823,16 +11832,16 @@ function prepareTools2({
               retrieval: {
                 vertex_rag_store: {
                   rag_resources: {
-                    rag_corpus: tool4.args.ragCorpus
+                    rag_corpus: tool5.args.ragCorpus
                   },
-                  similarity_top_k: tool4.args.topK
+                  similarity_top_k: tool5.args.topK
                 }
               }
             });
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool4.id}`,
+              feature: `provider-defined tool ${tool5.id}`,
               details: "The RAG store tool is not supported with other Gemini models than Gemini 2."
             });
           }
@@ -11843,7 +11852,7 @@ function prepareTools2({
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool4.id}`,
+              feature: `provider-defined tool ${tool5.id}`,
               details: "The Google Maps grounding tool is not supported with Gemini models other than Gemini 2 or newer."
             });
           }
@@ -11851,19 +11860,19 @@ function prepareTools2({
         default:
           toolWarnings.push({
             type: "unsupported",
-            feature: `provider-defined tool ${tool4.id}`
+            feature: `provider-defined tool ${tool5.id}`
           });
           break;
       }
     });
     if (hasFunctionTools && isGemini3orNewer && googleTools2.length > 0) {
       const functionDeclarations2 = [];
-      for (const tool4 of tools) {
-        if (tool4.type === "function") {
+      for (const tool5 of tools) {
+        if (tool5.type === "function") {
           functionDeclarations2.push({
-            name: tool4.name,
-            description: (_a20 = tool4.description) != null ? _a20 : "",
-            parameters: convertJSONSchemaToOpenAPISchema(tool4.inputSchema)
+            name: tool5.name,
+            description: (_a20 = tool5.description) != null ? _a20 : "",
+            parameters: convertJSONSchemaToOpenAPISchema(tool5.inputSchema)
           });
         }
       }
@@ -11903,22 +11912,22 @@ function prepareTools2({
   }
   const functionDeclarations = [];
   let hasStrictTools = false;
-  for (const tool4 of tools) {
-    switch (tool4.type) {
+  for (const tool5 of tools) {
+    switch (tool5.type) {
       case "function":
         functionDeclarations.push({
-          name: tool4.name,
-          description: (_b20 = tool4.description) != null ? _b20 : "",
-          parameters: convertJSONSchemaToOpenAPISchema(tool4.inputSchema)
+          name: tool5.name,
+          description: (_b20 = tool5.description) != null ? _b20 : "",
+          parameters: convertJSONSchemaToOpenAPISchema(tool5.inputSchema)
         });
-        if (tool4.strict === true) {
+        if (tool5.strict === true) {
           hasStrictTools = true;
         }
         break;
       default:
         toolWarnings.push({
           type: "unsupported",
-          feature: `function tool ${tool4.name}`
+          feature: `function tool ${tool5.name}`
         });
         break;
     }
@@ -12261,7 +12270,7 @@ var GoogleGenerativeAILanguageModel = class {
     }
     const isVertexProvider = this.config.provider.startsWith("google.vertex.");
     if ((tools == null ? void 0 : tools.some(
-      (tool4) => tool4.type === "provider" && tool4.id === "google.vertex_rag_store"
+      (tool5) => tool5.type === "provider" && tool5.id === "google.vertex_rag_store"
     )) && !isVertexProvider) {
       warnings.push({
         type: "other",
@@ -16994,23 +17003,23 @@ function prepareChatTools({
     return { tools: void 0, toolChoice: void 0, toolWarnings };
   }
   const openaiTools2 = [];
-  for (const tool4 of tools) {
-    switch (tool4.type) {
+  for (const tool5 of tools) {
+    switch (tool5.type) {
       case "function":
         openaiTools2.push({
           type: "function",
           function: {
-            name: tool4.name,
-            description: tool4.description,
-            parameters: tool4.inputSchema,
-            ...tool4.strict != null ? { strict: tool4.strict } : {}
+            name: tool5.name,
+            description: tool5.description,
+            parameters: tool5.inputSchema,
+            ...tool5.strict != null ? { strict: tool5.strict } : {}
           }
         });
         break;
       default:
         toolWarnings.push({
           type: "unsupported",
-          feature: `tool type: ${tool4.type}`
+          feature: `tool type: ${tool5.type}`
         });
         break;
     }
@@ -20721,26 +20730,26 @@ async function prepareResponsesTools({
   }
   const openaiTools2 = [];
   const resolvedCustomProviderToolNames = customProviderToolNames != null ? customProviderToolNames : /* @__PURE__ */ new Set();
-  for (const tool4 of tools) {
-    switch (tool4.type) {
+  for (const tool5 of tools) {
+    switch (tool5.type) {
       case "function": {
-        const openaiOptions = (_a20 = tool4.providerOptions) == null ? void 0 : _a20.openai;
+        const openaiOptions = (_a20 = tool5.providerOptions) == null ? void 0 : _a20.openai;
         const deferLoading = openaiOptions == null ? void 0 : openaiOptions.deferLoading;
         openaiTools2.push({
           type: "function",
-          name: tool4.name,
-          description: tool4.description,
-          parameters: tool4.inputSchema,
-          ...tool4.strict != null ? { strict: tool4.strict } : {},
+          name: tool5.name,
+          description: tool5.description,
+          parameters: tool5.inputSchema,
+          ...tool5.strict != null ? { strict: tool5.strict } : {},
           ...deferLoading != null ? { defer_loading: deferLoading } : {}
         });
         break;
       }
       case "provider": {
-        switch (tool4.id) {
+        switch (tool5.id) {
           case "openai.file_search": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: fileSearchArgsSchema2
             });
             openaiTools2.push({
@@ -20763,7 +20772,7 @@ async function prepareResponsesTools({
           }
           case "openai.shell": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: shellArgsSchema
             });
             openaiTools2.push({
@@ -20782,7 +20791,7 @@ async function prepareResponsesTools({
           }
           case "openai.web_search_preview": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: webSearchPreviewArgsSchema
             });
             openaiTools2.push({
@@ -20794,7 +20803,7 @@ async function prepareResponsesTools({
           }
           case "openai.web_search": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: webSearchArgsSchema
             });
             openaiTools2.push({
@@ -20808,7 +20817,7 @@ async function prepareResponsesTools({
           }
           case "openai.code_interpreter": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: codeInterpreterArgsSchema
             });
             openaiTools2.push({
@@ -20819,7 +20828,7 @@ async function prepareResponsesTools({
           }
           case "openai.image_generation": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: imageGenerationArgsSchema
             });
             openaiTools2.push({
@@ -20842,7 +20851,7 @@ async function prepareResponsesTools({
           }
           case "openai.mcp": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: mcpArgsSchema
             });
             const mapApprovalFilter = (filter4) => ({
@@ -20868,7 +20877,7 @@ async function prepareResponsesTools({
           }
           case "openai.custom": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: customArgsSchema
             });
             openaiTools2.push({
@@ -20882,7 +20891,7 @@ async function prepareResponsesTools({
           }
           case "openai.tool_search": {
             const args = await validateTypes3({
-              value: tool4.args,
+              value: tool5.args,
               schema: toolSearchArgsSchema
             });
             openaiTools2.push({
@@ -20899,7 +20908,7 @@ async function prepareResponsesTools({
       default:
         toolWarnings.push({
           type: "unsupported",
-          feature: `function tool ${tool4}`
+          feature: `function tool ${tool5}`
         });
         break;
     }
@@ -21071,7 +21080,7 @@ var OpenAIResponsesLanguageModel = class {
         "openai.apply_patch": "apply_patch",
         "openai.tool_search": "tool_search"
       },
-      resolveProviderToolName: (tool4) => tool4.id === "openai.custom" ? tool4.args.name : void 0
+      resolveProviderToolName: (tool5) => tool5.id === "openai.custom" ? tool5.args.name : void 0
     });
     const customProviderToolNames = /* @__PURE__ */ new Set();
     const {
@@ -21108,14 +21117,14 @@ var OpenAIResponsesLanguageModel = class {
       }
     }
     function hasOpenAITool(id) {
-      return (tools == null ? void 0 : tools.find((tool4) => tool4.type === "provider" && tool4.id === id)) != null;
+      return (tools == null ? void 0 : tools.find((tool5) => tool5.type === "provider" && tool5.id === id)) != null;
     }
     const topLogprobs = typeof (openaiOptions == null ? void 0 : openaiOptions.logprobs) === "number" ? openaiOptions == null ? void 0 : openaiOptions.logprobs : (openaiOptions == null ? void 0 : openaiOptions.logprobs) === true ? TOP_LOGPROBS_MAX : void 0;
     if (topLogprobs) {
       addInclude("message.output_text.logprobs");
     }
     const webSearchToolName = (_e = tools == null ? void 0 : tools.find(
-      (tool4) => tool4.type === "provider" && (tool4.id === "openai.web_search" || tool4.id === "openai.web_search_preview")
+      (tool5) => tool5.type === "provider" && (tool5.id === "openai.web_search" || tool5.id === "openai.web_search_preview")
     )) == null ? void 0 : _e.name;
     if (webSearchToolName) {
       addInclude("web_search_call.action.sources");
@@ -21229,7 +21238,7 @@ var OpenAIResponsesLanguageModel = class {
       delete baseArgs.service_tier;
     }
     const shellToolEnvType = (_i = (_h = (_g = tools == null ? void 0 : tools.find(
-      (tool4) => tool4.type === "provider" && tool4.id === "openai.shell"
+      (tool5) => tool5.type === "provider" && tool5.id === "openai.shell"
     )) == null ? void 0 : _g.args) == null ? void 0 : _h.environment) == null ? void 0 : _i.type;
     const isShellProviderExecuted = shellToolEnvType === "containerAuto" || shellToolEnvType === "containerReference";
     return {
@@ -23895,8 +23904,211 @@ var OUTRO = `
 Please write all the necessary code to fully implement the feature end-to-end. Do not make mock data or example placeholders!!!
 `;
 
+// src/search.ts
+var import_ai2 = require("ai");
+var import_zod = require("zod");
+var WEB_SEARCH_TOOL_NAME = "web_search";
+var EXA_SEARCH_URL = "https://api.exa.ai/search";
+var DEFAULT_MAX_USES = 3;
+var DEFAULT_NUM_RESULTS = 5;
+var DEFAULT_MAX_CHARACTERS = 4e3;
+function getSearchApiKey() {
+  return normalizeApiKey(process.env.EXA_API_KEY);
+}
+function hasSearchApiKey() {
+  return !!getSearchApiKey();
+}
+function resolveSearchBackend(provider) {
+  return provider === "anthropic" ? "anthropic" : "exa";
+}
+async function searchWeb(query, opts = {}) {
+  const apiKey = normalizeApiKey(opts.apiKey) || getSearchApiKey();
+  if (!apiKey) throw new Error("EXA_API_KEY not configured");
+  const res = await fetch(EXA_SEARCH_URL, {
+    method: "POST",
+    headers: { "content-type": "application/json", "x-api-key": apiKey },
+    signal: opts.abortSignal,
+    body: JSON.stringify({
+      query,
+      type: "auto",
+      numResults: opts.numResults ?? DEFAULT_NUM_RESULTS,
+      contents: {
+        text: { maxCharacters: opts.maxCharacters ?? DEFAULT_MAX_CHARACTERS }
+      },
+      ...opts.allowedDomains?.length ? { includeDomains: opts.allowedDomains } : {},
+      ...opts.blockedDomains?.length ? { excludeDomains: opts.blockedDomains } : {}
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(`Exa search failed (${res.status}): ${body.slice(0, 300)}`);
+  }
+  const json = await res.json();
+  const results = Array.isArray(json.results) ? json.results : [];
+  return results.filter((r) => typeof r.url === "string").map((r) => ({
+    url: r.url,
+    title: r.title ?? null,
+    pageAge: r.publishedDate ?? null,
+    ...r.text ? { text: r.text } : {},
+    type: "web_search_result"
+  }));
+}
+function citationSnippet(backend) {
+  const indexRule = backend === "exa" ? "Every result carries an `index` field. Use that number exactly as returned \u2014 never invent or renumber one. Indices are global across all searches in this conversation." : "Use the index Anthropic assigns to the search result you are citing.";
+  return `
+
+## Citing web search results
+When you use information from a \`${WEB_SEARCH_TOOL_NAME}\` result, cite it inline as \`<cite index="N">anchor text</cite>\`. ${indexRule}
+
+The anchor text is REQUIRED and becomes the link text \u2014 put the words being sourced inside the tag, e.g. \`<cite index="3">runs on the Lightning Network</cite>\`. Never emit an empty tag like \`<cite index="3"></cite>\`; a trailing marker with no anchor produces a broken link.
+
+Do NOT name sources parenthetically (e.g. \`(Bitcoin Magazine)\`) or as bare URLs \u2014 observed models fall back to that style and it produces no link. Every source reference must be a cite tag.`;
+}
+function createWebSearch(opts) {
+  const results = [];
+  const backend = opts.backend ?? resolveSearchBackend(opts.provider);
+  const maxUses = opts.maxUses ?? DEFAULT_MAX_USES;
+  if (backend === "anthropic") {
+    const apiKey = normalizeApiKey(opts.apiKey) || normalizeApiKey(process.env.ANTHROPIC_API_KEY);
+    if (!apiKey) {
+      return emptyHandle(results);
+    }
+    const baseURL = getGatewayBaseURL("anthropic");
+    const anthropic2 = createAnthropic({ apiKey, ...baseURL && { baseURL } });
+    return {
+      tool: anthropic2.tools.webSearch_20250305({
+        maxUses,
+        ...opts.allowedDomains?.length ? { allowedDomains: opts.allowedDomains } : {},
+        ...opts.blockedDomains?.length ? { blockedDomains: opts.blockedDomains } : {}
+      }),
+      backend,
+      native: true,
+      results,
+      capture: (stepContent) => captureNativeResults(stepContent, results),
+      promptSnippet: opts.citations ? citationSnippet("anthropic") : "",
+      formatOutput: (markdown) => formatOutput(markdown, results, !!opts.citations)
+    };
+  }
+  const searchApiKey = normalizeApiKey(opts.searchApiKey) || getSearchApiKey();
+  if (!searchApiKey) {
+    return emptyHandle(results);
+  }
+  let uses = 0;
+  return {
+    tool: (0, import_ai2.tool)({
+      description: "Search the web for current information. Returns numbered results with page text. Prefer one specific query per call over broad multi-topic queries.",
+      inputSchema: import_zod.z.object({
+        query: import_zod.z.string().describe("The search query."),
+        num_results: import_zod.z.number().int().min(1).max(10).optional().describe("How many results to return. Default 5.")
+      }),
+      execute: async ({
+        query,
+        num_results
+      }) => {
+        if (uses >= maxUses) {
+          return {
+            error: `web_search budget exhausted (${maxUses} calls). Answer with what you have.`
+          };
+        }
+        uses++;
+        try {
+          const hits = await searchWeb(query, {
+            numResults: num_results ?? opts.numResults,
+            maxCharacters: opts.maxCharacters,
+            allowedDomains: opts.allowedDomains,
+            blockedDomains: opts.blockedDomains,
+            apiKey: searchApiKey,
+            abortSignal: opts.abortSignal
+          });
+          return hits.map((hit) => {
+            const indexed = { ...hit, index: results.length + 1 };
+            results.push(indexed);
+            return indexed;
+          });
+        } catch (err) {
+          return {
+            error: `Search failed: ${err instanceof Error ? err.message : String(err)}`
+          };
+        }
+      }
+    }),
+    backend,
+    native: false,
+    results,
+    // Exa results are appended by `execute` above; walking the step
+    // would double-count them.
+    capture: () => {
+    },
+    promptSnippet: opts.citations ? citationSnippet("exa") : "",
+    formatOutput: (markdown) => formatOutput(markdown, results, !!opts.citations)
+  };
+}
+function emptyHandle(results) {
+  return {
+    tool: void 0,
+    backend: void 0,
+    native: false,
+    results,
+    capture: () => {
+    },
+    promptSnippet: "",
+    formatOutput: (markdown) => formatOutput(markdown, results, false)
+  };
+}
+function formatOutput(markdown, results, citations) {
+  return citations ? linkifyCitations(markdown, results) : { content: stripCitations(markdown), converted: 0, skipped: 0 };
+}
+function captureNativeResults(stepContent, target) {
+  if (!Array.isArray(stepContent)) return;
+  for (const content of stepContent) {
+    if (content?.type !== "tool-result") continue;
+    if (content?.toolName !== WEB_SEARCH_TOOL_NAME) continue;
+    const body = content.output ?? content.result ?? null;
+    if (!Array.isArray(body)) continue;
+    for (const r of body) {
+      if (r && typeof r === "object" && typeof r.url === "string") {
+        target.push({
+          url: r.url,
+          title: r.title ?? null,
+          pageAge: r.pageAge ?? null,
+          // Assigned here too, so `results` is shape-identical to the
+          // Exa path. Anthropic's model derives its own indices from
+          // the same ordering, so these agree by construction.
+          index: target.length + 1,
+          type: "web_search_result"
+        });
+      }
+    }
+  }
+}
+function stripCitations(markdown) {
+  return markdown.replace(/[ \t]*<cite\b[^>]*>\s*<\/cite>/g, "").replace(/<cite\b[^>]*>(.*?)<\/cite>/g, "$1").replace(/<\/?cite\b[^>]*>/g, "");
+}
+function linkifyCitations(markdown, results) {
+  let converted = 0;
+  let skipped = 0;
+  const content = markdown.replace(
+    /<cite index="(\d+)(?:-\d+(?:,\d+-\d+)*)?">(.*?)<\/cite>/g,
+    (_match, indexStr, anchor) => {
+      const index = parseInt(indexStr, 10);
+      const hit = results[index - 1];
+      if (!hit || typeof hit.url !== "string") {
+        skipped++;
+        return anchor;
+      }
+      converted++;
+      const text = anchor.trim() ? anchor.replace(/\]/g, "\\]") : `[${index}]`;
+      return `[${text}](${hit.url})`;
+    }
+  );
+  return { content, converted, skipped };
+}
+
 // src/tools.ts
 function getProviderTool(provider, apiKey, toolName) {
+  if (toolName === "webSearch") {
+    return createWebSearch({ provider, apiKey }).tool;
+  }
   switch (provider) {
     case "anthropic":
       return getAnthropicTool(apiKey, toolName);
@@ -23953,12 +24165,15 @@ function consoleLogger(name19) {
   OUTRO,
   PROVIDERS,
   SYSTEM,
+  WEB_SEARCH_TOOL_NAME,
   addUsage,
   callGenerateObject,
   callGenerateText,
   callModel,
+  captureNativeResults,
   computeSessionCost,
   consoleLogger,
+  createWebSearch,
   emptyUsage,
   gatewayEnvForProviders,
   gatewayUrlFor,
@@ -23972,13 +24187,19 @@ function consoleLogger(name19) {
   getProviderForModel,
   getProviderOptions,
   getProviderTool,
+  getSearchApiKey,
   getTokenPricing,
   hasApiKeyForProvider,
+  hasSearchApiKey,
+  linkifyCitations,
   loadModelPricing,
   normalizeApiKey,
   normalizeCallerBaseURL,
   normalizeUsage,
   resolveLLMConfig,
+  resolveSearchBackend,
+  searchWeb,
+  stripCitations,
   withLegacyUsage,
   withProviderCacheUsage
 });