utilitas 1999.1.51 → 1999.1.53

package/lib/alan.mjs

@@ -56,36 +56,34 @@ const [
     ];
 
 const [
-    OPENAI, GEMINI, OPENAI_TRAINING, OLLAMA, GPT_4O, GPT_O1, GPT_O3_MINI,
-    GEMINI_20_FLASH, NOVA, DEEPSEEK_R1, MD_CODE, TEXT_EMBEDDING_3_SMALL,
-    TEXT_EMBEDDING_3_LARGE, CLOUD_37_SONNET, AUDIO, WAV, ATTACHMENTS, CHAT,
-    OPENAI_VOICE, MEDIUM, LOW, HIGH, GPT_REASONING_EFFORT, THINK, THINK_STR,
-    THINK_END, AZURE, TOOLS_STR, TOOLS_END, TOOLS, TEXT, THINKING, OK, FUNC,
-    GPT_45, REDACTED_THINKING, GEMMA_3_27B, AZURE_OPENAI, ANTHROPIC,
-    VERTEX_ANTHROPIC, GEMMA327B, v8k, ais, MAX_TOOL_RECURSION, LOG, name, user,
-    system, assistant, MODEL, JSON_OBJECT, TOOL, silent, GEMINI_EMBEDDING_M,
-    INVALID_FILE, tokenSafeRatio, GPT_QUERY_LIMIT, CONTENT_IS_REQUIRED,
-    OPENAI_HI_RES_SIZE, k, kT, m, minute, hour, gb, trimTailing, EBD,
-    GEMINI_20_FLASH_EXP, IMAGE, JINA, JINA_DEEPSEARCH, JINA_CLIP, VERTEX,
-    GEMINI_25_PRO, SILICONFLOW, SF_DEEPSEEK_V3,
+    OPENAI, GEMINI, OPENAI_TRAINING, OLLAMA, GPT_4O, GPT_O3, GEMINI_25_FLASH,
+    NOVA, DEEPSEEK_R1, MD_CODE, TEXT_EMBEDDING_3_SMALL, TEXT_EMBEDDING_3_LARGE,
+    CLOUD_37_SONNET, AUDIO, WAV, ATTACHMENTS, CHAT, OPENAI_VOICE, MEDIUM, LOW,
+    HIGH, GPT_REASONING_EFFORT, THINK, THINK_STR, THINK_END, AZURE, TOOLS_STR,
+    TOOLS_END, TOOLS, TEXT, THINKING, OK, FUNC, GPT_41, REDACTED_THINKING,
+    GEMMA_3_27B, AZURE_OPENAI, ANTHROPIC, VERTEX_ANTHROPIC, v8k, ais,
+    MAX_TOOL_RECURSION, LOG, name, user, system, assistant, MODEL, JSON_OBJECT,
+    TOOL, silent, GEMINI_EMBEDDING_M, INVALID_FILE, tokenSafeRatio,
+    GPT_QUERY_LIMIT, CONTENT_IS_REQUIRED, OPENAI_HI_RES_SIZE, k, kT, m, minute,
+    hour, gb, trimTailing, EBD, GEMINI_20_FLASH, IMAGE, JINA, JINA_DEEPSEARCH,
+    JINA_CLIP, VERTEX, GEMINI_25_PRO, SILICONFLOW, SF_DEEPSEEK_V3,
 ] = [
-        'OpenAI', 'Gemini', 'OPENAI_TRAINING', 'Ollama', 'gpt-4o', 'o1',
-        'o3-mini', 'gemini-2.0-flash', 'nova', 'deepseek-r1', '```',
-        'text-embedding-3-small', 'text-embedding-3-large',
+        'OpenAI', 'Gemini', 'OPENAI_TRAINING', 'Ollama', 'gpt-4o', 'o3',
+        'gemini-2.5-flash-preview-04-17', 'nova', 'deepseek-r1',
+        '```', 'text-embedding-3-small', 'text-embedding-3-large',
         'claude-3-7-sonnet@20250219', 'audio', 'wav', '[ATTACHMENTS]', 'CHAT',
         'OPENAI_VOICE', 'medium', 'low', 'high', 'medium', 'think', '<think>',
         '</think>', 'AZURE', '<tools>', '</tools>', 'tools', 'text', 'thinking',
-        'OK', 'function', 'gpt-4.5-preview', 'redacted_thinking',
-        'gemma-3-27b-it', 'Azure Openai', 'Anthropic', 'Vertex Anthropic',
-        'gemma3:27b', 7680 * 4320, [], 10, { log: true }, 'Alan', 'user',
-        'system', 'assistant', 'model', 'json_object', 'tool', true,
-        'gemini-embedding-exp-03-07', 'Invalid file data.', 1.1, 100,
-        'Content is required.', 2000 * 768, x => 1024 * x, x => 1000 * x,
-        x => 1024 * 1024 * x, x => 60 * x, x => 60 * 60 * x,
-        x => 1024 * 1024 * 1024 * x, x => x.replace(/[\.\s]*$/, ''),
-        { embedding: true }, 'gemini-2.0-flash-exp', 'image', 'Jina',
-        'jina-deepsearch-v1', 'jina-clip-v2', 'Vertex',
-        'gemini-2.5-pro-exp-03-25', 'SiliconFlow',
+        'OK', 'function', 'gpt-4.1', 'redacted_thinking', 'gemma3:27b',
+        'Azure Openai', 'Anthropic', 'Vertex Anthropic', 7680 * 4320, [], 10,
+        { log: true }, 'Alan', 'user', 'system', 'assistant', 'model',
+        'json_object', 'tool', true, 'gemini-embedding-exp-03-07',
+        'Invalid file data.', 1.1, 100, 'Content is required.', 2048 * 2048,
+        x => 1024 * x, x => 1000 * x, x => 1024 * 1024 * x, x => 60 * x,
+        x => 60 * 60 * x, x => 1024 * 1024 * 1024 * x,
+        x => x.replace(/[\.\s]*$/, ''), { embedding: true },
+        'gemini-2.0-flash-exp', 'image', 'Jina', 'jina-deepsearch-v1',
+        'jina-clip-v2', 'Vertex', 'gemini-2.5-pro-exp-03-25', 'SiliconFlow',
         'Pro/deepseek-ai/DeepSeek-V3',
     ];
 
