opencode-pollinations-plugin 6.0.0-beta.19 → 6.0.0-beta.2

package/dist/tools/design/gen_diagram.js

@@ -0,0 +1,97 @@
+import { tool } from '@opencode-ai/plugin/tool';
+import * as https from 'https';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const SAVE_DIR = path.join(os.homedir(), 'Downloads', 'pollinations', 'diagrams');
+const MERMAID_INK_BASE = 'https://mermaid.ink';
+/**
+ * Encode Mermaid code for mermaid.ink API
+ * Uses base64 encoding of the diagram definition
+ */
+function encodeMermaid(code) {
+    return Buffer.from(code, 'utf-8').toString('base64url');
+}
+/**
+ * Fetch binary content from URL
+ */
+function fetchBinary(url) {
+    return new Promise((resolve, reject) => {
+        const req = https.get(url, { headers: { 'User-Agent': 'OpenCode-Pollinations-Plugin/6.0' } }, (res) => {
+            // Follow redirects
+            if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                return fetchBinary(res.headers.location).then(resolve).catch(reject);
+            }
+            if (res.statusCode && res.statusCode >= 400) {
+                return reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));
+            }
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => resolve(Buffer.concat(chunks)));
+        });
+        req.on('error', reject);
+        req.setTimeout(15000, () => {
+            req.destroy();
+            reject(new Error('Timeout fetching diagram'));
+        });
+    });
+}
+export const genDiagramTool = tool({
+    description: `Render a Mermaid diagram to SVG or PNG image. 
+Uses mermaid.ink (free, no auth required). Supports all Mermaid syntax:
+flowchart, sequenceDiagram, classDiagram, stateDiagram, erDiagram, gantt, pie, mindmap, timeline, etc.
+The diagram code should be valid Mermaid syntax WITHOUT the \`\`\`mermaid fences.`,
+    args: {
+        code: tool.schema.string().describe('Mermaid diagram code (e.g. "graph LR; A-->B; B-->C")'),
+        format: tool.schema.enum(['svg', 'png']).optional().describe('Output format (default: svg)'),
+        theme: tool.schema.enum(['default', 'dark', 'forest', 'neutral']).optional().describe('Diagram theme (default: default)'),
+        filename: tool.schema.string().optional().describe('Custom filename (without extension). Auto-generated if omitted'),
+    },
+    async execute(args, context) {
+        const format = args.format || 'svg';
+        const theme = args.theme || 'default';
+        // Ensure save directory
+        if (!fs.existsSync(SAVE_DIR)) {
+            fs.mkdirSync(SAVE_DIR, { recursive: true });
+        }
+        // Build mermaid.ink URL
+        // For themed rendering, we wrap with config
+        const themedCode = theme !== 'default'
+            ? `%%{init: {'theme': '${theme}'}}%%\n${args.code}`
+            : args.code;
+        const encoded = encodeMermaid(themedCode);
+        const endpoint = format === 'svg' ? 'svg' : 'img';
+        const url = `${MERMAID_INK_BASE}/${endpoint}/${encoded}`;
+        // Generate filename
+        const safeName = args.filename
+            ? args.filename.replace(/[^a-zA-Z0-9_-]/g, '_')
+            : `diagram_${Date.now()}`;
+        const filePath = path.join(SAVE_DIR, `${safeName}.${format}`);
+        try {
+            const data = await fetchBinary(url);
+            if (data.length < 50) {
+                return `❌ Diagram Error: mermaid.ink returned empty/invalid response. Check your Mermaid syntax.`;
+            }
+            fs.writeFileSync(filePath, data);
+            const fileSizeKB = (data.length / 1024).toFixed(1);
+            // Extract diagram type from first line
+            const firstLine = args.code.trim().split('\n')[0].trim();
+            const diagramType = firstLine.replace(/[;\s{].*/g, '');
+            context.metadata({ title: `📊 Diagram: ${diagramType}` });
+            return [
+                `📊 Diagram Rendered`,
+                `━━━━━━━━━━━━━━━━━━━`,
+                `Type: ${diagramType}`,
+                `Theme: ${theme}`,
+                `Format: ${format.toUpperCase()}`,
+                `File: ${filePath}`,
+                `Weight: ${fileSizeKB} KB`,
+                `URL: ${url}`,
+                `Cost: Free (mermaid.ink)`,
+            ].join('\n');
+        }
+        catch (err) {
+            return `❌ Diagram Error: ${err.message}\n💡 Verify your Mermaid syntax at https://mermaid.live`;
+        }
+    },
+});

package/dist/tools/design/gen_palette.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+export declare const genPaletteTool: ToolDefinition;

package/dist/tools/design/gen_palette.js

@@ -0,0 +1,185 @@
+import { tool } from '@opencode-ai/plugin/tool';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const SAVE_DIR = path.join(os.homedir(), 'Downloads', 'pollinations', 'palettes');
+function hexToHSL(hex) {
+    hex = hex.replace('#', '');
+    if (hex.length === 3)
+        hex = hex.split('').map(c => c + c).join('');
+    const r = parseInt(hex.substring(0, 2), 16) / 255;
+    const g = parseInt(hex.substring(2, 4), 16) / 255;
+    const b = parseInt(hex.substring(4, 6), 16) / 255;
+    const max = Math.max(r, g, b), min = Math.min(r, g, b);
+    let h = 0, s = 0;
+    const l = (max + min) / 2;
+    if (max !== min) {
+        const d = max - min;
+        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+        switch (max) {
+            case r:
+                h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+                break;
+            case g:
+                h = ((b - r) / d + 2) / 6;
+                break;
+            case b:
+                h = ((r - g) / d + 4) / 6;
+                break;
+        }
+    }
+    return { h: Math.round(h * 360), s: Math.round(s * 100), l: Math.round(l * 100) };
+}
+function hslToHex(h, s, l) {
+    s /= 100;
+    l /= 100;
+    const a = s * Math.min(l, 1 - l);
+    const f = (n) => {
+        const k = (n + h / 30) % 12;
+        const color = l - a * Math.max(Math.min(k - 3, 9 - k, 1), -1);
+        return Math.round(255 * color).toString(16).padStart(2, '0');
+    };
+    return `#${f(0)}${f(8)}${f(4)}`;
+}
+function generatePalette(baseHex, scheme, count) {
+    const base = hexToHSL(baseHex);
+    const colors = [];
+    switch (scheme) {
+        case 'complementary':
+            colors.push({ hex: baseHex, role: 'Base' });
+            colors.push({ hex: hslToHex((base.h + 180) % 360, base.s, base.l), role: 'Complement' });
+            // Fill shades
+            for (let i = 2; i < count; i++) {
+                const lShift = base.l + (i % 2 === 0 ? 15 : -15) * Math.ceil(i / 2);
+                colors.push({ hex: hslToHex(base.h, base.s, Math.max(10, Math.min(90, lShift))), role: `Shade ${i - 1}` });
+            }
+            break;
+        case 'analogous':
+            for (let i = 0; i < count; i++) {
+                const offset = (i - Math.floor(count / 2)) * 30;
+                colors.push({
+                    hex: hslToHex((base.h + offset + 360) % 360, base.s, base.l),
+                    role: offset === 0 ? 'Base' : `${offset > 0 ? '+' : ''}${offset}°`
+                });
+            }
+            break;
+        case 'triadic':
+            colors.push({ hex: baseHex, role: 'Base' });
+            colors.push({ hex: hslToHex((base.h + 120) % 360, base.s, base.l), role: 'Triad +120°' });
+            colors.push({ hex: hslToHex((base.h + 240) % 360, base.s, base.l), role: 'Triad +240°' });
+            for (let i = 3; i < count; i++) {
+                const lShift = base.l + (i % 2 === 0 ? 12 : -12) * Math.ceil((i - 2) / 2);
+                colors.push({ hex: hslToHex((base.h + (i * 120)) % 360, base.s, Math.max(10, Math.min(90, lShift))), role: `Accent ${i - 2}` });
+            }
+            break;
+        case 'split-complementary':
+            colors.push({ hex: baseHex, role: 'Base' });
+            colors.push({ hex: hslToHex((base.h + 150) % 360, base.s, base.l), role: 'Split +150°' });
+            colors.push({ hex: hslToHex((base.h + 210) % 360, base.s, base.l), role: 'Split +210°' });
+            for (let i = 3; i < count; i++) {
+                colors.push({ hex: hslToHex(base.h, base.s, Math.max(10, Math.min(90, base.l + (i * 10 - 30)))), role: `Tone ${i - 2}` });
+            }
+            break;
+        case 'monochromatic':
+        default:
+            for (let i = 0; i < count; i++) {
+                const l = Math.round(15 + (i / (count - 1)) * 70); // 15% to 85%
+                colors.push({
+                    hex: hslToHex(base.h, base.s, l),
+                    role: l < base.l ? `Dark ${Math.abs(i - Math.floor(count / 2))}` : l === base.l ? 'Base' : `Light ${Math.abs(i - Math.floor(count / 2))}`,
+                });
+            }
+            // Mark closest to base
+            let closestIdx = 0;
+            let closestDiff = Infinity;
+            colors.forEach((c, i) => {
+                const diff = Math.abs(hexToHSL(c.hex).l - base.l);
+                if (diff < closestDiff) {
+                    closestDiff = diff;
+                    closestIdx = i;
+                }
+            });
+            colors[closestIdx].role = 'Base';
+            break;
+    }
+    return colors.slice(0, count);
+}
+function generateSVG(colors) {
+    const swatchW = 120;
+    const swatchH = 80;
+    const gap = 8;
+    const totalW = colors.length * (swatchW + gap) - gap + 40;
+    const totalH = swatchH + 60;
+    const swatches = colors.map((c, i) => {
+        const x = 20 + i * (swatchW + gap);
+        const textColor = hexToHSL(c.hex).l > 50 ? '#1a1a1a' : '#ffffff';
+        return `
+    <rect x="${x}" y="20" width="${swatchW}" height="${swatchH}" rx="8" fill="${c.hex}" stroke="#333" stroke-width="1"/>
+    <text x="${x + swatchW / 2}" y="${swatchH / 2 + 15}" text-anchor="middle" fill="${textColor}" font-family="monospace" font-size="13" font-weight="bold">${c.hex.toUpperCase()}</text>
+    <text x="${x + swatchW / 2}" y="${swatchH + 38}" text-anchor="middle" fill="#666" font-family="sans-serif" font-size="11">${c.role}</text>`;
+    }).join('');
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${totalW}" height="${totalH}" viewBox="0 0 ${totalW} ${totalH}">
+  <rect width="100%" height="100%" fill="#0d0d0d" rx="12"/>
+  ${swatches}
+</svg>`;
+}
+export const genPaletteTool = tool({
+    description: `Generate a harmonious color palette from a base hex color.
+Outputs a visual SVG palette + JSON color codes. Works 100% offline.
+Schemes: monochromatic, complementary, analogous, triadic, split-complementary.
+Perfect for frontend design, branding, and UI theming.`,
+    args: {
+        color: tool.schema.string().describe('Base hex color (e.g. "#3B82F6" or "3B82F6")'),
+        scheme: tool.schema.enum(['monochromatic', 'complementary', 'analogous', 'triadic', 'split-complementary']).optional()
+            .describe('Color harmony scheme (default: analogous)'),
+        count: tool.schema.number().min(3).max(8).optional().describe('Number of colors (default: 5, max: 8)'),
+        filename: tool.schema.string().optional().describe('Custom filename (without extension). Auto-generated if omitted'),
+    },
+    async execute(args, context) {
+        const scheme = args.scheme || 'analogous';
+        const count = args.count || 5;
+        // Normalize hex
+        let hex = args.color.trim();
+        if (!hex.startsWith('#'))
+            hex = '#' + hex;
+        if (!/^#[0-9a-fA-F]{3,6}$/.test(hex)) {
+            return `❌ Invalid hex color: "${args.color}". Use format: #3B82F6 or 3B82F6`;
+        }
+        if (hex.length === 4)
+            hex = '#' + hex[1] + hex[1] + hex[2] + hex[2] + hex[3] + hex[3];
+        // Generate palette
+        const colors = generatePalette(hex, scheme, count);
+        // Ensure save directory
+        if (!fs.existsSync(SAVE_DIR)) {
+            fs.mkdirSync(SAVE_DIR, { recursive: true });
+        }
+        // Save SVG
+        const safeName = args.filename
+            ? args.filename.replace(/[^a-zA-Z0-9_-]/g, '_')
+            : `palette_${hex.replace('#', '')}_${scheme}`;
+        const svgPath = path.join(SAVE_DIR, `${safeName}.svg`);
+        const svg = generateSVG(colors);
+        fs.writeFileSync(svgPath, svg);
+        // Build CSS custom properties snippet
+        const cssVars = colors.map((c, i) => `  --color-${i + 1}: ${c.hex};`).join('\n');
+        context.metadata({ title: `🎨 Palette: ${scheme} from ${hex}` });
+        const colorTable = colors.map(c => `  ${c.hex.toUpperCase()}  ${c.role}`).join('\n');
+        return [
+            `🎨 Color Palette Generated`,
+            `━━━━━━━━━━━━━━━━━━━━━━━━━`,
+            `Base: ${hex.toUpperCase()}`,
+            `Scheme: ${scheme}`,
+            `Colors (${count}):`,
+            colorTable,
+            ``,
+            `File: ${svgPath}`,
+            ``,
+            `CSS Variables:`,
+            `:root {`,
+            cssVars,
+            `}`,
+            ``,
+            `Cost: Free (local computation)`,
+        ].join('\n');
+    },
+});

