@yourgpt/llm-sdk 0.1.0 → 0.1.1

package/dist/base-D_FyHFKj.d.mts

@@ -0,0 +1,235 @@
+import { Message, ActionDefinition, LLMConfig, StreamEvent, MessageAttachment } from '@yourgpt/copilot-sdk/core';
+
+/**
+ * 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[];
+    /** System prompt */
+    systemPrompt?: string;
+    /** LLM configuration overrides */
+    config?: Partial<LLMConfig>;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * 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;
+    /** 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[];
+
+export { type AdapterFactory as A, type ChatCompletionRequest as C, type LLMAdapter as L, type OpenAIContentBlock as O, type CompletionResult as a, formatTools as b, formatMessagesForAnthropic as c, formatMessagesForOpenAI as d, messageToOpenAIContent as e, formatMessages as f, hasMediaAttachments as g, hasImageAttachments as h, attachmentToAnthropicImage as i, attachmentToAnthropicDocument as j, attachmentToOpenAIImage as k, type AnthropicContentBlock as l, messageToAnthropicContent as m };

package/dist/base-D_FyHFKj.d.ts

@@ -0,0 +1,235 @@
+import { Message, ActionDefinition, LLMConfig, StreamEvent, MessageAttachment } from '@yourgpt/copilot-sdk/core';
+
+/**
+ * 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[];
+    /** System prompt */
+    systemPrompt?: string;
+    /** LLM configuration overrides */
+    config?: Partial<LLMConfig>;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * 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;
+    /** 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[];
+
+export { type AdapterFactory as A, type ChatCompletionRequest as C, type LLMAdapter as L, type OpenAIContentBlock as O, type CompletionResult as a, formatTools as b, formatMessagesForAnthropic as c, formatMessagesForOpenAI as d, messageToOpenAIContent as e, formatMessages as f, hasMediaAttachments as g, hasImageAttachments as h, attachmentToAnthropicImage as i, attachmentToAnthropicDocument as j, attachmentToOpenAIImage as k, type AnthropicContentBlock as l, messageToAnthropicContent as m };