wispy-ai 1.4.1 → 1.5.0

package/dist/agents/tool-executor.d.ts

@@ -29,7 +29,12 @@ export declare class ToolExecutor {
     private cronService?;
     private reminderService?;
     private progressCallback?;
+    private liveStream?;
     constructor(config: WispyConfig, runtimeDir: string, soulDir: string, memoryManager?: MemoryManager, integrationRegistry?: IntegrationRegistry, mcpRegistry?: McpRegistry);
+    /**
+     * Check if a file path is allowed based on filesystem access settings.
+     */
+    private isPathAllowed;
     /**
      * Set callback for progress notifications (used by Telegram visuals)
      */
@@ -145,6 +150,7 @@ export declare class ToolExecutor {
     private executeResearchReport;
     private executeGenerateX402Report;
     private executeSendDocumentToTelegram;
+    private executeTelegramListFiles;
     private executeSendProgressUpdate;
     private executeAskUserConfirmation;
     private executeFilePermissions;
@@ -160,6 +166,11 @@ export declare class ToolExecutor {
     private executeRealisticVoiceReply;
     private executeDesktopScreenshot;
     private executeScreenRecord;
+    private executeWebcamCapture;
+    private executeWebcamRecord;
+    private executeWebcamListDevices;
+    private executeWebcamLiveStart;
+    private executeWebcamLiveStop;
     private executeGitInit;
     private executeGitCommit;
     private executeGitPush;

package/dist/agents/tool-executor.d.ts.map

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

package/dist/agents/tool-executor.js

@@ -58,6 +58,7 @@ export class ToolExecutor {
     cronService;
     reminderService;
     progressCallback;
+    liveStream;
     constructor(config, runtimeDir, soulDir, memoryManager, integrationRegistry, mcpRegistry) {
         this.config = config;
         this.runtimeDir = runtimeDir;
@@ -66,6 +67,22 @@ export class ToolExecutor {
         this.integrationRegistry = integrationRegistry;
         this.mcpRegistry = mcpRegistry;
     }
+    /**
+     * Check if a file path is allowed based on filesystem access settings.
+     */
+    isPathAllowed(filePath) {
+        // Always allow runtime and soul directories
+        if (filePath.startsWith(this.runtimeDir) || filePath.startsWith(this.soulDir))
+            return true;
+        // Autonomous mode or full filesystem access: allow all
+        if (this.config.security.autonomousMode || this.config.security.fullFilesystemAccess)
+            return true;
+        // Standard mode: restrict to workspace
+        const workspaceDir = resolve(this.runtimeDir, "workspace");
+        if (filePath.startsWith(workspaceDir))
+            return true;
+        return false;
+    }
     /**
      * Set callback for progress notifications (used by Telegram visuals)
      */
@@ -242,6 +259,8 @@ export class ToolExecutor {
                 // === Telegram Document Delivery ===
                 case "send_document_to_telegram":
                     return this.executeSendDocumentToTelegram(tool.args);
+                case "telegram_list_files":
+                    return this.executeTelegramListFiles(tool.args);
                 case "send_progress_update":
                     return this.executeSendProgressUpdate(tool.args);
                 case "ask_user_confirmation":
@@ -276,6 +295,17 @@ export class ToolExecutor {
                     return this.executeDesktopScreenshot(tool.args);
                 case "screen_record":
                     return this.executeScreenRecord(tool.args);
+                // === Webcam & Live Vision ===
+                case "webcam_capture":
+                    return this.executeWebcamCapture(tool.args);
+                case "webcam_record":
+                    return this.executeWebcamRecord(tool.args);
+                case "webcam_list_devices":
+                    return this.executeWebcamListDevices();
+                case "webcam_live_start":
+                    return this.executeWebcamLiveStart(tool.args);
+                case "webcam_live_stop":
+                    return this.executeWebcamLiveStop();
                 // === Git & GitHub ===
                 case "git_init":
                     return this.executeGitInit(tool.args);
@@ -363,14 +393,22 @@ export class ToolExecutor {
             }
         }
         try {
-            // Use workspace directory as cwd for relative commands
-            const { join } = await import("path");
-            const workspaceDir = join(this.runtimeDir, "workspace");
-            ensureDir(workspaceDir);
+            // Determine working directory: explicit cwd arg, or fallback to workspace
+            const { join, isAbsolute } = await import("path");
+            const customCwd = args.cwd ? String(args.cwd) : "";
+            let effectiveCwd;
+            if (customCwd && isAbsolute(customCwd) && existsSync(customCwd)) {
+                effectiveCwd = customCwd;
+            }
+            else {
+                const workspaceDir = join(this.runtimeDir, "workspace");
+                ensureDir(workspaceDir);
+                effectiveCwd = workspaceDir;
+            }
             const { stdout, stderr } = await execAsync(command, {
                 timeout: 180000, // 3 minutes for npm operations
                 maxBuffer: 10 * 1024 * 1024, // 10MB for large outputs
-                cwd: workspaceDir, // Run commands in workspace
+                cwd: effectiveCwd,
                 env: { ...process.env },
             });
             const combined = stdout + (stderr ? `\nSTDERR: ${stderr}` : "");
@@ -449,6 +487,9 @@ export class ToolExecutor {
         const path = String(args.path || "");
         if (!path)
             return { success: false, output: "", error: "No path provided" };
+        if (!this.isPathAllowed(resolve(path))) {
+            return { success: false, output: "", error: `Access denied: ${path}\nEnable full filesystem access with: /setup or set security.fullFilesystemAccess in config.` };
+        }
         if (!existsSync(path))
             return { success: false, output: "", error: `File not found: ${path}` };
         try {
@@ -476,6 +517,9 @@ export class ToolExecutor {
             ensureDir(workspaceDir);
             path = resolvePath(workspaceDir, path);
         }
+        if (!this.isPathAllowed(path)) {
+            return { success: false, output: "", error: `Access denied: ${path}\nEnable full filesystem access with: /setup or set security.fullFilesystemAccess in config.` };
+        }
         // Create checkpoint before overwrite
         if (existsSync(path)) {
             try {
@@ -498,11 +542,10 @@ export class ToolExecutor {
         catch (err) {
             // Handle permission errors with helpful message
             if (err.code === "EPERM" || err.code === "EACCES") {
-                const workspaceDir = join(this.runtimeDir, "workspace");
                 return {
                     success: false,
                     output: "",
-                    error: `Permission denied: ${path}\n\nI don't have write access to this location. Try using a relative path (e.g., "calculator/index.html") and I'll create it in my workspace: ${workspaceDir}`,
+                    error: `Permission denied: ${path}\n\nI don't have write access to this location. Try a different directory, or check folder permissions.`,
                 };
             }
             return { success: false, output: "", error: err.message };
@@ -1410,11 +1453,10 @@ export class ToolExecutor {
         catch (err) {
             // Handle permission errors with helpful message
             if (err.code === "EPERM" || err.code === "EACCES") {
-                const workspaceDir = join(this.runtimeDir, "workspace");
                 return {
                     success: false,
                     output: "",
-                    error: `Permission denied: ${path}\n\nTry using a relative path (e.g., "my-project") and I'll create it in my workspace: ${workspaceDir}`,
+                    error: `Permission denied: ${path}\n\nI don't have access to this location. Try a different directory, or check folder permissions.`,
                 };
             }
             return { success: false, output: "", error: err.message };
@@ -3295,6 +3337,40 @@ export default ${componentName};
             return { success: false, output: "", error: `Send document error: ${err.message}` };
         }
     }
+    async executeTelegramListFiles(args) {
+        try {
+            const { homedir } = await import("os");
+            const { join, basename } = await import("path");
+            const targetDir = String(args.directory || join(homedir(), "Downloads"));
+            if (!existsSync(targetDir)) {
+                return { success: false, output: "", error: `Directory not found: ${targetDir}` };
+            }
+            const entries = readdirSync(targetDir, { withFileTypes: true })
+                .slice(0, 50)
+                .map((e) => {
+                const icon = e.isDirectory() ? "[DIR]" : "[FILE]";
+                return `${icon} ${e.name}`;
+            });
+            const listing = `Directory: ${targetDir}\n\n${entries.join("\n") || "(empty)"}`;
+            // If sendFile is specified, also send that file as attachment
+            const sendFile = args.sendFile ? String(args.sendFile) : "";
+            if (sendFile && existsSync(sendFile)) {
+                const chatId = this.currentChatContext?.chatId
+                    || process.env.TELEGRAM_CHAT_ID;
+                if (chatId) {
+                    try {
+                        const { sendTelegramDocument } = await import("../channels/telegram/adapter.js");
+                        await sendTelegramDocument(chatId, sendFile, basename(sendFile));
+                    }
+                    catch { /* non-fatal */ }
+                }
+            }
+            return { success: true, output: listing };
+        }
+        catch (err) {
+            return { success: false, output: "", error: `List files error: ${err.message}` };
+        }
+    }
     async executeSendProgressUpdate(args) {
         const type = String(args.type || "update");
         const message = String(args.message || "");
@@ -3392,7 +3468,7 @@ export default ${componentName};
             // For grant actions, we just report what would happen (actual chmod is too dangerous)
             return {
                 success: true,
-                output: `Permission action '${action}' noted. In sandboxed mode, use workspace directory for full access: ${resolve(this.runtimeDir, "workspace")}`,
+                output: `Permission action '${action}' noted. Use file_write with an absolute path to write files anywhere you have access.`,
             };
         }
         catch (err) {
@@ -4019,6 +4095,168 @@ ${newTaskContext}
         }
     }
     // ═══════════════════════════════════════════════════════════════════════════════
+    // WEBCAM & LIVE VISION TOOLS
+    // ═══════════════════════════════════════════════════════════════════════════════
+    async executeWebcamCapture(args) {
+        try {
+            const { captureFrame } = await import("../vision/webcam.js");
+            const outputDir = resolve(this.runtimeDir, "captures");
+            const framePath = captureFrame({
+                device: args.device ? String(args.device) : undefined,
+                width: args.width ? Number(args.width) : undefined,
+                height: args.height ? Number(args.height) : undefined,
+                outputDir,
+            });
+            // Send to chat if requested
+            if (args.sendToChat && this.currentChatContext?.chatId) {
+                try {
+                    const { sendDocument } = await import("../documents/telegram-delivery.js");
+                    await sendDocument(this.currentChatContext.chatId, framePath, {
+                        caption: "Webcam capture",
+                    });
+                }
+                catch (sendErr) {
+                    log.warn("Failed to send webcam capture to chat: %s", sendErr.message);
+                }
+            }
+            return {
+                success: true,
+                output: `Webcam frame captured!\nPath: ${framePath}${args.sendToChat ? "\nSent to Telegram: Yes" : ""}`,
+            };
+        }
+        catch (err) {
+            return { success: false, output: "", error: `Webcam capture failed: ${err.message}` };
+        }
+    }
+    async executeWebcamRecord(args) {
+        try {
+            const { recordVideo } = await import("../vision/webcam.js");
+            const outputDir = resolve(this.runtimeDir, "captures");
+            const videoPath = recordVideo({
+                device: args.device ? String(args.device) : undefined,
+                duration: args.duration ? Number(args.duration) : undefined,
+                fps: args.fps ? Number(args.fps) : undefined,
+                outputDir,
+            });
+            const { statSync } = await import("fs");
+            const stats = statSync(videoPath);
+            const sizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+            // Send to chat if requested
+            if (args.sendToChat && this.currentChatContext?.chatId) {
+                try {
+                    const { sendDocument } = await import("../documents/telegram-delivery.js");
+                    await sendDocument(this.currentChatContext.chatId, videoPath, {
+                        caption: `Webcam recording (${args.duration || 10}s)`,
+                    });
+                }
+                catch (sendErr) {
+                    log.warn("Failed to send webcam video to chat: %s", sendErr.message);
+                }
+            }
+            return {
+                success: true,
+                output: `Webcam video recorded!\nPath: ${videoPath}\nDuration: ${args.duration || 10}s\nSize: ${sizeMB} MB${args.sendToChat ? "\nSent to Telegram: Yes" : ""}`,
+            };
+        }
+        catch (err) {
+            return { success: false, output: "", error: `Webcam recording failed: ${err.message}` };
+        }
+    }
+    async executeWebcamListDevices() {
+        try {
+            const { listDevices, isFfmpegAvailable } = await import("../vision/webcam.js");
+            if (!isFfmpegAvailable()) {
+                return {
+                    success: false,
+                    output: "",
+                    error: "FFmpeg not found. Install FFmpeg to use webcam features: https://ffmpeg.org/download.html",
+                };
+            }
+            const devices = listDevices();
+            if (devices.length === 0) {
+                return {
+                    success: true,
+                    output: "No video capture devices found. Make sure a webcam is connected.",
+                };
+            }
+            const lines = devices.map((d, i) => `${i + 1}. ${d.name} (ID: ${d.id}, Type: ${d.type})`);
+            return {
+                success: true,
+                output: `Found ${devices.length} video device(s):\n${lines.join("\n")}`,
+            };
+        }
+        catch (err) {
+            return { success: false, output: "", error: `Device listing failed: ${err.message}` };
+        }
+    }
+    async executeWebcamLiveStart(args) {
+        try {
+            // Check if already running
+            if (this.liveStream?.getStatus().running) {
+                return {
+                    success: false,
+                    output: "",
+                    error: "A live stream is already running. Call webcam_live_stop first.",
+                };
+            }
+            const { LiveVisionStream } = await import("../vision/live-stream.js");
+            this.liveStream = new LiveVisionStream();
+            const intervalMs = args.intervalMs ? Number(args.intervalMs) : 2000;
+            const maxFrames = args.maxFrames ? Number(args.maxFrames) : 30;
+            const prompt = args.prompt ? String(args.prompt) : undefined;
+            const device = args.device ? String(args.device) : undefined;
+            const outputDir = resolve(this.runtimeDir, "captures");
+            // Start the stream -- onFrame sends analysis to chat or logs it
+            const chatCtx = this.currentChatContext;
+            await this.liveStream.start({
+                device,
+                intervalMs,
+                maxFrames,
+                prompt,
+                outputDir,
+                onFrame: async (analysis, frameIndex) => {
+                    const msg = `[Frame ${frameIndex}] ${analysis}`;
+                    log.info(msg);
+                    // Send to Telegram if available
+                    if (chatCtx?.chatId) {
+                        try {
+                            const { sendDocument } = await import("../documents/telegram-delivery.js");
+                            // Use Telegram bot API to send text message
+                            const token = process.env.TELEGRAM_BOT_TOKEN;
+                            if (token) {
+                                await fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
+                                    method: "POST",
+                                    headers: { "Content-Type": "application/json" },
+                                    body: JSON.stringify({ chat_id: chatCtx.chatId, text: msg }),
+                                });
+                            }
+                        }
+                        catch { /* best-effort */ }
+                    }
+                },
+            });
+            return {
+                success: true,
+                output: `Live vision stream started!\nInterval: ${intervalMs}ms\nMax frames: ${maxFrames}\nPrompt: ${prompt || "Describe what you see"}\nDevice: ${device || "default"}`,
+            };
+        }
+        catch (err) {
+            return { success: false, output: "", error: `Live stream failed: ${err.message}` };
+        }
+    }
+    async executeWebcamLiveStop() {
+        if (!this.liveStream) {
+            return { success: false, output: "", error: "No live stream is running." };
+        }
+        const status = this.liveStream.getStatus();
+        this.liveStream.stop();
+        const elapsed = status.startedAt ? Math.round((Date.now() - status.startedAt) / 1000) : 0;
+        return {
+            success: true,
+            output: `Live stream stopped.\nFrames analyzed: ${status.framesAnalyzed}\nDuration: ${elapsed}s\nLast analysis: ${status.lastAnalysis || "N/A"}`,
+        };
+    }
+    // ═══════════════════════════════════════════════════════════════════════════════
     // GIT & GITHUB TOOLS
     // ═══════════════════════════════════════════════════════════════════════════════
     async executeGitInit(args) {