opencode-minimax-easy-vision 1.0.0 → 1.1.1

package/README.md

@@ -1,6 +1,6 @@
-# MiniMax Easy Vision
+# Opencode MiniMax Easy Vision
 
-MiniMax Easy Vision is a plugin for [OpenCode](https://opencode.ai) that enables **vision support** when using [MiniMax](https://www.minimax.io/) models. It restores a simple “paste and ask” workflow by automatically handling image assets and routing them through the [MiniMax Coding Plan MCP](https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP)
+MiniMax Easy Vision is a plugin for [OpenCode](https://opencode.ai) that enables **vision support** for models that lack native image attachment support. Originally built for [MiniMax](https://www.minimax.io/) models, it can be configured to work with any model that requires MCP-based image handling. It restores a simple "paste and ask" workflow by automatically handling image assets and routing them through the [MiniMax Coding Plan MCP](https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP).
 
 ## Demo
 
@@ -14,28 +14,28 @@ https://github.com/user-attachments/assets/826f90ea-913f-427e-ace8-0b711302c497
 
 When using MiniMax models (for example, MiniMax M2.1) inside OpenCode, users run into a limitation: **vision is not supported via native image attachments**.
 
-MiniMax models rely on the MiniMax Coding Plan MCP’s `understand_image` tool, which requires an explicit file path or URL. This breaks the normal chat workflow:
+MiniMax models rely on the MiniMax Coding Plan MCP's `understand_image` tool, which requires an explicit file path or URL. This breaks the normal chat workflow:
 
 * **Ignored images**: Images pasted directly into chat are ignored by MiniMax models.
 * **Manual steps**: Users must save screenshots, locate file paths, and reference them manually.
-* **Broken flow**: The “paste and ask” vision workflow available in other models is lost.
+* **Broken flow**: The "paste and ask" vision workflow available in other models is lost.
 
 ## What This Plugin Does
 
-This plugin removes that friction by automating the vision pipeline for MiniMax models.
+This plugin removes that friction by automating the vision pipeline for configured models.
 
 Internally, it:
 
-1. Detects when a MiniMax model is active
+1. Detects when a configured model is active (MiniMax by default)
 2. Intercepts images pasted into the chat
 3. Saves them to a temporary local directory
 4. Injects the required context so the model can invoke the `understand_image` MCP tool with the correct file path
 
-From the user’s perspective, pasted images simply work with MiniMax vision.
+From the user's perspective, pasted images simply work with vision, just like how it works out of the box with other vision-capable models like Claude.
 
 ## Supported Models
 
-The plugin activates only for MiniMax models, identified by:
+By default, the plugin activates for MiniMax models, identified by:
 
 * **Provider ID** containing `minimax`
 * **Model ID** containing `minimax` or `abab`
@@ -45,7 +45,75 @@ Examples:
 * `minimax/minimax-m2.1`
 * `minimax/abab6.5s-chat`
 
-Non-MiniMax models are not affected. Their native vision support continues to work normally.
+### Custom Model Configuration
+
+You can configure which models the plugin applies to by creating a config file.
+
+#### Config File Locations
+
+The plugin looks for configuration in these locations (in order of priority):
+
+1. **Project level**: `.opencode/opencode-minimax-easy-vision.json`
+2. **User level**: `~/.config/opencode/opencode-minimax-easy-vision.json`
+
+Project-level config takes precedence over user-level config.
+
+#### Config File Format
+
+```json
+{
+  "models": ["minimax/*", "glm/*", "openai/gpt-4-vision"]
+}
+```
+
+#### Pattern Syntax
+
+Model patterns use a `provider/model` format with wildcard support:
+
+| Pattern        | Description                                         |
+| -------------- | --------------------------------------------------- |
+| `*`            | Match ALL models (global wildcard)                  |
+| `minimax/*`    | Match all models from the `minimax` provider        |
+| `*/glm-4v`     | Match `glm-4v` model from any provider              |
+| `openai/gpt-4` | Exact match for provider and model                  |
+| `*/abab*`      | Match any model containing `abab` from any provider |
+
+#### Wildcard Rules
+
+* `*` at the start matches any prefix: `*suffix` matches values ending with `suffix`
+* `*` at the end matches any suffix: `prefix*` matches values starting with `prefix`
+* `*` alone matches everything
+* `*text*` matches values containing `text`
+
+#### Precedence
+
+When multiple patterns are specified, the first matching pattern wins. If the `models` array is empty or the config file doesn't exist, the plugin falls back to default MiniMax-only behavior.
+
+#### Examples
+
+**Enable for all models:**
+
+```json
+{
+  "models": ["*"]
+}
+```
+
+**Enable for specific providers:**
+
+```json
+{
+  "models": ["minimax/*", "glm/*", "zhipu/*"]
+}
+```
+
+**Mix of providers and specific models:**
+
+```json
+{
+  "models": ["minimax/*", "openai/gpt-4-vision", "*/claude-3*"]
+}
+```
 
 ## Supported Image Formats
 
@@ -53,7 +121,7 @@ Non-MiniMax models are not affected. Their native vision support continues to wo
 * JPEG
 * WebP
 
-These formats match the constraints of the MiniMax Coding Plan MCP `understand_image` tool.
+*(These formats are dictated by the limitations of the [MiniMax Coding Plan MCP](https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP) `understand_image` tool.)*
 
 ## Installation
 
@@ -105,7 +173,7 @@ For full setup details, refer to the MiniMax Coding Plan MCP and MiniMax API doc
 
 ## Usage
 
-1. Start OpenCode with a supported MiniMax model
+1. Start OpenCode with a supported model (MiniMax by default, or any configured model)
 2. Paste an image into the chat (`Cmd+V` / `Ctrl+V`)
 3. Ask a question about the image
 
@@ -130,14 +198,6 @@ Model: I'll analyze the screenshot using the understand_image tool.
 Model: The error message indicates a "TypeError: Cannot read property 'foo' of undefined"...
 ```
 
-## Limitations
-
-* Uses `experimental.chat.messages.transform`, which may change in future OpenCode versions
-* Images persist until the OS clears the temporary directory
-* Only JPEG, PNG, and WebP are supported
-* The MCP server must have access to the local filesystem
-* Animated GIFs and unsupported formats are skipped
-
 ## Development
 
 ```bash
@@ -149,12 +209,12 @@ The built plugin will be available at `dist/index.js`.
 
 ## License
 
-GPL-3.0. See `LICENSE.md` for details.
+GPL-3.0. See [LICENSE.md](./LICENCE.md) for details.
 
 ## References
 
-* [https://opencode.ai](https://opencode.ai)
-* [https://opencode.ai/docs/plugins/](https://opencode.ai/docs/plugins/)
-* [https://www.minimax.io/](https://www.minimax.io/)
-* [https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP](https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP)
-* [https://platform.minimax.io/docs/guides/coding-plan-mcp-guide](https://platform.minimax.io/docs/guides/coding-plan-mcp-guide)
+* [OpenCode Official Website](https://opencode.ai)
+* [OpenCode Plugins Documentation](https://opencode.ai/docs/plugins/)
+* [MiniMax Official Website](https://www.minimax.io/)
+* [MiniMax Coding Plan MCP Repository](https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP)
+* [MiniMax API Documentation](https://platform.minimax.io/docs/guides/coding-plan-mcp-guide)

package/dist/index.d.ts

@@ -1,7 +1,4 @@
 import type { Plugin } from "@opencode-ai/plugin";
-/**
- * The main plugin export
- */
 export declare const MinimaxEasyVisionPlugin: Plugin;
 export default MinimaxEasyVisionPlugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAsNlD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAgHrC,CAAC;AAGF,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAgTlD,eAAO,MAAM,uBAAuB,EAAE,MAwGrC,CAAC;AAEF,eAAe,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,64 +1,137 @@
-import { tmpdir } from "node:os";
+import { tmpdir, homedir } from "node:os";
 import { join } from "node:path";
-import { mkdir, writeFile } from "node:fs/promises";
+import { mkdir, writeFile, readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
 import { randomUUID } from "node:crypto";
-/**
- * Plugin name for logging
- */
 const PLUGIN_NAME = "minimax-easy-vision";
-/**
- * Temp directory name for saved images
- */
+const CONFIG_FILENAME = "opencode-minimax-easy-vision.json";
 const TEMP_DIR_NAME = "opencode-minimax-vision";
-/**
- * Supported image MIME types (Minimax MCP limitation)
- */
 const SUPPORTED_MIME_TYPES = new Set([
     "image/png",
     "image/jpeg",
     "image/jpg",
     "image/webp",
 ]);
-/**
- * Map MIME type to file extension
- */
 const MIME_TO_EXTENSION = {
     "image/png": "png",
     "image/jpeg": "jpg",
     "image/jpg": "jpg",
     "image/webp": "webp",
 };
-/**
- * Check if a model is a Minimax model
- */
-function isMinimaxModel(model) {
+const DEFAULT_MODEL_PATTERNS = ["minimax/*", "*/abab*"];
+let pluginConfig = {};
+function getUserConfigPath() {
+    return join(homedir(), ".config", "opencode", CONFIG_FILENAME);
+}
+function getProjectConfigPath(directory) {
+    return join(directory, ".opencode", CONFIG_FILENAME);
+}
+async function loadConfigFile(configPath) {
+    try {
+        if (!existsSync(configPath)) {
+            return null;
+        }
+        const content = await readFile(configPath, "utf-8");
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === "object" && parsed !== null) {
+            const config = parsed;
+            if (Array.isArray(config.models)) {
+                const models = config.models.filter((m) => typeof m === "string");
+                return { models };
+            }
+        }
+        return {};
+    }
+    catch {
+        return null;
+    }
+}
+// Config precedence: project > user > defaults
+async function loadPluginConfig(directory, log) {
+    const userConfigPath = getUserConfigPath();
+    const projectConfigPath = getProjectConfigPath(directory);
+    const userConfig = await loadConfigFile(userConfigPath);
+    const projectConfig = await loadConfigFile(projectConfigPath);
+    if (projectConfig?.models && projectConfig.models.length > 0) {
+        pluginConfig = projectConfig;
+        log(`Loaded project config from ${projectConfigPath}: ${projectConfig.models.join(", ")}`);
+    }
+    else if (userConfig?.models && userConfig.models.length > 0) {
+        pluginConfig = userConfig;
+        log(`Loaded user config from ${userConfigPath}: ${userConfig.models.join(", ")}`);
+    }
+    else {
+        pluginConfig = {};
+        log(`No config found, using defaults: ${DEFAULT_MODEL_PATTERNS.join(", ")}`);
+    }
+}
+// Order matters: check *text* before *text or text* to avoid false matches
+function matchesPattern(pattern, value) {
+    const lowerPattern = pattern.toLowerCase();
+    const lowerValue = value.toLowerCase();
+    if (lowerPattern === "*") {
+        return true;
+    }
+    if (lowerPattern.startsWith("*") &&
+        lowerPattern.endsWith("*") &&
+        lowerPattern.length > 2) {
+        const middle = lowerPattern.slice(1, -1);
+        return lowerValue.includes(middle);
+    }
+    if (lowerPattern.endsWith("*")) {
+        const prefix = lowerPattern.slice(0, -1);
+        return lowerValue.startsWith(prefix);
+    }
+    if (lowerPattern.startsWith("*")) {
+        const suffix = lowerPattern.slice(1);
+        return lowerValue.endsWith(suffix);
+    }
+    return lowerValue === lowerPattern;
+}
+// Pattern format: "provider/model" with wildcards. No slash = match against both.
+function modelMatchesPatterns(model, patterns) {
     if (!model)
         return false;
-    const providerID = model.providerID.toLowerCase();
-    const modelID = model.modelID.toLowerCase();
-    return (providerID.includes("minimax") ||
-        modelID.includes("minimax") ||
-        modelID.includes("abab") // Minimax model naming convention
-    );
+    for (const pattern of patterns) {
+        if (pattern === "*") {
+            return true;
+        }
+        const slashIndex = pattern.indexOf("/");
+        if (slashIndex === -1) {
+            if (matchesPattern(pattern, model.modelID)) {
+                return true;
+            }
+            if (matchesPattern(pattern, model.providerID)) {
+                return true;
+            }
+        }
+        else {
+            const providerPattern = pattern.slice(0, slashIndex);
+            const modelPattern = pattern.slice(slashIndex + 1);
+            const providerMatches = matchesPattern(providerPattern, model.providerID);
+            const modelMatches = matchesPattern(modelPattern, model.modelID);
+            if (providerMatches && modelMatches) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function shouldApplyVisionHook(model) {
+    const patterns = pluginConfig.models && pluginConfig.models.length > 0
+        ? pluginConfig.models
+        : DEFAULT_MODEL_PATTERNS;
+    return modelMatchesPatterns(model, patterns);
 }
-/**
- * Check if a part is a FilePart with an image
- */
 function isImageFilePart(part) {
     if (part.type !== "file")
         return false;
     const filePart = part;
     return SUPPORTED_MIME_TYPES.has(filePart.mime?.toLowerCase() ?? "");
 }
-/**
- * Check if a part is a TextPart
- */
 function isTextPart(part) {
     return part.type === "text";
 }
-/**
- * Parse a data URL and extract the base64 data
- */
 function parseDataUrl(dataUrl) {
     const match = dataUrl.match(/^data:([^;]+);base64,(.+)$/);
     if (!match)
@@ -73,23 +146,14 @@ function parseDataUrl(dataUrl) {
         return null;
     }
 }
-/**
- * Get file extension from MIME type
- */
 function getExtension(mime) {
     return MIME_TO_EXTENSION[mime.toLowerCase()] ?? "png";
 }
-/**
- * Ensure temp directory exists and return its path
- */
 async function ensureTempDir() {
     const dir = join(tmpdir(), TEMP_DIR_NAME);
     await mkdir(dir, { recursive: true });
     return dir;
 }
-/**
- * Save image data to a temp file and return the path
- */
 async function saveImageToTemp(data, mime) {
     const tempDir = await ensureTempDir();
     const ext = getExtension(mime);
@@ -98,9 +162,6 @@ async function saveImageToTemp(data, mime) {
     await writeFile(filepath, data);
     return filepath;
 }
-/**
- * Generate the injection prompt for the model
- */
 function generateInjectionPrompt(imagePaths, userText) {
     if (imagePaths.length === 0)
         return userText;
@@ -115,10 +176,6 @@ Use the \`mcp_minimax_understand_image\` tool to analyze ${isSingle ? "this imag
 
 User's request: ${userText || "(analyze the image)"}`;
 }
-/**
- * Process a message and extract/save any images
- * Returns the paths of saved images
- */
 async function processMessageImages(parts, log) {
     const savedImages = [];
     for (const part of parts) {
@@ -126,12 +183,10 @@ async function processMessageImages(parts, log) {
             continue;
         const filePart = part;
         const url = filePart.url;
-        // Skip if no URL
         if (!url) {
             log(`Skipping image part ${filePart.id}: no URL`);
             continue;
         }
-        // Handle file:// URLs - already on disk
         if (url.startsWith("file://")) {
             const localPath = url.replace("file://", "");
             log(`Image already on disk: ${localPath}`);
@@ -142,7 +197,6 @@ async function processMessageImages(parts, log) {
             });
             continue;
         }
-        // Handle data: URLs - need to save to disk
         if (url.startsWith("data:")) {
             const parsed = parseDataUrl(url);
             if (!parsed) {
@@ -163,7 +217,6 @@ async function processMessageImages(parts, log) {
             }
             continue;
         }
-        // Handle HTTP/HTTPS URLs - Minimax can use these directly
         if (url.startsWith("http://") || url.startsWith("https://")) {
             log(`Image is remote URL: ${url}`);
             savedImages.push({
@@ -177,12 +230,8 @@ async function processMessageImages(parts, log) {
     }
     return savedImages;
 }
-/**
- * The main plugin export
- */
 export const MinimaxEasyVisionPlugin = async (input) => {
-    const { client } = input;
-    // Simple logging helper
+    const { client, directory } = input;
     const log = (msg) => {
         client.app
             .log({
@@ -192,19 +241,13 @@ export const MinimaxEasyVisionPlugin = async (input) => {
                 message: msg,
             },
         })
-            .catch(() => {
-            // Ignore logging errors
-        });
+            .catch(() => { });
     };
+    await loadPluginConfig(directory, log);
     log("Plugin initialized");
     return {
-        /**
-         * Transform messages before they're sent to the LLM
-         * This is where we intercept images and inject the MCP tool instructions
-         */
         "experimental.chat.messages.transform": async (_input, output) => {
             const { messages } = output;
-            // Find the last user message
             let lastUserMessage;
             let lastUserIndex = -1;
             for (let i = messages.length - 1; i >= 0; i--) {
@@ -215,21 +258,18 @@ export const MinimaxEasyVisionPlugin = async (input) => {
                 }
             }
             if (!lastUserMessage) {
-                return; // No user message to process
+                return;
             }
-            // Check if using Minimax model
             const userInfo = lastUserMessage.info;
-            if (!isMinimaxModel(userInfo.model)) {
-                return; // Not a Minimax model, skip
+            if (!shouldApplyVisionHook(userInfo.model)) {
+                return;
             }
-            log("Detected Minimax model, checking for images...");
-            // Check if there are any image parts
+            log("Model matched, checking for images...");
             const hasImages = lastUserMessage.parts.some(isImageFilePart);
             if (!hasImages) {
-                return; // No images to process
+                return;
             }
             log("Found images in message, processing...");
-            // Process and save images
             const savedImages = await processMessageImages(lastUserMessage.parts, log);
             if (savedImages.length === 0) {
                 log("No images were successfully saved");
@@ -262,5 +302,4 @@ export const MinimaxEasyVisionPlugin = async (input) => {
         },
     };
 };
-// Default export for OpenCode plugin loading
 export default MinimaxEasyVisionPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-minimax-easy-vision",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "OpenCode plugin that enables vision support for Minimax models by saving pasted images and injecting MCP tool instructions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",