@agentrun/sdk 0.0.3 → 0.0.4

package/dist/integration/mastra/index.d.cts

@@ -0,0 +1,186 @@
+import { C as Config } from '../../config-07gMelJP.cjs';
+export { p as TemplateType } from '../../model-BV7A6Trb.cjs';
+import { LanguageModelV3 } from '@ai-sdk/provider';
+import { ToolsInput } from '@mastra/core/agent';
+import { ToolAction, ToolExecutionContext } from '@mastra/core/tools';
+import { a as AgentEvent } from '../../model-DGBy-o_L.cjs';
+import { ChunkType } from '@mastra/core/stream';
+import '../../model--I90nCqy.cjs';
+
+/**
+ * Mastra Event Converter
+ * Mastra 事件转换器
+ *
+ * Converts Mastra stream events (ChunkType) to AgentRun events (AgentEventItem).
+ * 将 Mastra 流式事件（ChunkType）转换为 AgentRun 事件（AgentEventItem）。
+ *
+ * @example
+ * ```typescript
+ * import { MastraConverter } from '@alicloud/agentrun-sdk/integration/mastra';
+ * import { Agent } from '@mastra/core/agent';
+ *
+ * const agent = new Agent({...});
+ * const converter = new MastraConverter();
+ *
+ * async function* invokeAgent(request: AgentRequest) {
+ *   const mastraStream = await agent.stream(request.messages);
+ *
+ *   for await (const chunk of mastraStream.fullStream) {
+ *     const events = converter.convert(chunk);
+ *     for (const event of events) {
+ *       yield event;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+
+/**
+ * Agent event item - can be a string (text) or AgentEvent (structured event)
+ * Agent 事件项 - 可以是字符串（文本）或 AgentEvent（结构化事件）
+ */
+type AgentEventItem = string | AgentEvent;
+/**
+ * Mastra Event Converter
+ * Mastra 事件转换器
+ *
+ * Converts Mastra stream chunk events to AgentRun standard events.
+ * Supports text streaming, tool calls, and error handling.
+ *
+ * 将 Mastra 流式 chunk 事件转换为 AgentRun 标准事件。
+ * 支持文本流式输出、工具调用和错误处理。
+ */
+declare class MastraConverter {
+    /**
+     * Convert a single Mastra chunk to AgentRun events
+     * 转换单个 Mastra chunk 为 AgentRun 事件
+     *
+     * @param chunk - Mastra stream chunk
+     * @returns Generator of AgentEventItem (strings or AgentEvents)
+     *
+     * @example
+     * ```typescript
+     * const converter = new MastraConverter();
+     * for await (const chunk of mastraStream.fullStream) {
+     *   const events = converter.convert(chunk);
+     *   for (const event of events) {
+     *     yield event;
+     *   }
+     * }
+     * ```
+     */
+    convert<T extends ChunkType<U>, U = undefined>(chunk: T): Generator<AgentEventItem>;
+    /**
+     * Extract text content from chunk payload
+     * 从 chunk payload 提取文本内容
+     */
+    private extractTextFromPayload;
+    /**
+     * Extract tool call information from chunk payload
+     * 从 chunk payload 提取工具调用信息
+     */
+    private extractToolCallFromPayload;
+    /**
+     * Extract tool result information from chunk payload
+     * 从 chunk payload 提取工具结果信息
+     */
+    private extractToolResultFromPayload;
+    /**
+     * Extract error message from chunk payload
+     * 从 chunk payload 提取错误信息
+     */
+    private extractErrorFromPayload;
+}
+
+/**
+ * AgentRun Mastra Integration Module
+ * AgentRun 与 Mastra 的集成模块
+ *
+ * Provides integration functions for using AgentRun resources with Mastra framework.
+ * This module handles all Mastra-specific conversions to avoid dependencies in builtin module.
+ *
+ * 提供将 AgentRun 资源与 Mastra 框架集成的函数。
+ * 本模块处理所有 Mastra 特定的转换，避免在 builtin 模块中引入依赖。
+ */
+
+/**
+ * Mastra Tool type - a ToolAction with any schema types
+ */
+type MastraTool = ToolAction<any, any, any, any, any, string>;
+/**
+ * Get Mastra-compatible model from AgentRun ModelService/ModelProxy name
+ * 根据 AgentRun ModelService/ModelProxy name 获取 Mastra 可直接使用的 model
+ *
+ * @example
+ * ```typescript
+ * const llm = await model({ name: 'qwen-max' });
+ * const agent = createAgent({ model: llm });
+ * ```
+ */
+declare function model(params: {
+    name: string;
+    modelName?: string;
+    config?: Config;
+}): Promise<LanguageModelV3>;
+/**
+ * Create a Mastra tool from ToolAction definition
+ * 从 ToolAction 定义创建 Mastra 工具
+ *
+ * This is a low-level function for creating custom Mastra tools.
+ */
+declare function createMastraTool<TId extends string = string, TSchemaIn = unknown, TSchemaOut = unknown, TSuspend = unknown, TResume = unknown, TContext extends ToolExecutionContext<TSuspend, TResume> = ToolExecutionContext<TSuspend, TResume>>(params: ToolAction<TSchemaIn, TSchemaOut, TSuspend, TResume, TContext, TId>): Promise<ToolAction<TSchemaIn, TSchemaOut, TSuspend, TResume, TContext, TId>>;
+/**
+ * Get Mastra-compatible tools from AgentRun ToolSet name
+ * 根据 AgentRun 工具集 name 获取 Mastra 可直接使用的 tools
+ *
+ * Returns a ToolsInput map that can be directly used with Mastra Agent.
+ *
+ * @example
+ * ```typescript
+ * const tools = await toolset({ name: 'my-toolset' });
+ * const agent = new Agent({ tools });
+ * ```
+ */
+declare function toolset(params: {
+    name: string;
+    config?: Config;
+}): Promise<ToolsInput>;
+/**
+ * Get Mastra-compatible sandbox tools from AgentRun sandbox template
+ * 根据 AgentRun 沙箱模板获取 Mastra 可直接使用的 sandbox 工具
+ *
+ * Returns a ToolsInput map that can be directly used with Mastra Agent.
+ *
+ * @param params.templateName - Name of the sandbox template
+ * @param params.templateType - Type of sandbox (CODE_INTERPRETER or BROWSER)
+ * @param params.sandboxIdleTimeoutSeconds - Idle timeout in seconds (default: 300)
+ * @param params.config - Configuration object
+ *
+ * @example
+ * ```typescript
+ * // Get code interpreter tools
+ * const codeTools = await sandbox({
+ *   templateName: 'my-code-interpreter-template',
+ *   templateType: TemplateType.CODE_INTERPRETER,
+ * });
+ *
+ * // Get browser automation tools
+ * const browserTools = await sandbox({
+ *   templateName: 'my-browser-template',
+ *   templateType: TemplateType.BROWSER,
+ * });
+ *
+ * // Use with Mastra agent
+ * const agent = new Agent({
+ *   tools: { ...codeTools },
+ *   model: await model({ name: 'qwen-max' }),
+ * });
+ * ```
+ */
+declare function sandbox(params: {
+    templateName: string;
+    sandboxIdleTimeoutSeconds?: number;
+    config?: Config;
+}): Promise<ToolsInput>;
+
+export { type AgentEventItem, MastraConverter, type MastraTool, createMastraTool, model, sandbox, toolset };

