@agentscope-ai/agentscope 0.0.2

package/dist/formatter/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/message/message.ts","../../src/formatter/base.ts","../../src/formatter/dashscope-chat-formatter.ts","../../src/formatter/deepseek-chat-formatter.ts","../../src/formatter/ollama-chat-formatter.ts","../../src/formatter/openai-chat-formatter.ts"],"sourcesContent":["import { JSONSerializableObject } from '../type';\nimport {\n    ContentBlock,\n    TextBlock,\n    ThinkingBlock,\n    ToolResultBlock,\n    ToolCallBlock,\n    DataBlock,\n} from './block';\n\n/** A chat message exchanged between agents or between an agent and a model. */\nexport interface Msg {\n    /** Unique identifier for the message. */\n    id: string;\n    /** Display name of the message sender. */\n    name: string;\n    /** Conversation role of the sender. */\n    role: 'user' | 'assistant' | 'system';\n    /** Message body. */\n    content: ContentBlock[];\n    /** Arbitrary key-value metadata attached to the message. */\n    metadata: Record<string, JSONSerializableObject>;\n    /** ISO-8601 creation timestamp. */\n    timestamp: string;\n    /** Usage information for the message, such as token counts. */\n    usage?: {\n        inputTokens: number;\n        outputTokens: number;\n    };\n}\n\n/**\n * Create a new {@link Msg} object, filling in `id` and `timestamp` when omitted.\n *\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.role\n * @param root0.metadata\n * @param root0.id\n * @param root0.timestamp\n * @param root0.usage\n * @returns A fully-populated {@link Msg} object.\n */\nexport function createMsg({\n    name,\n    content,\n    role,\n    metadata = {},\n    id = crypto.randomUUID(),\n    timestamp = new Date().toISOString(),\n    usage,\n}: Omit<Msg, 'id' | 'timestamp' | 'metadata'> &\n    Partial<Pick<Msg, 'id' | 'timestamp' | 'metadata'>>): Msg {\n    return { id, name, role, content, metadata, timestamp, usage } as Msg;\n}\n\n/**\n * Extract the plain-text content from a message.\n *\n * When `content` is a string it is returned as-is. When it is an array of\n * content blocks, all {@link TextBlock} texts are joined with `separator`.\n *\n * @param msg - The message to read.\n * @param separator - String inserted between consecutive text blocks. Defaults to `'\\n'`.\n * @returns The concatenated text, or `null` when no text blocks are present.\n */\nexport function getTextContent(msg: Msg, separator: string = '\\n'): string | null {\n    const textBlocks = msg.content.filter(block => block.type === 'text');\n    if (textBlocks.length === 0) {\n        return null;\n    }\n    return textBlocks.map(block => (block as TextBlock).text).join(separator);\n}\n\n/**\n * Return all content blocks from a message, regardless of type.\n *\n * When `content` is a plain string it is wrapped in a single {@link TextBlock}.\n *\n * @param msg - The message to read.\n * @returns An array of all {@link ContentBlock} objects.\n */\nexport function getContentBlocks(msg: Msg): ContentBlock[];\n/**\n * Return all {@link TextBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'text'`\n * @returns An array of {@link TextBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'text'): TextBlock[];\n/**\n * Return all {@link ThinkingBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'thinking'`\n * @returns An array of {@link ThinkingBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'thinking'): ThinkingBlock[];\n/**\n * Return all {@link DataBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'video'`\n * @returns An array of {@link DataBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'data'): DataBlock[];\n/**\n * Return all {@link ToolCallBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'tool_call'`\n * @returns An array of {@link ToolCallBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'tool_call'): ToolCallBlock[];\n/**\n * Return all {@link ToolResultBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'tool_result'`\n * @returns An array of {@link ToolResultBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'tool_result'): ToolResultBlock[];\nexport function getContentBlocks(\n    msg: Msg,\n    blockType?: 'text' | 'thinking' | 'data' | 'tool_call' | 'tool_result'\n): ContentBlock[] {\n    if (!blockType) return msg.content;\n    return msg.content.filter(block => block.type === blockType);\n}\n","import { Msg, TextBlock, DataBlock, createMsg } from '../message';\n\n/**\n * Base class for message formatters.\n */\nexport abstract class FormatterBase {\n    /**\n     * Format the input message objects into the required format by the API.\n     *\n     * @param root0\n     * @param root0.msgs - An array of message objects to be formatted.\n     * @returns A promise that resolves to an array of formatted message objects.\n     */\n    abstract format({ msgs }: { msgs: Array<Msg> }): Promise<Record<string, unknown>[]>;\n\n    /**\n     * Convert the tool output to string format for the LLM APIs that only accept text input. If\n     * `promoteMultimodalToolResult` is true, the multimodal content will be promoted to be a user message with\n     * \"<system-info></system-info>\" tags. Otherwise, the multimodal content will be saved to a storage and a URL link\n     * will be provided in the text output.\n     *\n     * @param output - The tool output, which can be a string or an array of content blocks.\n     * @param promoteMultimodalToolResult - Whether to promote the multimodal content to the prompt messages.\n     * @returns An object containing the text output and an optional promoted message.\n     */\n    convertToolOutputToString(\n        output: string | (TextBlock | DataBlock)[],\n        promoteMultimodalToolResult: boolean | { image?: boolean; audio?: boolean; video?: boolean }\n    ) {\n        if (typeof output === 'string') return { text: output, promotedMsg: null };\n\n        let textualOutput = [];\n\n        const promotedData: { id: string; block: DataBlock }[] = [];\n\n        for (const block of output) {\n            switch (block.type) {\n                case 'text':\n                    textualOutput.push(block.text);\n                    break;\n                default:\n                    const type = block.source.mediaType.split('/')[0];\n                    if (type !== 'image' && type !== 'audio' && type !== 'video') {\n                        console.log(\n                            `Unsupported media type '${block.source.mediaType}' in tool output. Only image, audio and video are supported.`\n                        );\n                        break;\n                    }\n                    if (block.source.type === 'url') {\n                        textualOutput.push(\n                            `<system-info>One returned ${type} can be found at: ${block.source.url}</system-info>`\n                        );\n                    } else {\n                        // If we should promote the multimodal content to the prompt messages\n                        const shouldPromote =\n                            promoteMultimodalToolResult === true ||\n                            (typeof promoteMultimodalToolResult === 'object' &&\n                                promoteMultimodalToolResult[type]);\n\n                        if (shouldPromote) {\n                            // Create an ID for the multimodal content first, which should less than 10 characters\n                            const dataID = Math.random().toString(36).substring(2, 10);\n                            textualOutput.push(\n                                `<system-info>One returned ${type} is embedded with ID '${dataID}' and will be attached within '<system-info></system-info>' tags later.</system-info>`\n                            );\n\n                            // Record the promoted data\n                            promotedData.push({ id: dataID, block });\n                        } else {\n                            // TODO: save locally\n\n                            // Save to storage and provide URL link\n                            textualOutput.push(`The returned ${block.type} is stored locally.`);\n                        }\n                    }\n            }\n        }\n\n        // Attach prefix and suffix system-info tags if there are promoted blocks\n        const promotedBlocks: (TextBlock | DataBlock)[] = [];\n        promotedData.forEach(({ id, block }) => {\n            const type = block.source.mediaType.split('/')[0];\n            promotedBlocks.push({\n                id: crypto.randomUUID(),\n                type: 'text',\n                text: `<${type}_data id='${id}'>`,\n            });\n            promotedBlocks.push(block);\n            promotedBlocks.push({\n                id: crypto.randomUUID(),\n                type: 'text',\n                text: `</${type}_data>\\n`,\n            });\n        });\n\n        if (promotedBlocks.length > 0) {\n            // The prefix\n            const prefix =\n                '<system-info>The multimodal contents returned from the tool call are as follows:\\n';\n\n            if (promotedBlocks[0].type === 'text') {\n                promotedBlocks[0].text = `${prefix}${promotedBlocks[0].text}`;\n            } else {\n                promotedBlocks.unshift({\n                    id: crypto.randomUUID(),\n                    type: 'text',\n                    text: `${prefix}`,\n                });\n            }\n\n            // The suffix\n            const lastBlock = promotedBlocks[promotedBlocks.length - 1];\n            if (lastBlock.type === 'text') {\n                promotedBlocks[promotedBlocks.length - 1] = {\n                    id: crypto.randomUUID(),\n                    type: 'text',\n                    text: `${lastBlock.text}</system-info>`,\n                };\n            } else {\n                promotedBlocks.push({\n                    id: crypto.randomUUID(),\n                    type: 'text',\n                    text: `</system-info>`,\n                });\n            }\n        }\n\n        return {\n            text: textualOutput.join('\\n'),\n            promotedMsg: createMsg({ name: 'user', content: promotedBlocks, role: 'user' }),\n        };\n    }\n}\n","import { FormatterBase } from './base';\nimport { Msg, TextBlock, getContentBlocks } from '../message';\nimport { DataBlock } from '../message';\n\ninterface DashScopeFormatterOptions {\n    /**\n     * Since DashScope API doesn't support multimodal tool outputs, this option indicates whether to\n     * promote the multimodal tool results to the prompt messages, so that LLMs can see them.\n     * Note you should ensure your model supports the corresponding modalities.\n     */\n    promoteMultimodalToolResult?:\n        | {\n              image?: boolean;\n              audio?: boolean;\n              video?: boolean;\n          }\n        | boolean;\n}\n\n/**\n *\n */\nexport class DashScopeChatFormatter extends FormatterBase {\n    private promoteMultimodalToolResult:\n        | { image?: boolean; audio?: boolean; video?: boolean }\n        | boolean;\n\n    /**\n     * Initialize a DashScopeChatFormatter instance.\n     *\n     * @param promoteMultimodalToolResult - Since DashScope API doesn't support multimodal tool outputs, this option\n     *  indicates whether to promote the multimodal tool results to the prompt messages, so that LLMs can see them.\n     *  Note you should ensure your model supports the corresponding modalities.\n     * @param promoteMultimodalToolResult.promoteMultimodalToolResult\n     */\n    constructor({ promoteMultimodalToolResult = false }: DashScopeFormatterOptions = {}) {\n        super();\n        this.promoteMultimodalToolResult = promoteMultimodalToolResult;\n    }\n\n    /**\n     * Format the input message objects into the required format by DashScope API.\n     *\n     * @param msgs - An array of Msg instances to be formatted.\n     * @param msgs.msgs\n     * @returns A promise that resolves to an array of formatted message objects.\n     */\n    async format({ msgs }: { msgs: Array<Msg> }): Promise<Record<string, unknown>[]> {\n        const formattedMsgs: Array<Record<string, unknown>> = [];\n        let index = 0;\n        while (index < msgs.length) {\n            const msg = msgs[index];\n            const formattedMsg: {\n                role: string;\n                content: Record<string, unknown>[];\n                tool_calls?: {\n                    id: string;\n                    type: 'function';\n                    function: {\n                        name: string;\n                        arguments: string;\n                    };\n                }[];\n            } = {\n                role: msg.role,\n                content: [],\n            };\n\n            // The cached messages that should be pushed after the current message, to keep the order of messages correct.\n            const cachedMsgs = [];\n            for (const block of getContentBlocks(msg)) {\n                switch (block.type) {\n                    case 'text':\n                        formattedMsg.content.push(this._formatTextBlock(block));\n                        break;\n                    case 'thinking':\n                        break;\n                    case 'tool_call':\n                        if (!formattedMsg.tool_calls) {\n                            formattedMsg.tool_calls = [];\n                        }\n                        formattedMsg.tool_calls.push({\n                            id: block.id,\n                            type: 'function',\n                            function: {\n                                name: block.name,\n                                arguments: block.input,\n                            },\n                        });\n                        break;\n                    case 'tool_result':\n                        const formattedToolResult = this.convertToolOutputToString(\n                            block.output,\n                            this.promoteMultimodalToolResult\n                        );\n\n                        cachedMsgs.push({\n                            role: 'tool',\n                            tool_call_id: block.id,\n                            name: block.name,\n                            content: formattedToolResult.text,\n                        });\n                        if (formattedToolResult.promotedMsg) {\n                            // Insert the promoted message into the array as the next message to be processed\n                            msgs.splice(index + 1, 0, formattedToolResult.promotedMsg);\n                        }\n                        break;\n                    case 'data':\n                        formattedMsg.content.push(...this._formatMultimodalBlock(block));\n                        break;\n                }\n            }\n            if (formattedMsg.content.length > 0 || formattedMsg.tool_calls) {\n                formattedMsgs.push(formattedMsg);\n            }\n            if (cachedMsgs.length > 0) {\n                formattedMsgs.push(...cachedMsgs);\n            }\n\n            // Process next message\n            index++;\n        }\n        return formattedMsgs;\n    }\n\n    /**\n     * Format a text content block into the required format.\n     *\n     * @param block - The text content block to format.\n     * @returns An object representing the formatted text content.\n     */\n    _formatTextBlock(block: TextBlock) {\n        return { text: block.text };\n    }\n\n    /**\n     * Format a multimodal data block into the required format.\n     * In DashScope API, the local file paths should be prefixed with \"file://\". URLs are kept unchanged.\n     *\n     * @param block - The multimodal content block to format.\n     * @returns An object representing the formatted multimodal content.\n     */\n    _formatMultimodalBlock(block: DataBlock) {\n        const type = block.source.mediaType.split('/')[0];\n\n        if (!['image', 'audio', 'video'].includes(type)) {\n            console.log(\n                `Skip unsupported media type ${block.source.mediaType} in DashScopeChatFormatter. Only image, audio and video are supported.`\n            );\n            return [];\n        }\n\n        if (block.source.type === 'url') {\n            return [{ [type]: block.source.url }];\n        }\n\n        return [\n            {\n                [type]: `data:${block.source.mediaType};base64,${block.source.data}`,\n            },\n        ];\n    }\n}\n","import { FormatterBase } from './base';\nimport { Msg, getContentBlocks } from '../message';\n\ninterface DeepSeekFormatterOptions {\n    /**\n     * Most LLM APIs don't support multimodal tool outputs, this option controls whether to\n     * promote multimodal tool results to follow-up user messages.\n     */\n    promoteMultimodalToolResult?:\n        | {\n              image?: boolean;\n              audio?: boolean;\n              video?: boolean;\n          }\n        | boolean;\n}\n\n/**\n * Format AgentScope message objects into DeepSeek Chat Completions message format.\n */\nexport class DeepSeekChatFormatter extends FormatterBase {\n    private promoteMultimodalToolResult:\n        | { image?: boolean; audio?: boolean; video?: boolean }\n        | boolean;\n\n    /**\n     * Initializes a new instance of the DeepSeekChatFormatter class.\n     * @param root0\n     * @param root0.promoteMultimodalToolResult\n     */\n    constructor({ promoteMultimodalToolResult = false }: DeepSeekFormatterOptions = {}) {\n        super();\n        this.promoteMultimodalToolResult = promoteMultimodalToolResult;\n    }\n\n    /**\n     * Format the input messages into the structure expected by DeepSeek Chat Completions API.\n     * @param root0\n     * @param root0.msgs\n     * @returns An array of formatted message objects ready to be sent to the DeepSeek API.\n     */\n    async format({ msgs }: { msgs: Array<Msg> }): Promise<Record<string, unknown>[]> {\n        const formattedMsgs: Array<Record<string, unknown>> = [];\n        let index = 0;\n\n        while (index < msgs.length) {\n            const msg = msgs[index];\n            const formattedMsg: {\n                role: string;\n                name: string;\n                content: Record<string, unknown>[] | null;\n                tool_calls?: {\n                    id: string;\n                    type: 'function';\n                    function: {\n                        name: string;\n                        arguments: string;\n                    };\n                }[];\n            } = {\n                role: msg.role,\n                name: msg.name,\n                content: null,\n            };\n            const content: Record<string, unknown>[] = [];\n\n            // Cache tool-result messages to keep the sequence right after current message.\n            const cachedMsgs: Record<string, unknown>[] = [];\n            for (const block of getContentBlocks(msg)) {\n                switch (block.type) {\n                    case 'text':\n                        content.push({\n                            type: 'text',\n                            text: block.text,\n                        });\n                        break;\n                    case 'thinking':\n                        break;\n                    case 'tool_call':\n                        if (!formattedMsg.tool_calls) {\n                            formattedMsg.tool_calls = [];\n                        }\n                        formattedMsg.tool_calls.push({\n                            id: block.id,\n                            type: 'function',\n                            function: {\n                                name: block.name,\n                                arguments: block.input,\n                            },\n                        });\n                        break;\n                    case 'tool_result':\n                        const formattedToolResult = this.convertToolOutputToString(\n                            block.output,\n                            this.promoteMultimodalToolResult\n                        );\n                        cachedMsgs.push({\n                            role: 'tool',\n                            tool_call_id: block.id,\n                            name: block.name,\n                            content: formattedToolResult.text,\n                        });\n                        if (formattedToolResult.promotedMsg?.content.length) {\n                            msgs.splice(index + 1, 0, formattedToolResult.promotedMsg);\n                        }\n                        break;\n                    case 'data':\n                        console.warn(\n                            `DeepSeek models don't support multimodal data for now (2026-03), skip the data block in message content.`\n                        );\n                        break;\n                }\n            }\n\n            if (content.length > 0) {\n                formattedMsg.content = content;\n            }\n            if (formattedMsg.content || formattedMsg.tool_calls) {\n                formattedMsgs.push(formattedMsg);\n            }\n            if (cachedMsgs.length > 0) {\n                formattedMsgs.push(...cachedMsgs);\n            }\n\n            index++;\n        }\n\n        return formattedMsgs;\n    }\n}\n","import { FormatterBase } from './base';\nimport { Msg, getContentBlocks, getTextContent } from '../message';\n\n/**\n * Format AgentScope message objects into Ollama Chat message format.\n * Ollama expects simple string content, not the multimodal array format.\n */\nexport class OllamaChatFormatter extends FormatterBase {\n    // eslint-disable-next-line jsdoc/require-returns\n    /**\n     * Format messages for Ollama API\n     * @param root0\n     * @param root0.msgs\n     */\n    async format({ msgs }: { msgs: Array<Msg> }): Promise<Record<string, unknown>[]> {\n        const formattedMsgs: Array<Record<string, unknown>> = [];\n\n        for (const msg of msgs) {\n            const formattedMsg: {\n                role: string;\n                content: string;\n                tool_calls?: {\n                    function: {\n                        name: string;\n                        arguments: Record<string, unknown>;\n                    };\n                }[];\n            } = {\n                role: msg.role,\n                content: '',\n            };\n\n            // Extract text content\n            const textContent = getTextContent(msg);\n            if (textContent) {\n                formattedMsg.content = textContent;\n            }\n\n            // Handle tool calls\n            const toolCalls = getContentBlocks(msg, 'tool_call');\n            if (toolCalls.length > 0) {\n                formattedMsg.tool_calls = toolCalls.map(toolCall => ({\n                    function: {\n                        name: toolCall.name,\n                        arguments: JSON.parse(toolCall.input),\n                    },\n                }));\n            }\n\n            // Handle tool results\n            const toolResults = getContentBlocks(msg, 'tool_result');\n            for (const toolResult of toolResults) {\n                const resultText = this.convertToolOutputToString(toolResult.output, false);\n                formattedMsgs.push({\n                    role: 'tool',\n                    content: resultText.text,\n                });\n            }\n\n            if (formattedMsg.content || formattedMsg.tool_calls) {\n                formattedMsgs.push(formattedMsg);\n            }\n        }\n\n        return formattedMsgs;\n    }\n}\n","import { existsSync } from 'fs';\nimport { readFile } from 'fs/promises';\nimport { extname } from 'path';\nimport { fileURLToPath } from 'url';\n\nimport { FormatterBase } from './base';\nimport { DataBlock, Msg, TextBlock, getContentBlocks } from '../message';\n\ninterface OpenAIFormatterOptions {\n    /**\n     * Most LLM APIs don't support multimodal tool outputs, this option controls whether to\n     * promote multimodal tool results to follow-up user messages.\n     */\n    promoteMultimodalToolResult?:\n        | {\n              image?: boolean;\n              audio?: boolean;\n              video?: boolean;\n          }\n        | boolean;\n}\n\n/**\n * Format AgentScope message objects into OpenAI Chat Completions message format.\n */\nexport class OpenAIChatFormatter extends FormatterBase {\n    private promoteMultimodalToolResult:\n        | { image?: boolean; audio?: boolean; video?: boolean }\n        | boolean;\n\n    /**\n     * Initializes a new instance of the OpenAIChatFormatter class.\n     * @param root0\n     * @param root0.promoteMultimodalToolResult\n     */\n    constructor({ promoteMultimodalToolResult = false }: OpenAIFormatterOptions = {}) {\n        super();\n        this.promoteMultimodalToolResult = promoteMultimodalToolResult;\n    }\n\n    /**\n     * Format the input messages into OpenAI Chat Completions message format.\n     * @param root0\n     * @param root0.msgs\n     * @returns An array of formatted messages compatible with OpenAI Chat Completions API.\n     */\n    async format({ msgs }: { msgs: Array<Msg> }): Promise<Record<string, unknown>[]> {\n        const formattedMsgs: Array<Record<string, unknown>> = [];\n        let index = 0;\n\n        while (index < msgs.length) {\n            const msg = msgs[index];\n            const formattedMsg: {\n                role: string;\n                name: string;\n                content: Record<string, unknown>[] | null;\n                tool_calls?: {\n                    id: string;\n                    type: 'function';\n                    function: {\n                        name: string;\n                        arguments: string;\n                    };\n                }[];\n            } = {\n                role: msg.role,\n                name: msg.name,\n                content: null,\n            };\n            const content: Record<string, unknown>[] = [];\n\n            // Cache tool-result messages to keep the sequence right after current message.\n            const cachedMsgs: Record<string, unknown>[] = [];\n            for (const block of getContentBlocks(msg)) {\n                switch (block.type) {\n                    case 'text':\n                        content.push(this._formatTextBlock(block));\n                        break;\n                    case 'thinking':\n                        break;\n                    case 'tool_call':\n                        if (!formattedMsg.tool_calls) {\n                            formattedMsg.tool_calls = [];\n                        }\n                        formattedMsg.tool_calls.push({\n                            id: block.id,\n                            type: 'function',\n                            function: {\n                                name: block.name,\n                                arguments: block.input,\n                            },\n                        });\n                        break;\n                    case 'tool_result':\n                        const formattedToolResult = this.convertToolOutputToString(\n                            block.output,\n                            this.promoteMultimodalToolResult\n                        );\n                        cachedMsgs.push({\n                            role: 'tool',\n                            tool_call_id: block.id,\n                            name: block.name,\n                            content: formattedToolResult.text,\n                        });\n                        if (formattedToolResult.promotedMsg?.content.length) {\n                            msgs.splice(index + 1, 0, formattedToolResult.promotedMsg);\n                        }\n                        break;\n                    case 'data':\n                        content.push(\n                            ...(await this._formatMultimodalBlock({ block, role: msg.role }))\n                        );\n                        break;\n                }\n            }\n\n            if (content.length > 0) {\n                formattedMsg.content = content;\n            }\n            if (formattedMsg.content || formattedMsg.tool_calls) {\n                formattedMsgs.push(formattedMsg);\n            }\n            if (cachedMsgs.length > 0) {\n                formattedMsgs.push(...cachedMsgs);\n            }\n\n            index++;\n        }\n\n        return formattedMsgs;\n    }\n\n    /**\n     * Format a text block into OpenAI Chat Completions message content format.\n     * @param block\n     * @returns An object representing the formatted text block.\n     */\n    _formatTextBlock(block: TextBlock) {\n        return {\n            type: 'text',\n            text: block.text,\n        };\n    }\n\n    /**\n     * Format a multimodal data block into OpenAI Chat Completions message content format.\n     * @param root0\n     * @param root0.block\n     * @param root0.role\n     * @returns The formatted content blocks\n     */\n    async _formatMultimodalBlock({\n        block,\n        role,\n    }: {\n        block: DataBlock;\n        role: Msg['role'];\n    }): Promise<Record<string, unknown>[]> {\n        const type = block.source.mediaType.split('/')[0];\n        if (type === 'image') {\n            return [\n                {\n                    type: 'image_url',\n                    image_url: {\n                        url: await this._toOpenAIImageURL(block),\n                    },\n                },\n            ];\n        }\n\n        if (type === 'audio') {\n            // Skip assistant output audio to avoid carrying generated audio back into next request.\n            if (role === 'assistant') {\n                return [];\n            }\n            return [\n                {\n                    type: 'input_audio',\n                    input_audio: await this._toOpenAIAudioData(block),\n                },\n            ];\n        }\n\n        console.log(\n            `Skip unsupported media type ${block.source.mediaType} in OpenAIChatFormatter. Only image and audio are supported.`\n        );\n        return [];\n    }\n\n    /**\n     * Convert the data block to an OpenAI compatible image URL.\n     * @param block\n     * @returns A promise that resolves to a string representing the image URL in a format compatible with OpenAI Chat Completions API.\n     */\n    protected async _toOpenAIImageURL(block: DataBlock): Promise<string> {\n        if (block.source.type === 'base64') {\n            return `data:${block.source.mediaType};base64,${block.source.data}`;\n        }\n\n        const sourceUrl = block.source.url;\n        if (sourceUrl.startsWith('http://') || sourceUrl.startsWith('https://')) {\n            return sourceUrl;\n        }\n        if (sourceUrl.startsWith('data:')) {\n            return sourceUrl;\n        }\n\n        const localPath = this._toLocalPath(sourceUrl);\n        if (!localPath || !existsSync(localPath)) {\n            throw new Error(`Image path not found: ${sourceUrl}`);\n        }\n\n        const ext = extname(localPath).toLowerCase();\n        const supportedImageExtensions = ['.png', '.jpg', '.jpeg', '.gif', '.webp'];\n        if (!supportedImageExtensions.includes(ext)) {\n            throw new TypeError(\n                `Unsupported image extension: ${ext}. Supported: ${supportedImageExtensions.join(', ')}`\n            );\n        }\n\n        const file = await readFile(localPath);\n        const mime = block.source.mediaType || `image/${ext.slice(1)}`;\n        return `data:${mime};base64,${file.toString('base64')}`;\n    }\n\n    /**\n     * Converts a data block to OpenAI compatible audio data format.\n     *\n     * @param block - The data block containing audio information.\n     * @returns A promise that resolves to an object with audio data and format.\n     */\n    protected async _toOpenAIAudioData(\n        block: DataBlock\n    ): Promise<{ data: string; format: 'wav' | 'mp3' }> {\n        const supportedMediaTypes = new Map<string, 'wav' | 'mp3'>([\n            ['audio/wav', 'wav'],\n            ['audio/mp3', 'mp3'],\n            ['audio/mpeg', 'mp3'],\n        ]);\n\n        if (block.source.type === 'base64') {\n            const format = supportedMediaTypes.get(block.source.mediaType);\n            if (!format) {\n                throw new TypeError(\n                    `Unsupported audio media type: ${block.source.mediaType}, only audio/wav and audio/mp3 are supported.`\n                );\n            }\n            return { data: block.source.data, format };\n        }\n\n        const sourceUrl = block.source.url;\n        const localPath = this._toLocalPath(sourceUrl);\n        let data: string;\n\n        if (localPath && existsSync(localPath)) {\n            const file = await readFile(localPath);\n            data = file.toString('base64');\n        } else if (sourceUrl.startsWith('http://') || sourceUrl.startsWith('https://')) {\n            const response = await fetch(sourceUrl);\n            if (!response.ok) {\n                throw new Error(\n                    `Failed to fetch audio from URL: ${sourceUrl} (${response.status})`\n                );\n            }\n            const arr = await response.arrayBuffer();\n            data = Buffer.from(arr).toString('base64');\n        } else {\n            throw new Error(\n                `Unsupported audio source: ${sourceUrl}, it should be a local file path, file URL, or an HTTP URL.`\n            );\n        }\n\n        const ext = extname(localPath || sourceUrl).toLowerCase();\n        const extToFormat = new Map<string, 'wav' | 'mp3'>([\n            ['.wav', 'wav'],\n            ['.mp3', 'mp3'],\n        ]);\n        const format = extToFormat.get(ext);\n        if (!format) {\n            throw new TypeError(`Unsupported audio extension: ${ext}, wav and mp3 are supported.`);\n        }\n\n        return { data, format };\n    }\n\n    /**\n     * Converts a URL or path to a local file path.\n     *\n     * @param urlOrPath - The URL or path to convert.\n     * @returns The local file path, or null if not a local path.\n     */\n    protected _toLocalPath(urlOrPath: string) {\n        if (urlOrPath.startsWith('file://')) {\n            return fileURLToPath(urlOrPath);\n        }\n        if (!urlOrPath.includes('://')) {\n            return urlOrPath;\n        }\n        return null;\n    }\n}\n"],"mappings":"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","names":["format"]}

package/dist/index-BTJDlKvQ.d.mts

@@ -0,0 +1,195 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import z$1, { z } from 'zod';
+import { J as JSONSerializableObject, b as ToolInputSchema } from './index-CAxQAkiP.mjs';
+import { T as TextBlock, D as DataBlock } from './block-VsnHrllL.mjs';
+import { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
+
+/**
+ * The tool response structure.
+ */
+interface ToolResponse {
+    content: Array<TextBlock | DataBlock>;
+    id: string;
+    createdAt: string;
+    metadata: Record<string, JSONSerializableObject>;
+    state: 'success' | 'error' | 'interrupted' | 'running';
+    isLast: boolean;
+    isInterrupted: boolean;
+}
+
+interface Tool {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject | ToolInputSchema;
+    call?: (input: any) => string | Promise<string> | Generator<string> | AsyncGenerator<string> | ToolResponse | Promise<ToolResponse> | Generator<ToolResponse> | AsyncGenerator<ToolResponse>;
+    requireUserConfirm?: boolean;
+}
+
+/**
+ * Type definition for getting a client instance
+ */
+type GetClient = () => Promise<Client>;
+/**
+ * Type definition for releasing a client instance
+ */
+type ReleaseClient = (client: Client) => Promise<void>;
+/**
+ * MCPTool class that wraps an MCP tool and provides a callable interface
+ */
+declare class MCPTool implements Tool {
+    name: string;
+    description: string;
+    inputSchema: z$1.ZodObject | ToolInputSchema;
+    requireUserConfirm: boolean;
+    call: (input: Record<string, unknown>) => Promise<ToolResponse>;
+    private getClient;
+    private releaseClient;
+    /**
+     * Initialize an MCPTool instance
+     * @param root0
+     * @param root0.name
+     * @param root0.description
+     * @param root0.inputSchema
+     * @param root0.getClient
+     * @param root0.releaseClient
+     */
+    constructor({ name, description, inputSchema, getClient, releaseClient, }: {
+        name: string;
+        description: string;
+        inputSchema: z$1.ZodObject | ToolInputSchema;
+        getClient: GetClient;
+        releaseClient: ReleaseClient;
+    });
+    /**
+     * Call the MCP tool with the specified input arguments. This method sends a request to the MCP server to execute
+     * the tool and returns the result as a ToolResponse.
+     *
+     * @param arguments
+     * @param input
+     * @returns A ToolResponse object containing the result of the tool execution, or an error message if the call fails.
+     */
+    _call(input: Record<string, unknown>): Promise<ToolResponse>;
+}
+
+/**
+ * The HTTP MCP client class that connects to an MCP server using either Streamable HTTP or Server-Sent Events (SSE)
+ * transport.
+ * Note the client is stateful, meaning that developers should manually call the `connect()` and `close()` methods to
+ * manage the connection lifecycle.
+ */
+declare class HTTPMCPClient {
+    name: string;
+    private requestOptions?;
+    private client?;
+    private transport?;
+    private transportType;
+    private url;
+    private transportOpts?;
+    private stateful;
+    /**
+     * Initialize the HTTPStatefulMCPClient with the specified transport type, URL, and options.
+     *
+     * @param root0
+     * @param root0.name
+     * @param root0.transportType
+     * @param root0.url
+     * @param root0.stateful
+     * @param root0.transportOpts
+     * @param root0.requestOptions
+     */
+    constructor({ name, transportType, url, stateful, transportOpts, requestOptions, }: {
+        name: string;
+        transportType: 'streamable-http' | 'sse';
+        url: string;
+        stateful?: boolean;
+        transportOpts?: StreamableHTTPClientTransportOptions | SSEClientTransportOptions;
+        requestOptions?: RequestOptions;
+    });
+    /**
+     * Connect to the MCP server with the specified transport and URL. This method must be called before making any
+     * requests to the server.
+     */
+    connect(): Promise<void>;
+    /**
+     * The internal method to establish the connection to the MCP server. It initializes the appropriate transport
+     * based on the specified transport type and creates a new Client instance to manage the connection and requests.
+     */
+    protected _connect(): Promise<void>;
+    /**
+     * List all tools available on the MCP server.
+     *
+     * @returns An array of MCPTool instances representing the tools available on the server.
+     */
+    listTools(): Promise<MCPTool[]>;
+    /**
+     * Close the connection to the MCP server and clean up any resources used by the client.
+     */
+    close(): Promise<void>;
+    /**
+     * The internal method to close the connection to the MCP server.
+     */
+    protected _close(): Promise<void>;
+    /**
+     * Create a new client instance without storing it in this.client.
+     * Used for stateless operations where each request needs its own client.
+     * @returns A new connected Client instance
+     */
+    protected _createClient(): Promise<Client>;
+    /**
+     * Get a callable function for a specific tool by its name.
+     * @param root0
+     * @param root0.name
+     * @returns An instance of MCPTool that can be called to execute the tool's functionality.
+     */
+    getCallableFunction({ name }: {
+        name: string;
+    }): Promise<MCPTool>;
+}
+
+/**
+ * The STDIO MCP client class.
+ */
+declare class StdioMCPClient {
+    name: string;
+    private stdioServerParameters;
+    private transport?;
+    private client?;
+    /**
+     * Initialize the StdioMCPClient with the given Stdio parameters.
+     *
+     * @param root0
+     * @param root0.name
+     */
+    constructor({ name, ...rest }: {
+        name: string;
+    } & StdioServerParameters);
+    /**
+     * Connect to the MCP server using Stdio transport. Note the Stdio client will start an
+     * MCP server process under the hood.
+     */
+    connect(): Promise<void>;
+    /**
+     * Close the connection and stop the MCP server process.
+     */
+    close(): Promise<void>;
+    /**
+     * List all tools available on the MCP server.
+     *
+     * @returns An array of MCPTool instances representing the tools available on the server.
+     */
+    listTools(): Promise<MCPTool[]>;
+    /**
+     * Get a callable function for a specific tool by its name.
+     * @param root0
+     * @param root0.name
+     * @returns An instance of MCPTool that can be called to execute the tool's functionality.
+     */
+    getCallableFunction({ name }: {
+        name: string;
+    }): Promise<MCPTool>;
+}
+
+export { HTTPMCPClient as H, StdioMCPClient as S, type Tool as T, type ToolResponse as a };

package/dist/index-BcatlwXQ.d.ts

@@ -0,0 +1,195 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import z$1, { z } from 'zod';
+import { J as JSONSerializableObject, b as ToolInputSchema } from './index-CAxQAkiP.js';
+import { T as TextBlock, D as DataBlock } from './block-VsnHrllL.js';
+import { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
+
+/**
+ * The tool response structure.
+ */
+interface ToolResponse {
+    content: Array<TextBlock | DataBlock>;
+    id: string;
+    createdAt: string;
+    metadata: Record<string, JSONSerializableObject>;
+    state: 'success' | 'error' | 'interrupted' | 'running';
+    isLast: boolean;
+    isInterrupted: boolean;
+}
+
+interface Tool {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject | ToolInputSchema;
+    call?: (input: any) => string | Promise<string> | Generator<string> | AsyncGenerator<string> | ToolResponse | Promise<ToolResponse> | Generator<ToolResponse> | AsyncGenerator<ToolResponse>;
+    requireUserConfirm?: boolean;
+}
+
+/**
+ * Type definition for getting a client instance
+ */
+type GetClient = () => Promise<Client>;
+/**
+ * Type definition for releasing a client instance
+ */
+type ReleaseClient = (client: Client) => Promise<void>;
+/**
+ * MCPTool class that wraps an MCP tool and provides a callable interface
+ */
+declare class MCPTool implements Tool {
+    name: string;
+    description: string;
+    inputSchema: z$1.ZodObject | ToolInputSchema;
+    requireUserConfirm: boolean;
+    call: (input: Record<string, unknown>) => Promise<ToolResponse>;
+    private getClient;
+    private releaseClient;
+    /**
+     * Initialize an MCPTool instance
+     * @param root0
+     * @param root0.name
+     * @param root0.description
+     * @param root0.inputSchema
+     * @param root0.getClient
+     * @param root0.releaseClient
+     */
+    constructor({ name, description, inputSchema, getClient, releaseClient, }: {
+        name: string;
+        description: string;
+        inputSchema: z$1.ZodObject | ToolInputSchema;
+        getClient: GetClient;
+        releaseClient: ReleaseClient;
+    });
+    /**
+     * Call the MCP tool with the specified input arguments. This method sends a request to the MCP server to execute
+     * the tool and returns the result as a ToolResponse.
+     *
+     * @param arguments
+     * @param input
+     * @returns A ToolResponse object containing the result of the tool execution, or an error message if the call fails.
+     */
+    _call(input: Record<string, unknown>): Promise<ToolResponse>;
+}
+
+/**
+ * The HTTP MCP client class that connects to an MCP server using either Streamable HTTP or Server-Sent Events (SSE)
+ * transport.
+ * Note the client is stateful, meaning that developers should manually call the `connect()` and `close()` methods to
+ * manage the connection lifecycle.
+ */
+declare class HTTPMCPClient {
+    name: string;
+    private requestOptions?;
+    private client?;
+    private transport?;
+    private transportType;
+    private url;
+    private transportOpts?;
+    private stateful;
+    /**
+     * Initialize the HTTPStatefulMCPClient with the specified transport type, URL, and options.
+     *
+     * @param root0
+     * @param root0.name
+     * @param root0.transportType
+     * @param root0.url
+     * @param root0.stateful
+     * @param root0.transportOpts
+     * @param root0.requestOptions
+     */
+    constructor({ name, transportType, url, stateful, transportOpts, requestOptions, }: {
+        name: string;
+        transportType: 'streamable-http' | 'sse';
+        url: string;
+        stateful?: boolean;
+        transportOpts?: StreamableHTTPClientTransportOptions | SSEClientTransportOptions;
+        requestOptions?: RequestOptions;
+    });
+    /**
+     * Connect to the MCP server with the specified transport and URL. This method must be called before making any
+     * requests to the server.
+     */
+    connect(): Promise<void>;
+    /**
+     * The internal method to establish the connection to the MCP server. It initializes the appropriate transport
+     * based on the specified transport type and creates a new Client instance to manage the connection and requests.
+     */
+    protected _connect(): Promise<void>;
+    /**
+     * List all tools available on the MCP server.
+     *
+     * @returns An array of MCPTool instances representing the tools available on the server.
+     */
+    listTools(): Promise<MCPTool[]>;
+    /**
+     * Close the connection to the MCP server and clean up any resources used by the client.
+     */
+    close(): Promise<void>;
+    /**
+     * The internal method to close the connection to the MCP server.
+     */
+    protected _close(): Promise<void>;
+    /**
+     * Create a new client instance without storing it in this.client.
+     * Used for stateless operations where each request needs its own client.
+     * @returns A new connected Client instance
+     */
+    protected _createClient(): Promise<Client>;
+    /**
+     * Get a callable function for a specific tool by its name.
+     * @param root0
+     * @param root0.name
+     * @returns An instance of MCPTool that can be called to execute the tool's functionality.
+     */
+    getCallableFunction({ name }: {
+        name: string;
+    }): Promise<MCPTool>;
+}
+
+/**
+ * The STDIO MCP client class.
+ */
+declare class StdioMCPClient {
+    name: string;
+    private stdioServerParameters;
+    private transport?;
+    private client?;
+    /**
+     * Initialize the StdioMCPClient with the given Stdio parameters.
+     *
+     * @param root0
+     * @param root0.name
+     */
+    constructor({ name, ...rest }: {
+        name: string;
+    } & StdioServerParameters);
+    /**
+     * Connect to the MCP server using Stdio transport. Note the Stdio client will start an
+     * MCP server process under the hood.
+     */
+    connect(): Promise<void>;
+    /**
+     * Close the connection and stop the MCP server process.
+     */
+    close(): Promise<void>;
+    /**
+     * List all tools available on the MCP server.
+     *
+     * @returns An array of MCPTool instances representing the tools available on the server.
+     */
+    listTools(): Promise<MCPTool[]>;
+    /**
+     * Get a callable function for a specific tool by its name.
+     * @param root0
+     * @param root0.name
+     * @returns An instance of MCPTool that can be called to execute the tool's functionality.
+     */
+    getCallableFunction({ name }: {
+        name: string;
+    }): Promise<MCPTool>;
+}
+
+export { HTTPMCPClient as H, StdioMCPClient as S, type Tool as T, type ToolResponse as a };

package/dist/index-CAxQAkiP.d.mts

@@ -0,0 +1,21 @@
+type JSONSerializableObject = string | number | boolean | null | JSONSerializableObject[] | {
+    [key: string]: JSONSerializableObject;
+};
+type ToolName = string;
+type ToolChoice = 'auto' | 'none' | 'required' | ToolName;
+interface ToolInputSchema {
+    type: 'object';
+    properties?: Record<string, object>;
+    required?: string[];
+    [key: string]: unknown;
+}
+interface ToolSchema {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: ToolInputSchema;
+    };
+}
+
+export type { JSONSerializableObject as J, ToolSchema as T, ToolChoice as a, ToolInputSchema as b };

package/dist/index-CAxQAkiP.d.ts

@@ -0,0 +1,21 @@
+type JSONSerializableObject = string | number | boolean | null | JSONSerializableObject[] | {
+    [key: string]: JSONSerializableObject;
+};
+type ToolName = string;
+type ToolChoice = 'auto' | 'none' | 'required' | ToolName;
+interface ToolInputSchema {
+    type: 'object';
+    properties?: Record<string, object>;
+    required?: string[];
+    [key: string]: unknown;
+}
+interface ToolSchema {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: ToolInputSchema;
+    };
+}
+
+export type { JSONSerializableObject as J, ToolSchema as T, ToolChoice as a, ToolInputSchema as b };

package/dist/mcp/index.d.mts

@@ -0,0 +1,9 @@
+export { H as HTTPMCPClient, S as StdioMCPClient } from '../index-BTJDlKvQ.mjs';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/client/sse.js';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import '@modelcontextprotocol/sdk/shared/protocol.js';
+import 'zod';
+import '../index-CAxQAkiP.mjs';
+import '../block-VsnHrllL.mjs';
+import '@modelcontextprotocol/sdk/client/stdio.js';

package/dist/mcp/index.d.ts

@@ -0,0 +1,9 @@
+export { H as HTTPMCPClient, S as StdioMCPClient } from '../index-BcatlwXQ.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/client/sse.js';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import '@modelcontextprotocol/sdk/shared/protocol.js';
+import 'zod';
+import '../index-CAxQAkiP.js';
+import '../block-VsnHrllL.js';
+import '@modelcontextprotocol/sdk/client/stdio.js';