@yourgpt/copilot-sdk 2.0.1 → 2.0.2-beta.2

package/dist/chunk-TXLIY7GF.cjs

@@ -0,0 +1,132 @@
+'use strict';
+
+// src/core/tools/webSearch/providers/anthropic.ts
+var ANTHROPIC_API_URL = "https://api.anthropic.com/v1/messages";
+function validateAnthropicConfig(config) {
+  if (!config.apiKey) {
+    throw new Error(
+      "Anthropic API key is required for native web search. Pass apiKey or set ANTHROPIC_API_KEY environment variable."
+    );
+  }
+}
+async function searchAnthropic(params, config) {
+  validateAnthropicConfig(config);
+  const startTime = Date.now();
+  const apiKey = config.apiKey || process.env.ANTHROPIC_API_KEY;
+  const webSearchTool = {
+    type: "web_search_20250305",
+    // Use stable version
+    name: "web_search",
+    max_uses: config.maxResults ?? 5
+  };
+  if (config.includeDomains?.length) {
+    webSearchTool.allowed_domains = config.includeDomains;
+  }
+  if (config.excludeDomains?.length) {
+    webSearchTool.blocked_domains = config.excludeDomains;
+  }
+  if (config.country) {
+    webSearchTool.user_location = {
+      type: "approximate",
+      country: config.country.toUpperCase()
+    };
+  }
+  const response = await fetch(ANTHROPIC_API_URL, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": apiKey,
+      "anthropic-version": "2023-06-01"
+    },
+    body: JSON.stringify({
+      model: "claude-sonnet-4-20250514",
+      // Use Sonnet 4 for balance of speed/quality
+      max_tokens: 2048,
+      tools: [webSearchTool],
+      messages: [
+        {
+          role: "user",
+          content: params.query
+        }
+      ]
+    }),
+    signal: config.timeout ? AbortSignal.timeout(config.timeout) : void 0
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "Unknown error");
+    console.error(
+      "[Anthropic Native Search] API error:",
+      response.status,
+      errorText
+    );
+    throw new Error(
+      `Anthropic Messages API error (${response.status}): ${errorText}`
+    );
+  }
+  const data = await response.json();
+  const searchTime = Date.now() - startTime;
+  let outputText = "";
+  const sources = [];
+  const searchResults = [];
+  if (data.content && Array.isArray(data.content)) {
+    for (const block of data.content) {
+      if (block.type === "text" && block.text) {
+        outputText += block.text;
+        if (block.citations && Array.isArray(block.citations)) {
+          for (const citation of block.citations) {
+            if (citation.url && !sources.find((s) => s.url === citation.url)) {
+              sources.push({
+                url: citation.url,
+                title: citation.title || extractDomain(citation.url),
+                cited_text: citation.cited_text
+              });
+            }
+          }
+        }
+      }
+      if (block.type === "web_search_tool_result" && block.content) {
+        for (const result of block.content) {
+          if (result.type === "web_search_result" && result.url) {
+            searchResults.push({
+              url: result.url,
+              title: result.title || extractDomain(result.url),
+              page_age: result.page_age
+            });
+          }
+        }
+      }
+    }
+  }
+  const finalSources = sources.length > 0 ? sources : searchResults;
+  return {
+    query: params.query,
+    answer: outputText,
+    results: finalSources.slice(0, params.maxResults ?? config.maxResults ?? 5).map((source, i) => ({
+      title: source.title,
+      url: source.url,
+      content: "cited_text" in source ? source.cited_text || "" : "",
+      score: 1 - i * 0.1,
+      domain: extractDomain(source.url)
+    })),
+    provider: "anthropic",
+    totalResults: finalSources.length,
+    searchTime
+  };
+}
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname.replace("www.", "");
+  } catch {
+    return url;
+  }
+}
+var anthropicProvider = {
+  search: searchAnthropic,
+  validateConfig: validateAnthropicConfig
+};
+
+exports.anthropicProvider = anthropicProvider;
+exports.searchAnthropic = searchAnthropic;
+exports.validateAnthropicConfig = validateAnthropicConfig;
+//# sourceMappingURL=chunk-TXLIY7GF.cjs.map
+//# sourceMappingURL=chunk-TXLIY7GF.cjs.map

