opencode-pollinations-plugin 6.4.9 → 6.5.0

package/dist/tools/pollinations/tool-capability-registry.js

@@ -0,0 +1,215 @@
+/**
+ * Tool Capability Registry (v6.5) — capability-centric, declarative.
+ *
+ * Answers "HOW to execute this capability" — endpoint, transport, execution
+ * mode, timeouts, retry/recovery policy, artifact format, backend overrides.
+ *
+ * The Model Registry remains model-centric ("WHAT exists"). The TCR
+ * references/enriches it and does NOT duplicate model fields (pricing,
+ * paid_only, modalities stay in the Model Registry).
+ *
+ * Overrides that the live catalog does NOT expose (special headers, endpoint
+ * quirks, token formats) live here — never as `if (model === ...)` scattered
+ * across tools.
+ */
+import { resolveEffectiveTimeout } from './timeout-policy.js';
+export const TOOL_CAPABILITIES = [
+    // ── Pollinations generation (cache-backed, LONG_BLOCKING, SERVER_DEDUP) ──
+    {
+        capability: 'gen_image',
+        backend: 'pollinations',
+        transport: { endpoint: 'https://gen.pollinations.ai/image/{prompt}', method: 'GET', mode: 'LONG_BLOCKING' },
+        execution: {
+            defaultTimeoutSeconds: 600,
+            retryPolicy: 'RECOVER_SAME_REQUEST',
+            idempotency: 'SERVER_DEDUP',
+            supportsCancel: false,
+            recovery: 'same request (same model/params/seed) → cache hit, not rebilled',
+        },
+        backendOverrides: {
+            'gpt-image-2': { quality: ['low', 'med', 'high'], transparent: true },
+            kontext: { header: 'x-usage-completion-image-tokens' },
+            klein: { header: 'x-usage-completion-image-tokens' },
+        },
+    },
+    {
+        capability: 'gen_video',
+        backend: 'pollinations',
+        // v6.5: /video/{prompt} is the canonical route (SDK/CLI).
+        transport: { endpoint: 'https://gen.pollinations.ai/video/{prompt}', method: 'GET', mode: 'LONG_BLOCKING' },
+        execution: {
+            defaultTimeoutSeconds: 1800,
+            retryPolicy: 'RECOVER_SAME_REQUEST',
+            idempotency: 'SERVER_DEDUP',
+            supportsCancel: false,
+            recovery: 'same request (same model/params/seed) → cache hit, not rebilled',
+        },
+        backendOverrides: {
+            wan: { requiresReferenceImage: true, t2vDummyImage: true },
+            veo: { interpolationRefs: 2 },
+            'seedance-*': { headerVideoTokens: true, fixedDuration4s: true },
+            'ltx-2': { error520Known: true },
+            'grok-video-pro': { forceAudio: true },
+        },
+    },
+    {
+        capability: 'gen_3d',
+        backend: 'pollinations',
+        transport: { endpoint: 'https://gen.pollinations.ai/3d/{prompt}', method: 'GET', mode: 'LONG_BLOCKING' },
+        outputs: { artifactFormat: 'glb', mime: 'model/gltf-binary' },
+        execution: {
+            defaultTimeoutSeconds: 1800,
+            retryPolicy: 'RECOVER_SAME_REQUEST',
+            idempotency: 'SERVER_DEDUP',
+            supportsCancel: false,
+            recovery: 'same request (same model/params/seed) → model3dCache hit, not rebilled',
+        },
+        backendOverrides: {
+            'trellis-2': { resolutions: ['low', 'medium', 'high'], timeoutSeconds: 1200, maxRefImages: 1 },
+            'hyper3d-rodin': { timeoutSeconds: 1800 },
+        },
+    },
+    {
+        capability: 'tts',
+        backend: 'pollinations',
+        transport: { endpoint: 'https://gen.pollinations.ai/v1/audio/speech', method: 'POST', mode: 'SHORT_REQUEST' },
+        execution: { defaultTimeoutSeconds: 600, retryPolicy: 'NO_AUTOMATIC_RETRY', idempotency: 'SERVER_DEDUP' },
+        backendOverrides: {
+            elevenlabs: { voices: 'registry' },
+            'openai-audio': { voices: ['alloy', 'echo', 'fable', 'onyx', 'nova', 'shimmer'], formats: ['mp3', 'wav', 'pcm16'] },
+        },
+    },
+    {
+        capability: 'music',
+        backend: 'pollinations',
+        transport: { endpoint: 'https://gen.pollinations.ai/audio/{prompt}', method: 'GET', mode: 'LONG_BLOCKING' },
+        execution: { defaultTimeoutSeconds: 600, retryPolicy: 'NO_AUTOMATIC_RETRY', idempotency: 'SERVER_DEDUP' },
+        constraints: { maxDurationSeconds: 300 },
+    },
+    {
+        capability: 'stt',
+        backend: 'pollinations',
+        transport: { endpoint: 'https://gen.pollinations.ai/v1/audio/transcriptions', method: 'POST', mode: 'SHORT_REQUEST' },
+        execution: { defaultTimeoutSeconds: 600, retryPolicy: 'NO_AUTOMATIC_RETRY' },
+    },
+    {
+        capability: 'web_search',
+        backend: 'pollinations',
+        transport: { endpoint: 'https://gen.pollinations.ai/v1/chat/completions', method: 'POST', mode: 'SHORT_REQUEST' },
+        execution: { defaultTimeoutSeconds: 300, retryPolicy: 'NO_AUTOMATIC_RETRY' },
+    },
+    {
+        capability: 'embed',
+        backend: 'pollinations',
+        transport: { endpoint: 'https://gen.pollinations.ai/v1/embeddings', method: 'POST', mode: 'SHORT_REQUEST' },
+        // Billable POST → never auto-replay (NOT a read-only operation).
+        execution: { defaultTimeoutSeconds: 60, retryPolicy: 'NO_AUTOMATIC_RETRY', idempotency: 'NONE' },
+    },
+    // ── Tier services (true ASYNC_JOB with job.id, re-poll safe) ──
+    {
+        capability: 'video_free',
+        backend: 'playground',
+        transport: { endpoint: 'https://pruna-playground-production-861e.up.railway.app/api/p-video/generate', method: 'POST', mode: 'ASYNC_JOB' },
+        execution: {
+            defaultTimeoutSeconds: 900,
+            retryPolicy: 'REPOLL_JOB',
+            idempotency: 'NONE',
+            pollIntervalSeconds: 4,
+            supportsCancel: false,
+            recovery: 're-poll job.id (never resubmit)',
+        },
+    },
+    {
+        capability: 'remove_background',
+        backend: 'imgtools',
+        // No modelId — the TCR is capability-centric, not model-centric.
+        transport: { endpoint: 'https://rmbg.bgeraser.com/api/rmbg', method: 'POST', mode: 'ASYNC_JOB' },
+        execution: {
+            defaultTimeoutSeconds: 300,
+            retryPolicy: 'REPOLL_JOB',
+            pollIntervalSeconds: 5,
+            supportsCancel: false,
+            recovery: 're-poll job.id / key rotation + provider fallback',
+        },
+    },
+    {
+        capability: 'object_remove',
+        backend: 'imgtools',
+        transport: { endpoint: 'https://objectremover.com/api/remove', method: 'POST', mode: 'ASYNC_JOB' },
+        execution: { defaultTimeoutSeconds: 300, retryPolicy: 'REPOLL_JOB', pollIntervalSeconds: 3 },
+    },
+    {
+        capability: 'image_upscale',
+        backend: 'imgtools',
+        transport: { endpoint: 'https://imgupscaler.com/api/upscale', method: 'POST', mode: 'ASYNC_JOB' },
+        execution: { defaultTimeoutSeconds: 300, retryPolicy: 'REPOLL_JOB', pollIntervalSeconds: 5 },
+    },
+    {
+        capability: 'image_enhance',
+        backend: 'imgtools',
+        transport: { endpoint: 'https://imgupscaler.com/api/enhance', method: 'POST', mode: 'ASYNC_JOB' },
+        execution: { defaultTimeoutSeconds: 300, retryPolicy: 'REPOLL_JOB', pollIntervalSeconds: 3 },
+    },
+    {
+        capability: 'upload',
+        backend: 'filehost',
+        transport: { endpoint: 'multi-provider cascade', method: 'POST', mode: 'SHORT_REQUEST' },
+        // POST upload → NOT a read-only op. The provider cascade is explicit,
+        // not an automatic same-request replay.
+        execution: { defaultTimeoutSeconds: 45, retryPolicy: 'NO_AUTOMATIC_RETRY', idempotency: 'NONE' },
+    },
+    // ── Local (offline) ──
+    {
+        capability: 'qrcode',
+        backend: 'local',
+        transport: { endpoint: 'local', method: 'GET', mode: 'LOCAL' },
+        execution: { retryPolicy: 'SAFE_READ_ONLY' },
+    },
+    {
+        capability: 'palette',
+        backend: 'local',
+        transport: { endpoint: 'local', method: 'GET', mode: 'LOCAL' },
+        execution: { retryPolicy: 'SAFE_READ_ONLY' },
+    },
+    {
+        capability: 'diagram',
+        backend: 'mermaid-ink',
+        transport: { endpoint: 'https://mermaid.ink', method: 'GET', mode: 'SHORT_REQUEST' },
+        execution: { defaultTimeoutSeconds: 15, retryPolicy: 'NO_AUTOMATIC_RETRY' },
+    },
+];
+/** Resolve a capability declaration by name (optionally filtered by backend). */
+export function resolveCapability(capability, backend) {
+    return TOOL_CAPABILITIES.find(c => c.capability === capability && (backend === undefined || c.backend === backend));
+}
+export function listCapabilities() {
+    return TOOL_CAPABILITIES.map(c => c.capability);
+}
+/**
+ * Effective timeout for a capability+model with full v6.5 precedence:
+ * per-call > USER model override > USER capability override
+ * > built-in model default > built-in capability > global.
+ */
+export function resolveCapabilityTimeout(capability, model, perCall, userConfig) {
+    const cap = resolveCapability(capability);
+    return resolveEffectiveTimeout({
+        perCall,
+        model,
+        capabilityKey: mapCapabilityToTimeoutKey(capability),
+        longRunning: cap?.transport.mode === 'LONG_BLOCKING',
+        user: userConfig ?? null,
+    });
+}
+function mapCapabilityToTimeoutKey(capability) {
+    if (capability === 'gen_image')
+        return 'image';
+    if (capability === 'gen_video')
+        return 'video';
+    if (capability === 'gen_3d')
+        return 'threeD';
+    if (capability === 'tts' || capability === 'music' || capability === 'stt')
+        return 'audio';
+    if (capability === 'embed')
+        return 'embed';
+    return undefined;
+}

