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

package/README.md

@@ -44,6 +44,48 @@ function App() {
 | `/ui`    | Pre-built UI components        |
 | `/core`  | Types, utilities, tool helpers |
 
+## Built-in Tools
+
+### Web Search
+
+Add real-time web search capabilities to your AI copilot. **No extra API key needed** - use your existing OpenAI or Google key.
+
+```typescript
+import { createWebSearchTool } from "@yourgpt/copilot-sdk/core";
+
+// Use OpenAI's built-in search (recommended)
+const webSearch = createWebSearchTool({
+  provider: "openai",
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+// Or use Google's built-in search
+const webSearch = createWebSearchTool({
+  provider: "google",
+  apiKey: process.env.GOOGLE_API_KEY,
+});
+
+const runtime = createRuntime({
+  provider: openai,
+  model: "gpt-4o",
+  tools: [webSearch],
+});
+```
+
+**Native Providers (No extra API needed):**
+
+- `openai` - OpenAI's built-in web search
+- `google` - Google's grounding with Google Search
+- `anthropic` - Anthropic's built-in web search
+
+**Third-Party Providers:**
+
+- [Tavily](https://tavily.com/) - AI-native search with answer generation
+- [Serper](https://serper.dev/) - Google Search API
+- [Brave](https://brave.com/search/api/) - Privacy-focused search
+- [Exa](https://exa.ai/) - Semantic AI search
+- [SearXNG](https://docs.searxng.org/) - Self-hosted metasearch
+
 ## Examples
 
 Explore real-world implementations and demo projects.

package/dist/{ThreadManager-JT0sqSSD.d.ts → ThreadManager-Dkp_eLty.d.ts}

@@ -1,4 +1,4 @@
-import { k as Thread, l as ThreadData, _ as ThreadStorageAdapter, X as AsyncThreadStorageAdapter, g as Message } from './types-BtAaOV07.js';
+import { T as Thread, a as ThreadData, b as ThreadStorageAdapter, A as AsyncThreadStorageAdapter, M as Message } from './types-DG2ya08y.js';
 
 /**
  * Tool types for App Context Awareness

package/dist/{ThreadManager-CUq5Ocu2.d.cts → ThreadManager-LfFRhr4e.d.cts}

@@ -1,4 +1,4 @@
-import { k as Thread, l as ThreadData, _ as ThreadStorageAdapter, X as AsyncThreadStorageAdapter, g as Message } from './types-BtAaOV07.cjs';
+import { T as Thread, a as ThreadData, b as ThreadStorageAdapter, A as AsyncThreadStorageAdapter, M as Message } from './types-DG2ya08y.cjs';
 
 /**
  * Tool types for App Context Awareness

package/dist/anthropic-6F5GRE3B.js

@@ -0,0 +1,4 @@
+export { anthropicProvider, searchAnthropic, validateAnthropicConfig } from './chunk-RQ74USYU.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=anthropic-6F5GRE3B.js.map
+//# sourceMappingURL=anthropic-6F5GRE3B.js.map

package/dist/anthropic-6F5GRE3B.js.map

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

package/dist/anthropic-DGalr_Fw.d.cts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.cjs';
+
+/**
+ * Anthropic Web Search Provider
+ *
+ * Uses Anthropic's built-in web_search tool via the Messages API.
+ * Returns reliable citations with cited_text, url, and title.
+ *
+ * @see https://docs.anthropic.com/en/docs/build-with-claude/tool-use/web-search-tool
+ */
+
+/**
+ * Anthropic native search provider implementation
+ */
+declare const anthropicProvider: WebSearchProviderInterface;
+
+export { anthropicProvider as a };

package/dist/anthropic-DkCEDYOt.d.ts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.js';
+
+/**
+ * Anthropic Web Search Provider
+ *
+ * Uses Anthropic's built-in web_search tool via the Messages API.
+ * Returns reliable citations with cited_text, url, and title.
+ *
+ * @see https://docs.anthropic.com/en/docs/build-with-claude/tool-use/web-search-tool
+ */
+
+/**
+ * Anthropic native search provider implementation
+ */
+declare const anthropicProvider: WebSearchProviderInterface;
+
+export { anthropicProvider as a };

package/dist/anthropic-NMTRABEH.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var chunkTXLIY7GF_cjs = require('./chunk-TXLIY7GF.cjs');
+require('./chunk-JEQ2X3Z6.cjs');
+
+
+
+Object.defineProperty(exports, "anthropicProvider", {
+  enumerable: true,
+  get: function () { return chunkTXLIY7GF_cjs.anthropicProvider; }
+});
+Object.defineProperty(exports, "searchAnthropic", {
+  enumerable: true,
+  get: function () { return chunkTXLIY7GF_cjs.searchAnthropic; }
+});
+Object.defineProperty(exports, "validateAnthropicConfig", {
+  enumerable: true,
+  get: function () { return chunkTXLIY7GF_cjs.validateAnthropicConfig; }
+});
+//# sourceMappingURL=anthropic-NMTRABEH.cjs.map
+//# sourceMappingURL=anthropic-NMTRABEH.cjs.map

package/dist/anthropic-NMTRABEH.cjs.map

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

package/dist/brave-DdnWb7Gb.d.cts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.cjs';
+
+/**
+ * Brave Search Provider
+ *
+ * Brave Search is a privacy-focused search engine with its own index.
+ * Provides independent search results without tracking.
+ *
+ * @see https://brave.com/search/api/
+ */
+
+/**
+ * Brave provider implementation
+ */
+declare const braveProvider: WebSearchProviderInterface;
+
+export { braveProvider as b };

package/dist/brave-DsI9n7Wr.d.ts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.js';
+
+/**
+ * Brave Search Provider
+ *
+ * Brave Search is a privacy-focused search engine with its own index.
+ * Provides independent search results without tracking.
+ *
+ * @see https://brave.com/search/api/
+ */
+
+/**
+ * Brave provider implementation
+ */
+declare const braveProvider: WebSearchProviderInterface;
+
+export { braveProvider as b };

package/dist/brave-OYKCOZEM.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var chunkW73FBYIH_cjs = require('./chunk-W73FBYIH.cjs');
+require('./chunk-JEQ2X3Z6.cjs');
+
+
+
+Object.defineProperty(exports, "braveProvider", {
+  enumerable: true,
+  get: function () { return chunkW73FBYIH_cjs.braveProvider; }
+});
+Object.defineProperty(exports, "searchBrave", {
+  enumerable: true,
+  get: function () { return chunkW73FBYIH_cjs.searchBrave; }
+});
+Object.defineProperty(exports, "validateBraveConfig", {
+  enumerable: true,
+  get: function () { return chunkW73FBYIH_cjs.validateBraveConfig; }
+});
+//# sourceMappingURL=brave-OYKCOZEM.cjs.map
+//# sourceMappingURL=brave-OYKCOZEM.cjs.map

package/dist/brave-OYKCOZEM.cjs.map

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

package/dist/brave-XSASGGH2.js

@@ -0,0 +1,4 @@
+export { braveProvider, searchBrave, validateBraveConfig } from './chunk-PPFHA6IL.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=brave-XSASGGH2.js.map
+//# sourceMappingURL=brave-XSASGGH2.js.map

package/dist/brave-XSASGGH2.js.map

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

package/dist/chunk-2FAWEBZS.cjs

@@ -0,0 +1,88 @@
+'use strict';
+
+// src/core/tools/webSearch/providers/searxng.ts
+var DEFAULT_SEARXNG_URL = "https://searxng.instance.local";
+function validateSearxngConfig(config) {
+  if (!config.baseUrl) {
+    throw new Error(
+      "SearXNG base URL is required. Self-host SearXNG or use a public instance. See https://docs.searxng.org/ for setup instructions."
+    );
+  }
+}
+async function searchSearxng(params, config) {
+  validateSearxngConfig(config);
+  const startTime = Date.now();
+  const baseUrl = config.baseUrl || DEFAULT_SEARXNG_URL;
+  const searchParams = new URLSearchParams({
+    q: params.query,
+    format: "json"
+  });
+  if (config.language) {
+    searchParams.set("language", config.language);
+  }
+  const url = `${baseUrl.replace(/\/$/, "")}/search?${searchParams.toString()}`;
+  const headers = {
+    Accept: "application/json"
+  };
+  if (config.apiKey) {
+    headers["Authorization"] = `Bearer ${config.apiKey}`;
+  }
+  const response = await fetch(url, {
+    method: "GET",
+    headers,
+    signal: config.timeout ? AbortSignal.timeout(config.timeout) : void 0
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "Unknown error");
+    throw new Error(`SearXNG API error (${response.status}): ${errorText}`);
+  }
+  const data = await response.json();
+  const searchTime = Date.now() - startTime;
+  let results = data.results || [];
+  if (config.includeDomains?.length) {
+    results = results.filter(
+      (r) => config.includeDomains.some((domain) => r.url.includes(domain))
+    );
+  }
+  if (config.excludeDomains?.length) {
+    results = results.filter(
+      (r) => !config.excludeDomains.some((domain) => r.url.includes(domain))
+    );
+  }
+  const maxResults = params.maxResults ?? config.maxResults ?? 5;
+  results = results.slice(0, maxResults);
+  const answer = data.answers?.[0] || data.infoboxes?.[0]?.content;
+  return {
+    query: params.query,
+    answer,
+    results: results.map((result) => ({
+      title: result.title,
+      url: result.url,
+      content: result.content,
+      score: result.score,
+      publishedDate: result.publishedDate,
+      image: result.img_src,
+      domain: extractDomain(result.url)
+    })),
+    provider: "searxng",
+    totalResults: data.number_of_results,
+    searchTime
+  };
+}
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname;
+  } catch {
+    return url;
+  }
+}
+var searxngProvider = {
+  search: searchSearxng,
+  validateConfig: validateSearxngConfig
+};
+
+exports.searchSearxng = searchSearxng;
+exports.searxngProvider = searxngProvider;
+exports.validateSearxngConfig = validateSearxngConfig;
+//# sourceMappingURL=chunk-2FAWEBZS.cjs.map
+//# sourceMappingURL=chunk-2FAWEBZS.cjs.map

package/dist/chunk-2FAWEBZS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/tools/webSearch/providers/searxng.ts"],"names":[],"mappings":"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","file":"chunk-2FAWEBZS.cjs","sourcesContent":["/**\n * SearXNG Search Provider\n *\n * SearXNG is a privacy-respecting, self-hostable metasearch engine.\n * It aggregates results from multiple search engines without tracking.\n *\n * @see https://docs.searxng.org/\n */\n\nimport type {\n  WebSearchConfig,\n  WebSearchParams,\n  WebSearchResponse,\n  SearxngApiResponse,\n  WebSearchProviderInterface,\n} from \"../types\";\n\n// Default public instance (users should self-host for production)\nconst DEFAULT_SEARXNG_URL = \"https://searxng.instance.local\";\n\n/**\n * Validate SearXNG configuration\n */\nexport function validateSearxngConfig(config: WebSearchConfig): void {\n  if (!config.baseUrl) {\n    throw new Error(\n      \"SearXNG base URL is required. Self-host SearXNG or use a public instance. \" +\n        \"See https://docs.searxng.org/ for setup instructions.\",\n    );\n  }\n}\n\n/**\n * Search using SearXNG API\n */\nexport async function searchSearxng(\n  params: WebSearchParams,\n  config: WebSearchConfig,\n): Promise<WebSearchResponse> {\n  validateSearxngConfig(config);\n\n  const startTime = Date.now();\n\n  const baseUrl = config.baseUrl || DEFAULT_SEARXNG_URL;\n  const searchParams = new URLSearchParams({\n    q: params.query,\n    format: \"json\",\n  });\n\n  // SearXNG doesn't have a direct max_results param, but we can limit after\n  if (config.language) {\n    searchParams.set(\"language\", config.language);\n  }\n\n  // Add specific engines if needed\n  // searchParams.set('engines', 'google,duckduckgo,bing');\n\n  const url = `${baseUrl.replace(/\\/$/, \"\")}/search?${searchParams.toString()}`;\n\n  const headers: Record<string, string> = {\n    Accept: \"application/json\",\n  };\n\n  // Add API key if provided (some instances require it)\n  if (config.apiKey) {\n    headers[\"Authorization\"] = `Bearer ${config.apiKey}`;\n  }\n\n  const response = await fetch(url, {\n    method: \"GET\",\n    headers,\n    signal: config.timeout ? AbortSignal.timeout(config.timeout) : undefined,\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => \"Unknown error\");\n    throw new Error(`SearXNG API error (${response.status}): ${errorText}`);\n  }\n\n  const data: SearxngApiResponse = await response.json();\n  const searchTime = Date.now() - startTime;\n\n  // Filter by domains if specified\n  let results = data.results || [];\n  if (config.includeDomains?.length) {\n    results = results.filter((r) =>\n      config.includeDomains!.some((domain) => r.url.includes(domain)),\n    );\n  }\n  if (config.excludeDomains?.length) {\n    results = results.filter(\n      (r) => !config.excludeDomains!.some((domain) => r.url.includes(domain)),\n    );\n  }\n\n  // Limit results\n  const maxResults = params.maxResults ?? config.maxResults ?? 5;\n  results = results.slice(0, maxResults);\n\n  // Extract answer from infoboxes or answers if available\n  const answer = data.answers?.[0] || data.infoboxes?.[0]?.content;\n\n  return {\n    query: params.query,\n    answer,\n    results: results.map((result) => ({\n      title: result.title,\n      url: result.url,\n      content: result.content,\n      score: result.score,\n      publishedDate: result.publishedDate,\n      image: result.img_src,\n      domain: extractDomain(result.url),\n    })),\n    provider: \"searxng\",\n    totalResults: data.number_of_results,\n    searchTime,\n  };\n}\n\n/**\n * Extract domain from URL\n */\nfunction extractDomain(url: string): string {\n  try {\n    return new URL(url).hostname;\n  } catch {\n    return url;\n  }\n}\n\n/**\n * SearXNG provider implementation\n */\nexport const searxngProvider: WebSearchProviderInterface = {\n  search: searchSearxng,\n  validateConfig: validateSearxngConfig,\n};\n"]}