@yourgpt/copilot-sdk 2.1.5-alpha.3 → 2.1.5-alpha.5

package/dist/{chunk-TPB7XED6.cjs → chunk-TPDMBDQX.cjs}

@@ -76,5 +76,5 @@ exports.success = success;
 exports.tool = tool;
 exports.toolToAnthropicFormat = toolToAnthropicFormat;
 exports.toolToOpenAIFormat = toolToOpenAIFormat;
-//# sourceMappingURL=chunk-TPB7XED6.cjs.map
-//# sourceMappingURL=chunk-TPB7XED6.cjs.map
+//# sourceMappingURL=chunk-TPDMBDQX.cjs.map
+//# sourceMappingURL=chunk-TPDMBDQX.cjs.map

package/dist/chunk-TPDMBDQX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types/tools.ts"],"names":["tool"],"mappings":";;;AAs9BO,SAAS,KACd,MAAA,EACuC;AACvC,EAAA,OAAO;AAAA,IACL,aAAa,MAAA,CAAO,WAAA;AAAA,IACpB,QAAA,EAAU,OAAO,QAAA,IAAY,QAAA;AAAA,IAC7B,UAAU,MAAA,CAAO,QAAA;AAAA,IACjB,OAAO,MAAA,CAAO,KAAA;AAAA,IACd,cAAc,MAAA,CAAO,YAAA;AAAA,IACrB,UAAU,MAAA,CAAO,QAAA;AAAA,IACjB,gBAAgB,MAAA,CAAO,cAAA;AAAA,IACvB,cAAc,MAAA,CAAO,YAAA;AAAA;AAAA,IAErB,OAAO,MAAA,CAAO,KAAA;AAAA,IACd,gBAAgB,MAAA,CAAO,cAAA;AAAA,IACvB,gBAAgB,MAAA,CAAO,cAAA;AAAA;AAAA,IAEvB,WAAA,EAAa,OAAO,WAAA,IAAe;AAAA,MACjC,IAAA,EAAM,QAAA;AAAA,MACN,YAAY,EAAC;AAAA,MACb,UAAU;AAAC,KACb;AAAA,IACA,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,QAAQ,MAAA,CAAO,MAAA;AAAA,IACf,WAAW,MAAA,CAAO,SAAA;AAAA,IAClB,QAAQ,MAAA,CAAO,MAAA;AAAA,IACf,eAAe,MAAA,CAAO,aAAA;AAAA,IACtB,iBAAiB,MAAA,CAAO,eAAA;AAAA,IACxB,gBAAgB,MAAA,CAAO,cAAA;AAAA,IACvB,WAAW,MAAA,CAAO;AAAA,GACpB;AACF;AASO,SAAS,mBAAmBA,KAAAA,EAA8B;AAC/D,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA;AAAA,IACN,QAAA,EAAU;AAAA,MACR,MAAMA,KAAAA,CAAK,IAAA;AAAA,MACX,aAAaA,KAAAA,CAAK,WAAA;AAAA,MAClB,YAAYA,KAAAA,CAAK;AAAA;AACnB,GACF;AACF;AAKO,SAAS,sBAAsBA,KAAAA,EAA8B;AAClE,EAAA,OAAO;AAAA,IACL,MAAMA,KAAAA,CAAK,IAAA;AAAA,IACX,aAAaA,KAAAA,CAAK,WAAA;AAAA,IAClB,cAAcA,KAAAA,CAAK;AAAA,GACrB;AACF;AAKO,SAAS,gBAAA,CACd,YACA,QAAA,EACmB;AACnB,EAAA,OAAO;AAAA,IACL,UAAA;AAAA,IACA,OAAA,EAAS,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAA;AAAA,IAChC,SAAS,QAAA,CAAS,OAAA;AAAA,IAClB,OAAO,QAAA,CAAS;AAAA,GAClB;AACF;AAKO,SAAS,OAAA,CACd,MACA,OAAA,EACiB;AACjB,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,IAAA;AAAA,IACT,IAAA;AAAA,IACA;AAAA,GACF;AACF;AAKO,SAAS,QAAQ,KAAA,EAA6B;AACnD,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,KAAA;AAAA,IACT;AAAA,GACF;AACF","file":"chunk-TPDMBDQX.cjs","sourcesContent":["/**\n * Tool-related types for the agentic loop\n */\n\nimport type { ActionRenderProps } from \"./actions\";\n\n// ============================================\n// Provider Types\n// ============================================\n\n/**\n * Supported AI providers for tool calling\n */\nexport type AIProvider =\n  | \"anthropic\"\n  | \"openai\"\n  | \"xai\"\n  | \"grok\"\n  | \"gemini\"\n  | \"groq\"\n  | \"ollama\";\n\n/**\n * Where the tool executes\n */\nexport type ToolLocation = \"server\" | \"client\";\n\n/**\n * Source/origin of the tool\n * - \"mcp\": Tool from an MCP (Model Context Protocol) server\n * - \"native\": Built-in SDK tool\n * - \"custom\": User-defined tool\n */\nexport type ToolSource = \"mcp\" | \"native\" | \"custom\";\n\n// ============================================\n// Tool Definition Types\n// ============================================\n\n/**\n * JSON Schema property definition\n */\nexport interface JSONSchemaProperty {\n  type?:\n    | \"string\"\n    | \"number\"\n    | \"boolean\"\n    | \"object\"\n    | \"array\"\n    | \"integer\"\n    | \"null\";\n  description?: string;\n  enum?: (string | number | boolean)[];\n  items?: JSONSchemaProperty;\n  properties?: Record<string, JSONSchemaProperty>;\n  required?: string[];\n  default?: unknown;\n  minLength?: number;\n  maxLength?: number;\n  minimum?: number;\n  maximum?: number;\n  pattern?: string;\n  oneOf?: JSONSchemaProperty[];\n  anyOf?: JSONSchemaProperty[];\n}\n\n/**\n * JSON Schema for tool input\n */\nexport interface ToolInputSchema {\n  type?: \"object\";\n  properties?: Record<string, JSONSchemaProperty>;\n  required?: string[];\n  additionalProperties?: boolean;\n  oneOf?: JSONSchemaProperty[];\n  anyOf?: JSONSchemaProperty[];\n}\n\n/**\n * Tool execution context\n *\n * Provides runtime information to tool handlers including cancellation signals,\n * request metadata, and custom context data.\n */\nexport interface ToolContext {\n  /** Abort signal for cancellation */\n  signal?: AbortSignal;\n  /** Thread ID if using threads */\n  threadId?: string;\n  /** Custom context data passed from runtime config */\n  data?: Record<string, unknown>;\n\n  // ============================================\n  // Rich Context (Vercel AI SDK pattern)\n  // ============================================\n\n  /**\n   * Unique ID for this specific tool call.\n   * Useful for logging, tracing, and correlating tool executions.\n   */\n  toolCallId?: string;\n\n  /**\n   * Request headers (for auth in server tools).\n   * Contains headers from the original HTTP request.\n   *\n   * @example\n   * ```typescript\n   * handler: async (params, context) => {\n   *   const token = context?.headers?.authorization;\n   *   if (!token) return failure('Authentication required');\n   *   // ...\n   * }\n   * ```\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Full request metadata for server-side tools.\n   * Provides access to HTTP method, URL, and headers.\n   *\n   * @example\n   * ```typescript\n   * handler: async (params, context) => {\n   *   console.log(`Tool called from: ${context?.request?.url}`);\n   *   // Forward auth to internal service\n   *   const authHeader = context?.request?.headers?.authorization;\n   * }\n   * ```\n   */\n  request?: {\n    /** HTTP method (GET, POST, etc.) */\n    method?: string;\n    /** Request URL path */\n    url?: string;\n    /** Request headers */\n    headers?: Record<string, string>;\n  };\n\n  /**\n   * Data passed from user's approval action.\n   * Only present when tool has `needsApproval: true` and user approved with extra data.\n   *\n   * @example\n   * ```typescript\n   * // In render function:\n   * approval.onApprove({ supervisor: selectedSupervisor });\n   *\n   * // In handler:\n   * handler: async (params, context) => {\n   *   const supervisor = context?.approvalData?.supervisor;\n   *   await assignToSupervisor(params.ticketId, supervisor);\n   * }\n   * ```\n   */\n  approvalData?: Record<string, unknown>;\n}\n\n// ============================================\n// AI Response Control Types\n// ============================================\n\n/**\n * AI response behavior for tool results.\n *\n * Controls what the AI sees after a tool executes and renders UI.\n *\n * - `'none'`: AI generates minimal response, UI component handles display\n * - `'brief'`: AI gets summary context (via aiContext), gives brief acknowledgment\n * - `'full'`: AI receives full data and responds accordingly (default)\n */\nexport type AIResponseMode = \"none\" | \"brief\" | \"full\";\n\n/**\n * Multimodal content for AI to analyze\n */\nexport type AIContent =\n  | { type: \"image\"; data: string; mediaType: string }\n  | { type: \"text\"; text: string };\n\n/**\n * How large tool results should be trimmed before they are sent back to the AI.\n */\nexport type ToolTruncationStrategy = \"head\" | \"head-tail\" | \"smart\";\n\n/**\n * Truncation controls for tool results.\n */\nexport interface ToolResultTruncationConfig {\n  enabled?: boolean;\n  maxContextShare?: number;\n  hardMaxChars?: number;\n  minKeepChars?: number;\n  strategy?: ToolTruncationStrategy;\n  preserveErrors?: boolean;\n}\n\n/**\n * Global or per-tool controls for how tool results are represented in prompts.\n */\nexport interface ToolResultConfig {\n  truncation?: ToolResultTruncationConfig;\n}\n\n/**\n * Named tool profile for selective loading.\n */\nexport interface ToolProfile {\n  name: string;\n  description?: string;\n  include?: string[];\n  exclude?: string[];\n}\n\n/**\n * Tool profile configuration.\n */\nexport interface ToolProfileConfig {\n  enabled?: boolean;\n  defaultProfile?: string;\n  profiles?: Record<string, ToolProfile>;\n  /** When false, active profiles exclude tools that do not declare profile membership. */\n  includeUnprofiled?: boolean;\n  dynamicSelection?: {\n    enabled?: boolean;\n    maxTools?: number;\n  };\n}\n\n/**\n * History compaction behavior for long-running sessions.\n */\nexport interface ContextHistoryConfig {\n  maxMessages?: number;\n  maxTokens?: number;\n  maxContextShare?: number;\n  pruneStrategy?: \"oldest\" | \"least-relevant\" | \"summarize\";\n}\n\n/**\n * Optional summarization controls used during history compaction.\n */\nexport interface ContextSummarizationConfig {\n  enabled?: boolean;\n  triggerAt?: number;\n  chunkSize?: number;\n  preserveRecent?: number;\n  fallbackBehavior?: \"truncate\" | \"statistical\" | \"error\";\n}\n\n/**\n * Token estimation controls.\n */\nexport interface TokenEstimationConfig {\n  safetyMargin?: number;\n  charsPerToken?: number;\n}\n\n/**\n * Conversation context management.\n */\nexport interface ContextManagementConfig {\n  enabled?: boolean;\n  history?: ContextHistoryConfig;\n  summarization?: ContextSummarizationConfig;\n  tokenEstimation?: TokenEstimationConfig;\n}\n\n/**\n * One budget bucket in the prompt context.\n */\nexport interface ContextUsagePart {\n  tokens: number;\n  percent: number;\n}\n\n/**\n * Prompt context usage snapshot.\n */\nexport interface ContextUsage {\n  total: ContextUsagePart;\n  breakdown: {\n    systemPrompt: ContextUsagePart;\n    history: ContextUsagePart;\n    toolResults: ContextUsagePart;\n    tools: ContextUsagePart;\n  };\n  budget: {\n    available: number;\n    remaining: number;\n  };\n  warnings: string[];\n}\n\n/**\n * Real-time context budget configuration.\n */\nexport interface ContextBudgetConfig {\n  enabled?: boolean;\n  budget?: {\n    contextWindowTokens?: number;\n    inputHeadroomRatio?: number;\n    systemPromptShare?: number;\n    historyShare?: number;\n    toolResultsShare?: number;\n    toolDefinitionsShare?: number;\n  };\n  enforcement?: {\n    mode?: \"warn\" | \"truncate\" | \"error\";\n    onBudgetExceeded?: (info: ContextUsage) => void;\n  };\n  monitoring?: {\n    enabled?: boolean;\n    onUsageUpdate?: (usage: ContextUsage) => void;\n  };\n}\n\n/**\n * Framework-agnostic optimization controls for tool-heavy chat sessions.\n */\nexport interface ToolOptimizationConfig {\n  toolProfiles?: ToolProfileConfig;\n  toolResultConfig?: ToolResultConfig;\n  contextManagement?: ContextManagementConfig;\n  contextBudget?: ContextBudgetConfig;\n}\n\n/**\n * Tool response format\n */\nexport interface ToolResponse<T = unknown> {\n  /** Whether the tool succeeded */\n  success: boolean;\n  /** Human-readable message */\n  message?: string;\n  /** Error message if failed */\n  error?: string;\n  /** Result data */\n  data?: T;\n\n  // ============================================\n  // AI Response Control (result-level overrides)\n  // ============================================\n\n  /**\n   * Override AI context for this specific result.\n   * Takes precedence over tool-level aiContext config.\n   * If set, this message is sent to AI instead of full result data.\n   *\n   * @example\n   * ```typescript\n   * return {\n   *   success: true,\n   *   data: sensitiveData,\n   *   _aiContext: '[Data retrieved - contains sensitive info, displayed to user]'\n   * };\n   * ```\n   */\n  _aiContext?: string;\n\n  /**\n   * Override AI response mode for this specific result.\n   * Takes precedence over tool-level aiResponseMode config.\n   */\n  _aiResponseMode?: AIResponseMode;\n\n  /**\n   * Content for AI to analyze (images, documents, etc.).\n   * When present, these are included as multimodal content for AI analysis.\n   *\n   * @example\n   * ```typescript\n   * // Screenshot for AI to analyze\n   * return {\n   *   success: true,\n   *   message: 'Screenshot captured',\n   *   _aiContent: [{ type: 'image', data: base64, mediaType: 'image/png' }]\n   * };\n   * ```\n   */\n  _aiContent?: AIContent[];\n\n  /**\n   * MCP-UI resources for rendering interactive UI components.\n   * These are extracted from MCP tool results and rendered as iframes.\n   * Not sent to the AI - purely for UI rendering.\n   *\n   * @example\n   * ```typescript\n   * // MCP tool returning UI\n   * return {\n   *   success: true,\n   *   message: 'Product displayed',\n   *   _uiResources: [{\n   *     uri: 'ui://shop/product/123',\n   *     mimeType: 'text/html',\n   *     content: '<div class=\"product\">...</div>',\n   *     metadata: { height: '300px' }\n   *   }]\n   * };\n   * ```\n   */\n  _uiResources?: Array<{\n    uri: string;\n    mimeType:\n      | \"text/html\"\n      | \"text/uri-list\"\n      | \"application/vnd.mcp-ui.remote-dom\";\n    content?: string;\n    blob?: string;\n    metadata?: {\n      title?: string;\n      width?: string;\n      height?: string;\n      sandbox?: string[];\n      className?: string;\n    };\n  }>;\n}\n\n/**\n * Approval callbacks passed to render when tool requires user action.\n * Only present when status is \"approval-required\".\n */\nexport interface ToolApprovalCallbacks {\n  /**\n   * Approve execution and optionally pass extra data to the handler.\n   * The extraData is available in handler via `context.approvalData`.\n   *\n   * @example\n   * ```tsx\n   * // Simple approval\n   * approval.onApprove();\n   *\n   * // Approval with data (e.g., user selection)\n   * approval.onApprove({ supervisor: { name: \"John\", role: \"Manager\" } });\n   * ```\n   */\n  onApprove: (extraData?: Record<string, unknown>) => void;\n\n  /**\n   * Reject the tool execution with optional reason.\n   * This stops the tool from executing and returns an error to AI.\n   */\n  onReject: (reason?: string) => void;\n\n  /** Custom message from tool's approvalMessage config */\n  message?: string;\n}\n\n/**\n * Props passed to tool render function.\n *\n * The render function is called for every status change, enabling\n * full lifecycle rendering similar to Vercel AI SDK.\n *\n * @example\n * ```tsx\n * render: ({ status, args, approval, result }) => {\n *   if (status === \"approval-required\" && approval) {\n *     return <ApprovalCard onConfirm={() => approval.onApprove()} />;\n *   }\n *   if (status === \"executing\") {\n *     return <LoadingSkeleton />;\n *   }\n *   if (status === \"completed\") {\n *     return <ResultCard data={result.data} />;\n *   }\n *   return null;\n * }\n * ```\n */\nexport interface ToolRenderProps<TParams = Record<string, unknown>> {\n  /**\n   * Current execution status:\n   * - `pending`: Tool call received, waiting to start\n   * - `approval-required`: Waiting for user approval (when needsApproval is set)\n   * - `executing`: Handler is running\n   * - `completed`: Handler finished successfully\n   * - `error`: Handler failed\n   */\n  status: \"pending\" | \"approval-required\" | \"executing\" | \"completed\" | \"error\";\n\n  /** Arguments passed to the tool */\n  args: TParams;\n\n  /** Result if completed */\n  result?: ToolResponse;\n\n  /** Error if failed */\n  error?: string;\n\n  /** Tool call ID */\n  toolCallId: string;\n\n  /** Tool name */\n  toolName: string;\n\n  /**\n   * Approval callbacks - only present when status is \"approval-required\".\n   * Use these to create custom approval UIs that can pass extra data to the handler.\n   */\n  approval?: ToolApprovalCallbacks;\n}\n\n/**\n * Tool definition with JSON Schema\n */\nexport interface ToolDefinition<TParams = Record<string, unknown>> {\n  /** Unique tool name */\n  name: string;\n  /** Tool description for LLM */\n  description: string;\n  /** Where the tool executes (server or client) */\n  location: ToolLocation;\n  /**\n   * Source/origin of the tool.\n   * Used to distinguish MCP tools from native/custom tools for UI rendering.\n   * @default \"custom\"\n   */\n  source?: ToolSource;\n  /** Optional category for search, filtering, and budgets */\n  category?: string;\n  /** Optional group for profile-based tool selection */\n  group?: string;\n  /** Deferred tools are discoverable but need not be sent on every request */\n  deferLoading?: boolean;\n  /** Profile memberships for selective tool loading */\n  profiles?: string[];\n  /** Extra keywords for dynamic tool selection */\n  searchKeywords?: string[];\n  /** Per-tool prompt/result shaping controls */\n  resultConfig?: ToolResultConfig;\n\n  // ============================================\n  // Display Configuration\n  // ============================================\n\n  /**\n   * Human-readable title for UI display.\n   * Can be a static string or a function that generates title from args.\n   *\n   * @example\n   * ```typescript\n   * title: \"Get order details\"\n   * // or dynamic:\n   * title: (args) => `Order #${args.orderId}`\n   * ```\n   */\n  title?: string | ((args: TParams) => string);\n\n  /**\n   * Title shown while executing (present tense with \"...\").\n   * If not provided, uses `title` with \"...\" appended.\n   *\n   * @example\n   * ```typescript\n   * executingTitle: (args) => `Fetching order #${args.orderId}...`\n   * ```\n   */\n  executingTitle?: string | ((args: TParams) => string);\n\n  /**\n   * Title shown after completion.\n   * If not provided, defaults to `title`.\n   *\n   * @example\n   * ```typescript\n   * completedTitle: (args) => `Retrieved order #${args.orderId}`\n   * ```\n   */\n  completedTitle?: string | ((args: TParams) => string);\n  /** JSON Schema for input parameters */\n  inputSchema: ToolInputSchema;\n  /** Handler function (optional for client tools registered on server) */\n  handler?: (\n    params: TParams,\n    context?: ToolContext,\n  ) => Promise<ToolResponse> | ToolResponse;\n  /** Optional render function for UI */\n  render?: (props: ToolRenderProps<TParams>) => unknown;\n  /** Whether the tool is available (for conditional registration) */\n  available?: boolean;\n\n  /**\n   * Hide this tool's execution from the chat UI.\n   * When true, tool calls and results won't be displayed to the user,\n   * but the tool will still execute normally.\n   * @default false\n   */\n  hidden?: boolean;\n\n  /**\n   * Require user approval before execution.\n   * Can be:\n   * - `true`: Always require approval\n   * - `false` or `undefined`: No approval needed (default)\n   * - `(params) => boolean`: Conditional approval based on input\n   *\n   * Similar to Vercel AI SDK v6's needsApproval pattern.\n   */\n  needsApproval?: boolean | ((params: TParams) => boolean | Promise<boolean>);\n\n  /**\n   * Custom title shown in the approval UI.\n   * If not provided, the tool name is used.\n   */\n  approvalTitle?: string | ((params: TParams) => string);\n\n  /**\n   * Custom message shown in the approval UI.\n   * Can be a string or a function that generates a message from params.\n   * If not provided, a default message with the tool name is shown.\n   */\n  approvalMessage?: string | ((params: TParams) => string);\n\n  // ============================================\n  // AI Response Control\n  // ============================================\n\n  /**\n   * How the AI should respond when this tool's result is rendered as UI.\n   *\n   * - `'none'`: AI generates minimal response (\"[Result displayed to user]\").\n   *   Use for tools where UI component fully handles the display (stats cards, etc.)\n   *\n   * - `'brief'`: AI receives summary context (from aiContext) and gives brief acknowledgment.\n   *   Use for charts/visualizations where AI should acknowledge but not repeat data.\n   *\n   * - `'full'`: AI receives complete data and responds accordingly (default).\n   *   Use for tools where AI should analyze and elaborate on results.\n   *\n   * @default 'full'\n   *\n   * @example\n   * ```typescript\n   * // Chart tool - AI acknowledges without repeating data\n   * const chartTool: ToolDefinition = {\n   *   name: 'get_chart',\n   *   aiResponseMode: 'brief',\n   *   aiContext: (result) => `[Chart displayed: ${result.data.title}]`,\n   *   handler: async () => ({ success: true, data: chartData })\n   * };\n   * ```\n   */\n  aiResponseMode?: AIResponseMode;\n\n  /**\n   * Context/summary sent to AI instead of (or along with) full result.\n   *\n   * Used when:\n   * - `aiResponseMode: 'brief'` - This becomes the only thing AI sees\n   * - `aiResponseMode: 'full'` - This is prepended to full data for context\n   *\n   * Can be:\n   * - `string`: Static message (e.g., \"[Weather data displayed]\")\n   * - `function`: Dynamic based on result (e.g., (result) => `[Chart: ${result.data.title}]`)\n   *\n   * @example\n   * ```typescript\n   * // Static context\n   * aiContext: '[Analytics chart displayed to user]'\n   *\n   * // Dynamic context based on result\n   * aiContext: (result, args) => {\n   *   const { title, currentValue } = result.data;\n   *   return `[Chart displayed: ${title}, showing ${currentValue}]`;\n   * }\n   * ```\n   */\n  aiContext?:\n    | string\n    | ((result: ToolResponse, args: Record<string, unknown>) => string);\n}\n\n// ============================================\n// Unified Tool Call Types (Provider-Agnostic)\n// ============================================\n\n/**\n * Unified tool call format (internal representation)\n */\nexport interface UnifiedToolCall {\n  /** Unique tool call ID */\n  id: string;\n  /** Tool name */\n  name: string;\n  /** Tool input arguments */\n  input: Record<string, unknown>;\n}\n\n/**\n * Unified tool result format\n */\nexport interface UnifiedToolResult {\n  /** Tool call ID this result is for */\n  toolCallId: string;\n  /** Serialized result content (JSON string) */\n  content: string;\n  /** Whether the tool succeeded */\n  success: boolean;\n  /** Error message if failed */\n  error?: string;\n}\n\n// ============================================\n// Tool Execution Types\n// ============================================\n\n/**\n * Tool execution status\n */\nexport type ToolExecutionStatus =\n  | \"pending\"\n  | \"executing\"\n  | \"completed\"\n  | \"error\";\n\n/**\n * Tool approval status (for human-in-the-loop)\n *\n * Similar to Vercel AI SDK v6's tool approval pattern.\n */\nexport type ToolApprovalStatus =\n  | \"none\" // No approval needed (default)\n  | \"required\" // Waiting for user decision\n  | \"approved\" // User approved, execution can proceed\n  | \"rejected\"; // User rejected, execution skipped\n\n// ============================================\n// Permission Persistence Types\n// ============================================\n\n/**\n * Permission level for tool execution\n *\n * Controls whether approval is needed and how the choice is remembered:\n * - \"ask\" - Always prompt user (default)\n * - \"allow_always\" - Auto-approve, persisted to storage\n * - \"deny_always\" - Auto-reject, persisted to storage\n * - \"session\" - Auto-approve for current session only\n */\nexport type PermissionLevel =\n  | \"ask\"\n  | \"allow_always\"\n  | \"deny_always\"\n  | \"session\";\n\n/**\n * Stored tool permission record\n */\nexport interface ToolPermission {\n  /** Tool name (unique identifier) */\n  toolName: string;\n  /** Permission level */\n  level: PermissionLevel;\n  /** When permission was set */\n  createdAt: number;\n  /** Last time this permission was used */\n  lastUsedAt?: number;\n}\n\n/**\n * Permission storage configuration\n */\nexport interface PermissionStorageConfig {\n  /**\n   * Storage type:\n   * - \"localStorage\" - Persists across browser sessions\n   * - \"sessionStorage\" - Clears when tab closes\n   * - \"memory\" - In-memory only (for SSR or testing)\n   */\n  type: \"localStorage\" | \"sessionStorage\" | \"memory\";\n  /** Storage key prefix (default: \"yourgpt-permissions\") */\n  keyPrefix?: string;\n}\n\n/**\n * Permission storage adapter interface (for custom implementations)\n */\nexport interface PermissionStorageAdapter {\n  /** Get permission for a tool */\n  get(toolName: string): Promise<ToolPermission | null>;\n  /** Set permission for a tool */\n  set(permission: ToolPermission): Promise<void>;\n  /** Remove permission for a tool */\n  remove(toolName: string): Promise<void>;\n  /** Get all permissions */\n  getAll(): Promise<ToolPermission[]>;\n  /** Clear all permissions */\n  clear(): Promise<void>;\n}\n\n/**\n * Tool execution record (for UI tracking)\n */\nexport interface ToolExecution {\n  /** Tool call ID */\n  id: string;\n  /** Tool name */\n  name: string;\n  /** Tool arguments */\n  args: Record<string, unknown>;\n  /** Execution status */\n  status: ToolExecutionStatus;\n  /** Result if completed */\n  result?: ToolResponse;\n  /** Error message if failed */\n  error?: string;\n  /** Timestamp when execution started */\n  timestamp: number;\n  /** Duration in ms (set when completed) */\n  duration?: number;\n\n  // Approval fields (for needsApproval tools)\n\n  /** Approval status for this execution */\n  approvalStatus: ToolApprovalStatus;\n  /** Title shown in approval UI (from tool's approvalTitle) */\n  approvalTitle?: string;\n  /** Message shown in approval UI (from tool's approvalMessage) */\n  approvalMessage?: string;\n  /** Timestamp when user responded to approval request */\n  approvalTimestamp?: number;\n\n  /**\n   * Whether this tool execution should be hidden from the UI.\n   * Server-side tools can set this to hide internal operations from users.\n   */\n  hidden?: boolean;\n}\n\n// ============================================\n// Agent Loop Types\n// ============================================\n\n/**\n * Agentic loop configuration\n */\nexport interface AgentLoopConfig {\n  /** Maximum iterations before stopping (default: 20) */\n  maxIterations?: number;\n  /** Enable debug logging */\n  debug?: boolean;\n  /** Whether to enable the agentic loop (default: true) */\n  enabled?: boolean;\n  /** Optional prompt/tool optimization controls */\n  optimization?: ToolOptimizationConfig;\n}\n\n/**\n * Agent loop state (for tracking)\n */\nexport interface AgentLoopState {\n  /** Current iteration number */\n  iteration: number;\n  /** Maximum iterations allowed */\n  maxIterations: number;\n  /** Whether the loop is currently running */\n  running: boolean;\n  /** Whether max iterations was reached */\n  maxIterationsReached: boolean;\n  /** Whether the loop was aborted */\n  aborted: boolean;\n}\n\n// ============================================\n// ToolSet Type (Vercel AI SDK pattern)\n// ============================================\n\n/**\n * A tool definition without the name (name is derived from the key in ToolSet)\n */\nexport type ToolSetEntry<TParams = Record<string, unknown>> = Omit<\n  ToolDefinition<TParams>,\n  \"name\"\n>;\n\n/**\n * A set of tools, keyed by tool name\n *\n * The key becomes the tool name, so tool definitions don't need a name property.\n * Use with the `tool()` helper for clean syntax.\n *\n * @example\n * ```typescript\n * const myTools: ToolSet = {\n *   capture_screenshot: tool({\n *     description: 'Capture screenshot',\n *     handler: async () => ({ success: true }),\n *   }),\n *   get_weather: tool({\n *     description: 'Get weather',\n *     inputSchema: { type: 'object', properties: { city: { type: 'string' } } },\n *     handler: async ({ city }) => ({ success: true, data: { temp: 72 } }),\n *   }),\n * };\n * ```\n */\nexport type ToolSet = Record<string, ToolSetEntry>;\n\n// ============================================\n// Tool Helper Function (Vercel AI SDK pattern)\n// ============================================\n\n/**\n * Configuration for creating a tool\n */\nexport interface ToolConfig<TParams = Record<string, unknown>> {\n  /** Tool description for LLM */\n  description: string;\n  /** Where the tool executes (default: 'client') */\n  location?: ToolLocation;\n  /** Optional category for search, filtering, and budgets */\n  category?: string;\n  /** Optional group for profile-based tool selection */\n  group?: string;\n  /** Deferred tools are discoverable but omitted from the default prompt */\n  deferLoading?: boolean;\n  /** Profile memberships for selective tool loading */\n  profiles?: string[];\n  /** Extra keywords for dynamic tool selection */\n  searchKeywords?: string[];\n  /** Per-tool prompt/result shaping controls */\n  resultConfig?: ToolResultConfig;\n\n  // Display Configuration\n  /** Human-readable title for UI display */\n  title?: string | ((args: TParams) => string);\n  /** Title shown while executing */\n  executingTitle?: string | ((args: TParams) => string);\n  /** Title shown after completion */\n  completedTitle?: string | ((args: TParams) => string);\n\n  /** JSON Schema for input parameters */\n  inputSchema?: ToolInputSchema;\n  /** Handler function */\n  handler?: (\n    params: TParams,\n    context?: ToolContext,\n  ) => Promise<ToolResponse> | ToolResponse;\n  /** Optional render function for UI */\n  render?: (props: ToolRenderProps<TParams>) => unknown;\n  /** Whether the tool is available */\n  available?: boolean;\n  /** Hide this tool from chat UI display */\n  hidden?: boolean;\n  /** Require user approval before execution */\n  needsApproval?: boolean | ((params: TParams) => boolean | Promise<boolean>);\n  /** Custom title shown in the approval UI */\n  approvalTitle?: string | ((params: TParams) => string);\n  /** Custom message shown in the approval UI */\n  approvalMessage?: string | ((params: TParams) => string);\n  /** AI response mode for this tool (default: 'full') */\n  aiResponseMode?: AIResponseMode;\n  /** Context/summary sent to AI instead of full result */\n  aiContext?:\n    | string\n    | ((result: ToolResponse, args: Record<string, unknown>) => string);\n}\n\n/**\n * Create a tool definition (similar to Vercel AI SDK's tool())\n *\n * @example\n * ```typescript\n * const weatherTool = tool({\n *   description: 'Get weather for a location',\n *   inputSchema: {\n *     type: 'object',\n *     properties: {\n *       location: { type: 'string', description: 'City name' },\n *     },\n *     required: ['location'],\n *   },\n *   handler: async ({ location }) => {\n *     const weather = await fetchWeather(location);\n *     return success(weather);\n *   },\n * });\n * ```\n */\nexport function tool<TParams = Record<string, unknown>>(\n  config: ToolConfig<TParams>,\n): Omit<ToolDefinition<TParams>, \"name\"> {\n  return {\n    description: config.description,\n    location: config.location ?? \"client\",\n    category: config.category,\n    group: config.group,\n    deferLoading: config.deferLoading,\n    profiles: config.profiles,\n    searchKeywords: config.searchKeywords,\n    resultConfig: config.resultConfig,\n    // Display configuration\n    title: config.title,\n    executingTitle: config.executingTitle,\n    completedTitle: config.completedTitle,\n    // Schema and handlers\n    inputSchema: config.inputSchema ?? {\n      type: \"object\",\n      properties: {},\n      required: [],\n    },\n    handler: config.handler,\n    render: config.render,\n    available: config.available,\n    hidden: config.hidden,\n    needsApproval: config.needsApproval,\n    approvalMessage: config.approvalMessage,\n    aiResponseMode: config.aiResponseMode,\n    aiContext: config.aiContext,\n  };\n}\n\n// ============================================\n// Helper Functions\n// ============================================\n\n/**\n * Convert ToolDefinition to OpenAI tool format\n */\nexport function toolToOpenAIFormat(tool: ToolDefinition): object {\n  return {\n    type: \"function\",\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: tool.inputSchema,\n    },\n  };\n}\n\n/**\n * Convert ToolDefinition to Anthropic tool format\n */\nexport function toolToAnthropicFormat(tool: ToolDefinition): object {\n  return {\n    name: tool.name,\n    description: tool.description,\n    input_schema: tool.inputSchema,\n  };\n}\n\n/**\n * Create a tool result response\n */\nexport function createToolResult(\n  toolCallId: string,\n  response: ToolResponse,\n): UnifiedToolResult {\n  return {\n    toolCallId,\n    content: JSON.stringify(response),\n    success: response.success,\n    error: response.error,\n  };\n}\n\n/**\n * Create a successful tool response\n */\nexport function success<T = unknown>(\n  data?: T,\n  message?: string,\n): ToolResponse<T> {\n  return {\n    success: true,\n    data,\n    message,\n  };\n}\n\n/**\n * Create a failed tool response\n */\nexport function failure(error: string): ToolResponse {\n  return {\n    success: false,\n    error,\n  };\n}\n"]}

