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

package/dist/tools/brave/index.js

@@ -0,0 +1,80 @@
+import { failure } from '../../chunk-BKO7DSPU.js';
+import { formatSearchResultsForAI, summarizeSearchResults } from '../../chunk-XGITAEXU.js';
+import '../../chunk-7W7QLZNC.js';
+import '../../chunk-CEOMTQTP.js';
+import { searchBrave } from '../../chunk-PPFHA6IL.js';
+export { braveProvider } from '../../chunk-PPFHA6IL.js';
+import '../../chunk-DABZYCVX.js';
+import '../../chunk-MNDGIW47.js';
+import '../../chunk-VD74IPKB.js';
+import '../../chunk-53UGJNHN.js';
+import '../../chunk-RQ74USYU.js';
+import '../../chunk-DGUM43GV.js';
+
+// src/tools/brave/index.ts
+function braveSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using Brave Search 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",
+    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
+        }
+      },
+      required: ["query"]
+    },
+    needsApproval: false,
+    aiResponseMode: "full",
+    handler: async (params) => {
+      try {
+        const response = await searchBrave(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5
+          },
+          {
+            provider: "brave",
+            apiKey: config.apiKey,
+            country: config.country,
+            language: config.language,
+            includeDomains: config.includeDomains,
+            excludeDomains: config.excludeDomains,
+            timeout: config.timeout
+          }
+        );
+        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 { braveSearch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/tools/brave/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/brave/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAqGO,SAAS,YACd,MAAA,EACmC;AACnC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IACN,WAAA,EAAa,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qDAAA,CAAA;AAAA,IAOb,QAAA,EAAU,QAAA;AAAA,IAEV,KAAA,EAAO,CAAC,IAAA,KAAS,CAAA,eAAA,EAAkB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,IAC7C,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,uBAAA,EAA0B,KAAK,KAAK,CAAA,IAAA,CAAA;AAAA,IAC9D,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,mBAAA,EAAsB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,IAE1D,WAAA,EAAa;AAAA,MACX,IAAA,EAAM,QAAA;AAAA,MACN,UAAA,EAAY;AAAA,QACV,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EAAa;AAAA,SACf;AAAA,QACA,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EACE,2DAAA;AAAA,UACF,OAAA,EAAS,CAAA;AAAA,UACT,OAAA,EAAS;AAAA;AACX,OACF;AAAA,MACA,QAAA,EAAU,CAAC,OAAO;AAAA,KACpB;AAAA,IAEA,aAAA,EAAe,KAAA;AAAA,IACf,cAAA,EAAgB,MAAA;AAAA,IAEhB,OAAA,EAAS,OAAO,MAAA,KAAW;AACzB,MAAA,IAAI;AACF,QAAA,MAAM,WAA8B,MAAM,WAAA;AAAA,UACxC;AAAA,YACE,OAAO,MAAA,CAAO,KAAA;AAAA,YACd,UAAA,EAAY,MAAA,CAAO,UAAA,IAAc,MAAA,CAAO,UAAA,IAAc;AAAA,WACxD;AAAA,UACA;AAAA,YACE,QAAA,EAAU,OAAA;AAAA,YACV,QAAQ,MAAA,CAAO,MAAA;AAAA,YACf,SAAS,MAAA,CAAO,OAAA;AAAA,YAChB,UAAU,MAAA,CAAO,QAAA;AAAA,YACjB,gBAAgB,MAAA,CAAO,cAAA;AAAA,YACvB,gBAAgB,MAAA,CAAO,cAAA;AAAA,YACvB,SAAS,MAAA,CAAO;AAAA;AAClB,SACF;AAEA,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":"index.js","sourcesContent":["/**\n * Brave Search Tool\n *\n * Tree-shakeable import for Brave web search provider.\n * Only imports Brave code - no other providers bundled.\n *\n * @example\n * ```typescript\n * import { braveSearch } from '@yourgpt/copilot-sdk/tools/brave';\n *\n * const webSearch = braveSearch({\n *   apiKey: process.env.BRAVE_API_KEY,\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://brave.com/search/api/\n * @module @yourgpt/copilot-sdk/tools/brave\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchBrave,\n  braveProvider,\n} from \"../../core/tools/webSearch/providers/brave\";\nimport {\n  formatSearchResultsForAI,\n  summarizeSearchResults,\n} from \"../../core/tools/webSearch\";\nimport type { WebSearchResponse } from \"../../core/tools/webSearch/types\";\n\n// Re-export provider for direct access\nexport { braveProvider };\n\n/**\n * Brave search configuration\n */\nexport interface BraveSearchConfig {\n  /** Brave Search API key - get one at https://brave.com/search/api/ */\n  apiKey: string;\n  /** Maximum number of results (default: 5) */\n  maxResults?: number;\n  /** Country code for localized results (e.g., 'us', 'gb', 'de') */\n  country?: string;\n  /** Language code for results (e.g., 'en', 'es', 'fr') */\n  language?: string;\n  /** Only include results from these domains */\n  includeDomains?: string[];\n  /** Exclude results from these domains */\n  excludeDomains?: string[];\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Search parameters passed to the tool\n */\ninterface BraveSearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n}\n\n/**\n * Create a Brave web search tool\n *\n * Brave Search is a privacy-focused search engine with its own index.\n * Provides independent search results without tracking.\n *\n * @param config - Brave configuration including API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { braveSearch } from '@yourgpt/copilot-sdk/tools/brave';\n *\n * // Basic usage\n * const webSearch = braveSearch({\n *   apiKey: process.env.BRAVE_API_KEY,\n * });\n *\n * // With locale settings\n * const webSearch = braveSearch({\n *   apiKey: process.env.BRAVE_API_KEY,\n *   country: 'us',\n *   language: 'en',\n *   maxResults: 10,\n * });\n *\n * const runtime = createRuntime({\n *   provider: openai,\n *   model: 'gpt-4o',\n *   tools: [webSearch],\n * });\n * ```\n */\nexport function braveSearch(\n  config: BraveSearchConfig,\n): ToolDefinition<BraveSearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using Brave Search 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\",\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      },\n      required: [\"query\"],\n    },\n\n    needsApproval: false,\n    aiResponseMode: \"full\",\n\n    handler: async (params) => {\n      try {\n        const response: WebSearchResponse = await searchBrave(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n          },\n          {\n            provider: \"brave\",\n            apiKey: config.apiKey,\n            country: config.country,\n            language: config.language,\n            includeDomains: config.includeDomains,\n            excludeDomains: config.excludeDomains,\n            timeout: config.timeout,\n          },\n        );\n\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"]}

