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

package/README.md

@@ -44,6 +44,48 @@ function App() {
 | `/ui`    | Pre-built UI components        |
 | `/core`  | Types, utilities, tool helpers |
 
+## Built-in Tools
+
+### Web Search
+
+Add real-time web search capabilities to your AI copilot. **No extra API key needed** - use your existing OpenAI or Google key.
+
+```typescript
+import { createWebSearchTool } from "@yourgpt/copilot-sdk/core";
+
+// Use OpenAI's built-in search (recommended)
+const webSearch = createWebSearchTool({
+  provider: "openai",
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+// Or use Google's built-in search
+const webSearch = createWebSearchTool({
+  provider: "google",
+  apiKey: process.env.GOOGLE_API_KEY,
+});
+
+const runtime = createRuntime({
+  provider: openai,
+  model: "gpt-4o",
+  tools: [webSearch],
+});
+```
+
+**Native Providers (No extra API needed):**
+
+- `openai` - OpenAI's built-in web search
+- `google` - Google's grounding with Google Search
+- `anthropic` - Anthropic's built-in web search
+
+**Third-Party Providers:**
+
+- [Tavily](https://tavily.com/) - AI-native search with answer generation
+- [Serper](https://serper.dev/) - Google Search API
+- [Brave](https://brave.com/search/api/) - Privacy-focused search
+- [Exa](https://exa.ai/) - Semantic AI search
+- [SearXNG](https://docs.searxng.org/) - Self-hosted metasearch
+
 ## Examples
 
 Explore real-world implementations and demo projects.

package/dist/{ThreadManager-JT0sqSSD.d.ts → ThreadManager-Dkp_eLty.d.ts}

@@ -1,4 +1,4 @@
-import { k as Thread, l as ThreadData, _ as ThreadStorageAdapter, X as AsyncThreadStorageAdapter, g as Message } from './types-BtAaOV07.js';
+import { T as Thread, a as ThreadData, b as ThreadStorageAdapter, A as AsyncThreadStorageAdapter, M as Message } from './types-DG2ya08y.js';
 
 /**
  * Tool types for App Context Awareness

package/dist/{ThreadManager-CUq5Ocu2.d.cts → ThreadManager-LfFRhr4e.d.cts}

@@ -1,4 +1,4 @@
-import { k as Thread, l as ThreadData, _ as ThreadStorageAdapter, X as AsyncThreadStorageAdapter, g as Message } from './types-BtAaOV07.cjs';
+import { T as Thread, a as ThreadData, b as ThreadStorageAdapter, A as AsyncThreadStorageAdapter, M as Message } from './types-DG2ya08y.cjs';
 
 /**
  * Tool types for App Context Awareness

package/dist/anthropic-6F5GRE3B.js

@@ -0,0 +1,4 @@
+export { anthropicProvider, searchAnthropic, validateAnthropicConfig } from './chunk-RQ74USYU.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=anthropic-6F5GRE3B.js.map
+//# sourceMappingURL=anthropic-6F5GRE3B.js.map

package/dist/anthropic-6F5GRE3B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"anthropic-6F5GRE3B.js"}

package/dist/anthropic-DGalr_Fw.d.cts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.cjs';
+
+/**
+ * Anthropic Web Search Provider
+ *
+ * Uses Anthropic's built-in web_search tool via the Messages API.
+ * Returns reliable citations with cited_text, url, and title.
+ *
+ * @see https://docs.anthropic.com/en/docs/build-with-claude/tool-use/web-search-tool
+ */
+
+/**
+ * Anthropic native search provider implementation
+ */
+declare const anthropicProvider: WebSearchProviderInterface;
+
+export { anthropicProvider as a };

package/dist/anthropic-DkCEDYOt.d.ts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.js';
+
+/**
+ * Anthropic Web Search Provider
+ *
+ * Uses Anthropic's built-in web_search tool via the Messages API.
+ * Returns reliable citations with cited_text, url, and title.
+ *
+ * @see https://docs.anthropic.com/en/docs/build-with-claude/tool-use/web-search-tool
+ */
+
+/**
+ * Anthropic native search provider implementation
+ */
+declare const anthropicProvider: WebSearchProviderInterface;
+
+export { anthropicProvider as a };

package/dist/anthropic-NMTRABEH.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var chunkTXLIY7GF_cjs = require('./chunk-TXLIY7GF.cjs');
+require('./chunk-JEQ2X3Z6.cjs');
+
+
+
+Object.defineProperty(exports, "anthropicProvider", {
+  enumerable: true,
+  get: function () { return chunkTXLIY7GF_cjs.anthropicProvider; }
+});
+Object.defineProperty(exports, "searchAnthropic", {
+  enumerable: true,
+  get: function () { return chunkTXLIY7GF_cjs.searchAnthropic; }
+});
+Object.defineProperty(exports, "validateAnthropicConfig", {
+  enumerable: true,
+  get: function () { return chunkTXLIY7GF_cjs.validateAnthropicConfig; }
+});
+//# sourceMappingURL=anthropic-NMTRABEH.cjs.map
+//# sourceMappingURL=anthropic-NMTRABEH.cjs.map

package/dist/anthropic-NMTRABEH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"anthropic-NMTRABEH.cjs"}

package/dist/brave-DdnWb7Gb.d.cts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.cjs';
+
+/**
+ * Brave Search Provider
+ *
+ * Brave Search is a privacy-focused search engine with its own index.
+ * Provides independent search results without tracking.
+ *
+ * @see https://brave.com/search/api/
+ */
+
+/**
+ * Brave provider implementation
+ */
+declare const braveProvider: WebSearchProviderInterface;
+
+export { braveProvider as b };

package/dist/brave-DsI9n7Wr.d.ts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.js';
+
+/**
+ * Brave Search Provider
+ *
+ * Brave Search is a privacy-focused search engine with its own index.
+ * Provides independent search results without tracking.
+ *
+ * @see https://brave.com/search/api/
+ */
+
+/**
+ * Brave provider implementation
+ */
+declare const braveProvider: WebSearchProviderInterface;
+
+export { braveProvider as b };

package/dist/brave-OYKCOZEM.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var chunkW73FBYIH_cjs = require('./chunk-W73FBYIH.cjs');
+require('./chunk-JEQ2X3Z6.cjs');
+
+
+
+Object.defineProperty(exports, "braveProvider", {
+  enumerable: true,
+  get: function () { return chunkW73FBYIH_cjs.braveProvider; }
+});
+Object.defineProperty(exports, "searchBrave", {
+  enumerable: true,
+  get: function () { return chunkW73FBYIH_cjs.searchBrave; }
+});
+Object.defineProperty(exports, "validateBraveConfig", {
+  enumerable: true,
+  get: function () { return chunkW73FBYIH_cjs.validateBraveConfig; }
+});
+//# sourceMappingURL=brave-OYKCOZEM.cjs.map
+//# sourceMappingURL=brave-OYKCOZEM.cjs.map

package/dist/brave-OYKCOZEM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"brave-OYKCOZEM.cjs"}

package/dist/brave-XSASGGH2.js

@@ -0,0 +1,4 @@
+export { braveProvider, searchBrave, validateBraveConfig } from './chunk-PPFHA6IL.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=brave-XSASGGH2.js.map
+//# sourceMappingURL=brave-XSASGGH2.js.map

package/dist/brave-XSASGGH2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"brave-XSASGGH2.js"}

package/dist/chunk-2FAWEBZS.cjs

@@ -0,0 +1,88 @@
+'use strict';
+
+// src/core/tools/webSearch/providers/searxng.ts
+var DEFAULT_SEARXNG_URL = "https://searxng.instance.local";
+function validateSearxngConfig(config) {
+  if (!config.baseUrl) {
+    throw new Error(
+      "SearXNG base URL is required. Self-host SearXNG or use a public instance. See https://docs.searxng.org/ for setup instructions."
+    );
+  }
+}
+async function searchSearxng(params, config) {
+  validateSearxngConfig(config);
+  const startTime = Date.now();
+  const baseUrl = config.baseUrl || DEFAULT_SEARXNG_URL;
+  const searchParams = new URLSearchParams({
+    q: params.query,
+    format: "json"
+  });
+  if (config.language) {
+    searchParams.set("language", config.language);
+  }
+  const url = `${baseUrl.replace(/\/$/, "")}/search?${searchParams.toString()}`;
+  const headers = {
+    Accept: "application/json"
+  };
+  if (config.apiKey) {
+    headers["Authorization"] = `Bearer ${config.apiKey}`;
+  }
+  const response = await fetch(url, {
+    method: "GET",
+    headers,
+    signal: config.timeout ? AbortSignal.timeout(config.timeout) : void 0
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "Unknown error");
+    throw new Error(`SearXNG API error (${response.status}): ${errorText}`);
+  }
+  const data = await response.json();
+  const searchTime = Date.now() - startTime;
+  let results = data.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 maxResults = params.maxResults ?? config.maxResults ?? 5;
+  results = results.slice(0, maxResults);
+  const answer = data.answers?.[0] || data.infoboxes?.[0]?.content;
+  return {
+    query: params.query,
+    answer,
+    results: results.map((result) => ({
+      title: result.title,
+      url: result.url,
+      content: result.content,
+      score: result.score,
+      publishedDate: result.publishedDate,
+      image: result.img_src,
+      domain: extractDomain(result.url)
+    })),
+    provider: "searxng",
+    totalResults: data.number_of_results,
+    searchTime
+  };
+}
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname;
+  } catch {
+    return url;
+  }
+}
+var searxngProvider = {
+  search: searchSearxng,
+  validateConfig: validateSearxngConfig
+};
+
+exports.searchSearxng = searchSearxng;
+exports.searxngProvider = searxngProvider;
+exports.validateSearxngConfig = validateSearxngConfig;
+//# sourceMappingURL=chunk-2FAWEBZS.cjs.map
+//# sourceMappingURL=chunk-2FAWEBZS.cjs.map

package/dist/chunk-2FAWEBZS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/providers/searxng.ts"],"names":[],"mappings":"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","file":"chunk-2FAWEBZS.cjs","sourcesContent":["/**\n * SearXNG Search Provider\n *\n * SearXNG is a privacy-respecting, self-hostable metasearch engine.\n * It aggregates results from multiple search engines without tracking.\n *\n * @see https://docs.searxng.org/\n */\n\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  SearxngApiResponse,\n  WebSearchProviderInterface,\n} from \"../types\";\n\n// Default public instance (users should self-host for production)\nconst DEFAULT_SEARXNG_URL = \"https://searxng.instance.local\";\n\n/**\n * Validate SearXNG configuration\n */\nexport function validateSearxngConfig(config: WebSearchConfig): void {\n  if (!config.baseUrl) {\n    throw new Error(\n      \"SearXNG base URL is required. Self-host SearXNG or use a public instance. \" +\n        \"See https://docs.searxng.org/ for setup instructions.\",\n    );\n  }\n}\n\n/**\n * Search using SearXNG API\n */\nexport async function searchSearxng(\n  params: WebSearchParams,\n  config: WebSearchConfig,\n): Promise<WebSearchResponse> {\n  validateSearxngConfig(config);\n\n  const startTime = Date.now();\n\n  const baseUrl = config.baseUrl || DEFAULT_SEARXNG_URL;\n  const searchParams = new URLSearchParams({\n    q: params.query,\n    format: \"json\",\n  });\n\n  // SearXNG doesn't have a direct max_results param, but we can limit after\n  if (config.language) {\n    searchParams.set(\"language\", config.language);\n  }\n\n  // Add specific engines if needed\n  // searchParams.set('engines', 'google,duckduckgo,bing');\n\n  const url = `${baseUrl.replace(/\\/$/, \"\")}/search?${searchParams.toString()}`;\n\n  const headers: Record<string, string> = {\n    Accept: \"application/json\",\n  };\n\n  // Add API key if provided (some instances require it)\n  if (config.apiKey) {\n    headers[\"Authorization\"] = `Bearer ${config.apiKey}`;\n  }\n\n  const response = await fetch(url, {\n    method: \"GET\",\n    headers,\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(`SearXNG API error (${response.status}): ${errorText}`);\n  }\n\n  const data: SearxngApiResponse = await response.json();\n  const searchTime = Date.now() - startTime;\n\n  // Filter by domains if specified\n  let results = data.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  // Limit results\n  const maxResults = params.maxResults ?? config.maxResults ?? 5;\n  results = results.slice(0, maxResults);\n\n  // Extract answer from infoboxes or answers if available\n  const answer = data.answers?.[0] || data.infoboxes?.[0]?.content;\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.content,\n      score: result.score,\n      publishedDate: result.publishedDate,\n      image: result.img_src,\n      domain: extractDomain(result.url),\n    })),\n    provider: \"searxng\",\n    totalResults: data.number_of_results,\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 * SearXNG provider implementation\n */\nexport const searxngProvider: WebSearchProviderInterface = {\n  search: searchSearxng,\n  validateConfig: validateSearxngConfig,\n};\n"]}

