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

package/dist/chunk-VD74IPKB.js

@@ -0,0 +1,106 @@
+// src/core/tools/webSearch/providers/openai.ts
+function validateOpenAIConfig(config) {
+  if (!config.apiKey) {
+    throw new Error(
+      "OpenAI API key is required for native web search. Pass apiKey or set OPENAI_API_KEY environment variable."
+    );
+  }
+}
+async function searchOpenAI(params, config) {
+  validateOpenAIConfig(config);
+  const startTime = Date.now();
+  const apiKey = config.apiKey || process.env.OPENAI_API_KEY;
+  const tools = [
+    {
+      type: "web_search",
+      // Domain filtering if provided
+      ...config.includeDomains?.length && {
+        filters: {
+          domains: config.includeDomains
+        }
+      }
+    }
+  ];
+  const response = await fetch("https://api.openai.com/v1/responses", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model: "gpt-4o",
+      // Use GPT-4o for web search
+      tools,
+      input: params.query
+    }),
+    signal: config.timeout ? AbortSignal.timeout(config.timeout) : void 0
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "Unknown error");
+    console.error(
+      "[OpenAI Native Search] API error:",
+      response.status,
+      errorText
+    );
+    throw new Error(
+      `OpenAI Responses API error (${response.status}): ${errorText}`
+    );
+  }
+  const data = await response.json();
+  const searchTime = Date.now() - startTime;
+  let outputText = "";
+  const sources = [];
+  if (data.output && Array.isArray(data.output)) {
+    for (const item of data.output) {
+      if (item.type === "message" && item.content) {
+        for (const contentPart of item.content) {
+          if (contentPart.type === "output_text" && contentPart.text) {
+            outputText = contentPart.text;
+          }
+          if (contentPart.annotations && Array.isArray(contentPart.annotations)) {
+            for (const annotation of contentPart.annotations) {
+              if (annotation.type === "url_citation" && annotation.url) {
+                if (!sources.find((s) => s.url === annotation.url)) {
+                  sources.push({
+                    url: annotation.url,
+                    title: annotation.title || extractDomain(annotation.url)
+                  });
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+  return {
+    query: params.query,
+    answer: outputText,
+    results: sources.slice(0, params.maxResults ?? config.maxResults ?? 5).map((source, i) => ({
+      title: source.title,
+      url: source.url,
+      content: "",
+      // OpenAI returns answer with inline citations, not separate snippets
+      score: 1 - i * 0.1,
+      domain: extractDomain(source.url)
+    })),
+    provider: "openai",
+    totalResults: sources.length,
+    searchTime
+  };
+}
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname.replace("www.", "");
+  } catch {
+    return url;
+  }
+}
+var openaiProvider = {
+  search: searchOpenAI,
+  validateConfig: validateOpenAIConfig
+};
+
+export { openaiProvider, searchOpenAI, validateOpenAIConfig };
+//# sourceMappingURL=chunk-VD74IPKB.js.map
+//# sourceMappingURL=chunk-VD74IPKB.js.map

package/dist/chunk-VD74IPKB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/providers/openai.ts"],"names":[],"mappings":"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","file":"chunk-VD74IPKB.js","sourcesContent":["/**\n * OpenAI Web Search Provider\n *\n * Uses OpenAI's built-in web_search tool via the Responses API.\n * No third-party API key required - uses your OpenAI API key.\n *\n * @see https://platform.openai.com/docs/guides/tools-web-search\n */\n\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  WebSearchProviderInterface,\n} from \"../types\";\n\n/**\n * Validate OpenAI native search configuration\n */\nexport function validateOpenAIConfig(config: WebSearchConfig): void {\n  if (!config.apiKey) {\n    throw new Error(\n      \"OpenAI API key is required for native web search. \" +\n        \"Pass apiKey or set OPENAI_API_KEY environment variable.\",\n    );\n  }\n}\n\n/**\n * Search using OpenAI's native web_search tool (Responses API)\n */\nexport async function searchOpenAI(\n  params: WebSearchParams,\n  config: WebSearchConfig,\n): Promise<WebSearchResponse> {\n  validateOpenAIConfig(config);\n\n  const startTime = Date.now();\n  const apiKey = config.apiKey || process.env.OPENAI_API_KEY;\n\n  // Build tools array with web_search\n  const tools: Array<Record<string, unknown>> = [\n    {\n      type: \"web_search\",\n      // Domain filtering if provided\n      ...(config.includeDomains?.length && {\n        filters: {\n          domains: config.includeDomains,\n        },\n      }),\n    },\n  ];\n\n  // Call OpenAI Responses API\n  const response = await fetch(\"https://api.openai.com/v1/responses\", {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      Authorization: `Bearer ${apiKey}`,\n    },\n    body: JSON.stringify({\n      model: \"gpt-4o\", // Use GPT-4o for web search\n      tools,\n      input: params.query,\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      \"[OpenAI Native Search] API error:\",\n      response.status,\n      errorText,\n    );\n    throw new Error(\n      `OpenAI Responses API error (${response.status}): ${errorText}`,\n    );\n  }\n\n  const data = await response.json();\n  const searchTime = Date.now() - startTime;\n\n  // Extract answer text and annotations from the message output\n  let outputText = \"\";\n  const sources: Array<{ url: string; title: string }> = [];\n\n  if (data.output && Array.isArray(data.output)) {\n    for (const item of data.output) {\n      // Find the message with content\n      if (item.type === \"message\" && item.content) {\n        for (const contentPart of item.content) {\n          // Extract text\n          if (contentPart.type === \"output_text\" && contentPart.text) {\n            outputText = contentPart.text;\n          }\n\n          // Extract sources from annotations (url_citation)\n          if (\n            contentPart.annotations &&\n            Array.isArray(contentPart.annotations)\n          ) {\n            for (const annotation of contentPart.annotations) {\n              if (annotation.type === \"url_citation\" && annotation.url) {\n                // Avoid duplicates\n                if (!sources.find((s) => s.url === annotation.url)) {\n                  sources.push({\n                    url: annotation.url,\n                    title: annotation.title || extractDomain(annotation.url),\n                  });\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n\n  return {\n    query: params.query,\n    answer: outputText,\n    results: sources\n      .slice(0, params.maxResults ?? config.maxResults ?? 5)\n      .map((source, i) => ({\n        title: source.title,\n        url: source.url,\n        content: \"\", // OpenAI returns answer with inline citations, not separate snippets\n        score: 1 - i * 0.1,\n        domain: extractDomain(source.url),\n      })),\n    provider: \"openai\",\n    totalResults: sources.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 * OpenAI native search provider implementation\n */\nexport const openaiProvider: WebSearchProviderInterface = {\n  search: searchOpenAI,\n  validateConfig: validateOpenAIConfig,\n};\n"]}

package/dist/chunk-W73FBYIH.cjs

@@ -0,0 +1,87 @@
+'use strict';
+
+// src/core/tools/webSearch/providers/brave.ts
+var BRAVE_API_URL = "https://api.search.brave.com/res/v1/web/search";
+function validateBraveConfig(config) {
+  if (!config.apiKey) {
+    throw new Error(
+      "Brave Search API key is required. Get one at https://brave.com/search/api/"
+    );
+  }
+}
+async function searchBrave(params, config) {
+  validateBraveConfig(config);
+  const startTime = Date.now();
+  const searchParams = new URLSearchParams({
+    q: params.query,
+    count: String(params.maxResults ?? config.maxResults ?? 5)
+  });
+  if (config.country) {
+    searchParams.set("country", config.country);
+  }
+  if (config.language) {
+    searchParams.set("search_lang", config.language);
+  }
+  const url = `${BRAVE_API_URL}?${searchParams.toString()}`;
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      Accept: "application/json",
+      "Accept-Encoding": "gzip",
+      "X-Subscription-Token": config.apiKey
+    },
+    signal: config.timeout ? AbortSignal.timeout(config.timeout) : void 0
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "Unknown error");
+    throw new Error(
+      `Brave Search API error (${response.status}): ${errorText}`
+    );
+  }
+  const data = await response.json();
+  const searchTime = Date.now() - startTime;
+  let results = data.web?.results || [];
+  if (config.includeDomains?.length) {
+    results = results.filter(
+      (r) => config.includeDomains.some((domain) => r.url.includes(domain))
+    );
+  }
+  if (config.excludeDomains?.length) {
+    results = results.filter(
+      (r) => !config.excludeDomains.some((domain) => r.url.includes(domain))
+    );
+  }
+  const answer = data.infobox?.description;
+  return {
+    query: params.query,
+    answer,
+    results: results.map((result) => ({
+      title: result.title,
+      url: result.url,
+      content: result.description,
+      publishedDate: result.page_age,
+      image: result.thumbnail?.src,
+      domain: extractDomain(result.url)
+    })),
+    provider: "brave",
+    totalResults: results.length,
+    searchTime
+  };
+}
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname;
+  } catch {
+    return url;
+  }
+}
+var braveProvider = {
+  search: searchBrave,
+  validateConfig: validateBraveConfig
+};
+
+exports.braveProvider = braveProvider;
+exports.searchBrave = searchBrave;
+exports.validateBraveConfig = validateBraveConfig;
+//# sourceMappingURL=chunk-W73FBYIH.cjs.map
+//# sourceMappingURL=chunk-W73FBYIH.cjs.map

