opencode-pollinations-plugin 6.4.10 → 6.5.1

package/README.fr.md

@@ -1,23 +1,9 @@
-# 🌸 Plugin Pollinations AI pour OpenCode (v6.4.9)
-
-## ✨ Nouveautés v6.4.9
-
-- 🎯 **Quêtes & Gamification** : `polli_quests` + `/poll quests`. Utiliser le plugin complète des quêtes **rétroactivement**.
-- 🆓 **Outils gratuits (sans clé)** — pour **n'importe quel** modèle OpenCode :
-  - `gen_edit_image_free` — génération **et** édition (~20/jour)
-  - `gen_video_free` — texte→vidéo (~5/jour)
-  - `object_remover` / `image_upscaler` / `image_enhancer` — traitement d'image gratuit
-  - `remove_background` — détourage IA gratuit (rmbg / bgeraser)
-- 🔐 **Connexion 1 clic** : `/poll login` + `polli_login`. `/poll connect sk_...` reste disponible.
-- 🧊 **Catalogue modèles complet** : text, image, video, audio, **3D**, **embeddings**, realtime.
-- 🧪 **CI + packaging** : Node ≥ 18, CLI `npx opencode-pollinations-plugin`, tests unit + i18n.
-- 🌍 **6 langues** : en, fr, es, de, it, zh — onboarding et commandes alignés.
-
+# 🌸 Plugin Pollinations AI pour OpenCode (v6.5.0)
 
 <div align="center">
   <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="180">
   <h3>La Passerelle ultime entre OpenCode et l'écosystème Pollinations.ai</h3>
-  <p><em>Accédez à un univers continu de modèles IA de base gratuits, ou exploitez des modèles d'entreprise premium grâce à nos généreux <b>Tiers Gratuits Horaires</b>, directement depuis votre terminal local.</em></p>
+  <p><em>Accédez à un univers continu de modèles IA de base gratuits, ou exploitez des modèles d'entreprise premium grâce à notre système <b>Quest & Paid Pollen</b>, directement depuis votre terminal local.</em></p>
 </div>
 
 <div align="center">
@@ -34,19 +20,23 @@
 
 > **"Pas de portes fermées, pas de contraintes d'entreprise — juste de bons outils et des gens biens."**
 
-**Pollinations.ai** est une plateforme open-source créée par et pour la communauté. Nous offrons une API unifiée et directe pour générer des images, du texte, de l'audio et des vidéos.
+**Pollinations.ai** est une plateforme open-source créée par et pour la communauté. Nous offrons une API unifiée et directe pour générer des images, du texte, de l'audio, de la vidéo et de la 3D.
 
 - 🌍 **Transparent** : Notre code, notre roadmap et nos discussions sont publics.
 - ⚖️ **Économie Juste** : Une monnaie unique (**Pollen 🌻**) pour tous les médias et modèles. Une tarification prévisible et transparente, sans enfermement propriétaire.
 
 ---
 
-## ✨ Nouveautés de la V6.4
+## ✨ Nouveautés v6.5.0
 
-- ⏱️ **Quotas Horaires** : Dites adieu aux limites journalières ! Les Tiers Développeurs se réinitialisent désormais **toutes les heures** pile (à `:00`), vous assurant d'avoir toujours des crédits frais disponibles pendant vos longues sessions de code.
-- ⚡ **Moteur 100% Dynamique** : Fini les listes de modèles codées en dur, les configurations par défaut et les prix fixes ! L'agent IA récupère dynamiquement les derniers LLMs, paramètres, tags (`[💎 Paid]`, `[🌿 Free]`) et coûts approximatifs depuis les API Pollinations.
-- 🛡️ **Sécurité Renforcée** : La protection contre le path traversal et les vérifications strictes d'URL sont totalement intégrées.
-- 🔍 **Recherche Web Améliorée** : Le composant `polli_web_search` s'aligne avec les options de pointe comme Google Gemini Fast, Perplexity ou les assistants spécialisés.
+- 🧊 **Génération 3D (`polli_gen_3d`)** : Génération de modèles 3D (`trellis-2`, `hyper3d-rodin`) au format standard `.glb` avec protection Cost Guard et reprise sur cache.
+- 🛡️ **Protection Anti-Double Facturation** : Retries chat strictement limités au code 429 ; les timeouts et coupures réseau ne rejouent jamais de requêtes payantes.
+- 🧠 **Normalisation du Raisonnement** : Nettoyage automatique des flux SSE de DeepSeek, Kimi et Qwen pour éviter toute fuite de texte de pensée dans le chat.
+- 💰 **Sémantique Quest & Paid Transparente** : Nouveaux modes de facturation (`quest`, `quest_only`, `paid`, `manual`) avec planchers d'alerte en Pollen absolu.
+- 📦 **Artifact Core (Magic Bytes)** : Vérification réelle des octets binaires (JPEG, PNG, GLB, MP4, MP3, WebM) garantissant la bonne extension de fichier sur le disque.
+- ⏱️ **Hiérarchie de Timeouts Configurable** : Contrôle fin des timeouts par appel, par modèle et par capacité via `/poll config timeouts.*`.
+- 🎯 **Quêtes & Connexion 1-Clic** : Suivi rétroactif des quêtes (`/poll quests`) et connexion automatique dans le navigateur (`/poll login`).
+- 🆓 **6 Outils Créateurs Gratuits (sans clé)** : `gen_edit_image_free`, `gen_video_free`, `object_remover`, `image_upscaler`, `image_enhancer`, `remove_background`.
 
 ---
 
@@ -57,61 +47,73 @@ Au-delà de la discussion textuelle, connecter votre clé donne aux Agents OpenC
 ### 💎 Outils Génératifs Intégrés (ENTER ONLY - requiert une clé API)
 - 🎨 `polli_gen_image` : Modèles d'imagerie de pointe (`Flux`, `Sana`, `Midjourney`, etc.).
 - 🎬 `polli_gen_video` : Puissants modèles Texte-vers-Vidéo et Image-vers-Vidéo (`Wan`, `Veo`, `LTX`, `Reveal`).
