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

package/dist/chunk-ASV6JLYG.cjs

@@ -0,0 +1,99 @@
+'use strict';
+
+// src/core/tools/webSearch/index.ts
+var providerLoaders = {
+  openai: () => import('./openai-6KTCQ7PZ.cjs').then((m) => m.openaiProvider),
+  google: () => import('./google-IIUXFFVF.cjs').then((m) => m.googleProvider),
+  anthropic: () => import('./anthropic-NMTRABEH.cjs').then((m) => m.anthropicProvider),
+  tavily: () => import('./tavily-AWFP4RM7.cjs').then((m) => m.tavilyProvider),
+  serper: () => import('./serper-63FT4AOL.cjs').then((m) => m.serperProvider),
+  brave: () => import('./brave-OYKCOZEM.cjs').then((m) => m.braveProvider),
+  searxng: () => import('./searxng-EJKNY236.cjs').then((m) => m.searxngProvider),
+  exa: () => import('./exa-72KFY5A7.cjs').then((m) => m.exaProvider)
+};
+var loadedProviders = /* @__PURE__ */ new Map();
+async function getProvider(name) {
+  const cached = loadedProviders.get(name);
+  if (cached) {
+    return cached;
+  }
+  const loader = providerLoaders[name];
+  if (!loader) {
+    throw new Error(
+      `Unknown search provider: ${name}. Available providers: ${Object.keys(providerLoaders).join(", ")}`
+    );
+  }
+  const provider = await loader();
+  const resolvedProvider = "default" in provider ? provider.default : provider;
+  loadedProviders.set(name, resolvedProvider);
+  return resolvedProvider;
+}
+function getAvailableProviders() {
+  return Object.keys(providerLoaders);
+}
+function isProviderInterface(provider) {
+  return typeof provider === "object" && "search" in provider;
+}
+async function executeWebSearch(params, config) {
+  const provider = isProviderInterface(config.provider) ? config.provider : await getProvider(config.provider);
+  const providerName = isProviderInterface(config.provider) ? "custom" : config.provider;
+  const resolvedConfig = {
+    ...config,
+    provider: providerName
+  };
+  if (provider.validateConfig) {
+    provider.validateConfig(resolvedConfig);
+  }
+  return provider.search(params, resolvedConfig);
+}
+function formatSearchResultsForAI(response, options) {
+  const {
+    includeUrls = true,
+    includeScores = false,
+    maxContentLength = 200
+  } = options || {};
+  const lines = [];
+  if (response.answer) {
+    lines.push(`Answer: ${response.answer}`);
+    lines.push("");
+  }
+  lines.push(`Search results for "${response.query}":`);
+  lines.push("");
+  response.results.forEach((result, index) => {
+    const num = index + 1;
+    let content = result.content;
+    if (maxContentLength && content.length > maxContentLength) {
+      content = content.slice(0, maxContentLength) + "...";
+    }
+    lines.push(`${num}. ${result.title}`);
+    if (includeUrls) {
+      lines.push(`   URL: ${result.url}`);
+    }
+    lines.push(`   ${content}`);
+    if (includeScores && result.score !== void 0) {
+      lines.push(`   Relevance: ${(result.score * 100).toFixed(1)}%`);
+    }
+    lines.push("");
+  });
+  return lines.join("\n");
+}
+function summarizeSearchResults(response) {
+  const count = response.results.length;
+  const sources = response.results.slice(0, 3).map((r) => r.domain || new URL(r.url).hostname).join(", ");
+  let summary = `Found ${count} result${count !== 1 ? "s" : ""}`;
+  if (sources) {
+    summary += ` from ${sources}`;
+  }
+  if (response.searchTime) {
+    summary += ` (${response.searchTime}ms)`;
+  }
+  return summary;
+}
+
+exports.executeWebSearch = executeWebSearch;
+exports.formatSearchResultsForAI = formatSearchResultsForAI;
+exports.getAvailableProviders = getAvailableProviders;
+exports.getProvider = getProvider;
+exports.summarizeSearchResults = summarizeSearchResults;
+//# sourceMappingURL=chunk-ASV6JLYG.cjs.map
+//# sourceMappingURL=chunk-ASV6JLYG.cjs.map

package/dist/chunk-ASV6JLYG.cjs.map

@@ -0,0 +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"]}