video-context-mcp-server 1.2.3 → 1.3.0

package/README.md

@@ -14,8 +14,8 @@ An MCP server that gives coding assistants (GitHub Copilot, Cursor, Claude Code)
 - 📊 **Video Metadata** — Get duration, resolution, fps, codec, and other technical details
 - 🎙️ **Audio Transcription** — Transcribe speech with paragraph-level timestamps (`[MM:SS]`) or export as SRT/VTT subtitles and JSON using Deepgram, AssemblyAI, Groq/Whisper, or Gemini
 - 🔊 **Speaker Diarization** — Identify who said what (Deepgram and AssemblyAI)
-- 🔊 **Audio-Enhanced Analysis** — Auto-transcribes audio and injects transcripts into AI prompts for richer results (GLM/Kimi/Qwen)
-- 🔄 **Multi-Provider Support** — Choose between GLM-4.6V, Qwen3.7, Kimi K2.6, Gemini, or MiMo-V2.5
+- 🔊 **Audio-Enhanced Analysis** — Auto-transcribes audio and injects transcripts into AI prompts for richer results (all non-Gemini video providers: GLM, MiniMax-M3, Kimi, Qwen, MiMo)
+- 🔄 **Multi-Provider Support** — Choose between GLM-4.6V, Qwen3.7, Kimi K2.6, Gemini, MiMo-V2.5, or MiniMax-M3
 - 🎯 **Smart Video Handling** — Extracts keyframes from long videos to reduce token usage
 - 🗣️ **Text-to-Speech** ⚠️ _Experimental_ — Convert text to natural speech audio (MiniMax TTS)
 - 🖼️ **Image Generation** ⚠️ _Experimental_ — Generate images from text prompts (MiniMax image-01)
