aieo 0.1.36 → 0.1.38

package/dist/index.cjs

@@ -36,16 +36,20 @@ __export(index_exports, {
   OUTRO: () => OUTRO,
   PROVIDERS: () => PROVIDERS,
   SYSTEM: () => SYSTEM,
+  WEB_FETCH_TOOL_NAME: () => WEB_FETCH_TOOL_NAME,
   WEB_SEARCH_TOOL_NAME: () => WEB_SEARCH_TOOL_NAME,
   addUsage: () => addUsage,
   callGenerateObject: () => callGenerateObject,
   callGenerateText: () => callGenerateText,
   callModel: () => callModel,
+  captureNativeFetchResults: () => captureNativeFetchResults,
   captureNativeResults: () => captureNativeResults,
   computeSessionCost: () => computeSessionCost,
   consoleLogger: () => consoleLogger,
+  createWebFetch: () => createWebFetch,
   createWebSearch: () => createWebSearch,
   emptyUsage: () => emptyUsage,
+  fetchUrl: () => fetchUrl,
   gatewayEnvForProviders: () => gatewayEnvForProviders,
   gatewayUrlFor: () => gatewayUrlFor,
   gatewayUrlForModel: () => gatewayUrlForModel,
@@ -62,15 +66,19 @@ __export(index_exports, {
   getTokenPricing: () => getTokenPricing,
   hasApiKeyForProvider: () => hasApiKeyForProvider,
   hasSearchApiKey: () => hasSearchApiKey,
+  htmlToText: () => htmlToText,
+  isPrivateAddress: () => isPrivateAddress,
   linkifyCitations: () => linkifyCitations,
   loadModelPricing: () => loadModelPricing,
   normalizeApiKey: () => normalizeApiKey,
   normalizeCallerBaseURL: () => normalizeCallerBaseURL,
   normalizeUsage: () => normalizeUsage,
+  resolveFetchBackend: () => resolveFetchBackend,
   resolveLLMConfig: () => resolveLLMConfig,
   resolveSearchBackend: () => resolveSearchBackend,
   searchWeb: () => searchWeb,
   stripCitations: () => stripCitations,
+  validateFetchUrl: () => validateFetchUrl,
   withLegacyUsage: () => withLegacyUsage,
   withProviderCacheUsage: () => withProviderCacheUsage
 });
@@ -4190,35 +4198,35 @@ async function prepareTools({
     return { tools: void 0, toolChoice: void 0, toolWarnings, betas };
   }
   const anthropicTools2 = [];
-  for (const tool5 of tools) {
-    switch (tool5.type) {
+  for (const tool6 of tools) {
+    switch (tool6.type) {
       case "function": {
-        const cacheControl = validator.getCacheControl(tool5.providerOptions, {
+        const cacheControl = validator.getCacheControl(tool6.providerOptions, {
           type: "tool definition",
           canCache: true
         });
-        const anthropicOptions = (_a20 = tool5.providerOptions) == null ? void 0 : _a20.anthropic;
+        const anthropicOptions = (_a20 = tool6.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 && tool5.strict != null) {
+        if (!supportsStrictTools && tool6.strict != null) {
           toolWarnings.push({
             type: "unsupported",
             feature: "strict",
-            details: `Tool '${tool5.name}' has strict: ${tool5.strict}, but strict mode is not supported by this provider. The strict property will be ignored.`
+            details: `Tool '${tool6.name}' has strict: ${tool6.strict}, but strict mode is not supported by this provider. The strict property will be ignored.`
           });
         }
         anthropicTools2.push({
-          name: tool5.name,
-          description: tool5.description,
-          input_schema: tool5.inputSchema,
+          name: tool6.name,
+          description: tool6.description,
+          input_schema: tool6.inputSchema,
           cache_control: cacheControl,
           ...eagerInputStreaming ? { eager_input_streaming: true } : {},
-          ...supportsStrictTools === true && tool5.strict != null ? { strict: tool5.strict } : {},
+          ...supportsStrictTools === true && tool6.strict != null ? { strict: tool6.strict } : {},
           ...deferLoading != null ? { defer_loading: deferLoading } : {},
           ...allowedCallers != null ? { allowed_callers: allowedCallers } : {},
-          ...tool5.inputExamples != null ? {
-            input_examples: tool5.inputExamples.map(
+          ...tool6.inputExamples != null ? {
+            input_examples: tool6.inputExamples.map(
               (example) => example.input
             )
           } : {}
@@ -4226,13 +4234,13 @@ async function prepareTools({
         if (supportsStructuredOutput === true) {
           betas.add("structured-outputs-2025-11-13");
         }
-        if (tool5.inputExamples != null || allowedCallers != null) {
+        if (tool6.inputExamples != null || allowedCallers != null) {
           betas.add("advanced-tool-use-2025-11-20");
         }
         break;
       }
       case "provider": {
-        switch (tool5.id) {
+        switch (tool6.id) {
           case "anthropic.code_execution_20250522": {
             betas.add("code-execution-2025-05-22");
             anthropicTools2.push({
@@ -4262,9 +4270,9 @@ async function prepareTools({
             anthropicTools2.push({
               name: "computer",
               type: "computer_20250124",
-              display_width_px: tool5.args.displayWidthPx,
-              display_height_px: tool5.args.displayHeightPx,
-              display_number: tool5.args.displayNumber,
+              display_width_px: tool6.args.displayWidthPx,
+              display_height_px: tool6.args.displayHeightPx,
+              display_number: tool6.args.displayNumber,
               cache_control: void 0
             });
             break;
@@ -4274,10 +4282,10 @@ async function prepareTools({
             anthropicTools2.push({
               name: "computer",
               type: "computer_20251124",
-              display_width_px: tool5.args.displayWidthPx,
-              display_height_px: tool5.args.displayHeightPx,
-              display_number: tool5.args.displayNumber,
-              enable_zoom: tool5.args.enableZoom,
+              display_width_px: tool6.args.displayWidthPx,
+              display_height_px: tool6.args.displayHeightPx,
+              display_number: tool6.args.displayNumber,
+              enable_zoom: tool6.args.enableZoom,
               cache_control: void 0
             });
             break;
@@ -4287,9 +4295,9 @@ async function prepareTools({
             anthropicTools2.push({
               name: "computer",
               type: "computer_20241022",
-              display_width_px: tool5.args.displayWidthPx,
-              display_height_px: tool5.args.displayHeightPx,
-              display_number: tool5.args.displayNumber,
+              display_width_px: tool6.args.displayWidthPx,
+              display_height_px: tool6.args.displayHeightPx,
+              display_number: tool6.args.displayNumber,
               cache_control: void 0
             });
             break;
@@ -4323,7 +4331,7 @@ async function prepareTools({
           }
           case "anthropic.text_editor_20250728": {
             const args = await validateTypes({
-              value: tool5.args,
+              value: tool6.args,
               schema: textEditor_20250728ArgsSchema
             });
             anthropicTools2.push({
@@ -4363,7 +4371,7 @@ async function prepareTools({
           case "anthropic.web_fetch_20250910": {
             betas.add("web-fetch-2025-09-10");
             const args = await validateTypes({
-              value: tool5.args,
+              value: tool6.args,
               schema: webFetch_20250910ArgsSchema
             });
             anthropicTools2.push({
@@ -4381,7 +4389,7 @@ async function prepareTools({
           case "anthropic.web_fetch_20260209": {
             betas.add("code-execution-web-tools-2026-02-09");
             const args = await validateTypes({
-              value: tool5.args,
+              value: tool6.args,
               schema: webFetch_20260209ArgsSchema
             });
             anthropicTools2.push({
@@ -4398,7 +4406,7 @@ async function prepareTools({
           }
           case "anthropic.web_search_20250305": {
             const args = await validateTypes({
-              value: tool5.args,
+              value: tool6.args,
               schema: webSearch_20250305ArgsSchema
             });
             anthropicTools2.push({
@@ -4415,7 +4423,7 @@ async function prepareTools({
           case "anthropic.web_search_20260209": {
             betas.add("code-execution-web-tools-2026-02-09");
             const args = await validateTypes({
-              value: tool5.args,
+              value: tool6.args,
               schema: webSearch_20260209ArgsSchema
             });
             anthropicTools2.push({
@@ -4446,7 +4454,7 @@ async function prepareTools({
           case "anthropic.advisor_20260301": {
             betas.add("advisor-tool-2026-03-01");
             const args = await validateTypes({
-              value: tool5.args,
+              value: tool6.args,
               schema: advisor_20260301ArgsSchema
             });
             anthropicTools2.push({
@@ -4461,7 +4469,7 @@ async function prepareTools({
           default: {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool5.id}`
+              feature: `provider-defined tool ${tool6.id}`
             });
             break;
           }
@@ -4471,7 +4479,7 @@ async function prepareTools({
       default: {
         toolWarnings.push({
           type: "unsupported",
-          feature: `tool ${tool5}`
+          feature: `tool ${tool6}`
         });
         break;
       }
@@ -6441,7 +6449,7 @@ var AnthropicMessagesLanguageModel = class {
       betas.add("skills-2025-10-02");
       betas.add("files-api-2025-04-14");
       if (!(tools == null ? void 0 : tools.some(
-        (tool5) => tool5.type === "provider" && (tool5.id === "anthropic.code_execution_20250825" || tool5.id === "anthropic.code_execution_20260120")
+        (tool6) => tool6.type === "provider" && (tool6.id === "anthropic.code_execution_20250825" || tool6.id === "anthropic.code_execution_20260120")
       ))) {
         warnings.push({
           type: "other",
@@ -8044,12 +8052,12 @@ function hasWebTool20260209WithoutCodeExecution(tools) {
   }
   let hasWebTool20260209 = false;
   let hasCodeExecutionTool = false;
-  for (const tool5 of tools) {
-    if ("type" in tool5 && (tool5.type === "web_fetch_20260209" || tool5.type === "web_search_20260209")) {
+  for (const tool6 of tools) {
+    if ("type" in tool6 && (tool6.type === "web_fetch_20260209" || tool6.type === "web_search_20260209")) {
       hasWebTool20260209 = true;
       continue;
     }
-    if (tool5.name === "code_execution") {
+    if (tool6.name === "code_execution") {
       hasCodeExecutionTool = true;
       break;
     }
@@ -11758,8 +11766,8 @@ function prepareTools2({
   if (tools == null) {
     return { tools: void 0, toolConfig: void 0, toolWarnings };
   }
-  const hasFunctionTools = tools.some((tool5) => tool5.type === "function");
-  const hasProviderTools = tools.some((tool5) => tool5.type === "provider");
+  const hasFunctionTools = tools.some((tool6) => tool6.type === "function");
+  const hasProviderTools = tools.some((tool6) => tool6.type === "provider");
   if (hasFunctionTools && hasProviderTools && !isGemini3orNewer) {
     toolWarnings.push({
       type: "unsupported",
@@ -11768,16 +11776,16 @@ function prepareTools2({
   }
   if (hasProviderTools) {
     const googleTools2 = [];
-    const ProviderTools = tools.filter((tool5) => tool5.type === "provider");
-    ProviderTools.forEach((tool5) => {
-      switch (tool5.id) {
+    const ProviderTools = tools.filter((tool6) => tool6.type === "provider");
+    ProviderTools.forEach((tool6) => {
+      switch (tool6.id) {
         case "google.google_search":
           if (isGemini2orNewer) {
-            googleTools2.push({ googleSearch: { ...tool5.args } });
+            googleTools2.push({ googleSearch: { ...tool6.args } });
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool5.id}`,
+              feature: `provider-defined tool ${tool6.id}`,
               details: "Google Search requires Gemini 2.0 or newer."
             });
           }
@@ -11788,7 +11796,7 @@ function prepareTools2({
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool5.id}`,
+              feature: `provider-defined tool ${tool6.id}`,
               details: "Enterprise Web Search requires Gemini 2.0 or newer."
             });
           }
@@ -11799,7 +11807,7 @@ function prepareTools2({
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool5.id}`,
+              feature: `provider-defined tool ${tool6.id}`,
               details: "The URL context tool is not supported with other Gemini models than Gemini 2."
             });
           }
@@ -11810,18 +11818,18 @@ function prepareTools2({
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool5.id}`,
+              feature: `provider-defined tool ${tool6.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: { ...tool5.args } });
+            googleTools2.push({ fileSearch: { ...tool6.args } });
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool5.id}`,
+              feature: `provider-defined tool ${tool6.id}`,
               details: "The file search tool is only supported with Gemini 2.5 models and Gemini 3 models."
             });
           }
@@ -11832,16 +11840,16 @@ function prepareTools2({
               retrieval: {
                 vertex_rag_store: {
                   rag_resources: {
-                    rag_corpus: tool5.args.ragCorpus
+                    rag_corpus: tool6.args.ragCorpus
                   },
-                  similarity_top_k: tool5.args.topK
+                  similarity_top_k: tool6.args.topK
                 }
               }
             });
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool5.id}`,
+              feature: `provider-defined tool ${tool6.id}`,
               details: "The RAG store tool is not supported with other Gemini models than Gemini 2."
             });
           }
@@ -11852,7 +11860,7 @@ function prepareTools2({
           } else {
             toolWarnings.push({
               type: "unsupported",
-              feature: `provider-defined tool ${tool5.id}`,
+              feature: `provider-defined tool ${tool6.id}`,
               details: "The Google Maps grounding tool is not supported with Gemini models other than Gemini 2 or newer."
             });
           }
@@ -11860,19 +11868,19 @@ function prepareTools2({
         default:
           toolWarnings.push({
             type: "unsupported",
-            feature: `provider-defined tool ${tool5.id}`
+            feature: `provider-defined tool ${tool6.id}`
           });
           break;
       }
     });
     if (hasFunctionTools && isGemini3orNewer && googleTools2.length > 0) {
       const functionDeclarations2 = [];
-      for (const tool5 of tools) {
-        if (tool5.type === "function") {
+      for (const tool6 of tools) {
+        if (tool6.type === "function") {
           functionDeclarations2.push({
-            name: tool5.name,
-            description: (_a20 = tool5.description) != null ? _a20 : "",
-            parameters: convertJSONSchemaToOpenAPISchema(tool5.inputSchema)
+            name: tool6.name,
+            description: (_a20 = tool6.description) != null ? _a20 : "",
+            parameters: convertJSONSchemaToOpenAPISchema(tool6.inputSchema)
           });
         }
       }
@@ -11912,22 +11920,22 @@ function prepareTools2({
   }
   const functionDeclarations = [];
   let hasStrictTools = false;
-  for (const tool5 of tools) {
-    switch (tool5.type) {
+  for (const tool6 of tools) {
+    switch (tool6.type) {
       case "function":
         functionDeclarations.push({
-          name: tool5.name,
-          description: (_b20 = tool5.description) != null ? _b20 : "",
-          parameters: convertJSONSchemaToOpenAPISchema(tool5.inputSchema)
+          name: tool6.name,
+          description: (_b20 = tool6.description) != null ? _b20 : "",
+          parameters: convertJSONSchemaToOpenAPISchema(tool6.inputSchema)
         });
-        if (tool5.strict === true) {
+        if (tool6.strict === true) {
           hasStrictTools = true;
         }
         break;
       default:
         toolWarnings.push({
           type: "unsupported",
-          feature: `function tool ${tool5.name}`
+          feature: `function tool ${tool6.name}`
         });
         break;
     }
@@ -12270,7 +12278,7 @@ var GoogleGenerativeAILanguageModel = class {
     }
     const isVertexProvider = this.config.provider.startsWith("google.vertex.");
     if ((tools == null ? void 0 : tools.some(
-      (tool5) => tool5.type === "provider" && tool5.id === "google.vertex_rag_store"
+      (tool6) => tool6.type === "provider" && tool6.id === "google.vertex_rag_store"
     )) && !isVertexProvider) {
       warnings.push({
         type: "other",
@@ -17003,23 +17011,23 @@ function prepareChatTools({
     return { tools: void 0, toolChoice: void 0, toolWarnings };
   }
   const openaiTools2 = [];
-  for (const tool5 of tools) {
-    switch (tool5.type) {
+  for (const tool6 of tools) {
+    switch (tool6.type) {
       case "function":
         openaiTools2.push({
           type: "function",
           function: {
-            name: tool5.name,
-            description: tool5.description,
-            parameters: tool5.inputSchema,
-            ...tool5.strict != null ? { strict: tool5.strict } : {}
+            name: tool6.name,
+            description: tool6.description,
+            parameters: tool6.inputSchema,
+            ...tool6.strict != null ? { strict: tool6.strict } : {}
           }
         });
         break;
       default:
         toolWarnings.push({
           type: "unsupported",
-          feature: `tool type: ${tool5.type}`
+          feature: `tool type: ${tool6.type}`
         });
         break;
     }
@@ -20730,26 +20738,26 @@ async function prepareResponsesTools({
   }
   const openaiTools2 = [];
   const resolvedCustomProviderToolNames = customProviderToolNames != null ? customProviderToolNames : /* @__PURE__ */ new Set();
-  for (const tool5 of tools) {
-    switch (tool5.type) {
+  for (const tool6 of tools) {
+    switch (tool6.type) {
       case "function": {
-        const openaiOptions = (_a20 = tool5.providerOptions) == null ? void 0 : _a20.openai;
+        const openaiOptions = (_a20 = tool6.providerOptions) == null ? void 0 : _a20.openai;
         const deferLoading = openaiOptions == null ? void 0 : openaiOptions.deferLoading;
         openaiTools2.push({
           type: "function",
-          name: tool5.name,
-          description: tool5.description,
-          parameters: tool5.inputSchema,
-          ...tool5.strict != null ? { strict: tool5.strict } : {},
+          name: tool6.name,
+          description: tool6.description,
+          parameters: tool6.inputSchema,
+          ...tool6.strict != null ? { strict: tool6.strict } : {},
           ...deferLoading != null ? { defer_loading: deferLoading } : {}
         });
         break;
       }
       case "provider": {
-        switch (tool5.id) {
+        switch (tool6.id) {
           case "openai.file_search": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: fileSearchArgsSchema2
             });
             openaiTools2.push({
@@ -20772,7 +20780,7 @@ async function prepareResponsesTools({
           }
           case "openai.shell": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: shellArgsSchema
             });
             openaiTools2.push({
@@ -20791,7 +20799,7 @@ async function prepareResponsesTools({
           }
           case "openai.web_search_preview": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: webSearchPreviewArgsSchema
             });
             openaiTools2.push({
@@ -20803,7 +20811,7 @@ async function prepareResponsesTools({
           }
           case "openai.web_search": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: webSearchArgsSchema
             });
             openaiTools2.push({
@@ -20817,7 +20825,7 @@ async function prepareResponsesTools({
           }
           case "openai.code_interpreter": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: codeInterpreterArgsSchema
             });
             openaiTools2.push({
@@ -20828,7 +20836,7 @@ async function prepareResponsesTools({
           }
           case "openai.image_generation": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: imageGenerationArgsSchema
             });
             openaiTools2.push({
@@ -20851,7 +20859,7 @@ async function prepareResponsesTools({
           }
           case "openai.mcp": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: mcpArgsSchema
             });
             const mapApprovalFilter = (filter4) => ({
@@ -20877,7 +20885,7 @@ async function prepareResponsesTools({
           }
           case "openai.custom": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: customArgsSchema
             });
             openaiTools2.push({
@@ -20891,7 +20899,7 @@ async function prepareResponsesTools({
           }
           case "openai.tool_search": {
             const args = await validateTypes3({
-              value: tool5.args,
+              value: tool6.args,
               schema: toolSearchArgsSchema
             });
             openaiTools2.push({
@@ -20908,7 +20916,7 @@ async function prepareResponsesTools({
       default:
         toolWarnings.push({
           type: "unsupported",
-          feature: `function tool ${tool5}`
+          feature: `function tool ${tool6}`
         });
         break;
     }
@@ -21080,7 +21088,7 @@ var OpenAIResponsesLanguageModel = class {
         "openai.apply_patch": "apply_patch",
         "openai.tool_search": "tool_search"
       },
-      resolveProviderToolName: (tool5) => tool5.id === "openai.custom" ? tool5.args.name : void 0
+      resolveProviderToolName: (tool6) => tool6.id === "openai.custom" ? tool6.args.name : void 0
     });
     const customProviderToolNames = /* @__PURE__ */ new Set();
     const {
@@ -21117,14 +21125,14 @@ var OpenAIResponsesLanguageModel = class {
       }
     }
     function hasOpenAITool(id) {
-      return (tools == null ? void 0 : tools.find((tool5) => tool5.type === "provider" && tool5.id === id)) != null;
+      return (tools == null ? void 0 : tools.find((tool6) => tool6.type === "provider" && tool6.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(
-      (tool5) => tool5.type === "provider" && (tool5.id === "openai.web_search" || tool5.id === "openai.web_search_preview")
+      (tool6) => tool6.type === "provider" && (tool6.id === "openai.web_search" || tool6.id === "openai.web_search_preview")
     )) == null ? void 0 : _e.name;
     if (webSearchToolName) {
       addInclude("web_search_call.action.sources");
@@ -21238,7 +21246,7 @@ var OpenAIResponsesLanguageModel = class {
       delete baseArgs.service_tier;
     }
     const shellToolEnvType = (_i = (_h = (_g = tools == null ? void 0 : tools.find(
-      (tool5) => tool5.type === "provider" && tool5.id === "openai.shell"
+      (tool6) => tool6.type === "provider" && tool6.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 {
@@ -23493,7 +23501,8 @@ function getModel(provider, opts) {
         usage: { include: true },
         ...isMoonshot ? { provider: { order: ["moonshotai"], allow_fallbacks: true } } : {}
       };
-      return openrouter(modelId, settings);
+      const gatewayModelId = baseURL ? `openrouter/${modelId}` : modelId;
+      return openrouter(gatewayModelId, settings);
     }
     case "xai": {
       if (baseURL) {
@@ -24104,11 +24113,404 @@ function linkifyCitations(markdown, results) {
   return { content, converted, skipped };
 }
 
+// src/fetch.ts
+var import_ai3 = require("ai");
+var import_zod2 = require("zod");
+var import_node_net = require("net");
+var import_promises = require("dns/promises");
+var WEB_FETCH_TOOL_NAME = "web_fetch";
+var DEFAULT_MAX_USES2 = 5;
+var DEFAULT_MAX_CHARACTERS2 = 4e4;
+var CHARS_PER_TOKEN = 4;
+var DEFAULT_TIMEOUT_MS = 2e4;
+var MAX_REDIRECTS = 5;
+var MAX_BODY_BYTES = 4 * 1024 * 1024;
+var USER_AGENT = "aieo-web-fetch/1 (+https://github.com/stakwork/stakgraph)";
+var ACCEPT = "text/html, application/xhtml+xml, text/plain;q=0.9, application/json;q=0.9, text/*;q=0.8, */*;q=0.5";
+function resolveFetchBackend(provider) {
+  return provider === "anthropic" ? "anthropic" : "http";
+}
+var PRIVATE_ADDRESSES = buildBlockList();
+function buildBlockList() {
+  const b = new import_node_net.BlockList();
+  const v42 = [
+    ["0.0.0.0", 8],
+    // "this" network
+    ["10.0.0.0", 8],
+    // RFC 1918
+    ["100.64.0.0", 10],
+    // carrier-grade NAT
+    ["127.0.0.0", 8],
+    // loopback
+    ["169.254.0.0", 16],
+    // link-local, incl. cloud metadata at 169.254.169.254
+    ["172.16.0.0", 12],
+    // RFC 1918
+    ["192.0.0.0", 24],
+    // IETF protocol assignments
+    ["192.168.0.0", 16],
+    // RFC 1918
+    ["198.18.0.0", 15],
+    // benchmarking
+    ["224.0.0.0", 4],
+    // multicast
+    ["240.0.0.0", 4]
+    // reserved, incl. broadcast
+  ];
+  for (const [net, prefix] of v42) b.addSubnet(net, prefix, "ipv4");
+  b.addAddress("::", "ipv6");
+  b.addAddress("::1", "ipv6");
+  const v6 = [
+    ["64:ff9b::", 96],
+    // NAT64
+    ["2002::", 16],
+    // 6to4
+    ["fc00::", 7],
+    // unique local
+    ["fe80::", 10],
+    // link-local
+    ["fec0::", 10],
+    // site-local (deprecated, still routed on old gear)
+    ["ff00::", 8]
+    // multicast
+  ];
+  for (const [net, prefix] of v6) b.addSubnet(net, prefix, "ipv6");
+  return b;
+}
+function isPrivateAddress(ip) {
+  const bare = ip.startsWith("[") && ip.endsWith("]") ? ip.slice(1, -1) : ip;
+  const family = (0, import_node_net.isIP)(bare);
+  try {
+    if (family === 4) return PRIVATE_ADDRESSES.check(bare, "ipv4");
+    if (family === 6) return PRIVATE_ADDRESSES.check(bare, "ipv6");
+  } catch {
+  }
+  return true;
+}
+var defaultLookup = async (hostname) => {
+  const addresses = await (0, import_promises.lookup)(hostname, { all: true });
+  return addresses.map((a) => a.address);
+};
+function matchesDomain(host, domains) {
+  return domains.some((d) => {
+    const dom = d.trim().toLowerCase().replace(/^https?:\/\//, "").replace(/\/.*$/, "").replace(/^\*\./, "").replace(/\.$/, "");
+    return !!dom && (host === dom || host.endsWith("." + dom));
+  });
+}
+async function validateFetchUrl(raw, opts = {}) {
+  let url;
+  try {
+    url = new URL(raw);
+  } catch {
+    throw new Error(`Not a valid absolute URL: ${raw}`);
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new Error(`Only http(s) URLs can be fetched, got ${url.protocol}`);
+  }
+  if (url.username || url.password) {
+    throw new Error("URLs with embedded credentials are not fetched");
+  }
+  const host = url.hostname.replace(/\.$/, "").toLowerCase();
+  if (!host) throw new Error("URL has no host");
+  if (host === "localhost" || host.endsWith(".localhost")) {
+    throw new Error("Refusing to fetch a local address");
+  }
+  if (opts.allowedDomains?.length && !matchesDomain(host, opts.allowedDomains)) {
+    throw new Error(`${host} is not in the allowed domains`);
+  }
+  if (opts.blockedDomains?.length && matchesDomain(host, opts.blockedDomains)) {
+    throw new Error(`${host} is a blocked domain`);
+  }
+  const literal = host.startsWith("[") ? host.slice(1, -1) : host;
+  if ((0, import_node_net.isIP)(literal)) {
+    if (isPrivateAddress(literal)) {
+      throw new Error("Refusing to fetch a private or reserved address");
+    }
+    return url;
+  }
+  let addresses;
+  try {
+    addresses = await (opts.lookup ?? defaultLookup)(host);
+  } catch (err) {
+    throw new Error(
+      `Could not resolve ${host}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (!addresses.length) throw new Error(`Could not resolve ${host}`);
+  if (addresses.some(isPrivateAddress)) {
+    throw new Error(`Refusing to fetch ${host}: it resolves to a private or reserved address`);
+  }
+  return url;
+}
+async function fetchUrl(rawUrl, opts = {}) {
+  const maxCharacters = opts.maxCharacters ?? DEFAULT_MAX_CHARACTERS2;
+  const signals = [AbortSignal.timeout(opts.timeoutMs ?? DEFAULT_TIMEOUT_MS)];
+  if (opts.abortSignal) signals.push(opts.abortSignal);
+  const signal = AbortSignal.any(signals);
+  let url = await validateFetchUrl(rawUrl, opts);
+  let res;
+  for (let hop = 0; ; hop++) {
+    try {
+      res = await fetch(url, {
+        method: "GET",
+        redirect: "manual",
+        signal,
+        headers: { "user-agent": USER_AGENT, accept: ACCEPT }
+      });
+    } catch (err) {
+      throw new Error(`Could not connect to ${url.hostname}: ${describeTransportError(err)}`);
+    }
+    if (!isRedirect(res.status)) break;
+    const location = res.headers.get("location");
+    await discard(res);
+    if (!location) throw new Error(`Redirect (${res.status}) without a Location header`);
+    if (hop >= MAX_REDIRECTS) throw new Error(`Too many redirects (more than ${MAX_REDIRECTS})`);
+    let next;
+    try {
+      next = new URL(location, url).toString();
+    } catch {
+      throw new Error(`Redirect to an invalid URL: ${location}`);
+    }
+    url = await validateFetchUrl(next, opts);
+  }
+  if (!res.ok) {
+    await discard(res);
+    throw new Error(`HTTP ${res.status} fetching ${url.hostname}`);
+  }
+  const contentType = res.headers.get("content-type") ?? "";
+  const mediaType = contentType.split(";")[0].trim().toLowerCase() || null;
+  if (mediaType === "application/pdf") {
+    await discard(res);
+    throw new Error(
+      "PDF documents are not supported by this fetch backend (only Anthropic's native web_fetch reads PDFs)"
+    );
+  }
+  if (!isTextual(mediaType)) {
+    await discard(res);
+    throw new Error(`Unsupported content type: ${mediaType}`);
+  }
+  const { bytes, capped } = await readCapped(res, MAX_BODY_BYTES);
+  const raw = decode(bytes, contentType);
+  const isHtml = mediaType === "text/html" || mediaType === "application/xhtml+xml" || looksLikeHtml(raw);
+  const { title, text } = isHtml ? htmlToText(raw) : { title: null, text: raw.trim() };
+  const truncated = capped || text.length > maxCharacters;
+  return {
+    url: url.toString(),
+    title,
+    text: truncated ? text.slice(0, maxCharacters) : text,
+    mediaType,
+    retrievedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    truncated,
+    type: "web_fetch_result"
+  };
+}
+function describeTransportError(err) {
+  const e = err;
+  if (e?.name === "TimeoutError") return "timed out";
+  if (e?.name === "AbortError") return "aborted";
+  const cause = e?.cause;
+  if (cause?.message) return cause.code ? `${cause.message} (${cause.code})` : cause.message;
+  return e?.message ?? String(err);
+}
+function isRedirect(status) {
+  return status === 301 || status === 302 || status === 303 || status === 307 || status === 308;
+}
+async function discard(res) {
+  await res.body?.cancel().catch(() => {
+  });
+}
+function isTextual(mediaType) {
+  if (!mediaType) return true;
+  if (mediaType.startsWith("text/")) return true;
+  if (mediaType.endsWith("+json") || mediaType.endsWith("+xml")) return true;
+  return mediaType === "application/json" || mediaType === "application/xml" || mediaType === "application/xhtml+xml" || mediaType === "application/javascript";
+}
+async function readCapped(res, maxBytes) {
+  const body = res.body;
+  if (!body) return { bytes: new Uint8Array(await res.arrayBuffer()), capped: false };
+  const reader = body.getReader();
+  const chunks = [];
+  let total = 0;
+  let capped = false;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (!value) continue;
+    if (total + value.byteLength > maxBytes) {
+      chunks.push(value.subarray(0, maxBytes - total));
+      total = maxBytes;
+      capped = true;
+      await reader.cancel().catch(() => {
+      });
+      break;
+    }
+    chunks.push(value);
+    total += value.byteLength;
+  }
+  const out = new Uint8Array(total);
+  let offset = 0;
+  for (const c of chunks) {
+    out.set(c, offset);
+    offset += c.byteLength;
+  }
+  return { bytes: out, capped };
+}
+function decode(bytes, contentType) {
+  const charset = /charset=["']?([\w.:-]+)/i.exec(contentType)?.[1] ?? "utf-8";
+  try {
+    return new TextDecoder(charset).decode(bytes);
+  } catch {
+    return new TextDecoder("utf-8").decode(bytes);
+  }
+}
+function looksLikeHtml(s) {
+  return /^\s*(?:<!doctype\s+html|<html[\s>]|<head[\s>]|<body[\s>])/i.test(s.slice(0, 1024));
+}
+var NAMED_ENTITIES = {
+  nbsp: " ",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'",
+  mdash: "\u2014",
+  ndash: "\u2013",
+  hellip: "\u2026",
+  copy: "\xA9",
+  reg: "\xAE",
+  trade: "\u2122",
+  laquo: "\xAB",
+  raquo: "\xBB",
+  ldquo: "\u201C",
+  rdquo: "\u201D",
+  lsquo: "\u2018",
+  rsquo: "\u2019",
+  bull: "\u2022",
+  middot: "\xB7",
+  times: "\xD7",
+  deg: "\xB0"
+};
+function codePoint(cp, fallback) {
+  if (!Number.isFinite(cp) || cp <= 0 || cp > 1114111 || cp >= 55296 && cp <= 57343) {
+    return fallback;
+  }
+  return String.fromCodePoint(cp);
+}
+function decodeEntities(s) {
+  return s.replace(/&#x([0-9a-f]{1,6});/gi, (m, hex) => codePoint(parseInt(hex, 16), m)).replace(/&#(\d{1,7});/g, (m, dec) => codePoint(parseInt(dec, 10), m)).replace(/&([a-z]+);/gi, (m, name19) => NAMED_ENTITIES[name19.toLowerCase()] ?? m).replace(/&amp;/g, "&");
+}
+var BLOCK_TAGS = "p|div|section|article|header|footer|main|aside|nav|h[1-6]|ul|ol|tr|table|thead|tbody|tfoot|blockquote|pre|hr|dd|dt|dl|figure|figcaption|form|fieldset|address|details|summary";
+function htmlToText(html) {
+  const titleMatch = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+  const title = titleMatch ? decodeEntities(titleMatch[1]).replace(/\s+/g, " ").trim() || null : null;
+  const stripped = html.replace(/<!--[\s\S]*?-->/g, " ").replace(/<(script|style|noscript|svg|template|head)\b[\s\S]*?<\/\1\s*>/gi, " ").replace(/<br\s*\/?>/gi, "\n").replace(/<li\b[^>]*>/gi, "\n- ").replace(new RegExp(`<\\/?(?:${BLOCK_TAGS})\\b[^>]*>`, "gi"), "\n").replace(/<[^>]+>/g, " ");
+  const text = decodeEntities(stripped).replace(/[ \t\r\f\v ]+/g, " ").replace(/ ?\n ?/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+  return { title, text };
+}
+function createWebFetch(opts) {
+  const results = [];
+  const backend = opts.backend ?? resolveFetchBackend(opts.provider);
+  const maxUses = opts.maxUses ?? DEFAULT_MAX_USES2;
+  const maxCharacters = opts.maxCharacters ?? (opts.maxContentTokens ? opts.maxContentTokens * CHARS_PER_TOKEN : DEFAULT_MAX_CHARACTERS2);
+  const maxContentTokens = opts.maxContentTokens ?? (opts.maxCharacters ? Math.ceil(opts.maxCharacters / CHARS_PER_TOKEN) : void 0);
+  if (backend === "anthropic") {
+    const apiKey = normalizeApiKey(opts.apiKey) || normalizeApiKey(process.env.ANTHROPIC_API_KEY);
+    if (!apiKey) {
+      return emptyFetchHandle(results);
+    }
+    const baseURL = getGatewayBaseURL("anthropic");
+    const anthropic2 = createAnthropic({ apiKey, ...baseURL && { baseURL } });
+    return {
+      tool: anthropic2.tools.webFetch_20250910({
+        maxUses,
+        ...maxContentTokens ? { maxContentTokens } : {},
+        ...opts.allowedDomains?.length ? { allowedDomains: opts.allowedDomains } : {},
+        ...opts.blockedDomains?.length ? { blockedDomains: opts.blockedDomains } : {}
+      }),
+      backend,
+      native: true,
+      results,
+      capture: (stepContent) => captureNativeFetchResults(stepContent, results)
+    };
+  }
+  let uses = 0;
+  return {
+    tool: (0, import_ai3.tool)({
+      description: "Fetch a specific web page by URL and return its text. HTML is converted to plain text; JSON and plain text come back as-is. Use this to read a page whose address you already have \u2014 one the user gave you, or one returned by web_search. It is not a search engine: it needs a full http(s) URL. PDFs and other binary content are not supported.",
+      inputSchema: import_zod2.z.object({
+        url: import_zod2.z.string().describe("The absolute http(s) URL to fetch.")
+      }),
+      execute: async ({ url }, ctx) => {
+        if (uses >= maxUses) {
+          return {
+            error: `web_fetch budget exhausted (${maxUses} calls). Work with what you have.`
+          };
+        }
+        uses++;
+        try {
+          const page = await fetchUrl(url, {
+            maxCharacters,
+            allowedDomains: opts.allowedDomains,
+            blockedDomains: opts.blockedDomains,
+            abortSignal: ctx?.abortSignal ?? opts.abortSignal,
+            lookup: opts.lookup
+          });
+          results.push(page);
+          return page;
+        } catch (err) {
+          return {
+            error: `Fetch failed: ${err instanceof Error ? err.message : String(err)}`
+          };
+        }
+      }
+    }),
+    backend,
+    native: false,
+    results,
+    // HTTP results are appended by `execute` above; walking the step
+    // would double-count them.
+    capture: () => {
+    }
+  };
+}
+function emptyFetchHandle(results) {
+  return {
+    tool: void 0,
+    backend: void 0,
+    native: false,
+    results,
+    capture: () => {
+    }
+  };
+}
+function captureNativeFetchResults(stepContent, target) {
+  if (!Array.isArray(stepContent)) return;
+  for (const content of stepContent) {
+    if (content?.type !== "tool-result") continue;
+    if (content?.toolName !== WEB_FETCH_TOOL_NAME) continue;
+    const body = content.output ?? content.result ?? null;
+    if (!body || typeof body !== "object") continue;
+    if (body.type !== "web_fetch_result" || typeof body.url !== "string") continue;
+    const doc = body.content ?? {};
+    const source = doc.source ?? {};
+    target.push({
+      url: body.url,
+      title: doc.title ?? null,
+      ...source.type === "text" && typeof source.data === "string" ? { text: source.data } : {},
+      mediaType: source.mediaType ?? source.media_type ?? null,
+      retrievedAt: body.retrievedAt ?? body.retrieved_at ?? null,
+      type: "web_fetch_result"
+    });
+  }
+}
+
 // src/tools.ts
 function getProviderTool(provider, apiKey, toolName) {
   if (toolName === "webSearch") {
     return createWebSearch({ provider, apiKey }).tool;
   }
+  if (toolName === "webFetch") {
+    return createWebFetch({ provider, apiKey }).tool;
+  }
   switch (provider) {
     case "anthropic":
       return getAnthropicTool(apiKey, toolName);
@@ -24165,16 +24567,20 @@ function consoleLogger(name19) {
   OUTRO,
   PROVIDERS,
   SYSTEM,
+  WEB_FETCH_TOOL_NAME,
   WEB_SEARCH_TOOL_NAME,
   addUsage,
   callGenerateObject,
   callGenerateText,
   callModel,
+  captureNativeFetchResults,
   captureNativeResults,
   computeSessionCost,
   consoleLogger,
+  createWebFetch,
   createWebSearch,
   emptyUsage,
+  fetchUrl,
   gatewayEnvForProviders,
   gatewayUrlFor,
   gatewayUrlForModel,
@@ -24191,15 +24597,19 @@ function consoleLogger(name19) {
   getTokenPricing,
   hasApiKeyForProvider,
   hasSearchApiKey,
+  htmlToText,
+  isPrivateAddress,
   linkifyCitations,
   loadModelPricing,
   normalizeApiKey,
   normalizeCallerBaseURL,
   normalizeUsage,
+  resolveFetchBackend,
   resolveLLMConfig,
   resolveSearchBackend,
   searchWeb,
   stripCitations,
+  validateFetchUrl,
   withLegacyUsage,
   withProviderCacheUsage
 });