package/dist/tools/design/gen_qrcode.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+export declare const genQrcodeTool: ToolDefinition;

package/dist/tools/design/gen_qrcode.js

@@ -0,0 +1,60 @@
+import { tool } from '@opencode-ai/plugin/tool';
+import * as QRCode from 'qrcode';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const SAVE_DIR = path.join(os.homedir(), 'Downloads', 'pollinations', 'qrcodes');
+export const genQrcodeTool = tool({
+    description: `Generate a QR code image from text, URL, or WiFi credentials. 
+Outputs a PNG file saved locally. Works 100% offline, no API key needed.
+Examples: URLs, plain text, WiFi (format: WIFI:T:WPA;S:NetworkName;P:Password;;)`,
+    args: {
+        content: tool.schema.string().describe('The text, URL, or WiFi string to encode into a QR code'),
+        size: tool.schema.number().min(128).max(2048).optional().describe('QR code size in pixels (default: 512)'),
+        filename: tool.schema.string().optional().describe('Custom filename (without extension). Auto-generated if omitted'),
+    },
+    async execute(args, context) {
+        const size = args.size || 512;
+        // Ensure save directory exists
+        if (!fs.existsSync(SAVE_DIR)) {
+            fs.mkdirSync(SAVE_DIR, { recursive: true });
+        }
+        // Generate filename
+        const safeName = args.filename
+            ? args.filename.replace(/[^a-zA-Z0-9_-]/g, '_')
+            : `qr_${Date.now()}`;
+        const filePath = path.join(SAVE_DIR, `${safeName}.png`);
+        try {
+            // Generate QR code PNG
+            await QRCode.toFile(filePath, args.content, {
+                width: size,
+                margin: 2,
+                color: {
+                    dark: '#000000',
+                    light: '#ffffff',
+                },
+                errorCorrectionLevel: 'M',
+            });
+            // Get file size
+            const stats = fs.statSync(filePath);
+            const fileSizeKB = (stats.size / 1024).toFixed(1);
+            // Truncate content for display
+            const displayContent = args.content.length > 80
+                ? args.content.substring(0, 77) + '...'
+                : args.content;
+            context.metadata({ title: `🔲 QR Code: ${displayContent}` });
+            return [
+                `🔲 QR Code Generated`,
+                `━━━━━━━━━━━━━━━━━━━`,
+                `Content: ${displayContent}`,
+                `Size: ${size}×${size}px`,
+                `File: ${filePath}`,
+                `Weight: ${fileSizeKB} KB`,
+                `Cost: Free (local generation)`,
+            ].join('\n');
+        }
+        catch (err) {
+            return `❌ QR Code Error: ${err.message}`;
+        }
+    },
+});