-- 🔊 `polli_gen_audio` & `polli_gen_music` : Synthèse vocale magique (ElevenLabs, OpenAI TTS) et Musique Générative.
+- 🧊 `polli_gen_3d` : Génération d'actifs 3D haute qualité (`trellis-2`, `hyper3d-rodin`) au format GLB.
+- 🔊 `polli_gen_audio` & `polli_gen_music` : Synthèse vocale (ElevenLabs, OpenAI TTS) et Musique Générative.
 - 🎙️ `polli_stt` : Transcription vocale de haute volée (Whisper V3).
 - 🌐 `polli_web_search` : Outil de recherche web connecté et contextes spécialisés (`gemini-search`, `perplexity...`).
 
-### 🧰 Outils Bonus Créateurs Gratuits (Toujours disponibles)
-- ✂️ `remove_background` : Suppression de fond d'image ultra-rapide intégrée.
-- 🛠️ `gen_qrcode`, `gen_diagram`, `extract_frames`, `extract_audio`, `file_to_url` : Utilitaires développeurs.
+### 🧰 Outils Bonus Créateurs Gratuits (Toujours disponibles — sans clé API)
+- 🆓 `gen_edit_image_free` : Génération et édition d'images gratuite (~20/jour, tout modèle, sans clé).
+- 🆓 `gen_video_free` : Texte-vers-vidéo gratuit avec image et audio d'entrée optionnels (~5/jour, sans clé).
+- 🧹 `object_remover` : Suppression d'objets par prompt en direct (30-120s, sans clé).
+- 📐 `image_upscaler` : Agrandissement 2x/4x gratuit (30-120s, sans clé).
+- ✨ `image_enhancer` : Amélioration IA — débruitage, netteté, restauration (30-120s, sans clé).
+- ✂️ `remove_background` : Suppression de fond d'image IA via rmbg (bgeraser.com) — gratuit.
+- 🛠️ `gen_qrcode`, `gen_diagram`, `gen_palette`, `extract_frames`, `extract_audio`, `file_to_url` : Utilitaires développeurs.
 
 ### 💻 Liste Complète des Commandes Terminal
 Utilisez l'alias **`/poll`** ou **`/pollinations`** à tout moment dans le terminal de conversation :
 - `/poll help` : Affiche le tableau d'aide interactif.
-- `/poll connect` : Outil de configuration "Bring Your Own Key" (Interactif).
-- `/poll usage full` : Tableau de bord en temps réel (Statistiques), Tiers gratuits actifs et Solde du Portefeuille.
-- `/poll config` : Ajustement fin du Cost Guard, des logs, de la langue et de l'affichage.
+- `/poll login` : **Connexion navigateur en 1 clic** (device flow) — crée et connecte une clé automatiquement.
+- `/poll connect <clé>` : Configuration manuelle "Bring Your Own Key" (`sk_...`).
+- `/poll quests` : Consultez vos quêtes et le Pollen gratuit à réclamer. 🎯
+- `/poll usage full` : Tableau de bord en temps réel (Statistiques), Quêtes actives et Solde du Portefeuille.
+- `/poll config` : Ajustement fin du Cost Guard, des timeouts, des logs, de la langue et de l'affichage.
 - `/poll models` : Vérifiez l'état des modèles disponibles.
 - `/poll pricing` : Consultez la tarification unifiée en temps réel (Estimation du coût moyen).
-- `/poll fallback` : Définissez les modèles de secours (Safety Net).
-- `/poll infos` : Découvrez les règles de la communauté et le système de niveaux.
+- `/poll mode <mode>` : Basculez entre les modes de facturation (`quest`, `quest_only`, `paid`, `manual`).
+- `/poll fallback` : Définissez le modèle de secours ultime pour le chat.
+- `/poll infos` : Découvrez les fonctionnalités et le guide d'utilisation.
 
 ---
 
 ## 🛡️ Le "Cost Guard" & le "Filet de Sécurité"
 
-Nous avons introduit des protections fondamentales pour garantir que votre flux de travail ne s'interrompe jamais et que votre budget (Portefeuille ou Tiers Gratuits) reste sous votre contrôle absolu :
+Nous avons introduit des protections fondamentales pour garantir que votre flux de travail ne s'interrompe jamais et que votre budget (Pollen Quest & Paid) reste sous votre contrôle absolu :
 
-- 🛟 **Filet de Sécurité (Safety Net)** : Si vous utilisez des modèles premium et que votre quota horaire s'épuise en pleine session de chat, le plugin bascule silencieusement vers un modèle gratuit de secours. *Plus d'erreurs bloquantes (429).*
-- 🚦 **Cost Guard pour les Outils** : Les Agents OpenCode peuvent être trop zélés. Si un Agent tente de dépenser trop de Pollens pour générer une vidéo très lourde, le plugin intercepte la requête. Un flux asynchrone demandera votre confirmation manuelle.
+- 🛟 **Filet de Sécurité (Safety Net)** : Si vous utilisez des modèles premium et que votre solde Quest/Paid s'épuise en pleine session de chat, le plugin bascule silencieusement vers un modèle gratuit de secours. *Plus d'erreurs bloquantes (429).*
+- 🚦 **Cost Guard pour les Outils** : Les Agents OpenCode peuvent être zélés. Si un Agent tente de dépenser trop de Pollen pour générer une vidéo ou un rendu 3D lourd, le plugin intercepte la requête. Un flux asynchrone demandera votre confirmation manuelle (`polli_gen_confirm`).
 
 ---
 
-## 🐝 Comprendre les Pollens & "Free Tiers"
+## 🐝 Comprendre le Quest Pollen & le Paid Pollen
+
+Le pollen Pollinations est réparti en deux colonnes :
+
+- **🎁 Quest Pollen** — gagné gratuitement en complétant des **Quêtes**. Consommé en premier par le serveur sur les modèles réguliers.
+- **💎 Paid Pollen** — acheté (carte bancaire). Utilisé quand le Quest est insuffisant, ou pour les modèles `paid_only`.
 
