@yourgpt/llm-sdk 2.1.4-alpha.1 → 2.1.4-alpha.3

package/dist/types-COAOEe_y.d.mts

@@ -1,1460 +0,0 @@
-import { z } from 'zod';
-
-/**
- * Core Types for @yourgpt/llm-sdk
- *
- * Modern, instance-based types following Vercel AI SDK patterns.
- */
-
-/**
- * A language model instance that can generate text.
- * This is what provider functions like `openai('gpt-4o')` return.
- */
-interface LanguageModel {
-    /** Provider identifier (e.g., 'openai', 'anthropic') */
-    readonly provider: string;
-    /** Model identifier (e.g., 'gpt-4o', 'claude-3-5-sonnet') */
-    readonly modelId: string;
-    /** Model capabilities for feature detection */
-    readonly capabilities: ModelCapabilities;
-    /**
-     * Generate a complete response (non-streaming)
-     * Used internally by generateText()
-     */
-    doGenerate(params: DoGenerateParams): Promise<DoGenerateResult>;
-    /**
-     * Stream a response
-     * Used internally by streamText()
-     */
-    doStream(params: DoGenerateParams): AsyncGenerator<StreamChunk>;
-}
-/**
- * Model capabilities for UI feature flags
- */
-interface ModelCapabilities {
-    /** Supports image inputs */
-    supportsVision: boolean;
-    /** Supports tool/function calling */
-    supportsTools: boolean;
-    /** Supports streaming responses */
-    supportsStreaming: boolean;
-    /** Supports JSON mode / structured output */
-    supportsJsonMode: boolean;
-    /** Supports extended thinking (Claude) */
-    supportsThinking: boolean;
-    /** Supports PDF document inputs */
-    supportsPDF: boolean;
-    /** Maximum context tokens */
-    maxTokens: number;
-    /** Supported image MIME types */
-    supportedImageTypes: string[];
-}
-/**
- * Default capabilities for unknown models
- */
-declare const DEFAULT_CAPABILITIES: ModelCapabilities;
-/**
- * Core message types for LLM conversations
- */
-type CoreMessage = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
-interface SystemMessage {
-    role: "system";
-    content: string;
-}
-interface UserMessage {
-    role: "user";
-    content: string | UserContentPart[];
-}
-interface AssistantMessage {
-    role: "assistant";
-    content: string | null;
-    toolCalls?: ToolCall$1[];
-}
-interface ToolMessage {
-    role: "tool";
-    toolCallId: string;
-    content: string;
-}
-/**
- * Content parts for multimodal user messages
- */
-type UserContentPart = TextPart | ImagePart | FilePart;
-interface TextPart {
-    type: "text";
-    text: string;
-}
-interface ImagePart {
-    type: "image";
-    /** Base64 data or URL */
-    image: string | Uint8Array;
-    /** MIME type (e.g., 'image/png') */
-    mimeType?: string;
-}
-interface FilePart {
-    type: "file";
-    /** Base64 data or URL */
-    data: string;
-    /** MIME type (e.g., 'application/pdf') */
-    mimeType: string;
-}
-/**
- * Tool definition with Zod schema support
- */
-interface Tool<TParams = unknown, TResult = unknown> {
-    /** Tool description for the LLM */
-    description: string;
-    /** Zod schema for parameters */
-    parameters: z.ZodType<TParams>;
-    /** Execute function */
-    execute: (params: TParams, context: ToolContext$1) => Promise<TResult>;
-    /**
-     * Hide this tool's execution from the chat UI.
-     * When true, tool calls and results won't be displayed to the user,
-     * but the tool will still execute normally.
-     * @default false
-     */
-    hidden?: boolean;
-}
-/**
- * Context passed to tool execute function
- */
-interface ToolContext$1 {
-    /** Abort signal for cancellation */
-    abortSignal?: AbortSignal;
-    /** Unique tool call ID */
-    toolCallId: string;
-    /** Optional: messages in conversation */
-    messages?: CoreMessage[];
-}
-/**
- * Tool call from LLM response
- */
-interface ToolCall$1 {
-    /** Unique ID for this tool call */
-    id: string;
-    /** Tool name */
-    name: string;
-    /** Parsed arguments */
-    args: Record<string, unknown>;
-}
-/**
- * Tool execution result
- */
-interface ToolResult {
-    /** Tool call ID this result corresponds to */
-    toolCallId: string;
-    /** Result data (will be JSON stringified for LLM) */
-    result: unknown;
-}
-/**
- * Parameters for model.doGenerate() and model.doStream()
- */
-interface DoGenerateParams {
-    /** Messages to send to LLM */
-    messages: CoreMessage[];
-    /** Tools available to the LLM (already formatted for provider) */
-    tools?: unknown[];
-    /** Temperature (0-2) */
-    temperature?: number;
-    /** Maximum tokens to generate */
-    maxTokens?: number;
-    /** Abort signal */
-    signal?: AbortSignal;
-}
-/**
- * Result from model.doGenerate()
- */
-interface DoGenerateResult {
-    /** Generated text content */
-    text: string;
-    /** Tool calls requested by the LLM */
-    toolCalls: ToolCall$1[];
-    /** Why generation stopped */
-    finishReason: FinishReason;
-    /** Token usage */
-    usage: TokenUsage;
-    /** Raw provider response (for debugging) */
-    rawResponse?: unknown;
-}
-/**
- * Finish reason for generation
- */
-type FinishReason = "stop" | "length" | "tool-calls" | "content-filter" | "error" | "unknown";
-/**
- * Token usage statistics
- */
-interface TokenUsage {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-}
-/**
- * Stream chunk from model.doStream()
- */
-type StreamChunk = TextDeltaChunk | ToolCallChunk | ToolResultChunk | FinishChunk | ErrorChunk;
-interface TextDeltaChunk {
-    type: "text-delta";
-    text: string;
-}
-interface ToolCallChunk {
-    type: "tool-call";
-    toolCall: ToolCall$1;
-}
-interface ToolResultChunk {
-    type: "tool-result";
-    toolCallId: string;
-    result: unknown;
-}
-interface FinishChunk {
-    type: "finish";
-    finishReason: FinishReason;
-    usage?: TokenUsage;
-}
-interface ErrorChunk {
-    type: "error";
-    error: Error;
-}
-/**
- * Parameters for generateText()
- */
-interface GenerateTextParams {
-    /** Language model to use */
-    model: LanguageModel;
-    /** Simple prompt (converted to user message) */
-    prompt?: string;
-    /** System prompt */
-    system?: string;
-    /** Full message history */
-    messages?: CoreMessage[];
-    /** Tools available to the LLM */
-    tools?: Record<string, Tool>;
-    /** Maximum agentic steps (tool call loops) */
-    maxSteps?: number;
-    /** Temperature (0-2) */
-    temperature?: number;
-    /** Maximum tokens to generate */
-    maxTokens?: number;
-    /** Abort signal */
-    signal?: AbortSignal;
-}
-/**
- * Result from generateText()
- */
-interface GenerateTextResult {
-    /** Final text output */
-    text: string;
-    /** Token usage */
-    usage: TokenUsage;
-    /** Why generation stopped */
-    finishReason: FinishReason;
-    /** All steps taken (for agentic workflows) */
-    steps: GenerateStep[];
-    /** All tool calls made across all steps */
-    toolCalls: ToolCall$1[];
-    /** All tool results across all steps */
-    toolResults: ToolResult[];
-    /** Final message list including tool interactions */
-    response: {
-        messages: CoreMessage[];
-    };
-}
-/**
- * A single step in the generation process
- */
-interface GenerateStep {
-    /** Text generated in this step */
-    text: string;
-    /** Tool calls made in this step */
-    toolCalls: ToolCall$1[];
-    /** Tool results from this step */
-    toolResults: ToolResult[];
-    /** Finish reason for this step */
-    finishReason: FinishReason;
-    /** Token usage for this step */
-    usage: TokenUsage;
-}
-/**
- * Parameters for streamText() - same as generateText
- */
-type StreamTextParams = GenerateTextParams;
-/**
- * Result from streamText()
- */
-interface StreamTextResult {
-    /** Async iterable of text chunks only */
-    textStream: AsyncIterable<string>;
-    /** Async iterable of all stream parts */
-    fullStream: AsyncIterable<StreamPart>;
-    /** Promise that resolves to full text when complete */
-    readonly text: Promise<string>;
-    /** Promise that resolves to usage when complete */
-    readonly usage: Promise<TokenUsage>;
-    /** Promise that resolves to finish reason when complete */
-    readonly finishReason: Promise<FinishReason>;
-    /** Convert to plain text streaming Response */
-    toTextStreamResponse(options?: ResponseOptions): Response;
-    /** Convert to data stream Response (SSE with tool calls) */
-    toDataStreamResponse(options?: ResponseOptions): Response;
-}
-/**
- * Stream part for fullStream
- */
-type StreamPart = {
-    type: "text-delta";
-    text: string;
-} | {
-    type: "tool-call-start";
-    toolCallId: string;
-    toolName: string;
-} | {
-    type: "tool-call-delta";
-    toolCallId: string;
-    argsText: string;
-} | {
-    type: "tool-call-complete";
-    toolCall: ToolCall$1;
-} | {
-    type: "tool-result";
-    toolCallId: string;
-    result: unknown;
-} | {
-    type: "step-start";
-    step: number;
-} | {
-    type: "step-finish";
-    step: number;
-    finishReason: FinishReason;
-} | {
-    type: "finish";
-    finishReason: FinishReason;
-    usage: TokenUsage;
-} | {
-    type: "error";
-    error: Error;
-};
-/**
- * Options for Response helpers
- */
-interface ResponseOptions {
-    /** Additional headers */
-    headers?: Record<string, string>;
-    /** Response status (default: 200) */
-    status?: number;
-}
-
-/**
- * Stream event types for llm-sdk
- * These types are used internally by the SDK for streaming responses
- */
-/**
- * Stream event types
- */
-type StreamEventType = "message:start" | "message:delta" | "message:end" | "thinking:start" | "thinking:delta" | "thinking:end" | "action:start" | "action:args" | "action:end" | "tool_calls" | "tool:result" | "citation" | "loop:iteration" | "loop:complete" | "error" | "done";
-/**
- * Base event interface
- */
-interface BaseEvent {
-    type: StreamEventType;
-}
-/**
- * Message started streaming
- */
-interface MessageStartEvent extends BaseEvent {
-    type: "message:start";
-    id: string;
-}
-/**
- * Message content delta (incremental update)
- */
-interface MessageDeltaEvent extends BaseEvent {
-    type: "message:delta";
-    content: string;
-}
-/**
- * Message finished streaming
- */
-interface MessageEndEvent extends BaseEvent {
-    type: "message:end";
-}
-/**
- * Thinking/reasoning started (for models like Claude, DeepSeek)
- */
-interface ThinkingStartEvent extends BaseEvent {
-    type: "thinking:start";
-}
-/**
- * Thinking content delta
- */
-interface ThinkingDeltaEvent extends BaseEvent {
-    type: "thinking:delta";
-    content: string;
-}
-/**
- * Thinking finished
- */
-interface ThinkingEndEvent extends BaseEvent {
-    type: "thinking:end";
-}
-/**
- * Action/tool execution started
- */
-interface ActionStartEvent extends BaseEvent {
-    type: "action:start";
-    id: string;
-    name: string;
-    /** Whether this tool should be hidden from UI */
-    hidden?: boolean;
-}
-/**
- * Action arguments (streaming)
- */
-interface ActionArgsEvent extends BaseEvent {
-    type: "action:args";
-    id: string;
-    args: string;
-}
-/**
- * Action execution completed
- */
-interface ActionEndEvent extends BaseEvent {
-    type: "action:end";
-    id: string;
-    name?: string;
-    result?: unknown;
-    error?: string;
-}
-/**
- * Error event
- */
-interface ErrorEvent extends BaseEvent {
-    type: "error";
-    message: string;
-    code?: string;
-}
-/**
- * Tool call information
- */
-interface ToolCallInfo {
-    id: string;
-    name: string;
-    args: Record<string, unknown>;
-    /** Whether this tool should be hidden from UI */
-    hidden?: boolean;
-}
-/**
- * Assistant message with tool calls
- */
-interface AssistantToolMessage {
-    role: "assistant";
-    content: string | null;
-    tool_calls: Array<{
-        id: string;
-        type: "function";
-        function: {
-            name: string;
-            arguments: string;
-        };
-    }>;
-}
-/**
- * Tool calls event - client should execute and send results
- */
-interface ToolCallsEvent extends BaseEvent {
-    type: "tool_calls";
-    toolCalls: ToolCallInfo[];
-    assistantMessage: AssistantToolMessage;
-}
-/**
- * Tool result event
- */
-interface ToolResultEvent extends BaseEvent {
-    type: "tool:result";
-    id: string;
-    name: string;
-    result: ToolResponse;
-}
-/**
- * Loop iteration event
- */
-interface LoopIterationEvent extends BaseEvent {
-    type: "loop:iteration";
-    iteration: number;
-    maxIterations: number;
-}
-/**
- * Loop complete event
- */
-interface LoopCompleteEvent extends BaseEvent {
-    type: "loop:complete";
-    iterations: number;
-    aborted?: boolean;
-    maxIterationsReached?: boolean;
-}
-/**
- * Citation from web search (unified format for all providers)
- */
-interface Citation {
-    /** Unique citation index (1-based) */
-    index: number;
-    /** Source URL */
-    url: string;
-    /** Page title */
-    title: string;
-    /** Cited text snippet (optional) */
-    citedText?: string;
-    /** Source domain (extracted from URL) */
-    domain?: string;
-    /** Favicon URL (generated from domain) */
-    favicon?: string;
-}
-/**
- * Citation event - web search returned citations
- */
-interface CitationEvent extends BaseEvent {
-    type: "citation";
-    citations: Citation[];
-}
-/**
- * Message format for done event (API format with snake_case)
- */
-interface DoneEventMessage {
-    role: "assistant" | "tool";
-    content: string | null;
-    tool_calls?: Array<{
-        id: string;
-        type: "function";
-        function: {
-            name: string;
-            arguments: string;
-        };
-    }>;
-    tool_call_id?: string;
-}
-/**
- * Token usage (snake_case for API compatibility)
- */
-interface TokenUsageRaw {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens?: number;
-}
-/**
- * Stream completed
- */
-interface DoneEvent extends BaseEvent {
-    type: "done";
-    requiresAction?: boolean;
-    messages?: DoneEventMessage[];
-    /** Token usage (server-side only, stripped before sending to client) */
-    usage?: TokenUsageRaw;
-}
-/**
- * Union of all stream events
- */
-type StreamEvent = MessageStartEvent | MessageDeltaEvent | MessageEndEvent | ThinkingStartEvent | ThinkingDeltaEvent | ThinkingEndEvent | ActionStartEvent | ActionArgsEvent | ActionEndEvent | ToolCallsEvent | ToolResultEvent | CitationEvent | LoopIterationEvent | LoopCompleteEvent | ErrorEvent | DoneEvent;
-/**
- * LLM configuration
- */
-interface LLMConfig {
-    temperature?: number;
-    maxTokens?: number;
-}
-/**
- * Tool call format (OpenAI style)
- */
-interface ToolCall {
-    id: string;
-    type: "function";
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-/**
- * Message role
- */
-type MessageRole = "system" | "user" | "assistant" | "tool";
-/**
- * Message attachment
- */
-interface MessageAttachment {
-    type: "image" | "file" | "audio" | "video";
-    data?: string;
-    url?: string;
-    mimeType: string;
-    filename?: string;
-}
-/**
- * Message metadata
- */
-interface MessageMetadata {
-    thinking?: string;
-    attachments?: MessageAttachment[];
-    toolName?: string;
-    [key: string]: unknown;
-}
-/**
- * Message type (simplified for llm-sdk)
- */
-interface Message {
-    id: string;
-    thread_id?: string;
-    role: MessageRole;
-    content: string | null;
-    tool_calls?: ToolCall[];
-    tool_call_id?: string;
-    metadata?: MessageMetadata;
-    created_at?: Date;
-}
-/**
- * Action parameter definition
- */
-interface ActionParameter {
-    type: string;
-    description?: string;
-    required?: boolean;
-    enum?: string[];
-    items?: ActionParameter;
-    properties?: Record<string, ActionParameter>;
-}
-/**
- * Action definition for tool calling
- */
-interface ActionDefinition<TParams = Record<string, unknown>> {
-    name: string;
-    description: string;
-    parameters?: Record<string, ActionParameter>;
-    handler: (params: TParams) => unknown | Promise<unknown>;
-}
-/**
- * Tool location (server or client)
- */
-type ToolLocation = "server" | "client";
-/**
- * Tool execution status
- */
-type ToolExecutionStatus = "pending" | "executing" | "completed" | "error";
-/**
- * Tool response
- */
-interface ToolResponse<T = unknown> {
-    success: boolean;
-    data?: T;
-    error?: string;
-    /** Internal: AI response mode override */
-    _aiResponseMode?: AIResponseMode;
-    /** Internal: AI content for multimodal response (images, etc.) */
-    _aiContent?: AIContent[];
-    /** Internal: AI context string override */
-    _aiContext?: string;
-}
-/**
- * Tool context passed to handlers
- */
-interface ToolContext {
-    userId?: string;
-    threadId?: string;
-    [key: string]: unknown;
-}
-/**
- * AI response mode for tool results
- */
-type AIResponseMode = "none" | "brief" | "full";
-/**
- * AI content structure
- */
-interface AIContent {
-    type?: "text" | "image";
-    text?: string;
-    mediaType?: string;
-    data?: string;
-    summary?: string;
-    details?: string;
-}
-/**
- * JSON Schema for tool input
- */
-interface ToolInputSchema {
-    type: "object";
-    properties?: Record<string, unknown>;
-    required?: string[];
-}
-/**
- * Tool definition
- */
-interface ToolDefinition<TParams = Record<string, unknown>> {
-    name: string;
-    description: string;
-    location: ToolLocation;
-    /** Optional logical category for tool search and selective loading. */
-    category?: string;
-    /** Optional group label for related tools. */
-    group?: string;
-    title?: string | ((args: TParams) => string);
-    inputSchema?: ToolInputSchema;
-    handler?: (params: TParams, context?: ToolContext) => unknown | Promise<unknown>;
-    render?: (props: unknown) => unknown;
-    available?: boolean;
-    /**
-     * Hide this tool's execution from the chat UI.
-     * When true, tool calls and results won't be displayed to the user,
-     * but the tool will still execute normally.
-     * @default false
-     */
-    hidden?: boolean;
-    needsApproval?: boolean;
-    approvalMessage?: string | ((params: TParams) => string);
-    /** AI response mode for this tool (none, brief, full) */
-    aiResponseMode?: AIResponseMode;
-    /** AI context string or function to generate context */
-    aiContext?: string | ((result: ToolResponse, args: Record<string, unknown>) => string);
-    /** Hint that this tool should be loaded lazily when dynamic selection is active. */
-    deferLoading?: boolean;
-    /** Named profiles this tool belongs to (for example "coding" or "search"). */
-    profiles?: string[];
-    /** Extra keywords used by lightweight tool search/ranking. */
-    searchKeywords?: string[];
-}
-interface ToolProfile {
-    include?: string[];
-    exclude?: string[];
-}
-interface OpenAIToolSelectionHints {
-    /**
-     * "single" forces the selected tool when exactly one tool remains after selection.
-     * Otherwise the adapter falls back to automatic tool choice.
-     */
-    toolChoice?: "auto" | "required" | "single";
-    /** Set false to disable parallel tool calls on OpenAI-compatible providers. */
-    parallelToolCalls?: boolean;
-}
-interface AnthropicToolSelectionHints {
-    /**
-     * "single" forces the selected tool when exactly one tool remains after selection.
-     * Otherwise the adapter falls back to Anthropic's automatic tool choice.
-     */
-    toolChoice?: "auto" | "any" | "single";
-    /** Disable parallel tool use when supported by the Anthropic API. */
-    disableParallelToolUse?: boolean;
-}
-interface ToolNativeProviderHints {
-    openai?: OpenAIToolSelectionHints;
-    anthropic?: AnthropicToolSelectionHints;
-}
-interface OpenAIProviderToolOptions {
-    toolChoice?: "auto" | "required" | {
-        type: "function";
-        name: string;
-    };
-    parallelToolCalls?: boolean;
-    nativeToolSearch?: {
-        enabled: boolean;
-        useResponsesApi?: boolean;
-    };
-}
-interface AnthropicProviderToolOptions {
-    toolChoice?: "auto" | "any" | {
-        type: "tool";
-        name: string;
-    };
-    disableParallelToolUse?: boolean;
-    nativeToolSearch?: {
-        enabled: boolean;
-        variant: "bm25" | "regex";
-    };
-}
-interface ProviderToolRuntimeOptions {
-    openai?: OpenAIProviderToolOptions;
-    anthropic?: AnthropicProviderToolOptions;
-}
-/**
- * Web search configuration for native provider search
- *
- * Enables native web search for supported providers:
- * - Anthropic: Uses Claude's built-in web search tool
- * - OpenAI: Uses GPT's web search preview
- * - Google: Uses Gemini's Google Search grounding
- *
- * @example
- * ```typescript
- * const runtime = createRuntime({
- *   provider: createAnthropic({ apiKey: '...' }),
- *   model: 'claude-sonnet-4-20250514',
- *   webSearch: true, // Enable with defaults
- * });
- *
- * // Or with configuration
- * const runtime = createRuntime({
- *   provider: createOpenAI({ apiKey: '...' }),
- *   model: 'gpt-4o',
- *   webSearch: {
- *     maxUses: 5,
- *     allowedDomains: ['docs.anthropic.com', 'openai.com'],
- *   },
- * });
- * ```
- */
-interface WebSearchConfig {
-    /** Maximum number of search uses per request (default: unlimited) */
-    maxUses?: number;
-    /** Only search these domains (provider-specific support) */
-    allowedDomains?: string[];
-    /** Exclude these domains from search (provider-specific support) */
-    blockedDomains?: string[];
-    /** User location for localized results (Anthropic only) */
-    userLocation?: {
-        type: "approximate";
-        city?: string;
-        region?: string;
-        country?: string;
-        timezone?: string;
-    };
-}
-/**
- * Unified tool call format
- */
-interface UnifiedToolCall {
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-}
-/**
- * Unified tool result format
- */
-interface UnifiedToolResult {
-    toolCallId: string;
-    content: string;
-    success: boolean;
-    error?: string;
-}
-/**
- * Tool execution state
- */
-interface ToolExecution {
-    id: string;
-    name: string;
-    args: Record<string, unknown>;
-    status: ToolExecutionStatus;
-    result?: ToolResponse;
-}
-/**
- * Knowledge base provider
- */
-type KnowledgeBaseProvider = "pinecone" | "qdrant" | "weaviate" | "custom";
-/**
- * Knowledge base configuration
- */
-interface KnowledgeBaseConfig {
-    id: string;
-    name?: string;
-    provider: KnowledgeBaseProvider;
-    apiKey?: string;
-    index?: string;
-}
-
-/**
- * Request-level LLM configuration overrides
- */
-interface RequestLLMConfig {
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-}
-/**
- * Chat completion request
- */
-interface ChatCompletionRequest {
-    /** Conversation messages */
-    messages: Message[];
-    /**
-     * Raw provider-formatted messages (for agent loop with tool calls)
-     * When provided, these are used instead of converting from Message[]
-     * This allows passing messages with tool_calls and tool role
-     */
-    rawMessages?: Array<Record<string, unknown>>;
-    /** Available actions/tools */
-    actions?: ActionDefinition[];
-    /** Full tool definitions for provider-native tool search / deferred loading paths. */
-    toolDefinitions?: ToolDefinition[];
-    /** System prompt */
-    systemPrompt?: string;
-    /** LLM configuration overrides */
-    config?: RequestLLMConfig;
-    /** Abort signal for cancellation */
-    signal?: AbortSignal;
-    /**
-     * Enable native web search for the provider.
-     * When true or configured, the provider's native search is enabled.
-     */
-    webSearch?: boolean | WebSearchConfig;
-    /** Optional provider-specific tool policy hints derived from runtime selection. */
-    providerToolOptions?: ProviderToolRuntimeOptions;
-    /** Enable adapter-level provider payload logging. */
-    debug?: boolean;
-}
-/**
- * Non-streaming completion result
- */
-interface CompletionResult {
-    /** Text content */
-    content: string;
-    /** Tool calls */
-    toolCalls: Array<{
-        id: string;
-        name: string;
-        args: Record<string, unknown>;
-    }>;
-    /** Thinking content (if extended thinking enabled) */
-    thinking?: string;
-    /** Token usage for billing/tracking */
-    usage?: TokenUsage;
-    /** Raw provider response for debugging */
-    rawResponse: Record<string, unknown>;
-}
-/**
- * Base LLM adapter interface
- */
-interface LLMAdapter {
-    /** Provider name */
-    readonly provider: string;
-    /** Model name */
-    readonly model: string;
-    /**
-     * Stream a chat completion
-     */
-    stream(request: ChatCompletionRequest): AsyncGenerator<StreamEvent>;
-    /**
-     * Non-streaming chat completion (for debugging/comparison)
-     */
-    complete?(request: ChatCompletionRequest): Promise<CompletionResult>;
-}
-/**
- * Adapter factory function type
- */
-type AdapterFactory = (config: LLMConfig) => LLMAdapter;
-/**
- * Convert messages to provider format (simple text only)
- */
-declare function formatMessages(messages: Message[], systemPrompt?: string): Array<{
-    role: string;
-    content: string;
-}>;
-/**
- * Convert actions to OpenAI tool format
- */
-declare function formatTools(actions: ActionDefinition[]): Array<{
-    type: "function";
-    function: {
-        name: string;
-        description: string;
-        parameters: object;
-    };
-}>;
-/**
- * Content block types for multimodal messages
- */
-type AnthropicContentBlock = {
-    type: "text";
-    text: string;
-} | {
-    type: "image";
-    source: {
-        type: "base64";
-        media_type: string;
-        data: string;
-    } | {
-        type: "url";
-        url: string;
-    };
-} | {
-    type: "document";
-    source: {
-        type: "base64";
-        media_type: string;
-        data: string;
-    } | {
-        type: "url";
-        url: string;
-    };
-};
-type OpenAIContentBlock = {
-    type: "text";
-    text: string;
-} | {
-    type: "image_url";
-    image_url: {
-        url: string;
-        detail?: "low" | "high" | "auto";
-    };
-};
-/**
- * Check if a message has image attachments
- * Supports both new format (metadata.attachments) and legacy (attachments)
- */
-declare function hasImageAttachments(message: Message): boolean;
-/**
- * Check if a message has media attachments (images or PDFs)
- */
-declare function hasMediaAttachments(message: Message): boolean;
-/**
- * Convert MessageAttachment to Anthropic image content block
- *
- * Anthropic format:
- * {
- *   type: "image",
- *   source: {
- *     type: "base64",
- *     media_type: "image/png",
- *     data: "base64data..."
- *   }
- * }
- */
-declare function attachmentToAnthropicImage(attachment: MessageAttachment): AnthropicContentBlock | null;
-/**
- * Convert MessageAttachment to OpenAI image_url content block
- *
- * OpenAI format:
- * {
- *   type: "image_url",
- *   image_url: {
- *     url: "data:image/png;base64,..."
- *   }
- * }
- */
-declare function attachmentToOpenAIImage(attachment: MessageAttachment): OpenAIContentBlock | null;
-/**
- * Convert MessageAttachment (PDF) to Anthropic document content block
- *
- * Anthropic format:
- * {
- *   type: "document",
- *   source: {
- *     type: "base64",
- *     media_type: "application/pdf",
- *     data: "base64data..."
- *   }
- * }
- */
-declare function attachmentToAnthropicDocument(attachment: MessageAttachment): AnthropicContentBlock | null;
-/**
- * Convert a Message to Anthropic multimodal content blocks
- */
-declare function messageToAnthropicContent(message: Message): string | AnthropicContentBlock[];
-/**
- * Convert a Message to OpenAI multimodal content blocks
- */
-declare function messageToOpenAIContent(message: Message): string | OpenAIContentBlock[];
-/**
- * Anthropic content block types (extended for tools)
- */
-type AnthropicToolUseBlock = {
-    type: "tool_use";
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-};
-type AnthropicToolResultBlock = {
-    type: "tool_result";
-    tool_use_id: string;
-    content: string;
-};
-type AnthropicMessageContent = string | Array<AnthropicContentBlock | AnthropicToolUseBlock | AnthropicToolResultBlock>;
-/**
- * Format messages for Anthropic with full tool support
- * Handles: text, images, tool_use, and tool_result
- *
- * Key differences from OpenAI:
- * - tool_calls become tool_use blocks in assistant content
- * - tool results become tool_result blocks in user content
- */
-declare function formatMessagesForAnthropic(messages: Message[], systemPrompt?: string): {
-    system: string;
-    messages: Array<{
-        role: "user" | "assistant";
-        content: AnthropicMessageContent;
-    }>;
-};
-/**
- * OpenAI message format with tool support
- */
-type OpenAIMessage = {
-    role: "system";
-    content: string;
-} | {
-    role: "user";
-    content: string | OpenAIContentBlock[];
-} | {
-    role: "assistant";
-    content: string | null;
-    tool_calls?: Array<{
-        id: string;
-        type: "function";
-        function: {
-            name: string;
-            arguments: string;
-        };
-    }>;
-} | {
-    role: "tool";
-    content: string;
-    tool_call_id: string;
-};
-/**
- * Format messages for OpenAI with full tool support
- * Handles: text, images, tool_calls, and tool results
- */
-declare function formatMessagesForOpenAI(messages: Message[], systemPrompt?: string): OpenAIMessage[];
-
-/**
- * Provider Types
- *
- * Defines interfaces for:
- * 1. Provider Formatters (for tool transformations in agent loop)
- * 2. Multi-provider architecture (AIProvider, capabilities, configs)
- */
-
-/**
- * Provider formatter interface
- *
- * Each provider implements this interface to handle:
- * - Tool definition transformation
- * - Tool call parsing from responses
- * - Tool result formatting
- * - Stop reason detection
- */
-interface ProviderFormatter {
-    /**
-     * Transform unified tool definitions to provider format
-     */
-    transformTools(tools: ToolDefinition[]): unknown[];
-    /**
-     * Parse tool calls from provider response
-     */
-    parseToolCalls(response: unknown): UnifiedToolCall[];
-    /**
-     * Format tool results for provider
-     */
-    formatToolResults(results: UnifiedToolResult[]): unknown[];
-    /**
-     * Check if response indicates tool use is requested
-     */
-    isToolUseStop(response: unknown): boolean;
-    /**
-     * Check if response indicates end of turn
-     */
-    isEndTurnStop(response: unknown): boolean;
-    /**
-     * Get stop reason string from response
-     */
-    getStopReason(response: unknown): string;
-    /**
-     * Extract text content from response
-     */
-    extractTextContent(response: unknown): string;
-    /**
-     * Build assistant message with tool calls for conversation history
-     */
-    buildAssistantToolMessage(toolCalls: UnifiedToolCall[], textContent?: string): unknown;
-    /**
-     * Build user message with tool results for conversation history
-     */
-    buildToolResultMessage(results: UnifiedToolResult[]): unknown;
-}
-/**
- * Anthropic tool definition format
- */
-interface AnthropicTool {
-    name: string;
-    description: string;
-    input_schema: {
-        type: "object";
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-}
-/**
- * Anthropic tool_use block from response
- */
-interface AnthropicToolUse {
-    type: "tool_use";
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-}
-/**
- * Anthropic tool_result block
- */
-interface AnthropicToolResult {
-    type: "tool_result";
-    tool_use_id: string;
-    content: string;
-}
-/**
- * OpenAI tool definition format
- */
-interface OpenAITool {
-    type: "function";
-    function: {
-        name: string;
-        description: string;
-        parameters: {
-            type: "object";
-            properties: Record<string, unknown>;
-            required?: string[];
-        };
-    };
-}
-/**
- * OpenAI tool call from response
- */
-interface OpenAIToolCall {
-    id: string;
-    type: "function";
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-/**
- * OpenAI tool result message
- */
-interface OpenAIToolResult {
-    role: "tool";
-    tool_call_id: string;
-    content: string;
-}
-/**
- * Google Gemini function declaration
- */
-interface GeminiFunctionDeclaration {
-    name: string;
-    description: string;
-    parameters?: {
-        type: "object";
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-}
-/**
- * Gemini function call from response
- */
-interface GeminiFunctionCall {
-    name: string;
-    args: Record<string, unknown>;
-}
-/**
- * Gemini function response
- */
-interface GeminiFunctionResponse {
-    name: string;
-    response: Record<string, unknown>;
-}
-/**
- * Capabilities of a model for UI feature flags
- * UI components can use this to enable/disable features
- */
-interface ProviderCapabilities {
-    /** Supports image inputs */
-    supportsVision: boolean;
-    /** Supports tool/function calling */
-    supportsTools: boolean;
-    /** Supports extended thinking (Claude, DeepSeek) */
-    supportsThinking: boolean;
-    /** Supports streaming responses */
-    supportsStreaming: boolean;
-    /** Supports PDF document inputs */
-    supportsPDF: boolean;
-    /** Supports audio inputs */
-    supportsAudio: boolean;
-    /** Supports video inputs */
-    supportsVideo: boolean;
-    /** Maximum context tokens */
-    maxTokens: number;
-    /** Supported image MIME types */
-    supportedImageTypes: string[];
-    /** Supported audio MIME types */
-    supportedAudioTypes?: string[];
-    /** Supported video MIME types */
-    supportedVideoTypes?: string[];
-    /** Supports JSON mode / structured output */
-    supportsJsonMode?: boolean;
-    /** Supports system messages */
-    supportsSystemMessages?: boolean;
-}
-/**
- * AI Provider interface (object form)
- *
- * Wraps existing LLMAdapter with additional metadata:
- * - Supported models list
- * - Per-model capabilities
- * - Provider name
- */
-interface AIProviderObject {
-    /** Provider name (e.g., 'openai', 'anthropic') */
-    readonly name: string;
-    /** List of supported model IDs */
-    readonly supportedModels: string[];
-    /**
-     * Get a language model adapter for the given model ID
-     * Returns the existing LLMAdapter interface - no breaking changes
-     */
-    languageModel(modelId: string): LLMAdapter;
-    /**
-     * Get capabilities for a specific model
-     * UI components use this to enable/disable features
-     */
-    getCapabilities(modelId: string): ProviderCapabilities;
-    /**
-     * Optional: Get an embedding model (future expansion)
-     */
-    embeddingModel?(modelId: string): EmbeddingModel;
-}
-/**
- * Callable AI Provider (Vercel AI SDK style)
- *
- * A function that returns a LanguageModel when called with a model ID,
- * but also has properties for provider metadata and methods.
- *
- * @example
- * ```typescript
- * const openai = createOpenAI({ apiKey: '...' });
- *
- * // Callable - returns LanguageModel directly (Vercel AI SDK style)
- * const model = openai('gpt-4o');
- *
- * // Also supports method calls (backward compatible)
- * const model2 = openai.languageModel('gpt-4o');
- *
- * // Check capabilities
- * const caps = openai.getCapabilities('gpt-4o');
- * if (caps.supportsVision) {
- *   // Show image upload button
- * }
- * ```
- */
-interface AIProvider extends AIProviderObject {
-    /**
-     * Call the provider directly with a model ID to get a LanguageModel
-     * This is the Vercel AI SDK style pattern
-     */
-    (modelId: string): LLMAdapter;
-}
-/**
- * Embedding model interface (for future expansion)
- */
-interface EmbeddingModel {
-    readonly provider: string;
-    readonly modelId: string;
-    embed(texts: string[]): Promise<number[][]>;
-}
-/**
- * Base provider configuration
- */
-interface BaseProviderConfig {
-    /** API key (falls back to environment variable) */
-    apiKey?: string;
-    /** Custom base URL */
-    baseUrl?: string;
-    /** Request timeout in milliseconds */
-    timeout?: number;
-    /** Custom headers to include */
-    headers?: Record<string, string>;
-}
-/**
- * OpenAI provider configuration
- */
-interface OpenAIProviderConfig extends BaseProviderConfig {
-    /** OpenAI organization ID */
-    organization?: string;
-    /** OpenAI project ID */
-    project?: string;
-    /** Vision detail level for images */
-    imageDetail?: "auto" | "low" | "high";
-}
-/**
- * Anthropic provider configuration
- */
-interface AnthropicProviderConfig extends BaseProviderConfig {
-    /** Extended thinking budget in tokens (minimum 1024) */
-    thinkingBudget?: number;
-    /** Enable prompt caching */
-    cacheControl?: boolean;
-}
-/**
- * Google provider configuration
- */
-interface GoogleProviderConfig extends BaseProviderConfig {
-    /** Safety settings */
-    safetySettings?: GoogleSafetySetting[];
-    /** Grounding configuration (for web search) */
-    groundingConfig?: GoogleGroundingConfig;
-}
-/**
- * Google safety setting
- */
-interface GoogleSafetySetting {
-    category: "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_DANGEROUS_CONTENT";
-    threshold: "BLOCK_NONE" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_HIGH_AND_ABOVE";
-}
-/**
- * Google grounding configuration
- */
-interface GoogleGroundingConfig {
-    /** Enable Google Search grounding */
-    googleSearchRetrieval?: boolean;
-}
-/**
- * xAI provider configuration
- */
-interface XAIProviderConfig extends BaseProviderConfig {
-}
-/**
- * Azure OpenAI provider configuration
- */
-interface AzureProviderConfig extends BaseProviderConfig {
-    /** Azure resource name */
-    resourceName: string;
-    /** Deployment name */
-    deploymentName: string;
-    /** API version (default: 2024-02-15-preview) */
-    apiVersion?: string;
-}
-/**
- * Ollama model-specific options
- * These map to Ollama's native API options
- */
-interface OllamaModelOptions {
-    /** Context window size (default varies by model) */
-    num_ctx?: number;
-    /** Max tokens to predict (-1 = infinite, -2 = fill context) */
-    num_predict?: number;
-    /** Mirostat sampling (0 = disabled, 1 = Mirostat, 2 = Mirostat 2.0) */
-    mirostat?: 0 | 1 | 2;
-    /** Mirostat learning rate (default: 0.1) */
-    mirostat_eta?: number;
-    /** Mirostat target entropy (default: 5.0) */
-    mirostat_tau?: number;
-    /** Repeat penalty (default: 1.1) */
-    repeat_penalty?: number;
-    /** Random seed for reproducibility (-1 = random) */
-    seed?: number;
-    /** Top-k sampling (default: 40) */
-    top_k?: number;
-    /** Top-p (nucleus) sampling (default: 0.9) */
-    top_p?: number;
-    /** Min-p sampling (default: 0.0) */
-    min_p?: number;
-    /** Stop sequences */
-    stop?: string[];
-    /** Temperature override (also available in config) */
-    temperature?: number;
-}
-/**
- * Ollama provider configuration
- */
-interface OllamaProviderConfig extends BaseProviderConfig {
-    /** Default Ollama-specific model options */
-    options?: OllamaModelOptions;
-}
-
-export { type GoogleProviderConfig as $, type AIProvider as A, type ToolResultChunk as B, type CoreMessage as C, type DoneEventMessage as D, type FinishChunk as E, type FilePart as F, type GenerateTextParams as G, type ErrorChunk as H, type ImagePart as I, type TokenUsage as J, type KnowledgeBaseConfig as K, type LLMAdapter as L, type Message as M, type FinishReason as N, DEFAULT_CAPABILITIES as O, type ProviderToolRuntimeOptions as P, type ChatCompletionRequest as Q, type ResponseOptions as R, type StreamTextParams as S, type ToolContext$1 as T, type UserMessage as U, type AdapterFactory as V, type WebSearchConfig as W, type ProviderCapabilities as X, type BaseProviderConfig as Y, type OpenAIProviderConfig as Z, type AnthropicProviderConfig as _, type GenerateTextResult as a, type XAIProviderConfig as a0, type AzureProviderConfig as a1, type OllamaProviderConfig as a2, type OllamaModelOptions as a3, type ProviderFormatter as a4, type AnthropicTool as a5, type AnthropicToolUse as a6, type AnthropicToolResult as a7, type OpenAITool as a8, type OpenAIToolCall as a9, attachmentToOpenAIImage as aA, type AnthropicContentBlock as aB, type OpenAIContentBlock as aC, type OpenAIToolResult as aa, type GeminiFunctionDeclaration as ab, type GeminiFunctionCall as ac, type GeminiFunctionResponse as ad, type LLMConfig as ae, type ToolLocation as af, type UnifiedToolCall as ag, type UnifiedToolResult as ah, type ToolExecution as ai, type OpenAIToolSelectionHints as aj, type AnthropicToolSelectionHints as ak, type ToolNativeProviderHints as al, type OpenAIProviderToolOptions as am, type AnthropicProviderToolOptions as an, type Citation as ao, type CompletionResult as ap, formatMessages as aq, formatTools as ar, formatMessagesForAnthropic as as, formatMessagesForOpenAI as at, messageToAnthropicContent as au, messageToOpenAIContent as av, hasImageAttachments as aw, hasMediaAttachments as ax, attachmentToAnthropicImage as ay, attachmentToAnthropicDocument as az, type StreamTextResult as b, type Tool as c, type ActionDefinition as d, type ToolDefinition as e, type ToolProfile as f, type StreamEvent as g, type ToolCallInfo as h, type TokenUsageRaw as i, type ToolResponse as j, type LanguageModel as k, type ModelCapabilities as l, type DoGenerateParams as m, type DoGenerateResult as n, type SystemMessage as o, type AssistantMessage as p, type ToolMessage as q, type UserContentPart as r, type TextPart as s, type ToolCall$1 as t, type ToolResult as u, type GenerateStep as v, type StreamPart as w, type StreamChunk as x, type TextDeltaChunk as y, type ToolCallChunk as z };