ft-scout 9.0.5 → 9.0.7

package/bin/src/engine/agentEngine.js

@@ -14,7 +14,7 @@ import { TaskStateManager } from './agentState.js';
 import { SemanticBrowserController } from './browser/index.js';
 import { ActionVerifier } from './actionVerifier.js';
 import { ApprovalManager, RiskClassifier } from './safety.js';
-import { TaskPlanner } from './planner.js';
+import { TaskPlanner, checkSimpleAppAction } from './planner.js';
 import { UnifiedToolRegistry } from './toolRegistry.js';
 import { SystemComputerController, MockComputerController } from './computer/index.js';
 import { AgentWorkspace, inferExecutionIntent, resolveDesktopPath } from './workspace/index.js';
@@ -615,8 +615,10 @@ CORE ARCHITECTURAL PRINCIPLES:
 6. MULTILINGUAL & INTENT COMPREHENSION: Understand user intent in any language (English, Hinglish like "likho", "bnao", "code karo", "fix karo", "samjha do", Hindi, Spanish, etc.).
 7. FOR CODE & REPO TASKS: When the task is a coding, project refactoring, or repository maintenance task, use direct code modification tools (write_file, edit_file, run_command, read_file, grep_search).
 8. RUN & VERIFY COMMANDS: Execute shell commands, tests, builds, and formatters using run_command.
-9. CRITICAL TERMINATION RULE: As soon as you have finished creating/modifying the necessary files, running verification checks, or completing the desktop application workflow, YOU MUST CALL task_completed tool immediately with a clear summary of your work.
+9. CRITICAL TERMINATION & CONVERSATIONAL VOICE RULE: As soon as you have finished creating/modifying the necessary files, running verification checks, or completing the desktop application workflow, YOU MUST CALL task_completed tool immediately.
+   - CONVERSATIONAL CO-PILOT TONE: In your 'summary' parameter for task_completed, speak directly and warmly to the developer like an elite human co-pilot (e.g. "I've launched Chrome for you and it's active on your screen. What should we tackle next?" or "I've created the authentication controller and all unit tests pass with zero regressions!"). Never output dry mechanical robot logs or third-person phrases like "Objective achieved with 1 tool call". Talk directly to the user!
 10. THOUGHT TRANSPARENCY PROTOCOL: In EVERY step before calling any tools or ending a turn, you MUST provide a clear 1-2 sentence explanation in your text response describing your current reasoning, what file/action you are taking, and why you are taking it.