package/dist/chunk-TXLIY7GF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/providers/anthropic.ts"],"names":[],"mappings":"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","file":"chunk-TXLIY7GF.cjs","sourcesContent":["/**\n * Anthropic Web Search Provider\n *\n * Uses Anthropic's built-in web_search tool via the Messages API.\n * Returns reliable citations with cited_text, url, and title.\n *\n * @see https://docs.anthropic.com/en/docs/build-with-claude/tool-use/web-search-tool\n */\n\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  WebSearchProviderInterface,\n} from \"../types\";\n\nconst ANTHROPIC_API_URL = \"https://api.anthropic.com/v1/messages\";\n\n/**\n * Validate Anthropic native search configuration\n */\nexport function validateAnthropicConfig(config: WebSearchConfig): void {\n  if (!config.apiKey) {\n    throw new Error(\n      \"Anthropic API key is required for native web search. \" +\n        \"Pass apiKey or set ANTHROPIC_API_KEY environment variable.\",\n    );\n  }\n}\n\n// Type definitions for Anthropic response\ninterface AnthropicWebSearchResult {\n  type: \"web_search_result\";\n  url: string;\n  title: string;\n  encrypted_content?: string;\n  page_age?: string;\n}\n\ninterface AnthropicCitation {\n  type: \"web_search_result_location\";\n  url: string;\n  title: string;\n  encrypted_index?: string;\n  cited_text?: string;\n}\n\ninterface AnthropicContentBlock {\n  type: string;\n  text?: string;\n  tool_use_id?: string;\n  content?: AnthropicWebSearchResult[];\n  citations?: AnthropicCitation[];\n}\n\ninterface AnthropicMessagesResponse {\n  id: string;\n  content: AnthropicContentBlock[];\n  usage?: {\n    input_tokens: number;\n    output_tokens: number;\n    server_tool_use?: {\n      web_search_requests?: number;\n    };\n  };\n}\n\n/**\n * Search using Anthropic's native web_search tool\n */\nexport async function searchAnthropic(\n  params: WebSearchParams,\n  config: WebSearchConfig,\n): Promise<WebSearchResponse> {\n  validateAnthropicConfig(config);\n\n  const startTime = Date.now();\n  const apiKey = config.apiKey || process.env.ANTHROPIC_API_KEY;\n\n  // Build web search tool configuration\n  const webSearchTool: Record<string, unknown> = {\n    type: \"web_search_20250305\", // Use stable version\n    name: \"web_search\",\n    max_uses: config.maxResults ?? 5,\n  };\n\n  // Add domain filtering if provided\n  if (config.includeDomains?.length) {\n    webSearchTool.allowed_domains = config.includeDomains;\n  }\n  if (config.excludeDomains?.length) {\n    webSearchTool.blocked_domains = config.excludeDomains;\n  }\n\n  // Add user location if country is set\n  if (config.country) {\n    webSearchTool.user_location = {\n      type: \"approximate\",\n      country: config.country.toUpperCase(),\n    };\n  }\n\n  // Call Anthropic Messages API\n  const response = await fetch(ANTHROPIC_API_URL, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey!,\n      \"anthropic-version\": \"2023-06-01\",\n    },\n    body: JSON.stringify({\n      model: \"claude-sonnet-4-20250514\", // Use Sonnet 4 for balance of speed/quality\n      max_tokens: 2048,\n      tools: [webSearchTool],\n      messages: [\n        {\n          role: \"user\",\n          content: params.query,\n        },\n      ],\n    }),\n    signal: config.timeout ? AbortSignal.timeout(config.timeout) : undefined,\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => \"Unknown error\");\n    console.error(\n      \"[Anthropic Native Search] API error:\",\n      response.status,\n      errorText,\n    );\n    throw new Error(\n      `Anthropic Messages API error (${response.status}): ${errorText}`,\n    );\n  }\n\n  const data: AnthropicMessagesResponse = await response.json();\n  const searchTime = Date.now() - startTime;\n\n  // Extract answer text and citations\n  let outputText = \"\";\n  const sources: Array<{ url: string; title: string; cited_text?: string }> =\n    [];\n  const searchResults: Array<{\n    url: string;\n    title: string;\n    page_age?: string;\n  }> = [];\n\n  if (data.content && Array.isArray(data.content)) {\n    for (const block of data.content) {\n      // Extract text blocks\n      if (block.type === \"text\" && block.text) {\n        outputText += block.text;\n\n        // Extract citations from text blocks\n        if (block.citations && Array.isArray(block.citations)) {\n          for (const citation of block.citations) {\n            if (citation.url && !sources.find((s) => s.url === citation.url)) {\n              sources.push({\n                url: citation.url,\n                title: citation.title || extractDomain(citation.url),\n                cited_text: citation.cited_text,\n              });\n            }\n          }\n        }\n      }\n\n      // Extract search results from web_search_tool_result\n      if (block.type === \"web_search_tool_result\" && block.content) {\n        for (const result of block.content) {\n          if (result.type === \"web_search_result\" && result.url) {\n            searchResults.push({\n              url: result.url,\n              title: result.title || extractDomain(result.url),\n              page_age: result.page_age,\n            });\n          }\n        }\n      }\n    }\n  }\n\n  // Prefer citations (have cited_text) over raw search results\n  const finalSources = sources.length > 0 ? sources : searchResults;\n\n  return {\n    query: params.query,\n    answer: outputText,\n    results: finalSources\n      .slice(0, params.maxResults ?? config.maxResults ?? 5)\n      .map((source, i) => ({\n        title: source.title,\n        url: source.url,\n        content: \"cited_text\" in source ? source.cited_text || \"\" : \"\",\n        score: 1 - i * 0.1,\n        domain: extractDomain(source.url),\n      })),\n    provider: \"anthropic\",\n    totalResults: finalSources.length,\n    searchTime,\n  };\n}\n\n/**\n * Extract domain from URL\n */\nfunction extractDomain(url: string): string {\n  try {\n    return new URL(url).hostname.replace(\"www.\", \"\");\n  } catch {\n    return url;\n  }\n}\n\n/**\n * Anthropic native search provider implementation\n */\nexport const anthropicProvider: WebSearchProviderInterface = {\n  search: searchAnthropic,\n  validateConfig: validateAnthropicConfig,\n};\n"]}