package/dist/chunk-TXQ37MAO.js

@@ -0,0 +1,287 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/ui/lib/utils.ts
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+function DotsLoader({
+  className,
+  size = "md"
+}) {
+  const dotSizes = {
+    sm: "h-1 w-1",
+    md: "h-1.5 w-1.5",
+    lg: "h-2 w-2"
+  };
+  const containerSizes = {
+    sm: "h-4",
+    md: "h-5",
+    lg: "h-6"
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "flex items-center translate-y-[-2px] space-x-1",
+        containerSizes[size],
+        className
+      ),
+      children: [
+        [...Array(3)].map((_, i) => /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: cn(
+              "bg-primary csdk-loader-bounce-dots rounded-full",
+              dotSizes[size]
+            ),
+            style: {
+              animationDelay: `${i * 160}ms`
+            }
+          },
+          i
+        )),
+        /* @__PURE__ */ jsx("span", { className: "sr-only", children: "Loading" })
+      ]
+    }
+  );
+}
+function TypingLoader({
+  className,
+  size = "md"
+}) {
+  const dotSizes = {
+    sm: "h-1 w-1",
+    md: "h-1.5 w-1.5",
+    lg: "h-2 w-2"
+  };
+  const containerSizes = {
+    sm: "h-4",
+    md: "h-5",
+    lg: "h-6"
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "flex items-center space-x-1",
+        containerSizes[size],
+        className
+      ),
+      children: [
+        [...Array(3)].map((_, i) => /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: cn(
+              "bg-primary csdk-loader-typing rounded-full",
+              dotSizes[size]
+            ),
+            style: {
+              animationDelay: `${i * 250}ms`
+            }
+          },
+          i
+        )),
+        /* @__PURE__ */ jsx("span", { className: "sr-only", children: "Loading" })
+      ]
+    }
+  );
+}
+function WaveLoader({
+  className,
+  size = "md"
+}) {
+  const barWidths = {
+    sm: "w-0.5",
+    md: "w-0.5",
+    lg: "w-1"
+  };
+  const containerSizes = {
+    sm: "h-4",
+    md: "h-5",
+    lg: "h-6"
+  };
+  const heights = {
+    sm: ["6px", "9px", "12px", "9px", "6px"],
+    md: ["8px", "12px", "16px", "12px", "8px"],
+    lg: ["10px", "15px", "20px", "15px", "10px"]
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "flex items-center gap-0.5",
+        containerSizes[size],
+        className
+      ),
+      children: [
+        [...Array(5)].map((_, i) => /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: cn(
+              "bg-primary csdk-loader-wave rounded-full",
+              barWidths[size]
+            ),
+            style: {
+              animationDelay: `${i * 100}ms`,
+              height: heights[size][i]
+            }
+          },
+          i
+        )),
+        /* @__PURE__ */ jsx("span", { className: "sr-only", children: "Loading" })
+      ]
+    }
+  );
+}
+function TerminalLoader({
+  className,
+  size = "md"
+}) {
+  const cursorSizes = {
+    sm: "h-3 w-1.5",
+    md: "h-4 w-2",
+    lg: "h-5 w-2.5"
+  };
+  const textSizes = {
+    sm: "text-xs",
+    md: "text-sm",
+    lg: "text-base"
+  };
+  const containerSizes = {
+    sm: "h-4",
+    md: "h-5",
+    lg: "h-6"
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "flex items-center space-x-1",
+        containerSizes[size],
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx("span", { className: cn("text-primary font-mono", textSizes[size]), children: ">" }),
+        /* @__PURE__ */ jsx("div", { className: cn("bg-primary csdk-loader-blink", cursorSizes[size]) }),
+        /* @__PURE__ */ jsx("span", { className: "sr-only", children: "Loading" })
+      ]
+    }
+  );
+}
+function TextBlinkLoader({
+  text = "Thinking",
+  className,
+  size = "md"
+}) {
+  const textSizes = {
+    sm: "text-xs",
+    md: "text-sm",
+    lg: "text-base"
+  };
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn(
+        "csdk-loader-text-blink font-medium",
+        textSizes[size],
+        className
+      ),
+      children: text
+    }
+  );
+}
+function TextShimmerLoader({
+  text = "Thinking",
+  className,
+  size = "md"
+}) {
+  const textSizes = {
+    sm: "text-xs",
+    md: "text-sm",
+    lg: "text-base"
+  };
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn(
+        "bg-[linear-gradient(to_right,var(--muted-foreground)_40%,var(--foreground)_60%,var(--muted-foreground)_80%)]",
+        "bg-[length:200%_auto] bg-clip-text font-medium text-transparent",
+        "csdk-loader-shimmer",
+        textSizes[size],
+        className
+      ),
+      children: text
+    }
+  );
+}
+function TextDotsLoader({
+  className,
+  text = "Thinking",
+  size = "md"
+}) {
+  const textSizes = {
+    sm: "text-xs",
+    md: "text-sm",
+    lg: "text-base"
+  };
+  return /* @__PURE__ */ jsxs("div", { className: cn("inline-flex items-center", className), children: [
+    /* @__PURE__ */ jsx("span", { className: cn("text-primary font-medium", textSizes[size]), children: text }),
+    /* @__PURE__ */ jsxs("span", { className: "inline-flex", children: [
+      /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: "text-primary csdk-loader-loading-dots",
+          style: { animationDelay: "0.2s" },
+          children: "."
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: "text-primary csdk-loader-loading-dots",
+          style: { animationDelay: "0.4s" },
+          children: "."
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: "text-primary csdk-loader-loading-dots",
+          style: { animationDelay: "0.6s" },
+          children: "."
+        }
+      )
+    ] })
+  ] });
+}
+function Loader({
+  variant = "typing",
+  size = "md",
+  text,
+  className
+}) {
+  switch (variant) {
+    case "dots":
+      return /* @__PURE__ */ jsx(DotsLoader, { size, className });
+    case "typing":
+      return /* @__PURE__ */ jsx(TypingLoader, { size, className });
+    case "wave":
+      return /* @__PURE__ */ jsx(WaveLoader, { size, className });
+    case "terminal":
+      return /* @__PURE__ */ jsx(TerminalLoader, { size, className });
+    case "text-blink":
+      return /* @__PURE__ */ jsx(TextBlinkLoader, { text, size, className });
+    case "text-shimmer":
+      return /* @__PURE__ */ jsx(TextShimmerLoader, { text, size, className });
+    case "loading-dots":
+      return /* @__PURE__ */ jsx(TextDotsLoader, { text, size, className });
+    default:
+      return /* @__PURE__ */ jsx(TypingLoader, { size, className });
+  }
+}
+
+export { DotsLoader, Loader, TextShimmerLoader, cn };
+//# sourceMappingURL=chunk-TXQ37MAO.js.map
+//# sourceMappingURL=chunk-TXQ37MAO.js.map

