@stabgan/openrouter-mcp-multimodal 4.5.1 → 4.6.0

package/dist/tool-handlers.js

@@ -14,6 +14,11 @@ import { handleAnalyzeVideo } from './tool-handlers/analyze-video.js';
 import { handleGenerateVideo, handleGetVideoStatus, handleGenerateVideoFromImage, } from './tool-handlers/generate-video.js';
 import { handleRerankDocuments } from './tool-handlers/rerank.js';
 import { handleHealthCheck } from './tool-handlers/health-check.js';
+import { handleGenerateImageDedicated, } from './tool-handlers/generate-image-dedicated.js';
+import { handleTextToSpeech } from './tool-handlers/text-to-speech.js';
+import { handleSpeechToText } from './tool-handlers/speech-to-text.js';
+import { handleStartChatCompletion, handleGetChatCompletionStatus, } from './tool-handlers/async-chat.js';
+import { TOOL_DESCRIPTIONS } from './tool-descriptions.js';
 function wrapToolArgs(a) {
     return { params: { arguments: a ?? {} } };
 }
@@ -49,124 +54,9 @@ function buildProgressHook(server, progressToken) {
     };
 }
 function extractProgressToken(req) {
-    const meta = req?.params
-        ?._meta;
+    const meta = req?.params?._meta;
     return meta?.progressToken;
 }
