@arikusi/deepseek-mcp-server 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -16,6 +16,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - Nothing yet
 
+## [1.2.0] - 2026-02-26
+
+### Added
+- **Thinking Mode**: Enable enhanced reasoning on deepseek-chat with `thinking: {type: "enabled"}` parameter. Automatically filters incompatible params (temperature, top_p, etc.) with logged warnings.
+- **JSON Output Mode**: Structured JSON responses with `json_mode: true`. Supported by both models. Warns if "json" word missing from prompt.
+- **Cache-Aware Cost Tracking**: V3.2 API returns `prompt_cache_hit_tokens` and `prompt_cache_miss_tokens`. Cost display now shows cache hit ratio and savings.
+- **CostBreakdown Interface**: `calculateCost()` returns structured `{inputCost, outputCost, totalCost, cacheHitRatio?, cacheSavings?}` instead of flat number.
+
+### Changed
+- **DeepSeek V3.2 Pricing**: Unified pricing for both models — cache hit $0.028/1M, cache miss $0.28/1M, output $0.42/1M (replaces old per-model pricing).
+- **max_tokens Limit**: Updated from 32768 to 65536 (reasoner max). Model-specific warnings: deepseek-chat warns above 8192, deepseek-reasoner warns above 65536.
+- **Tool Description**: Updated to mention V3.2, thinking mode, JSON mode, and cache-aware cost tracking.
+- **150 Tests**: Up from 126, covering thinking mode, JSON mode, cache tokens, and cost breakdown.
+
+### Fixed
+- **Incorrect Cost Reports**: Old flat pricing ($0.14/$0.28 chat, $0.55/$2.19 reasoner) replaced with accurate V3.2 unified pricing.
+
+## [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
@@ -124,6 +171,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version History
 
+- **1.2.0** (2026-02-26): DeepSeek V3.2 support — thinking mode, JSON mode, cache-aware pricing, 150 tests
+- **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
@@ -135,7 +184,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.1.0...HEAD
+[Unreleased]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.1.1...v1.2.0
+[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

package/README.md

@@ -48,14 +48,15 @@ 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
+- **DeepSeek V3.2**: Both models now run DeepSeek-V3.2 (since Sept 2025)
+- **Thinking Mode**: Enable enhanced reasoning on deepseek-chat with `thinking: {type: "enabled"}`
+- **JSON Output Mode**: Structured JSON responses with `json_mode: true`
 - **Function Calling**: OpenAI-compatible tool use with up to 128 tool definitions
-- **Cost Tracking**: Automatic cost calculation for every request (USD)
+- **Cache-Aware Cost Tracking**: Automatic cost calculation with cache hit/miss breakdown
 - **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
+- **Tested**: 150 tests with 90%+ code coverage
 - **Type-Safe**: Full TypeScript implementation
 - **MCP Compatible**: Works with any MCP-compatible CLI (Claude Code, Gemini CLI, etc.)
 
@@ -142,11 +143,13 @@ Chat with DeepSeek AI models with automatic cost tracking and function calling s
   - `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
+- `temperature` (optional): 0-2, controls randomness (default: 1.0). Ignored when thinking mode is enabled.
+- `max_tokens` (optional): Maximum tokens to generate (deepseek-chat: max 8192, deepseek-reasoner: max 65536)
 - `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: "..."}}`
+- `thinking` (optional): Enable thinking mode `{type: "enabled"}` for enhanced reasoning
+- `json_mode` (optional): Enable JSON output mode (supported by both models)
 
 **Response includes:**
 - Content with formatting
@@ -221,6 +224,40 @@ The reasoner model will show its thinking process in `<thinking>` tags followed
 
 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`.
 
+**Thinking Mode Example:**
+
+```json
+{
+  "messages": [
+    {
+      "role": "user",
+      "content": "Analyze the time complexity of quicksort"
+    }
+  ],
+  "model": "deepseek-chat",
+  "thinking": { "type": "enabled" }
+}
+```
+
+When thinking mode is enabled, `temperature`, `top_p`, `frequency_penalty`, and `presence_penalty` are automatically ignored. The model provides enhanced reasoning capabilities similar to deepseek-reasoner.
+
+**JSON Output Mode Example:**
+
+```json
+{
+  "messages": [
+    {
+      "role": "user",
+      "content": "Return a json object with name, age, and city fields for a sample user"
+    }
+  ],
+  "model": "deepseek-chat",
+  "json_mode": true
+}
+```
+
+JSON mode ensures the model outputs valid JSON. Include the word "json" in your prompt for best results. Supported by both `deepseek-chat` and `deepseek-reasoner`.
+
 ## Available Prompts
 
 Pre-built prompt templates for common tasks (12 total):
@@ -247,20 +284,28 @@ Each prompt is optimized for the DeepSeek Reasoner model to provide detailed rea
 
 ## Models
 
+Both models run **DeepSeek-V3.2** with unified pricing.
+
 ### deepseek-chat
 
 - **Best for**: General conversations, coding, content generation
 - **Speed**: Fast
