modelmix 4.3.6 → 4.4.2

package/README.md

@@ -18,11 +18,9 @@ Ever found yourself wanting to integrate AI models into your projects but worrie
 ## 🛠️ Usage
 
 1. **Install the ModelMix package:**
-Recommended: install dotenv to manage environment variables
 ```bash
-npm install modelmix dotenv
+npm install modelmix
 ```
-
 > **AI Skill**: You can also add ModelMix as a skill for AI agentic development:
 > ```bash
 > npx skills add https://github.com/clasen/ModelMix --skill modelmix
@@ -39,6 +37,8 @@ MINIMAX_API_KEY="your-minimax-key..."
 GEMINI_API_KEY="AIza..."
 ```
 
+For environment variables, use `dotenv` or Node's built-in `process.loadEnvFile()`.
+
 3. **Create and configure your models**:
 
 ```javascript
@@ -159,7 +159,7 @@ Here's a comprehensive list of available methods:
 | `grok41[think]()`  | Grok       | grok-4-1-fast                  | [\$0.20 / \$0.50][6]       |
 | `deepseekV32()`    | Fireworks  | fireworks/models/deepseek-v3p2  | [\$0.56 / \$1.68][10]      |
 | `GLM47()`          | Fireworks  | fireworks/models/glm-4p7        | [\$0.55 / \$2.19][10]      |
-| `minimaxM21()`     | MiniMax    | MiniMax-M2.1                   | [\$0.30 / \$1.20][9]       |
+| `minimaxM25()`     | MiniMax    | MiniMax-M2.5                   | [\$0.30 / \$1.20][9]       |
 | `sonar()`          | Perplexity | sonar                          | [\$1.00 / \$1.00][4]       |
 | `sonarPro()`       | Perplexity | sonar-pro                      | [\$3.00 / \$15.00][4]      |
 | `scout()`          | Groq       | Llama-4-Scout-17B-16E-Instruct | [\$0.11 / \$0.34][5]       |
@@ -177,7 +177,7 @@ Here's a comprehensive list of available methods:
 [6]: https://docs.x.ai/docs/models "xAI"
 [7]: https://www.together.ai/pricing "Together AI"
 [8]: https://lambda.ai/inference "Lambda Pricing"
-[9]: https://www.minimax.io/price "MiniMax Pricing"
+[9]: https://platform.minimax.io/docs/api-reference/anthropic-api-compatible-cache#supported-models-and-pricing "MiniMax Pricing"
 [10]: https://fireworks.ai/pricing#serverless-pricing "Fireworks Pricing"
 
 Each method accepts optional `options` and `config` parameters to customize the model's behavior. For example:
@@ -400,12 +400,12 @@ The `cost` field is the estimated cost in USD based on the model's pricing per 1
 
 To activate debug mode in ModelMix and view detailed request information, follow these two steps:
 
-1. In the ModelMix constructor, include `debug: 3` in the configuration:
+1. In the ModelMix constructor, include a `debug` level in the configuration:
 
    ```javascript
    const mix = ModelMix.new({
      config: {
-       debug: 3
+       debug: 4 // 0=silent, 1=minimal, 2=summary, 3=full (no truncate), 4=verbose (raw details)
        // ... other configuration options ...
      }
    });

package/demo/gpt51.js

@@ -3,7 +3,7 @@ import { ModelMix } from '../index.js';
 
 const mmix = new ModelMix({
     config: {
-        debug: 2,
+        debug: 3,
     }
 });
 

package/demo/minimax.js

