opencode-pollinations-plugin 6.1.0-beta.29 → 6.1.0-beta.30

package/README.md

@@ -180,15 +180,31 @@ Certain models (`claude-large`, `gemini-large`, `veo`, `seedream-pro`) are **Pai
 
 Aliases: `/poll` works as a shorthand for all commands.
 
-### Config Keys
+### Config Keys & Agent Understanding
 
+The plugin employs a **strict separation of concerns** between Chat/Conversational settings and Tool (generation/search) settings.
+
+#### 1. Chat Models & Fallbacks
+| Key | Values | Description |
+|-----|--------|-------------|
+| `mode` | `manual` / `alwaysfree` / `pro` | Automatic fallback routing strategy for chat. |
+| `threshold_tier` | `0-100` | Alert threshold percentage for Free Tier quota. |
+| `threshold_wallet` | `0-100` | Alert threshold percentage for Premium Wallet balance. |
+
+#### 2. Tools Protection
+| Key | Values | Description |
+|-----|--------|-------------|
+| `enablePaidTools` | `true` / `false` | Allows generation tools to consume Wallet pollen. |
+| `costConfirmationRequired` | `true` / `false` | Demands validation if a tool estimate exceeds threshold. |
+| `costThreshold` | numeric (e.g., `0.05`) | Trigger limit in Pollen for the confirmation lock. |
+| `cost_estimator` | `true` / `false` | Shows live cost estimates in tool outputs. |
+
+#### 3. UI & Notifications
 | 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 |
+| `status_gui` | `none` / `alert` / `all` | Toast notification verbosity. |
+| `logs_gui` | `none` / `error` / `verbose` | Technical log verbosity. |
+| `status_bar` | `true` / `false` | Status bar widget visibility. |
 
 ---
 

package/dist/index.js

@@ -100,20 +100,9 @@ export const PollinationsPlugin = async (ctx) => {
     return {
         "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}`);
-                }
-                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);
-                    }
-                }
+            if (m && m.modelID) {
+                sessionModels.set(input.sessionID, `${m.providerID}/${m.modelID}`);
+                log(`[Hook] Saved active model ${m.providerID}/${m.modelID} for session ${input.sessionID}`);
             }
         },
         tool: toolRegistry,
@@ -130,12 +119,6 @@ export const PollinationsPlugin = async (ctx) => {
                 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: 'pollinations',
                 name: `Pollinations AI (v${version})`,

package/dist/server/proxy.js

@@ -258,34 +258,6 @@ export async function handleChatCompletion(req, res, bodyRaw) {
             }
         }
         log(`Incoming Model (OpenCode ID): ${body.model}`);
-        // 0. TEST 4: Virtual Model Handler for Commands
-        if (body.model === 'pollinations/pollimock-handler' || body.model === 'pollimock-handler') {
-            const mockContent = "🚀 **[TEST 4] Modèle Virtuel de Commande !**\n\nCe texte n'a jamais quitté ton ordinateur. La commande `/pollimock` a demandé à OpenCode de se brancher temporairement sur le modèle virtuel `pollimock-handler`.\nLe proxy a intercepté cet appel et répondu instantanément.\n\n✅ L'historique affiche bien le message du Chat, **mais la requête LLM est totalement court-circuitée**.\nC'est la méthode ultime pour créer des vues de configuration via commandes (`/pollinations-config` par ex) sans polluer le crédit ou les LLM tiers !";
-            res.writeHead(200, {
-                'Content-Type': 'text/event-stream',
-                'Cache-Control': 'no-cache',
-                'Connection': 'keep-alive'
-            });
-            const chunk = JSON.stringify({
-                id: 'mock-' + Date.now(),
-                object: 'chat.completion.chunk',
-                created: Math.floor(Date.now() / 1000),
-                model: body.model,
-                choices: [{ index: 0, delta: { role: 'assistant', content: mockContent }, finish_reason: null }]
-            });
-            res.write(`data: ${chunk}\n\n`);
-            const chunkEnd = JSON.stringify({
-                id: 'mock-' + Date.now(),
-                object: 'chat.completion.chunk',
-                created: Math.floor(Date.now() / 1000),
-                model: body.model,
-                choices: [{ index: 0, delta: {}, finish_reason: 'stop' }]
-            });
-            res.write(`data: ${chunkEnd}\n\n`);
-            res.write('data: [DONE]\n\n');
-            res.end();
-            return;
-        }
         // 0. SPECIAL: pollinations/connect (Guide & Status)
         const CONNECT_MODEL_IDS = ['pollinations/connect', 'free/pollinations/connect', 'enter/pollinations/connect', 'connect-pollinations'];
         if (CONNECT_MODEL_IDS.includes(body.model)) {

package/dist/tools/pollinations/polli_config.js

@@ -5,22 +5,23 @@ export const polliConfigTool = tool({
     description: `[CRITICAL TOOL FOR ASSISTANT] View or modify the Pollinations plugin configuration.
 You must strictly understand the 3 INDEPENDENT categories of settings before explaining or changing them:
 
-=== 1. CHAT MODELS & FALLBACKS (Applies ONLY to conversational models, NOT tools) ===
+=== 1. CHAT MODELS & FALLBACKS (Applies ONLY to conversational chat models) ===
 - mode: Dictates fallback rules for the chat.
    * 'manual': No automatic rules.
    * 'alwaysfree': Free tiers first. If 'thresholdsTier' is reached -> fallbacks to Free Universe. NEVER uses Wallet.
    * 'pro': Uses Wallet. If 'thresholdsWallet' is reached -> fallbacks to Free Universe.
 - thresholdsTier: WARNING PERCENTAGE (e.g. 10 for 10%) that triggers chat fallback in 'alwaysfree' mode.
 - thresholdsWallet: WARNING PERCENTAGE (e.g. 50 for 50%) that triggers chat fallback in 'pro' mode.
+*Note: 'enter.agent' or 'free.agent' are fallback conversational models for logic reasoning, THEY DO NOT GENERATE IMAGES OR VIDEOS!*
 
 === 2. TOOLS PROTECTION (Applies ONLY to independent 'polli_' tools like image, video, search) ===
-- enablePaidTools: Allow tools to use the Wallet balance (true/false).
-- costConfirmationRequired: Safety lock for tools. If true, asks user confirmation before running a tool.
-- costThreshold: USD/🌼 limit that triggers the tool confirmation lock.
-- costEstimator: Shows live cost estimates in tool outputs (false = Silent Mode).
+- enablePaidTools: Allow tools to execute models that consume 'Wallet' pollen. If false, tools can only use models that consume 'Freetier' pollen.
+- costConfirmationRequired: Safety lock for tools. If true, the user MUST manually confirm BEFORE executing ANY tool whose cost estimate exceeds the 'costThreshold'.
+- costThreshold: USD/🌼 limit (cost of the tool execution) that triggers the confirmation lock.
+- costEstimator: Shows live cost estimates IN TOOL OUTPUTS (false = Silent Mode).
 
 === 3. UI & NOTIFICATIONS (General display) ===
-- statusBar: Show/Hide the bottom status bar in the OpenCode UI.
+- statusBar: Show/Hide the floating status bar notification in the OpenCode UI.
 
 Use 'action=update' to change these. NEVER confuse Chat Mode with Tools Protection!`,
     args: {

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "opencode-pollinations-plugin",
     "displayName": "Pollinations AI (V5.9)",
-    "version": "6.1.0-beta.29",
+    "version": "6.1.0-beta.30",
     "description": "Native Pollinations.ai Provider Plugin for OpenCode",
     "publisher": "pollinations",
     "repository": {