ft-scout 8.0.2 → 8.0.4

package/.firebase/hosting.d2Vi.cache

@@ -1,7 +1,7 @@
-styles.css,1788837280424,9af505c412e76d8c7ba06682686741a3cf74576fd4c813cc04f76a3e84ee335f
 ScoutFavicon.png,1786186569805,41a9ca9abf7acd2976e78c72a72285b49cc0e64b2b5eeb2c2b88c69628fc618a
-web_cli.html,1788838401645,30d5e62a5d8c1c8bd4df6bad3d149beacfee179854732d44a8851aeb18de4f6a
-index.html,1788838160025,0817fa631e6fa85023f78555327ba5566b0d1a0452edfd21988f9d36c2399eb7
-paid_plans.html,1788838401644,f57e08585d95ed75ccd174a5a1fe7561ad14a394a92757c072ee526c06a3b5c1
-authentication.html,1788838248887,0c18d51a13b2af09c31101ec5dd756ea8d9d536f7788dcfbda8793a8491bf3e3
-app.js,1788838401648,4c6b4edabf046f404464a4a6a1655e9e33be045d32740a4d418fc5bd1aa99356
+web_cli.html,1789048513457,75b7648de5366eb0f6565544610c965521e69ceb9248581edff14495dd1d839f
+authentication.html,1789048395369,535f9fc282d8f7417fb51bd04f905184a603bf4677dd1c03c94babf0a66323f6
+styles.css,1789048603188,7ac973be4a0034bc84096400b12c5a6f327c394db9fc189e97d48c1260474906
+paid_plans.html,1789048625479,2f8899f9ec336e90a5cecb5c0ce489ff3aeb628eb87e559c497225a92410b6cc
+index.html,1789048612383,60105d1acd08ea4b160fdff9d0f64cafbe5e4783f48385f140d509a09bcfb30d
+app.js,1789048647291,6e29d4a713c000d6450dfe9528d12c9be6a83a2e2a1178dda3c1c043c11996cf

package/README.md

@@ -1,4 +1,4 @@
-# scout (FrontTerrain CLI v8.0.2)
+# scout (FrontTerrain CLI v8.0.4)
 
 **FrontTerrain (`scout`)** — The Autonomous AI Principal Software Engineer & Codebase Co-Pilot in your terminal.
 
@@ -32,14 +32,16 @@ scout goal "Refactor database query logic" -y
 ### Interactive Scout Agent Session (Persistent chat loop with Slash Commands & full ReAct tool execution)
 scout agent
 
-# Select Interaction Mode: 💬 Text Interaction OR 🎙️ Audio Interaction (Voice STT + TTS)
-# Force Voice Mode directly via CLI flag:
-scout agent -V
+# Select Interaction Mode: Text Interaction | Audio Interaction (Voice STT + TTS) | Live Screen Share Interaction
+# Launch directly into your preferred mode via CLI flags:
+scout agent -S          # Launch with Live Screen Sharing (streams active app window to model in real time)
+scout agent --screen-share
+scout agent -V          # Launch with Audio Voice mode (STT + TTS)
 scout agent --voice
 
 # Inside session:
-# Agent Prompt: Add dark mode toggle button
-# Slash commands: /help /scratchpad /voice /speak /tree /stats /test /explain /export /diff /undo /clear /scan /plan /history /exit
+# Agent Prompt: "Inspect Chrome and automate login form submission"
+# Slash commands: /help /screenshare /scratchpad /voice /speak /tree /stats /test /explain /export /diff /undo /clear /history /exit
 
 # Generate and create a new source code file
 scout agent --create src/utils/math.ts "Create helper functions for sum, average, and array chunking"
@@ -142,11 +144,23 @@ Scout is built for uninterrupted autonomy across multiple LLM providers:
 
 ---
 
-## Dual Interaction Modes (Text vs Audio)
+## Triple Interaction Modes (Text, Voice, & Live Screen Share)
 
-When starting interactive sessions in `scout agent`, `scout init` (ask mode), or `scout search`, Scout presents a **2-Option Interaction Selector**:
-1. **Text Interaction**: Standard prompt input -> Text response in terminal.
+When starting interactive sessions in `scout agent`, `scout init` (ask mode), or `scout search`, Scout presents a **3-Option Interaction Selector**:
+1. **Text Interaction**: Standard command/prompt input -> Text response in terminal.
 2. **Audio Interaction**: Voice command input via microphone Speech-to-Text (STT) -> Text response + Audio response spoken out loud via Text-to-Speech (TTS).