package/dist/chunk-53UGJNHN.js

@@ -0,0 +1,92 @@
+// 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
+};
+
+export { googleProvider, searchGoogle, validateGoogleConfig };
+//# sourceMappingURL=chunk-53UGJNHN.js.map
+//# sourceMappingURL=chunk-53UGJNHN.js.map

package/dist/chunk-53UGJNHN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/providers/google.ts"],"names":[],"mappings":"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","file":"chunk-53UGJNHN.js","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-6T5XXJEP.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+// src/core/tools/webSearch/providers/exa.ts
+var EXA_API_URL = "https://api.exa.ai/search";
+function validateExaConfig(config) {
+  if (!config.apiKey) {
+    throw new Error("Exa API key is required. Get one at https://exa.ai/");
+  }
+}
+async function searchExa(params, config) {
+  validateExaConfig(config);
+  const startTime = Date.now();
+  const searchType = params.searchDepth === "advanced" || config.searchDepth === "advanced" ? "auto" : "keyword";
+  const requestBody = {
+    query: params.query,
+    numResults: params.maxResults ?? config.maxResults ?? 5,
+    type: searchType,
+    useAutoprompt: searchType === "auto"
+  };
+  if (config.includeRawContent) {
+    requestBody.contents = {
+      text: true,
+      highlights: true
+    };
+  }
+  if (config.includeDomains?.length) {
+    requestBody.includeDomains = config.includeDomains;
+  }
+  if (config.excludeDomains?.length) {
+    requestBody.excludeDomains = config.excludeDomains;
+  }
+  const response = await fetch(EXA_API_URL, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": config.apiKey
+    },
+    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(`Exa API error (${response.status}): ${errorText}`);
+  }
+  const data = await response.json();
+  const searchTime = Date.now() - startTime;
+  return {
+    query: params.query,
+    // Exa uses autoprompt to improve the query, include it as context
+    answer: data.autopromptString ? `Enhanced query: ${data.autopromptString}` : void 0,
+    results: data.results.map((result) => ({
+      title: result.title,
+      url: result.url,
+      content: result.highlights?.join(" ") || result.text?.slice(0, 300) || "",
+      score: result.score,
+      publishedDate: result.publishedDate,
+      domain: extractDomain(result.url)
+    })),
+    provider: "exa",
+    totalResults: data.results.length,
+    searchTime
+  };
+}
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname;
+  } catch {
+    return url;
+  }
+}
+var exaProvider = {
+  search: searchExa,
+  validateConfig: validateExaConfig
+};
+
+exports.exaProvider = exaProvider;
+exports.searchExa = searchExa;
+exports.validateExaConfig = validateExaConfig;
+//# sourceMappingURL=chunk-6T5XXJEP.cjs.map
+//# sourceMappingURL=chunk-6T5XXJEP.cjs.map

