ft-scout 9.4.6 → 9.4.7

package/bin/src/commands/pr.js

@@ -0,0 +1,191 @@
+/**
+ * Scout Autonomous GitHub PR Creator
+ * Cuts clean feature branches, analyzes git diff, generates architectural summaries, and creates GitHub PRs.
+ */
+import fs from 'fs';
+import path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import chalk from 'chalk';
+import { spinner, confirm, text, isCancel } from '@clack/prompts';
+import { openai, callOpenAIWithRetry } from '../engine/llm.js';
+const execAsync = promisify(exec);
+export async function handlePrCommand(titleInput, options = {}) {
+    const cwd = process.cwd();
+    const baseBranch = options.base || 'main';
+    console.log(chalk.bold.cyan(`\n🚀 Scout Autonomous GitHub PR Creator\n`));
+    // 1. Verify Git Repository
+    try {
+        await execAsync('git rev-parse --is-inside-work-tree', { cwd });
+    }
+    catch {
+        console.log(chalk.red('✖ Error: Current directory is not a git repository.'));
+        return;
+    }
+    // 2. Check current branch & git status
+    let currentBranch = 'main';
+    try {
+        const { stdout } = await execAsync('git rev-parse --abbrev-ref HEAD', { cwd });
+        currentBranch = stdout.trim();
+    }
+    catch { }
+    let statusOutput = '';
+    try {
+        const { stdout } = await execAsync('git status --porcelain', { cwd });
+        statusOutput = stdout.trim();
+    }
+    catch { }
+    // If there are uncommitted changes, commit them
+    if (statusOutput) {
+        console.log(chalk.yellow(`Found uncommitted changes in working directory:`));
+        const statusLines = statusOutput.split('\n').slice(0, 5);
+        statusLines.forEach(l => console.log(chalk.dim(`  ${l}`)));
+        if (statusOutput.split('\n').length > 5) {
+            console.log(chalk.dim(`  ...and ${statusOutput.split('\n').length - 5} more files`));
+        }
+        const shouldCommit = await confirm({
+            message: 'Commit these changes before creating the Pull Request?',
+            initialValue: true,
+        });
+        if (isCancel(shouldCommit))
+            return;
+        if (shouldCommit) {
+            const commitMsg = titleInput || `feat: autonomous updates by Scout AI`;
+            const spin = spinner();
+            spin.start(chalk.cyan('Committing changes...'));
+            try {
+                await execAsync('git add -A', { cwd });
+                await execAsync(`git commit -m "${commitMsg.replace(/"/g, '\\"')}"`, { cwd });
+                spin.stop(chalk.green('✔ Changes committed cleanly.'));
+            }
+            catch (err) {
+                spin.stop(chalk.red(`Failed to commit: ${err?.message || String(err)}`));
+                return;
+            }
+        }
+    }
+    // If currently on main or master, create and checkout feature branch
+    if (currentBranch === 'main' || currentBranch === 'master') {
+        const branchSlug = (titleInput || 'feature')
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '')
+            .slice(0, 30);
+        const newBranch = `feat/scout-${branchSlug || 'update'}-${Date.now().toString(36)}`;
+        console.log(chalk.cyan(`Currently on ${chalk.bold(currentBranch)}. Creating feature branch ${chalk.bold.yellow(newBranch)}...`));
+        try {
+            await execAsync(`git checkout -b "${newBranch}"`, { cwd });
+            currentBranch = newBranch;
+        }
+        catch (err) {
+            console.log(chalk.red(`Failed to create feature branch: ${err?.message || String(err)}`));
+            return;
+        }
+    }
+    // 3. Compute Diff against base branch
+    const diffSpin = spinner();
+    diffSpin.start(chalk.cyan(`Analyzing diff against ${baseBranch}...`));
+    let diffText = '';
+    try {
+        const { stdout } = await execAsync(`git diff ${baseBranch}...HEAD`, { cwd });
+        diffText = stdout.trim();
+        if (!diffText) {
+            // Fallback to diff against previous commit
+            const { stdout: headDiff } = await execAsync(`git diff HEAD~1..HEAD`, { cwd });
+            diffText = headDiff.trim();
+        }
+    }
+    catch {
+        try {
+            const { stdout } = await execAsync(`git diff HEAD~1`, { cwd });
+            diffText = stdout.trim();
+        }
+        catch { }
+    }
+    diffSpin.stop(chalk.green(`✔ Git diff captured (${diffText.length} characters).`));
+    // 4. Generate PR Description with AI
+    const prSpin = spinner();
+    prSpin.start(chalk.cyan('Synthesizing PR title, architectural breakdown, and risk analysis...'));
+    let prTitle = titleInput || 'feat: codebase improvements and updates';
+    let prBody = '';
+    try {
+        const prompt = `You are a Principal Software Engineer. Write a comprehensive GitHub Pull Request description based on this git diff.
+DIFF:
+${diffText.slice(0, 15000)}
+
+Generate the response in JSON format:
+{
+  "title": "Conventional commit style PR title (e.g. feat(engine): add auto-healer and visual HUD)",
+  "body": "Markdown formatted PR body with sections: ## 📌 Summary of Changes, ## 🧱 Architectural Impact, ## 🛡️ Risk & Verification Checklist, ## 🧪 How Was This Tested"
+}`;
+        const res = await callOpenAIWithRetry((model) => openai.chat.completions.create({
+            model,
+            messages: [{ role: 'user', content: prompt }],
+            response_format: { type: 'json_object' },
+        }));
+        const parsed = JSON.parse(res?.choices?.[0]?.message?.content || '{}');
+        if (parsed.title && !titleInput)
+            prTitle = parsed.title;
+        prBody = parsed.body || `## Summary\nAutonomous updates generated by FrontTerrain Scout.`;
+    }
+    catch {
+        prBody = `## 📌 Summary of Changes\n- Autonomous updates and refinements applied by Scout AI.\n\n## 🧪 Verification\n- Local build and test suites validated.`;
+    }
+    prSpin.stop(chalk.green('✔ PR metadata generated!'));
+    // 5. Save PR markdown artifact
+    const ftDir = path.join(cwd, '.ft');
+    if (!fs.existsSync(ftDir))
+        fs.mkdirSync(ftDir, { recursive: true });
+    fs.writeFileSync(path.join(ftDir, 'PULL_REQUEST.md'), `# ${prTitle}\n\n${prBody}`, 'utf-8');
+    console.log(`\n${chalk.bold('Title:')} ${chalk.green(prTitle)}`);
+    console.log(`${chalk.bold('Branch:')} ${chalk.cyan(currentBranch)} -> ${chalk.cyan(baseBranch)}\n`);
+    // 6. Push to Remote unless --no-push
+    if (!options.noPush) {
+        const pushSpin = spinner();
+        pushSpin.start(chalk.cyan(`Pushing branch ${currentBranch} to origin...`));
+        try {
+            await execAsync(`git push -u origin "${currentBranch}"`, { cwd });
+            pushSpin.stop(chalk.green('✔ Pushed branch to remote origin.'));
+        }
+        catch (err) {
+            pushSpin.stop(chalk.yellow(`Warning: Remote push notice: ${err?.message || String(err)}`));
+        }
+    }
+    // 7. Check for GitHub CLI (gh)
+    let ghAvailable = false;
+    try {
+        await execAsync('gh --version', { cwd });
+        ghAvailable = true;
+    }
+    catch { }
+    if (ghAvailable && !options.noPush) {
+        const createPrSpin = spinner();
+        createPrSpin.start(chalk.cyan('Creating Pull Request on GitHub via gh CLI...'));
+        try {
+            const draftFlag = options.draft ? '--draft' : '';
+            const { stdout } = await execAsync(`gh pr create --title "${prTitle.replace(/"/g, '\\"')}" --body-file "${path.join(ftDir, 'PULL_REQUEST.md').replace(/\\/g, '/')}" --base "${baseBranch}" ${draftFlag}`, { cwd });
+            createPrSpin.stop(chalk.green(`✔ GitHub Pull Request Created Successfully!`));
+            console.log(chalk.bold.green(`\n🔗 PR URL: ${stdout.trim()}\n`));
+            return;
+        }
+        catch (err) {
+            createPrSpin.stop(chalk.yellow(`Notice: gh CLI could not complete: ${err?.message || String(err)}`));
+        }
+    }
+    // Fallback: Get remote URL and print web compare link
+    let originUrl = '';
+    try {
+        const { stdout } = await execAsync('git config --get remote.origin.url', { cwd });
+        originUrl = stdout.trim();
+    }
+    catch { }
+    if (originUrl) {
+        // Convert git@github.com:owner/repo.git or https://github.com/owner/repo.git to web URL
+        let webUrl = originUrl.replace(/^git@github\.com:/, 'https://github.com/').replace(/\.git$/, '');
+        const compareUrl = `${webUrl}/compare/${baseBranch}...${currentBranch}?expand=1`;
+        console.log(chalk.bold.green(`\n✔ Branch pushed! Create your PR online at:`));
+        console.log(`  🔗 ${chalk.cyan.underline(compareUrl)}\n`);
+        console.log(chalk.dim(`PR description saved locally to .ft/PULL_REQUEST.md`));
+    }
+}
+//# sourceMappingURL=pr.js.map