package/dist/tools/pollinations/transcribe_audio.js

@@ -50,30 +50,11 @@ export const polliSttTool = tool({
             // Download from URL
             context.metadata({ title: t('tools.polli_transcribe_audio.toast_dl') });
             try {
-                const https = await import('https');
-                const http = await import('http');
-                const protocol = audioPath.startsWith('https') ? https : http;
-                audioBuffer = await new Promise((resolve, reject) => {
-                    const chunks = [];
-                    protocol.get(audioPath, (res) => {
-                        if (res.statusCode === 301 || res.statusCode === 302) {
-                            // Follow redirect
-                            const redirectUrl = res.headers.location;
-                            if (redirectUrl) {
-                                const redirectProtocol = redirectUrl.startsWith('https') ? https : http;
-                                redirectProtocol.get(redirectUrl, (res2) => {
-                                    res2.on('data', chunk => chunks.push(chunk));
-                                    res2.on('end', () => resolve(Buffer.concat(chunks)));
-                                    res2.on('error', reject);
-                                }).on('error', reject);
-                                return;
-                            }
-                        }
-                        res.on('data', chunk => chunks.push(chunk));
-                        res.on('end', () => resolve(Buffer.concat(chunks)));
-                        res.on('error', reject);
-                    }).on('error', reject);
-                });
+                // v6.5: use a single bounded fetch (timeout) instead of unbounded http(s).get.
+                audioBuffer = Buffer.from(await (await fetch(audioPath, {
+                    signal: AbortSignal.timeout(60000),
+                    redirect: 'follow',
+                })).arrayBuffer());
                 // Extract filename from URL
                 try {
                     const urlPath = new URL(audioPath).pathname;

package/package.json

@@ -1,65 +1,67 @@
 {
-    "name": "opencode-pollinations-plugin",
-    "displayName": "Pollinations",
-    "version": "6.4.9",
-    "description": "Native Pollinations.ai Provider Plugin for OpenCode — free & premium AI models, media tools, quests, cost guards",
-    "author": "fkom13",
-    "license": "MIT",
-    "keywords": [
-        "opencode",
-        "pollinations",
-        "ai",
-        "plugin",
-        "image-generation",
-        "video-generation",
-        "llm",
-        "pollen"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/fkom13/opencode-pollinations-plugin.git"
-    },
-    "bugs": {
-        "url": "https://github.com/fkom13/opencode-pollinations-plugin/issues"
-    },
-    "homepage": "https://github.com/fkom13/opencode-pollinations-plugin#readme",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "default": "./dist/index.js"
-        }
-    },
-    "bin": {
-        "opencode-pollinations-plugin": "./bin/setup.js"
-    },
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "engines": {
-        "node": ">=18"
-    },
-    "scripts": {
-        "build": "tsc",
-        "test": "npm run build && node scripts/tests/test-suite.cjs",
-        "test:unit": "node scripts/tests/test-suite.cjs",
-        "test:i18n": "node scripts/tests/test-i18n.cjs",
-        "prepare": "npm run build",
-        "prepublishOnly": "npm run build && npm run test:unit && npm run test:i18n"
-    },
-    "files": [
-        "dist",
-        "bin",
-        "README.md",
-        "LICENSE.md"
-    ],
-    "dependencies": {
-        "@opencode-ai/plugin": "^1.0.85",
-        "qrcode": "^1.5.4",
-        "zod": "^3.25.76"
-    },
-    "devDependencies": {
-        "@types/node": "^20.0.0",
-        "@types/qrcode": "^1.5.6",
-        "typescript": "^5.0.0"
+  "name": "opencode-pollinations-plugin",
+  "displayName": "Pollinations",
+  "version": "6.5.0",
+  "description": "Native Pollinations.ai Provider Plugin for OpenCode — free & premium AI models, media tools, quests, cost guards",
+  "author": "fkom13",
+  "license": "MIT",
+  "keywords": [
+    "opencode",
+    "pollinations",
+    "ai",
+    "plugin",
+    "image-generation",
+    "video-generation",
+    "llm",
+    "pollen"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fkom13/opencode-pollinations-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fkom13/opencode-pollinations-plugin/issues"
+  },
+  "homepage": "https://github.com/fkom13/opencode-pollinations-plugin#readme",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
+  },
+  "bin": {
+    "opencode-pollinations-plugin": "bin/setup.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node scripts/tests/test-suite.cjs && node scripts/tests/test-v65.cjs && node scripts/tests/test-i18n.cjs && node scripts/tests/test-ux-vocab.cjs",
+    "test:unit": "node scripts/tests/test-suite.cjs",
+    "test:v65": "node scripts/tests/test-v65.cjs",
+    "test:i18n": "node scripts/tests/test-i18n.cjs",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build && npm run test:unit && npm run test:v65 && npm run test:i18n && npm run test:vocab",
+    "test:vocab": "node scripts/tests/test-ux-vocab.cjs"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.0.85",
+    "qrcode": "^1.5.4",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/qrcode": "^1.5.6",
+    "typescript": "^5.0.0"
+  }
 }

package/dist/server/tier-info.d.ts

@@ -1,36 +0,0 @@
-/**
- * Tier Information - Central Configuration
- *
- * Hourly quota system (Pollinations API). Quotas refill every hour at :00.
- * Tiers mirror the official pollinations/shared/tier-config.ts.
- *
- * NOTE (2026-06): The legacy account-level upgrade paths (dev-points → Seed,
- * publish-app → Flower, admin tier-update) were removed upstream. Pollen is now
- * primarily earned by completing Quests. The `condition` fields below describe
- * the broad tier profile, not an automated upgrade trigger.
- */
-export interface TierInfo {
-    name: string;
-    emoji: string;
-    hourlyPollen: number;
-    dailyEstimate: number;
-    condition: string;
-    conditionKey: string;
-}
-export declare const TIER_INFO: Record<string, TierInfo>;
-/**
- * Get tier info by name
- */
-export declare function getTierInfo(tierName: string): TierInfo | undefined;
-/**
- * Get all tiers as array (sorted by hourlyPollen)
- */
-export declare function getAllTiers(): TierInfo[];
-/**
- * Format tier list for display (markdown table)
- */
-export declare function formatTierTable(lang?: 'en' | 'fr' | 'es' | 'de' | 'it' | 'zh'): string;
-/**
- * Get dynamic tier description with hourly rates
- */
-export declare function getTierDescription(lang?: 'en' | 'fr' | 'es' | 'de' | 'it' | 'zh'): string;

package/dist/server/tier-info.js

@@ -1,107 +0,0 @@
-/**
- * Tier Information - Central Configuration
- *
- * Hourly quota system (Pollinations API). Quotas refill every hour at :00.
- * Tiers mirror the official pollinations/shared/tier-config.ts.
- *
- * NOTE (2026-06): The legacy account-level upgrade paths (dev-points → Seed,
- * publish-app → Flower, admin tier-update) were removed upstream. Pollen is now
- * primarily earned by completing Quests. The `condition` fields below describe
- * the broad tier profile, not an automated upgrade trigger.
- */
-import { t } from '../locales/index.js';
-export const TIER_INFO = {
-    microbe: {
-        name: 'Microbe',
-        emoji: '🦠',
-        hourlyPollen: 0,
-        dailyEstimate: 0,
-        condition: 'Account under review',
-        conditionKey: 'tier.condition.under_review',
-    },
-    spore: {
-        name: 'Spore',
-        emoji: '🍄',
-        hourlyPollen: 0.01,
-        dailyEstimate: 0.24,
-        condition: 'New account (default)',
-        conditionKey: 'tier.condition.default',
-    },
-    seed: {
-        name: 'Seed',
-        emoji: '🌱',
-        hourlyPollen: 0.15,
-        dailyEstimate: 3.6,
-        condition: 'Active community member',
-        conditionKey: 'tier.condition.community',
-    },
-    flower: {
-        name: 'Flower',
-        emoji: '🌸',
-        hourlyPollen: 0.4,
-        dailyEstimate: 9.6,
-        condition: 'Complete Quests & contribute',
-        conditionKey: 'tier.condition.quests',
-    },
-    nectar: {
-        name: 'Nectar',
-        emoji: '🍯',
-        hourlyPollen: 0.8,
-        dailyEstimate: 19.2,
-        condition: 'Top contributor',
-        conditionKey: 'tier.condition.top_contributor',
-    },
-    router: {
-        name: 'Router',
-        emoji: '🐝',
-        hourlyPollen: 10,
-        dailyEstimate: 240,
-        condition: 'Special / invite-only',
-        conditionKey: 'tier.condition.special',
-    },
-};
-/**
- * Get tier info by name
- */
-export function getTierInfo(tierName) {
-    return TIER_INFO[tierName.toLowerCase()];
-}
-/**
- * Get all tiers as array (sorted by hourlyPollen)
- */
-export function getAllTiers() {
-    return Object.values(TIER_INFO).sort((a, b) => a.hourlyPollen - b.hourlyPollen);
-}
-/**
- * Format tier list for display (markdown table)
- */
-export function formatTierTable(lang = 'en') {
-    const tiers = getAllTiers();
-    const headers = {
-        en: '| Tier | Hourly | Daily (est.) | Condition |',
-        fr: '| Palier | Horaire | Journalier (est.) | Condition |',
-        es: '| Nivel | Por hora | Diario (est.) | Condición |',
-        de: '| Stufe | Pro Stunde | Täglich (ca.) | Bedingung |',
-        it: '| Livello | Orario | Giornaliero (stima) | Condizione |',
-        zh: '| 等级 | 每小时 | 每日 (估算) | 条件 |',
-    };
-    const separator = '|------|---------|----------------|-----------|';
-    const rows = tiers.map(tier => {
-        const conditionText = t(tier.conditionKey);
-        return `| ${tier.emoji} **${tier.name}** | **${tier.hourlyPollen} pollen/h** | ~${tier.dailyEstimate}/day | ${conditionText} |`;
-    });
-    return [headers[lang] || headers.en, separator, ...rows].join('\n');
-}
-/**
- * Get dynamic tier description with hourly rates
- */
-export function getTierDescription(lang = 'en') {
-    const perHour = lang === 'fr' ? '/heure' : '/hour';
-    const perDay = lang === 'fr' ? '/jour (est.)' : '/day (est.)';
-    const tiers = getAllTiers();
-    const lines = tiers.map(tier => {
-        const conditionText = t(tier.conditionKey);
-        return `- ${tier.emoji} **${tier.name}** (**${tier.hourlyPollen} Pollen${perHour}** ≈ ~${tier.dailyEstimate}${perDay}) : ${conditionText}`;
-    });
-    return lines.join('\n');
-}