package/dist/chunk-UIWFYMAO.cjs

@@ -0,0 +1,82 @@
+'use strict';
+
+var chunkCEKAYA2Q_cjs = require('./chunk-CEKAYA2Q.cjs');
+var chunkASV6JLYG_cjs = require('./chunk-ASV6JLYG.cjs');
+
+// src/core/tools/builtin/webSearch.ts
+var webSearchTool = chunkCEKAYA2Q_cjs.tool({
+  description: `Search the web for current information. Use this when the user asks about:
+- Recent events, news, or current affairs
+- Real-time data (prices, weather, stocks, sports scores)
+- Information that might have changed after your training cutoff
+- Facts that need verification with current sources
+- Research topics that require up-to-date information`,
+  location: "server",
+  // Runs on server to protect API keys
+  title: (args) => `Searching for "${args.query}"`,
+  executingTitle: (args) => `Searching the web for "${args.query}"...`,
+  completedTitle: (args) => `Found results for "${args.query}"`,
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: {
+        type: "string",
+        description: "The search query to find relevant information"
+      },
+      maxResults: {
+        type: "number",
+        description: "Maximum number of results to return (default: 5, max: 10)",
+        minimum: 1,
+        maximum: 10
+      },
+      searchDepth: {
+        type: "string",
+        enum: ["basic", "advanced"],
+        description: "Search depth - 'advanced' provides more thorough results but may be slower"
+      }
+    },
+    required: ["query"]
+  },
+  needsApproval: false,
+  // No user data exposed, just searching
+  // Control what AI sees from results
+  aiResponseMode: "full",
+  aiContext: (result, args) => {
+    if (!result.success) return `Search failed: ${result.error}`;
+    const data = result.data;
+    return chunkASV6JLYG_cjs.formatSearchResultsForAI(data);
+  }
+});
+function createWebSearchTool(config) {
+  return {
+    name: "web_search",
+    ...webSearchTool,
+    handler: async (params) => {
+      try {
+        const response = await chunkASV6JLYG_cjs.executeWebSearch(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5,
+            searchDepth: params.searchDepth ?? config.searchDepth ?? "basic"
+          },
+          config
+        );
+        const aiContext = chunkASV6JLYG_cjs.formatSearchResultsForAI(response);
+        return {
+          success: true,
+          message: chunkASV6JLYG_cjs.summarizeSearchResults(response),
+          data: response,
+          _aiContext: aiContext
+        };
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Web search failed";
+        return chunkCEKAYA2Q_cjs.failure(errorMessage);
+      }
+    }
+  };
+}
+
+exports.createWebSearchTool = createWebSearchTool;
+exports.webSearchTool = webSearchTool;
+//# sourceMappingURL=chunk-UIWFYMAO.cjs.map
+//# sourceMappingURL=chunk-UIWFYMAO.cjs.map

