@agentscope-ai/agentscope 0.0.2 → 0.0.3

package/dist/mcp/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/http.ts","../../src/mcp/base.ts","../../src/tool/response.ts","../../src/mcp/stdio.ts"],"sourcesContent":["import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport {\n    SSEClientTransport,\n    SSEClientTransportOptions,\n} from '@modelcontextprotocol/sdk/client/sse.js';\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport type { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport { ListToolsRequest, ListToolsResultSchema, Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { MCPTool } from './base';\n\n/**\n * The HTTP MCP client class that connects to an MCP server using either Streamable HTTP or Server-Sent Events (SSE)\n * transport.\n * Note the client is stateful, meaning that developers should manually call the `connect()` and `close()` methods to\n * manage the connection lifecycle.\n */\nexport class HTTPMCPClient {\n    name: string;\n    private requestOptions?: RequestOptions;\n    private client?: Client;\n    private transport?: StreamableHTTPClientTransport | SSEClientTransport;\n    private transportType: 'streamable-http' | 'sse';\n    private url: string;\n    private transportOpts?: StreamableHTTPClientTransportOptions | SSEClientTransportOptions;\n    private stateful: boolean;\n\n    /**\n     * Initialize the HTTPStatefulMCPClient with the specified transport type, URL, and options.\n     *\n     * @param root0\n     * @param root0.name\n     * @param root0.transportType\n     * @param root0.url\n     * @param root0.stateful\n     * @param root0.transportOpts\n     * @param root0.requestOptions\n     */\n    constructor({\n        name,\n        transportType,\n        url,\n        stateful = true,\n        transportOpts,\n        requestOptions,\n    }: {\n        name: string;\n        transportType: 'streamable-http' | 'sse';\n        url: string;\n        stateful?: boolean;\n        transportOpts?: StreamableHTTPClientTransportOptions | SSEClientTransportOptions;\n        requestOptions?: RequestOptions;\n    }) {\n        this.name = name;\n        this.transportType = transportType;\n        this.transportOpts = transportOpts;\n        this.requestOptions = requestOptions;\n        this.url = url;\n        this.stateful = stateful;\n    }\n\n    /**\n     * Connect to the MCP server with the specified transport and URL. This method must be called before making any\n     * requests to the server.\n     */\n    async connect() {\n        if (!this.stateful) {\n            console.log(\n                `MCP client '${this.name}' initialized with stateful=false will connect and close the connection automatically for each request, no need to call 'connect()' method explicitly.`\n            );\n        } else {\n            await this._connect();\n        }\n    }\n\n    /**\n     * The internal method to establish the connection to the MCP server. It initializes the appropriate transport\n     * based on the specified transport type and creates a new Client instance to manage the connection and requests.\n     */\n    protected async _connect() {\n        const baseUrl = new URL(this.url);\n        if (this.transportType === 'streamable-http') {\n            this.transport = new StreamableHTTPClientTransport(baseUrl, this.transportOpts);\n        } else {\n            this.transport = new SSEClientTransport(baseUrl, this.transportOpts);\n        }\n        this.client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await this.client.connect(this.transport, this.requestOptions);\n        console.log(`MCP client '${this.name}' is connected`);\n    }\n\n    /**\n     * List all tools available on the MCP server.\n     *\n     * @returns An array of MCPTool instances representing the tools available on the server.\n     */\n    async listTools(): Promise<MCPTool[]> {\n        let listClient: Client;\n\n        if (this.stateful) {\n            if (!this.client) {\n                throw new Error(\n                    `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n                );\n            }\n            listClient = this.client;\n        } else {\n            listClient = await this._createClient();\n        }\n\n        try {\n            const toolsRequest: ListToolsRequest = {\n                method: 'tools/list',\n                params: {},\n            };\n\n            const toolsResult = await listClient.request(toolsRequest, ListToolsResultSchema);\n            if (toolsResult.tools === undefined) {\n                return [];\n            }\n\n            return toolsResult.tools.map((tool: Tool) => {\n                if (this.stateful) {\n                    return new MCPTool({\n                        name: tool.name,\n                        description: tool.description || '',\n                        inputSchema: tool.inputSchema,\n                        getClient: async () => this.client!,\n                        releaseClient: async () => {},\n                    });\n                } else {\n                    return new MCPTool({\n                        name: tool.name,\n                        description: tool.description || '',\n                        inputSchema: tool.inputSchema,\n                        getClient: () => this._createClient(),\n                        releaseClient: async (c: Client) => {\n                            await c.close();\n                        },\n                    });\n                }\n            });\n        } finally {\n            if (!this.stateful) {\n                await listClient.close();\n            }\n        }\n    }\n\n    /**\n     * Close the connection to the MCP server and clean up any resources used by the client.\n     */\n    async close() {\n        if (!this.stateful) {\n            console.log(\n                `MCP client '${this.name}' initialized with stateful=false will connect and close the connection automatically for each request, no need to call 'close()' method explicitly.`\n            );\n        } else {\n            await this._close();\n        }\n    }\n\n    /**\n     * The internal method to close the connection to the MCP server.\n     */\n    protected async _close() {\n        try {\n            await this.client?.close();\n        } finally {\n            console.log(`MCP client '${this.name} is closed.'`);\n            this.client = undefined;\n            this.transport = undefined;\n        }\n    }\n\n    /**\n     * Create a new client instance without storing it in this.client.\n     * Used for stateless operations where each request needs its own client.\n     * @returns A new connected Client instance\n     */\n    protected async _createClient(): Promise<Client> {\n        const baseUrl = new URL(this.url);\n        const transport =\n            this.transportType === 'streamable-http'\n                ? new StreamableHTTPClientTransport(baseUrl, this.transportOpts)\n                : new SSEClientTransport(baseUrl, this.transportOpts);\n\n        const client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await client.connect(transport, this.requestOptions);\n        return client;\n    }\n\n    /**\n     * Get a callable function for a specific tool by its name.\n     * @param root0\n     * @param root0.name\n     * @returns An instance of MCPTool that can be called to execute the tool's functionality.\n     */\n    async getCallableFunction({ name }: { name: string }) {\n        if (this.stateful && !this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const tools = await this.listTools();\n        const targetTool = tools.find(tool => tool.name === name);\n\n        if (!targetTool) {\n            throw new Error(\n                `Tool '${name}' not found in MCP server '${this.name}'. Available tools: ${tools.map(t => t.name).join(', ')}`\n            );\n        }\n\n        return targetTool;\n    }\n}\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { CallToolRequest, CallToolResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport z from 'zod';\n\nimport { Tool, ToolResponse } from '../tool';\nimport { createToolResponse } from '../tool/response';\nimport { ToolInputSchema } from '../type';\n\n/**\n * Type definition for getting a client instance\n */\ntype GetClient = () => Promise<Client>;\n\n/**\n * Type definition for releasing a client instance\n */\ntype ReleaseClient = (client: Client) => Promise<void>;\n\n/**\n * MCPTool class that wraps an MCP tool and provides a callable interface\n */\nexport class MCPTool implements Tool {\n    name: string;\n    description: string;\n    inputSchema: z.ZodObject | ToolInputSchema;\n    requireUserConfirm = false;\n    call: (input: Record<string, unknown>) => Promise<ToolResponse>;\n\n    private getClient: GetClient;\n    private releaseClient: ReleaseClient;\n\n    /**\n     * Initialize an MCPTool instance\n     * @param root0\n     * @param root0.name\n     * @param root0.description\n     * @param root0.inputSchema\n     * @param root0.getClient\n     * @param root0.releaseClient\n     */\n    constructor({\n        name,\n        description,\n        inputSchema,\n        getClient,\n        releaseClient,\n    }: {\n        name: string;\n        description: string;\n        inputSchema: z.ZodObject | ToolInputSchema;\n        getClient: GetClient;\n        releaseClient: ReleaseClient;\n    }) {\n        this.name = name;\n        this.description = description;\n        this.inputSchema = inputSchema;\n        this.getClient = getClient;\n        this.releaseClient = releaseClient;\n        this.call = this._call.bind(this);\n    }\n\n    /**\n     * Call the MCP tool with the specified input arguments. This method sends a request to the MCP server to execute\n     * the tool and returns the result as a ToolResponse.\n     *\n     * @param arguments\n     * @param input\n     * @returns A ToolResponse object containing the result of the tool execution, or an error message if the call fails.\n     */\n    async _call(input: Record<string, unknown>) {\n        const client = await this.getClient();\n        try {\n            const request: CallToolRequest = {\n                method: 'tools/call',\n                params: {\n                    name: this.name,\n                    arguments: input,\n                },\n            };\n            const result = await client.request(request, CallToolResultSchema);\n\n            const content: ToolResponse['content'] = [];\n            result.content.forEach(item => {\n                if (item.type === 'text') {\n                    content.push({ type: 'text', text: item.text, id: crypto.randomUUID() });\n                } else if (item.type === 'image' || item.type === 'audio') {\n                    content.push({\n                        id: crypto.randomUUID(),\n                        type: 'data',\n                        source: { type: 'base64', mediaType: item.mimeType, data: item.data },\n                    });\n                } else {\n                    console.warn(\n                        `Unsupported content type '${item.type}' in tool result, skipping...`\n                    );\n                }\n            });\n            return createToolResponse({ content, state: 'success' });\n        } catch (error) {\n            return createToolResponse({\n                content: [\n                    {\n                        id: crypto.randomUUID(),\n                        type: 'text',\n                        text: `Error calling tool '${this.name}': ${error}`,\n                    },\n                ],\n                state: 'error',\n            });\n        } finally {\n            await this.releaseClient(client);\n        }\n    }\n}\n","import { DataBlock, TextBlock } from '../message';\nimport { JSONSerializableObject } from '../type';\n\n/**\n * The tool response structure.\n */\nexport interface ToolResponse {\n    content: Array<TextBlock | DataBlock>;\n    id: string;\n    createdAt: string;\n    metadata: Record<string, JSONSerializableObject>;\n    state: 'success' | 'error' | 'interrupted' | 'running';\n    isLast: boolean;\n    isInterrupted: boolean;\n}\n\n/**\n * Create a tool response object with the given parameters.\n *\n * @param root0\n * @param root0.content\n * @param root0.state\n * @param root0.id\n * @param root0.createdAt\n * @param root0.metadata\n * @param root0.stream\n * @param root0.isLast\n * @param root0.isInterrupted\n * @returns A ToolResponse object\n */\nexport function createToolResponse({\n    content,\n    state,\n    id = crypto.randomUUID(),\n    createdAt = new Date().toISOString(),\n    metadata = {},\n    stream = false,\n    isLast = true,\n    isInterrupted = false,\n}: {\n    content: Array<TextBlock | DataBlock>;\n    state: 'success' | 'error' | 'interrupted' | 'running';\n    id?: string;\n    createdAt?: string;\n    metadata?: Record<string, JSONSerializableObject>;\n    stream?: boolean;\n    isLast?: boolean;\n    isInterrupted?: boolean;\n}) {\n    return {\n        content,\n        id,\n        createdAt,\n        metadata,\n        state,\n        stream,\n        isLast,\n        isInterrupted,\n    } as ToolResponse;\n}\n\n/**\n * If the given object conforms to the ToolResponse structure.\n *\n * @param obj\n * @returns True if the object is a ToolResponse, false otherwise\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function isToolResponse(obj: any): boolean {\n    return (\n        obj &&\n        typeof obj === 'object' &&\n        typeof obj.id === 'string' &&\n        typeof obj.createdAt === 'string' &&\n        Array.isArray(obj.content) &&\n        typeof obj.metadata === 'object' &&\n        typeof obj.stream === 'boolean' &&\n        typeof obj.isLast === 'boolean' &&\n        typeof obj.isInterrupted === 'boolean' &&\n        ['success', 'error', 'interrupted', 'running'].includes(obj.state)\n    );\n}\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport {\n    StdioClientTransport,\n    StdioServerParameters,\n} from '@modelcontextprotocol/sdk/client/stdio.js';\nimport { ListToolsRequest, ListToolsResultSchema, Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { MCPTool } from './base';\n\n/**\n * The STDIO MCP client class.\n */\nexport class StdioMCPClient {\n    name: string;\n    private stdioServerParameters: StdioServerParameters;\n    private transport?: StdioClientTransport;\n    private client?: Client;\n\n    /**\n     * Initialize the StdioMCPClient with the given Stdio parameters.\n     *\n     * @param root0\n     * @param root0.name\n     */\n    constructor({\n        name,\n        ...rest\n    }: {\n        name: string;\n    } & StdioServerParameters) {\n        this.name = name;\n        this.stdioServerParameters = rest;\n    }\n\n    /**\n     * Connect to the MCP server using Stdio transport. Note the Stdio client will start an\n     * MCP server process under the hood.\n     */\n    async connect() {\n        this.transport = new StdioClientTransport(this.stdioServerParameters);\n        this.client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await this.client.connect(this.transport);\n    }\n\n    /**\n     * Close the connection and stop the MCP server process.\n     */\n    async close() {\n        try {\n            if (this.client) {\n                await this.client.close();\n            }\n        } finally {\n            this.client = undefined;\n            this.transport = undefined;\n        }\n    }\n\n    /**\n     * List all tools available on the MCP server.\n     *\n     * @returns An array of MCPTool instances representing the tools available on the server.\n     */\n    async listTools(): Promise<MCPTool[]> {\n        if (!this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const toolsRequest: ListToolsRequest = {\n            method: 'tools/list',\n            params: {},\n        };\n\n        const toolsResult = await this.client.request(toolsRequest, ListToolsResultSchema);\n        if (toolsResult.tools === undefined) {\n            return [];\n        }\n\n        return toolsResult.tools.map((tool: Tool) => {\n            return new MCPTool({\n                name: tool.name,\n                description: tool.description || '',\n                inputSchema: tool.inputSchema,\n                getClient: async () => this.client!,\n                releaseClient: async () => {},\n            });\n        });\n    }\n\n    /**\n     * Get a callable function for a specific tool by its name.\n     * @param root0\n     * @param root0.name\n     * @returns An instance of MCPTool that can be called to execute the tool's functionality.\n     */\n    async getCallableFunction({ name }: { name: string }) {\n        if (!this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const tools = await this.listTools();\n        const targetTool = tools.find(tool => tool.name === name);\n\n        if (!targetTool) {\n            throw new Error(\n                `Tool '${name}' not found in MCP server '${this.name}'. Available tools: ${tools.map(t => t.name).join(', ')}`\n            );\n        }\n\n        return targetTool;\n    }\n}\n"],"mappings":"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","names":["Client","ListToolsResultSchema","Client","ListToolsResultSchema"]}
+{"version":3,"sources":["../../src/mcp/http.ts","../../src/mcp/base.ts","../../src/tool/response.ts","../../src/mcp/stdio.ts"],"sourcesContent":["import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport {\n    SSEClientTransport,\n    SSEClientTransportOptions,\n} from '@modelcontextprotocol/sdk/client/sse.js';\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport type { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport { ListToolsRequest, ListToolsResultSchema, Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { MCPTool } from './base';\n\n/**\n * The HTTP MCP client class that connects to an MCP server using either Streamable HTTP or Server-Sent Events (SSE)\n * transport.\n * Note the client is stateful, meaning that developers should manually call the `connect()` and `close()` methods to\n * manage the connection lifecycle.\n */\nexport class HTTPMCPClient {\n    name: string;\n    private requestOptions?: RequestOptions;\n    private client?: Client;\n    private transport?: StreamableHTTPClientTransport | SSEClientTransport;\n    private transportType: 'streamable-http' | 'sse';\n    private url: string;\n    private transportOpts?: StreamableHTTPClientTransportOptions | SSEClientTransportOptions;\n    private stateful: boolean;\n\n    /**\n     * Initialize the HTTPStatefulMCPClient with the specified transport type, URL, and options.\n     *\n     * @param root0\n     * @param root0.name\n     * @param root0.transportType\n     * @param root0.url\n     * @param root0.stateful\n     * @param root0.transportOpts\n     * @param root0.requestOptions\n     */\n    constructor({\n        name,\n        transportType,\n        url,\n        stateful = true,\n        transportOpts,\n        requestOptions,\n    }: {\n        name: string;\n        transportType: 'streamable-http' | 'sse';\n        url: string;\n        stateful?: boolean;\n        transportOpts?: StreamableHTTPClientTransportOptions | SSEClientTransportOptions;\n        requestOptions?: RequestOptions;\n    }) {\n        this.name = name;\n        this.transportType = transportType;\n        this.transportOpts = transportOpts;\n        this.requestOptions = requestOptions;\n        this.url = url;\n        this.stateful = stateful;\n    }\n\n    /**\n     * Connect to the MCP server with the specified transport and URL. This method must be called before making any\n     * requests to the server.\n     */\n    async connect() {\n        if (!this.stateful) {\n            console.log(\n                `MCP client '${this.name}' initialized with stateful=false will connect and close the connection automatically for each request, no need to call 'connect()' method explicitly.`\n            );\n        } else {\n            await this._connect();\n        }\n    }\n\n    /**\n     * The internal method to establish the connection to the MCP server. It initializes the appropriate transport\n     * based on the specified transport type and creates a new Client instance to manage the connection and requests.\n     */\n    protected async _connect() {\n        const baseUrl = new URL(this.url);\n        if (this.transportType === 'streamable-http') {\n            this.transport = new StreamableHTTPClientTransport(baseUrl, this.transportOpts);\n        } else {\n            this.transport = new SSEClientTransport(baseUrl, this.transportOpts);\n        }\n        this.client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await this.client.connect(this.transport, this.requestOptions);\n        console.log(`MCP client '${this.name}' is connected`);\n    }\n\n    /**\n     * List all tools available on the MCP server.\n     *\n     * @returns An array of MCPTool instances representing the tools available on the server.\n     */\n    async listTools(): Promise<MCPTool[]> {\n        let listClient: Client;\n\n        if (this.stateful) {\n            if (!this.client) {\n                throw new Error(\n                    `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n                );\n            }\n            listClient = this.client;\n        } else {\n            listClient = await this._createClient();\n        }\n\n        try {\n            const toolsRequest: ListToolsRequest = {\n                method: 'tools/list',\n                params: {},\n            };\n\n            const toolsResult = await listClient.request(toolsRequest, ListToolsResultSchema);\n            if (toolsResult.tools === undefined) {\n                return [];\n            }\n\n            return toolsResult.tools.map((tool: Tool) => {\n                if (this.stateful) {\n                    return new MCPTool({\n                        name: tool.name,\n                        description: tool.description || '',\n                        inputSchema: tool.inputSchema,\n                        getClient: async () => this.client!,\n                        releaseClient: async () => {},\n                    });\n                } else {\n                    return new MCPTool({\n                        name: tool.name,\n                        description: tool.description || '',\n                        inputSchema: tool.inputSchema,\n                        getClient: () => this._createClient(),\n                        releaseClient: async (c: Client) => {\n                            await c.close();\n                        },\n                    });\n                }\n            });\n        } finally {\n            if (!this.stateful) {\n                await listClient.close();\n            }\n        }\n    }\n\n    /**\n     * Close the connection to the MCP server and clean up any resources used by the client.\n     */\n    async close() {\n        if (!this.stateful) {\n            console.log(\n                `MCP client '${this.name}' initialized with stateful=false will connect and close the connection automatically for each request, no need to call 'close()' method explicitly.`\n            );\n        } else {\n            await this._close();\n        }\n    }\n\n    /**\n     * The internal method to close the connection to the MCP server.\n     */\n    protected async _close() {\n        try {\n            await this.client?.close();\n        } finally {\n            console.log(`MCP client '${this.name} is closed.'`);\n            this.client = undefined;\n            this.transport = undefined;\n        }\n    }\n\n    /**\n     * Create a new client instance without storing it in this.client.\n     * Used for stateless operations where each request needs its own client.\n     * @returns A new connected Client instance\n     */\n    protected async _createClient(): Promise<Client> {\n        const baseUrl = new URL(this.url);\n        const transport =\n            this.transportType === 'streamable-http'\n                ? new StreamableHTTPClientTransport(baseUrl, this.transportOpts)\n                : new SSEClientTransport(baseUrl, this.transportOpts);\n\n        const client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await client.connect(transport, this.requestOptions);\n        return client;\n    }\n\n    /**\n     * Get a callable function for a specific tool by its name.\n     * @param root0\n     * @param root0.name\n     * @returns An instance of MCPTool that can be called to execute the tool's functionality.\n     */\n    async getCallableFunction({ name }: { name: string }) {\n        if (this.stateful && !this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const tools = await this.listTools();\n        const targetTool = tools.find(tool => tool.name === name);\n\n        if (!targetTool) {\n            throw new Error(\n                `Tool '${name}' not found in MCP server '${this.name}'. Available tools: ${tools.map(t => t.name).join(', ')}`\n            );\n        }\n\n        return targetTool;\n    }\n}\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { CallToolRequest, CallToolResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport z from 'zod';\n\nimport { Tool, ToolResponse } from '../tool';\nimport { createToolResponse } from '../tool/response';\nimport { ToolInputSchema } from '../type';\n\n/**\n * Type definition for getting a client instance\n */\ntype GetClient = () => Promise<Client>;\n\n/**\n * Type definition for releasing a client instance\n */\ntype ReleaseClient = (client: Client) => Promise<void>;\n\n/**\n * MCPTool class that wraps an MCP tool and provides a callable interface\n */\nexport class MCPTool implements Tool {\n    name: string;\n    description: string;\n    inputSchema: z.ZodObject | ToolInputSchema;\n    requireUserConfirm = false;\n    call: (input: Record<string, unknown>) => Promise<ToolResponse>;\n\n    private getClient: GetClient;\n    private releaseClient: ReleaseClient;\n\n    /**\n     * Initialize an MCPTool instance\n     * @param root0\n     * @param root0.name\n     * @param root0.description\n     * @param root0.inputSchema\n     * @param root0.getClient\n     * @param root0.releaseClient\n     */\n    constructor({\n        name,\n        description,\n        inputSchema,\n        getClient,\n        releaseClient,\n    }: {\n        name: string;\n        description: string;\n        inputSchema: z.ZodObject | ToolInputSchema;\n        getClient: GetClient;\n        releaseClient: ReleaseClient;\n    }) {\n        this.name = name;\n        this.description = description;\n        this.inputSchema = inputSchema;\n        this.getClient = getClient;\n        this.releaseClient = releaseClient;\n        this.call = this._call.bind(this);\n    }\n\n    /**\n     * Call the MCP tool with the specified input arguments. This method sends a request to the MCP server to execute\n     * the tool and returns the result as a ToolResponse.\n     *\n     * @param arguments\n     * @param input\n     * @returns A ToolResponse object containing the result of the tool execution, or an error message if the call fails.\n     */\n    async _call(input: Record<string, unknown>) {\n        const client = await this.getClient();\n        try {\n            const request: CallToolRequest = {\n                method: 'tools/call',\n                params: {\n                    name: this.name,\n                    arguments: input,\n                },\n            };\n            const result = await client.request(request, CallToolResultSchema);\n\n            const content: ToolResponse['content'] = [];\n            result.content.forEach(item => {\n                if (item.type === 'text') {\n                    content.push({ type: 'text', text: item.text, id: crypto.randomUUID() });\n                } else if (item.type === 'image' || item.type === 'audio') {\n                    content.push({\n                        id: crypto.randomUUID(),\n                        type: 'data',\n                        source: { type: 'base64', media_type: item.mimeType, data: item.data },\n                    });\n                } else {\n                    console.warn(\n                        `Unsupported content type '${item.type}' in tool result, skipping...`\n                    );\n                }\n            });\n            return createToolResponse({ content, state: 'success' });\n        } catch (error) {\n            return createToolResponse({\n                content: [\n                    {\n                        id: crypto.randomUUID(),\n                        type: 'text',\n                        text: `Error calling tool '${this.name}': ${error}`,\n                    },\n                ],\n                state: 'error',\n            });\n        } finally {\n            await this.releaseClient(client);\n        }\n    }\n}\n","import { DataBlock, TextBlock } from '../message';\nimport { JSONSerializableObject } from '../type';\n\n/**\n * The tool response structure.\n */\nexport interface ToolResponse {\n    content: Array<TextBlock | DataBlock>;\n    id: string;\n    createdAt: string;\n    metadata: Record<string, JSONSerializableObject>;\n    state: 'success' | 'error' | 'interrupted' | 'running';\n    isLast: boolean;\n    isInterrupted: boolean;\n}\n\n/**\n * Create a tool response object with the given parameters.\n *\n * @param root0\n * @param root0.content\n * @param root0.state\n * @param root0.id\n * @param root0.createdAt\n * @param root0.metadata\n * @param root0.stream\n * @param root0.isLast\n * @param root0.isInterrupted\n * @returns A ToolResponse object\n */\nexport function createToolResponse({\n    content,\n    state,\n    id = crypto.randomUUID(),\n    createdAt = new Date().toISOString(),\n    metadata = {},\n    stream = false,\n    isLast = true,\n    isInterrupted = false,\n}: {\n    content: Array<TextBlock | DataBlock>;\n    state: 'success' | 'error' | 'interrupted' | 'running';\n    id?: string;\n    createdAt?: string;\n    metadata?: Record<string, JSONSerializableObject>;\n    stream?: boolean;\n    isLast?: boolean;\n    isInterrupted?: boolean;\n}) {\n    return {\n        content,\n        id,\n        createdAt,\n        metadata,\n        state,\n        stream,\n        isLast,\n        isInterrupted,\n    } as ToolResponse;\n}\n\n/**\n * If the given object conforms to the ToolResponse structure.\n *\n * @param obj\n * @returns True if the object is a ToolResponse, false otherwise\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function isToolResponse(obj: any): boolean {\n    return (\n        obj &&\n        typeof obj === 'object' &&\n        typeof obj.id === 'string' &&\n        typeof obj.createdAt === 'string' &&\n        Array.isArray(obj.content) &&\n        typeof obj.metadata === 'object' &&\n        typeof obj.stream === 'boolean' &&\n        typeof obj.isLast === 'boolean' &&\n        typeof obj.isInterrupted === 'boolean' &&\n        ['success', 'error', 'interrupted', 'running'].includes(obj.state)\n    );\n}\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport {\n    StdioClientTransport,\n    StdioServerParameters,\n} from '@modelcontextprotocol/sdk/client/stdio.js';\nimport { ListToolsRequest, ListToolsResultSchema, Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { MCPTool } from './base';\n\n/**\n * The STDIO MCP client class.\n */\nexport class StdioMCPClient {\n    name: string;\n    private stdioServerParameters: StdioServerParameters;\n    private transport?: StdioClientTransport;\n    private client?: Client;\n\n    /**\n     * Initialize the StdioMCPClient with the given Stdio parameters.\n     *\n     * @param root0\n     * @param root0.name\n     */\n    constructor({\n        name,\n        ...rest\n    }: {\n        name: string;\n    } & StdioServerParameters) {\n        this.name = name;\n        this.stdioServerParameters = rest;\n    }\n\n    /**\n     * Connect to the MCP server using Stdio transport. Note the Stdio client will start an\n     * MCP server process under the hood.\n     */\n    async connect() {\n        this.transport = new StdioClientTransport(this.stdioServerParameters);\n        this.client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await this.client.connect(this.transport);\n    }\n\n    /**\n     * Close the connection and stop the MCP server process.\n     */\n    async close() {\n        try {\n            if (this.client) {\n                await this.client.close();\n            }\n        } finally {\n            this.client = undefined;\n            this.transport = undefined;\n        }\n    }\n\n    /**\n     * List all tools available on the MCP server.\n     *\n     * @returns An array of MCPTool instances representing the tools available on the server.\n     */\n    async listTools(): Promise<MCPTool[]> {\n        if (!this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const toolsRequest: ListToolsRequest = {\n            method: 'tools/list',\n            params: {},\n        };\n\n        const toolsResult = await this.client.request(toolsRequest, ListToolsResultSchema);\n        if (toolsResult.tools === undefined) {\n            return [];\n        }\n\n        return toolsResult.tools.map((tool: Tool) => {\n            return new MCPTool({\n                name: tool.name,\n                description: tool.description || '',\n                inputSchema: tool.inputSchema,\n                getClient: async () => this.client!,\n                releaseClient: async () => {},\n            });\n        });\n    }\n\n    /**\n     * Get a callable function for a specific tool by its name.\n     * @param root0\n     * @param root0.name\n     * @returns An instance of MCPTool that can be called to execute the tool's functionality.\n     */\n    async getCallableFunction({ name }: { name: string }) {\n        if (!this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const tools = await this.listTools();\n        const targetTool = tools.find(tool => tool.name === name);\n\n        if (!targetTool) {\n            throw new Error(\n                `Tool '${name}' not found in MCP server '${this.name}'. Available tools: ${tools.map(t => t.name).join(', ')}`\n            );\n        }\n\n        return targetTool;\n    }\n}\n"],"mappings":"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","names":["Client","ListToolsResultSchema","Client","ListToolsResultSchema"]}

package/dist/message/index.d.mts

@@ -1,5 +1,5 @@
-export { M as Msg, c as createMsg, g as getContentBlocks, a as getTextContent } from '../message-CkN21KaY.mjs';
-export { B as Base64Source, C as ContentBlock, D as DataBlock, T as TextBlock, a as ThinkingBlock, b as ToolCallBlock, c as ToolResultBlock, U as URLSource } from '../block-VsnHrllL.mjs';
+export { A as AssistantMsg, M as Msg, S as SystemMsg, U as UserMsg, c as createMsg, g as getContentBlocks, a as getTextContent } from '../message-CYnHiEVt.mjs';
+export { B as Base64Source, C as ContentBlock, D as DataBlock, T as TextBlock, a as ThinkingBlock, b as ToolCallBlock, c as ToolResultBlock, U as URLSource } from '../block-7fd6byyN.mjs';
 import '../index-CAxQAkiP.mjs';
 
 declare enum GenerateReason {

package/dist/message/index.d.ts

@@ -1,5 +1,5 @@
-export { M as Msg, c as createMsg, g as getContentBlocks, a as getTextContent } from '../message-CzLeTlua.js';
-export { B as Base64Source, C as ContentBlock, D as DataBlock, T as TextBlock, a as ThinkingBlock, b as ToolCallBlock, c as ToolResultBlock, U as URLSource } from '../block-VsnHrllL.js';
+export { A as AssistantMsg, M as Msg, S as SystemMsg, U as UserMsg, c as createMsg, g as getContentBlocks, a as getTextContent } from '../message-DZN7LetB.js';
+export { B as Base64Source, C as ContentBlock, D as DataBlock, T as TextBlock, a as ThinkingBlock, b as ToolCallBlock, c as ToolResultBlock, U as URLSource } from '../block-7fd6byyN.js';
 import '../index-CAxQAkiP.js';
 
 declare enum GenerateReason {

package/dist/message/index.js

@@ -20,7 +20,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/message/index.ts
 var message_exports = {};
 __export(message_exports, {
+  AssistantMsg: () => AssistantMsg,
   GenerateReason: () => GenerateReason,
+  SystemMsg: () => SystemMsg,
+  UserMsg: () => UserMsg,
   createMsg: () => createMsg,
   getContentBlocks: () => getContentBlocks,
   getTextContent: () => getTextContent
@@ -34,16 +37,44 @@ function createMsg({
   role,
   metadata = {},
   id = crypto.randomUUID(),
-  timestamp = (/* @__PURE__ */ new Date()).toISOString(),
+  created_at = (/* @__PURE__ */ new Date()).toISOString(),
+  finished_at,
   usage
 }) {
-  return { id, name, role, content, metadata, timestamp, usage };
+  const contentBlocks = typeof content === "string" ? [{ id: crypto.randomUUID(), type: "text", text: content }] : content;
+  return { id, name, role, content: contentBlocks, metadata, created_at, finished_at, usage };
+}
+function UserMsg({
+  name,
+  content,
+  metadata = {},
+  id = crypto.randomUUID(),
+  created_at = (/* @__PURE__ */ new Date()).toISOString()
+}) {
+  return createMsg({ name, content, role: "user", metadata, id, created_at });
+}
+function AssistantMsg({
+  name,
+  content,
+  metadata = {},
+  id = crypto.randomUUID(),
+  created_at = (/* @__PURE__ */ new Date()).toISOString(),
+  usage
+}) {
+  return createMsg({ name, content, role: "assistant", metadata, id, created_at, usage });
+}
+function SystemMsg({
+  name,
+  content,
+  metadata = {},
+  id = crypto.randomUUID(),
+  created_at = (/* @__PURE__ */ new Date()).toISOString()
+}) {
+  return createMsg({ name, content, role: "system", metadata, id, created_at });
 }
 function getTextContent(msg, separator = "\n") {
   const textBlocks = msg.content.filter((block) => block.type === "text");
-  if (textBlocks.length === 0) {
-    return null;
-  }
+  if (textBlocks.length === 0) return null;
   return textBlocks.map((block) => block.text).join(separator);
 }
 function getContentBlocks(msg, blockType) {
@@ -59,7 +90,10 @@ var GenerateReason = /* @__PURE__ */ ((GenerateReason2) => {
 })(GenerateReason || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AssistantMsg,
   GenerateReason,
+  SystemMsg,
+  UserMsg,
   createMsg,
   getContentBlocks,
   getTextContent

package/dist/message/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/message/index.ts","../../src/message/message.ts","../../src/message/enums.ts"],"sourcesContent":["export { Msg, createMsg, getTextContent, getContentBlocks } from './message';\nexport {\n    TextBlock,\n    ThinkingBlock,\n    ToolCallBlock,\n    ToolResultBlock,\n    ContentBlock,\n    Base64Source,\n    URLSource,\n    DataBlock,\n} from './block';\nexport { GenerateReason } from './enums';\n","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","export enum GenerateReason {\n    AWAITING_TOOL_RESULT = 'AWAITING_TOOL_RESULT',\n    AWAITING_USER_CONFIRMATION = 'AWAITING_USER_CONFIRMATION',\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4CO,SAAS,UAAU;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,EACnC;AACJ,GAC8D;AAC1D,SAAO,EAAE,IAAI,MAAM,MAAM,SAAS,UAAU,WAAW,MAAM;AACjE;AAYO,SAAS,eAAe,KAAU,YAAoB,MAAqB;AAC9E,QAAM,aAAa,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,MAAM;AACpE,MAAI,WAAW,WAAW,GAAG;AACzB,WAAO;AAAA,EACX;AACA,SAAO,WAAW,IAAI,WAAU,MAAoB,IAAI,EAAE,KAAK,SAAS;AAC5E;AAmDO,SAAS,iBACZ,KACA,WACc;AACd,MAAI,CAAC,UAAW,QAAO,IAAI;AAC3B,SAAO,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,SAAS;AAC/D;;;AClIO,IAAK,iBAAL,kBAAKA,oBAAL;AACH,EAAAA,gBAAA,0BAAuB;AACvB,EAAAA,gBAAA,gCAA6B;AAFrB,SAAAA;AAAA,GAAA;","names":["GenerateReason"]}
+{"version":3,"sources":["../../src/message/index.ts","../../src/message/message.ts","../../src/message/enums.ts"],"sourcesContent":["export {\n    Msg,\n    createMsg,\n    UserMsg,\n    AssistantMsg,\n    SystemMsg,\n    getTextContent,\n    getContentBlocks,\n} from './message';\nexport {\n    TextBlock,\n    ThinkingBlock,\n    ToolCallBlock,\n    ToolResultBlock,\n    ContentBlock,\n    Base64Source,\n    URLSource,\n    DataBlock,\n} from './block';\nexport { GenerateReason } from './enums';\n","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    created_at: string;\n    /** ISO-8601 finished timestamp. */\n    finished_at?: string | null;\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 `created_at` when omitted.\n * A plain string `content` is automatically wrapped in a single {@link TextBlock}.\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.created_at\n * @param root0.finished_at\n * @param root0.usage\n * @returns A Msg object.\n */\nexport function createMsg({\n    name,\n    content,\n    role,\n    metadata = {},\n    id = crypto.randomUUID(),\n    created_at = new Date().toISOString(),\n    finished_at,\n    usage,\n}: Omit<Msg, 'id' | 'created_at' | 'metadata' | 'content'> &\n    Partial<Pick<Msg, 'id' | 'created_at' | 'metadata'>> & {\n        content: string | ContentBlock[];\n    }): Msg {\n    const contentBlocks: ContentBlock[] =\n        typeof content === 'string'\n            ? [{ id: crypto.randomUUID(), type: 'text', text: content } as TextBlock]\n            : content;\n    return { id, name, role, content: contentBlocks, metadata, created_at, finished_at, usage };\n}\n\n/**\n * Create a user {@link Msg}.\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.metadata\n * @param root0.id\n * @param root0.created_at\n * @returns A Msg object with role 'user'.\n */\nexport function UserMsg({\n    name,\n    content,\n    metadata = {},\n    id = crypto.randomUUID(),\n    created_at = new Date().toISOString(),\n}: {\n    name: string;\n    content: string | ContentBlock[];\n    metadata?: Record<string, JSONSerializableObject>;\n    id?: string;\n    created_at?: string;\n}): Msg {\n    return createMsg({ name, content, role: 'user', metadata, id, created_at });\n}\n\n/**\n * Create an assistant {@link Msg}.\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.metadata\n * @param root0.id\n * @param root0.created_at\n * @param root0.usage\n * @returns A Msg object with role 'assistant'.\n */\nexport function AssistantMsg({\n    name,\n    content,\n    metadata = {},\n    id = crypto.randomUUID(),\n    created_at = new Date().toISOString(),\n    usage,\n}: {\n    name: string;\n    content: string | ContentBlock[];\n    metadata?: Record<string, JSONSerializableObject>;\n    id?: string;\n    created_at?: string;\n    usage?: Msg['usage'];\n}): Msg {\n    return createMsg({ name, content, role: 'assistant', metadata, id, created_at, usage });\n}\n\n/**\n * Create a system {@link Msg}.\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.metadata\n * @param root0.id\n * @param root0.created_at\n * @returns A Msg object with role 'system'.\n */\nexport function SystemMsg({\n    name,\n    content,\n    metadata = {},\n    id = crypto.randomUUID(),\n    created_at = new Date().toISOString(),\n}: {\n    name: string;\n    content: string | ContentBlock[];\n    metadata?: Record<string, JSONSerializableObject>;\n    id?: string;\n    created_at?: string;\n}): Msg {\n    return createMsg({ name, content, role: 'system', metadata, id, created_at });\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) return null;\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[];\nexport function getContentBlocks(msg: Msg, blockType: 'text'): TextBlock[];\nexport function getContentBlocks(msg: Msg, blockType: 'thinking'): ThinkingBlock[];\nexport function getContentBlocks(msg: Msg, blockType: 'data'): DataBlock[];\nexport function getContentBlocks(msg: Msg, blockType: 'tool_call'): ToolCallBlock[];\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","export enum GenerateReason {\n    AWAITING_TOOL_RESULT = 'AWAITING_TOOL_RESULT',\n    AWAITING_USER_CONFIRMATION = 'AWAITING_USER_CONFIRMATION',\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC+CO,SAAS,UAAU;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AAAA,EACA;AACJ,GAGY;AACR,QAAM,gBACF,OAAO,YAAY,WACb,CAAC,EAAE,IAAI,OAAO,WAAW,GAAG,MAAM,QAAQ,MAAM,QAAQ,CAAc,IACtE;AACV,SAAO,EAAE,IAAI,MAAM,MAAM,SAAS,eAAe,UAAU,YAAY,aAAa,MAAM;AAC9F;AAYO,SAAS,QAAQ;AAAA,EACpB;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,cAAa,oBAAI,KAAK,GAAE,YAAY;AACxC,GAMQ;AACJ,SAAO,UAAU,EAAE,MAAM,SAAS,MAAM,QAAQ,UAAU,IAAI,WAAW,CAAC;AAC9E;AAaO,SAAS,aAAa;AAAA,EACzB;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AACJ,GAOQ;AACJ,SAAO,UAAU,EAAE,MAAM,SAAS,MAAM,aAAa,UAAU,IAAI,YAAY,MAAM,CAAC;AAC1F;AAYO,SAAS,UAAU;AAAA,EACtB;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,cAAa,oBAAI,KAAK,GAAE,YAAY;AACxC,GAMQ;AACJ,SAAO,UAAU,EAAE,MAAM,SAAS,MAAM,UAAU,UAAU,IAAI,WAAW,CAAC;AAChF;AAYO,SAAS,eAAe,KAAU,YAAoB,MAAqB;AAC9E,QAAM,aAAa,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,MAAM;AACpE,MAAI,WAAW,WAAW,EAAG,QAAO;AACpC,SAAO,WAAW,IAAI,WAAU,MAAoB,IAAI,EAAE,KAAK,SAAS;AAC5E;AAgBO,SAAS,iBACZ,KACA,WACc;AACd,MAAI,CAAC,UAAW,QAAO,IAAI;AAC3B,SAAO,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,SAAS;AAC/D;;;ACxLO,IAAK,iBAAL,kBAAKA,oBAAL;AACH,EAAAA,gBAAA,0BAAuB;AACvB,EAAAA,gBAAA,gCAA6B;AAFrB,SAAAA;AAAA,GAAA;","names":["GenerateReason"]}

package/dist/message/index.mjs

@@ -5,16 +5,44 @@ function createMsg({
   role,
   metadata = {},
   id = crypto.randomUUID(),
-  timestamp = (/* @__PURE__ */ new Date()).toISOString(),
+  created_at = (/* @__PURE__ */ new Date()).toISOString(),
+  finished_at,
   usage
 }) {
-  return { id, name, role, content, metadata, timestamp, usage };
+  const contentBlocks = typeof content === "string" ? [{ id: crypto.randomUUID(), type: "text", text: content }] : content;
+  return { id, name, role, content: contentBlocks, metadata, created_at, finished_at, usage };
+}
+function UserMsg({
+  name,
+  content,
+  metadata = {},
+  id = crypto.randomUUID(),
+  created_at = (/* @__PURE__ */ new Date()).toISOString()
+}) {
+  return createMsg({ name, content, role: "user", metadata, id, created_at });
+}
+function AssistantMsg({
+  name,
+  content,
+  metadata = {},
+  id = crypto.randomUUID(),
+  created_at = (/* @__PURE__ */ new Date()).toISOString(),
+  usage
+}) {
+  return createMsg({ name, content, role: "assistant", metadata, id, created_at, usage });
+}
+function SystemMsg({
+  name,
+  content,
+  metadata = {},
+  id = crypto.randomUUID(),
+  created_at = (/* @__PURE__ */ new Date()).toISOString()
+}) {
+  return createMsg({ name, content, role: "system", metadata, id, created_at });
 }
 function getTextContent(msg, separator = "\n") {
   const textBlocks = msg.content.filter((block) => block.type === "text");
-  if (textBlocks.length === 0) {
-    return null;
-  }
+  if (textBlocks.length === 0) return null;
   return textBlocks.map((block) => block.text).join(separator);
 }
 function getContentBlocks(msg, blockType) {
@@ -29,7 +57,10 @@ var GenerateReason = /* @__PURE__ */ ((GenerateReason2) => {
   return GenerateReason2;
 })(GenerateReason || {});
 export {
+  AssistantMsg,
   GenerateReason,
+  SystemMsg,
+  UserMsg,
   createMsg,
   getContentBlocks,
   getTextContent

package/dist/message/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/message/message.ts","../../src/message/enums.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","export enum GenerateReason {\n    AWAITING_TOOL_RESULT = 'AWAITING_TOOL_RESULT',\n    AWAITING_USER_CONFIRMATION = 'AWAITING_USER_CONFIRMATION',\n}\n"],"mappings":";AA4CO,SAAS,UAAU;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,EACnC;AACJ,GAC8D;AAC1D,SAAO,EAAE,IAAI,MAAM,MAAM,SAAS,UAAU,WAAW,MAAM;AACjE;AAYO,SAAS,eAAe,KAAU,YAAoB,MAAqB;AAC9E,QAAM,aAAa,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,MAAM;AACpE,MAAI,WAAW,WAAW,GAAG;AACzB,WAAO;AAAA,EACX;AACA,SAAO,WAAW,IAAI,WAAU,MAAoB,IAAI,EAAE,KAAK,SAAS;AAC5E;AAmDO,SAAS,iBACZ,KACA,WACc;AACd,MAAI,CAAC,UAAW,QAAO,IAAI;AAC3B,SAAO,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,SAAS;AAC/D;;;AClIO,IAAK,iBAAL,kBAAKA,oBAAL;AACH,EAAAA,gBAAA,0BAAuB;AACvB,EAAAA,gBAAA,gCAA6B;AAFrB,SAAAA;AAAA,GAAA;","names":["GenerateReason"]}
+{"version":3,"sources":["../../src/message/message.ts","../../src/message/enums.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    created_at: string;\n    /** ISO-8601 finished timestamp. */\n    finished_at?: string | null;\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 `created_at` when omitted.\n * A plain string `content` is automatically wrapped in a single {@link TextBlock}.\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.created_at\n * @param root0.finished_at\n * @param root0.usage\n * @returns A Msg object.\n */\nexport function createMsg({\n    name,\n    content,\n    role,\n    metadata = {},\n    id = crypto.randomUUID(),\n    created_at = new Date().toISOString(),\n    finished_at,\n    usage,\n}: Omit<Msg, 'id' | 'created_at' | 'metadata' | 'content'> &\n    Partial<Pick<Msg, 'id' | 'created_at' | 'metadata'>> & {\n        content: string | ContentBlock[];\n    }): Msg {\n    const contentBlocks: ContentBlock[] =\n        typeof content === 'string'\n            ? [{ id: crypto.randomUUID(), type: 'text', text: content } as TextBlock]\n            : content;\n    return { id, name, role, content: contentBlocks, metadata, created_at, finished_at, usage };\n}\n\n/**\n * Create a user {@link Msg}.\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.metadata\n * @param root0.id\n * @param root0.created_at\n * @returns A Msg object with role 'user'.\n */\nexport function UserMsg({\n    name,\n    content,\n    metadata = {},\n    id = crypto.randomUUID(),\n    created_at = new Date().toISOString(),\n}: {\n    name: string;\n    content: string | ContentBlock[];\n    metadata?: Record<string, JSONSerializableObject>;\n    id?: string;\n    created_at?: string;\n}): Msg {\n    return createMsg({ name, content, role: 'user', metadata, id, created_at });\n}\n\n/**\n * Create an assistant {@link Msg}.\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.metadata\n * @param root0.id\n * @param root0.created_at\n * @param root0.usage\n * @returns A Msg object with role 'assistant'.\n */\nexport function AssistantMsg({\n    name,\n    content,\n    metadata = {},\n    id = crypto.randomUUID(),\n    created_at = new Date().toISOString(),\n    usage,\n}: {\n    name: string;\n    content: string | ContentBlock[];\n    metadata?: Record<string, JSONSerializableObject>;\n    id?: string;\n    created_at?: string;\n    usage?: Msg['usage'];\n}): Msg {\n    return createMsg({ name, content, role: 'assistant', metadata, id, created_at, usage });\n}\n\n/**\n * Create a system {@link Msg}.\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.metadata\n * @param root0.id\n * @param root0.created_at\n * @returns A Msg object with role 'system'.\n */\nexport function SystemMsg({\n    name,\n    content,\n    metadata = {},\n    id = crypto.randomUUID(),\n    created_at = new Date().toISOString(),\n}: {\n    name: string;\n    content: string | ContentBlock[];\n    metadata?: Record<string, JSONSerializableObject>;\n    id?: string;\n    created_at?: string;\n}): Msg {\n    return createMsg({ name, content, role: 'system', metadata, id, created_at });\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) return null;\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[];\nexport function getContentBlocks(msg: Msg, blockType: 'text'): TextBlock[];\nexport function getContentBlocks(msg: Msg, blockType: 'thinking'): ThinkingBlock[];\nexport function getContentBlocks(msg: Msg, blockType: 'data'): DataBlock[];\nexport function getContentBlocks(msg: Msg, blockType: 'tool_call'): ToolCallBlock[];\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","export enum GenerateReason {\n    AWAITING_TOOL_RESULT = 'AWAITING_TOOL_RESULT',\n    AWAITING_USER_CONFIRMATION = 'AWAITING_USER_CONFIRMATION',\n}\n"],"mappings":";AA+CO,SAAS,UAAU;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AAAA,EACA;AACJ,GAGY;AACR,QAAM,gBACF,OAAO,YAAY,WACb,CAAC,EAAE,IAAI,OAAO,WAAW,GAAG,MAAM,QAAQ,MAAM,QAAQ,CAAc,IACtE;AACV,SAAO,EAAE,IAAI,MAAM,MAAM,SAAS,eAAe,UAAU,YAAY,aAAa,MAAM;AAC9F;AAYO,SAAS,QAAQ;AAAA,EACpB;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,cAAa,oBAAI,KAAK,GAAE,YAAY;AACxC,GAMQ;AACJ,SAAO,UAAU,EAAE,MAAM,SAAS,MAAM,QAAQ,UAAU,IAAI,WAAW,CAAC;AAC9E;AAaO,SAAS,aAAa;AAAA,EACzB;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AACJ,GAOQ;AACJ,SAAO,UAAU,EAAE,MAAM,SAAS,MAAM,aAAa,UAAU,IAAI,YAAY,MAAM,CAAC;AAC1F;AAYO,SAAS,UAAU;AAAA,EACtB;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,cAAa,oBAAI,KAAK,GAAE,YAAY;AACxC,GAMQ;AACJ,SAAO,UAAU,EAAE,MAAM,SAAS,MAAM,UAAU,UAAU,IAAI,WAAW,CAAC;AAChF;AAYO,SAAS,eAAe,KAAU,YAAoB,MAAqB;AAC9E,QAAM,aAAa,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,MAAM;AACpE,MAAI,WAAW,WAAW,EAAG,QAAO;AACpC,SAAO,WAAW,IAAI,WAAU,MAAoB,IAAI,EAAE,KAAK,SAAS;AAC5E;AAgBO,SAAS,iBACZ,KACA,WACc;AACd,MAAI,CAAC,UAAW,QAAO,IAAI;AAC3B,SAAO,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,SAAS;AAC/D;;;ACxLO,IAAK,iBAAL,kBAAKA,oBAAL;AACH,EAAAA,gBAAA,0BAAuB;AACvB,EAAAA,gBAAA,gCAA6B;AAFrB,SAAAA;AAAA,GAAA;","names":["GenerateReason"]}

package/dist/{message-CkN21KaY.d.mts → message-CYnHiEVt.d.mts}

@@ -1,5 +1,5 @@
 import { J as JSONSerializableObject } from './index-CAxQAkiP.mjs';
-import { C as ContentBlock, T as TextBlock, a as ThinkingBlock, D as DataBlock, b as ToolCallBlock, c as ToolResultBlock } from './block-VsnHrllL.mjs';
+import { C as ContentBlock, T as TextBlock, a as ThinkingBlock, D as DataBlock, b as ToolCallBlock, c as ToolResultBlock } from './block-7fd6byyN.mjs';
 
 /** A chat message exchanged between agents or between an agent and a model. */
 interface Msg {
@@ -14,7 +14,9 @@ interface Msg {
     /** Arbitrary key-value metadata attached to the message. */
     metadata: Record<string, JSONSerializableObject>;
     /** ISO-8601 creation timestamp. */
-    timestamp: string;
+    created_at: string;
+    /** ISO-8601 finished timestamp. */
+    finished_at?: string | null;
     /** Usage information for the message, such as token counts. */
     usage?: {
         inputTokens: number;
@@ -22,19 +24,75 @@ interface Msg {
     };
 }
 /**
- * Create a new {@link Msg} object, filling in `id` and `timestamp` when omitted.
- *
+ * Create a new {@link Msg} object, filling in `id` and `created_at` when omitted.
+ * A plain string `content` is automatically wrapped in a single {@link TextBlock}.
  * @param root0
  * @param root0.name
  * @param root0.content
  * @param root0.role
  * @param root0.metadata
  * @param root0.id
- * @param root0.timestamp
+ * @param root0.created_at
+ * @param root0.finished_at
  * @param root0.usage
- * @returns A fully-populated {@link Msg} object.
+ * @returns A Msg object.
+ */
+declare function createMsg({ name, content, role, metadata, id, created_at, finished_at, usage, }: Omit<Msg, 'id' | 'created_at' | 'metadata' | 'content'> & Partial<Pick<Msg, 'id' | 'created_at' | 'metadata'>> & {
+    content: string | ContentBlock[];
+}): Msg;
+/**
+ * Create a user {@link Msg}.
+ * @param root0
+ * @param root0.name
+ * @param root0.content
+ * @param root0.metadata
+ * @param root0.id
+ * @param root0.created_at
+ * @returns A Msg object with role 'user'.
+ */
+declare function UserMsg({ name, content, metadata, id, created_at, }: {
+    name: string;
+    content: string | ContentBlock[];
+    metadata?: Record<string, JSONSerializableObject>;
+    id?: string;
+    created_at?: string;
+}): Msg;
+/**
+ * Create an assistant {@link Msg}.
+ * @param root0
+ * @param root0.name
+ * @param root0.content
+ * @param root0.metadata
+ * @param root0.id
+ * @param root0.created_at
+ * @param root0.usage
+ * @returns A Msg object with role 'assistant'.
+ */
+declare function AssistantMsg({ name, content, metadata, id, created_at, usage, }: {
+    name: string;
+    content: string | ContentBlock[];
+    metadata?: Record<string, JSONSerializableObject>;
+    id?: string;
+    created_at?: string;
+    usage?: Msg['usage'];
+}): Msg;
+/**
+ * Create a system {@link Msg}.
+ * @param root0
+ * @param root0.name
+ * @param root0.content
+ * @param root0.metadata
+ * @param root0.id
+ * @param root0.created_at
+ * @returns A Msg object with role 'system'.
  */
-declare function createMsg({ name, content, role, metadata, id, timestamp, usage, }: Omit<Msg, 'id' | 'timestamp' | 'metadata'> & Partial<Pick<Msg, 'id' | 'timestamp' | 'metadata'>>): Msg;
+declare function SystemMsg({ name, content, metadata, id, created_at, }: {
+    name: string;
+    content: string | ContentBlock[];
+    metadata?: Record<string, JSONSerializableObject>;
+    id?: string;
+    created_at?: string;
+}): Msg;
 /**
  * Extract the plain-text content from a message.
  *
@@ -55,45 +113,10 @@ declare function getTextContent(msg: Msg, separator?: string): string | null;
  * @returns An array of all {@link ContentBlock} objects.
  */
 declare function getContentBlocks(msg: Msg): ContentBlock[];
-/**
- * Return all {@link TextBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'text'`
- * @returns An array of {@link TextBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'text'): TextBlock[];
-/**
- * Return all {@link ThinkingBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'thinking'`
- * @returns An array of {@link ThinkingBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'thinking'): ThinkingBlock[];
-/**
- * Return all {@link DataBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'video'`
- * @returns An array of {@link DataBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'data'): DataBlock[];
-/**
- * Return all {@link ToolCallBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'tool_call'`
- * @returns An array of {@link ToolCallBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'tool_call'): ToolCallBlock[];
-/**
- * Return all {@link ToolResultBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'tool_result'`
- * @returns An array of {@link ToolResultBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'tool_result'): ToolResultBlock[];
 
-export { type Msg as M, getTextContent as a, createMsg as c, getContentBlocks as g };
+export { AssistantMsg as A, type Msg as M, SystemMsg as S, UserMsg as U, getTextContent as a, createMsg as c, getContentBlocks as g };

package/dist/{message-CzLeTlua.d.ts → message-DZN7LetB.d.ts}

@@ -1,5 +1,5 @@
 import { J as JSONSerializableObject } from './index-CAxQAkiP.js';
-import { C as ContentBlock, T as TextBlock, a as ThinkingBlock, D as DataBlock, b as ToolCallBlock, c as ToolResultBlock } from './block-VsnHrllL.js';
+import { C as ContentBlock, T as TextBlock, a as ThinkingBlock, D as DataBlock, b as ToolCallBlock, c as ToolResultBlock } from './block-7fd6byyN.js';
 
 /** A chat message exchanged between agents or between an agent and a model. */
 interface Msg {
@@ -14,7 +14,9 @@ interface Msg {
     /** Arbitrary key-value metadata attached to the message. */
     metadata: Record<string, JSONSerializableObject>;
     /** ISO-8601 creation timestamp. */
-    timestamp: string;
+    created_at: string;
+    /** ISO-8601 finished timestamp. */
+    finished_at?: string | null;
     /** Usage information for the message, such as token counts. */
     usage?: {
         inputTokens: number;
@@ -22,19 +24,75 @@ interface Msg {
     };
 }
 /**
- * Create a new {@link Msg} object, filling in `id` and `timestamp` when omitted.
- *
+ * Create a new {@link Msg} object, filling in `id` and `created_at` when omitted.
+ * A plain string `content` is automatically wrapped in a single {@link TextBlock}.
  * @param root0
  * @param root0.name
  * @param root0.content
  * @param root0.role
  * @param root0.metadata
  * @param root0.id
- * @param root0.timestamp
+ * @param root0.created_at
+ * @param root0.finished_at
  * @param root0.usage
- * @returns A fully-populated {@link Msg} object.
+ * @returns A Msg object.
+ */
+declare function createMsg({ name, content, role, metadata, id, created_at, finished_at, usage, }: Omit<Msg, 'id' | 'created_at' | 'metadata' | 'content'> & Partial<Pick<Msg, 'id' | 'created_at' | 'metadata'>> & {
+    content: string | ContentBlock[];
+}): Msg;
+/**
+ * Create a user {@link Msg}.
+ * @param root0
+ * @param root0.name
+ * @param root0.content
+ * @param root0.metadata
+ * @param root0.id
+ * @param root0.created_at
+ * @returns A Msg object with role 'user'.
+ */
+declare function UserMsg({ name, content, metadata, id, created_at, }: {
+    name: string;
+    content: string | ContentBlock[];
+    metadata?: Record<string, JSONSerializableObject>;
+    id?: string;
+    created_at?: string;
+}): Msg;
+/**
+ * Create an assistant {@link Msg}.
+ * @param root0
+ * @param root0.name
+ * @param root0.content
+ * @param root0.metadata
+ * @param root0.id
+ * @param root0.created_at
+ * @param root0.usage
+ * @returns A Msg object with role 'assistant'.
+ */
+declare function AssistantMsg({ name, content, metadata, id, created_at, usage, }: {
+    name: string;
+    content: string | ContentBlock[];
+    metadata?: Record<string, JSONSerializableObject>;
+    id?: string;
+    created_at?: string;
+    usage?: Msg['usage'];
+}): Msg;
+/**
+ * Create a system {@link Msg}.
+ * @param root0
+ * @param root0.name
+ * @param root0.content
+ * @param root0.metadata
+ * @param root0.id
+ * @param root0.created_at
+ * @returns A Msg object with role 'system'.
  */
-declare function createMsg({ name, content, role, metadata, id, timestamp, usage, }: Omit<Msg, 'id' | 'timestamp' | 'metadata'> & Partial<Pick<Msg, 'id' | 'timestamp' | 'metadata'>>): Msg;
+declare function SystemMsg({ name, content, metadata, id, created_at, }: {
+    name: string;
+    content: string | ContentBlock[];
+    metadata?: Record<string, JSONSerializableObject>;
+    id?: string;
+    created_at?: string;
+}): Msg;
 /**
  * Extract the plain-text content from a message.
  *
@@ -55,45 +113,10 @@ declare function getTextContent(msg: Msg, separator?: string): string | null;
  * @returns An array of all {@link ContentBlock} objects.
  */
 declare function getContentBlocks(msg: Msg): ContentBlock[];
-/**
- * Return all {@link TextBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'text'`
- * @returns An array of {@link TextBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'text'): TextBlock[];
-/**
- * Return all {@link ThinkingBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'thinking'`
- * @returns An array of {@link ThinkingBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'thinking'): ThinkingBlock[];
-/**
- * Return all {@link DataBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'video'`
- * @returns An array of {@link DataBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'data'): DataBlock[];
-/**
- * Return all {@link ToolCallBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'tool_call'`
- * @returns An array of {@link ToolCallBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'tool_call'): ToolCallBlock[];
-/**
- * Return all {@link ToolResultBlock} objects from a message.
- *
- * @param msg - The message to read.
- * @param blockType - `'tool_result'`
- * @returns An array of {@link ToolResultBlock} objects.
- */
 declare function getContentBlocks(msg: Msg, blockType: 'tool_result'): ToolResultBlock[];
 
-export { type Msg as M, getTextContent as a, createMsg as c, getContentBlocks as g };
+export { AssistantMsg as A, type Msg as M, SystemMsg as S, UserMsg as U, getTextContent as a, createMsg as c, getContentBlocks as g };