utilitas 2001.1.117 → 2001.1.118

package/lib/alan.mjs

@@ -1,4 +1,4 @@
-import { checkSearch, distill, search } from './web.mjs';
+import { checkSearch, distill, getOpenRouterModels, search } from './web.mjs';
 import { create as createUoid } from './uoid.mjs';
 import { packPcmToWav } from './media.mjs';
 import { v4 as uuidv4 } from 'uuid';
@@ -47,7 +47,7 @@ const _NEED = ['OpenAI', '@google/genai'];
 const [
     OPENAI, GOOGLE, OLLAMA, NOVA, DEEPSEEK_32, MD_CODE, CLOUD_OPUS_45, AUDIO,
     WAV, OPENAI_VOICE, GPT_REASONING_EFFORT, THINK, THINK_STR, THINK_END,
-    TOOLS_STR, TOOLS_END, TOOLS, TEXT, OK, FUNC, GPT_52, GPT_51_CODEX,
+    TOOLS_STR, TOOLS_END, TOOLS, TEXT, OK, FUNC, GPT_52, GPT_52_CODEX,
     GPT_IMAGE_15, GEMMA_3_27B, ANTHROPIC, ais, MAX_TOOL_RECURSION, LOG, name,
     user, system, assistant, JSON_OBJECT, PROMPT_IS_REQUIRED, k, trimTailing,
     trimBeginning, GEMINI_30_PRO_IMAGE, IMAGE, JINA, SILICONFLOW,
@@ -61,7 +61,7 @@ const [
         'OpenAI', 'Google', 'Ollama', 'nova', 'deepseek-3.2-speciale', '```',
         'claude-opus-4.5', 'audio', 'wav', 'OPENAI_VOICE', 'medium', 'think',
         '<think>', '</think>', '<tools>', '</tools>', 'tools', 'text', 'OK',
-        'function', 'gpt-5.2', 'gpt-5.1-codex', 'gpt-image-1.5', 'gemma3:27b',
+        'function', 'gpt-5.2', 'gpt-5.2-codex', 'gpt-image-1.5', 'gemma3:27b',
         'Anthropic', [], 30, { log: true }, 'Alan', 'user', { role: 'system' },
         { role: 'assistant' }, 'json_object', 'Prompt is required.',
         x => 1000 * x, x => x.replace(/[\.\s]*$/, ''),
@@ -108,47 +108,13 @@ const FEATURE_ICONS = {
     vision: '👁️', // finetune: '🔧',
 };
 
-const GEMINI_RULES = {
-    source: GOOGLE, contextWindow: m(1.05), maxOutputTokens: k(65.5),
-    hearing: true, reasoning: true, structured: true, tools: true, vision: true,
-    supportedMimeTypes: [
-        MIME_PNG, MIME_JPEG, MIME_MOV, MIME_MPEG, MIME_MP4, MIME_MPG, MIME_AVI,
-        MIME_WMV, MIME_MPEGPS, MIME_FLV, MIME_PDF, MIME_AAC, MIME_FLAC,
-        MIME_MP3, MIME_MPEGA, MIME_M4A, MIME_MPGA, MIME_OPUS, MIME_PCM,
-        MIME_WAV, MIME_WEBM, MIME_TGPP, MIME_OGG,
-    ], defaultProvider: OPENROUTER,
-};
-
-const OPENAI_RULES = {
-    source: OPENAI, contextWindow: k(400), maxOutputTokens: k(128),
-    hearing: true, reasoning: true, structured: true, tools: true, vision: true,
-    supportedMimeTypes: [
-        MIME_PNG, MIME_JPEG, MIME_GIF, MIME_WEBP, MIME_PDF, MIME_WAV
-    ], defaultProvider: OPENROUTER,
-};
-
 const DEEPSEEK_32_RULES = {
     source: DEEPSEEK, contextWindow: k(163.8), maxOutputTokens: k(65.5),
     structured: true, tools: true, reasoning: true,
 };
 
-// https://platform.openai.com/docs/models
-// https://cloud.google.com/vertex-ai/docs/generative-ai/learn/models
-// https://openrouter.ai/docs/features/multimodal/audio (only support input audio)
 const MODELS = {
-    // fast and balanced models
-    [GEMINI_30_FLASH]: { // https://gemini.google.com/app/c680748b3307790b
-        ...GEMINI_RULES, fast: true, structured: false, // issue with json output via OpenRouter
-    },
-    // strong and fast
-    [GPT_52]: { ...OPENAI_RULES, fast: true },
-    // stronger but slow
-    [GEMINI_30_PRO]: { ...GEMINI_RULES },
     // models with generation capabilities
-    [GEMINI_30_PRO_IMAGE]: {
-        ...GEMINI_RULES, icon: '🍌', label: 'Nano Banana Pro',
-        contextWindow: k(64), maxOutputTokens: k(32), image: true, tools: false,
-    },
     [IMAGEN_4_ULTRA]: {
         source: GOOGLE, maxInputTokens: 480,
         image: true, defaultProvider: GOOGLE,
@@ -163,18 +129,11 @@ const MODELS = {
         supportedMimeTypes: [MIME_PNG, MIME_JPEG], defaultProvider: GOOGLE,
     },
     [GPT_IMAGE_15]: {
-        ...OPENAI_RULES, image: true, defaultProvider: OPENAI,
+        source: OPENAI, contextWindow: k(400), maxOutputTokens: k(128),
+        hearing: true, image: true, reasoning: true, structured: true,
+        tools: true, vision: true, defaultProvider: OPENAI,
         supportedMimeTypes: [MIME_PNG, MIME_JPEG, MIME_GIF, MIME_WEBP],
     },
-    // models with code capabilities
-    [GPT_51_CODEX]: { ...OPENAI_RULES },
-    [CLOUD_OPUS_45]: {
-        source: ANTHROPIC, contextWindow: k(200), maxOutputTokens: k(64),
-        reasoning: true, structured: true, tools: true, vision: true,
-        supportedMimeTypes: [
-            MIME_TEXT, MIME_PNG, MIME_JPEG, MIME_GIF, MIME_WEBP, MIME_PDF,
-        ], defaultProvider: OPENROUTER,
-    },
     // tts/stt models
     [GEMINI_25_FLASH_TTS]: {
         source: GOOGLE, maxInputTokens: k(32),
@@ -226,7 +185,7 @@ for (const n in MODELS) {
 }
 // Auto model have some issues with tools and reasoning, so we disable them here
 // MODELS[AUTO] = { name: AUTO, defaultProvider: OPENROUTER, };
-// for (const n of [GPT_52, GPT_51_CODEX, GEMINI_30_PRO, GEMINI_30_FLASH]) {
+// for (const n of [GPT_52, GPT_52_CODEX, GEMINI_30_PRO, GEMINI_30_FLASH]) {
 //     // get the most restrictive limits
 //     for (const key of [
 //         'contextWindow', 'maxInputTokens', 'maxOutputTokens',
@@ -263,13 +222,138 @@ for (const n in MODELS) {
 
 // Default models for each provider
 const DEFAULT_MODELS = {
-    [OPENROUTER]: GEMINI_30_FLASH,
+    [OPENROUTER]: [
+        // fast and balanced models
+        GEMINI_30_FLASH,
+        // strong and fast
+        GPT_52,
+        // stronger but slow
+        GEMINI_30_PRO,
+        // models with generation capabilities
+        GEMINI_30_PRO_IMAGE,
+        // models with code capabilities
+        GPT_52_CODEX,
+        CLOUD_OPUS_45,
+    ],
     [SILICONFLOW]: SF_DEEPSEEK_32,
     [OLLAMA]: GEMMA_3_27B,
     [OPENAI_VOICE]: NOVA,
 };
 
-let _tools;
+let _tools, openrouterUpdated;
+
+const adaptOpenRouterModels = async () => {
+    if (openrouterUpdated) { return; }
+    openrouterUpdated = true;
+    for (const model of await getOpenRouterModels()) {
+        model.label = model.name;
+        model.name = model.id.split('/').pop().trim();
+        model.source = OPENROUTER;
+        model.contextWindow = Math.min(
+            model.context_length || (1000 * 1000),
+            model.top_provider?.context_length || Infinity
+        );
+        model.maxOutputTokens = Math.min(
+            ~~model.top_provider?.max_completion_tokens || model.contextWindow,
+            parseInt(model.contextWindow * 0.4)
+        );
+        model.attachmentTokenCost = ATTACHMENT_TOKEN_COST;
+        model.maxInputTokens = model.contextWindow - model.maxOutputTokens;
+        model.inputModalities = model.architecture.input_modalities;
+        model.source = model.label.split(':')[0] || model.id.split('/')[0];
+        model.outputModalities = model.architecture.output_modalities;
+        model.defaultProvider = OPENROUTER;
+        [
+            'architecture', 'canonical_slug', 'context_length', 'created',
+            'default_parameters', 'expiration_date', 'hugging_face_id',
+            'per_request_limits', 'pricing', 'supported_parameters',
+            'top_provider',
+        ].map(key => delete model[key]);
+        // Backward compatibility: {
+        if (model.inputModalities.includes('image')
+            || model.inputModalities.includes('video')
+            || model.inputModalities.includes('file')) {
+            model.vision = true;
+        }
+        if (model.inputModalities.includes('audio')) {
+            model.hearing = true;
+        }
+        if (/reasoning|thinking/i.test(model.description)) {
+            model.reasoning = true;
+        }
+        if (model.outputModalities.includes('image')) {
+            model.image = true;
+        }
+        // if (model.outputModalities.includes('audio')) {
+        //     model.audio = true;
+        // }
+        // https://gemini.google.com/app/c680748b3307790b
+        // issue with json output via OpenRouter
+        if (/structured/i.test(model.description)
+            && model.name !== 'gemini-3-flash') {
+            model.structured = true;
+        }
+        if (/tool/i.test(model.description)) {
+            model.tools = true;
+        }
+        if (/flash|lite|mini|nano|tiny|small/i.test(model.name)) {
+            model.fast = true;
+        }
+        model.supportedMimeTypes = [];
+        switch (model.source) {
+            case GOOGLE:
+                if (model.vision) {
+                    model.supportedMimeTypes.push(
+                        MIME_PNG, MIME_JPEG, MIME_MOV, MIME_MPEG, MIME_MP4,
+                        MIME_MPG, MIME_AVI, MIME_WMV, MIME_MPEGPS, MIME_FLV,
+                        MIME_WEBM, MIME_TGPP, MIME_PDF,
+                    );
+                }
+                if (model.hearing) {
+                    model.supportedMimeTypes.push(
+                        MIME_AAC, MIME_FLAC, MIME_MP3, MIME_MPEGA, MIME_M4A,
+                        MIME_MPGA, MIME_OPUS, MIME_PCM, MIME_WAV, MIME_OGG,
+                    );
+                }
+                if (model.name === GEMINI_30_PRO_IMAGE) {
+                    model.icon = '🍌';
+                    model.label = 'Nano Banana Pro';
+                } else if (model.name === 'gemini-2.5-flash-image') {
+                    model.icon = '🍌';
+                    model.label = 'Nano Banana';
+                }
+                break;
+            case OPENAI:
+                // Notes:
+                // https://platform.openai.com/docs/models
+                // https://cloud.google.com/vertex-ai/docs/generative-ai/learn/models
+                // https://openrouter.ai/docs/features/multimodal/audio (only support input audio)
+                if (model.vision) {
+                    model.supportedMimeTypes.push(
+                        MIME_PNG, MIME_JPEG, MIME_GIF, MIME_WEBP, MIME_PDF,
+                    );
+                }
+                if (model.hearing) {
+                    model.supportedMimeTypes.push(MIME_WAV);
+                }
+                if (model.name === GPT_52) {
+                    model.fast = true;
+                }
+                break;
+            case ANTHROPIC:
+                if (model.vision) {
+                    model.supportedMimeTypes.push(
+                        MIME_TEXT, MIME_PNG, MIME_JPEG, MIME_GIF, MIME_WEBP,
+                        MIME_PDF,
+                    );
+                }
+                break;
+        }
+        // }
+        model.label = model.label.split(':').pop().trim();
+        MODELS[model.name] = model;
+    }
+};
 
 const unifyProvider = provider => {
     assert(provider = (provider || '').trim(), 'AI provider is required.');
@@ -400,6 +484,7 @@ const init = async (options = {}) => {
         (await need('node:util')).inspect.defaultOptions.depth = null;
         options.logLevel = 'debug';
     }
+    await adaptOpenRouterModels();
     options.provider = options.provider || OPENROUTER;
     const provider = unifyProvider(options.provider);
     const priority = options.priority;
@@ -413,7 +498,10 @@ const init = async (options = {}) => {
             x => ensureArray(options.model).includes(x.name)
         );
     } else if (DEFAULT_MODELS[provider]) { // Default model
-        models = [MODELS[DEFAULT_MODELS[provider]]];
+        const modelsByName = Object.fromEntries(
+            Object.values(MODELS).map(x => [x.name, x])
+        );
+        models = ensureArray(DEFAULT_MODELS[provider]).map(x => modelsByName[x]);
     } else if (options.modelConfig) {
         models = ensureArray(options.modelConfig);
     }
@@ -1614,6 +1702,7 @@ export {
     GEMINI_30_PRO_IMAGE,
     GPT_IMAGE_15,
     GPT_52,
+    GPT_52_CODEX,
     IMAGEN_4_ULTRA,
     INSTRUCTIONS,
     MODELS,

package/lib/manifest.mjs

@@ -1,7 +1,7 @@
 const manifest = {
     "name": "utilitas",
     "description": "Just another common utility for JavaScript.",
-    "version": "2001.1.117",
+    "version": "2001.1.118",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",

package/lib/web.mjs

@@ -381,6 +381,11 @@ const getExchangeRate = async (to, from, amount) => {
     return { rate, amount: amount.toString() };
 };
 
+const getOpenRouterModels = async () => {
+    const resp = await get('https://openrouter.ai/api/v1/models', { encode: 'JSON' });
+    assert(resp?.content?.data, 'Error fetching OpenRouter models.', 500);
+    return resp.content.data;
+};
 
 export default get;
 export {
@@ -397,6 +402,7 @@ export {
     getCurrentPosition,
     getExchangeRate,
     getJson,
+    getOpenRouterModels,
     getParsedHtml,
     getVersionOnNpm,
     getYoutubeMetadata,

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "utilitas",
     "description": "Just another common utility for JavaScript.",
-    "version": "2001.1.117",
+    "version": "2001.1.118",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",