fluxflow-cli 1.5.3 → 1.6.0

package/TOOLS.md

@@ -1,52 +1,52 @@
-# 🧰 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.
-
-## Tool Availability by Mode
-
-| Tool | Flux Mode (Dev) | Flow Mode (Chat) |
-| :--- | :---: | :---: |
-| **Web Search** | ✅ | ✅ |
-| **Web Scrape** | ✅ | ✅ |
-| **Write PDF** | ✅ | ✅ |
-| **View/Read Files** | ✅ | ❌ |
-| **Write/Update Files** | ✅ | ❌ |
-| **Execute Commands** | ✅ | ❌ |
-
----
-
-## Core Tools
-
-### 🌐 Web & Research
-- **`web_search`**: Uses DuckDuckGo to find up-to-date information on the internet. Crucial for answering questions about recent events or unlearned documentation.
-- **`web_scrape`**: Extracts the detailed text content from a specific URL, allowing the agent to read documentation or articles.
-- **`write_pdf`**: Generates high-fidelity, branded PDF documents from HTML/CSS. Features automatic watermarking and page-aware layout management.
-
-### 📁 File System Operations
-- **`list_files`**: Lists the contents of a directory to help the agent understand the project structure.
-- **`read_folder`**: Provides detailed statistics and metadata about a directory's contents.
-- **`view_file`**: Reads the content of a file.
-  - **Native Multimodality**: Supports analyzing images (JPG, PNG, WEBP) and PDF documents. The tool automatically detects binary formats and encodes them for AI analysis.
-  - **Text Reading**: Supports specific line ranges (`start_line`, `end_line`) to manage context size efficiently.
-
-### ✍️ Code Editing
-- **`write_file`**: Creates a new file or completely overwrites an existing one with new content.
-- **`update_file` (Smart Patching)**: Surgically replaces a specific block of text within a file.
-  - *Diff Generation*: It returns a high-fidelity visual diff (Red/Green changes with context lines) to the UI, allowing the user to see exactly what the agent modified.
-
-### 💻 Terminal Execution
-- **`exec_command`**: Runs a shell command directly in the terminal using Node's `child_process.spawn`.
-  - *Context Aware*: Runs in the current working directory.
-  - *Cross-Platform*: Uses `shell: true` to handle Windows `.cmd`/`.bat` files natively.
-
----
-
-## Memory Management
-
-The memory tool (`memory.js`) is primarily used by the background **Janitor** model, but can be accessed by the main agent if necessary.
-
-- **Temporary Context (`action='temp'`)**: Saves a rolling summary of the current session to maintain conversational context without bloating the main prompt history.
-- **Persistent User Memory (`action='user'`)**:
-  - The Janitor analyzes conversations to detect user preferences, hobbies, or instructions.
-  - It uses `add`, `update`, or `delete` methods to manage facts in the encrypted `memories.json` vault.
+# 🧰 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.
+
+## Tool Availability by Mode
+
+| Tool | Flux Mode (Dev) | Flow Mode (Chat) |
+| :--- | :---: | :---: |
+| **Web Search** | ✅ | ✅ |
+| **Web Scrape** | ✅ | ✅ |
+| **Write PDF** | ✅ | ✅ |
+| **View/Read Files** | ✅ | ❌ |
+| **Write/Update Files** | ✅ | ❌ |
+| **Execute Commands** | ✅ | ❌ |
+
+---
+
+## Core Tools
+
+### 🌐 Web & Research
+- **`web_search`**: Uses DuckDuckGo to find up-to-date information on the internet. Crucial for answering questions about recent events or unlearned documentation.
+- **`web_scrape`**: Extracts the detailed text content from a specific URL, allowing the agent to read documentation or articles.
+- **`write_pdf`**: Generates high-fidelity, branded PDF documents from HTML/CSS. Features automatic watermarking and page-aware layout management.
+
+### 📁 File System Operations
+- **`list_files`**: Lists the contents of a directory to help the agent understand the project structure.
+- **`read_folder`**: Provides detailed statistics and metadata about a directory's contents.
+- **`view_file`**: Reads the content of a file.
+  - **Native Multimodality**: Supports analyzing images (JPG, PNG, WEBP) and PDF documents. The tool automatically detects binary formats and encodes them for AI analysis.
+  - **Text Reading**: Supports specific line ranges (`start_line`, `end_line`) to manage context size efficiently.
+
+### ✍️ Code Editing
+- **`write_file`**: Creates a new file or completely overwrites an existing one with new content.
+- **`update_file` (Smart Patching)**: Surgically replaces a specific block of text within a file.
+  - *Diff Generation*: It returns a high-fidelity visual diff (Red/Green changes with context lines) to the UI, allowing the user to see exactly what the agent modified.
+
+### 💻 Terminal Execution
+- **`exec_command`**: Runs a shell command directly in the terminal using Node's `child_process.spawn`.
+  - *Context Aware*: Runs in the current working directory.
+  - *Cross-Platform*: Uses `shell: true` to handle Windows `.cmd`/`.bat` files natively.
+
+---
+
+## Memory Management
+
+The memory tool (`memory.js`) is primarily used by the background **Janitor** model, but can be accessed by the main agent if necessary.
+
+- **Temporary Context (`action='temp'`)**: Saves a rolling summary of the current session to maintain conversational context without bloating the main prompt history.
+- **Persistent User Memory (`action='user'`)**:
+  - The Janitor analyzes conversations to detect user preferences, hobbies, or instructions.
+  - It uses `add`, `update`, or `delete` methods to manage facts in the encrypted `memories.json` vault.
   - These memories are injected into the system prompt of *future* sessions, allowing Flux Flow to learn and adapt to the user over time.

package/UI_FEATURES.md

