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

package/README.md

@@ -1,9 +1,19 @@
-# @yourgpt/copilot-sdk
+<a href="https://copilot-sdk.yourgpt.ai">
+  <img src="https://copilot-sdk.yourgpt.ai/images/yourgpt-copilot-sdk-npm.png" alt="YourGPT Copilot SDK" width="100%" />
+</a>
+
+# Copilot SDK
+
+[![npm version](https://img.shields.io/npm/v/@yourgpt/copilot-sdk)](https://www.npmjs.com/package/@yourgpt/copilot-sdk)
+[![npm downloads](https://img.shields.io/npm/dm/@yourgpt/copilot-sdk)](https://www.npmjs.com/package/@yourgpt/copilot-sdk)
+[![License](https://img.shields.io/npm/l/@yourgpt/copilot-sdk)](https://github.com/YourGPT/copilot-sdk/blob/main/LICENSE)
 
 Build AI Copilots for Your Product.
 
 Production-ready AI Copilots for any product. Connect any LLM, deploy on your infrastructure, own your data.
 
+**Documentation:** [copilot-sdk.yourgpt.ai](https://copilot-sdk.yourgpt.ai)
+
 ## Installation
 
 ```bash
@@ -34,46 +44,77 @@ function App() {
 | `/ui`    | Pre-built UI components        |
 | `/core`  | Types, utilities, tool helpers |
 
-## Styling (Tailwind CSS v4)
+## Built-in Tools
+
+### Web Search
 
-```css
-/* app/globals.css */
-@import "tailwindcss";
+Add real-time web search capabilities to your AI copilot. **No extra API key needed** - use your existing OpenAI or Google key.
 
-/* IMPORTANT: Path is relative to your CSS file location */
-/* If globals.css is in app/ folder, use ../ prefix */
-@source "../node_modules/@yourgpt/copilot-sdk/dist/**/*.{js,ts,jsx,tsx}";
+```typescript
+import { createWebSearchTool } from "@yourgpt/copilot-sdk/core";
 
-@custom-variant dark (&:is(.dark *));
+// 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],
+});
 ```
 
-> **Note:** The `@source` path must point to `dist/` (not `src/`) and include all file extensions `{js,ts,jsx,tsx}`.
+**Native Providers (No extra API needed):**
 
-> **Important:** For Tailwind v4, you also need the `@theme inline` block to map CSS variables like `--background` to Tailwind utilities like `bg-background`. If you have shadcn/ui, this is already configured. Otherwise, see the [Quick Start guide](https://copilot-sdk.yourgpt.ai/docs/quickstart) for complete setup.
+- `openai` - OpenAI's built-in web search
+- `google` - Google's grounding with Google Search
+- `anthropic` - Anthropic's built-in web search
 
-## Theming
+**Third-Party Providers:**
 
-Works automatically with existing shadcn/ui setup. For projects without shadcn:
+- [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
 
-```tsx
-import "@yourgpt/copilot-sdk/ui/styles.css";
-import "@yourgpt/copilot-sdk/ui/themes/claude.css"; // Optional preset
+## Examples
 
-<div className="csdk-theme-claude">
-  <CopilotChat />
-</div>;
-```
+Explore real-world implementations and demo projects.
+
+### Debug Assistant
+
+AI-powered debugging companion that captures console logs, takes screenshots, and provides intelligent analysis.
+
+<a href="https://copilot-sdk.yourgpt.ai/docs/examples">
+  <img src="https://copilot-sdk.yourgpt.ai/images/debug-assistant-demo.webp" alt="Debug Assistant" width="100%" style="border-radius: 12px;" />
+</a>
+
+### Support Ticket System
+
+AI-powered customer support with intelligent ticket routing, automatic escalation, and context-aware responses.
+
+<a href="https://copilot-sdk.yourgpt.ai/docs/examples">
+  <img src="https://copilot-sdk.yourgpt.ai/images/copilot-sdk-support-demo.png" alt="Support Ticket System" width="100%" style="border-radius: 12px;" />
+</a>
 
-**8 theme presets available:** Claude, Vercel, Supabase, Twitter, Linear, PostHog, Catppuccin, Modern
+### SaaS Application
 
-## Documentation
+SaaS template with AI copilot integration. Includes subscription handling, billing management, and intelligent assistance.
 
-Visit [copilot-sdk.yourgpt.ai](https://copilot-sdk.yourgpt.ai) for full documentation including:
+<a href="https://copilot-sdk.yourgpt.ai/docs/examples">
+  <img src="https://copilot-sdk.yourgpt.ai/images/saas-demo.webp" alt="SaaS Application" width="100%" style="border-radius: 12px;" />
+</a>
 
-- Theme customization & CSS variables
-- Semantic CSS classes (`csdk-*`)
-- Creating custom themes
-- Dark mode support
+**[View all examples →](https://copilot-sdk.yourgpt.ai/docs/examples)**
 
 ## License
 

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"]}