package/dist/integration/mastra/index.d.ts

@@ -0,0 +1,186 @@
+import { C as Config } from '../../config-07gMelJP.js';
+export { p as TemplateType } from '../../model-RiiiZnou.js';
+import { LanguageModelV3 } from '@ai-sdk/provider';
+import { ToolsInput } from '@mastra/core/agent';
+import { ToolAction, ToolExecutionContext } from '@mastra/core/tools';
+import { a as AgentEvent } from '../../model-DGBy-o_L.js';
+import { ChunkType } from '@mastra/core/stream';
+import '../../model--I90nCqy.js';
+
+/**
+ * Mastra Event Converter
+ * Mastra 事件转换器
+ *
+ * Converts Mastra stream events (ChunkType) to AgentRun events (AgentEventItem).
+ * 将 Mastra 流式事件（ChunkType）转换为 AgentRun 事件（AgentEventItem）。
+ *
+ * @example
+ * ```typescript
+ * import { MastraConverter } from '@alicloud/agentrun-sdk/integration/mastra';
+ * import { Agent } from '@mastra/core/agent';
+ *
+ * const agent = new Agent({...});
+ * const converter = new MastraConverter();
+ *
+ * async function* invokeAgent(request: AgentRequest) {
+ *   const mastraStream = await agent.stream(request.messages);
+ *
+ *   for await (const chunk of mastraStream.fullStream) {
+ *     const events = converter.convert(chunk);
+ *     for (const event of events) {
+ *       yield event;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+
+/**
+ * Agent event item - can be a string (text) or AgentEvent (structured event)
+ * Agent 事件项 - 可以是字符串（文本）或 AgentEvent（结构化事件）
+ */
+type AgentEventItem = string | AgentEvent;
+/**
+ * Mastra Event Converter
+ * Mastra 事件转换器
+ *
+ * Converts Mastra stream chunk events to AgentRun standard events.
+ * Supports text streaming, tool calls, and error handling.
+ *
+ * 将 Mastra 流式 chunk 事件转换为 AgentRun 标准事件。
+ * 支持文本流式输出、工具调用和错误处理。
+ */
+declare class MastraConverter {
+    /**
+     * Convert a single Mastra chunk to AgentRun events
+     * 转换单个 Mastra chunk 为 AgentRun 事件
+     *
+     * @param chunk - Mastra stream chunk
+     * @returns Generator of AgentEventItem (strings or AgentEvents)
+     *
+     * @example
+     * ```typescript
+     * const converter = new MastraConverter();
+     * for await (const chunk of mastraStream.fullStream) {
+     *   const events = converter.convert(chunk);
+     *   for (const event of events) {
+     *     yield event;
+     *   }
+     * }
+     * ```
+     */
+    convert<T extends ChunkType<U>, U = undefined>(chunk: T): Generator<AgentEventItem>;
+    /**
+     * Extract text content from chunk payload
+     * 从 chunk payload 提取文本内容
+     */
+    private extractTextFromPayload;
+    /**
+     * Extract tool call information from chunk payload
+     * 从 chunk payload 提取工具调用信息
+     */
+    private extractToolCallFromPayload;
+    /**
+     * Extract tool result information from chunk payload
+     * 从 chunk payload 提取工具结果信息
+     */
+    private extractToolResultFromPayload;
+    /**
+     * Extract error message from chunk payload
+     * 从 chunk payload 提取错误信息
+     */
+    private extractErrorFromPayload;
+}
+
+/**
+ * AgentRun Mastra Integration Module
+ * AgentRun 与 Mastra 的集成模块
+ *
+ * Provides integration functions for using AgentRun resources with Mastra framework.
+ * This module handles all Mastra-specific conversions to avoid dependencies in builtin module.
+ *
+ * 提供将 AgentRun 资源与 Mastra 框架集成的函数。
+ * 本模块处理所有 Mastra 特定的转换，避免在 builtin 模块中引入依赖。
+ */
+
+/**
+ * Mastra Tool type - a ToolAction with any schema types
+ */
+type MastraTool = ToolAction<any, any, any, any, any, string>;
+/**
+ * Get Mastra-compatible model from AgentRun ModelService/ModelProxy name
+ * 根据 AgentRun ModelService/ModelProxy name 获取 Mastra 可直接使用的 model
+ *
+ * @example
+ * ```typescript
+ * const llm = await model({ name: 'qwen-max' });
+ * const agent = createAgent({ model: llm });
+ * ```
+ */
+declare function model(params: {
+    name: string;
+    modelName?: string;
+    config?: Config;
+}): Promise<LanguageModelV3>;
+/**
+ * Create a Mastra tool from ToolAction definition
+ * 从 ToolAction 定义创建 Mastra 工具
+ *
+ * This is a low-level function for creating custom Mastra tools.
+ */
+declare function createMastraTool<TId extends string = string, TSchemaIn = unknown, TSchemaOut = unknown, TSuspend = unknown, TResume = unknown, TContext extends ToolExecutionContext<TSuspend, TResume> = ToolExecutionContext<TSuspend, TResume>>(params: ToolAction<TSchemaIn, TSchemaOut, TSuspend, TResume, TContext, TId>): Promise<ToolAction<TSchemaIn, TSchemaOut, TSuspend, TResume, TContext, TId>>;
+/**
+ * Get Mastra-compatible tools from AgentRun ToolSet name
+ * 根据 AgentRun 工具集 name 获取 Mastra 可直接使用的 tools
+ *
+ * Returns a ToolsInput map that can be directly used with Mastra Agent.
+ *
+ * @example
+ * ```typescript
+ * const tools = await toolset({ name: 'my-toolset' });
+ * const agent = new Agent({ tools });
+ * ```
+ */
+declare function toolset(params: {
+    name: string;
+    config?: Config;
+}): Promise<ToolsInput>;
+/**
+ * Get Mastra-compatible sandbox tools from AgentRun sandbox template
+ * 根据 AgentRun 沙箱模板获取 Mastra 可直接使用的 sandbox 工具
+ *
+ * Returns a ToolsInput map that can be directly used with Mastra Agent.
+ *
+ * @param params.templateName - Name of the sandbox template
+ * @param params.templateType - Type of sandbox (CODE_INTERPRETER or BROWSER)
+ * @param params.sandboxIdleTimeoutSeconds - Idle timeout in seconds (default: 300)
+ * @param params.config - Configuration object
+ *
+ * @example
+ * ```typescript
+ * // Get code interpreter tools
+ * const codeTools = await sandbox({
+ *   templateName: 'my-code-interpreter-template',
+ *   templateType: TemplateType.CODE_INTERPRETER,
+ * });
+ *
+ * // Get browser automation tools
+ * const browserTools = await sandbox({
+ *   templateName: 'my-browser-template',
+ *   templateType: TemplateType.BROWSER,
+ * });
+ *
+ * // Use with Mastra agent
+ * const agent = new Agent({
+ *   tools: { ...codeTools },
+ *   model: await model({ name: 'qwen-max' }),
+ * });
+ * ```
+ */
+declare function sandbox(params: {
+    templateName: string;
+    sandboxIdleTimeoutSeconds?: number;
+    config?: Config;
+}): Promise<ToolsInput>;
+
+export { type AgentEventItem, MastraConverter, type MastraTool, createMastraTool, model, sandbox, toolset };