-- **Context**: 64K tokens
-- **Cost**: Most economical
+- **Context**: 128K tokens
+- **Max Output**: 8K tokens (default 4K)
+- **Mode**: Non-thinking (can enable thinking via parameter)
+- **Features**: Thinking mode, JSON mode, function calling, FIM completion
+- **Pricing**: $0.028/1M cache hit, $0.28/1M cache miss, $0.42/1M output
 
-### deepseek-reasoner (R1)
+### deepseek-reasoner
 
 - **Best for**: Complex reasoning, math, logic problems, multi-step tasks
 - **Speed**: Slower (shows thinking process)
-- **Context**: 64K tokens
-- **Special**: Provides chain-of-thought reasoning
+- **Context**: 128K tokens
+- **Max Output**: 64K tokens (default 32K)
+- **Mode**: Thinking (always active, chain-of-thought reasoning)
+- **Features**: JSON mode, function calling
 - **Output**: Both reasoning process and final answer
+- **Pricing**: $0.028/1M cache hit, $0.28/1M cache miss, $0.42/1M output
 
 ## Configuration
 
@@ -273,6 +318,8 @@ The server is configured via environment variables. All settings except `DEEPSEE
 | `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
@@ -289,18 +336,25 @@ claude mcp add -s user deepseek npx @arikusi/deepseek-mcp-server \
 ```
 deepseek-mcp-server/
 ├── src/
-│   ├── index.ts              # Main MCP server, tool & prompt registration
+│   ├── 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 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
+│   ├── 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

package/dist/config.d.ts

@@ -9,24 +9,30 @@ declare const ConfigSchema: z.ZodObject<{
     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.
- * Exits process if validation fails (e.g., missing API key).
+ * Throws ConfigError if validation fails.
  */
 export declare function loadConfig(): Config;
 /**

package/dist/config.d.ts.map

@@ -1 +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"}
+{"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

@@ -3,18 +3,21 @@
  * 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.
- * Exits process if validation fails (e.g., missing API key).
+ * Throws ConfigError if validation fails.
  */
 export function loadConfig() {
     const raw = {
@@ -27,19 +30,21 @@ export function loadConfig() {
         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) {
-        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);
+        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;

package/dist/config.js.map

@@ -1 +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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/cost.d.ts

@@ -1,24 +1,41 @@
 /**
  * Cost Calculation Module
  * Handles pricing and cost formatting for DeepSeek API requests
+ *
+ * DeepSeek V3.2 unified pricing (both deepseek-chat and deepseek-reasoner):
+ * - Cache hit input: $0.028/1M tokens
+ * - Cache miss input: $0.28/1M tokens
+ * - Output: $0.42/1M tokens
  */
-/** DeepSeek pricing per 1M tokens (USD) */
+/** DeepSeek V3.2 unified 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;
-    };
+    readonly cache_hit: 0.028;
+    readonly cache_miss: 0.28;
+    readonly output: 0.42;
 };
 /**
- * Calculate cost for a request based on token usage
+ * Cost breakdown for a request
  */
-export declare function calculateCost(promptTokens: number, completionTokens: number, model: string): number;
+export interface CostBreakdown {
+    inputCost: number;
+    outputCost: number;
+    totalCost: number;
+    cacheHitRatio?: number;
+    cacheSavings?: number;
+}
 /**
- * Format cost as readable USD string
+ * Calculate cost for a request based on token usage.
+ * Supports V3.2 cache hit/miss pricing. If cache fields are absent,
+ * treats all input tokens as cache miss (backward compatible).
  */
-export declare function formatCost(cost: number): string;
+export declare function calculateCost(usage: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    prompt_cache_hit_tokens?: number;
+    prompt_cache_miss_tokens?: number;
+}): CostBreakdown;
+/**
+ * Format cost as readable USD string with optional cache savings info
+ */
+export declare function formatCost(breakdown: CostBreakdown): string;
 //# sourceMappingURL=cost.d.ts.map

package/dist/cost.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wDAAwD;AACxD,eAAO,MAAM,OAAO;;;;CAIV,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,GAAG,aAAa,CA4ChB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAqB3D"}

package/dist/cost.js

@@ -1,34 +1,73 @@
 /**
  * Cost Calculation Module
  * Handles pricing and cost formatting for DeepSeek API requests
+ *
+ * DeepSeek V3.2 unified pricing (both deepseek-chat and deepseek-reasoner):
+ * - Cache hit input: $0.028/1M tokens
+ * - Cache miss input: $0.28/1M tokens
+ * - Output: $0.42/1M tokens
  */
-/** DeepSeek pricing per 1M tokens (USD) */
+/** DeepSeek V3.2 unified pricing per 1M tokens (USD) */
 export const PRICING = {
-    'deepseek-chat': {
-        prompt: 0.14,
-        completion: 0.28,
-    },
-    'deepseek-reasoner': {
-        prompt: 0.55,
-        completion: 2.19,
-    },
+    cache_hit: 0.028,
+    cache_miss: 0.28,
+    output: 0.42,
 };
 /**
- * Calculate cost for a request based on token usage
+ * Calculate cost for a request based on token usage.
+ * Supports V3.2 cache hit/miss pricing. If cache fields are absent,
+ * treats all input tokens as cache miss (backward compatible).
  */
-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;
+export function calculateCost(usage) {
+    const { prompt_tokens, completion_tokens, prompt_cache_hit_tokens, prompt_cache_miss_tokens, } = usage;
+    let inputCost;
+    let cacheHitRatio;
+    let cacheSavings;
+    if (prompt_cache_hit_tokens !== undefined &&
+        prompt_cache_miss_tokens !== undefined) {
+        // V3.2 cache-aware pricing
+        const hitCost = (prompt_cache_hit_tokens / 1_000_000) * PRICING.cache_hit;
+        const missCost = (prompt_cache_miss_tokens / 1_000_000) * PRICING.cache_miss;
+        inputCost = hitCost + missCost;
+        if (prompt_tokens > 0) {
+            cacheHitRatio = prompt_cache_hit_tokens / prompt_tokens;
+        }
+        // Savings = what all-miss would cost minus actual cost
+        const allMissCost = (prompt_tokens / 1_000_000) * PRICING.cache_miss;
+        cacheSavings = allMissCost - inputCost;
+    }
+    else {
+        // Backward compatible: treat all input as cache miss
+        inputCost = (prompt_tokens / 1_000_000) * PRICING.cache_miss;
+    }
+    const outputCost = (completion_tokens / 1_000_000) * PRICING.output;
+    return {
+        inputCost,
+        outputCost,
+        totalCost: inputCost + outputCost,
+        cacheHitRatio,
+        cacheSavings,
+    };
 }
 /**
- * Format cost as readable USD string
+ * Format cost as readable USD string with optional cache savings info
  */
-export function formatCost(cost) {
+export function formatCost(breakdown) {
+    const cost = breakdown.totalCost;
+    let formatted;
     if (cost < 0.01) {
-        return `$${cost.toFixed(4)}`;
+        formatted = `$${cost.toFixed(4)}`;
+    }
+    else {
+        formatted = `$${cost.toFixed(2)}`;
+    }
+    if (breakdown.cacheHitRatio !== undefined &&
+        breakdown.cacheHitRatio > 0 &&
+        breakdown.cacheSavings !== undefined &&
+        breakdown.cacheSavings > 0) {
+        const pct = Math.round(breakdown.cacheHitRatio * 100);
+        formatted += ` (cache hit: ${pct}%, saved ~$${breakdown.cacheSavings.toFixed(4)})`;
     }
-    return `$${cost.toFixed(2)}`;
+    return formatted;
 }
 //# sourceMappingURL=cost.js.map

package/dist/cost.js.map

@@ -1 +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"}
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;CACJ,CAAC;AAaX;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAK7B;IACC,MAAM,EACJ,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,GACzB,GAAG,KAAK,CAAC;IAEV,IAAI,SAAiB,CAAC;IACtB,IAAI,aAAiC,CAAC;IACtC,IAAI,YAAgC,CAAC;IAErC,IACE,uBAAuB,KAAK,SAAS;QACrC,wBAAwB,KAAK,SAAS,EACtC,CAAC;QACD,2BAA2B;QAC3B,MAAM,OAAO,GACX,CAAC,uBAAuB,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;QAC5D,MAAM,QAAQ,GACZ,CAAC,wBAAwB,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QAC9D,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;QAE/B,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,aAAa,GAAG,uBAAuB,GAAG,aAAa,CAAC;QAC1D,CAAC;QAED,uDAAuD;QACvD,MAAM,WAAW,GAAG,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QACrE,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,qDAAqD;QACrD,SAAS,GAAG,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAC/D,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAEpE,OAAO;QACL,SAAS;QACT,UAAU;QACV,SAAS,EAAE,SAAS,GAAG,UAAU;QACjC,aAAa;QACb,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAwB;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC;IACjC,IAAI,SAAiB,CAAC;IAEtB,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAChB,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;IAED,IACE,SAAS,CAAC,aAAa,KAAK,SAAS;QACrC,SAAS,CAAC,aAAa,GAAG,CAAC;QAC3B,SAAS,CAAC,YAAY,KAAK,SAAS;QACpC,SAAS,CAAC,YAAY,GAAG,CAAC,EAC1B,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QACtD,SAAS,IAAI,gBAAgB,GAAG,cAAc,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrF,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/deepseek-client.d.ts

@@ -6,6 +6,14 @@ import type { ChatCompletionParams, ChatCompletionResponse } from './types.js';
 export declare class DeepSeekClient {
     private client;
     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)
      */

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;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"}
+{"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;AAWpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;;IAavB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyD1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IA+ClC;;;OAGG;IACG,6BAA6B,CACjC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IA0GlC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAazC"}