@arikusi/deepseek-mcp-server 1.0.3 → 1.1.0

package/CHANGELOG.md

@@ -16,6 +16,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - Nothing yet
 
+## [1.1.0] - 2026-02-10
+
+### Added
+- **Function Calling Support**: Full OpenAI-compatible function calling via `tools` and `tool_choice` parameters
+  - Define up to 128 tool definitions with JSON Schema parameters
+  - Control tool behavior with `tool_choice`: auto, none, required, or specific function
+  - Tool call results formatted in response with call IDs and arguments
+  - Streaming + function calling works together (delta accumulation)
+  - `tool` message role for sending tool results back
+- **Centralized Config System** (`src/config.ts`)
+  - Zod-validated configuration from environment variables
+  - `DEEPSEEK_BASE_URL`: Custom API endpoint (default: `https://api.deepseek.com`)
+  - `SHOW_COST_INFO`: Toggle cost display in responses (default: true)
+  - `REQUEST_TIMEOUT`: API request timeout in ms (default: 60000)
+  - `MAX_RETRIES`: Maximum API retry count (default: 2)
+- **Test Suite**: 85 tests with Vitest
+  - Config, Cost, Schemas, Client, and Function Calling tests
+  - 80%+ code coverage with v8 provider
+  - `npm test`, `npm run test:watch`, `npm run test:coverage` scripts
+- **2 New Prompt Templates** (total: 12)
+  - `function_call_debug`: Debug function calling issues
+  - `create_function_schema`: Generate JSON Schema from natural language
+- CI coverage job in GitHub Actions
+
+### Changed
+- **Project Structure**: Modularized codebase
+  - `src/config.ts`: Centralized configuration
+  - `src/cost.ts`: Cost calculation (extracted from index.ts)
+  - `src/schemas.ts`: Zod validation schemas (extracted from index.ts)
+- `DeepSeekClient` constructor now uses centralized config (no manual apiKey passing)
+- Server version bumped to 1.1.0
+- Updated `deepseek_chat` tool description to mention function calling
+
 ## [1.0.3] - 2025-02-07
 
 ### Added
@@ -91,6 +124,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version History
 
+- **1.1.0** (2026-02-10): Function calling, config system, test suite
 - **1.0.3** (2025-02-07): Cost tracking and prompt templates
 - **1.0.0** (2025-01-13): Initial public release
 - **0.1.0** (Development): Internal development version