package/dist/tools/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tool Registry — Conditional Injection System
+ *
+ * Free Universe (no key): 7 tools always available
+ * Enter Universe (with key): +5 Pollinations tools
+ *
+ * Tools are injected ONCE at plugin init. Restart needed after /poll connect.
+ */
+/**
+ * Build the tool registry based on user's access level
+ *
+ * @returns Record<string, Tool> to be spread into the plugin's tool: {} property
+ */
+export declare function createToolRegistry(): Record<string, any>;

package/dist/tools/index.js

@@ -0,0 +1,75 @@
+/**
+ * Tool Registry — Conditional Injection System
+ *
+ * Free Universe (no key): 7 tools always available
+ * Enter Universe (with key): +5 Pollinations tools
+ *
+ * Tools are injected ONCE at plugin init. Restart needed after /poll connect.
+ */
+import { loadConfig } from '../server/config.js';
+// === FREE TOOLS (Always available) ===
+import { genQrcodeTool } from './design/gen_qrcode.js';
+import { genDiagramTool } from './design/gen_diagram.js';
+import { genPaletteTool } from './design/gen_palette.js';
+import { fileToUrlTool } from './power/file_to_url.js';
+import { removeBackgroundTool } from './power/remove_background.js';
+import { extractFramesTool } from './power/extract_frames.js';
+// === ENTER TOOLS (Require API key) ===
+// Phase 4D: Pollinations tools — TO BE IMPLEMENTED
+// import { genImageTool } from './pollinations/gen_image.js';
+// import { genVideoTool } from './pollinations/gen_video.js';
+// import { genAudioTool } from './pollinations/gen_audio.js';
+// import { genMusicTool } from './pollinations/gen_music.js';
+// import { deepsearchTool } from './pollinations/deepsearch.js';
+// import { searchCrawlScrapeTool } from './pollinations/search_crawl_scrape.js';
+import * as fs from 'fs';
+const LOG_FILE = '/tmp/opencode_pollinations_v4.log';
+function log(msg) {
+    try {
+        fs.appendFileSync(LOG_FILE, `[${new Date().toISOString()}] [Tools] ${msg}\n`);
+    }
+    catch { }
+}
+/**
+ * Detect if a valid API key is present
+ */
+function hasValidKey() {
+    const config = loadConfig();
+    return !!(config.apiKey && config.apiKey.length > 5 && config.apiKey !== 'dummy');
+}
+/**
+ * Build the tool registry based on user's access level
+ *
+ * @returns Record<string, Tool> to be spread into the plugin's tool: {} property
+ */
+export function createToolRegistry() {
+    const tools = {};
+    const keyPresent = hasValidKey();
+    const config = loadConfig();
+    // === FREE UNIVERSE: Always injected ===
+    // Design tools
+    tools['gen_qrcode'] = genQrcodeTool;
+    tools['gen_diagram'] = genDiagramTool;
+    tools['gen_palette'] = genPaletteTool;
+    // Power tools
+    tools['file_to_url'] = fileToUrlTool;
+    tools['remove_background'] = removeBackgroundTool;
+    tools['extract_frames'] = extractFramesTool;
+    // gen_image (free version) — TODO Phase 4D
+    // tools['gen_image'] = genImageTool;
+    log(`Free tools injected: ${Object.keys(tools).length}`);
+    // === ENTER UNIVERSE: Only with valid API key ===
+    if (keyPresent) {
+        // Pollinations paid tools — TODO Phase 4D
+        // tools['gen_video'] = genVideoTool;
+        // tools['gen_audio'] = genAudioTool;
+        // tools['gen_music'] = genMusicTool;
+        // tools['deepsearch'] = deepsearchTool;
+        // tools['search_crawl_scrape'] = searchCrawlScrapeTool;
+        log(`Enter tools injected (key detected). Total: ${Object.keys(tools).length}`);
+    }
+    else {
+        log(`Enter tools SKIPPED (no key). Total: ${Object.keys(tools).length}`);
+    }
+    return tools;
+}