-Par le passé, Pollinations s'appuyait principalement sur le trafic réseau financé par la pub. Aujourd'hui, faire tourner des modèles massifs (comme Claude 3.5 Sonnet, Flux Pro, Wan Video) coûte de l'argent. L'Univers **Enter** nécessite une clé API pour débloquer les modèles de pointe.
+> ⚠️ Le plugin ne peut pas lire la répartition côté serveur ; il estime Quest/Paid localement et lit la répartition réelle (`meter_source`) via `/account/usage`.
 
-**Mais attendez, vous n'avez pas besoin de carte bancaire !**
+### Modes de facturation (v6.5) :
 
-Le **Pollen 🌻** est notre système de crédit unifié (1$ ≈ 1 Pollen). En connectant une simple clé API gratuite, vous débloquez des recharges **horaires** selon votre niveau Développeur :
+| Mode | Comportement |
+| :--- | :--- |
+| `quest` (QUEST_PREFERRED, **défaut**) | Quest d'abord, bascule Paid autorisée. Retombe sur l'univers gratuit quand les deux semblent épuisés. |
+| `quest_only` (QUEST_ELIGIBLE_ONLY) | Bloque les modèles `paid_only` localement ; envoie uniquement les appels éligibles Quest. **Best-effort** — un débit Paid peut survenir. |
+| `paid` (PAID_ALLOWED) | Paid autorisé, `paid_only` selon le Cost Guard. Retombe sur le gratuit quand le wallet est bas. |
+| `manual` | Aucune politique automatique — contrôle total. |
 
-| Tier | Recharge Horaire ⏱️ | Estimation Jour* | Condition |
-| :--- | :--- | :--- | :--- |
-| 🍄 **Spore** | **0.01 Pollen / heure** | ~0.24 / jour | Nouveau compte (par défaut) |
-| 🌱 **Seed** | **0.15 Pollen / heure** | ~3.6 / jour | Membre actif de la communauté |
-| 🌸 **Flower** | **0.40 Pollen / heure** | ~9.6 / jour | Compléter des Quêtes et contribuer |
-| 🍯 **Nectar** | **0.80 Pollen / heure** | ~19.2 / jour | Contributeur de premier plan |
-| 🐝 **Router** | **10 Pollen / heure** | ~240 / jour | Spécial / sur invitation |
+Changez avec `/poll mode <mode>` ou `/poll config mode <mode>`.
 
-_*Les estimations quotidiennes sont approximatives (~24h × taux horaire). La réinitialisation réelle s'effectue automatiquement au début de chaque heure (XX:00)._
+> 🎯 **Gagnez du pollen gratuit en complétant des Quêtes !** Utiliser simplement ce plugin en complète plusieurs rétroactivement. Lancez `/poll quests`.
 
