modelmix 5.1.17 → 5.1.19

package/README.md

@@ -197,7 +197,10 @@ ModelMix provides convenient shorthand methods for quickly accessing different A
 | `grok420multiAgent()` | Grok | grok-4.20-multi-agent-0309 | [\$1.25][6] | [\$2.50][6] |
 | `grok420()` | Grok | grok-4.20-0309 (†) | [\$1.25][6] | [\$2.50][6] |
 | `museGlimmer30b()` | Fireworks | models/muse-glimmer-30b | [\$0.35][17] | [\$1.50][17] |
-| `museSpark12()` | OpenRouter | meta/muse-spark-1.2-contributor | [\$0.10][22] | [\$0.20][22] |
+| `museSpark12()` | OpenRouter | meta/muse-spark-1.2 | [\$1.25][25] | [\$4.25][25] |
+| `museSpark12c()` | OpenRouter | meta/muse-spark-1.2-contributor | [\$0.10][22] | [\$0.20][22] |
+| `museSpark13()` | OpenRouter | meta/muse-spark-1.3 | [\$1.25][24] | [\$4.25][24] |
+| `museSpark13c()` | OpenRouter | meta/muse-spark-1.3-contributor | [\$0.10][26] | [\$0.20][26] |
 | `qwen35397b()` | OpenRouter | qwen/qwen3.5-397b-a17b | [\$0.385][14] | [\$2.45][14] |
 | `qwen36plus()` | OpenRouter | qwen/qwen3.6-plus | [\$0.325][18] | [\$1.95][18] |
 | `qwen37plus()` | Fireworks | models/qwen3p7-plus | [\$0.40][10] | [\$1.60][10] |
@@ -254,6 +257,12 @@ OpenRouter fallbacks are disabled globally by default and are appended only with
 [21]: https://openrouter.ai/anthropic/claude-fable-5.1 "Claude Fable 5.1 on OpenRouter"
 [22]: https://openrouter.ai/meta/muse-spark-1.2-contributor "Muse Spark 1.2 Contributor on OpenRouter"
 [23]: https://openrouter.ai/openai "OpenAI Models on OpenRouter"
+[24]: https://openrouter.ai/meta/muse-spark-1.3 "Muse Spark 1.3 on OpenRouter"
+
+[25]: https://openrouter.ai/meta/muse-spark-1.2 "Muse Spark 1.2 on OpenRouter"
+[26]: https://openrouter.ai/meta/muse-spark-1.3-contributor "Muse Spark 1.3 Contributor on OpenRouter"
+
+Muse Spark methods ending in `c` select Contributor: prompts and outputs may be used to improve Meta products. Methods without `c` select the standard tier. `museSpark12()` now selects standard; use `museSpark12c()` for the previous Contributor behavior.
 
 Each method accepts optional `options`, `config`, and (for multi-provider methods) `mix` parameters to customize behavior.  
 

package/demo/short.js

@@ -21,9 +21,12 @@ const mmix = await ModelMix.new(setup)
     .GLM53() // (fallback 10) OpenRouter z-ai/glm-5.3
     .GLM53Flash() // (fallback 11) OpenRouter z-ai/glm-5.3-flash
     .museGlimmer30b({ mix: { fireworks: false, openrouter: true } }) // (fallback 12) OpenRouter meta/muse-glimmer-30b
-    .museSpark12() // (fallback 13) OpenRouter meta/muse-spark-1.2-contributor
+    .museSpark12c() // (fallback 13) OpenRouter meta/muse-spark-1.2-contributor
     .hermes470b() // (fallback 14) OpenRouter nousresearch/hermes-4-70b
     .hermes4405b() // (fallback 15) OpenRouter nousresearch/hermes-4-405b
+    .museSpark13() // (fallback 16) OpenRouter meta/muse-spark-1.3
+    .museSpark12() // (fallback 17) OpenRouter meta/muse-spark-1.2
+    .museSpark13c() // (fallback 18) OpenRouter meta/muse-spark-1.3-contributor
     .addText("What's your name?");
 
 console.log(await mmix.message());

package/effort.js