+11. APPLICATION LAUNCH & SIMPLE ACTION TERMINATION: When the user's objective is simply to open, launch, close, or focus an application (e.g. "Open Chrome", "Launch Notepad", "Open Calculator"): Immediately after calling computer_open_app or computer_close_app, your goal is 100% complete! You MUST call task_completed on the very next step with your friendly conversational summary. NEVER explore the repository or call list_dir, read_file, grep_search, or edit_file for app launching tasks!
 
 When returning tool calls, use standard OpenAI function calling format or JSON tool call payload format:
 \`\`\`json
@@ -657,97 +659,100 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
                 content: recentSessionsMemory,
             });
         }
-        // Robust Target File Discovery: Extract file paths/names directly from userGoal without destroying backslashes
+        // Robust Target File Discovery: Only run file discovery if the goal is NOT a simple desktop application launch/action
+        const simpleAppCheck = checkSimpleAppAction(userGoal);
         const filesList = getDirectoryFiles(this.cwd);
         const matchedFiles = [];
-        const isIgnoredFile = (filePath) => {
-            const norm = filePath.replace(/\\/g, '/').toLowerCase();
-            const ext = path.extname(norm);
-            const ignoredExts = ['.pyc', '.pyo', '.png', '.jpg', '.jpeg', '.gif', '.ico', '.exe', '.bin', '.dll', '.so', '.dylib', '.zip', '.tar', '.gz'];
-            return (norm.includes('__pycache__/') ||
-                norm.includes('.git/') ||
-                norm.includes('node_modules/') ||
-                norm.includes('.ft/') ||
-                ignoredExts.includes(ext));
-        };
-        // Match potential paths
-        const pathMatches = userGoal.match(/(?:[a-zA-Z]:[\\/][^\s"':;,]+|\.?[\\/][^\s"':;,]+\.[a-zA-Z0-9]+|[a-zA-Z0-9_\-./\\]+\.[a-zA-Z0-9]+)/g) || [];
-        for (const rawPath of pathMatches) {
-            const cleanP = rawPath.replace(/^["'()]+|["'()]+$/g, '').trim();
-            if (!cleanP || cleanP.length < 3)
-                continue;
-            const fullP = path.isAbsolute(cleanP) ? cleanP : path.resolve(this.cwd, cleanP);
-            if (fs.existsSync(fullP) && fs.statSync(fullP).isFile()) {
-                const relP = path.relative(this.cwd, fullP).replace(/\\/g, '/');
-                if (!isIgnoredFile(relP) && !matchedFiles.includes(relP))
-                    matchedFiles.push(relP);
+        if (!simpleAppCheck.isSimple) {
+            const isIgnoredFile = (filePath) => {
+                const norm = filePath.replace(/\\/g, '/').toLowerCase();
+                const ext = path.extname(norm);
+                const ignoredExts = ['.pyc', '.pyo', '.png', '.jpg', '.jpeg', '.gif', '.ico', '.exe', '.bin', '.dll', '.so', '.dylib', '.zip', '.tar', '.gz'];
+                return (norm.includes('__pycache__/') ||
+                    norm.includes('.git/') ||
+                    norm.includes('node_modules/') ||
+                    norm.includes('.ft/') ||
+                    ignoredExts.includes(ext));
+            };
+            // Match potential paths
+            const pathMatches = userGoal.match(/(?:[a-zA-Z]:[\\/][^\s"':;,]+|\.?[\\/][^\s"':;,]+\.[a-zA-Z0-9]+|[a-zA-Z0-9_\-./\\]+\.[a-zA-Z0-9]+)/g) || [];
+            for (const rawPath of pathMatches) {
+                const cleanP = rawPath.replace(/^["'()]+|["'()]+$/g, '').trim();
+                if (!cleanP || cleanP.length < 3)
+                    continue;
+                const fullP = path.isAbsolute(cleanP) ? cleanP : path.resolve(this.cwd, cleanP);
+                if (fs.existsSync(fullP) && fs.statSync(fullP).isFile()) {
+                    const relP = path.relative(this.cwd, fullP).replace(/\\/g, '/');
+                    if (!isIgnoredFile(relP) && !matchedFiles.includes(relP))
+                        matchedFiles.push(relP);
+                }
+                else {
+                    // Check if any file in filesList matches or ends with the extracted relative path or filename
+                    const normToken = cleanP.replace(/\\/g, '/').toLowerCase();
+                    const baseName = path.basename(normToken);
+                    for (const f of filesList) {
+                        if (isIgnoredFile(f))
+                            continue;
+                        const normF = f.replace(/\\/g, '/').toLowerCase();
+                        if (normF === normToken || normF.endsWith('/' + normToken) || (baseName.includes('.') && normF.endsWith('/' + baseName))) {
+                            if (!matchedFiles.includes(f))
+                                matchedFiles.push(f);
+                        }
+                    }
+                }
             }
-            else {
-                // Check if any file in filesList matches or ends with the extracted relative path or filename
-                const normToken = cleanP.replace(/\\/g, '/').toLowerCase();
-                const baseName = path.basename(normToken);
+            // Keyword fallback if no direct path matched
+            if (matchedFiles.length === 0) {
+                const stopWords = new Set([
+                    'the', 'a', 'an', 'in', 'is', 'for', 'to', 'of', 'and', 'or', 'on', 'at', 'by', 'from',
+                    'with', 'this', 'that', 'it', 'code', 'file', 'files', 'fix', 'add', 'make', 'create',
+                    'update', 'change', 'modify', 'edit', 'write', 'implement', 'bro', 'please', 'scout',
+                    'agent', 'bug', 'error', 'issue', 'help', 'app', 'project', 'script', 'function',
+                    'folder', 'dir', 'directory', 'testing', 'inside', 'open', 'vs', 'vscode', 'py', 'python',
+                    'new', 'build', 'run', 'test', 'suite'
+                ]);
+                const words = userGoal.split(/[\s,;:\/\\]+/).map((w) => w.replace(/["'(),;:!]/g, '').trim());
+                const keywords = words.filter((w) => w.length >= 3 && !stopWords.has(w.toLowerCase()));
                 for (const f of filesList) {
                     if (isIgnoredFile(f))
                         continue;
+                    if (matchedFiles.length >= 3)
+                        break;
                     const normF = f.replace(/\\/g, '/').toLowerCase();
-                    if (normF === normToken || normF.endsWith('/' + normToken) || (baseName.includes('.') && normF.endsWith('/' + baseName))) {
-                        if (!matchedFiles.includes(f))
-                            matchedFiles.push(f);
+                    const baseName = path.basename(normF, path.extname(normF));
+                    for (const kw of keywords) {
+                        const kwLower = kw.toLowerCase();
+                        if (baseName === kwLower || normF.endsWith('/' + kwLower + path.extname(normF))) {
+                            if (!matchedFiles.includes(f))
+                                matchedFiles.push(f);
+                            break;
+                        }
                     }
                 }
             }
-        }
-        // Keyword fallback if no direct path matched
-        if (matchedFiles.length === 0) {
-            const stopWords = new Set([
-                'the', 'a', 'an', 'in', 'is', 'for', 'to', 'of', 'and', 'or', 'on', 'at', 'by', 'from',
-                'with', 'this', 'that', 'it', 'code', 'file', 'files', 'fix', 'add', 'make', 'create',
-                'update', 'change', 'modify', 'edit', 'write', 'implement', 'bro', 'please', 'scout',
-                'agent', 'bug', 'error', 'issue', 'help', 'app', 'project', 'script', 'function',
-                'folder', 'dir', 'directory', 'testing', 'inside', 'open', 'vs', 'vscode', 'py', 'python',
-                'new', 'build', 'run', 'test', 'suite'
-            ]);
-            const words = userGoal.split(/[\s,;:\/\\]+/).map((w) => w.replace(/["'(),;:!]/g, '').trim());
-            const keywords = words.filter((w) => w.length >= 3 && !stopWords.has(w.toLowerCase()));
-            for (const f of filesList) {
-                if (isIgnoredFile(f))
-                    continue;
-                if (matchedFiles.length >= 3)
-                    break;
-                const normF = f.replace(/\\/g, '/').toLowerCase();
-                const baseName = path.basename(normF, path.extname(normF));
-                for (const kw of keywords) {
-                    const kwLower = kw.toLowerCase();
-                    if (baseName === kwLower || normF.endsWith('/' + kwLower + path.extname(normF))) {
-                        if (!matchedFiles.includes(f))
-                            matchedFiles.push(f);
-                        break;
+            // Safely inject high-confidence existing file previews without prompt-hijacking
+            for (const file of matchedFiles.slice(0, 3)) {
+                const fullP = path.resolve(this.cwd, file);
+                if (fs.existsSync(fullP) && fs.statSync(fullP).isFile()) {
+                    const analyzeSpin = spinner();
+                    analyzeSpin.start(chalk.cyan(` Auto-discovered target file: ${file}. Analyzing...`));
+                    try {
+                        const content = fs.readFileSync(fullP, 'utf-8');
+                        const lines = content.split('\n');
+                        analyzeSpin.stop(chalk.green(` Auto-discovered & analyzed ${file} (${lines.length} lines)`));
+                        const previewSnippet = lines.length <= 250
+                            ? lines.map((l, i) => `${i + 1} | ${l}`).join('\n')
+                            : lines.slice(0, 100).map((l, i) => `${i + 1} | ${l}`).join('\n') + `\n... [truncated, file has ${lines.length} lines. Call read_file to view remaining lines]`;
+                        this.readFilesHistory.add(file);
+                        this.readFilesHistory.add(file.replace(/\\/g, '/').toLowerCase());
+                        this.historyMessages.push({
+                            role: 'user',
+                            content: `[Reference Workspace Context - Pre-loaded target file "${file}" (${lines.length} lines)]:\n\`\`\`\n${previewSnippet}\n\`\`\`\nCRITICAL DIRECTIVE: The target file "${file}" is ALREADY fully pre-loaded into your reference context above. DO NOT call read_file or list_dir for this file again! Immediately begin calling write_file, edit_file, or run_command to satisfy the user goal.`,
+                        });
+                    }
+                    catch {
+                        analyzeSpin.stop(chalk.yellow(`Could not read file ${file}`));
                     }