package/dist/chunk-TXQ37MAO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ui/lib/utils.ts","../src/ui/components/ui/loader.tsx"],"names":[],"mappings":"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","file":"chunk-TXQ37MAO.js","sourcesContent":["import { clsx, type ClassValue } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n","import { cn } from \"../../lib/utils\";\n\nexport interface LoaderProps {\n  variant?:\n    | \"dots\"\n    | \"typing\"\n    | \"wave\"\n    | \"terminal\"\n    | \"text-blink\"\n    | \"text-shimmer\"\n    | \"loading-dots\";\n  size?: \"sm\" | \"md\" | \"lg\";\n  text?: string;\n  className?: string;\n}\n\nexport function DotsLoader({\n  className,\n  size = \"md\",\n}: {\n  className?: string;\n  size?: \"sm\" | \"md\" | \"lg\";\n}) {\n  const dotSizes = {\n    sm: \"h-1 w-1\",\n    md: \"h-1.5 w-1.5\",\n    lg: \"h-2 w-2\",\n  };\n\n  const containerSizes = {\n    sm: \"h-4\",\n    md: \"h-5\",\n    lg: \"h-6\",\n  };\n\n  return (\n    <div\n      className={cn(\n        \"flex items-center translate-y-[-2px] space-x-1\",\n        containerSizes[size],\n        className,\n      )}\n    >\n      {[...Array(3)].map((_, i) => (\n        <div\n          key={i}\n          className={cn(\n            \"bg-primary csdk-loader-bounce-dots rounded-full\",\n            dotSizes[size],\n          )}\n          style={{\n            animationDelay: `${i * 160}ms`,\n          }}\n        />\n      ))}\n      <span className=\"sr-only\">Loading</span>\n    </div>\n  );\n}\n\nexport function TypingLoader({\n  className,\n  size = \"md\",\n}: {\n  className?: string;\n  size?: \"sm\" | \"md\" | \"lg\";\n}) {\n  const dotSizes = {\n    sm: \"h-1 w-1\",\n    md: \"h-1.5 w-1.5\",\n    lg: \"h-2 w-2\",\n  };\n\n  const containerSizes = {\n    sm: \"h-4\",\n    md: \"h-5\",\n    lg: \"h-6\",\n  };\n\n  return (\n    <div\n      className={cn(\n        \"flex items-center space-x-1\",\n        containerSizes[size],\n        className,\n      )}\n    >\n      {[...Array(3)].map((_, i) => (\n        <div\n          key={i}\n          className={cn(\n            \"bg-primary csdk-loader-typing rounded-full\",\n            dotSizes[size],\n          )}\n          style={{\n            animationDelay: `${i * 250}ms`,\n          }}\n        />\n      ))}\n      <span className=\"sr-only\">Loading</span>\n    </div>\n  );\n}\n\nexport function WaveLoader({\n  className,\n  size = \"md\",\n}: {\n  className?: string;\n  size?: \"sm\" | \"md\" | \"lg\";\n}) {\n  const barWidths = {\n    sm: \"w-0.5\",\n    md: \"w-0.5\",\n    lg: \"w-1\",\n  };\n\n  const containerSizes = {\n    sm: \"h-4\",\n    md: \"h-5\",\n    lg: \"h-6\",\n  };\n\n  const heights = {\n    sm: [\"6px\", \"9px\", \"12px\", \"9px\", \"6px\"],\n    md: [\"8px\", \"12px\", \"16px\", \"12px\", \"8px\"],\n    lg: [\"10px\", \"15px\", \"20px\", \"15px\", \"10px\"],\n  };\n\n  return (\n    <div\n      className={cn(\n        \"flex items-center gap-0.5\",\n        containerSizes[size],\n        className,\n      )}\n    >\n      {[...Array(5)].map((_, i) => (\n        <div\n          key={i}\n          className={cn(\n            \"bg-primary csdk-loader-wave rounded-full\",\n            barWidths[size],\n          )}\n          style={{\n            animationDelay: `${i * 100}ms`,\n            height: heights[size][i],\n          }}\n        />\n      ))}\n      <span className=\"sr-only\">Loading</span>\n    </div>\n  );\n}\n\nexport function TerminalLoader({\n  className,\n  size = \"md\",\n}: {\n  className?: string;\n  size?: \"sm\" | \"md\" | \"lg\";\n}) {\n  const cursorSizes = {\n    sm: \"h-3 w-1.5\",\n    md: \"h-4 w-2\",\n    lg: \"h-5 w-2.5\",\n  };\n\n  const textSizes = {\n    sm: \"text-xs\",\n    md: \"text-sm\",\n    lg: \"text-base\",\n  };\n\n  const containerSizes = {\n    sm: \"h-4\",\n    md: \"h-5\",\n    lg: \"h-6\",\n  };\n\n  return (\n    <div\n      className={cn(\n        \"flex items-center space-x-1\",\n        containerSizes[size],\n        className,\n      )}\n    >\n      <span className={cn(\"text-primary font-mono\", textSizes[size])}>\n        {\">\"}\n      </span>\n      <div className={cn(\"bg-primary csdk-loader-blink\", cursorSizes[size])} />\n      <span className=\"sr-only\">Loading</span>\n    </div>\n  );\n}\n\nexport function TextBlinkLoader({\n  text = \"Thinking\",\n  className,\n  size = \"md\",\n}: {\n  text?: string;\n  className?: string;\n  size?: \"sm\" | \"md\" | \"lg\";\n}) {\n  const textSizes = {\n    sm: \"text-xs\",\n    md: \"text-sm\",\n    lg: \"text-base\",\n  };\n\n  return (\n    <div\n      className={cn(\n        \"csdk-loader-text-blink font-medium\",\n        textSizes[size],\n        className,\n      )}\n    >\n      {text}\n    </div>\n  );\n}\n\nexport function TextShimmerLoader({\n  text = \"Thinking\",\n  className,\n  size = \"md\",\n}: {\n  text?: string;\n  className?: string;\n  size?: \"sm\" | \"md\" | \"lg\";\n}) {\n  const textSizes = {\n    sm: \"text-xs\",\n    md: \"text-sm\",\n    lg: \"text-base\",\n  };\n\n  return (\n    <div\n      className={cn(\n        \"bg-[linear-gradient(to_right,var(--muted-foreground)_40%,var(--foreground)_60%,var(--muted-foreground)_80%)]\",\n        \"bg-[length:200%_auto] bg-clip-text font-medium text-transparent\",\n        \"csdk-loader-shimmer\",\n        textSizes[size],\n        className,\n      )}\n    >\n      {text}\n    </div>\n  );\n}\n\nexport function TextDotsLoader({\n  className,\n  text = \"Thinking\",\n  size = \"md\",\n}: {\n  className?: string;\n  text?: string;\n  size?: \"sm\" | \"md\" | \"lg\";\n}) {\n  const textSizes = {\n    sm: \"text-xs\",\n    md: \"text-sm\",\n    lg: \"text-base\",\n  };\n\n  return (\n    <div className={cn(\"inline-flex items-center\", className)}>\n      <span className={cn(\"text-primary font-medium\", textSizes[size])}>\n        {text}\n      </span>\n      <span className=\"inline-flex\">\n        <span\n          className=\"text-primary csdk-loader-loading-dots\"\n          style={{ animationDelay: \"0.2s\" }}\n        >\n          .\n        </span>\n        <span\n          className=\"text-primary csdk-loader-loading-dots\"\n          style={{ animationDelay: \"0.4s\" }}\n        >\n          .\n        </span>\n        <span\n          className=\"text-primary csdk-loader-loading-dots\"\n          style={{ animationDelay: \"0.6s\" }}\n        >\n          .\n        </span>\n      </span>\n    </div>\n  );\n}\n\nfunction Loader({\n  variant = \"typing\",\n  size = \"md\",\n  text,\n  className,\n}: LoaderProps) {\n  switch (variant) {\n    case \"dots\":\n      return <DotsLoader size={size} className={className} />;\n    case \"typing\":\n      return <TypingLoader size={size} className={className} />;\n    case \"wave\":\n      return <WaveLoader size={size} className={className} />;\n    case \"terminal\":\n      return <TerminalLoader size={size} className={className} />;\n    case \"text-blink\":\n      return <TextBlinkLoader text={text} size={size} className={className} />;\n    case \"text-shimmer\":\n      return (\n        <TextShimmerLoader text={text} size={size} className={className} />\n      );\n    case \"loading-dots\":\n      return <TextDotsLoader text={text} size={size} className={className} />;\n    default:\n      return <TypingLoader size={size} className={className} />;\n  }\n}\n\nexport { Loader };\n"]}