@@ -7,7 +7,7 @@ const main = async () => {
 
     const bot = ModelMix
         .new({ config: { debug: 3 } })
-        .minimaxM21()
+        .minimaxM25()
         .setSystem('You are a helpful assistant.');
 
     bot.addText('What is the capital of France?');

package/index.js

@@ -48,8 +48,10 @@ const MODEL_PRICING = {
     'accounts/fireworks/models/deepseek-v3p2': [0.56, 1.68],
     'accounts/fireworks/models/glm-4p7': [0.55, 2.19],
     'accounts/fireworks/models/kimi-k2p5': [0.50, 2.80],
+    'fireworks/glm-5': [1.00, 3.20],
     // MiniMax
     'MiniMax-M2.1': [0.30, 1.20],
+    'MiniMax-M2.5': [0.30, 1.20],
     // Perplexity
     'sonar': [1.00, 1.00],
     'sonar-pro': [3.00, 15.00],
@@ -110,7 +112,7 @@ class ModelMix {
         this.config = {
             system: 'You are an assistant.',
             max_history: 1, // Default max history
-            debug: 0, // 0=silent, 1=minimal, 2=readable summary, 3=full details
+            debug: 0, // 0=silent, 1=minimal, 2=readable summary, 3=full (no truncate), 4=verbose (raw details)
             bottleneck: defaultBottleneckConfig,
             roundRobin: false, // false=fallback mode, true=round robin rotation
             ...config
@@ -170,7 +172,7 @@ class ModelMix {
         return (tokens.input * inputPerMillion / 1_000_000) + (tokens.output * outputPerMillion / 1_000_000);
     }
 
-    static formatInputSummary(messages, system) {
+    static formatInputSummary(messages, system, debug = 2) {
         const lastMessage = messages[messages.length - 1];
         let inputText = '';
 
@@ -181,38 +183,39 @@ class ModelMix {
             inputText = lastMessage.content;
         }
 
-        const systemStr = `System: ${ModelMix.truncate(system, 500)}`;
-        const inputStr = `Input: ${ModelMix.truncate(inputText, 1200)}`;
+        const noTruncate = debug >= 3;
+        const systemStr = noTruncate ? (system || '') : ModelMix.truncate(system, 500);
+        const inputStr = noTruncate ? inputText : ModelMix.truncate(inputText, 1200);
         const msgCount = `(${messages.length} msg${messages.length !== 1 ? 's' : ''})`;
 
-        return `${systemStr} \n| ${inputStr} ${msgCount}`;
+        return `| SYSTEM\n${systemStr}\n| INPUT ${msgCount}\n${inputStr}`;
     }
 
     static formatOutputSummary(result, debug) {
         const parts = [];
+        const noTruncate = debug >= 3;
         if (result.message) {
             // Try to parse as JSON for better formatting
             try {
                 const parsed = JSON.parse(result.message.trim());
                 // If it's valid JSON and debug >= 2, show it formatted
                 if (debug >= 2) {
-                    parts.push(`Output (JSON):\n${ModelMix.formatJSON(parsed)}`);
+                    parts.push(`| OUTPUT (JSON)\n${ModelMix.formatJSON(parsed)}`);
                 } else {
-                    parts.push(`Output: ${ModelMix.truncate(result.message, 1500)}`);
+                    parts.push(`| OUTPUT\n${ModelMix.truncate(result.message, 1500)}`);
                 }
             } catch (e) {
-                // Not JSON, show truncated as before
-                parts.push(`Output: ${ModelMix.truncate(result.message, 1500)}`);
+                parts.push(`| OUTPUT\n${noTruncate ? result.message : ModelMix.truncate(result.message, 1500)}`);
             }
         }
         if (result.think) {
-            parts.push(`Think: ${ModelMix.truncate(result.think, 800)}`);
+            parts.push(`| THINK\n${noTruncate ? result.think : ModelMix.truncate(result.think, 800)}`);
         }
         if (result.toolCalls && result.toolCalls.length > 0) {
             const toolNames = result.toolCalls.map(t => t.function?.name || t.name).join(', ');
-            parts.push(`Tools: ${toolNames}`);
+            parts.push(`| TOOLS\n${toolNames}`);
         }
-        return parts.join(' | ');
+        return parts.join('\n');
     }
 
     attach(key, provider) {
@@ -435,6 +438,10 @@ class ModelMix {
         return this;
     }
 
+    minimaxM25({ options = {}, config = {} } = {}) {
+        return this.attach('MiniMax-M2.5', new MixMiniMax({ options, config }));
+    }
+
     minimaxM2Stable({ options = {}, config = {} } = {}) {
         return this.attach('MiniMax-M2-Stable', new MixMiniMax({ options, config }));
     }
@@ -446,6 +453,12 @@ class ModelMix {
         return this;
     }
 
+    GLM5({ options = {}, config = {}, mix = { fireworks: true } } = {}) {
+        mix = { ...this.mix, ...mix };
+        if (mix.fireworks) this.attach('fireworks/glm-5', new MixFireworks({ options, config }));
+        return this;
+    }
+
     GLM47({ options = {}, config = {}, mix = { fireworks: true } } = {}) {
         mix = { ...this.mix, ...mix };
         if (mix.fireworks) this.attach('accounts/fireworks/models/glm-4p7', new MixFireworks({ options, config }));
@@ -842,7 +855,7 @@ class ModelMix {
                     const header = `\n${prefix} [${providerName}:${currentModelKey}] #${originalIndex + 1}${suffix}`;
 
                     if (currentConfig.debug >= 2) {
-                        console.log(`${header} | ${ModelMix.formatInputSummary(this.messages, currentConfig.system)}`);
+                        console.log(`${header}\n${ModelMix.formatInputSummary(this.messages, currentConfig.system, currentConfig.debug)}`);
                     } else {
                         console.log(header);
                     }
@@ -897,11 +910,14 @@ class ModelMix {
 
                     // debug level 2: Readable summary of output
                     if (currentConfig.debug >= 2) {
-                        console.log(`✓ ${ModelMix.formatOutputSummary(result, currentConfig.debug).trim()}`);
+                        const tokenInfo = result.tokens
+                            ? ` ${result.tokens.input} → ${result.tokens.output} tok` + (result.tokens.cost != null ? ` $${result.tokens.cost.toFixed(4)}` : '')
+                            : '';
+                        console.log(`✓${tokenInfo}\n${ModelMix.formatOutputSummary(result, currentConfig.debug).trim()}`);
                     }
 
-                    // debug level 3 (debug): Full response details
-                    if (currentConfig.debug >= 3) {
+                    // debug level 4 (verbose): Full response details
+                    if (currentConfig.debug >= 4) {
                         if (result.response) {
                             console.log('\n[RAW RESPONSE]');
                             console.log(ModelMix.formatJSON(result.response));
@@ -1148,8 +1164,8 @@ class MixCustom {
 
             options.messages = this.convertMessages(options.messages, config);
 
-            // debug level 3 (debug): Full request details
-            if (config.debug >= 3) {
+            // debug level 4 (verbose): Full request details
+            if (config.debug >= 4) {
                 console.log('\n[REQUEST DETAILS]');
 
                 console.log('\n[CONFIG]');
@@ -2032,8 +2048,8 @@ class MixGoogle extends MixCustom {
         };
 
         try {
-            // debug level 3 (debug): Full request details
-            if (config.debug >= 3) {
+            // debug level 4 (verbose): Full request details
+            if (config.debug >= 4) {
                 console.log('\n[REQUEST DETAILS - GOOGLE]');
 
                 console.log('\n[CONFIG]');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modelmix",
-  "version": "4.3.6",
+  "version": "4.4.2",
   "description": "🧬 Reliable interface with automatic fallback for AI LLMs.",
   "main": "index.js",
   "repository": {

package/skills/modelmix/SKILL.md

@@ -20,6 +20,23 @@ Do NOT use this skill for:
 - Python or non-Node.js projects
 - Direct HTTP calls to LLM APIs (use ModelMix instead)
 
+## Common Tasks
+
+- [Get a text response](#get-a-text-response)
+- [Get structured JSON](#get-structured-json)
+- [Stream a response](#stream-a-response)
+- [Get raw response (tokens, thinking, tool calls)](#get-raw-response-tokens-thinking-tool-calls)
+- [Access full response after `message()` or `json()` with `lastRaw`](#access-full-response-after-message-or-json-with-lastraw)
+- [Add images](#add-images)
+- [Use templates with placeholders](#use-templates-with-placeholders)
+- [Round-robin load balancing](#round-robin-load-balancing)
+- [MCP integration (external tools)](#mcp-integration-external-tools)
+- [Custom local tools (addTool)](#custom-local-tools-addtool)
+- [Rate limiting (Bottleneck)](#rate-limiting-bottleneck)
+- [Debug mode](#debug-mode)
+- [Use free-tier models](#use-free-tier-models)
+- [Conversation history](#conversation-history)
+
 ## Installation
 
 ```bash
@@ -46,7 +63,7 @@ const model = ModelMix.new({
     config: {
         system: "You are a helpful assistant.",
         max_history: 5,
-        debug: 0,           // 0=silent, 1=minimal, 2=summary, 3=full
+        debug: 0,           // 0=silent, 1=minimal, 2=summary, 3=full (no truncate), 4=verbose
         roundRobin: false    // false=fallback, true=rotate models
     }
 });
@@ -229,7 +246,7 @@ const model = ModelMix.new({
 
 ```javascript
 const model = ModelMix.new({
-    config: { debug: 2 }  // 0=silent, 1=minimal, 2=summary, 3=full
+    config: { debug: 2 }  // 0=silent, 1=minimal, 2=summary, 3=full (no truncate), 4=verbose
 }).gpt5mini();
 ```