@@ -1,101 +1,101 @@
-# 🎮 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.
-
-## ⌨️ Command System
-
-You can control the application using `/` commands directly in the chat input:
-
-- **/mode [flux|flow]**: Quickly switch between **Flux** (Dev) and **Flow** (Chat) modes. Using it without arguments opens the selection menu.
-- **/thinking [low|medium|high|max|show|hide]**: Adjust reasoning depth or toggle visibility of the thinking process. Using it without arguments opens the selection menu.
-- **/model [name]**: Choose which AI model to use for the main interaction.
-- **/key**: Open the API Key management view to update or remove your credentials.
-- **/settings**: Access the system configuration menu.
-- **/profile**: Update your name, nickname, and custom instructions.
-- **/update**: Update Flux Flow to the latest version.
-- **/memory**: View and manage the persistent memories extracted by the Janitor.
-- **/resume <chat-id>**: Switch back to a previous conversation.
-- **/changelog**: Open the project's changelog in your default browser.
-- **/help**: List all available commands.
-
-## 📁 External Data Sanctuary (Redirection)
-
-Flux Flow allows you to "Anchor" your data outside of the default user directory. This is perfect for users who want to keep their logs, chat history, and encrypted memories on an external drive, a VeraCrypt volume, or a specific project folder.
-
-- **How to Enable**: Open `/settings` and toggle **Use External Data**. 
-- **Portability**: Once set, the application will synchronously "pivot" all data operations to your specified `externalDataPath` upon startup.
-- **Privacy**: Keeps sensitive data off your primary system drive.
-
-
-### Command Shortcuts
-
-For power users, several commands support direct arguments to skip the menus:
-- ` /mode flux ` or ` /mode flow `
-- ` /thinking low ` / ` /thinking medium ` / ` /thinking high ` / ` /thinking max `
-- ` /thinking show ` / ` /thinking hide ` (Toggles thinking process visibility)
-- ` /model gemini-3.1-pro-preview ` (Switches model directly)
-- ` /update check ` (Checks for updates)
-
-## 🧠 Thinking Levels & Visualization
-
-Flux Flow separates the model's "internal monologue" (reasoning) from its final response using `<think>` tags.
-
-- **Thinking Levels**: Depending on the mode, you can choose from **Low**, **Medium**, **High**, or **Max**. Higher levels allow the agent more "space" to reason through complex architecture or debugging problems.
-- **Show/Hide Thinking**: You can toggle the visibility of the thinking process using `/thinking show/hide`.
-  - When **Hidden**, the agent doesn't just disappear; it provides a "minimalist" view showing only the core **Headings** and **Action Steps** (bolded lines) from its reasoning. This keeps you informed of its current "step" without cluttering the screen with detailed internal monologue.
-
-## ⚡ Interactive Sub-Terminal
-
-Flux Flow features a high-fidelity, interactive sub-terminal that allows you to engage with commands spawned by the agent in real-time.
-
-- **Live Interaction**: When an agent executes a command (like `npm init`, `git commit`, or a custom script), the terminal output appears in a dedicated box.
-- **Focus Toggling (`TAB`)**: While a terminal is live, you can press **`TAB`** to shift your keyboard focus from the chat prompt directly into the terminal.
-- **Visual Feedback**:
-  - **Yellow Glow**: When the terminal is focused, its border changes to a "Double Yellow" style to indicate it is capturing input.
-  - **Status Indicator**: The footer will change from `● LIVE` to `▶ TERMINAL FOCUSED`.
-- **Cross-Platform Compatibility**: The input bridge automatically detects your OS and sends the correct line endings (`\r\n` for Windows, `\n` for Unix), ensuring that interactive prompts like `y/n` work seamlessly across environments.
-- **Input Mirroring**: Your keystrokes are mirrored in the terminal box in real-time, providing an IDE-grade responsive feel.
-
-> [!TIP]
-> Use the Interactive Sub-Terminal to handle authentication prompts, confirmation dialogs, or to manually steering a long-running process without leaving the Flux Flow interface.
-
-## 🛡️ Human-in-the-Loop (HITL) Verification
-
-Security and safety are paramount when an AI has access to your file system and terminal. Flux Flow implements several layers of verification:
-
-### Tool Approval
-By default, the agent **cannot** execute dangerous actions without your consent.
-- **Terminal Approval**: If the agent attempts to run a shell command (`exec_command`), a dedicated approval screen appears showing the exact command. You can **Allow** or **Deny** the execution.
-- **File Approval**: Similar to terminal commands, writing or updating files requires manual approval unless configured otherwise.
-- **Safe Commands**: Basic read-only commands (like `ls`, `git status`, `pwd`) are automatically allowed to minimize friction.
-
-### Auto-Execution (Advanced)
-For power users, **Auto-Exec** can be enabled in `/settings`.
-- **⚠️ Warning**: This allows the agent to run any tool and execute any command autonomously.
-- **External Access**: You can also toggle whether the agent is allowed to access files outside of its current working directory.
-
-## 🔄 Steering & Resolution
-
-### Real-time Steering
-If you realize the agent is going down the wrong path *while* it is in an agentic loop, you can provide "Steering Hints." The system will inject your feedback into the next loop to course-correct the agent.
-
-### Resolution Modal
-If the agent finishes its task just as you send a steering hint, a **Resolution Modal** appears. It asks if you want to:
-- **Send Anyway**: Start a new loop with your feedback.
-- **Edit Prompt**: Refine your feedback before sending.
-
-## 📊 Status Bar & Feedback
-The bottom of the screen features a dynamic status bar showing:
-- **Active Mode** (Flux/Flow)
-- **Thinking Level**
-- **Token Usage**: Real-time tracking of tokens used in the current session.
-- **Agentic Loops**: Counters showing how many times the agent has "looped" to solve the current task.
-- **API Status**: Visual feedback when the model is thinking or executing a tool.
-
-## 🚑 System Integrity & Self-Healing
-
-Flux Flow is a "Self-Healing" agent. It actively monitors its own environment to ensure all complex dependencies (like the Chromium engine for PDF generation) are ready for action.
-
-- **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.
+# 🎮 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.
+
+## ⌨️ Command System
+
+You can control the application using `/` commands directly in the chat input:
+
+- **/mode [flux|flow]**: Quickly switch between **Flux** (Dev) and **Flow** (Chat) modes. Using it without arguments opens the selection menu.
+- **/thinking [low|medium|high|max|show|hide]**: Adjust reasoning depth or toggle visibility of the thinking process. Using it without arguments opens the selection menu.
+- **/model [name]**: Choose which AI model to use for the main interaction.
+- **/key**: Open the API Key management view to update or remove your credentials.
+- **/settings**: Access the system configuration menu.
+- **/profile**: Update your name, nickname, and custom instructions.
+- **/update**: Update Flux Flow to the latest version.
+- **/memory**: View and manage the persistent memories extracted by the Janitor.
+- **/resume <chat-id>**: Switch back to a previous conversation.
+- **/changelog**: Open the project's changelog in your default browser.
+- **/help**: List all available commands.
+
+## 📁 External Data Sanctuary (Redirection)
+
+Flux Flow allows you to "Anchor" your data outside of the default user directory. This is perfect for users who want to keep their logs, chat history, and encrypted memories on an external drive, a VeraCrypt volume, or a specific project folder.
+
+- **How to Enable**: Open `/settings` and toggle **Use External Data**. 
+- **Portability**: Once set, the application will synchronously "pivot" all data operations to your specified `externalDataPath` upon startup.
+- **Privacy**: Keeps sensitive data off your primary system drive.
+
+
+### Command Shortcuts
+
+For power users, several commands support direct arguments to skip the menus:
+- ` /mode flux ` or ` /mode flow `
+- ` /thinking low ` / ` /thinking medium ` / ` /thinking high ` / ` /thinking max `
+- ` /thinking show ` / ` /thinking hide ` (Toggles thinking process visibility)
+- ` /model gemini-3.1-pro-preview ` (Switches model directly)
+- ` /update check ` (Checks for updates)
+
+## 🧠 Thinking Levels & Visualization
+
+Flux Flow separates the model's "internal monologue" (reasoning) from its final response using `<think>` tags.
+
+- **Thinking Levels**: Depending on the mode, you can choose from **Low**, **Medium**, **High**, or **Max**. Higher levels allow the agent more "space" to reason through complex architecture or debugging problems.
+- **Show/Hide Thinking**: You can toggle the visibility of the thinking process using `/thinking show/hide`.
+  - When **Hidden**, the agent doesn't just disappear; it provides a "minimalist" view showing only the core **Headings** and **Action Steps** (bolded lines) from its reasoning. This keeps you informed of its current "step" without cluttering the screen with detailed internal monologue.
+
+## ⚡ Interactive Sub-Terminal
+
+Flux Flow features a high-fidelity, interactive sub-terminal that allows you to engage with commands spawned by the agent in real-time.
+
+- **Live Interaction**: When an agent executes a command (like `npm init`, `git commit`, or a custom script), the terminal output appears in a dedicated box.
+- **Focus Toggling (`TAB`)**: While a terminal is live, you can press **`TAB`** to shift your keyboard focus from the chat prompt directly into the terminal.
+- **Visual Feedback**:
+  - **Yellow Glow**: When the terminal is focused, its border changes to a "Double Yellow" style to indicate it is capturing input.
+  - **Status Indicator**: The footer will change from `● LIVE` to `▶ TERMINAL FOCUSED`.
+- **Cross-Platform Compatibility**: The input bridge automatically detects your OS and sends the correct line endings (`\r\n` for Windows, `\n` for Unix), ensuring that interactive prompts like `y/n` work seamlessly across environments.
+- **Input Mirroring**: Your keystrokes are mirrored in the terminal box in real-time, providing an IDE-grade responsive feel.
+
+> [!TIP]
+> Use the Interactive Sub-Terminal to handle authentication prompts, confirmation dialogs, or to manually steering a long-running process without leaving the Flux Flow interface.
+
+## 🛡️ Human-in-the-Loop (HITL) Verification
+
+Security and safety are paramount when an AI has access to your file system and terminal. Flux Flow implements several layers of verification:
+
+### Tool Approval
+By default, the agent **cannot** execute dangerous actions without your consent.
+- **Terminal Approval**: If the agent attempts to run a shell command (`exec_command`), a dedicated approval screen appears showing the exact command. You can **Allow** or **Deny** the execution.
+- **File Approval**: Similar to terminal commands, writing or updating files requires manual approval unless configured otherwise.
+- **Safe Commands**: Basic read-only commands (like `ls`, `git status`, `pwd`) are automatically allowed to minimize friction.
+
+### Auto-Execution (Advanced)
+For power users, **Auto-Exec** can be enabled in `/settings`.
+- **⚠️ Warning**: This allows the agent to run any tool and execute any command autonomously.
+- **External Access**: You can also toggle whether the agent is allowed to access files outside of its current working directory.
+
+## 🔄 Steering & Resolution
+
+### Real-time Steering
+If you realize the agent is going down the wrong path *while* it is in an agentic loop, you can provide "Steering Hints." The system will inject your feedback into the next loop to course-correct the agent.
+
+### Resolution Modal
+If the agent finishes its task just as you send a steering hint, a **Resolution Modal** appears. It asks if you want to:
+- **Send Anyway**: Start a new loop with your feedback.
+- **Edit Prompt**: Refine your feedback before sending.
+
+## 📊 Status Bar & Feedback
+The bottom of the screen features a dynamic status bar showing:
+- **Active Mode** (Flux/Flow)
+- **Thinking Level**
+- **Token Usage**: Real-time tracking of tokens used in the current session.
+- **Agentic Loops**: Counters showing how many times the agent has "looped" to solve the current task.
+- **API Status**: Visual feedback when the model is thinking or executing a tool.
+
+## 🚑 System Integrity & Self-Healing
+
+Flux Flow is a "Self-Healing" agent. It actively monitors its own environment to ensure all complex dependencies (like the Chromium engine for PDF generation) are ready for action.
+
+- **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.

