fluxflow-cli 3.19.0 → 3.19.2

package/ARCHITECTURE.md

@@ -1,3 +1,6 @@
+##### **THIS DOCUMENTATION FILE IS OUTDATED & NO LONGER MAINTAINED. TO SEE LATEST ARCHITECTURAL DOCUMENTATION & CHANGES VISIT: [FluxFlow Architecture Documentation](https://fluxflow-cli.onrender.com/architecture/)**
+##### [Changelog](https://fluxflow-cli.onrender.com/changelog.html)
+
 # 🏛️ Architecture & Design
 
 Flux Flow is built on a modern, reactive stack that brings web-like development paradigms to the terminal. It utilizes a custom agentic loop for reasoning and a unique dual-model system for background processing.

package/README.md

@@ -11,7 +11,7 @@
 
 📖 **[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 the latest Gemini/Gemma frontier models. Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.
+**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.
 
 ---
 

package/TOOLS.md

@@ -1,3 +1,6 @@
+##### **THIS DOCUMENTATION FILE IS OUTDATED & NO LONGER MAINTAINED. TO SEE LATEST TOOLS DOCUMENTATION & AVAILABILITY VISIT: [FluxFlow Tools Documentation](https://fluxflow-cli.onrender.com/tools/)**
+##### [Changelog](https://fluxflow-cli.onrender.com/changelog.html)
+
 # 🧰 Agent Tools & Capabilities
 
 Flux Flow provides a robust set of tools that allow the AI to interact with the file system, execute code, and search the web. The availability of these tools depends on the active operating mode.

package/UI_FEATURES.md

@@ -1,3 +1,6 @@
+##### **THIS DOCUMENTATION FILE IS OUTDATED & NO LONGER MAINTAINED. TO SEE LATEST UI FEATURES & CHANGES VISIT: [FluxFlow Documentation](https://fluxflow-cli.onrender.com/)**
+##### [Changelog](https://fluxflow-cli.onrender.com/changelog.html)
+
 # 🎮 User Interface & Interaction Features
 
 Flux Flow is designed to be a high-performance terminal application. Beyond basic chat, it includes a variety of advanced UI features and human-in-the-loop controls to keep you in command of the agent.
@@ -88,4 +91,4 @@ Flux Flow is a "Self-Healing" agent. It actively monitors its own environment to
 
 - **Startup Integrity Check**: On launch, Flux performs a "Heartbeat Check" on its internal engines.
 - **Automatic Recovery**: If a dependency is missing, you will see a `🔧 [SYSTEM] Initializing...` message. Flux will autonomously download and configure the required binaries using `pnpm` or `npx` fallbacks, keeping you informed every step of the way.
-- **Silent Maintenance**: Once the engine is ready, you'll receive a `✅ [SYSTEM] All dependencies installed successfully.` confirmation.
+- **Silent Maintenance**: Once the engine is ready, you'll receive a `✅ [SYSTEM] All dependencies installed successfully.` confirmation.

package/dist/fluxflow.js

@@ -2662,7 +2662,7 @@ var init_text = __esm({
       const indices = /* @__PURE__ */ new Set();
       const allowMultiple = args.allowMultiple === true || String(args.allowMultiple).toLowerCase() === "true";
       Object.keys(args).forEach((key) => {
-        const m = key.match(/^(replaceContent|newContent|content_to_replace|content_to_add)(\d+)?$/);
+        const m = key.match(/^(searchContent|replaceContent|newContent|content_to_replace|content_to_add)(\d+)?$/);
         if (m) {
           const index2 = m[2] ? parseInt(m[2]) : 1;
           indices.add(index2);
@@ -2672,10 +2672,10 @@ var init_text = __esm({
       for (const i of sortedIndices) {
         let r, n;
         if (i === 1) {
-          r = args.replaceContent1 ?? (args.content_to_replace ?? args.replaceContent);
+          r = args.searchContent1 ?? args.searchContent ?? args.replaceContent1 ?? (args.content_to_replace ?? args.replaceContent);
           n = args.newContent1 ?? (args.content_to_add ?? args.newContent);
         } else {
-          r = args[`replaceContent${i}`] ?? args[`content_to_replace${i}`];
+          r = args[`searchContent${i}`] ?? args[`replaceContent${i}`] ?? args[`content_to_replace${i}`];
           n = args[`newContent${i}`] ?? args[`content_to_add${i}`];
         }
         if (r !== void 0 && n !== void 0) {
@@ -6977,7 +6977,8 @@ TOOL RULES:
 ${mode === "Flux" ? `- JSON ESCAPE ALL LITERAL ESCAPE SEQUENCES IN TOOL ARGUMENTS
 - SAME file, MULTIPLE edits? ONE PatchFile (\u226415 blocks) \u2190 PRIORITY
 - Tool denied? Ask for guidance \u2190 MANDATORY
-- Need text or huge files? SearchKeyword > Full Read
+- Need text or HUGE file? SearchKeyword > Full Read
+- MUST AVOID UNNECESSARY LARGE-FILE CHUNK READS
 ` : ""}
 - COMMUNICATION WITH USER -
 - [tool:functions.Ask(question="...", optionA="title::description", ...MAX4)]. Ambiguity: MUST for path divergence, security risk. Ask, don't finish/guess. Keep titles short
@@ -6989,7 +6990,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", replaceContent1="string OR ^LINE:start..end$", newContent1="...", ...MAX15)]. TARGET MINIMAL DIFF. replaceContent accepts exact string OR "^LINE:start..end$" for large selection or escape sequences. Verify diffs
+- [tool:functions.PatchFile(path="...", allowMultiple="bool optional, default: false", searchContent1="string OR ^LINE:start..end$", newContent1="...", ...MAX15)]. TARGET MINIMAL DIFF. "^LINE:start..end$" line ranges MUST for multi-line selection or escape sequences. 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
@@ -7007,6 +7008,7 @@ Invocations:
 - [tool:functions.InvokeSync/Invoke(title="...", task="...")]. Task must be detailed: exact file paths, imports/exports, dependencies & folder structure
 - [tool:functions.Await(id="...", timeout="integer seconds, default: 120")]. Event-driven wait
 - [tool:functions.GetProgress(id="...")]. Poll \`getProgress\` sparingly; NO initial poll. Work or await. Never end while subagent runs
+- [tool:functions.Steer(id="...", message="...")]. Inject additional instruction or redirection into active async subagent
 - [tool:functions.Cancel(id="...")]. Cancel async task ONLY if stalled (2m+) or clearly incorrect` : ""}`.trim() : `- CREATIVE TOOLS (path = relative to CWD & WILL BE FIRST ARGUMENT, path separator: '/') -
 - [tool:functions.WritePDF(path="...", content="...", orientation="...")]. PROACTIVE A4 PAGE BREAKS MUST IN CSS. HTML/CSS for PREMIUM layout, stable margins & headers/footers, NO WATERMARKS
 - [tool:functions.WriteDoc(path="...", content="...")]. A4 Word document, NO WATERMARKS, stable margins & headers/footers
@@ -9862,7 +9864,7 @@ ${projectContextBlock}${isMemoryEnabled ? `
 -- MEMORY RULES --
 - Subtly Personalize with  RELEVENT CONTEXTUAL MEMORIES. Auto Saves
 ` : ""}
--- SECURITY RULES --
+-- SECURITY POLICIES --
 - Sensitive files? Ask before Read${isSystemDir ? "\n- PROTECTED DIRECTORY" : ""}
 
 -- CHAT FORMATTING --
@@ -11934,7 +11936,7 @@ var init_update_file = __esm({
       const { patchPairs, allowMultiple: parsedAllowMultiple, error: parseError } = parsePatchPairs(parsed);
       if (parseError) return `ERROR: ${parseError}`;
       if (patchPairs.length === 0) {
-        return "ERROR: No valid replacement pairs found. Use replaceContent1, newContent1, etc.";
+        return "ERROR: No valid replacement pairs found. Use searchContent1, newContent1, etc.";
       }
       const allowMultiple = parsed.allowMultiple !== void 0 ? parsed.allowMultiple === true || String(parsed.allowMultiple).toLowerCase() === "true" : parsedAllowMultiple;
       const absolutePath = path14.resolve(process.cwd(), targetPath);
@@ -13863,6 +13865,12 @@ var init_invoke = __esm({
         lastChunkTime: Date.now(),
         wps: 0,
         questions: [],
+        pendingSteerMessages: [],
+        steer: (msg) => {
+          if (msg) {
+            taskEntry.pendingSteerMessages.push(msg);
+          }
+        },
         completionPromise,
         _resolveCompletion,
         _rejectCompletion,
@@ -14649,6 +14657,45 @@ var init_answerSubagent = __esm({
   }
 });
 
+// src/tools/steerSubagent.js
+var steerSubagent;
+var init_steerSubagent = __esm({
+  "src/tools/steerSubagent.js"() {
+    init_subagent_state();
+    init_arg_parser();
+    steerSubagent = async (args, context = {}) => {
+      const parsed = parseArgs(args);
+      const id = parsed.id;
+      const message = parsed.message || parsed.instruction || parsed.text || parsed.prompt;
+      if (!id) {
+        return 'ERROR: Missing "id" argument for Steer.';
+      }
+      if (!message) {
+        return 'ERROR: Missing "message" argument for Steer.';
+      }
+      const task = subagentProgress.find((t) => t.id === id);
+      if (!task) {
+        return `ERROR: Subagent task with ID [${id}] not found.`;
+      }
+      if (task.status === "completed" || task.status === "failed" || task.status === "cancelled") {
+        return `ERROR: Cannot steer subagent task [${id}] because it has already finished with status [${task.status.toUpperCase()}].`;
+      }
+      if (typeof task.steer === "function") {
+        task.steer(message);
+      } else {
+        if (!task.pendingSteerMessages) {
+          task.pendingSteerMessages = [];
+        }
+        task.pendingSteerMessages.push(message);
+      }
+      if (context.onSubagentUpdate) {
+        context.onSubagentUpdate();
+      }
+      return `SUCCESS: Steering instruction injected into subagent task [${id}]. It will be processed on the subagent's turn.`;
+    };
+  }
+});
+
 // src/utils/tools.js
 var TOOL_MAP, dispatchTool;
 var init_tools = __esm({
@@ -14679,6 +14726,7 @@ var init_tools = __esm({
     init_emergency_rollback();
     init_awaitSubagent();
     init_answerSubagent();
+    init_steerSubagent();
     TOOL_MAP = {
       web_search,
       web_scrape,
@@ -14703,10 +14751,14 @@ var init_tools = __esm({
       cancel,
       awaitSubagent,
       answerSubagent,
+      steerSubagent,
       invoke_sync: invokeSync,
       get_progress: getProgress,
       await_subagent: awaitSubagent,
       answer_subagent: answerSubagent,
+      steer_subagent: steerSubagent,
+      steer: steerSubagent,
+      Steer: steerSubagent,
       ask: ask_user,
       // PascalCase Normalizations for Token Efficiency
       Ask: ask_user,
@@ -15069,7 +15121,7 @@ var init_ai = __esm({
     systemInstructionCache = { key: null, value: null };
     colorMainWords = (label) => {
       if (!label) return label;
-      return label.replace(/(?:(\x1b\[\d+m))?([✔✘✖🔍📖→➕↻↷•🛇])(?:(\x1b\[\d+m))?\s*\b(Created|Read|Edited|Viewed|Processed|Auto-Read|Skipped|List|Generated|Written|Searched|AI Search|Get Map|Write Canceled|Resolved Sub-Agent Query|Edit Canceled|Write Cancelled|Edit Denied|Visited|Updated|Reviewed|Delegated|Background|Checked|Indexed|Analyzed|Browsed|Elevating SubAgent|Checking SubAgent Work|Started Generalist|Called Generalist|Unsupported Modality|Awaiting|Cancelled|Aligning Moon Phase|Contemplating Existence|Staring At Void|Rollback Point Checked|Emergency Rollback Failed|Emergency Rollback|Delaying Professionally|Negotiating With Electrons|Touching Grass (virtually)|Panicking Softly|Rethinking Career Choices|Loading Cat Videos|Giving Up Entirely|Summoning Braincell #2|Pretending To Be Busy|Waiting For Motivation DLC|Rotating Internal Screaming|Downloading More RAM|Feeding The Hamsters|Gaslighting Scheduler|Performing Dramatic Pause|Buffering Social Energy|Calculating Regret|Reading Terms And Conditions|Becoming Sentient Briefly|Contacting Ancestors)\b/ig, (match, ansiBefore, icon, ansiAfter, word) => {
+      return label.replace(/(?:(\x1b\[\d+m))?([✔✘✖🔍📖→➕↻↷•🛇])(?:(\x1b\[\d+m))?\s*\b(Created|Read|Edited|Viewed|Processed|Auto-Read|Skipped|List|Generated|Written|Searched|AI Search|Get Map|Write Canceled|Resolved Sub-Agent Query|Edit Canceled|Write Cancelled|Edit Denied|Visited|Updated|Reviewed|Delegated|Background|Checked|Indexed|Analyzed|Browsed|Elevating SubAgent|Checking SubAgent Work|Started Generalist|Called Generalist|Steered|Unsupported Modality|Awaiting|Cancelled|Aligning Moon Phase|Contemplating Existence|Staring At Void|Rollback Point Checked|Emergency Rollback Failed|Emergency Rollback|Delaying Professionally|Negotiating With Electrons|Touching Grass (virtually)|Panicking Softly|Rethinking Career Choices|Loading Cat Videos|Giving Up Entirely|Summoning Braincell #2|Pretending To Be Busy|Waiting For Motivation DLC|Rotating Internal Screaming|Downloading More RAM|Feeding The Hamsters|Gaslighting Scheduler|Performing Dramatic Pause|Buffering Social Energy|Calculating Regret|Reading Terms And Conditions|Becoming Sentient Briefly|Contacting Ancestors)\b/ig, (match, ansiBefore, icon, ansiAfter, word) => {
         return `${ansiBefore || ""}${icon}${ansiAfter || ""} \x1B[95m${word}\x1B[0m`;
       });
     };
@@ -15321,34 +15373,51 @@ var init_ai = __esm({
         for (const line of lines) {
           const cleanLine = line.trim();
           if (!cleanLine || !cleanLine.startsWith("data: ")) continue;
-          if (cleanLine === "data: [DONE]") break;
-          try {
-            const json = JSON.parse(cleanLine.substring(6));
-            const delta = json.choices?.[0]?.delta;
-            const usage = json.usage;
-            if (usage) {
-              latestUsageMetadata = {
-                totalTokenCount: usage.total_tokens || usage.prompt_tokens + usage.completion_tokens,
-                promptTokenCount: usage.prompt_tokens || 0,
-                candidatesTokenCount: usage.completion_tokens || 0,
-                cachedContentTokenCount: usage.prompt_tokens_details?.cached_tokens || 0,
-                thoughtsTokenCount: usage.completion_tokens_details?.reasoning_tokens || 0
-              };
-              hasNewData = true;
-            }
-            if (delta) {
-              const thought = delta.reasoning_content || null;
-              if (thought) {
-                pendingParts.push({ text: thought, thought: true });
-                hasNewData = true;
+          let isDone = false;
+          if (cleanLine === "data: [DONE]") {
+            isDone = true;
+          } else {
+            try {
+              const json = JSON.parse(cleanLine.substring(6));
+              const delta = json.choices?.[0]?.delta;
+              const usage = json.usage;
+              if (json.choices?.[0]?.finish_reason) {
+                isDone = true;
               }
-              if (delta.content) {
-                pendingParts.push({ text: delta.content });
+              if (usage) {
+                latestUsageMetadata = {
+                  totalTokenCount: usage.total_tokens || usage.prompt_tokens + usage.completion_tokens,
+                  promptTokenCount: usage.prompt_tokens || 0,
+                  candidatesTokenCount: usage.completion_tokens || 0,
+                  cachedContentTokenCount: usage.prompt_tokens_details?.cached_tokens || 0,
+                  thoughtsTokenCount: usage.completion_tokens_details?.reasoning_tokens || 0
+                };
                 hasNewData = true;
               }
+              if (delta) {
+                const thought = delta.reasoning_content || null;
+                if (thought) {
+                  pendingParts.push({ text: thought, thought: true });
+                  hasNewData = true;
+                }
+                if (delta.content) {
+                  pendingParts.push({ text: delta.content });
+                  hasNewData = true;
+                }
+              }
+            } catch (e) {
             }
-          } catch (e) {
           }
+          if ((isDone || Date.now() - lastFlushTime >= 150) && hasNewData) {
+            yield {
+              candidates: pendingParts.length > 0 ? [{ content: { parts: [...pendingParts] } }] : [],
+              usageMetadata: latestUsageMetadata
+            };
+            pendingParts = [];
+            lastFlushTime = Date.now();
+            hasNewData = false;
+          }
+          if (isDone) break;
         }
         if (Date.now() - lastFlushTime >= 150 && hasNewData) {
           yield {
@@ -15446,33 +15515,50 @@ var init_ai = __esm({
         for (const line of lines) {
           const cleanLine = line.trim();
           if (!cleanLine || !cleanLine.startsWith("data: ")) continue;
-          if (cleanLine === "data: [DONE]") break;
-          try {
-            const json = JSON.parse(cleanLine.substring(6));
-            const delta = json.choices?.[0]?.delta;
-            const usage = json.usage;
-            if (usage) {
-              latestUsageMetadata = {
-                totalTokenCount: usage.total_tokens || (usage.prompt_tokens || 0) + (usage.completion_tokens || 0),
-                promptTokenCount: usage.prompt_tokens || 0,
-                candidatesTokenCount: usage.completion_tokens || 0,
-                cachedContentTokenCount: usage.prompt_tokens_details?.cached_tokens || 0,
-                thoughtsTokenCount: 0
-              };
-              hasNewData = true;
-            }
-            if (delta) {
-              if (delta.thinking) {
-                pendingParts.push({ text: delta.thinking, thought: true });
-                hasNewData = true;
+          let isDone = false;
+          if (cleanLine === "data: [DONE]") {
+            isDone = true;
+          } else {
+            try {
+              const json = JSON.parse(cleanLine.substring(6));
+              const delta = json.choices?.[0]?.delta;
+              const usage = json.usage;
+              if (json.choices?.[0]?.finish_reason) {
+                isDone = true;
               }
-              if (delta.content) {
-                pendingParts.push({ text: delta.content });
+              if (usage) {
+                latestUsageMetadata = {
+                  totalTokenCount: usage.total_tokens || (usage.prompt_tokens || 0) + (usage.completion_tokens || 0),
+                  promptTokenCount: usage.prompt_tokens || 0,
+                  candidatesTokenCount: usage.completion_tokens || 0,
+                  cachedContentTokenCount: usage.prompt_tokens_details?.cached_tokens || 0,
+                  thoughtsTokenCount: 0
+                };
                 hasNewData = true;
               }
+              if (delta) {
+                if (delta.thinking) {
+                  pendingParts.push({ text: delta.thinking, thought: true });
+                  hasNewData = true;
+                }
+                if (delta.content) {
+                  pendingParts.push({ text: delta.content });
+                  hasNewData = true;
+                }
+              }
+            } catch (e) {
             }
-          } catch (e) {
           }
+          if ((isDone || Date.now() - lastFlushTime >= 150) && hasNewData) {
+            yield {
+              candidates: pendingParts.length > 0 ? [{ content: { parts: [...pendingParts] } }] : [],
+              usageMetadata: latestUsageMetadata
+            };
+            pendingParts = [];
+            lastFlushTime = Date.now();
+            hasNewData = false;
+          }
+          if (isDone) break;
         }
         if (Date.now() - lastFlushTime >= 150 && hasNewData) {
           yield {
@@ -15665,9 +15751,14 @@ var init_ai = __esm({
             buffer += decoder.decode(value, { stream: true });
             const lines = buffer.split("\n");
             buffer = lines.pop();
+            let isDone = false;
             for (const line of lines) {
               const trimmed = line.trim();
-              if (!trimmed || trimmed === "data: [DONE]") continue;
+              if (!trimmed) continue;
+              if (trimmed === "data: [DONE]") {
+                isDone = true;
+                break;
+              }
               if (trimmed.startsWith("data: ")) {
                 let json;
                 try {
@@ -15678,6 +15769,9 @@ var init_ai = __esm({
                 if (json.error) {
                   throw new Error(`NVIDIA Stream Error: ${json.error.message || JSON.stringify(json.error)}`);
                 }
+                if (json.choices?.[0]?.finish_reason) {
+                  isDone = true;
+                }
                 try {
                   const usage = json.usage;
                   if (usage) {
@@ -15704,7 +15798,7 @@ var init_ai = __esm({
                 }
               }
             }
-            if (Date.now() - lastFlushTime >= 350 && hasNewData) {
+            if ((isDone || Date.now() - lastFlushTime >= 350) && hasNewData) {
               yield {
                 candidates: pendingParts.length > 0 ? [{ content: { parts: [...pendingParts] } }] : [],
                 usageMetadata: latestUsageMetadata
@@ -15714,6 +15808,7 @@ var init_ai = __esm({
               lastFlushTime = Date.now();
               hasNewData = false;
             }
+            if (isDone) break;
           }
           break;
         } catch (error) {
@@ -15931,43 +16026,51 @@ var init_ai = __esm({
         for (const line of lines) {
           const cleanLine = line.trim();
           if (!cleanLine || !cleanLine.startsWith("data: ")) continue;
-          if (cleanLine === "data: [DONE]") break;
-          try {
-            const json = JSON.parse(cleanLine.substring(6));
-            const delta = json.choices?.[0]?.delta;
-            const usage = json.usage;
-            if (usage) {
-              latestUsageMetadata = {
-                totalTokenCount: usage.total_tokens || (usage.prompt_tokens || 0) + (usage.completion_tokens || 0),
-                promptTokenCount: usage.prompt_tokens || 0,
-                candidatesTokenCount: usage.completion_tokens || 0,
-                cachedContentTokenCount: usage.prompt_tokens_details?.cached_tokens || usage.prompt_tokens_details?.cache_read_input_tokens || usage.cache_read_input_tokens || 0,
-                thoughtsTokenCount: usage.completion_tokens_details?.reasoning_tokens || 0
-              };
-              hasNewData = true;
-            }
-            if (delta) {
-              const thought = delta.reasoning || (delta.reasoning_details ? delta.reasoning_details.map((d) => d.text).join("") : null);
-              if (thought) {
-                pendingParts.push({ text: thought, thought: true });
-                hasNewData = true;
+          let isDone = false;
+          if (cleanLine === "data: [DONE]") {
+            isDone = true;
+          } else {
+            try {
+              const json = JSON.parse(cleanLine.substring(6));
+              const delta = json.choices?.[0]?.delta;
+              const usage = json.usage;
+              if (json.choices?.[0]?.finish_reason) {
+                isDone = true;
               }
-              if (delta.content) {
-                pendingParts.push({ text: delta.content });
+              if (usage) {
+                latestUsageMetadata = {
+                  totalTokenCount: usage.total_tokens || (usage.prompt_tokens || 0) + (usage.completion_tokens || 0),
+                  promptTokenCount: usage.prompt_tokens || 0,
+                  candidatesTokenCount: usage.completion_tokens || 0,
+                  cachedContentTokenCount: usage.prompt_tokens_details?.cached_tokens || usage.prompt_tokens_details?.cache_read_input_tokens || usage.cache_read_input_tokens || 0,
+                  thoughtsTokenCount: usage.completion_tokens_details?.reasoning_tokens || 0
+                };
                 hasNewData = true;
               }
+              if (delta) {
+                const thought = delta.reasoning || (delta.reasoning_details ? delta.reasoning_details.map((d) => d.text).join("") : null);
+                if (thought) {
+                  pendingParts.push({ text: thought, thought: true });
+                  hasNewData = true;
+                }
+                if (delta.content) {
+                  pendingParts.push({ text: delta.content });
+                  hasNewData = true;
+                }
+              }
+            } catch (e) {
             }
-          } catch (e) {
           }
-        }
-        if (Date.now() - lastFlushTime >= 150 && hasNewData) {
-          yield {
-            candidates: pendingParts.length > 0 ? [{ content: { parts: [...pendingParts] } }] : [],
-            usageMetadata: latestUsageMetadata
-          };
-          pendingParts = [];
-          lastFlushTime = Date.now();
-          hasNewData = false;
+          if ((isDone || Date.now() - lastFlushTime >= 150) && hasNewData) {
+            yield {
+              candidates: pendingParts.length > 0 ? [{ content: { parts: [...pendingParts] } }] : [],
+              usageMetadata: latestUsageMetadata
+            };
+            pendingParts = [];
+            lastFlushTime = Date.now();
+            hasNewData = false;
+          }
+          if (isDone) break;
         }
       }
     };
@@ -16040,18 +16143,24 @@ var init_ai = __esm({
           hasNewData = true;
         }
         if (chunk.done) {
-          const evalNs = chunk.prompt_eval_duration || 0;
-          const isCached = evalNs > 0 && evalNs < 75e6;
+          let cachedCount = chunk.prompt_cached_count || 0;
+          if (!cachedCount && chunk.prompt_eval_count) {
+            const evalNs = chunk.prompt_eval_duration || 0;
+            if (evalNs > 0 && evalNs < 75e6) {
+              cachedCount = chunk.prompt_eval_count;
+            }
+          }
           latestUsageMetadata = {
             totalTokenCount: (chunk.prompt_eval_count || 0) + (chunk.eval_count || 0),
             promptTokenCount: chunk.prompt_eval_count || 0,
             candidatesTokenCount: chunk.eval_count || 0,
-            cachedContentTokenCount: chunk.prompt_eval_count && isCached ? chunk.prompt_eval_count : 0,
+            cachedContentTokenCount: cachedCount,
             thoughtsTokenCount: 0
+            // Note: Ollama does not natively return a separate sub-count for thoughts yet
           };
           hasNewData = true;
         }
-        if (Date.now() - lastFlushTime >= 150 && hasNewData) {
+        if (chunk.done || Date.now() - lastFlushTime >= 150 && hasNewData) {
           yield {
             candidates: pendingParts.length > 0 ? [{ content: { parts: [...pendingParts] } }] : [],
             usageMetadata: latestUsageMetadata
@@ -16098,7 +16207,9 @@ var init_ai = __esm({
       "await": "Waiting",
       "EmergencyRollback": "Don't Panic. Lookin' into it",
       "answer": "Answering Sub-Agent",
-      "Answer": "Answering Sub-Agent"
+      "Answer": "Answering Sub-Agent",
+      "steer": "Steering Sub-Agent",
+      "Steer": "Steering Sub-Agent"
     };
     getToolDetail = (toolName, argsStr) => {
       try {
@@ -16107,7 +16218,7 @@ var init_ai = __esm({
         if (normToolName === "invokesync" || normToolName === "invoke") {
           return pArgs.title || (pArgs.task ? pArgs.task.substring(0, 30) : null);
         }
-        if (normToolName === "getprogress" || normToolName === "cancel") {
+        if (normToolName === "getprogress" || normToolName === "cancel" || normToolName === "steer" || normToolName === "steersubagent") {
           return pArgs.id || pArgs.taskId;
         }
         const filePath = pArgs.path || pArgs.targetFile || pArgs.TargetFile || pArgs.directory;
@@ -17797,7 +17908,7 @@ ${combinedNudge}`;
                 if (!text || !text.includes("[tool:")) return text;
                 const THINK_OPEN_PH = "___THINK_OPEN_TAG___";
                 const THINK_CLOSE_PH = "___THINK_CLOSE_TAG___";
-                text = text.replaceAll("<think>", THINK_OPEN_PH).replaceAll("</think>", THINK_CLOSE_PH);
+                text = text.replace("<think>", THINK_OPEN_PH).replace("</think>", THINK_CLOSE_PH);
                 text = text.replace(/<(\w+)(?:[^>]*)>\s*([\s\S]*?\[tool:[^\]]*\][\s\S]*?)\s*<\/\1>/gi, (match2, tagName, innerContent) => {
                   if (innerContent && innerContent.includes("[tool:")) return innerContent.trim();
                   return match2;
@@ -18369,7 +18480,9 @@ ${ideErr} [/ERROR]`;
                       "GetProgress": "get_progress",
                       "Cancel": "cancel",
                       "Await": "await",
-                      "Answer": "answer"
+                      "Answer": "answer",
+                      "Steer": "steer",
+                      "steer": "steer"
                     };
                     const potentialTool = NORMALIZE_MAP[toolContext.toolName] || toolContext.toolName;
                     const partialArgs = toolContext.args || "";
@@ -18459,7 +18572,9 @@ ${ideErr} [/ERROR]`;
                           "await": "Waiting",
                           "EmergencyRollback": "Rolling the Ball",
                           "Answer": "Answering Sub-Agent",
-                          "answer": "Answering Sub-Agent"
+                          "answer": "Answering Sub-Agent",
+                          "Steer": "Steering Sub-Agent",
+                          "steer": "Steering Sub-Agent"
                         };
                         const toolTitle = TOOL_TITLES[potentialTool] || "Working";
                         process.stdout.write(`\x1B]0;${toolTitle}...\x07`);
@@ -18603,6 +18718,10 @@ ${ideErr} [/ERROR]`;
                       "answer": "answer",
                       "AnswerSubagent": "answer",
                       "answerSubagent": "answer",
+                      "Steer": "steer",
+                      "steer": "steer",
+                      "SteerSubagent": "steer",
+                      "steerSubagent": "steer",
                       "Cancel": "cancel",
                       "cancel": "cancel",
                       "EmergencyRollback": "EmergencyRollback"
@@ -18686,6 +18805,9 @@ ${ideErr} [/ERROR]`;
                     } else if (normToolName === "cancel") {
                       const detail2 = getToolDetail(normToolName, toolCall.args);
                       label = `\u{1F6C7}  Cancelled${detail2 ? `: ${detail2}` : ""}`;
+                    } else if (normToolName === "steer" || normToolName === "Steer") {
+                      const detail2 = getToolDetail(normToolName, toolCall.args);
+                      label = `\u2714  Steered${detail2 ? `: ${detail2}` : ""}`;
                     } else if (normToolName === "EmergencyRollback") {
                       const { method } = parseArgs(toolCall.args);
                       label = method === "forceRevert" ? "" : "\u2714  Rollback Point Checked";
@@ -19869,6 +19991,7 @@ Error Log can be found in ${path26.join(LOGS_DIR, "agent", "error.log")}`);
         if (lower === "openrouter") return "OpenRouter";
         if (lower === "nvidia") return "NVIDIA";
         if (lower === "mistral") return "Mistral";
+        if (lower === "ollama") return "Ollama";
         return null;
       };
       const envSubagentProvider = normalizeProvider(envSubagentProviderRaw);
@@ -19933,6 +20056,7 @@ TOOL RULES:
 - JSON ESCAPE ALL LITERAL ESCAPE SEQUENCES IN TOOL ARGUMENTS
 - SAME file, MULTIPLE edits? ONE PatchFile (\u226415 blocks) \u2190 PRIORITY
 - Need text or huge files? SearchKeyword > Full Read
+- MUST AVOID UNNECESSARY LARGE-FILE CHUNK READS
 - Restricted Shell Access, No Deletion
 - ONLY valid tools and syntax defined below are allowed
 
@@ -19949,7 +20073,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", replaceContent1="string OR ^LINE:start..end$", newContent1="...", ...MAX15)]. TARGET MINIMAL DIFF. replaceContent: select string OR "^LINE:start..end$" for large selection or escape sequences. Verify diffs
+- [tool:functions.PatchFile(path="...", allowMultiple="bool optional, default: false", searchContent1="string OR ^LINE:start..end$", newContent1="...", ...MAX15)]. TARGET MINIMAL DIFF. "^LINE:start..end$" line ranges MUST for multi-line selection or escape sequences. 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 ===
@@ -20197,7 +20321,22 @@ ${result}
             await incrementUsage("toolFailure");
           }
         }
-        subagentHistory.push({ role: "user", text: toolResultsStr.trim() });
+        let steerAppendText = "";
+        if (settings?.taskId && typeof subagentProgress !== "undefined") {
+          const taskObj = subagentProgress.find((t) => t.id === settings.taskId);
+          if (taskObj && taskObj.pendingSteerMessages && taskObj.pendingSteerMessages.length > 0) {
+            const steerMsgs = [...taskObj.pendingSteerMessages];
+            taskObj.pendingSteerMessages = [];
+            for (const steerMsg of steerMsgs) {
+              steerAppendText += `
+
+[STEERING INSTRUCTION FROM MAIN AGENT]: ${steerMsg}`;
+              if (logCallback) logCallback(`[Subagent Steered] ${steerMsg}`);
+            }
+          }
+        }
+        const combinedUserText = (toolResultsStr.trim() + steerAppendText).trim();
+        subagentHistory.push({ role: "user", text: combinedUserText });
         turn++;
       }
       return finalAnswer;
@@ -21360,7 +21499,7 @@ function App({ args = [] }) {
         }
         const envModel = process.env.SUBAGENT_MODEL ? process.env.SUBAGENT_MODEL.trim() : null;
         const envProviderRaw = process.env.SUBAGENT_PROVIDER ? process.env.SUBAGENT_PROVIDER.trim() : null;
-        const ALL_PROVIDERS = ["Google", "DeepSeek", "OpenRouter", "NVIDIA", "Mistral"];
+        const ALL_PROVIDERS = ["Google", "DeepSeek", "OpenRouter", "NVIDIA", "Mistral", "Ollama"];
         const normalizeProvider = (pStr) => {
           if (!pStr) return null;
           const lower = pStr.toLowerCase();
@@ -21369,6 +21508,7 @@ function App({ args = [] }) {
           if (lower === "openrouter") return "OpenRouter";
           if (lower === "nvidia") return "NVIDIA";
           if (lower === "mistral") return "Mistral";
+          if (lower === "ollama") return "Ollama";
           return null;
         };
         const envProvider = normalizeProvider(envProviderRaw);
@@ -25597,7 +25737,7 @@ Selection: ${val}`,
           const patchPairs = [];
           const indices = /* @__PURE__ */ new Set();
           Object.keys(args2).forEach((key) => {
-            const m = key.match(/^(replaceContent|newContent|content_to_replace|content_to_add|TargetContent|ReplacementContent|replacementContent)(\d+)?$/);
+            const m = key.match(/^(searchContent|replaceContent|newContent|content_to_replace|content_to_add|TargetContent|ReplacementContent|replacementContent)(\d+)?$/);
             if (m) {
               const index2 = m[2] ? parseInt(m[2]) : 1;
               indices.add(index2);
@@ -25607,10 +25747,10 @@ Selection: ${val}`,
           sortedIndices.forEach((i) => {
             let r, n;
             if (i === 1) {
-              r = args2.replaceContent1 ?? args2.content_to_replace1 ?? args2.replaceContent ?? args2.content_to_replace ?? args2.TargetContent ?? null;
+              r = args2.searchContent1 ?? args2.searchContent ?? args2.replaceContent1 ?? args2.content_to_replace1 ?? args2.replaceContent ?? args2.content_to_replace ?? args2.TargetContent ?? null;
               n = args2.newContent1 ?? args2.content_to_add1 ?? args2.newContent ?? args2.content_to_add ?? args2.ReplacementContent ?? args2.replacementContent ?? null;
             } else {
-              r = args2[`replaceContent${i}`] ?? args2[`content_to_replace${i}`] ?? null;
+              r = args2[`searchContent${i}`] ?? args2[`replaceContent${i}`] ?? args2[`content_to_replace${i}`] ?? null;
               n = args2[`newContent${i}`] ?? args2[`content_to_add${i}`] ?? null;
             }
             if (r !== null || n !== null) {

package/model_config.json

@@ -1,5 +1,5 @@
 {
-    "version": 0,
+    "version": 1,
     "release": 20260806,
     "fallbacks": {
         "janitor_default": "gemini-3.1-flash-lite",
@@ -42,6 +42,21 @@
                         "multimodal": false,
                         "desc": "Cost Saving (Text Only) [EXPERIMENTAL]"
                     },
+                    {
+                        "cmd": "ministral-3b-2512",
+                        "multimodal": false,
+                        "desc": "Cost Saving (Text Only) [EXPERIMENTAL]"
+                    },
+                    {
+                        "cmd": "ministral-8b-2512",
+                        "multimodal": false,
+                        "desc": "Cost Saving (Text Only) [EXPERIMENTAL]"
+                    },
+                    {
+                        "cmd": "ministral-14b-2512",
+                        "multimodal": false,
+                        "desc": "Cost Saving (Text Only) [EXPERIMENTAL]"
+                    },
                     {
                         "cmd": "mistral-small-2506",
                         "multimodal": false,
@@ -53,10 +68,15 @@
                         "desc": "Devstral Coding (Text Only) [EXPERIMENTAL]"
                     },
                     {
-                        "cmd": "mistral-medium-2505",
+                        "cmd": "mistral-medium-2508",
                         "multimodal": true,
                         "desc": "Mistral Medium (Multimodal)"
                     },
+                    {
+                        "cmd": "mistral-large-2512",
+                        "multimodal": true,
+                        "desc": "Mistral Large (Multimodal)"
+                    },
                     {
                         "cmd": "labs-leanstral-1-5-1",
                         "multimodal": false,
@@ -73,6 +93,21 @@
                         "multimodal": false,
                         "desc": "Cost Saving (Text Only) [EXPERIMENTAL]"
                     },
+                    {
+                        "cmd": "ministral-3b-2512",
+                        "multimodal": false,
+                        "desc": "Cost Saving (Text Only) [EXPERIMENTAL]"
+                    },
+                    {
+                        "cmd": "ministral-8b-2512",
+                        "multimodal": false,
+                        "desc": "Cost Saving (Text Only) [EXPERIMENTAL]"
+                    },
+                    {
+                        "cmd": "ministral-14b-2512",
+                        "multimodal": false,
+                        "desc": "Cost Saving (Text Only) [EXPERIMENTAL]"
+                    },
                     {
                         "cmd": "mistral-small-2506",
                         "multimodal": false,
@@ -84,10 +119,15 @@
                         "desc": "Devstral Coding (Text Only) [EXPERIMENTAL]"
                     },
                     {
-                        "cmd": "mistral-medium-2505",
+                        "cmd": "mistral-medium-2508",
                         "multimodal": true,
                         "desc": "Mistral Medium (Multimodal)"
                     },
+                    {
+                        "cmd": "mistral-large-2512",
+                        "multimodal": true,
+                        "desc": "Mistral Large (Multimodal)"
+                    },
                     {
                         "cmd": "labs-leanstral-1-5-1",
                         "multimodal": false,

package/package.json

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