@yourgpt/copilot-sdk 2.1.3 → 2.1.5-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/dist/MessageTree-CoIt_4nB.d.cts +161 -0
  2. package/dist/MessageTree-CzaN9Eul.d.ts +161 -0
  3. package/dist/{ThreadManager-Dkp_eLty.d.ts → ThreadManager-BEAECB7Y.d.ts} +1 -1
  4. package/dist/{ThreadManager-LfFRhr4e.d.cts → ThreadManager-Cw5fwyCN.d.cts} +1 -1
  5. package/dist/{chunk-POZNNKNJ.cjs → chunk-246B6X5D.cjs} +8 -2
  6. package/dist/chunk-246B6X5D.cjs.map +1 -0
  7. package/dist/{chunk-QLH6TSCC.js → chunk-4QXY2PBG.js} +8 -2
  8. package/dist/chunk-4QXY2PBG.js.map +1 -0
  9. package/dist/{chunk-DMBFN7KO.js → chunk-6BMQZIS3.js} +3105 -355
  10. package/dist/chunk-6BMQZIS3.js.map +1 -0
  11. package/dist/{chunk-R6LKHKAI.cjs → chunk-76RE7AJE.cjs} +3277 -509
  12. package/dist/chunk-76RE7AJE.cjs.map +1 -0
  13. package/dist/chunk-BJYA5NDL.cjs +96 -0
  14. package/dist/chunk-BJYA5NDL.cjs.map +1 -0
  15. package/dist/{chunk-LZMBBGWH.js → chunk-ENFWM3EY.js} +4 -4
  16. package/dist/{chunk-LZMBBGWH.js.map → chunk-ENFWM3EY.js.map} +1 -1
  17. package/dist/{chunk-WQSK3Z4K.cjs → chunk-I3SQUNTT.cjs} +81 -31
  18. package/dist/chunk-I3SQUNTT.cjs.map +1 -0
  19. package/dist/{chunk-WAPGTQDR.cjs → chunk-JKGFQUHJ.cjs} +10 -10
  20. package/dist/{chunk-WAPGTQDR.cjs.map → chunk-JKGFQUHJ.cjs.map} +1 -1
  21. package/dist/{chunk-XGITAEXU.js → chunk-LLM7AHMO.js} +2 -2
  22. package/dist/{chunk-XGITAEXU.js.map → chunk-LLM7AHMO.js.map} +1 -1
  23. package/dist/{chunk-ASV6JLYG.cjs → chunk-NUXLAZOE.cjs} +2 -2
  24. package/dist/{chunk-ASV6JLYG.cjs.map → chunk-NUXLAZOE.cjs.map} +1 -1
  25. package/dist/{chunk-VFV5FVVI.js → chunk-UXJ6LIZB.js} +61 -13
  26. package/dist/chunk-UXJ6LIZB.js.map +1 -0
  27. package/dist/chunk-VNLLW3ZI.js +94 -0
  28. package/dist/chunk-VNLLW3ZI.js.map +1 -0
  29. package/dist/core/index.cjs +99 -91
  30. package/dist/core/index.d.cts +21 -10
  31. package/dist/core/index.d.ts +21 -10
  32. package/dist/core/index.js +5 -5
  33. package/dist/{index-BHkRA0mM.d.cts → index-CiExk87c.d.cts} +1 -1
  34. package/dist/{index-tB0qI8my.d.ts → index-Dwrcf-CP.d.ts} +1 -1
  35. package/dist/mcp/index.d.cts +3 -3
  36. package/dist/mcp/index.d.ts +3 -3
  37. package/dist/react/index.cjs +113 -52
  38. package/dist/react/index.d.cts +703 -90
  39. package/dist/react/index.d.ts +703 -90
  40. package/dist/react/index.js +7 -6
  41. package/dist/server/index.cjs +339 -0
  42. package/dist/server/index.cjs.map +1 -0
  43. package/dist/server/index.d.cts +171 -0
  44. package/dist/server/index.d.ts +171 -0
  45. package/dist/server/index.js +332 -0
  46. package/dist/server/index.js.map +1 -0
  47. package/dist/tools/anthropic/index.cjs +3 -3
  48. package/dist/tools/anthropic/index.d.cts +1 -1
  49. package/dist/tools/anthropic/index.d.ts +1 -1
  50. package/dist/tools/anthropic/index.js +3 -3
  51. package/dist/tools/brave/index.cjs +6 -6
  52. package/dist/tools/brave/index.d.cts +1 -1
  53. package/dist/tools/brave/index.d.ts +1 -1
  54. package/dist/tools/brave/index.js +3 -3
  55. package/dist/tools/exa/index.cjs +6 -6
  56. package/dist/tools/exa/index.d.cts +1 -1
  57. package/dist/tools/exa/index.d.ts +1 -1
  58. package/dist/tools/exa/index.js +3 -3
  59. package/dist/tools/google/index.cjs +6 -6
  60. package/dist/tools/google/index.d.cts +1 -1
  61. package/dist/tools/google/index.d.ts +1 -1
  62. package/dist/tools/google/index.js +3 -3
  63. package/dist/tools/openai/index.cjs +6 -6
  64. package/dist/tools/openai/index.d.cts +1 -1
  65. package/dist/tools/openai/index.d.ts +1 -1
  66. package/dist/tools/openai/index.js +3 -3
  67. package/dist/tools/searxng/index.cjs +6 -6
  68. package/dist/tools/searxng/index.d.cts +1 -1
  69. package/dist/tools/searxng/index.d.ts +1 -1
  70. package/dist/tools/searxng/index.js +3 -3
  71. package/dist/tools/serper/index.cjs +6 -6
  72. package/dist/tools/serper/index.d.cts +1 -1
  73. package/dist/tools/serper/index.d.ts +1 -1
  74. package/dist/tools/serper/index.js +3 -3
  75. package/dist/tools/tavily/index.cjs +6 -6
  76. package/dist/tools/tavily/index.d.cts +1 -1
  77. package/dist/tools/tavily/index.d.ts +1 -1
  78. package/dist/tools/tavily/index.js +3 -3
  79. package/dist/tools/web-search/index.cjs +7 -7
  80. package/dist/tools/web-search/index.d.cts +2 -2
  81. package/dist/tools/web-search/index.d.ts +2 -2
  82. package/dist/tools/web-search/index.js +4 -4
  83. package/dist/{tools-coIcskZ4.d.ts → tools-DHZhF5km.d.cts} +161 -1
  84. package/dist/{tools-coIcskZ4.d.cts → tools-DHZhF5km.d.ts} +161 -1
  85. package/dist/{types-rjaSVmEF.d.ts → types-BTyJu0WD.d.ts} +1 -1
  86. package/dist/types-BckL3hiw.d.cts +93 -0
  87. package/dist/types-BckL3hiw.d.ts +93 -0
  88. package/dist/{types-C8t4Ut8f.d.cts → types-BdX7uPj0.d.cts} +1 -1
  89. package/dist/{types-DG2ya08y.d.ts → types-BeFBBZ5i.d.cts} +64 -1
  90. package/dist/{types-DG2ya08y.d.cts → types-BeFBBZ5i.d.ts} +64 -1
  91. package/dist/ui/index.cjs +468 -163
  92. package/dist/ui/index.cjs.map +1 -1
  93. package/dist/ui/index.d.cts +81 -4
  94. package/dist/ui/index.d.ts +81 -4
  95. package/dist/ui/index.js +416 -112
  96. package/dist/ui/index.js.map +1 -1
  97. package/package.json +6 -1
  98. package/dist/chunk-DMBFN7KO.js.map +0 -1
  99. package/dist/chunk-POZNNKNJ.cjs.map +0 -1
  100. package/dist/chunk-QLH6TSCC.js.map +0 -1
  101. package/dist/chunk-R6LKHKAI.cjs.map +0 -1
  102. package/dist/chunk-VFV5FVVI.js.map +0 -1
  103. package/dist/chunk-WQSK3Z4K.cjs.map +0 -1
@@ -1,10 +1,10 @@
1
1
  'use strict';
2
2
 
3
- var chunkPOZNNKNJ_cjs = require('./chunk-POZNNKNJ.cjs');
4
- var chunkASV6JLYG_cjs = require('./chunk-ASV6JLYG.cjs');
3
+ var chunk246B6X5D_cjs = require('./chunk-246B6X5D.cjs');
4
+ var chunkNUXLAZOE_cjs = require('./chunk-NUXLAZOE.cjs');
5
5
 
6
6
  // src/core/tools/builtin/webSearch.ts
