@yourgpt/copilot-sdk 2.1.4 → 2.1.5-alpha.1

package/dist/chunk-BJYA5NDL.cjs

@@ -0,0 +1,96 @@
+'use strict';
+
+// src/skill-system/registry.ts
+var SkillRegistry = class {
+  constructor() {
+    this.skills = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register a skill. Silently overwrites if name already exists.
+   * Use collision detection in loadSkills() instead.
+   */
+  register(skill) {
+    this.skills.set(skill.name, skill);
+  }
+  /**
+   * Unregister a skill by name.
+   */
+  unregister(name) {
+    this.skills.delete(name);
+  }
+  /**
+   * Get a skill by name.
+   */
+  get(name) {
+    return this.skills.get(name);
+  }
+  /**
+   * Get all registered skills.
+   */
+  getAll() {
+    return Array.from(this.skills.values());
+  }
+  /**
+   * Get all skills with strategy === "eager".
+   * These are injected directly into the system prompt.
+   */
+  getEager() {
+    return this.getAll().filter((s) => this.resolveStrategy(s) === "eager");
+  }
+  /**
+   * Get all skills with strategy === "auto".
+   * These appear in the catalog and are loadable on demand.
+   */
+  getAuto() {
+    return this.getAll().filter((s) => this.resolveStrategy(s) === "auto");
+  }
+  /**
+   * Check if a skill is registered.
+   */
+  has(name) {
+    return this.skills.has(name);
+  }
+  /**
+   * Number of registered skills.
+   */
+  get count() {
+    return this.skills.size;
+  }
+  /**
+   * Build a skill catalog string for "auto" skills.
+   * Appended to the system prompt so the AI can discover available skills.
+   */
+  buildCatalog() {
+    const autoSkills = this.getAuto();
+    if (autoSkills.length === 0) return "";
+    const lines = autoSkills.map((s) => `- ${s.name}: ${s.description}`);
+    return `Available skills:
+${lines.join("\n")}`;
+  }
+  /**
+   * Concatenate content of all "eager" skills.
+   * These instructions are always active without requiring load_skill.
+   */
+  buildEagerContent() {
+    const eagerSkills = this.getEager();
+    if (eagerSkills.length === 0) return "";
+    return eagerSkills.map((s) => `## Skill: ${s.name}
+
+${s.content}`).join("\n\n---\n\n");
+  }
+  /**
+   * Resolve content for a skill by name.
+   * For inline/file/url skills, content is already resolved at registration time.
+   */
+  async resolveContent(name) {
+    const skill = this.skills.get(name);
+    return skill?.content;
+  }
+  resolveStrategy(skill) {
+    return skill.strategy ?? "auto";
+  }
+};
+
+exports.SkillRegistry = SkillRegistry;
+//# sourceMappingURL=chunk-BJYA5NDL.cjs.map
+//# sourceMappingURL=chunk-BJYA5NDL.cjs.map

package/dist/chunk-BJYA5NDL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skill-system/registry.ts"],"names":[],"mappings":";;;AASO,IAAM,gBAAN,MAAoB;AAAA,EAApB,WAAA,GAAA;AACL,IAAA,IAAA,CAAQ,MAAA,uBAAa,GAAA,EAA2B;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMhD,SAAS,KAAA,EAA4B;AACnC,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,KAAA,CAAM,IAAA,EAAM,KAAK,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,IAAA,EAAoB;AAC7B,IAAA,IAAA,CAAK,MAAA,CAAO,OAAO,IAAI,CAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,IAAA,EAAyC;AAC3C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAA,GAA0B;AACxB,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAA,GAA4B;AAC1B,IAAA,OAAO,IAAA,CAAK,MAAA,EAAO,CAAE,MAAA,CAAO,CAAC,MAAM,IAAA,CAAK,eAAA,CAAgB,CAAC,CAAA,KAAM,OAAO,CAAA;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAA,GAA2B;AACzB,IAAA,OAAO,IAAA,CAAK,MAAA,EAAO,CAAE,MAAA,CAAO,CAAC,MAAM,IAAA,CAAK,eAAA,CAAgB,CAAC,CAAA,KAAM,MAAM,CAAA;AAAA,EACvE;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,IAAA,EAAuB;AACzB,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,KAAA,GAAgB;AAClB,IAAA,OAAO,KAAK,MAAA,CAAO,IAAA;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAA,GAAuB;AACrB,IAAA,MAAM,UAAA,GAAa,KAAK,OAAA,EAAQ;AAChC,IAAA,IAAI,UAAA,CAAW,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAEpC,IAAA,MAAM,KAAA,GAAQ,UAAA,CAAW,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAA,EAAK,CAAA,CAAE,IAAI,CAAA,EAAA,EAAK,CAAA,CAAE,WAAW,CAAA,CAAE,CAAA;AACnE,IAAA,OAAO,CAAA;AAAA,EAAsB,KAAA,CAAM,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,iBAAA,GAA4B;AAC1B,IAAA,MAAM,WAAA,GAAc,KAAK,QAAA,EAAS;AAClC,IAAA,IAAI,WAAA,CAAY,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAErC,IAAA,OAAO,YACJ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,UAAA,EAAa,EAAE,IAAI;;AAAA,EAAO,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAChD,KAAK,aAAa,CAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,eAAe,IAAA,EAA2C;AAC9D,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAClC,IAAA,OAAO,KAAA,EAAO,OAAA;AAAA,EAChB;AAAA,EAEQ,gBAAgB,KAAA,EAAqC;AAC3D,IAAA,OAAO,MAAM,QAAA,IAAY,MAAA;AAAA,EAC3B;AACF","file":"chunk-BJYA5NDL.cjs","sourcesContent":["/**\n * SkillRegistry — manages registered skills\n *\n * Shared between server (loadSkills) and client (SkillProvider).\n * Framework-agnostic — no React dependencies.\n */\n\nimport type { ResolvedSkill, SkillStrategy } from \"./types\";\n\nexport class SkillRegistry {\n  private skills = new Map<string, ResolvedSkill>();\n\n  /**\n   * Register a skill. Silently overwrites if name already exists.\n   * Use collision detection in loadSkills() instead.\n   */\n  register(skill: ResolvedSkill): void {\n    this.skills.set(skill.name, skill);\n  }\n\n  /**\n   * Unregister a skill by name.\n   */\n  unregister(name: string): void {\n    this.skills.delete(name);\n  }\n\n  /**\n   * Get a skill by name.\n   */\n  get(name: string): ResolvedSkill | undefined {\n    return this.skills.get(name);\n  }\n\n  /**\n   * Get all registered skills.\n   */\n  getAll(): ResolvedSkill[] {\n    return Array.from(this.skills.values());\n  }\n\n  /**\n   * Get all skills with strategy === \"eager\".\n   * These are injected directly into the system prompt.\n   */\n  getEager(): ResolvedSkill[] {\n    return this.getAll().filter((s) => this.resolveStrategy(s) === \"eager\");\n  }\n\n  /**\n   * Get all skills with strategy === \"auto\".\n   * These appear in the catalog and are loadable on demand.\n   */\n  getAuto(): ResolvedSkill[] {\n    return this.getAll().filter((s) => this.resolveStrategy(s) === \"auto\");\n  }\n\n  /**\n   * Check if a skill is registered.\n   */\n  has(name: string): boolean {\n    return this.skills.has(name);\n  }\n\n  /**\n   * Number of registered skills.\n   */\n  get count(): number {\n    return this.skills.size;\n  }\n\n  /**\n   * Build a skill catalog string for \"auto\" skills.\n   * Appended to the system prompt so the AI can discover available skills.\n   */\n  buildCatalog(): string {\n    const autoSkills = this.getAuto();\n    if (autoSkills.length === 0) return \"\";\n\n    const lines = autoSkills.map((s) => `- ${s.name}: ${s.description}`);\n    return `Available skills:\\n${lines.join(\"\\n\")}`;\n  }\n\n  /**\n   * Concatenate content of all \"eager\" skills.\n   * These instructions are always active without requiring load_skill.\n   */\n  buildEagerContent(): string {\n    const eagerSkills = this.getEager();\n    if (eagerSkills.length === 0) return \"\";\n\n    return eagerSkills\n      .map((s) => `## Skill: ${s.name}\\n\\n${s.content}`)\n      .join(\"\\n\\n---\\n\\n\");\n  }\n\n  /**\n   * Resolve content for a skill by name.\n   * For inline/file/url skills, content is already resolved at registration time.\n   */\n  async resolveContent(name: string): Promise<string | undefined> {\n    const skill = this.skills.get(name);\n    return skill?.content;\n  }\n\n  private resolveStrategy(skill: ResolvedSkill): SkillStrategy {\n    return skill.strategy ?? \"auto\";\n  }\n}\n"]}

