@astack-tech/integrations 0.1.1-beta.5 → 0.2.0-beta.7

package/dist/model-provider/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/model-provider/index.ts","../../src/model-provider/deepseek/index.ts"],"sourcesContent":["export {\n  default as Deepseek,\n  type Message as DeepseekMessage,\n  type ToolCall as DeepseekToolCall,\n  type DeepseekConfig,\n  type MessageRole as DeepseekMessageRole,\n} from './deepseek';\n","import { Component } from '@astack-tech/core';\nimport OpenAI from 'openai';\n\n/**\n * Deepseek 模型提供者配置\n */\nexport interface DeepseekConfig {\n  /**\n   * API 密钥\n   */\n  apiKey: string;\n\n  /**\n   * 使用的模型名称\n   * 默认为 'deepseek-chat'\n   */\n  model?: string;\n\n  /**\n   * 自定义 API 基础 URL\n   * 默认为 Deepseek 官方 API 地址\n   */\n  baseURL?: string;\n\n  /**\n   * 温度参数，控制输出的随机性\n   */\n  temperature?: number;\n\n  /**\n   * 最大生成的 token 数\n   */\n  maxTokens?: number;\n\n  /**\n   * 采样概率\n   */\n  topP?: number;\n\n  /**\n   * 系统提示消息\n   */\n  systemPrompt?: string;\n\n  /**\n   * 工具实例数组，直接传递工具实例\n   * 每个工具应具有 name、description 和 parameters 属性\n   */\n  rawTools?: Array<{\n    name: string;\n    description: string;\n    parameters?: Record<string, unknown>;\n  }>;\n\n  /**\n   * API 格式的工具定义数组，与 rawTools 二选一\n   * 使用 OpenAI 兼容的工具定义格式\n   */\n  tools?: unknown[];\n\n  /**\n   * dangerouslyAllowBrowser\n   * 是否允许在浏览器等非安全环境内运行\n   */\n  dangerouslyAllowBrowser?: boolean;\n}\n\n/**\n * 消息角色类型\n */\nexport type MessageRole = 'system' | 'user' | 'assistant' | 'tool';\n\n/**\n * 工具调用\n */\nexport interface ToolCall {\n  /**\n   * 工具调用 ID\n   */\n  id?: string;\n\n  /**\n   * 工具名称\n   */\n  tool_name: string;\n\n  /**\n   * 工具调用参数\n   */\n  arguments: Record<string, unknown>;\n}\n\n/**\n * Token 使用统计\n */\nexport interface TokenUsage {\n  /**\n   * 完成部分的 token 数量\n   */\n  completion_tokens: number;\n\n  /**\n   * 提示部分的 token 数量\n   */\n  prompt_tokens: number;\n\n  /**\n   * 提示缓存命中的 token 数量（可选）\n   */\n  prompt_cache_hit_tokens?: number;\n\n  /**\n   * 提示缓存未命中的 token 数量（可选）\n   */\n  prompt_cache_miss_tokens?: number;\n\n  /**\n   * 总 token 数量\n   */\n  total_tokens: number;\n}\n\n/**\n * 对话消息类型\n */\nexport interface Message {\n  /**\n   * 消息角色\n   */\n  role: MessageRole;\n\n  /**\n   * 消息内容\n   */\n  content?: string;\n\n  /**\n   * 工具调用\n   */\n  tool_calls?: ToolCall[];\n\n  /**\n   * 工具调用 ID，用于工具响应消息\n   */\n  tool_call_id?: string;\n\n  /**\n   * Token 使用统计（可选）\n   */\n  usage?: TokenUsage;\n}\n\n/**\n * Deepseek 组件\n *\n * 使用 OpenAI 兼容接口调用 Deepseek 模型\n *\n * 输入:\n *   - prompt: 文本提示\n *   - messages: 对话消息数组\n *\n * 输出:\n *   - completion: 生成的文本完成\n *   - message: 生成的响应消息\n */\nclass Deepseek extends Component {\n  // OpenAI 客户端实例\n  private client: OpenAI;\n\n  // 配置选项\n  private model: string;\n  private temperature: number;\n  private maxTokens?: number;\n  private topP?: number;\n  private systemPrompt?: string;\n  private tools?: unknown[];\n\n  constructor(config: DeepseekConfig) {\n    super({});\n\n    // 配置客户端\n    this.client = new OpenAI({\n      apiKey: config.apiKey,\n      baseURL: config.baseURL || 'https://api.deepseek.com/v1',\n      dangerouslyAllowBrowser: config.dangerouslyAllowBrowser ?? false,\n    });\n\n    // 保存基本配置\n    this.model = config.model || 'deepseek-chat';\n    this.temperature = config.temperature ?? 0.7;\n    this.maxTokens = config.maxTokens;\n    this.topP = config.topP;\n    this.systemPrompt = config.systemPrompt;\n\n    // 处理工具配置，优先使用 rawTools\n    if (config.rawTools && config.rawTools.length > 0) {\n      // 将工具实例转换为 API 格式\n      this.tools = config.rawTools.map(tool => ({\n        type: 'function',\n        function: {\n          name: tool.name,\n          description: tool.description,\n          parameters: tool.parameters || {},\n        },\n      }));\n    } else {\n      // 使用直接提供的 API 格式工具\n      this.tools = config.tools;\n    }\n\n    // 重命名端口\n    Component.Port.I('prompt').attach(this);\n    Component.Port.I('messages').attach(this);\n    Component.Port.O('completion').attach(this);\n    Component.Port.O('message').attach(this);\n  }\n\n  /**\n   * 生成文本完成\n   * @param prompt 提示文本\n   * @returns 生成的文本\n   */\n  async generateCompletion(prompt: string): Promise<string> {\n    const messages: Array<OpenAI.Chat.ChatCompletionMessageParam> = [];\n\n    // 添加系统提示\n    if (this.systemPrompt) {\n      messages.push({\n        role: 'system',\n        content: this.systemPrompt,\n      });\n    }\n\n    // 添加用户提示\n    messages.push({\n      role: 'user',\n      content: prompt,\n    });\n\n    // 创建请求参数\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const requestParams: any = {\n      model: this.model,\n      messages,\n      temperature: this.temperature,\n      max_tokens: this.maxTokens,\n      top_p: this.topP,\n    };\n\n    // 如果有工具定义，添加到请求中\n    if (this.tools && this.tools.length > 0) {\n      requestParams.tools = this.tools;\n    }\n\n    // 调用 API\n    const response = await this.client.chat.completions.create(requestParams);\n\n    // 处理工具调用结果\n    if (\n      response.choices[0].message.tool_calls &&\n      response.choices[0].message.tool_calls.length > 0\n    ) {\n      return JSON.stringify(response.choices[0].message);\n    }\n\n    return response.choices[0].message.content || '';\n  }\n\n  /**\n   * 流式处理对话消息\n   * @param messages 对话消息数组\n   * @param options 可选的调用选项，包含临时工具列表\n   * @returns 生成的流式响应消息异步生成器\n   */\n  async *streamChatCompletion(\n    messages: Message[],\n    options?: { temporaryTools?: unknown[] }\n  ): AsyncGenerator<Partial<Message>> {\n    // 转换消息格式 (复用现有逻辑)\n    const formattedMessages: Array<OpenAI.Chat.ChatCompletionMessageParam> = [];\n\n    // 添加系统提示\n    if (this.systemPrompt) {\n      formattedMessages.push({\n        role: 'system',\n        content: this.systemPrompt,\n      });\n    }\n\n    // 添加用户提供的消息\n    formattedMessages.push(\n      ...messages.map(msg => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const formattedMsg: any = {\n          role: msg.role,\n          content: msg.content,\n        };\n\n        if (msg.role === 'tool' && msg.tool_call_id) {\n          formattedMsg.tool_call_id = msg.tool_call_id;\n        }\n\n        return formattedMsg;\n      })\n    );\n\n    // 创建请求参数\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const requestParams: any = {\n      model: this.model,\n      messages: formattedMessages,\n      temperature: this.temperature,\n      max_tokens: this.maxTokens,\n      top_p: this.topP,\n      stream: true, // 开启流式模式\n    };\n\n    // 决定使用哪些工具\n    const toolsToUse = options?.temporaryTools || this.tools;\n\n    // 如果有工具定义，添加到请求中\n    if (toolsToUse && toolsToUse.length > 0) {\n      const formattedTools = toolsToUse.map(tool => {\n        type ToolType = {\n          type?: string;\n          name?: string;\n          description?: string;\n          parameters?: Record<string, unknown>;\n        };\n\n        const typedTool = tool as ToolType;\n\n        if (typedTool.type === 'function') {\n          return tool;\n        }\n\n        return {\n          type: 'function',\n          function: {\n            name: typedTool.name,\n            description: typedTool.description,\n            parameters: typedTool.parameters || {},\n          },\n        };\n      });\n\n      requestParams.tools = formattedTools;\n    }\n\n    // 调用流式 API\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const stream = (await this.client.chat.completions.create(requestParams)) as any;\n\n    // 处理流式响应\n    for await (const chunk of stream) {\n      const delta = chunk.choices[0]?.delta;\n\n      if (delta?.content) {\n        // 流式文本内容\n        yield {\n          role: 'assistant',\n          content: delta.content,\n        };\n      }\n\n      if (delta?.tool_calls) {\n        // 流式工具调用（如果需要）\n        yield {\n          role: 'assistant',\n          content: '',\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          tool_calls: delta.tool_calls.map((toolCall: any) => ({\n            id: toolCall.id || '',\n            function: {\n              name: toolCall.function?.name || '',\n              arguments: toolCall.function?.arguments || '',\n            },\n            type: 'function',\n            tool_name: toolCall.function?.name || '',\n            arguments: toolCall.function?.arguments || '',\n          })),\n        };\n      }\n\n      // 提取并返回 token 使用统计信息\n      if (chunk.usage) {\n        yield {\n          role: 'assistant',\n          content: '',\n          usage: {\n            completion_tokens: chunk.usage.completion_tokens || 0,\n            prompt_tokens: chunk.usage.prompt_tokens || 0,\n            prompt_cache_hit_tokens: chunk.usage.prompt_cache_hit_tokens,\n            prompt_cache_miss_tokens: chunk.usage.prompt_cache_miss_tokens,\n            total_tokens: chunk.usage.total_tokens || 0,\n          },\n        };\n      }\n    }\n  }\n\n  /**\n   * 处理对话消息\n   * @param messages 对话消息数组\n   * @param options 可选的调用选项，包含临时工具列表\n   * @returns 生成的响应消息\n   */\n  async chatCompletion(\n    messages: Message[],\n    options?: { temporaryTools?: unknown[] }\n  ): Promise<Message> {\n    // 转换消息格式\n    const formattedMessages: Array<OpenAI.Chat.ChatCompletionMessageParam> = [];\n\n    // 添加系统提示\n    if (this.systemPrompt) {\n      formattedMessages.push({\n        role: 'system',\n        content: this.systemPrompt,\n      });\n    }\n\n    // 添加用户提供的消息\n    formattedMessages.push(\n      ...messages.map(msg => {\n        // 基本消息结构\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const formattedMsg: any = {\n          role: msg.role,\n          content: msg.content,\n        };\n\n        // 如果有工具调用 ID，添加到消息中\n        if (msg.role === 'tool' && msg.tool_call_id) {\n          formattedMsg.tool_call_id = msg.tool_call_id;\n        }\n\n        return formattedMsg;\n      })\n    );\n\n    // 创建请求参数\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const requestParams: any = {\n      model: this.model,\n      messages: formattedMessages,\n      temperature: this.temperature,\n      max_tokens: this.maxTokens,\n      top_p: this.topP,\n    };\n\n    // 决定使用哪些工具\n    // 如果提供了临时工具，优先使用临时工具\n    const toolsToUse = options?.temporaryTools || this.tools;\n\n    // 如果有工具定义，添加到请求中\n    if (toolsToUse && toolsToUse.length > 0) {\n      // 检查工具格式并转换，确保符合 Deepseek API 要求\n      const formattedTools = toolsToUse.map(tool => {\n        // 使用类型断言来处理 unknown 类型\n        type ToolType = {\n          type?: string;\n          name?: string;\n          description?: string;\n          parameters?: Record<string, unknown>;\n        };\n\n        const typedTool = tool as ToolType;\n\n        // 如果工具已经是 API 格式，直接返回\n        if (typedTool.type === 'function') {\n          return tool;\n        }\n\n        // 如果是简单工具实例，转换为 API 格式\n        return {\n          type: 'function',\n          function: {\n            name: typedTool.name,\n            description: typedTool.description,\n            parameters: typedTool.parameters || {},\n          },\n        };\n      });\n\n      requestParams.tools = formattedTools;\n    }\n\n    // 调用 API\n    const response = await this.client.chat.completions.create(requestParams);\n\n    // 解析响应\n    const responseMessage = response.choices[0].message;\n\n    // 转换为内部消息格式\n    const result: Message = {\n      role: 'assistant',\n      content: responseMessage.content || '',\n    };\n\n    // 提取并添加 token 使用统计信息\n    if (response.usage) {\n      const usage = response.usage as typeof response.usage & {\n        prompt_cache_hit_tokens?: number;\n        prompt_cache_miss_tokens?: number;\n      };\n      result.usage = {\n        completion_tokens: usage.completion_tokens || 0,\n        prompt_tokens: usage.prompt_tokens || 0,\n        prompt_cache_hit_tokens: usage.prompt_cache_hit_tokens,\n        prompt_cache_miss_tokens: usage.prompt_cache_miss_tokens,\n        total_tokens: usage.total_tokens || 0,\n      };\n    }\n\n    // 如果有工具调用，添加到结果中\n    if (responseMessage.tool_calls && responseMessage.tool_calls.length > 0) {\n      // 为了兼容 Agent 组件期望的格式，保留 function 和 type 字段\n      // 同时为了满足内部 ToolCall 接口，也添加 tool_name 和 arguments 字段\n      result.tool_calls = responseMessage.tool_calls.map(toolCall => {\n        // 解析参数，确保是对象形式\n        let args: Record<string, unknown>;\n\n        const rawArgs = toolCall.function.arguments;\n\n        if (typeof rawArgs === 'string') {\n          const raw = rawArgs;\n          try {\n            args = raw && raw.trim().length > 0 ? (JSON.parse(raw) as Record<string, unknown>) : {};\n          } catch {\n            args = {};\n          }\n        } else if (rawArgs && typeof rawArgs === 'object') {\n          args = rawArgs as Record<string, unknown>;\n        } else {\n          args = {};\n        }\n\n        return {\n          id: toolCall.id,\n          // 满足 Agent 组件期望的格式\n          function: {\n            name: toolCall.function.name,\n            arguments: toolCall.function.arguments || '{}',\n          },\n          type: 'function',\n          // 满足内部 ToolCall 接口\n          tool_name: toolCall.function.name,\n          arguments: args,\n        };\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * 在独立模式下运行组件\n   * @param input 输入参数，可以是提示文本或对话消息数组\n   * @returns 生成的文本或响应消息\n   */\n  async run(input: string | Message[]): Promise<string | Message> {\n    if (typeof input === 'string') {\n      return this.generateCompletion(input);\n    } else {\n      return this.chatCompletion(input);\n    }\n  }\n\n  /**\n   * 在流水线中运行组件\n   * @param $i 输入端口\n   * @param $o 输出端口\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _transform($i: any, $o: any) {\n    // 处理文本提示输入\n    $i('prompt').receive(async (prompt: string) => {\n      try {\n        const completion = await this.generateCompletion(prompt);\n        $o('completion').send(completion);\n      } catch (error) {\n        console.error('Deepseek API 调用错误:', error);\n        $o('completion').send('API 调用错误');\n      }\n    });\n\n    // 处理对话消息输入\n    $i('messages').receive(async (messages: Message[]) => {\n      try {\n        const responseMessage = await this.chatCompletion(messages);\n        $o('message').send(responseMessage);\n      } catch (error) {\n        console.error('Deepseek API 调用错误:', error);\n        $o('message').send({\n          role: 'assistant',\n          content: 'API 调用错误',\n        });\n      }\n    });\n  }\n}\n\n// 默认导出组件\nexport default Deepseek;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAA0B;AAC1B,oBAAmB;AAoKnB,IAAM,WAAN,cAAuB,sBAAU;AAAA,EAY/B,YAAY,QAAwB;AAClC,UAAM,CAAC,CAAC;AAGR,SAAK,SAAS,IAAI,cAAAA,QAAO;AAAA,MACvB,QAAQ,OAAO;AAAA,MACf,SAAS,OAAO,WAAW;AAAA,MAC3B,yBAAyB,OAAO,2BAA2B;AAAA,IAC7D,CAAC;AAGD,SAAK,QAAQ,OAAO,SAAS;AAC7B,SAAK,cAAc,OAAO,eAAe;AACzC,SAAK,YAAY,OAAO;AACxB,SAAK,OAAO,OAAO;AACnB,SAAK,eAAe,OAAO;AAG3B,QAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AAEjD,WAAK,QAAQ,OAAO,SAAS,IAAI,WAAS;AAAA,QACxC,MAAM;AAAA,QACN,UAAU;AAAA,UACR,MAAM,KAAK;AAAA,UACX,aAAa,KAAK;AAAA,UAClB,YAAY,KAAK,cAAc,CAAC;AAAA,QAClC;AAAA,MACF,EAAE;AAAA,IACJ,OAAO;AAEL,WAAK,QAAQ,OAAO;AAAA,IACtB;AAGA,0BAAU,KAAK,EAAE,QAAQ,EAAE,OAAO,IAAI;AACtC,0BAAU,KAAK,EAAE,UAAU,EAAE,OAAO,IAAI;AACxC,0BAAU,KAAK,EAAE,YAAY,EAAE,OAAO,IAAI;AAC1C,0BAAU,KAAK,EAAE,SAAS,EAAE,OAAO,IAAI;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,mBAAmB,QAAiC;AACxD,UAAM,WAA0D,CAAC;AAGjE,QAAI,KAAK,cAAc;AACrB,eAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,SAAS,KAAK;AAAA,MAChB,CAAC;AAAA,IACH;AAGA,aAAS,KAAK;AAAA,MACZ,MAAM;AAAA,MACN,SAAS;AAAA,IACX,CAAC;AAID,UAAM,gBAAqB;AAAA,MACzB,OAAO,KAAK;AAAA,MACZ;AAAA,MACA,aAAa,KAAK;AAAA,MAClB,YAAY,KAAK;AAAA,MACjB,OAAO,KAAK;AAAA,IACd;AAGA,QAAI,KAAK,SAAS,KAAK,MAAM,SAAS,GAAG;AACvC,oBAAc,QAAQ,KAAK;AAAA,IAC7B;AAGA,UAAM,WAAW,MAAM,KAAK,OAAO,KAAK,YAAY,OAAO,aAAa;AAGxE,QACE,SAAS,QAAQ,CAAC,EAAE,QAAQ,cAC5B,SAAS,QAAQ,CAAC,EAAE,QAAQ,WAAW,SAAS,GAChD;AACA,aAAO,KAAK,UAAU,SAAS,QAAQ,CAAC,EAAE,OAAO;AAAA,IACnD;AAEA,WAAO,SAAS,QAAQ,CAAC,EAAE,QAAQ,WAAW;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,qBACL,UACA,SACkC;AAElC,UAAM,oBAAmE,CAAC;AAG1E,QAAI,KAAK,cAAc;AACrB,wBAAkB,KAAK;AAAA,QACrB,MAAM;AAAA,QACN,SAAS,KAAK;AAAA,MAChB,CAAC;AAAA,IACH;AAGA,sBAAkB;AAAA,MAChB,GAAG,SAAS,IAAI,SAAO;AAErB,cAAM,eAAoB;AAAA,UACxB,MAAM,IAAI;AAAA,UACV,SAAS,IAAI;AAAA,QACf;AAEA,YAAI,IAAI,SAAS,UAAU,IAAI,cAAc;AAC3C,uBAAa,eAAe,IAAI;AAAA,QAClC;AAEA,eAAO;AAAA,MACT,CAAC;AAAA,IACH;AAIA,UAAM,gBAAqB;AAAA,MACzB,OAAO,KAAK;AAAA,MACZ,UAAU;AAAA,MACV,aAAa,KAAK;AAAA,MAClB,YAAY,KAAK;AAAA,MACjB,OAAO,KAAK;AAAA,MACZ,QAAQ;AAAA;AAAA,IACV;AAGA,UAAM,aAAa,SAAS,kBAAkB,KAAK;AAGnD,QAAI,cAAc,WAAW,SAAS,GAAG;AACvC,YAAM,iBAAiB,WAAW,IAAI,UAAQ;AAQ5C,cAAM,YAAY;AAElB,YAAI,UAAU,SAAS,YAAY;AACjC,iBAAO;AAAA,QACT;AAEA,eAAO;AAAA,UACL,MAAM;AAAA,UACN,UAAU;AAAA,YACR,MAAM,UAAU;AAAA,YAChB,aAAa,UAAU;AAAA,YACvB,YAAY,UAAU,cAAc,CAAC;AAAA,UACvC;AAAA,QACF;AAAA,MACF,CAAC;AAED,oBAAc,QAAQ;AAAA,IACxB;AAIA,UAAM,SAAU,MAAM,KAAK,OAAO,KAAK,YAAY,OAAO,aAAa;AAGvE,qBAAiB,SAAS,QAAQ;AAChC,YAAM,QAAQ,MAAM,QAAQ,CAAC,GAAG;AAEhC,UAAI,OAAO,SAAS;AAElB,cAAM;AAAA,UACJ,MAAM;AAAA,UACN,SAAS,MAAM;AAAA,QACjB;AAAA,MACF;AAEA,UAAI,OAAO,YAAY;AAErB,cAAM;AAAA,UACJ,MAAM;AAAA,UACN,SAAS;AAAA;AAAA,UAET,YAAY,MAAM,WAAW,IAAI,CAAC,cAAmB;AAAA,YACnD,IAAI,SAAS,MAAM;AAAA,YACnB,UAAU;AAAA,cACR,MAAM,SAAS,UAAU,QAAQ;AAAA,cACjC,WAAW,SAAS,UAAU,aAAa;AAAA,YAC7C;AAAA,YACA,MAAM;AAAA,YACN,WAAW,SAAS,UAAU,QAAQ;AAAA,YACtC,WAAW,SAAS,UAAU,aAAa;AAAA,UAC7C,EAAE;AAAA,QACJ;AAAA,MACF;AAGA,UAAI,MAAM,OAAO;AACf,cAAM;AAAA,UACJ,MAAM;AAAA,UACN,SAAS;AAAA,UACT,OAAO;AAAA,YACL,mBAAmB,MAAM,MAAM,qBAAqB;AAAA,YACpD,eAAe,MAAM,MAAM,iBAAiB;AAAA,YAC5C,yBAAyB,MAAM,MAAM;AAAA,YACrC,0BAA0B,MAAM,MAAM;AAAA,YACtC,cAAc,MAAM,MAAM,gBAAgB;AAAA,UAC5C;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,eACJ,UACA,SACkB;AAElB,UAAM,oBAAmE,CAAC;AAG1E,QAAI,KAAK,cAAc;AACrB,wBAAkB,KAAK;AAAA,QACrB,MAAM;AAAA,QACN,SAAS,KAAK;AAAA,MAChB,CAAC;AAAA,IACH;AAGA,sBAAkB;AAAA,MAChB,GAAG,SAAS,IAAI,SAAO;AAGrB,cAAM,eAAoB;AAAA,UACxB,MAAM,IAAI;AAAA,UACV,SAAS,IAAI;AAAA,QACf;AAGA,YAAI,IAAI,SAAS,UAAU,IAAI,cAAc;AAC3C,uBAAa,eAAe,IAAI;AAAA,QAClC;AAEA,eAAO;AAAA,MACT,CAAC;AAAA,IACH;AAIA,UAAM,gBAAqB;AAAA,MACzB,OAAO,KAAK;AAAA,MACZ,UAAU;AAAA,MACV,aAAa,KAAK;AAAA,MAClB,YAAY,KAAK;AAAA,MACjB,OAAO,KAAK;AAAA,IACd;AAIA,UAAM,aAAa,SAAS,kBAAkB,KAAK;AAGnD,QAAI,cAAc,WAAW,SAAS,GAAG;AAEvC,YAAM,iBAAiB,WAAW,IAAI,UAAQ;AAS5C,cAAM,YAAY;AAGlB,YAAI,UAAU,SAAS,YAAY;AACjC,iBAAO;AAAA,QACT;AAGA,eAAO;AAAA,UACL,MAAM;AAAA,UACN,UAAU;AAAA,YACR,MAAM,UAAU;AAAA,YAChB,aAAa,UAAU;AAAA,YACvB,YAAY,UAAU,cAAc,CAAC;AAAA,UACvC;AAAA,QACF;AAAA,MACF,CAAC;AAED,oBAAc,QAAQ;AAAA,IACxB;AAGA,UAAM,WAAW,MAAM,KAAK,OAAO,KAAK,YAAY,OAAO,aAAa;AAGxE,UAAM,kBAAkB,SAAS,QAAQ,CAAC,EAAE;AAG5C,UAAM,SAAkB;AAAA,MACtB,MAAM;AAAA,MACN,SAAS,gBAAgB,WAAW;AAAA,IACtC;AAGA,QAAI,SAAS,OAAO;AAClB,YAAM,QAAQ,SAAS;AAIvB,aAAO,QAAQ;AAAA,QACb,mBAAmB,MAAM,qBAAqB;AAAA,QAC9C,eAAe,MAAM,iBAAiB;AAAA,QACtC,yBAAyB,MAAM;AAAA,QAC/B,0BAA0B,MAAM;AAAA,QAChC,cAAc,MAAM,gBAAgB;AAAA,MACtC;AAAA,IACF;AAGA,QAAI,gBAAgB,cAAc,gBAAgB,WAAW,SAAS,GAAG;AAGvE,aAAO,aAAa,gBAAgB,WAAW,IAAI,cAAY;AAE7D,YAAI;AAEJ,cAAM,UAAU,SAAS,SAAS;AAElC,YAAI,OAAO,YAAY,UAAU;AAC/B,gBAAM,MAAM;AACZ,cAAI;AACF,mBAAO,OAAO,IAAI,KAAK,EAAE,SAAS,IAAK,KAAK,MAAM,GAAG,IAAgC,CAAC;AAAA,UACxF,QAAQ;AACN,mBAAO,CAAC;AAAA,UACV;AAAA,QACF,WAAW,WAAW,OAAO,YAAY,UAAU;AACjD,iBAAO;AAAA,QACT,OAAO;AACL,iBAAO,CAAC;AAAA,QACV;AAEA,eAAO;AAAA,UACL,IAAI,SAAS;AAAA;AAAA,UAEb,UAAU;AAAA,YACR,MAAM,SAAS,SAAS;AAAA,YACxB,WAAW,SAAS,SAAS,aAAa;AAAA,UAC5C;AAAA,UACA,MAAM;AAAA;AAAA,UAEN,WAAW,SAAS,SAAS;AAAA,UAC7B,WAAW;AAAA,QACb;AAAA,MACF,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,IAAI,OAAsD;AAC9D,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,KAAK,mBAAmB,KAAK;AAAA,IACtC,OAAO;AACL,aAAO,KAAK,eAAe,KAAK;AAAA,IAClC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,WAAW,IAAS,IAAS;AAE3B,OAAG,QAAQ,EAAE,QAAQ,OAAO,WAAmB;AAC7C,UAAI;AACF,cAAM,aAAa,MAAM,KAAK,mBAAmB,MAAM;AACvD,WAAG,YAAY,EAAE,KAAK,UAAU;AAAA,MAClC,SAAS,OAAO;AACd,gBAAQ,MAAM,0CAAsB,KAAK;AACzC,WAAG,YAAY,EAAE,KAAK,8BAAU;AAAA,MAClC;AAAA,IACF,CAAC;AAGD,OAAG,UAAU,EAAE,QAAQ,OAAO,aAAwB;AACpD,UAAI;AACF,cAAM,kBAAkB,MAAM,KAAK,eAAe,QAAQ;AAC1D,WAAG,SAAS,EAAE,KAAK,eAAe;AAAA,MACpC,SAAS,OAAO;AACd,gBAAQ,MAAM,0CAAsB,KAAK;AACzC,WAAG,SAAS,EAAE,KAAK;AAAA,UACjB,MAAM;AAAA,UACN,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAGA,IAAO,mBAAQ;","names":["OpenAI"]}
+{"version":3,"sources":["../../src/model-provider/index.ts","../../src/model-provider/deepseek/index.ts"],"sourcesContent":["export {\n  default as Deepseek,\n  type AssistantMessage as DeepseekAssistantMessage,\n  type ChatCompletionOptions as DeepseekChatCompletionOptions,\n  type DeepseekConfig,\n  type Message as DeepseekMessage,\n  type MessageRole as DeepseekMessageRole,\n  type RawTool as DeepseekRawTool,\n  type ResponseToolCall as DeepseekResponseToolCall,\n  type StreamChunk as DeepseekStreamChunk,\n  type StreamToolCall as DeepseekStreamToolCall,\n  type TokenUsage as DeepseekTokenUsage,\n  type ToolCall as DeepseekToolCall,\n} from './deepseek';\n","import { Component } from '@astack-tech/core';\nimport type { Port } from '@astack-tech/core';\nimport OpenAI from 'openai';\n\n/**\n * Options for the DeepSeek model provider.\n */\nexport interface DeepseekConfig {\n  /** DeepSeek API key. */\n  apiKey: string;\n  /** Model name. Defaults to `deepseek-chat`. */\n  model?: string | undefined;\n  /** API base URL. Defaults to `https://api.deepseek.com/v1`. */\n  baseURL?: string | undefined;\n  /** Sampling temperature. Defaults to `0.7`. */\n  temperature?: number | undefined;\n  /** Maximum number of generated tokens. */\n  maxTokens?: number | undefined;\n  /** Nucleus sampling probability. */\n  topP?: number | undefined;\n  /** System prompt added before every request. */\n  systemPrompt?: string | undefined;\n  /**\n   * Tools given as `{ name, description, parameters }` objects.\n   * When this list is not empty, it takes precedence over `tools`.\n   */\n  rawTools?: RawTool[] | undefined;\n  /** Tools in the OpenAI-compatible `{ type: 'function', function }` format. */\n  tools?: unknown[] | undefined;\n  /** Allows the OpenAI client to run in a browser. Defaults to `false`. */\n  dangerouslyAllowBrowser?: boolean | undefined;\n  /** Logs API errors to the console. Defaults to `false`. */\n  verbose?: boolean | undefined;\n}\n\n/**\n * Tool description accepted by `rawTools` and `temporaryTools`.\n */\nexport interface RawTool {\n  name: string;\n  description: string;\n  parameters?: Record<string, unknown> | undefined;\n}\n\n/**\n * Role of a chat message.\n */\nexport type MessageRole = 'system' | 'user' | 'assistant' | 'tool';\n\n/**\n * Tool call in the internal format.\n */\nexport interface ToolCall {\n  /** Identifier assigned by the API. */\n  id?: string | undefined;\n  /** Name of the tool. */\n  tool_name: string;\n  /** Parsed arguments. */\n  arguments: Record<string, unknown>;\n}\n\n/**\n * Tool call returned by `chatCompletion`. It carries both the OpenAI shape\n * (`type`, `function`) and the internal shape (`tool_name`, `arguments`).\n */\nexport interface ResponseToolCall {\n  id: string;\n  type: 'function';\n  function: { name: string; arguments: string };\n  tool_name: string;\n  arguments: Record<string, unknown>;\n}\n\n/**\n * Partial tool call emitted while streaming. `arguments` holds the raw JSON fragment.\n */\nexport interface StreamToolCall {\n  id: string;\n  type: 'function';\n  function: { name: string; arguments: string };\n  tool_name: string;\n  arguments: string;\n}\n\n/**\n * Token usage reported by the API.\n */\nexport interface TokenUsage {\n  completion_tokens: number;\n  prompt_tokens: number;\n  prompt_cache_hit_tokens?: number | undefined;\n  prompt_cache_miss_tokens?: number | undefined;\n  total_tokens: number;\n}\n\n/**\n * Chat message accepted as input. It matches the agent message contract in\n * `@astack-tech/components`, so agent histories can be passed directly.\n */\nexport interface Message {\n  /** One of `system`, `user`, `assistant` or `tool` (see `MessageRole`). */\n  role: string;\n  content?: string | undefined;\n  /** Accepted for compatibility. Assistant tool calls are not forwarded to the API. */\n  tool_calls?: readonly unknown[] | undefined;\n  /** Identifier of the call that a `tool` message answers. */\n  tool_call_id?: string | undefined;\n  usage?: TokenUsage | undefined;\n}\n\n/**\n * Assistant message returned by `chatCompletion`.\n */\nexport interface AssistantMessage {\n  role: 'assistant';\n  content: string;\n  tool_calls?: ResponseToolCall[] | undefined;\n  usage?: TokenUsage | undefined;\n}\n\n/**\n * Chunk yielded by `streamChatCompletion`.\n */\nexport interface StreamChunk {\n  role: 'assistant';\n  content: string;\n  tool_calls?: StreamToolCall[] | undefined;\n  usage?: TokenUsage | undefined;\n}\n\n/**\n * Per-call options.\n */\nexport interface ChatCompletionOptions {\n  /** Tools for this call only. They replace the configured tools. */\n  temporaryTools?: unknown[] | undefined;\n}\n\ntype ChatMessageParam = OpenAI.Chat.ChatCompletionMessageParam;\ntype ChatTool = OpenAI.Chat.ChatCompletionTool;\n\ninterface DeepseekUsage {\n  completion_tokens?: number;\n  prompt_tokens?: number;\n  total_tokens?: number;\n  prompt_cache_hit_tokens?: number;\n  prompt_cache_miss_tokens?: number;\n}\n\nconst DEFAULT_BASE_URL = 'https://api.deepseek.com/v1';\nconst DEFAULT_MODEL = 'deepseek-chat';\nconst DEFAULT_TEMPERATURE = 0.7;\nconst FALLBACK_TEXT = 'API call failed';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Converts a `{ name, description, parameters }` object to the OpenAI tool format.\n * Objects already in the OpenAI format are returned unchanged.\n */\nfunction toApiTool(tool: unknown): ChatTool {\n  if (isRecord(tool) && tool['type'] === 'function') {\n    return tool as unknown as ChatTool;\n  }\n  const raw = isRecord(tool) ? tool : {};\n  const { name, description, parameters } = raw;\n  return {\n    type: 'function',\n    function: {\n      name: typeof name === 'string' ? name : '',\n      description: typeof description === 'string' ? description : '',\n      parameters: isRecord(parameters) ? parameters : {},\n    },\n  };\n}\n\n/**\n * Parses tool-call arguments. Anything that is not a JSON object becomes `{}`.\n */\nfunction parseArguments(raw: string): Record<string, unknown> {\n  if (raw.trim().length === 0) {\n    return {};\n  }\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    return isRecord(parsed) ? parsed : {};\n  } catch {\n    return {};\n  }\n}\n\nfunction mapUsage(usage: DeepseekUsage): TokenUsage {\n  return {\n    completion_tokens: usage.completion_tokens ?? 0,\n    prompt_tokens: usage.prompt_tokens ?? 0,\n    total_tokens: usage.total_tokens ?? 0,\n    ...(usage.prompt_cache_hit_tokens === undefined\n      ? {}\n      : { prompt_cache_hit_tokens: usage.prompt_cache_hit_tokens }),\n    ...(usage.prompt_cache_miss_tokens === undefined\n      ? {}\n      : { prompt_cache_miss_tokens: usage.prompt_cache_miss_tokens }),\n  };\n}\n\n/**\n * DeepSeek model provider. It calls the DeepSeek API through the OpenAI-compatible client.\n *\n * Ports:\n * - `prompt` (in): a text prompt. The answer is sent on `completion`.\n * - `messages` (in): a list of chat messages. The reply is sent on `message`.\n */\nclass Deepseek extends Component {\n  private readonly client: OpenAI;\n  private readonly model: string;\n  private readonly temperature: number;\n  private readonly maxTokens: number | undefined;\n  private readonly topP: number | undefined;\n  private readonly systemPrompt: string | undefined;\n  private readonly tools: unknown[] | undefined;\n  private readonly verbose: boolean;\n\n  constructor(config: DeepseekConfig) {\n    super({});\n\n    this.client = new OpenAI({\n      apiKey: config.apiKey,\n      baseURL: config.baseURL ?? DEFAULT_BASE_URL,\n      dangerouslyAllowBrowser: config.dangerouslyAllowBrowser ?? false,\n    });\n\n    this.model = config.model ?? DEFAULT_MODEL;\n    this.temperature = config.temperature ?? DEFAULT_TEMPERATURE;\n    this.maxTokens = config.maxTokens;\n    this.topP = config.topP;\n    this.systemPrompt = config.systemPrompt;\n    this.verbose = config.verbose ?? false;\n    this.tools =\n      config.rawTools !== undefined && config.rawTools.length > 0\n        ? config.rawTools.map(toApiTool)\n        : config.tools;\n\n    Component.Port.I('prompt').attach(this);\n    Component.Port.I('messages').attach(this);\n    Component.Port.O('completion').attach(this);\n    Component.Port.O('message').attach(this);\n  }\n\n  /**\n   * Generates a completion for a single prompt.\n   *\n   * @returns The text answer, or the JSON-encoded assistant message when it contains tool calls.\n   */\n  async generateCompletion(prompt: string): Promise<string> {\n    const response = await this.client.chat.completions.create({\n      ...this.baseRequest(),\n      messages: [...this.systemMessages(), { role: 'user', content: prompt }],\n      ...this.toolsParam(this.tools),\n    });\n\n    const message = this.firstMessage(response);\n    if (message.tool_calls !== undefined && message.tool_calls.length > 0) {\n      return JSON.stringify(message);\n    }\n    return message.content ?? '';\n  }\n\n  /**\n   * Sends a conversation and returns the assistant reply.\n   */\n  async chatCompletion(\n    messages: Message[],\n    options?: ChatCompletionOptions\n  ): Promise<AssistantMessage> {\n    const response = await this.client.chat.completions.create({\n      ...this.baseRequest(),\n      messages: this.formatMessages(messages),\n      ...this.toolsParam(options?.temporaryTools ?? this.tools),\n    });\n\n    const message = this.firstMessage(response);\n    const result: AssistantMessage = { role: 'assistant', content: message.content ?? '' };\n\n    if (response.usage !== undefined) {\n      result.usage = mapUsage(response.usage);\n    }\n\n    if (message.tool_calls !== undefined && message.tool_calls.length > 0) {\n      result.tool_calls = message.tool_calls.map(toolCall => {\n        if (toolCall.type !== 'function') {\n          throw new Error(`Unsupported tool call type: ${toolCall.type}`);\n        }\n        const rawArguments = toolCall.function.arguments;\n        return {\n          id: toolCall.id,\n          type: 'function',\n          function: {\n            name: toolCall.function.name,\n            arguments: rawArguments.length > 0 ? rawArguments : '{}',\n          },\n          tool_name: toolCall.function.name,\n          arguments: parseArguments(rawArguments),\n        };\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * Streams the assistant reply. Each chunk holds a text delta, tool-call deltas, or usage.\n   */\n  async *streamChatCompletion(\n    messages: Message[],\n    options?: ChatCompletionOptions\n  ): AsyncGenerator<StreamChunk> {\n    const stream = await this.client.chat.completions.create({\n      ...this.baseRequest(),\n      messages: this.formatMessages(messages),\n      ...this.toolsParam(options?.temporaryTools ?? this.tools),\n      stream: true,\n    });\n\n    for await (const chunk of stream) {\n      const delta = chunk.choices[0]?.delta;\n\n      if (delta?.content) {\n        yield { role: 'assistant', content: delta.content };\n      }\n\n      if (delta?.tool_calls) {\n        yield {\n          role: 'assistant',\n          content: '',\n          tool_calls: delta.tool_calls.map(toolCall => {\n            const name = toolCall.function?.name ?? '';\n            const args = toolCall.function?.arguments ?? '';\n            return {\n              id: toolCall.id ?? '',\n              type: 'function',\n              function: { name, arguments: args },\n              tool_name: name,\n              arguments: args,\n            };\n          }),\n        };\n      }\n\n      if (chunk.usage) {\n        yield { role: 'assistant', content: '', usage: mapUsage(chunk.usage) };\n      }\n    }\n  }\n\n  /**\n   * Runs the model outside a pipeline.\n   *\n   * @param input A prompt string or a list of messages.\n   */\n  override run(input: string | Message[]): Promise<string | AssistantMessage> {\n    return typeof input === 'string' ? this.generateCompletion(input) : this.chatCompletion(input);\n  }\n\n  /**\n   * Connects the `prompt` and `messages` input ports to the model.\n   * API errors produce a fallback value so the pipeline keeps flowing.\n   */\n  override _transform($i: Port, $o: Port): void {\n    $i('prompt').receive((prompt: string) => {\n      this.generateCompletion(prompt).then(\n        completion => {\n          $o('completion').send(completion);\n        },\n        (error: unknown) => {\n          this.logError(error);\n          $o('completion').send(FALLBACK_TEXT);\n        }\n      );\n    });\n\n    $i('messages').receive((messages: Message[]) => {\n      this.chatCompletion(messages).then(\n        message => {\n          $o('message').send(message);\n        },\n        (error: unknown) => {\n          this.logError(error);\n          $o('message').send({ role: 'assistant', content: FALLBACK_TEXT });\n        }\n      );\n    });\n  }\n\n  private baseRequest(): {\n    model: string;\n    temperature: number;\n    max_tokens?: number;\n    top_p?: number;\n  } {\n    return {\n      model: this.model,\n      temperature: this.temperature,\n      ...(this.maxTokens === undefined ? {} : { max_tokens: this.maxTokens }),\n      ...(this.topP === undefined ? {} : { top_p: this.topP }),\n    };\n  }\n\n  private toolsParam(tools: unknown[] | undefined): { tools?: ChatTool[] } {\n    return tools !== undefined && tools.length > 0 ? { tools: tools.map(toApiTool) } : {};\n  }\n\n  private systemMessages(): ChatMessageParam[] {\n    return this.systemPrompt ? [{ role: 'system', content: this.systemPrompt }] : [];\n  }\n\n  /**\n   * Converts input messages to API messages. Assistant `tool_calls` are not forwarded:\n   * agents send tool results back as user messages, and the API rejects assistant tool\n   * calls that are not followed by tool messages.\n   */\n  private formatMessages(messages: Message[]): ChatMessageParam[] {\n    return [\n      ...this.systemMessages(),\n      ...messages.map(\n        (message): ChatMessageParam =>\n          ({\n            role: message.role,\n            content: message.content,\n            ...(message.role === 'tool' && message.tool_call_id\n              ? { tool_call_id: message.tool_call_id }\n              : {}),\n          }) as ChatMessageParam\n      ),\n    ];\n  }\n\n  private firstMessage(response: OpenAI.Chat.ChatCompletion): OpenAI.Chat.ChatCompletionMessage {\n    const choice = response.choices[0];\n    if (choice === undefined) {\n      throw new Error('DeepSeek returned no choices.');\n    }\n    return choice.message;\n  }\n\n  private logError(error: unknown): void {\n    if (this.verbose) {\n      // eslint-disable-next-line no-console -- opt-in diagnostics controlled by `verbose`.\n      console.error('[Deepseek] API call failed:', error);\n    }\n  }\n}\n\nexport default Deepseek;\n"],"mappings":"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","names":["OpenAI"]}

package/dist/model-provider/index.d.cts

@@ -1,195 +1,196 @@
-import { Component } from '@astack-tech/core';
+import { Component, Port } from '@astack-tech/core';
 
 /**
- * Deepseek 模型提供者配置
+ * Options for the DeepSeek model provider.
  */
 interface DeepseekConfig {
-    /**
-     * API 密钥
-     */
+    /** DeepSeek API key. */
     apiKey: string;
-    /**
-     * 使用的模型名称
-     * 默认为 'deepseek-chat'
-     */
-    model?: string;
-    /**
-     * 自定义 API 基础 URL
-     * 默认为 Deepseek 官方 API 地址
-     */
-    baseURL?: string;
-    /**
-     * 温度参数，控制输出的随机性
-     */
-    temperature?: number;
-    /**
-     * 最大生成的 token 数
-     */
-    maxTokens?: number;
-    /**
-     * 采样概率
-     */
-    topP?: number;
-    /**
-     * 系统提示消息
-     */
-    systemPrompt?: string;
-    /**
-     * 工具实例数组，直接传递工具实例
-     * 每个工具应具有 name、description 和 parameters 属性
-     */
-    rawTools?: Array<{
-        name: string;
-        description: string;
-        parameters?: Record<string, unknown>;
-    }>;
-    /**
-     * API 格式的工具定义数组，与 rawTools 二选一
-     * 使用 OpenAI 兼容的工具定义格式
-     */
-    tools?: unknown[];
-    /**
-     * dangerouslyAllowBrowser
-     * 是否允许在浏览器等非安全环境内运行
-     */
-    dangerouslyAllowBrowser?: boolean;
+    /** Model name. Defaults to `deepseek-chat`. */
+    model?: string | undefined;
+    /** API base URL. Defaults to `https://api.deepseek.com/v1`. */
+    baseURL?: string | undefined;
+    /** Sampling temperature. Defaults to `0.7`. */
+    temperature?: number | undefined;
+    /** Maximum number of generated tokens. */
+    maxTokens?: number | undefined;
+    /** Nucleus sampling probability. */
+    topP?: number | undefined;
+    /** System prompt added before every request. */
+    systemPrompt?: string | undefined;
+    /**
+     * Tools given as `{ name, description, parameters }` objects.
+     * When this list is not empty, it takes precedence over `tools`.
+     */
+    rawTools?: RawTool[] | undefined;
+    /** Tools in the OpenAI-compatible `{ type: 'function', function }` format. */
+    tools?: unknown[] | undefined;
+    /** Allows the OpenAI client to run in a browser. Defaults to `false`. */
+    dangerouslyAllowBrowser?: boolean | undefined;
+    /** Logs API errors to the console. Defaults to `false`. */
+    verbose?: boolean | undefined;
+}
+/**
+ * Tool description accepted by `rawTools` and `temporaryTools`.
+ */
+interface RawTool {
+    name: string;
+    description: string;
+    parameters?: Record<string, unknown> | undefined;
 }
 /**
- * 消息角色类型
+ * Role of a chat message.
  */
 type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
 /**
- * 工具调用
+ * Tool call in the internal format.
  */
 interface ToolCall {
-    /**
-     * 工具调用 ID
-     */
-    id?: string;
-    /**
-     * 工具名称
-     */
+    /** Identifier assigned by the API. */
+    id?: string | undefined;
+    /** Name of the tool. */
     tool_name: string;
-    /**
-     * 工具调用参数
-     */
+    /** Parsed arguments. */
     arguments: Record<string, unknown>;
 }
 /**
- * Token 使用统计
+ * Tool call returned by `chatCompletion`. It carries both the OpenAI shape
+ * (`type`, `function`) and the internal shape (`tool_name`, `arguments`).
+ */
+interface ResponseToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+    tool_name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * Partial tool call emitted while streaming. `arguments` holds the raw JSON fragment.
+ */
+interface StreamToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+    tool_name: string;
+    arguments: string;
+}
+/**
+ * Token usage reported by the API.
  */
 interface TokenUsage {
-    /**
-     * 完成部分的 token 数量
-     */
     completion_tokens: number;
-    /**
-     * 提示部分的 token 数量
-     */
     prompt_tokens: number;
-    /**
-     * 提示缓存命中的 token 数量（可选）
-     */
-    prompt_cache_hit_tokens?: number;
-    /**
-     * 提示缓存未命中的 token 数量（可选）
-     */
-    prompt_cache_miss_tokens?: number;
-    /**
-     * 总 token 数量
-     */
+    prompt_cache_hit_tokens?: number | undefined;
+    prompt_cache_miss_tokens?: number | undefined;
     total_tokens: number;
 }
 /**
- * 对话消息类型
+ * Chat message accepted as input. It matches the agent message contract in
+ * `@astack-tech/components`, so agent histories can be passed directly.
  */
 interface Message {
-    /**
-     * 消息角色
-     */
-    role: MessageRole;
-    /**
-     * 消息内容
-     */
-    content?: string;
-    /**
-     * 工具调用
-     */
-    tool_calls?: ToolCall[];
-    /**
-     * 工具调用 ID，用于工具响应消息
-     */
-    tool_call_id?: string;
-    /**
-     * Token 使用统计（可选）
-     */
-    usage?: TokenUsage;
+    /** One of `system`, `user`, `assistant` or `tool` (see `MessageRole`). */
+    role: string;
+    content?: string | undefined;
+    /** Accepted for compatibility. Assistant tool calls are not forwarded to the API. */
+    tool_calls?: readonly unknown[] | undefined;
+    /** Identifier of the call that a `tool` message answers. */
+    tool_call_id?: string | undefined;
+    usage?: TokenUsage | undefined;
 }
 /**
- * Deepseek 组件
- *
- * 使用 OpenAI 兼容接口调用 Deepseek 模型
- *
- * 输入:
- *   - prompt: 文本提示
- *   - messages: 对话消息数组
+ * Assistant message returned by `chatCompletion`.
+ */
+interface AssistantMessage {
+    role: 'assistant';
+    content: string;
+    tool_calls?: ResponseToolCall[] | undefined;
+    usage?: TokenUsage | undefined;
+}
+/**
+ * Chunk yielded by `streamChatCompletion`.
+ */
+interface StreamChunk {
+    role: 'assistant';
+    content: string;
+    tool_calls?: StreamToolCall[] | undefined;
+    usage?: TokenUsage | undefined;
+}
+/**
+ * Per-call options.
+ */
+interface ChatCompletionOptions {
+    /** Tools for this call only. They replace the configured tools. */
+    temporaryTools?: unknown[] | undefined;
+}
+/**
+ * DeepSeek model provider. It calls the DeepSeek API through the OpenAI-compatible client.
  *
- * 输出:
- *   - completion: 生成的文本完成
- *   - message: 生成的响应消息
+ * Ports:
+ * - `prompt` (in): a text prompt. The answer is sent on `completion`.
+ * - `messages` (in): a list of chat messages. The reply is sent on `message`.
  */
 declare class Deepseek extends Component {
-    private client;
-    private model;
-    private temperature;
-    private maxTokens?;
-    private topP?;
-    private systemPrompt?;
-    private tools?;
+    private readonly client;
+    private readonly model;
+    private readonly temperature;
+    private readonly maxTokens;
+    private readonly topP;
+    private readonly systemPrompt;
+    private readonly tools;
+    private readonly verbose;
     constructor(config: DeepseekConfig);
     /**
-     * 生成文本完成
-     * @param prompt 提示文本
-     * @returns 生成的文本
+     * Generates a completion for a single prompt.
+     *
+     * @returns The text answer, or the JSON-encoded assistant message when it contains tool calls.
      */
     generateCompletion(prompt: string): Promise<string>;
     /**
-     * 流式处理对话消息
-     * @param messages 对话消息数组
-     * @param options 可选的调用选项，包含临时工具列表
-     * @returns 生成的流式响应消息异步生成器
+     * Sends a conversation and returns the assistant reply.
+     */
+    chatCompletion(messages: Message[], options?: ChatCompletionOptions): Promise<AssistantMessage>;
+    /**
+     * Streams the assistant reply. Each chunk holds a text delta, tool-call deltas, or usage.
      */
-    streamChatCompletion(messages: Message[], options?: {
-        temporaryTools?: unknown[];
-    }): AsyncGenerator<Partial<Message>>;
+    streamChatCompletion(messages: Message[], options?: ChatCompletionOptions): AsyncGenerator<StreamChunk>;
     /**
-     * 处理对话消息
-     * @param messages 对话消息数组
-     * @param options 可选的调用选项，包含临时工具列表
-     * @returns 生成的响应消息
+     * Runs the model outside a pipeline.
+     *
+     * @param input A prompt string or a list of messages.
      */
-    chatCompletion(messages: Message[], options?: {
-        temporaryTools?: unknown[];
-    }): Promise<Message>;
+    run(input: string | Message[]): Promise<string | AssistantMessage>;
     /**
-     * 在独立模式下运行组件
-     * @param input 输入参数，可以是提示文本或对话消息数组
-     * @returns 生成的文本或响应消息
+     * Connects the `prompt` and `messages` input ports to the model.
+     * API errors produce a fallback value so the pipeline keeps flowing.
      */
-    run(input: string | Message[]): Promise<string | Message>;
+    _transform($i: Port, $o: Port): void;
+    private baseRequest;
+    private toolsParam;
+    private systemMessages;
     /**
-     * 在流水线中运行组件
-     * @param $i 输入端口
-     * @param $o 输出端口
+     * Converts input messages to API messages. Assistant `tool_calls` are not forwarded:
+     * agents send tool results back as user messages, and the API rejects assistant tool
+     * calls that are not followed by tool messages.
      */
-    _transform($i: any, $o: any): void;
+    private formatMessages;
+    private firstMessage;
+    private logError;
 }
 
 type index_Deepseek = Deepseek;
 declare const index_Deepseek: typeof Deepseek;
 type index_DeepseekConfig = DeepseekConfig;
 declare namespace index {
-  export { index_Deepseek as Deepseek, type index_DeepseekConfig as DeepseekConfig, type Message as DeepseekMessage, type MessageRole as DeepseekMessageRole, type ToolCall as DeepseekToolCall };
+  export { index_Deepseek as Deepseek };
+  export type { AssistantMessage as DeepseekAssistantMessage, ChatCompletionOptions as DeepseekChatCompletionOptions, index_DeepseekConfig as DeepseekConfig, Message as DeepseekMessage, MessageRole as DeepseekMessageRole, RawTool as DeepseekRawTool, ResponseToolCall as DeepseekResponseToolCall, StreamChunk as DeepseekStreamChunk, StreamToolCall as DeepseekStreamToolCall, TokenUsage as DeepseekTokenUsage, ToolCall as DeepseekToolCall };
 }
 
-export { Deepseek, type DeepseekConfig, type Message as DeepseekMessage, type MessageRole as DeepseekMessageRole, type ToolCall as DeepseekToolCall, index as i };
+export { Deepseek, index as i };
+export type { AssistantMessage as DeepseekAssistantMessage, ChatCompletionOptions as DeepseekChatCompletionOptions, DeepseekConfig, Message as DeepseekMessage, MessageRole as DeepseekMessageRole, RawTool as DeepseekRawTool, ResponseToolCall as DeepseekResponseToolCall, StreamChunk as DeepseekStreamChunk, StreamToolCall as DeepseekStreamToolCall, TokenUsage as DeepseekTokenUsage, ToolCall as DeepseekToolCall };