package/dist/tools/power/extract_frames.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+export declare const extractFramesTool: ToolDefinition;

package/dist/tools/power/extract_frames.js

@@ -0,0 +1,215 @@
+import { tool } from '@opencode-ai/plugin/tool';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as https from 'https';
+import * as http from 'http';
+const SAVE_DIR = path.join(os.homedir(), 'Downloads', 'pollinations', 'frames');
+/**
+ * Download a video from URL to a temp file
+ */
+function downloadVideo(url) {
+    return new Promise((resolve, reject) => {
+        const tempPath = path.join(os.tmpdir(), `video_${Date.now()}.mp4`);
+        const proto = url.startsWith('https') ? https : http;
+        const req = proto.get(url, { headers: { 'User-Agent': 'OpenCode-Pollinations-Plugin/6.0' } }, (res) => {
+            // Follow redirects
+            if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                return downloadVideo(res.headers.location).then(resolve).catch(reject);
+            }
+            if (res.statusCode && res.statusCode >= 400) {
+                return reject(new Error(`HTTP ${res.statusCode}`));
+            }
+            const ws = fs.createWriteStream(tempPath);
+            res.pipe(ws);
+            ws.on('finish', () => {
+                ws.close();
+                resolve(tempPath);
+            });
+            ws.on('error', reject);
+        });
+        req.on('error', reject);
+        req.setTimeout(120000, () => {
+            req.destroy();
+            reject(new Error('Download timeout (120s)'));
+        });
+    });
+}
+/**
+ * Try to load @ffmpeg/ffmpeg dynamically — it's an optional peer dependency
+ */
+async function loadFFmpeg() {
+    try {
+        // @ts-ignore — optional peer dependency
+        const { FFmpeg } = await import('@ffmpeg/ffmpeg');
+        // @ts-ignore — optional peer dependency
+        const { toBlobURL } = await import('@ffmpeg/util');
+        return { FFmpeg, toBlobURL };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if system ffmpeg is available (fallback)
+ */
+function hasSystemFFmpeg() {
+    try {
+        const { execSync } = require('child_process');
+        execSync('ffmpeg -version', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extract frames using system ffmpeg
+ */
+function extractWithSystemFFmpeg(videoPath, outputDir, baseName, options) {
+    const { execSync } = require('child_process');
+    const outputPattern = path.join(outputDir, `${baseName}_%03d.png`);
+    const outputs = [];
+    let cmd = `ffmpeg -y -i "${videoPath}"`;
+    if (options.at_time) {
+        // Single frame at specific time
+        cmd += ` -ss ${options.at_time} -frames:v 1`;
+        const singleOutput = path.join(outputDir, `${baseName}_at_${options.at_time.replace(/:/g, '-')}.png`);
+        cmd += ` "${singleOutput}"`;
+        execSync(cmd, { stdio: 'ignore', timeout: 60000 });
+        if (fs.existsSync(singleOutput))
+            outputs.push(singleOutput);
+    }
+    else {
+        // Range extraction
+        if (options.start)
+            cmd += ` -ss ${options.start}`;
+        if (options.end)
+            cmd += ` -to ${options.end}`;
+        const fps = options.fps || 1; // Default 1 fps
+        cmd += ` -vf "fps=${fps}" "${outputPattern}"`;
+        execSync(cmd, { stdio: 'ignore', timeout: 120000 });
+        // Collect generated files
+        const files = fs.readdirSync(outputDir);
+        files.filter(f => f.startsWith(baseName) && f.endsWith('.png'))
+            .sort()
+            .forEach(f => outputs.push(path.join(outputDir, f)));
+    }
+    return outputs;
+}
+function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+export const extractFramesTool = tool({
+    description: `Extract image frames from a video file or URL.
+Can extract a single frame at a specific timestamp, or multiple frames from a time range.
+Requires either system ffmpeg installed or @ffmpeg/ffmpeg npm package.
+Supports MP4, WebM, and other common video formats.
+Free to use — no API key needed.`,
+    args: {
+        source: tool.schema.string().describe('Video file path (absolute) or URL'),
+        at_time: tool.schema.string().optional().describe('Extract single frame at timestamp (e.g. "00:00:05" or "5")'),
+        start: tool.schema.string().optional().describe('Start time for range extraction (e.g. "00:00:02")'),
+        end: tool.schema.string().optional().describe('End time for range extraction (e.g. "00:00:10")'),
+        fps: tool.schema.number().min(0.1).max(30).optional().describe('Frames per second for range extraction (default: 1)'),
+        filename: tool.schema.string().optional().describe('Base filename prefix. Auto-generated if omitted'),
+    },
+    async execute(args, context) {
+        // Check ffmpeg availability
+        const systemFFmpeg = hasSystemFFmpeg();
+        if (!systemFFmpeg) {
+            // Try wasm ffmpeg
+            const ffmpegWasm = await loadFFmpeg();
+            if (!ffmpegWasm) {
+                return [
+                    `❌ FFmpeg not found!`,
+                    ``,
+                    `This tool requires ffmpeg. Install one of:`,
+                    `  • System: sudo apt install ffmpeg  (or brew install ffmpeg)`,
+                    `  • Node.js: npm install @ffmpeg/ffmpeg @ffmpeg/util @ffmpeg/core`,
+                ].join('\n');
+            }
+            // TODO: Implement wasm extraction path (system ffmpeg is sufficient for MVP)
+            return `❌ @ffmpeg/ffmpeg wasm path not yet implemented. Please install system ffmpeg: sudo apt install ffmpeg`;
+        }
+        // Ensure save directory
+        if (!fs.existsSync(SAVE_DIR)) {
+            fs.mkdirSync(SAVE_DIR, { recursive: true });
+        }
+        // Resolve source: URL → download, path → validate
+        let videoPath;
+        let isRemote = false;
+        if (args.source.startsWith('http://') || args.source.startsWith('https://')) {
+            isRemote = true;
+            context.metadata({ title: `🎬 Downloading video...` });
+            try {
+                videoPath = await downloadVideo(args.source);
+            }
+            catch (err) {
+                return `❌ Download error: ${err.message}`;
+            }
+        }
+        else {
+            videoPath = args.source;
+            if (!fs.existsSync(videoPath)) {
+                return `❌ File not found: ${videoPath}`;
+            }
+        }
+        const baseName = args.filename
+            ? args.filename.replace(/[^a-zA-Z0-9_-]/g, '_')
+            : `frame_${Date.now()}`;
+        try {
+            context.metadata({ title: `🎬 Extracting frames...` });
+            const extractedFiles = extractWithSystemFFmpeg(videoPath, SAVE_DIR, baseName, {
+                at_time: args.at_time,
+                start: args.start,
+                end: args.end,
+                fps: args.fps,
+            });
+            // Cleanup temp video if downloaded
+            if (isRemote && fs.existsSync(videoPath)) {
+                try {
+                    fs.unlinkSync(videoPath);
+                }
+                catch { }
+            }
+            if (extractedFiles.length === 0) {
+                return `❌ No frames extracted. Check your timestamps and video source.`;
+            }
+            // Calculate total size
+            const totalSize = extractedFiles.reduce((sum, f) => sum + fs.statSync(f).size, 0);
+            const fileList = extractedFiles.length <= 5
+                ? extractedFiles.map(f => `  ${path.basename(f)}`).join('\n')
+                : [
+                    ...extractedFiles.slice(0, 3).map(f => `  ${path.basename(f)}`),
+                    `  ... and ${extractedFiles.length - 3} more`,
+                ].join('\n');
+            return [
+                `🎬 Frames Extracted`,
+                `━━━━━━━━━━━━━━━━━━━`,
+                `Source: ${isRemote ? args.source : path.basename(videoPath)}`,
+                `Frames: ${extractedFiles.length}`,
+                `Directory: ${SAVE_DIR}`,
+                `Total size: ${formatFileSize(totalSize)}`,
+                `Files:`,
+                fileList,
+                ``,
+                `Cost: Free (local ffmpeg)`,
+            ].join('\n');
+        }
+        catch (err) {
+            // Cleanup on error
+            if (isRemote && fs.existsSync(videoPath)) {
+                try {
+                    fs.unlinkSync(videoPath);
+                }
+                catch { }
+            }
+            return `❌ Frame extraction error: ${err.message}`;
+        }
+    },
+});

package/dist/tools/power/file_to_url.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+export declare const fileToUrlTool: ToolDefinition;