package/dist/{chunk-MDS23G2S.cjs → chunk-Y2A6AMGO.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkTPB7XED6_cjs = require('./chunk-TPB7XED6.cjs');
-var chunkNUXLAZOE_cjs = require('./chunk-NUXLAZOE.cjs');
+var chunkTPDMBDQX_cjs = require('./chunk-TPDMBDQX.cjs');
+var chunk3ZDRX7J2_cjs = require('./chunk-3ZDRX7J2.cjs');
 
 // src/core/tools/builtin/webSearch.ts
-var webSearchTool = chunkTPB7XED6_cjs.tool({
+var webSearchTool = chunkTPDMBDQX_cjs.tool({
   description: `Search the web for current information. Use this when the user asks about:
 - Recent events, news, or current affairs
 - Real-time data (prices, weather, stocks, sports scores)
@@ -44,7 +44,7 @@ var webSearchTool = chunkTPB7XED6_cjs.tool({
   aiContext: (result, args) => {
     if (!result.success) return `Search failed: ${result.error}`;
     const data = result.data;
-    return chunkNUXLAZOE_cjs.formatSearchResultsForAI(data);
+    return chunk3ZDRX7J2_cjs.formatSearchResultsForAI(data);
   }
 });
 function createWebSearchTool(config) {
@@ -53,7 +53,7 @@ function createWebSearchTool(config) {
     ...webSearchTool,
     handler: async (params) => {
       try {
-        const response = await chunkNUXLAZOE_cjs.executeWebSearch(
+        const response = await chunk3ZDRX7J2_cjs.executeWebSearch(
           {
             query: params.query,
             maxResults: params.maxResults ?? config.maxResults ?? 5,
@@ -61,16 +61,16 @@ function createWebSearchTool(config) {
           },
           config
         );
-        const aiContext = chunkNUXLAZOE_cjs.formatSearchResultsForAI(response);
+        const aiContext = chunk3ZDRX7J2_cjs.formatSearchResultsForAI(response);
         return {
           success: true,
-          message: chunkNUXLAZOE_cjs.summarizeSearchResults(response),
+          message: chunk3ZDRX7J2_cjs.summarizeSearchResults(response),
           data: response,
           _aiContext: aiContext
         };
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : "Web search failed";
-        return chunkTPB7XED6_cjs.failure(errorMessage);
+        return chunkTPDMBDQX_cjs.failure(errorMessage);
       }
     }
   };
@@ -78,5 +78,5 @@ function createWebSearchTool(config) {
 
 exports.createWebSearchTool = createWebSearchTool;
 exports.webSearchTool = webSearchTool;
-//# sourceMappingURL=chunk-MDS23G2S.cjs.map
-//# sourceMappingURL=chunk-MDS23G2S.cjs.map
+//# sourceMappingURL=chunk-Y2A6AMGO.cjs.map
+//# sourceMappingURL=chunk-Y2A6AMGO.cjs.map

package/dist/{chunk-MDS23G2S.cjs.map → chunk-Y2A6AMGO.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/tools/builtin/webSearch.ts"],"names":["tool","formatSearchResultsForAI","executeWebSearch","summarizeSearchResults","failure"],"mappings":";;;;;;AAoDO,IAAM,gBAAgBA,sBAAA,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,OAAOC,2CAAyB,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,MAAMC,kCAAA;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,GAAYD,2CAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAASE,yCAAuB,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,OAAOC,0BAAQ,YAAY,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-MDS23G2S.cjs","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":["tool","formatSearchResultsForAI","executeWebSearch","summarizeSearchResults","failure"],"mappings":";;;;;;AAoDO,IAAM,gBAAgBA,sBAAA,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,OAAOC,2CAAyB,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,MAAMC,kCAAA;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,GAAYD,2CAAyB,QAAQ,CAAA;AAEnD,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,IAAA;AAAA,UACT,OAAA,EAASE,yCAAuB,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,OAAOC,0BAAQ,YAAY,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-Y2A6AMGO.cjs","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-WZ2TOZ7M.js → chunk-YLZCTR4O.js}

@@ -1,5 +1,5 @@
-import { webSearchTool } from './chunk-RKGRQRZU.js';
-import { tool, failure, success } from './chunk-3AONOZLY.js';
+import { webSearchTool } from './chunk-533K2Z7C.js';
+import { tool, failure, success } from './chunk-AIVXGTWS.js';
 
 // src/core/tools/screenshot.ts
 var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
@@ -1692,6 +1692,12 @@ function getZodEnumValues(schema) {
 }
 function zodToJsonSchema(schema) {
   const result = _zodToJsonSchemaInternal(schema);
+  if (!result.type && (result.oneOf || result.anyOf)) {
+    return {
+      type: "object",
+      ...result.oneOf ? { oneOf: result.oneOf } : { anyOf: result.anyOf }
+    };
+  }
   return result;
 }
 function _zodToJsonSchemaInternal(schema) {
@@ -1800,6 +1806,28 @@ function _zodToJsonSchemaInternal(schema) {
       }
       return { type: "string", description };
     }
+    case "ZodDiscriminatedUnion": {
+      const obj = schema;
+      let options;
+      if ("_zod" in obj) {
+        const zod = obj._zod;
+        const def = zod.def;
+        const raw = def?.options;
+        options = raw instanceof Map ? Array.from(raw.values()) : raw;
+      }
+      if (!options) {
+        const def = obj._def;
+        const raw = def?.options;
+        options = raw instanceof Map ? Array.from(raw.values()) : raw;
+      }
+      if (options && options.length > 0) {
+        const oneOf = options.map((opt) => _zodToJsonSchemaInternal(opt));
+        const result2 = { oneOf };
+        if (description) result2.description = description;
+        return result2;
+      }
+      return { type: "object", description };
+    }
     case "ZodUnion": {
       const obj = schema;
       let options;
@@ -1813,7 +1841,10 @@ function _zodToJsonSchemaInternal(schema) {
         options = def?.options;
       }
       if (options && options.length > 0) {
-        return _zodToJsonSchemaInternal(options[0]);
+        const oneOf = options.map((opt) => _zodToJsonSchemaInternal(opt));
+        const result2 = { oneOf };
+        if (description) result2.description = description;
+        return result2;
       }
       return { type: "string", description };
     }
@@ -2112,6 +2143,7 @@ function serializeThread(thread) {
     createdAt: thread.createdAt.toISOString(),
     updatedAt: thread.updatedAt.toISOString(),
     sources: thread.sources || [],
+    activeLeafId: thread.activeLeafId,
     messages: thread.messages.map((m) => ({
       id: m.id,
       role: m.role,
@@ -2119,7 +2151,9 @@ function serializeThread(thread) {
       created_at: m.created_at instanceof Date ? m.created_at.toISOString() : m.created_at,
       tool_calls: m.tool_calls,
       tool_call_id: m.tool_call_id,
-      metadata: m.metadata
+      metadata: m.metadata,
+      parent_id: m.parent_id,
+      children_ids: m.children_ids
     }))
   };
 }
@@ -2132,6 +2166,7 @@ function deserializeThread(data) {
     createdAt: new Date(data.createdAt),
     updatedAt: new Date(data.updatedAt),
     sources: data.sources || [],
+    activeLeafId: data.activeLeafId,
     messages: (data.messages || []).map((m) => ({
       id: m.id,
       role: m.role,
@@ -2139,7 +2174,9 @@ function deserializeThread(data) {
       created_at: new Date(m.created_at),
       tool_calls: m.tool_calls,
       tool_call_id: m.tool_call_id,
-      metadata: m.metadata
+      metadata: m.metadata,
+      parent_id: m.parent_id,
+      children_ids: m.children_ids
     }))
   };
 }
@@ -2179,9 +2216,25 @@ function writeStore(storageKey, store) {
     localStorage.setItem(storageKey, serialized);
   } catch (e) {
     if (e instanceof DOMException && e.name === "QuotaExceededError") {
-      console.error(
-        "[CopilotSDK] localStorage quota exceeded. Consider clearing old threads."
-      );
+      if (store.threads.length > 1) {
+        const evicted = [...store.threads].sort(
+          (a, b) => new Date(a.updatedAt).getTime() - new Date(b.updatedAt).getTime()
+        );
+        const trimmed = { ...store, threads: evicted.slice(1) };
+        console.warn(
+          "[CopilotSDK] localStorage quota exceeded \u2014 evicting oldest thread:",
+          evicted[0].id
+        );
+        try {
+          localStorage.setItem(storageKey, JSON.stringify(trimmed));
+        } catch {
+          console.error("[CopilotSDK] localStorage still full after eviction.");
+        }
+      } else {
+        console.error(
+          "[CopilotSDK] localStorage quota exceeded and only one thread remains. Cannot evict."
+        );
+      }
     } else {
       console.warn("[CopilotSDK] Failed to write store:", e);
     }
@@ -2623,7 +2676,8 @@ var ThreadManager = class {
       preview: options?.messages?.[0]?.content ? generatePreview(
         typeof options.messages[0].content === "string" ? options.messages[0].content : ""
       ) : void 0,
-      messageCount: options?.messages?.length ?? 0
+      messageCount: options?.messages?.length ?? 0,
+      activeLeafId: options?.activeLeafId
     };
     const asyncAdapter = this.adapter;
     if (asyncAdapter.createThread) {
@@ -2866,5 +2920,5 @@ function createThreadManager(config, callbacks) {
 }
 
 export { CLOUD_MAX_FILE_SIZE, DEFAULT_YOURGPT_ENDPOINT, SimpleThreadManagerState, ThreadManager, actionToTool, builtinTools, captureCurrentLogs, captureScreenshot, clearConsoleLogs, clearNetworkRequests, consoleLogsTool, createAssistantMessage, createCloudStorage, createConsoleLogsTool, createCustomDetector, createLocalStorageAdapter, createLogger, createMemoryAdapter, createMessage, createNetworkRequestsTool, createSSEStream, createScreenshotTool, createServerAdapter, createThreadManager, createToolCall, createToolMessage, createUserMessage, defaultSystemMessage, defineClientTool, defineServerTool, defineTool, detectIntent, formatLogsForAI, formatRequestsForAI, formatSSE, generateId, generateMessageId, generateSuggestionReason, generateThreadId, generateThreadTitle, generateToolCallId, getAttachmentTypeFromMime, getConsoleErrors, getConsoleLogs, getConsoleWarnings, getFailedRequests, getNetworkRequests, getPrimaryTool, hasToolCalls, hasToolSuggestions, isConsoleCaptureActive, isNetworkCaptureActive, isScreenshotSupported, isToolResult, localStorageAdapter, logOnce, networkRequestsTool, noopAdapter, parseSSELine, parseStreamEvent, parseToolCallArgs, processFileToAttachment, resizeScreenshot, screenshotTool, serializeStreamEvent, startConsoleCapture, startNetworkCapture, stopConsoleCapture, stopNetworkCapture, streamSSE, zodObjectToInputSchema, zodToJsonSchema };
-//# sourceMappingURL=chunk-WZ2TOZ7M.js.map
-//# sourceMappingURL=chunk-WZ2TOZ7M.js.map
+//# sourceMappingURL=chunk-YLZCTR4O.js.map
+//# sourceMappingURL=chunk-YLZCTR4O.js.map