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

package/dist/google-CTEK6SV2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"google-CTEK6SV2.js"}

package/dist/google-Da8IQxaI.d.ts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.js';
+
+/**
+ * Google Web Search Provider (Grounding with Google Search)
+ *
+ * Uses Google's built-in grounding feature via the Gemini API.
+ * No third-party API key required - uses your Google/Gemini API key.
+ *
+ * @see https://ai.google.dev/gemini-api/docs/google-search
+ */
+
+/**
+ * Google native search provider implementation
+ */
+declare const googleProvider: WebSearchProviderInterface;
+
+export { googleProvider as g };

package/dist/google-IIUXFFVF.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var chunkXWOHNY3F_cjs = require('./chunk-XWOHNY3F.cjs');
+require('./chunk-JEQ2X3Z6.cjs');
+
+
+
+Object.defineProperty(exports, "googleProvider", {
+  enumerable: true,
+  get: function () { return chunkXWOHNY3F_cjs.googleProvider; }
+});
+Object.defineProperty(exports, "searchGoogle", {
+  enumerable: true,
+  get: function () { return chunkXWOHNY3F_cjs.searchGoogle; }
+});
+Object.defineProperty(exports, "validateGoogleConfig", {
+  enumerable: true,
+  get: function () { return chunkXWOHNY3F_cjs.validateGoogleConfig; }
+});
+//# sourceMappingURL=google-IIUXFFVF.cjs.map
+//# sourceMappingURL=google-IIUXFFVF.cjs.map

package/dist/google-IIUXFFVF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"google-IIUXFFVF.cjs"}

package/dist/index-2VtgKM8S.d.cts