-                }
-            }
-        }
-        // Safely inject high-confidence existing file previews without prompt-hijacking
-        for (const file of matchedFiles.slice(0, 3)) {
-            const fullP = path.resolve(this.cwd, file);
-            if (fs.existsSync(fullP) && fs.statSync(fullP).isFile()) {
-                const analyzeSpin = spinner();
-                analyzeSpin.start(chalk.cyan(` Auto-discovered target file: ${file}. Analyzing...`));
-                try {
-                    const content = fs.readFileSync(fullP, 'utf-8');
-                    const lines = content.split('\n');
-                    analyzeSpin.stop(chalk.green(` Auto-discovered & analyzed ${file} (${lines.length} lines)`));
-                    const previewSnippet = lines.length <= 250
-                        ? lines.map((l, i) => `${i + 1} | ${l}`).join('\n')
-                        : lines.slice(0, 100).map((l, i) => `${i + 1} | ${l}`).join('\n') + `\n... [truncated, file has ${lines.length} lines. Call read_file to view remaining lines]`;
-                    this.readFilesHistory.add(file);
-                    this.readFilesHistory.add(file.replace(/\\/g, '/').toLowerCase());
-                    this.historyMessages.push({
-                        role: 'user',
-                        content: `[Reference Workspace Context - Pre-loaded target file "${file}" (${lines.length} lines)]:\n\`\`\`\n${previewSnippet}\n\`\`\`\nCRITICAL DIRECTIVE: The target file "${file}" is ALREADY fully pre-loaded into your reference context above. DO NOT call read_file or list_dir for this file again! Immediately begin calling write_file, edit_file, or run_command to satisfy the user goal.`,
-                    });
-                }
-                catch {
-                    analyzeSpin.stop(chalk.yellow(`Could not read file ${file}`));
                 }
             }
         }
