@yourgpt/copilot-sdk 0.1.0 → 1.0.0

package/dist/{thread-C2FjuGLb.d.ts → types-BtAaOV07.d.ts}

@@ -1,212 +1,3 @@
-/**
- * Tool types for App Context Awareness
- */
-interface ScreenshotOptions {
-    /** Target element to capture (defaults to document.body) */
-    element?: HTMLElement;
-    /** Image quality (0.1-1.0, default 0.8) */
-    quality?: number;
-    /** Image format */
-    format?: "png" | "jpeg" | "webp";
-    /** Max width to scale down to */
-    maxWidth?: number;
-    /** Max height to scale down to */
-    maxHeight?: number;
-    /** Whether to include cursor */
-    includeCursor?: boolean;
-}
-interface ScreenshotResult {
-    /** Base64-encoded image data */
-    data: string;
-    /** Image format */
-    format: "png" | "jpeg" | "webp";
-    /** Image width */
-    width: number;
-    /** Image height */
-    height: number;
-    /** Timestamp of capture */
-    timestamp: number;
-}
-type ConsoleLogType = "log" | "info" | "warn" | "error" | "debug";
-interface ConsoleLogEntry {
-    /** Type of console method */
-    type: ConsoleLogType;
-    /** Log message(s) */
-    message: string;
-    /** Additional arguments passed to console */
-    args?: unknown[];
-    /** Stack trace (for errors) */
-    stack?: string;
-    /** Timestamp */
-    timestamp: number;
-}
-interface ConsoleLogOptions {
-    /** Types of logs to capture */
-    types?: ConsoleLogType[];
-    /** Maximum number of logs to store */
-    limit?: number;
-    /** Filter function */
-    filter?: (entry: ConsoleLogEntry) => boolean;
-}
-interface ConsoleLogResult {
-    /** Captured log entries */
-    logs: ConsoleLogEntry[];
-    /** Total logs captured (before limit) */
-    totalCaptured: number;
-}
-type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
-interface NetworkRequestEntry {
-    /** Request URL */
-    url: string;
-    /** HTTP method */
-    method: HttpMethod;
-    /** Response status code */
-    status: number;
-    /** Status text */
-    statusText: string;
-    /** Whether request failed (non-2xx or error) */
-    failed: boolean;
-    /** Request headers (sanitized) */
-    requestHeaders?: Record<string, string>;
-    /** Response headers (sanitized) */
-    responseHeaders?: Record<string, string>;
-    /** Request body (if captured) */
-    requestBody?: unknown;
-    /** Response body (if captured and failed) */
-    responseBody?: unknown;
-    /** Request duration in ms */
-    duration: number;
-    /** Timestamp of request start */
-    timestamp: number;
-    /** Error message if request failed */
-    error?: string;
-}
-interface NetworkRequestOptions {
-    /** Maximum number of requests to store */
-    limit?: number;
-    /** Only capture failed requests (default: true) */
-    failedOnly?: boolean;
-    /** HTTP methods to capture */
-    methods?: HttpMethod[];
-    /** URL patterns to include (regex) */
-    includeUrls?: RegExp[];
-    /** URL patterns to exclude (regex) */
-    excludeUrls?: RegExp[];
-    /** Whether to capture request body */
-    captureRequestBody?: boolean;
-    /** Whether to capture response body */
-    captureResponseBody?: boolean;
-    /** Max body size to capture (bytes) */
-    maxBodySize?: number;
-}
-interface NetworkRequestResult {
-    /** Captured network requests */
-    requests: NetworkRequestEntry[];
-    /** Total requests captured (before limit) */
-    totalCaptured: number;
-}
-type ToolType = "screenshot" | "console" | "network";
-interface IntentDetectionResult {
-    /** Detected tools that might be helpful */
-    suggestedTools: ToolType[];
-    /** Confidence score (0-1) for each tool */
-    confidence: Record<ToolType, number>;
-    /** Keywords that triggered detection */
-    matchedKeywords: Record<ToolType, string[]>;
-}
-interface ToolsConfig {
-    /** Enable screenshot capture */
-    screenshot?: boolean;
-    /** Enable console log capture */
-    console?: boolean;
-    /** Enable network request capture */
-    network?: boolean;
-    /** Always require user consent before capturing (default: true) */
-    requireConsent?: boolean;
-    /** Screenshot-specific options */
-    screenshotOptions?: ScreenshotOptions;
-    /** Console-specific options */
-    consoleOptions?: ConsoleLogOptions;
-    /** Network-specific options */
-    networkOptions?: NetworkRequestOptions;
-}
-interface ToolConsentRequest {
-    /** Tools being requested */
-    tools: ToolType[];
-    /** Reason for request (from intent detection) */
-    reason: string;
-    /** Keywords that triggered this request */
-    keywords: string[];
-}
-interface ToolConsentResponse {
-    /** Tools user approved */
-    approved: ToolType[];
-    /** Tools user denied */
-    denied: ToolType[];
-    /** Remember preference for session */
-    remember?: boolean;
-}
-interface CapturedContext {
-    /** Screenshot data (if captured) */
-    screenshot?: ScreenshotResult;
-    /** Console logs (if captured) */
-    consoleLogs?: ConsoleLogResult;
-    /** Network requests (if captured) */
-    networkRequests?: NetworkRequestResult;
-    /** Timestamp of capture */
-    timestamp: number;
-}
-
-/**
- * Intent Detector
- *
- * Detects user intent from messages to suggest relevant tools.
- * Framework-agnostic implementation using keyword matching.
- */
-
-/**
- * Detect user intent from a message
- *
- * @param message - User message to analyze
- * @returns Detection result with suggested tools
- *
- * @example
- * ```typescript
- * const result = detectIntent("I'm seeing an error on my screen");
- * // Returns:
- * // {
- * //   suggestedTools: ['screenshot', 'console'],
- * //   confidence: { screenshot: 0.6, console: 0.8, network: 0 },
- * //   matchedKeywords: { screenshot: ['seeing', 'screen'], console: ['error'] }
- * // }
- * ```
- */
-declare function detectIntent(message: string): IntentDetectionResult;
-/**
- * Check if a message suggests any tools
- */
-declare function hasToolSuggestions(message: string): boolean;
-/**
- * Get the primary suggested tool (highest confidence)
- */
-declare function getPrimaryTool(message: string): ToolType | null;
-/**
- * Generate a reason string for why tools are being suggested
- */
-declare function generateSuggestionReason(result: IntentDetectionResult): string;
-/**
- * Custom keyword configuration
- */
-interface CustomKeywords {
-    screenshot?: string[];
-    console?: string[];
-    network?: string[];
-}
-/**
- * Create a custom intent detector with additional keywords
- */
-declare function createCustomDetector(customKeywords: CustomKeywords): (message: string) => IntentDetectionResult;
-
 /**
  * Tool-related types for the agentic loop
  */