package/bin/src/commands/pr.js.map

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

package/bin/src/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["watch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyBrD;AAED,wBAAsB,WAAW,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,iBAwHnF"}

package/bin/src/commands/watch.js

@@ -0,0 +1,149 @@
+/**
+ * Scout Smart Terminal Auto-Healer & Test Watcher
+ * Background watch daemon that auto-runs tests on save, captures tracebacks, and self-heals failures.
+ */
+import fs from 'fs';
+import path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import chalk from 'chalk';
+import { spinner, select, isCancel } from '@clack/prompts';
+import { AgentExecutionLoop } from '../engine/agentEngine.js';
+import { extractErrorDiagnostics } from '../engine/verifier.js';
+const execAsync = promisify(exec);
+export function detectTestCommand(cwd) {
+    const pkgJson = path.join(cwd, 'package.json');
+    if (fs.existsSync(pkgJson)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgJson, 'utf-8'));
+            if (pkg.scripts?.test && pkg.scripts.test !== 'echo "Error: no test specified" && exit 1') {
+                return 'npm test';
+            }
+            if (pkg.scripts?.build) {
+                return 'npm run build';
+            }
+        }
+        catch { }
+    }
+    if (fs.existsSync(path.join(cwd, 'pytest.ini')) || fs.existsSync(path.join(cwd, 'pyproject.toml'))) {
+        return 'pytest';
+    }
+    if (fs.existsSync(path.join(cwd, 'Cargo.toml'))) {
+        return 'cargo test';
+    }
+    if (fs.existsSync(path.join(cwd, 'go.mod'))) {
+        return 'go test ./...';
+    }
+    return 'npm test';
+}
+export async function handleWatch(customCommand, options = {}) {
+    const cwd = options.dir ? path.resolve(process.cwd(), options.dir) : process.cwd();
+    const testCmd = customCommand || detectTestCommand(cwd);
+    console.log(chalk.bold.cyan(`\n👁️  Scout Smart Watch Daemon Active`));
+    console.log(`  ${chalk.bold('Workspace:')} ${chalk.gray(cwd)}`);
+    console.log(`  ${chalk.bold('Command:')}   ${chalk.yellow(testCmd)}`);
+    console.log(`  ${chalk.bold('Mode:')}      ${options.auto ? chalk.green('Auto-Heal ON') : chalk.cyan('Interactive Prompt')}`);
+    console.log(chalk.dim(`\nWatching for file changes... Press Ctrl+C to stop.\n`));
+    let isRunning = false;
+    let pendingRun = false;
+    let debounceTimer = null;
+    const runCheck = async () => {
+        if (isRunning) {
+            pendingRun = true;
+            return;
+        }
+        isRunning = true;
+        pendingRun = false;
+        if (options.clear) {
+            console.clear();
+        }
+        console.log(chalk.gray(`\n[${new Date().toLocaleTimeString()}] Running: ${testCmd}...`));
+        const runSpin = spinner();
+        runSpin.start(chalk.cyan(`Executing ${testCmd}...`));
+        try {
+            const { stdout, stderr } = await execAsync(testCmd, { cwd });
+            runSpin.stop(chalk.green(`✔ All checks passed cleanly!`));
+            if (stdout && stdout.length < 500) {
+                console.log(chalk.dim(stdout.trim()));
+            }
+        }
+        catch (err) {
+            runSpin.stop(chalk.red(`✖ Command failed with error:`));
+            const errorOutput = `${err?.stdout || ''}\n${err?.stderr || ''}\n${err?.message || ''}`.trim();
+            console.log(chalk.red.dim(errorOutput.slice(-1200)));
+            const diagnostics = extractErrorDiagnostics(errorOutput);
+            const errorSummary = diagnostics.keyErrors[0] || 'Build or test execution failure';
+            const brokenFile = diagnostics.referencedFiles[0] || '';
+            console.log(chalk.bold.yellow(`\nDetected issue: ${errorSummary}`));
+            if (brokenFile) {
+                console.log(`   ${chalk.bold('Target file:')} ${chalk.cyan(brokenFile)}`);
+            }
+            let shouldHeal = Boolean(options.auto);
+            if (!shouldHeal) {
+                const choice = await select({
+                    message: 'How would you like to proceed?',
+                    options: [
+                        { label: '⚡ Auto-heal with Scout Agent', value: 'heal' },
+                        { label: '🔄 Re-run command', value: 'rerun' },
+                        { label: '👁️ Continue watching', value: 'ignore' },
+                    ],
+                });
+                if (isCancel(choice)) {
+                    process.exit(0);
+                }
+                if (choice === 'heal') {
+                    shouldHeal = true;
+                }
+                else if (choice === 'rerun') {
+                    isRunning = false;
+                    runCheck();
+                    return;
+                }
+            }
+            if (shouldHeal) {
+                console.log(chalk.cyan.bold(`\n🛠️  Scout Auto-Healer Dispatching...`));
+                const goal = `Fix the test/build failure caused by: ${errorSummary}. The broken file is ${brokenFile || 'in the project'}. Verify the solution by ensuring '${testCmd}' executes without errors.`;
+                const agent = new AgentExecutionLoop({
+                    autoApprove: true,
+                });
+                const result = await agent.executeGoal(goal);
+                if (result.success) {
+                    console.log(chalk.green.bold(`\n✔ Auto-heal succeeded! Re-running verification...`));
+                }
+                else {
+                    console.log(chalk.yellow(`\n⚠ Auto-heal finished with notice: ${result.summary}`));
+                }
+            }
+        }
+        finally {
+            isRunning = false;
+            if (pendingRun) {
+                runCheck();
+            }
+        }
+    };
+    // Run once on launch
+    await runCheck();
+    // Setup recursive filesystem watcher
+    const ignoreDirs = ['node_modules', '.git', '.ft', 'dist', 'bin', 'coverage', '.cache'];
+    const watcher = fs.watch(cwd, { recursive: true }, (_eventType, filename) => {
+        if (!filename)
+            return;
+        const norm = filename.replace(/\\/g, '/');
+        if (ignoreDirs.some(dir => norm.startsWith(dir + '/') || norm === dir))
+            return;
+        if (norm.endsWith('.tmp') || norm.endsWith('.log'))
+            return;
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            runCheck();
+        }, 350);
+    });
+    process.on('SIGINT', () => {
+        watcher.close();
+        console.log(chalk.cyan('\nWatcher stopped. Goodbye!\n'));
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=watch.js.map

package/bin/src/commands/watch.js.map

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

package/bin/src/engine/agentEngine.d.ts.map

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

package/bin/src/engine/agentEngine.js

@@ -23,6 +23,7 @@ import { loadAuthConfig, isProOrHigher } from '../utils/auth.js';
 import { getMCPManager } from '../mcp/index.js';
 import { writeTelemetry } from '../utils/qrBridge.js';
 import { compress, LEVEL_FAST } from 'codrop';
+import { CheckpointManager } from './checkpoints/checkpointManager.js';
 export { AgentRuntime, AgentWorkspace, inferExecutionIntent, resolveDesktopPath, SystemComputerController, MockComputerController };
 const execAsync = promisify(exec);
 export function robustSnippetReplace(origContent, target, replacement) {
@@ -293,6 +294,29 @@ export const AGENT_TOOLS = [
             required: ['text'],
         },
     },
+    {
+        name: 'delegate_subtask',
+        description: 'Delegate a specialized subtask to an autonomous specialist subagent (architect, coder, tester, reviewer, general). Useful for delegating code reviews, test generation, architectural breakdowns, or isolated module implementations to an autonomous worker agent.',
+        parameters: {
+            type: 'object',
+            properties: {
+                role: {
+                    type: 'string',
+                    enum: ['architect', 'coder', 'tester', 'reviewer', 'general'],
+                    description: 'Specialist role for the subagent (architect, coder, tester, reviewer, general)',
+                },
+                task: {
+                    type: 'string',
+                    description: 'The specific subtask instruction or goal for the subagent to complete',
+                },
+                context: {
+                    type: 'string',
+                    description: 'Relevant file paths, error messages, or architectural context to provide to the subagent',
+                },
+            },
+            required: ['role', 'task'],
+        },
+    },
     {
         name: 'task_completed',
         description: 'Signal that the user goal has been fully completed with the full answer, results, and summary.',
@@ -403,10 +427,10 @@ export class AgentExecutionLoop {
         this.mockMode = Boolean(options?.mockMode);
         this.isAudioMode = Boolean(options?.isAudioMode);
         this.userTier = (options?.tier || loadAuthConfig().currentTier || 'free').toLowerCase();
-        // Free tier is bounded to basic direct actions (max 5 steps). Full autonomous multi-step loops require Pro/Enterprise.
+        // Free tier is bounded to basic direct actions (max 5 steps). Full autonomous multi-step loops require Pro/Enterprise (unlimited steps).
         const isPaid = this.mockMode || this.userTier === 'pro' || this.userTier === 'enterprise';
-        const requestedSteps = options?.maxSteps || 30;
-        this.maxSteps = isPaid ? requestedSteps : Math.min(requestedSteps, 5);
+        const requestedSteps = options?.maxSteps;
+        this.maxSteps = isPaid ? (requestedSteps || Infinity) : Math.min(requestedSteps || 5, 5);
         this.taskStateManager = new TaskStateManager(options?.taskId, '', this.cwd);
         this.computerController = options?.computerController || (this.mockMode ? new MockComputerController() : new SystemComputerController(this.cwd));
         this.browserController = options?.browserController || new SemanticBrowserController(this.cwd);
@@ -418,6 +442,9 @@ export class AgentExecutionLoop {
     getUserTier() {
         return this.userTier;
     }
+    isPaidTier() {
+        return this.mockMode || this.userTier === 'pro' || this.userTier === 'enterprise';
+    }
     getExecutionIntent() {
         return this.executionIntent;
     }
@@ -591,9 +618,10 @@ Task Execution Intent & Constraints:
 • Target Destination: ${this.executionIntent.targetDestination || 'Default'}
 • Target Artifact: ${this.executionIntent.targetArtifactName || 'None'}
 ` : '';
-        const isPaid = this.mockMode || this.userTier === 'pro' || this.userTier === 'enterprise';
+        const isPaid = this.isPaidTier();
         const tierDirective = isPaid ? `
 PLAN TIER & CAPABILITIES: ${this.userTier.toUpperCase()} (FULL ACCESS UNLOCKED)
+• Unlimited autonomous multi-step loops with no step limits.
 • Autonomous Computer-Use, Browser Automation, and AI Scratchpad Reasoning are fully ENABLED.
 • Use the 'scratchpad' tool to organize multi-step reasoning, break down complex goals, draft hypotheses, and track working memory across turns.
 ` : `
@@ -821,9 +849,15 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
                 content: promptContent,
             });
         }
-        const estTotalSecs = Math.round(this.maxSteps * 12);
-        const estTimeText = estTotalSecs >= 60 ? `~${(estTotalSecs / 60).toFixed(1)}m` : `~${estTotalSecs}s`;
-        console.log(chalk.gray(`Estimated completion time: ${estTimeText} (Max ${this.maxSteps} steps)`));
+        const isPaid = this.mockMode || this.userTier === 'pro' || this.userTier === 'enterprise';
+        if (!isPaid && Number.isFinite(this.maxSteps)) {
+            const estTotalSecs = Math.round(this.maxSteps * 12);
+            const estTimeText = estTotalSecs >= 60 ? `~${(estTotalSecs / 60).toFixed(1)}m` : `~${estTotalSecs}s`;
+            console.log(chalk.gray(`Estimated completion time: ${estTimeText} (Free Tier Max ${this.maxSteps} steps)`));
+        }
+        else {
+            console.log(chalk.gray(`⚡ Autonomous execution loop: Unlimited steps active (${this.userTier.toUpperCase()} plan)`));
+        }
         let step = 0;
         let finalSummary = '';
         const stepDurations = [];
@@ -838,16 +872,21 @@ When returning tool calls, use standard OpenAI function calling format or JSON t
             this.currentStep = step;
             this.taskStateManager.startStep(step);
             const stepStartTime = Date.now();
-            const avgStepMs = stepDurations.length > 0
-                ? stepDurations.reduce((a, b) => a + b, 0) / stepDurations.length
-                : 12000;
-            const remainingSteps = (this.maxSteps - step + 1);
-            const estSecsLeft = Math.max(5, Math.round((remainingSteps * avgStepMs) / 1000));
-            const estLeftStr = estSecsLeft >= 60
-                ? `${Math.floor(estSecsLeft / 60)}m ${estSecsLeft % 60}s`
-                : `${estSecsLeft}s`;
             const stepSpinner = spinner();
-            stepSpinner.start(chalk.cyan(`Scout is Working (Step ${step}/${this.maxSteps} • Est. completion: ~${estLeftStr} left)`));
+            if (isPaid && !Number.isFinite(this.maxSteps)) {
+                stepSpinner.start(chalk.cyan(`Scout is Working (Step ${step})`));
+            }
+            else {
+                const avgStepMs = stepDurations.length > 0
+                    ? stepDurations.reduce((a, b) => a + b, 0) / stepDurations.length
+                    : 12000;
+                const remainingSteps = (this.maxSteps - step + 1);
+                const estSecsLeft = Math.max(5, Math.round((remainingSteps * avgStepMs) / 1000));
+                const estLeftStr = estSecsLeft >= 60
+                    ? `${Math.floor(estSecsLeft / 60)}m ${estSecsLeft % 60}s`
+                    : `${estSecsLeft}s`;
+                stepSpinner.start(chalk.cyan(`Scout is Working (Step ${step}/${this.maxSteps} • Est. completion: ~${estLeftStr} left)`));
+            }
             try {
                 let response;
                 const mcpRouting = getMCPManager().routeTools(userGoal);
@@ -1169,22 +1208,17 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                     content: `Error in previous turn: ${err?.message || String(err)}. Please try alternative steps or call tools.`,
                 });
             }