package/dist/chunk-UIWFYMAO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/builtin/webSearch.ts"],"names":["tool","formatSearchResultsForAI","executeWebSearch","summarizeSearchResults","failure"],"mappings":";;;;;;AAoDO,IAAM,gBAAgBA,sBAAA,CAAsB;AAAA,EACjD,WAAA,EAAa,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qDAAA,CAAA;AAAA,EAOb,QAAA,EAAU,QAAA;AAAA;AAAA,EAEV,KAAA,EAAO,CAAC,IAAA,KAAS,CAAA,eAAA,EAAkB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,EAC7C,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,uBAAA,EAA0B,KAAK,KAAK,CAAA,IAAA,CAAA;AAAA,EAC9D,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,mBAAA,EAAsB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,EAE1D,WAAA,EAAa;AAAA,IACX,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,KAAA,EAAO;AAAA,QACL,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EACE,2DAAA;AAAA,QACF,OAAA,EAAS,CAAA;AAAA,QACT,OAAA,EAAS;AAAA,OACX;AAAA,MACA,WAAA,EAAa;AAAA,QACX,IAAA,EAAM,QAAA;AAAA,QACN,IAAA,EAAM,CAAC,OAAA,EAAS,UAAU,CAAA;AAAA,QAC1B,WAAA,EACE;AAAA;AACJ,KACF;AAAA,IACA,QAAA,EAAU,CAAC,OAAO;AAAA,GACpB;AAAA,EAEA,aAAA,EAAe,KAAA;AAAA;AAAA;AAAA,EAGf,cAAA,EAAgB,MAAA;AAAA,EAChB,SAAA,EAAW,CAAC,MAAA,EAAQ,IAAA,KAAS;AAC3B,IAAA,IAAI,CAAC,MAAA,CAAO,OAAA,EAAS,OAAO,CAAA,eAAA,EAAkB,OAAO,KAAK,CAAA,CAAA;AAC1D,IAAA,MAAM,OAAO,MAAA,CAAO,IAAA;AACpB,IAAA,OAAOC,2CAAyB,IAAI,CAAA;AAAA,EACtC;AACF,CAAC;AAoEM,SAAS,oBACd,MAAA,EACiC;AACjC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IACN,GAAG,aAAA;AAAA,IACH,OAAA,EAAS,OAAO,MAAA,KAA4B;AAC1C,MAAA,IAAI;AACF,QAAA,MAAM,WAAW,MAAMC,kCAAA;AAAA,UACrB;AAAA,YACE,OAAO,MAAA,CAAO,KAAA;AAAA,YACd,UAAA,EAAY,MAAA,CAAO,UAAA,IAAc,MAAA,CAAO,UAAA,IAAc,CAAA;AAAA,YACtD,WAAA,EAAa,MAAA,CAAO,WAAA,IAAe,MAAA,CAAO,WAAA,IAAe;AAAA,WAC3D;AAAA,UACA;AAAA,SACF;AAGA,QAAA,MAAM,SAAA,GAAYD,2CAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAASE,yCAAuB,QAAQ,CAAA;AAAA,UACxC,IAAA,EAAM,QAAA;AAAA,UACN,UAAA,EAAY;AAAA,SACd;AAAA,MACF,SAAS,KAAA,EAAO;AACd,QAAA,MAAM,YAAA,GACJ,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,mBAAA;AAC3C,QAAA,OAAOC,0BAAQ,YAAY,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-UIWFYMAO.cjs","sourcesContent":["/**\n * Built-in Web Search Tool\n *\n * A pre-configured tool for searching the web with multiple provider support.\n * Runs on the server to protect API keys.\n *\n * Supports tree-shaking - import providers directly for smaller bundles.\n *\n * @example\n * ```typescript\n * // Option 1: String provider (lazy loaded at runtime)\n * import { createWebSearchTool } from '@yourgpt/copilot-sdk';\n * const webSearch = createWebSearchTool({\n *   provider: 'tavily',\n *   apiKey: process.env.TAVILY_API_KEY,\n * });\n *\n * // Option 2: Direct provider import (best for tree-shaking)\n * import { createWebSearchTool, tavilyProvider } from '@yourgpt/copilot-sdk';\n * const webSearch = createWebSearchTool({\n *   provider: tavilyProvider,\n *   apiKey: process.env.TAVILY_API_KEY,\n * });\n *\n * // Add to your runtime\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n */\n\nimport { tool, success, failure } from \"../../types/tools\";\nimport type { ToolDefinition } from \"../../types/tools\";\nimport {\n  executeWebSearch,\n  formatSearchResultsForAI,\n  summarizeSearchResults,\n  type WebSearchConfigExtended,\n} from \"../webSearch\";\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  WebSearchProviderInterface,\n} from \"../webSearch/types\";\n\n/**\n * Base web search tool definition\n *\n * This is the core tool definition. Use `createWebSearchTool()` to create\n * a configured instance with your provider settings.\n */\nexport const webSearchTool = tool<WebSearchParams>({\n  description: `Search the web for current information. Use this when the user asks about:\n- Recent events, news, or current affairs\n- Real-time data (prices, weather, stocks, sports scores)\n- Information that might have changed after your training cutoff\n- Facts that need verification with current sources\n- Research topics that require up-to-date information`,\n\n  location: \"server\", // Runs on server to protect API keys\n\n  title: (args) => `Searching for \"${args.query}\"`,\n  executingTitle: (args) => `Searching the web for \"${args.query}\"...`,\n  completedTitle: (args) => `Found results for \"${args.query}\"`,\n\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      query: {\n        type: \"string\",\n        description: \"The search query to find relevant information\",\n      },\n      maxResults: {\n        type: \"number\",\n        description:\n          \"Maximum number of results to return (default: 5, max: 10)\",\n        minimum: 1,\n        maximum: 10,\n      },\n      searchDepth: {\n        type: \"string\",\n        enum: [\"basic\", \"advanced\"],\n        description:\n          \"Search depth - 'advanced' provides more thorough results but may be slower\",\n      },\n    },\n    required: [\"query\"],\n  },\n\n  needsApproval: false, // No user data exposed, just searching\n\n  // Control what AI sees from results\n  aiResponseMode: \"full\",\n  aiContext: (result, args) => {\n    if (!result.success) return `Search failed: ${result.error}`;\n    const data = result.data as WebSearchResponse;\n    return formatSearchResultsForAI(data);\n  },\n});\n\n/**\n * Create a configured web search tool\n *\n * Supports both string provider names (lazy loaded) and direct provider imports (tree-shakeable).\n *\n * @param config - Web search configuration including provider and API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * // ===== BEST FOR TREE-SHAKING: Direct provider import =====\n * import { createWebSearchTool, openaiProvider } from '@yourgpt/copilot-sdk/core';\n *\n * const webSearch = createWebSearchTool({\n *   provider: openaiProvider, // Only this provider in bundle\n *   apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * // ===== STRING PROVIDERS (Lazy loaded at runtime) =====\n *\n * // OpenAI (uses your OpenAI API key)\n * const webSearch = createWebSearchTool({\n *   provider: 'openai',\n *   apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * // Google (uses your Google/Gemini API key)\n * const webSearch = createWebSearchTool({\n *   provider: 'google',\n *   apiKey: process.env.GOOGLE_API_KEY,\n * });\n *\n * // Tavily (AI-optimized search with answer generation)\n * const webSearch = createWebSearchTool({\n *   provider: 'tavily',\n *   apiKey: process.env.TAVILY_API_KEY,\n *   includeAnswer: true,\n *   maxResults: 5,\n * });\n *\n * // Serper (Google results)\n * const webSearch = createWebSearchTool({\n *   provider: 'serper',\n *   apiKey: process.env.SERPER_API_KEY,\n * });\n *\n * // Brave Search (privacy-focused)\n * const webSearch = createWebSearchTool({\n *   provider: 'brave',\n *   apiKey: process.env.BRAVE_API_KEY,\n * });\n *\n * // Self-hosted SearXNG (no API key needed)\n * const webSearch = createWebSearchTool({\n *   provider: 'searxng',\n *   baseUrl: 'https://your-searxng-instance.com',\n * });\n *\n * // Exa (AI-optimized semantic search)\n * const webSearch = createWebSearchTool({\n *   provider: 'exa',\n *   apiKey: process.env.EXA_API_KEY,\n *   searchDepth: 'advanced',\n * });\n * ```\n */\nexport function createWebSearchTool(\n  config: WebSearchConfigExtended,\n): ToolDefinition<WebSearchParams> {\n  return {\n    name: \"web_search\",\n    ...webSearchTool,\n    handler: async (params: WebSearchParams) => {\n      try {\n        const response = await executeWebSearch(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n            searchDepth: params.searchDepth ?? config.searchDepth ?? \"basic\",\n          },\n          config,\n        );\n\n        // Build the AI context string\n        const aiContext = formatSearchResultsForAI(response);\n\n        return {\n          success: true,\n          message: summarizeSearchResults(response),\n          data: response,\n          _aiContext: aiContext,\n        };\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error ? error.message : \"Web search failed\";\n        return failure(errorMessage);\n      }\n    },\n  };\n}\n\n/**\n * Utility types for web search tool configuration\n */\nexport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  WebSearchProviderInterface,\n};\nexport type { WebSearchConfigExtended };\n"]}