package/dist/tools/exa/index.cjs

@@ -0,0 +1,90 @@
+'use strict';
+
+var chunkCEKAYA2Q_cjs = require('../../chunk-CEKAYA2Q.cjs');
+var chunkASV6JLYG_cjs = require('../../chunk-ASV6JLYG.cjs');
+require('../../chunk-CBAHCI4R.cjs');
+require('../../chunk-MEBXW75C.cjs');
+require('../../chunk-W73FBYIH.cjs');
+require('../../chunk-2FAWEBZS.cjs');
+var chunk6T5XXJEP_cjs = require('../../chunk-6T5XXJEP.cjs');
+require('../../chunk-GANCV72Z.cjs');
+require('../../chunk-XWOHNY3F.cjs');
+require('../../chunk-TXLIY7GF.cjs');
+require('../../chunk-JEQ2X3Z6.cjs');
+
+// src/tools/exa/index.ts
+function exaSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using Exa 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",
+    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' uses semantic search for better results"
+        }
+      },
+      required: ["query"]
+    },
+    needsApproval: false,
+    aiResponseMode: "full",
+    handler: async (params) => {
+      try {
+        const response = await chunk6T5XXJEP_cjs.searchExa(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5,
+            searchDepth: params.searchDepth ?? config.searchDepth ?? "basic"
+          },
+          {
+            provider: "exa",
+            apiKey: config.apiKey,
+            includeDomains: config.includeDomains,
+            excludeDomains: config.excludeDomains,
+            includeRawContent: config.includeRawContent,
+            timeout: config.timeout
+          }
+        );
+        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);
+      }
+    }
+  };
+}
+
+Object.defineProperty(exports, "exaProvider", {
+  enumerable: true,
+  get: function () { return chunk6T5XXJEP_cjs.exaProvider; }
+});
+exports.exaSearch = exaSearch;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/tools/exa/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/exa/index.ts"],"names":["searchExa","formatSearchResultsForAI","summarizeSearchResults","failure"],"mappings":";;;;;;;;;;;;;;;AAsGO,SAAS,UACd,MAAA,EACiC;AACjC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IACN,WAAA,EAAa,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qDAAA,CAAA;AAAA,IAOb,QAAA,EAAU,QAAA;AAAA,IAEV,KAAA,EAAO,CAAC,IAAA,KAAS,CAAA,eAAA,EAAkB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,IAC7C,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,uBAAA,EAA0B,KAAK,KAAK,CAAA,IAAA,CAAA;AAAA,IAC9D,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,mBAAA,EAAsB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,IAE1D,WAAA,EAAa;AAAA,MACX,IAAA,EAAM,QAAA;AAAA,MACN,UAAA,EAAY;AAAA,QACV,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EAAa;AAAA,SACf;AAAA,QACA,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EACE,2DAAA;AAAA,UACF,OAAA,EAAS,CAAA;AAAA,UACT,OAAA,EAAS;AAAA,SACX;AAAA,QACA,WAAA,EAAa;AAAA,UACX,IAAA,EAAM,QAAA;AAAA,UACN,IAAA,EAAM,CAAC,OAAA,EAAS,UAAU,CAAA;AAAA,UAC1B,WAAA,EACE;AAAA;AACJ,OACF;AAAA,MACA,QAAA,EAAU,CAAC,OAAO;AAAA,KACpB;AAAA,IAEA,aAAA,EAAe,KAAA;AAAA,IACf,cAAA,EAAgB,MAAA;AAAA,IAEhB,OAAA,EAAS,OAAO,MAAA,KAAW;AACzB,MAAA,IAAI;AACF,QAAA,MAAM,WAA8B,MAAMA,2BAAA;AAAA,UACxC;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,YACE,QAAA,EAAU,KAAA;AAAA,YACV,QAAQ,MAAA,CAAO,MAAA;AAAA,YACf,gBAAgB,MAAA,CAAO,cAAA;AAAA,YACvB,gBAAgB,MAAA,CAAO,cAAA;AAAA,YACvB,mBAAmB,MAAA,CAAO,iBAAA;AAAA,YAC1B,SAAS,MAAA,CAAO;AAAA;AAClB,SACF;AAEA,QAAA,MAAM,SAAA,GAAYC,2CAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAASC,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":"index.cjs","sourcesContent":["/**\n * Exa Search Tool\n *\n * Tree-shakeable import for Exa web search provider.\n * Only imports Exa code - no other providers bundled.\n *\n * @example\n * ```typescript\n * import { exaSearch } from '@yourgpt/copilot-sdk/tools/exa';\n *\n * const webSearch = exaSearch({\n *   apiKey: process.env.EXA_API_KEY,\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://exa.ai/\n * @module @yourgpt/copilot-sdk/tools/exa\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchExa,\n  exaProvider,\n} from \"../../core/tools/webSearch/providers/exa\";\nimport {\n  formatSearchResultsForAI,\n  summarizeSearchResults,\n} from \"../../core/tools/webSearch\";\nimport type { WebSearchResponse } from \"../../core/tools/webSearch/types\";\n\n// Re-export provider for direct access\nexport { exaProvider };\n\n/**\n * Exa search configuration\n */\nexport interface ExaSearchConfig {\n  /** Exa API key - get one at https://exa.ai/ */\n  apiKey: string;\n  /** Maximum number of results (default: 5) */\n  maxResults?: number;\n  /** Search depth - 'advanced' uses autoprompt for better semantic search */\n  searchDepth?: \"basic\" | \"advanced\";\n  /** Only include results from these domains */\n  includeDomains?: string[];\n  /** Exclude results from these domains */\n  excludeDomains?: string[];\n  /** Include raw page content */\n  includeRawContent?: boolean;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Search parameters passed to the tool\n */\ninterface ExaSearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n  /** Search depth (overrides config) */\n  searchDepth?: \"basic\" | \"advanced\";\n}\n\n/**\n * Create an Exa web search tool\n *\n * Exa (formerly Metaphor) is an AI-native search engine that understands\n * queries semantically for better results.\n *\n * @param config - Exa configuration including API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { exaSearch } from '@yourgpt/copilot-sdk/tools/exa';\n *\n * // Basic usage\n * const webSearch = exaSearch({\n *   apiKey: process.env.EXA_API_KEY,\n * });\n *\n * // With semantic search (autoprompt)\n * const webSearch = exaSearch({\n *   apiKey: process.env.EXA_API_KEY,\n *   searchDepth: 'advanced',\n *   maxResults: 10,\n * });\n *\n * const runtime = createRuntime({\n *   provider: openai,\n *   model: 'gpt-4o',\n *   tools: [webSearch],\n * });\n * ```\n */\nexport function exaSearch(\n  config: ExaSearchConfig,\n): ToolDefinition<ExaSearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using Exa 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\",\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' uses semantic search for better results\",\n        },\n      },\n      required: [\"query\"],\n    },\n\n    needsApproval: false,\n    aiResponseMode: \"full\",\n\n    handler: async (params) => {\n      try {\n        const response: WebSearchResponse = await searchExa(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n            searchDepth: params.searchDepth ?? config.searchDepth ?? \"basic\",\n          },\n          {\n            provider: \"exa\",\n            apiKey: config.apiKey,\n            includeDomains: config.includeDomains,\n            excludeDomains: config.excludeDomains,\n            includeRawContent: config.includeRawContent,\n            timeout: config.timeout,\n          },\n        );\n\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"]}