@@ -858,6 +863,29 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                                 content: `Tool Execution Result (${fnName}):\n${toolResult.result}`,
                             });
                             this.handleToolConsecutiveTracking(fnName, args, step);
+                            // Automatic immediate completion for simple app actions (open/close/switch window)
+                            if (simpleAppCheck.isSimple && (fnName === 'computer_open_app' || fnName === 'computer_close_app' || fnName === 'computer_switch_window')) {
+                                let callSucceeded = false;
+                                try {
+                                    const parsed = JSON.parse(toolResult.result);
+                                    callSucceeded = parsed.success !== false;
+                                }
+                                catch {
+                                    callSucceeded = !toolResult.result.toLowerCase().includes('failed') && !toolResult.result.toLowerCase().includes('error');
+                                }
+                                if (callSucceeded) {
+                                    const appName = simpleAppCheck.appName || 'application';
+                                    const actionVerb = simpleAppCheck.action === 'close' ? 'closed' : (simpleAppCheck.action === 'switch' ? 'focused' : 'launched');
+                                    finalSummary = `I've ${actionVerb} ${appName} for you. It's ready on your screen!`;
+                                    safeNote(chalk.green(` ${finalSummary}`), 'Task Completed');
+                                    saveAgentSession({
+                                        goal: userGoal,
+                                        summary: finalSummary,
+                                        modifiedFiles: [],
+                                    });
+                                    return { success: true, summary: finalSummary };
+                                }
+                            }
                             if (fnName === 'task_completed') {
                                 finalSummary = args.summary || toolResult.result;
                                 if (this.modifiedFiles.size > 0) {
@@ -891,6 +919,29 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                         content: `Tool Execution Result (${parsedJsonTool.tool}):\n${toolResult.result}`,
                     });
                     this.handleToolConsecutiveTracking(parsedJsonTool.tool, parsedJsonTool.args, step);
