opencode-pollinations-plugin 6.0.0 → 6.1.0-beta.10

package/README.md

@@ -1,119 +1,172 @@
-# 🌸 Pollinations AI Plugin for OpenCode
+# 🌸 Pollinations AI Plugin for OpenCode (v6.1-beta)
 
 <div align="center">
-  <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="150">
+  <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>
+  <b>The Bridge between OpenCode and the Pollinations.ai Ecosystem.</b>
   <br>
-  Access 25+ AI models with Vision, Reasoning, and Tools support.
+  Access unlimited free AI models or premium enterprise models directly within your editor.
 </div>
 
 <div align="center">
 
-![Version](https://img.shields.io/badge/version-6.0.0--beta.25-blue.svg)
+![Version](https://img.shields.io/badge/version-6.1.0--beta.10-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
-![Status](https://img.shields.io/badge/status-Stable-brightgreen.svg)
-
-[📜 Changelog](./CHANGELOG.md) | [🛣️ Roadmap](./ROADMAP.md)
+![Status](https://img.shields.io/badge/status-Beta-orange.svg)
 
 </div>
 
----
-
-## ✨ Features
-
-- **👁️ Vision Support**: Send images to AI models (OpenAI, Claude, Gemini, Kimi)
-- **🧠 Reasoning Models**: Access advanced thinking models (DeepSeek, Kimi, Perplexity)
-- **🛠️ Native Tools**: Full function calling support for compatible models
-- **🔐 Secure Auth**: Native OpenCode `/connect` integration
-- **🔄 Hot-Reload**: Change API keys without restarting OpenCode
-
----
-
-## 🐝 Understanding Pollen & Tiers
-
-**Pollen** is Pollinations' unified credit system. $1 ≈ 1 Pollen.
-
-| Tier | Daily Grant | Requirement |
-|:-----|:------------|:------------|
-| 🦠 **Microbe** | 0.1 Pollen | Flagged accounts |
-| 🌱 **Spore** | 1 Pollen | Sign up |
-| 🌿 **Seed** | 3 Pollen | Active GitHub dev (8+ points) |
-| 🌸 **Flower** | 10 Pollen | Published app |
-| 🍯 **Nectar** | 20 Pollen | Major contributor |
-
-> 💡 This plugin was published to the OpenCode ecosystem, granting its author **Flower** tier (10 Pollen/day).
-
----
+## 📖 Philosophy: Open AI for Creators
 
-## 🚀 Quick Start
+> **"No closed doors, no corporate hoops — just good tools and good people."**
 
-### 1. Install Plugin
-```bash
-npm install -g opencode-pollinations-plugin
-npx opencode-pollinations-plugin
-```
+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.
 
-### 2. Connect Your Account
-```
-/connect
-```
-Select **pollinations** → Enter your API key from [enter.pollinations.ai](https://enter.pollinations.ai)
+## 📸 Gallery
 
-### 3. Start Using
-Select any `pollinations/*` model in OpenCode and chat!
-
----
-
-## 👁️ Vision Support
-
-The following models support image input:
+<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>
 
-| Model | Vision | Reasoning | Tools |
-|-------|:------:|:---------:|:-----:|
-| `openai` / `openai-large` | ✅ | - | ✅ |
-| `gemini` / `gemini-search` | ✅ | - | ✅ |
-| `claude` / `claude-large` | ✅ | - | ✅ |
-| `kimi` | ✅ | ✅ | - |
-| `openai-audio` | ✅ | - | ✅ |
+<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>
 
-**Usage**: Simply paste an image in the chat or use an image URL. The plugin handles encoding automatically.
+<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>
 
----
+<p align="center">
+  <img src="https://github.com/fkom13/opencode-pollinations-plugin/raw/main/docs/images/free_add.png" alt="Free Chat Example" width="800">
+  <br>
+  <em>Free Universe Chat (Supported by Pollinations Ads)</em>
+</p>
 
-## 📊 Available Models (25+)
+<p align="center">
+  <img src="https://github.com/fkom13/opencode-pollinations-plugin/raw/main/docs/images/plan_1.png" alt="Plan Build Step 1" width="400">
+  <img src="https://github.com/fkom13/opencode-pollinations-plugin/raw/main/docs/images/plan_2.png" alt="Plan Build Step 2" width="400">
+  <br>
+  <em>Integrated Plan Building Workflow</em>
+</p>
 
-### Text/Chat Models
-- **OpenAI**: `openai`, `openai-fast`, `openai-large` 
-- **Gemini**: `gemini`, `gemini-fast`, `gemini-search`, `gemini-large` 💎
-- **Claude**: `claude-fast`, `claude`, `claude-large` 💎
-- **Reasoning**: `deepseek`, `kimi`, `perplexity-reasoning`
-- **Code**: `qwen-coder`, `mistral`
-- **Fast**: `nova-fast`, `grok`
+## ✨ Features
 
-### Paid-Only Models (💎)
-These require purchased credits (not daily grants):
-- `claude-large`, `gemini-large`, `veo`, `seedream-pro`
+- **🌍 Free Universe**: Access generic models (`openai`, `mistral`, `gemini`) for **FREE**, unlimited time, no API key required.
+- **🛡️ Robust Quota System (New v6.1)**: Local "Ledger" technology (`~/.pollinations/usage_history.json`) ensures 100% accurate usage tracking, zero lag, and no wallet drain.
+- **🚀 Pro Mode**: Connect your Pollinations API Key to access Premium Models (`claude-3-opus`, `gpt-4o`, `deepseek-coder`).
+- **🔐 Limited Key Support**: Use keys restricted to "Generation Only". The plugin automatically disables Advanced Features (Dashboard/Quota) but allows full generation in Manual Mode.
+- **🛡️ 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.
+    - **Smart Mode Switching**: Prevents Limited Keys from entering "Pro" mode to avoid confusing errors.
+- **📊 Real-time Dashboard**: Track your **Pollen** usage, Tier Status, and Wallet Balance inside OpenCode.
+- **🔇 Stealth Mode**: Status notifications are now strictly limited to Pollinations Enter (Paid) sessions. No more cluttered notifications when using other providers like Nvidia or Google AI.
 
----
+### 📚 Documentation
 
-## 🔧 Commands
+- **[User Manual](docs/technical/manual.md)**
+- **[API Reference](docs/technical/api_reference.md)**
+- **[Architecture](docs/technical/architecture.md)**
 
-```
-/pollinations usage       # View Pollen balance
-/pollinations usage full  # Detailed model breakdown
-/pollinations status      # Plugin health check
-```
+## 🐝 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!
+
+### 🐧 Platform Support & Dynamic Ports (v5.4.6+)
+This plugin is **true Cross-Platform** (Windows, macOS, Linux).
+- **Dynamic Port Allocation**: No more port conflicts! The plugin automatically finds an available port on startup.
+- **Tools Support**: Using tools with Gemini (Free) triggers an **Automatic Intelligent Fallback** to OpenAI to ensure your workflow never breaks.
+
+> **Note**: Legacy static port (10001) logic has been replaced with system-assigned ports (0). This eliminates "Address in use" errors and effectively removes the need for Linux-specific `fuser` commands, making the plugin fully **Cross-Platform**.
+
+This plugin is part of the **OpenCode Ecosystem**.
+
+### Option 1: NPM (Instant Setup) (Recommended)
+This method automatically configures OpenCode to load the plugin.
+
+1. Install global:
+   ```bash
+   npm install -g opencode-pollinations-plugin
+   ```
+2. Run the Auto-Setup (Magic):
+   ```bash
+   npx opencode-pollinations-plugin
+   ```
+   *This detects your OpenCode config and injects the plugin path automatically.*
+
+### Option 2: Manual Configuration
+1. Install globally as above.
+2. Edit `~/.config/opencode/opencode.json`:
+   ```json
+   {
+     "plugin": [
+       "opencode-pollinations-plugin"
+     ]
+   }
+   ```
+   *Note: If OpenCode fails to find it, use the absolute path to the global install.*
+
+## 🚀 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-fast` (GPT-OSS 20b)
+- Model: `mistral` (Mistral Small 3.1)
+- ...
+
+### 🔑 Configuration (API Key)
+
+1.  Run the setup command:
+    ```bash
+    /connect
+    ```
+2.  Choose "pollinations" and enter your key if you have one (or leave blank for free tier).
+3.  **IMPORTANT**: You must **restart OpenCode** for the model list to update with your new tier (e.g. to see Paid models).
+
+### 🤖 Models
+
+### 🔑 Types de Clés Supportés
+- **Clés Standard (`sk-...`)**: Accès complet (Modèles + Dashboard Usage + Quota).
+- **Clés Limitées**: Accès Génération uniquement. Le dashboard affichera une alerte de restriction.
+- **Support Legacy**: Les anciennes clés (`sk_...`) sont aussi acceptées.
 
 ## 🔗 Links
 
-- **Get API Key**: [enter.pollinations.ai](https://enter.pollinations.ai)
-- **Discord**: [Join Community](https://discord.gg/pollinations-ai-885844321461485618)
-- **GitHub**: [Plugin Repository](https://github.com/fkom13/opencode-pollinations-plugin)
-
----
+- **Sign up Pollinations Beta (more and best free tiers access and paids models)**: [pollinations.ai](https://enter.pollinations.ai)
+- **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
 

package/dist/index.js

@@ -1,11 +1,12 @@
 import * as http from 'http';
 import * as fs from 'fs';
 import { generatePollinationsConfig } from './server/generate-config.js';
-import { loadConfig, saveConfig } from './server/config.js';
+import { loadConfig } from './server/config.js';
 import { handleChatCompletion } from './server/proxy.js';
-import { createToastHooks, setGlobalClient } from './server/toast.js';
+import { createToastHooks, createToolHooks, setGlobalClient } from './server/toast.js';
 import { createStatusHooks } from './server/status.js';
-import { createCommandHooks } from './server/commands.js';
+import { createCommandHooks, setClientForCommands } from './server/commands.js';
+import { createToolRegistry } from './tools/index.js';
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const LOG_FILE = '/tmp/opencode_pollinations_v4.log';
@@ -15,17 +16,12 @@ function log(msg) {
     }
     catch (e) { }
 }
-// === PROXY SERVER (Singleton with Fixed Port) ===
-const DEFAULT_PORT = 18888;
-const GLOBAL_SERVER_KEY = '__POLLINATIONS_PROXY_SERVER__';
+// Port killing removed: Using dynamic ports.
 const startProxy = () => {
-    // Check if server exists in global scope (survives module reloads)
-    if (global[GLOBAL_SERVER_KEY]) {
-        log(`[Proxy] Reusing existing global server on port ${DEFAULT_PORT}`);
-        return Promise.resolve(DEFAULT_PORT);
-    }
     return new Promise((resolve) => {
         const server = http.createServer(async (req, res) => {
+            // ... (Request Handling) ...
+            // We reuse the existing logic structure but simplified startup
             log(`[Proxy] Request: ${req.method} ${req.url}`);
             res.setHeader('Access-Control-Allow-Origin', '*');
             res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
@@ -67,156 +63,40 @@ const startProxy = () => {
             res.writeHead(404);
             res.end("Not Found");
         });
-        // Try fixed port first, fallback to dynamic if occupied
-        const tryListen = (port, fallbackToDynamic) => {
-            server.listen(port, '127.0.0.1', () => {
-                // @ts-ignore
-                const assignedPort = server.address().port;
-                global[GLOBAL_SERVER_KEY] = server;
-                log(`[Proxy] Started v${require('../package.json').version} on port ${assignedPort}${port === 0 ? ' (dynamic fallback)' : ''}`);
-                resolve(assignedPort);
-            });
-            server.on('error', (e) => {
-                if (e.code === 'EADDRINUSE' && fallbackToDynamic) {
-                    log(`[Proxy] Port ${port} in use, falling back to dynamic port`);
-                    server.removeAllListeners('error');
-                    tryListen(0, false); // Try dynamic port
-                }
-                else {
-                    log(`[Proxy] Fatal Error: ${e}`);
-                    resolve(0);
-                }
-            });
-        };
-        tryListen(DEFAULT_PORT, true);
+        // Listen on random port (0) to avoid conflicts (CLI/IDE)
+        server.listen(0, '127.0.0.1', () => {
+            // @ts-ignore
+            const assignedPort = server.address().port;
+            log(`[Proxy] Started v${require('../package.json').version} (Dynamic Port) on port ${assignedPort}`);
+            resolve(assignedPort);
+        });
+        server.on('error', (e) => {
+            log(`[Proxy] Fatal Error: ${e}`);
+            resolve(0);
+        });
     });
 };
-// === AUTH HOOK: Native /connect Integration ===
-// Auth Hook moved inside plugin to access context
 // === PLUGIN EXPORT ===
 export const PollinationsPlugin = async (ctx) => {
-    log(`Plugin Initializing v${require('../package.json').version}...`);
-    // START PROXY on fixed port
+    const v = require('../package.json').version;
+    log(`Plugin Initializing v${v}...`);
+    console.log(`🚀 POLLINATIONS PLUGIN v${v} LOADED 🚀`);
+    // START PROXY
     const port = await startProxy();
     const localBaseUrl = `http://127.0.0.1:${port}/v1`;
     setGlobalClient(ctx.client);
+    setClientForCommands(ctx.client);
     const toastHooks = createToastHooks(ctx.client);
     const commandHooks = createCommandHooks();
-    // Helper: Refresh provider config (for hot-reload after /connect)
-    let isRefreshing = false;
-    const refreshProviderConfig = async () => {
-        if (isRefreshing)
-            return;
-        isRefreshing = true;
-        try {
-            log('[Event] Refreshing provider config after auth update...');
-            const modelsArray = await generatePollinationsConfig();
-            const modelsObj = {};
-            for (const m of modelsArray) {
-                modelsObj[m.id] = m;
-            }
-            const version = require('../package.json').version;
-            // CRITICAL: Fetch current config first to avoid overwriting other providers
-            let currentConfig = {};
-            try {
-                // Try to fetch existing config to preserve other providers
-                const response = await ctx.client.fetch('/config');
-                if (response.ok) {
-                    currentConfig = await response.json();
-                }
-            }
-            catch (err) {
-                log(`[Event] Warning: Could not fetch current config: ${err}`);
-            }
-            // Safe Merge
-            if (!currentConfig.provider)
-                currentConfig.provider = {};
-            currentConfig.provider.pollinations = {
-                id: 'openai',
-                name: `Pollinations AI (v${version})`,
-                options: {
-                    baseURL: localBaseUrl,
-                    apiKey: 'plugin-managed',
-                },
-                models: modelsObj
-            };
-            // Use Server API to update config with the MERGED object
-            await ctx.client.fetch('/config', {
-                method: 'PATCH',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({
-                    provider: currentConfig.provider
-                })
-            });
-            log(`[Event] Provider config refreshed with ${Object.keys(modelsObj).length} models.`);
-        }
-        catch (e) {
-            log(`[Event] Failed to refresh provider config: ${e}`);
-        }
-        finally {
-            // Debounce: prevent another refresh for 5 seconds
-            setTimeout(() => { isRefreshing = false; }, 5000);
-        }
-    };
+    // Build tool registry (conditional on API key presence)
+    const toolRegistry = createToolRegistry();
+    log(`[Tools] ${Object.keys(toolRegistry).length} tools registered`);
     return {
-        // AUTH HOOK: Native /connect integration (INLINED)
-        auth: {
-            provider: 'pollinations',
-            loader: async (auth, provider) => {
-                log('[AuthHook] loader() called');
-                try {
-                    const authData = await auth();
-                    if (authData && 'key' in authData) {
-                        const k = authData.key;
-                        saveConfig({ apiKey: k });
-                        return { apiKey: k };
-                    }
-                }
-                catch (e) {
-                    log(`[AuthHook] loader error: ${e}`);
-                }
-                const config = loadConfig();
-                if (config.apiKey)
-                    return { apiKey: config.apiKey };
-                return {};
-            },
-            methods: [{
-                    type: 'api',
-                    label: 'Pollinations API Key',
-                    prompts: [{
-                            type: 'text',
-                            key: 'apiKey',
-                            message: 'Enter Pollinations API Key (starts with sk_)',
-                            validate: (v) => (!v || v.length < 10) ? 'Invalid key' : undefined
-                        }],
-                    authorize: async (inputs) => {
-                        log(`[AuthHook] authorize() called`);
-                        if (!inputs?.apiKey)
-                            return { type: 'failed' };
-                        try {
-                            const r = await fetch('https://gen.pollinations.ai/text/models', {
-                                headers: { 'Authorization': `Bearer ${inputs.apiKey}` }
-                            });
-                            if (r.ok) {
-                                log('[AuthHook] Success. Saving & Refreshing Config...');
-                                saveConfig({ apiKey: inputs.apiKey });
-                                // CRITICAL: Refresh config IMMEDIATELY after successful auth
-                                await refreshProviderConfig();
-                                return { type: 'success', key: inputs.apiKey };
-                            }
-                        }
-                        catch (e) {
-                            log(`[AuthHook] Auth error: ${e}`);
-                        }
-                        return { type: 'failed' };
-                    }
-                }]
-        },
-        // Event hook removed (logic moved to authorize)
-        event: async ({ event }) => { },
+        tool: toolRegistry,
         async config(config) {
             log("[Hook] config() called");
-            // Generate models based on current auth state
+            // STARTUP only - No complex hot reload logic
+            // The user must restart OpenCode to refresh this list if they change keys.
             const modelsArray = await generatePollinationsConfig();
             const modelsObj = {};
             for (const m of modelsArray) {
@@ -224,19 +104,18 @@ export const PollinationsPlugin = async (ctx) => {
             }
             if (!config.provider)
                 config.provider = {};
+            // Dynamic Provider Name
             const version = require('../package.json').version;
             config.provider['pollinations'] = {
-                id: 'openai',
+                id: 'pollinations',
                 name: `Pollinations AI (v${version})`,
-                options: {
-                    baseURL: localBaseUrl,
-                    apiKey: 'plugin-managed', // Key is managed by auth hook
-                },
+                options: { baseURL: localBaseUrl },
                 models: modelsObj
             };
             log(`[Hook] Registered ${Object.keys(modelsObj).length} models.`);
         },
         ...toastHooks,
+        ...createToolHooks(ctx.client),
         ...createStatusHooks(ctx.client),
         ...commandHooks
     };

package/dist/server/commands.d.ts

@@ -9,8 +9,10 @@ interface CommandResult {
     response?: string;
     error?: string;
 }
+export declare function setClientForCommands(client: any): void;
 export declare function handleCommand(command: string): Promise<CommandResult>;
 export declare function createCommandHooks(): {
     'tui.command.execute': (input: any, output: any) => Promise<void>;
+    'command.execute.before': (input: any, output: any) => Promise<void>;
 };
 export {};