+3. **Live Screen Share Interaction**: Real-time live screen share stream directly to AI vision models + Target App Window Isolation + Continuous Futuristic Sky-Blue Aura HUD.
+
+---
+
+## Real-Time Live Screen Sharing & Visual Perception Engine
+
+Scout features a native in-memory live screen sharing engine designed specifically for multimodal AI co-pilot workflows:
+
+- **Direct In-Memory Streaming (0 Files Saved to Disk)**: Completely eliminates saving temporary `.png` screenshot files to disk. Real-time compressed frames stream directly in-memory to AI multimodal vision models (Google Gemini 2.0 Flash, NVIDIA Vision, OpenAI GPT-4o) with zero disk I/O overhead.
+- **Target Application Window Isolation**: When the agent is operating on an external app (such as Google Chrome, Microsoft Edge, VS Code, or Notepad), the capture engine isolates **ONLY that specific application's window rectangle** (`BoundingRectangle`). Background applications, sensitive tabs, and other monitor areas are completely excluded from the stream.
+- **Continuous Sky-Blue Aura HUD Overlay**: While live screen sharing is active, a glowing sky-blue (`#00e5ff`) aura border and corner HUD pulses smoothly across screen edges with an active status badge (`Live Screen Share Active [App: chrome] • Streaming to Model Perception Active`).
+- **Autonomous App Focus Synchronization**: Whenever the agent opens or switches applications (`openApp('chrome')` or `takeoverControl('chrome')`), the live stream viewport automatically retargets and locks onto that application window.
 
 ---
 
@@ -155,6 +169,7 @@ When starting interactive sessions in `scout agent`, `scout init` (ask mode), or
 Inside an active `scout agent` interactive session, type any slash command to trigger agent actions:
 
 - `/help` — Display comprehensive guide to all 18 tools and interactive slash commands.
+- `/screenshare` or `/livescreen` — Toggle real-time in-memory screen share stream to the AI model.
 - `/scratchpad` — View active working memory plan & step checklist (`.ft/scratchpad.md`).
 - `/voice` — Activate microphone Speech-to-Text (STT) listener to speak your prompt into CLI.
 - `/speak <text>` — Read entered text out loud via Text-to-Speech (TTS) voice synthesis.
@@ -171,14 +186,15 @@ Inside an active `scout agent` interactive session, type any slash command to tr
 
 ---
 
-## What's New in v8.0.2
+## What's New in v8.0.4
 
-- **Nemotron & DeepSeek Fallback Tool-Calling**: Added smart JSON prompt formatting and fallback parser so models lacking native function-calling can reliably trigger tools, desktop automation, and scratchpad updates.
+- **Real-Time Live Screen Sharing Engine**: Replaced static disk screenshots with in-memory video streaming directly to vision models. Zero disk writes, zero garbage files.
+- **Target App Window Isolation**: Selectively captures and streams ONLY the active application window the agent is working in (e.g., Chrome) instead of leaking the entire desktop.
+- **Continuous Sky-Blue Aura HUD**: A pulsing `#00e5ff` HUD border and corner brackets play continuously throughout the live screen sharing session.
+- **Nemotron & DeepSeek Fallback Tool-Calling**: Smart JSON prompt formatting and fallback parser so models lacking native function-calling can reliably trigger tools, desktop automation, and scratchpad updates.
 - **Extended 90s LLM Timeout**: Boosted NVIDIA NIM client timeout from 35s to 90s to accommodate complex multi-step reasoning models without early cutoff.
 - **Instant Timeout Failover**: Added timeout detection (`ETIMEDOUT`, `ECONNABORTED`, `408`, `AbortError`) to trigger immediate model fallback instead of burning retries.
 - **Desktop Takeover & Scratchpad Tasks**: Enhanced cross-platform cursor positioning, mouse clicking, keystroke injection, and external app automation.