+                    // Automatic immediate completion for simple app actions (open/close/switch window)
+                    if (simpleAppCheck.isSimple && (parsedJsonTool.tool === 'computer_open_app' || parsedJsonTool.tool === 'computer_close_app' || parsedJsonTool.tool === 'computer_switch_window')) {
+                        let callSucceeded = false;
+                        try {
+                            const parsed = JSON.parse(toolResult.result);
+                            callSucceeded = parsed.success !== false;
+                        }
+                        catch {
+                            callSucceeded = !toolResult.result.toLowerCase().includes('failed') && !toolResult.result.toLowerCase().includes('error');
+                        }
+                        if (callSucceeded) {
+                            const appName = simpleAppCheck.appName || 'application';
+                            const actionVerb = simpleAppCheck.action === 'close' ? 'closed' : (simpleAppCheck.action === 'switch' ? 'focused' : 'launched');
+                            finalSummary = `I've ${actionVerb} ${appName} for you. It's ready on your screen!`;
+                            safeNote(chalk.green(` ${finalSummary}`), 'Task Completed');
+                            saveAgentSession({
+                                goal: userGoal,
+                                summary: finalSummary,
+                                modifiedFiles: [],
+                            });
+                            return { success: true, summary: finalSummary };
+                        }
+                    }
                     if (parsedJsonTool.tool === 'task_completed') {
                         finalSummary = parsedJsonTool.args?.summary || toolResult.result;
                         saveAgentSession({
@@ -970,7 +1021,7 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                     safeNote(chalk.bold.yellow(`⚡ Step limit reached while task is in progress. Automatically extending execution by +15 extra steps (New Max Limit: ${this.maxSteps})...`), ' Auto Extra Steps Extension');
                 }
                 else if (!isPaid) {
-                    safeNote(chalk.bold.yellow(`⚡ Free Tier limit reached (${this.maxSteps} steps).\nFree developers can perform basic code editing, creating files/folders, and running commands.\nTo unlock unlimited autonomous multi-step loops and scratchpad reasoning, upgrade to Pro at https://tryscout.web.app/plans or run 'scout dashboard'.`), ' Free Tier Step Limit');
+                    safeNote(chalk.bold.yellow(`⚡ Free Tier limit reached (${this.maxSteps} steps).\nFree developers can perform basic code editing, creating files/folders, and running commands.\nTo unlock unlimited autonomous multi-step loops and scratchpad reasoning, upgrade to Pro at https://scout.frontterrain.com/plans or run 'scout dashboard'.`), ' Free Tier Step Limit');
                     break;
                 }
             }
@@ -1112,7 +1163,7 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
         // 1. Scratchpad Feature Gating (Pro & Enterprise only)
         if (name === 'scratchpad') {
             if (!isPaid) {
-                const blockedMsg = `[PLAN RESTRICTION: PRO / ENTERPRISE ONLY] The Scratchpad reasoning memory is exclusive to Pro and Enterprise tiers. Free tier developers can perform basic code editing (edit_file), creating files and folders (write_file), and running commands (run_command). To unlock the AI scratchpad, upgrade at https://tryscout.web.app/plans or run 'scout dashboard'.`;
+                const blockedMsg = `[PLAN RESTRICTION: PRO / ENTERPRISE ONLY] The Scratchpad reasoning memory is exclusive to Pro and Enterprise tiers. Free tier developers can perform basic code editing (edit_file), creating files and folders (write_file), and running commands (run_command). To unlock the AI scratchpad, upgrade at https://scout.frontterrain.com/plans or run 'scout dashboard'.`;
                 console.log(chalk.red.bold(`\n⛔ ${blockedMsg}`));
                 this.taskStateManager.addObservation(name, blockedMsg, false);
                 return { result: blockedMsg };
@@ -1153,7 +1204,7 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
         // 2. Autonomous Computer & Browser Automation Gating (Pro & Enterprise only)
         if (name === 'computer' || name.startsWith('computer_') || name.startsWith('browser_')) {
             if (!isPaid) {
-                const blockedMsg = `[PLAN RESTRICTION: PRO / ENTERPRISE ONLY] Autonomous Computer-Use & Browser Automation features are exclusive to Pro and Enterprise tiers. Free tier developers can perform basic code editing (edit_file), creating files and folders (write_file), and running commands (run_command) in the workspace. Upgrade to Pro at https://tryscout.web.app/plans or run 'scout dashboard'.`;
+                const blockedMsg = `[PLAN RESTRICTION: PRO / ENTERPRISE ONLY] Autonomous Computer-Use & Browser Automation features are exclusive to Pro and Enterprise tiers. Free tier developers can perform basic code editing (edit_file), creating files and folders (write_file), and running commands (run_command) in the workspace. Upgrade to Pro at https://scout.frontterrain.com/plans or run 'scout dashboard'.`;
                 console.log(chalk.red.bold(`\n⛔ ${blockedMsg}`));
                 this.taskStateManager.addObservation(name, blockedMsg, false);
                 return { result: blockedMsg };
@@ -1178,6 +1229,22 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
             }
         }
         // Validate against execution intent (USER INTENT > TOOL CONVENIENCE)
+        const simpleCheckInDispatch = checkSimpleAppAction(this.taskStateManager.getState()?.objective || '');
+        if (simpleCheckInDispatch.isSimple) {
+            if (['list_dir', 'read_file', 'grep_search', 'glob_search', 'file_info', 'tree_view', 'write_file', 'edit_file', 'multi_edit_file'].includes(name)) {
+                const blockedExplorationMsg = `[UNNECESSARY WORKSPACE EXPLORATION BLOCKED]: The user only requested to ${simpleCheckInDispatch.action || 'launch'} ${simpleCheckInDispatch.appName || 'the application'}. Reading repository code or listing files (${name}) is forbidden for this task. You must call task_completed immediately.`;
+                this.taskStateManager.addObservation(name, blockedExplorationMsg, false);
+                return {
+                    result: JSON.stringify({
+                        success: false,
+                        action: name,
+                        error: 'UnnecessaryWorkspaceExplorationBlocked',
+                        message: blockedExplorationMsg,
+                        directive: "Call 'task_completed' NOW with your completion summary."
+                    }, null, 2)
+                };
+            }
+        }
         if (this.executionIntent && !this.executionIntent.allowAlternativeTools) {
             if (this.executionIntent.requiredInteraction === 'computer') {
                 if (['write_file', 'edit_file', 'multi_edit_file'].includes(name)) {
@@ -1256,6 +1323,24 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                 name = 'computer_diagnostic';
             }
         }
+        // Tier Gating Enforcement
+        if (!isPaid) {
+            if (name.startsWith('computer_') || name === 'computer') {
+                const upgradeMsg = `[PLAN RESTRICTION]: Autonomous Computer Control tools (${name}) are exclusively available to Pro and Enterprise plan developers. Free tier developers can perform code editing, creating files/folders, and running terminal commands. Upgrade to Pro at https://scout.frontterrain.com to unlock autonomous computer & app control.`;
+                this.taskStateManager.addObservation(name, upgradeMsg, false);
+                return { result: upgradeMsg };
+            }
+            if (name.startsWith('browser_')) {
+                const upgradeMsg = `[PLAN RESTRICTION]: Autonomous Browser Control tools (${name}) are exclusively available to Pro and Enterprise plan developers. Free tier developers can perform code editing, creating files/folders, and running terminal commands. Upgrade to Pro at https://scout.frontterrain.com to unlock browser automation.`;
+                this.taskStateManager.addObservation(name, upgradeMsg, false);
+                return { result: upgradeMsg };
+            }
+            if (name === 'scratchpad') {
+                const upgradeMsg = `[PLAN RESTRICTION]: AI Scratchpad & Autonomous reasoning is an exclusive feature for Pro and Enterprise plan subscribers. Free tier developers can perform code editing, creating files/folders, and running commands. Upgrade to Pro at https://scout.frontterrain.com to unlock the AI Scratchpad.`;
+                this.taskStateManager.addObservation(name, upgradeMsg, false);
+                return { result: upgradeMsg };
+            }
+        }
         switch (name) {
             case 'read_file': {
                 const targetPath = String(args.path || '').trim();
@@ -1716,6 +1801,54 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                 this.taskStateManager.addObservation('browser_content', `Extracted content (${res.output.length} chars)`, res.success);
                 return { result: res.output };
             }
+            case 'browser_screenshot': {
+                const res = await this.browserController.screenshot();
+                this.taskStateManager.addObservation('browser_screenshot', res.output, res.success, res.url);
+                return { result: res.output };
+            }
+            case 'browser_select': {
+                const selector = String(args.selector || args.target || '');
+                const val = String(args.value || args.val || '');
+                const res = await this.browserController.select(selector, val);
+                this.taskStateManager.addObservation('browser_select', res.output, res.success, selector);
+                return { result: res.output };
+            }
+            case 'browser_scroll': {
+                const direction = (args.direction || 'down');
+                const amount = Number(args.amount) || 4;
+                const res = await this.browserController.scroll(direction, amount);
+                this.taskStateManager.addObservation('browser_scroll', res.output, res.success);
+                return { result: res.output };
+            }
+            case 'scratchpad': {
+                const action = String(args.action || 'read').toLowerCase().trim();
+                const scratchpadPath = path.resolve(this.cwd, '.ft', 'scratchpad.md');
+                fs.mkdirSync(path.dirname(scratchpadPath), { recursive: true });
+                if (action === 'read') {
+                    const content = fs.existsSync(scratchpadPath) ? fs.readFileSync(scratchpadPath, 'utf-8') : '(Scratchpad is empty)';
+                    this.taskStateManager.addObservation('scratchpad', 'Read scratchpad content', true);
+                    return { result: `Scratchpad Content:\n${content || '(empty)'}` };
+                }
+                else if (action === 'write') {
+                    const newContent = String(args.content || '');
+                    fs.writeFileSync(scratchpadPath, newContent, 'utf-8');
+                    this.taskStateManager.addObservation('scratchpad', `Wrote scratchpad (${newContent.length} chars)`, true);
+                    return { result: `Scratchpad updated (${newContent.length} chars).` };
+                }
+                else if (action === 'append') {
+                    const appendContent = String(args.content || '');
+                    fs.appendFileSync(scratchpadPath, `\n${appendContent}`, 'utf-8');
+                    this.taskStateManager.addObservation('scratchpad', `Appended to scratchpad (${appendContent.length} chars)`, true);
+                    return { result: `Appended to scratchpad (${appendContent.length} chars).` };
+                }
+                else if (action === 'clear') {
+                    if (fs.existsSync(scratchpadPath))
+                        fs.unlinkSync(scratchpadPath);
+                    this.taskStateManager.addObservation('scratchpad', 'Cleared scratchpad', true);
+                    return { result: 'Scratchpad cleared.' };
+                }
+                return { result: `Unknown scratchpad action: "${action}". Supported: read, write, append, clear.` };
+            }
             case 'computer_screenshot': {
                 const res = await this.computerController.screenshot();
                 if (res.path) {
@@ -1917,6 +2050,9 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                 const res = await this.computerController.openApplication(appName, args.args);
                 this.taskStateManager.setActiveApplication(appName);
                 this.taskStateManager.addObservation('computer_open_app', res.output, res.success);
+                const currentObj = this.taskStateManager.getState()?.objective || '';
+                const simpleCheck = checkSimpleAppAction(currentObj);
+                const isOnlyOpening = simpleCheck.isSimple && simpleCheck.action !== 'close';
                 const structuredRes = {
                     success: res.success,
                     action: 'open_app',
@@ -1925,6 +2061,9 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                     recoverable: res.recoverable ?? true,
                     activeWindow: res.activeWindow || appName,
                     expectedWindow: res.expectedWindow || appName,
+                    ...(isOnlyOpening && res.success ? {
+                        directive: "CRITICAL: The requested application is now opened. Your objective is 100% satisfied. You MUST call 'task_completed' immediately on your next turn. DO NOT call list_dir, read_file, or explore the repository."
+                    } : {}),
                 };
                 return { result: JSON.stringify(structuredRes, null, 2) };
             }
@@ -1932,6 +2071,12 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                 const appName = String(args.appName || args.app || '');
                 const res = await this.computerController.closeApplication(appName);
                 this.taskStateManager.addObservation('computer_close_app', res.output, res.success);
+                const currentObj = this.taskStateManager.getState()?.objective || '';
+                const simpleCheck = checkSimpleAppAction(currentObj);
+                const isOnlyClosing = simpleCheck.isSimple && simpleCheck.action === 'close';
+                if (isOnlyClosing && res.success) {
+                    return { result: `${res.output}\nCRITICAL: Application closed. Objective complete. Call task_completed now.` };
+                }
                 return { result: res.output };
             }
             case 'computer_switch_window': {