aura-code 0.3.7 → 0.6.3

package/dist/tools/telegram.js

@@ -40,20 +40,25 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 exports.TELEGRAM_DEFINITION = {
     name: 'telegram',
-    description: 'Communicate via Telegram Bot. Send text messages, photos, documents. Read incoming messages. ' +
+    description: 'Communicate via Telegram Bot. Send text messages, photos, videos, documents. Read incoming messages. ' +
         'Configure ~/.aura/telegram.json with { "bot_token": "...", "default_chat_id": "..." }. ' +
         'Create a bot via @BotFather on Telegram.',
     parameters: {
         type: 'object',
         properties: {
-            action: { type: 'string', description: 'Action: send, send_photo, send_document, get_updates, get_chat, set_webhook, info' },
+            action: { type: 'string', description: 'Action: send, send_photo, send_video, send_document, get_updates, get_chat, set_webhook, info' },
             chat_id: { type: 'string', description: 'Chat ID (uses default from config if omitted)' },
             text: { type: 'string', description: 'Message text (for send)' },
             photo: { type: 'string', description: 'Photo path or URL (for send_photo)' },
+            video: { type: 'string', description: 'Video URL or file_id (for send_video). Local files not yet supported — use a hosted URL.' },
             document: { type: 'string', description: 'Document path or URL (for send_document)' },
-            caption: { type: 'string', description: 'Caption for photo/document' },
+            caption: { type: 'string', description: 'Caption for photo/video/document' },
             parse_mode: { type: 'string', description: 'Parse mode: HTML, Markdown, MarkdownV2' },
             reply_to: { type: 'number', description: 'Message ID to reply to' },
+            duration: { type: 'number', description: 'Video duration in seconds (for send_video)' },
+            width: { type: 'number', description: 'Video width in pixels (for send_video)' },
+            height: { type: 'number', description: 'Video height in pixels (for send_video)' },
+            supports_streaming: { type: 'boolean', description: 'Pass True if the video supports streaming (for send_video)' },
             offset: { type: 'number', description: 'Update offset for get_updates (to acknowledge processed updates)' },
             limit: { type: 'number', description: 'Max updates to fetch (default: 10)' },
             webhook_url: { type: 'string', description: 'Webhook URL for set_webhook' },
@@ -109,6 +114,59 @@ async function apiGet(token, method, params) {
     return data.result;
 }
 // ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/** Check if a path is a local file (exists on disk), not a URL */
+function isLocalPath(p) {
+    return !p.startsWith('http://') && !p.startsWith('https://') && fs.existsSync(p);
+}
+/** Get MIME type from file extension */
+function mimeFromExt(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const mimeMap = {
+        '.jpg': 'image/jpeg',
+        '.jpeg': 'image/jpeg',
+        '.png': 'image/png',
+        '.gif': 'image/gif',
+        '.webp': 'image/webp',
+        '.bmp': 'image/bmp',
+        '.mp4': 'video/mp4',
+        '.avi': 'video/x-msvideo',
+        '.mov': 'video/quicktime',
+        '.webm': 'video/webm',
+        '.pdf': 'application/pdf',
+        '.txt': 'text/plain',
+        '.zip': 'application/zip',
+    };
+    return mimeMap[ext] ?? 'application/octet-stream';
+}
+/**
+ * Send a file to Telegram via multipart/form-data upload.
+ * Used when the file is a local path rather than a URL.
+ */
+async function sendFileMultipart(token, method, fields, fileField, filePath) {
+    const url = `${API_BASE}/bot${token}/${method}`;
+    const formData = new FormData();
+    for (const [key, val] of Object.entries(fields)) {
+        formData.append(key, val);
+    }
+    const fileName = path.basename(filePath);
+    const mimeType = mimeFromExt(filePath);
+    const fileBuffer = fs.readFileSync(filePath);
+    const file = new File([fileBuffer], fileName, { type: mimeType });
+    formData.append(fileField, file);
+    const response = await fetch(url, {
+        method: 'POST',
+        body: formData,
+        signal: AbortSignal.timeout(30_000),
+    });
+    const data = await response.json();
+    if (!data.ok) {
+        throw new Error(`Telegram API error: ${data.description ?? 'Unknown error'} (code: ${data.error_code})`);
+    }
+    return data.result;
+}
+// ─────────────────────────────────────────────────────────────────────────────
 // Actions
 // ─────────────────────────────────────────────────────────────────────────────
 async function doSend(config, input) {
@@ -134,9 +192,21 @@ async function doSendPhoto(config, input) {
         return 'Error: chat_id required';
     if (!input.photo)
         return 'Error: photo required';
+    const photo = input.photo;
+    if (isLocalPath(photo)) {
+        // Local file — upload via multipart/form-data
+        const fields = { chat_id: chatId };
+        if (input.caption)
+            fields.caption = input.caption;
+        if (input.parse_mode)
+            fields.parse_mode = input.parse_mode;
+        const result = await sendFileMultipart(config.bot_token, 'sendPhoto', fields, 'photo', photo);
+        return `Photo sent to ${chatId} (msg_id: ${result.message_id})`;
+    }
+    // URL or file_id — send as JSON (Telegram fetches the URL)
     const body = {
         chat_id: chatId,
-        photo: input.photo,
+        photo: photo,
     };
     if (input.caption)
         body.caption = input.caption;
@@ -145,15 +215,54 @@ async function doSendPhoto(config, input) {
     const result = await api(config.bot_token, 'sendPhoto', body);
     return `Photo sent to ${chatId} (msg_id: ${result.message_id})`;
 }
+async function doSendVideo(config, input) {
+    const chatId = input.chat_id ?? config.default_chat_id;
+    if (!chatId)
+        return 'Error: chat_id required';
+    if (!input.video)
+        return 'Error: video required (URL or file_id)';
+    const body = {
+        chat_id: chatId,
+        video: input.video,
+    };
+    if (input.caption)
+        body.caption = input.caption;
+    if (input.parse_mode)
+        body.parse_mode = input.parse_mode;
+    if (input.duration !== undefined)
+        body.duration = input.duration;
+    if (input.width !== undefined)
+        body.width = input.width;
+    if (input.height !== undefined)
+        body.height = input.height;
+    if (input.supports_streaming !== undefined)
+        body.supports_streaming = input.supports_streaming;
+    if (input.reply_to)
+        body.reply_to_message_id = input.reply_to;
+    const result = await api(config.bot_token, 'sendVideo', body);
+    return `Video sent to ${chatId} (msg_id: ${result.message_id})`;
+}
 async function doSendDocument(config, input) {
     const chatId = input.chat_id ?? config.default_chat_id;
     if (!chatId)
         return 'Error: chat_id required';
     if (!input.document)
         return 'Error: document required';
+    const document = input.document;
+    if (isLocalPath(document)) {
+        // Local file — upload via multipart/form-data
+        const fields = { chat_id: chatId };
+        if (input.caption)
+            fields.caption = input.caption;
+        if (input.parse_mode)
+            fields.parse_mode = input.parse_mode;
+        const result = await sendFileMultipart(config.bot_token, 'sendDocument', fields, 'document', document);
+        return `Document sent to ${chatId} (msg_id: ${result.message_id})`;
+    }
+    // URL — send as JSON (Telegram fetches the URL)
     const body = {
         chat_id: chatId,
-        document: input.document,
+        document: document,
     };
     if (input.caption)
         body.caption = input.caption;
@@ -212,6 +321,7 @@ async function telegramTool(input) {
         switch (input.action) {
             case 'send': return await doSend(config, input);
             case 'send_photo': return await doSendPhoto(config, input);
+            case 'send_video': return await doSendVideo(config, input);
             case 'send_document': return await doSendDocument(config, input);
             case 'get_updates': return await doGetUpdates(config, input);
             case 'get_chat': return await doGetChat(config, input);

package/dist/tools/telegram.js.map

@@ -1 +1 @@
-{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/tools/telegram.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/tools/telegram.ts"],"names":[],"mappings":"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"}

package/dist/tools/video-render.d.ts

@@ -0,0 +1,11 @@
+export interface RenderOptions {
+    htmlPath: string;
+    output: string;
+    fps?: number;
+    width?: number;
+    height?: number;
+    duration?: number;
+    keepFrames?: boolean;
+    onProgress?: (current: number, total: number) => void;
+}
+export declare function renderVideo(options: RenderOptions): Promise<string>;

package/dist/tools/video-render.js

@@ -0,0 +1,189 @@
+"use strict";
+/// <reference lib="dom" />
+/// <reference lib="dom" />
+// ─────────────────────────────────────────────────────────────────────────────
+// Video Renderer — Puppeteer frame capture + ffmpeg MP4 encoding
+// Takes an HTML file with CSS animations, captures every frame via Puppeteer,
+// pipes PNGs to ffmpeg, produces an MP4.  No new dependencies required.
+// ─────────────────────────────────────────────────────────────────────────────
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderVideo = renderVideo;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+// ─────────────────────────────────────────────────────────────────────────────
+// Chrome detection
+// ─────────────────────────────────────────────────────────────────────────────
+function findChrome() {
+    const candidates = [
+        'google-chrome-stable', 'google-chrome', 'chromium-browser', 'chromium',
+    ];
+    for (const cmd of candidates) {
+        try {
+            const result = (0, child_process_1.execSync)(`which ${cmd}`, { stdio: 'pipe' });
+            return result.toString().trim();
+        }
+        catch { }
+    }
+    // Direct paths as fallback
+    const directPaths = [
+        '/usr/bin/google-chrome-stable', '/usr/bin/google-chrome',
+        '/usr/bin/chromium-browser', '/snap/bin/chromium',
+    ];
+    for (const p of directPaths) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    throw new Error('Chrome/Chromium not found.');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Main render function
+// ─────────────────────────────────────────────────────────────────────────────
+async function renderVideo(options) {
+    const { htmlPath, output, fps = 30, width = 1920, height = 1080, keepFrames = false, onProgress, } = options;
+    const absHtml = path.resolve(htmlPath);
+    if (!fs.existsSync(absHtml))
+        throw new Error(`HTML not found: ${absHtml}`);
+    const absOutput = path.resolve(output);
+    const outDir = path.dirname(absOutput);
+    if (!fs.existsSync(outDir))
+        fs.mkdirSync(outDir, { recursive: true });
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'aura-video-'));
+    const framePattern = path.join(tmpDir, 'frame-%06d.png');
+    // Puppeteer
+    const puppeteer = await Promise.resolve().then(() => __importStar(require('puppeteer-core')));
+    const browser = await puppeteer.launch({
+        executablePath: findChrome(),
+        headless: true,
+        args: ['--no-sandbox', '--disable-gpu', '--disable-dev-shm-usage'],
+    });
+    let totalFrames = 0;
+    try {
+        const page = await browser.newPage();
+        await page.setViewport({ width, height, deviceScaleFactor: 1 });
+        await page.goto(`file://${absHtml}`, { waitUntil: 'networkidle0', timeout: 15000 });
+        const pageDuration = options.duration ??
+            (await page.evaluate(() => {
+                const el = document.getElementById('__duration');
+                return el ? parseFloat(el.textContent || '5') : 5;
+            }));
+        totalFrames = Math.ceil(pageDuration * fps);
+        // Inject animation seek controller
+        await page.evaluate(() => {
+            const style = document.createElement('style');
+            style.id = '__aura-control';
+            style.textContent = `.aura-el { animation-play-state: paused !important; opacity: 0; }`;
+            document.head.appendChild(style);
+            window.__seek = (t) => {
+                document.querySelectorAll('.aura-el').forEach((el) => {
+                    const enter = parseFloat(el.dataset.enter || '0');
+                    const exit = parseFloat(el.dataset.exit || '9999');
+                    const dur = parseFloat(el.dataset.dur || '0.5');
+                    const enterAnim = el.dataset.enterAnim || 'fadeIn';
+                    const exitAnim = el.dataset.exitAnim || 'fadeOut';
+                    const centered = 'translate(-50%, -50%)';
+                    if (t < enter) {
+                        el.style.opacity = '0';
+                        el.style.animation = 'none';
+                        el.style.transform = centered;
+                    }
+                    else if (t >= enter && t < enter + dur) {
+                        const elapsed = t - enter;
+                        el.style.animation = `${enterAnim} ${dur}s ease-out 1 forwards`;
+                        el.style.animationDelay = `-${elapsed}s`;
+                        el.style.animationPlayState = 'paused';
+                    }
+                    else if (t >= enter + dur && t < exit) {
+                        el.style.opacity = '1';
+                        el.style.animation = 'none';
+                        el.style.transform = centered;
+                    }
+                    else if (t >= exit && t < exit + dur) {
+                        const elapsed = t - exit;
+                        el.style.animation = `${exitAnim} ${dur}s ease-in 1 forwards`;
+                        el.style.animationDelay = `-${elapsed}s`;
+                        el.style.animationPlayState = 'paused';
+                    }
+                    else {
+                        el.style.opacity = '0';
+                        el.style.animation = 'none';
+                        el.style.transform = centered;
+                    }
+                });
+            };
+        });
+        // Capture frames
+        let lastLog = -1;
+        for (let frame = 0; frame < totalFrames; frame++) {
+            const t = frame / fps;
+            await page.evaluate((time) => { window.__seek?.(time); }, t);
+            const fp = path.join(tmpDir, `frame-${String(frame).padStart(6, '0')}.png`);
+            await page.screenshot({ path: fp, type: 'png' });
+            const pct = Math.round((frame / totalFrames) * 100);
+            if (pct >= lastLog + 10) {
+                lastLog = pct;
+                onProgress?.(frame, totalFrames);
+            }
+        }
+        await page.close();
+    }
+    finally {
+        await browser.close();
+    }
+    onProgress?.(totalFrames, totalFrames);
+    // ffmpeg stitch
+    await new Promise((resolve, reject) => {
+        const ffmpeg = (0, child_process_1.spawn)('ffmpeg', [
+            '-y', '-framerate', String(fps), '-i', framePattern,
+            '-c:v', 'libx264', '-preset', 'medium', '-crf', '18',
+            '-pix_fmt', 'yuv420p', '-movflags', '+faststart', absOutput,
+        ], { stdio: ['ignore', 'pipe', 'pipe'] });
+        let stderr = '';
+        ffmpeg.stderr.on('data', (d) => { stderr += d.toString(); });
+        ffmpeg.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`ffmpeg exit ${code}: ${stderr.slice(-400)}`));
+        });
+        ffmpeg.on('error', reject);
+    });
+    if (!keepFrames)
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    return absOutput;
+}
+//# sourceMappingURL=video-render.js.map

package/dist/tools/video-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-render.js","sourceRoot":"","sources":["../../src/tools/video-render.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-search.d.ts

@@ -1,4 +1,24 @@
 import type { ToolDefinition } from '../providers/types.js';
+/**
+ * Web Search — multi-provider with graceful fallback.
+ *
+ * Resolution order:
+ *   1. Tavily   (process.env.TAVILY_API_KEY) — AI-tuned, best snippets, 1000/mo free
+ *   2. Serper   (process.env.SERPER_API_KEY) — Google results passthrough, 2500/mo free
+ *   3. DuckDuckGo HTML scrape — no key required, but brittle (DDG changes
+ *      its markup periodically; the scraper rots).
+ *
+ * If ALL THREE fail, we return an explicit `Error: web search unavailable...`
+ * string. This is critical — the previous implementation silently returned
+ * `"No results found for: <query>"` on scraper breakage, which the calling
+ * agents interpreted as a real empty result and then re-queried 15+ times
+ * burning tokens (see :council Pavle / SpaceX incidents, 2026-06-26). Loud
+ * errors make agents stop retrying and try a different tool (e.g. web_fetch
+ * to a known URL).
+ *
+ * Tool interface (name, params, return shape) is unchanged from the
+ * original so the agent loop and existing tests keep working.
+ */
 export interface WebSearchInput {
     query: string;
     max_results?: number;