-- **Zero-Screenshot Privacy Architecture**: Permanently eliminates desktop screenshot captures and vision latency for 100% desktop privacy and instant action execution.
-- **Scratchpad Working Memory**: Dynamic step checklists and notes in `.ft/scratchpad.md` synchronized across agent loops.
 
 ---
 

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["agent.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACvB;AAKD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,QAKpD;AAED,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAO/C;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsDlE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3E;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC/E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA2F5F;AAED,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,SAAS,EAAE,MAAM,EAAE,GACpB,MAAM,EAAE,CAgGV;AAED,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAoFxF;AAED,wBAAsB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,iBAmkC3E"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["agent.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACvB;AAKD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,QAKpD;AAED,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAO/C;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsDlE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3E;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC/E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA2F5F;AAED,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,SAAS,EAAE,MAAM,EAAE,GACpB,MAAM,EAAE,CAgGV;AAED,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAuLxF;AAED,wBAAsB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,iBA2lC3E"}

package/bin/src/commands/agent.js

@@ -14,6 +14,7 @@ import { handleUndo } from './undo.js';
 import { AgentExecutionLoop, buildDirectoryTree, AGENT_TOOLS } from '../engine/agentEngine.js';
 import { verifyAndSelfHealFiles, executeSmartCommand, runProjectVerification } from '../engine/verifier.js';
 import { speakText, listenSpeechToText, promptInteractionMode } from '../engine/voiceEngine.js';
+import { startLiveScreenShare, stopLiveScreenShare, isLiveScreenShareActive } from '../engine/liveScreenEngine.js';
 import { exec } from 'child_process';
 import { promisify } from 'util';
 const execAsync = promisify(exec);
@@ -247,6 +248,7 @@ export async function getAgentGoalInput(placeholderStr) {
     }
     return new Promise((resolve) => {
         let buffer = '';
+        let cursorIndex = 0;
         let isDone = false;
         const rl = readline.createInterface({
             input: process.stdin,
@@ -256,7 +258,15 @@ export async function getAgentGoalInput(placeholderStr) {
         if (process.stdin.setRawMode) {
             process.stdin.setRawMode(true);
         }
-        process.stdout.write(`\n${chalk.cyan('◇')}  ${chalk.bold('Agent Prompt:')}\n${chalk.cyan('│')}  `);
+        const prefix = `${chalk.cyan('│')}  `;
+        const prefixVisibleLen = 3;
+        process.stdout.write(`\n${chalk.cyan('◇')}  ${chalk.bold('Agent Prompt:')}\n${prefix}`);
+        const renderLine = () => {
+            readline.cursorTo(process.stdout, 0);
+            readline.clearLine(process.stdout, 0);
+            process.stdout.write(prefix + buffer);
+            readline.cursorTo(process.stdout, prefixVisibleLen + cursorIndex);
+        };
         const cleanup = () => {
             process.stdin.removeListener('keypress', onKeypress);
             if (process.stdin.setRawMode) {
@@ -281,7 +291,7 @@ export async function getAgentGoalInput(placeholderStr) {
                 cleanup();
                 readline.cursorTo(process.stdout, 0);
                 readline.clearLine(process.stdout, 0);
-                process.stdout.write(`${chalk.cyan('│')}  /\n`);
+                process.stdout.write(`${prefix}/\n`);
                 resolve('/');
                 return;
             }
@@ -293,19 +303,106 @@ export async function getAgentGoalInput(placeholderStr) {
                 resolve(buffer.trim());
                 return;
             }
+            // Left Arrow Navigation
+            if (key && key.name === 'left') {
+                if (key.ctrl || key.meta) {
+                    let newPos = cursorIndex;
+                    while (newPos > 0 && buffer[newPos - 1] === ' ')
+                        newPos--;
+                    while (newPos > 0 && buffer[newPos - 1] !== ' ')
+                        newPos--;
+                    cursorIndex = newPos;
+                }
+                else if (cursorIndex > 0) {
+                    cursorIndex--;
+                }
+                renderLine();
+                return;
+            }
+            // Right Arrow Navigation
+            if (key && key.name === 'right') {
+                if (key.ctrl || key.meta) {
+                    let newPos = cursorIndex;
+                    while (newPos < buffer.length && buffer[newPos] === ' ')
+                        newPos++;
+                    while (newPos < buffer.length && buffer[newPos] !== ' ')
+                        newPos++;
+                    cursorIndex = newPos;
+                }
+                else if (cursorIndex < buffer.length) {
+                    cursorIndex++;
+                }
+                renderLine();
+                return;
+            }
+            // Home / Ctrl+A
+            if ((key && key.name === 'home') || (key && key.ctrl && key.name === 'a')) {
+                cursorIndex = 0;
+                renderLine();
+                return;
+            }
+            // End / Ctrl+E
+            if ((key && key.name === 'end') || (key && key.ctrl && key.name === 'e')) {
+                cursorIndex = buffer.length;
+                renderLine();
+                return;
+            }
+            // Up / Down arrow keys (ignore to prevent terminal escape sequences from polluting buffer)
+            if (key && (key.name === 'up' || key.name === 'down')) {
+                return;
+            }
+            // Clear to start (Ctrl+U)
+            if (key && key.ctrl && key.name === 'u') {
+                buffer = buffer.slice(cursorIndex);
+                cursorIndex = 0;
+                renderLine();
+                return;
+            }
+            // Clear to end (Ctrl+K)
+            if (key && key.ctrl && key.name === 'k') {
+                buffer = buffer.slice(0, cursorIndex);
+                renderLine();
+                return;
+            }
+            // Delete word left (Ctrl+W)
+            if (key && key.ctrl && key.name === 'w') {
+                let newPos = cursorIndex;
+                while (newPos > 0 && buffer[newPos - 1] === ' ')
+                    newPos--;
+                while (newPos > 0 && buffer[newPos - 1] !== ' ')
+                    newPos--;
+                buffer = buffer.slice(0, newPos) + buffer.slice(cursorIndex);
+                cursorIndex = newPos;
+                renderLine();
+                return;
+            }
+            // Backspace
             const isBackspace = (key && key.name === 'backspace') || str === '\b' || str === '\x7f';
             if (isBackspace) {
-                if (buffer.length > 0) {
-                    buffer = buffer.slice(0, -1);
-                    readline.cursorTo(process.stdout, 0);
-                    readline.clearLine(process.stdout, 0);
-                    process.stdout.write(`${chalk.cyan('│')}  ${buffer}`);
+                if (cursorIndex > 0) {
+                    buffer = buffer.slice(0, cursorIndex - 1) + buffer.slice(cursorIndex);
+                    cursorIndex--;
+                    renderLine();
                 }
                 return;
             }
+            // Delete (Forward delete)
+            if (key && key.name === 'delete') {
+                if (cursorIndex < buffer.length) {
+                    buffer = buffer.slice(0, cursorIndex) + buffer.slice(cursorIndex + 1);
+                    renderLine();
+                }
+                return;
+            }
+            // Regular character insertion
             if (str && !key?.ctrl && !key?.meta && key?.name !== 'escape' && !isEnter && !isBackspace) {
-                buffer += str;
-                process.stdout.write(str);
+                const cleanStr = str.replace(/[\r\n]/g, '');
+                if (cleanStr.length > 0) {
+                    buffer = buffer.slice(0, cursorIndex) + cleanStr + buffer.slice(cursorIndex);
+                    cursorIndex += cleanStr.length;
+                    renderLine();
+                }
+                return;
             }
         };
         process.stdin.on('keypress', onKeypress);
@@ -345,36 +442,43 @@ export async function handleAgent(goalInput, options) {
     const projectName = existingContext?.projectName || path.basename(cwd) || 'Codebase';
     let initialGoal = goalInput || options?.goal;
     let isFirstRun = true;
+    let isAudioMode = options?.voice;
+    let isScreenShareMode = options?.screenShare;
+    if (isAudioMode === undefined && isScreenShareMode === undefined && !initialGoal && process.stdout.isTTY) {
+        const selectedMode = await promptInteractionMode();
+        isAudioMode = selectedMode === 'audio';
+        isScreenShareMode = selectedMode === 'screen_share';
+    }
+    if (isScreenShareMode) {
+        await startLiveScreenShare();
+    }
     const agentLoop = new AgentExecutionLoop({
         autoApprove: options?.yes,
         maxSteps: options?.steps || options?.maxSteps || 30,
         language: targetLang,
         projectName,
+        screenShare: isScreenShareMode,
     });
     const modelInfo = getActiveModelInfo();
     const fallbackPipeline = modelInfo.fallbackChain.slice(1).join(' ➔ ');
-    let isAudioMode = options?.voice;
-    if (isAudioMode === undefined && !initialGoal && process.stdout.isTTY) {
-        const selectedMode = await promptInteractionMode();
-        isAudioMode = selectedMode === 'audio';
-    }
     const welcomeBanner = `
-${chalk.bold.cyan('Scout Autonomous AI Agent')} ${targetLang ? `(${targetLang})` : ''} [${isAudioMode ? ' Audio Mode' : ' Text Mode'}]
+${chalk.bold.cyan('Scout Autonomous AI Agent')} ${targetLang ? `(${targetLang})` : ''} [${isScreenShareMode ? 'Live Screen Share Mode' : isAudioMode ? '🎤 Audio Mode' : '📝 Text Mode'}]
 ${chalk.bold('Active Model:')} ${chalk.bold.green(modelInfo.currentActiveModel)}
 ${chalk.bold('Fallback Pipeline:')} ${chalk.dim(fallbackPipeline)}
 
 ${chalk.dim('Type your goal, or use slash commands:')}
-${chalk.cyan('/help')}    - Show agent tools & commands (${AGENT_TOOLS.length} tools)
-${chalk.cyan('/tree')}    - View workspace directory tree
-${chalk.cyan('/stats')}   - View real-time session & model telemetry
-${chalk.cyan('/test')}    - Run automated project test suite
-${chalk.cyan('/diff')}    - Show git diff of uncommitted changes
-${chalk.cyan('/export')}  - Save session report to .ft/
-${chalk.cyan('/undo')}    - Revert last file modifications
-${chalk.cyan('/clear')}   - Reset conversation context
-${chalk.cyan('/scan')}    - Run vulnerability scan
-${chalk.cyan('/plan')}    - Generate implementation roadmap
-${chalk.cyan('/exit')}    - Exit session
+${chalk.cyan('/help')}        - Show agent tools & commands (${AGENT_TOOLS.length} tools)
+${chalk.cyan('/screenshare')} - Toggle real-time live screen share stream with model
+${chalk.cyan('/tree')}        - View workspace directory tree
+${chalk.cyan('/stats')}       - View real-time session & model telemetry
+${chalk.cyan('/test')}        - Run automated project test suite
+${chalk.cyan('/diff')}        - Show git diff of uncommitted changes
+${chalk.cyan('/export')}      - Save session report to .ft/
+${chalk.cyan('/undo')}        - Revert last file modifications
+${chalk.cyan('/clear')}       - Reset conversation context
+${chalk.cyan('/scan')}        - Run vulnerability scan
+${chalk.cyan('/plan')}        - Generate implementation roadmap
+${chalk.cyan('/exit')}        - Exit session
 `.trim();
     safeNote(welcomeBanner, 'Scout Agent Active Session');
     while (true) {
@@ -409,7 +513,8 @@ ${chalk.cyan('/exit')}    - Exit session
             const KNOWN_SLASH_COMMANDS = [
                 '/help', '/tree', '/status', '/stats', '/test', '/explain',
                 '/export', '/save-session', '/diff', '/clear', '/compact',
-                '/undo', '/history', '/scan', '/plan', '/scratchpad', '/voice', '/speak', '/exit', '/quit'
+                '/undo', '/history', '/scan', '/plan', '/scratchpad', '/voice', '/speak',
+                '/screenshare', '/livescreen', '/live', '/exit', '/quit'
             ];
             if (trimmedInput.startsWith('/')) {
                 const cmdName = trimmedInput.split(/\s+/)[0].toLowerCase();
@@ -417,6 +522,7 @@ ${chalk.cyan('/exit')}    - Exit session
                     const filterStr = trimmedInput.toLowerCase();
                     let availableOptions = [
                         { value: '/help', label: '/help', hint: 'Show agent tools & commands guide' },
+                        { value: '/screenshare', label: '/screenshare', hint: 'Toggle real-time live screen share stream with model' },
                         { value: '/voice', label: '/voice', hint: 'Activate microphone STT speech input' },
                         { value: '/speak', label: '/speak', hint: 'Speak text out loud via TTS' },
                         { value: '/scratchpad', label: '/scratchpad', hint: 'View current agent working memory & plan (.ft/scratchpad.md)' },
@@ -511,6 +617,7 @@ ${chalk.cyan('/exit')}    - Exit session
 
 ### 🚀 Interactive Slash Commands
 - \`/help\`: Show this tools & commands guide.
+- \`/screenshare\` or \`/live\`: Toggle real-time live screen share stream with model.
 - \`/tree [dir]\`: Display workspace directory tree structure.
 - \`/status\` or \`/stats\`: Show session telemetry & statistics.
 - \`/test [cmd]\`: Run project verification test suite.
@@ -529,6 +636,19 @@ ${chalk.cyan('/exit')}    - Exit session
                 safeNote(renderMarkdown(helpText), ' Scout Slash Commands & Tools');
                 continue;
             }
+            if (trimmedInput.toLowerCase() === '/screenshare' || trimmedInput.toLowerCase() === '/livescreen' || trimmedInput.toLowerCase() === '/live') {
+                if (isLiveScreenShareActive()) {
+                    const stopRes = stopLiveScreenShare();
+                    isScreenShareMode = false;
+                    safeNote(chalk.yellow(stopRes.summary), ' Live Screen Share Stopped');
+                }
+                else {
+                    const startRes = await startLiveScreenShare();
+                    isScreenShareMode = true;
+                    safeNote(chalk.green(startRes.message), ' Live Screen Share Active');
+                }
+                continue;
+            }
             if (trimmedInput.toLowerCase().startsWith('/speak')) {
                 const phrase = trimmedInput.slice(6).trim();
                 if (phrase) {