package/dist/{chunk-LZMBBGWH.js → chunk-ENFWM3EY.js}

@@ -1,5 +1,5 @@
-import { tool, failure } from './chunk-QLH6TSCC.js';
-import { formatSearchResultsForAI, executeWebSearch, summarizeSearchResults } from './chunk-XGITAEXU.js';
+import { tool, failure } from './chunk-4QXY2PBG.js';
+import { formatSearchResultsForAI, executeWebSearch, summarizeSearchResults } from './chunk-LLM7AHMO.js';
 
 // src/core/tools/builtin/webSearch.ts
 var webSearchTool = tool({
@@ -75,5 +75,5 @@ function createWebSearchTool(config) {
 }
 
 export { createWebSearchTool, webSearchTool };
-//# sourceMappingURL=chunk-LZMBBGWH.js.map
-//# sourceMappingURL=chunk-LZMBBGWH.js.map
+//# sourceMappingURL=chunk-ENFWM3EY.js.map
+//# sourceMappingURL=chunk-ENFWM3EY.js.map

package/dist/{chunk-LZMBBGWH.js.map → chunk-ENFWM3EY.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/tools/builtin/webSearch.ts"],"names":[],"mappings":";;;;AAoDO,IAAM,gBAAgB,IAAA,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,OAAO,yBAAyB,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,MAAM,gBAAA;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,GAAY,yBAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAAS,uBAAuB,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,OAAO,QAAQ,YAAY,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-LZMBBGWH.js","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"]}
+{"version":3,"sources":["../src/core/tools/builtin/webSearch.ts"],"names":[],"mappings":";;;;AAoDO,IAAM,gBAAgB,IAAA,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,OAAO,yBAAyB,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,MAAM,gBAAA;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,GAAY,yBAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAAS,uBAAuB,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,OAAO,QAAQ,YAAY,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-ENFWM3EY.js","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"]}

package/dist/{chunk-OQPRIB73.cjs → chunk-I3SQUNTT.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkWAPGTQDR_cjs = require('./chunk-WAPGTQDR.cjs');
-var chunkPOZNNKNJ_cjs = require('./chunk-POZNNKNJ.cjs');
+var chunkJKGFQUHJ_cjs = require('./chunk-JKGFQUHJ.cjs');
+var chunk246B6X5D_cjs = require('./chunk-246B6X5D.cjs');
 
 // src/core/tools/screenshot.ts
 var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
@@ -1036,7 +1036,7 @@ function createCustomDetector(customKeywords) {
 }
 
 // src/core/tools/builtin/screenshot.ts
-var screenshotTool = chunkPOZNNKNJ_cjs.tool({
+var screenshotTool = chunk246B6X5D_cjs.tool({
   description: "Capture a screenshot of the user's current screen/viewport. Use this when the user asks you to look at their screen, see what they're seeing, help with visual issues, or debug UI problems.",
   location: "client",
   inputSchema: {
@@ -1055,7 +1055,7 @@ var screenshotTool = chunkPOZNNKNJ_cjs.tool({
   approvalMessage: "Allow AI to capture a screenshot of your screen?",
   handler: async (params) => {
     if (!isScreenshotSupported()) {
-      return chunkPOZNNKNJ_cjs.failure("Screenshot capture is not supported in this environment");
+      return chunk246B6X5D_cjs.failure("Screenshot capture is not supported in this environment");
     }
     try {
       const options = {};
@@ -1081,20 +1081,20 @@ var screenshotTool = chunkPOZNNKNJ_cjs.tool({
         }
       };
     } catch (error) {
-      return chunkPOZNNKNJ_cjs.failure(
+      return chunk246B6X5D_cjs.failure(
         error instanceof Error ? error.message : "Screenshot capture failed"
       );
     }
   }
 });
 function createScreenshotTool(options) {
-  return chunkPOZNNKNJ_cjs.tool({
+  return chunk246B6X5D_cjs.tool({
     ...screenshotTool,
     needsApproval: options?.needsApproval ?? true,
     approvalMessage: options?.approvalMessage ?? "Allow AI to capture a screenshot of your screen?",
     handler: async (params) => {
       if (!isScreenshotSupported()) {
-        return chunkPOZNNKNJ_cjs.failure(
+        return chunk246B6X5D_cjs.failure(
           "Screenshot capture is not supported in this environment"
         );
       }
@@ -1120,7 +1120,7 @@ function createScreenshotTool(options) {
           }
         };
       } catch (error) {
-        return chunkPOZNNKNJ_cjs.failure(
+        return chunk246B6X5D_cjs.failure(
           error instanceof Error ? error.message : "Screenshot capture failed"
         );
       }
@@ -1133,7 +1133,7 @@ var isBrowser4 = typeof window !== "undefined" && typeof console !== "undefined"
 if (isBrowser4 && !isConsoleCaptureActive()) {
   startConsoleCapture();
 }
-var consoleLogsTool = chunkPOZNNKNJ_cjs.tool({
+var consoleLogsTool = chunk246B6X5D_cjs.tool({
   description: "Get recent console logs from the browser. Use this when debugging JavaScript errors, checking for warnings, or understanding what's happening in the application.",
   location: "client",
   inputSchema: {
@@ -1166,7 +1166,7 @@ var consoleLogsTool = chunkPOZNNKNJ_cjs.tool({
         types: params.types
       });
       const formattedLogs = formatLogsForAI(logs.logs);
-      return chunkPOZNNKNJ_cjs.success(
+      return chunk246B6X5D_cjs.success(
         {
           logs: formattedLogs,
           count: logs.logs.length,
@@ -1175,14 +1175,14 @@ var consoleLogsTool = chunkPOZNNKNJ_cjs.tool({
         `Retrieved ${logs.logs.length} console logs`
       );
     } catch (error) {
-      return chunkPOZNNKNJ_cjs.failure(
+      return chunk246B6X5D_cjs.failure(
         error instanceof Error ? error.message : "Failed to get console logs"
       );
     }
   }
 });
 function createConsoleLogsTool(options) {
-  return chunkPOZNNKNJ_cjs.tool({
+  return chunk246B6X5D_cjs.tool({
     ...consoleLogsTool,
     needsApproval: options?.needsApproval ?? true,
     approvalMessage: options?.approvalMessage ?? "Allow AI to access browser console logs?",
@@ -1196,7 +1196,7 @@ function createConsoleLogsTool(options) {
           types: params.types
         });
         const formattedLogs = formatLogsForAI(logs.logs);
-        return chunkPOZNNKNJ_cjs.success(
+        return chunk246B6X5D_cjs.success(
           {
             logs: formattedLogs,
             count: logs.logs.length,
@@ -1205,7 +1205,7 @@ function createConsoleLogsTool(options) {
           `Retrieved ${logs.logs.length} console logs`
         );
       } catch (error) {
-        return chunkPOZNNKNJ_cjs.failure(
+        return chunk246B6X5D_cjs.failure(
           error instanceof Error ? error.message : "Failed to get console logs"
         );
       }
@@ -1214,7 +1214,7 @@ function createConsoleLogsTool(options) {
 }
 
 // src/core/tools/builtin/network.ts
-var networkRequestsTool = chunkPOZNNKNJ_cjs.tool({
+var networkRequestsTool = chunk246B6X5D_cjs.tool({
   description: "Get recent network requests from the browser. Use this when debugging API calls, checking for failed requests, analyzing network activity, or troubleshooting connectivity issues.",
   location: "client",
   inputSchema: {
@@ -1243,7 +1243,7 @@ var networkRequestsTool = chunkPOZNNKNJ_cjs.tool({
         failedOnly: params.failedOnly
       });
       const formattedRequests = formatRequestsForAI(requests.requests);
-      return chunkPOZNNKNJ_cjs.success(
+      return chunk246B6X5D_cjs.success(
         {
           requests: formattedRequests,
           count: requests.requests.length,
@@ -1252,14 +1252,14 @@ var networkRequestsTool = chunkPOZNNKNJ_cjs.tool({
         `Retrieved ${requests.requests.length} network requests`
       );
     } catch (error) {
-      return chunkPOZNNKNJ_cjs.failure(
+      return chunk246B6X5D_cjs.failure(
         error instanceof Error ? error.message : "Failed to get network requests"
       );
     }
   }
 });
 function createNetworkRequestsTool(options) {
-  return chunkPOZNNKNJ_cjs.tool({
+  return chunk246B6X5D_cjs.tool({
     ...networkRequestsTool,
     needsApproval: options?.needsApproval ?? true,
     approvalMessage: options?.approvalMessage ?? "Allow AI to access network request history?",
@@ -1273,7 +1273,7 @@ function createNetworkRequestsTool(options) {
           failedOnly: params.failedOnly
         });
         const formattedRequests = formatRequestsForAI(requests.requests);
-        return chunkPOZNNKNJ_cjs.success(
+        return chunk246B6X5D_cjs.success(
           {
             requests: formattedRequests,
             count: requests.requests.length,
@@ -1282,7 +1282,7 @@ function createNetworkRequestsTool(options) {
           `Retrieved ${requests.requests.length} network requests`
         );
       } catch (error) {
-        return chunkPOZNNKNJ_cjs.failure(
+        return chunk246B6X5D_cjs.failure(
           error instanceof Error ? error.message : "Failed to get network requests"
         );
       }
@@ -1306,10 +1306,51 @@ var builtinTools = {
   },
   web_search: {
     name: "web_search",
-    ...chunkWAPGTQDR_cjs.webSearchTool
+    ...chunkJKGFQUHJ_cjs.webSearchTool
   }
 };
 
+// src/core/utils/logger.ts
+function isEnabled(getEnabled) {
+  if (typeof window !== "undefined" && window.__COPILOT_DEBUG !== void 0) {
+    return !!window.__COPILOT_DEBUG;
+  }
+  return getEnabled();
+}
+function logOnce(scope, enabled, action, data) {
+  if (!isEnabled(() => enabled)) return;
+  const prefix = `[${scope}]`;
+  if (data !== void 0) {
+    console.log(prefix, action, data);
+  } else {
+    console.log(prefix, action);
+  }
+}
+function createLogger(scope, getEnabled) {
+  const prefix = `[${scope}]`;
+  function log(action, data) {
+    if (!isEnabled(getEnabled)) return;
+    if (data !== void 0) {
+      console.log(prefix, action, data);
+    } else {
+      console.log(prefix, action);
+    }
+  }
+  log.group = function(label) {
+    if (!isEnabled(getEnabled)) return;
+    console.group(`${prefix} ${label}`);
+  };
+  log.groupCollapsed = function(label) {
+    if (!isEnabled(getEnabled)) return;
+    console.groupCollapsed(`${prefix} ${label}`);
+  };
+  log.groupEnd = function() {
+    if (!isEnabled(getEnabled)) return;
+    console.groupEnd();
+  };
+  return log;
+}
+
 // src/core/utils/id.ts
 function generateId(prefix = "id") {
   return `${prefix}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
@@ -1351,7 +1392,9 @@ function createMessage(partial) {
     tool_calls: partial.tool_calls,
     tool_call_id: partial.tool_call_id,
     metadata: partial.metadata,
-    created_at: partial.created_at ?? /* @__PURE__ */ new Date()
+    created_at: partial.created_at ?? /* @__PURE__ */ new Date(),
+    ...partial.parent_id !== void 0 ? { parent_id: partial.parent_id } : {},
+    ...partial.children_ids !== void 0 ? { children_ids: partial.children_ids } : {}
   };
 }
 function createUserMessage(content, options) {
@@ -1360,7 +1403,8 @@ function createUserMessage(content, options) {
     thread_id: options?.thread_id,
     role: "user",
     content,
-    metadata: options?.attachments ? { attachments: options.attachments } : void 0
+    metadata: options?.attachments ? { attachments: options.attachments } : void 0,
+    ...options?.parent_id !== void 0 ? { parent_id: options.parent_id } : {}
   });
 }
 function createAssistantMessage(content, options) {
@@ -2839,6 +2883,7 @@ exports.createCloudStorage = createCloudStorage;
 exports.createConsoleLogsTool = createConsoleLogsTool;
 exports.createCustomDetector = createCustomDetector;
 exports.createLocalStorageAdapter = createLocalStorageAdapter;
+exports.createLogger = createLogger;
 exports.createMemoryAdapter = createMemoryAdapter;
 exports.createMessage = createMessage;
 exports.createNetworkRequestsTool = createNetworkRequestsTool;
@@ -2877,6 +2922,7 @@ exports.isNetworkCaptureActive = isNetworkCaptureActive;
 exports.isScreenshotSupported = isScreenshotSupported;
 exports.isToolResult = isToolResult;
 exports.localStorageAdapter = localStorageAdapter;
+exports.logOnce = logOnce;
 exports.networkRequestsTool = networkRequestsTool;
 exports.noopAdapter = noopAdapter;
 exports.parseSSELine = parseSSELine;
@@ -2893,5 +2939,5 @@ exports.stopNetworkCapture = stopNetworkCapture;
 exports.streamSSE = streamSSE;
 exports.zodObjectToInputSchema = zodObjectToInputSchema;
 exports.zodToJsonSchema = zodToJsonSchema;
-//# sourceMappingURL=chunk-OQPRIB73.cjs.map
-//# sourceMappingURL=chunk-OQPRIB73.cjs.map
+//# sourceMappingURL=chunk-I3SQUNTT.cjs.map
+//# sourceMappingURL=chunk-I3SQUNTT.cjs.map