@arikusi/deepseek-mcp-server 1.0.3 → 1.1.1

package/CHANGELOG.md

@@ -16,6 +16,69 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - Nothing yet
 
+## [1.1.1] - 2026-02-11
+
+### Added
+- **Custom Error Classes** (`src/errors.ts`): `BaseError`, `ConfigError`, `ApiError`, `RateLimitError`, `AuthenticationError`, `ValidationError`, `ConnectionError` with error cause chaining
+- **DeepSeek Type Extensions** (`src/types.ts`): `DeepSeekRawResponse`, `DeepSeekStreamChunk`, `DeepSeekStreamDelta` types and `hasReasoningContent()`, `getErrorMessage()` type guards
+- **Message Content Length Limit**: `MAX_MESSAGE_LENGTH` config (default: 100K chars) prevents excessive API costs
+- **Optional Connection Test**: `SKIP_CONNECTION_TEST=true` env skips startup API call for faster boot
+- **AI Discoverability**: `llms.txt` and `llms-full.txt` for LLM/AI agent consumption
+- **New Tests**: 126 tests (up from 85) covering errors, server factory, tool handlers, prompt registration
+
+### Changed
+- **Modular Architecture**: Monolithic `index.ts` (783 lines) split into focused modules:
+  - `src/server.ts`: McpServer factory with auto-version from package.json
+  - `src/tools/deepseek-chat.ts`: Tool handler (extracted from index.ts)
+  - `src/tools/index.ts`: Tool registration aggregator
+  - `src/prompts/core.ts`: 5 core reasoning prompts
+  - `src/prompts/advanced.ts`: 5 advanced prompts
+  - `src/prompts/function-calling.ts`: 2 function calling prompts
+  - `src/prompts/index.ts`: Prompt registration aggregator
+  - `src/index.ts`: Slim bootstrap (~80 lines)
+- **DRY Refactoring** (`deepseek-client.ts`): Extracted `buildRequestParams()` and `wrapError()` methods (eliminated code duplication)
+- **Type Safety**: Replaced 16 `any` casts with proper DeepSeek type extensions and type guards (`error: unknown` pattern)
+- **Config**: `process.exit(1)` replaced with `throw ConfigError` for testability
+- **Version**: Single source of truth from `package.json` via `createRequire` (no more manual sync)
+
+### Fixed
+- **Security**: Updated `@modelcontextprotocol/sdk` to fix cross-client data leak (GHSA-345p-7cg4-v4c7)
+- **Security**: Fixed `hono` transitive dependency vulnerabilities (XSS, cache deception, IP spoofing)
+- CI dist check updated for new file structure
+
+## [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 +154,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version History
 
+- **1.1.1** (2026-02-11): Modular architecture, type safety, security fixes, 126 tests
+- **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 +166,9 @@ 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.1...HEAD
+[1.1.1]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.1.0...v1.1.1
+[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**: 126 tests with 90%+ 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,28 @@ 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 |
+| `SKIP_CONNECTION_TEST` | `false` | Skip startup API connection test |
+| `MAX_MESSAGE_LENGTH` | `100000` | Maximum message content length (characters) |
+
+**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 +291,26 @@ 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              # Entry point, bootstrap (~80 lines)
+│   ├── server.ts             # McpServer factory (auto-version)
+│   ├── 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 types + type guards
+│   ├── errors.ts             # Custom error classes
+│   ├── tools/
+│   │   ├── deepseek-chat.ts  # deepseek_chat tool handler
+│   │   └── index.ts          # Tool registration aggregator
+│   └── prompts/
+│       ├── core.ts           # 5 core reasoning prompts
+│       ├── advanced.ts       # 5 advanced prompts
+│       ├── function-calling.ts # 2 function calling prompts
+│       └── index.ts          # Prompt registration aggregator
+├── dist/                     # Compiled JavaScript
+├── llms.txt                  # AI discoverability index
+├── llms-full.txt             # Full docs for LLM context
+├── vitest.config.ts          # Test configuration
 ├── package.json
 ├── tsconfig.json
 └── README.md
@@ -244,6 +328,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 +454,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 +473,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,48 @@
+/**
+ * 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>;
+    skipConnectionTest: z.ZodDefault<z.ZodBoolean>;
+    maxMessageLength: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    apiKey: string;
+    baseUrl: string;
+    showCostInfo: boolean;
+    requestTimeout: number;
+    maxRetries: number;
+    skipConnectionTest: boolean;
+    maxMessageLength: number;
+}, {
+    apiKey: string;
+    baseUrl?: string | undefined;
+    showCostInfo?: boolean | undefined;
+    requestTimeout?: number | undefined;
+    maxRetries?: number | undefined;
+    skipConnectionTest?: boolean | undefined;
+    maxMessageLength?: number | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Load configuration from environment variables.
+ * Validates with Zod and caches the result.
+ * Throws ConfigError if validation fails.
+ */
+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;AAGxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;EAQhB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAqCnC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/config.js

@@ -0,0 +1,68 @@
+/**
+ * Centralized Configuration
+ * Loads and validates configuration from environment variables
+ */
+import { z } from 'zod';
+import { ConfigError } from './errors.js';
+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),
+    skipConnectionTest: z.boolean().default(false),
+    maxMessageLength: z.number().positive().default(100_000),
+});
+let cachedConfig = null;
+/**
+ * Load configuration from environment variables.
+ * Validates with Zod and caches the result.
+ * Throws ConfigError if validation fails.
+ */
+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,
+        skipConnectionTest: process.env.SKIP_CONNECTION_TEST === 'true',
+        maxMessageLength: process.env.MAX_MESSAGE_LENGTH
+            ? parseInt(process.env.MAX_MESSAGE_LENGTH, 10)
+            : 100_000,
+    };
+    const result = ConfigSchema.safeParse(raw);
+    if (!result.success) {
+        const issues = result.error.issues.map((issue) => ({
+            path: issue.path.join('.'),
+            message: issue.message,
+        }));
+        const hint = !raw.apiKey
+            ? '\nPlease set your DeepSeek API key:\n  export DEEPSEEK_API_KEY="your-api-key-here"'
+            : '';
+        throw new ConfigError(`Configuration validation failed${hint}`, issues);
+    }
+    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":"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"}

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,22 @@
 import type { ChatCompletionParams, ChatCompletionResponse } from './types.js';
 export declare class DeepSeekClient {
     private client;
-    private baseURL;
-    constructor(apiKey: string);
+    constructor();
+    /**
+     * Build request params shared between streaming and non-streaming
+     */
+    private buildRequestParams;
+    /**
+     * Wrap caught errors with appropriate custom error class
+     */
+    private wrapError;
     /**
      * 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;AAKH,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EAKvB,MAAM,YAAY,CAAC;AAGpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;;IAavB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IA6ClC;;;OAGG;IACG,6BAA6B,CACjC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IAoGlC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAazC"}