package/dist/tools/exa/index.d.cts

@@ -0,0 +1,92 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.cjs';
+export { e as exaProvider } from '../../exa-jJSPhyUW.cjs';
+import '../../types-ZguuKEs_.cjs';
+
+/**
+ * Exa Search Tool
+ *
+ * Tree-shakeable import for Exa web search provider.
+ * Only imports Exa code - no other providers bundled.
+ *
+ * @example
+ * ```typescript
+ * import { exaSearch } from '@yourgpt/copilot-sdk/tools/exa';
+ *
+ * const webSearch = exaSearch({
+ *   apiKey: process.env.EXA_API_KEY,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://exa.ai/
+ * @module @yourgpt/copilot-sdk/tools/exa
+ */
+
+/**
+ * Exa search configuration
+ */
+interface ExaSearchConfig {
+    /** Exa API key - get one at https://exa.ai/ */
+    apiKey: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Search depth - 'advanced' uses autoprompt for better semantic search */
+    searchDepth?: "basic" | "advanced";
+    /** Only include results from these domains */
+    includeDomains?: string[];
+    /** Exclude results from these domains */
+    excludeDomains?: string[];
+    /** Include raw page content */
+    includeRawContent?: boolean;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface ExaSearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+    /** Search depth (overrides config) */
+    searchDepth?: "basic" | "advanced";
+}
+/**
+ * Create an Exa web search tool
+ *
+ * Exa (formerly Metaphor) is an AI-native search engine that understands
+ * queries semantically for better results.
+ *
+ * @param config - Exa configuration including API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { exaSearch } from '@yourgpt/copilot-sdk/tools/exa';
+ *
+ * // Basic usage
+ * const webSearch = exaSearch({
+ *   apiKey: process.env.EXA_API_KEY,
+ * });
+ *
+ * // With semantic search (autoprompt)
+ * const webSearch = exaSearch({
+ *   apiKey: process.env.EXA_API_KEY,
+ *   searchDepth: 'advanced',
+ *   maxResults: 10,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: openai,
+ *   model: 'gpt-4o',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function exaSearch(config: ExaSearchConfig): ToolDefinition<ExaSearchParams>;
+
+export { type ExaSearchConfig, exaSearch };

package/dist/tools/exa/index.d.ts

@@ -0,0 +1,92 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.js';
+export { e as exaProvider } from '../../exa-Dp9U-WTc.js';
+import '../../types-ZguuKEs_.js';
+
+/**
+ * Exa Search Tool
+ *
+ * Tree-shakeable import for Exa web search provider.
+ * Only imports Exa code - no other providers bundled.
+ *
+ * @example
+ * ```typescript
+ * import { exaSearch } from '@yourgpt/copilot-sdk/tools/exa';
+ *
+ * const webSearch = exaSearch({
+ *   apiKey: process.env.EXA_API_KEY,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://exa.ai/
+ * @module @yourgpt/copilot-sdk/tools/exa
+ */
+
+/**
+ * Exa search configuration
+ */
+interface ExaSearchConfig {
+    /** Exa API key - get one at https://exa.ai/ */
+    apiKey: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Search depth - 'advanced' uses autoprompt for better semantic search */
+    searchDepth?: "basic" | "advanced";
+    /** Only include results from these domains */
+    includeDomains?: string[];
+    /** Exclude results from these domains */
+    excludeDomains?: string[];
+    /** Include raw page content */
+    includeRawContent?: boolean;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface ExaSearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+    /** Search depth (overrides config) */
+    searchDepth?: "basic" | "advanced";
+}
+/**
+ * Create an Exa web search tool
+ *
+ * Exa (formerly Metaphor) is an AI-native search engine that understands
+ * queries semantically for better results.
+ *
+ * @param config - Exa configuration including API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { exaSearch } from '@yourgpt/copilot-sdk/tools/exa';
+ *
+ * // Basic usage
+ * const webSearch = exaSearch({
+ *   apiKey: process.env.EXA_API_KEY,
+ * });
+ *
+ * // With semantic search (autoprompt)
+ * const webSearch = exaSearch({
+ *   apiKey: process.env.EXA_API_KEY,
+ *   searchDepth: 'advanced',
+ *   maxResults: 10,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: openai,
+ *   model: 'gpt-4o',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function exaSearch(config: ExaSearchConfig): ToolDefinition<ExaSearchParams>;
+
+export { type ExaSearchConfig, exaSearch };

package/dist/tools/exa/index.js

@@ -0,0 +1,85 @@
+import { failure } from '../../chunk-BKO7DSPU.js';
+import { formatSearchResultsForAI, summarizeSearchResults } from '../../chunk-XGITAEXU.js';
+import '../../chunk-7W7QLZNC.js';
+import '../../chunk-CEOMTQTP.js';
+import '../../chunk-PPFHA6IL.js';
+import '../../chunk-DABZYCVX.js';
+import { searchExa } from '../../chunk-MNDGIW47.js';
+export { exaProvider } from '../../chunk-MNDGIW47.js';
+import '../../chunk-VD74IPKB.js';
+import '../../chunk-53UGJNHN.js';
+import '../../chunk-RQ74USYU.js';
+import '../../chunk-DGUM43GV.js';
+
+// src/tools/exa/index.ts
+function exaSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using Exa 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",
+    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' uses semantic search for better results"
+        }
+      },
+      required: ["query"]
+    },
+    needsApproval: false,
+    aiResponseMode: "full",
+    handler: async (params) => {
+      try {
+        const response = await searchExa(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5,
+            searchDepth: params.searchDepth ?? config.searchDepth ?? "basic"
+          },
+          {
+            provider: "exa",
+            apiKey: config.apiKey,
+            includeDomains: config.includeDomains,
+            excludeDomains: config.excludeDomains,
+            includeRawContent: config.includeRawContent,
+            timeout: config.timeout
+          }
+        );
+        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 { exaSearch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/tools/exa/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/exa/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAsGO,SAAS,UACd,MAAA,EACiC;AACjC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IACN,WAAA,EAAa,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qDAAA,CAAA;AAAA,IAOb,QAAA,EAAU,QAAA;AAAA,IAEV,KAAA,EAAO,CAAC,IAAA,KAAS,CAAA,eAAA,EAAkB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,IAC7C,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,uBAAA,EAA0B,KAAK,KAAK,CAAA,IAAA,CAAA;AAAA,IAC9D,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,mBAAA,EAAsB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,IAE1D,WAAA,EAAa;AAAA,MACX,IAAA,EAAM,QAAA;AAAA,MACN,UAAA,EAAY;AAAA,QACV,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EAAa;AAAA,SACf;AAAA,QACA,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EACE,2DAAA;AAAA,UACF,OAAA,EAAS,CAAA;AAAA,UACT,OAAA,EAAS;AAAA,SACX;AAAA,QACA,WAAA,EAAa;AAAA,UACX,IAAA,EAAM,QAAA;AAAA,UACN,IAAA,EAAM,CAAC,OAAA,EAAS,UAAU,CAAA;AAAA,UAC1B,WAAA,EACE;AAAA;AACJ,OACF;AAAA,MACA,QAAA,EAAU,CAAC,OAAO;AAAA,KACpB;AAAA,IAEA,aAAA,EAAe,KAAA;AAAA,IACf,cAAA,EAAgB,MAAA;AAAA,IAEhB,OAAA,EAAS,OAAO,MAAA,KAAW;AACzB,MAAA,IAAI;AACF,QAAA,MAAM,WAA8B,MAAM,SAAA;AAAA,UACxC;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,YACE,QAAA,EAAU,KAAA;AAAA,YACV,QAAQ,MAAA,CAAO,MAAA;AAAA,YACf,gBAAgB,MAAA,CAAO,cAAA;AAAA,YACvB,gBAAgB,MAAA,CAAO,cAAA;AAAA,YACvB,mBAAmB,MAAA,CAAO,iBAAA;AAAA,YAC1B,SAAS,MAAA,CAAO;AAAA;AAClB,SACF;AAEA,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":"index.js","sourcesContent":["/**\n * Exa Search Tool\n *\n * Tree-shakeable import for Exa web search provider.\n * Only imports Exa code - no other providers bundled.\n *\n * @example\n * ```typescript\n * import { exaSearch } from '@yourgpt/copilot-sdk/tools/exa';\n *\n * const webSearch = exaSearch({\n *   apiKey: process.env.EXA_API_KEY,\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://exa.ai/\n * @module @yourgpt/copilot-sdk/tools/exa\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchExa,\n  exaProvider,\n} from \"../../core/tools/webSearch/providers/exa\";\nimport {\n  formatSearchResultsForAI,\n  summarizeSearchResults,\n} from \"../../core/tools/webSearch\";\nimport type { WebSearchResponse } from \"../../core/tools/webSearch/types\";\n\n// Re-export provider for direct access\nexport { exaProvider };\n\n/**\n * Exa search configuration\n */\nexport interface ExaSearchConfig {\n  /** Exa API key - get one at https://exa.ai/ */\n  apiKey: string;\n  /** Maximum number of results (default: 5) */\n  maxResults?: number;\n  /** Search depth - 'advanced' uses autoprompt for better semantic search */\n  searchDepth?: \"basic\" | \"advanced\";\n  /** Only include results from these domains */\n  includeDomains?: string[];\n  /** Exclude results from these domains */\n  excludeDomains?: string[];\n  /** Include raw page content */\n  includeRawContent?: boolean;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Search parameters passed to the tool\n */\ninterface ExaSearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n  /** Search depth (overrides config) */\n  searchDepth?: \"basic\" | \"advanced\";\n}\n\n/**\n * Create an Exa web search tool\n *\n * Exa (formerly Metaphor) is an AI-native search engine that understands\n * queries semantically for better results.\n *\n * @param config - Exa configuration including API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { exaSearch } from '@yourgpt/copilot-sdk/tools/exa';\n *\n * // Basic usage\n * const webSearch = exaSearch({\n *   apiKey: process.env.EXA_API_KEY,\n * });\n *\n * // With semantic search (autoprompt)\n * const webSearch = exaSearch({\n *   apiKey: process.env.EXA_API_KEY,\n *   searchDepth: 'advanced',\n *   maxResults: 10,\n * });\n *\n * const runtime = createRuntime({\n *   provider: openai,\n *   model: 'gpt-4o',\n *   tools: [webSearch],\n * });\n * ```\n */\nexport function exaSearch(\n  config: ExaSearchConfig,\n): ToolDefinition<ExaSearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using Exa 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\",\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' uses semantic search for better results\",\n        },\n      },\n      required: [\"query\"],\n    },\n\n    needsApproval: false,\n    aiResponseMode: \"full\",\n\n    handler: async (params) => {\n      try {\n        const response: WebSearchResponse = await searchExa(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n            searchDepth: params.searchDepth ?? config.searchDepth ?? \"basic\",\n          },\n          {\n            provider: \"exa\",\n            apiKey: config.apiKey,\n            includeDomains: config.includeDomains,\n            excludeDomains: config.excludeDomains,\n            includeRawContent: config.includeRawContent,\n            timeout: config.timeout,\n          },\n        );\n\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"]}