package/dist/chunk-W73FBYIH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/providers/brave.ts"],"names":[],"mappings":"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","file":"chunk-W73FBYIH.cjs","sourcesContent":["/**\n * Brave Search Provider\n *\n * Brave Search is a privacy-focused search engine with its own index.\n * Provides independent search results without tracking.\n *\n * @see https://brave.com/search/api/\n */\n\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  BraveApiResponse,\n  WebSearchProviderInterface,\n} from \"../types\";\n\nconst BRAVE_API_URL = \"https://api.search.brave.com/res/v1/web/search\";\n\n/**\n * Validate Brave configuration\n */\nexport function validateBraveConfig(config: WebSearchConfig): void {\n  if (!config.apiKey) {\n    throw new Error(\n      \"Brave Search API key is required. Get one at https://brave.com/search/api/\",\n    );\n  }\n}\n\n/**\n * Search using Brave Search API\n */\nexport async function searchBrave(\n  params: WebSearchParams,\n  config: WebSearchConfig,\n): Promise<WebSearchResponse> {\n  validateBraveConfig(config);\n\n  const startTime = Date.now();\n\n  const searchParams = new URLSearchParams({\n    q: params.query,\n    count: String(params.maxResults ?? config.maxResults ?? 5),\n  });\n\n  // Add locale settings\n  if (config.country) {\n    searchParams.set(\"country\", config.country);\n  }\n  if (config.language) {\n    searchParams.set(\"search_lang\", config.language);\n  }\n\n  const url = `${BRAVE_API_URL}?${searchParams.toString()}`;\n\n  const response = await fetch(url, {\n    method: \"GET\",\n    headers: {\n      Accept: \"application/json\",\n      \"Accept-Encoding\": \"gzip\",\n      \"X-Subscription-Token\": config.apiKey!,\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    throw new Error(\n      `Brave Search API error (${response.status}): ${errorText}`,\n    );\n  }\n\n  const data: BraveApiResponse = await response.json();\n  const searchTime = Date.now() - startTime;\n\n  // Filter by domains if specified\n  let results = data.web?.results || [];\n  if (config.includeDomains?.length) {\n    results = results.filter((r) =>\n      config.includeDomains!.some((domain) => r.url.includes(domain)),\n    );\n  }\n  if (config.excludeDomains?.length) {\n    results = results.filter(\n      (r) => !config.excludeDomains!.some((domain) => r.url.includes(domain)),\n    );\n  }\n\n  // Extract answer from infobox if available\n  const answer = data.infobox?.description;\n\n  return {\n    query: params.query,\n    answer,\n    results: results.map((result) => ({\n      title: result.title,\n      url: result.url,\n      content: result.description,\n      publishedDate: result.page_age,\n      image: result.thumbnail?.src,\n      domain: extractDomain(result.url),\n    })),\n    provider: \"brave\",\n    totalResults: results.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;\n  } catch {\n    return url;\n  }\n}\n\n/**\n * Brave provider implementation\n */\nexport const braveProvider: WebSearchProviderInterface = {\n  search: searchBrave,\n  validateConfig: validateBraveConfig,\n};\n"]}