-> 🎁 **Obtenez votre Clé Personnelle Gratuite (BYOK) sur [Pollinations.ai](https://enter.pollinations.ai/authorize?redirect_url=https://github.com/fkom13/opencode-pollinations-plugin) pour booster OpenCode !**
+> 🎁 **Obtenez votre Clé Personnelle Gratuite (BYOK) sur [enter.pollinations.ai](https://enter.pollinations.ai) pour booster OpenCode !**
 
 **Comment ça marche :**
-1. Votre quota de Tier gratuit (ex: 0.40 🌻/h pour Flower) est consommé en premier.
-2. Lorsque le quota est épuisé, le filet de sécurité bascule doucement vers les modèles gratuits.
-3. Le solde de votre Portefeuille (Pollen payant) n'est touché que pour les outils premium si le quota gratuit est insuffisant.
-4. Boom ! 💥 Le quota se réinitialise complètement dès la prochaine heure.
+1. Votre Quest Pollen est consommé en premier sur les modèles réguliers.
+2. Les modèles `paid_only` 💎 consomment toujours du Pollen acheté.
+3. Quand les soldes sont épuisés, le filet de sécurité bascule doucement vers les modèles gratuits de secours.
 
 ---
 
@@ -126,30 +128,40 @@ Pollinations pour OpenCode parle votre langue nativement :
 ## 🚀 Installation & Onboarding
 
 ### 🐧 1. Configuration Multi-OS (Installation NPM)
-Ce plugin est **totalement multiplateforme** (Windows, macOS, Linux) et détecte dynamiquement les ports OpenCode.
+Ce plugin est **totalement multiplateforme** (Windows, macOS, Linux ; Node **≥ 18**) et démarre un proxy local sur un port dynamique.
 
-1. Installation globale :
+1. Installation globale ou locale :
    ```bash
    npm install -g opencode-pollinations-plugin
    ```
 2. Auto-Configuration :
    ```bash
    npx opencode-pollinations-plugin
+   # ou: npx opencode-pollinations-plugin --check
    ```
-   *(Ou injectez-le manuellement dans `~/.config/opencode/opencode.json`)*
+   *(Injecte automatiquement `opencode-pollinations-plugin` dans votre fichier `~/.config/opencode/opencode.json`)*
 
 ### 🔑 2. Onboarding Interactif
-Une fois dans OpenCode, tapez simplement cette commande dans le terminal de l'Agent :
+
+Une fois dans OpenCode, connectez votre compte Pollinations via **l'une de ces méthodes** :
+
+**Option A — Connexion 1 clic (recommandée) :**
+```bash
+/poll login
+```
+Votre navigateur s'ouvre automatiquement. Connectez-vous avec GitHub et cliquez sur **Authorize** — le plugin se connecte tout seul, sans copier-coller.
+
+**Option B — Clé manuelle :**
 ```bash
-/poll connect
+/poll connect sk_votre_cle_ici
 ```
-Un assistant interactif vous guidera pour configurer votre clé Pollinations. *(Redémarrez OpenCode pour rafraîchir la liste graphique des modèles).*
+Créez vous-même une clé **Secret** sur [enter.pollinations.ai](https://enter.pollinations.ai) et collez-la. *(Redémarrez OpenCode pour rafraîchir la liste graphique des modèles).*
 
 ---
 
 ## 🔗 Liens
 
-- **Créez votre Clé API Pollen** : [pollinations.ai](https://pollinations.ai)
+- **Dashboard & Clés API** : [enter.pollinations.ai](https://enter.pollinations.ai)
 - **Communauté Discord** : [Rejoignez-nous !](https://discord.gg/pollinations-ai-885844321461485618)
 - **Ecosystème OpenCode** : [opencode.ai](https://opencode.ai/docs/ecosystem#plugins)
 

package/README.it.md

@@ -1,23 +1,9 @@
-# 🌸 Pollinations AI Plugin per OpenCode (v6.4.9)
-
-## ✨ Novità v6.4.9
-
-- 🎯 **Quest & Gamification**: `polli_quests` + `/poll quests`. Usare il plugin completa le quest **retroattivamente**.
-- 🆓 **Strumenti gratis (senza chiave)** — per **qualsiasi** modello OpenCode:
-  - `gen_edit_image_free` — genera **e** modifica (~20/giorno)
-  - `gen_video_free` — testo→video (~5/giorno)
-  - `object_remover` / `image_upscaler` / `image_enhancer` — elaborazione immagini gratis
-  - `remove_background` — ritaglio IA gratis (rmbg / bgeraser)
-- 🔐 **Login in 1 clic**: `/poll login` + `polli_login`. `/poll connect sk_...` resta disponibile.
-- 🧊 **Catalogo modelli completo**: text, image, video, audio, **3D**, **embeddings**, realtime.
-- 🧪 **CI + packaging**: Node ≥ 18, CLI `npx opencode-pollinations-plugin`, test unit + i18n.
-- 🌍 **6 lingue**: en, fr, es, de, it, zh — onboarding e comandi allineati.
-
+# 🌸 Pollinations AI Plugin per OpenCode (v6.5.0)
 
 <div align="center">
   <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="180">
   <h3>Il Ponte definitivo tra OpenCode e l'ecosistema Pollinations.ai</h3>
-  <p><em>Accedi a un universo continuo di modelli AI di base gratuiti, o sfrutta modelli premium enterprise utilizzando i nostri generosi <b>Fondi Gratuiti Orari (Hourly Free Tiers)</b> direttamente dal tuo terminale locale.</em></p>
+  <p><em>Accedi a un universo continuo di modelli AI di base gratuiti, o sfrutta modelli premium enterprise utilizzando il nostro sistema <b>Quest & Paid Pollen</b> direttamente dal tuo terminale locale.</em></p>
 </div>
 
 <div align="center">
@@ -34,19 +20,23 @@
 
 > **"Nessuna porta chiusa, nessun ostacolo corporativo — solo buoni strumenti e brave persone."**
 
-**Pollinations.ai** è una piattaforma open-source creata dalla e per la community. Offriamo un'API unificata e diretta per la generazione di immagini, testi, audio e video.
+**Pollinations.ai** è una piattaforma open-source creata dalla e per la community. Offriamo un'API unificata e diretta per la generazione di immagini, testi, audio, video e 3D.
 
 - 🌍 **Trasparente**: Il nostro codice, la roadmap e le discussioni sono pubblici.
 - ⚖️ **Economia Equa**: Un'unica valuta (**Pollen 🌻**) per tutti i media e i modelli. Prezzi prevedibili e trasparenti, senza vincoli (vendor lock-in).
 
 ---
 
-## ✨ Novità della V6.4
+## ✨ Novità v6.5.0
 
-- ⏱️ **Quote Orarie**: Addio ai limiti giornalieri! I Tier Sviluppatore ora si ricaricano **ogni singola ora** in punto (`:00`), garantendoti sempre crediti freschi durante le tue sessioni di programmazione.
-- ⚡ **Motore 100% Dinamico**: Fine delle liste di modelli hard-coded, delle configurazioni fisse e dei prezzi statici! Nella V6.2, l'agente AI di OpenCode recupera dinamicamente gli ultimi LLM, parametri, tag (`[💎 Paid]`, `[🌿 Free]`) e stime dei costi dalle API di Pollinations.
-- 🛡️ **Sicurezza Robusta**: La protezione contro i path traversal e i rigorosi controlli degli URL sono completamente integrati.
-- 🔍 **Ricerca Web Migliorata**: Il componente `polli_web_search` è perfettamente allineato alle attuali opzioni specializzate e web-enabled come Google Gemini Fast, Perplexity e assistenti personalizzati.
+- 🧊 **Generazione 3D (`polli_gen_3d`)**: Generazione di modelli 3D (`trellis-2`, `hyper3d-rodin`) in formato standard `.glb` con protezione Cost Guard e recupero da cache.
+- 🛡️ **Zero Doppia Fatturazione**: Retry chat rigorosamente limitati al codice HTTP 429; timeout e interruzioni di rete non inviano mai richieste di pagamento duplicate.
+- 🧠 **Normalizzazione del Reasoning**: Pulizia automatica dei flussi SSE per DeepSeek, Kimi e Qwen — nessuna perdita di testo di pensiero nella chat.
+- 💰 **Semantica Quest & Paid Trasparente**: Nuove modalità di fatturazione (`quest`, `quest_only`, `paid`, `manual`) con soglie di allerta in Pollen assoluto.
+- 📦 **Artifact Core (Magic Bytes)**: Verifica fisica binaria (JPEG, PNG, GLB, MP4, MP3, WebM) che garantisce estensioni di file corrette su disco.
+- ⏱️ **Gerarchia di Timeout Configurabile**: Controllo dettagliato dei timeout per chiamata, per modello e per capacità con `/poll config timeouts.*`.
+- 🎯 **Quest & Login in 1 Clic**: Tracciamento retroattivo delle quest (`/poll quests`) e login automatico nel browser (`/poll login`).
+- 🆓 **6 Strumenti Creatore Gratuiti (senza chiave)**: `gen_edit_image_free`, `gen_video_free`, `object_remover`, `image_upscaler`, `image_enhancer`, `remove_background`.
 
 ---
 
@@ -57,24 +47,33 @@ Oltre alle discussioni testuali, connettere la tua chiave API fornisce agli Agen
 ### 💎 Strumenti Generativi Integrati (ENTER ONLY - richiede API key)
 - 🎨 `polli_gen_image` : Modelli di generazione immagini all'avanguardia (`Flux`, `Sana`, `Midjourney`, ecc.).
 - 🎬 `polli_gen_video` : Potenti modelli Testo-a-Video e Immagine-a-Video (`Wan`, `Veo`, `LTX`, `Reveal`).
+- 🧊 `polli_gen_3d` : Generazione di risorse 3D ad alta fedeltà (`trellis-2`, `hyper3d-rodin`) con output GLB.
 - 🔊 `polli_gen_audio` & `polli_gen_music` : Sintesi vocale magica (ElevenLabs, OpenAI TTS) e Musica Generativa.
 - 🎙️ `polli_stt` : Trascrizione vocale di altissimo livello (Whisper V3).
 - 🌐 `polli_web_search` : Ricerca Web connessa & ricerca specializzata sui dati (`gemini-search`, `perplexity...`).
 
-### 🧰 Strumenti Extra Gratuiti (Sempre disponibili)
-- ✂️ `remove_background` : Rimozione dello sfondo dalle immagini integrata e ultraveloce.
-- 🛠️ `gen_qrcode`, `gen_diagram`, `extract_frames`, `extract_audio`, `file_to_url`: Utility per sviluppatori integrate.
+### 🧰 Strumenti di Creazione Gratuiti (Sempre disponibili — senza chiave API)
+- 🆓 `gen_edit_image_free` : Genera e modifica immagini gratis (~20/giorno, qualsiasi modello, senza chiave).
+- 🆓 `gen_video_free` : Testo-a-video gratis con immagine e audio opzionali (~5/giorno, senza chiave).
+- 🧹 `object_remover` : Rimozione oggetti tramite prompt direttamente (30-120s, senza chiave).
+- 📐 `image_upscaler` : Ingrandimento 2x/4x gratis (30-120s, senza chiave).
+- ✨ `image_enhancer` : Miglioramento immagini IA — denoise, nitidezza, restauro (30-120s, senza chiave).
+- ✂️ `remove_background` : Rimozione sfondo IA tramite rmbg (bgeraser.com) — gratis.
+- 🛠️ `gen_qrcode`, `gen_diagram`, `gen_palette`, `extract_frames`, `extract_audio`, `file_to_url`: Utility per sviluppatori integrate.
 
 ### 💻 Elenco Completo dei Comandi del Terminale
 Usa l'alias **`/poll`** o **`/pollinations`** nel tuo terminale della conversazione:
 - `/poll help` : Mostra la tabella di aiuto interattiva.
-- `/poll connect` : Strumento interattivo per configurare la tua API Key (BYOK).
-- `/poll usage full` : Dashboard in tempo reale (Statistiche), Tier Gratuiti attivi e Saldo del Portafoglio (Wallet).
-- `/poll config` : Regolazioni fini (Log, Limiti Costi, Lingua).
+- `/poll login` : **Login browser in 1 clic** (device flow) — crea e connette una chiave automaticamente.
+- `/poll connect <chiave>` : Configurazione manuale "Bring Your Own Key" (`sk_...`).
+- `/poll quests` : Visualizza le tue quest e il Pollen gratuito da riscattare. 🎯
+- `/poll usage full` : Dashboard in tempo reale (Statistiche), Quest attive e Saldo del Portafoglio.
+- `/poll config` : Regolazioni fini (Cost Guard, timeout, log, lingua, interfaccia).
 - `/poll models` : Controlla quali modelli sono al momento online.
 - `/poll pricing` : Controlla la tabella dei prezzi live (Stime medie).
+- `/poll mode <mode>` : Cambia modalità di fatturazione (`quest`, `quest_only`, `paid`, `manual`).
 - `/poll fallback` : Usa i modelli base di salvataggio del "Safety Net".
-- `/poll infos` : Scopri come salire di livello con il tuo account developer.
+- `/poll infos` : Informazioni del sistema e guida all'uso.
 
 ---
 
@@ -82,77 +81,90 @@ Usa l'alias **`/poll`** o **`/pollinations`** nel tuo terminale della conversazi
 
 Abbiamo introdotto protezioni fondamentali per garantire che il tuo flusso di lavoro non si fermi mai e il tuo budget rimanga sotto stretto controllo:
 
-- 🛟 **Rete di Sicurezza**: Se usi modelli premium e la tua quota oraria di Pollen termina nel mezzo della sessione, il plugin passa automaticamente e in silenzio a un modello gratuito. *Mai più errori 429.*
-- 🚦 **Cost Guard sui Tool**: Gli Agenti a volte esagerano. Se l'Agente tenta di generare qualcosa di troppo oneroso, il plugin intercetterà la richiesta, mettendola in pausa finché tu non darai la conferma esplicita per autorizzare la spesa.
+- 🛟 **Rete di Sicurezza (Safety Net)** : Se usi modelli premium e il tuo saldo Quest/Paid termina nel mezzo della sessione, il plugin passa automaticamente e in silenzio a un modello gratuito. *Mai più errori 429.*
+- 🚦 **Cost Guard sui Tool** : Gli agenti a volte possono essere insistenti. Se l'Agente tenta di spendere troppo Pollen per una pesante generazione video o 3D, il plugin intercetta la richiesta chiedendo la tua conferma manuale (`polli_gen_confirm`).
 
 ---
 
-## 🐝 Capire i Pollen & I "Free Tiers"
+## 🐝 Capire il Quest Pollen & il Pollen a Pagamento
+
+Il pollen di Pollinations è diviso in due colonne:
+
+- **🎁 Pollen Quest** — guadagnato gratis completando le **Quest**. Consumato per primo dal server sui modelli regolari.
+- **💎 Pollen a Pagamento** — acquistato (carta). Usato quando il Quest è insufficiente, o per i modelli `paid_only`.
 
-In passato, Pollinations si finanziava principalmente con il traffico generato dalla pubblicità. Oggi, modelli massicci (es. Claude 3.5 Sonnet, Wan Video) hanno un gran costo. Pertanto l'**Enter Universe** ha lo scopo di darti questo accesso tramite Key.
+> ⚠️ Il plugin non può leggere la suddivisione lato server; stima Quest/Pagamento localmente e legge la suddivisione reale (`meter_source`) da `/account/usage`.
 
-**Ma aspetta, NON hai bisogno di una carta di credito!**
+### Modalità di fatturazione (v6.5):
 
-Il **Pollen 🌻** è un sistema universale (1$ ≈ 1 Pollen). Immettendo una primissima Chiave Gratuita dal sito, sbloccherai le generose **Ricariche Orarie** calcolate tramite un sistema a Tiers (Livelli):
+| Modalità | Comportamento |
+| :--- | :--- |
+| `quest` (QUEST_PREFERRED, **predefinita**) | Prima Quest, fallback a Pagamento consentito. Cade sull'universo gratuito quando entrambi sembrano esauriti. |
+| `quest_only` (QUEST_ELIGIBLE_ONLY) | Blocca i modelli `paid_only` localmente; invia solo chiamate eleggibili Quest. **Best-effort** — può verificarsi un addebito Pagamento. |
+| `paid` (PAID_ALLOWED) | Pagamento consentito, `paid_only` secondo il Cost Guard. Cade sul gratuito quando il wallet è basso. |
+| `manual` | Nessuna politica automatica — controllo totale. |
 
-| Tier (Livello) | Ricarica Oraria ⏱️ | Stima Giorno* | Requisito richiesto |
-| :--- | :--- | :--- | :--- |
-| 🍄 **Spore** | **0.01 Pollen / ora** | ~0.24 / giorno | Nuovo account (predefinito) |
-| 🌱 **Seed** | **0.15 Pollen / ora** | ~3.6 / giorno | Membro attivo della community |
-| 🌸 **Flower** | **0.40 Pollen / ora** | ~9.6 / giorno | Completa le Missioni e contribuisci |
-| 🍯 **Nectar** | **0.80 Pollen / ora** | ~19.2 / giorno | Contributore di punta |
-| 🐝 **Router** | **10 Pollen / ora** | ~240 / giorno | Speciale / solo su invito |
+Cambia con `/poll mode <mode>` o `/poll config mode <mode>`.
 
-_*La stima giornaliera è puramente teorica (~24h × quota oraria). I Pollen si rinfrescano in modo corretto all'istante di ogni cambio ora (`:00`)._
+> 🎯 **Guadagna pollen gratis completando le Quest!** Usare questo plugin ne completa diverse retroattivamente. Esegui `/poll quests`.
 
-> 🎁 **Aggiungi la tua API Key Base su [Pollinations.ai](https://enter.pollinations.ai/authorize?redirect_url=https://github.com/fkom13/opencode-pollinations-plugin) per avviare il potenziamento!**
+> 🎁 **Ottieni la tua Chiave Personale Gratuita (BYOK) su [enter.pollinations.ai](https://enter.pollinations.ai) per potenziare OpenCode!**
 
 **Come Funziona:**
-1. Il saldo grauito del tuo Tier (es: 0.40 🌻/ora per un Flower) viene drenato per primo.
-2. Quando arriva a zero, subentrano i modelli Free di salvataggio (Safety Net).
-3. Il saldo in dollari reale si sfiora "A Meno Che" tu non voglia eseguire dei modelli costosi super premium a tutti i costi.
-4. Ogni inizio dell'ora tutto riparte! 💥 Fai /poll usage per misurarlo e divertiti!
+1. Il tuo Pollen Quest viene consumato per primo sui modelli regolari.
+2. I modelli `paid_only` 💎 usano sempre Pollen acquistato.
+3. Quando entrambi i saldi si esauriscono, subentrano dolcemente i modelli gratuiti di salvataggio.
 
 ---
 
 ## 🌍 Supporto Multilingua (i18n)
 
-Pollinations per OpenCode "parla" fin dall'inizio tantissime lingue:
-- Le Notifiche (Toast) in basso, il prompt e vari settaggi capiscono: **Inglese**, **Francese**, **Spagnolo**, **Tedesco**, **Italiano** e **Cinese**
-- Scrivi nel terminal: `/poll config lang <en|fr|es|de|it|zh>` e cambierà instantaneamente.
+Pollinations per OpenCode parla la tua lingua nativamente:
+- Interfaccia, Notifiche (Toast), Risposte dei tool e Comandi sono disponibili in **Inglese**, **Francese**, **Spagnolo**, **Tedesco**, **Italiano** e **Cinese**.
+- Scrivi nel terminale `/poll config lang <en|fr|es|de|it|zh>` per cambiare lingua istantaneamente.
 
 ---
 
 ## 🚀 Guida all'Installazione Base
 
-### 🐧 1. Terminale Cross-Platform Facile (NPM Locale)
-Niente di più semplice su ecosistemi Windows, macOS, e GNU/Linux sfruttando la rilevazione OpenCode automatica.
+### 🐧 1. Configurazione Multi-OS (NPM)
+Questo plugin è **completamente multipiattaforma** (Windows, macOS, Linux ; Node **≥ 18**) e avvia un proxy locale su una porta dinamica.
 
-1. Se preferisci, globale
+1. Installazione globale o locale:
    ```bash
    npm install -g opencode-pollinations-plugin
    ```
-2. Oppure istanziale:
+2. Auto-Configurazione:
    ```bash
    npx opencode-pollinations-plugin
+   # oppure: npx opencode-pollinations-plugin --check
    ```
-   *(Può essere richiamato nel manifest in `~/.config/opencode/opencode.json` con lo starter CLI)*
+   *(Inserisce automaticamente `opencode-pollinations-plugin` nel tuo file `~/.config/opencode/opencode.json`)*
+
+### 🔑 2. Onboarding Interattivo
+
+Una volta in OpenCode, connetti il tuo account Pollinations tramite **una di queste opzioni**:
+
+**Opzione A — Login in 1 clic (consigliata):**
+```bash
+/poll login
+```
+Il browser si aprirà automaticamente. Accedi con GitHub e clicca su **Authorize** — il plugin si collegherà da solo senza copia-incolla.
 
-### 🔑 2. Onboarding Interattivo Rapido
-Dentro al pannello OpenCode entra in chat terminale digitando:
+**Opzione B — Chiave manuale:**
 ```bash
-/poll connect
+/poll connect sk_la_tua_chiave_qui
 ```
-Basta inserire la Key ottenuta su internet alla richiesta a schermo. *(Se devi ricaricare l'elenco tool base cliccabili un avvio veloce del pannello basterà).*
+Crea una chiave **Secret** su [enter.pollinations.ai](https://enter.pollinations.ai) e incollala. *(Riavvia OpenCode per aggiornare la lista dei modelli grafici).*
 
 ---
 
-## 🔗 Link veloci
+## 🔗 Link Importanti
 
-- **Crea una Key per l'Api Pollen**: [pollinations.ai](https://pollinations.ai)
-- **Community Chat e Discord**: [Aggregati a noi ora!](https://discord.gg/pollinations-ai-885844321461485618)
-- **L'infinita OpenCode community**: [opencode.ai](https://opencode.ai/docs/ecosystem#plugins)
+- **Dashboard e Chiavi API**: [enter.pollinations.ai](https://enter.pollinations.ai)
+- **Community Discord**: [Unisciti a noi!](https://discord.gg/pollinations-ai-885844321461485618)
+- **Ecosistema OpenCode**: [opencode.ai](https://opencode.ai/docs/ecosystem#plugins)
 
-## 📜 Licenza d'Uso
+## 📜 Licenza
 
-Rilasciata a tutta la rete tramite un format libero MIT License creato da [fkom13](https://github.com/fkom13) & La fantastica Community Pollinations.
+Licenza MIT. Sviluppato da [fkom13](https://github.com/fkom13) e la Community Pollinations.

package/README.md

@@ -1,9 +1,9 @@
-# 🌸 Pollinations AI Plugin for OpenCode (v6.4.9)
+# 🌸 Pollinations AI Plugin for OpenCode (v6.5.0)
 
 <div align="center">
   <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="180">
   <h3>The Ultimate Bridge between OpenCode and the Pollinations.ai Ecosystem.</h3>
-  <p><em>Access a continuous universe of free basic AI models, or leverage premium enterprise models with our generous <b>Hourly Free Tiers</b> directly from your local terminal.</em></p>
+  <p><em>Access a continuous universe of free basic AI models, or leverage premium enterprise models with our <b>Quest & Paid Pollen</b> system directly from your local terminal.</em></p>
 </div>
 
 <div align="center">
@@ -20,25 +20,23 @@
 
 > **"No closed doors, no corporate hoops — just good tools and good people."**
 
-**Pollinations.ai** is an open-source platform created by and for the community. We offer a unified, direct API for generating **images, text, audio, and video**.
+**Pollinations.ai** is an open-source platform created by and for the community. We offer a unified, direct API for generating **images, text, audio, video, and 3D**.
 
 - 🌍 **Transparent**: Our code, roadmap, and discussions are fully public.
 - ⚖️ **Fair Economy**: A single currency (**Pollen 🌻**) for all media and models. Predictable and transparent pricing. No vendor lock-in.
 
 ---
 
-## ✨ What's new in v6.4.9?
+## ✨ What's new in v6.5.0?
 
-- 🎯 **Quests & Gamification**: `polli_quests` + `/poll quests`. Using this plugin completes several quests **retroactively** — free Pollen may already be waiting.
-- 🆓 **Free tools (no key required)** — usable by **any** OpenCode model:
-  - `gen_edit_image_free` — generate **and edit** images (~20/day).
-  - `gen_video_free` — text-to-video (~5/day), optional first frame & audio.
-  - `object_remover` / `image_upscaler` / `image_enhancer` — free image processing.
-  - `remove_background` — free AI cutout (rmbg / bgeraser).
-- 🔐 **1-Click Device Login**: `/poll login` + `polli_login` (like `gh auth login`). Manual `/poll connect sk_...` still works.
-- 🧊 **Full model catalog**: text, image, video, audio, **3D**, **embeddings**, realtime.
-- 🧪 **CI + packaging**: Node 18+ only (no VS Code leftovers), `npx opencode-pollinations-plugin` setup CLI restored, unit + i18n tests.
-- 🌍 **6 languages**: en, fr, es, de, it, zh — onboarding, commands, and free-tool strings aligned.
+- 🧊 **3D Generation (`polli_gen_3d`)**: High-fidelity 3D model generation (`trellis-2`, `hyper3d-rodin`) as standard `.glb` assets with Cost Guard protection and cache recovery.
+- 🛡️ **Zero Double-Billing**: Chat retries strictly constrained to 429; client timeouts and network interruptions never re-submit or duplicate token debits.
+- 🧠 **Clean Reasoning Normalization**: Normalizes DeepSeek, Kimi, and Qwen reasoning streams — no internal thinking text leaks into the conversation.
+- 💰 **Transparent Quest & Paid Semantics**: Modern billing modes (`quest`, `quest_only`, `paid`, `manual`) with absolute Pollen threshold safeguards.
+- 📦 **Artifact Core (Magic Bytes)**: True binary file verification ensures image, video, audio, and 3D files are saved with their real file extension.
+- ⏱️ **Configurable Timeout Hierarchy**: Fine-grained per-call, per-model, and per-capability timeout control via `/poll config timeouts.*`.
+- 🎯 **Quests & 1-Click Device Login**: Automatic quest tracking (`/poll quests`) and instant browser login (`/poll login`).
+- 🆓 **6 Free Creator Tools (No API key needed)**: `gen_edit_image_free`, `gen_video_free`, `object_remover`, `image_upscaler`, `image_enhancer`, `remove_background`.
 
 ---
 
@@ -49,6 +47,7 @@ Beyond text discussion, connecting your key gives OpenCode Agents access to our
 ### 💎 Integrated Generative Tools (ENTER ONLY - requires API key)
 - 🎨 `polli_gen_image` : State-of-the-art imagery models (`Flux`, `Sana`, `Midjourney`, etc.).
 - 🎬 `polli_gen_video` : Powerful Text-to-Video and Image-to-Video models (`Wan`, `Veo`, `LTX`, `Reveal`).
+- 🧊 `polli_gen_3d` : High-quality 3D asset generation (`trellis-2`, `hyper3d-rodin`) with GLB output.
 - 🔊 `polli_gen_audio` & `polli_gen_music` : Voice synthesis (ElevenLabs, OpenAI TTS) and Generative Music.
 - 🎙️ `polli_stt` : High-flying voice transcription (Whisper V3).
 - 🌐 `polli_web_search` : Connected Web & Specialized Search context (`gemini-search`, `perplexity...`).
@@ -79,36 +78,41 @@ Use the alias **`/poll`** or **`/pollinations`** anytime inside your conversatio
 
 ## 🛡️ The "Cost Guard" & the "Safety Net"
 
-We have introduced fundamental protections to ensure your workflow never interrupts and your budget (Wallet or Free Tiers) is under your control:
+We have introduced fundamental protections to ensure your workflow never interrupts and your budget (Quest & Paid Pollen) is under your control:
 
-- 🛟 **Safety Net**: If you use premium models and your hourly Pollen quota runs out in the middle of a chat session, the plugin silently and automatically switches to a free model. *No more blocking errors (429).*
+- 🛟 **Safety Net**: If you use premium models and your Quest/Paid balance runs out in the middle of a chat session, the plugin silently and automatically switches to a free model. *No more blocking errors (429).*
 - 🚦 **Cost Guard for Tools**: OpenCode Agents can be zealous. If an Agent tries to spend too many Pollens to generate a heavy video or music, the plugin intercepts the request. An asynchronous flow will ask for your manual confirmation before executing costly generations. You stay in control.
 
 ---
 
-## 🐝 Understanding Quest Pollen & Hourly Refill
+## 🐝 Understanding Quest Pollen & Paid Pollen
 
-In the past, Pollinations relied on tier grants. Today, you earn free Pollen by completing **Quests** and get **hourly refills** based on your contribution level:
+Pollinations pollen is split into two columns:
 
-| Level | Hourly Refill ⏱️ | Daily Estimate* | Condition |
-| :--- | :--- | :--- | :--- |
-| 🍄 **Spore** | **0.01 Pollen / hour** | ~0.24 / day | New account (default) |
-| 🌱 **Seed** | **0.15 Pollen / hour** | ~3.6 / day | Active community member |
-| 🌸 **Flower** | **0.40 Pollen / hour** | ~9.6 / day | Complete Quests & contribute |
-| 🍯 **Nectar** | **0.80 Pollen / hour** | ~19.2 / day | Top contributor |
-| 🐝 **Router** | **10 Pollen / hour** | ~240 / day | Special / invite-only |
+- **🎁 Quest Pollen** — earned free by completing **Quests**. Consumed first by the server on regular models.
+- **💎 Paid Pollen** — purchased (credit card). Used when Quest is insufficient, or for `paid_only` models.
 
-_*Daily estimates are approximate (~24h × hourly rate). Refill resets automatically at the top of every hour (XX:00). Quest Pollen lasts 12 months since last account activity._
+> ⚠️ The plugin cannot read the split server-side; it estimates Quest/Paid locally and reads the real split (`meter_source`) from `/account/usage`.
+
+### Billing modes (v6.5)
+
+| Mode | Behavior |
+| :--- | :--- |
+| `quest` (QUEST_PREFERRED, **default**) | Quest first, Paid fallback allowed (server default). Falls back to the Free Universe when both look exhausted. |
+| `quest_only` (QUEST_ELIGIBLE_ONLY) | Blocks `paid_only` models locally; only sends Quest-eligible calls. **Best-effort** — a Paid debit can still occur in a race. |
+| `paid` (PAID_ALLOWED) | Paid allowed, `paid_only` allowed per Cost Guard. Falls back to Free when the wallet is low. |
+| `manual` | No automatic policy — full manual control. |
+
+Change with `/poll mode <mode>` or `/poll config mode <mode>`.
 
 > 🎯 **Earn free Pollen by completing Quests!** Just using this plugin completes several quests retroactively. Run `/poll quests` to see what you can claim.
 
 > 🎁 **Get your Free Personal Key (BYOK) on [Pollinations](https://enter.pollinations.ai) to boost OpenCode!**
 
 **How It Works:**
-1. Your Quest Pollen (hourly refill + accumulated quest rewards) is consumed first on all regular models.
+1. Your Quest Pollen is consumed first on all regular models.
 2. 💎 Paid-only models always use purchased Pollen.
-3. When Quest Pollen is exhausted, the safety net gracefully switches you to free fallback variants.
-4. ⏰ Refill resets at the top of the next hour.
+3. When both balances are exhausted, the safety net gracefully switches you to free fallback variants.
 
 ---