-            // Step limit check: Auto-extend by +15 steps ONLY for Pro & Enterprise (up to 60 max threshold)
-            const isPaid = this.mockMode || this.userTier === 'pro' || this.userTier === 'enterprise';
-            if (step >= this.maxSteps) {
-                if (isPaid && this.maxSteps < 60) {
-                    this.maxSteps += 15;
-                    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://scout.frontterrain.com/plans or run 'scout dashboard'.`), ' Free Tier Step Limit');
-                    break;
-                }
+            // Step limit check: Free tier only. Pro and Enterprise have unlimited steps.
+            if (!isPaid && step >= this.maxSteps) {
+                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;
             }
         }
         return {
             success: false,
-            summary: `Reached max iteration steps limit (${this.maxSteps}). Modified files: ${Array.from(this.modifiedFiles).join(', ')}`,
+            summary: isPaid
+                ? `Task ended after ${step} iteration steps. Modified files: ${Array.from(this.modifiedFiles).join(', ')}`
+                : `Reached max iteration steps limit (${this.maxSteps}). Modified files: ${Array.from(this.modifiedFiles).join(', ')}`,
         };
     }
     extractJsonToolCall(content) {
@@ -1206,7 +1240,7 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
             'read_file', 'write_file', 'edit_file', 'run_command', 'list_dir',
             'grep_search', 'glob_search', 'tree_view', 'file_info', 'multi_edit_file',
             'fetch_url', 'git_diff',
-            'ask_user', 'speak_text', 'task_completed', 'scratchpad',
+            'ask_user', 'speak_text', 'delegate_subtask', 'task_completed', 'scratchpad',
         ];
         for (const toolName of knownTools) {
             const tagRegex = new RegExp(`<${toolName}>([\\s\\S]*?)<\\/${toolName}>`, 'i');
@@ -1306,6 +1340,8 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
             actionDesc = `Inspecting visible desktop UI`;
         else if (name === 'computer_diagnostic')
             actionDesc = `Running computer control diagnostics`;
+        else if (name === 'delegate_subtask')
+            actionDesc = `Delegating subtask to [${args.role || 'subagent'}]: ${String(args.task || '').slice(0, 40)}`;
         else if (name === 'computer')
             actionDesc = `Computer action: ${args.action || 'action'}`;
         else if (name === 'scratchpad')
@@ -1504,6 +1540,11 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                 this.taskStateManager.addObservation(name, upgradeMsg, false);
                 return { result: upgradeMsg };
             }