package/dist/chunk-XGITAEXU.js

@@ -0,0 +1,93 @@
+// src/core/tools/webSearch/index.ts
+var providerLoaders = {
+  openai: () => import('./openai-7W2PCNW5.js').then((m) => m.openaiProvider),
+  google: () => import('./google-CTEK6SV2.js').then((m) => m.googleProvider),
+  anthropic: () => import('./anthropic-6F5GRE3B.js').then((m) => m.anthropicProvider),
+  tavily: () => import('./tavily-CIWAAZPH.js').then((m) => m.tavilyProvider),
+  serper: () => import('./serper-3JYJHJX6.js').then((m) => m.serperProvider),
+  brave: () => import('./brave-XSASGGH2.js').then((m) => m.braveProvider),
+  searxng: () => import('./searxng-AXLVGY7Z.js').then((m) => m.searxngProvider),
+  exa: () => import('./exa-NNVPBC2M.js').then((m) => m.exaProvider)
+};
+var loadedProviders = /* @__PURE__ */ new Map();
+async function getProvider(name) {
+  const cached = loadedProviders.get(name);
+  if (cached) {
+    return cached;
+  }
+  const loader = providerLoaders[name];
+  if (!loader) {
+    throw new Error(
+      `Unknown search provider: ${name}. Available providers: ${Object.keys(providerLoaders).join(", ")}`
+    );
+  }
+  const provider = await loader();
+  const resolvedProvider = "default" in provider ? provider.default : provider;
+  loadedProviders.set(name, resolvedProvider);
+  return resolvedProvider;
+}
+function getAvailableProviders() {
+  return Object.keys(providerLoaders);
+}
+function isProviderInterface(provider) {
+  return typeof provider === "object" && "search" in provider;
+}
+async function executeWebSearch(params, config) {
+  const provider = isProviderInterface(config.provider) ? config.provider : await getProvider(config.provider);
+  const providerName = isProviderInterface(config.provider) ? "custom" : config.provider;
+  const resolvedConfig = {
+    ...config,
+    provider: providerName
+  };
+  if (provider.validateConfig) {
+    provider.validateConfig(resolvedConfig);
+  }
+  return provider.search(params, resolvedConfig);
+}
+function formatSearchResultsForAI(response, options) {
+  const {
+    includeUrls = true,
+    includeScores = false,
+    maxContentLength = 200
+  } = options || {};
+  const lines = [];
+  if (response.answer) {
+    lines.push(`Answer: ${response.answer}`);
+    lines.push("");
+  }
+  lines.push(`Search results for "${response.query}":`);
+  lines.push("");
+  response.results.forEach((result, index) => {
+    const num = index + 1;
+    let content = result.content;
+    if (maxContentLength && content.length > maxContentLength) {
+      content = content.slice(0, maxContentLength) + "...";
+    }
+    lines.push(`${num}. ${result.title}`);
+    if (includeUrls) {
+      lines.push(`   URL: ${result.url}`);
+    }
+    lines.push(`   ${content}`);
+    if (includeScores && result.score !== void 0) {
+      lines.push(`   Relevance: ${(result.score * 100).toFixed(1)}%`);
+    }
+    lines.push("");
+  });
+  return lines.join("\n");
+}
+function summarizeSearchResults(response) {
+  const count = response.results.length;
+  const sources = response.results.slice(0, 3).map((r) => r.domain || new URL(r.url).hostname).join(", ");
+  let summary = `Found ${count} result${count !== 1 ? "s" : ""}`;
+  if (sources) {
+    summary += ` from ${sources}`;
+  }
+  if (response.searchTime) {
+    summary += ` (${response.searchTime}ms)`;
+  }
+  return summary;
+}
+
+export { executeWebSearch, formatSearchResultsForAI, getAvailableProviders, getProvider, summarizeSearchResults };
+//# sourceMappingURL=chunk-XGITAEXU.js.map
+//# sourceMappingURL=chunk-XGITAEXU.js.map