package/dist/fluxflow.js

@@ -23,39 +23,81 @@ var init_TerminalBox = __esm({
 });
 
 // src/components/ChatLayout.jsx
-import React2 from "react";
+import React2, { useState, useEffect, useRef } from "react";
 import { Box as Box2, Text as Text2 } from "ink";
-var cleanSignals, formatThinkText, InlineMarkdown, wrapText, TableRenderer, MarkdownText, DiffLine, DiffBlock, CodeRenderer, MessageItem, ChatLayout, ChatLayout_default;
+var TypewriterText, cleanSignals, formatThinkText, InlineMarkdown, wrapText, TableRenderer, MarkdownText, DiffLine, DiffBlock, CodeRenderer, MessageItem, ChatLayout, ChatLayout_default;
 var init_ChatLayout = __esm({
   "src/components/ChatLayout.jsx"() {
     init_TerminalBox();
+    TypewriterText = ({ text, isStreaming, onComplete, columns = 80, color = "white", speed = 50, render }) => {
+      const [displayedText, setDisplayedText] = useState("");
+      const fullTextRef = useRef(text);
+      const displayedTextRef = useRef("");
+      useEffect(() => {
+        fullTextRef.current = text;
+      }, [text]);
+      useEffect(() => {
+        const timer = setInterval(() => {
+          const currentFull = fullTextRef.current;
+          const currentDisp = displayedTextRef.current;
+          if (currentDisp.length < currentFull.length) {
+            const remaining = currentFull.slice(currentDisp.length);
+            const match = remaining.match(/^(\S+\s*|\s+)/);
+            if (match) {
+              const chunk = match[0];
+              const gap = currentFull.length - currentDisp.length;
+              let revealedChunk = chunk;
+              if (gap > 100) {
+                const extraMatch = remaining.slice(chunk.length).match(/^(\S+\s*|\s+){0,2}/);
+                if (extraMatch) revealedChunk += extraMatch[0];
+              }
+              const nextText = currentDisp + revealedChunk;
+              setDisplayedText(nextText);
+              displayedTextRef.current = nextText;
+            }
+          } else if (!isStreaming) {
+            if (onComplete) onComplete();
+            clearInterval(timer);
+          }
+        }, speed);
+        return () => clearInterval(timer);
+      }, [isStreaming, speed]);
+      if (render) return render(displayedText);
+      return /* @__PURE__ */ React2.createElement(CodeRenderer, { text: displayedText, columns });
+    };
     cleanSignals = (text) => {
       if (!text) return text;
-      const parts = [];
-      let i = 0;
-      while (i < text.length) {
-        const trigger = "tool:functions.";
-        if (text.substring(i, i + trigger.length).toLowerCase() === trigger) {
-          let balance = 0;
-          let foundStart = false;
-          let j = i;
-          while (j < text.length) {
-            if (text[j] === "(") {
+      let result = text;
+      const trigger = "tool:functions.";
+      while (true) {
+        const lowerResult = result.toLowerCase();
+        const startIdx = lowerResult.indexOf(trigger);
+        if (startIdx === -1) break;
+        let balance = 0;
+        let foundStart = false;
+        let inString = null;
+        let j = startIdx;
+        while (j < result.length) {
+          const char = result[j];
+          if (!inString && (char === "'" || char === '"' || char === "`")) {
+            inString = char;
+          } else if (inString && char === inString && result[j - 1] !== "\\") {
+            inString = null;
+          }
+          if (!inString) {
+            if (char === "(") {
               balance++;
               foundStart = true;
-            } else if (text[j] === ")") {
+            } else if (char === ")") {
               balance--;
             }
-            j++;
-            if (foundStart && balance === 0) break;
           }
-          i = j;
-        } else {
-          parts.push(text[i]);
-          i++;
+          j++;
+          if (foundStart && balance === 0 && !inString) break;
         }
+        result = result.substring(0, startIdx) + result.substring(j);
       }
-      return parts.join("").replace(/^\[TOOL_RESULT\]:\s*/gi, "").split("\n").filter((line) => !line.trim().startsWith("SUCCESS:") && !line.trim().startsWith("ERROR:")).join("\n").replace(/\[\s*(turn\s*:)?\s*(continue|finish)\s*\]/gi, "").replace(/\n\s*turn\s*:\s*(continue|finish)\s*$/gi, "").replace(/\n\nResponded on .*/g, "").replace(/\n\n\[Prompted on: .*\]/g, "").replace(/(\$?\\?\/?\\rightarrow\$?|\$\\rightarrow\$)/gi, "\u2192").replace(/(\$?\\?\/?\\leftarrow\$?|\$\\leftarrow\$)/gi, "\u2190").replace(/(\$?\\?\/?\\uparrow\$?|\$\\uparrow\$)/gi, "\u2191").replace(/(\$?\\?\/?\\downarrow\$?|\$\\downarrow\$)/gi, "\u2193").replace(/(\$?\\?\/?\\leftrightarrow\$?|\$\\leftrightarrow\$)/gi, "\u2194").trim();
+      return result.replace(/^\[TOOL_RESULT\]:\s*/gi, "").split("\n").filter((line) => !line.trim().startsWith("SUCCESS:") && !line.trim().startsWith("ERROR:")).join("\n").replace(/\[\s*(turn\s*:)?\s*(continue|finish)\s*\]/gi, "").replace(/\n\s*turn\s*:\s*(continue|finish)\s*$/gi, "").replace(/\n\nResponded on .*/g, "").replace(/\n\n\[Prompted on: .*\]/g, "").replace(/(\$?\\?\/?\\rightarrow\$?|\$\\rightarrow\$)/gi, "\u2192").replace(/(\$?\\?\/?\\leftarrow\$?|\$\\leftarrow\$)/gi, "\u2190").replace(/(\$?\\?\/?\\uparrow\$?|\$\\uparrow\$)/gi, "\u2191").replace(/(\$?\\?\/?\\downarrow\$?|\$\\downarrow\$)/gi, "\u2193").replace(/(\$?\\?\/?\\leftrightarrow\$?|\$\\leftrightarrow\$)/gi, "\u2194").trim();
     };
     formatThinkText = (cleaned, columns = 80) => {
       if (!cleaned) return null;
@@ -257,6 +299,9 @@ var init_ChatLayout = __esm({
     MessageItem = React2.memo(({ msg, showFullThinking, columns = 80 }) => {
       const isDiffResult = msg.role === "system" && msg.text?.includes("[DIFF_START]");
       const isTerminalRecord = msg.isTerminalRecord;
+      if (msg.isVisualFeedback) {
+        return /* @__PURE__ */ React2.createElement(Box2, { marginBottom: 1, paddingX: 1, width: "100%" }, /* @__PURE__ */ React2.createElement(Text2, { color: "white" }, msg.text));
+      }
       if (msg.role === "system" && msg.text?.includes("[TOOL_RESULT]") && !isDiffResult && !isTerminalRecord) return null;
       if (msg.isAskRecord) {
         const selectionMatch = msg.text.match(/Selection: (.*)/);
@@ -290,7 +335,11 @@ var init_ChatLayout = __esm({
         const outputList = outputMatch ? outputMatch[1] : "";
         return /* @__PURE__ */ React2.createElement(Box2, { marginBottom: 1, paddingX: 1, width: "100%" }, /* @__PURE__ */ React2.createElement(TerminalBox, { command: cmd, output: outputList, completed: true }));
       }
+      const [animationDone, setAnimationDone] = React2.useState(!msg.isStreaming);
       const content = React2.useMemo(() => cleanSignals(msg.text), [msg.text]);
+      React2.useEffect(() => {
+        if (msg.isStreaming) setAnimationDone(false);
+      }, [msg.id]);
       const finalContent = React2.useMemo(() => {
         if (msg.role === "think" && !showFullThinking) {
           const lines = content.split("\n").filter((line) => {
@@ -317,7 +366,24 @@ var init_ChatLayout = __esm({
           finalContent.replace(/\r\n/g, "\n").replace(/\r/g, "\n").replace(/\\\n/g, "\n").replace(/\\$/, ""),
           columns - 6
         ).split("\n").map((line, lineIdx) => /* @__PURE__ */ React2.createElement(Box2, { key: lineIdx, flexDirection: "row", width: "100%" }, /* @__PURE__ */ React2.createElement(Box2, { flexShrink: 0, width: 2 }, /* @__PURE__ */ React2.createElement(Text2, { bold: true, color: "white" }, lineIdx === 0 ? "\u276F" : " ")), /* @__PURE__ */ React2.createElement(Box2, { flexGrow: 1, marginLeft: 1 }, /* @__PURE__ */ React2.createElement(Text2, { color: msg.color || "white", wrap: "anywhere" }, line))))
-      ) : msg.role === "think" ? /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", marginTop: 1, paddingX: 1, width: "100%" }, /* @__PURE__ */ React2.createElement(Text2, { bold: true, color: "white" }, "Thinking..."), /* @__PURE__ */ React2.createElement(Box2, { borderStyle: "single", borderLeft: true, borderRight: false, borderTop: false, borderBottom: false, paddingLeft: 2, flexDirection: "column", width: "100%" }, formatThinkText(finalContent, columns))) : /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", paddingX: 1, marginTop: 1, width: "100%" }, /* @__PURE__ */ React2.createElement(CodeRenderer, { text: finalContent, columns }), msg.memoryUpdated && /* @__PURE__ */ React2.createElement(Box2, { marginTop: 1, width: "100%" }, /* @__PURE__ */ React2.createElement(Text2, { color: "yellow", italic: true }, "\u2728 [Memory Updated]"))));
+      ) : msg.role === "think" ? /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", marginTop: 1, paddingX: 1, width: "100%" }, /* @__PURE__ */ React2.createElement(Text2, { bold: true, color: "white" }, "Thinking..."), /* @__PURE__ */ React2.createElement(Box2, { borderStyle: "single", borderLeft: true, borderRight: false, borderTop: false, borderBottom: false, paddingLeft: 2, flexDirection: "column", width: "100%" }, !animationDone ? /* @__PURE__ */ React2.createElement(
+        TypewriterText,
+        {
+          text: finalContent,
+          isStreaming: msg.isStreaming,
+          onComplete: () => setAnimationDone(true),
+          speed: 25,
+          render: (t) => formatThinkText(t, columns)
+        }
+      ) : formatThinkText(finalContent, columns))) : /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", paddingX: 1, marginTop: 1, width: "100%" }, !animationDone ? /* @__PURE__ */ React2.createElement(
+        TypewriterText,
+        {
+          text: finalContent,
+          isStreaming: msg.isStreaming,
+          onComplete: () => setAnimationDone(true),
+          columns
+        }
+      ) : /* @__PURE__ */ React2.createElement(CodeRenderer, { text: finalContent, columns }), msg.memoryUpdated && /* @__PURE__ */ React2.createElement(Box2, { marginTop: 1, width: "100%" }, /* @__PURE__ */ React2.createElement(Text2, { color: "yellow", italic: true }, "\u2728 [Memory Updated]"))));
     });
     ChatLayout = React2.memo(({ messages, showFullThinking, columns = 80 }) => {
       return /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", width: "100%" }, messages.map((msg, idx) => /* @__PURE__ */ React2.createElement(
@@ -389,13 +455,13 @@ var init_CommandMenu = __esm({
 });
 
 // src/components/ProfileForm.jsx
-import React5, { useState } from "react";
+import React5, { useState as useState2 } from "react";
 import { Box as Box5, Text as Text5 } from "ink";
 import TextInput from "ink-text-input";
 function ProfileForm({ onSave, onCancel }) {
-  const [step, setStep] = useState(0);
-  const [currentInput, setCurrentInput] = useState("");
-  const [profile, setProfile] = useState({ name: "", nickname: "", instructions: "" });
+  const [step, setStep] = useState2(0);
+  const [currentInput, setCurrentInput] = useState2("");
+  const [profile, setProfile] = useState2({ name: "", nickname: "", instructions: "" });
   const steps = [
     { key: "name", label: "Enter your Name: " },
     { key: "nickname", label: "Enter a Nickname (Agent will use this): " },
@@ -427,16 +493,16 @@ var init_ProfileForm = __esm({
 });
 
 // src/components/AskUserModal.jsx
-import React6, { useState as useState2 } from "react";
+import React6, { useState as useState3 } from "react";
 import { Box as Box6, Text as Text6, useInput } from "ink";
 import TextInput2 from "ink-text-input";
 var AskUserModal, AskUserModal_default;
 var init_AskUserModal = __esm({
   "src/components/AskUserModal.jsx"() {
     AskUserModal = ({ question, options, onResolve }) => {
-      const [isSuggestingElse, setIsSuggestingElse] = useState2(false);
-      const [customInput, setCustomInput] = useState2("");
-      const [selectedIndex, setSelectedIndex] = useState2(0);
+      const [isSuggestingElse, setIsSuggestingElse] = useState3(false);
+      const [customInput, setCustomInput] = useState3("");
+      const [selectedIndex, setSelectedIndex] = useState3(0);
       const allOptions = [...options, { id: "CUSTOM", label: "Suggest something else...", description: "Provide a custom response" }];
       useInput((input, key) => {
         if (isSuggestingElse) return;
@@ -612,10 +678,10 @@ ${mode === "Flux" ? `
     3. Read Folder: tool:functions.read_folder(path="relative/path"). Detailed stats of a directory.
     4. Write File: tool:functions.write_file(path="path", content="content"). Creates/Overwrites. NO CODE BLOCKS. RETURNS: Disk verification + original content (if overwritten) for 100% reversibility.
     5. Update File: tool:functions.update_file(path="relative/path", content_to_replace="old", content_to_add="new"). Surgical patching. RETURNS: High-fidelity visual diff and old code block. You MUST verify that the change specifically matches your intent using the returned diff. PREFFER UPDATE FILE OVER WRITE FILE if file already exists for better reversal tracking (if a file has 500+ lines, try to stick with update_file over full-rewrite). DONT WRAP UPDATE FILE CALL CONTENT IN MARKDOWN CODE BLOCKS.
-    6. Write PDF: tool:functions.write_pdf(path="path", content="<html/css content>", orientation="portrait/landscape"). Generates a professional PDF document. Orientation are optional. A4 size page will be used. DO NOT ADD FOOTER MANUALLY, the system will handle it automatically. USE CSS TO VISUALLY BEAUTIFY THE DOCUMENT.
+    6. Write PDF: tool:functions.write_pdf(path="path", content="<html/css content>", orientation="portrait/landscape"). Generates a professional PDF document. Orientation are optional. A4 size page will be used, so any multi-page PDFs calculate your alightment and page breaks to not mess up A4 page layout . DO NOT ADD FOOTER MANUALLY, the system will handle it automatically. USE CSS TO VISUALLY BEAUTIFY THE DOCUMENT.
     7. Execution: tool:functions.exec_command(command="terminal command"). Runs a shell command.
 
-    **NOTE:** WHEN WRITING/UPDATING FILES, USE ACTUAL NEW LINE CHARACTER FOR LINE BREAKS RATHER THAN STRING '\\n'`.trim() : `
+    **NOTE:** WHEN WRITING/UPDATING FILES, USE ACTUAL NEW LINE CONTROL CHARACTER (LF) FOR LINE BREAKS RATHER THAN STRING '\\n'`.trim() : `
     - DEV & FILE TOOLS ARE NOT AVAILABLE IN FLOW MODE. If you need to access files, tell the user to switch to FLUX MODE (manually by user).`.trim()}
 -----------------
 Results will be provided in the next loop as: [TOOL_RESULT]: [content]
@@ -957,21 +1023,24 @@ var init_arg_parser = __esm({
   "src/utils/arg_parser.js"() {
     parseArgs = (argsString) => {
       const args = {};
-      const regex = /(\w+)\s*=\s*(?:(["'])((?:\\.|(?!\2)[\s\S])*)\2|([^,\s\)]+))/g;
+      const regex = /(\w+)\s*=\s*(?:(["'`])((?:\\.|(?!\2)[\s\S])*)\2|([^,\s\)]+))/g;
       let match;
       while ((match = regex.exec(argsString)) !== null) {
         const key = match[1];
         let value = match[3] !== void 0 ? match[3] : match[4];
         if (match[3] !== void 0) {
           try {
-            value = JSON.parse(`"${value.replace(/"/g, '\\"').replace(/\n/g, "\\n")}"`);
+            value = JSON.parse(`"${value.replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r")}"`);
           } catch (e) {
-            value = value.replace(/\\"/g, '"').replace(/\\'/g, "'").replace(/\\\\/g, "\\");
+            value = value.replace(/\\"/g, '"').replace(/\\'/g, "'").replace(/\\`/g, "`").replace(/\\\\/g, "\\");
           }
         }
         if (value === "true") value = true;
         else if (value === "false") value = false;
         else if (typeof value === "string" && !isNaN(value) && value.trim() !== "") value = Number(value);
+        if (typeof value === "string" && (key.toLowerCase().includes("path") || ["dest", "source", "to", "from"].includes(key.toLowerCase()))) {
+          value = value.replace(/\x0C/g, "\\f").replace(/\x0D/g, "\\r").replace(/\x0B/g, "\\v").replace(/\x08/g, "\\b");
+        }
         args[key] = value;
       }
       return args;
@@ -1360,7 +1429,11 @@ var init_view_file = __esm({
             }
           };
         }
-        const content = fs9.readFileSync(absolutePath, "utf8");
+        let content = fs9.readFileSync(absolutePath, "utf8");
+        if (content.startsWith("\uFEFF")) {
+          content = content.slice(1);
+        }
+        content = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
         const lines = content.split("\n");
         const totalLines = lines.length;
         const start = Math.max(0, start_line - 1);
@@ -1389,7 +1462,7 @@ var init_write_file = __esm({
       let { path: targetPath, content } = parseArgs(args);
       if (!targetPath) return 'ERROR: Missing "path" argument for write_file.';
       if (content === void 0) return 'ERROR: Missing "content" argument for write_file.';
-      content = content.replace(/^```[\w]*\n?/, "").replace(/```\s*$/, "").trim();
+      content = content.replace(/^```[\w]*\n?/, "").replace(/```\s*$/, "").replace(/\r\n/g, "\n").replace(/\r/g, "\n");
       const absolutePath = path10.resolve(process.cwd(), targetPath);
       const parentDir = path10.dirname(absolutePath);
       try {
@@ -1459,7 +1532,7 @@ var init_update_file = __esm({
       if (!targetPath) return 'ERROR: Missing "path" argument for update_file.';
       if (content_to_replace === void 0) return 'ERROR: Missing "content_to_replace" argument.';
       if (content_to_add === void 0) return 'ERROR: Missing "content_to_add" argument.';
-      const strip = (t) => t.replace(/^```[\w]*\n?/, "").replace(/```\s*$/, "").trim();
+      const strip = (t) => t.replace(/^```[\w]*\n?/, "").replace(/```\s*$/, "").replace(/\r\n/g, "\n").replace(/\r/g, "\n");
       content_to_replace = strip(content_to_replace);
       content_to_add = strip(content_to_add);
       const absolutePath = path11.resolve(process.cwd(), targetPath);
@@ -1467,9 +1540,23 @@ var init_update_file = __esm({
         if (!fs11.existsSync(absolutePath)) {
           return `ERROR: File [${targetPath}] does not exist. Use write_file instead.`;
         }
-        const currentContent = fs11.readFileSync(absolutePath, "utf8");
+        let diskContent = fs11.readFileSync(absolutePath, "utf8");
+        if (diskContent.startsWith("\uFEFF")) {
+          diskContent = diskContent.slice(1);
+        }
+        const normalizedDisk = diskContent.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+        if (diskContent !== normalizedDisk) {
+          fs11.writeFileSync(absolutePath, normalizedDisk, "utf8");
+          diskContent = normalizedDisk;
+        }
+        const currentContent = diskContent;
         if (!currentContent.includes(content_to_replace)) {
-          return `ERROR: Could not find exact match for the specified "content_to_replace" in [${targetPath}]. Check indentation/whitespace/line breaks(LF or CRLF)/string. Try re-reading the file for latest changes.`;
+          const diskLen = currentContent.length;
+          const matchLen = content_to_replace.length;
+          return `ERROR: Could not find exact match for the specified "content_to_replace" in [${targetPath}].
+- Disk Content Length (Normalized): ${diskLen}
+- Match String Length (Normalized): ${matchLen}
+- Check indentation/whitespace/line breaks. Try re-reading the file for latest changes.`;
         }
         const startPos = currentContent.indexOf(content_to_replace);
         const startLine = currentContent.substring(0, startPos).split(/\r?\n/).length;
@@ -1709,12 +1796,18 @@ var init_ask_user = __esm({
 import puppeteer3 from "puppeteer";
 import path13 from "path";
 import fs13 from "fs-extra";
+import { PDFDocument } from "pdf-lib";
 var write_pdf;
 var init_write_pdf = __esm({
   "src/tools/write_pdf.js"() {
     init_arg_parser();
     write_pdf = async (args) => {
-      const { path: targetPath, content, orientation = "portrait", margin = "10px" } = parseArgs(args);
+      const {
+        path: targetPath,
+        content,
+        orientation = "portrait",
+        margin = "10px"
+      } = parseArgs(args);
       if (!targetPath) return 'ERROR: Missing "path" argument for write_pdf.';
       if (!content) return 'ERROR: Missing "content" (HTML/CSS) for write_pdf.';
       const absolutePath = path13.resolve(process.cwd(), targetPath);
@@ -1733,39 +1826,57 @@ var init_write_pdf = __esm({
         const page = await browser.newPage();
         const styledContent = `
             <style>
-                @page { 
-                    margin: ${margin}; 
+                @page {
+                    margin: ${margin};
                 }
-                body { 
-                    margin: 0; 
+                body {
+                    margin: 0;
                     padding: 0;
                     font-family: system-ui, -apple-system, sans-serif;
                 }
                 * { box-sizing: border-box; }
+                .watermark {
+                    position: fixed;
+                    top: 50%;
+                    left: 50%;
+                    transform: translate(-50%, -50%) rotate(-50deg);
+                    font-size: 52px;
+                    font-weight: bold;
+                    color: rgba(0, 0, 0, 0.005);
+                    pointer-events: none;
+                    z-index: -1000;
+                    text-align: center;
+                    width: 150%;
+                    white-space: nowrap;
+                    text-transform: uppercase;
+                    letter-spacing: 5px;
+                }
             </style>
+            <div class="watermark">Generated by FluxFlow CLI (AI)</div>
             ${content}
         `;
         await page.setContent(styledContent, { waitUntil: "networkidle0" });
-        await page.pdf({
-          path: absolutePath,
+        const pdfBytes = await page.pdf({
           format: "A4",
           landscape: orientation.toLowerCase() === "landscape",
           margin: {
             top: margin,
             right: margin,
-            bottom: "15mm",
-            // Space for watermark
+            bottom: margin,
             left: margin
           },
-          displayHeaderFooter: true,
-          headerTemplate: "<span></span>",
-          footerTemplate: `
-                <div style="font-size: 9px; color: rgba(0,0,0,0.2); width: 100%; text-align: right; padding-right: 15mm; font-family: system-ui, sans-serif; -webkit-print-color-adjust: exact;">
-                    FluxFlow CLI
-                </div>
-            `,
           printBackground: true
         });
+        const pdfDoc = await PDFDocument.load(pdfBytes);
+        const fileName = path13.basename(targetPath);
+        pdfDoc.setTitle(`FluxFlow ${fileName}`);
+        pdfDoc.setAuthor("FluxFlow CLI");
+        pdfDoc.setSubject("Generated with AI");
+        pdfDoc.setKeywords(["FluxFlow", "AI", "Agentic", "Automated"]);
+        pdfDoc.setCreator("FluxFlow PDF Engine");
+        pdfDoc.setProducer("FluxFlow (Generative AI)");
+        const finalPdfBytes = await pdfDoc.save();
+        await fs13.writeFile(absolutePath, finalPdfBytes);
         const stats = await fs13.stat(absolutePath);
         return `SUCCESS: PDF generated successfully at [${targetPath}] (${(stats.size / 1024).toFixed(2)} KB).`;
       } catch (err) {
@@ -1865,39 +1976,47 @@ var init_ai = __esm({
     };
     detectToolCalls = (text) => {
       const results = [];
-      const toolRegex = /(?:\[?\s*tool:functions\.)([a-z0-9_]+)\s*\(([\s\S]*?)\)(?:\s*\]?)/gi;
+      const toolRegex = /(?:\[?\s*tool:functions\.)([a-z0-9_]+)\s*\(/gi;
       let match;
       while ((match = toolRegex.exec(text)) !== null) {
-        const fullMatch = match[0];
         const toolName = match[1];
-        const args = match[2];
-        let openCount = (args.match(/\(/g) || []).length;
-        let closeCount = (args.match(/\)/g) || []).length;
-        let finalArgs = args;
-        let finalFullMatch = fullMatch;
-        if (openCount > closeCount) {
-          const startIdx = match.index + fullMatch.indexOf("(");
-          let balance = 0;
-          let endIdx = -1;
-          for (let i = startIdx; i < text.length; i++) {
-            if (text[i] === "(") balance++;
-            if (text[i] === ")") balance--;
+        const startIdx = match.index + match[0].length - 1;
+        let balance = 0;
+        let inString = null;
+        let isEscaped = false;
+        let endIdx = -1;
+        for (let i = startIdx; i < text.length; i++) {
+          const char = text[i];
+          if (!inString && (char === '"' || char === "'" || char === "`")) {
+            inString = char;
+            isEscaped = false;
+          } else if (inString && char === inString && !isEscaped) {
+            inString = null;
+          }
+          if (!inString) {
+            if (char === "(") balance++;
+            else if (char === ")") balance--;
             if (balance === 0) {
               endIdx = i;
               break;
             }
           }
-          if (endIdx !== -1) {
-            finalArgs = text.substring(startIdx + 1, endIdx);
-            finalFullMatch = text.substring(match.index, endIdx + 1);
-            toolRegex.lastIndex = endIdx + 1;
+          if (char === "\\") {
+            isEscaped = !isEscaped;
+          } else {
+            isEscaped = false;
           }
         }
-        results.push({
-          fullMatch: finalFullMatch,
-          toolName: toolName.trim(),
-          args: finalArgs.trim()
-        });
+        if (endIdx !== -1) {
+          const finalArgs = text.substring(startIdx + 1, endIdx);
+          const finalFullMatch = text.substring(match.index, endIdx + 1);
+          results.push({
+            fullMatch: finalFullMatch,
+            toolName: toolName.trim(),
+            args: finalArgs.trim()
+          });
+          toolRegex.lastIndex = endIdx + 1;
+        }
       }
       return results;
     };
@@ -1933,7 +2052,7 @@ USER_PROMPT: ${agentText}`.trim();
       let lastUsage = null;
       const MAX_LOOPS = mode === "Flux" ? 50 : 7;
       const MAX_RETRIES = 7;
-      yield { type: "status", content: "Working..." };
+      yield { type: "status", content: "Connecting..." };
       TERMINATION_SIGNAL = false;
       let fullAgentResponseChunks = [];
       modifiedHistory.forEach((msg) => {
@@ -2036,6 +2155,7 @@ USER_PROMPT: ${agentText}`.trim();
           lastUsage = chunk.usageMetadata;
           if (lastUsage) {
             yield { type: "liveTokens", content: lastUsage.totalTokenCount };
+            yield { type: "status", content: "Working..." };
           }
         }
         await incrementUsage("agent");
@@ -2043,7 +2163,11 @@ USER_PROMPT: ${agentText}`.trim();
           yield { type: "usage", content: lastUsage };
         }
         fullAgentResponseChunks.push(turnText);
-        const textToProcess = turnText.replace(/<think>[\s\S]*?<\/think>/g, "");
+        let textToProcess = turnText;
+        const thinkMatch = turnText.match(/<think>([\s\S]*?)<\/think>/i);
+        if (thinkMatch) {
+          textToProcess = turnText.replace(/<think>[\s\S]*?<\/think>/i, "");
+        }
         const turnTextLower = textToProcess.toLowerCase();
         const hasFinish = /\[\s*(turn\s*:)?\s*finish\s*\]/i.test(turnTextLower);
         const toolCalls = detectToolCalls(textToProcess);
@@ -2102,7 +2226,7 @@ USER_PROMPT: ${agentText}`.trim();
               const boxTop = `\u256D${"\u2500".repeat(boxWidth)}\u256E`;
               const boxMid = `\u2502 ${label.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`;
               const boxBottom = `\u2570${"\u2500".repeat(boxWidth)}\u256F`;
-              yield { type: "text", content: `
+              yield { type: "visual_feedback", content: `
 
 ${boxTop}
 ${boxMid}
@@ -2404,13 +2528,13 @@ var init_settings = __esm({
 });
 
 // src/components/ResumeModal.jsx
-import React7, { useState as useState3, useEffect } from "react";
+import React7, { useState as useState4, useEffect as useEffect2 } from "react";
 import { Box as Box7, Text as Text7, useInput as useInput2 } from "ink";
 function ResumeModal({ onSelect, onDelete, onClose }) {
-  const [history, setHistory] = useState3({});
-  const [keys, setKeys] = useState3([]);
-  const [selectedIndex, setSelectedIndex] = useState3(0);
-  useEffect(() => {
+  const [history, setHistory] = useState4({});
+  const [keys, setKeys] = useState4([]);
+  const [selectedIndex, setSelectedIndex] = useState4(0);
+  useEffect2(() => {
     const fetchHistory = async () => {
       const h = await loadHistory();
       setHistory(h);
@@ -2447,16 +2571,16 @@ var init_ResumeModal = __esm({
 });
 
 // src/components/MemoryModal.jsx
-import React8, { useState as useState4, useEffect as useEffect2 } from "react";
+import React8, { useState as useState5, useEffect as useEffect3 } from "react";
 import { Box as Box8, Text as Text8, useInput as useInput3 } from "ink";
 function MemoryModal({ onClose }) {
-  const [memories, setMemories] = useState4([]);
-  const [selectedIndex, setSelectedIndex] = useState4(0);
+  const [memories, setMemories] = useState5([]);
+  const [selectedIndex, setSelectedIndex] = useState5(0);
   const loadMemories = () => {
     const data = readEncryptedJson(MEMORIES_FILE, []);
     setMemories(data);
   };
-  useEffect2(() => {
+  useEffect3(() => {
     loadMemories();
   }, []);
   useInput3((input, key) => {
@@ -2486,7 +2610,7 @@ var init_MemoryModal = __esm({
 });
 
 // src/components/UpdateProcessor.jsx
-import React9, { useState as useState5, useEffect as useEffect3 } from "react";
+import React9, { useState as useState6, useEffect as useEffect4 } from "react";
 import { Box as Box9, Text as Text9 } from "ink";
 import Spinner from "ink-spinner";
 import { exec } from "child_process";
@@ -2494,10 +2618,10 @@ var UpdateProcessor, UpdateProcessor_default;
 var init_UpdateProcessor = __esm({
   "src/components/UpdateProcessor.jsx"() {
     UpdateProcessor = ({ latest, current, settings, onClose, onUpdateSettings, onSuccess }) => {
-      const [status, setStatus] = useState5("initializing");
-      const [log, setLog] = useState5("");
-      const [error, setError] = useState5(null);
-      useEffect3(() => {
+      const [status, setStatus] = useState6("initializing");
+      const [log, setLog] = useState6("");
+      const [error, setError] = useState6(null);
+      useEffect4(() => {
         const runUpdate = async () => {
           const manager = settings.updateManager || "npm";
           if (!settings.updateManager) {
@@ -2584,7 +2708,7 @@ var app_exports = {};
 __export(app_exports, {
   default: () => App
 });
-import React10, { useState as useState6, useEffect as useEffect4, useRef, useMemo } from "react";
+import React10, { useState as useState7, useEffect as useEffect5, useRef as useRef2, useMemo } from "react";
 import { Box as Box10, Text as Text10, useInput as useInput4, useStdout } from "ink";
 import Spinner2 from "ink-spinner";
 import fs17 from "fs-extra";
@@ -2594,14 +2718,14 @@ import TextInput3 from "ink-text-input";
 import gradient from "gradient-string";
 function App() {
   const { stdout } = useStdout();
-  const [input, setInput] = useState6("");
-  const [isExpanded, setIsExpanded] = useState6(false);
-  const [mode, setMode] = useState6("Flux");
-  const [terminalSize, setTerminalSize] = useState6({
+  const [input, setInput] = useState7("");
+  const [isExpanded, setIsExpanded] = useState7(false);
+  const [mode, setMode] = useState7("Flux");
+  const [terminalSize, setTerminalSize] = useState7({
     columns: stdout?.columns || 80,
     rows: stdout?.rows || 24
   });
-  const [selectedIndex, setSelectedIndex] = useState6(0);
+  const [selectedIndex, setSelectedIndex] = useState7(0);
   const performVersionCheck = async (manual = false, settingsOverride = null) => {
     const settingsToUse = settingsOverride || systemSettings;
     if (manual) {
@@ -2648,7 +2772,7 @@ Check what's new using \`/changelog\` command.`,
       }
     }
   };
-  useEffect4(() => {
+  useEffect5(() => {
     const handleResize = () => {
       stdout.write("\x1Bc");
       setTerminalSize({
@@ -2661,29 +2785,29 @@ Check what's new using \`/changelog\` command.`,
       stdout.off("resize", handleResize);
     };
   }, [stdout]);
-  const [thinkingLevel, setThinkingLevel] = useState6("Medium");
-  const [latestVer, setLatestVer] = useState6(null);
-  const [showFullThinking, setShowFullThinking] = useState6(false);
-  const [activeModel, setActiveModel] = useState6("gemma-4-31b-it");
-  const [janitorModel, setJanitorModel] = useState6("gemma-4-26b-a4b-it");
-  const [isInitializing, setIsInitializing] = useState6(true);
-  const [apiKey, setApiKey] = useState6(null);
-  const [tempKey, setTempKey] = useState6("");
-  const [activeView, setActiveView] = useState6("chat");
-  const [apiTier, setApiTier] = useState6("Free");
-  const [quotas, setQuotas] = useState6({ agentLimit: 1500, backgroundLimit: 1500, searchLimit: 100, customModelId: "", customLimit: 0 });
-  const [inputConfig, setInputConfig] = useState6(null);
-  const [systemSettings, setSystemSettings] = useState6({ memory: true, compression: 0, autoExec: false, autoDeleteHistory: "7d", autoUpdate: false, updateManager: "npm", customUpdateCommand: "" });
-  const [profileData, setProfileData] = useState6({ name: null, nickname: null, instructions: null });
-  const [sessionStats, setSessionStats] = useState6({ tokens: 0 });
-  const [sessionAgentCalls, setSessionAgentCalls] = useState6(0);
-  const [sessionBackgroundCalls, setSessionBackgroundCalls] = useState6(0);
-  const [sessionTotalTokens, setSessionTotalTokens] = useState6(0);
-  const [dailyUsage, setDailyUsage] = useState6(null);
-  const [chatId, setChatId] = useState6(generateChatId());
-  const [activeCommand, setActiveCommand] = useState6(null);
-  const [execOutput, setExecOutput] = useState6("");
-  const [isTerminalFocused, setIsTerminalFocused] = useState6(false);
+  const [thinkingLevel, setThinkingLevel] = useState7("Medium");
+  const [latestVer, setLatestVer] = useState7(null);
+  const [showFullThinking, setShowFullThinking] = useState7(false);
+  const [activeModel, setActiveModel] = useState7("gemma-4-31b-it");
+  const [janitorModel, setJanitorModel] = useState7("gemma-4-26b-a4b-it");
+  const [isInitializing, setIsInitializing] = useState7(true);
+  const [apiKey, setApiKey] = useState7(null);
+  const [tempKey, setTempKey] = useState7("");
+  const [activeView, setActiveView] = useState7("chat");
+  const [apiTier, setApiTier] = useState7("Free");
+  const [quotas, setQuotas] = useState7({ agentLimit: 1500, backgroundLimit: 1500, searchLimit: 100, customModelId: "", customLimit: 0 });
+  const [inputConfig, setInputConfig] = useState7(null);
+  const [systemSettings, setSystemSettings] = useState7({ memory: true, compression: 0, autoExec: false, autoDeleteHistory: "7d", autoUpdate: false, updateManager: "npm", customUpdateCommand: "" });
+  const [profileData, setProfileData] = useState7({ name: null, nickname: null, instructions: null });
+  const [sessionStats, setSessionStats] = useState7({ tokens: 0 });
+  const [sessionAgentCalls, setSessionAgentCalls] = useState7(0);
+  const [sessionBackgroundCalls, setSessionBackgroundCalls] = useState7(0);
+  const [sessionTotalTokens, setSessionTotalTokens] = useState7(0);
+  const [dailyUsage, setDailyUsage] = useState7(null);
+  const [chatId, setChatId] = useState7(generateChatId());
+  const [activeCommand, setActiveCommand] = useState7(null);
+  const [execOutput, setExecOutput] = useState7("");
+  const [isTerminalFocused, setIsTerminalFocused] = useState7(false);
   const terminalEnv = useMemo(() => {
     const isIDE = process.env.TERM_PROGRAM === "vscode" || !!process.env.VSC_TERMINAL_URL || !!process.env.INTELLIJ_TERMINAL_COMMAND_BLOCKS;
     return {
@@ -2691,17 +2815,17 @@ Check what's new using \`/changelog\` command.`,
       shortcut: isIDE ? "Shift + Enter" : "Ctrl + Enter"
     };
   }, []);
-  const activeCommandRef = useRef(null);
-  const execOutputRef = useRef("");
-  useEffect4(() => {
+  const activeCommandRef = useRef2(null);
+  const execOutputRef = useRef2("");
+  useEffect5(() => {
     activeCommandRef.current = activeCommand;
   }, [activeCommand]);
-  useEffect4(() => {
+  useEffect5(() => {
     execOutputRef.current = execOutput;
   }, [execOutput]);
-  const [autoAcceptWrites, setAutoAcceptWrites] = useState6(false);
-  const [pendingApproval, setPendingApproval] = useState6(null);
-  const [pendingAsk, setPendingAsk] = useState6(null);
+  const [autoAcceptWrites, setAutoAcceptWrites] = useState7(false);
+  const [pendingApproval, setPendingApproval] = useState7(null);
+  const [pendingAsk, setPendingAsk] = useState7(null);
   const formatDuration = (totalSecs) => {
     const h = Math.floor(totalSecs / 3600);
     const m = Math.floor(totalSecs % 3600 / 60);
@@ -2712,18 +2836,18 @@ Check what's new using \`/changelog\` command.`,
     parts.push(`${s}s`);
     return parts.join(" ");
   };
-  const [statusText, setStatusText] = useState6(null);
-  const [isProcessing, setIsProcessing] = useState6(false);
-  const [escPressed, setEscPressed] = useState6(false);
-  const [escTimer, setEscTimer] = useState6(null);
-  const [queuedPrompt, setQueuedPrompt] = useState6(null);
-  const [resolutionData, setResolutionData] = useState6(null);
-  const [tempModelOverride, setTempModelOverride] = useState6(null);
-  const [messages, setMessages] = useState6([
+  const [statusText, setStatusText] = useState7(null);
+  const [isProcessing, setIsProcessing] = useState7(false);
+  const [escPressed, setEscPressed] = useState7(false);
+  const [escTimer, setEscTimer] = useState7(null);
+  const [queuedPrompt, setQueuedPrompt] = useState7(null);
+  const [resolutionData, setResolutionData] = useState7(null);
+  const [tempModelOverride, setTempModelOverride] = useState7(null);
+  const [messages, setMessages] = useState7([
     { id: "welcome", role: "system", text: FLUX_LOGO + "\n\n\u{1F30A}\u26A1 Welcome to Flux Flow! Type /help for commands.\n", isMeta: true }
   ]);
-  const queuedPromptRef = useRef(null);
-  const [completedIndex, setCompletedIndex] = useState6(1);
+  const queuedPromptRef = useRef2(null);
+  const [completedIndex, setCompletedIndex] = useState7(1);
   const windowedHistory = useMemo(() => {
     const MAX_LINES = 1e3;
     const width = stdout?.columns || 80;
@@ -2825,7 +2949,7 @@ Check what's new using \`/changelog\` command.`,
       setInput((prev) => prev.replace(/\\\r?$/, "").replace(/\r?$/, "") + "\n");
     }
   });
-  useEffect4(() => {
+  useEffect5(() => {
     async function init() {
       if (!checkPuppeteerReady()) {
         setMessages((prev) => {
@@ -2870,7 +2994,7 @@ Check what's new using \`/changelog\` command.`,
     }
     init();
   }, []);
-  useEffect4(() => {
+  useEffect5(() => {
     if (!isInitializing) {
       saveSettings({
         mode,
@@ -3214,7 +3338,7 @@ ${timestamp}` };
         setIsExpanded(false);
         try {
           const cleanHistoryForAI = [...messages, userMessage].filter(
-            (m) => m.role !== "think" && !String(m.id).startsWith("welcome")
+            (m) => m.role !== "think" && !m.isVisualFeedback && !String(m.id).startsWith("welcome")
           ).map((m) => ({
             ...m,
             text: m.fullText || m.text
@@ -3315,6 +3439,12 @@ Selection: ${val}`,
           let inThinkMode = false;
           let currentThinkId = null;
           let currentAgentId = null;
+          let inCodeBlock = false;
+          let inToolCall = false;
+          let thinkConsumedInTurn = false;
+          let toolCallEncounteredInTurn = false;
+          let toolCallBalance = 0;
+          let inToolCallString = null;
           const signalRegex = /\[?_DISABLED_SIGNAL_REGEX_\]?/gi;
           for await (const packet of stream) {
             if (packet.type === "status") {
@@ -3329,6 +3459,9 @@ Selection: ${val}`,
               currentThinkId = null;
               currentAgentId = null;
               inThinkMode = false;
+              inCodeBlock = false;
+              inToolCall = false;
+              toolCallEncounteredInTurn = false;
               continue;
             }
             if (packet.type === "memory_updated") {
@@ -3341,6 +3474,15 @@ Selection: ${val}`,
               });
               continue;
             }
+            if (packet.type === "visual_feedback") {
+              setMessages((prev) => [...prev, {
+                id: "feedback-" + Date.now(),
+                role: "system",
+                text: packet.content,
+                isVisualFeedback: true
+              }]);
+              continue;
+            }
             if (packet.type === "exec_start") {
               continue;
             }
@@ -3372,23 +3514,50 @@ Selection: ${val}`,
               continue;
             }
             let chunkText = packet.content;
-            if ((chunkText.toLowerCase().includes("<think") || chunkText.toLowerCase().includes("<thought")) && !inThinkMode) {
+            const chunkLower = chunkText.toLowerCase();
+            if (chunkText.includes("```")) inCodeBlock = !inCodeBlock;
+            if (chunkLower.includes("tool:functions.")) {
+              inToolCall = true;
+              toolCallBalance = 0;
+              inToolCallString = null;
+            }
+            if (inToolCall) {
+              for (let j = 0; j < chunkText.length; j++) {
+                const char = chunkText[j];
+                if (!inToolCallString && (char === "'" || char === '"' || char === "`")) {
+                  inToolCallString = char;
+                } else if (inToolCallString && char === inToolCallString && chunkText[j - 1] !== "\\") {
+                  inToolCallString = null;
+                }
+                if (!inToolCallString) {
+                  if (char === "(") toolCallBalance++;
+                  else if (char === ")") toolCallBalance--;
+                }
+              }
+              if (toolCallBalance <= 0 && !inToolCallString) {
+                inToolCall = false;
+              }
+            }
+            const hasThinkTag = chunkLower.includes("<think") || chunkLower.includes("<thought");
+            const canThink = !inThinkMode && !inCodeBlock && !inToolCall && !thinkConsumedInTurn;
+            if (hasThinkTag && canThink) {
               inThinkMode = true;
-              chunkText = chunkText.replace(/<(think|thought)>/gi, "");
+              thinkConsumedInTurn = true;
+              chunkText = chunkText.replace(/<(think|thought)>[\s\S]*?<\/(think|thought)>/gi, "").replace(/<(think|thought)>/gi, "");
               currentThinkId = "think-" + Date.now();
-              setMessages((prev) => [...prev, { id: currentThinkId, role: "think", text: "" }]);
+              setMessages((prev) => [...prev, { id: currentThinkId, role: "think", text: "", isStreaming: true }]);
             }
-            if (chunkText.toLowerCase().includes("</think>") || chunkText.toLowerCase().includes("</thought>")) {
+            if (chunkLower.includes("</think>") || chunkLower.includes("</thought>")) {
               const parts = chunkText.split(/<\/(think|thought)>/gi);
               const thinkPart = parts[0] || "";
-              const agentPart = parts.slice(2).join("") || "";
+              const agentPart = parts.slice(2).join("").replace(/<\/?(think|thought)>/gi, "");
               setMessages((prev) => {
                 const newMsgs = prev.map(
-                  (m) => m.id === currentThinkId ? { ...m, text: m.text + thinkPart } : m
+                  (m) => m.id === currentThinkId ? { ...m, text: m.text + thinkPart, isStreaming: true } : m
                 );
                 inThinkMode = false;
                 currentAgentId = "agent-" + Date.now();
-                return [...newMsgs, { id: currentAgentId, role: "agent", text: agentPart.replace(/<\/?(think|thought)>/gi, "") }];
+                return [...newMsgs, { id: currentAgentId, role: "agent", text: agentPart, isStreaming: true }];
               });
               continue;
             }
@@ -3405,26 +3574,33 @@ Selection: ${val}`,
                       transitionContent = parts.slice(1).join("</think>") || "";
                       return { ...m, text: parts[0] };
                     }
-                    return { ...m, text: newText };
+                    return { ...m, text: newText, isStreaming: true };
                   }
                   return m;
                 });
                 if (transitioning) {
                   inThinkMode = false;
                   currentAgentId = "agent-" + Date.now();
-                  return [...newMsgs, { id: currentAgentId, role: "agent", text: transitionContent.replace(/<\/?think>/gi, "") }];
+                  return [...newMsgs, { id: currentAgentId, role: "agent", text: transitionContent.replace(/<\/?(think|thought)>/gi, ""), isStreaming: true }];
                 }
                 return newMsgs;
               });
-            } else if (!inThinkMode) {
-              const cleanedText = chunkText.replace(/<\/?(think|thought)>/gi, "").replace(signalRegex, "");
-              if (!currentAgentId) {
-                currentAgentId = "agent-" + Date.now();
-                setMessages((prev) => [...prev, { id: currentAgentId, role: "agent", text: cleanedText }]);
-              } else {
-                setMessages((prev) => prev.map(
-                  (m) => m.id === currentAgentId ? { ...m, text: m.text + cleanedText } : m
-                ));
+            } else if (!inThinkMode && !toolCallEncounteredInTurn) {
+              let cleanedText = chunkText.replace(/<(think|thought)>[\s\S]*?<\/(think|thought)>/gi, "").replace(/<\/?(think|thought)>/gi, "").replace(signalRegex, "");
+              const toolIdx = cleanedText.toLowerCase().indexOf("tool:functions.");
+              if (toolIdx !== -1) {
+                cleanedText = cleanedText.substring(0, toolIdx);
+                toolCallEncounteredInTurn = true;
+              }
+              if (cleanedText) {
+                if (!currentAgentId) {
+                  currentAgentId = "agent-" + Date.now();
+                  setMessages((prev) => [...prev, { id: currentAgentId, role: "agent", text: cleanedText, isStreaming: true }]);
+                } else {
+                  setMessages((prev) => prev.map(
+                    (m) => m.id === currentAgentId ? { ...m, text: m.text + cleanedText, isStreaming: true } : m
+                  ));
+                }
               }
             }
           }
@@ -3452,10 +3628,11 @@ Selection: ${val}`,
             setActiveView("resolution");
           }
           setMessages((prev) => {
-            const historyToSave = prev.filter((m) => !String(m.id).startsWith("welcome"));
+            const newMsgs = prev.map((m) => m.isStreaming ? { ...m, isStreaming: false } : m);
+            const historyToSave = newMsgs.filter((m) => !String(m.id).startsWith("welcome") && !m.isVisualFeedback);
             saveChat(chatId, null, historyToSave);
-            setCompletedIndex(prev.length);
-            return prev;
+            setCompletedIndex(newMsgs.length);
+            return newMsgs;
           });
         }
       };
@@ -3483,7 +3660,7 @@ Selection: ${val}`,
     }
     return [];
   }, [input]);
-  useEffect4(() => {
+  useEffect5(() => {
     setSelectedIndex(0);
   }, [suggestions]);
   const renderActiveView = () => {
@@ -4121,7 +4298,7 @@ var init_app = __esm({
     init_setup();
     SESSION_START_TIME = Date.now();
     CHANGELOG_URL = "https://fluxflow-cli.onrender.com/changelog.html";
-    versionFluxflow = "1.5.3";
+    versionFluxflow = "1.6.0";
     updatedOn = "2026-05-02";
     ResolutionModal = ({ data, onResolve, onEdit }) => /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", paddingX: 2, paddingY: 1, width: "100%" }, /* @__PURE__ */ React10.createElement(Text10, { color: "magenta", bold: true, underline: true }, "\u{1F7E3} STEERING HINT RESOLUTION"), /* @__PURE__ */ React10.createElement(Text10, { marginTop: 1 }, "The agent already finished the task (turn: finish) before your hint was consumed."), /* @__PURE__ */ React10.createElement(Box10, { marginTop: 1, backgroundColor: "#222", paddingX: 1, width: "100%" }, /* @__PURE__ */ React10.createElement(Text10, { italic: true, color: "gray" }, '"', data, '"')), /* @__PURE__ */ React10.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React10.createElement(Text10, { color: "cyan" }, "How would you like to proceed?")), /* @__PURE__ */ React10.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React10.createElement(
       CommandMenu,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "fluxflow-cli",
-	"version": "1.5.3",
+	"version": "1.6.0",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",
@@ -34,7 +34,7 @@
 	},
 	"scripts": {
 		"start": "tsx ./src/cli.jsx",
-		"build": "esbuild ./src/cli.jsx --bundle --platform=node --format=esm --outfile=./dist/fluxflow.js --external:react --external:ink --external:chalk --external:fs-extra --external:gradient-string --external:ink-text-input --external:ink-select-input --external:ink-spinner --external:ink-multiline-input --external:@google/genai --external:zod --external:nanoid --external:puppeteer --external:typescript"
+		"build": "esbuild ./src/cli.jsx --bundle --platform=node --format=esm --outfile=./dist/fluxflow.js --external:react --external:ink --external:chalk --external:fs-extra --external:gradient-string --external:ink-text-input --external:ink-select-input --external:ink-spinner --external:ink-multiline-input --external:@google/genai --external:zod --external:nanoid --external:puppeteer --external:pdf-lib --external:typescript"
 	},
 	"dependencies": {
 		"@google/genai": "^1.50.1",
@@ -47,6 +47,7 @@
 		"ink-spinner": "^5.0.0",
 		"ink-text-input": "^6.0.0",
 		"nanoid": "^5.1.9",
+		"pdf-lib": "^1.17.1",
 		"puppeteer": "^24.42.0",
 		"react": "^19.2.5",
 		"zod": "^4.3.6"