opencode-pollinations-plugin 6.1.0-beta.2 → 6.1.0-beta.23

package/README.md

@@ -1,117 +1,297 @@
 # 🌸 Pollinations AI Plugin for OpenCode
 
 <div align="center">
-  <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="150">
-  <br>
-  <b>The Bridge between OpenCode and the Pollinations.ai Ecosystem</b>
-  <br>
-  Access 25+ AI models with Vision, Reasoning, and Tools support.
-</div>
-
-<div align="center">
-
-![Version](https://img.shields.io/badge/version-6.0.0--beta.25-blue.svg)
+  <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="180">
+  <br><br>
+  <b>The most complete bridge between OpenCode and the Pollinations.ai ecosystem.</b><br>
+  Free AI models, multimodal generation, and smart quota management — directly in your editor.
+  <br><br>
+
+![Version](https://img.shields.io/badge/version-6.1.0--beta.22-blue.svg)
+![Downloads](https://img.shields.io/npm/dt/opencode-pollinations-plugin?label=downloads&color=brightgreen)
 ![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)
+![OpenCode](https://img.shields.io/badge/OpenCode-Plugin-purple.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
+> **"No closed doors, no corporate hoops — just good tools and good people."**
+>
+> Pollinations.ai is an open-source platform built by and for the creative community. This plugin brings it entirely inside OpenCode: text, image, audio, video, music, diagrams, and more — with a transparent fallback system that means you're *never* blocked.
 
 ---
 
-## 🐝 Understanding Pollen & Tiers
-
-**Pollen** is Pollinations' unified credit system. $1 ≈ 1 Pollen.
+## ✨ What's New in v6.1-beta.22
 
-| 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 |
+The jump from v5.9 to v6.1 is not incremental. The plugin has grown from a smart proxy into a **full multimodal agent toolkit**:
 
-> 💡 This plugin was published to the OpenCode ecosystem, granting its author **Flower** tier (10 Pollen/day).
+- **15+ native tools** for generation, design, and media processing — usable directly in OpenCode's agent mode
+- **Smart Fetch Quota**: 100% exact math fetching directly from Pollinations API for quota verification (zero local cache)
+- **Dynamic Pricing**: Tool costs are estimated live based on Tinybird API model stats. Token models have a built-in max theoretical threshold limit (Cost Guard).
+- **Stealth notifications**: status toasts now only fire in relevant contexts, no more noise
+- **Background removal** with multi-key rotation and automatic fallback to free provider
+- **Video, music, audio generation** via the Pollinations API
+- **Web search + scraping** integrated as agent tools
 
 ---
 
 ## 🚀 Quick Start
 
-### 1. Install Plugin
 ```bash
+# Install globally
 npm install -g opencode-pollinations-plugin
-npx opencode-pollinations-plugin
 ```
 
-### 2. Connect Your Account
+Then in OpenCode:
 ```
 /connect
 ```
-Select **pollinations** → Enter your API key from [enter.pollinations.ai](https://enter.pollinations.ai)
+Select **pollinations** → Enter your API key from [enter.pollinations.ai](https://enter.pollinations.ai), or leave blank to use the free tier.
+
+Select any `pollinations/*` text model and start chatting. **No key required for text.**
 
-### 3. Start Using
-Select any `pollinations/*` model in OpenCode and chat!
+> ⚠️ **Note:** Image generation (`gen_image`) requires a Pollinations API Key. Text models remain free.
+
+> ⚠️ After connecting a new key, restart OpenCode once for the model list to update.
+
+---
+
+## 🌐 Free Universe — No Key Required
+
+Access a wide range of models with **zero setup**, supported by Pollinations' ad model:
+
+| Model | Speed | Context | Notes |
+|-------|:-----:|:-------:|-------|
+| `openai` / `openai-large` | Fast | 128k | GPT-4o class |
+| `gemini` / `gemini-search` | Fast | 1M | Google Gemini |
+| `mistral` / `qwen-coder` | Fast | 32k | Code-focused |
+| `nova-fast` / `grok` | Very Fast | 32k | Quick tasks |
+| `deepseek` / `kimi` | Medium | 128k | Reasoning |
+
+> 💡 Using Gemini with tool calls? The plugin auto-detects incompatibilities and transparently falls back to OpenAI — your workflow never breaks.
+
+---
+
+## 💎 Pro Mode — Unlock Premium Models
+
+Connect your [Pollinations API key](https://enter.pollinations.ai) to access enterprise-grade models charged in **Pollen** (the unified credit, ~$1 = 1 Pollen):
+
+| Model | Provider | Notes |
+|-------|----------|-------|
+| `claude` / `claude-large` | Anthropic | Requires wallet credits |
+| `gemini-large` | Google | Requires wallet credits |
+| `gpt-4o` / `openai-large` | OpenAI | Daily grant available |
+| `deepseek-coder` | DeepSeek | Daily grant available |
+
+### 🛡️ Safety Net — You're Never Blocked
+
+If your quota or wallet runs low mid-session, the plugin switches automatically to a free model, injects a visible warning in the response stream, and continues. No errors. No broken sessions.
+
+---
+
+## 🔧 Agent Tools (v6.1 — New)
+
+When OpenCode uses the plugin in agent mode, it gets access to a rich toolbox organized in three categories:
+
+### 🎨 Pollinations Generation Tools
+
+These tools call the Pollinations APIs directly, enabling the AI to generate media as part of its reasoning:
+
+| Tool | Description |
+|------|-------------|
+| `gen_image` | Generate images from a text prompt (Flux, SDXL, etc.) **[Requires Key]** |
+| `gen_audio` | Generate speech or sound effects |
+| `gen_music` | Generate music from a description |
+| `gen_video` | Generate short video clips |
+| `transcribe_audio` | Transcribe an audio file to text |
+| `deepsearch` | Multi-step AI-powered research |
+| `search_crawl_scrape` | Web search with full page scraping |
+| `beta_discovery` | Probe undocumented model parameters (400 validation extraction) |
+
+### 🖌️ Design Tools
+
+| Tool | Description |
+|------|-------------|
+| `gen_diagram` | Generate diagrams (flowcharts, architecture, etc.) |
+| `gen_palette` | Create color palettes from a description or image |
+| `gen_qrcode` | Generate styled QR codes |
+
+### ⚡ Power Tools
+
+| Tool | Description |
+|------|-------------|
+| `remove_background` | Remove image backgrounds (free or BackgroundCut HD) |
+| `rmbg_keys` | Manage BackgroundCut API keys with rotation |
+| `extract_audio` | Extract the audio track from a video file |
+| `extract_frames` | Extract frames from a video at a given interval |
+| `file_to_url` | Upload a local file and return a public URL |
+
+> **Background Removal** supports multi-key rotation: if one BackgroundCut key is exhausted or rate-limited, the plugin automatically rotates to the next available key, then falls back to the free provider if all keys fail.
 
 ---
 
 ## 👁️ Vision Support
 
-The following models support image input:
+Paste images directly into the chat or use an image URL. The plugin handles encoding automatically.
 
 | Model | Vision | Reasoning | Tools |
 |-------|:------:|:---------:|:-----:|
-| `openai` / `openai-large` | ✅ | - | ✅ |
-| `gemini` / `gemini-search` | ✅ | - | ✅ |
-| `claude` / `claude-large` | ✅ | - | ✅ |
-| `kimi` | ✅ | ✅ | - |
-| `openai-audio` | ✅ | - | ✅ |
+| `openai` / `openai-large` | ✅ | — | ✅ |
+| `gemini` / `gemini-search` | ✅ | — | ✅ |
+| `claude` / `claude-large` | ✅ | — | ✅ |
+| `kimi` | ✅ | ✅ | — |
+| `openai-audio` | ✅ | — | ✅ |
+
+---
+
+## 💰 Understanding Pollen & Tiers
+
+**Pollen** is Pollinations' unified credit system. **$1 ≈ 1 Pollen.**
+
+Every registered user receives a **daily Pollen grant** based on their tier:
+
+| 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 |
+
+> 🌸 Publishing this plugin to the OpenCode ecosystem earned its author **Flower** tier (10 Pollen/day). [Register here to claim yours.](https://enter.pollinations.ai)
+
+Certain models (`claude-large`, `gemini-large`, `veo`, `seedream-pro`) are **Paid-Only**: they require wallet credits on top of (or instead of) daily grants.
+
+---
 
-**Usage**: Simply paste an image in the chat or use an image URL. The plugin handles encoding automatically.
+## 📊 Commands
+
+```
+/pollinations usage          # View Pollen balance + tier status
+/pollinations usage full     # Detailed per-model breakdown
+/pollinations mode [manual|alwaysfree|pro]   # Change routing mode
+/pollinations status         # Plugin health check
+/pollinations config [key] [value]   # Read or write config values
+/pollinations fallback <main> [agent]  # Configure fallback models
+/pollinations help           # Full command reference
+```
+
+Aliases: `/poll` works as a shorthand for all commands.
+
+### Config Keys
+
+| Key | Values | Description |
+|-----|--------|-------------|
+| `status_gui` | `none` / `alert` / `all` | Toast verbosity |
+| `logs_gui` | `none` / `error` / `verbose` | Technical log verbosity |
+| `threshold_tier` | `0-100` | Alert threshold for tier (%) |
+| `threshold_wallet` | `0-100` | Safety Net trigger ($) |
+| `status_bar` | `true` / `false` | Status bar widget |
 
 ---
 
-## 📊 Available Models (25+)
+## 🔑 API Key Types
+
+| Type | Access |
+|------|--------|
+| **Standard (`pk_...`)** | Full access: models, usage dashboard, quota |
+| **Limited** | Generation only. Dashboard shows a restriction alert. The plugin auto-switches to Manual mode to avoid quota errors. |
+| **Legacy (`sk_...`)** | Accepted for backward compatibility |
 
-### 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`
+---
 
-### Paid-Only Models (💎)
-These require purchased credits (not daily grants):
-- `claude-large`, `gemini-large`, `veo`, `seedream-pro`
+## 🛠️ Routing Modes
+
+| Mode | Behavior |
+|------|----------|
+| `manual` | You choose the model, no automatic switching |
+| `alwaysfree` | Only free models, never charges Pollen |
+| `pro` | Enterprise models with automatic free fallback when quota/wallet is low |
 
 ---
 
-## 🔧 Commands
+## 🏗️ Architecture (Summary)
+
+The plugin runs a **local HTTP proxy** on a dynamically assigned port (system port 0 — no conflicts, cross-platform). OpenCode points its `pollinations` provider at this proxy. The proxy reads your config, checks quota, applies model-specific sanitizations, and forwards requests to the correct Pollinations endpoint.
 
 ```
-/pollinations usage       # View Pollen balance
-/pollinations usage full  # Detailed model breakdown
-/pollinations status      # Plugin health check
+OpenCode TUI
+    │  POST /v1/chat/completions
+    ▼
+Local Proxy (Dynamic Port)
+    ├── Safety Net Logic (quota check, fallback)
+    ├── Model Sanitization (Azure/Vertex/Gemini/Kimi)
+    └── Route to:
+        ├── text.pollinations.ai  (Free Universe)
+        └── gen.pollinations.ai   (Enterprise Universe)
 ```
 
+Config is read from (highest priority first):
+1. `~/.pollinations/config.json`
+2. `~/.local/share/opencode/auth.json`
+3. `~/.config/opencode/opencode.json`
+
+---
+
+## 🗺️ Roadmap
+
+### ✅ Shipped (v5.x → v6.1-beta)
+- Free + Enterprise proxy with transparent fallback (Safety Net)
+- Dynamic port allocation — cross-platform (no more `fuser`, no port conflicts)
+- Pollen/tier quota tracking with Smart Fetch API (no local logging)
+- Dynamic Pricing (Tinybird stats) and Cost Guard max thresholds
+- Agent tools: image, audio, music, video generation
+- Agent tools: web search, scraping, deep research
+- Design tools: diagrams, palettes, QR codes
+- Power tools: background removal with key rotation, frame/audio extraction
+- Stealth notification mode (toasts only in relevant sessions)
+- Limited-key support with automatic mode switching
+- Gemini tools auto-fallback to OpenAI
+- Enterprise schema sanitization (Azure, Vertex, Bedrock, Kimi)
+
+### 🔜 Next (v6.2 — v6.5, 2026)
+- **Config file watcher** — hot-reload without restarting OpenCode
+- **Signature map rotation** — LRU eviction to prevent unbounded memory growth
+- **Unit tests** — coverage for `proxy.ts`, `quota.ts`, `tools/`
+- **`/poll status` one-liner** — faster than opening the dashboard
+- **Structured logging** — JSON format, configurable log levels, log rotation
+- **Model search** — `/poll models <query>` to filter the model list
+
+### 🔭 Longer Term (v7.0+, 2027)
+- **Smart Router** — cost-aware and latency-aware model selection
+- **Multi-provider failover** — fallback to OpenRouter if Pollinations is unreachable
+- **Web Dashboard** — browser UI for monitoring, config, and analytics
+- **Team features** — shared quotas and API keys
+- **Persistent memory** — vector DB integration for long-running agents
+
+> Community ideas with the most votes: API usage alerts, conversation export (Markdown/JSON), model comparison mode. Open an issue to vote!
+
+---
+
+## 🤝 Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, code guidelines, and priority areas (testing, docs, i18n, DevOps).
+
+### Areas Where Help Is Needed
+- 🧪 **Testing** — Unit + integration tests for the proxy and tools
+- 📚 **Docs** — User guides, tool examples
+- 🌍 **i18n** — French/English consistency, German and Spanish translations
+- 🎨 **UX** — Command output formatting improvements
+
 ---
 
 ## 🔗 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)
+| Resource | Link |
+|----------|------|
+| Sign up for Pollinations (free tiers + paid models) | [enter.pollinations.ai](https://enter.pollinations.ai) |
+| Pollinations website | [pollinations.ai](https://pollinations.ai) |
+| Pollinations GitHub | [github.com/pollinations/pollinations](https://github.com/pollinations/pollinations) |
+| Discord community | [Join us!](https://discord.gg/pollinations-ai-885844321461485618) |
+| OpenCode ecosystem | [opencode.ai/docs/ecosystem](https://opencode.ai/docs/ecosystem#plugins) |
+| Plugin author | [@fkom13](https://github.com/fkom13) |
 
 ---
 

package/dist/index.js

@@ -1,31 +1,21 @@
 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, migrateLegacyConfig } 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';
-function log(msg) {
-    try {
-        fs.appendFileSync(LOG_FILE, `[${new Date().toISOString()}] ${msg}\n`);
-    }
-    catch (e) { }
-}
-// === PROXY SERVER (Singleton with Fixed Port) ===
-const DEFAULT_PORT = 18888;
-const GLOBAL_SERVER_KEY = '__POLLINATIONS_PROXY_SERVER__';
+import { log } from './server/logger.js';
+import { ModelRegistry } from './server/models/index.js';
+const sessionModels = new Map();
 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 +57,70 @@ 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}...`);
+    log(`[ENV] Keys: ${Object.keys(process.env).filter(k => k.includes('OPENCODE') || k.includes('APP') || k.includes('DATA')).join(', ')}`);
+    console.log(`🚀 POLLINATIONS PLUGIN v${v} LOADED 🚀`);
+    // MIGRATE CONFIG
+    migrateLegacyConfig();
+    // START PROXY
     const port = await startProxy();
     const localBaseUrl = `http://127.0.0.1:${port}/v1`;
+    // INIT MODEL REGISTRY (non-blocking, fire-and-forget)
+    ModelRegistry.refresh().then(() => {
+        const stats = ModelRegistry.stats();
+        log(`[ModelRegistry] Ready: ${stats.image} image, ${stats.video} video, ${stats.audio} audio, ${stats.text} text`);
+        // Démarrage du patcher asynchrone des descriptions des Outils (Phase 1.5)
+        import('./server/models/worker.js').then(module => {
+            module.ToolRegistryWorker.start();
+        }).catch(e => log(`[ToolWorker] Failed to load worker: ${e}`));
+    }).catch(e => log(`[ModelRegistry] Init failed (will use fallback): ${e}`));
     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}`);
+        "chat.message": async (input) => {
+            const m = input.model;
+            if (m) {
+                if (m.modelID && !m.modelID.includes('pollimock-handler')) {
+                    sessionModels.set(input.sessionID, `${m.providerID}/${m.modelID}`);
+                    log(`[Hook] Saved active model ${m.providerID}/${m.modelID} for session ${input.sessionID}`);
                 }
-                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' };
+                else if (m.modelID && m.modelID.includes('pollimock-handler')) {
+                    const prev = sessionModels.get(input.sessionID);
+                    if (prev) {
+                        log(`[Hook] Virtual model triggered. Reverting to ${prev} in 500ms...`);
+                        setTimeout(() => {
+                            ctx.client.tui.executeCommand({ body: { command: `/model ${prev}` } }).catch(console.error);
+                        }, 500);
                     }
-                }]
+                }
+            }
         },
-        // 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 +128,24 @@ export const PollinationsPlugin = async (ctx) => {
             }
             if (!config.provider)
                 config.provider = {};
+            // Dynamic Provider Name
             const version = require('../package.json').version;
+            // Inject Virtual Handler Model
+            modelsObj['pollimock-handler'] = {
+                id: 'pollimock-handler',
+                name: 'Command Handler (Virtual)',
+                options: { hidden: true } // Try to hide from UI if OpenCode supports it
+            };
             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,14 @@ interface CommandResult {
     response?: string;
     error?: string;
 }
+export declare function setClientForCommands(client: any): void;
 export declare function handleCommand(command: string): Promise<CommandResult>;
+export declare function handleUsageCommand(args: string[]): Promise<CommandResult>;
+export declare function handleModelsCommand(args: string[]): Promise<CommandResult>;
+export declare function handlePricingCommand(): Promise<CommandResult>;
+export declare function handleInfosCommand(): 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 {};