package/dist/chunk-XGITAEXU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/index.ts"],"names":[],"mappings":"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","file":"chunk-XGITAEXU.js","sourcesContent":["/**\n * Web Search Module\n *\n * Multi-provider web search with unified API.\n * Supports tree-shaking - only the provider you use gets bundled.\n *\n * @example\n * ```typescript\n * // Option 1: Lazy loading (provider loaded on first use)\n * import { executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n *   { query: 'latest AI news' },\n *   { provider: 'tavily', apiKey: 'your-api-key' }\n * );\n *\n * // Option 2: Direct import (best for tree-shaking)\n * import { tavilyProvider, executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n *   { query: 'latest AI news' },\n *   { provider: tavilyProvider, apiKey: 'your-api-key' }\n * );\n * ```\n */\n\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  WebSearchProvider,\n  WebSearchProviderInterface,\n} from \"./types\";\n\n// ============================================\n// Lazy Provider Loading (for tree-shaking)\n// ============================================\n\n/**\n * Provider loaders - dynamically import providers only when needed.\n * This ensures unused providers are NOT included in the bundle.\n */\nconst providerLoaders: Record<\n  WebSearchProvider,\n  () => Promise<\n    { default: WebSearchProviderInterface } | WebSearchProviderInterface\n  >\n> = {\n  openai: () => import(\"./providers/openai\").then((m) => m.openaiProvider),\n  google: () => import(\"./providers/google\").then((m) => m.googleProvider),\n  anthropic: () =>\n    import(\"./providers/anthropic\").then((m) => m.anthropicProvider),\n  tavily: () => import(\"./providers/tavily\").then((m) => m.tavilyProvider),\n  serper: () => import(\"./providers/serper\").then((m) => m.serperProvider),\n  brave: () => import(\"./providers/brave\").then((m) => m.braveProvider),\n  searxng: () => import(\"./providers/searxng\").then((m) => m.searxngProvider),\n  exa: () => import(\"./providers/exa\").then((m) => m.exaProvider),\n};\n\n// Cache for loaded providers\nconst loadedProviders: Map<WebSearchProvider, WebSearchProviderInterface> =\n  new Map();\n\n/**\n * Get a provider by name (lazy loading)\n *\n * @param name - Provider name string\n * @returns Provider interface (loaded dynamically)\n */\nexport async function getProvider(\n  name: WebSearchProvider,\n): Promise<WebSearchProviderInterface> {\n  // Check cache first\n  const cached = loadedProviders.get(name);\n  if (cached) {\n    return cached;\n  }\n\n  // Load provider dynamically\n  const loader = providerLoaders[name];\n  if (!loader) {\n    throw new Error(\n      `Unknown search provider: ${name}. ` +\n        `Available providers: ${Object.keys(providerLoaders).join(\", \")}`,\n    );\n  }\n\n  const provider = await loader();\n  const resolvedProvider = \"default\" in provider ? provider.default : provider;\n\n  // Cache for future use\n  loadedProviders.set(name, resolvedProvider as WebSearchProviderInterface);\n\n  return resolvedProvider as WebSearchProviderInterface;\n}\n\n/**\n * Get all available provider names\n */\nexport function getAvailableProviders(): WebSearchProvider[] {\n  return Object.keys(providerLoaders) as WebSearchProvider[];\n}\n\n// ============================================\n// Extended Config with Direct Provider Support\n// ============================================\n\n/**\n * Extended config that allows passing provider directly for tree-shaking\n */\nexport interface WebSearchConfigExtended extends Omit<\n  WebSearchConfig,\n  \"provider\"\n> {\n  /**\n   * Provider can be either:\n   * - A string name (lazy loaded): \"tavily\", \"openai\", \"anthropic\", \"google\", etc.\n   * - A provider instance (best for tree-shaking): import { tavilyProvider } from '...'\n   */\n  provider: WebSearchProvider | WebSearchProviderInterface;\n}\n\n/**\n * Check if a value is a provider interface (not a string)\n */\nfunction isProviderInterface(\n  provider: WebSearchProvider | WebSearchProviderInterface,\n): provider is WebSearchProviderInterface {\n  return typeof provider === \"object\" && \"search\" in provider;\n}\n\n// ============================================\n// Execute Search\n// ============================================\n\n/**\n * Execute a web search using the configured provider\n *\n * @param params - Search parameters (query, maxResults, searchDepth)\n * @param config - Provider configuration (provider, apiKey, options)\n * @returns Search results with optional AI-generated answer\n *\n * @example\n * ```typescript\n * // Option 1: String provider name (lazy loaded)\n * const results = await executeWebSearch(\n *   { query: 'What is the latest news about SpaceX?' },\n *   {\n *     provider: 'tavily',\n *     apiKey: process.env.TAVILY_API_KEY,\n *   }\n * );\n *\n * // Option 2: Direct provider import (best for tree-shaking)\n * import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\n * const results = await executeWebSearch(\n *   { query: 'What is the latest news about SpaceX?' },\n *   {\n *     provider: tavilyProvider,\n *     apiKey: process.env.TAVILY_API_KEY,\n *   }\n * );\n * ```\n */\nexport async function executeWebSearch(\n  params: WebSearchParams,\n  config: WebSearchConfigExtended,\n): Promise<WebSearchResponse> {\n  // Resolve provider (either from string or direct reference)\n  const provider = isProviderInterface(config.provider)\n    ? config.provider\n    : await getProvider(config.provider);\n\n  // Build config with string provider name for validation\n  const providerName: WebSearchProvider = isProviderInterface(config.provider)\n    ? (\"custom\" as WebSearchProvider) // Direct provider\n    : config.provider;\n\n  const resolvedConfig: WebSearchConfig = {\n    ...config,\n    provider: providerName,\n  };\n\n  // Validate configuration if provider supports it\n  if (provider.validateConfig) {\n    provider.validateConfig(resolvedConfig);\n  }\n\n  // Execute search\n  return provider.search(params, resolvedConfig);\n}\n\n// ============================================\n// Utility Functions\n// ============================================\n\n/**\n * Format search results for display in AI context\n *\n * @param response - Web search response\n * @param options - Formatting options\n * @returns Formatted string for AI consumption\n */\nexport function formatSearchResultsForAI(\n  response: WebSearchResponse,\n  options?: {\n    includeUrls?: boolean;\n    includeScores?: boolean;\n    maxContentLength?: number;\n  },\n): string {\n  const {\n    includeUrls = true,\n    includeScores = false,\n    maxContentLength = 200,\n  } = options || {};\n\n  const lines: string[] = [];\n\n  // Add answer if available\n  if (response.answer) {\n    lines.push(`Answer: ${response.answer}`);\n    lines.push(\"\");\n  }\n\n  // Add results\n  lines.push(`Search results for \"${response.query}\":`);\n  lines.push(\"\");\n\n  response.results.forEach((result, index) => {\n    const num = index + 1;\n    let content = result.content;\n\n    // Truncate content if needed\n    if (maxContentLength && content.length > maxContentLength) {\n      content = content.slice(0, maxContentLength) + \"...\";\n    }\n\n    lines.push(`${num}. ${result.title}`);\n    if (includeUrls) {\n      lines.push(`   URL: ${result.url}`);\n    }\n    lines.push(`   ${content}`);\n    if (includeScores && result.score !== undefined) {\n      lines.push(`   Relevance: ${(result.score * 100).toFixed(1)}%`);\n    }\n    lines.push(\"\");\n  });\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Create a minimal search result summary\n *\n * @param response - Web search response\n * @returns Brief summary string\n */\nexport function summarizeSearchResults(response: WebSearchResponse): string {\n  const count = response.results.length;\n  const sources = response.results\n    .slice(0, 3)\n    .map((r) => r.domain || new URL(r.url).hostname)\n    .join(\", \");\n\n  let summary = `Found ${count} result${count !== 1 ? \"s\" : \"\"}`;\n  if (sources) {\n    summary += ` from ${sources}`;\n  }\n  if (response.searchTime) {\n    summary += ` (${response.searchTime}ms)`;\n  }\n\n  return summary;\n}\n\n// ============================================\n// Re-exports\n// ============================================\n\n// Export types\nexport * from \"./types\";\n\n// Export individual providers for direct import (tree-shakeable)\n// Users should import these directly for best bundle size:\n//   import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\nexport { openaiProvider } from \"./providers/openai\";\nexport { googleProvider } from \"./providers/google\";\nexport { anthropicProvider } from \"./providers/anthropic\";\nexport { tavilyProvider } from \"./providers/tavily\";\nexport { serperProvider } from \"./providers/serper\";\nexport { braveProvider } from \"./providers/brave\";\nexport { searxngProvider } from \"./providers/searxng\";\nexport { exaProvider } from \"./providers/exa\";\n"]}

