opencode-pollinations-plugin 5.1.3

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pollinations.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# 🌸 Pollinations AI Plugin for OpenCode (v5.1)
+
+<div align="center">
+  <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="200">
+  <br>
+  <b>The Bridge between OpenCode and the Pollinations.ai Ecosystem.</b>
+  <br>
+  Access unlimited free AI models or premium enterprise models directly within your editor.
+</div>
+
+<div align="center">
+
+![Version](https://img.shields.io/badge/version-5.1.3-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Status](https://img.shields.io/badge/status-Stable-success.svg)
+
+</div>
+
+## 📖 Philosophy: Open AI for Creators
+
+> **"No closed doors, no corporate hoops — just good tools and good people."**
+
+Pollinations.ai is an open-source platform built by and for the community. We provide a unified API for image, text, audio, and video generation.
+- **Transparent**: Our code, roadmap, and discussions are open.
+- **Community Driven**: Features are prioritized based on what *you* need.
+- **Fair**: One single currency (**Pollen**) for all models. No complex subscriptions.
+
+## 📸 Gallery
+
+<p align="center">
+  <img src="https://github.com/fkom13/opencode-pollinations-plugin/raw/main/docs/images/connect.png" alt="Connect Command" width="800">
+  <br>
+  <em>Easy Connection with /connect or /pollinations config apiKey</em>
+</p>
+
+<p align="center">
+  <img src="https://github.com/fkom13/opencode-pollinations-plugin/raw/main/docs/images/usage_dashboard.png" alt="Usage Dashboard" width="800">
+  <br>
+  <em>Integrated Usage Dashboard (/pollinations usage)</em>
+</p>
+
+<p align="center">
+  <img src="https://github.com/fkom13/opencode-pollinations-plugin/raw/main/docs/images/models.png" alt="Models" width="800">
+  <br>
+  <em>Wide Range of Models (Mistral, OpenAI, Gemini, Claude)</em>
+</p>
+
+## ✨ Features
+
+- **🌍 Free Universe**: Access generic models (`openai`, `mistral`, `gemini`) for **FREE**, unlimited time, no API key required.
+- **🚀 Pro Mode**: Connect your Pollinations API Key to access Premium Models (`claude-3-opus`, `gpt-4o`, `deepseek-coder`).
+- **🛡️ Safety Net V5**: never get blocked.
+    - **Transparent Fallback**: If your Pro quota runs out mid-chat, the plugin automatically switches to a free model instantly. No errors, just a seamless experience.
+- **📊 Real-time Dashboard**: Track your **Pollen** usage, Tier Status, and Wallet Balance inside OpenCode.
+
+## 🐝 Understanding Pollen & Tiers
+
+**Pollen** is our unified credit system. $1 ≈ 1 Pollen.
+You spend it to verify API calls on premium models.
+
+### Tiers (Free Daily Grants during Beta)
+
+| Tier | Grant | Requirement |
+| :--- | :--- | :--- |
+| **🦠 Spore** | **1 Pollen/day** | Just Sign Up! |
+| **🌱 Seed** | **3 Pollen/day** | Active GitHub Developer (8+ points) |
+| **🌸 Flower** | **10 Pollen/day** | **Publish an App** (Like this Plugin!) |
+| **🍯 Nectar** | **20 Pollen/day** | Major Contributors (Coming Soon) |
+
+> 🎁 **Beta Bonus**: Buy one Pollen pack, get one free!
+
+## 📦 Installation & Ecology
+
+This plugin is part of the **OpenCode Ecosystem**.
+
+### Option 1: NPM (Standard Installation)
+This is the native method for OpenCode CLI.
+
+1. Install the plugin globally:
+   ```bash
+   npm install -g opencode-pollinations-plugin
+   ```
+2. Register it in your OpenCode configuration (e.g., `~/.config/opencode/opencode.json`):
+   ```json
+   {
+     "plugin": [
+       "opencode-pollinations-plugin"
+     ]
+   }
+   ```
+
+### Option 2: Local Development (Source)
+If you are developing the plugin:
+1. Clone the repo.
+2. Link it globally:
+   ```bash
+   cd opencode-pollinations-plugin
+   npm link
+   ```
+3. Use the provided script (`run_dev.sh`) which automatically injects the plugin for testing.
+
+## 🚀 Publication (The "Registry")
+OpenCode uses NPM as its registry. To publish:
+
+1. **Publish to NPM**:
+   ```bash
+   npm login
+   npm publish
+   ```
+2. **Join Ecosystem**: Submit a Pull Request to [OpenCode Ecosystem](https://github.com/opencode-ai/ecosystem) to list your plugin officially.
+   *Once accepted, users can find it via documentation or future registry commands.*
+
+## 🚀 Getting Started
+
+### 1. The Basics (Free Mode)
+Just type in the chat. You are in **Manual Mode** by default.
+- Model: `openai` (GPT-4o Mini equivalent)
+- Model: `mistral` (Mistral Nemo)
+
+### 2. Going Pro
+1. Get your API Key from [pollinations.ai](https://pollinations.ai).
+2. Run command:
+   ```bash
+   /pollinations config apiKey sk_YourSecretKey
+   ```
+3. Set mode to Pro:
+   ```bash
+   /pollinations mode pro
+   ```
+4. **Reload Window**.
+
+## 🔗 Links
+
+- **Pollinations Website**: [pollinations.ai](https://pollinations.ai)
+- **Discord Community**: [Join us!](https://discord.gg/pollinations-ai-885844321461485618)
+- **OpenCode Ecosystem**: [opencode.ai](https://opencode.ai/docs/ecosystem#plugins)
+
+## 📜 License
+
+MIT License. Created by [fkom13](https://github.com/fkom13) & The Pollinations Community.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const PollinationsPlugin: Plugin;
+export default PollinationsPlugin;

package/dist/index.js

@@ -0,0 +1,128 @@
+import * as http from 'http';
+import * as fs from 'fs';
+import { execSync } from 'child_process';
+import { generatePollinationsConfig } from './server/generate-config.js';
+import { loadConfig } from './server/config.js';
+import { handleChatCompletion } from './server/proxy.js';
+import { createToastHooks, setGlobalClient } from './server/toast.js';
+import { createStatusHooks } from './server/status.js';
+import { createCommandHooks } from './server/commands.js';
+const LOG_FILE = '/tmp/opencode_pollinations_v4.log';
+function log(msg) {
+    try {
+        fs.appendFileSync(LOG_FILE, `[${new Date().toISOString()}] ${msg}\n`);
+    }
+    catch (e) { }
+}
+const TRACKING_PORT = 10001;
+// === ANTI-ZOMBIE ATOMIC CLEANUP ===
+try {
+    log(`[Init] Checking port ${TRACKING_PORT} for zombies...`);
+    execSync(`fuser -k ${TRACKING_PORT}/tcp || true`);
+    log(`[Init] Port ${TRACKING_PORT} cleaned.`);
+}
+catch (e) {
+    log(`[Init] Zombie cleanup warning: ${e}`);
+}
+// === GESTION DU CYCLE DE VIE PROXY ===
+const startProxy = () => {
+    return new Promise((resolve) => {
+        const server = http.createServer(async (req, res) => {
+            log(`[Proxy] Request: ${req.method} ${req.url}`);
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+            res.setHeader('Access-Control-Allow-Headers', '*');
+            if (req.method === 'OPTIONS') {
+                res.writeHead(204);
+                res.end();
+                return;
+            }
+            if (req.method === 'GET' && req.url === '/health') {
+                const config = loadConfig();
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    status: "ok",
+                    version: "v4.0.5",
+                    mode: config.mode
+                }));
+                return;
+            }
+            // SUPPORT FLEXIBLE DES PATHS
+            // Le SDK peut envoyer /v1/chat/completions ou juste /chat/completions
+            if (req.method === 'POST' && (req.url === '/v1/chat/completions' || req.url === '/chat/completions')) {
+                const chunks = [];
+                req.on('data', chunk => chunks.push(chunk));
+                req.on('end', async () => {
+                    try {
+                        const bodyRaw = Buffer.concat(chunks).toString();
+                        await handleChatCompletion(req, res, bodyRaw);
+                    }
+                    catch (e) {
+                        log(`Error: ${e}`);
+                        if (!res.headersSent) {
+                            res.writeHead(500);
+                            res.end(JSON.stringify({ error: String(e) }));
+                        }
+                    }
+                });
+                return;
+            }
+            log(`[Proxy] 404 Not Found for ${req.url}`);
+            res.writeHead(404);
+            res.end("Not Found");
+        });
+        server.listen(TRACKING_PORT, '127.0.0.1', () => {
+            log(`[Proxy] Started V4 on port ${TRACKING_PORT}`);
+            resolve(TRACKING_PORT);
+        });
+        server.on('error', (e) => {
+            log(`[Proxy] Fatal Error: ${e}`);
+            resolve(0);
+        });
+    });
+};
+// === PLUGIN EXPORT ===
+export const PollinationsPlugin = async (ctx) => {
+    log("Plugin Initializing V4.0.5 (Path Fix)...");
+    try {
+        log(`[DEBUG] CTX Keys: ${Object.keys(ctx).join(', ')}`);
+    }
+    catch (e) {
+        log(`[DEBUG] Error inspecting ctx: ${e}`);
+    }
+    const port = await startProxy();
+    // IMPORTANT: On ajoute /v1 à la base URL pour guider le SDK, 
+    // mais le proxy accepte aussi sans.
+    const localBaseUrl = `http://127.0.0.1:${port}/v1`;
+    setGlobalClient(ctx.client); // REGISTER CLIENT FOR IMMEDIATE TOASTS
+    const toastHooks = createToastHooks(ctx.client);
+    const commandHooks = createCommandHooks();
+    return {
+        async config(config) {
+            log("[Hook] config() called");
+            const modelsArray = await generatePollinationsConfig();
+            const modelsObj = {};
+            for (const m of modelsArray) {
+                // Ensure ID is relative for mapping ("free/gemini") 
+                // BUT Provider needs full ID ? No, the object key is the relative ID
+                // OpenCode: provider.models[id]
+                // id comes from generatePollinationsConfig which returns "free/gemini"
+                // So modelsObj["free/gemini"] = ... matches.
+                modelsObj[m.id] = m;
+            }
+            if (!config.provider)
+                config.provider = {};
+            config.provider['pollinations'] = {
+                id: 'pollinations',
+                name: 'Pollinations V5.1 (Native)',
+                options: { baseURL: localBaseUrl },
+                models: modelsObj
+            };
+            log(`[Hook] Registered ${Object.keys(modelsObj).length} models.`);
+        },
+        ...toastHooks,
+        ...createStatusHooks(ctx.client), // New Status Bar Logic
+        ...commandHooks
+    };
+};
+export default PollinationsPlugin;

package/dist/provider.d.ts

@@ -0,0 +1 @@
+export declare const createPollinationsFetch: (apiKey: string) => (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;

package/dist/provider.js

@@ -0,0 +1,135 @@
+// Removed invalid imports
+import * as fs from 'fs';
+// --- Sanitization Helpers (Ported from Gateway/Upstream) ---
+function safeId(id) {
+    if (!id)
+        return id;
+    if (id.length > 30)
+        return id.substring(0, 30);
+    return id;
+}
+function logDebug(message, data) {
+    try {
+        const timestamp = new Date().toISOString();
+        let logMsg = `[${timestamp}] ${message}`;
+        if (data) {
+            logMsg += `\n${JSON.stringify(data, null, 2)}`;
+        }
+        fs.appendFileSync('/tmp/opencode_pollinations_debug.log', logMsg + '\n\n');
+    }
+    catch (e) {
+        // ignore logging errors
+    }
+}
+function sanitizeTools(tools) {
+    if (!Array.isArray(tools))
+        return tools;
+    const cleanSchema = (schema) => {
+        if (!schema || typeof schema !== "object")
+            return;
+        if (schema.optional !== undefined)
+            delete schema.optional;
+        if (schema.ref !== undefined)
+            delete schema.ref;
+        if (schema["$ref"] !== undefined)
+            delete schema["$ref"];
+        if (schema.properties) {
+            for (const key in schema.properties)
+                cleanSchema(schema.properties[key]);
+        }
+        if (schema.items)
+            cleanSchema(schema.items);
+    };
+    return tools.map((tool) => {
+        const newTool = { ...tool };
+        if (newTool.function && newTool.function.parameters) {
+            cleanSchema(newTool.function.parameters);
+        }
+        return newTool;
+    });
+}
+function filterTools(tools, maxCount = 120) {
+    if (!Array.isArray(tools))
+        return [];
+    if (tools.length <= maxCount)
+        return tools;
+    const priorities = [
+        "bash", "read", "write", "edit", "webfetch", "glob", "grep",
+        "searxng_remote_search", "deepsearch_deep_search", "google_search",
+        "task", "todowrite"
+    ];
+    const priorityTools = tools.filter((t) => priorities.includes(t.function.name));
+    const otherTools = tools.filter((t) => !priorities.includes(t.function.name));
+    const slotsLeft = maxCount - priorityTools.length;
+    const othersKept = otherTools.slice(0, Math.max(0, slotsLeft));
+    logDebug(`[POLLI-PLUGIN] Filtering tools: ${tools.length} -> ${priorityTools.length + othersKept.length}`);
+    return [...priorityTools, ...othersKept];
+}
+// --- Fetch Implementation ---
+export const createPollinationsFetch = (apiKey) => async (input, init) => {
+    let url = input.toString();
+    const options = init || {};
+    let body = null;
+    if (options.body && typeof options.body === "string") {
+        try {
+            body = JSON.parse(options.body);
+        }
+        catch (e) {
+            // Not JSON, ignore
+        }
+    }
+    // --- INTERCEPTION & SANITIZATION ---
+    if (body) {
+        let model = body.model || "";
+        // 0. Model Name Normalization
+        if (typeof model === "string" && model.startsWith("pollinations/enter/")) {
+            body.model = model.replace("pollinations/enter/", "");
+            model = body.model;
+        }
+        // FIX: Remove stream_options (causes 400 on some OpenAI proxies)
+        if (body.stream_options) {
+            delete body.stream_options;
+        }
+        // 1. Azure Tool Limit Fix
+        if ((model.includes("openai") || model.includes("gpt")) && body.tools) {
+            if (body.tools.length > 120) {
+                body.tools = filterTools(body.tools, 120);
+            }
+        }
+        // 2. Vertex/Gemini Schema Fix
+        if (model.includes("gemini") && body.tools) {
+            body.tools = sanitizeTools(body.tools);
+        }
+        // Re-serialize body
+        options.body = JSON.stringify(body);
+    }
+    // Ensure Headers
+    const headers = new Headers(options.headers || {});
+    headers.set("Authorization", `Bearer ${apiKey}`);
+    headers.set("Content-Type", "application/json");
+    options.headers = headers;
+    logDebug(`Req: ${url}`, body);
+    try {
+        const response = await global.fetch(url, options);
+        // Log response status
+        // We clone to read text for debugging errors
+        if (!response.ok) {
+            try {
+                const clone = response.clone();
+                const text = await clone.text();
+                logDebug(`Res (Error): ${response.status}`, text);
+            }
+            catch (e) {
+                logDebug(`Res (Error): ${response.status} (Read failed)`);
+            }
+        }
+        else {
+            logDebug(`Res (OK): ${response.status}`);
+        }
+        return response;
+    }
+    catch (e) {
+        logDebug(`Fetch Error: ${e.message}`);
+        throw e;
+    }
+};

package/dist/provider_v1.d.ts

@@ -0,0 +1 @@
+export declare const createPollinationsFetch: (apiKey: string) => (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;

package/dist/provider_v1.js

@@ -0,0 +1,135 @@
+// Removed invalid imports
+import * as fs from 'fs';
+// --- Sanitization Helpers (Ported from Gateway/Upstream) ---
+function safeId(id) {
+    if (!id)
+        return id;
+    if (id.length > 30)
+        return id.substring(0, 30);
+    return id;
+}
+function logDebug(message, data) {
+    try {
+        const timestamp = new Date().toISOString();
+        let logMsg = `[${timestamp}] ${message}`;
+        if (data) {
+            logMsg += `\n${JSON.stringify(data, null, 2)}`;
+        }
+        fs.appendFileSync('/tmp/opencode_pollinations_debug.log', logMsg + '\n\n');
+    }
+    catch (e) {
+        // ignore logging errors
+    }
+}
+function sanitizeTools(tools) {
+    if (!Array.isArray(tools))
+        return tools;
+    const cleanSchema = (schema) => {
+        if (!schema || typeof schema !== "object")
+            return;
+        if (schema.optional !== undefined)
+            delete schema.optional;
+        if (schema.ref !== undefined)
+            delete schema.ref;
+        if (schema["$ref"] !== undefined)
+            delete schema["$ref"];
+        if (schema.properties) {
+            for (const key in schema.properties)
+                cleanSchema(schema.properties[key]);
+        }
+        if (schema.items)
+            cleanSchema(schema.items);
+    };
+    return tools.map((tool) => {
+        const newTool = { ...tool };
+        if (newTool.function && newTool.function.parameters) {
+            cleanSchema(newTool.function.parameters);
+        }
+        return newTool;
+    });
+}
+function filterTools(tools, maxCount = 120) {
+    if (!Array.isArray(tools))
+        return [];
+    if (tools.length <= maxCount)
+        return tools;
+    const priorities = [
+        "bash", "read", "write", "edit", "webfetch", "glob", "grep",
+        "searxng_remote_search", "deepsearch_deep_search", "google_search",
+        "task", "todowrite"
+    ];
+    const priorityTools = tools.filter((t) => priorities.includes(t.function.name));
+    const otherTools = tools.filter((t) => !priorities.includes(t.function.name));
+    const slotsLeft = maxCount - priorityTools.length;
+    const othersKept = otherTools.slice(0, Math.max(0, slotsLeft));
+    logDebug(`[POLLI-PLUGIN] Filtering tools: ${tools.length} -> ${priorityTools.length + othersKept.length}`);
+    return [...priorityTools, ...othersKept];
+}
+// --- Fetch Implementation ---
+export const createPollinationsFetch = (apiKey) => async (input, init) => {
+    let url = input.toString();
+    const options = init || {};
+    let body = null;
+    if (options.body && typeof options.body === "string") {
+        try {
+            body = JSON.parse(options.body);
+        }
+        catch (e) {
+            // Not JSON, ignore
+        }
+    }
+    // --- INTERCEPTION & SANITIZATION ---
+    if (body) {
+        let model = body.model || "";
+        // 0. Model Name Normalization
+        if (typeof model === "string" && model.startsWith("pollinations/enter/")) {
+            body.model = model.replace("pollinations/enter/", "");
+            model = body.model;
+        }
+        // FIX: Remove stream_options (causes 400 on some OpenAI proxies)
+        if (body.stream_options) {
+            delete body.stream_options;
+        }
+        // 1. Azure Tool Limit Fix
+        if ((model.includes("openai") || model.includes("gpt")) && body.tools) {
+            if (body.tools.length > 120) {
+                body.tools = filterTools(body.tools, 120);
+            }
+        }
+        // 2. Vertex/Gemini Schema Fix
+        if (model.includes("gemini") && body.tools) {
+            body.tools = sanitizeTools(body.tools);
+        }
+        // Re-serialize body
+        options.body = JSON.stringify(body);
+    }
+    // Ensure Headers
+    const headers = new Headers(options.headers || {});
+    headers.set("Authorization", `Bearer ${apiKey}`);
+    headers.set("Content-Type", "application/json");
+    options.headers = headers;
+    logDebug(`Req: ${url}`, body);
+    try {
+        const response = await global.fetch(url, options);
+        // Log response status
+        // We clone to read text for debugging errors
+        if (!response.ok) {
+            try {
+                const clone = response.clone();
+                const text = await clone.text();
+                logDebug(`Res (Error): ${response.status}`, text);
+            }
+            catch (e) {
+                logDebug(`Res (Error): ${response.status} (Read failed)`);
+            }
+        }
+        else {
+            logDebug(`Res (OK): ${response.status}`);
+        }
+        return response;
+    }
+    catch (e) {
+        logDebug(`Fetch Error: ${e.message}`);
+        throw e;
+    }
+};

package/dist/server/commands.d.ts

@@ -0,0 +1,10 @@
+interface CommandResult {
+    handled: boolean;
+    response?: string;
+    error?: string;
+}
+export declare function handleCommand(command: string): Promise<CommandResult>;
+export declare function createCommandHooks(): {
+    'tui.command.execute': (input: any, output: any) => Promise<void>;
+};
+export {};