@@ -49,7 +49,10 @@ const OPENAI_MODEL_LEVELS = {
     'meta/muse-glimmer-30b': ['low', 'medium', 'high'],
     'accounts/fireworks/models/muse-glimmer-30b': ['low', 'medium', 'high', 'xhigh'],
     'meta-models/Muse-Glimmer-30B': ['low', 'medium', 'high', 'xhigh'],
+    'meta/muse-spark-1.2': ['minimal', 'low', 'medium', 'high', 'xhigh'],
+    'meta/muse-spark-1.3-contributor': ['minimal', 'low', 'medium', 'high', 'xhigh'],
     'meta/muse-spark-1.2-contributor': ['minimal', 'low', 'medium', 'high', 'xhigh'],
+    'meta/muse-spark-1.3': ['minimal', 'low', 'medium', 'high', 'xhigh'],
     'accounts/fireworks/models/qwen3p8-2p4t-a95b': ['none', 'low', 'medium', 'high'],
     'qwen/qwen3.8-27b': ['low', 'medium', 'xhigh'],
     'qwen/qwen3.8-flash': ['low', 'medium', 'xhigh'],

package/index.d.ts

@@ -504,6 +504,9 @@ export declare class ModelMix {
   // Multi-provider
   museGlimmer30b(args?: ModelAttachArgs): this;
   museSpark12(args?: ModelAttachArgs): this;
+  museSpark12c(args?: ModelAttachArgs): this;
+  museSpark13(args?: ModelAttachArgs): this;
+  museSpark13c(args?: ModelAttachArgs): this;
   qwen35397b(args?: ModelAttachArgs): this;
   qwen36plus(args?: ModelAttachArgs): this;
   qwen37plus(args?: ModelAttachArgs): this;

package/index.js

@@ -625,9 +625,21 @@ class ModelMix {
     }
 
     museSpark12({ options = {}, config = {} } = {}) {
+        return this.attach('meta/muse-spark-1.2', new MixOpenRouter({ options, config }));
+    }
+
+    museSpark12c({ options = {}, config = {} } = {}) {
         return this.attach('meta/muse-spark-1.2-contributor', new MixOpenRouter({ options, config }));
     }
 
+    museSpark13({ options = {}, config = {} } = {}) {
+        return this.attach('meta/muse-spark-1.3', new MixOpenRouter({ options, config }));
+    }
+
+    museSpark13c({ options = {}, config = {} } = {}) {
+        return this.attach('meta/muse-spark-1.3-contributor', new MixOpenRouter({ options, config }));
+    }
+
     qwen35397b({ options = {}, config = {} } = {}) {
         return this.attach('qwen/qwen3.5-397b-a17b', new MixOpenRouter({ options, config }));
     }

package/lib/model-chain.js

@@ -10,7 +10,7 @@ const CHAIN_MODEL_SHORTCUTS = new Set([
     'gemini31pro', 'gemini38flash', 'gemini37flash', 'gemini36flash', 'gemini35flash',
     'gemini35flashLite', 'gemini31flashLite', 'sonarPro', 'sonar',
     'grok46', 'grok45', 'grok43', 'grok420multiAgent', 'grok420',
-    'museGlimmer30b', 'museSpark12',
+    'museGlimmer30b', 'museSpark12', 'museSpark12c', 'museSpark13', 'museSpark13c',
     'qwen35397b', 'qwen36plus', 'qwen37plus', 'qwen38max', 'qwen3827b', 'qwen38flash',
     'hermes470b', 'hermes4405b', 'hermes3',
     'kimiK26', 'kimiK27Code', 'kimiK3', 'kimiK25',

package/lib/token-usage.js

@@ -84,7 +84,10 @@ const MODEL_PRICING = {
     'meta/muse-glimmer-30b': { input: 0.35, cachedInput: 0.04, output: 1.50 },
     'accounts/fireworks/models/muse-glimmer-30b': { input: 0.35, cachedInput: 0.04, output: 1.50 },
     'meta-models/Muse-Glimmer-30B': { input: 0.35, cachedInput: 0.04, output: 1.50 },
+    'meta/muse-spark-1.2': { input: 1.25, cachedInput: 0.15, output: 4.25 },
+    'meta/muse-spark-1.3-contributor': { input: 0.10, cachedInput: 0.002, output: 0.20 },
     'meta/muse-spark-1.2-contributor': { input: 0.10, cachedInput: 0.002, output: 0.20 },
+    'meta/muse-spark-1.3': { input: 1.25, cachedInput: 0.15, output: 4.25 },
     // Fireworks
     'accounts/fireworks/models/deepseek-v4-flash': { input: 0.14, output: 0.28 },
     'accounts/fireworks/models/deepseek-v4-pro': { input: 1.74, output: 3.48 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modelmix",
-  "version": "5.1.17",
+  "version": "5.1.19",
   "description": "🧬 Reliable interface with automatic fallback for AI LLMs.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -24,20 +24,20 @@
     "fallback",
     "kimi",
     "mythos",
-    "gpt5",
-    "opus50",
-    "opus5",
-    "fable51",
-    "fable50",
+    "gpt6",
+    "astra",
+    "muse",
+    "spark",
+    "opus",
     "fable",
     "sonnet",
     "openrouter",
     "gemini",
+    "qwen",
     "glm",
     "lmstudio",
     "deepseek",
     "oss",
-    "k26",
     "reasoning",
     "minimax",
     "thinking",
@@ -79,5 +79,6 @@
     "test:plugins": "mocha test/plugins.test.js --timeout 10000 --require test/setup.js",
     "test:rlm": "mocha plugins/rlm/test/**/*.test.js --timeout 10000 --require test/setup.js",
     "test:offline": "mocha test/abort.test.js test/json.test.js test/fallback.test.js test/templates.test.js test/images.test.js test/bottleneck.test.js test/tokens.test.js test/history.test.js test/anthropic.test.js test/effort.test.js test/grok.test.js test/moderation.test.js test/plugins.test.js plugins/rlm/test/**/*.test.js --timeout 10000 --require test/setup.js"
-  }
-}
+  },
+  "packageManager": "pnpm@11.18.0+sha512.33d83c77da82f49fba836925c6f1b841181ec3132b670639bd012f7075f5c7cf634c5f870147c19aae7478fac01df09d8892e880454896edd23ee9b33757563c"
+}

package/skills/modelmix/SKILL.md

@@ -190,7 +190,9 @@ Use `.effort(n)` (or `config.effort`) to enable Anthropic thinking — e.g. `.ef
 `GLM46()`
 
 ### OpenRouter
-`museGlimmer30b()` `museSpark12()` `gptOss()` `qwen35397b()` `qwen36plus()` `qwen37plus()` `qwen3827b()` `qwen38flash()` `hermes470b()` `hermes4405b()` `qwen38max()` `kimiK27Code()` `kimiK3()` `minimaxM27()` `minimaxM3()` `GLM45()` `GLM52()` `GLM53()` `GLM53Flash()`
+`museGlimmer30b()` `museSpark12()` `museSpark12c()` `museSpark13()` `museSpark13c()` `gptOss()` `qwen35397b()` `qwen36plus()` `qwen37plus()` `qwen3827b()` `qwen38flash()` `hermes470b()` `hermes4405b()` `qwen38max()` `kimiK27Code()` `kimiK3()` `minimaxM27()` `minimaxM3()` `GLM45()` `GLM52()` `GLM53()` `GLM53Flash()`
+
+Muse Spark: the `c` suffix selects Contributor, where prompts and outputs may be used to improve Meta products. Without `c`, the standard tier is selected. Use `museSpark12c()` for the former `museSpark12()` Contributor behavior.
 
 ### Multi-provider (auto-fallback across free/paid tiers)
 `hermes3()` `kimiK25()`

package/test/effort.test.js

@@ -135,14 +135,18 @@ describe('Unified effort scale', () => {
             });
         });
 
-        it('maps Muse Spark 1.2 Contributor to every supported reasoning level', () => {
-            const key = 'meta/muse-spark-1.2-contributor';
-            expect(mapEffort('openai', 0, key)).to.deep.equal({ reasoning_effort: 'minimal' });
-            expect(mapEffort('openai', 20, key)).to.deep.equal({ reasoning_effort: 'low' });
-            expect(mapEffort('openai', 40, key)).to.deep.equal({ reasoning_effort: 'medium' });
-            expect(mapEffort('openai', 60, key)).to.deep.equal({ reasoning_effort: 'high' });
-            expect(mapEffort('openai', 80, key)).to.deep.equal({ reasoning_effort: 'xhigh' });
-            expect(mapEffort('openai', -1, key)).to.equal(null);
+        it('maps every Muse Spark variant to supported reasoning levels', () => {
+            for (const key of [
+                'meta/muse-spark-1.2', 'meta/muse-spark-1.2-contributor',
+                'meta/muse-spark-1.3', 'meta/muse-spark-1.3-contributor'
+            ]) {
+                expect(mapEffort('openai', 0, key)).to.deep.equal({ reasoning_effort: 'minimal' });
+                expect(mapEffort('openai', 20, key)).to.deep.equal({ reasoning_effort: 'low' });
+                expect(mapEffort('openai', 40, key)).to.deep.equal({ reasoning_effort: 'medium' });
+                expect(mapEffort('openai', 60, key)).to.deep.equal({ reasoning_effort: 'high' });
+                expect(mapEffort('openai', 80, key)).to.deep.equal({ reasoning_effort: 'xhigh' });
+                expect(mapEffort('openai', -1, key)).to.equal(null);
+            }
         });
 
         it('maps Qwen 3.8 27B to its supported reasoning levels', () => {

package/test/muse.test.js

@@ -1,4 +1,5 @@
 const { expect } = require('chai');
+const nock = require('nock');
 const {
     ModelMix,
     MixFireworks,
@@ -8,6 +9,28 @@ const {
 } = require('../index.js');
 
 describe('Muse Model Registration Tests', () => {
+    it('sends Muse Spark 1.3 requests through chain() with supported effort and options', async () => {
+        const api = nock('https://openrouter.ai')
+            .post('/api/v1/chat/completions', body => {
+                expect(body.model).to.equal('meta/muse-spark-1.3');
+                expect(body.reasoning_effort).to.equal('minimal');
+                expect(body.max_tokens).to.equal(2048);
+                return true;
+            })
+            .reply(200, {
+                choices: [{ message: { content: 'ok' } }],
+                usage: { prompt_tokens: 10, completion_tokens: 2, total_tokens: 12 }
+            });
+
+        const model = ModelMix.new({ config: { apiKey: 'test-key' }, options: { max_tokens: 2048 } })
+            .chain('museSpark13@0')
+            .addText('Hi');
+
+        expect(model.models[0].provider).to.be.instanceOf(MixOpenRouter);
+        expect(await model.message()).to.equal('ok');
+        api.done();
+    });
+
     it('registers only Fireworks by default', () => {
         const model = ModelMix.new().museGlimmer30b();
 
@@ -56,23 +79,25 @@ describe('Muse Model Registration Tests', () => {
         ]);
     });
 
-    it('registers Muse Spark 1.2 Contributor through OpenRouter', () => {
-        const model = ModelMix.new().museSpark12();
+    for (const [shortcut, key] of [
+        ['museSpark12', 'meta/muse-spark-1.2'],
+        ['museSpark12c', 'meta/muse-spark-1.2-contributor'],
+        ['museSpark13', 'meta/muse-spark-1.3'],
+        ['museSpark13c', 'meta/muse-spark-1.3-contributor']
+    ]) {
+        it(`registers ${shortcut} directly and through chain()`, () => {
+            const direct = ModelMix.new()[shortcut]({
+                config: { apiKey: 'test-key' },
+                options: { max_tokens: 2048 }
+            });
+            const chain = ModelMix.new({ config: { apiKey: 'test-key' } }).chain(shortcut);
 
-        expect(model.models).to.have.length(1);
-        expect(model.models[0].key).to.equal('meta/muse-spark-1.2-contributor');
-        expect(model.models[0].provider).to.be.instanceOf(MixOpenRouter);
-        expect(ModelMix.calculateCost('meta/muse-spark-1.2-contributor', {
-            input: 1_000_000,
-            cached: 250_000,
-            output: 1_000_000
-        })).to.equal(0.2755);
-    });
-
-    it('supports Muse Spark 1.2 Contributor in chain()', () => {
-        const model = ModelMix.new().chain('museSpark12');
-
-        expect(model.models).to.have.length(1);
-        expect(model.models[0].key).to.equal('meta/muse-spark-1.2-contributor');
-    });
+            for (const model of [direct, chain]) {
+                expect(model.models).to.have.length(1);
+                expect(model.models[0].key).to.equal(key);
+                expect(model.models[0].provider).to.be.instanceOf(MixOpenRouter);
+            }
+            expect(direct.models[0].provider.options.max_tokens).to.equal(2048);
+        });
+    }
 });