package/dist/chunk-XWOHNY3F.cjs

@@ -0,0 +1,96 @@
+'use strict';
+
+// src/core/tools/webSearch/providers/google.ts
+var GEMINI_API_URL = "https://generativelanguage.googleapis.com/v1beta/models";
+function validateGoogleConfig(config) {
+  if (!config.apiKey) {
+    throw new Error(
+      "Google API key is required for native web search. Pass apiKey or set GOOGLE_API_KEY/GEMINI_API_KEY environment variable."
+    );
+  }
+}
+async function searchGoogle(params, config) {
+  validateGoogleConfig(config);
+  const startTime = Date.now();
+  const apiKey = config.apiKey || process.env.GOOGLE_API_KEY || process.env.GEMINI_API_KEY;
+  const model = "gemini-2.0-flash";
+  const url = `${GEMINI_API_URL}/${model}:generateContent?key=${apiKey}`;
+  const requestBody = {
+    contents: [
+      {
+        parts: [
+          {
+            text: params.query
+          }
+        ]
+      }
+    ],
+    tools: [
+      {
+        google_search: {}
+        // Enable Google Search grounding
+      }
+    ],
+    // Generation config
+    generationConfig: {
+      temperature: 0.7,
+      maxOutputTokens: 1024
+    }
+  };
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(requestBody),
+    signal: config.timeout ? AbortSignal.timeout(config.timeout) : void 0
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "Unknown error");
+    throw new Error(
+      `Google Gemini API error (${response.status}): ${errorText}`
+    );
+  }
+  const data = await response.json();
+  const searchTime = Date.now() - startTime;
+  const candidates = data.candidates || [];
+  const content = candidates[0]?.content;
+  const textParts = content?.parts?.filter((p) => p.text) || [];
+  const generatedText = textParts.map((p) => p.text).join("\n");
+  const groundingMetadata = candidates[0]?.groundingMetadata;
+  const groundingChunks = groundingMetadata?.groundingChunks || [];
+  groundingMetadata?.searchEntryPoint;
+  const results = groundingChunks.filter((chunk) => chunk.web).slice(0, params.maxResults ?? config.maxResults ?? 5).map((chunk, i) => ({
+    title: chunk.web.title || extractDomain(chunk.web.uri),
+    url: chunk.web.uri,
+    content: "",
+    // Google doesn't provide snippets in grounding response
+    score: 1 - i * 0.1,
+    domain: extractDomain(chunk.web.uri)
+  }));
+  return {
+    query: params.query,
+    answer: generatedText,
+    results,
+    provider: "google",
+    totalResults: groundingChunks.length,
+    searchTime
+  };
+}
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname.replace("www.", "");
+  } catch {
+    return url;
+  }
+}
+var googleProvider = {
+  search: searchGoogle,
+  validateConfig: validateGoogleConfig
+};
+
+exports.googleProvider = googleProvider;
+exports.searchGoogle = searchGoogle;
+exports.validateGoogleConfig = validateGoogleConfig;
+//# sourceMappingURL=chunk-XWOHNY3F.cjs.map
+//# sourceMappingURL=chunk-XWOHNY3F.cjs.map