-// ---------------------------------------------------------------------------
-// Tool descriptions include explicit "Fails when" and "Works with" sections
-// per arxiv 2602.18764 (Schema-Guided Dialogue / MCP convergence). Explicit
-// failure-mode documentation reduces misrouted calls and helps the model
-// pick the right recovery path after an error.
-const TOOL_DESCRIPTIONS = {
-    chat_completion: 'Send messages to an OpenRouter model and get a text response. Supports provider routing ' +
-        '(quantizations / ignore / sort / order / require_parameters / data_collection / allow_fallbacks), ' +
-        'model variant suffixes (`:nitro` fastest, `:floor` cheapest, `:exacto` tool-calling accuracy), ' +
-        'reasoning token passthrough, web search, and response caching.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: messages array is empty\n' +
-        '- UPSTREAM_REFUSED: provider rejected the request (credits, content policy, or rate limit)\n' +
-        '- UPSTREAM_TIMEOUT: upstream did not respond within the SDK timeout\n' +
-        '- MODEL_NOT_FOUND: model slug does not exist on OpenRouter\n\n' +
-        'Works with: validate_model (pre-flight model id check), search_models (discover models).',
-    analyze_image: 'Analyze an image with a vision model. Accepts local file paths, http(s) URLs, or base64 data URLs. ' +
-        'Output is model-generated and tagged `_meta.content_is_untrusted: true`.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: image_path missing or malformed\n' +
-        '- UNSAFE_PATH: local path escaped the sandbox\n' +
-        '- RESOURCE_TOO_LARGE: image exceeded configured fetch size cap\n' +
-        '- UPSTREAM_REFUSED: provider SSRF guard blocked the URL or content policy rejected\n\n' +
-        'Works with: search_models (find vision-capable models), generate_image (follow-up creation).',
-    analyze_audio: 'Transcribe or analyze an audio file (WAV / MP3 / FLAC / OGG / etc.) using a multimodal model. ' +
-        'Output is tagged `_meta.content_is_untrusted: true`.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: audio_path missing\n' +
-        '- UNSUPPORTED_FORMAT: decoder could not identify the file as audio\n' +
-        '- RESOURCE_TOO_LARGE: input exceeded size cap\n' +
-        '- UPSTREAM_REFUSED: blocked host or content policy\n\n' +
-        'Works with: generate_audio (text-to-speech follow-up).',
-    analyze_video: 'Describe or analyze a video (mp4 / mpeg / mov / webm) using a multimodal model. Default model: ' +
-        'google/gemini-2.5-flash. Output is tagged `_meta.content_is_untrusted: true`.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: video_path missing\n' +
-        '- UNSUPPORTED_FORMAT: not a recognized video container\n' +
-        '- RESOURCE_TOO_LARGE: exceeds fetch cap\n' +
-        '- UPSTREAM_REFUSED: SSRF block or provider refusal\n\n' +
-        'Works with: generate_video (text-to-video), get_video_status (poll async jobs).',
-    search_models: 'Search OpenRouter\'s model catalog by name, provider, or capability. Returns a paginated list; ' +
-        'use `offset` / `limit` / `next_offset` to page through.\n\n' +
-        'Fails when:\n' +
-        '- UPSTREAM_HTTP: /models endpoint returned an error\n' +
-        '- UPSTREAM_REFUSED: invalid API key\n\n' +
-        'Works with: validate_model, get_model_info.',
-    get_model_info: 'Get pricing / context-length / capability details for a specific model id.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: model not provided\n' +
-        '- MODEL_NOT_FOUND: model slug does not exist\n' +
-        '- UPSTREAM_HTTP: model list fetch failed\n\n' +
-        'Works with: search_models (discover ids), validate_model (cheap existence check).',
-    validate_model: 'Check whether a model id exists on OpenRouter. Cheap boolean lookup against the cached catalog.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: model not provided\n' +
-        '- UPSTREAM_HTTP: catalog refresh failed\n\n' +
-        'Works with: get_model_info (detailed lookup), chat_completion (pre-flight validation).',
-    generate_image: 'Generate an image from a text prompt. Optional reference images condition the output for style / ' +
-        'identity consistency. Default model: google/gemini-2.5-flash-image.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: prompt empty, bad aspect_ratio / image_size, unreadable reference image\n' +
-        '- UNSAFE_PATH: save_path or input_images path escaped the sandbox\n' +
-        '- UPSTREAM_REFUSED: provider content policy rejected or insufficient credits\n' +
-        '- MODEL_NOT_FOUND: model slug invalid\n\n' +
-        'Works with: analyze_image (verify the result), generate_video_from_image (next step in workflow).',
-    generate_audio: 'Generate audio (speech / music) from a text prompt. Format auto-detected, extension auto-corrected.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: prompt empty\n' +
-        '- UNSAFE_PATH: save_path escaped the sandbox\n' +
-        '- UPSTREAM_REFUSED: content policy or credit issues\n\n' +
-        'Works with: analyze_audio (verify the result).',
-    generate_video: 'Generate a video from a text prompt (optionally conditioned on first/last-frame or reference images). ' +
-        'Submits an async job, polls until completion or max_wait_ms, and downloads the result. Emits MCP ' +
-        'progress notifications when the client provides a `progressToken`. Default model: google/veo-3.1.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: prompt empty\n' +
-        '- UNSAFE_PATH: save_path or reference image paths escaped the sandbox\n' +
-        '- UPSTREAM_REFUSED: content policy, credits, or bad request\n' +
-        '- JOB_FAILED: provider marked the job as failed\n' +
-        '- UNSUPPORTED_FORMAT: reference/frame image could not be decoded\n\n' +
-        'Returns successfully with `_meta.code: JOB_STILL_RUNNING` (NOT an error) when the timeout ' +
-        'elapses — the response carries `_meta.video_id` so callers can resume via get_video_status.\n\n' +
-        'Works with: get_video_status (resume timed-out jobs), generate_video_from_image (narrower image-to-video variant).',
-    generate_video_from_image: 'Narrower convenience wrapper around generate_video for image-to-video workflows. Takes a single ' +
-        '`image` argument (used as the first frame) and `prompt`. Per arxiv 2511.03497, narrower tools with ' +
-        'fewer parameters improve tool-call hit rate. For last-frame conditioning or reference images, use ' +
-        'generate_video directly.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: image or prompt missing\n' +
-        '- UNSAFE_PATH: image path escaped the sandbox\n' +
-        '- UPSTREAM_REFUSED / JOB_FAILED: same as generate_video\n\n' +
-        'Returns successfully with `_meta.code: JOB_STILL_RUNNING` on timeout (resumable via ' +
-        'get_video_status).\n\n' +
-        'Works with: generate_video (full parameter surface), get_video_status.',
-    get_video_status: 'Poll an async video-generation job by id. Downloads the result when complete (and saves if save_path given).\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: video_id missing\n' +
-        '- UNSAFE_PATH: save_path escaped the sandbox\n' +
-        '- JOB_FAILED: provider marked the job as failed\n\n' +
-        'Returns successfully with `_meta.code: JOB_STILL_RUNNING` (NOT an error) when the job is still ' +
-        'in flight — response carries `_meta.last_status` and `_meta.progress` so callers can retry later.\n\n' +
-        'Works with: generate_video, generate_video_from_image.',
-    rerank_documents: 'Re-order a list of documents by relevance to a query using an OpenRouter reranker. Default model: ' +
-        'cohere/rerank-english-v3.0.\n\n' +
-        'Fails when:\n' +
-        '- INVALID_INPUT: query missing, documents empty, non-string document elements\n' +
-        '- MODEL_NOT_FOUND: reranker model slug does not exist\n' +
-        '- UPSTREAM_HTTP: provider returned an error\n\n' +
-        'Works with: search_models (discover rerankers), chat_completion (answer grounded in top-ranked docs).',
-    health_check: 'Verify API-key validity, OpenRouter reachability, and return server + protocol versions. No args.\n\n' +
-        'Fails when: never returns an error result — always returns `{ ok, api_key_valid, ... }` so ops can ' +
-        'programmatically branch on the payload.\n\n' +
-        'Works with: every other tool (run once at startup to confirm credentials).',
-};
 export class ToolHandlers {
     openai;
     modelCache = ModelCache.getInstance();
@@ -202,8 +92,9 @@ export class ToolHandlers {
                             model: {
                                 type: 'string',
                                 description: 'Model ID (optional, uses default). Append `:nitro` for the fastest variant, ' +
-                                    '`:floor` for the cheapest, or `:exacto` for the best tool-calling accuracy. ' +
-                                    'Example: `openai/gpt-4o:nitro`.',
+                                    '`:floor` for the cheapest, `:free` for the free tier, `:online` for web search, ' +
+                                    'or `:exacto` for the best tool-calling accuracy. ' +
+                                    'Example: `openai/gpt-4o:nitro`. Or pass `online: true` for programmatic web search control.',
                             },
                             messages: {
                                 type: 'array',
@@ -252,11 +143,11 @@ export class ToolHandlers {
                             },
                             include_reasoning: {
                                 type: 'boolean',
-                                description: 'Surface the model\'s chain-of-thought on `_meta.reasoning` for R1 / Opus 4.7 / Gemini Thinking.',
+                                description: "Surface the model's chain-of-thought on `_meta.reasoning` for R1 / Opus 4.7 / Gemini Thinking.",
                             },
                             online: {
                                 type: 'boolean',
-                                description: 'Enable OpenRouter\'s web-search plugin (Exa-backed, $4 / 1000 results).',
+                                description: "Enable OpenRouter's web-search plugin (Exa-backed, $4 / 1000 results).",
                             },
                             web_max_results: {
                                 type: 'number',
@@ -280,6 +171,63 @@ export class ToolHandlers {
                         required: ['messages'],
                     },
                 },
+                {
+                    name: 'start_chat_completion',
+                    description: TOOL_DESCRIPTIONS.start_chat_completion,
+                    annotations: {
+                        title: 'Start async chat completion',
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            model: { type: 'string', description: 'Model ID (same as chat_completion).' },
+                            messages: {
+                                type: 'array',
+                                minItems: 1,
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        role: { type: 'string', enum: ['system', 'user', 'assistant'] },
+                                        content: { oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'object' } }] },
+                                    },
+                                    required: ['role', 'content'],
+                                },
+                            },
+                            temperature: { type: 'number', minimum: 0, maximum: 2 },
+                            max_tokens: { type: 'number', minimum: 1 },
+                            provider: { type: 'object' },
+                            include_reasoning: { type: 'boolean' },
+                            online: { type: 'boolean' },
+                            web_max_results: { type: 'number', minimum: 1 },
+                            cache: { type: 'boolean' },
+                            cache_ttl: { type: 'string' },
+                            cache_clear: { type: 'boolean' },
+                        },
+                        required: ['messages'],
+                    },
+                },
+                {
+                    name: 'get_chat_completion_status',
+                    description: TOOL_DESCRIPTIONS.get_chat_completion_status,
+                    annotations: {
+                        title: 'Get async chat completion status',
+                        readOnlyHint: true,
+                        destructiveHint: false,
+                        idempotentHint: true,
+                        openWorldHint: false,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            job_id: { type: 'string', description: 'The job_id returned by start_chat_completion.' },
+                        },
+                        required: ['job_id'],
+                    },
+                },
                 {
                     name: 'analyze_image',
                     description: TOOL_DESCRIPTIONS.analyze_image,
@@ -293,8 +241,16 @@ export class ToolHandlers {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            image_path: { type: 'string', description: 'File path, URL, or data URL' },
-                            question: { type: 'string', description: 'Question about the image' },
+                            image_path: {
+                                type: 'string',
+                                description: 'Required. Local path (inside OPENROUTER_INPUT_DIR sandbox), https URL, or data URL. ' +
+                                    'Good: `"photo.jpg"`. Bad: `"url": "..."` (wrong key), `"/etc/passwd"` (UNSAFE_PATH).',
+                            },
+                            question: {
+                                type: 'string',
+                                description: 'Optional question about the image. Defaults to "What\'s in this image?" if omitted. ' +
+                                    'Good: `"List all text"`. Bad: using `prompt` key (wrong name for this tool).',
+                            },
                             model: { type: 'string' },
                             cache_input: {
                                 type: 'boolean',
@@ -323,7 +279,8 @@ export class ToolHandlers {
                         properties: {
                             audio_path: {
                                 type: 'string',
-                                description: 'File path, URL, or data URL (base64-encoded audio)',
+                                description: 'Local file path (sandboxed to OPENROUTER_INPUT_DIR / OPENROUTER_OUTPUT_DIR / cwd), ' +
+                                    'http(s) URL, or data URL (base64-encoded audio)',
                             },
                             question: {
                                 type: 'string',
@@ -353,7 +310,8 @@ export class ToolHandlers {
                         properties: {
                             video_path: {
                                 type: 'string',
-                                description: 'File path, HTTP(S) URL, or base64 data URL. Supported: mp4 / mpeg / mov / webm.',
+                                description: 'Local file path (sandboxed to OPENROUTER_INPUT_DIR / OPENROUTER_OUTPUT_DIR / cwd), ' +
+                                    'http(s) URL, or base64 data URL. Supported: mp4 / mpeg / mov / webm.',
                             },
                             question: { type: 'string' },
                             model: { type: 'string' },
@@ -498,6 +456,69 @@ export class ToolHandlers {
                         required: ['prompt'],
                     },
                 },
+                {
+                    name: 'generate_image_dedicated',
+                    description: TOOL_DESCRIPTIONS.generate_image_dedicated,
+                    annotations: {
+                        title: 'Generate image (dedicated API)',
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            prompt: {
+                                type: 'string',
+                                description: 'Text prompt describing the image to generate.',
+                            },
+                            model: {
+                                type: 'string',
+                                description: 'Image model ID. Default: google/gemini-2.5-flash-image. Browse available at https://openrouter.ai/collections/image-models',
+                            },
+                            resolution: {
+                                type: 'string',
+                                enum: ['512', '0.5K', '1K', '2K', '4K'],
+                                description: 'Normalized resolution tier. Provider maps to closest supported size.',
+                            },
+                            aspect_ratio: {
+                                type: 'string',
+                                description: 'Aspect ratio (e.g. "1:1", "16:9", "9:16", "4:3", "21:9").',
+                            },
+                            quality: {
+                                type: 'string',
+                                enum: ['auto', 'low', 'medium', 'high'],
+                                description: 'Image quality level.',
+                            },
+                            output_format: {
+                                type: 'string',
+                                enum: ['png', 'jpeg', 'webp', 'svg'],
+                                description: 'Output image format.',
+                            },
+                            n: {
+                                type: 'number',
+                                minimum: 1,
+                                maximum: 10,
+                                description: 'Number of images to generate (model-dependent, default 1).',
+                            },
+                            input_references: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Reference images for image-to-image workflows. Each entry: local path, http(s) URL, or data URL.',
+                            },
+                            save_path: { type: 'string', description: 'Save generated image to this path.' },
+                            provider: {
+                                type: 'object',
+                                description: 'Provider routing overrides (order, sort, allow_fallbacks, etc.).',
+                            },
+                            cache: { type: 'boolean' },
+                            cache_ttl: { type: 'string' },
+                            cache_clear: { type: 'boolean' },
+                        },
+                        required: ['prompt'],
+                    },
+                },
                 {
                     name: 'generate_audio',
                     description: TOOL_DESCRIPTIONS.generate_audio,
@@ -520,6 +541,97 @@ export class ToolHandlers {
                         required: ['prompt'],
                     },
                 },
+                {
+                    name: 'text_to_speech',
+                    description: TOOL_DESCRIPTIONS.text_to_speech,
+                    annotations: {
+                        title: 'Text to speech (dedicated API)',
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            input: {
+                                type: 'string',
+                                description: 'Text to convert to speech.',
+                            },
+                            model: {
+                                type: 'string',
+                                description: 'TTS model. Default: openai/gpt-4o-mini-tts-2025-12-15. Also: google/gemini-flash-tts, mistral/voxtral-mini-tts.',
+                            },
+                            voice: {
+                                type: 'string',
+                                description: 'Voice ID (model-specific). Default: alloy. OpenAI voices: alloy, echo, fable, onyx, nova, shimmer.',
+                            },
+                            response_format: {
+                                type: 'string',
+                                enum: ['mp3', 'opus', 'aac', 'flac', 'wav', 'pcm'],
+                                description: 'Output audio format. Default: mp3.',
+                            },
+                            speed: {
+                                type: 'number',
+                                minimum: 0.25,
+                                maximum: 4.0,
+                                description: 'Speed of speech (0.25 to 4.0). Default: 1.0.',
+                            },
+                            instructions: {
+                                type: 'string',
+                                description: 'Tone/style instructions (e.g. "speak in a warm, friendly tone"). OpenAI models only.',
+                            },
+                            save_path: { type: 'string', description: 'Save audio to this path.' },
+                            cache: { type: 'boolean' },
+                            cache_ttl: { type: 'string' },
+                            cache_clear: { type: 'boolean' },
+                        },
+                        required: ['input'],
+                    },
+                },
+                {
+                    name: 'speech_to_text',
+                    description: TOOL_DESCRIPTIONS.speech_to_text,
+                    annotations: {
+                        title: 'Speech to text (dedicated API)',
+                        readOnlyHint: true,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: true,
+                    },
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            audio_path: {
+                                type: 'string',
+                                description: 'Audio file: local path (sandboxed), http(s) URL, or base64 data URL. Formats: mp3, wav, flac, ogg, webm, mp4.',
+                            },
+                            model: {
+                                type: 'string',
+                                description: 'STT model. Default: openai/whisper-1. Also: openai/gpt-4o-transcribe, openai/gpt-4o-mini-transcribe.',
+                            },
+                            language: {
+                                type: 'string',
+                                description: 'ISO-639-1 language code (e.g. "en", "es", "fr"). Improves accuracy.',
+                            },
+                            response_format: {
+                                type: 'string',
+                                enum: ['json', 'text', 'srt', 'verbose_json', 'vtt'],
+                                description: 'Output format for transcription. Default: json.',
+                            },
+                            temperature: {
+                                type: 'number',
+                                minimum: 0,
+                                maximum: 1,
+                                description: 'Sampling temperature for transcription (0-1).',
+                            },
+                            cache: { type: 'boolean' },
+                            cache_ttl: { type: 'string' },
+                            cache_clear: { type: 'boolean' },
+                        },
+                        required: ['audio_path'],
+                    },
+                },
                 {
                     name: 'generate_video',
                     description: TOOL_DESCRIPTIONS.generate_video,
@@ -661,7 +773,13 @@ export class ToolHandlers {
                             models_cached: { type: 'number' },
                             error: { type: 'string' },
                         },
-                        required: ['ok', 'server_version', 'protocol_version', 'api_key_valid', 'models_cached'],
+                        required: [
+                            'ok',
+                            'server_version',
+                            'protocol_version',
+                            'api_key_valid',
+                            'models_cached',
+                        ],
                     },
                 },
             ],