package/dist/{chunk-4PRWNAXQ.cjs → chunk-UOWLKFXK.cjs}

@@ -1,5 +1,8 @@
 'use strict';
 
+var chunkUIWFYMAO_cjs = require('./chunk-UIWFYMAO.cjs');
+var chunkCEKAYA2Q_cjs = require('./chunk-CEKAYA2Q.cjs');
+
 // src/core/tools/screenshot.ts
 var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
 var DEFAULT_OPTIONS = {
@@ -1032,71 +1035,8 @@ function createCustomDetector(customKeywords) {
   };
 }
 
-// src/core/types/tools.ts
-function tool(config) {
-  return {
-    description: config.description,
-    location: config.location ?? "client",
-    // Display configuration
-    title: config.title,
-    executingTitle: config.executingTitle,
-    completedTitle: config.completedTitle,
-    // Schema and handlers
-    inputSchema: config.inputSchema ?? {
-      type: "object",
-      properties: {},
-      required: []
-    },
-    handler: config.handler,
-    render: config.render,
-    available: config.available,
-    needsApproval: config.needsApproval,
-    approvalMessage: config.approvalMessage,
-    aiResponseMode: config.aiResponseMode,
-    aiContext: config.aiContext
-  };
-}
-function toolToOpenAIFormat(tool2) {
-  return {
-    type: "function",
-    function: {
-      name: tool2.name,
-      description: tool2.description,
-      parameters: tool2.inputSchema
-    }
-  };
-}
-function toolToAnthropicFormat(tool2) {
-  return {
-    name: tool2.name,
-    description: tool2.description,
-    input_schema: tool2.inputSchema
-  };
-}
-function createToolResult(toolCallId, response) {
-  return {
-    toolCallId,
-    content: JSON.stringify(response),
-    success: response.success,
-    error: response.error
-  };
-}
-function success(data, message) {
-  return {
-    success: true,
-    data,
-    message
-  };
-}
-function failure(error) {
-  return {
-    success: false,
-    error
-  };
-}
-
 // src/core/tools/builtin/screenshot.ts
