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

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

@@ -0,0 +1,91 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.cjs';
+export { s as searxngProvider } from '../../searxng-QGOte_Gq.cjs';
+import '../../types-ZguuKEs_.cjs';
+
+/**
+ * SearXNG Search Tool
+ *
+ * Tree-shakeable import for SearXNG web search provider.
+ * Only imports SearXNG code - no other providers bundled.
+ *
+ * @example
+ * ```typescript
+ * import { searxngSearch } from '@yourgpt/copilot-sdk/tools/searxng';
+ *
+ * const webSearch = searxngSearch({
+ *   baseUrl: 'https://your-searxng-instance.com',
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://docs.searxng.org/
+ * @module @yourgpt/copilot-sdk/tools/searxng
+ */
+
+/**
+ * SearXNG search configuration
+ */
+interface SearxngSearchConfig {
+    /** Base URL of your SearXNG instance (e.g., 'https://searx.example.com') */
+    baseUrl: string;
+    /** Optional API key if your instance requires authentication */
+    apiKey?: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Language code for results (e.g., 'en', 'es', 'fr') */
+    language?: string;
+    /** Only include results from these domains */
+    includeDomains?: string[];
+    /** Exclude results from these domains */
+    excludeDomains?: string[];
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface SearxngSearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+}
+/**
+ * Create a SearXNG web search tool
+ *
+ * SearXNG is a privacy-respecting, self-hostable metasearch engine.
+ * It aggregates results from multiple search engines without tracking.
+ *
+ * @param config - SearXNG configuration including instance URL
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { searxngSearch } from '@yourgpt/copilot-sdk/tools/searxng';
+ *
+ * // Basic usage with self-hosted instance
+ * const webSearch = searxngSearch({
+ *   baseUrl: 'https://your-searxng-instance.com',
+ * });
+ *
+ * // With authentication
+ * const webSearch = searxngSearch({
+ *   baseUrl: 'https://your-searxng-instance.com',
+ *   apiKey: process.env.SEARXNG_API_KEY,
+ *   language: 'en',
+ *   maxResults: 10,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: openai,
+ *   model: 'gpt-4o',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function searxngSearch(config: SearxngSearchConfig): ToolDefinition<SearxngSearchParams>;
+
+export { type SearxngSearchConfig, searxngSearch };

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

@@ -0,0 +1,91 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.js';
+export { s as searxngProvider } from '../../searxng-K0qtY9vp.js';
+import '../../types-ZguuKEs_.js';
+
+/**
+ * SearXNG Search Tool
+ *
+ * Tree-shakeable import for SearXNG web search provider.
+ * Only imports SearXNG code - no other providers bundled.
+ *
+ * @example
+ * ```typescript
+ * import { searxngSearch } from '@yourgpt/copilot-sdk/tools/searxng';
+ *
+ * const webSearch = searxngSearch({
+ *   baseUrl: 'https://your-searxng-instance.com',
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://docs.searxng.org/
+ * @module @yourgpt/copilot-sdk/tools/searxng
+ */
+
+/**
+ * SearXNG search configuration
+ */
+interface SearxngSearchConfig {
+    /** Base URL of your SearXNG instance (e.g., 'https://searx.example.com') */
+    baseUrl: string;
+    /** Optional API key if your instance requires authentication */
+    apiKey?: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Language code for results (e.g., 'en', 'es', 'fr') */
+    language?: string;
+    /** Only include results from these domains */
+    includeDomains?: string[];
+    /** Exclude results from these domains */
+    excludeDomains?: string[];
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface SearxngSearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+}
+/**
+ * Create a SearXNG web search tool
+ *
+ * SearXNG is a privacy-respecting, self-hostable metasearch engine.
+ * It aggregates results from multiple search engines without tracking.
+ *
+ * @param config - SearXNG configuration including instance URL
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { searxngSearch } from '@yourgpt/copilot-sdk/tools/searxng';
+ *
+ * // Basic usage with self-hosted instance
+ * const webSearch = searxngSearch({
+ *   baseUrl: 'https://your-searxng-instance.com',
+ * });
+ *
+ * // With authentication
+ * const webSearch = searxngSearch({
+ *   baseUrl: 'https://your-searxng-instance.com',
+ *   apiKey: process.env.SEARXNG_API_KEY,
+ *   language: 'en',
+ *   maxResults: 10,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: openai,
+ *   model: 'gpt-4o',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function searxngSearch(config: SearxngSearchConfig): ToolDefinition<SearxngSearchParams>;
+
+export { type SearxngSearchConfig, searxngSearch };

package/dist/tools/searxng/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 '../../chunk-PPFHA6IL.js';
+import { searchSearxng } from '../../chunk-DABZYCVX.js';
+export { searxngProvider } from '../../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/searxng/index.ts
+function searxngSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using SearXNG 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 searchSearxng(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5
+          },
+          {
+            provider: "searxng",
+            baseUrl: config.baseUrl,
+            apiKey: config.apiKey,
+            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 { searxngSearch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/searxng/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAqGO,SAAS,cACd,MAAA,EACqC;AACrC,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,aAAA;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,SAAA;AAAA,YACV,SAAS,MAAA,CAAO,OAAA;AAAA,YAChB,QAAQ,MAAA,CAAO,MAAA;AAAA,YACf,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 * SearXNG Search Tool\n *\n * Tree-shakeable import for SearXNG web search provider.\n * Only imports SearXNG code - no other providers bundled.\n *\n * @example\n * ```typescript\n * import { searxngSearch } from '@yourgpt/copilot-sdk/tools/searxng';\n *\n * const webSearch = searxngSearch({\n *   baseUrl: 'https://your-searxng-instance.com',\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://docs.searxng.org/\n * @module @yourgpt/copilot-sdk/tools/searxng\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchSearxng,\n  searxngProvider,\n} from \"../../core/tools/webSearch/providers/searxng\";\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 { searxngProvider };\n\n/**\n * SearXNG search configuration\n */\nexport interface SearxngSearchConfig {\n  /** Base URL of your SearXNG instance (e.g., 'https://searx.example.com') */\n  baseUrl: string;\n  /** Optional API key if your instance requires authentication */\n  apiKey?: string;\n  /** Maximum number of results (default: 5) */\n  maxResults?: number;\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 SearxngSearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n}\n\n/**\n * Create a SearXNG web search tool\n *\n * SearXNG is a privacy-respecting, self-hostable metasearch engine.\n * It aggregates results from multiple search engines without tracking.\n *\n * @param config - SearXNG configuration including instance URL\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { searxngSearch } from '@yourgpt/copilot-sdk/tools/searxng';\n *\n * // Basic usage with self-hosted instance\n * const webSearch = searxngSearch({\n *   baseUrl: 'https://your-searxng-instance.com',\n * });\n *\n * // With authentication\n * const webSearch = searxngSearch({\n *   baseUrl: 'https://your-searxng-instance.com',\n *   apiKey: process.env.SEARXNG_API_KEY,\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 searxngSearch(\n  config: SearxngSearchConfig,\n): ToolDefinition<SearxngSearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using SearXNG 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 searchSearxng(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n          },\n          {\n            provider: \"searxng\",\n            baseUrl: config.baseUrl,\n            apiKey: config.apiKey,\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/serper/index.cjs

@@ -0,0 +1,85 @@
+'use strict';
+
+var chunkCEKAYA2Q_cjs = require('../../chunk-CEKAYA2Q.cjs');
+var chunkASV6JLYG_cjs = require('../../chunk-ASV6JLYG.cjs');
+require('../../chunk-CBAHCI4R.cjs');
+var chunkMEBXW75C_cjs = require('../../chunk-MEBXW75C.cjs');
+require('../../chunk-W73FBYIH.cjs');
+require('../../chunk-2FAWEBZS.cjs');
+require('../../chunk-6T5XXJEP.cjs');
+require('../../chunk-GANCV72Z.cjs');
+require('../../chunk-XWOHNY3F.cjs');
+require('../../chunk-TXLIY7GF.cjs');
+require('../../chunk-JEQ2X3Z6.cjs');
+
+// src/tools/serper/index.ts
+function serperSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using Serper (Google results) 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 chunkMEBXW75C_cjs.searchSerper(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5
+          },
+          {
+            provider: "serper",
+            apiKey: config.apiKey,
+            country: config.country,
+            language: config.language,
+            includeDomains: config.includeDomains,
+            excludeDomains: config.excludeDomains,
+            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, "serperProvider", {
+  enumerable: true,
+  get: function () { return chunkMEBXW75C_cjs.serperProvider; }
+});
+exports.serperSearch = serperSearch;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/serper/index.ts"],"names":["searchSerper","formatSearchResultsForAI","summarizeSearchResults","failure"],"mappings":";;;;;;;;;;;;;;;AAqGO,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,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,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 * Serper Search Tool\n *\n * Tree-shakeable import for Serper web search provider.\n * Only imports Serper code - no other providers bundled.\n *\n * @example\n * ```typescript\n * import { serperSearch } from '@yourgpt/copilot-sdk/tools/serper';\n *\n * const webSearch = serperSearch({\n *   apiKey: process.env.SERPER_API_KEY,\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://serper.dev/\n * @module @yourgpt/copilot-sdk/tools/serper\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchSerper,\n  serperProvider,\n} from \"../../core/tools/webSearch/providers/serper\";\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 { serperProvider };\n\n/**\n * Serper search configuration\n */\nexport interface SerperSearchConfig {\n  /** Serper API key - get one at https://serper.dev/ */\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 SerperSearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n}\n\n/**\n * Create a Serper web search tool\n *\n * Serper is a Google Search API that provides SERP data.\n * Fast and cost-effective for real-time Google results.\n *\n * @param config - Serper configuration including API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { serperSearch } from '@yourgpt/copilot-sdk/tools/serper';\n *\n * // Basic usage\n * const webSearch = serperSearch({\n *   apiKey: process.env.SERPER_API_KEY,\n * });\n *\n * // With locale settings\n * const webSearch = serperSearch({\n *   apiKey: process.env.SERPER_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 serperSearch(\n  config: SerperSearchConfig,\n): ToolDefinition<SerperSearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using Serper (Google results) 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 searchSerper(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n          },\n          {\n            provider: \"serper\",\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/serper/index.d.cts

@@ -0,0 +1,91 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.cjs';
+export { s as serperProvider } from '../../serper-JzdaSnS9.cjs';
+import '../../types-ZguuKEs_.cjs';
+
+/**
+ * Serper Search Tool
+ *
+ * Tree-shakeable import for Serper web search provider.
+ * Only imports Serper code - no other providers bundled.
+ *
+ * @example
+ * ```typescript
+ * import { serperSearch } from '@yourgpt/copilot-sdk/tools/serper';
+ *
+ * const webSearch = serperSearch({
+ *   apiKey: process.env.SERPER_API_KEY,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://serper.dev/
+ * @module @yourgpt/copilot-sdk/tools/serper
+ */
+
+/**
+ * Serper search configuration
+ */
+interface SerperSearchConfig {
+    /** Serper API key - get one at https://serper.dev/ */
+    apiKey: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Country code for localized results (e.g., 'us', 'gb', 'de') */
+    country?: string;
+    /** Language code for results (e.g., 'en', 'es', 'fr') */
+    language?: string;
+    /** Only include results from these domains */
+    includeDomains?: string[];
+    /** Exclude results from these domains */
+    excludeDomains?: string[];
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface SerperSearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+}
+/**
+ * Create a Serper web search tool
+ *
+ * Serper is a Google Search API that provides SERP data.
+ * Fast and cost-effective for real-time Google results.
+ *
+ * @param config - Serper configuration including API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { serperSearch } from '@yourgpt/copilot-sdk/tools/serper';
+ *
+ * // Basic usage
+ * const webSearch = serperSearch({
+ *   apiKey: process.env.SERPER_API_KEY,
+ * });
+ *
+ * // With locale settings
+ * const webSearch = serperSearch({
+ *   apiKey: process.env.SERPER_API_KEY,
+ *   country: 'us',
+ *   language: 'en',
+ *   maxResults: 10,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: openai,
+ *   model: 'gpt-4o',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function serperSearch(config: SerperSearchConfig): ToolDefinition<SerperSearchParams>;
+
+export { type SerperSearchConfig, serperSearch };

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

@@ -0,0 +1,91 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.js';
+export { s as serperProvider } from '../../serper-7Czya3PW.js';
+import '../../types-ZguuKEs_.js';
+
+/**
+ * Serper Search Tool
+ *
+ * Tree-shakeable import for Serper web search provider.
+ * Only imports Serper code - no other providers bundled.
+ *
+ * @example
+ * ```typescript
+ * import { serperSearch } from '@yourgpt/copilot-sdk/tools/serper';
+ *
+ * const webSearch = serperSearch({
+ *   apiKey: process.env.SERPER_API_KEY,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://serper.dev/
+ * @module @yourgpt/copilot-sdk/tools/serper
+ */
+
+/**
+ * Serper search configuration
+ */
+interface SerperSearchConfig {
+    /** Serper API key - get one at https://serper.dev/ */
+    apiKey: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Country code for localized results (e.g., 'us', 'gb', 'de') */
+    country?: string;
+    /** Language code for results (e.g., 'en', 'es', 'fr') */
+    language?: string;
+    /** Only include results from these domains */
+    includeDomains?: string[];
+    /** Exclude results from these domains */
+    excludeDomains?: string[];
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface SerperSearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+}
+/**
+ * Create a Serper web search tool
+ *
+ * Serper is a Google Search API that provides SERP data.
+ * Fast and cost-effective for real-time Google results.
+ *
+ * @param config - Serper configuration including API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { serperSearch } from '@yourgpt/copilot-sdk/tools/serper';
+ *
+ * // Basic usage
+ * const webSearch = serperSearch({
+ *   apiKey: process.env.SERPER_API_KEY,
+ * });
+ *
+ * // With locale settings
+ * const webSearch = serperSearch({
+ *   apiKey: process.env.SERPER_API_KEY,
+ *   country: 'us',
+ *   language: 'en',
+ *   maxResults: 10,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: openai,
+ *   model: 'gpt-4o',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function serperSearch(config: SerperSearchConfig): ToolDefinition<SerperSearchParams>;
+
+export { type SerperSearchConfig, serperSearch };

package/dist/tools/serper/index.js

@@ -0,0 +1,80 @@
+import { failure } from '../../chunk-BKO7DSPU.js';
+import { formatSearchResultsForAI, summarizeSearchResults } from '../../chunk-XGITAEXU.js';
+import '../../chunk-7W7QLZNC.js';
+import { searchSerper } from '../../chunk-CEOMTQTP.js';
+export { serperProvider } from '../../chunk-CEOMTQTP.js';
+import '../../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/serper/index.ts
+function serperSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using Serper (Google results) 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 searchSerper(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5
+          },
+          {
+            provider: "serper",
+            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 { serperSearch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/serper/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAqGO,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,MAAM,YAAA;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,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 * Serper Search Tool\n *\n * Tree-shakeable import for Serper web search provider.\n * Only imports Serper code - no other providers bundled.\n *\n * @example\n * ```typescript\n * import { serperSearch } from '@yourgpt/copilot-sdk/tools/serper';\n *\n * const webSearch = serperSearch({\n *   apiKey: process.env.SERPER_API_KEY,\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://serper.dev/\n * @module @yourgpt/copilot-sdk/tools/serper\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchSerper,\n  serperProvider,\n} from \"../../core/tools/webSearch/providers/serper\";\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 { serperProvider };\n\n/**\n * Serper search configuration\n */\nexport interface SerperSearchConfig {\n  /** Serper API key - get one at https://serper.dev/ */\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 SerperSearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n}\n\n/**\n * Create a Serper web search tool\n *\n * Serper is a Google Search API that provides SERP data.\n * Fast and cost-effective for real-time Google results.\n *\n * @param config - Serper configuration including API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { serperSearch } from '@yourgpt/copilot-sdk/tools/serper';\n *\n * // Basic usage\n * const webSearch = serperSearch({\n *   apiKey: process.env.SERPER_API_KEY,\n * });\n *\n * // With locale settings\n * const webSearch = serperSearch({\n *   apiKey: process.env.SERPER_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 serperSearch(\n  config: SerperSearchConfig,\n): ToolDefinition<SerperSearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using Serper (Google results) 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 searchSerper(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n          },\n          {\n            provider: \"serper\",\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"]}