+            if (name === 'delegate_subtask') {
+                const upgradeMsg = `[PLAN RESTRICTION]: Autonomous Multi-Agent Swarm Delegation is exclusively available to 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 autonomous subagents.`;
+                this.taskStateManager.addObservation(name, upgradeMsg, false);
+                return { result: upgradeMsg };
+            }
         }
         switch (name) {
             case 'read_file': {
@@ -1563,6 +1604,10 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                     this.backups.push({ filePath: targetPath, originalContent: '__FT_WAS_NEW__' });
                     fs.mkdirSync(path.dirname(fullPath), { recursive: true });
                 }
+                try {
+                    CheckpointManager.getInstance(this.cwd).createCheckpoint(`Step ${this.currentStep}: write_file ${targetPath}`, [targetPath], this.currentStep, this.taskStateManager.getCurrentState().taskId);
+                }
+                catch { }
                 fs.writeFileSync(fullPath, content, 'utf-8');
                 this.modifiedFiles.add(targetPath);
                 const oldLineCount = origContent !== '__FT_WAS_NEW__' ? origContent.split('\n').length : 0;
@@ -1618,6 +1663,10 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                     return { result: `Error editing "${targetPath}": ${replaceRes.error}` };
                 }
                 this.backups.push({ filePath: targetPath, originalContent: origContent });