@@ -0,0 +1,206 @@
+import { b as WebSearchConfig, a as WebSearchProvider, W as WebSearchProviderInterface, c as WebSearchParams, f as WebSearchResponse } from './types-ZguuKEs_.cjs';
+import { T as ToolDefinition } from './tools-DDWrco4h.cjs';
+
+/**
+ * Web Search Module
+ *
+ * Multi-provider web search with unified API.
+ * Supports tree-shaking - only the provider you use gets bundled.
+ *
+ * @example
+ * ```typescript
+ * // Option 1: Lazy loading (provider loaded on first use)
+ * import { executeWebSearch } from './webSearch';
+ * const results = await executeWebSearch(
+ *   { query: 'latest AI news' },
+ *   { provider: 'tavily', apiKey: 'your-api-key' }
+ * );
+ *
+ * // Option 2: Direct import (best for tree-shaking)
+ * import { tavilyProvider, executeWebSearch } from './webSearch';
+ * const results = await executeWebSearch(
+ *   { query: 'latest AI news' },
+ *   { provider: tavilyProvider, apiKey: 'your-api-key' }
+ * );
+ * ```
+ */
+
+/**
+ * Get a provider by name (lazy loading)
+ *
+ * @param name - Provider name string
+ * @returns Provider interface (loaded dynamically)
+ */
+declare function getProvider(name: WebSearchProvider): Promise<WebSearchProviderInterface>;
+/**
+ * Get all available provider names
+ */
+declare function getAvailableProviders(): WebSearchProvider[];
+/**
+ * Extended config that allows passing provider directly for tree-shaking
+ */
+interface WebSearchConfigExtended extends Omit<WebSearchConfig, "provider"> {
+    /**
+     * Provider can be either:
+     * - A string name (lazy loaded): "tavily", "openai", "anthropic", "google", etc.
+     * - A provider instance (best for tree-shaking): import { tavilyProvider } from '...'
+     */
+    provider: WebSearchProvider | WebSearchProviderInterface;
+}
+/**
+ * Execute a web search using the configured provider
+ *
+ * @param params - Search parameters (query, maxResults, searchDepth)
+ * @param config - Provider configuration (provider, apiKey, options)
+ * @returns Search results with optional AI-generated answer
+ *
+ * @example
+ * ```typescript
+ * // Option 1: String provider name (lazy loaded)
+ * const results = await executeWebSearch(
+ *   { query: 'What is the latest news about SpaceX?' },
+ *   {
+ *     provider: 'tavily',
+ *     apiKey: process.env.TAVILY_API_KEY,
+ *   }
+ * );
+ *
+ * // Option 2: Direct provider import (best for tree-shaking)
+ * import { tavilyProvider } from '@yourgpt/copilot-sdk/core';
+ * const results = await executeWebSearch(
+ *   { query: 'What is the latest news about SpaceX?' },
+ *   {
+ *     provider: tavilyProvider,
+ *     apiKey: process.env.TAVILY_API_KEY,
+ *   }
+ * );
+ * ```
+ */
+declare function executeWebSearch(params: WebSearchParams, config: WebSearchConfigExtended): Promise<WebSearchResponse>;
+/**
+ * Format search results for display in AI context
+ *
+ * @param response - Web search response
+ * @param options - Formatting options
+ * @returns Formatted string for AI consumption
+ */
+declare function formatSearchResultsForAI(response: WebSearchResponse, options?: {
+    includeUrls?: boolean;
+    includeScores?: boolean;
+    maxContentLength?: number;
+}): string;
+/**
+ * Create a minimal search result summary
+ *
+ * @param response - Web search response
+ * @returns Brief summary string
+ */
+declare function summarizeSearchResults(response: WebSearchResponse): string;
+
+/**
+ * Built-in Web Search Tool
+ *
+ * A pre-configured tool for searching the web with multiple provider support.
+ * Runs on the server to protect API keys.
+ *
+ * Supports tree-shaking - import providers directly for smaller bundles.
+ *
+ * @example
+ * ```typescript
+ * // Option 1: String provider (lazy loaded at runtime)
+ * import { createWebSearchTool } from '@yourgpt/copilot-sdk';
+ * const webSearch = createWebSearchTool({
+ *   provider: 'tavily',
+ *   apiKey: process.env.TAVILY_API_KEY,
+ * });
+ *
+ * // Option 2: Direct provider import (best for tree-shaking)
+ * import { createWebSearchTool, tavilyProvider } from '@yourgpt/copilot-sdk';
+ * const webSearch = createWebSearchTool({
+ *   provider: tavilyProvider,
+ *   apiKey: process.env.TAVILY_API_KEY,
+ * });
+ *
+ * // Add to your runtime
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+
+/**
+ * Base web search tool definition
+ *
+ * This is the core tool definition. Use `createWebSearchTool()` to create
+ * a configured instance with your provider settings.
+ */
+declare const webSearchTool: Omit<ToolDefinition<WebSearchParams>, "name">;
+/**
+ * Create a configured web search tool
+ *
+ * Supports both string provider names (lazy loaded) and direct provider imports (tree-shakeable).
+ *
+ * @param config - Web search configuration including provider and API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * // ===== BEST FOR TREE-SHAKING: Direct provider import =====
+ * import { createWebSearchTool, openaiProvider } from '@yourgpt/copilot-sdk/core';
+ *
+ * const webSearch = createWebSearchTool({
+ *   provider: openaiProvider, // Only this provider in bundle
+ *   apiKey: process.env.OPENAI_API_KEY,
+ * });
+ *
+ * // ===== STRING PROVIDERS (Lazy loaded at runtime) =====
+ *
+ * // OpenAI (uses your OpenAI API key)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'openai',
+ *   apiKey: process.env.OPENAI_API_KEY,
+ * });
+ *
+ * // Google (uses your Google/Gemini API key)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'google',
+ *   apiKey: process.env.GOOGLE_API_KEY,
+ * });
+ *
+ * // Tavily (AI-optimized search with answer generation)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'tavily',
+ *   apiKey: process.env.TAVILY_API_KEY,
+ *   includeAnswer: true,
+ *   maxResults: 5,
+ * });
+ *
+ * // Serper (Google results)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'serper',
+ *   apiKey: process.env.SERPER_API_KEY,
+ * });
+ *
+ * // Brave Search (privacy-focused)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'brave',
+ *   apiKey: process.env.BRAVE_API_KEY,
+ * });
+ *
+ * // Self-hosted SearXNG (no API key needed)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'searxng',
+ *   baseUrl: 'https://your-searxng-instance.com',
+ * });
+ *
+ * // Exa (AI-optimized semantic search)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'exa',
+ *   apiKey: process.env.EXA_API_KEY,
+ *   searchDepth: 'advanced',
+ * });
+ * ```
+ */
+declare function createWebSearchTool(config: WebSearchConfigExtended): ToolDefinition<WebSearchParams>;
+
+export { getAvailableProviders as a, createWebSearchTool as c, executeWebSearch as e, formatSearchResultsForAI as f, getProvider as g, summarizeSearchResults as s, webSearchTool as w };

