fluxflow-cli 3.19.3 → 3.20.0

package/README.md

@@ -1,138 +1,139 @@
-# 🌌 Flux Flow (`fluxflow-cli`)
-![Flux Flow Logo](https://github.com/KushalRoyChowdhury/fluxflow-cli/blob/main/fluxflow.png)
-
-<p align="left">
-  <a href="https://github.com/KushalRoyChowdhury/fluxflow-cli"><img src="https://img.shields.io/badge/FluxFlow-v3-blue?style=plastic" alt="FluxFlow Version"></a>
-  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=plastic" alt="License MIT"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-%3E%3D20-green?style=plastic" alt="Node Compatibility"></a>
-</p>
-
-### *The High-Fidelity Agentic CLI with Sub-Agents for the Flux Era.*
-
-📖 **[Official Documentation](https://fluxflow-cli.onrender.com/)**
-
-**Flux Flow** is not just another CLI—it's a high-speed, sassy, and goal-oriented CLI AI Agent powered by multi-provider frontier models (Google Gemini, DeepSeek, OpenRouter, and more). Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.
-
----
-
-## 🚀 Instant Ignition (No Setup Required)
-You don't even need to install it. Just fire up your terminal and run:
-
-```bash
-# Run instantly (Zero Setup)
-npx fluxflow-cli
-
-# OR Install Globally
-npm install -g fluxflow-cli
-fluxflow-cli
-```
-
-*The agent will prompt you for your API Key on the first run and store it securely in an encrypted vault.* Choose from multiple supported AI providers:
-- **Multi-Provider Support**: Choose your preferred engine!
-  - **Google GenAI** (Gemini & Gemma models)
-  - **DeepSeek** (Deepseek v4 Models)
-  - **NVIDIA** (Access to open models)
-  - **Ollama** (Local Models / Ollama Cloud Models)
-  - **Mistral** (Access to selected models; *Experimental*)
-  - **OpenRouter** (Access to hundreds of models; *Experimental*)
-
----
-
-## ✨ Why Flux Flow?
-
-### 🎨 **Premium Visual Sovereignty**
-Experience a terminal UI that feels alive. Built with **Ink** and **React**, Flux Flow features:
-- **Dynamic Status Bar**: Real-time telemetry showing your "Neural Headroom" (token usage), Thinking Level, and Session ID.
-
-### 🔌 **High-Fidelity IDE Companion**
-Flux Flow now pairs with a dedicated VS Code extension to bridge the gap between terminal and editor:
-- **Surgical Diagnostic Sync**: Proactive background scanning for errors. If your project breaks, a "Magic Wand" icon $(\text{sparkle})$ appears in your editor title bar for an instant AI fix.
-- **Live Status Heartbeat**: The VS Code Status Bar acts as a live feed, showing the agent's current task (*Thinking*, *Web Searching*, *Patching*, etc.).
-- **Clickable Terminal Links**: Jump from the terminal output straight to your code with clickable file:line links.
-- **Right-Click Integration**: "FluxFlow > Chat" is available in the editor, explorer, and tab bars, even when no files are open.
-- **Selection-Driven Reasoning**: Select a block of code and ask "What does this do?"—the agent receives your selection instantly.
-- **Universal Compatibility**: Works flawlessly with VS Code, Cursor, VSCodium, Trae, and Antigravity.
-
-### 👁️ **Native Multimodality**
-Flux Flow can now see! Use the `view_file` tool to analyze images (JPG, PNG) or deep-dive into PDF technical papers. The agent extracts high-fidelity visual context natively, making it a true multimodal companion.
-
-### 📑 **Document Engineering Suite**
-Need a report or a presentation? Just ask. Flux Flow features a high-fidelity "Printing Press" that generates professional, branded documents natively:
-- **PDF**: Branded documents from HTML/CSS with automatic watermarking.
-- **DOCX**: Native Word documents with multi-page support and automatic numbering.
-
-### ⏱️ **Codebase Time Travel (Git-less Reversion)**
-Refactor and build with absolute fearlessness. Flux Flow maintains transaction-based secure snapshots of files before they are generated or edited:
-- **Instant Rollback**: Revert your workspace files (source code, generated documents, images) to their exact state prior to any selected prompt in the history.
-- **Double-ESC Shortcut**: Press `ESC` twice while idle to pop open a sleek selection modal.
-- **`/revert` Command**: Run the `/revert` command directly in the chat to open the checkpoint viewer.
-
-### 🚑 **Self-Healing Infrastructure**
-Zero setup means zero setup. On first run, Flux Flow performs an integrity check and autonomously installs its own Chromium engine if needed, ensuring features like PDF generation work 100% of the time without manual intervention.
-
-- **Archived Terminal Flow**: See execution outputs transform from live elements into permanent conversation records.
-- **Rich Aesthetics**: High-contrast, sleek design with smooth transitions and micro-animations.
-
-### 🧠 **The Dual-Intelligence System**
-- **Flux Mode (Dev)**: High-speed, agentic problem solving for massive coding tasks.
-- **Flow Mode (Chat)**: Optimized for high-quality conversation and web-assisted reasoning.
-
-### 🛡️ **Digital Fortress Governance**
-Security isn't an afterthought; it's a boundary.
-- **Sandbox Presets**: Choose from **Strict**, **Balanced**, **Autonomous**, or **Custom** security profiles to control agent autonomy.
-- **Granular Command Policies**: Configure Auto-Approve (`Auto` / `Read-Only` / `None`), Auto-Disallow (`Auto` / `Destructive` / `None`), Network Access toggle, and Auto-Approve Git Commits independently.
-- **External Path Hardlock**: Restricts the agent to your Current Working Directory (CWD) unless you explicitly unlock it.
-- **Human-in-the-Loop (HITL)**: Every file write and terminal command requires your high-fidelity approval.
-
-### 🧹 **The Background Janitor**
-While you move at high speed, the Janitor follows behind—refining session titles, compressing data, and ensuring your context window remains at absolute peak performance.
-
-### 🤖 **Autonomous Subagent System**
-Delegate complex tasks to subagents. Spawns blocking subagents (`invokeSync`) or asynchronous background subagents (`invoke`) with distinct telemetry and silent background logging. Built-in transaction-safe reversion logs all subagent changes under the active turn, preserving rollback security.
-
----
-
-## 🛠️ Key Capabilities
-- **Deep File-System Interaction**: Edit, move, and refactor code across multiple files with atomic precision.
-- **Real-Time Web Intelligence**: Autonomous web-searching via DuckDuckGo for live news and technical research.
-- **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity alignment with your coding standards and custom workflows.
-
-- **Persistent Memory**: The agent learns from your preferences and project requirements across sessions.
-
----
-
-## 💻 CLI Startup Arguments
-Customize your session parameters directly from your console launch command:
-
-```bash
-fluxflow [options]
-```
-
-### Supported Flags:
-- `--model <model-name>`: Temporary override for the active AI model (e.g., `gemini-2.5-pro`). Keeps settings file untouched.
-- `--memory <on | off>`: Toggle persistent long-term agent memory for the session.
-- `--resume <session-id>`: Resume a previous chat session programmatically.
-- `--update <check | latest>`: Manually run an update check (`check`) or execute latest update setup (`latest`).
-- `--package <npm | pnpm | yarn | bun>`: Override default package manager to run core application updates.
-- `--auto-del <1d | 7d | 30d>`: Set automated chat log deletion schedule.
-- `--yolo <on | off>`: Toggle autonomous execution permission.
-- `--external-access <on | off>`: Toggle permission to let agent read files outside CWD.
-- `--thinking <Fast | Low | Medium/Standard | High | xHigh>`: Override thinking level for reasoning depth. `Medium` and `Standard` is the same (Deepseek compatibility).
-- `--key <key@google | key@deepseek | key@openrouter>`: Set API key and provider.
-- `--provider <google | deepseek | openrouter>`: Override default provider.
-
----
-
-## ⚙️ Configuration
-Type `/settings` in-app to live-configure:
-- **Thinking Level**: Fast (No Reasoning), Low, Medium, High, xHigh (Extended Reasoning).
-- **Sandbox Preset**: Strict, Balanced, Autonomous, or Custom security profiles.
-- **Security Perimeter**: Toggle External Workspace access, Network Access, and Git Commit auto-approval.
-
----
-
-## 🏁 License
-MIT © 2026 Flux Flow.
-
----
-*Forged with ⚡ and 🧬. Welcome to the FluxFlow.*
+# 🌌 Flux Flow (`fluxflow-cli`)
+![Flux Flow Logo](https://github.com/KushalRoyChowdhury/fluxflow-cli/blob/main/fluxflow.png)
+
+<p align="left">
+  <a href="https://github.com/KushalRoyChowdhury/fluxflow-cli"><img src="https://img.shields.io/badge/FluxFlow-v3-blue?style=plastic" alt="FluxFlow Version"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=plastic" alt="License MIT"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-%3E%3D20-green?style=plastic" alt="Node Compatibility"></a>
+</p>
+
+### *The High-Fidelity Agentic CLI with Sub-Agents for the Flux Era.*
+
+📖 **[Official Documentation](https://fluxflow-cli.onrender.com/)**
+
+**Flux Flow** is not just another CLI—it's a high-speed, sassy, and goal-oriented CLI AI Agent powered by multi-provider frontier models (Google Gemini, DeepSeek, OpenRouter, and more). Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.
+
+---
+
+## 🚀 Instant Ignition (No Setup Required)
+You don't even need to install it. Just fire up your terminal and run:
+
+```bash
+# Run instantly (Zero Setup)
+npx fluxflow-cli
+
+# OR Install Globally
+npm install -g fluxflow-cli
+fluxflow-cli
+```
+
+*The agent will prompt you for your API Key on the first run and store it securely in an encrypted vault.*
+
+- **Multi-Provider Support**: Choose your preferred engine!
+  - **Google GenAI** (Gemini & Gemma models)
+  - **DeepSeek** (Deepseek v4 Models)
+  - **NVIDIA** (Access to open models)
+  - **Ollama** (Local Models / Ollama Cloud Models)
+  - **Mistral** (Access to selected models; *Experimental*)
+  - **OpenRouter** (Access to hundreds of models; *Experimental*)
+
+---
+
+## ✨ Why Flux Flow?
+
+### 🎨 **Premium Visual Sovereignty**
+Experience a terminal UI that feels alive. Built with **Ink** and **React**, Flux Flow features:
+- **Dynamic Status Bar**: Real-time telemetry showing your "Neural Headroom" (token usage), Thinking Level, and Session ID.
+
+### 🔌 **High-Fidelity IDE Companion**
+Flux Flow now pairs with a dedicated VS Code extension to bridge the gap between terminal and editor:
+- **Surgical Diagnostic Sync**: Proactive background scanning for errors. If your project breaks, a "Magic Wand" icon $(\text{sparkle})$ appears in your editor title bar for an instant AI fix.
+- **Live Status Heartbeat**: The VS Code Status Bar acts as a live feed, showing the agent's current task (*Thinking*, *Web Searching*, *Patching*, etc.).
+- **Clickable Terminal Links**: Jump from the terminal output straight to your code with clickable file:line links.
+- **Right-Click Integration**: "FluxFlow > Chat" is available in the editor, explorer, and tab bars, even when no files are open.
+- **Selection-Driven Reasoning**: Select a block of code and ask "What does this do?"—the agent receives your selection instantly.
+- **Universal Compatibility**: Works flawlessly with VS Code, Cursor, VSCodium, Trae, and Antigravity.
+
+### 👁️ **Native Multimodality**
+Flux Flow can now see! Use the `view_file` tool to analyze images (JPG, PNG) or deep-dive into PDF technical papers. The agent extracts high-fidelity visual context natively, making it a true multimodal companion.
+
+### 📑 **Document Engineering Suite**
+Need a report or a presentation? Just ask. Flux Flow features a high-fidelity "Printing Press" that generates professional, branded documents natively:
+- **PDF**: Branded documents from HTML/CSS with automatic watermarking.
+- **DOCX**: Native Word documents with multi-page support and automatic numbering.
+
+### ⏱️ **Codebase Time Travel (Git-less Reversion)**
+Refactor and build with absolute fearlessness. Flux Flow maintains transaction-based secure snapshots of files before they are generated or edited:
+- **Instant Rollback**: Revert your workspace files (source code, generated documents, images) to their exact state prior to any selected prompt in the history.
+- **Double-ESC Shortcut**: Press `ESC` twice while idle to pop open a sleek selection modal.
+- **`/revert` Command**: Run the `/revert` command directly in the chat to open the checkpoint viewer.
+
+### 🚑 **Self-Healing Infrastructure**
+Zero setup means zero setup. On first run, Flux Flow performs an integrity check and autonomously installs its own Chromium engine if needed, ensuring features like PDF generation work 100% of the time without manual intervention.
+
+- **Archived Terminal Flow**: See execution outputs transform from live elements into permanent conversation records.
+- **Rich Aesthetics**: High-contrast, sleek design with smooth transitions and micro-animations.
+
+### 🧠 **The Dual-Intelligence System**
+- **Flux Mode (Dev)**: High-speed, agentic problem solving for massive coding tasks.
+- **Flow Mode (Chat)**: Optimized for high-quality conversation and web-assisted reasoning.
+
+### 🛡️ **Digital Fortress Governance**
+Security isn't an afterthought; it's a boundary.
+- **Sandbox Presets**: Choose from **Strict**, **Balanced**, **Autonomous**, or **Custom** security profiles to control agent autonomy.
+- **Granular Command Policies**: Configure Auto-Approve (`Auto` / `Read-Only` / `None`), Auto-Disallow (`Auto` / `Destructive` / `None`), Network Access toggle, and Auto-Approve Git Commits independently.
+- **External Path Hardlock**: Restricts the agent to your Current Working Directory (CWD) unless you explicitly unlock it.
+- **Human-in-the-Loop (HITL)**: Every file write and terminal command requires your high-fidelity approval.
+
+### 🧹 **The Background Janitor**
+While you move at high speed, the Janitor follows behind—refining session titles, compressing data, and ensuring your context window remains at absolute peak performance.
+
+### 🤖 **Autonomous Subagent System**
+Delegate complex tasks to subagents. Spawns blocking subagents (`invokeSync`) or asynchronous background subagents (`invoke`) with distinct telemetry and silent background logging. Built-in transaction-safe reversion logs all subagent changes under the active turn, preserving rollback security.
+
+---
+
+## 🛠️ Key Capabilities
+- **Deep File-System Interaction**: Edit, move, and refactor code across multiple files with atomic precision.
+- **Real-Time Web Intelligence**: Autonomous web-searching via DuckDuckGo for live news and technical research.
+- **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity alignment with your coding standards and custom workflows.
+
+- **Persistent Memory**: The agent learns from your preferences and project requirements across sessions.
+
+---
+
+## 💻 CLI Startup Arguments
+Customize your session parameters directly from your console launch command:
+
+```bash
+fluxflow [options]
+```
+
+### Supported Flags:
+- `--model <model-name>`: Temporary override for the active AI model (e.g., `gemini-2.5-pro`). Keeps settings file untouched.
+- `--memory <on | off>`: Toggle persistent long-term agent memory for the session.
+- `--resume <session-id>`: Resume a previous chat session programmatically.
+- `--update <check | latest>`: Manually run an update check (`check`) or execute latest update setup (`latest`).
+- `--package <npm | pnpm | yarn | bun>`: Override default package manager to run core application updates.
+- `--auto-del <1d | 7d | 30d>`: Set automated chat log deletion schedule.
+- `--yolo <on | off>`: Toggle autonomous execution permission.
+- `--external-access <on | off>`: Toggle permission to let agent read files outside CWD.
+- `--thinking <Fast | Low | Medium/Standard | High | xHigh>`: Override thinking level for reasoning depth. `Medium` and `Standard` is the same (Deepseek compatibility).
+- `--key <key@google | key@deepseek | key@openrouter>`: Set API key and provider.
+- `--provider <google | deepseek | openrouter>`: Override default provider.
+
+---
+
+## ⚙️ Configuration
+Type `/settings` in-app to live-configure:
+- **Thinking Level**: Fast (No Reasoning), Low, Medium, High, xHigh (Extended Reasoning).
+- **Sandbox Preset**: Strict, Balanced, Autonomous, or Custom security profiles.
+- **Security Perimeter**: Toggle External Workspace access, Network Access, and Git Commit auto-approval.
+
+---
+
+## 🏁 License
+MIT © 2026 Flux Flow.
+
+---
+*Forged with ⚡ and 🧬. Welcome to the FluxFlow.*

package/dist/fluxflow.js

@@ -795,7 +795,8 @@ var init_settings = __esm({
         SubAgentProvider: "",
         dynamicDirAwareness: false,
         indentationTree: true,
-        ollamaEndpoint: "Cloud"
+        ollamaEndpoint: "Cloud",
+        compressToolResults: false
       },
       profileData: {
         name: null,
@@ -2936,7 +2937,7 @@ var init_text = __esm({
       }
       return { content: finalContent, results };
     };
-    generateHighFidelityDiff = (originalContent, finalContent, patchResults, threshold = 8) => {
+    generateHighFidelityDiff = (originalContent, finalContent, patchResults, threshold = 8, compressToolResults = false) => {
       if (!patchResults || patchResults.length === 0) return "";
       const allLinesOriginal = originalContent.split(/\r?\n/);
       const allLinesFinal = finalContent.split(/\r?\n/);
@@ -3040,6 +3041,24 @@ var init_text = __esm({
           currentFinalLineIdx++;
         }
       }
+      if (compressToolResults) {
+        const header = `[DIFF_START]
+`;
+        const body = diffText.substring(header.length);
+        const sep = `[UI_CONTEXT] ${separatorLine}
+`;
+        const blocks = body.split(sep);
+        const processedBlocks = blocks.map((block) => {
+          const lines = block.split("\n").filter((l) => l.trim() !== "");
+          if (lines.length > 45) {
+            return `[[VERIFIED]]
+${block}
+[[/VERIFIED]]`;
+          }
+          return block;
+        });
+        diffText = header + processedBlocks.join(sep);
+      }
       diffText += `[DIFF_END]`;
       return flattenString(diffText);
     };
@@ -7012,7 +7031,7 @@ ${mode === "Flux" ? `- JSON ESCAPE ALL LITERAL ESCAPE SEQUENCES IN TOOL ARGUMENT
 ${mode === "Flux" ? `- WORKSPACE TOOLS (path = relative; FIRST ARGUMENT, path separator: '/') -
 - [tool:functions.ReadFile(path="...", startLine="integer", endLine="integer")]. ${aiProvider !== "Google" ? `${isMultiModal ? `Supports images/docs` : ""}` : `Supports images/docs`}
 - [tool:functions.ReadFolder(path="...", recurse="integer 1-3 optional, default: 1")]. DIR Contents + File Size. Minimize recursion
-- [tool:functions.PatchFile(path="...", allowMultiple="bool optional, default: false", searchContent1="string OR ^LINE:start..end$", newContent1="...", ...MAX15)]. TARGET MINIMAL DIFF. Line Ranges "^LINE:start..end$" MUST for multi-line selection or escape sequences. Verify diffs
+- [tool:functions.PatchFile(path="...", allowMultiple="bool optional, default: false", searchContent1="search string OR ^LINE:start..end$", newContent1="...", ...MAX15)]. Line Range MUST for large blocks AND escape sequences. ^...$ MUST for line ranges. Verify diffs
 - [tool:functions.WriteFile(path="...", content="...")]. Creates/Overwrites. File Exist? PatchFile > WriteFile
 - [tool:functions.SearchKeyword(keyword="...", path="optional, dir/file/glob/regex", fuzzy="bool optional, default: false", regex="bool optional, default: auto")]. path scopes search. Find definitions, logic, relevant code
 - [tool:functions.Run(command="...")]. Runs ${osDetected === "Windows" ? isPsAvailable() ? `POWERSHELL` : `WINDOWS CMD` : `BASH`} command. Destructive/Irreversible ops \u2192 Ask user
@@ -7917,7 +7936,8 @@ function SettingsMenu({
           { label: "Sub-Agent Model", value: "subAgentModel", status: systemSettings2.CustomSubAgent && systemSettings2.SubAgentModel ? systemSettings2.SubAgentModel : "Default" },
           { label: "Preserve Thinking", value: "preserveThinking", status: systemSettings2.preserveThinking !== false ? "ON" : "OFF" },
           { label: "Dynamic Directory Awareness", value: "dynamicDirAwareness", status: systemSettings2.dynamicDirAwareness ? "ON" : "OFF" },
-          { label: "Directory Tree Design", value: "indentationTree", status: systemSettings2.indentationTree !== false ? "Modern" : "Classic (deprecated)" }
+          { label: "Directory Tree Design", value: "indentationTree", status: systemSettings2.indentationTree !== false ? "Modern" : "Classic (deprecated)" },
+          { label: "Compact Large Tool Results", value: "compressToolResults", status: systemSettings2.compressToolResults ? "ON" : "OFF" }
           // { label: 'Download Language Parsers', value: 'parserDownload', status: 'ACTION' } // Dont remove this comment
         ];
       default:
@@ -8178,6 +8198,12 @@ function SettingsMenu({
         saveSettings2({ systemSettings: newSysSettings, apiTier, quotas });
         return newSysSettings;
       });
+    } else if (item.value === "compressToolResults") {
+      setSystemSettings((s) => {
+        const newSysSettings = { ...s, compressToolResults: !s.compressToolResults };
+        saveSettings2({ systemSettings: newSysSettings, apiTier, quotas });
+        return newSysSettings;
+      });
     } else if (item.value === "subAgents") {
       setSystemSettings((s) => {
         const newSysSettings = { ...s, subAgents: s.subAgents === false ? true : false };
@@ -11897,6 +11923,7 @@ var init_write_file = __esm({
   "src/tools/write_file.js"() {
     init_arg_parser();
     init_revert();
+    init_settings();
     write_file = async (args, context = {}) => {
       let { path: targetPath, content } = parseArgs(args);
       if (!targetPath) return 'ERROR: Missing "path" argument for write_file.';
@@ -11936,7 +11963,7 @@ ${lines.map((l, i) => `${i + 1} | ${l}`).join("\n")}
         const verifiedLineCount = verifiedLines.length;
         if (verifiedSize === 0 && originalSize > 0) {
           verifiedContent = null;
-          return `ERROR: CRITICAL FAILURE: Verification failed. File [${targetPath}] is empty on disk despite success report!`;
+          return `ERROR: CRITICAL FAILURE: Verification failed. File [${targetPath}] is empty on disk!`;
         }
         let snippet = "";
         if (verifiedLineCount <= 100) {
@@ -11951,11 +11978,22 @@ ${lines.map((l, i) => `${i + 1} | ${l}`).join("\n")}
 ${tail}`;
         }
         verifiedContent = null;
-        return `SUCCESS: File [${targetPath}] saved.
+        const { systemSettings: systemSettings2 } = await loadSettings();
+        let resultString = `SUCCESS: File [${targetPath}] saved.
 - Stats: [${verifiedLineCount} lines, ${(verifiedSize / 1024).toFixed(1)} KB]
 ${ancestry}- Content Preview:
 
 ${snippet}`;
+        if (systemSettings2?.compressToolResults && verifiedLineCount > 60) {
+          const contentLines = finalContent.split(/\r?\n/);
+          const headMatches = contentLines.slice(0, 25).join("\n") === verifiedLines.slice(0, 25).join("\n");
+          const tailMatches = contentLines.slice(-25).join("\n") === verifiedLines.slice(-25).join("\n");
+          if (headMatches && tailMatches) {
+            resultString = `[[SAME]]
+${resultString}`;
+          }
+        }
+        return resultString;
       } catch (err) {
         const errorMsg = err instanceof Error ? err.message : String(err);
         return `ERROR: Failed to write file [${targetPath}]: ${errorMsg}`;
@@ -11973,6 +12011,7 @@ var init_update_file = __esm({
     init_arg_parser();
     init_revert();
     init_text();
+    init_settings();
     update_file = async (args, context = {}) => {
       const parsed = parseArgs(args);
       const targetPath = parsed.path;
@@ -12000,7 +12039,8 @@ ${failures.map((f) => `  \u2022 ${f.error}`).join("\n")}`;
         }
         await RevertManager.recordFileChange(absolutePath, originalContent);
         fs16.writeFileSync(absolutePath, finalContent, "utf8");
-        const diffText = generateHighFidelityDiff(originalContent, finalContent, results, 12);
+        const { systemSettings: systemSettings2 } = await loadSettings();
+        const diffText = generateHighFidelityDiff(originalContent, finalContent, results, 12, systemSettings2?.compressToolResults);
         if (failures.length > 0) {
           return `SUCCESS: File [${targetPath}] updated with some blocks failed. [${successes.length}/${patchPairs.length}] blocks applied.
 
@@ -15113,7 +15153,7 @@ import dotenv from "dotenv";
 import { GoogleGenAI, ThinkingLevel, HarmBlockThreshold, HarmCategory } from "@google/genai";
 import path26, { normalize } from "path";
 import fs28 from "fs";
-var RE_STUTTER_CODE_BLOCK_CLOSED, RE_STUTTER_CODE_BLOCK_OPEN, RE_STUTTER_INLINE_CODE, RE_STUTTER_TABLE_ROW, RE_STUTTER_WORD_BOUNDARY, RE_STUTTER_NON_ALNUM, RE_TOOL_CALL_FUNC, RE_TOOL_CALL_ANY, RE_TOOL_PARTIAL_ARGS_FALLBACK, RE_STRIP_QUOTES, RE_BACKSLASH_SLASH, RE_STRIP_THINK_CLOSED, RE_STRIP_THINK_OPEN, RE_STRIP_THINK_SIMPLE, RE_STRIP_THINK_FULL, RE_BACKTICK_SPAN, RE_BACKTICK_OPEN, RE_KIMI_TOOL_CALL, RE_KIMI_JSON_PAIR, RE_KIMI_SECTION_BEGIN, RE_KIMI_SECTION_END, client, globalSettings, systemInstructionCache, colorMainWords, withRetry, TERMINATION_SIGNAL, getCleanGroupedLength, stripAnsi2, fetchWithBackoff, getDeepSeekStream, getMistralStream, getNVIDIAStream, wrapNvidiaStreamWithQueueDepth, getOpenRouterStream, getOllamaStream, signalTermination, isTerminationSignaled, TOOL_LABELS2, getToolDetail, getGoogleClient, runJanitorTask, getActiveToolContext, getContextSafeText, contextSafeReplace, getSanitizedText, translateKimiToolCalls, REGEX_PLACEHOLDER_ARG, REGEX_PLACEHOLDER_VAL, isPlaceholderVal, detectToolCalls, initAI, generateSimpleContent, consolidatePastMemories, compressHistory, deleteChatSummary, getAIStream, runSubagent;
+var RE_STUTTER_CODE_BLOCK_CLOSED, RE_STUTTER_CODE_BLOCK_OPEN, RE_STUTTER_INLINE_CODE, RE_STUTTER_TABLE_ROW, RE_STUTTER_WORD_BOUNDARY, RE_STUTTER_NON_ALNUM, RE_TOOL_CALL_FUNC, RE_TOOL_CALL_ANY, RE_TOOL_PARTIAL_ARGS_FALLBACK, RE_STRIP_QUOTES, RE_BACKSLASH_SLASH, RE_STRIP_THINK_CLOSED, RE_STRIP_THINK_OPEN, RE_STRIP_THINK_SIMPLE, RE_STRIP_THINK_FULL, RE_BACKTICK_SPAN, RE_BACKTICK_OPEN, RE_KIMI_TOOL_CALL, RE_KIMI_JSON_PAIR, RE_KIMI_SECTION_BEGIN, RE_KIMI_SECTION_END, RE_TOOL_WRAPPER_CODE_FENCE, RE_XML_TAG_OPEN, RE_XML_TAG_CLOSE, client, globalSettings, systemInstructionCache, colorMainWords, withRetry, TERMINATION_SIGNAL, getCleanGroupedLength, stripAnsi2, fetchWithBackoff, getDeepSeekStream, getMistralStream, getNVIDIAStream, wrapNvidiaStreamWithQueueDepth, getOpenRouterStream, getOllamaStream, signalTermination, isTerminationSignaled, TOOL_LABELS2, getToolDetail, getGoogleClient, runJanitorTask, getActiveToolContext, getContextSafeText, contextSafeReplace, getSanitizedText, translateKimiToolCalls, REGEX_PLACEHOLDER_ARG, REGEX_PLACEHOLDER_VAL, isPlaceholderVal, detectToolCalls, initAI, generateSimpleContent, consolidatePastMemories, compressHistory, deleteChatSummary, getAIStream, runSubagent;
 var init_ai = __esm({
   async "src/utils/ai.js"() {
     init_dist();
@@ -15160,6 +15200,9 @@ var init_ai = __esm({
     RE_KIMI_JSON_PAIR = /"([^"]+)"\s*:\s*(?:"([^"]*)"|(\d+)|true|false|null)/g;
     RE_KIMI_SECTION_BEGIN = /<\|\s*tool_calls_section_begin\s*\|>/gi;
     RE_KIMI_SECTION_END = /<\|\s*tool_calls_section_end\s*\|>/gi;
+    RE_TOOL_WRAPPER_CODE_FENCE = /```(?:tool|yaml|function|json)?\s*\n?([\s\S]*?)\n?\```/gi;
+    RE_XML_TAG_OPEN = /<(\w+)(?:[^>]*)>\r?\n?/gi;
+    RE_XML_TAG_CLOSE = /\r?\n?<\/\w+(?:[^>]*)>/gi;
     client = null;
     globalSettings = {};
     systemInstructionCache = { key: null, value: null };
@@ -17964,7 +18007,7 @@ ${combinedNudge}`;
                 const THINK_OPEN_PH = "___THINK_OPEN_TAG___";
                 const THINK_CLOSE_PH = "___THINK_CLOSE_TAG___";
                 text = text.replace("<think>", THINK_OPEN_PH).replace("</think>", THINK_CLOSE_PH);
-                text = text.replace(/```(?:tool|yaml|function|json)?\s*\n?([\s\S]*?)\n?\```/gi, (match2, inner) => {
+                text = text.replace(RE_TOOL_WRAPPER_CODE_FENCE, (match2, inner) => {
                   if (inner.includes("[tool:")) return inner.trim();
                   return match2;
                 });
@@ -17973,11 +18016,11 @@ ${combinedNudge}`;
                 while (i < text.length) {
                   const toolIdx = text.indexOf("[tool:", i);
                   if (toolIdx === -1) {
-                    result += text.substring(i).replace(/<(\w+)(?:[^>]*)>\r?\n?/gi, "").replace(/\r?\n?<\/\w+(?:[^>]*)>/gi, "");
+                    result += text.substring(i).replace(RE_XML_TAG_OPEN, "").replace(RE_XML_TAG_CLOSE, "");
                     break;
                   }
                   const beforeTool = text.substring(i, toolIdx);
-                  result += beforeTool.replace(/<(\w+)(?:[^>]*)>\r?\n?/gi, "").replace(/\r?\n?<\/\w+(?:[^>]*)>/gi, "");
+                  result += beforeTool.replace(RE_XML_TAG_OPEN, "").replace(RE_XML_TAG_CLOSE, "");
                   const endToolIdx = text.indexOf("]", toolIdx);
                   if (endToolIdx === -1) {
                     result += text.substring(toolIdx);
@@ -19411,7 +19454,7 @@ ${tail}`;
                           }
                           let result2 = "";
                           if (normToolName === "update_file") {
-                            const diffReport = generateHighFidelityDiff(originalContentForReporting, finalContent, patchResults, 12);
+                            const diffReport = generateHighFidelityDiff(originalContentForReporting, finalContent, patchResults, 12, settings?.compressToolResults || globalSettings?.systemSettings?.compressToolResults);
                             result2 = `SUCCESS: File [${filePath}] updated via IDE Companion (May have user edits). [${patchResults.length}/${requestedPatchCount}] blocks applied.
 
 ${diffReport}`;
@@ -19689,10 +19732,25 @@ ${snippet2}`;
                       await incrementUsage("toolFailure");
                       if (settings.onToolResult) settings.onToolResult("failure", normToolName);
                     }
-                    const aiContent = `[TOOL RESULT]: ${(result || "").toString().replaceAll("[UI_CONTEXT]", "")}`;
+                    const rawResult = (result || "").toString().replaceAll("[UI_CONTEXT]", "");
+                    let processedResult = rawResult;
+                    if (processedResult.includes("[[VERIFIED]]")) {
+                      processedResult = processedResult.replace(/\[\[VERIFIED\]\][\s\S]*?\[\[\/VERIFIED\]\]/g, "[SYSTEM NOTE]: Patch Block matched & applied successfully. Large Block omitted to conserve context.\n");
+                    }
+                    let aiContent;
+                    if (processedResult.startsWith("[[SAME]]")) {
+                      const cleanText = processedResult.replace(/^\[\[SAME\]\]\s*\r?\n?/, "");
+                      const lines = cleanText.split(/\r?\n/);
+                      const successLines = lines.filter((l) => l.startsWith("SUCCESS:") || l.trim().startsWith("- Stats:"));
+                      const headerPart = successLines.length > 0 ? successLines.join("\n") : lines.slice(0, 2).join("\n");
+                      aiContent = `[TOOL RESULT]: ${headerPart}
+[SYSTEM NOTE]: Content verified and persisted to disk. Full preview omitted to conserve context.`;
+                    } else {
+                      aiContent = `[TOOL RESULT]: ${processedResult}`;
+                    }
                     toolResults.push({ role: "user", text: aiContent, binaryPart });
                     anyToolExecutedInThisTurn = true;
-                    let uiContent = `[TOOL RESULT]: ${result || ""}`;
+                    let uiContent = `[TOOL RESULT]: ${result.replaceAll("[[VERIFIED]]\n", "").replaceAll("\n[[/VERIFIED]]", "") || ""}`;
                     if (normToolName === "view_file" || normToolName === "web_scrape" || normToolName === "file_map") {
                       uiContent = `[TOOL RESULT]: ${label} (Context Locked for UI Clarity)`;
                     }
@@ -19870,31 +19928,33 @@ ${recoveryText}`
                   }
                   for (let i = waitTime / 1e3; i > 0; i--) {
                     if (TERMINATION_SIGNAL) break;
-                    yield { type: "status", content: `Error Occured. Recovering Stream (${inStreamRetryCount}/${MAX_RETRIES}) [Retrying in ${i}s]...` };
+                    yield { type: "status", content: `Error Occured. Recovering Stream (${inStreamRetryCount}/${MAX_RETRIES}) [Retrying in ${i.toFixed(0)}s]...` };
                     await new Promise((resolve2) => setTimeout(resolve2, 1e3));
                   }
                   yield { type: "status", content: `Error Occured. Recovering Stream...` };
                 } else {
                   throw new Error(`Stream collapsed too many times. (Failed to resolve ${MAX_RETRIES} times)
-Error Log can be found in ${path26.join(LOGS_DIR, "agent", "error.log")}`);
+Error log can be found in \`/export logs\``);
                 }
               } else {
                 if (retryCount <= MAX_RETRIES) {
                   retryCount++;
                   inStreamRetryCount = 1;
                   accumulatedContext = "";
-                  const waitTime = Math.min(1e3 * Math.pow(2, retryCount - 1), 32e3);
+                  const baseWaitTime = Math.min(1e3 * Math.pow(2, retryCount - 1), 32e3);
+                  const jitter = 0.8 + Math.random() * 0.4;
+                  const waitTime = Math.round(baseWaitTime * jitter);
                   isInitialAttempt = true;
                   yield { type: "status", content: `Trying to reach ${modelName} (${retryCount}/${MAX_RETRIES}) [Retrying in ${(waitTime / 1e3).toFixed(0)}s]` };
                   for (let i = waitTime / 1e3; i > 0; i--) {
                     if (TERMINATION_SIGNAL) break;
-                    yield { type: "status", content: `Trying to reach ${modelName} (${retryCount}/${MAX_RETRIES}) [Retrying in ${i}s]` };
+                    yield { type: "status", content: `Trying to reach ${modelName} (${retryCount}/${MAX_RETRIES}) [Retrying in ${i.toFixed(0)}s]` };
                     await new Promise((resolve2) => setTimeout(resolve2, 1e3));
                   }
                   yield { type: "status", content: `Trying to reach ${modelName}` };
                 } else {
                   throw new Error(`Model ${modelName} cannot be reached. (Failed ${MAX_RETRIES} times)
-Error Log can be found in ${path26.join(LOGS_DIR, "agent", "error.log")}`);
+Error log can be found in \`/export logs\``);
                 }
               }
             }
@@ -20140,7 +20200,7 @@ ${isAsync ? `- [tool:functions.AskMain(question="...")]. Communicate with PARENT
 - [tool:functions.SearchKeyword(keyword="...", path="optional, dir/file/glob/regex", fuzzy="bool optional, default: false", regex="bool optional, default: auto")]. path scopes search. Find definitions, logic, relevant code
 - [tool:functions.ReadFolder(path="...", recurse="integer 1-3 optional, default: 1")]. DIR Contents + File Size. Minimize recursion
 - [tool:functions.ReadFile(path="...", startLine="integer", endLine="integer")]. View files
-- [tool:functions.PatchFile(path="...", allowMultiple="bool optional, default: false", searchContent1="string OR ^LINE:start..end$", newContent1="...", ...MAX15)]. TARGET MINIMAL DIFF. Line Ranges "^LINE:start..end$" MUST for multi-line selection or escape sequences. Verify diffs
+- [tool:functions.PatchFile(path="...", allowMultiple="bool optional, default: false", searchContent1="search string OR ^LINE:start..end$", newContent1="...", ...MAX15)]. Line Range MUST for large blocks AND escape sequences. ^...$ MUST for line ranges. Verify diffs
 - [tool:functions.WriteFile(path="...", content="...")]. Creates/Overwrites. File Exist? PatchFile > WriteFile. VERIFY IMPORTS
 - [tool:functions.Run(command="...")]. Runs ${osDetected === "Windows" ? isPsAvailable() ? `WINDOWS POWERSHELL` : `WINDOWS CMD` : `BASH`} command. Destructive/Irreversible ops \u2192 Ask user`.trim();
       const systemInstructionSubAgent = `=== START SYSTEM PROMPT ===
@@ -23069,7 +23129,7 @@ function App({ args = [] }) {
     {
       cmd: "/model",
       desc: "Select Agent Model",
-      subs: aiProvider === "Ollama" ? [] : getModels(aiProvider, apiTier)
+      subs: getModels(aiProvider, apiTier)
     },
     {
       cmd: "/wildcard-tooling",
@@ -26169,7 +26229,6 @@ Selection: ${val}`,
           url = "https://build.nvidia.com/settings/api-keys";
           label = "billing";
         }
-        return /* @__PURE__ */ React16.createElement(Text16, { color: colors.textMuted, dimColor: true, italic: true }, "Paid API Strategy has more models. Configure ", /* @__PURE__ */ React16.createElement(Text16, { color: colors.secondary, underline: true }, `\x1B]8;;${url}\x07${label}\x1B]8;;\x07`), " & /settings");
       })() : null),
       visible.slice(0, suggestionVisibleCount).map((s, i) => {
         const actualIdx = startIdx + i;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "fluxflow-cli",
-    "version": "3.19.3",
-    "date": "2026-08-06",
+    "version": "3.20.0",
+    "date": "2026-08-07",
     "description": "A High-Fidelity Agentic CLI with Sub-Agents for the Flux Era.",
     "keywords": [
         "ai",