@@ -679,6 +797,10 @@ export class ToolHandlers {
                 switch (name) {
                     case 'chat_completion':
                         return handleChatCompletion(wrapToolArgs(args), this.openai, this.defaultModel);
+                    case 'start_chat_completion':
+                        return handleStartChatCompletion(wrapToolArgs(args), this.openai, this.defaultModel);
+                    case 'get_chat_completion_status':
+                        return handleGetChatCompletionStatus(wrapToolArgs(args));
                     case 'analyze_image':
                         return handleAnalyzeImage(wrapToolArgs(args), this.openai, this.defaultModel);
                     case 'analyze_audio':
@@ -693,8 +815,14 @@ export class ToolHandlers {
                         return handleValidateModel(wrapToolArgs(args), this.modelCache, this.apiClient);
                     case 'generate_image':
                         return handleGenerateImage(wrapToolArgs(args), this.openai);
+                    case 'generate_image_dedicated':
+                        return handleGenerateImageDedicated(wrapToolArgs(args), this.apiClient);
                     case 'generate_audio':
                         return handleGenerateAudio(wrapToolArgs(args), this.openai);
+                    case 'text_to_speech':
+                        return handleTextToSpeech(wrapToolArgs(args), this.apiClient);
+                    case 'speech_to_text':
+                        return handleSpeechToText(wrapToolArgs(args), this.apiClient);
                     case 'generate_video':
                         return handleGenerateVideo(wrapToolArgs(args), this.apiClient, buildProgressHook(this.server, extractProgressToken(request)));
                     case 'generate_video_from_image':

package/dist/version.d.ts

@@ -6,7 +6,7 @@
  * Bumped in lockstep with package.json / server.json / smithery.yaml /
  * scripts/build-manifest.mjs during release prep.
  */
-export declare const SERVER_VERSION = "4.5.1";
+export declare const SERVER_VERSION = "4.6.0";
 /**
  * MCP protocol version our SDK speaks. Hardcoded to match the version
  * bundled with `@modelcontextprotocol/sdk`; update when upgrading the

package/dist/version.js

@@ -6,7 +6,7 @@
  * Bumped in lockstep with package.json / server.json / smithery.yaml /
  * scripts/build-manifest.mjs during release prep.
  */
-export const SERVER_VERSION = '4.5.1';
+export const SERVER_VERSION = '4.6.0';
 /**
  * MCP protocol version our SDK speaks. Hardcoded to match the version
  * bundled with `@modelcontextprotocol/sdk`; update when upgrading the

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stabgan/openrouter-mcp-multimodal",
-  "version": "4.5.1",
+  "version": "4.6.0",
   "mcpName": "io.github.stabgan/openrouter-multimodal",
-  "description": "MCP server for OpenRouter with text chat, image analysis + generation, audio analysis + generation, video analysis, and video generation (Veo 3.1 / Sora 2 Pro / Seedance / Wan)",
+  "description": "MCP server for OpenRouter — chat with 300+ LLMs, analyze images/audio/video, generate images (dedicated API), TTS/STT, video generation (Veo 3.1 / Seedance / Wan), async completions, response caching",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -19,8 +19,18 @@
     "lint": "eslint src",
     "format": "prettier --write \"src/**/*.ts\" *.json \"*.md\"",
     "format:check": "prettier --check \"src/**/*.ts\"",
-    "test": "node --experimental-vm-modules node_modules/.bin/vitest run",
-    "test:integration": "node --experimental-vm-modules node_modules/.bin/vitest run --config vitest.integration.config.ts"
+    "test": "vitest run",
+    "test:regression": "vitest run --config vitest.regression.config.ts",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:e2e": "npm run build && node scripts/live-e2e.mjs",
+    "test:smoke:npm": "npm run build && npm pack --quiet && node scripts/smoke-npm-mcp.mjs",
+    "test:smoke:docker": "node scripts/smoke-docker-mcp.mjs",
+    "test:smoke:uvx": "node scripts/smoke-uvx-mcp.mjs",
+    "test:smoke:uvx:local": "npm run build && npm pack --quiet && MCP_UVX_LOCAL=1 node scripts/smoke-uvx-mcp.mjs",
+    "test:smoke:uvx:git": "MCP_UVX_FROM_GIT=1 node scripts/smoke-uvx-mcp.mjs",
+    "test:smoke": "npm run test:smoke:npm && npm run test:smoke:docker && npm run test:smoke:uvx:local",
+    "test:all": "npm test && npm run test:regression && npm run test:integration",
+    "ci": "npm run lint && npm run format:check && npm run build && npm run test:all"
   },
   "keywords": [
     "mcp",
@@ -44,23 +54,25 @@
   "homepage": "https://github.com/stabgan/openrouter-mcp-multimodal#readme",
   "license": "Apache-2.0",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "dotenv": "^16.4.7",
-    "openai": "^4.89.1",
-    "sharp": "^0.33.5"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "dotenv": "^17.4.2",
+    "openai": "^4.104.0",
+    "sharp": "^0.35.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
-    "@types/node": "^22.13.14",
+    "@types/node": "^22.20.0",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
-    "prettier": "^3.7.4",
-    "shx": "^0.3.4",
-    "typescript": "^5.8.2",
-    "typescript-eslint": "^8.53.0",
-    "vitest": "^3.1.1"
+    "form-data": "^4.0.6",
+    "js-yaml": "^4.3.0",
+    "prettier": "^3.9.4",
+    "shx": "^0.4.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.62.1",
+    "vitest": "^4.1.9"
   }
 }