@@ -297,6 +88,23 @@ interface ToolContext {
         /** Request headers */
         headers?: Record<string, string>;
     };
+    /**
+     * Data passed from user's approval action.
+     * Only present when tool has `needsApproval: true` and user approved with extra data.
+     *
+     * @example
+     * ```typescript
+     * // In render function:
+     * approval.onApprove({ supervisor: selectedSupervisor });
+     *
+     * // In handler:
+     * handler: async (params, context) => {
+     *   const supervisor = context?.approvalData?.supervisor;
+     *   await assignToSupervisor(params.ticketId, supervisor);
+     * }
+     * ```
+     */
+    approvalData?: Record<string, unknown>;
 }
 /**
  * AI response behavior for tool results.
@@ -368,17 +176,79 @@ interface ToolResponse<T = unknown> {
     _aiContent?: AIContent[];
 }
 /**
- * Props passed to tool render function
+ * Approval callbacks passed to render when tool requires user action.
+ * Only present when status is "approval-required".
+ */
+interface ToolApprovalCallbacks {
+    /**
+     * Approve execution and optionally pass extra data to the handler.
+     * The extraData is available in handler via `context.approvalData`.
+     *
+     * @example
+     * ```tsx
+     * // Simple approval
+     * approval.onApprove();
+     *
+     * // Approval with data (e.g., user selection)
+     * approval.onApprove({ supervisor: { name: "John", role: "Manager" } });
+     * ```
+     */
+    onApprove: (extraData?: Record<string, unknown>) => void;
+    /**
+     * Reject the tool execution with optional reason.
+     * This stops the tool from executing and returns an error to AI.
+     */
+    onReject: (reason?: string) => void;
+    /** Custom message from tool's approvalMessage config */
+    message?: string;
+}
+/**
+ * Props passed to tool render function.
+ *
+ * The render function is called for every status change, enabling
+ * full lifecycle rendering similar to Vercel AI SDK.
+ *
+ * @example
+ * ```tsx
+ * render: ({ status, args, approval, result }) => {
+ *   if (status === "approval-required" && approval) {
+ *     return <ApprovalCard onConfirm={() => approval.onApprove()} />;
+ *   }
+ *   if (status === "executing") {
+ *     return <LoadingSkeleton />;
+ *   }
+ *   if (status === "completed") {
+ *     return <ResultCard data={result.data} />;
+ *   }
+ *   return null;
+ * }
+ * ```
  */
 interface ToolRenderProps<TParams = Record<string, unknown>> {
-    /** Current execution status */
-    status: "pending" | "executing" | "completed" | "error";
+    /**
+     * Current execution status:
+     * - `pending`: Tool call received, waiting to start
+     * - `approval-required`: Waiting for user approval (when needsApproval is set)
+     * - `executing`: Handler is running
+     * - `completed`: Handler finished successfully
+     * - `error`: Handler failed
+     */
+    status: "pending" | "approval-required" | "executing" | "completed" | "error";
     /** Arguments passed to the tool */
     args: TParams;
     /** Result if completed */
     result?: ToolResponse;
     /** Error if failed */
     error?: string;
+    /** Tool call ID */
+    toolCallId: string;
+    /** Tool name */
+    toolName: string;
+    /**
+     * Approval callbacks - only present when status is "approval-required".
+     * Use these to create custom approval UIs that can pass extra data to the handler.
+     */
+    approval?: ToolApprovalCallbacks;
 }
 /**
  * Tool definition with JSON Schema
@@ -910,269 +780,6 @@ declare function hasToolCalls(message: Message): boolean;
  */
 declare function isToolResult(message: Message): boolean;
 