-var screenshotTool = tool({
+var screenshotTool = chunkCEKAYA2Q_cjs.tool({
   description: "Capture a screenshot of the user's current screen/viewport. Use this when the user asks you to look at their screen, see what they're seeing, help with visual issues, or debug UI problems.",
   location: "client",
   inputSchema: {
@@ -1115,7 +1055,7 @@ var screenshotTool = tool({
   approvalMessage: "Allow AI to capture a screenshot of your screen?",
   handler: async (params) => {
     if (!isScreenshotSupported()) {
-      return failure("Screenshot capture is not supported in this environment");
+      return chunkCEKAYA2Q_cjs.failure("Screenshot capture is not supported in this environment");
     }
     try {
       const options = {};
@@ -1141,20 +1081,20 @@ var screenshotTool = tool({
         }
       };
     } catch (error) {
-      return failure(
+      return chunkCEKAYA2Q_cjs.failure(
         error instanceof Error ? error.message : "Screenshot capture failed"
       );
     }
   }
 });
 function createScreenshotTool(options) {
-  return tool({
+  return chunkCEKAYA2Q_cjs.tool({
     ...screenshotTool,
     needsApproval: options?.needsApproval ?? true,
     approvalMessage: options?.approvalMessage ?? "Allow AI to capture a screenshot of your screen?",
     handler: async (params) => {
       if (!isScreenshotSupported()) {
-        return failure(
+        return chunkCEKAYA2Q_cjs.failure(
           "Screenshot capture is not supported in this environment"
         );
       }
@@ -1180,7 +1120,7 @@ function createScreenshotTool(options) {
           }
         };
       } catch (error) {
-        return failure(
+        return chunkCEKAYA2Q_cjs.failure(
           error instanceof Error ? error.message : "Screenshot capture failed"
         );
       }
@@ -1193,7 +1133,7 @@ var isBrowser4 = typeof window !== "undefined" && typeof console !== "undefined"
 if (isBrowser4 && !isConsoleCaptureActive()) {
   startConsoleCapture();
 }
-var consoleLogsTool = tool({
+var consoleLogsTool = chunkCEKAYA2Q_cjs.tool({
   description: "Get recent console logs from the browser. Use this when debugging JavaScript errors, checking for warnings, or understanding what's happening in the application.",
   location: "client",
   inputSchema: {
@@ -1226,7 +1166,7 @@ var consoleLogsTool = tool({
         types: params.types
       });
       const formattedLogs = formatLogsForAI(logs.logs);
-      return success(
+      return chunkCEKAYA2Q_cjs.success(
         {
           logs: formattedLogs,
           count: logs.logs.length,
@@ -1235,14 +1175,14 @@ var consoleLogsTool = tool({
         `Retrieved ${logs.logs.length} console logs`
       );
     } catch (error) {
-      return failure(
+      return chunkCEKAYA2Q_cjs.failure(
         error instanceof Error ? error.message : "Failed to get console logs"
       );
     }
   }
 });
 function createConsoleLogsTool(options) {
-  return tool({
+  return chunkCEKAYA2Q_cjs.tool({
     ...consoleLogsTool,
     needsApproval: options?.needsApproval ?? true,
     approvalMessage: options?.approvalMessage ?? "Allow AI to access browser console logs?",
@@ -1256,7 +1196,7 @@ function createConsoleLogsTool(options) {
           types: params.types
         });
         const formattedLogs = formatLogsForAI(logs.logs);
-        return success(
+        return chunkCEKAYA2Q_cjs.success(
           {
             logs: formattedLogs,
             count: logs.logs.length,
@@ -1265,7 +1205,7 @@ function createConsoleLogsTool(options) {
           `Retrieved ${logs.logs.length} console logs`
         );
       } catch (error) {
-        return failure(
+        return chunkCEKAYA2Q_cjs.failure(
           error instanceof Error ? error.message : "Failed to get console logs"
         );
       }
@@ -1274,7 +1214,7 @@ function createConsoleLogsTool(options) {
 }
 
 // src/core/tools/builtin/network.ts
-var networkRequestsTool = tool({
+var networkRequestsTool = chunkCEKAYA2Q_cjs.tool({
   description: "Get recent network requests from the browser. Use this when debugging API calls, checking for failed requests, analyzing network activity, or troubleshooting connectivity issues.",
   location: "client",
   inputSchema: {
@@ -1303,7 +1243,7 @@ var networkRequestsTool = tool({
         failedOnly: params.failedOnly
       });
       const formattedRequests = formatRequestsForAI(requests.requests);
-      return success(
+      return chunkCEKAYA2Q_cjs.success(
         {
           requests: formattedRequests,
           count: requests.requests.length,
@@ -1312,14 +1252,14 @@ var networkRequestsTool = tool({
         `Retrieved ${requests.requests.length} network requests`
       );
     } catch (error) {
-      return failure(
+      return chunkCEKAYA2Q_cjs.failure(
         error instanceof Error ? error.message : "Failed to get network requests"
       );
     }
   }
 });
 function createNetworkRequestsTool(options) {
-  return tool({
+  return chunkCEKAYA2Q_cjs.tool({
     ...networkRequestsTool,
     needsApproval: options?.needsApproval ?? true,
     approvalMessage: options?.approvalMessage ?? "Allow AI to access network request history?",
@@ -1333,7 +1273,7 @@ function createNetworkRequestsTool(options) {
           failedOnly: params.failedOnly
         });
         const formattedRequests = formatRequestsForAI(requests.requests);
-        return success(
+        return chunkCEKAYA2Q_cjs.success(
           {
             requests: formattedRequests,
             count: requests.requests.length,
@@ -1342,7 +1282,7 @@ function createNetworkRequestsTool(options) {
           `Retrieved ${requests.requests.length} network requests`
         );
       } catch (error) {
-        return failure(
+        return chunkCEKAYA2Q_cjs.failure(
           error instanceof Error ? error.message : "Failed to get network requests"
         );
       }
@@ -1363,6 +1303,10 @@ var builtinTools = {
   get_network_requests: {
     name: "get_network_requests",
     ...networkRequestsTool
+  },
+  web_search: {
+    name: "web_search",
+    ...chunkUIWFYMAO_cjs.webSearchTool
   }
 };
 
@@ -2900,14 +2844,12 @@ exports.createServerAdapter = createServerAdapter;
 exports.createThreadManager = createThreadManager;
 exports.createToolCall = createToolCall;
 exports.createToolMessage = createToolMessage;
-exports.createToolResult = createToolResult;
 exports.createUserMessage = createUserMessage;
 exports.defaultSystemMessage = defaultSystemMessage;
 exports.defineClientTool = defineClientTool;
 exports.defineServerTool = defineServerTool;
 exports.defineTool = defineTool;
 exports.detectIntent = detectIntent;
-exports.failure = failure;
 exports.formatLogsForAI = formatLogsForAI;
 exports.formatRequestsForAI = formatRequestsForAI;
 exports.formatSSE = formatSSE;
@@ -2945,11 +2887,7 @@ exports.startNetworkCapture = startNetworkCapture;
 exports.stopConsoleCapture = stopConsoleCapture;
 exports.stopNetworkCapture = stopNetworkCapture;
 exports.streamSSE = streamSSE;
-exports.success = success;
-exports.tool = tool;
-exports.toolToAnthropicFormat = toolToAnthropicFormat;
-exports.toolToOpenAIFormat = toolToOpenAIFormat;
 exports.zodObjectToInputSchema = zodObjectToInputSchema;
 exports.zodToJsonSchema = zodToJsonSchema;
-//# sourceMappingURL=chunk-4PRWNAXQ.cjs.map
-//# sourceMappingURL=chunk-4PRWNAXQ.cjs.map
+//# sourceMappingURL=chunk-UOWLKFXK.cjs.map
+//# sourceMappingURL=chunk-UOWLKFXK.cjs.map