package/dist/chunk-6T5XXJEP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/providers/exa.ts"],"names":[],"mappings":"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","file":"chunk-6T5XXJEP.cjs","sourcesContent":["/**\n * Exa Search Provider\n *\n * Exa (formerly Metaphor) is an AI-native search engine\n * that understands queries semantically for better results.\n *\n * @see https://exa.ai/\n */\n\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  ExaApiResponse,\n  WebSearchProviderInterface,\n} from \"../types\";\n\nconst EXA_API_URL = \"https://api.exa.ai/search\";\n\n/**\n * Validate Exa configuration\n */\nexport function validateExaConfig(config: WebSearchConfig): void {\n  if (!config.apiKey) {\n    throw new Error(\"Exa API key is required. Get one at https://exa.ai/\");\n  }\n}\n\n/**\n * Search using Exa API\n */\nexport async function searchExa(\n  params: WebSearchParams,\n  config: WebSearchConfig,\n): Promise<WebSearchResponse> {\n  validateExaConfig(config);\n\n  const startTime = Date.now();\n\n  // Exa uses \"auto\" for their autoprompt feature which enhances queries\n  const searchType =\n    params.searchDepth === \"advanced\" || config.searchDepth === \"advanced\"\n      ? \"auto\"\n      : \"keyword\";\n\n  const requestBody: Record<string, unknown> = {\n    query: params.query,\n    numResults: params.maxResults ?? config.maxResults ?? 5,\n    type: searchType,\n    useAutoprompt: searchType === \"auto\",\n  };\n\n  // Add content retrieval if raw content is requested\n  if (config.includeRawContent) {\n    requestBody.contents = {\n      text: true,\n      highlights: true,\n    };\n  }\n\n  // Domain filtering\n  if (config.includeDomains?.length) {\n    requestBody.includeDomains = config.includeDomains;\n  }\n  if (config.excludeDomains?.length) {\n    requestBody.excludeDomains = config.excludeDomains;\n  }\n\n  const response = await fetch(EXA_API_URL, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": config.apiKey!,\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(`Exa API error (${response.status}): ${errorText}`);\n  }\n\n  const data: ExaApiResponse = await response.json();\n  const searchTime = Date.now() - startTime;\n\n  return {\n    query: params.query,\n    // Exa uses autoprompt to improve the query, include it as context\n    answer: data.autopromptString\n      ? `Enhanced query: ${data.autopromptString}`\n      : undefined,\n    results: data.results.map((result) => ({\n      title: result.title,\n      url: result.url,\n      content: result.highlights?.join(\" \") || result.text?.slice(0, 300) || \"\",\n      score: result.score,\n      publishedDate: result.publishedDate,\n      domain: extractDomain(result.url),\n    })),\n    provider: \"exa\",\n    totalResults: data.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 * Exa provider implementation\n */\nexport const exaProvider: WebSearchProviderInterface = {\n  search: searchExa,\n  validateConfig: validateExaConfig,\n};\n"]}