-/**
- * Supported LLM providers
- */
-type LLMProvider = "openai" | "anthropic" | "google" | "groq" | "ollama" | "custom";
-/**
- * LLM configuration
- */
-interface LLMConfig {
-    /** LLM provider */
-    provider: LLMProvider;
-    /** Model name (e.g., 'gpt-4o', 'claude-3-5-sonnet-latest') */
-    model?: string;
-    /** API key for the provider */
-    apiKey?: string;
-    /** Base URL for custom/self-hosted models */
-    baseUrl?: string;
-    /** Temperature (0-2) */
-    temperature?: number;
-    /** Maximum tokens in response */
-    maxTokens?: number;
-    /** Top P sampling */
-    topP?: number;
-    /** Frequency penalty */
-    frequencyPenalty?: number;
-    /** Presence penalty */
-    presencePenalty?: number;
-    /** Enable streaming responses (default: true) */
-    streaming?: boolean;
-}
-/**
- * Cloud configuration (for managed hosting)
- */
-interface CloudConfig {
-    /** API key */
-    apiKey: string;
-    /** Bot ID */
-    botId: string;
-    /** Custom API endpoint (optional) */
-    endpoint?: string;
-}
-/**
- * Extension configuration
- */
-interface Extension {
-    /** Extension name */
-    name: string;
-    /** Extension configuration */
-    config: Record<string, unknown>;
-    /** Initialize the extension */
-    init?: () => Promise<void>;
-}
-/**
- * Main SDK configuration
- */
-interface CopilotConfig {
-    /** LLM configuration (for self-hosted) */
-    config?: LLMConfig;
-    /** Cloud configuration (for managed hosting) */
-    cloud?: CloudConfig;
-    /** Runtime URL for self-hosted backend */
-    runtimeUrl?: string;
-    /** System prompt */
-    systemPrompt?: string;
-    /** Extensions (like knowledge base) */
-    extensions?: Extension[];
-    /** Enable debug logging */
-    debug?: boolean;
-}
-/**
- * Default LLM configurations per provider
- */
-declare const DEFAULT_MODELS: Record<LLMProvider, string>;
-/**
- * Get default model for a provider
- */
-declare function getDefaultModel(provider: LLMProvider): string;
-
-/**
- * Parameter types for actions
- */
-type ParameterType = "string" | "number" | "boolean" | "object" | "array";
-/**
- * Action parameter definition
- */
-interface ActionParameter {
-    /** Parameter type */
-    type: ParameterType;
-    /** Description of the parameter */
-    description?: string;
-    /** Whether the parameter is required */
-    required?: boolean;
-    /** Default value */
-    default?: unknown;
-    /** Enum values for string type */
-    enum?: string[];
-    /** Properties for object type */
-    properties?: Record<string, ActionParameter>;
-    /** Items schema for array type */
-    items?: ActionParameter;
-}
-/**
- * Action definition
- */
-interface ActionDefinition<TParams = Record<string, unknown>> {
-    /** Unique name for the action */
-    name: string;
-    /** Description of what the action does */
-    description: string;
-    /** Parameter definitions */
-    parameters?: Record<string, ActionParameter>;
-    /** Handler function */
-    handler: (params: TParams) => unknown | Promise<unknown>;
-    /** Optional render function for UI */
-    render?: (props: ActionRenderProps<TParams>) => unknown;
-}
-/**
- * Props passed to action render function
- */
-interface ActionRenderProps<TParams = Record<string, unknown>> {
-    /** Current status */
-    status: "pending" | "executing" | "completed" | "error";
-    /** Arguments passed to the action */
-    args: TParams;
-    /** Result if completed */
-    result?: unknown;
-    /** Error if failed */
-    error?: string;
-}
-/**
- * Convert action definition to OpenAI tool format
- */
-declare function actionToTool(action: ActionDefinition): object;
-
-/**
- * Knowledge Base Types
- *
- * Configuration and types for Knowledge Base (RAG) integration.
- * Currently a placeholder - full implementation coming soon.
- */
-/**
- * Supported vector database providers
- */
-type KnowledgeBaseProvider = "pinecone" | "qdrant" | "chroma" | "supabase" | "weaviate" | "custom";
-/**
- * Knowledge Base configuration
- */
-interface KnowledgeBaseConfig {
-    /** Unique identifier for this knowledge base */
-    id: string;
-    /** Display name */
-    name?: string;
-    /** Vector database provider */
-    provider: KnowledgeBaseProvider;
-    /** API key for the vector database */
-    apiKey?: string;
-    /** Index/collection name */
-    index?: string;
-    /** Namespace within the index */
-    namespace?: string;
-    /** Custom endpoint URL (for self-hosted or custom providers) */
-    endpoint?: string;
-    /** Number of results to return (default: 5) */
-    topK?: number;
-    /** Minimum similarity score threshold (0-1) */
-    scoreThreshold?: number;
-    /** Whether to include source metadata in results */
-    includeMetadata?: boolean;
-}
-/**
- * Knowledge Base search result
- */
-interface KnowledgeBaseResult {
-    /** Result content/text */
-    content: string;
-    /** Similarity score (0-1) */
-    score: number;
-    /** Source metadata */
-    metadata?: {
-        /** Source document/URL */
-        source?: string;
-        /** Document title */
-        title?: string;
-        /** Page number (for PDFs) */
-        page?: number;
-        /** Chunk index */
-        chunk?: number;
-        /** Any additional metadata */
-        [key: string]: unknown;
-    };
-}
-/**
- * Knowledge Base search request
- */
-interface KnowledgeBaseSearchRequest {
-    /** Search query */
-    query: string;
-    /** Knowledge base ID to search */
-    knowledgeBaseId: string;
-    /** Number of results (overrides config) */
-    limit?: number;
-    /** Filter by metadata */
-    filter?: Record<string, unknown>;
-}
-/**
- * Knowledge Base search response
- */
-interface KnowledgeBaseSearchResponse {
-    /** Search results */
-    results: KnowledgeBaseResult[];
-    /** Knowledge base ID */
-    knowledgeBaseId: string;
-    /** Query that was searched */
-    query: string;
-    /** Search duration in ms */
-    durationMs?: number;
-}
-/**
- * Internal Knowledge Base configuration
- * Used for managed cloud searchIndexDocument API
- */
-interface InternalKnowledgeBaseConfig {
-    /** Project UID for the knowledge base */
-    projectUid: string;
-    /** Auth token for API calls */
-    token: string;
-    /** App ID (default: "1") */
-    appId?: string;
-    /** Results limit (default: 5) */
-    limit?: number;
-    /** Whether KB is enabled (default: true) */
-    enabled?: boolean;
-}
-/**
- * Internal Knowledge Base search result
- */
-interface InternalKnowledgeBaseResult {
-    /** Document ID */
-    id: string;
-    /** Document title */
-    title?: string;
-    /** Matched content snippet */
-    content: string;
-    /** Relevance score */
-    score?: number;
-    /** Source URL if available */
-    url?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Internal Knowledge Base search response
- */
-interface InternalKnowledgeBaseSearchResponse {
-    /** Whether the search was successful */
-    success: boolean;
-    /** Search results */
-    results: InternalKnowledgeBaseResult[];
-    /** Total number of results */
-    total?: number;
-    /** Error message if failed */
-    error?: string;
-}
-
 /**
  * Thread metadata (for listing threads)
  */
@@ -1181,6 +788,10 @@ interface Thread {
     id: string;
     /** Thread title (auto-generated from first message or manual) */
     title?: string;
+    /** Preview of the first message (for thread lists) */
+    preview?: string;
+    /** Number of messages in this thread */
+    messageCount?: number;
     /** When thread was created */
     createdAt: Date;
     /** When thread was last updated */
@@ -1198,7 +809,7 @@ interface ThreadData extends Thread {
 /**
  * Persistence storage interface for custom adapters
  */
-interface ThreadStorageAdapter {
+interface ThreadStorageAdapter$1 {
     /** Save threads to storage */
     save: (threads: ThreadData[]) => Promise<void>;
     /** Load threads from storage */
@@ -1215,11 +826,136 @@ interface PersistenceConfig {
     /** Storage type */
     storage?: "localStorage" | "custom";
     /** Custom storage adapter (required if storage is 'custom') */
-    customStorage?: ThreadStorageAdapter;
+    customStorage?: ThreadStorageAdapter$1;
 }
 /**
  * Generate a thread title from message content
  */
 declare function generateThreadTitle(content: string): string;
 
-export { type Thread as $, type ToolCall as A, type TokenUsage as B, type ConsoleLogOptions as C, type LLMConfig as D, type CloudConfig as E, type Extension as F, type CopilotConfig as G, type HttpMethod as H, type IntentDetectionResult as I, type JSONSchemaProperty as J, type ActionParameter as K, type LLMProvider as L, type MessageAttachment as M, type NetworkRequestOptions as N, type ActionDefinition as O, type ParameterType as P, type ActionRenderProps as Q, type KnowledgeBaseProvider as R, type ScreenshotOptions as S, type ToolDefinition as T, type KnowledgeBaseConfig as U, type KnowledgeBaseResult as V, type KnowledgeBaseSearchRequest as W, type KnowledgeBaseSearchResponse as X, type InternalKnowledgeBaseConfig as Y, type InternalKnowledgeBaseResult as Z, type InternalKnowledgeBaseSearchResponse as _, type ScreenshotResult as a, type ThreadData as a0, type PersistenceConfig as a1, type ThreadStorageAdapter as a2, type AIProvider as a3, type ToolRenderProps as a4, type ToolConfig as a5, type ToolSet as a6, type UnifiedToolCall as a7, type UnifiedToolResult as a8, type ToolApprovalStatus as a9, failure as aA, type ToolExecution as aa, type AgentLoopConfig as ab, type AgentLoopState as ac, type AIResponseMode as ad, type AIContent as ae, type PermissionLevel as af, type ToolPermission as ag, type PermissionStorageConfig as ah, type PermissionStorageAdapter as ai, generateThreadTitle as aj, createMessage as ak, createUserMessage as al, createAssistantMessage as am, createToolMessage as an, createToolCall as ao, parseToolCallArgs as ap, hasToolCalls as aq, isToolResult as ar, actionToTool as as, getDefaultModel as at, DEFAULT_MODELS as au, tool as av, toolToOpenAIFormat as aw, toolToAnthropicFormat as ax, createToolResult as ay, success as az, type ConsoleLogResult as b, type ConsoleLogEntry as c, type NetworkRequestResult as d, type NetworkRequestEntry as e, type Source as f, type ToolExecutionStatus as g, type ToolResponse as h, type ToolInputSchema as i, type ToolLocation as j, type ToolContext as k, detectIntent as l, hasToolSuggestions as m, getPrimaryTool as n, generateSuggestionReason as o, createCustomDetector as p, type ConsoleLogType as q, type ToolType as r, type ToolsConfig as s, type ToolConsentRequest as t, type ToolConsentResponse as u, type CapturedContext as v, type CustomKeywords as w, type MessageRole as x, type Message as y, type MessageMetadata as z };
+/**
+ * Thread Storage Adapter Types
+ *
+ * Interfaces for thread persistence adapters.
+ */
+
+/**
+ * Basic thread storage adapter interface
+ * Used by ThreadManager for persistence
+ */
+interface ThreadStorageAdapter {
+    /** Save all threads to storage */
+    save: (threads: ThreadData[]) => Promise<void>;
+    /** Load all threads from storage */
+    load: () => Promise<ThreadData[]>;
+    /** Clear all threads from storage */
+    clear: () => Promise<void>;
+    /**
+     * Get the last active thread ID
+     * Optional - used for session persistence
+     */
+    getLastActiveThreadId?: () => Promise<string | null>;
+    /**
+     * Set the last active thread ID
+     * Optional - used for session persistence
+     */
+    setLastActiveThreadId?: (threadId: string | null) => Promise<void>;
+}
+/**
+ * Pagination options for listing threads
+ */
+interface ListThreadsOptions {
+    /** Maximum number of threads to return */
+    limit?: number;
+    /** Number of threads to skip */
+    offset?: number;
+    /** Sort order (default: updatedAt desc) */
+    orderBy?: "createdAt" | "updatedAt";
+    /** Sort direction */
+    orderDir?: "asc" | "desc";
+}
+/**
+ * Paginated response for thread listing
+ */
+interface ListThreadsResult {
+    /** Threads for current page */
+    threads: Thread[];
+    /** Total number of threads */
+    total: number;
+    /** Whether there are more threads */
+    hasMore: boolean;
+}
+/**
+ * Async thread storage adapter with optimized single-thread operations
+ *
+ * Use this interface when implementing database backends (Supabase, Firebase, etc.)
+ * These methods are optional - if not provided, ThreadManager falls back to
+ * full save/load operations.
+ *
+ * @example Supabase adapter
+ * ```typescript
+ * const supabaseAdapter: AsyncThreadStorageAdapter = {
+ *   save: async (threads) => { /* batch upsert *\/ },
+ *   load: async () => { /* select all *\/ },
+ *   clear: async () => { /* delete all *\/ },
+ *
+ *   // Optimized operations
+ *   getThread: async (id) => {
+ *     const { data } = await supabase
+ *       .from('threads')
+ *       .select('*, messages(*)')
+ *       .eq('id', id)
+ *       .single();
+ *     return data;
+ *   },
+ *   createThread: async (thread) => {
+ *     const { data } = await supabase.from('threads').insert(thread).select().single();
+ *     return data;
+ *   },
+ *   updateThread: async (id, updates) => {
+ *     const { data } = await supabase.from('threads').update(updates).eq('id', id).select().single();
+ *     return data;
+ *   },
+ *   deleteThread: async (id) => {
+ *     await supabase.from('threads').delete().eq('id', id);
+ *   },
+ *   listThreads: async ({ limit, offset }) => {
+ *     const { data, count } = await supabase
+ *       .from('threads')
+ *       .select('*', { count: 'exact' })
+ *       .order('updatedAt', { ascending: false })
+ *       .range(offset, offset + limit - 1);
+ *     return { threads: data, total: count, hasMore: (offset + limit) < count };
+ *   },
+ * };
+ * ```
+ */
+interface AsyncThreadStorageAdapter extends ThreadStorageAdapter {
+    /**
+     * Get a single thread by ID
+     * If provided, used instead of loading all threads
+     */
+    getThread?: (id: string) => Promise<ThreadData | null>;
+    /**
+     * Create a new thread
+     * If provided, used instead of saving all threads
+     */
+    createThread?: (thread: ThreadData) => Promise<ThreadData>;
+    /**
+     * Update an existing thread
+     * If provided, used instead of saving all threads
+     */
+    updateThread?: (id: string, updates: Partial<ThreadData>) => Promise<ThreadData>;
+    /**
+     * Delete a thread by ID
+     * If provided, used instead of saving all threads
+     */
+    deleteThread?: (id: string) => Promise<void>;
+    /**
+     * List threads with pagination
+     * If provided, used for efficient thread listing
+     */
+    listThreads?: (options?: ListThreadsOptions) => Promise<ListThreadsResult>;
+}
+
+export { type AIProvider as A, type PermissionStorageAdapter as B, generateThreadTitle as C, createMessage as D, createUserMessage as E, createAssistantMessage as F, createToolMessage as G, createToolCall as H, parseToolCallArgs as I, type JSONSchemaProperty as J, hasToolCalls as K, isToolResult as L, type MessageAttachment as M, tool as N, toolToOpenAIFormat as O, type PersistenceConfig as P, toolToAnthropicFormat as Q, createToolResult as R, type Source as S, type ToolDefinition as T, type UnifiedToolCall as U, success as V, failure as W, type AsyncThreadStorageAdapter as X, type ListThreadsOptions as Y, type ListThreadsResult as Z, type ThreadStorageAdapter as _, type ToolExecutionStatus as a, type ToolResponse as b, type ToolInputSchema as c, type ToolLocation as d, type ToolContext as e, type MessageRole as f, type Message as g, type MessageMetadata as h, type ToolCall as i, type TokenUsage as j, type Thread as k, type ThreadData as l, type ThreadStorageAdapter$1 as m, type ToolRenderProps as n, type ToolConfig as o, type ToolSet as p, type UnifiedToolResult as q, type ToolApprovalStatus as r, type ToolExecution as s, type AgentLoopConfig as t, type AgentLoopState as u, type AIResponseMode as v, type AIContent as w, type PermissionLevel as x, type ToolPermission as y, type PermissionStorageConfig as z };