@@ -101,7 +135,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - [GitHub repository](https://github.com/arikusi/deepseek-mcp-server)
 - [Issue tracker](https://github.com/arikusi/deepseek-mcp-server/issues)
 
-[Unreleased]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.0.3...HEAD
+[Unreleased]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.0.3...v1.1.0
 [1.0.3]: https://github.com/arikusi/deepseek-mcp-server/releases/tag/v1.0.3
 [1.0.0]: https://github.com/arikusi/deepseek-mcp-server/releases/tag/v1.0.0
 [0.1.0]: https://github.com/arikusi/deepseek-mcp-server/releases/tag/v0.1.0

package/README.md

@@ -14,9 +14,9 @@ A Model Context Protocol (MCP) server that integrates DeepSeek AI models with MC
 - Gemini CLI (if MCP support is available)
 - Any MCP-compatible client
 
-> **⚠️ Note**: This is an unofficial community project and is not affiliated with DeepSeek.
+> **Note**: This is an unofficial community project and is not affiliated with DeepSeek.
 
-## ⚡ Quick Start
+## Quick Start
 
 ### For Claude Code
 
@@ -42,19 +42,22 @@ gemini mcp add deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=you
 
 **Get your API key:** [https://platform.deepseek.com](https://platform.deepseek.com)
 
-That's it! Your MCP client can now use DeepSeek models! 🎉
+That's it! Your MCP client can now use DeepSeek models!
 
 ---
 
 ## Features
 
-- 🤖 **DeepSeek Chat**: Fast and capable general-purpose model
-- 🧠 **DeepSeek Reasoner (R1)**: Advanced reasoning with chain-of-thought explanations
-- 💰 **Cost Tracking**: Automatic cost calculation for every request (USD)
-- 📋 **10 Prompt Templates**: Pre-built templates for debugging, code review, research, and more
-- 🔄 **Streaming Support**: Real-time response generation
-- 🛡️ **Type-Safe**: Full TypeScript implementation
-- 🎯 **MCP Compatible**: Works with any MCP-compatible CLI (Claude Code, Gemini CLI, etc.)
+- **DeepSeek Chat**: Fast and capable general-purpose model
+- **DeepSeek Reasoner (R1)**: Advanced reasoning with chain-of-thought explanations
+- **Function Calling**: OpenAI-compatible tool use with up to 128 tool definitions
+- **Cost Tracking**: Automatic cost calculation for every request (USD)
+- **Configurable**: Environment-based configuration with validation
+- **12 Prompt Templates**: Pre-built templates for debugging, code review, function calling, and more
+- **Streaming Support**: Real-time response generation
+- **Tested**: 85 tests with 80%+ code coverage
+- **Type-Safe**: Full TypeScript implementation
+- **MCP Compatible**: Works with any MCP-compatible CLI (Claude Code, Gemini CLI, etc.)
 
 ## Installation
 
@@ -130,22 +133,26 @@ If your MCP client doesn't support the `add` command, manually add to your confi
 
 ### `deepseek_chat`
 
-Chat with DeepSeek AI models with automatic cost tracking.
+Chat with DeepSeek AI models with automatic cost tracking and function calling support.
 
 **Parameters:**
 
 - `messages` (required): Array of conversation messages
-  - `role`: "system" | "user" | "assistant"
+  - `role`: "system" | "user" | "assistant" | "tool"
   - `content`: Message text
+  - `tool_call_id` (optional): Required for tool role messages
 - `model` (optional): "deepseek-chat" (default) or "deepseek-reasoner"
 - `temperature` (optional): 0-2, controls randomness (default: 1.0)
 - `max_tokens` (optional): Maximum tokens to generate
 - `stream` (optional): Enable streaming mode (default: false)
+- `tools` (optional): Array of tool definitions for function calling (max 128)
+- `tool_choice` (optional): "auto" | "none" | "required" | `{type: "function", function: {name: "..."}}`
 
 **Response includes:**
 - Content with formatting
+- Function call results (if tools were used)
 - Request information (tokens, model, cost in USD)
-- Structured data with `cost_usd` field
+- Structured data with `cost_usd` and `tool_calls` fields
 
 **Example:**
 
@@ -179,9 +186,44 @@ Chat with DeepSeek AI models with automatic cost tracking.
 
 The reasoner model will show its thinking process in `<thinking>` tags followed by the final answer.
 
+**Function Calling Example:**
+
+```json
+{
+  "messages": [
+    {
+      "role": "user",
+      "content": "What's the weather in Istanbul?"
+    }
+  ],
+  "tools": [
+    {
+      "type": "function",
+      "function": {
+        "name": "get_weather",
+        "description": "Get current weather for a location",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "location": {
+              "type": "string",
+              "description": "City name"
+            }
+          },
+          "required": ["location"]
+        }
+      }
+    }
+  ],
+  "tool_choice": "auto"
+}
+```
+
+When the model decides to call a function, the response includes `tool_calls` with the function name and arguments. You can then send the result back using a `tool` role message with the matching `tool_call_id`.
+
 ## Available Prompts
 
-Pre-built prompt templates for common tasks:
+Pre-built prompt templates for common tasks (12 total):
 
 ### Core Reasoning
 - **debug_with_reasoning**: Debug code with step-by-step analysis
@@ -197,6 +239,10 @@ Pre-built prompt templates for common tasks:
 - **cost_comparison**: Compare LLM costs for tasks
 - **pair_programming**: Interactive coding with explanations
 
+### Function Calling
+- **function_call_debug**: Debug function calling issues with tool definitions and messages
+- **create_function_schema**: Generate JSON Schema for function calling from natural language
+
 Each prompt is optimized for the DeepSeek Reasoner model to provide detailed reasoning.
 
 ## Models
@@ -216,6 +262,26 @@ Each prompt is optimized for the DeepSeek Reasoner model to provide detailed rea
 - **Special**: Provides chain-of-thought reasoning
 - **Output**: Both reasoning process and final answer
 
+## Configuration
+
+The server is configured via environment variables. All settings except `DEEPSEEK_API_KEY` are optional.
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DEEPSEEK_API_KEY` | (required) | Your DeepSeek API key |
+| `DEEPSEEK_BASE_URL` | `https://api.deepseek.com` | Custom API endpoint |
+| `SHOW_COST_INFO` | `true` | Show cost info in responses |
+| `REQUEST_TIMEOUT` | `60000` | Request timeout in milliseconds |
+| `MAX_RETRIES` | `2` | Maximum retry count for failed requests |
+
+**Example with custom config:**
+```bash
+claude mcp add -s user deepseek npx @arikusi/deepseek-mcp-server \
+  -e DEEPSEEK_API_KEY=your-key \
+  -e SHOW_COST_INFO=false \
+  -e REQUEST_TIMEOUT=30000
+```
+
 ## Development
 
 ### Project Structure
@@ -223,10 +289,19 @@ Each prompt is optimized for the DeepSeek Reasoner model to provide detailed rea
 ```
 deepseek-mcp-server/
 ├── src/
-│   ├── index.ts           # Main MCP server
-│   ├── deepseek-client.ts # DeepSeek API wrapper
-│   └── types.ts           # TypeScript definitions
-├── dist/                  # Compiled JavaScript
+│   ├── index.ts              # Main MCP server, tool & prompt registration
+│   ├── deepseek-client.ts    # DeepSeek API wrapper (OpenAI SDK)
+│   ├── config.ts             # Centralized config with Zod validation
+│   ├── cost.ts               # Cost calculation and formatting
+│   ├── schemas.ts            # Zod input validation schemas
+│   ├── types.ts              # TypeScript type definitions
+│   ├── config.test.ts        # Config tests
+│   ├── cost.test.ts          # Cost tests
+│   ├── schemas.test.ts       # Schema validation tests
+│   ├── deepseek-client.test.ts    # Client tests
+│   └── function-calling.test.ts   # Function calling tests
+├── dist/                     # Compiled JavaScript
+├── vitest.config.ts          # Test configuration
 ├── package.json
 ├── tsconfig.json
 └── README.md
@@ -244,6 +319,19 @@ npm run build
 npm run watch
 ```
 
+### Testing
+
+```bash
+# Run all tests
+npm test
+
+# Watch mode
+npm run test:watch
+
+# With coverage report
+npm run test:coverage
+```
+
 ### Testing Locally
 
 ```bash
@@ -357,10 +445,10 @@ MIT License - see [LICENSE](LICENSE) file for details
 
 ## Support
 
-- 📖 [Documentation](https://github.com/arikusi/deepseek-mcp-server#readme)
-- 🐛 [Bug Reports](https://github.com/arikusi/deepseek-mcp-server/issues)
-- 💬 [Discussions](https://github.com/arikusi/deepseek-mcp-server/discussions)
-- 📧 Contact: [GitHub Issues](https://github.com/arikusi/deepseek-mcp-server/issues)
+- [Documentation](https://github.com/arikusi/deepseek-mcp-server#readme)
+- [Bug Reports](https://github.com/arikusi/deepseek-mcp-server/issues)
+- [Discussions](https://github.com/arikusi/deepseek-mcp-server/discussions)
+- Contact: [GitHub Issues](https://github.com/arikusi/deepseek-mcp-server/issues)
 
 ## Resources
 
@@ -376,6 +464,6 @@ MIT License - see [LICENSE](LICENSE) file for details
 
 ---
 
-**Made with ❤️ by [@arikusi](https://github.com/arikusi)**
+**Made by [@arikusi](https://github.com/arikusi)**
 
 This is an unofficial community project and is not affiliated with DeepSeek.

package/dist/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Centralized Configuration
+ * Loads and validates configuration from environment variables
+ */
+import { z } from 'zod';
+declare const ConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    baseUrl: z.ZodDefault<z.ZodString>;
+    showCostInfo: z.ZodDefault<z.ZodBoolean>;
+    requestTimeout: z.ZodDefault<z.ZodNumber>;
+    maxRetries: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    apiKey: string;
+    baseUrl: string;
+    showCostInfo: boolean;
+    requestTimeout: number;
+    maxRetries: number;
+}, {
+    apiKey: string;
+    baseUrl?: string | undefined;
+    showCostInfo?: boolean | undefined;
+    requestTimeout?: number | undefined;
+    maxRetries?: number | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Load configuration from environment variables.
+ * Validates with Zod and caches the result.
+ * Exits process if validation fails (e.g., missing API key).
+ */
+export declare function loadConfig(): Config;
+/**
+ * Get the cached configuration.
+ * Throws if loadConfig() hasn't been called yet.
+ */
+export declare function getConfig(): Config;
+/**
+ * Reset cached configuration (for testing).
+ */
+export declare function resetConfig(): void;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAMhB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CA8BnC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/config.js

@@ -0,0 +1,63 @@
+/**
+ * Centralized Configuration
+ * Loads and validates configuration from environment variables
+ */
+import { z } from 'zod';
+const ConfigSchema = z.object({
+    apiKey: z.string().min(1, 'DEEPSEEK_API_KEY is required'),
+    baseUrl: z.string().url().default('https://api.deepseek.com'),
+    showCostInfo: z.boolean().default(true),
+    requestTimeout: z.number().positive().default(60000),
+    maxRetries: z.number().min(0).max(10).default(2),
+});
+let cachedConfig = null;
+/**
+ * Load configuration from environment variables.
+ * Validates with Zod and caches the result.
+ * Exits process if validation fails (e.g., missing API key).
+ */
+export function loadConfig() {
+    const raw = {
+        apiKey: process.env.DEEPSEEK_API_KEY || '',
+        baseUrl: process.env.DEEPSEEK_BASE_URL || 'https://api.deepseek.com',
+        showCostInfo: process.env.SHOW_COST_INFO !== 'false',
+        requestTimeout: process.env.REQUEST_TIMEOUT
+            ? parseInt(process.env.REQUEST_TIMEOUT, 10)
+            : 60000,
+        maxRetries: process.env.MAX_RETRIES
+            ? parseInt(process.env.MAX_RETRIES, 10)
+            : 2,
+    };
+    const result = ConfigSchema.safeParse(raw);
+    if (!result.success) {
+        console.error('Error: Configuration validation failed');
+        const issues = result.error.issues;
+        for (const issue of issues) {
+            console.error(`  - ${issue.path.join('.')}: ${issue.message}`);
+        }
+        if (!raw.apiKey) {
+            console.error('Please set your DeepSeek API key:');
+            console.error('  export DEEPSEEK_API_KEY="your-api-key-here"');
+        }
+        process.exit(1);
+    }
+    cachedConfig = result.data;
+    return cachedConfig;
+}
+/**
+ * Get the cached configuration.
+ * Throws if loadConfig() hasn't been called yet.
+ */
+export function getConfig() {
+    if (!cachedConfig) {
+        throw new Error('Config not loaded. Call loadConfig() first.');
+    }
+    return cachedConfig;
+}
+/**
+ * Reset cached configuration (for testing).
+ */
+export function resetConfig() {
+    cachedConfig = null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC;IAC7D,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD,CAAC,CAAC;AAIH,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE;QAC1C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,0BAA0B;QACpE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,OAAO;QACpD,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;YACzC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC;YAC3C,CAAC,CAAC,KAAK;QACT,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;YACjC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;YACvC,CAAC,CAAC,CAAC;KACN,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAE3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC;IAC3B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/cost.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cost Calculation Module
+ * Handles pricing and cost formatting for DeepSeek API requests
+ */
+/** DeepSeek pricing per 1M tokens (USD) */
+export declare const PRICING: {
+    readonly 'deepseek-chat': {
+        readonly prompt: 0.14;
+        readonly completion: 0.28;
+    };
+    readonly 'deepseek-reasoner': {
+        readonly prompt: 0.55;
+        readonly completion: 2.19;
+    };
+};
+/**
+ * Calculate cost for a request based on token usage
+ */
+export declare function calculateCost(promptTokens: number, completionTokens: number, model: string): number;
+/**
+ * Format cost as readable USD string
+ */
+export declare function formatCost(cost: number): string;
+//# sourceMappingURL=cost.d.ts.map

package/dist/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,OAAO;;;;;;;;;CASV,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C"}

package/dist/cost.js

@@ -0,0 +1,34 @@
+/**
+ * Cost Calculation Module
+ * Handles pricing and cost formatting for DeepSeek API requests
+ */
+/** DeepSeek pricing per 1M tokens (USD) */
+export const PRICING = {
+    'deepseek-chat': {
+        prompt: 0.14,
+        completion: 0.28,
+    },
+    'deepseek-reasoner': {
+        prompt: 0.55,
+        completion: 2.19,
+    },
+};
+/**
+ * Calculate cost for a request based on token usage
+ */
+export function calculateCost(promptTokens, completionTokens, model) {
+    const modelPricing = PRICING[model] || PRICING['deepseek-chat'];
+    const promptCost = (promptTokens / 1_000_000) * modelPricing.prompt;
+    const completionCost = (completionTokens / 1_000_000) * modelPricing.completion;
+    return promptCost + completionCost;
+}
+/**
+ * Format cost as readable USD string
+ */
+export function formatCost(cost) {
+    if (cost < 0.01) {
+        return `$${cost.toFixed(4)}`;
+    }
+    return `$${cost.toFixed(2)}`;
+}
+//# sourceMappingURL=cost.js.map

package/dist/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,eAAe,EAAE;QACf,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,IAAI;KACjB;IACD,mBAAmB,EAAE;QACnB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,IAAI;KACjB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAoB,EACpB,gBAAwB,EACxB,KAAa;IAEb,MAAM,YAAY,GAChB,OAAO,CAAC,KAA6B,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAErE,MAAM,UAAU,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;IACpE,MAAM,cAAc,GAClB,CAAC,gBAAgB,GAAG,SAAS,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC;IAE3D,OAAO,UAAU,GAAG,cAAc,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAChB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC"}

package/dist/deepseek-client.d.ts

@@ -5,15 +5,14 @@
 import type { ChatCompletionParams, ChatCompletionResponse } from './types.js';
 export declare class DeepSeekClient {
     private client;
-    private baseURL;
-    constructor(apiKey: string);
+    constructor();
     /**
      * Create a chat completion (non-streaming)
      */
     createChatCompletion(params: ChatCompletionParams): Promise<ChatCompletionResponse>;
     /**
      * Create a streaming chat completion
-     * Returns the full text after streaming completes
+     * Returns the full text after streaming completes (buffered)
      */
     createStreamingChatCompletion(params: ChatCompletionParams): Promise<ChatCompletionResponse>;
     /**

package/dist/deepseek-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepseek-client.d.ts","sourceRoot":"","sources":["../src/deepseek-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA8B;gBAEjC,MAAM,EAAE,MAAM;IAW1B;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IA4ClC;;;OAGG;IACG,6BAA6B,CACjC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IAsElC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAazC"}
+{"version":3,"file":"deepseek-client.d.ts","sourceRoot":"","sources":["../src/deepseek-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;;IAavB;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IAkElC;;;OAGG;IACG,6BAA6B,CACjC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IAyHlC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAazC"}

package/dist/deepseek-client.js

@@ -3,16 +3,16 @@
  * Wrapper around OpenAI SDK for DeepSeek API
  */
 import OpenAI from 'openai';
+import { getConfig } from './config.js';
 export class DeepSeekClient {
     client;
-    baseURL = 'https://api.deepseek.com';
-    constructor(apiKey) {
-        if (!apiKey) {
-            throw new Error('DeepSeek API key is required');
-        }
+    constructor() {
+        const config = getConfig();
         this.client = new OpenAI({
-            apiKey,
-            baseURL: this.baseURL,
+            apiKey: config.apiKey,
+            baseURL: config.baseUrl,
+            timeout: config.requestTimeout,
+            maxRetries: config.maxRetries,
         });
     }
     /**
@@ -20,7 +20,9 @@ export class DeepSeekClient {
      */
     async createChatCompletion(params) {
         try {
-            const response = await this.client.chat.completions.create({
+            // Build request params - using 'any' for OpenAI SDK compatibility
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const requestParams = {
                 model: params.model,
                 messages: params.messages,
                 temperature: params.temperature ?? 1.0,
@@ -30,7 +32,14 @@ export class DeepSeekClient {
                 presence_penalty: params.presence_penalty,
                 stop: params.stop,
                 stream: false,
-            });
+            };
+            if (params.tools?.length) {
+                requestParams.tools = params.tools;
+            }
+            if (params.tool_choice !== undefined) {
+                requestParams.tool_choice = params.tool_choice;
+            }
+            const response = await this.client.chat.completions.create(requestParams);
             const choice = response.choices[0];
             if (!choice) {
                 throw new Error('No response from DeepSeek API');
@@ -39,6 +48,15 @@ export class DeepSeekClient {
             const reasoning_content = 'reasoning_content' in choice.message
                 ? choice.message.reasoning_content
                 : undefined;
+            // Extract tool_calls if present
+            const tool_calls = choice.message.tool_calls?.map((tc) => ({
+                id: tc.id,
+                type: 'function',
+                function: {
+                    name: tc.function.name,
+                    arguments: tc.function.arguments,
+                },
+            }));
             return {
                 content: choice.message.content || '',
                 reasoning_content,
@@ -49,6 +67,7 @@ export class DeepSeekClient {
                     total_tokens: response.usage?.total_tokens || 0,
                 },
                 finish_reason: choice.finish_reason || 'stop',
+                tool_calls: tool_calls?.length ? tool_calls : undefined,
             };
         }
         catch (error) {
@@ -58,11 +77,13 @@ export class DeepSeekClient {
     }
     /**
      * Create a streaming chat completion
-     * Returns the full text after streaming completes
+     * Returns the full text after streaming completes (buffered)
      */
     async createStreamingChatCompletion(params) {
         try {
-            const stream = await this.client.chat.completions.create({
+            // Build request params - using 'any' for OpenAI SDK compatibility
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const requestParams = {
                 model: params.model,
                 messages: params.messages,
                 temperature: params.temperature ?? 1.0,
@@ -72,7 +93,14 @@ export class DeepSeekClient {
                 presence_penalty: params.presence_penalty,
                 stop: params.stop,
                 stream: true,
-            });
+            };
+            if (params.tools?.length) {
+                requestParams.tools = params.tools;
+            }
+            if (params.tool_choice !== undefined) {
+                requestParams.tool_choice = params.tool_choice;
+            }
+            const stream = await this.client.chat.completions.create(requestParams);
             let fullContent = '';
             let reasoningContent = '';
             let modelName = params.model;
@@ -82,6 +110,8 @@ export class DeepSeekClient {
                 completion_tokens: 0,
                 total_tokens: 0,
             };
+            // Tool calls accumulation (index-based)
+            const toolCallsMap = new Map();
             // Collect all chunks
             for await (const chunk of stream) {
                 const choice = chunk.choices[0];
@@ -92,9 +122,31 @@ export class DeepSeekClient {
                     fullContent += choice.delta.content;
                 }
                 // Collect reasoning content (for deepseek-reasoner)
-                if ('reasoning_content' in choice.delta) {
+                if ('reasoning_content' in (choice.delta || {})) {
                     reasoningContent += choice.delta.reasoning_content || '';
                 }
+                // Accumulate tool_calls deltas
+                if (choice.delta?.tool_calls) {
+                    for (const tc of choice.delta.tool_calls) {
+                        const existing = toolCallsMap.get(tc.index);
+                        if (existing) {
+                            if (tc.function?.name)
+                                existing.function.name += tc.function.name;
+                            if (tc.function?.arguments)
+                                existing.function.arguments += tc.function.arguments;
+                        }
+                        else {
+                            toolCallsMap.set(tc.index, {
+                                id: tc.id || '',
+                                type: 'function',
+                                function: {
+                                    name: tc.function?.name || '',
+                                    arguments: tc.function?.arguments || '',
+                                },
+                            });
+                        }
+                    }
+                }
                 // Get finish reason
                 if (choice.finish_reason) {
                     finishReason = choice.finish_reason;
@@ -108,12 +160,19 @@ export class DeepSeekClient {
                     usage = chunk.usage;
                 }
             }
+            // Convert tool calls map to sorted array
+            const toolCalls = toolCallsMap.size > 0
+                ? Array.from(toolCallsMap.entries())
+                    .sort(([a], [b]) => a - b)
+                    .map(([, tc]) => tc)
+                : undefined;
             return {
                 content: fullContent,
                 reasoning_content: reasoningContent || undefined,
                 model: modelName,
                 usage,
                 finish_reason: finishReason,
+                tool_calls: toolCalls,
             };
         }
         catch (error) {