@astack-tech/integrations 0.2.0-beta.7 → 0.2.0-beta.8

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/model-provider/deepseek/index.ts"],"sourcesContent":["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":[]}
+{"version":3,"sources":["../../src/model-provider/openai-compatible/index.ts","../../src/model-provider/deepseek/index.ts"],"sourcesContent":["import { Component } from '@astack-tech/core';\nimport type { Port } from '@astack-tech/core';\nimport OpenAI from 'openai';\n\n/**\n * Options for a provider that speaks the OpenAI chat completions API.\n */\nexport interface OpenAICompatibleConfig {\n  /** API key of the provider. */\n  apiKey: string;\n  /** Model name, for example `gpt-4o-mini`, `qwen-plus` or `llama3.1`. */\n  model: string;\n  /** API base URL. Defaults to `https://api.openai.com/v1`. */\n  baseURL?: string | undefined;\n  /** Provider name used in errors and logs. Defaults to `The model API`. */\n  name?: 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  /** Unique tool name. */\n  name: string;\n  /** Description that tells the model when to use the tool. */\n  description: string;\n  /** JSON Schema of the arguments. Defaults to `{}`. */\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  /** Identifier assigned by the API. A `tool` message answers the call with it. */\n  id: string;\n  /** Always `function`. */\n  type: 'function';\n  /** The call in the OpenAI shape: function name and raw JSON arguments. An empty argument string is sent as `{}`. */\n  function: {\n    /** Name of the tool to call. */\n    name: string;\n    /** Arguments as JSON text. */\n    arguments: string;\n  };\n  /** Name of the tool, same as `function.name`. */\n  tool_name: string;\n  /** Parsed arguments. JSON that is not an object becomes `{}`. */\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  /** Identifier assigned by the API. Only the first delta of a call carries it; later deltas have `''`. */\n  id: string;\n  /** Always `function`. */\n  type: 'function';\n  /** The delta in the OpenAI shape. `arguments` holds only this delta's JSON fragment. */\n  function: {\n    /** Name of the tool to call. */\n    name: string;\n    /** Arguments as JSON text. */\n    arguments: string;\n  };\n  /** Name of the tool when this delta carries it, otherwise `''`. */\n  tool_name: string;\n  /** Raw JSON fragment of this delta. Concatenate the fragments of a call to get its arguments. */\n  arguments: string;\n}\n\n/**\n * Token usage reported by the API.\n */\nexport interface TokenUsage {\n  /** Tokens in the generated reply. */\n  completion_tokens: number;\n  /** Tokens in the request. */\n  prompt_tokens: number;\n  /** Prompt tokens served from the provider's context cache (reported by DeepSeek). */\n  prompt_cache_hit_tokens?: number | undefined;\n  /** Prompt tokens not served from the cache. */\n  prompt_cache_miss_tokens?: number | undefined;\n  /** Sum of prompt and completion tokens. */\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  /** Text content. Omitted content is sent as no content. */\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  /** Ignored on input. Present so agent histories can be passed unchanged. */\n  usage?: TokenUsage | undefined;\n}\n\n/**\n * Assistant message returned by `chatCompletion`.\n */\nexport interface AssistantMessage {\n  /** Always `assistant`. */\n  role: 'assistant';\n  /** Reply text. Empty when the model only calls tools. */\n  content: string;\n  /** Tool calls requested by the model, if any. */\n  tool_calls?: ResponseToolCall[] | undefined;\n  /** Token usage of this request, when the API reports it. */\n  usage?: TokenUsage | undefined;\n}\n\n/**\n * Chunk yielded by `streamChatCompletion`.\n */\nexport interface StreamChunk {\n  /** Always `assistant`. */\n  role: 'assistant';\n  /** Text delta. Empty in chunks that carry tool calls or usage. */\n  content: string;\n  /** Tool-call deltas in this chunk. */\n  tool_calls?: StreamToolCall[] | undefined;\n  /** Token usage. Sent once, in the final chunk, when the API reports it. */\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 ApiUsage {\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.openai.com/v1';\nconst DEFAULT_NAME = 'The model API';\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: ApiUsage): 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 * Model provider for any API that speaks the OpenAI chat completions protocol:\n * OpenAI itself, and the compatible endpoints of DeepSeek, Qwen, Moonshot, Ollama,\n * vLLM and others. Set `baseURL` and `model` for the provider you use.\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 OpenAICompatible 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  private readonly name: string;\n\n  constructor(config: OpenAICompatibleConfig) {\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;\n    this.name = config.name ?? DEFAULT_NAME;\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(`${this.name} 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(`[${this.name}] API call failed:`, error);\n    }\n  }\n}\n\nexport default OpenAICompatible;\n","import OpenAICompatible from '../openai-compatible';\nimport type { OpenAICompatibleConfig } from '../openai-compatible';\n\nexport type {\n  AssistantMessage,\n  ChatCompletionOptions,\n  Message,\n  MessageRole,\n  RawTool,\n  ResponseToolCall,\n  StreamChunk,\n  StreamToolCall,\n  TokenUsage,\n  ToolCall,\n} from '../openai-compatible';\n\nconst DEFAULT_BASE_URL = 'https://api.deepseek.com/v1';\nconst DEFAULT_MODEL = 'deepseek-chat';\n\n/**\n * Options for the DeepSeek model provider. They are the options of\n * `OpenAICompatible`, with DeepSeek's endpoint and model as defaults.\n */\nexport interface DeepseekConfig extends Omit<OpenAICompatibleConfig, 'model' | 'name'> {\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}\n\n/**\n * DeepSeek model provider: `OpenAICompatible` set up for the DeepSeek API.\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 OpenAICompatible {\n  constructor(config: DeepseekConfig) {\n    super({\n      ...config,\n      model: config.model ?? DEFAULT_MODEL,\n      baseURL: config.baseURL ?? DEFAULT_BASE_URL,\n      name: 'DeepSeek',\n    });\n  }\n}\n\nexport default Deepseek;\n"],"mappings":"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","names":["DEFAULT_BASE_URL"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astack-tech/integrations",
-  "version": "0.2.0-beta.7",
+  "version": "0.2.0-beta.8",
   "description": "Model provider integrations for AStack, starting with DeepSeek through the OpenAI-compatible API.",
   "keywords": [
     "astack",
@@ -59,13 +59,13 @@
   },
   "dependencies": {
     "openai": "^6.10.0",
-    "@astack-tech/core": "0.2.0-beta.2"
+    "@astack-tech/core": "0.2.0-beta.3"
   },
   "devDependencies": {
     "@types/node": "^22.20.5",
     "@vitest/coverage-v8": "^5.0.5",
     "tsup": "^9.0.0",
-    "typescript": "^5.8.3",
+    "typescript": "^6.0.3",
     "vitest": "^5.0.5"
   },
   "publishConfig": {
@@ -77,6 +77,8 @@
     "check-types": "tsc -p tsconfig.json",
     "test": "vitest run --coverage",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "check:package": "publint --strict && attw --pack . --profile node16"
+    "check:package": "publint --strict && attw --pack . --profile node16",
+    "check:api": "tsc -p tsconfig.json --noEmit false --emitDeclarationOnly --declarationMap false --outDir temp/dts && api-extractor run",
+    "update:api": "tsc -p tsconfig.json --noEmit false --emitDeclarationOnly --declarationMap false --outDir temp/dts && api-extractor run --local"
   }
 }

package/src/index.ts

@@ -1,4 +1,10 @@
 /**
- * AStack integrations: components that connect pipelines to external services.
+ * Model provider integrations for AStack. `ModelProvider.OpenAICompatible` calls any API
+ * that speaks the OpenAI chat completions protocol, and `ModelProvider.Deepseek` is that
+ * provider set up for DeepSeek. Both satisfy the `ModelProvider` interface of
+ * `@astack-tech/components`.
+ *
+ * @packageDocumentation
  */
+
 export * as ModelProvider from './model-provider';

package/src/model-provider/deepseek/index.ts

@@ -1,455 +1,49 @@
-import { Component } from '@astack-tech/core';
-import type { Port } from '@astack-tech/core';
-import OpenAI from 'openai';
+import OpenAICompatible from '../openai-compatible';
+import type { OpenAICompatibleConfig } from '../openai-compatible';
+
+export type {
+  AssistantMessage,
+  ChatCompletionOptions,
+  Message,
+  MessageRole,
+  RawTool,
+  ResponseToolCall,
+  StreamChunk,
+  StreamToolCall,
+  TokenUsage,
+  ToolCall,
+} from '../openai-compatible';
+
+const DEFAULT_BASE_URL = 'https://api.deepseek.com/v1';
+const DEFAULT_MODEL = 'deepseek-chat';
 
 /**
- * Options for the DeepSeek model provider.
+ * Options for the DeepSeek model provider. They are the options of
+ * `OpenAICompatible`, with DeepSeek's endpoint and model as defaults.
  */
-export interface DeepseekConfig {
-  /** DeepSeek API key. */
-  apiKey: string;
+export interface DeepseekConfig extends Omit<OpenAICompatibleConfig, 'model' | 'name'> {
   /** 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`.
- */
-export interface RawTool {
-  name: string;
-  description: string;
-  parameters?: Record<string, unknown> | undefined;
-}
-
-/**
- * Role of a chat message.
- */
-export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
-
-/**
- * Tool call in the internal format.
- */
-export interface ToolCall {
-  /** Identifier assigned by the API. */
-  id?: string | undefined;
-  /** Name of the tool. */
-  tool_name: string;
-  /** Parsed arguments. */
-  arguments: Record<string, unknown>;
-}
-
-/**
- * Tool call returned by `chatCompletion`. It carries both the OpenAI shape
- * (`type`, `function`) and the internal shape (`tool_name`, `arguments`).
- */
-export 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.
- */
-export interface StreamToolCall {
-  id: string;
-  type: 'function';
-  function: { name: string; arguments: string };
-  tool_name: string;
-  arguments: string;
-}
-
-/**
- * Token usage reported by the API.
- */
-export interface TokenUsage {
-  completion_tokens: number;
-  prompt_tokens: number;
-  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.
- */
-export interface Message {
-  /** 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;
-}
-
-/**
- * Assistant message returned by `chatCompletion`.
- */
-export interface AssistantMessage {
-  role: 'assistant';
-  content: string;
-  tool_calls?: ResponseToolCall[] | undefined;
-  usage?: TokenUsage | undefined;
-}
-
-/**
- * Chunk yielded by `streamChatCompletion`.
- */
-export interface StreamChunk {
-  role: 'assistant';
-  content: string;
-  tool_calls?: StreamToolCall[] | undefined;
-  usage?: TokenUsage | undefined;
-}
-
-/**
- * Per-call options.
- */
-export interface ChatCompletionOptions {
-  /** Tools for this call only. They replace the configured tools. */
-  temporaryTools?: unknown[] | undefined;
-}
-
-type ChatMessageParam = OpenAI.Chat.ChatCompletionMessageParam;
-type ChatTool = OpenAI.Chat.ChatCompletionTool;
-
-interface DeepseekUsage {
-  completion_tokens?: number;
-  prompt_tokens?: number;
-  total_tokens?: number;
-  prompt_cache_hit_tokens?: number;
-  prompt_cache_miss_tokens?: number;
-}
-
-const DEFAULT_BASE_URL = 'https://api.deepseek.com/v1';
-const DEFAULT_MODEL = 'deepseek-chat';
-const DEFAULT_TEMPERATURE = 0.7;
-const FALLBACK_TEXT = 'API call failed';
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-/**
- * Converts a `{ name, description, parameters }` object to the OpenAI tool format.
- * Objects already in the OpenAI format are returned unchanged.
- */
-function toApiTool(tool: unknown): ChatTool {
-  if (isRecord(tool) && tool['type'] === 'function') {
-    return tool as unknown as ChatTool;
-  }
-  const raw = isRecord(tool) ? tool : {};
-  const { name, description, parameters } = raw;
-  return {
-    type: 'function',
-    function: {
-      name: typeof name === 'string' ? name : '',
-      description: typeof description === 'string' ? description : '',
-      parameters: isRecord(parameters) ? parameters : {},
-    },
-  };
 }
 
 /**
- * Parses tool-call arguments. Anything that is not a JSON object becomes `{}`.
- */
-function parseArguments(raw: string): Record<string, unknown> {
-  if (raw.trim().length === 0) {
-    return {};
-  }
-  try {
-    const parsed: unknown = JSON.parse(raw);
-    return isRecord(parsed) ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-
-function mapUsage(usage: DeepseekUsage): TokenUsage {
-  return {
-    completion_tokens: usage.completion_tokens ?? 0,
-    prompt_tokens: usage.prompt_tokens ?? 0,
-    total_tokens: usage.total_tokens ?? 0,
-    ...(usage.prompt_cache_hit_tokens === undefined
-      ? {}
-      : { prompt_cache_hit_tokens: usage.prompt_cache_hit_tokens }),
-    ...(usage.prompt_cache_miss_tokens === undefined
-      ? {}
-      : { prompt_cache_miss_tokens: usage.prompt_cache_miss_tokens }),
-  };
-}
-
-/**
- * DeepSeek model provider. It calls the DeepSeek API through the OpenAI-compatible client.
+ * DeepSeek model provider: `OpenAICompatible` set up for the DeepSeek API.
  *
  * 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`.
  */
-class Deepseek extends Component {
-  private readonly client: OpenAI;
-  private readonly model: string;
-  private readonly temperature: number;
-  private readonly maxTokens: number | undefined;
-  private readonly topP: number | undefined;
-  private readonly systemPrompt: string | undefined;
-  private readonly tools: unknown[] | undefined;
-  private readonly verbose: boolean;
-
+class Deepseek extends OpenAICompatible {
   constructor(config: DeepseekConfig) {
-    super({});
-
-    this.client = new OpenAI({
-      apiKey: config.apiKey,
+    super({
+      ...config,
+      model: config.model ?? DEFAULT_MODEL,
       baseURL: config.baseURL ?? DEFAULT_BASE_URL,
-      dangerouslyAllowBrowser: config.dangerouslyAllowBrowser ?? false,
-    });
-
-    this.model = config.model ?? DEFAULT_MODEL;
-    this.temperature = config.temperature ?? DEFAULT_TEMPERATURE;
-    this.maxTokens = config.maxTokens;
-    this.topP = config.topP;
-    this.systemPrompt = config.systemPrompt;
-    this.verbose = config.verbose ?? false;
-    this.tools =
-      config.rawTools !== undefined && config.rawTools.length > 0
-        ? config.rawTools.map(toApiTool)
-        : config.tools;
-
-    Component.Port.I('prompt').attach(this);
-    Component.Port.I('messages').attach(this);
-    Component.Port.O('completion').attach(this);
-    Component.Port.O('message').attach(this);
-  }
-
-  /**
-   * Generates a completion for a single prompt.
-   *
-   * @returns The text answer, or the JSON-encoded assistant message when it contains tool calls.
-   */
-  async generateCompletion(prompt: string): Promise<string> {
-    const response = await this.client.chat.completions.create({
-      ...this.baseRequest(),
-      messages: [...this.systemMessages(), { role: 'user', content: prompt }],
-      ...this.toolsParam(this.tools),
-    });
-
-    const message = this.firstMessage(response);
-    if (message.tool_calls !== undefined && message.tool_calls.length > 0) {
-      return JSON.stringify(message);
-    }
-    return message.content ?? '';
-  }
-
-  /**
-   * Sends a conversation and returns the assistant reply.
-   */
-  async chatCompletion(
-    messages: Message[],
-    options?: ChatCompletionOptions
-  ): Promise<AssistantMessage> {
-    const response = await this.client.chat.completions.create({
-      ...this.baseRequest(),
-      messages: this.formatMessages(messages),
-      ...this.toolsParam(options?.temporaryTools ?? this.tools),
-    });
-
-    const message = this.firstMessage(response);
-    const result: AssistantMessage = { role: 'assistant', content: message.content ?? '' };
-
-    if (response.usage !== undefined) {
-      result.usage = mapUsage(response.usage);
-    }
-
-    if (message.tool_calls !== undefined && message.tool_calls.length > 0) {
-      result.tool_calls = message.tool_calls.map(toolCall => {
-        if (toolCall.type !== 'function') {
-          throw new Error(`Unsupported tool call type: ${toolCall.type}`);
-        }
-        const rawArguments = toolCall.function.arguments;
-        return {
-          id: toolCall.id,
-          type: 'function',
-          function: {
-            name: toolCall.function.name,
-            arguments: rawArguments.length > 0 ? rawArguments : '{}',
-          },
-          tool_name: toolCall.function.name,
-          arguments: parseArguments(rawArguments),
-        };
-      });
-    }
-
-    return result;
-  }
-
-  /**
-   * Streams the assistant reply. Each chunk holds a text delta, tool-call deltas, or usage.
-   */
-  async *streamChatCompletion(
-    messages: Message[],
-    options?: ChatCompletionOptions
-  ): AsyncGenerator<StreamChunk> {
-    const stream = await this.client.chat.completions.create({
-      ...this.baseRequest(),
-      messages: this.formatMessages(messages),
-      ...this.toolsParam(options?.temporaryTools ?? this.tools),
-      stream: true,
-    });
-
-    for await (const chunk of stream) {
-      const delta = chunk.choices[0]?.delta;
-
-      if (delta?.content) {
-        yield { role: 'assistant', content: delta.content };
-      }
-
-      if (delta?.tool_calls) {
-        yield {
-          role: 'assistant',
-          content: '',
-          tool_calls: delta.tool_calls.map(toolCall => {
-            const name = toolCall.function?.name ?? '';
-            const args = toolCall.function?.arguments ?? '';
-            return {
-              id: toolCall.id ?? '',
-              type: 'function',
-              function: { name, arguments: args },
-              tool_name: name,
-              arguments: args,
-            };
-          }),
-        };
-      }
-
-      if (chunk.usage) {
-        yield { role: 'assistant', content: '', usage: mapUsage(chunk.usage) };
-      }
-    }
-  }
-
-  /**
-   * Runs the model outside a pipeline.
-   *
-   * @param input A prompt string or a list of messages.
-   */
-  override run(input: string | Message[]): Promise<string | AssistantMessage> {
-    return typeof input === 'string' ? this.generateCompletion(input) : this.chatCompletion(input);
-  }
-
-  /**
-   * Connects the `prompt` and `messages` input ports to the model.
-   * API errors produce a fallback value so the pipeline keeps flowing.
-   */
-  override _transform($i: Port, $o: Port): void {
-    $i('prompt').receive((prompt: string) => {
-      this.generateCompletion(prompt).then(
-        completion => {
-          $o('completion').send(completion);
-        },
-        (error: unknown) => {
-          this.logError(error);
-          $o('completion').send(FALLBACK_TEXT);
-        }
-      );
-    });
-
-    $i('messages').receive((messages: Message[]) => {
-      this.chatCompletion(messages).then(
-        message => {
-          $o('message').send(message);
-        },
-        (error: unknown) => {
-          this.logError(error);
-          $o('message').send({ role: 'assistant', content: FALLBACK_TEXT });
-        }
-      );
+      name: 'DeepSeek',
     });
   }
-
-  private baseRequest(): {
-    model: string;
-    temperature: number;
-    max_tokens?: number;
-    top_p?: number;
-  } {
-    return {
-      model: this.model,
-      temperature: this.temperature,
-      ...(this.maxTokens === undefined ? {} : { max_tokens: this.maxTokens }),
-      ...(this.topP === undefined ? {} : { top_p: this.topP }),
-    };
-  }
-
-  private toolsParam(tools: unknown[] | undefined): { tools?: ChatTool[] } {
-    return tools !== undefined && tools.length > 0 ? { tools: tools.map(toApiTool) } : {};
-  }
-
-  private systemMessages(): ChatMessageParam[] {
-    return this.systemPrompt ? [{ role: 'system', content: this.systemPrompt }] : [];
-  }
-
-  /**
-   * 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.
-   */
-  private formatMessages(messages: Message[]): ChatMessageParam[] {
-    return [
-      ...this.systemMessages(),
-      ...messages.map(
-        (message): ChatMessageParam =>
-          ({
-            role: message.role,
-            content: message.content,
-            ...(message.role === 'tool' && message.tool_call_id
-              ? { tool_call_id: message.tool_call_id }
-              : {}),
-          }) as ChatMessageParam
-      ),
-    ];
-  }
-
-  private firstMessage(response: OpenAI.Chat.ChatCompletion): OpenAI.Chat.ChatCompletionMessage {
-    const choice = response.choices[0];
-    if (choice === undefined) {
-      throw new Error('DeepSeek returned no choices.');
-    }
-    return choice.message;
-  }
-
-  private logError(error: unknown): void {
-    if (this.verbose) {
-      // eslint-disable-next-line no-console -- opt-in diagnostics controlled by `verbose`.
-      console.error('[Deepseek] API call failed:', error);
-    }
-  }
 }
 
 export default Deepseek;

package/src/model-provider/index.ts

@@ -12,3 +12,17 @@ export {
   type TokenUsage as DeepseekTokenUsage,
   type ToolCall as DeepseekToolCall,
 } from './deepseek';
+export {
+  default as OpenAICompatible,
+  type AssistantMessage,
+  type ChatCompletionOptions,
+  type Message,
+  type MessageRole,
+  type OpenAICompatibleConfig,
+  type RawTool,
+  type ResponseToolCall,
+  type StreamChunk,
+  type StreamToolCall,
+  type TokenUsage,
+  type ToolCall,
+} from './openai-compatible';