package/dist/tools/google/index.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var chunkCEKAYA2Q_cjs = require('../../chunk-CEKAYA2Q.cjs');
+var chunkASV6JLYG_cjs = require('../../chunk-ASV6JLYG.cjs');
+require('../../chunk-CBAHCI4R.cjs');
+require('../../chunk-MEBXW75C.cjs');
+require('../../chunk-W73FBYIH.cjs');
+require('../../chunk-2FAWEBZS.cjs');
+require('../../chunk-6T5XXJEP.cjs');
+require('../../chunk-GANCV72Z.cjs');
+var chunkXWOHNY3F_cjs = require('../../chunk-XWOHNY3F.cjs');
+require('../../chunk-TXLIY7GF.cjs');
+require('../../chunk-JEQ2X3Z6.cjs');
+
+// src/tools/google/index.ts
+function googleSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using Google Search 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",
+    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
+        }
+      },
+      required: ["query"]
+    },
+    needsApproval: false,
+    aiResponseMode: "full",
+    handler: async (params) => {
+      try {
+        const response = await chunkXWOHNY3F_cjs.searchGoogle(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5
+          },
+          {
+            provider: "google",
+            apiKey: config.apiKey,
+            timeout: config.timeout
+          }
+        );
+        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);
+      }
+    }
+  };
+}
+
+Object.defineProperty(exports, "googleProvider", {
+  enumerable: true,
+  get: function () { return chunkXWOHNY3F_cjs.googleProvider; }
+});
+exports.googleSearch = googleSearch;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/tools/google/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/google/index.ts"],"names":["searchGoogle","formatSearchResultsForAI","summarizeSearchResults","failure"],"mappings":";;;;;;;;;;;;;;;AA2FO,SAAS,aACd,MAAA,EACoC;AACpC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IACN,WAAA,EAAa,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qDAAA,CAAA;AAAA,IAOb,QAAA,EAAU,QAAA;AAAA,IAEV,KAAA,EAAO,CAAC,IAAA,KAAS,CAAA,eAAA,EAAkB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,IAC7C,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,uBAAA,EAA0B,KAAK,KAAK,CAAA,IAAA,CAAA;AAAA,IAC9D,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,mBAAA,EAAsB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,IAE1D,WAAA,EAAa;AAAA,MACX,IAAA,EAAM,QAAA;AAAA,MACN,UAAA,EAAY;AAAA,QACV,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EAAa;AAAA,SACf;AAAA,QACA,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EACE,2DAAA;AAAA,UACF,OAAA,EAAS,CAAA;AAAA,UACT,OAAA,EAAS;AAAA;AACX,OACF;AAAA,MACA,QAAA,EAAU,CAAC,OAAO;AAAA,KACpB;AAAA,IAEA,aAAA,EAAe,KAAA;AAAA,IACf,cAAA,EAAgB,MAAA;AAAA,IAEhB,OAAA,EAAS,OAAO,MAAA,KAAW;AACzB,MAAA,IAAI;AACF,QAAA,MAAM,WAA8B,MAAMA,8BAAA;AAAA,UACxC;AAAA,YACE,OAAO,MAAA,CAAO,KAAA;AAAA,YACd,UAAA,EAAY,MAAA,CAAO,UAAA,IAAc,MAAA,CAAO,UAAA,IAAc;AAAA,WACxD;AAAA,UACA;AAAA,YACE,QAAA,EAAU,QAAA;AAAA,YACV,QAAQ,MAAA,CAAO,MAAA;AAAA,YACf,SAAS,MAAA,CAAO;AAAA;AAClB,SACF;AAEA,QAAA,MAAM,SAAA,GAAYC,2CAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAASC,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":"index.cjs","sourcesContent":["/**\n * Google Search Tool\n *\n * Tree-shakeable import for Google's built-in web search via Gemini API.\n * Uses Google's grounding with Google Search feature.\n *\n * @example\n * ```typescript\n * import { googleSearch } from '@yourgpt/copilot-sdk/tools/google';\n *\n * const webSearch = googleSearch({\n *   apiKey: process.env.GOOGLE_API_KEY,\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://ai.google.dev/gemini-api/docs/google-search\n * @module @yourgpt/copilot-sdk/tools/google\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchGoogle,\n  googleProvider,\n} from \"../../core/tools/webSearch/providers/google\";\nimport {\n  formatSearchResultsForAI,\n  summarizeSearchResults,\n} from \"../../core/tools/webSearch\";\nimport type { WebSearchResponse } from \"../../core/tools/webSearch/types\";\n\n// Re-export provider for direct access\nexport { googleProvider };\n\n/**\n * Google native search configuration\n */\nexport interface GoogleSearchConfig {\n  /** Google/Gemini API key - uses your existing Google API key */\n  apiKey: string;\n  /** Maximum number of results (default: 5) */\n  maxResults?: number;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Search parameters passed to the tool\n */\ninterface GoogleSearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n}\n\n/**\n * Create a Google native web search tool\n *\n * Uses Google's built-in grounding with Google Search via the Gemini API.\n * No third-party API key required - uses your existing Google/Gemini API key.\n *\n * @param config - Google configuration including API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { googleSearch } from '@yourgpt/copilot-sdk/tools/google';\n *\n * // Basic usage\n * const webSearch = googleSearch({\n *   apiKey: process.env.GOOGLE_API_KEY,\n * });\n *\n * // Or with Gemini API key\n * const webSearch = googleSearch({\n *   apiKey: process.env.GEMINI_API_KEY,\n *   maxResults: 5,\n * });\n *\n * const runtime = createRuntime({\n *   provider: gemini,\n *   model: 'gemini-2.0-flash',\n *   tools: [webSearch],\n * });\n * ```\n */\nexport function googleSearch(\n  config: GoogleSearchConfig,\n): ToolDefinition<GoogleSearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using Google Search 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\",\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      },\n      required: [\"query\"],\n    },\n\n    needsApproval: false,\n    aiResponseMode: \"full\",\n\n    handler: async (params) => {\n      try {\n        const response: WebSearchResponse = await searchGoogle(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n          },\n          {\n            provider: \"google\",\n            apiKey: config.apiKey,\n            timeout: config.timeout,\n          },\n        );\n\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"]}

