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

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

@@ -0,0 +1,81 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.js';
+export { g as googleProvider } from '../../google-Da8IQxaI.js';
+import '../../types-ZguuKEs_.js';
+
+/**
+ * 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 };

package/dist/tools/google/index.js

@@ -0,0 +1,76 @@
+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 '../../chunk-MNDGIW47.js';
+import '../../chunk-VD74IPKB.js';
+import { searchGoogle } from '../../chunk-53UGJNHN.js';
+export { googleProvider } from '../../chunk-53UGJNHN.js';
+import '../../chunk-RQ74USYU.js';
+import '../../chunk-DGUM43GV.js';
+
+// 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 searchGoogle(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5
+          },
+          {
+            provider: "google",
+            apiKey: config.apiKey,
+            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 { googleSearch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/google/index.ts"],"names":[],"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,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;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 * 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/openai/index.cjs

@@ -0,0 +1,83 @@
+'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');
+var chunkGANCV72Z_cjs = require('../../chunk-GANCV72Z.cjs');
+require('../../chunk-XWOHNY3F.cjs');
+require('../../chunk-TXLIY7GF.cjs');
+require('../../chunk-JEQ2X3Z6.cjs');
+
+// src/tools/openai/index.ts
+function openaiSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using OpenAI's native 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 chunkGANCV72Z_cjs.searchOpenAI(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5
+          },
+          {
+            provider: "openai",
+            apiKey: config.apiKey,
+            includeDomains: config.includeDomains,
+            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";
+        console.error("[OpenAI Search] Error:", errorMessage);
+        return chunkCEKAYA2Q_cjs.failure(errorMessage);
+      }
+    }
+  };
+}
+
+Object.defineProperty(exports, "openaiProvider", {
+  enumerable: true,
+  get: function () { return chunkGANCV72Z_cjs.openaiProvider; }
+});
+exports.openaiSearch = openaiSearch;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/openai/index.ts"],"names":["searchOpenAI","formatSearchResultsForAI","summarizeSearchResults","failure"],"mappings":";;;;;;;;;;;;;;;AA8FO,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,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,OAAA,CAAQ,KAAA,CAAM,0BAA0B,YAAY,CAAA;AACpD,QAAA,OAAOC,0BAAQ,YAAY,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["/**\n * OpenAI Search Tool\n *\n * Tree-shakeable import for OpenAI's built-in web search.\n * Uses OpenAI's Responses API with the web_search tool.\n *\n * @example\n * ```typescript\n * import { openaiSearch } from '@yourgpt/copilot-sdk/tools/openai';\n *\n * const webSearch = openaiSearch({\n *   apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://platform.openai.com/docs/guides/tools-web-search\n * @module @yourgpt/copilot-sdk/tools/openai\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchOpenAI,\n  openaiProvider,\n} from \"../../core/tools/webSearch/providers/openai\";\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 { openaiProvider };\n\n/**\n * OpenAI search configuration\n */\nexport interface OpenAISearchConfig {\n  /** OpenAI API key - uses your existing OpenAI key */\n  apiKey: string;\n  /** Maximum number of results (default: 5) */\n  maxResults?: number;\n  /** Only include results from these domains */\n  includeDomains?: string[];\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Search parameters passed to the tool\n */\ninterface OpenAISearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n}\n\n/**\n * Create an OpenAI web search tool\n *\n * Uses OpenAI's built-in web_search tool via the Responses API.\n * No third-party API key required - uses your existing OpenAI API key.\n *\n * @param config - OpenAI configuration including API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { openaiSearch } from '@yourgpt/copilot-sdk/tools/openai';\n *\n * // Basic usage\n * const webSearch = openaiSearch({\n *   apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * // With domain filtering\n * const webSearch = openaiSearch({\n *   apiKey: process.env.OPENAI_API_KEY,\n *   includeDomains: ['docs.python.org', 'stackoverflow.com'],\n *   maxResults: 5,\n * });\n *\n * const runtime = createRuntime({\n *   provider: openai,\n *   model: 'gpt-4o',\n *   tools: [webSearch],\n * });\n * ```\n */\nexport function openaiSearch(\n  config: OpenAISearchConfig,\n): ToolDefinition<OpenAISearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using OpenAI's native 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 searchOpenAI(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n          },\n          {\n            provider: \"openai\",\n            apiKey: config.apiKey,\n            includeDomains: config.includeDomains,\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        console.error(\"[OpenAI Search] Error:\", errorMessage);\n        return failure(errorMessage);\n      }\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,84 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.cjs';
+export { o as openaiProvider } from '../../openai-HVSCuXgO.cjs';
+import '../../types-ZguuKEs_.cjs';
+
+/**
+ * OpenAI Search Tool
+ *
+ * Tree-shakeable import for OpenAI's built-in web search.
+ * Uses OpenAI's Responses API with the web_search tool.
+ *
+ * @example
+ * ```typescript
+ * import { openaiSearch } from '@yourgpt/copilot-sdk/tools/openai';
+ *
+ * const webSearch = openaiSearch({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://platform.openai.com/docs/guides/tools-web-search
+ * @module @yourgpt/copilot-sdk/tools/openai
+ */
+
+/**
+ * OpenAI search configuration
+ */
+interface OpenAISearchConfig {
+    /** OpenAI API key - uses your existing OpenAI key */
+    apiKey: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Only include results from these domains */
+    includeDomains?: string[];
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface OpenAISearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+}
+/**
+ * Create an OpenAI web search tool
+ *
+ * Uses OpenAI's built-in web_search tool via the Responses API.
+ * No third-party API key required - uses your existing OpenAI API key.
+ *
+ * @param config - OpenAI configuration including API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { openaiSearch } from '@yourgpt/copilot-sdk/tools/openai';
+ *
+ * // Basic usage
+ * const webSearch = openaiSearch({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ * });
+ *
+ * // With domain filtering
+ * const webSearch = openaiSearch({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ *   includeDomains: ['docs.python.org', 'stackoverflow.com'],
+ *   maxResults: 5,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: openai,
+ *   model: 'gpt-4o',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function openaiSearch(config: OpenAISearchConfig): ToolDefinition<OpenAISearchParams>;
+
+export { type OpenAISearchConfig, openaiSearch };

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

@@ -0,0 +1,84 @@
+import { T as ToolDefinition } from '../../tools-DDWrco4h.js';
+export { o as openaiProvider } from '../../openai-Cam8hF4f.js';
+import '../../types-ZguuKEs_.js';
+
+/**
+ * OpenAI Search Tool
+ *
+ * Tree-shakeable import for OpenAI's built-in web search.
+ * Uses OpenAI's Responses API with the web_search tool.
+ *
+ * @example
+ * ```typescript
+ * import { openaiSearch } from '@yourgpt/copilot-sdk/tools/openai';
+ *
+ * const webSearch = openaiSearch({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ *
+ * @see https://platform.openai.com/docs/guides/tools-web-search
+ * @module @yourgpt/copilot-sdk/tools/openai
+ */
+
+/**
+ * OpenAI search configuration
+ */
+interface OpenAISearchConfig {
+    /** OpenAI API key - uses your existing OpenAI key */
+    apiKey: string;
+    /** Maximum number of results (default: 5) */
+    maxResults?: number;
+    /** Only include results from these domains */
+    includeDomains?: string[];
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Search parameters passed to the tool
+ */
+interface OpenAISearchParams {
+    /** The search query */
+    query: string;
+    /** Maximum number of results (overrides config) */
+    maxResults?: number;
+}
+/**
+ * Create an OpenAI web search tool
+ *
+ * Uses OpenAI's built-in web_search tool via the Responses API.
+ * No third-party API key required - uses your existing OpenAI API key.
+ *
+ * @param config - OpenAI configuration including API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * import { openaiSearch } from '@yourgpt/copilot-sdk/tools/openai';
+ *
+ * // Basic usage
+ * const webSearch = openaiSearch({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ * });
+ *
+ * // With domain filtering
+ * const webSearch = openaiSearch({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ *   includeDomains: ['docs.python.org', 'stackoverflow.com'],
+ *   maxResults: 5,
+ * });
+ *
+ * const runtime = createRuntime({
+ *   provider: openai,
+ *   model: 'gpt-4o',
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+declare function openaiSearch(config: OpenAISearchConfig): ToolDefinition<OpenAISearchParams>;
+
+export { type OpenAISearchConfig, openaiSearch };

package/dist/tools/openai/index.js

@@ -0,0 +1,78 @@
+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 '../../chunk-MNDGIW47.js';
+import { searchOpenAI } from '../../chunk-VD74IPKB.js';
+export { openaiProvider } from '../../chunk-VD74IPKB.js';
+import '../../chunk-53UGJNHN.js';
+import '../../chunk-RQ74USYU.js';
+import '../../chunk-DGUM43GV.js';
+
+// src/tools/openai/index.ts
+function openaiSearch(config) {
+  return {
+    name: "web_search",
+    description: `Search the web using OpenAI's native 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 searchOpenAI(
+          {
+            query: params.query,
+            maxResults: params.maxResults ?? config.maxResults ?? 5
+          },
+          {
+            provider: "openai",
+            apiKey: config.apiKey,
+            includeDomains: config.includeDomains,
+            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";
+        console.error("[OpenAI Search] Error:", errorMessage);
+        return failure(errorMessage);
+      }
+    }
+  };
+}
+
+export { openaiSearch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/openai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AA8FO,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,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,OAAA,CAAQ,KAAA,CAAM,0BAA0B,YAAY,CAAA;AACpD,QAAA,OAAO,QAAQ,YAAY,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,GACF;AACF","file":"index.js","sourcesContent":["/**\n * OpenAI Search Tool\n *\n * Tree-shakeable import for OpenAI's built-in web search.\n * Uses OpenAI's Responses API with the web_search tool.\n *\n * @example\n * ```typescript\n * import { openaiSearch } from '@yourgpt/copilot-sdk/tools/openai';\n *\n * const webSearch = openaiSearch({\n *   apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * const runtime = createRuntime({\n *   tools: [webSearch],\n * });\n * ```\n *\n * @see https://platform.openai.com/docs/guides/tools-web-search\n * @module @yourgpt/copilot-sdk/tools/openai\n */\n\nimport type { ToolDefinition } from \"../../core/types/tools\";\nimport { failure } from \"../../core/types/tools\";\nimport {\n  searchOpenAI,\n  openaiProvider,\n} from \"../../core/tools/webSearch/providers/openai\";\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 { openaiProvider };\n\n/**\n * OpenAI search configuration\n */\nexport interface OpenAISearchConfig {\n  /** OpenAI API key - uses your existing OpenAI key */\n  apiKey: string;\n  /** Maximum number of results (default: 5) */\n  maxResults?: number;\n  /** Only include results from these domains */\n  includeDomains?: string[];\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Search parameters passed to the tool\n */\ninterface OpenAISearchParams {\n  /** The search query */\n  query: string;\n  /** Maximum number of results (overrides config) */\n  maxResults?: number;\n}\n\n/**\n * Create an OpenAI web search tool\n *\n * Uses OpenAI's built-in web_search tool via the Responses API.\n * No third-party API key required - uses your existing OpenAI API key.\n *\n * @param config - OpenAI configuration including API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * import { openaiSearch } from '@yourgpt/copilot-sdk/tools/openai';\n *\n * // Basic usage\n * const webSearch = openaiSearch({\n *   apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * // With domain filtering\n * const webSearch = openaiSearch({\n *   apiKey: process.env.OPENAI_API_KEY,\n *   includeDomains: ['docs.python.org', 'stackoverflow.com'],\n *   maxResults: 5,\n * });\n *\n * const runtime = createRuntime({\n *   provider: openai,\n *   model: 'gpt-4o',\n *   tools: [webSearch],\n * });\n * ```\n */\nexport function openaiSearch(\n  config: OpenAISearchConfig,\n): ToolDefinition<OpenAISearchParams> {\n  return {\n    name: \"web_search\",\n    description: `Search the web using OpenAI's native 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 searchOpenAI(\n          {\n            query: params.query,\n            maxResults: params.maxResults ?? config.maxResults ?? 5,\n          },\n          {\n            provider: \"openai\",\n            apiKey: config.apiKey,\n            includeDomains: config.includeDomains,\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        console.error(\"[OpenAI Search] Error:\", errorMessage);\n        return failure(errorMessage);\n      }\n    },\n  };\n}\n"]}

package/dist/tools/searxng/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');
+require('../../chunk-MEBXW75C.cjs');
+require('../../chunk-W73FBYIH.cjs');
+var chunk2FAWEBZS_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/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 chunk2FAWEBZS_cjs.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 = 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, "searxngProvider", {
+  enumerable: true,
+  get: function () { return chunk2FAWEBZS_cjs.searxngProvider; }
+});
+exports.searxngSearch = searxngSearch;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/tools/searxng/index.ts"],"names":["searchSearxng","formatSearchResultsForAI","summarizeSearchResults","failure"],"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,MAAMA,+BAAA;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,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 * 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"]}