7
- var webSearchTool = chunkPOZNNKNJ_cjs.tool({
7
+ var webSearchTool = chunk246B6X5D_cjs.tool({
8
8
  description: `Search the web for current information. Use this when the user asks about:
9
9
  - Recent events, news, or current affairs
10
10
  - Real-time data (prices, weather, stocks, sports scores)
@@ -44,7 +44,7 @@ var webSearchTool = chunkPOZNNKNJ_cjs.tool({
44
44
  aiContext: (result, args) => {
45
45
  if (!result.success) return `Search failed: ${result.error}`;
46
46
  const data = result.data;
47
- return chunkASV6JLYG_cjs.formatSearchResultsForAI(data);
47
+ return chunkNUXLAZOE_cjs.formatSearchResultsForAI(data);
48
48
  }
49
49
  });
50
50
  function createWebSearchTool(config) {
@@ -53,7 +53,7 @@ function createWebSearchTool(config) {
53
53
  ...webSearchTool,
54
54
  handler: async (params) => {
55
55
  try {
56
- const response = await chunkASV6JLYG_cjs.executeWebSearch(
56
+ const response = await chunkNUXLAZOE_cjs.executeWebSearch(
57
57
  {
58
58
  query: params.query,
59
59
  maxResults: params.maxResults ?? config.maxResults ?? 5,
@@ -61,16 +61,16 @@ function createWebSearchTool(config) {
61
61
  },
62
62
  config
63
63
  );
64
- const aiContext = chunkASV6JLYG_cjs.formatSearchResultsForAI(response);
64
+ const aiContext = chunkNUXLAZOE_cjs.formatSearchResultsForAI(response);
65
65
  return {
66
66
  success: true,
67
- message: chunkASV6JLYG_cjs.summarizeSearchResults(response),
67
+ message: chunkNUXLAZOE_cjs.summarizeSearchResults(response),
68
68
  data: response,
69
69
  _aiContext: aiContext
70
70
  };
71
71
  } catch (error) {
72
72
  const errorMessage = error instanceof Error ? error.message : "Web search failed";
73
- return chunkPOZNNKNJ_cjs.failure(errorMessage);
73
+ return chunk246B6X5D_cjs.failure(errorMessage);
74
74
  }
75
75
  }
76
76
  };
@@ -78,5 +78,5 @@ function createWebSearchTool(config) {
78
78
 
79
79
  exports.createWebSearchTool = createWebSearchTool;
80
80
  exports.webSearchTool = webSearchTool;
81
- //# sourceMappingURL=chunk-WAPGTQDR.cjs.map
82
- //# sourceMappingURL=chunk-WAPGTQDR.cjs.map
81
+ //# sourceMappingURL=chunk-JKGFQUHJ.cjs.map
82
+ //# sourceMappingURL=chunk-JKGFQUHJ.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/core/tools/builtin/webSearch.ts"],"names":["tool","formatSearchResultsForAI","executeWebSearch","summarizeSearchResults","failure"],"mappings":";;;;;;AAoDO,IAAM,gBAAgBA,sBAAA,CAAsB;AAAA,EACjD,WAAA,EAAa,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qDAAA,CAAA;AAAA,EAOb,QAAA,EAAU,QAAA;AAAA;AAAA,EAEV,KAAA,EAAO,CAAC,IAAA,KAAS,CAAA,eAAA,EAAkB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,EAC7C,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,uBAAA,EAA0B,KAAK,KAAK,CAAA,IAAA,CAAA;AAAA,EAC9D,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,mBAAA,EAAsB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,EAE1D,WAAA,EAAa;AAAA,IACX,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,KAAA,EAAO;AAAA,QACL,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EACE,2DAAA;AAAA,QACF,OAAA,EAAS,CAAA;AAAA,QACT,OAAA,EAAS;AAAA,OACX;AAAA,MACA,WAAA,EAAa;AAAA,QACX,IAAA,EAAM,QAAA;AAAA,QACN,IAAA,EAAM,CAAC,OAAA,EAAS,UAAU,CAAA;AAAA,QAC1B,WAAA,EACE;AAAA;AACJ,KACF;AAAA,IACA,QAAA,EAAU,CAAC,OAAO;AAAA,GACpB;AAAA,EAEA,aAAA,EAAe,KAAA;AAAA;AAAA;AAAA,EAGf,cAAA,EAAgB,MAAA;AAAA,EAChB,SAAA,EAAW,CAAC,MAAA,EAAQ,IAAA,KAAS;AAC3B,IAAA,IAAI,CAAC,MAAA,CAAO,OAAA,EAAS,OAAO,CAAA,eAAA,EAAkB,OAAO,KAAK,CAAA,CAAA;AAC1D,IAAA,MAAM,OAAO,MAAA,CAAO,IAAA;AACpB,IAAA,OAAOC,2CAAyB,IAAI,CAAA;AAAA,EACtC;AACF,CAAC;AAoEM,SAAS,oBACd,MAAA,EACiC;AACjC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IACN,GAAG,aAAA;AAAA,IACH,OAAA,EAAS,OAAO,MAAA,KAA4B;AAC1C,MAAA,IAAI;AACF,QAAA,MAAM,WAAW,MAAMC,kCAAA;AAAA,UACrB;AAAA,YACE,OAAO,MAAA,CAAO,KAAA;AAAA,YACd,UAAA,EAAY,MAAA,CAAO,UAAA,IAAc,MAAA,CAAO,UAAA,IAAc,CAAA;AAAA,YACtD,WAAA,EAAa,MAAA,CAAO,WAAA,IAAe,MAAA,CAAO,WAAA,IAAe;AAAA,WAC3D;AAAA,UACA;AAAA,SACF;AAGA,QAAA,MAAM,SAAA,GAAYD,2CAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAASE,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":"chunk-WAPGTQDR.cjs","sourcesContent":["/**\n * Built-in Web Search Tool\n *\n * A pre-configured tool for searching the web with multiple provider support.\n * Runs on the server to protect API keys.\n *\n * Supports tree-shaking - import providers directly for smaller bundles.\n *\n * @example\n * ```typescript\n * // Option 1: String provider (lazy loaded at runtime)\n * import { createWebSearchTool } from '@yourgpt/copilot-sdk';\n * const webSearch = createWebSearchTool({\n * provider: 'tavily',\n * apiKey: process.env.TAVILY_API_KEY,\n * });\n *\n * // Option 2: Direct provider import (best for tree-shaking)\n * import { createWebSearchTool, tavilyProvider } from '@yourgpt/copilot-sdk';\n * const webSearch = createWebSearchTool({\n * provider: tavilyProvider,\n * apiKey: process.env.TAVILY_API_KEY,\n * });\n *\n * // Add to your runtime\n * const runtime = createRuntime({\n * tools: [webSearch],\n * });\n * ```\n */\n\nimport { tool, success, failure } from \"../../types/tools\";\nimport type { ToolDefinition } from \"../../types/tools\";\nimport {\n executeWebSearch,\n formatSearchResultsForAI,\n summarizeSearchResults,\n type WebSearchConfigExtended,\n} from \"../webSearch\";\nimport type {\n WebSearchConfig,\n WebSearchParams,\n WebSearchResponse,\n WebSearchProviderInterface,\n} from \"../webSearch/types\";\n\n/**\n * Base web search tool definition\n *\n * This is the core tool definition. Use `createWebSearchTool()` to create\n * a configured instance with your provider settings.\n */\nexport const webSearchTool = tool<WebSearchParams>({\n description: `Search the web for current information. Use this when the user asks about:\n- Recent events, news, or current affairs\n- Real-time data (prices, weather, stocks, sports scores)\n- Information that might have changed after your training cutoff\n- Facts that need verification with current sources\n- Research topics that require up-to-date information`,\n\n location: \"server\", // Runs on server to protect API keys\n\n title: (args) => `Searching for \"${args.query}\"`,\n executingTitle: (args) => `Searching the web for \"${args.query}\"...`,\n completedTitle: (args) => `Found results for \"${args.query}\"`,\n\n inputSchema: {\n type: \"object\",\n properties: {\n query: {\n type: \"string\",\n description: \"The search query to find relevant information\",\n },\n maxResults: {\n type: \"number\",\n description:\n \"Maximum number of results to return (default: 5, max: 10)\",\n minimum: 1,\n maximum: 10,\n },\n searchDepth: {\n type: \"string\",\n enum: [\"basic\", \"advanced\"],\n description:\n \"Search depth - 'advanced' provides more thorough results but may be slower\",\n },\n },\n required: [\"query\"],\n },\n\n needsApproval: false, // No user data exposed, just searching\n\n // Control what AI sees from results\n aiResponseMode: \"full\",\n aiContext: (result, args) => {\n if (!result.success) return `Search failed: ${result.error}`;\n const data = result.data as WebSearchResponse;\n return formatSearchResultsForAI(data);\n },\n});\n\n/**\n * Create a configured web search tool\n *\n * Supports both string provider names (lazy loaded) and direct provider imports (tree-shakeable).\n *\n * @param config - Web search configuration including provider and API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * // ===== BEST FOR TREE-SHAKING: Direct provider import =====\n * import { createWebSearchTool, openaiProvider } from '@yourgpt/copilot-sdk/core';\n *\n * const webSearch = createWebSearchTool({\n * provider: openaiProvider, // Only this provider in bundle\n * apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * // ===== STRING PROVIDERS (Lazy loaded at runtime) =====\n *\n * // OpenAI (uses your OpenAI API key)\n * const webSearch = createWebSearchTool({\n * provider: 'openai',\n * apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * // Google (uses your Google/Gemini API key)\n * const webSearch = createWebSearchTool({\n * provider: 'google',\n * apiKey: process.env.GOOGLE_API_KEY,\n * });\n *\n * // Tavily (AI-optimized search with answer generation)\n * const webSearch = createWebSearchTool({\n * provider: 'tavily',\n * apiKey: process.env.TAVILY_API_KEY,\n * includeAnswer: true,\n * maxResults: 5,\n * });\n *\n * // Serper (Google results)\n * const webSearch = createWebSearchTool({\n * provider: 'serper',\n * apiKey: process.env.SERPER_API_KEY,\n * });\n *\n * // Brave Search (privacy-focused)\n * const webSearch = createWebSearchTool({\n * provider: 'brave',\n * apiKey: process.env.BRAVE_API_KEY,\n * });\n *\n * // Self-hosted SearXNG (no API key needed)\n * const webSearch = createWebSearchTool({\n * provider: 'searxng',\n * baseUrl: 'https://your-searxng-instance.com',\n * });\n *\n * // Exa (AI-optimized semantic search)\n * const webSearch = createWebSearchTool({\n * provider: 'exa',\n * apiKey: process.env.EXA_API_KEY,\n * searchDepth: 'advanced',\n * });\n * ```\n */\nexport function createWebSearchTool(\n config: WebSearchConfigExtended,\n): ToolDefinition<WebSearchParams> {\n return {\n name: \"web_search\",\n ...webSearchTool,\n handler: async (params: WebSearchParams) => {\n try {\n const response = await executeWebSearch(\n {\n query: params.query,\n maxResults: params.maxResults ?? config.maxResults ?? 5,\n searchDepth: params.searchDepth ?? config.searchDepth ?? \"basic\",\n },\n config,\n );\n\n // Build the AI context string\n const aiContext = formatSearchResultsForAI(response);\n\n return {\n success: true,\n message: summarizeSearchResults(response),\n data: response,\n _aiContext: aiContext,\n };\n } catch (error) {\n const errorMessage =\n error instanceof Error ? error.message : \"Web search failed\";\n return failure(errorMessage);\n }\n },\n };\n}\n\n/**\n * Utility types for web search tool configuration\n */\nexport type {\n WebSearchConfig,\n WebSearchParams,\n WebSearchResponse,\n WebSearchProviderInterface,\n};\nexport type { WebSearchConfigExtended };\n"]}
1
+ {"version":3,"sources":["../src/core/tools/builtin/webSearch.ts"],"names":["tool","formatSearchResultsForAI","executeWebSearch","summarizeSearchResults","failure"],"mappings":";;;;;;AAoDO,IAAM,gBAAgBA,sBAAA,CAAsB;AAAA,EACjD,WAAA,EAAa,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qDAAA,CAAA;AAAA,EAOb,QAAA,EAAU,QAAA;AAAA;AAAA,EAEV,KAAA,EAAO,CAAC,IAAA,KAAS,CAAA,eAAA,EAAkB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,EAC7C,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,uBAAA,EAA0B,KAAK,KAAK,CAAA,IAAA,CAAA;AAAA,EAC9D,cAAA,EAAgB,CAAC,IAAA,KAAS,CAAA,mBAAA,EAAsB,KAAK,KAAK,CAAA,CAAA,CAAA;AAAA,EAE1D,WAAA,EAAa;AAAA,IACX,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,KAAA,EAAO;AAAA,QACL,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EACE,2DAAA;AAAA,QACF,OAAA,EAAS,CAAA;AAAA,QACT,OAAA,EAAS;AAAA,OACX;AAAA,MACA,WAAA,EAAa;AAAA,QACX,IAAA,EAAM,QAAA;AAAA,QACN,IAAA,EAAM,CAAC,OAAA,EAAS,UAAU,CAAA;AAAA,QAC1B,WAAA,EACE;AAAA;AACJ,KACF;AAAA,IACA,QAAA,EAAU,CAAC,OAAO;AAAA,GACpB;AAAA,EAEA,aAAA,EAAe,KAAA;AAAA;AAAA;AAAA,EAGf,cAAA,EAAgB,MAAA;AAAA,EAChB,SAAA,EAAW,CAAC,MAAA,EAAQ,IAAA,KAAS;AAC3B,IAAA,IAAI,CAAC,MAAA,CAAO,OAAA,EAAS,OAAO,CAAA,eAAA,EAAkB,OAAO,KAAK,CAAA,CAAA;AAC1D,IAAA,MAAM,OAAO,MAAA,CAAO,IAAA;AACpB,IAAA,OAAOC,2CAAyB,IAAI,CAAA;AAAA,EACtC;AACF,CAAC;AAoEM,SAAS,oBACd,MAAA,EACiC;AACjC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IACN,GAAG,aAAA;AAAA,IACH,OAAA,EAAS,OAAO,MAAA,KAA4B;AAC1C,MAAA,IAAI;AACF,QAAA,MAAM,WAAW,MAAMC,kCAAA;AAAA,UACrB;AAAA,YACE,OAAO,MAAA,CAAO,KAAA;AAAA,YACd,UAAA,EAAY,MAAA,CAAO,UAAA,IAAc,MAAA,CAAO,UAAA,IAAc,CAAA;AAAA,YACtD,WAAA,EAAa,MAAA,CAAO,WAAA,IAAe,MAAA,CAAO,WAAA,IAAe;AAAA,WAC3D;AAAA,UACA;AAAA,SACF;AAGA,QAAA,MAAM,SAAA,GAAYD,2CAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAASE,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":"chunk-JKGFQUHJ.cjs","sourcesContent":["/**\n * Built-in Web Search Tool\n *\n * A pre-configured tool for searching the web with multiple provider support.\n * Runs on the server to protect API keys.\n *\n * Supports tree-shaking - import providers directly for smaller bundles.\n *\n * @example\n * ```typescript\n * // Option 1: String provider (lazy loaded at runtime)\n * import { createWebSearchTool } from '@yourgpt/copilot-sdk';\n * const webSearch = createWebSearchTool({\n * provider: 'tavily',\n * apiKey: process.env.TAVILY_API_KEY,\n * });\n *\n * // Option 2: Direct provider import (best for tree-shaking)\n * import { createWebSearchTool, tavilyProvider } from '@yourgpt/copilot-sdk';\n * const webSearch = createWebSearchTool({\n * provider: tavilyProvider,\n * apiKey: process.env.TAVILY_API_KEY,\n * });\n *\n * // Add to your runtime\n * const runtime = createRuntime({\n * tools: [webSearch],\n * });\n * ```\n */\n\nimport { tool, success, failure } from \"../../types/tools\";\nimport type { ToolDefinition } from \"../../types/tools\";\nimport {\n executeWebSearch,\n formatSearchResultsForAI,\n summarizeSearchResults,\n type WebSearchConfigExtended,\n} from \"../webSearch\";\nimport type {\n WebSearchConfig,\n WebSearchParams,\n WebSearchResponse,\n WebSearchProviderInterface,\n} from \"../webSearch/types\";\n\n/**\n * Base web search tool definition\n *\n * This is the core tool definition. Use `createWebSearchTool()` to create\n * a configured instance with your provider settings.\n */\nexport const webSearchTool = tool<WebSearchParams>({\n description: `Search the web for current information. Use this when the user asks about:\n- Recent events, news, or current affairs\n- Real-time data (prices, weather, stocks, sports scores)\n- Information that might have changed after your training cutoff\n- Facts that need verification with current sources\n- Research topics that require up-to-date information`,\n\n location: \"server\", // Runs on server to protect API keys\n\n title: (args) => `Searching for \"${args.query}\"`,\n executingTitle: (args) => `Searching the web for \"${args.query}\"...`,\n completedTitle: (args) => `Found results for \"${args.query}\"`,\n\n inputSchema: {\n type: \"object\",\n properties: {\n query: {\n type: \"string\",\n description: \"The search query to find relevant information\",\n },\n maxResults: {\n type: \"number\",\n description:\n \"Maximum number of results to return (default: 5, max: 10)\",\n minimum: 1,\n maximum: 10,\n },\n searchDepth: {\n type: \"string\",\n enum: [\"basic\", \"advanced\"],\n description:\n \"Search depth - 'advanced' provides more thorough results but may be slower\",\n },\n },\n required: [\"query\"],\n },\n\n needsApproval: false, // No user data exposed, just searching\n\n // Control what AI sees from results\n aiResponseMode: \"full\",\n aiContext: (result, args) => {\n if (!result.success) return `Search failed: ${result.error}`;\n const data = result.data as WebSearchResponse;\n return formatSearchResultsForAI(data);\n },\n});\n\n/**\n * Create a configured web search tool\n *\n * Supports both string provider names (lazy loaded) and direct provider imports (tree-shakeable).\n *\n * @param config - Web search configuration including provider and API key\n * @returns A configured tool definition ready to use\n *\n * @example\n * ```typescript\n * // ===== BEST FOR TREE-SHAKING: Direct provider import =====\n * import { createWebSearchTool, openaiProvider } from '@yourgpt/copilot-sdk/core';\n *\n * const webSearch = createWebSearchTool({\n * provider: openaiProvider, // Only this provider in bundle\n * apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * // ===== STRING PROVIDERS (Lazy loaded at runtime) =====\n *\n * // OpenAI (uses your OpenAI API key)\n * const webSearch = createWebSearchTool({\n * provider: 'openai',\n * apiKey: process.env.OPENAI_API_KEY,\n * });\n *\n * // Google (uses your Google/Gemini API key)\n * const webSearch = createWebSearchTool({\n * provider: 'google',\n * apiKey: process.env.GOOGLE_API_KEY,\n * });\n *\n * // Tavily (AI-optimized search with answer generation)\n * const webSearch = createWebSearchTool({\n * provider: 'tavily',\n * apiKey: process.env.TAVILY_API_KEY,\n * includeAnswer: true,\n * maxResults: 5,\n * });\n *\n * // Serper (Google results)\n * const webSearch = createWebSearchTool({\n * provider: 'serper',\n * apiKey: process.env.SERPER_API_KEY,\n * });\n *\n * // Brave Search (privacy-focused)\n * const webSearch = createWebSearchTool({\n * provider: 'brave',\n * apiKey: process.env.BRAVE_API_KEY,\n * });\n *\n * // Self-hosted SearXNG (no API key needed)\n * const webSearch = createWebSearchTool({\n * provider: 'searxng',\n * baseUrl: 'https://your-searxng-instance.com',\n * });\n *\n * // Exa (AI-optimized semantic search)\n * const webSearch = createWebSearchTool({\n * provider: 'exa',\n * apiKey: process.env.EXA_API_KEY,\n * searchDepth: 'advanced',\n * });\n * ```\n */\nexport function createWebSearchTool(\n config: WebSearchConfigExtended,\n): ToolDefinition<WebSearchParams> {\n return {\n name: \"web_search\",\n ...webSearchTool,\n handler: async (params: WebSearchParams) => {\n try {\n const response = await executeWebSearch(\n {\n query: params.query,\n maxResults: params.maxResults ?? config.maxResults ?? 5,\n searchDepth: params.searchDepth ?? config.searchDepth ?? \"basic\",\n },\n config,\n );\n\n // Build the AI context string\n const aiContext = formatSearchResultsForAI(response);\n\n return {\n success: true,\n message: summarizeSearchResults(response),\n data: response,\n _aiContext: aiContext,\n };\n } catch (error) {\n const errorMessage =\n error instanceof Error ? error.message : \"Web search failed\";\n return failure(errorMessage);\n }\n },\n };\n}\n\n/**\n * Utility types for web search tool configuration\n */\nexport type {\n WebSearchConfig,\n WebSearchParams,\n WebSearchResponse,\n WebSearchProviderInterface,\n};\nexport type { WebSearchConfigExtended };\n"]}
@@ -89,5 +89,5 @@ function summarizeSearchResults(response) {
89
89
  }
90
90
 
91
91
  export { executeWebSearch, formatSearchResultsForAI, getAvailableProviders, getProvider, summarizeSearchResults };
92
- //# sourceMappingURL=chunk-XGITAEXU.js.map
93
- //# sourceMappingURL=chunk-XGITAEXU.js.map
92
+ //# sourceMappingURL=chunk-LLM7AHMO.js.map
93
+ //# sourceMappingURL=chunk-LLM7AHMO.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/core/tools/webSearch/index.ts"],"names":[],"mappings":"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","file":"chunk-XGITAEXU.js","sourcesContent":["/**\n * Web Search Module\n *\n * Multi-provider web search with unified API.\n * Supports tree-shaking - only the provider you use gets bundled.\n *\n * @example\n * ```typescript\n * // Option 1: Lazy loading (provider loaded on first use)\n * import { executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n * { query: 'latest AI news' },\n * { provider: 'tavily', apiKey: 'your-api-key' }\n * );\n *\n * // Option 2: Direct import (best for tree-shaking)\n * import { tavilyProvider, executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n * { query: 'latest AI news' },\n * { provider: tavilyProvider, apiKey: 'your-api-key' }\n * );\n * ```\n */\n\nimport type {\n WebSearchConfig,\n WebSearchParams,\n WebSearchResponse,\n WebSearchProvider,\n WebSearchProviderInterface,\n} from \"./types\";\n\n// ============================================\n// Lazy Provider Loading (for tree-shaking)\n// ============================================\n\n/**\n * Provider loaders - dynamically import providers only when needed.\n * This ensures unused providers are NOT included in the bundle.\n */\nconst providerLoaders: Record<\n WebSearchProvider,\n () => Promise<\n { default: WebSearchProviderInterface } | WebSearchProviderInterface\n >\n> = {\n openai: () => import(\"./providers/openai\").then((m) => m.openaiProvider),\n google: () => import(\"./providers/google\").then((m) => m.googleProvider),\n anthropic: () =>\n import(\"./providers/anthropic\").then((m) => m.anthropicProvider),\n tavily: () => import(\"./providers/tavily\").then((m) => m.tavilyProvider),\n serper: () => import(\"./providers/serper\").then((m) => m.serperProvider),\n brave: () => import(\"./providers/brave\").then((m) => m.braveProvider),\n searxng: () => import(\"./providers/searxng\").then((m) => m.searxngProvider),\n exa: () => import(\"./providers/exa\").then((m) => m.exaProvider),\n};\n\n// Cache for loaded providers\nconst loadedProviders: Map<WebSearchProvider, WebSearchProviderInterface> =\n new Map();\n\n/**\n * Get a provider by name (lazy loading)\n *\n * @param name - Provider name string\n * @returns Provider interface (loaded dynamically)\n */\nexport async function getProvider(\n name: WebSearchProvider,\n): Promise<WebSearchProviderInterface> {\n // Check cache first\n const cached = loadedProviders.get(name);\n if (cached) {\n return cached;\n }\n\n // Load provider dynamically\n const loader = providerLoaders[name];\n if (!loader) {\n throw new Error(\n `Unknown search provider: ${name}. ` +\n `Available providers: ${Object.keys(providerLoaders).join(\", \")}`,\n );\n }\n\n const provider = await loader();\n const resolvedProvider = \"default\" in provider ? provider.default : provider;\n\n // Cache for future use\n loadedProviders.set(name, resolvedProvider as WebSearchProviderInterface);\n\n return resolvedProvider as WebSearchProviderInterface;\n}\n\n/**\n * Get all available provider names\n */\nexport function getAvailableProviders(): WebSearchProvider[] {\n return Object.keys(providerLoaders) as WebSearchProvider[];\n}\n\n// ============================================\n// Extended Config with Direct Provider Support\n// ============================================\n\n/**\n * Extended config that allows passing provider directly for tree-shaking\n */\nexport interface WebSearchConfigExtended extends Omit<\n WebSearchConfig,\n \"provider\"\n> {\n /**\n * Provider can be either:\n * - A string name (lazy loaded): \"tavily\", \"openai\", \"anthropic\", \"google\", etc.\n * - A provider instance (best for tree-shaking): import { tavilyProvider } from '...'\n */\n provider: WebSearchProvider | WebSearchProviderInterface;\n}\n\n/**\n * Check if a value is a provider interface (not a string)\n */\nfunction isProviderInterface(\n provider: WebSearchProvider | WebSearchProviderInterface,\n): provider is WebSearchProviderInterface {\n return typeof provider === \"object\" && \"search\" in provider;\n}\n\n// ============================================\n// Execute Search\n// ============================================\n\n/**\n * Execute a web search using the configured provider\n *\n * @param params - Search parameters (query, maxResults, searchDepth)\n * @param config - Provider configuration (provider, apiKey, options)\n * @returns Search results with optional AI-generated answer\n *\n * @example\n * ```typescript\n * // Option 1: String provider name (lazy loaded)\n * const results = await executeWebSearch(\n * { query: 'What is the latest news about SpaceX?' },\n * {\n * provider: 'tavily',\n * apiKey: process.env.TAVILY_API_KEY,\n * }\n * );\n *\n * // Option 2: Direct provider import (best for tree-shaking)\n * import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\n * const results = await executeWebSearch(\n * { query: 'What is the latest news about SpaceX?' },\n * {\n * provider: tavilyProvider,\n * apiKey: process.env.TAVILY_API_KEY,\n * }\n * );\n * ```\n */\nexport async function executeWebSearch(\n params: WebSearchParams,\n config: WebSearchConfigExtended,\n): Promise<WebSearchResponse> {\n // Resolve provider (either from string or direct reference)\n const provider = isProviderInterface(config.provider)\n ? config.provider\n : await getProvider(config.provider);\n\n // Build config with string provider name for validation\n const providerName: WebSearchProvider = isProviderInterface(config.provider)\n ? (\"custom\" as WebSearchProvider) // Direct provider\n : config.provider;\n\n const resolvedConfig: WebSearchConfig = {\n ...config,\n provider: providerName,\n };\n\n // Validate configuration if provider supports it\n if (provider.validateConfig) {\n provider.validateConfig(resolvedConfig);\n }\n\n // Execute search\n return provider.search(params, resolvedConfig);\n}\n\n// ============================================\n// Utility Functions\n// ============================================\n\n/**\n * Format search results for display in AI context\n *\n * @param response - Web search response\n * @param options - Formatting options\n * @returns Formatted string for AI consumption\n */\nexport function formatSearchResultsForAI(\n response: WebSearchResponse,\n options?: {\n includeUrls?: boolean;\n includeScores?: boolean;\n maxContentLength?: number;\n },\n): string {\n const {\n includeUrls = true,\n includeScores = false,\n maxContentLength = 200,\n } = options || {};\n\n const lines: string[] = [];\n\n // Add answer if available\n if (response.answer) {\n lines.push(`Answer: ${response.answer}`);\n lines.push(\"\");\n }\n\n // Add results\n lines.push(`Search results for \"${response.query}\":`);\n lines.push(\"\");\n\n response.results.forEach((result, index) => {\n const num = index + 1;\n let content = result.content;\n\n // Truncate content if needed\n if (maxContentLength && content.length > maxContentLength) {\n content = content.slice(0, maxContentLength) + \"...\";\n }\n\n lines.push(`${num}. ${result.title}`);\n if (includeUrls) {\n lines.push(` URL: ${result.url}`);\n }\n lines.push(` ${content}`);\n if (includeScores && result.score !== undefined) {\n lines.push(` Relevance: ${(result.score * 100).toFixed(1)}%`);\n }\n lines.push(\"\");\n });\n\n return lines.join(\"\\n\");\n}\n\n/**\n * Create a minimal search result summary\n *\n * @param response - Web search response\n * @returns Brief summary string\n */\nexport function summarizeSearchResults(response: WebSearchResponse): string {\n const count = response.results.length;\n const sources = response.results\n .slice(0, 3)\n .map((r) => r.domain || new URL(r.url).hostname)\n .join(\", \");\n\n let summary = `Found ${count} result${count !== 1 ? \"s\" : \"\"}`;\n if (sources) {\n summary += ` from ${sources}`;\n }\n if (response.searchTime) {\n summary += ` (${response.searchTime}ms)`;\n }\n\n return summary;\n}\n\n// ============================================\n// Re-exports\n// ============================================\n\n// Export types\nexport * from \"./types\";\n\n// Export individual providers for direct import (tree-shakeable)\n// Users should import these directly for best bundle size:\n// import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\nexport { openaiProvider } from \"./providers/openai\";\nexport { googleProvider } from \"./providers/google\";\nexport { anthropicProvider } from \"./providers/anthropic\";\nexport { tavilyProvider } from \"./providers/tavily\";\nexport { serperProvider } from \"./providers/serper\";\nexport { braveProvider } from \"./providers/brave\";\nexport { searxngProvider } from \"./providers/searxng\";\nexport { exaProvider } from \"./providers/exa\";\n"]}
1
+ {"version":3,"sources":["../src/core/tools/webSearch/index.ts"],"names":[],"mappings":"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","file":"chunk-LLM7AHMO.js","sourcesContent":["/**\n * Web Search Module\n *\n * Multi-provider web search with unified API.\n * Supports tree-shaking - only the provider you use gets bundled.\n *\n * @example\n * ```typescript\n * // Option 1: Lazy loading (provider loaded on first use)\n * import { executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n * { query: 'latest AI news' },\n * { provider: 'tavily', apiKey: 'your-api-key' }\n * );\n *\n * // Option 2: Direct import (best for tree-shaking)\n * import { tavilyProvider, executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n * { query: 'latest AI news' },\n * { provider: tavilyProvider, apiKey: 'your-api-key' }\n * );\n * ```\n */\n\nimport type {\n WebSearchConfig,\n WebSearchParams,\n WebSearchResponse,\n WebSearchProvider,\n WebSearchProviderInterface,\n} from \"./types\";\n\n// ============================================\n// Lazy Provider Loading (for tree-shaking)\n// ============================================\n\n/**\n * Provider loaders - dynamically import providers only when needed.\n * This ensures unused providers are NOT included in the bundle.\n */\nconst providerLoaders: Record<\n WebSearchProvider,\n () => Promise<\n { default: WebSearchProviderInterface } | WebSearchProviderInterface\n >\n> = {\n openai: () => import(\"./providers/openai\").then((m) => m.openaiProvider),\n google: () => import(\"./providers/google\").then((m) => m.googleProvider),\n anthropic: () =>\n import(\"./providers/anthropic\").then((m) => m.anthropicProvider),\n tavily: () => import(\"./providers/tavily\").then((m) => m.tavilyProvider),\n serper: () => import(\"./providers/serper\").then((m) => m.serperProvider),\n brave: () => import(\"./providers/brave\").then((m) => m.braveProvider),\n searxng: () => import(\"./providers/searxng\").then((m) => m.searxngProvider),\n exa: () => import(\"./providers/exa\").then((m) => m.exaProvider),\n};\n\n// Cache for loaded providers\nconst loadedProviders: Map<WebSearchProvider, WebSearchProviderInterface> =\n new Map();\n\n/**\n * Get a provider by name (lazy loading)\n *\n * @param name - Provider name string\n * @returns Provider interface (loaded dynamically)\n */\nexport async function getProvider(\n name: WebSearchProvider,\n): Promise<WebSearchProviderInterface> {\n // Check cache first\n const cached = loadedProviders.get(name);\n if (cached) {\n return cached;\n }\n\n // Load provider dynamically\n const loader = providerLoaders[name];\n if (!loader) {\n throw new Error(\n `Unknown search provider: ${name}. ` +\n `Available providers: ${Object.keys(providerLoaders).join(\", \")}`,\n );\n }\n\n const provider = await loader();\n const resolvedProvider = \"default\" in provider ? provider.default : provider;\n\n // Cache for future use\n loadedProviders.set(name, resolvedProvider as WebSearchProviderInterface);\n\n return resolvedProvider as WebSearchProviderInterface;\n}\n\n/**\n * Get all available provider names\n */\nexport function getAvailableProviders(): WebSearchProvider[] {\n return Object.keys(providerLoaders) as WebSearchProvider[];\n}\n\n// ============================================\n// Extended Config with Direct Provider Support\n// ============================================\n\n/**\n * Extended config that allows passing provider directly for tree-shaking\n */\nexport interface WebSearchConfigExtended extends Omit<\n WebSearchConfig,\n \"provider\"\n> {\n /**\n * Provider can be either:\n * - A string name (lazy loaded): \"tavily\", \"openai\", \"anthropic\", \"google\", etc.\n * - A provider instance (best for tree-shaking): import { tavilyProvider } from '...'\n */\n provider: WebSearchProvider | WebSearchProviderInterface;\n}\n\n/**\n * Check if a value is a provider interface (not a string)\n */\nfunction isProviderInterface(\n provider: WebSearchProvider | WebSearchProviderInterface,\n): provider is WebSearchProviderInterface {\n return typeof provider === \"object\" && \"search\" in provider;\n}\n\n// ============================================\n// Execute Search\n// ============================================\n\n/**\n * Execute a web search using the configured provider\n *\n * @param params - Search parameters (query, maxResults, searchDepth)\n * @param config - Provider configuration (provider, apiKey, options)\n * @returns Search results with optional AI-generated answer\n *\n * @example\n * ```typescript\n * // Option 1: String provider name (lazy loaded)\n * const results = await executeWebSearch(\n * { query: 'What is the latest news about SpaceX?' },\n * {\n * provider: 'tavily',\n * apiKey: process.env.TAVILY_API_KEY,\n * }\n * );\n *\n * // Option 2: Direct provider import (best for tree-shaking)\n * import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\n * const results = await executeWebSearch(\n * { query: 'What is the latest news about SpaceX?' },\n * {\n * provider: tavilyProvider,\n * apiKey: process.env.TAVILY_API_KEY,\n * }\n * );\n * ```\n */\nexport async function executeWebSearch(\n params: WebSearchParams,\n config: WebSearchConfigExtended,\n): Promise<WebSearchResponse> {\n // Resolve provider (either from string or direct reference)\n const provider = isProviderInterface(config.provider)\n ? config.provider\n : await getProvider(config.provider);\n\n // Build config with string provider name for validation\n const providerName: WebSearchProvider = isProviderInterface(config.provider)\n ? (\"custom\" as WebSearchProvider) // Direct provider\n : config.provider;\n\n const resolvedConfig: WebSearchConfig = {\n ...config,\n provider: providerName,\n };\n\n // Validate configuration if provider supports it\n if (provider.validateConfig) {\n provider.validateConfig(resolvedConfig);\n }\n\n // Execute search\n return provider.search(params, resolvedConfig);\n}\n\n// ============================================\n// Utility Functions\n// ============================================\n\n/**\n * Format search results for display in AI context\n *\n * @param response - Web search response\n * @param options - Formatting options\n * @returns Formatted string for AI consumption\n */\nexport function formatSearchResultsForAI(\n response: WebSearchResponse,\n options?: {\n includeUrls?: boolean;\n includeScores?: boolean;\n maxContentLength?: number;\n },\n): string {\n const {\n includeUrls = true,\n includeScores = false,\n maxContentLength = 200,\n } = options || {};\n\n const lines: string[] = [];\n\n // Add answer if available\n if (response.answer) {\n lines.push(`Answer: ${response.answer}`);\n lines.push(\"\");\n }\n\n // Add results\n lines.push(`Search results for \"${response.query}\":`);\n lines.push(\"\");\n\n response.results.forEach((result, index) => {\n const num = index + 1;\n let content = result.content;\n\n // Truncate content if needed\n if (maxContentLength && content.length > maxContentLength) {\n content = content.slice(0, maxContentLength) + \"...\";\n }\n\n lines.push(`${num}. ${result.title}`);\n if (includeUrls) {\n lines.push(` URL: ${result.url}`);\n }\n lines.push(` ${content}`);\n if (includeScores && result.score !== undefined) {\n lines.push(` Relevance: ${(result.score * 100).toFixed(1)}%`);\n }\n lines.push(\"\");\n });\n\n return lines.join(\"\\n\");\n}\n\n/**\n * Create a minimal search result summary\n *\n * @param response - Web search response\n * @returns Brief summary string\n */\nexport function summarizeSearchResults(response: WebSearchResponse): string {\n const count = response.results.length;\n const sources = response.results\n .slice(0, 3)\n .map((r) => r.domain || new URL(r.url).hostname)\n .join(\", \");\n\n let summary = `Found ${count} result${count !== 1 ? \"s\" : \"\"}`;\n if (sources) {\n summary += ` from ${sources}`;\n }\n if (response.searchTime) {\n summary += ` (${response.searchTime}ms)`;\n }\n\n return summary;\n}\n\n// ============================================\n// Re-exports\n// ============================================\n\n// Export types\nexport * from \"./types\";\n\n// Export individual providers for direct import (tree-shakeable)\n// Users should import these directly for best bundle size:\n// import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\nexport { openaiProvider } from \"./providers/openai\";\nexport { googleProvider } from \"./providers/google\";\nexport { anthropicProvider } from \"./providers/anthropic\";\nexport { tavilyProvider } from \"./providers/tavily\";\nexport { serperProvider } from \"./providers/serper\";\nexport { braveProvider } from \"./providers/brave\";\nexport { searxngProvider } from \"./providers/searxng\";\nexport { exaProvider } from \"./providers/exa\";\n"]}
@@ -95,5 +95,5 @@ exports.formatSearchResultsForAI = formatSearchResultsForAI;
95
95
  exports.getAvailableProviders = getAvailableProviders;
96
96
  exports.getProvider = getProvider;
97
97
  exports.summarizeSearchResults = summarizeSearchResults;
98
- //# sourceMappingURL=chunk-ASV6JLYG.cjs.map
99
- //# sourceMappingURL=chunk-ASV6JLYG.cjs.map
98
+ //# sourceMappingURL=chunk-NUXLAZOE.cjs.map
99
+ //# sourceMappingURL=chunk-NUXLAZOE.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/core/tools/webSearch/index.ts"],"names":[],"mappings":"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","file":"chunk-ASV6JLYG.cjs","sourcesContent":["/**\n * Web Search Module\n *\n * Multi-provider web search with unified API.\n * Supports tree-shaking - only the provider you use gets bundled.\n *\n * @example\n * ```typescript\n * // Option 1: Lazy loading (provider loaded on first use)\n * import { executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n * { query: 'latest AI news' },\n * { provider: 'tavily', apiKey: 'your-api-key' }\n * );\n *\n * // Option 2: Direct import (best for tree-shaking)\n * import { tavilyProvider, executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n * { query: 'latest AI news' },\n * { provider: tavilyProvider, apiKey: 'your-api-key' }\n * );\n * ```\n */\n\nimport type {\n WebSearchConfig,\n WebSearchParams,\n WebSearchResponse,\n WebSearchProvider,\n WebSearchProviderInterface,\n} from \"./types\";\n\n// ============================================\n// Lazy Provider Loading (for tree-shaking)\n// ============================================\n\n/**\n * Provider loaders - dynamically import providers only when needed.\n * This ensures unused providers are NOT included in the bundle.\n */\nconst providerLoaders: Record<\n WebSearchProvider,\n () => Promise<\n { default: WebSearchProviderInterface } | WebSearchProviderInterface\n >\n> = {\n openai: () => import(\"./providers/openai\").then((m) => m.openaiProvider),\n google: () => import(\"./providers/google\").then((m) => m.googleProvider),\n anthropic: () =>\n import(\"./providers/anthropic\").then((m) => m.anthropicProvider),\n tavily: () => import(\"./providers/tavily\").then((m) => m.tavilyProvider),\n serper: () => import(\"./providers/serper\").then((m) => m.serperProvider),\n brave: () => import(\"./providers/brave\").then((m) => m.braveProvider),\n searxng: () => import(\"./providers/searxng\").then((m) => m.searxngProvider),\n exa: () => import(\"./providers/exa\").then((m) => m.exaProvider),\n};\n\n// Cache for loaded providers\nconst loadedProviders: Map<WebSearchProvider, WebSearchProviderInterface> =\n new Map();\n\n/**\n * Get a provider by name (lazy loading)\n *\n * @param name - Provider name string\n * @returns Provider interface (loaded dynamically)\n */\nexport async function getProvider(\n name: WebSearchProvider,\n): Promise<WebSearchProviderInterface> {\n // Check cache first\n const cached = loadedProviders.get(name);\n if (cached) {\n return cached;\n }\n\n // Load provider dynamically\n const loader = providerLoaders[name];\n if (!loader) {\n throw new Error(\n `Unknown search provider: ${name}. ` +\n `Available providers: ${Object.keys(providerLoaders).join(\", \")}`,\n );\n }\n\n const provider = await loader();\n const resolvedProvider = \"default\" in provider ? provider.default : provider;\n\n // Cache for future use\n loadedProviders.set(name, resolvedProvider as WebSearchProviderInterface);\n\n return resolvedProvider as WebSearchProviderInterface;\n}\n\n/**\n * Get all available provider names\n */\nexport function getAvailableProviders(): WebSearchProvider[] {\n return Object.keys(providerLoaders) as WebSearchProvider[];\n}\n\n// ============================================\n// Extended Config with Direct Provider Support\n// ============================================\n\n/**\n * Extended config that allows passing provider directly for tree-shaking\n */\nexport interface WebSearchConfigExtended extends Omit<\n WebSearchConfig,\n \"provider\"\n> {\n /**\n * Provider can be either:\n * - A string name (lazy loaded): \"tavily\", \"openai\", \"anthropic\", \"google\", etc.\n * - A provider instance (best for tree-shaking): import { tavilyProvider } from '...'\n */\n provider: WebSearchProvider | WebSearchProviderInterface;\n}\n\n/**\n * Check if a value is a provider interface (not a string)\n */\nfunction isProviderInterface(\n provider: WebSearchProvider | WebSearchProviderInterface,\n): provider is WebSearchProviderInterface {\n return typeof provider === \"object\" && \"search\" in provider;\n}\n\n// ============================================\n// Execute Search\n// ============================================\n\n/**\n * Execute a web search using the configured provider\n *\n * @param params - Search parameters (query, maxResults, searchDepth)\n * @param config - Provider configuration (provider, apiKey, options)\n * @returns Search results with optional AI-generated answer\n *\n * @example\n * ```typescript\n * // Option 1: String provider name (lazy loaded)\n * const results = await executeWebSearch(\n * { query: 'What is the latest news about SpaceX?' },\n * {\n * provider: 'tavily',\n * apiKey: process.env.TAVILY_API_KEY,\n * }\n * );\n *\n * // Option 2: Direct provider import (best for tree-shaking)\n * import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\n * const results = await executeWebSearch(\n * { query: 'What is the latest news about SpaceX?' },\n * {\n * provider: tavilyProvider,\n * apiKey: process.env.TAVILY_API_KEY,\n * }\n * );\n * ```\n */\nexport async function executeWebSearch(\n params: WebSearchParams,\n config: WebSearchConfigExtended,\n): Promise<WebSearchResponse> {\n // Resolve provider (either from string or direct reference)\n const provider = isProviderInterface(config.provider)\n ? config.provider\n : await getProvider(config.provider);\n\n // Build config with string provider name for validation\n const providerName: WebSearchProvider = isProviderInterface(config.provider)\n ? (\"custom\" as WebSearchProvider) // Direct provider\n : config.provider;\n\n const resolvedConfig: WebSearchConfig = {\n ...config,\n provider: providerName,\n };\n\n // Validate configuration if provider supports it\n if (provider.validateConfig) {\n provider.validateConfig(resolvedConfig);\n }\n\n // Execute search\n return provider.search(params, resolvedConfig);\n}\n\n// ============================================\n// Utility Functions\n// ============================================\n\n/**\n * Format search results for display in AI context\n *\n * @param response - Web search response\n * @param options - Formatting options\n * @returns Formatted string for AI consumption\n */\nexport function formatSearchResultsForAI(\n response: WebSearchResponse,\n options?: {\n includeUrls?: boolean;\n includeScores?: boolean;\n maxContentLength?: number;\n },\n): string {\n const {\n includeUrls = true,\n includeScores = false,\n maxContentLength = 200,\n } = options || {};\n\n const lines: string[] = [];\n\n // Add answer if available\n if (response.answer) {\n lines.push(`Answer: ${response.answer}`);\n lines.push(\"\");\n }\n\n // Add results\n lines.push(`Search results for \"${response.query}\":`);\n lines.push(\"\");\n\n response.results.forEach((result, index) => {\n const num = index + 1;\n let content = result.content;\n\n // Truncate content if needed\n if (maxContentLength && content.length > maxContentLength) {\n content = content.slice(0, maxContentLength) + \"...\";\n }\n\n lines.push(`${num}. ${result.title}`);\n if (includeUrls) {\n lines.push(` URL: ${result.url}`);\n }\n lines.push(` ${content}`);\n if (includeScores && result.score !== undefined) {\n lines.push(` Relevance: ${(result.score * 100).toFixed(1)}%`);\n }\n lines.push(\"\");\n });\n\n return lines.join(\"\\n\");\n}\n\n/**\n * Create a minimal search result summary\n *\n * @param response - Web search response\n * @returns Brief summary string\n */\nexport function summarizeSearchResults(response: WebSearchResponse): string {\n const count = response.results.length;\n const sources = response.results\n .slice(0, 3)\n .map((r) => r.domain || new URL(r.url).hostname)\n .join(\", \");\n\n let summary = `Found ${count} result${count !== 1 ? \"s\" : \"\"}`;\n if (sources) {\n summary += ` from ${sources}`;\n }\n if (response.searchTime) {\n summary += ` (${response.searchTime}ms)`;\n }\n\n return summary;\n}\n\n// ============================================\n// Re-exports\n// ============================================\n\n// Export types\nexport * from \"./types\";\n\n// Export individual providers for direct import (tree-shakeable)\n// Users should import these directly for best bundle size:\n// import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\nexport { openaiProvider } from \"./providers/openai\";\nexport { googleProvider } from \"./providers/google\";\nexport { anthropicProvider } from \"./providers/anthropic\";\nexport { tavilyProvider } from \"./providers/tavily\";\nexport { serperProvider } from \"./providers/serper\";\nexport { braveProvider } from \"./providers/brave\";\nexport { searxngProvider } from \"./providers/searxng\";\nexport { exaProvider } from \"./providers/exa\";\n"]}
1
+ {"version":3,"sources":["../src/core/tools/webSearch/index.ts"],"names":[],"mappings":";;;AAwCA,IAAM,eAAA,GAKF;AAAA,EACF,MAAA,EAAQ,MAAM,OAAO,uBAAoB,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,cAAc,CAAA;AAAA,EACvE,MAAA,EAAQ,MAAM,OAAO,uBAAoB,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,cAAc,CAAA;AAAA,EACvE,SAAA,EAAW,MACT,OAAO,0BAAuB,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,iBAAiB,CAAA;AAAA,EACjE,MAAA,EAAQ,MAAM,OAAO,uBAAoB,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,cAAc,CAAA;AAAA,EACvE,MAAA,EAAQ,MAAM,OAAO,uBAAoB,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,cAAc,CAAA;AAAA,EACvE,KAAA,EAAO,MAAM,OAAO,sBAAmB,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,aAAa,CAAA;AAAA,EACpE,OAAA,EAAS,MAAM,OAAO,wBAAqB,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,eAAe,CAAA;AAAA,EAC1E,GAAA,EAAK,MAAM,OAAO,oBAAiB,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,WAAW;AAChE,CAAA;AAGA,IAAM,eAAA,uBACA,GAAA,EAAI;AAQV,eAAsB,YACpB,IAAA,EACqC;AAErC,EAAA,MAAM,MAAA,GAAS,eAAA,CAAgB,GAAA,CAAI,IAAI,CAAA;AACvC,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,OAAO,MAAA;AAAA,EACT;AAGA,EAAA,MAAM,MAAA,GAAS,gBAAgB,IAAI,CAAA;AACnC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,yBAAA,EAA4B,IAAI,CAAA,uBAAA,EACN,MAAA,CAAO,KAAK,eAAe,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACnE;AAAA,EACF;AAEA,EAAA,MAAM,QAAA,GAAW,MAAM,MAAA,EAAO;AAC9B,EAAA,MAAM,gBAAA,GAAmB,SAAA,IAAa,QAAA,GAAW,QAAA,CAAS,OAAA,GAAU,QAAA;AAGpE,EAAA,eAAA,CAAgB,GAAA,CAAI,MAAM,gBAA8C,CAAA;AAExE,EAAA,OAAO,gBAAA;AACT;AAKO,SAAS,qBAAA,GAA6C;AAC3D,EAAA,OAAO,MAAA,CAAO,KAAK,eAAe,CAAA;AACpC;AAwBA,SAAS,oBACP,QAAA,EACwC;AACxC,EAAA,OAAO,OAAO,QAAA,KAAa,QAAA,IAAY,QAAA,IAAY,QAAA;AACrD;AAmCA,eAAsB,gBAAA,CACpB,QACA,MAAA,EAC4B;AAE5B,EAAA,MAAM,QAAA,GAAW,mBAAA,CAAoB,MAAA,CAAO,QAAQ,CAAA,GAChD,OAAO,QAAA,GACP,MAAM,WAAA,CAAY,MAAA,CAAO,QAAQ,CAAA;AAGrC,EAAA,MAAM,eAAkC,mBAAA,CAAoB,MAAA,CAAO,QAAQ,CAAA,GACtE,WACD,MAAA,CAAO,QAAA;AAEX,EAAA,MAAM,cAAA,GAAkC;AAAA,IACtC,GAAG,MAAA;AAAA,IACH,QAAA,EAAU;AAAA,GACZ;AAGA,EAAA,IAAI,SAAS,cAAA,EAAgB;AAC3B,IAAA,QAAA,CAAS,eAAe,cAAc,CAAA;AAAA,EACxC;AAGA,EAAA,OAAO,QAAA,CAAS,MAAA,CAAO,MAAA,EAAQ,cAAc,CAAA;AAC/C;AAaO,SAAS,wBAAA,CACd,UACA,OAAA,EAKQ;AACR,EAAA,MAAM;AAAA,IACJ,WAAA,GAAc,IAAA;AAAA,IACd,aAAA,GAAgB,KAAA;AAAA,IAChB,gBAAA,GAAmB;AAAA,GACrB,GAAI,WAAW,EAAC;AAEhB,EAAA,MAAM,QAAkB,EAAC;AAGzB,EAAA,IAAI,SAAS,MAAA,EAAQ;AACnB,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,QAAA,EAAW,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AACvC,IAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AAAA,EACf;AAGA,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,oBAAA,EAAuB,QAAA,CAAS,KAAK,CAAA,EAAA,CAAI,CAAA;AACpD,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AAEb,EAAA,QAAA,CAAS,OAAA,CAAQ,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAC1C,IAAA,MAAM,MAAM,KAAA,GAAQ,CAAA;AACpB,IAAA,IAAI,UAAU,MAAA,CAAO,OAAA;AAGrB,IAAA,IAAI,gBAAA,IAAoB,OAAA,CAAQ,MAAA,GAAS,gBAAA,EAAkB;AACzD,MAAA,OAAA,GAAU,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,gBAAgB,CAAA,GAAI,KAAA;AAAA,IACjD;AAEA,IAAA,KAAA,CAAM,KAAK,CAAA,EAAG,GAAG,CAAA,EAAA,EAAK,MAAA,CAAO,KAAK,CAAA,CAAE,CAAA;AACpC,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,KAAA,CAAM,IAAA,CAAK,CAAA,QAAA,EAAW,MAAA,CAAO,GAAG,CAAA,CAAE,CAAA;AAAA,IACpC;AACA,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,GAAA,EAAM,OAAO,CAAA,CAAE,CAAA;AAC1B,IAAA,IAAI,aAAA,IAAiB,MAAA,CAAO,KAAA,KAAU,MAAA,EAAW;AAC/C,MAAA,KAAA,CAAM,IAAA,CAAK,kBAAkB,MAAA,CAAO,KAAA,GAAQ,KAAK,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,IAChE;AACA,IAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AAAA,EACf,CAAC,CAAA;AAED,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;AAQO,SAAS,uBAAuB,QAAA,EAAqC;AAC1E,EAAA,MAAM,KAAA,GAAQ,SAAS,OAAA,CAAQ,MAAA;AAC/B,EAAA,MAAM,OAAA,GAAU,SAAS,OAAA,CACtB,KAAA,CAAM,GAAG,CAAC,CAAA,CACV,IAAI,CAAC,CAAA,KAAM,EAAE,MAAA,IAAU,IAAI,IAAI,CAAA,CAAE,GAAG,EAAE,QAAQ,CAAA,CAC9C,KAAK,IAAI,CAAA;AAEZ,EAAA,IAAI,UAAU,CAAA,MAAA,EAAS,KAAK,UAAU,KAAA,KAAU,CAAA,GAAI,MAAM,EAAE,CAAA,CAAA;AAC5D,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,OAAA,IAAW,SAAS,OAAO,CAAA,CAAA;AAAA,EAC7B;AACA,EAAA,IAAI,SAAS,UAAA,EAAY;AACvB,IAAA,OAAA,IAAW,CAAA,EAAA,EAAK,SAAS,UAAU,CAAA,GAAA,CAAA;AAAA,EACrC;AAEA,EAAA,OAAO,OAAA;AACT","file":"chunk-NUXLAZOE.cjs","sourcesContent":["/**\n * Web Search Module\n *\n * Multi-provider web search with unified API.\n * Supports tree-shaking - only the provider you use gets bundled.\n *\n * @example\n * ```typescript\n * // Option 1: Lazy loading (provider loaded on first use)\n * import { executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n * { query: 'latest AI news' },\n * { provider: 'tavily', apiKey: 'your-api-key' }\n * );\n *\n * // Option 2: Direct import (best for tree-shaking)\n * import { tavilyProvider, executeWebSearch } from './webSearch';\n * const results = await executeWebSearch(\n * { query: 'latest AI news' },\n * { provider: tavilyProvider, apiKey: 'your-api-key' }\n * );\n * ```\n */\n\nimport type {\n WebSearchConfig,\n WebSearchParams,\n WebSearchResponse,\n WebSearchProvider,\n WebSearchProviderInterface,\n} from \"./types\";\n\n// ============================================\n// Lazy Provider Loading (for tree-shaking)\n// ============================================\n\n/**\n * Provider loaders - dynamically import providers only when needed.\n * This ensures unused providers are NOT included in the bundle.\n */\nconst providerLoaders: Record<\n WebSearchProvider,\n () => Promise<\n { default: WebSearchProviderInterface } | WebSearchProviderInterface\n >\n> = {\n openai: () => import(\"./providers/openai\").then((m) => m.openaiProvider),\n google: () => import(\"./providers/google\").then((m) => m.googleProvider),\n anthropic: () =>\n import(\"./providers/anthropic\").then((m) => m.anthropicProvider),\n tavily: () => import(\"./providers/tavily\").then((m) => m.tavilyProvider),\n serper: () => import(\"./providers/serper\").then((m) => m.serperProvider),\n brave: () => import(\"./providers/brave\").then((m) => m.braveProvider),\n searxng: () => import(\"./providers/searxng\").then((m) => m.searxngProvider),\n exa: () => import(\"./providers/exa\").then((m) => m.exaProvider),\n};\n\n// Cache for loaded providers\nconst loadedProviders: Map<WebSearchProvider, WebSearchProviderInterface> =\n new Map();\n\n/**\n * Get a provider by name (lazy loading)\n *\n * @param name - Provider name string\n * @returns Provider interface (loaded dynamically)\n */\nexport async function getProvider(\n name: WebSearchProvider,\n): Promise<WebSearchProviderInterface> {\n // Check cache first\n const cached = loadedProviders.get(name);\n if (cached) {\n return cached;\n }\n\n // Load provider dynamically\n const loader = providerLoaders[name];\n if (!loader) {\n throw new Error(\n `Unknown search provider: ${name}. ` +\n `Available providers: ${Object.keys(providerLoaders).join(\", \")}`,\n );\n }\n\n const provider = await loader();\n const resolvedProvider = \"default\" in provider ? provider.default : provider;\n\n // Cache for future use\n loadedProviders.set(name, resolvedProvider as WebSearchProviderInterface);\n\n return resolvedProvider as WebSearchProviderInterface;\n}\n\n/**\n * Get all available provider names\n */\nexport function getAvailableProviders(): WebSearchProvider[] {\n return Object.keys(providerLoaders) as WebSearchProvider[];\n}\n\n// ============================================\n// Extended Config with Direct Provider Support\n// ============================================\n\n/**\n * Extended config that allows passing provider directly for tree-shaking\n */\nexport interface WebSearchConfigExtended extends Omit<\n WebSearchConfig,\n \"provider\"\n> {\n /**\n * Provider can be either:\n * - A string name (lazy loaded): \"tavily\", \"openai\", \"anthropic\", \"google\", etc.\n * - A provider instance (best for tree-shaking): import { tavilyProvider } from '...'\n */\n provider: WebSearchProvider | WebSearchProviderInterface;\n}\n\n/**\n * Check if a value is a provider interface (not a string)\n */\nfunction isProviderInterface(\n provider: WebSearchProvider | WebSearchProviderInterface,\n): provider is WebSearchProviderInterface {\n return typeof provider === \"object\" && \"search\" in provider;\n}\n\n// ============================================\n// Execute Search\n// ============================================\n\n/**\n * Execute a web search using the configured provider\n *\n * @param params - Search parameters (query, maxResults, searchDepth)\n * @param config - Provider configuration (provider, apiKey, options)\n * @returns Search results with optional AI-generated answer\n *\n * @example\n * ```typescript\n * // Option 1: String provider name (lazy loaded)\n * const results = await executeWebSearch(\n * { query: 'What is the latest news about SpaceX?' },\n * {\n * provider: 'tavily',\n * apiKey: process.env.TAVILY_API_KEY,\n * }\n * );\n *\n * // Option 2: Direct provider import (best for tree-shaking)\n * import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\n * const results = await executeWebSearch(\n * { query: 'What is the latest news about SpaceX?' },\n * {\n * provider: tavilyProvider,\n * apiKey: process.env.TAVILY_API_KEY,\n * }\n * );\n * ```\n */\nexport async function executeWebSearch(\n params: WebSearchParams,\n config: WebSearchConfigExtended,\n): Promise<WebSearchResponse> {\n // Resolve provider (either from string or direct reference)\n const provider = isProviderInterface(config.provider)\n ? config.provider\n : await getProvider(config.provider);\n\n // Build config with string provider name for validation\n const providerName: WebSearchProvider = isProviderInterface(config.provider)\n ? (\"custom\" as WebSearchProvider) // Direct provider\n : config.provider;\n\n const resolvedConfig: WebSearchConfig = {\n ...config,\n provider: providerName,\n };\n\n // Validate configuration if provider supports it\n if (provider.validateConfig) {\n provider.validateConfig(resolvedConfig);\n }\n\n // Execute search\n return provider.search(params, resolvedConfig);\n}\n\n// ============================================\n// Utility Functions\n// ============================================\n\n/**\n * Format search results for display in AI context\n *\n * @param response - Web search response\n * @param options - Formatting options\n * @returns Formatted string for AI consumption\n */\nexport function formatSearchResultsForAI(\n response: WebSearchResponse,\n options?: {\n includeUrls?: boolean;\n includeScores?: boolean;\n maxContentLength?: number;\n },\n): string {\n const {\n includeUrls = true,\n includeScores = false,\n maxContentLength = 200,\n } = options || {};\n\n const lines: string[] = [];\n\n // Add answer if available\n if (response.answer) {\n lines.push(`Answer: ${response.answer}`);\n lines.push(\"\");\n }\n\n // Add results\n lines.push(`Search results for \"${response.query}\":`);\n lines.push(\"\");\n\n response.results.forEach((result, index) => {\n const num = index + 1;\n let content = result.content;\n\n // Truncate content if needed\n if (maxContentLength && content.length > maxContentLength) {\n content = content.slice(0, maxContentLength) + \"...\";\n }\n\n lines.push(`${num}. ${result.title}`);\n if (includeUrls) {\n lines.push(` URL: ${result.url}`);\n }\n lines.push(` ${content}`);\n if (includeScores && result.score !== undefined) {\n lines.push(` Relevance: ${(result.score * 100).toFixed(1)}%`);\n }\n lines.push(\"\");\n });\n\n return lines.join(\"\\n\");\n}\n\n/**\n * Create a minimal search result summary\n *\n * @param response - Web search response\n * @returns Brief summary string\n */\nexport function summarizeSearchResults(response: WebSearchResponse): string {\n const count = response.results.length;\n const sources = response.results\n .slice(0, 3)\n .map((r) => r.domain || new URL(r.url).hostname)\n .join(\", \");\n\n let summary = `Found ${count} result${count !== 1 ? \"s\" : \"\"}`;\n if (sources) {\n summary += ` from ${sources}`;\n }\n if (response.searchTime) {\n summary += ` (${response.searchTime}ms)`;\n }\n\n return summary;\n}\n\n// ============================================\n// Re-exports\n// ============================================\n\n// Export types\nexport * from \"./types\";\n\n// Export individual providers for direct import (tree-shakeable)\n// Users should import these directly for best bundle size:\n// import { tavilyProvider } from '@yourgpt/copilot-sdk/core';\nexport { openaiProvider } from \"./providers/openai\";\nexport { googleProvider } from \"./providers/google\";\nexport { anthropicProvider } from \"./providers/anthropic\";\nexport { tavilyProvider } from \"./providers/tavily\";\nexport { serperProvider } from \"./providers/serper\";\nexport { braveProvider } from \"./providers/brave\";\nexport { searxngProvider } from \"./providers/searxng\";\nexport { exaProvider } from \"./providers/exa\";\n"]}
@@ -1,5 +1,5 @@
1
- import { webSearchTool } from './chunk-LZMBBGWH.js';
2
- import { tool, failure, success } from './chunk-QLH6TSCC.js';
1
+ import { webSearchTool } from './chunk-ENFWM3EY.js';
2
+ import { tool, failure, success } from './chunk-4QXY2PBG.js';
3
3
 
4
4
  // src/core/tools/screenshot.ts
5
5
  var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
@@ -1308,6 +1308,47 @@ var builtinTools = {
1308
1308
  }
1309
1309
  };
1310
1310
 
1311
+ // src/core/utils/logger.ts
1312
+ function isEnabled(getEnabled) {
1313
+ if (typeof window !== "undefined" && window.__COPILOT_DEBUG !== void 0) {
1314
+ return !!window.__COPILOT_DEBUG;
1315
+ }
1316
+ return getEnabled();
1317
+ }
1318
+ function logOnce(scope, enabled, action, data) {
1319
+ if (!isEnabled(() => enabled)) return;
1320
+ const prefix = `[${scope}]`;
1321
+ if (data !== void 0) {
1322
+ console.log(prefix, action, data);
1323
+ } else {
1324
+ console.log(prefix, action);
1325
+ }
1326
+ }
1327
+ function createLogger(scope, getEnabled) {
1328
+ const prefix = `[${scope}]`;
1329
+ function log(action, data) {
1330
+ if (!isEnabled(getEnabled)) return;
1331
+ if (data !== void 0) {
1332
+ console.log(prefix, action, data);
1333
+ } else {
1334
+ console.log(prefix, action);
1335
+ }
1336
+ }
1337
+ log.group = function(label) {
1338
+ if (!isEnabled(getEnabled)) return;
1339
+ console.group(`${prefix} ${label}`);
1340
+ };
1341
+ log.groupCollapsed = function(label) {
1342
+ if (!isEnabled(getEnabled)) return;
1343
+ console.groupCollapsed(`${prefix} ${label}`);
1344
+ };
1345
+ log.groupEnd = function() {
1346
+ if (!isEnabled(getEnabled)) return;
1347
+ console.groupEnd();
1348
+ };
1349
+ return log;
1350
+ }
1351
+
1311
1352
  // src/core/utils/id.ts
1312
1353
  function generateId(prefix = "id") {
1313
1354
  return `${prefix}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
@@ -1349,7 +1390,9 @@ function createMessage(partial) {
1349
1390
  tool_calls: partial.tool_calls,
1350
1391
  tool_call_id: partial.tool_call_id,
1351
1392
  metadata: partial.metadata,
1352
- created_at: partial.created_at ?? /* @__PURE__ */ new Date()
1393
+ created_at: partial.created_at ?? /* @__PURE__ */ new Date(),
1394
+ ...partial.parent_id !== void 0 ? { parent_id: partial.parent_id } : {},
1395
+ ...partial.children_ids !== void 0 ? { children_ids: partial.children_ids } : {}
1353
1396
  };
1354
1397
  }
1355
1398
  function createUserMessage(content, options) {
@@ -1358,7 +1401,8 @@ function createUserMessage(content, options) {
1358
1401
  thread_id: options?.thread_id,
1359
1402
  role: "user",
1360
1403
  content,
1361
- metadata: options?.attachments ? { attachments: options.attachments } : void 0
1404
+ metadata: options?.attachments ? { attachments: options.attachments } : void 0,
1405
+ ...options?.parent_id !== void 0 ? { parent_id: options.parent_id } : {}
1362
1406
  });
1363
1407
  }
1364
1408
  function createAssistantMessage(content, options) {
@@ -1647,6 +1691,10 @@ function getZodEnumValues(schema) {
1647
1691
  return null;
1648
1692
  }
1649
1693
  function zodToJsonSchema(schema) {
1694
+ const result = _zodToJsonSchemaInternal(schema);
1695
+ return result;
1696
+ }
1697
+ function _zodToJsonSchemaInternal(schema) {
1650
1698
  if (!isZodSchema(schema)) {
1651
1699
  return { type: "string" };
1652
1700
  }
@@ -1688,7 +1736,7 @@ function zodToJsonSchema(schema) {
1688
1736
  const innerType = getZodInnerType(schema);
1689
1737
  const result2 = {
1690
1738
  type: "array",
1691
- items: innerType ? zodToJsonSchema(innerType) : { type: "string" }
1739
+ items: innerType ? _zodToJsonSchemaInternal(innerType) : { type: "string" }
1692
1740
  };
1693
1741
  if (description) result2.description = description;
1694
1742
  return result2;
@@ -1701,7 +1749,7 @@ function zodToJsonSchema(schema) {
1701
1749
  const properties = {};
1702
1750
  const required = [];
1703
1751
  for (const [key, value] of Object.entries(shapeObj)) {
1704
- properties[key] = zodToJsonSchema(value);
1752
+ properties[key] = _zodToJsonSchemaInternal(value);
1705
1753
  const fieldTypeName = getZodTypeName(value);
1706
1754
  if (fieldTypeName !== "ZodOptional" && fieldTypeName !== "ZodNullable") {
1707
1755
  required.push(key);
@@ -1719,14 +1767,14 @@ function zodToJsonSchema(schema) {
1719
1767
  case "ZodNullable": {
1720
1768
  const innerType = getZodInnerType(schema);
1721
1769
  if (innerType) {
1722
- return zodToJsonSchema(innerType);
1770
+ return _zodToJsonSchemaInternal(innerType);
1723
1771
  }
1724
1772
  return { type: "string", description };
1725
1773
  }
1726
1774
  case "ZodDefault": {
1727
1775
  const innerType = getZodInnerType(schema);
1728
1776
  if (innerType) {
1729
- const result2 = zodToJsonSchema(innerType);
1777
+ const result2 = _zodToJsonSchemaInternal(innerType);
1730
1778
  return result2;
1731
1779
  }
1732
1780
  return { type: "string", description };
@@ -1765,7 +1813,7 @@ function zodToJsonSchema(schema) {
1765
1813
  options = def?.options;
1766
1814
  }
1767
1815
  if (options && options.length > 0) {
1768
- return zodToJsonSchema(options[0]);
1816
+ return _zodToJsonSchemaInternal(options[0]);
1769
1817
  }
1770
1818
  return { type: "string", description };
1771
1819
  }
@@ -1776,7 +1824,7 @@ function zodToJsonSchema(schema) {
1776
1824
  }
1777
1825
  }
1778
1826
  function zodObjectToInputSchema(schema) {
1779
- const jsonSchema = zodToJsonSchema(schema);
1827
+ const jsonSchema = _zodToJsonSchemaInternal(schema);
1780
1828
  if (jsonSchema.type !== "object" || !jsonSchema.properties) {
1781
1829
  const typeName = getZodTypeName(schema);
1782
1830
  throw new Error(
@@ -2817,6 +2865,6 @@ function createThreadManager(config, callbacks) {
2817
2865
  return new ThreadManager(config, callbacks);
2818
2866
  }
2819
2867
 
2820
- export { CLOUD_MAX_FILE_SIZE, DEFAULT_YOURGPT_ENDPOINT, SimpleThreadManagerState, ThreadManager, actionToTool, builtinTools, captureCurrentLogs, captureScreenshot, clearConsoleLogs, clearNetworkRequests, consoleLogsTool, createAssistantMessage, createCloudStorage, createConsoleLogsTool, createCustomDetector, createLocalStorageAdapter, createMemoryAdapter, createMessage, createNetworkRequestsTool, createSSEStream, createScreenshotTool, createServerAdapter, createThreadManager, createToolCall, createToolMessage, createUserMessage, defaultSystemMessage, defineClientTool, defineServerTool, defineTool, detectIntent, formatLogsForAI, formatRequestsForAI, formatSSE, generateId, generateMessageId, generateSuggestionReason, generateThreadId, generateThreadTitle, generateToolCallId, getAttachmentTypeFromMime, getConsoleErrors, getConsoleLogs, getConsoleWarnings, getFailedRequests, getNetworkRequests, getPrimaryTool, hasToolCalls, hasToolSuggestions, isConsoleCaptureActive, isNetworkCaptureActive, isScreenshotSupported, isToolResult, localStorageAdapter, networkRequestsTool, noopAdapter, parseSSELine, parseStreamEvent, parseToolCallArgs, processFileToAttachment, resizeScreenshot, screenshotTool, serializeStreamEvent, startConsoleCapture, startNetworkCapture, stopConsoleCapture, stopNetworkCapture, streamSSE, zodObjectToInputSchema, zodToJsonSchema };
2821
- //# sourceMappingURL=chunk-VFV5FVVI.js.map
2822
- //# sourceMappingURL=chunk-VFV5FVVI.js.map
2868
+ export { CLOUD_MAX_FILE_SIZE, DEFAULT_YOURGPT_ENDPOINT, SimpleThreadManagerState, ThreadManager, actionToTool, builtinTools, captureCurrentLogs, captureScreenshot, clearConsoleLogs, clearNetworkRequests, consoleLogsTool, createAssistantMessage, createCloudStorage, createConsoleLogsTool, createCustomDetector, createLocalStorageAdapter, createLogger, createMemoryAdapter, createMessage, createNetworkRequestsTool, createSSEStream, createScreenshotTool, createServerAdapter, createThreadManager, createToolCall, createToolMessage, createUserMessage, defaultSystemMessage, defineClientTool, defineServerTool, defineTool, detectIntent, formatLogsForAI, formatRequestsForAI, formatSSE, generateId, generateMessageId, generateSuggestionReason, generateThreadId, generateThreadTitle, generateToolCallId, getAttachmentTypeFromMime, getConsoleErrors, getConsoleLogs, getConsoleWarnings, getFailedRequests, getNetworkRequests, getPrimaryTool, hasToolCalls, hasToolSuggestions, isConsoleCaptureActive, isNetworkCaptureActive, isScreenshotSupported, isToolResult, localStorageAdapter, logOnce, networkRequestsTool, noopAdapter, parseSSELine, parseStreamEvent, parseToolCallArgs, processFileToAttachment, resizeScreenshot, screenshotTool, serializeStreamEvent, startConsoleCapture, startNetworkCapture, stopConsoleCapture, stopNetworkCapture, streamSSE, zodObjectToInputSchema, zodToJsonSchema };
2869
+ //# sourceMappingURL=chunk-UXJ6LIZB.js.map
2870
+ //# sourceMappingURL=chunk-UXJ6LIZB.js.map