package/dist/tools/google/index.d.cts

@@ -0,0 +1,81 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.cjs';
+export { g as googleProvider } from '../../google-CHU2yycE.cjs';
+import '../../types-ZguuKEs_.cjs';
+
+/**
+ * Google Search Tool
+ *
+ * Tree-shakeable import for Google's built-in web search via Gemini API.
+ * Uses Google's grounding with Google Search feature.
+ *
+ * @example
+ * ```typescript
+ * import { googleSearch } from '@yourgpt/copilot-sdk/tools/google';
+ *
+ * const webSearch = googleSearch({
+ *   apiKey: process.env.GOOGLE_API_KEY,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://ai.google.dev/gemini-api/docs/google-search
+ * @module @yourgpt/copilot-sdk/tools/google
+ */
+
+/**
+ * Google native search configuration
+ */
+interface GoogleSearchConfig {
+    /** Google/Gemini API key - uses your existing Google API key */
+    apiKey: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface GoogleSearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+}
+/**
+ * Create a Google native web search tool
+ *
+ * Uses Google's built-in grounding with Google Search via the Gemini API.
+ * No third-party API key required - uses your existing Google/Gemini API key.
+ *
+ * @param config - Google configuration including API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { googleSearch } from '@yourgpt/copilot-sdk/tools/google';
+ *
+ * // Basic usage
+ * const webSearch = googleSearch({
+ *   apiKey: process.env.GOOGLE_API_KEY,
+ * });
+ *
+ * // Or with Gemini API key
+ * const webSearch = googleSearch({
+ *   apiKey: process.env.GEMINI_API_KEY,
+ *   maxResults: 5,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: gemini,
+ *   model: 'gemini-2.0-flash',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function googleSearch(config: GoogleSearchConfig): ToolDefinition<GoogleSearchParams>;
+
+export { type GoogleSearchConfig, googleSearch };