package/dist/chunk-XWOHNY3F.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/providers/google.ts"],"names":[],"mappings":"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","file":"chunk-XWOHNY3F.cjs","sourcesContent":["/**\n * Google Web Search Provider (Grounding with Google Search)\n *\n * Uses Google's built-in grounding feature via the Gemini API.\n * No third-party API key required - uses your Google/Gemini API key.\n *\n * @see https://ai.google.dev/gemini-api/docs/google-search\n */\n\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  WebSearchProviderInterface,\n} from \"../types\";\n\nconst GEMINI_API_URL =\n  \"https://generativelanguage.googleapis.com/v1beta/models\";\n\n/**\n * Validate Google native search configuration\n */\nexport function validateGoogleConfig(config: WebSearchConfig): void {\n  if (!config.apiKey) {\n    throw new Error(\n      \"Google API key is required for native web search. \" +\n        \"Pass apiKey or set GOOGLE_API_KEY/GEMINI_API_KEY environment variable.\",\n    );\n  }\n}\n\n/**\n * Search using Google's native grounding with Google Search\n */\nexport async function searchGoogle(\n  params: WebSearchParams,\n  config: WebSearchConfig,\n): Promise<WebSearchResponse> {\n  validateGoogleConfig(config);\n\n  const startTime = Date.now();\n  const apiKey =\n    config.apiKey || process.env.GOOGLE_API_KEY || process.env.GEMINI_API_KEY;\n  const model = \"gemini-2.0-flash\"; // Use latest model with grounding support\n\n  const url = `${GEMINI_API_URL}/${model}:generateContent?key=${apiKey}`;\n\n  // Build request with Google Search grounding\n  const requestBody = {\n    contents: [\n      {\n        parts: [\n          {\n            text: params.query,\n          },\n        ],\n      },\n    ],\n    tools: [\n      {\n        google_search: {}, // Enable Google Search grounding\n      },\n    ],\n    // Generation config\n    generationConfig: {\n      temperature: 0.7,\n      maxOutputTokens: 1024,\n    },\n  };\n\n  const response = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify(requestBody),\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    throw new Error(\n      `Google Gemini API error (${response.status}): ${errorText}`,\n    );\n  }\n\n  const data = await response.json();\n  const searchTime = Date.now() - startTime;\n\n  // Extract the generated text\n  const candidates = data.candidates || [];\n  const content = candidates[0]?.content;\n  const textParts =\n    content?.parts?.filter((p: { text?: string }) => p.text) || [];\n  const generatedText = textParts\n    .map((p: { text: string }) => p.text)\n    .join(\"\\n\");\n\n  // Extract grounding metadata (sources)\n  const groundingMetadata = candidates[0]?.groundingMetadata;\n  const groundingChunks = groundingMetadata?.groundingChunks || [];\n  const searchEntryPoint = groundingMetadata?.searchEntryPoint;\n\n  // Build results from grounding chunks\n  const results = groundingChunks\n    .filter((chunk: { web?: { uri: string; title?: string } }) => chunk.web)\n    .slice(0, params.maxResults ?? config.maxResults ?? 5)\n    .map((chunk: { web: { uri: string; title?: string } }, i: number) => ({\n      title: chunk.web.title || extractDomain(chunk.web.uri),\n      url: chunk.web.uri,\n      content: \"\", // Google doesn't provide snippets in grounding response\n      score: 1 - i * 0.1,\n      domain: extractDomain(chunk.web.uri),\n    }));\n\n  return {\n    query: params.query,\n    answer: generatedText,\n    results,\n    provider: \"google\",\n    totalResults: groundingChunks.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 * Google native search provider implementation\n */\nexport const googleProvider: WebSearchProviderInterface = {\n  search: searchGoogle,\n  validateConfig: validateGoogleConfig,\n};\n"]}