@@ -411,7 +411,7 @@ If you need a MiniMax API key, get it from the [MiniMax interface key page](http
 
 ### Video Providers
 
-Set all keys to get the full fallback chain. The server will try Gemini first, then GLM, then Qwen, then Kimi, then MiMo, so having all keys ensures it never gets stuck without a working provider:
+Set all keys to get the full fallback chain. The server will try Gemini first, then MiniMax-M3, then Kimi, then Qwen, then MiMo, then GLM last (the free tier is aggressively rate-limited, so GLM is the last-resort fallback), so having all keys ensures it never gets stuck without a working provider:
 
 | Provider                                  | Key                 | Link                                                                                          |
 | ----------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------- |
@@ -420,14 +420,16 @@ Set all keys to get the full fallback chain. The server will try Gemini first, t
 | **Qwen3.7** (paid)                        | `DASHSCOPE_API_KEY` | [Get key](https://modelstudio.console.alibabacloud.com/ap-southeast-1?tab=dashboard#/api-key) |
 | **Kimi K2.6** (paid)                      | `MOONSHOT_API_KEY`  | [Get key](https://platform.kimi.ai)                                                           |
 | **MiMo-V2.5** (paid)                      | `MIMO_API_KEY`      | [Get key](https://platform.xiaomimimo.com/#/console/api-keys)                                 |
+| **MiniMax-M3** (paid)                     | `MINIMAX_API_KEY`   | [Get key](https://platform.minimax.io/user-center/basic-information/interface-key)            |
 
-When a provider's API key is missing or its API call fails at runtime, tools automatically fall back through the remaining providers in priority order, starting from the configured default:
+When a provider's API key is missing or its API call fails at runtime, tools automatically fall back through the remaining providers in priority order, starting from the configured default. **GLM is last in the chain** — its free tier applies aggressive rate-limit throttling, so all other providers are preferred when their keys are available. **Kimi is placed ahead of Qwen** because Kimi accepts native file upload up to 100 MB, so large local videos work out-of-the-box without setting up the optional S3 relay (which most users skip):
 
-- Gemini default (standard): **Gemini → GLM → Qwen → Kimi → MiMo**
-- GLM default: **GLM → Gemini → Qwen → Kimi → MiMo**
-- Qwen default: **Qwen → Gemini → GLM → Kimi → MiMo**
-- Kimi default: **Kimi → Gemini → GLM → Qwen → MiMo**
-- MiMo default: **MiMo → Gemini → GLM → Qwen → Kimi**
+- Gemini default (standard): **Gemini → MiniMax-M3 → Kimi → Qwen → MiMo → GLM**
+- MiniMax-M3 default: **MiniMax-M3 → Gemini → Kimi → Qwen → MiMo → GLM**
+- Kimi default: **Kimi → Gemini → MiniMax-M3 → Qwen → MiMo → GLM**
+- Qwen default: **Qwen → Gemini → MiniMax-M3 → Kimi → MiMo → GLM**
+- MiMo default: **MiMo → Gemini → MiniMax-M3 → Kimi → Qwen → GLM**
+- GLM default: **GLM → Gemini → MiniMax-M3 → Kimi → Qwen → MiMo**
 
 ### Audio Providers
 
@@ -448,17 +450,17 @@ When an audio key is missing or an audio API call fails at runtime, tools automa
 
 ### Video Providers
 
-| Feature        | Gemini 3.5 Flash (default)                     | GLM-4.6V                                               | Qwen3.7                                                | Kimi K2.6                                      | MiMo-V2.5                                              |
-| -------------- | ---------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------ | ---------------------------------------------- | ------------------------------------------------------ |
-| Price          | Free tier available                            | Free tier available (GLM-4.6V-Flash)                   | $0.50 input / $3.00 output per 1M tokens               | $0.60 input / $3.00 output per 1M tokens       | $0.40 input / $2.00 output per 1M tokens               |
-| Video formats  | mp4, mpeg, mov, avi, flv, mpg, webm, wmv, 3gpp | mp4, avi, mov, wmv, webm, m4v                          | mp4, avi, mov, wmv, webm, m4v                          | mp4, mpeg, mov, avi, flv, mpg, webm, wmv, 3gpp | mp4, mov, avi, wmv                                     |
-| Context window | 1M tokens                                      | 128K tokens                                            | 1M tokens                                              | 256K tokens                                    | 256K tokens                                            |
-| Max file size  | 2 GB                                           | ~12 MB base64 / frames fallback / **unlimited w/ S3↓** | ~10 MB base64 / frames fallback / **unlimited w/ S3↓** | 100 MB                                         | ~10 MB base64 / frames fallback / **unlimited w/ S3↓** |
-| Best for       | **Default** — free, no card required           | Free, no card required                                 | SOTA agentic coding                                    | Paid — broadest format support                 | Paid — thinking mode; multimodal                       |
+| Feature        | Gemini 3.5 Flash (default)                     | GLM-4.6V                                               | Qwen3.7                                                | Kimi K2.6                                      | MiMo-V2.5                                              | MiniMax-M3                                                                                             |
+| -------------- | ---------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------ | ---------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
+| Price          | Free tier available                            | Free tier available (GLM-4.6V-Flash)                   | $0.50 input / $3.00 output per 1M tokens               | $0.60 input / $3.00 output per 1M tokens       | $0.40 input / $2.00 output per 1M tokens               | **$0.30 / $1.20** (effective; permanent 50% off) ≤512K                                                 |
+| Video formats  | mp4, mpeg, mov, avi, flv, mpg, webm, wmv, 3gpp | mp4, avi, mov, wmv, webm, m4v                          | mp4, avi, mov, wmv, webm, m4v                          | mp4, mpeg, mov, avi, flv, mpg, webm, wmv, 3gpp | mp4, mov, avi, wmv                                     | mp4, mov, avi, etc. (image frames; ≤100 per request)                                                   |
+| Context window | 1M tokens                                      | 128K tokens                                            | 1M tokens                                              | 256K tokens                                    | 256K tokens                                            | **1M tokens** (built for long-video understanding)                                                     |
+| Max file size  | 2 GB                                           | ~12 MB base64 / frames fallback / **unlimited w/ S3↓** | ~10 MB base64 / frames fallback / **unlimited w/ S3↓** | 100 MB                                         | ~10 MB base64 / frames fallback / **unlimited w/ S3↓** | 100 MB image batch budget / frames fallback                                                            |
+| Best for       | **Default** — free, no card required           | Free, no card required                                 | SOTA agentic coding                                    | Paid — broadest format support                 | Paid — thinking mode; multimodal                       | Paid — **best for long videos** (1M context, 100-frame budget, prompt caching 5× cheaper on follow-up) |
 
-**Gemini 3.5 Flash** is the default — it offers a free tier with no credit card required, 1M context window, and 2 GB file support. **GLM-4.6V** is the second fallback — also free with no card required. **Qwen3.7** is a paid provider at $0.50 input / $3.00 output per 1M tokens with SOTA agentic coding performance. **Kimi K2.6** is a paid provider with the broadest video format support. **MiMo-V2.5** is Xiaomi's multimodal model with thinking mode support ($0.40 input / $2.00 output per 1M tokens).
+**Gemini 3.5 Flash** is the default — it offers a free tier with no credit card required, 1M context window, and 2 GB file support. **MiniMax-M3** is the second fallback — paid, but has the largest context window (1M tokens) and 100-image-per-request budget, making it the best long-video fallback. **Kimi K2.6** is the third fallback — paid, with native file upload up to 100 MB so large local videos work without S3 relay. **Qwen3.7** is the fourth fallback — paid at $0.50 input / $3.00 output per 1M tokens with SOTA agentic coding performance (capped at 10 MB base64 — large files require S3 relay or frame fallback). **MiMo-V2.5** is the fifth fallback — Xiaomi's multimodal model with thinking mode support ($0.40 input / $2.00 output per 1M tokens). **GLM-4.6V** is the last-resort fallback — also free with no card required, but the free tier applies aggressive rate-limit throttling, so all other providers are preferred when their keys are available.
 
-Set `VIDEO_MCP_DEFAULT_PROVIDER=gemini`, `glm`, `qwen`, `kimi`, or `mimo` to change the default provider used when a tool call does not pass `provider`. If a tool call includes `provider`, that per-call value takes precedence.
+Set `VIDEO_MCP_DEFAULT_PROVIDER=gemini`, `glm`, `qwen`, `kimi`, `mimo`, or `m3` to change the default provider used when a tool call does not pass `provider`. If a tool call includes `provider`, that per-call value takes precedence.
 
 > **ℹ️ Large local files with GLM, Qwen, or MiMo:** All three providers have a 10–12 MB base64 limit for local files. When a file exceeds this limit, the server first tries to fall back to an upload-capable provider (Gemini or Kimi) if one is available in the fallback chain. Frame-based analysis (evenly-spaced keyframes sent as images) is used only as a **last resort** when no upload-capable provider is available, or when all upload-capable providers fail at runtime — no configuration needed. For the highest quality with large local videos, set up the optional **S3 relay** (below) — GLM, Qwen, and MiMo will receive a presigned URL to the full video, bypassing the limit entirely and taking priority over both fallbacks.
 
@@ -709,13 +711,13 @@ Set `AUDIO_MCP_DEFAULT_PROVIDER` to change the default.
 
 ### Audio
 
-| Variable                       | Description                                                                                                                                                                       | Default    |
-| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| `DEEPGRAM_API_KEY`             | Deepgram API key                                                                                                                                                                  | —          |
-| `ASSEMBLYAI_API_KEY`           | AssemblyAI API key                                                                                                                                                                | —          |
-| `GROQ_API_KEY`                 | Groq API key for Whisper transcription                                                                                                                                            | —          |
-| `AUDIO_MCP_DEFAULT_PROVIDER`   | Default audio provider: `deepgram`, `assemblyai`, `groq`, or `gemini`. Falls back in that order when the selected key is missing.                                                 | `deepgram` |
-| `AUDIO_ENHANCE_VIDEO_ANALYSIS` | Inject audio transcripts into `analyze_video`/`summarize_video` prompts (GLM/Kimi/Qwen/MiMo). `auto` = transcribe when audio track detected; `true` = always; `false` = disabled. | `auto`     |
+| Variable                       | Description                                                                                                                                                                          | Default    |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
+| `DEEPGRAM_API_KEY`             | Deepgram API key                                                                                                                                                                     | —          |
+| `ASSEMBLYAI_API_KEY`           | AssemblyAI API key                                                                                                                                                                   | —          |
+| `GROQ_API_KEY`                 | Groq API key for Whisper transcription                                                                                                                                               | —          |
+| `AUDIO_MCP_DEFAULT_PROVIDER`   | Default audio provider: `deepgram`, `assemblyai`, `groq`, or `gemini`. Falls back in that order when the selected key is missing.                                                    | `deepgram` |
+| `AUDIO_ENHANCE_VIDEO_ANALYSIS` | Inject audio transcripts into `analyze_video`/`summarize_video` prompts (GLM/Kimi/Qwen/MiMo/M3). `auto` = transcribe when audio track detected; `true` = always; `false` = disabled. | `auto`     |
 
 ### Media Generation (MiniMax)
 
@@ -823,6 +825,12 @@ vmcp cache clear:all --yes   # skip confirmation
 | ------------------------- | ------------------------------------------------------------------------------ | ---------------- |
 | `MIMO_REQUEST_TIMEOUT_MS` | Client-side timeout (ms) for MiMo API requests. Default: `240000` (4 minutes). | `240000` (4 min) |
 
+### M3 (MiniMax-M3)
+
+| Variable                | Description                                                                                                               | Default          |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------- | ---------------- |
+| `M3_REQUEST_TIMEOUT_MS` | Client-side timeout (ms) for MiniMax-M3 API requests. MiniMax-M3 is image-only (100 images per request, 10 MB per image). | `240000` (4 min) |
+
 ### yt-dlp (Platform Downloads)
 
 | Variable                | Description                                                                                                                                                          | Default |
@@ -877,6 +885,7 @@ vmcp cache clear:all --yes   # skip confirmation
         "QWEN_REQUEST_TIMEOUT_MS": "240000",
         "GLM_REQUEST_TIMEOUT_MS": "240000",
         "MIMO_REQUEST_TIMEOUT_MS": "240000",
+        "M3_REQUEST_TIMEOUT_MS": "240000",
         "VIDEO_MCP_LICENSE_KEY": "your-license-key"
       }
     }

package/dist/generated/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.2.3";
+export declare const VERSION = "1.3.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/sync-version.ts — do not edit
-export const VERSION = '1.2.3';
+export const VERSION = '1.3.0';
 //# sourceMappingURL=version.js.map

package/dist/index.js

@@ -88,7 +88,7 @@ async function main() {
     // Tool 2: summarize_video - Generate structured video summary
     server.registerTool('summarize_video', {
         title: 'Summarize Video',
-        description: "Generate a structured summary of the video including overview, key scenes, and timeline. For long videos (>5 min), extracts keyframes to reduce token usage (unless using Gemini, which processes natively). Provider options: 'glm' (default), 'qwen', 'kimi', 'gemini', 'mimo'.",
+        description: "Generate a structured summary of the video including overview, key scenes, and timeline. For long videos (>5 min), extracts keyframes to reduce token usage (unless using Gemini, which processes natively). Provider options: 'gemini' (Gemini 3.5 Flash, default), 'glm' (GLM-4.6V), 'qwen' (Qwen3.7), 'kimi' (Kimi K2.6), 'mimo' (MiMo-V2.5), or 'm3' (MiniMax-M3).",
         inputSchema: summarizeVideoSchema,
     }, withUpdateCheck(summarizeVideoTool));
     // Tool 3: extract_frames - Extract frames from video

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/services/m3Client.d.ts

@@ -0,0 +1,75 @@
+/**
+ * MiniMax-M3 Client
+ * Handles multimodal video understanding via MiniMax's Anthropic-compatible API.
+ *
+ * API Specification (Confirmed):
+ * - Base URL (Anthropic-compatible, recommended): https://api.minimax.io/anthropic
+ * - Endpoint: POST {baseURL}/v1/messages
+ * - Auth: x-api-key header (Anthropic-style)
+ * - Anthropic version: 2023-06-01
+ * - Model: MiniMax-M3
+ * - Native multimodality with 1M-token context window; explicitly built for
+ *   "long-video understanding" via extracted JPEG frames.
+ * - Per-request caps inherited from Anthropic Messages vision:
+ *   up to 100 images, 10 MB per image (base64-encoded), 8000x8000 px max.
+ * - Caching: $0.06/M effective cache-hit vs $0.30/M effective new input
+ *   (5x cheaper on follow-up calls when content is the same).
+ */
+export interface M3ClientOptions {
+    apiKey: string;
+    baseURL?: string;
+}
+export declare class M3Client {
+    private apiKey;
+    private baseURL;
+    constructor(options: M3ClientOptions);
+    /**
+     * Send a vision analysis request — array of JPEG/PNG frames + text prompt.
+     * Returns the model's text response (skipping `thinking` blocks).
+     *
+     * @param images  Base64-encoded frames with MIME types
+     * @param prompt  Text prompt (question, summarization, etc.)
+     * @param opts.maxImages  Cap images per request (default 100, Anthropic 200K cap)
+     * @param opts.maxImageBytes  Cap per-image base64 size (default 10 MB)
+     * @param opts.useCache  Add `cache_control: { type: 'ephemeral' }` to the last
+     *                       image block to enable explicit prompt caching
+     */
+    analyzeImages(images: Array<{
+        data: string;
+        mimeType: string;
+    }>, prompt: string, opts?: {
+        maxImages?: number;
+        maxImageBytes?: number;
+        useCache?: boolean;
+        maxTokens?: number;
+    }): Promise<string>;
+    /** Throw if any image exceeds the per-request caps. */
+    private validateImagesOrThrow;
+    /** Convert base64 frames to Anthropic-style image content blocks. */
+    private buildImageBlocks;
+    /** Surface any API error envelope and return the model text otherwise. */
+    private extractErrorOrText;
+    /**
+     * Convenience wrapper for prompt caching. Equivalent to
+     * `analyzeImages(images, prompt, { useCache: true })`.
+     */
+    analyzeImagesCached(images: Array<{
+        data: string;
+        mimeType: string;
+    }>, prompt: string, opts?: {
+        maxImages?: number;
+        maxImageBytes?: number;
+        maxTokens?: number;
+    }): Promise<string>;
+    /** Extract the first text content block, skipping thinking/tool_use blocks. */
+    private extractText;
+    private post;
+}
+/**
+ * Create an M3Client if the API key is available.
+ * @param apiKey  MiniMax API key (MINIMAX_API_KEY env var)
+ * @param baseURL  Optional custom base URL
+ * @returns M3Client instance or null if no API key
+ */
+export declare function createM3Client(apiKey?: string, baseURL?: string): M3Client | null;
+//# sourceMappingURL=m3Client.d.ts.map

package/dist/services/m3Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"m3Client.d.ts","sourceRoot":"","sources":["../../src/services/m3Client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAqBH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AA8CD,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;gBAEX,OAAO,EAAE,eAAe;IAKpC;;;;;;;;;;OAUG;IACG,aAAa,CACjB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EACjD,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,SAAS,CAAC,EAAE,MAAM,CAAA;KACd,GACL,OAAO,CAAC,MAAM,CAAC;IAyBlB,uDAAuD;IACvD,OAAO,CAAC,qBAAqB;IAsB7B,qEAAqE;IACrE,OAAO,CAAC,gBAAgB;IAsBxB,0EAA0E;IAC1E,OAAO,CAAC,kBAAkB;IAmB1B;;;OAGG;IACG,mBAAmB,CACvB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EACjD,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,SAAS,CAAC,EAAE,MAAM,CAAA;KACd,GACL,OAAO,CAAC,MAAM,CAAC;IAOlB,+EAA+E;IAC/E,OAAO,CAAC,WAAW;YAgBL,IAAI;CAqDnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,QAAQ,GAAG,IAAI,CAIjB"}

package/dist/services/m3Client.js

@@ -0,0 +1,195 @@
+/**
+ * MiniMax-M3 Client
+ * Handles multimodal video understanding via MiniMax's Anthropic-compatible API.
+ *
+ * API Specification (Confirmed):
+ * - Base URL (Anthropic-compatible, recommended): https://api.minimax.io/anthropic
+ * - Endpoint: POST {baseURL}/v1/messages
+ * - Auth: x-api-key header (Anthropic-style)
+ * - Anthropic version: 2023-06-01
+ * - Model: MiniMax-M3
+ * - Native multimodality with 1M-token context window; explicitly built for
+ *   "long-video understanding" via extracted JPEG frames.
+ * - Per-request caps inherited from Anthropic Messages vision:
+ *   up to 100 images, 10 MB per image (base64-encoded), 8000x8000 px max.
+ * - Caching: $0.06/M effective cache-hit vs $0.30/M effective new input
+ *   (5x cheaper on follow-up calls when content is the same).
+ */
+const M3_BASE_URL = 'https://api.minimax.io/anthropic';
+const M3_MODEL = 'MiniMax-M3';
+/** Client-side request timeout in ms. Default: 4 min.
+ * Override via M3_REQUEST_TIMEOUT_MS env var (milliseconds). */
+const M3_REQUEST_TIMEOUT_MS = process.env.M3_REQUEST_TIMEOUT_MS
+    ? Number(process.env.M3_REQUEST_TIMEOUT_MS)
+    : 4 * 60 * 1000;
+const M3_TIMEOUT_LABEL = `${Math.round(M3_REQUEST_TIMEOUT_MS / 60000)} minutes`;
+/** Anthropic-API version pinned for M3 multimodal vision support. */
+const M3_ANTHROPIC_VERSION = '2023-06-01';
+/** Default per-request image cap. Matches Anthropic 200K-context ceiling. */
+const M3_MAX_IMAGES_DEFAULT = 100;
+/** Per-image base64 size cap. Matches Anthropic vision limit. */
+const M3_MAX_IMAGE_BYTES = 10 * 1024 * 1024;
+export class M3Client {
+    apiKey;
+    baseURL;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseURL = (options.baseURL ?? M3_BASE_URL).replace(/\/+$/, '');
+    }
+    /**
+     * Send a vision analysis request — array of JPEG/PNG frames + text prompt.
+     * Returns the model's text response (skipping `thinking` blocks).
+     *
+     * @param images  Base64-encoded frames with MIME types
+     * @param prompt  Text prompt (question, summarization, etc.)
+     * @param opts.maxImages  Cap images per request (default 100, Anthropic 200K cap)
+     * @param opts.maxImageBytes  Cap per-image base64 size (default 10 MB)
+     * @param opts.useCache  Add `cache_control: { type: 'ephemeral' }` to the last
+     *                       image block to enable explicit prompt caching
+     */
+    async analyzeImages(images, prompt, opts = {}) {
+        const maxImages = opts.maxImages ?? M3_MAX_IMAGES_DEFAULT;
+        const maxImageBytes = opts.maxImageBytes ?? M3_MAX_IMAGE_BYTES;
+        this.validateImagesOrThrow(images, maxImages, maxImageBytes);
+        const messages = [
+            {
+                role: 'user',
+                content: [
+                    ...this.buildImageBlocks(images, opts.useCache === true),
+                    { type: 'text', text: prompt },
+                ],
+            },
+        ];
+        const body = {
+            model: M3_MODEL,
+            max_tokens: opts.maxTokens ?? 4096,
+            messages,
+        };
+        const data = await this.post('/v1/messages', body);
+        return this.extractErrorOrText(data);
+    }
+    /** Throw if any image exceeds the per-request caps. */
+    validateImagesOrThrow(images, maxImages, maxImageBytes) {
+        if (images.length > maxImages) {
+            throw new Error(`M3: too many images (${images.length} > ${maxImages}). ` +
+                `Reduce frame count or split into multiple requests.`);
+        }
+        for (const [i, img] of images.entries()) {
+            if (img.data.length > maxImageBytes) {
+                throw new Error(`M3: image ${i} exceeds per-image base64 size limit ` +
+                    `(${img.data.length} > ${maxImageBytes} bytes). ` +
+                    `Re-encode at a lower resolution.`);
+            }
+        }
+    }
+    /** Convert base64 frames to Anthropic-style image content blocks. */
+    buildImageBlocks(images, useCache) {
+        return images.map((img, i) => {
+            const isLast = i === images.length - 1;
+            const block = {
+                type: 'image',
+                source: {
+                    type: 'base64',
+                    media_type: img.mimeType,
+                    data: img.data,
+                },
+            };
+            if (useCache && isLast) {
+                // Cache the last image so subsequent calls on the same video are cheap
+                block.cache_control = { type: 'ephemeral' };
+            }
+            return block;
+        });
+    }
+    /** Surface any API error envelope and return the model text otherwise. */
+    extractErrorOrText(data) {
+        // MiniMax-style error envelope
+        if (data.base_resp?.status_code !== undefined &&
+            data.base_resp.status_code !== 0) {
+            throw new Error(`M3 API error ${data.base_resp.status_code}: ${data.base_resp.status_msg ?? 'unknown error'}`);
+        }
+        // Anthropic-style top-level error
+        if (data.error) {
+            throw new Error(`M3 API error: ${data.error.message ?? data.error.type ?? 'unknown error'}`);
+        }
+        return this.extractText(data);
+    }
+    /**
+     * Convenience wrapper for prompt caching. Equivalent to
+     * `analyzeImages(images, prompt, { useCache: true })`.
+     */
+    async analyzeImagesCached(images, prompt, opts = {}) {
+        return this.analyzeImages(images, prompt, {
+            ...opts,
+            useCache: true,
+        });
+    }
+    /** Extract the first text content block, skipping thinking/tool_use blocks. */
+    extractText(data) {
+        const blocks = data.content ?? [];
+        const textBlocks = blocks.filter((b) => b.type === 'text');
+        if (textBlocks.length === 0) {
+            throw new Error('M3 returned no text content');
+        }
+        return textBlocks
+            .map((b) => b.text ?? '')
+            .join('\n')
+            .trim();
+    }
+    // ── HTTP helpers ──────────────────────────────────────────────────────
+    async post(path, body) {
+        const url = `${this.baseURL}${path}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), M3_REQUEST_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-api-key': this.apiKey,
+                    'anthropic-version': M3_ANTHROPIC_VERSION,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            const text = await response.text();
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch (parseError) {
+                throw new Error(`M3 API returned non-JSON response (HTTP ${response.status}): ${text.substring(0, 200)}`, { cause: parseError });
+            }
+            if (!response.ok &&
+                !data.base_resp &&
+                !data.error) {
+                throw new Error(`M3 API HTTP ${response.status}: ${text.substring(0, 200)}`);
+            }
+            return data;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`M3 API request timed out after ${M3_TIMEOUT_LABEL}`, {
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+/**
+ * Create an M3Client if the API key is available.
+ * @param apiKey  MiniMax API key (MINIMAX_API_KEY env var)
+ * @param baseURL  Optional custom base URL
+ * @returns M3Client instance or null if no API key
+ */
+export function createM3Client(apiKey, baseURL) {
+    const key = apiKey || process.env.MINIMAX_API_KEY;
+    if (!key)
+        return null;
+    return new M3Client({ apiKey: key, baseURL });
+}
+//# sourceMappingURL=m3Client.js.map

package/dist/services/m3Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"m3Client.js","sourceRoot":"","sources":["../../src/services/m3Client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,GAAG,kCAAkC,CAAA;AACtD,MAAM,QAAQ,GAAG,YAAY,CAAA;AAE7B;gEACgE;AAChE,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB;IAC7D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAC3C,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AACjB,MAAM,gBAAgB,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,GAAG,KAAK,CAAC,UAAU,CAAA;AAE/E,qEAAqE;AACrE,MAAM,oBAAoB,GAAG,YAAY,CAAA;AAEzC,6EAA6E;AAC7E,MAAM,qBAAqB,GAAG,GAAG,CAAA;AAEjC,iEAAiE;AACjE,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAmD3C,MAAM,OAAO,QAAQ;IACX,MAAM,CAAQ;IACd,OAAO,CAAQ;IAEvB,YAAY,OAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACrE,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,aAAa,CACjB,MAAiD,EACjD,MAAc,EACd,OAKI,EAAE;QAEN,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,qBAAqB,CAAA;QACzD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,kBAAkB,CAAA;QAE9D,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAA;QAC5D,MAAM,QAAQ,GAAgB;YAC5B;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;oBACxD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;iBAC/B;aACF;SACF,CAAA;QAED,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;YAClC,QAAQ;SACT,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAqB,cAAc,EAAE,IAAI,CAAC,CAAA;QACtE,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC;IAED,uDAAuD;IAC/C,qBAAqB,CAC3B,MAAiD,EACjD,SAAiB,EACjB,aAAqB;QAErB,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,MAAM,MAAM,SAAS,KAAK;gBACvD,qDAAqD,CACxD,CAAA;QACH,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACxC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CACb,aAAa,CAAC,uCAAuC;oBACnD,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,MAAM,aAAa,WAAW;oBACjD,kCAAkC,CACrC,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,qEAAqE;IAC7D,gBAAgB,CACtB,MAAiD,EACjD,QAAiB;QAEjB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;YACtC,MAAM,KAAK,GAAmB;gBAC5B,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,GAAG,CAAC,QAAQ;oBACxB,IAAI,EAAE,GAAG,CAAC,IAAI;iBACf;aACF,CAAA;YACD,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;gBACvB,uEAAuE;gBACvE,KAAK,CAAC,aAAa,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;YAC7C,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,0EAA0E;IAClE,kBAAkB,CAAC,IAAwB;QACjD,+BAA+B;QAC/B,IACE,IAAI,CAAC,SAAS,EAAE,WAAW,KAAK,SAAS;YACzC,IAAI,CAAC,SAAS,CAAC,WAAW,KAAK,CAAC,EAChC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,gBAAgB,IAAI,CAAC,SAAS,CAAC,WAAW,KAAK,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,eAAe,EAAE,CAC9F,CAAA;QACH,CAAC;QACD,kCAAkC;QAClC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,eAAe,EAAE,CAC5E,CAAA;QACH,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CACvB,MAAiD,EACjD,MAAc,EACd,OAII,EAAE;QAEN,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE;YACxC,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI;SACf,CAAC,CAAA;IACJ,CAAC;IAED,+EAA+E;IACvE,WAAW,CAAC,IAAwB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;QACjC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAwC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAC/D,CAAA;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,UAAU;aACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;aACxB,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,EAAE,CAAA;IACX,CAAC;IAED,yEAAyE;IAEjE,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAa;QAC/C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAA;QACpC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,SAAS,GAAG,UAAU,CAC1B,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,qBAAqB,CACtB,CAAA;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,mBAAmB,EAAE,oBAAoB;iBAC1C;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAA;YAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAClC,IAAI,IAAO,CAAA;YACX,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAA;YAC9B,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,CAAC,MAAM,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EACxF,EAAE,KAAK,EAAE,UAAU,EAAE,CACtB,CAAA;YACH,CAAC;YAED,IACE,CAAC,QAAQ,CAAC,EAAE;gBACZ,CAAE,IAAgC,CAAC,SAAS;gBAC5C,CAAE,IAA4B,CAAC,KAAK,EACpC,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,eAAe,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC5D,CAAA;YACH,CAAC;YAED,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,kCAAkC,gBAAgB,EAAE,EAAE;oBACpE,KAAK,EAAE,KAAK;iBACb,CAAC,CAAA;YACJ,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAe,EACf,OAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAA;IACjD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,OAAO,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;AAC/C,CAAC"}

package/dist/services/providerRouter.d.ts

@@ -2,18 +2,19 @@
  * Provider Selection
  * Determines which AI backend to use based on user preference
  */
-export type VideoProvider = 'glm' | 'kimi' | 'gemini' | 'qwen' | 'mimo';
+export type VideoProvider = 'glm' | 'kimi' | 'gemini' | 'qwen' | 'mimo' | 'm3';
 /**
  * Validate that the selected provider has a configured API key
- * @param provider - User-specified provider ('glm', 'kimi', 'gemini', 'qwen', or 'mimo')
+ * @param provider - User-specified provider ('glm', 'kimi', 'gemini', 'qwen', 'mimo', or 'm3')
  * @param hasKimiKey - Whether Kimi API key is available
  * @param hasGLMKey - Whether GLM API key is available
  * @param hasGeminiKey - Whether Gemini API key is available
  * @param hasQwenKey - Whether Qwen API key is available
  * @param hasMimoKey - Whether MiMo API key is available
+ * @param hasM3Key - Whether MiniMax-M3 API key is available
  * @returns The validated provider
  */
-export declare function selectProvider(provider: VideoProvider, hasKimiKey: boolean, hasGLMKey: boolean, hasGeminiKey?: boolean, hasQwenKey?: boolean, hasMimoKey?: boolean): VideoProvider;
+export declare function selectProvider(provider: VideoProvider, hasKimiKey: boolean, hasGLMKey: boolean, hasGeminiKey?: boolean, hasQwenKey?: boolean, hasMimoKey?: boolean, hasM3Key?: boolean): VideoProvider;
 /**
  * Result type returned by resolveProviderWithFallback.
  * When `fallbackFrom` is set, the caller should notify the user that the
@@ -26,18 +27,19 @@ export type ProviderResult = {
 /**
  * Resolve the provider, with optional fallback behavior.
  * If the requested provider's key is missing, falls back in canonical priority
- * order (gemini → glm → qwen → kimi → mimo), skipping the requested provider and
- * visiting all remaining candidates. This means every starting provider can
+ * order (gemini → m3 → kimi → qwen → mimo → glm), skipping the requested provider
+ * and visiting all remaining candidates. This means every starting provider can
  * eventually reach any other provider:
- *   gemini → glm → qwen → kimi → mimo
- *   glm    → gemini → qwen → kimi → mimo
- *   kimi   → gemini → glm → qwen → mimo
- *   qwen   → gemini → glm → kimi → mimo
- *   mimo   → gemini → glm → qwen → kimi
+ *   gemini → m3 → kimi → qwen → mimo → glm
+ *   glm    → gemini → m3 → kimi → qwen → mimo
+ *   kimi   → gemini → m3 → qwen → mimo → glm
+ *   qwen   → gemini → m3 → kimi → mimo → glm
+ *   mimo   → gemini → m3 → kimi → qwen → glm
+ *   m3     → gemini → kimi → qwen → mimo → glm
  * Returns a ProviderResult with `fallbackFrom` set if a fallback occurred.
  * Throws only when no provider API key is available at all.
  */
-export declare function resolveProviderWithFallback(provider: VideoProvider, hasKimiKey: boolean, hasGLMKey: boolean, hasGeminiKey?: boolean, hasQwenKey?: boolean, hasMimoKey?: boolean): ProviderResult;
+export declare function resolveProviderWithFallback(provider: VideoProvider, hasKimiKey: boolean, hasGLMKey: boolean, hasGeminiKey?: boolean, hasQwenKey?: boolean, hasMimoKey?: boolean, hasM3Key?: boolean): ProviderResult;
 /**
  * Get the default provider from environment variable
  */
@@ -47,18 +49,19 @@ export declare function getDefaultProvider(): VideoProvider;
  * filtered to only those whose API keys are available.
  *
  * Fallback order: start with the requested provider, then visit remaining
- * providers in canonical priority order (gemini → glm → qwen → kimi → mimo), so
- * every starting provider can reach all other providers:
- *   gemini → gemini, glm, qwen, kimi, mimo
- *   glm    → glm, gemini, qwen, kimi, mimo
- *   kimi   → kimi, gemini, glm, qwen, mimo
- *   qwen   → qwen, gemini, glm, kimi, mimo
- *   mimo   → mimo, gemini, glm, qwen, kimi
+ * providers in canonical priority order (gemini → m3 → kimi → qwen → mimo → glm),
+ * so every starting provider can reach all other providers:
+ *   gemini → gemini, m3, kimi, qwen, mimo, glm
+ *   glm    → glm, gemini, m3, kimi, qwen, mimo
+ *   kimi   → kimi, gemini, m3, qwen, mimo, glm
+ *   qwen   → qwen, gemini, m3, kimi, mimo, glm
+ *   mimo   → mimo, gemini, m3, kimi, qwen, glm
+ *   m3     → m3, gemini, kimi, qwen, mimo, glm
  *
  * This is used for runtime error-based fallback: if the first provider's API call
  * throws (overloaded, timeout, 5xx, etc.), the caller retries with the next entry.
  */
-export declare function getRuntimeFallbackChain(provider: VideoProvider, hasKimiKey: boolean, hasGLMKey: boolean, hasGeminiKey?: boolean, hasQwenKey?: boolean, hasMimoKey?: boolean): VideoProvider[];
+export declare function getRuntimeFallbackChain(provider: VideoProvider, hasKimiKey: boolean, hasGLMKey: boolean, hasGeminiKey?: boolean, hasQwenKey?: boolean, hasMimoKey?: boolean, hasM3Key?: boolean): VideoProvider[];
 /**
  * Get the maximum number of frames to extract for summarization.
  *
@@ -74,8 +77,8 @@ export declare function getMaxFrames(): number;
  * Returns the maximum number of images that can be sent in a single
  * analyzeImages() request for a given provider.
  *
- * Qwen3.6 and MiMo-V2.5 enforce a per-request image cap of 20.
- * GLM-4.6V shares the same 20-image practical limit.
+ * Qwen3.7, MiMo-V2.5 and GLM-4.6V enforce a per-request image cap of 20.
+ * M3 (MiniMax-M3) inherits Anthropic's 200K-context vision cap of 100.
  * Kimi/Gemini are upload-based and do not use multi-image requests.
  */
 export declare function getProviderImageCountLimit(provider: VideoProvider): number;
@@ -88,6 +91,8 @@ export declare function getProviderImageCountLimit(provider: VideoProvider): num
  * Qwen cap: ~10 MB (DashScope hard reject above this)
  * Kimi cap: ~80 MB (frame payload budget — base64 overhead keeps request body under 100 MB)
  * MiMo cap: ~10 MB (confirmed for mimo-v2.5)
+ * M3 cap: 100 MB overall request budget (image-only provider; 1M-token context,
+ *   10 MB per-image Anthropic cap is enforced in M3Client.analyzeImages).
  * Gemini: no base64 path — always uses the Files API
  */
 export declare function getProviderBase64SizeLimit(provider: VideoProvider): number;
@@ -105,7 +110,8 @@ export declare const KIMI_FILE_UPLOAD_LIMIT: number;
  * Returns true when at least one provider remaining in the fallback chain
  * (after `chainIndex`) can accept the given file via native upload (not
  * base64). Gemini always qualifies (2 GB Files API). Kimi qualifies when
- * the raw file is ≤ 100 MB.
+ * the raw file is ≤ 100 MB. M3 is image-only (no native upload) so it
+ * does not qualify — GLM/Qwen/MiMo will only defer to Gemini or Kimi.
  */
 export declare function hasUploadCapableProviderRemaining(chain: VideoProvider[], chainIndex: number, fileSizeBytes: number): boolean;
 /**

package/dist/services/providerRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providerRouter.d.ts","sourceRoot":"","sources":["../../src/services/providerRouter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,YAAY,GAAE,OAAe,EAC7B,UAAU,GAAE,OAAe,EAC3B,UAAU,GAAE,OAAe,GAC1B,aAAa,CA4Bf;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,aAAa,CAAA;IACvB,YAAY,CAAC,EAAE,aAAa,CAAA;CAC7B,CAAA;AAWD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,YAAY,GAAE,OAAe,EAC7B,UAAU,GAAE,OAAe,EAC3B,UAAU,GAAE,OAAe,GAC1B,cAAc,CAuBhB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAYlD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,YAAY,GAAE,OAAe,EAC7B,UAAU,GAAE,OAAe,EAC3B,UAAU,GAAE,OAAe,GAC1B,aAAa,EAAE,CAgBjB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAerC;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAK1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAM1E;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAGT;AAED,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,QAAoB,CAAA;AAEvD;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAQzC"}
+{"version":3,"file":"providerRouter.d.ts","sourceRoot":"","sources":["../../src/services/providerRouter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;AAE9E;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,YAAY,GAAE,OAAe,EAC7B,UAAU,GAAE,OAAe,EAC3B,UAAU,GAAE,OAAe,EAC3B,QAAQ,GAAE,OAAe,GACxB,aAAa,CA+Bf;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,aAAa,CAAA;IACvB,YAAY,CAAC,EAAE,aAAa,CAAA;CAC7B,CAAA;AAmBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,YAAY,GAAE,OAAe,EAC7B,UAAU,GAAE,OAAe,EAC3B,UAAU,GAAE,OAAe,EAC3B,QAAQ,GAAE,OAAe,GACxB,cAAc,CAwBhB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAalD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,YAAY,GAAE,OAAe,EAC7B,UAAU,GAAE,OAAe,EAC3B,UAAU,GAAE,OAAe,EAC3B,QAAQ,GAAE,OAAe,GACxB,aAAa,EAAE,CAiBjB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAerC;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAM1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAO1E;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAGT;AAED,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,QAAoB,CAAA;AAEvD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAQzC"}