@@ -120,6 +118,7 @@ const OPENAI_RULES = {
 };
 
 const GEMINI_RULES = {
+    contextWindow: m(1), json: true,
     audioCostTokens: 1000 * 1000 * 1, // 8.4 hours => 1 million tokens
     imageCostTokens: ~~(v8k / (768 * 768) * 258), maxAudioLength: hour(8.4),
     maxAudioPerPrompt: 1, maxFileSize: m(20), maxImagePerPrompt: 3000,
@@ -133,26 +132,27 @@ const GEMINI_RULES = {
 // https://platform.openai.com/docs/models
 // https://cloud.google.com/vertex-ai/docs/generative-ai/learn/models
 const MODELS = {
-    [GPT_4O]: { ...OPENAI_RULES, ...OPENAI_S1 },
-    [GPT_45]: { ...OPENAI_RULES, ...OPENAI_S1 },
-    [GPT_O1]: { ...OPENAI_RULES, ...OPENAI_S2, reasoning: true },
-    [GPT_O3_MINI]: {
-        ...OPENAI_RULES, ...OPENAI_S2,
-        fast: true, reasoning: true, vision: GPT_O1,
-    },
+    [GPT_4O]: { ...OPENAI_RULES, ...OPENAI_S1, defaultProvider: null },
+    [GPT_41]: { ...OPENAI_RULES, ...OPENAI_S1, fast: true, finetune: true },
+    [GPT_O3]: { ...OPENAI_RULES, ...OPENAI_S2, reasoning: true },
     [GEMINI_20_FLASH]: {
-        ...GEMINI_RULES, contextWindow: m(1), maxOutputTokens: k(8),
-        fast: true, json: true, tools: true,
+        ...GEMINI_RULES, maxOutputTokens: k(8),
+        fast: true, image: true, tools: false,
+    },
+    [GEMINI_25_FLASH]: {
+        ...GEMINI_RULES, maxOutputTokens: k(64),
+        fast: true, reasoning: true, tools: true,
     },
     [GEMINI_25_PRO]: {
-        ...GEMINI_RULES, contextWindow: m(1), maxOutputTokens: k(64),
-        json: true, reasoning: true, tools: true,
+        ...GEMINI_RULES, maxOutputTokens: k(64),
+        reasoning: true, tools: true,
     },
     [GEMMA_3_27B]: {
         contextWindow: kT(128), maxOutputTokens: k(8),
         imageCostTokens: 256, maxImageSize: 896 * 896,
         supportedMimeTypes: [png, jpeg, gif],
-        fast: true, json: true, vision: true, defaultProvider: GEMINI,
+        fast: true, json: true, vision: true,
+        defaultProvider: OLLAMA,
     },
     [JINA_DEEPSEARCH]: {
         contextWindow: Infinity, maxInputTokens: Infinity,
@@ -202,27 +202,18 @@ for (const n in MODELS) {
     }
 }
 
-MODELS[GEMINI_20_FLASH].image = GEMINI_20_FLASH_EXP;
-MODELS[GEMINI_20_FLASH_EXP] = {
-    ...MODELS[GEMINI_20_FLASH],
-    name: GEMINI_20_FLASH_EXP, image: true, tools: false,
-};
-MODELS[GEMMA327B] = { // Ollama Alias
-    ...MODELS[GEMMA_3_27B], name: GEMMA327B, defaultProvider: OLLAMA
-};
-
 // Default models for each provider
 const DEFAULT_MODELS = {
-    [OPENAI]: GPT_4O,
+    [OPENAI]: GPT_41,
     [AZURE_OPENAI]: GPT_4O,
     [SILICONFLOW]: SF_DEEPSEEK_V3,
-    [GEMINI]: GEMINI_20_FLASH,
+    [GEMINI]: GEMINI_25_FLASH,
     [ANTHROPIC]: CLOUD_37_SONNET,
     [VERTEX_ANTHROPIC]: CLOUD_37_SONNET,
     [JINA]: JINA_DEEPSEARCH,
-    [OLLAMA]: GEMMA327B,
+    [OLLAMA]: GEMMA_3_27B,
     [OPENAI_VOICE]: NOVA,
-    [OPENAI_TRAINING]: GPT_4O, // https://platform.openai.com/docs/guides/fine-tuning
+    [OPENAI_TRAINING]: GPT_41, // https://platform.openai.com/docs/guides/fine-tuning
 };
 
 const DEFAULT_EMBEDDING = {
@@ -238,7 +229,7 @@ const PROVIDER_ICONS = {
 };
 
 const FEATURE_ICONS = {
-    audio: '📣', deepsearch: '🔍', fast: '⚡️', image: '🎨',
+    audio: '📣', deepsearch: '🔍', fast: '⚡️', finetune: '🔧', image: '🎨',
     json: '📊', reasoning: '🧠', tools: '🧰', vision: '👁️',
 };
 
@@ -815,7 +806,7 @@ const buildPrompts = async (model, input, options = {}) => {
             break;
         case GEMINI:
             const _role = {
-                role: [GEMINI_20_FLASH_EXP, GEMMA_3_27B].includes(options.model)
+                role: [GEMINI_20_FLASH].includes(options.model)
                     ? user : system
             };
             systemPrompt = buildGeminiHistory(options.systemPrompt, _role);
@@ -859,7 +850,6 @@ const buildPrompts = async (model, input, options = {}) => {
                 break;
             case GEMINI:
                 history.push(
-                    ...options.model === GEMMA_3_27B ? [systemPrompt] : [],
                     ...options.toolsResult?.length ? [
                         buildGeminiHistory(content, { ...options, role: user }),
                         ...options.toolsResult.slice(0, options.toolsResult.length - 1)
@@ -878,7 +868,7 @@ const buildPrompts = async (model, input, options = {}) => {
         } // @todo: audioCostTokens (needs to calculate the audio length):
     }, model.maxInputTokens - options.attachments?.length * model.imageCostTokens);
     if ([OPENAI].includes(options.flavor)
-        || [GEMINI_20_FLASH_EXP, GEMMA_3_27B].includes(options.model)) {
+        || [GEMINI_20_FLASH].includes(options.model)) {
         systemPrompt = null;
     }
     return { systemPrompt, history, prompt };
@@ -1186,7 +1176,7 @@ const promptGemini = async (aiId, content, options = {}) => {
             systemInstruction, responseModalities: options.modalities || (
                 options.imageMode ? [TEXT, IMAGE] : undefined
             ), ...options?.config || {}, ...model?.tools && !options.jsonMode
-                && options.model !== GEMINI_20_FLASH_EXP ? (options.tools ?? {
+                && options.model !== GEMINI_20_FLASH ? (options.tools ?? {
                     tools: [
                         // @todo: Gemini will failed when using these tools together.
                         // https://ai.google.dev/gemini-api/docs/function-calling
@@ -1538,10 +1528,10 @@ export {
     FEATURE_ICONS,
     FUNCTION,
     GEMINI_20_FLASH,
-    GPT_45,
+    GEMINI_25_FLASH,
+    GPT_41,
     GPT_4O,
-    GPT_O1,
-    GPT_O3_MINI,
+    GPT_O3,
     INSTRUCTIONS,
     MODELS,
     OPENAI_VOICE,

package/lib/image.mjs

@@ -3,10 +3,12 @@ import { MIME_PNG, convert } from './storage.mjs';
 
 const _NEED = ['OpenAI'];
 
-const [clients, OPENAI, GEMINI, BASE64, BUFFER, ERROR_GENERATING, IMAGEN_MODEL]
-    = [
+const [
+    clients, OPENAI, GEMINI, BASE64, BUFFER, ERROR_GENERATING, IMAGEN_MODEL,
+    OPENAI_MODEL,
+] = [
         {}, 'OPENAI', 'GEMINI', 'BASE64', 'BUFFER', 'Error generating image.',
-        'imagen-3.0-generate-002',
+        'imagen-3.0-generate-002', 'gpt-image-1',
     ];
 
 const init = async (options) => {
@@ -36,6 +38,7 @@ const generate = async (prompt, options) => {
     if (!provider && clients?.[GEMINI]) { provider = GEMINI; }
     if (!provider && clients?.[OPENAI]) { provider = OPENAI; }
     const client = clients?.[provider];
+    const n = options?.n || 4;
     assert(client, 'No available image generation provider.');
     prompt = ensureString(prompt);
     assert(prompt.length <= 4000,
@@ -46,20 +49,18 @@ const generate = async (prompt, options) => {
                 ...options || {},
                 expected: ensureString(options?.expected || BUFFER, { case: 'LOW' }),
             };
-            const asUrl = options.expected === 'url';
-            try {
+            try { // https://platform.openai.com/docs/guides/image-generation?image-generation-model=gpt-image-1
                 var resp = await client.generate({
-                    prompt, model: 'dall-e-3', n: 1, quality: 'hd',
-                    response_format: asUrl ? 'url' : 'b64_json',
-                    size: '1792x1024', // 1024x1024, 1792x1024, or 1024x1792
-                    // style: 'vivid', // or 'natural'
-                    // user: '',
+                    prompt, model: OPENAI_MODEL, n, quality: 'high',
+                    size: '1536x1024', moderation: 'low',
+                    // 1024x1024 (square), 1536x1024 (landscape), 1024x1536 (portrait), auto (default)
+                    // background: 'transparent',
                     ...options?.params || {},
                 });
             } catch (err) { throwError(err?.message || ERROR_GENERATING); }
-            if (!options?.raw && !asUrl) {
+            if (!options?.raw) {
                 resp.data = await Promise.all(resp.data.map(async x => ({
-                    caption: x.revised_prompt, tts: x.revised_prompt,
+                    caption: `🎨 by ${OPENAI_MODEL}`,
                     data: await extractImage(x.b64_json, options),
                     mimeType: MIME_PNG,
                 })));
@@ -73,7 +74,7 @@ const generate = async (prompt, options) => {
                 method: 'POST', headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({
                     instances: [{ prompt }], parameters: {
-                        sampleCount: 4, aspectRatio: '16:9',
+                        sampleCount: n, aspectRatio: '16:9',
                         ...options?.params || {},
                     }, // "1:1" (default), "3:4", "4:3", "9:16", and "16:9"
                 })
@@ -82,7 +83,7 @@ const generate = async (prompt, options) => {
             if (!options?.raw) {
                 resp = await Promise.all((resp?.predictions || []).map(
                     async x => ({
-                        caption: `🎨 by ${IMAGEN_MODEL}`, tts: null,
+                        caption: `🎨 by ${IMAGEN_MODEL}`,
                         data: await extractImage(x.bytesBase64Encoded, options),
                         mimeType: x.mimeType,
                     })

package/lib/manifest.mjs

@@ -1,7 +1,7 @@
 const manifest = {
     "name": "utilitas",
     "description": "Just another common utility for JavaScript.",
-    "version": "1999.1.51",
+    "version": "1999.1.53",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",
@@ -19,56 +19,56 @@ const manifest = {
         "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.1/xlsx-0.20.1.tgz"
     },
     "dependencies": {
-        "file-type": "^20.4.1",
-        "mathjs": "^14.3.1",
+        "file-type": "^20.5.0",
+        "mathjs": "^14.4.0",
         "uuid": "^11.1.0"
     },
     "devDependencies": {
-        "@anthropic-ai/sdk": "^0.39.0",
+        "@anthropic-ai/sdk": "^0.40.1",
         "@anthropic-ai/vertex-sdk": "^0.7.0",
         "@ffmpeg-installer/ffmpeg": "^1.1.0",
         "@ffprobe-installer/ffprobe": "^2.1.2",
-        "@google-cloud/speech": "^7.0.0",
-        "@google-cloud/storage": "^7.15.2",
-        "@google-cloud/text-to-speech": "^6.0.0",
-        "@google-cloud/vision": "^5.0.0",
-        "@google/genai": "^0.4.0",
+        "@google-cloud/speech": "^7.0.1",
+        "@google-cloud/storage": "^7.16.0",
+        "@google-cloud/text-to-speech": "^6.0.1",
+        "@google-cloud/vision": "^5.1.0",
+        "@google/genai": "^0.10.0",
         "@mozilla/readability": "github:mozilla/readability",
-        "@sentry/node": "^9.6.0",
-        "@sentry/profiling-node": "^9.6.0",
+        "@sentry/node": "^9.15.0",
+        "@sentry/profiling-node": "^9.15.0",
         "acme-client": "^5.4.0",
         "browserify-fs": "^1.0.0",
         "buffer": "^6.0.3",
         "fast-geoip": "^1.1.88",
         "fluent-ffmpeg": "^2.1.3",
         "form-data": "^4.0.2",
-        "ioredis": "^5.6.0",
-        "js-tiktoken": "^1.0.19",
-        "jsdom": "^26.0.0",
+        "ioredis": "^5.6.1",
+        "js-tiktoken": "^1.0.20",
+        "jsdom": "^26.1.0",
         "lorem-ipsum": "^2.0.8",
         "mailgun.js": "^12.0.1",
         "mailparser": "^3.7.2",
-        "mime": "^4.0.6",
-        "mysql2": "^3.13.0",
+        "mime": "^4.0.7",
+        "mysql2": "^3.14.1",
         "node-mailjet": "^6.0.8",
         "node-polyfill-webpack-plugin": "^4.1.0",
         "office-text-extractor": "^3.0.3",
-        "openai": "^4.87.4",
-        "pdfjs-dist": "^5.0.375",
-        "pg": "^8.14.1",
+        "openai": "^4.96.2",
+        "pdfjs-dist": "^5.2.133",
+        "pg": "^8.15.6",
         "pgvector": "^0.2.0",
         "ping": "^0.4.4",
         "process": "^0.11.10",
-        "puppeteer": "^24.4.0",
+        "puppeteer": "^24.7.2",
         "say": "^0.16.0",
         "telegraf": "^4.16.3",
         "telesignsdk": "^3.0.2",
-        "tesseract.js": "^6.0.0",
-        "twilio": "^5.5.0",
+        "tesseract.js": "^6.0.1",
+        "twilio": "^5.5.2",
         "url": "github:Leask/node-url",
         "webpack-cli": "^6.0.1",
         "whisper-node": "^1.1.1",
-        "wrangler": "^4.1.0",
+        "wrangler": "^4.14.0",
         "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.1/xlsx-0.20.1.tgz",
         "youtube-transcript": "^1.2.1"
     }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "utilitas",
     "description": "Just another common utility for JavaScript.",
-    "version": "1999.1.51",
+    "version": "1999.1.53",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",
@@ -30,56 +30,56 @@
         "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.1/xlsx-0.20.1.tgz"
     },
     "dependencies": {
-        "file-type": "^20.4.1",
-        "mathjs": "^14.3.1",
+        "file-type": "^20.5.0",
+        "mathjs": "^14.4.0",
         "uuid": "^11.1.0"
     },
     "devDependencies": {
-        "@anthropic-ai/sdk": "^0.39.0",
+        "@anthropic-ai/sdk": "^0.40.1",
         "@anthropic-ai/vertex-sdk": "^0.7.0",
         "@ffmpeg-installer/ffmpeg": "^1.1.0",
         "@ffprobe-installer/ffprobe": "^2.1.2",
-        "@google-cloud/speech": "^7.0.0",
-        "@google-cloud/storage": "^7.15.2",
-        "@google-cloud/text-to-speech": "^6.0.0",
-        "@google-cloud/vision": "^5.0.0",
-        "@google/genai": "^0.4.0",
+        "@google-cloud/speech": "^7.0.1",
+        "@google-cloud/storage": "^7.16.0",
+        "@google-cloud/text-to-speech": "^6.0.1",
+        "@google-cloud/vision": "^5.1.0",
+        "@google/genai": "^0.10.0",
         "@mozilla/readability": "github:mozilla/readability",
-        "@sentry/node": "^9.6.0",
-        "@sentry/profiling-node": "^9.6.0",
+        "@sentry/node": "^9.15.0",
+        "@sentry/profiling-node": "^9.15.0",
         "acme-client": "^5.4.0",
         "browserify-fs": "^1.0.0",
         "buffer": "^6.0.3",
         "fast-geoip": "^1.1.88",
         "fluent-ffmpeg": "^2.1.3",
         "form-data": "^4.0.2",
-        "ioredis": "^5.6.0",
-        "js-tiktoken": "^1.0.19",
-        "jsdom": "^26.0.0",
+        "ioredis": "^5.6.1",
+        "js-tiktoken": "^1.0.20",
+        "jsdom": "^26.1.0",
         "lorem-ipsum": "^2.0.8",
         "mailgun.js": "^12.0.1",
         "mailparser": "^3.7.2",
-        "mime": "^4.0.6",
-        "mysql2": "^3.13.0",
+        "mime": "^4.0.7",
+        "mysql2": "^3.14.1",
         "node-mailjet": "^6.0.8",
         "node-polyfill-webpack-plugin": "^4.1.0",
         "office-text-extractor": "^3.0.3",
-        "openai": "^4.87.4",
-        "pdfjs-dist": "^5.0.375",
-        "pg": "^8.14.1",
+        "openai": "^4.96.2",
+        "pdfjs-dist": "^5.2.133",
+        "pg": "^8.15.6",
         "pgvector": "^0.2.0",
         "ping": "^0.4.4",
         "process": "^0.11.10",
-        "puppeteer": "^24.4.0",
+        "puppeteer": "^24.7.2",
         "say": "^0.16.0",
         "telegraf": "^4.16.3",
         "telesignsdk": "^3.0.2",
-        "tesseract.js": "^6.0.0",
-        "twilio": "^5.5.0",
+        "tesseract.js": "^6.0.1",
+        "twilio": "^5.5.2",
         "url": "github:Leask/node-url",
         "webpack-cli": "^6.0.1",
         "whisper-node": "^1.1.1",
-        "wrangler": "^4.1.0",
+        "wrangler": "^4.14.0",
         "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.1/xlsx-0.20.1.tgz",
         "youtube-transcript": "^1.2.1"
     }