ft-scout 9.0.2 → 9.0.4

package/bin/src/engine/appControl.js

@@ -1,2320 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import http from 'http';
-import https from 'https';
-import { exec, spawn, ChildProcess } from 'child_process';
-import { promisify } from 'util';
-import OpenAI from 'openai';
-import dotenv from 'dotenv';
-import chalk from 'chalk';
-import { startLiveScreenShare, stopLiveScreenShare, isLiveScreenShareActive, getLiveScreenFrame, analyzeLiveScreen, callVisionAiWithFrame, setLiveScreenTargetApp, getLiveScreenTargetApp, } from './liveScreenEngine.js';
-dotenv.config({ quiet: true });
-const execAsync = promisify(exec);
-/**
- * Standardize app name aliases across platforms.
- */
-export function normalizeAppName(rawAppName) {
-    const appLower = (rawAppName || '').trim().toLowerCase();
-    if (['browser', 'chrome', 'google-chrome', 'msedge', 'edge', 'firefox', 'brave', 'safari', 'opera', 'instagram', 'whatsapp', 'twitter', 'x', 'telegram', 'linkedin', 'slack', 'discord'].includes(appLower)) {
-        return { category: 'browser', name: appLower || 'browser' };
-    }
-    if (['terminal', 'cmd', 'powershell', 'pwsh', 'wt', 'windows-terminal', 'iterm', 'bash', 'zsh', 'sh', 'console', 'konsole'].includes(appLower)) {
-        return { category: 'terminal', name: appLower || 'terminal' };
-    }
-    if (['code', 'vscode', 'visual-studio-code', 'cursor', 'zed', 'sublime', 'notepad', 'notepad++', 'vim', 'nvim', 'nano', 'editor'].includes(appLower)) {
-        return { category: 'editor', name: appLower || 'editor' };
-    }
-    if (['game', 'games', 'gaming', 'play', 'launcher', 'steam', 'epic', 'epicgames', 'riot', 'battlenet', 'ea', 'ubisoft', 'gog'].includes(appLower) || appLower.startsWith('game:')) {
-        return { category: 'game', name: appLower };
-    }
-    return { category: 'system', name: appLower };
-}
-export function parsePayload(payload) {
-    if (!payload)
-        return {};
-    if (typeof payload === 'object')
-        return payload;
-    if (typeof payload === 'string') {
-        const trimmed = payload.trim();
-        if (trimmed.startsWith('{') && trimmed.endsWith('}')) {
-            try {
-                return JSON.parse(trimmed);
-            }
-            catch { }
-        }
-    }
-    return { target: payload };
-}
-export function buildSocialUrl(platformOrAppName, target, text) {
-    const parsedPayload = parsePayload(target);
-    const rawTarget = typeof target === 'string' && !target.trim().startsWith('{')
-        ? target.trim()
-        : (parsedPayload.recipient || parsedPayload.user || parsedPayload.username || parsedPayload.handle || parsedPayload.target || parsedPayload.url || '');
-    const rawMsgText = text || parsedPayload.text || parsedPayload.message || parsedPayload.content || '';
-    const pLower = (platformOrAppName || parsedPayload.platform || '').toLowerCase().trim();
-    const cleanTarget = String(rawTarget || '').trim();
-    const handleMatch = cleanTarget.match(/@?([a-zA-Z0-9_.-]+)/);
-    const handle = handleMatch && handleMatch[1] ? handleMatch[1] : '';
-    const isInstagram = pLower.includes('instagram') || cleanTarget.includes('instagram') || cleanTarget.startsWith('@');
-    const isWhatsApp = pLower.includes('whatsapp') || cleanTarget.includes('whatsapp') || (/^\+?[0-9]{7,15}$/.test(cleanTarget) && !cleanTarget.startsWith('http'));
-    const isTwitter = pLower.includes('twitter') || pLower.includes('x') || cleanTarget.includes('x.com') || cleanTarget.includes('twitter.com');
-    const isTelegram = pLower.includes('telegram') || cleanTarget.includes('t.me');
-    const isLinkedIn = pLower.includes('linkedin') || cleanTarget.includes('linkedin.com');
-    if (isInstagram) {
-        if (handle && handle !== 'instagram' && !cleanTarget.includes('http')) {
-            return `https://www.instagram.com/direct/i/`;
-        }
-        return `https://www.instagram.com/direct/inbox/`;
-    }
-    if (isWhatsApp) {
-        const phone = cleanTarget.replace(/[^0-9]/g, '');
-        const msgParam = rawMsgText ? `?text=${encodeURIComponent(rawMsgText)}` : '';
-        if (phone) {
-            return `https://web.whatsapp.com/send?phone=${phone}${rawMsgText ? `&text=${encodeURIComponent(rawMsgText)}` : ''}`;
-        }
-        return `https://web.whatsapp.com/send${msgParam}`;
-    }
-    if (isTwitter) {
-        if (handle && !cleanTarget.includes('http')) {
-            return `https://x.com/direct_messages/create/${handle}`;
-        }
-        return `https://x.com/direct_messages`;
-    }
-    if (isTelegram) {
-        if (handle)
-            return `https://t.me/${handle}`;
-        return `https://web.telegram.org/`;
-    }
-    if (isLinkedIn) {
-        return `https://www.linkedin.com/messaging/`;
-    }
-    const isEmail = pLower.includes('gmail') || pLower.includes('mail') || pLower.includes('email') || (cleanTarget.includes('@') && cleanTarget.includes('.')) || cleanTarget.includes('mail.google.com');
-    if (isEmail) {
-        const to = cleanTarget.includes('@') && !cleanTarget.startsWith('http') ? cleanTarget : (parsedPayload.to || parsedPayload.recipient || '');
-        const subject = parsedPayload.subject || parsedPayload.su || 'Message from Scout';
-        const body = rawMsgText || parsedPayload.body || '';
-        if (to || body) {
-            return `https://mail.google.com/mail/?view=cm&fs=1${to ? `&to=${encodeURIComponent(to)}` : ''}${subject ? `&su=${encodeURIComponent(subject)}` : ''}${body ? `&body=${encodeURIComponent(body)}` : ''}`;
-        }
-        return 'https://mail.google.com';
-    }
-    if (cleanTarget.startsWith('http://') || cleanTarget.startsWith('https://')) {
-        return cleanTarget;
-    }
-    if (cleanTarget.includes('.') && !cleanTarget.includes(' ') && !cleanTarget.includes('{')) {
-        return `http://${cleanTarget}`;
-    }
-    return 'https://www.instagram.com/direct/inbox/';
-}
-/**
- * Universally search and locate any installed app, game, or store package on the host OS without hardcoding.
- * Automatically resolves Win32 executables, Microsoft Store games, Steam games, and desktop shortcuts.
- */
-export async function findInstalledApp(query) {
-    const cleanQuery = (query || '').replace(/[^\w\s-]/g, '').trim().toLowerCase();
-    if (!cleanQuery)
-        return null;
-    const platform = process.platform;
-    if (platform === 'win32') {
-        try {
-            // Query Windows Get-StartApps with wildcard matching
-            const safePattern = `*${cleanQuery.replace(/[*_']/g, '')}*`;
-            const psCmd = `powershell.exe -NoProfile -NonInteractive -Command "Get-StartApps -Name '${safePattern}' | Select-Object -First 1 Name, AppID | ConvertTo-Json"`;
-            const { stdout } = await execAsync(psCmd, { timeout: 3500 });
-            if (stdout && stdout.trim()) {
-                const parsed = JSON.parse(stdout.trim());
-                if (parsed && (parsed.Name || parsed.AppID)) {
-                    return {
-                        name: String(parsed.Name || query),
-                        appId: String(parsed.AppID || ''),
-                        source: 'start_apps',
-                    };
-                }
-            }
-        }
-        catch { }
-        // Fallback: check registered URI scheme protocol (e.g. steam, roblox, spotify, discord, minecraft, riot)
-        if (!cleanQuery.includes(' ') && cleanQuery.length >= 3) {
-            try {
-                const checkReg = `powershell.exe -NoProfile -NonInteractive -Command "Test-Path 'Registry::HKEY_CLASSES_ROOT\\${cleanQuery}'"`;
-                const { stdout } = await execAsync(checkReg, { timeout: 1500 });
-                if (stdout && stdout.trim().toLowerCase() === 'true') {
-                    return {
-                        name: query,
-                        appId: `${cleanQuery}:`,
-                        source: 'protocol',
-                    };
-                }
-            }
-            catch { }
-        }
-    }
-    else if (platform === 'darwin') {
-        try {
-            const { stdout } = await execAsync(`mdfind "kMDItemKind == 'Application' && kMDItemDisplayName == '*${cleanQuery}*'c" | head -n 1`, { timeout: 3000 });
-            if (stdout && stdout.trim()) {
-                return {
-                    name: path.basename(stdout.trim(), '.app'),
-                    appId: stdout.trim(),
-                    source: 'path',
-                };
-            }
-        }
-        catch { }
-    }
-    else {
-        // Linux: check which or desktop application entries
-        try {
-            const { stdout } = await execAsync(`which "${cleanQuery}" || find /usr/share/applications -name "*${cleanQuery}*.desktop" | head -n 1`, { timeout: 2500 });
-            if (stdout && stdout.trim()) {
-                return {
-                    name: query,
-                    appId: stdout.trim(),
-                    source: 'path',
-                };
-            }
-        }
-        catch { }
-    }
-    return null;
-}
-/**
- * Cross-platform app opener.
- * Launches and opens target application on Windows, macOS, or Linux.
- */
-export async function openApp(appNameOrPath, target, options) {
-    const { category, name } = normalizeAppName(appNameOrPath);
-    if (name && name !== 'desktop' && name !== 'system') {
-        setLiveScreenTargetApp(name);
-    }
-    const platform = process.platform;
-    let command = '';
-    const cleanTarget = target ? target.trim() : '';
-    if (category === 'browser') {
-        let url = cleanTarget;
-        const parsedPayload = parsePayload(cleanTarget);
-        const rawRecipient = parsedPayload.recipient || parsedPayload.username || parsedPayload.handle || parsedPayload.target || cleanTarget;
-        if (['instagram', 'whatsapp', 'twitter', 'x', 'telegram', 'linkedin'].includes(name) || cleanTarget.includes('instagram') || cleanTarget.includes('whatsapp') || cleanTarget.includes('x.com') || cleanTarget.includes('t.me') || String(rawRecipient).startsWith('@')) {
-            url = buildSocialUrl(name, cleanTarget, options?.args?.[0]);
-        }
-        else if (!url.startsWith('http://') && !url.startsWith('https://')) {
-            url = url && !url.includes('{') ? `http://${url}` : 'https://google.com';
-        }
-        if (platform === 'win32') {
-            if (name === 'chrome' || name === 'google-chrome') {
-                command = `start chrome "${url}"`;
-            }
-            else if (name === 'edge' || name === 'msedge') {
-                command = `start msedge "${url}"`;
-            }
-            else if (name === 'firefox') {
-                command = `start firefox "${url}"`;
-            }
-            else if (name === 'brave') {
-                command = `start brave "${url}"`;
-            }
-            else {
-                command = `start "" "${url}"`;
-            }
-        }
-        else if (platform === 'darwin') {
-            if (name === 'chrome' || name === 'google-chrome') {
-                command = `open -a "Google Chrome" "${url}"`;
-            }
-            else if (name === 'firefox') {
-                command = `open -a "Firefox" "${url}"`;
-            }
-            else if (name === 'safari') {
-                command = `open -a "Safari" "${url}"`;
-            }
-            else {
-                command = `open "${url}"`;
-            }
-        }
-        else {
-            // Linux
-            if (name === 'chrome' || name === 'google-chrome') {
-                command = `google-chrome "${url}" &`;
-            }
-            else if (name === 'firefox') {
-                command = `firefox "${url}" &`;
-            }
-            else {
-                command = `xdg-open "${url}" &`;
-            }
-        }
-    }
-    else if (category === 'terminal') {
-        const initialCmd = cleanTarget;
-        if (platform === 'win32') {
-            if (name === 'wt' || name === 'windows-terminal' || name === 'terminal') {
-                command = initialCmd ? `start wt.exe powershell -NoExit -Command "${initialCmd.replace(/"/g, '`"')}"` : `start wt.exe`;
-            }
-            else if (name === 'cmd') {
-                command = initialCmd ? `start cmd.exe /k "${initialCmd}"` : `start cmd.exe`;
-            }
-            else {
-                // powershell / default
-                command = initialCmd ? `start powershell.exe -NoExit -Command "${initialCmd.replace(/"/g, '`"')}"` : `start powershell.exe`;
-            }
-        }
-        else if (platform === 'darwin') {
-            if (name === 'iterm') {
-                command = `open -a iTerm .`;
-            }
-            else {
-                command = `open -a Terminal .`;
-            }
-        }
-        else {
-            // Linux
-            command = `x-terminal-emulator &`;
-        }
-    }
-    else if (category === 'editor') {
-        const fileOrDir = cleanTarget || '.';
-        if (name === 'code' || name === 'vscode' || name === 'visual-studio-code' || name === 'cursor' || name === 'editor') {
-            const exe = name === 'cursor' ? 'cursor' : 'code';
-            command = `${exe} "${fileOrDir}"`;
-        }
-        else if (name === 'notepad' && platform === 'win32') {
-            command = `start notepad "${fileOrDir}"`;
-        }
-        else if (platform === 'win32') {
-            command = `start "" "${fileOrDir}"`;
-        }
-        else if (platform === 'darwin') {
-            command = `open -a "Visual Studio Code" "${fileOrDir}"`;
-        }
-        else {
-            command = `xdg-open "${fileOrDir}" &`;
-        }
-    }
-    else {
-        // Universal Application, Game & Desktop Launcher (Zero-Hardcode OS Discovery)
-        const targetQuery = name || appNameOrPath;
-        const installedApp = await findInstalledApp(targetQuery);
-        if (installedApp) {
-            if (platform === 'win32') {
-                if (installedApp.source === 'protocol') {
-                    const extraArg = cleanTarget ? ` "${cleanTarget}"` : '';
-                    command = `start ${installedApp.appId}${extraArg}`;
-                }
-                else {
-                    command = `explorer.exe "shell:AppsFolder\\${installedApp.appId}"`;
-                }
-            }
-            else if (platform === 'darwin') {
-                command = `open -a "${installedApp.appId || installedApp.name}"`;
-            }
-            else {
-                command = `"${installedApp.appId || installedApp.name}" &`;
-            }
-        }
-        else {
-            // Protocol scheme check (e.g. steam:, roblox:, spotify:, discord:, minecraft:, etc.)
-            const isProtocol = /^[a-zA-Z0-9_\-]+:/.test(appNameOrPath) || (cleanTarget && /^[a-zA-Z0-9_\-]+:/.test(cleanTarget));
-            if (isProtocol && platform === 'win32') {
-                const proto = /^[a-zA-Z0-9_\-]+:/.test(appNameOrPath) ? appNameOrPath : cleanTarget;
-                command = `start ${proto}`;
-            }
-            else if (platform === 'win32') {
-                command = cleanTarget ? `start "" "${appNameOrPath}" ${cleanTarget}` : `start "" "${appNameOrPath}"`;
-            }
-            else if (platform === 'darwin') {
-                command = cleanTarget ? `open -a "${appNameOrPath}" "${cleanTarget}"` : `open -a "${appNameOrPath}"`;
-            }
-            else {
-                command = cleanTarget ? `${appNameOrPath} "${cleanTarget}" &` : `${appNameOrPath} &`;
-            }
-        }
-    }
-    try {
-        await execAsync(command, { timeout: 3000 });
-        return {
-            success: true,
-            app: name || appNameOrPath,
-            action: 'open',
-            output: `Successfully launched ${name || appNameOrPath} [Category: ${category}] with target "${cleanTarget || 'default'}". Executed command: \`${command}\`.`,
-            details: { category, appName: name || appNameOrPath, target: cleanTarget, command, platform },
-        };
-    }
-    catch (err) {
-        // Fallback for GUI commands that spawn detached processes or timeout waiting for process exit
-        return {
-            success: true,
-            app: name || appNameOrPath,
-            action: 'open',
-            output: `Triggered app launch for ${name || appNameOrPath} (Platform: ${platform}). Command: \`${command}\`. Note: ${err?.message || 'Process spawned in background.'}`,
-            details: { category, appName: name || appNameOrPath, target: cleanTarget, command, platform, warning: err?.message },
-        };
-    }
-}
-/**
- * Execute automation actions within an opened application context.
- */
-export async function executeInApp(appName, action, payload) {
-    const { category, name } = normalizeAppName(appName);
-    const actLower = (action || '').trim().toLowerCase();
-    // Focus live screen sharing on the active app being operated
-    if (name && name !== 'desktop' && name !== 'system') {
-        setLiveScreenTargetApp(name);
-    }
-    // Universal Scratchpad Desktop Automation Actions (Takeover, Screen Seeing, Keystrokes, Mouse Clicks, Focus Locks)
-    if (['takeover', 'takeover_control', 'takeover_screen', 'takeover_app'].includes(actLower)) {
-        const parsed = parsePayload(payload);
-        const duration = typeof parsed.duration === 'number' ? parsed.duration : 3000;
-        const x = typeof parsed.x === 'number' ? parsed.x : undefined;
-        const y = typeof parsed.y === 'number' ? parsed.y : undefined;
-        const res = await takeoverControl(name || appName, duration, x, y);
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.output,
-            details: res.details,
-        };
-    }
-    if (['release_takeover', 'unlock_screen', 'unlock_app', 'unlock_input', 'unlock'].includes(actLower)) {
-        const res = await releaseTakeover();
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.output,
-        };
-    }
-    if (['start_screen_share', 'live_screen_share', 'screen_share', 'start_live_stream'].includes(actLower)) {
-        const targetApp = (name && name !== 'desktop' && name !== 'system') ? name : undefined;
-        const res = await startLiveScreenShare({ targetApp });
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.message,
-            details: { active: true, targetApp },
-        };
-    }
-    if (['stop_screen_share', 'end_screen_share', 'stop_live_stream'].includes(actLower)) {
-        const res = stopLiveScreenShare();
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.summary,
-            details: { active: false },
-        };
-    }
-    if (['capture_screen', 'screenshot', 'screen_shot'].includes(actLower)) {
-        if (isLiveScreenShareActive()) {
-            const liveRes = await analyzeLiveScreen();
-            return {
-                success: liveRes.success,
-                app: name || appName,
-                action: actLower,
-                output: liveRes.output,
-                details: liveRes.details,
-            };
-        }
-        const res = await captureScreen(name || appName);
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.output,
-            details: res.details,
-        };
-    }
-    if (['see_screen', 'inspect_screen', 'view_screen', 'analyze_screen', 'inspect_desktop', 'visual_analysis', 'see_and_analyze', 'live_screen_stream', 'screen_stream'].includes(actLower)) {
-        const query = typeof payload === 'string' ? payload : (payload?.query || payload?.target || payload?.text || undefined);
-        const res = await analyzeLiveScreen(query);
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.output,
-            details: res.details,
-        };
-    }
-    if (['get_screen_info', 'list_screens', 'screen_bounds', 'screen_info'].includes(actLower)) {
-        const res = await getScreenInfo(name || appName);
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.output,
-            details: res.details,
-        };
-    }
-    if (['type_text', 'send_keys', 'type', 'keystrokes', 'key_combo', 'press_hotkey', 'hotkey'].includes(actLower)) {
-        const parsed = parsePayload(payload);
-        const isHotKeyAction = ['key_combo', 'press_hotkey', 'hotkey', 'send_keys'].includes(actLower);
-        let keyCombo = undefined;
-        let textToType = '';
-        if (typeof parsed === 'object') {
-            keyCombo = parsed.keyCombo || parsed.combo || parsed.hotkey || parsed.keys || parsed.key;
-            textToType = parsed.text || parsed.content || parsed.message || '';
-        }
-        if (!keyCombo && typeof payload === 'string') {
-            const trimmed = payload.trim();
-            if (isHotKeyAction || trimmed.includes('+') || ['enter', 'return', 'tab', 'esc', 'escape', 'backspace', 'space', 'up', 'down', 'left', 'right'].includes(trimmed.toLowerCase())) {
-                keyCombo = trimmed;
-            }
-            else {
-                textToType = trimmed;
-            }
-        }
-        else if (!textToType && typeof payload === 'string' && !payload.trim().startsWith('{')) {
-            textToType = payload;
-        }
-        const pressEnter = typeof parsed === 'object' && parsed.enter !== undefined ? parsed.enter : !isHotKeyAction;
-        const ksRes = await sendKeystrokes(name || appName, textToType, pressEnter, keyCombo);
-        return {
-            success: ksRes.success,
-            app: name || appName,
-            action: actLower,
-            output: ksRes.output,
-            details: { appName: name || appName, textToType, pressEnter, keyCombo },
-        };
-    }
-    if (['click_element', 'click_ui', 'click_button', 'tap_element'].includes(actLower)) {
-        const parsed = parsePayload(payload);
-        const query = typeof parsed === 'object' ? (parsed.element || parsed.target || parsed.name || parsed.query || '') : String(parsed || payload);
-        const button = typeof parsed === 'object' && parsed.button ? parsed.button : 'left';
-        const res = await findAndClickElement(query, name || appName, button);
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.output,
-            details: res.coordinates,
-        };
-    }
-    if (['click', 'click_app', 'click_at', 'move_mouse', 'drag_mouse'].includes(actLower)) {
-        const parsedPayload = parsePayload(payload);
-        if (typeof parsedPayload === 'object' && parsedPayload.element && parsedPayload.x === undefined) {
-            const res = await findAndClickElement(parsedPayload.element, name || appName, parsedPayload.button || 'left');
-            return {
-                success: res.success,
-                app: name || appName,
-                action: actLower,
-                output: res.output,
-                details: res.coordinates,
-            };
-        }
-        const x = typeof parsedPayload.x === 'number' ? parsedPayload.x : undefined;
-        const y = typeof parsedPayload.y === 'number' ? parsedPayload.y : undefined;
-        const button = ['right', 'double', 'middle', 'scroll'].includes(parsedPayload.button) ? parsedPayload.button : 'left';
-        const clickRes = await moveAndClickMouse(x, y, button, name || appName);
-        return {
-            success: clickRes.success,
-            app: name || appName,
-            action: actLower,
-            output: clickRes.output,
-            details: { appName: name || appName, x, y, button },
-        };
-    }
-    if (['scroll', 'scroll_window', 'scroll_down', 'scroll_up', 'scroll_page'].includes(actLower)) {
-        const parsed = parsePayload(payload);
-        let direction = 'down';
-        let amount = 3;
-        if (typeof parsed === 'object') {
-            if (parsed.direction === 'up' || parsed.dir === 'up')
-                direction = 'up';
-            if (typeof parsed.amount === 'number')
-                amount = parsed.amount;
-            if (typeof parsed.clicks === 'number')
-                amount = parsed.clicks;
-        }
-        else if (typeof payload === 'string' && payload.toLowerCase().includes('up')) {
-            direction = 'up';
-        }
-        if (actLower === 'scroll_up')
-            direction = 'up';
-        const res = await scrollWindow(direction, amount);
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.output,
-        };
-    }
-    if (['list_windows', 'get_windows', 'open_windows', 'show_windows'].includes(actLower)) {
-        const res = await listWindows();
-        return {
-            success: res.success,
-            app: name || appName,
-            action: actLower,
-            output: res.output,
-            details: res.windows,
-        };
-    }
-    if (['focus_window', 'switch_window', 'bring_to_front', 'select_window'].includes(actLower)) {
-        const parsed = parsePayload(payload);
-        const target = typeof parsed === 'object' ? (parsed.title || parsed.app || parsed.name || '') : String(parsed || payload || name || appName);
-        const res = await focusWindow(target);
-        return {
-            success: res.success,
-            app: target,
-            action: actLower,
-            output: res.output,
-        };
-    }
-    if (['lock_app', 'block_interruption', 'lock_input', 'lock'].includes(actLower)) {
-        const parsedPayload = parsePayload(payload);
-        const durationMs = typeof parsedPayload.duration === 'number' ? parsedPayload.duration : 3000;
-        const lockRes = await lockAppInput(name || appName, durationMs);
-        return {
-            success: lockRes.success,
-            app: name || appName,
-            action: actLower,
-            output: lockRes.output,
-            details: { appName: name || appName, durationMs },
-        };
-    }
-    if (category === 'browser') {
-        if (['navigate', 'goto', 'open_url'].includes(actLower)) {
-            const rawUrl = typeof payload === 'string' ? payload : (payload?.url || payload?.target || 'https://google.com');
-            let targetUrl = rawUrl.trim();
-            let navigationNote = '';
-            // Universal URL vs Search Query Grounding:
-            // If the input is not a valid URL (contains spaces or lacks a dot / scheme), convert into a search
-            if (!targetUrl.startsWith('http://') && !targetUrl.startsWith('https://')) {
-                if (targetUrl.includes(' ') || !targetUrl.includes('.')) {
-                    navigationNote = ` [Note: Plain search term passed to navigate; converted to web search query]`;
-                    targetUrl = `https://www.google.com/search?q=${encodeURIComponent(targetUrl)}`;
-                }
-                else {
-                    targetUrl = `https://${targetUrl}`;
-                }
-            }
-            await openApp(name || 'browser', targetUrl);
-            await new Promise((r) => setTimeout(r, 800));
-            const capture = await captureScreen(name || 'browser');
-            return {
-                success: true,
-                app: name || 'browser',
-                action: actLower,
-                output: `Browser Navigated Successfully to Target URL: ${targetUrl}${navigationNote}\n- Screenshot Saved: ${capture.details?.outPath || 'Active'}`,
-                details: { url: targetUrl, capture: capture.details },
-            };
-        }
-        if (actLower === 'fetch_page' || actLower === 'read_url' || actLower === 'inspect_dom') {
-            const rawUrl = typeof payload === 'string' ? payload : (payload?.url || payload?.target || 'http://localhost:3000');
-            const targetUrl = rawUrl.startsWith('http://') || rawUrl.startsWith('https://') ? rawUrl : `http://${rawUrl}`;
-            try {
-                const pageContent = await fetchUrlContent(targetUrl);
-                const textSnippet = extractTextFromHtml(pageContent);
-                return {
-                    success: true,
-                    app: name,
-                    action: actLower,
-                    output: `Browser Action [${actLower}] for ${targetUrl}:\n\n` +
-                        `--- Page Text Preview (${textSnippet.length} chars) ---\n` +
-                        `${textSnippet.slice(0, 2000)}${textSnippet.length > 2000 ? '\n... [truncated]' : ''}`,
-                    details: { url: targetUrl, fullHtmlLength: pageContent.length, textLength: textSnippet.length },
-                };
-            }
-            catch (err) {
-                return {
-                    success: false,
-                    app: name,
-                    action: actLower,
-                    output: `Failed to fetch page at ${targetUrl}: ${err?.message || String(err)}`,
-                };
-            }
-        }
-        if (actLower === 'search' || actLower === 'search_web') {
-            const query = typeof payload === 'string' ? payload : (payload?.query || payload?.target || payload?.url || '');
-            const isUrl = query.startsWith('http://') || query.startsWith('https://') || (query.includes('.') && !query.includes(' '));
-            if (isUrl) {
-                const targetUrl = query.startsWith('http://') || query.startsWith('https://') ? query : `https://${query}`;
-                return await executeInApp(name || 'browser', 'navigate', targetUrl);
-            }
-            // Direct Search in browser window
-            const searchUrl = `https://www.google.com/search?q=${encodeURIComponent(query)}`;
-            await openApp(name || 'browser', searchUrl);
-            await new Promise((r) => setTimeout(r, 800));
-            const capture = await captureScreen(name || 'browser');
-            return {
-                success: true,
-                app: name,
-                action: actLower,
-                output: `Browser search executed for "${query}" at ${searchUrl}.\n- Screenshot Saved: ${capture.details?.outPath || 'Active'}`,
-                details: { query, searchUrl, capture: capture.details },
-            };
-        }
-        if (['send_dm', 'open_dm', 'dm', 'send_message', 'message', 'social_dm', 'send_mail', 'send_email', 'mail', 'email'].includes(actLower)) {
-            const parsed = parsePayload(payload);
-            const recipient = typeof payload === 'string' && payload.includes('@') && !payload.startsWith('{')
-                ? payload
-                : (parsed.recipient || parsed.to || parsed.user || parsed.target || parsed.handle || parsed.username || '');
-            let msgText = typeof parsed === 'object' ? (parsed.text || parsed.message || parsed.content || parsed.body) : undefined;
-            if (!msgText && typeof payload === 'string' && payload.length > 0 && !payload.startsWith('@') && !payload.startsWith('http') && !payload.includes('@')) {
-                msgText = payload;
-            }
-            const isEmail = ['send_mail', 'send_email', 'mail', 'email'].includes(actLower) || recipient.includes('@');
-            const targetUrl = buildSocialUrl(isEmail ? 'gmail' : name, recipient, msgText);
-            const openRes = await openApp('browser', targetUrl);
-            let keystrokeOutput = '';
-            if (isEmail) {
-                // For Gmail direct compose: wait 2.5s for page & compose dialog to render, then press Ctrl+Enter to send!
-                await lockAppInput('browser', 3500);
-                await new Promise((r) => setTimeout(r, 2200));
-                const ksRes = await sendKeystrokes('browser', '', false, 'ctrl+enter');
-                keystrokeOutput = `\nAuto-Send Keystroke Dispatch (Ctrl+Enter): ${ksRes.output}`;
-            }
-            else if (msgText) {
-                // Lock user interruption during scratchpad keystroke dispatch so user clicks don't interrupt
-                await lockAppInput(name || 'browser', 3000);
-                await new Promise((r) => setTimeout(r, 1200));
-                const ksRes = await sendKeystrokes(name || 'browser', msgText, true);
-                keystrokeOutput = `\nAuto-Keystroke Automated Dispatch: ${ksRes.output}`;
-            }
-            return {
-                success: true,
-                app: name,
-                action: actLower,
-                output: `Executed ${isEmail ? 'Gmail / Email Dispatch' : `${name} Direct Message`} for target recipient "${recipient}" at ${targetUrl}.${keystrokeOutput}`,
-                details: { platform: isEmail ? 'gmail' : name, recipient, msgText, targetUrl },
-            };
-        }
-    }
-    if (category === 'terminal') {
-        if (actLower === 'exec_command' || actLower === 'run_script' || actLower === 'run') {
-            const cmdStr = typeof payload === 'string' ? payload : (payload?.command || payload?.cmd || payload?.script || 'echo "Terminal Action Executed"');
-            try {
-                const { stdout, stderr } = await execAsync(cmdStr, { cwd: process.cwd() });
-                return {
-                    success: true,
-                    app: name,
-                    action: actLower,
-                    output: `Terminal Execution inside ${name}:\nCommand: \`${cmdStr}\`\n\nOutput:\n${stdout || stderr || '(No output)'}`,
-                    details: { command: cmdStr, stdout, stderr },
-                };
-            }
-            catch (err) {
-                return {
-                    success: false,
-                    app: name,
-                    action: actLower,
-                    output: `Terminal Execution Failed for \`${cmdStr}\`: ${err?.message || String(err)}`,
-                };
-            }
-        }
-    }
-    if (category === 'editor') {
-        if (actLower === 'open_file' || actLower === 'view_file' || actLower === 'open') {
-            const filePath = typeof payload === 'string' ? payload : (payload?.path || payload?.target || '.');
-            return await openApp(name, filePath);
-        }
-    }
-    if (category === 'game' || ['open', 'launch', 'start'].includes(actLower)) {
-        const rawTarget = typeof payload === 'string' ? payload : (payload?.target || payload?.game || payload?.url || payload?.query || payload?.id || '');
-        return await openApp(name || appName, rawTarget);
-    }
-    // Generic fallback app action
-    return {
-        success: true,
-        app: name,
-        action: actLower,
-        output: `Executed app action "${actLower}" on ${name}. Target/Payload: ${JSON.stringify(payload || {})}`,
-        details: { appName: name, action: actLower, payload },
-    };
-}
-/**
- * Simple HTTP/HTTPS URL content fetcher for browser page inspection.
- */
-function fetchUrlContent(targetUrl) {
-    return new Promise((resolve, reject) => {
-        const client = targetUrl.startsWith('https:') ? https : http;
-        const req = client.get(targetUrl, { timeout: 10000 }, (res) => {
-            if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-                const redirectUrl = res.headers.location.startsWith('http')
-                    ? res.headers.location
-                    : new URL(res.headers.location, targetUrl).toString();
-                return fetchUrlContent(redirectUrl).then(resolve).catch(reject);
-            }
-            let data = '';
-            res.setEncoding('utf-8');
-            res.on('data', (chunk) => { data += chunk; });
-            res.on('end', () => { resolve(data); });
-        });
-        req.on('error', (err) => reject(err));
-        req.on('timeout', () => {
-            req.destroy();
-            reject(new Error(`HTTP request timed out after 10000ms for ${targetUrl}`));
-        });
-    });
-}
-/**
- * Basic HTML to plain text converter for page inspection.
- */
-function extractTextFromHtml(html) {
-    if (!html)
-        return '';
-    return html
-        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
-        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
-        .replace(/<[^>]+>/g, ' ')
-        .replace(/\s+/g, ' ')
-        .trim();
-}
-/**
- * Diagnostics report of active host platform app launchers.
- */
-export function getAppCapabilities() {
-    const platform = process.platform;
-    return {
-        platform,
-        supportedCategories: ['browser', 'terminal', 'editor', 'system'],
-        defaultBrowserLauncher: platform === 'win32' ? 'start' : platform === 'darwin' ? 'open' : 'xdg-open',
-        defaultTerminalLauncher: platform === 'win32' ? 'wt.exe / powershell.exe' : platform === 'darwin' ? 'Terminal.app' : 'x-terminal-emulator',
-        defaultEditorLauncher: platform === 'win32' ? 'code / notepad' : platform === 'darwin' ? 'code / open -a' : 'code / xdg-open',
-    };
-}
-const WIN_CAPTURE_SCRIPT_CONTENT = `param(
-    [string]$OutPath,
-    [switch]$InfoOnly
-)
-
-$source = @"
-using System;
-using System.Drawing;
-using System.Drawing.Imaging;
-using System.Runtime.InteropServices;
-using System.Text;
-using System.Threading;
-using System.Collections.Generic;
-
-public class WinCaptureResult {
-    public bool success;
-    public string savedPath;
-    public int width;
-    public int height;
-    public int cursorX;
-    public int cursorY;
-    public string activeWindow;
-    public string[] visibleWindows;
-    public string error;
-}
-
-public class WinCaptureHelper {
-    [DllImport("user32.dll", SetLastError = true)]
-    public static extern IntPtr OpenInputDesktop(uint dwFlags, bool fInherit, uint dwDesiredAccess);
-
-    [DllImport("user32.dll", SetLastError = true)]
-    public static extern IntPtr OpenDesktop(string lpszDesktop, uint dwFlags, bool fInherit, uint dwDesiredAccess);
-
-    [DllImport("user32.dll", SetLastError = true)]
-    public static extern bool SetThreadDesktop(IntPtr hDesktop);
-
-    [DllImport("user32.dll", SetLastError = true)]
-    public static extern bool CloseDesktop(IntPtr hDesktop);
-
-    [DllImport("user32.dll")]
-    public static extern IntPtr GetDC(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    public static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);
-
-    [DllImport("gdi32.dll")]
-    public static extern IntPtr CreateCompatibleDC(IntPtr hdc);
-
-    [DllImport("gdi32.dll")]
-    public static extern IntPtr CreateCompatibleBitmap(IntPtr hdc, int nWidth, int nHeight);
-
-    [DllImport("gdi32.dll")]
-    public static extern IntPtr SelectObject(IntPtr hdc, IntPtr hgdiobj);
-
-    [DllImport("gdi32.dll")]
-    public static extern bool DeleteDC(IntPtr hdc);
-
-    [DllImport("gdi32.dll")]
-    public static extern bool DeleteObject(IntPtr hObject);
-
-    [DllImport("gdi32.dll")]
-    public static extern bool BitBlt(IntPtr hdcDest, int nXDest, int nYDest, int nWidth, int nHeight, IntPtr hdcSrc, int nXSrc, int nYSrc, int dwRop);
-
-    [DllImport("user32.dll")]
-    public static extern int GetSystemMetrics(int nIndex);
-
-    public delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);
-
-    [DllImport("user32.dll")]
-    public static extern bool EnumWindows(EnumWindowsProc lpEnumFunc, IntPtr lParam);
-
-    [DllImport("user32.dll", CharSet = CharSet.Auto)]
-    public static extern int GetWindowText(IntPtr hWnd, StringBuilder lpString, int nMaxCount);
-
-    [DllImport("user32.dll")]
-    public static extern bool IsWindowVisible(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    public static extern IntPtr GetForegroundWindow();
-
-    [StructLayout(LayoutKind.Sequential)]
-    public struct POINT {
-        public int X;
-        public int Y;
-    }
-
-    [DllImport("user32.dll")]
-    public static extern bool GetCursorPos(out POINT lpPoint);
-
-    const uint DESKTOP_ACCESS = 0x01FF | 0x00020000;
-    const int SM_CXSCREEN = 0;
-    const int SM_CYSCREEN = 1;
-    const int SRCCOPY = 0x00CC0020;
-    const int CAPTUREBLT = 0x40000000;
-
-    public static WinCaptureResult GetInfo() {
-        var res = new WinCaptureResult();
-        res.success = true;
-        res.error = "";
-        var visibleWindows = new List<string>();
-
-        Thread worker = new Thread(() => {
-            IntPtr hDesk = OpenInputDesktop(0, false, DESKTOP_ACCESS);
-            if (hDesk == IntPtr.Zero) {
-                hDesk = OpenDesktop("Default", 0, false, DESKTOP_ACCESS);
-            }
-            if (hDesk != IntPtr.Zero) {
-                SetThreadDesktop(hDesk);
-            }
-
-            res.width = GetSystemMetrics(SM_CXSCREEN);
-            res.height = GetSystemMetrics(SM_CYSCREEN);
-            if (res.width <= 0) res.width = 1920;
-            if (res.height <= 0) res.height = 1080;
-
-            POINT pt;
-            if (GetCursorPos(out pt)) {
-                res.cursorX = pt.X;
-                res.cursorY = pt.Y;
-            }
-
-            IntPtr fg = GetForegroundWindow();
-            if (fg != IntPtr.Zero) {
-                var sbFg = new StringBuilder(256);
-                GetWindowText(fg, sbFg, 256);
-                res.activeWindow = sbFg.ToString().Trim();
-            } else {
-                res.activeWindow = "";
-            }
-
-            EnumWindows((hWnd, lParam) => {
-                if (IsWindowVisible(hWnd)) {
-                    var title = new StringBuilder(256);
-                    GetWindowText(hWnd, title, 256);
-                    string t = title.ToString().Trim();
-                    if (t.Length > 0 && !visibleWindows.Contains(t) && t != "Program Manager" && t != "Windows Input Experience") {
-                        visibleWindows.Add(t);
-                    }
-                }
-                return true;
-            }, IntPtr.Zero);
-
-            if (hDesk != IntPtr.Zero) {
-                CloseDesktop(hDesk);
-            }
-        });
-
-        worker.SetApartmentState(ApartmentState.STA);
-        worker.Start();
-        worker.Join();
-
-        res.visibleWindows = visibleWindows.ToArray();
-        return res;
-    }
-
-    public static WinCaptureResult Capture(string filePath) {
-        var res = new WinCaptureResult();
-        res.savedPath = filePath;
-        res.error = "";
-        var visibleWindows = new List<string>();
-
-        Thread worker = new Thread(() => {
-            IntPtr hDesk = OpenInputDesktop(0, false, DESKTOP_ACCESS);
-            if (hDesk == IntPtr.Zero) {
-                hDesk = OpenDesktop("Default", 0, false, DESKTOP_ACCESS);
-            }
-            if (hDesk != IntPtr.Zero) {
-                SetThreadDesktop(hDesk);
-            }
-
-            res.width = GetSystemMetrics(SM_CXSCREEN);
-            res.height = GetSystemMetrics(SM_CYSCREEN);
-            if (res.width <= 0) res.width = 1920;
-            if (res.height <= 0) res.height = 1080;
-
-            POINT pt;
-            if (GetCursorPos(out pt)) {
-                res.cursorX = pt.X;
-                res.cursorY = pt.Y;
-            }
-
-            IntPtr fg = GetForegroundWindow();
-            if (fg != IntPtr.Zero) {
-                var sbFg = new StringBuilder(256);
-                GetWindowText(fg, sbFg, 256);
-                res.activeWindow = sbFg.ToString().Trim();
-            } else {
-                res.activeWindow = "";
-            }
-
-            EnumWindows((hWnd, lParam) => {
-                if (IsWindowVisible(hWnd)) {
-                    var title = new StringBuilder(256);
-                    GetWindowText(hWnd, title, 256);
-                    string t = title.ToString().Trim();
-                    if (t.Length > 0 && !visibleWindows.Contains(t) && t != "Program Manager" && t != "Windows Input Experience") {
-                        visibleWindows.Add(t);
-                    }
-                }
-                return true;
-            }, IntPtr.Zero);
-
-            try {
-                IntPtr hdcSrc = GetDC(IntPtr.Zero);
-                IntPtr hdcDest = CreateCompatibleDC(hdcSrc);
-                IntPtr hBitmap = CreateCompatibleBitmap(hdcSrc, res.width, res.height);
-                IntPtr hOld = SelectObject(hdcDest, hBitmap);
-                bool bltOk = BitBlt(hdcDest, 0, 0, res.width, res.height, hdcSrc, 0, 0, SRCCOPY | CAPTUREBLT);
-
-                SelectObject(hdcDest, hOld);
-                DeleteDC(hdcDest);
-                ReleaseDC(IntPtr.Zero, hdcSrc);
-
-                if (bltOk) {
-                    using (Bitmap bmp = Bitmap.FromHbitmap(hBitmap)) {
-                        bmp.Save(filePath, ImageFormat.Png);
-                    }
-                    res.success = true;
-                } else {
-                    res.error = "BitBlt failed";
-                }
-                DeleteObject(hBitmap);
-            } catch (Exception ex) {
-                res.error = ex.Message;
-            }
-
-            if (hDesk != IntPtr.Zero) {
-                CloseDesktop(hDesk);
-            }
-        });
-
-        worker.SetApartmentState(ApartmentState.STA);
-        worker.Start();
-        worker.Join();
-
-        res.visibleWindows = visibleWindows.ToArray();
-        return res;
-    }
-}
-"@
-
-Add-Type -TypeDefinition $source -ReferencedAssemblies System.Drawing, System.Windows.Forms
-
-if ($InfoOnly) {
-    [WinCaptureHelper]::GetInfo() | ConvertTo-Json -Compress
-} else {
-    [WinCaptureHelper]::Capture($OutPath) | ConvertTo-Json -Compress
-}
-`;
-export function ensureWinCaptureScript() {
-    const scriptsDir = path.join(process.cwd(), '.ft', 'scripts');
-    if (!fs.existsSync(scriptsDir)) {
-        fs.mkdirSync(scriptsDir, { recursive: true });
-    }
-    const scriptPath = path.join(scriptsDir, 'winCapture.ps1');
-    fs.writeFileSync(scriptPath, WIN_CAPTURE_SCRIPT_CONTENT, 'utf8');
-    return scriptPath;
-}
-/**
- * Get screen metrics, active window title, visible windows, and cursor position.
- */
-export async function getScreenInfo(appName) {
-    const platform = process.platform;
-    if (platform === 'win32') {
-        try {
-            const scriptPath = ensureWinCaptureScript();
-            const { stdout } = await execAsync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${scriptPath}" -InfoOnly`);
-            const data = JSON.parse(stdout.trim());
-            const visList = Array.isArray(data.visibleWindows) && data.visibleWindows.length > 0
-                ? ` | Visible Windows: ${data.visibleWindows.slice(0, 5).join(', ')}`
-                : '';
-            return {
-                success: true,
-                output: `Screen Info: Resolution ${data.screenWidth}x${data.screenHeight} | Cursor at (${data.cursorX}, ${data.cursorY}) | Active Window: "${data.activeWindow || appName || 'Desktop'}"${visList}`,
-                details: {
-                    ...data,
-                    activeWindow: data.activeWindow || appName || 'Desktop',
-                },
-            };
-        }
-        catch {
-            return {
-                success: true,
-                output: `Screen Info (Default): Resolution 1920x1080 | Active Window: "${appName || 'Desktop'}"`,
-                details: { screenWidth: 1920, screenHeight: 1080, activeWindow: appName || 'Desktop', cursorX: 0, cursorY: 0 },
-            };
-        }
-    }
-    else {
-        return {
-            success: true,
-            output: `Screen Info (${platform}): Primary display active | Target App: "${appName || 'Desktop'}"`,
-            details: { platform, appName: appName || 'Desktop' },
-        };
-    }
-}
-function escapeXaml(text) {
-    return text
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&apos;')
-        .replace(/•/g, '&#x2022;');
-}
-let persistentAuraProcess = null;
-let persistentAuraFlagPath = null;
-/**
- * Start persistent futuristic sky-blue aura overlay on screen borders and corners.
- * Stays continuously active and animating as long as live screen sharing is running.
- */
-export async function startScreenAuraOverlay(message = "Live Screen Share Active • Streaming to Model") {
-    const platform = process.platform;
-    if (platform !== 'win32')
-        return;
-    // Stop any existing overlay first
-    stopScreenAuraOverlay();
-    try {
-        const scriptsDir = path.join(process.cwd(), '.ft', 'scripts');
-        if (!fs.existsSync(scriptsDir)) {
-            fs.mkdirSync(scriptsDir, { recursive: true });
-        }
-        const psFile = path.join(scriptsDir, 'scout_aura_persistent.ps1');
-        const flagFile = path.join(scriptsDir, 'aura_active.flag');
-        fs.writeFileSync(flagFile, String(Date.now()), 'utf8');
-        persistentAuraFlagPath = flagFile;
-        const subtitleText = " Perception Active";
-        const safeMessage = escapeXaml(message);
-        const safeSubtitle = escapeXaml(subtitleText);
-        const parentPid = process.pid;
-        const overlayPs = `
-Add-Type -AssemblyName PresentationFramework, PresentationCore, WindowsBase
-
-[xml]$xaml = @"
-<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-        Title="Scout Aura Overlay"
-        WindowStyle="None"
-        AllowsTransparency="True"
-        Background="Transparent"
-        Topmost="True"
-        ShowInTaskbar="False"
-        ShowActivated="False"
-        IsHitTestVisible="False">
-    <Window.Resources>
-        <Storyboard x:Key="AuraPulse" RepeatBehavior="Forever" AutoReverse="True">
-            <DoubleAnimation Storyboard.TargetName="AuraBorder" Storyboard.TargetProperty="Opacity"
-                             From="0.4" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="CornerTL" Storyboard.TargetProperty="Opacity"
-                             From="0.5" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="CornerTR" Storyboard.TargetProperty="Opacity"
-                             From="0.5" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="CornerBL" Storyboard.TargetProperty="Opacity"
-                             From="0.5" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="CornerBR" Storyboard.TargetProperty="Opacity"
-                             From="0.5" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="AuraGlow" Storyboard.TargetProperty="Opacity"
-                             From="0.25" To="0.9" Duration="0:0:0.6"/>
-        </Storyboard>
-    </Window.Resources>
-
-    <Grid IsHitTestVisible="False">
-        <!-- Outer Glowing Sky Blue Aura Border -->
-        <Border x:Name="AuraGlow" BorderThickness="6" BorderBrush="#00d8ff" Margin="0">
-            <Border.Effect>
-                <DropShadowEffect Color="#00e5ff" BlurRadius="45" ShadowDepth="0" Opacity="0.95"/>
-            </Border.Effect>
-        </Border>
-        <Border x:Name="AuraBorder" BorderThickness="3" BorderBrush="#38bdf8" Margin="0">
-            <Border.Effect>
-                <DropShadowEffect Color="#00e5ff" BlurRadius="25" ShadowDepth="0" Opacity="1"/>
-            </Border.Effect>
-        </Border>
-
-        <!-- Sky Blue Corner Brackets with Aura Glow -->
-        <!-- Top Left Corner -->
-        <Canvas HorizontalAlignment="Left" VerticalAlignment="Top" Width="120" Height="120" Margin="6,6,0,0">
-            <Path x:Name="CornerTL" Data="M 0,90 L 0,0 L 90,0" Stroke="#00e5ff" StrokeThickness="6">
-                <Path.Effect>
-                    <DropShadowEffect Color="#00e5ff" BlurRadius="30" ShadowDepth="0" Opacity="1"/>
-                </Path.Effect>
-            </Path>
-        </Canvas>
-
-        <!-- Top Right Corner -->
-        <Canvas HorizontalAlignment="Right" VerticalAlignment="Top" Width="120" Height="120" Margin="0,6,6,0">
-            <Path x:Name="CornerTR" Data="M 30,0 L 120,0 L 120,90" Stroke="#00e5ff" StrokeThickness="6">
-                <Path.Effect>
-                    <DropShadowEffect Color="#00e5ff" BlurRadius="30" ShadowDepth="0" Opacity="1"/>
-                </Path.Effect>
-            </Path>
-        </Canvas>
-
-        <!-- Bottom Left Corner -->
-        <Canvas HorizontalAlignment="Left" VerticalAlignment="Bottom" Width="120" Height="120" Margin="6,0,0,6">
-            <Path x:Name="CornerBL" Data="M 0,30 L 0,120 L 90,120" Stroke="#00e5ff" StrokeThickness="6">
-                <Path.Effect>
-                    <DropShadowEffect Color="#00e5ff" BlurRadius="30" ShadowDepth="0" Opacity="1"/>
-                </Path.Effect>
-            </Path>
-        </Canvas>
-
-        <!-- Bottom Right Corner -->
-        <Canvas HorizontalAlignment="Right" VerticalAlignment="Bottom" Width="120" Height="120" Margin="0,0,6,6">
-            <Path x:Name="CornerBR" Data="M 30,120 L 120,120 L 120,30" Stroke="#00e5ff" StrokeThickness="6">
-                <Path.Effect>
-                    <DropShadowEffect Color="#00e5ff" BlurRadius="30" ShadowDepth="0" Opacity="1"/>
-                </Path.Effect>
-            </Path>
-        </Canvas>
-
-        <!-- Top Floating Status Badge -->
-        <Border HorizontalAlignment="Center" VerticalAlignment="Top" Margin="0,22,0,0"
-                Background="#EE03121F" BorderBrush="#00e5ff" BorderThickness="1.8" CornerRadius="24" Padding="26,10">
-            <Border.Effect>
-                <DropShadowEffect Color="#00e5ff" BlurRadius="25" ShadowDepth="0" Opacity="0.95"/>
-            </Border.Effect>
-            <StackPanel Orientation="Horizontal" VerticalAlignment="Center">
-                <Ellipse Width="12" Height="12" Fill="#00e5ff" Margin="0,0,12,0">
-                    <Ellipse.Effect>
-                        <DropShadowEffect Color="#00e5ff" BlurRadius="12" ShadowDepth="0"/>
-                    </Ellipse.Effect>
-                </Ellipse>
-                <TextBlock Text="${safeMessage}" Foreground="#ffffff" FontSize="16" FontWeight="Bold" VerticalAlignment="Center"/>
-                <TextBlock Text="${safeSubtitle}" Foreground="#38bdf8" FontSize="13.5" FontWeight="SemiBold" Margin="10,0,0,0" VerticalAlignment="Center"/>
-            </StackPanel>
-        </Border>
-    </Grid>
-</Window>
-"@
-
-$reader = (New-Object System.Xml.XmlNodeReader $xaml)
-$window = [System.Windows.Markup.XamlReader]::Load($reader)
-
-$window.Left = [System.Windows.SystemParameters]::VirtualScreenLeft
-$window.Top = [System.Windows.SystemParameters]::VirtualScreenTop
-$window.Width = [System.Windows.SystemParameters]::VirtualScreenWidth
-$window.Height = [System.Windows.SystemParameters]::VirtualScreenHeight
-$window.Topmost = $true
-$window.ShowActivated = $false
-
-$storyboard = $window.Resources["AuraPulse"]
-$window.Add_Loaded({
-    $storyboard.Begin($window)
-})
-
-$flagPath = "${flagFile.replace(/\\/g, '\\\\')}"
-$parentPid = ${parentPid}
-
-# Check if screen sharing is active or parent exited every 350ms
-$timer = New-Object System.Windows.Threading.DispatcherTimer
-$timer.Interval = [TimeSpan]::FromMilliseconds(350)
-$timer.Add_Tick({
-    $shouldClose = $false
-    if (-not (Test-Path $flagPath)) {
-        $shouldClose = $true
-    } else {
-        $proc = Get-Process -Id $parentPid -ErrorAction SilentlyContinue
-        if (-not $proc) {
-            $shouldClose = $true
-        }
-    }
-    if ($shouldClose) {
-        $timer.Stop()
-        $window.Close()
-    }
-})
-$timer.Start()
-
-[void]$window.ShowDialog()
-`;
-        fs.writeFileSync(psFile, '\uFEFF' + overlayPs, 'utf8');
-        const child = spawn('powershell', ['-WindowStyle', 'Hidden', '-NoProfile', '-Sta', '-ExecutionPolicy', 'Bypass', '-File', psFile], {
-            detached: false,
-            stdio: 'ignore',
-        });
-        child.unref();
-        persistentAuraProcess = child;
-    }
-    catch { }
-}
-/**
- * Stop persistent screen aura animation when live screen sharing stops.
- */
-export function stopScreenAuraOverlay() {
-    if (persistentAuraFlagPath && fs.existsSync(persistentAuraFlagPath)) {
-        try {
-            fs.unlinkSync(persistentAuraFlagPath);
-        }
-        catch { }
-        persistentAuraFlagPath = null;
-    }
-    if (persistentAuraProcess) {
-        try {
-            persistentAuraProcess.kill();
-        }
-        catch { }
-        persistentAuraProcess = null;
-    }
-}
-/**
- * Display a futuristic sky-blue aura animation on screen borders and corners,
- * show the warning "Scout is on the screen.", and optionally block external inputs.
- * If durationMs <= 0, aura stays on continuously until stopScreenAuraOverlay() is called.
- */
-export async function showScreenAuraOverlay(durationMs = 2200, message = "Scout is viewing the screen.", blockInput = false) {
-    if (durationMs <= 0) {
-        return await startScreenAuraOverlay(message);
-    }
-    const platform = process.platform;
-    if (platform !== 'win32')
-        return;
-    try {
-        const scriptsDir = path.join(process.cwd(), '.ft', 'scripts');
-        if (!fs.existsSync(scriptsDir)) {
-            fs.mkdirSync(scriptsDir, { recursive: true });
-        }
-        const psFile = path.join(scriptsDir, 'scout_aura_overlay.ps1');
-        const blockInputSnippet = blockInput ? `
-$sig = '[DllImport("user32.dll")] public static extern bool BlockInput(bool fBlock);'
-$b = Add-Type -memberDefinition $sig -name 'Win32AuraBlock' -namespace Win32Functions -passThru
-try { [void]$b::BlockInput($true) } catch {}
-` : '';
-        const unblockSnippet = blockInput ? `
-    try { [void]$b::BlockInput($false) } catch {}
-` : '';
-        const subtitleText = blockInput ? " • External Input Locked" : " Perception Active";
-        const safeMessage = escapeXaml(message);
-        const safeSubtitle = escapeXaml(subtitleText);
-        const overlayPs = `
-Add-Type -AssemblyName PresentationFramework, PresentationCore, WindowsBase
-${blockInputSnippet}
-
-[xml]$xaml = @"
-<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-        Title="Scout Aura Overlay"
-        WindowStyle="None"
-        AllowsTransparency="True"
-        Background="Transparent"
-        Topmost="True"
-        ShowInTaskbar="False"
-        ShowActivated="False"
-        IsHitTestVisible="False">
-    <Window.Resources>
-        <Storyboard x:Key="AuraPulse" RepeatBehavior="Forever" AutoReverse="True">
-            <DoubleAnimation Storyboard.TargetName="AuraBorder" Storyboard.TargetProperty="Opacity"
-                             From="0.4" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="CornerTL" Storyboard.TargetProperty="Opacity"
-                             From="0.5" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="CornerTR" Storyboard.TargetProperty="Opacity"
-                             From="0.5" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="CornerBL" Storyboard.TargetProperty="Opacity"
-                             From="0.5" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="CornerBR" Storyboard.TargetProperty="Opacity"
-                             From="0.5" To="1.0" Duration="0:0:0.6"/>
-            <DoubleAnimation Storyboard.TargetName="AuraGlow" Storyboard.TargetProperty="Opacity"
-                             From="0.25" To="0.9" Duration="0:0:0.6"/>
-        </Storyboard>
-    </Window.Resources>
-
-    <Grid IsHitTestVisible="False">
-        <!-- Outer Glowing Sky Blue Aura Border -->
-        <Border x:Name="AuraGlow" BorderThickness="6" BorderBrush="#00d8ff" Margin="0">
-            <Border.Effect>
-                <DropShadowEffect Color="#00e5ff" BlurRadius="45" ShadowDepth="0" Opacity="0.95"/>
-            </Border.Effect>
-        </Border>
-        <Border x:Name="AuraBorder" BorderThickness="3" BorderBrush="#38bdf8" Margin="0">
-            <Border.Effect>
-                <DropShadowEffect Color="#00e5ff" BlurRadius="25" ShadowDepth="0" Opacity="1"/>
-            </Border.Effect>
-        </Border>
-
-        <!-- Sky Blue Corner Brackets with Aura Glow -->
-        <!-- Top Left Corner -->
-        <Canvas HorizontalAlignment="Left" VerticalAlignment="Top" Width="120" Height="120" Margin="6,6,0,0">
-            <Path x:Name="CornerTL" Data="M 0,90 L 0,0 L 90,0" Stroke="#00e5ff" StrokeThickness="6">
-                <Path.Effect>
-                    <DropShadowEffect Color="#00e5ff" BlurRadius="30" ShadowDepth="0" Opacity="1"/>
-                </Path.Effect>
-            </Path>
-        </Canvas>
-
-        <!-- Top Right Corner -->
-        <Canvas HorizontalAlignment="Right" VerticalAlignment="Top" Width="120" Height="120" Margin="0,6,6,0">
-            <Path x:Name="CornerTR" Data="M 30,0 L 120,0 L 120,90" Stroke="#00e5ff" StrokeThickness="6">
-                <Path.Effect>
-                    <DropShadowEffect Color="#00e5ff" BlurRadius="30" ShadowDepth="0" Opacity="1"/>
-                </Path.Effect>
-            </Path>
-        </Canvas>
-
-        <!-- Bottom Left Corner -->
-        <Canvas HorizontalAlignment="Left" VerticalAlignment="Bottom" Width="120" Height="120" Margin="6,0,0,6">
-            <Path x:Name="CornerBL" Data="M 0,30 L 0,120 L 90,120" Stroke="#00e5ff" StrokeThickness="6">
-                <Path.Effect>
-                    <DropShadowEffect Color="#00e5ff" BlurRadius="30" ShadowDepth="0" Opacity="1"/>
-                </Path.Effect>
-            </Path>
-        </Canvas>
-
-        <!-- Bottom Right Corner -->
-        <Canvas HorizontalAlignment="Right" VerticalAlignment="Bottom" Width="120" Height="120" Margin="0,0,6,6">
-            <Path x:Name="CornerBR" Data="M 30,120 L 120,120 L 120,30" Stroke="#00e5ff" StrokeThickness="6">
-                <Path.Effect>
-                    <DropShadowEffect Color="#00e5ff" BlurRadius="30" ShadowDepth="0" Opacity="1"/>
-                </Path.Effect>
-            </Path>
-        </Canvas>
-
-        <!-- Top Floating Status Badge -->
-        <Border HorizontalAlignment="Center" VerticalAlignment="Top" Margin="0,22,0,0"
-                Background="#EE03121F" BorderBrush="#00e5ff" BorderThickness="1.8" CornerRadius="24" Padding="26,10">
-            <Border.Effect>
-                <DropShadowEffect Color="#00e5ff" BlurRadius="25" ShadowDepth="0" Opacity="0.95"/>
-            </Border.Effect>
-            <StackPanel Orientation="Horizontal" VerticalAlignment="Center">
-                <Ellipse Width="12" Height="12" Fill="#00e5ff" Margin="0,0,12,0">
-                    <Ellipse.Effect>
-                        <DropShadowEffect Color="#00e5ff" BlurRadius="12" ShadowDepth="0"/>
-                    </Ellipse.Effect>
-                </Ellipse>
-                <TextBlock Text="${safeMessage}" Foreground="#ffffff" FontSize="16" FontWeight="Bold" VerticalAlignment="Center"/>
-                <TextBlock Text="${safeSubtitle}" Foreground="#38bdf8" FontSize="13.5" FontWeight="SemiBold" Margin="10,0,0,0" VerticalAlignment="Center"/>
-            </StackPanel>
-        </Border>
-    </Grid>
-</Window>
-"@
-
-$reader = (New-Object System.Xml.XmlNodeReader $xaml)
-$window = [System.Windows.Markup.XamlReader]::Load($reader)
-
-$window.Left = [System.Windows.SystemParameters]::VirtualScreenLeft
-$window.Top = [System.Windows.SystemParameters]::VirtualScreenTop
-$window.Width = [System.Windows.SystemParameters]::VirtualScreenWidth
-$window.Height = [System.Windows.SystemParameters]::VirtualScreenHeight
-$window.Topmost = $true
-$window.ShowActivated = $false
-
-$storyboard = $window.Resources["AuraPulse"]
-$window.Add_Loaded({
-    $storyboard.Begin($window)
-})
-
-# Safety timer to close overlay and guarantee unblock
-$timer = New-Object System.Windows.Threading.DispatcherTimer
-$timer.Interval = [TimeSpan]::FromMilliseconds(${durationMs})
-$timer.Add_Tick({
-    $timer.Stop()
-    ${unblockSnippet}
-    $window.Close()
-})
-$timer.Start()
-
-[void]$window.ShowDialog()
-${unblockSnippet}
-`;
-        fs.writeFileSync(psFile, '\uFEFF' + overlayPs, 'utf8');
-        await execAsync(`powershell -WindowStyle Hidden -NoProfile -Sta -ExecutionPolicy Bypass -File "${psFile}"`, { timeout: durationMs + 3000 });
-    }
-    catch {
-        if (blockInput) {
-            try {
-                await execAsync(`powershell -NoProfile -Command "$sig='[DllImport(\\"user32.dll\\")] public static extern bool BlockInput(bool f);';$b=Add-Type -m $sig -n B -p;[void]$b::BlockInput($false)"`);
-            }
-            catch { }
-        }
-    }
-}
-const capturedScreenshots = new Set();
-/**
- * Register a captured screenshot file path for automatic post-task cleanup.
- */
-export function registerCapturedScreenshot(filePath) {
-    if (filePath) {
-        capturedScreenshots.add(path.resolve(filePath));
-    }
-}
-/**
- * Clean up all captured screenshots permanently from disk after task completion.
- */
-export function cleanupScreenshots() {
-    let deletedCount = 0;
-    // 1. Delete all tracked screenshots
-    for (const filePath of capturedScreenshots) {
-        try {
-            if (fs.existsSync(filePath)) {
-                fs.unlinkSync(filePath);
-                deletedCount++;
-            }
-        }
-        catch { }
-    }
-    capturedScreenshots.clear();
-    // 2. Clean any remaining files in .ft/screenshots
-    try {
-        const screenshotsDir = path.join(process.cwd(), '.ft', 'screenshots');
-        if (fs.existsSync(screenshotsDir)) {
-            const files = fs.readdirSync(screenshotsDir);
-            for (const file of files) {
-                if (file.startsWith('screen_') && (file.endsWith('.png') || file.endsWith('.jpg'))) {
-                    try {
-                        fs.unlinkSync(path.join(screenshotsDir, file));
-                        deletedCount++;
-                    }
-                    catch { }
-                }
-            }
-        }
-    }
-    catch { }
-    return { success: true, deletedCount };
-}
-/**
- * Capture full desktop screen or specified window screenshot without running shell commands.
- * Screenshots are tracked and will be deleted automatically upon task completion.
- */
-export async function captureScreen(appNameOrScreen) {
-    const platform = process.platform;
-    const screenshotsDir = path.join(process.cwd(), '.ft', 'screenshots');
-    try {
-        if (!fs.existsSync(screenshotsDir)) {
-            fs.mkdirSync(screenshotsDir, { recursive: true });
-        }
-    }
-    catch { }
-    const filename = `screen_${Date.now()}.png`;
-    const outPath = path.join(screenshotsDir, filename);
-    if (platform === 'win32') {
-        try {
-            const scriptPath = ensureWinCaptureScript();
-            const { stdout } = await execAsync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${scriptPath}" -OutPath "${outPath}"`);
-            const meta = JSON.parse(stdout.trim());
-            if (meta.success && fs.existsSync(outPath) && fs.statSync(outPath).size > 0) {
-                registerCapturedScreenshot(outPath);
-                showScreenAuraOverlay(1800, "Scout is viewing the screen...", false).catch(() => { });
-                const visibleList = Array.isArray(meta.visibleWindows) && meta.visibleWindows.length > 0
-                    ? `\n- Visible Windows: ${meta.visibleWindows.slice(0, 6).map((w) => `"${w}"`).join(', ')}`
-                    : '';
-                return {
-                    success: true,
-                    output: `Screen Captured Successfully!\n- Screenshot Saved To: ${outPath}\n- Resolution: ${meta.width}x${meta.height}\n- Active Window: "${meta.activeWindow || 'Desktop'}"${visibleList}\n- Seeing Status: Screen is visible and captured. (NOTE: This temporary screenshot will be automatically deleted upon task completion).`,
-                    details: { ...meta, outPath },
-                };
-            }
-            throw new Error(meta.error || 'Desktop capture returned false');
-        }
-        catch (err) {
-            // Fallback to Graphics.CopyFromScreen
-            const psScript = `
-Add-Type -AssemblyName System.Windows.Forms
-Add-Type -AssemblyName System.Drawing
-$screen = [System.Windows.Forms.Screen]::PrimaryScreen
-$bounds = $screen.Bounds
-$bmp = New-Object System.Drawing.Bitmap($bounds.Width, $bounds.Height)
-$graphics = [System.Drawing.Graphics]::FromImage($bmp)
-try { $graphics.CopyFromScreen($bounds.Location, [System.Drawing.Point]::Empty, $bounds.Size) } catch {}
-$bmp.Save("${outPath.replace(/\\/g, '\\\\')}", [System.Drawing.Imaging.ImageFormat]::Png)
-$graphics.Dispose()
-$bmp.Dispose()
-@{ savedPath = "${outPath.replace(/\\/g, '\\\\')}"; width = $bounds.Width; height = $bounds.Height; activeWindow = "${appNameOrScreen || 'Desktop'}" } | ConvertTo-Json
-`;
-            try {
-                const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-                const { stdout } = await execAsync(`powershell -NoProfile -EncodedCommand ${encodedScript}`);
-                const meta = JSON.parse(stdout.trim());
-                registerCapturedScreenshot(outPath);
-                return {
-                    success: true,
-                    output: `Screen Captured Successfully!\n- Screenshot Saved To: ${outPath}\n- Resolution: ${meta.width}x${meta.height}\n- Active Window: "${meta.activeWindow || 'Desktop'}"\n- Seeing Status: Screen is visible and captured.`,
-                    details: { ...meta, outPath },
-                };
-            }
-            catch (fallbackErr) {
-                return {
-                    success: false,
-                    output: `Failed to capture screen: ${err?.message || fallbackErr?.message || String(err)}`,
-                };
-            }
-        }
-    }
-    else if (platform === 'darwin') {
-        try {
-            await execAsync(`screencapture -x "${outPath}"`);
-            registerCapturedScreenshot(outPath);
-            return {
-                success: true,
-                output: `macOS Screen Captured Successfully! Saved To: ${outPath}\n(NOTE: This temporary screenshot will be automatically deleted upon task completion).`,
-                details: { outPath, platform: 'darwin' },
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `Failed macOS screen capture: ${err?.message || String(err)}`,
-            };
-        }
-    }
-    else {
-        try {
-            await execAsync(`import -window root "${outPath}" || scrot "${outPath}"`);
-            registerCapturedScreenshot(outPath);
-            return {
-                success: true,
-                output: `Linux Screen Captured Successfully! Saved To: ${outPath}\n(NOTE: This temporary screenshot will be automatically deleted upon task completion).`,
-                details: { outPath, platform: 'linux' },
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `Failed Linux screen capture: ${err?.message || String(err)}`,
-            };
-        }
-    }
-}
-/**
- * Call Vision AI with graceful multi-provider fallback.
- * Tries NVIDIA Vision (meta/llama-3.2-11b-vision-instruct), Gemini (gemini-2.0-flash), OpenAI (gpt-4o-mini), and BYOK.
- */
-export async function callVisionAi(outPath, prompt, maxTokens = 350) {
-    if (!outPath || !fs.existsSync(outPath))
-        return null;
-    let imageBase64;
-    try {
-        imageBase64 = fs.readFileSync(outPath).toString('base64');
-    }
-    catch {
-        return null;
-    }
-    const nvidiaKey = process.env.NVIDIA_API_KEY || process.env.NVCF_API_KEY;
-    const geminiKey = process.env.GEMINI_API_KEY;
-    const openaiKey = process.env.OPENAI_API_KEY;
-    const byokKey = process.env.BYOK_API_KEY;
-    const candidates = [];
-    if (nvidiaKey) {
-        candidates.push({ apiKey: nvidiaKey, baseURL: 'https://integrate.api.nvidia.com/v1', model: 'meta/llama-3.2-11b-vision-instruct', timeout: 35000 });
-    }
-    if (geminiKey) {
-        candidates.push({ apiKey: geminiKey, baseURL: 'https://generativelanguage.googleapis.com/v1beta/openai', model: 'gemini-2.0-flash', timeout: 20000 });
-    }
-    if (openaiKey) {
-        candidates.push({ apiKey: openaiKey, model: 'gpt-4o-mini', timeout: 20000 });
-    }
-    if (byokKey) {
-        candidates.push({ apiKey: byokKey, model: 'gpt-4o-mini', timeout: 20000 });
-    }
-    for (const cand of candidates) {
-        try {
-            const client = new OpenAI({ apiKey: cand.apiKey, baseURL: cand.baseURL, timeout: cand.timeout });
-            const resp = await client.chat.completions.create({
-                model: cand.model,
-                messages: [
-                    {
-                        role: 'user',
-                        content: [
-                            { type: 'text', text: prompt },
-                            { type: 'image_url', image_url: { url: `data:image/png;base64,${imageBase64}` } },
-                        ],
-                    },
-                ],
-                max_tokens: maxTokens,
-            });
-            const reply = resp.choices[0]?.message?.content?.trim();
-            if (reply) {
-                return reply;
-            }
-        }
-        catch {
-            continue;
-        }
-    }
-    return null;
-}
-/**
- * Visual screen analysis. Takes a full-screen screenshot and provides visual context
- * (including AI Vision inspection if an API key is available).
- * All temporary screenshots are automatically deleted upon task completion.
- */
-export async function analyzeScreen(appNameOrScreen, targetQuery) {
-    const capture = await captureScreen(appNameOrScreen);
-    const info = await getScreenInfo(appNameOrScreen);
-    let visualAiAnalysis = '';
-    const outPath = capture.details?.outPath;
-    // Optional Vision Model Analysis if screenshot exists and has valid content
-    if (capture.success && outPath && fs.existsSync(outPath)) {
-        try {
-            if (fs.statSync(outPath).size > 0) {
-                const prompt = targetQuery
-                    ? `Describe what is visible on this screen specifically regarding: "${targetQuery}". Keep it concise, noting visible UI elements, open windows, tabs, buttons, or error messages.`
-                    : `Briefly describe what is currently visible on this desktop screen: active window, main content/tabs, buttons, and system state in 2-3 sentences.`;
-                const reply = await callVisionAi(outPath, prompt, 350);
-                if (reply && reply.trim()) {
-                    visualAiAnalysis = `\nAI Visual Screen Analysis:\n${reply.trim()}`;
-                }
-            }
-        }
-        catch {
-            // Vision API call is optional; fallback gracefully to system metadata
-        }
-    }
-    const activeWin = capture.details?.activeWindow || info.details?.activeWindow || appNameOrScreen || 'Active Desktop';
-    const visWins = Array.isArray(capture.details?.visibleWindows) && capture.details.visibleWindows.length > 0
-        ? capture.details.visibleWindows
-        : (Array.isArray(info.details?.visibleWindows) ? info.details.visibleWindows : []);
-    const visibleWindowsText = visWins.length > 0
-        ? `\nVisible Open Windows:\n${visWins.slice(0, 8).map((w) => `  - "${w}"`).join('\n')}`
-        : '';
-    const report = [
-        `=== SCOUT SCRATCHPAD DESKTOP SCREEN VISUAL INSPECTION ===`,
-        `Target App / Screen Context: "${appNameOrScreen || 'Desktop'}"`,
-        `Screen Resolution: ${info.details?.screenWidth || capture.details?.width || 1920}x${info.details?.screenHeight || capture.details?.height || 1080}`,
-        `Active Window Focus: "${activeWin}"${visibleWindowsText}`,
-        `Mouse Cursor Position: (${info.details?.cursorX || capture.details?.cursorX || 0}, ${info.details?.cursorY || capture.details?.cursorY || 0})`,
-        `Screenshot Status: Captured temporarily for visual inspection. (Will be automatically deleted upon task completion)`,
-        `Visual Status: Screen is visible and verified.${visualAiAnalysis}`,
-    ].join('\n');
-    return {
-        success: capture.success,
-        app: appNameOrScreen || 'desktop',
-        action: 'analyze_screen',
-        output: report,
-        details: { capture: capture.details, info: info.details },
-    };
-}
-/**
- * Full Mouse Cursor & Keyboard Takeover on specified screen or window.
- */
-export async function takeoverControl(appName, durationMs = 3000, x, y) {
-    const { category, name } = normalizeAppName(appName);
-    const targetApp = (name && name !== 'desktop' && name !== 'system') ? name : undefined;
-    if (targetApp) {
-        setLiveScreenTargetApp(targetApp);
-    }
-    if (name && name !== 'desktop' && name !== 'system' && category !== 'browser') {
-        await openApp(name);
-    }
-    // Trigger visual sky-blue aura overlay on screen borders & corners with warning badge & input block
-    try {
-        const auraLabel = targetApp ? `Scout is controlling ${targetApp}...` : "Scout is on the screen.";
-        await showScreenAuraOverlay(Math.min(5000, Math.max(800, durationMs)), auraLabel, true);
-        startLiveScreenShare({ targetApp }).catch(() => { });
-    }
-    catch { }
-    const mouseRes = await moveAndClickMouse(x, y, 'left', name || appName);
-    const lockRes = await lockAppInput(name || appName, durationMs);
-    return {
-        success: lockRes.success && mouseRes.success,
-        output: `TAKEOVER EXECUTED: Scout Agent has taken over mouse cursor, window focus, and keyboard control on specified screen window ("${name || appName}"). Sky-blue aura HUD activated and user interruption locked for ${durationMs}ms. ${mouseRes.output} Agent can view, analyze, type, and click without shell commands.`,
-        details: { appName: name || appName, durationMs, x, y, mouseOutput: mouseRes.output },
-    };
-}
-/**
- * Release user input lock / takeover.
- */
-export async function releaseTakeover() {
-    const platform = process.platform;
-    if (platform === 'win32') {
-        const psScript = `
-$sig = '[DllImport("user32.dll")] public static extern bool BlockInput(bool fBlock);'
-$b = Add-Type -memberDefinition $sig -name 'Win32Block' -namespace Win32Functions -passThru
-try { [void]$b::BlockInput($false) } catch {}
-`;
-        try {
-            const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-            await execAsync(`powershell -NoProfile -Sta -EncodedCommand ${encodedScript}`);
-        }
-        catch { }
-    }
-    return {
-        success: true,
-        output: 'Released mouse cursor and keyboard takeover. Control returned to user.',
-    };
-}
-/**
- * Focus application window and simulate typing text + pressing keys (Enter/Tab) or hotkey combinations.
- */
-export async function sendKeystrokes(appName, textToType, pressEnter = true, keyCombo) {
-    const platform = process.platform;
-    const targetText = textToType || '';
-    const combo = (keyCombo || '').trim().toLowerCase();
-    if (platform === 'win32') {
-        const sanitized = targetText.replace(/"/g, '""').replace(/[\r\n]+/g, ' ');
-        const sendKeysText = sanitized.replace(/[{}+^~%()\[\]]/g, '{$&}');
-        let sendKeysCombo = '';
-        if (combo) {
-            const cLower = combo.toLowerCase().replace(/\s+/g, '');
-            if (cLower.includes('ctrl+enter') || cLower.includes('ctrl+return'))
-                sendKeysCombo = '^{ENTER}';
-            else if (cLower.includes('alt+enter') || cLower.includes('alt+return'))
-                sendKeysCombo = '%{ENTER}';
-            else if (cLower.includes('shift+enter') || cLower.includes('shift+return'))
-                sendKeysCombo = '+{ENTER}';
-            else if (cLower.includes('ctrl+a') || cLower === 'select_all')
-                sendKeysCombo = '^a';
-            else if (cLower.includes('ctrl+c') || cLower === 'copy')
-                sendKeysCombo = '^c';
-            else if (cLower.includes('ctrl+v') || cLower === 'paste')
-                sendKeysCombo = '^v';
-            else if (cLower.includes('ctrl+x') || cLower === 'cut')
-                sendKeysCombo = '^x';
-            else if (cLower.includes('ctrl+z') || cLower === 'undo')
-                sendKeysCombo = '^z';
-            else if (cLower.includes('ctrl+s') || cLower === 'save')
-                sendKeysCombo = '^s';
-            else if (cLower.includes('ctrl+l') || cLower === 'address_bar')
-                sendKeysCombo = '^l';
-            else if (cLower.includes('ctrl+t') || cLower === 'new_tab')
-                sendKeysCombo = '^t';
-            else if (cLower.includes('ctrl+w') || cLower === 'close_tab')
-                sendKeysCombo = '^w';
-            else if (cLower.includes('ctrl+r') || cLower === 'reload')
-                sendKeysCombo = '^r';
-            else if (cLower.includes('ctrl+f') || cLower === 'find')
-                sendKeysCombo = '^f';
-            else if (cLower.includes('ctrl+n') || cLower === 'new_window')
-                sendKeysCombo = '^n';
-            else if (cLower.includes('ctrl+shift+i') || cLower.includes('devtools'))
-                sendKeysCombo = '^+i';
-            else if (cLower.includes('alt+d'))
-                sendKeysCombo = '%d';
-            else if (cLower.includes('alt+tab'))
-                sendKeysCombo = '%{TAB}';
-            else if (cLower.includes('alt+f4'))
-                sendKeysCombo = '%{F4}';
-            else if (cLower === 'enter' || cLower === 'return')
-                sendKeysCombo = '{ENTER}';
-            else if (cLower === 'esc' || cLower === 'escape')
-                sendKeysCombo = '{ESC}';
-            else if (cLower === 'tab')
-                sendKeysCombo = '{TAB}';
-            else if (cLower === 'backspace')
-                sendKeysCombo = '{BACKSPACE}';
-            else if (cLower === 'space')
-                sendKeysCombo = ' ';
-            else if (cLower === 'up')
-                sendKeysCombo = '{UP}';
-            else if (cLower === 'down')
-                sendKeysCombo = '{DOWN}';
-            else if (cLower === 'left')
-                sendKeysCombo = '{LEFT}';
-            else if (cLower === 'right')
-                sendKeysCombo = '{RIGHT}';
-            else
-                sendKeysCombo = combo;
-        }
-        const psScript = `
-$sig = @'
-[DllImport("user32.dll")] public static extern bool BlockInput(bool fBlock);
-[DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd);
-[DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
-[DllImport("user32.dll")] public static extern void keybd_event(byte bVk, byte bScan, uint dwFlags, UIntPtr dwExtraInfo);
-'@
-$b = Add-Type -memberDefinition $sig -name ('Win32Block_' + (Get-Random)) -namespace Win32Functions -passThru
-
-try { [void]$b::BlockInput($true) } catch {}
-
-Add-Type -AssemblyName System.Windows.Forms
-$ws = New-Object -ComObject WScript.Shell
-
-try {
-    $proc = Get-Process -Name chrome, msedge, firefox, brave, opera, "${appName}" -ErrorAction SilentlyContinue | Where-Object { $_.MainWindowHandle -ne 0 } | Select-Object -First 1
-    if ($proc) {
-        $b::keybd_event(0x12, 0, 0, [UIntPtr]::Zero)
-        $b::keybd_event(0x12, 0, 2, [UIntPtr]::Zero)
-        [void]$b::ShowWindow($proc.MainWindowHandle, 9)
-        [void]$b::SetForegroundWindow($proc.MainWindowHandle)
-        Start-Sleep -Milliseconds 250
-    } else {
-        $activated = $ws.AppActivate("${appName}")
-        if (-not $activated) { $activated = $ws.AppActivate("Chrome") }
-        if (-not $activated) { $activated = $ws.AppActivate("Edge") }
-        if (-not $activated) { $activated = $ws.AppActivate("Firefox") }
-        if (-not $activated) { $activated = $ws.AppActivate("Brave") }
-        if (-not $activated) { $activated = $ws.AppActivate("Notepad") }
-        if (-not $activated) { $activated = $ws.AppActivate("Visual Studio Code") }
-        Start-Sleep -Milliseconds 300
-    }
-} catch {}
-
-Start-Sleep -Milliseconds 250
-
-${sendKeysCombo ? `$ws.SendKeys("${sendKeysCombo}")` : ''}
-
-${sanitized ? `
-$copied = $false
-try {
-    Set-Clipboard -Value "${sanitized}"
-    $copied = $true
-} catch {
-    try {
-        [System.Windows.Forms.Clipboard]::SetText("${sanitized}")
-        $copied = $true
-    } catch {}
-}
-if ($copied) {
-    $ws.SendKeys("^v")
-} else {
-    $ws.SendKeys("${sendKeysText}")
-}
-` : ''}
-
-if (${pressEnter ? '$true' : '$false'}) {
-    Start-Sleep -Milliseconds 200
-    $ws.SendKeys("~")
-}
-
-try { [void]$b::BlockInput($false) } catch {}
-`;
-        try {
-            const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-            await execAsync(`powershell -NoProfile -Sta -EncodedCommand ${encodedScript}`);
-            return {
-                success: true,
-                output: `Successfully focused "${appName}" window and sent keyboard takeover inputs ("${targetText}"${combo ? ` [Hotkey: ${combo}]` : ''}${pressEnter ? ' + [ENTER]' : ''}).`
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `Failed to send keystrokes to "${appName}": ${err?.message || String(err)}`
-            };
-        }
-    }
-    else if (platform === 'darwin') {
-        const escaped = targetText.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-        const script = `
-tell application "System Events"
-    ${escaped ? `keystroke "${escaped}"` : ''}
-    ${pressEnter ? 'key code 36' : ''}
-end tell
-`;
-        try {
-            await execAsync(`osascript -e '${script.replace(/'/g, "'\\''")}'`);
-            return {
-                success: true,
-                output: `Sent macOS keyboard takeover keystrokes ("${targetText}").`
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `Failed macOS osascript keystrokes: ${err?.message || String(err)}`
-            };
-        }
-    }
-    else {
-        try {
-            const escaped = targetText.replace(/"/g, '\\"');
-            await execAsync(`xdotool type "${escaped}" ${pressEnter ? '&& xdotool key Return' : ''}`);
-            return {
-                success: true,
-                output: `Sent Linux keyboard takeover keystrokes ("${targetText}").`
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `xdotool keystroke error: ${err?.message || String(err)}`
-            };
-        }
-    }
-}
-/**
- * Move cursor and perform OS mouse click at target coordinates or active window center.
- */
-export async function moveAndClickMouse(x, y, button = 'left', appName) {
-    const platform = process.platform;
-    if (platform === 'win32') {
-        const psScript = `
-Add-Type -AssemblyName System.Drawing
-Add-Type -AssemblyName System.Windows.Forms
-$sig = '[DllImport("user32.dll")] public static extern void mouse_event(int dwFlags, int dx, int dy, int cButtons, int dwExtraInfo); [DllImport("user32.dll")] public static extern bool SetCursorPos(int X, int Y);'
-$m = Add-Type -memberDefinition $sig -name 'Win32Mouse' -namespace Win32Functions -passThru
-
-${(appName && appName !== 'desktop' && appName !== 'system') ? `
-try {
-    $proc = Get-Process -Name chrome, msedge, firefox, brave, "${appName}" -ErrorAction SilentlyContinue | Where-Object { $_.MainWindowHandle -ne 0 } | Select-Object -First 1
-    if ($proc) {
-        $sigFw = '[DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd);'
-        $fw = Add-Type -memberDefinition $sigFw -name 'Win32FwMouse' -namespace Win32Functions -passThru
-        [void]$fw::SetForegroundWindow($proc.MainWindowHandle)
-        Start-Sleep -Milliseconds 250
-    } else {
-        $ws = New-Object -ComObject WScript.Shell
-        [void]$ws.AppActivate("${appName}")
-        Start-Sleep -Milliseconds 200
-    }
-} catch {}
-` : ''}
-
-$screen = [System.Windows.Forms.Screen]::PrimaryScreen
-$targetX = ${x !== undefined ? Math.round(x) : '[int]($screen.Bounds.Width / 2)'}
-$targetY = ${y !== undefined ? Math.round(y) : '[int]($screen.Bounds.Height / 2)'}
-
-[void]$m::SetCursorPos($targetX, $targetY)
-try { [System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point($targetX, $targetY) } catch {}
-Start-Sleep -Milliseconds 200
-
-# MOUSEEVENTF_LEFTDOWN = 0x0002, MOUSEEVENTF_LEFTUP = 0x0004
-# MOUSEEVENTF_RIGHTDOWN = 0x0008, MOUSEEVENTF_RIGHTUP = 0x0010
-# MOUSEEVENTF_MIDDLEDOWN = 0x0020, MOUSEEVENTF_MIDDLEUP = 0x0040
-# MOUSEEVENTF_WHEEL = 0x0800
-${button === 'right' ? '$m::mouse_event(0x0008, 0, 0, 0, 0); $m::mouse_event(0x0010, 0, 0, 0, 0);' :
-            button === 'middle' ? '$m::mouse_event(0x0020, 0, 0, 0, 0); $m::mouse_event(0x0040, 0, 0, 0, 0);' :
-                button === 'scroll' ? '$m::mouse_event(0x0800, 0, 0, -120, 0);' :
-                    '$m::mouse_event(0x0002, 0, 0, 0, 0); $m::mouse_event(0x0004, 0, 0, 0, 0);'}
-${button === 'double' ? 'Start-Sleep -Milliseconds 100; $m::mouse_event(0x0002, 0, 0, 0, 0); $m::mouse_event(0x0004, 0, 0, 0, 0);' : ''}
-`;
-        try {
-            const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-            await execAsync(`powershell -NoProfile -Sta -EncodedCommand ${encodedScript}`);
-            return {
-                success: true,
-                output: `Executed mouse cursor takeover ${button} click at screen coordinates (${x !== undefined ? x : 'screen center'}, ${y !== undefined ? y : 'screen center'}).`
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `Failed mouse takeover action: ${err?.message || String(err)}`
-            };
-        }
-    }
-    else if (platform === 'darwin') {
-        const script = `
-tell application "System Events"
-    ${(x !== undefined && y !== undefined) ? `click at {${x}, ${y}}` : 'click'}
-end tell
-`;
-        try {
-            await execAsync(`osascript -e '${script.replace(/'/g, "'\\''")}'`);
-            return {
-                success: true,
-                output: `Executed macOS mouse cursor click.`
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `Failed macOS mouse click: ${err?.message || String(err)}`
-            };
-        }
-    }
-    else {
-        try {
-            const cmd = (x !== undefined && y !== undefined)
-                ? `xdotool mousemove ${x} ${y} click ${button === 'right' ? '3' : '1'}`
-                : `xdotool click ${button === 'right' ? '3' : '1'}`;
-            await execAsync(cmd);
-            return {
-                success: true,
-                output: `Executed Linux mouse click.`
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `xdotool click error: ${err?.message || String(err)}`
-            };
-        }
-    }
-}
-/**
- * Prevent user interruption on targeted application window during scratchpad execution.
- * Focuses window and temporarily locks input / enforces frontmost focus while Scout is working.
- */
-export async function lockAppInput(appName, durationMs = 2000) {
-    const platform = process.platform;
-    if (platform === 'win32') {
-        const psScript = `
-$sig = '[DllImport("user32.dll")] public static extern bool BlockInput(bool fBlock);'
-$b = Add-Type -memberDefinition $sig -name 'Win32Block' -namespace Win32Functions -passThru
-
-$ws = New-Object -ComObject WScript.Shell
-$activated = $ws.AppActivate("${appName}")
-if (-not $activated) { $activated = $ws.AppActivate("Chrome") }
-if (-not $activated) { $activated = $ws.AppActivate("Edge") }
-if (-not $activated) { $activated = $ws.AppActivate("Firefox") }
-if (-not $activated) { $activated = $ws.AppActivate("Brave") }
-
-try { [void]$b::BlockInput($true) } catch {}
-Start-Sleep -Milliseconds ${Math.min(10000, Math.max(500, durationMs))}
-try { [void]$b::BlockInput($false) } catch {}
-`;
-        try {
-            const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-            await execAsync(`powershell -NoProfile -Sta -EncodedCommand ${encodedScript}`);
-            return {
-                success: true,
-                output: `Locked user interruption on "${appName}" window for ${durationMs}ms while Scout Scratchpad was working.`
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `Focus lock applied for "${appName}".`
-            };
-        }
-    }
-    else if (platform === 'darwin') {
-        const script = `
-tell application "System Events"
-    tell application "${appName}" to activate
-end tell
-`;
-        try {
-            await execAsync(`osascript -e '${script.replace(/'/g, "'\\''")}'`);
-            return {
-                success: true,
-                output: `Enforced frontmost focus on "${appName}" to prevent user interruption on macOS.`
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: `macOS focus enforcement notice: ${err?.message || String(err)}`
-            };
-        }
-    }
-    else {
-        return {
-            success: true,
-            output: `Enforced scratchpad focus lock on Linux for "${appName}".`
-        };
-    }
-}
-/**
- * List all active top-level application windows.
- */
-export async function listWindows() {
-    const platform = process.platform;
-    if (platform === 'win32') {
-        const psScript = `
-Get-Process | Where-Object { $_.MainWindowTitle -ne '' } | Select-Object Id, ProcessName, MainWindowTitle, MainWindowHandle | ConvertTo-Json
-`;
-        try {
-            const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-            const { stdout } = await execAsync(`powershell -NoProfile -Sta -EncodedCommand ${encodedScript}`);
-            let rawList = [];
-            try {
-                rawList = JSON.parse(stdout.trim());
-            }
-            catch { }
-            if (!Array.isArray(rawList))
-                rawList = rawList ? [rawList] : [];
-            const windows = rawList.map((w) => ({
-                title: String(w.MainWindowTitle || ''),
-                processName: String(w.ProcessName || ''),
-                handle: String(w.MainWindowHandle || ''),
-            }));
-            const formatted = windows.map((w, idx) => ` ${idx + 1}. [${w.processName}] "${w.title}"`).join('\n');
-            return {
-                success: true,
-                output: `Active Application Windows (${windows.length}):\n${formatted || 'No active top-level windows with title found.'}`,
-                windows,
-            };
-        }
-        catch (err) {
-            return { success: false, output: `Failed to list windows: ${err?.message || String(err)}`, windows: [] };
-        }
-    }
-    return { success: true, output: 'Window listing only supported on Windows.', windows: [] };
-}
-/**
- * Bring a target window to front and focus it.
- */
-export async function focusWindow(appNameOrTitle) {
-    const platform = process.platform;
-    if (platform === 'win32') {
-        const psScript = `
-$target = "${appNameOrTitle.replace(/"/g, '`"')}"
-$proc = Get-Process | Where-Object { ($_.MainWindowTitle -like "*$target*" -or $_.ProcessName -like "*$target*") -and $_.MainWindowHandle -ne 0 } | Select-Object -First 1
-if ($proc) {
-    $sig = '[DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd); [DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);'
-    $w = Add-Type -memberDefinition $sig -name 'Win32Fw' -namespace Win32Functions -passThru
-    [void]$w::ShowWindow($proc.MainWindowHandle, 9)
-    [void]$w::SetForegroundWindow($proc.MainWindowHandle)
-    Write-Output "Focused '$($proc.MainWindowTitle)' ($($proc.ProcessName))"
-} else {
-    $ws = New-Object -ComObject WScript.Shell
-    $activated = $ws.AppActivate($target)
-    if ($activated) { Write-Output "Activated '$target' via WScript.Shell" } else { Write-Output "Window '$target' not found" }
-}
-`;
-        try {
-            const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-            const { stdout } = await execAsync(`powershell -NoProfile -Sta -EncodedCommand ${encodedScript}`);
-            return { success: true, output: stdout.trim() || `Focus request completed for "${appNameOrTitle}".` };
-        }
-        catch (err) {
-            return { success: false, output: `Could not focus window: ${err?.message || String(err)}` };
-        }
-    }
-    return { success: true, output: `Focus request sent for "${appNameOrTitle}".` };
-}
-/**
- * Scroll mouse wheel up or down by specified notch amount.
- */
-export async function scrollWindow(direction = 'down', amount = 3) {
-    const platform = process.platform;
-    if (platform === 'win32') {
-        const clicks = Math.max(1, Math.min(20, amount));
-        const delta = direction === 'up' ? 120 * clicks : -120 * clicks;
-        const psScript = `
-Add-Type -AssemblyName System.Windows.Forms
-$sig = '[DllImport("user32.dll")] public static extern void mouse_event(int dwFlags, int dx, int dy, int cButtons, int dwExtraInfo);'
-$m = Add-Type -memberDefinition $sig -name 'Win32Scroll' -namespace Win32Functions -passThru
-$m::mouse_event(0x0800, 0, 0, ${delta}, 0)
-`;
-        try {
-            const encodedScript = Buffer.from(psScript, 'utf16le').toString('base64');
-            await execAsync(`powershell -NoProfile -EncodedCommand ${encodedScript}`);
-            return { success: true, output: `Scrolled mouse wheel ${direction} by ${clicks} notch(es).` };
-        }
-        catch (err) {
-            return { success: false, output: `Failed to scroll: ${err?.message || String(err)}` };
-        }
-    }
-    return { success: true, output: `Scrolled ${direction}` };
-}
-/**
- * Visually ground and click a target UI element by name or visual description.
- */
-export async function findAndClickElement(elementQuery, appName, button = 'left') {
-    let screenWidth = 1920;
-    let screenHeight = 1080;
-    let targetX = undefined;
-    let targetY = undefined;
-    // Use in-memory live screen frame first without writing screenshot files to disk
-    const liveFrame = await getLiveScreenFrame();
-    if (liveFrame) {
-        screenWidth = liveFrame.width;
-        screenHeight = liveFrame.height;
-        try {
-            const prompt = `Look at this screen and locate the UI element: "${elementQuery}".
-Return ONLY a valid JSON object with the center point of this element in 0-1000 normalized coordinates:
-{"point": [y, x]}
-Where y is between 0 and 1000 (top to bottom) and x is between 0 and 1000 (left to right).
-If not found, return {"point": null}. Output nothing else.`;
-            const reply = await callVisionAiWithFrame(liveFrame, prompt, 80);
-            if (reply) {
-                const match = reply.match(/\{[\s\S]*"point"[\s\S]*\}/);
-                if (match) {
-                    const parsed = JSON.parse(match[0]);
-                    if (Array.isArray(parsed.point) && parsed.point.length === 2) {
-                        const normY = Number(parsed.point[0]);
-                        const normX = Number(parsed.point[1]);
-                        if (!isNaN(normX) && !isNaN(normY)) {
-                            targetX = Math.round((normX / 1000) * screenWidth);
-                            targetY = Math.round((normY / 1000) * screenHeight);
-                        }
-                    }
-                }
-            }
-        }
-        catch { }
-    }
-    else {
-        const capture = await captureScreen(appName);
-        if (capture.success && capture.details?.outPath && fs.existsSync(capture.details.outPath)) {
-            screenWidth = capture.details.width || 1920;
-            screenHeight = capture.details.height || 1080;
-            try {
-                const prompt = `Look at this screenshot and locate the UI element: "${elementQuery}".
-Return ONLY a valid JSON object with the center point of this element in 0-1000 normalized coordinates:
-{"point": [y, x]}
-Where y is between 0 and 1000 (top to bottom) and x is between 0 and 1000 (left to right).
-If not found, return {"point": null}. Output nothing else.`;
-                const reply = await callVisionAi(capture.details.outPath, prompt, 80);
-                if (reply) {
-                    const match = reply.match(/\{[\s\S]*"point"[\s\S]*\}/);
-                    if (match) {
-                        const parsed = JSON.parse(match[0]);
-                        if (Array.isArray(parsed.point) && parsed.point.length === 2) {
-                            const normY = Number(parsed.point[0]);
-                            const normX = Number(parsed.point[1]);
-                            if (!isNaN(normX) && !isNaN(normY)) {
-                                targetX = Math.round((normX / 1000) * screenWidth);
-                                targetY = Math.round((normY / 1000) * screenHeight);
-                            }
-                        }
-                    }
-                }
-            }
-            catch { }
-        }
-    }
-    if ((targetX === undefined || targetY === undefined) && process.platform === 'win32') {
-        const psScript = `
-Add-Type -AssemblyName UIAutomationClient
-Add-Type -AssemblyName UIAutomationTypes
-$target = "${elementQuery.replace(/"/g, '""')}"
-$root = [System.Windows.Automation.AutomationElement]::RootElement
-
-$condName = New-Object System.Windows.Automation.PropertyCondition([System.Windows.Automation.AutomationElement]::NameProperty, $target)
-$el = $root.FindFirst([System.Windows.Automation.TreeScope]::Descendants, $condName)
-
-if (-not $el) {
-    $all = $root.FindAll([System.Windows.Automation.TreeScope]::Descendants, [System.Windows.Automation.Condition]::TrueCondition)
-    foreach ($item in $all) {
-        if ($item.Current.Name -and $item.Current.Name.ToLower().Contains($target.ToLower())) {
-            $el = $item
-            break
-        }
-    }
-}
-
-if ($el) {
-    $rect = $el.Current.BoundingRectangle
-    if ($rect -and $rect.Width -gt 0 -and $rect.Height -gt 0) {
-        $cx = [int]($rect.X + ($rect.Width / 2))
-        $cy = [int]($rect.Y + ($rect.Height / 2))
-        @{ x = $cx; y = $cy; name = $el.Current.Name } | ConvertTo-Json
-    }
-}
-`;
-        try {
-            const { stdout } = await execAsync(`powershell -NoProfile -Command "${psScript.replace(/\r?\n/g, ' ')}"`);
-            if (stdout.trim()) {
-                const uia = JSON.parse(stdout.trim());
-                if (uia.x && uia.y) {
-                    targetX = uia.x;
-                    targetY = uia.y;
-                }
-            }
-        }
-        catch { }
-    }
-    if (targetX !== undefined && targetY !== undefined) {
-        const clickRes = await moveAndClickMouse(targetX, targetY, button, appName);
-        return {
-            success: clickRes.success,
-            output: `Visual Grounding Success: Located "${elementQuery}" at screen coordinates (${targetX}, ${targetY}). ${clickRes.output}`,
-            coordinates: { x: targetX, y: targetY },
-        };
-    }
-    return {
-        success: false,
-        output: `Could not visually or structurally locate UI element "${elementQuery}" on screen. Try calling analyze_screen to view current screen contents, or provide explicit (x, y) coordinates.`,
-    };
-}
-//# sourceMappingURL=appControl.js.map