package/dist/index-pWEH7pUE.d.ts

@@ -0,0 +1,206 @@
+import { b as WebSearchConfig, a as WebSearchProvider, W as WebSearchProviderInterface, c as WebSearchParams, f as WebSearchResponse } from './types-ZguuKEs_.js';
+import { T as ToolDefinition } from './tools-DDWrco4h.js';
+
+/**
+ * Web Search Module
+ *
+ * Multi-provider web search with unified API.
+ * Supports tree-shaking - only the provider you use gets bundled.
+ *
+ * @example
+ * ```typescript
+ * // Option 1: Lazy loading (provider loaded on first use)
+ * import { executeWebSearch } from './webSearch';
+ * const results = await executeWebSearch(
+ *   { query: 'latest AI news' },
+ *   { provider: 'tavily', apiKey: 'your-api-key' }
+ * );
+ *
+ * // Option 2: Direct import (best for tree-shaking)
+ * import { tavilyProvider, executeWebSearch } from './webSearch';
+ * const results = await executeWebSearch(
+ *   { query: 'latest AI news' },
+ *   { provider: tavilyProvider, apiKey: 'your-api-key' }
+ * );
+ * ```
+ */
+
+/**
+ * Get a provider by name (lazy loading)
+ *
+ * @param name - Provider name string
+ * @returns Provider interface (loaded dynamically)
+ */
+declare function getProvider(name: WebSearchProvider): Promise<WebSearchProviderInterface>;
+/**
+ * Get all available provider names
+ */
+declare function getAvailableProviders(): WebSearchProvider[];
+/**
+ * Extended config that allows passing provider directly for tree-shaking
+ */
+interface WebSearchConfigExtended extends Omit<WebSearchConfig, "provider"> {
+    /**
+     * Provider can be either:
+     * - A string name (lazy loaded): "tavily", "openai", "anthropic", "google", etc.
+     * - A provider instance (best for tree-shaking): import { tavilyProvider } from '...'
+     */
+    provider: WebSearchProvider | WebSearchProviderInterface;
+}
+/**
+ * Execute a web search using the configured provider
+ *
+ * @param params - Search parameters (query, maxResults, searchDepth)
+ * @param config - Provider configuration (provider, apiKey, options)
+ * @returns Search results with optional AI-generated answer
+ *
+ * @example
+ * ```typescript
+ * // Option 1: String provider name (lazy loaded)
+ * const results = await executeWebSearch(
+ *   { query: 'What is the latest news about SpaceX?' },
+ *   {
+ *     provider: 'tavily',
+ *     apiKey: process.env.TAVILY_API_KEY,
+ *   }
+ * );
+ *
+ * // Option 2: Direct provider import (best for tree-shaking)
+ * import { tavilyProvider } from '@yourgpt/copilot-sdk/core';
+ * const results = await executeWebSearch(
+ *   { query: 'What is the latest news about SpaceX?' },
+ *   {
+ *     provider: tavilyProvider,
+ *     apiKey: process.env.TAVILY_API_KEY,
+ *   }
+ * );
+ * ```
+ */
+declare function executeWebSearch(params: WebSearchParams, config: WebSearchConfigExtended): Promise<WebSearchResponse>;
+/**
+ * Format search results for display in AI context
+ *
+ * @param response - Web search response
+ * @param options - Formatting options
+ * @returns Formatted string for AI consumption
+ */
+declare function formatSearchResultsForAI(response: WebSearchResponse, options?: {
+    includeUrls?: boolean;
+    includeScores?: boolean;
+    maxContentLength?: number;
+}): string;
+/**
+ * Create a minimal search result summary
+ *
+ * @param response - Web search response
+ * @returns Brief summary string
+ */
+declare function summarizeSearchResults(response: WebSearchResponse): string;
+
+/**
+ * Built-in Web Search Tool
+ *
+ * A pre-configured tool for searching the web with multiple provider support.
+ * Runs on the server to protect API keys.
+ *
+ * Supports tree-shaking - import providers directly for smaller bundles.
+ *
+ * @example
+ * ```typescript
+ * // Option 1: String provider (lazy loaded at runtime)
+ * import { createWebSearchTool } from '@yourgpt/copilot-sdk';
+ * const webSearch = createWebSearchTool({
+ *   provider: 'tavily',
+ *   apiKey: process.env.TAVILY_API_KEY,
+ * });
+ *
+ * // Option 2: Direct provider import (best for tree-shaking)
+ * import { createWebSearchTool, tavilyProvider } from '@yourgpt/copilot-sdk';
+ * const webSearch = createWebSearchTool({
+ *   provider: tavilyProvider,
+ *   apiKey: process.env.TAVILY_API_KEY,
+ * });
+ *
+ * // Add to your runtime
+ * const runtime = createRuntime({
+ *   tools: [webSearch],
+ * });
+ * ```
+ */
+
+/**
+ * Base web search tool definition
+ *
+ * This is the core tool definition. Use `createWebSearchTool()` to create
+ * a configured instance with your provider settings.
+ */
+declare const webSearchTool: Omit<ToolDefinition<WebSearchParams>, "name">;
+/**
+ * Create a configured web search tool
+ *
+ * Supports both string provider names (lazy loaded) and direct provider imports (tree-shakeable).
+ *
+ * @param config - Web search configuration including provider and API key
+ * @returns A configured tool definition ready to use
+ *
+ * @example
+ * ```typescript
+ * // ===== BEST FOR TREE-SHAKING: Direct provider import =====
+ * import { createWebSearchTool, openaiProvider } from '@yourgpt/copilot-sdk/core';
+ *
+ * const webSearch = createWebSearchTool({
+ *   provider: openaiProvider, // Only this provider in bundle
+ *   apiKey: process.env.OPENAI_API_KEY,
+ * });
+ *
+ * // ===== STRING PROVIDERS (Lazy loaded at runtime) =====
+ *
+ * // OpenAI (uses your OpenAI API key)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'openai',
+ *   apiKey: process.env.OPENAI_API_KEY,
+ * });
+ *
+ * // Google (uses your Google/Gemini API key)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'google',
+ *   apiKey: process.env.GOOGLE_API_KEY,
+ * });
+ *
+ * // Tavily (AI-optimized search with answer generation)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'tavily',
+ *   apiKey: process.env.TAVILY_API_KEY,
+ *   includeAnswer: true,
+ *   maxResults: 5,
+ * });
+ *
+ * // Serper (Google results)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'serper',
+ *   apiKey: process.env.SERPER_API_KEY,
+ * });
+ *
+ * // Brave Search (privacy-focused)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'brave',
+ *   apiKey: process.env.BRAVE_API_KEY,
+ * });
+ *
+ * // Self-hosted SearXNG (no API key needed)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'searxng',
+ *   baseUrl: 'https://your-searxng-instance.com',
+ * });
+ *
+ * // Exa (AI-optimized semantic search)
+ * const webSearch = createWebSearchTool({
+ *   provider: 'exa',
+ *   apiKey: process.env.EXA_API_KEY,
+ *   searchDepth: 'advanced',
+ * });
+ * ```
+ */
+declare function createWebSearchTool(config: WebSearchConfigExtended): ToolDefinition<WebSearchParams>;
+
+export { getAvailableProviders as a, createWebSearchTool as c, executeWebSearch as e, formatSearchResultsForAI as f, getProvider as g, summarizeSearchResults as s, webSearchTool as w };