+                try {
+                    CheckpointManager.getInstance(this.cwd).createCheckpoint(`Step ${this.currentStep}: edit_file ${targetPath}`, [targetPath], this.currentStep, this.taskStateManager.getCurrentState().taskId);
+                }
+                catch { }
                 fs.writeFileSync(fullPath, replaceRes.updatedContent, 'utf-8');
                 this.modifiedFiles.add(targetPath);
                 const targetLines = target.split('\n').length;
@@ -2244,6 +2293,30 @@ You MUST output exactly ONE JSON code block per tool call. Do NOT describe what
                 };
                 return { result: JSON.stringify(structuredRes, null, 2) };
             }
+            case 'delegate_subtask': {
+                const role = (args.role || 'general');
+                const task = String(args.task || '').trim();
+                const context = args.context ? String(args.context) : undefined;
+                if (!task) {
+                    return { result: JSON.stringify({ success: false, error: 'No task specified for subagent delegation.' }) };
+                }
+                const { SubagentManager } = await import('./subagents/subagentManager.js');
+                const subagentMgr = SubagentManager.getInstance();
+                const subRes = await subagentMgr.delegate({
+                    role,
+                    task,
+                    context,
+                    cwd: this.cwd,
+                    tier: this.userTier,
+                });
+                if (subRes.modifiedFiles && subRes.modifiedFiles.length > 0) {
+                    for (const f of subRes.modifiedFiles) {
+                        this.modifiedFiles.add(f);
+                    }
+                }
+                this.taskStateManager.addObservation('delegate_subtask', `[Subagent ${role.toUpperCase()} Result]: ${subRes.summary}`, subRes.success);
+                return { result: JSON.stringify(subRes, null, 2) };
+            }
             case 'task_completed': {
                 const summaryStr = String(args.summary || 'Task completed successfully.');
                 if (this.executionIntent?.targetDestination === 'Desktop' && this.executionIntent?.targetArtifactName) {