package/dist/chunk-ZPYQDMUX.js

@@ -0,0 +1,79 @@
+import { tool, failure } from './chunk-BKO7DSPU.js';
+import { formatSearchResultsForAI, executeWebSearch, summarizeSearchResults } from './chunk-XGITAEXU.js';
+
+// src/core/tools/builtin/webSearch.ts
+var webSearchTool = 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 formatSearchResultsForAI(data);
+  }
+});
+function createWebSearchTool(config) {
+  return {
+    name: "web_search",
+    ...webSearchTool,
+    handler: async (params) => {
+      try {
+        const response = await executeWebSearch(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5,
+            searchDepth: params.searchDepth ?? config.searchDepth ?? "basic"
+          },
+          config
+        );
+        const aiContext = formatSearchResultsForAI(response);
+        return {
+          success: true,
+          message: summarizeSearchResults(response),
+          data: response,
+          _aiContext: aiContext
+        };
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Web search failed";
+        return failure(errorMessage);
+      }
+    }
+  };
+}
+
+export { createWebSearchTool, webSearchTool };
+//# sourceMappingURL=chunk-ZPYQDMUX.js.map
+//# sourceMappingURL=chunk-ZPYQDMUX.js.map

package/dist/chunk-ZPYQDMUX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/builtin/webSearch.ts"],"names":[],"mappings":";;;;AAoDO,IAAM,gBAAgB,IAAA,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,OAAO,yBAAyB,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,MAAM,gBAAA;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,GAAY,yBAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAAS,uBAAuB,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,OAAO,QAAQ,YAAY,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-ZPYQDMUX.js","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"]}