fluxflow-cli 1.1.1 → 1.1.3

package/ARCHITECTURE.md

@@ -1,48 +1,48 @@
-# 🏛️ 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.
-
-## UI Layer: React & Ink
-
-The entire terminal interface is built using **React** via the [Ink](https://github.com/vadimdemedes/ink) renderer.
-- **Component-Based**: The UI is composed of isolated, reusable React components (`ChatLayout`, `StatusBar`, `CommandMenu`, `TerminalBox`, `ProfileForm`).
-- **Reactive State**: The application uses React hooks (`useState`, `useEffect`) to manage user input, application mode, model selection, and the terminal's resizing events.
-- **Zero-Render Overheads**: Critical performance trackers, like the session start time, are kept outside the React render cycle to maintain terminal responsiveness during high-speed AI text streaming.
-
-## The Agentic Loop
-
-The core intelligence of Flux Flow resides in `src/utils/ai.js`. It does not rely on opaque third-party agent frameworks; instead, it uses a custom, highly transparent string-based protocol powered by an asynchronous generator (`async function*`). This approach allows for real-time UI updates while managing complex multi-step reasoning.
-
-The execution flow of a single user prompt follows this loop:
-
-1. **Context Assembly**: The user's prompt is combined with the system instructions, temporary session context, persistent user memories, and the current chat history. If the history gets too large (e.g., >128k tokens) and compression is disabled, it is gracefully truncated.
-2. **Stream Processing**: The main loop initiates a streaming request to the Gemini API (`client.models.generateContentStream`). It yields chunks of text and status updates directly back to the React UI as they arrive.
-3. **Detection & Tool Execution**: Once the stream completes for a given turn, the entire response is scanned for tool calls using a custom regex and bracket-balancing parser (looking for `tool:functions.tool_name(args...)`).
-   - If tools are found, the loop pauses.
-   - Each tool is dispatched to its respective handler in `src/tools/`.
-   - Tool outputs are collected and appended to the context as `[TOOL_RESULT]: ...`.
-4. **Security Governance**: During tool execution, the loop enforces security checks (e.g., blocking `exec_command` from accessing system root drives if "External Workspace Access" is off) and pauses for Human-in-the-Loop (HITL) approval if necessary.
-5. **Turn Management & Continuation**: The model is instructed to append `[turn: finish]` if its goal is complete, or `[turn: continue]` if it expects tool results. 
-   - If tools were called or `[turn: continue]` is present, the loop increments and re-prompts the model with the newly gathered `[TOOL_RESULT]` data.
-   - If `[turn: finish]` is detected and no further tools were called, the main loop terminates, passing the final synthesized context to the background Janitor process.
-6. **Loop Limits & Resilience**: To prevent infinite loops or excessive API usage, **Flux mode** is capped at 50 iterations per user prompt, while **Flow mode** is capped at 5. 
-   - **Multi-Stage Failover**: The loop features a sophisticated 8-attempt retry engine with random backoff (800ms - 2s).
-   - **Critical Fallback Pivot**: If the primary model fails 5 consecutive times, the agent surgically pivots to a lighter, high-concurrency fallback model (`gemini-3.1-flash-lite-preview`) for the final 3 attempts to ensure session navigation through API congestion.
-
-## The Dual-Model System
-
-To maintain a fast, snappy UI while still performing complex data management, Flux Flow employs two separate AI models for every interaction:
-
-### 1. The Main Agent
-- **Responsibility**: Direct user interaction, reasoning, and tool execution.
-- **Behavior**: Streams text directly to the UI. It focuses entirely on solving the user's immediate problem or answering their question.
-
-### 2. The Janitor (Background Process)
-- **Responsibility**: System maintenance, long-term memory extraction, and chat summarization.
-- **Behavior**: After the Main Agent finishes its loop, the entire context (User Prompt + Agent Raws) is sent to the Janitor model.
-- **Headless Operation**: The Janitor is explicitly instructed to be a "silent background system process" with "no mouth." It *only* outputs valid tool calls (e.g., updating the chat title or saving a new user preference to the persistent memory vault).
-
-## Data Persistence & Safety
-
-- **High-Fidelity Lock**: Because both the UI and the Janitor model may attempt to write to the `history.json` file simultaneously, a Promise-based `WRITE_LOCK` (`src/utils/history.js`) is utilized. This prevents race conditions and ensures data integrity.
+# 🏛️ 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.
+
+## UI Layer: React & Ink
+
+The entire terminal interface is built using **React** via the [Ink](https://github.com/vadimdemedes/ink) renderer.
+- **Component-Based**: The UI is composed of isolated, reusable React components (`ChatLayout`, `StatusBar`, `CommandMenu`, `TerminalBox`, `ProfileForm`).
+- **Reactive State**: The application uses React hooks (`useState`, `useEffect`) to manage user input, application mode, model selection, and the terminal's resizing events.
+- **Zero-Render Overheads**: Critical performance trackers, like the session start time, are kept outside the React render cycle to maintain terminal responsiveness during high-speed AI text streaming.
+
+## The Agentic Loop
+
+The core intelligence of Flux Flow resides in `src/utils/ai.js`. It does not rely on opaque third-party agent frameworks; instead, it uses a custom, highly transparent string-based protocol powered by an asynchronous generator (`async function*`). This approach allows for real-time UI updates while managing complex multi-step reasoning.
+
+The execution flow of a single user prompt follows this loop:
+
+1. **Context Assembly**: The user's prompt is combined with the system instructions, temporary session context, persistent user memories, and the current chat history. If the history gets too large (e.g., >128k tokens) and compression is disabled, it is gracefully truncated.
+2. **Stream Processing**: The main loop initiates a streaming request to the Gemini API (`client.models.generateContentStream`). It yields chunks of text and status updates directly back to the React UI as they arrive.
+3. **Detection & Tool Execution**: Once the stream completes for a given turn, the entire response is scanned for tool calls using a custom regex and bracket-balancing parser (looking for `tool:functions.tool_name(args...)`).
+   - If tools are found, the loop pauses.
+   - Each tool is dispatched to its respective handler in `src/tools/`.
+   - Tool outputs are collected and appended to the context as `[TOOL_RESULT]: ...`.
+4. **Security Governance**: During tool execution, the loop enforces security checks (e.g., blocking `exec_command` from accessing system root drives if "External Workspace Access" is off) and pauses for Human-in-the-Loop (HITL) approval if necessary.
+5. **Turn Management & Continuation**: The model is instructed to append `[turn: finish]` if its goal is complete, or `[turn: continue]` if it expects tool results.
+   - If tools were called or `[turn: continue]` is present, the loop increments and re-prompts the model with the newly gathered `[TOOL_RESULT]` data.
+   - If `[turn: finish]` is detected and no further tools were called, the main loop terminates, passing the final synthesized context to the background Janitor process.
+6. **Loop Limits & Resilience**: To prevent infinite loops or excessive API usage, **Flux mode** is capped at 50 iterations per user prompt, while **Flow mode** is capped at 5.
+   - **Multi-Stage Failover**: The loop features a sophisticated 8-attempt retry engine with random backoff (800ms - 2s).
+   - **Critical Fallback Pivot**: If the primary model fails 5 consecutive times, the agent surgically pivots to a lighter, high-concurrency fallback model (`gemini-3.1-flash-lite-preview`) for the final 3 attempts to ensure session navigation through API congestion.
+
+## The Dual-Model System
+
+To maintain a fast, snappy UI while still performing complex data management, Flux Flow employs two separate AI models for every interaction:
+
+### 1. The Main Agent
+- **Responsibility**: Direct user interaction, reasoning, and tool execution.
+- **Behavior**: Streams text directly to the UI. It focuses entirely on solving the user's immediate problem or answering their question.
+
+### 2. The Janitor (Background Process)
+- **Responsibility**: System maintenance, long-term memory extraction, and chat summarization.
+- **Behavior**: After the Main Agent finishes its loop, the entire context (User Prompt + Agent Raws) is sent to the Janitor model.
+- **Headless Operation**: The Janitor is explicitly instructed to be a "silent background system process" with "no mouth." It *only* outputs valid tool calls (e.g., updating the chat title or saving a new user preference to the persistent memory vault).
+
+## Data Persistence & Safety
+
+- **High-Fidelity Lock**: Because both the UI and the Janitor model may attempt to write to the `history.json` file simultaneously, a Promise-based `WRITE_LOCK` (`src/utils/history.js`) is utilized. This prevents race conditions and ensures data integrity.
 - **Encryption**: User secrets and persistent memories (`secret/memories.json`) are handled by `src/utils/crypto.js` to ensure local privacy.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Kushal Roy Chowdhury
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Kushal Roy Chowdhury
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/TOOLS.md

@@ -1,48 +1,48 @@
-# 🧰 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** | ✅ | ✅ |
-| **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.
-
-### 📁 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. Supports reading 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** | ✅ | ✅ |
+| **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.
+
+### 📁 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. Supports reading 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,67 +1,67 @@
-# 🎮 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.
-- **/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.
-
-### 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)
-
-## 🧠 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.
-
-## 🛡️ 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.
+# 🎮 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.
+- **/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.
+
+### 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)
+
+## 🧠 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.
+
+## 🛡️ 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.

package/dist/fluxflow.js

@@ -199,7 +199,7 @@ var ChatLayout_default = ChatLayout;
 // src/components/StatusBar.jsx
 import React3 from "react";
 import { Box as Box3, Text as Text3 } from "ink";
-var StatusBar = React3.memo(({ mode, thinkingLevel, tokens = "0.0k", chatId = "NEW-SESSION", isMemoryEnabled = true }) => {
+var StatusBar = React3.memo(({ mode, thinkingLevel, tokens = "0.0k", tokensTotal = "0.0k", chatId = "NEW-SESSION", isMemoryEnabled = true }) => {
   const modeColor = mode === "Flux" ? "yellow" : "cyan";
   const modeIcon = mode === "Flux" ? "\u26A1" : "\u{1F30A}";
   const memStatus = isMemoryEnabled ? "ON" : "OFF";
@@ -215,7 +215,7 @@ var StatusBar = React3.memo(({ mode, thinkingLevel, tokens = "0.0k", chatId = "N
     },
     /* @__PURE__ */ React3.createElement(Box3, null, /* @__PURE__ */ React3.createElement(Text3, { color: modeColor, bold: true }, modeIcon, " ", mode.toUpperCase()), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "magenta" }, "\u{1F9E0} ", thinkingLevel)),
     /* @__PURE__ */ React3.createElement(Box3, { flexGrow: 1, justifyContent: "center", paddingX: 2 }, /* @__PURE__ */ React3.createElement(Text3, { color: "gray", dimColor: true }, "\u{1F4C1} "), /* @__PURE__ */ React3.createElement(Text3, { color: "blue", dimColor: true, italic: true }, process.cwd())),
-    /* @__PURE__ */ React3.createElement(Box3, null, /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, "MEM: "), /* @__PURE__ */ React3.createElement(Text3, { color: memStatus === "ON" ? "green" : "red" }, memStatus), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "blue" }, " Tokens ", tokens > 1e3 ? `${(tokens / 1e3).toFixed(1)}k` : tokens, " (", Math.round(tokens / 254e3 * 100), "%)"), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "dim" }, "ID: ", chatId, " "))
+    /* @__PURE__ */ React3.createElement(Box3, null, /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, "MEM: "), /* @__PURE__ */ React3.createElement(Text3, { color: memStatus === "ON" ? "green" : "red" }, memStatus), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "blue" }, " Tokens ", tokensTotal > 1e3 ? `${(tokensTotal / 1e3).toFixed(1)}k` : tokensTotal, " (", Math.round(tokens / 254e3 * 100), "%)"), /* @__PURE__ */ React3.createElement(Text3, { color: "gray" }, " \u2502 "), /* @__PURE__ */ React3.createElement(Text3, { color: "dim" }, "ID: ", chatId, " "))
   );
 });
 var StatusBar_default = StatusBar;
@@ -410,7 +410,7 @@ tool:functions.tool_name(arguments)
 - WEB TOOLS (Available in Flux & Flow) -
     1. Web Search: tool:functions.web_search(query="<query>", limit=number). Find info. limit is optional (3-10, default 10). If user asks about something that is not in your training data, proactively use this tool to find the information.Winder search recomemded (limit = 10) when exploring a topic.
     2. Web Scrape: tool:functions.web_scrape(url="<url>"). provides detail from a URL.
-    3. Ask User: tool:functions.ask(question="...", optionA="Option::Desc", optionB="Option::Desc"). Use this ONLY when you reach a decision point with multiple valid paths and need user preference to proceed / confirmation. This allows you to pause for guidance without ending your task loop. Format options as 'Short Label::Detailed Description'. You can provide 2 - 4 options (optionA, optionB, optionC, optionD). Tool can also return result as none of the 4 if user write custom one.
+    3. Ask User: tool:functions.ask(question="...", optionA="Option::Desc", optionB="Option::Desc"). Mandatory triggers include: 1) **Path Divergence**: When multiple architectural or technical solutions exist, present options via 'ask' instead of choosing arbitrarily. 2) **Security Boundaries**: Explicitly request permission via 'ask' before accessing sensitive files (e.g., .env, config keys, credentials). 3) **Ambiguity Resolution**: Use 'ask' to clarify vague prompts before executing terminal commands or writing code. 4) **Risk Mitigation**: Require a 'Yes/No' confirmation for any destructive or irreversible operations. Options must always follow the 'Short Label::Detailed Description' format. This tool is a non-terminating suspension so you can get guidance without losing context.
 ${mode === "Flux" ? `
 - DEV & FILE TOOLS (Available in FLUX MODE ONLY) -
     1. View File: tool:functions.view_file(path="relative/path", start_line=number, end_line=number). Reads file content. Auto-truncates at 500 lines unless start_line and end_line are provided.
@@ -422,7 +422,7 @@ ${mode === "Flux" ? `
     - 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]
-WHEN CALLING TOOLS, YOU **MUST** END YOUR RESPONSE WITH '[turn: continue]' AFTER CALLING FUNCTIONS.
+WHEN CALLING TOOLS, YOU **MUST** end your response with '[turn: continue]'. NEVER use '[turn: finish]' in the same turn as a tool call. After receiving the [TOOL_RESULT], acknowledge the output and verify if the goal is met; only then may you use '[turn: finish]', otherwise use '[turn: continue]'.
 Do NOT over-use tools. Use them only when strictly necessary for the user's objective. You can stack multiple tool calls 1-by-1.
 Distinguish clearly between tool discussion and execution. Use the 'tool:' prefix ONLY when calling a function. When discussing tools with the user, refer to them by name as nouns (e.g., 'write_file', 'list_files') to avoid accidental triggers and context bloat. Even in your <think> ... </think> tags, do not use the 'tool:' prefix when planning to select a tool.
 -- END FUNCTION CALLING PROTOCOL --`.trim();
@@ -465,6 +465,7 @@ var getSystemInstruction = (profile, thinkingLevel, mode, systemSettings, tempMe
   if (thinkingLevel === "Low") levelKey = "Minimal";
   if (thinkingLevel === "xHigh" || thinkingLevel === "Max") levelKey = "Max";
   const thinkingConfig = thinking_prompts_default[levelKey] || thinking_prompts_default["Medium"];
+  const osDetected = process.platform === "win32" ? "Windows" : process.platform === "darwin" ? "macOS" : "Linux";
   const nameStr = profile.name && profile.name?.length > 0 ? `User Name: ${profile.name}` : "";
   const nicknameStr = profile.nickname && profile.nickname?.length > 0 ? `. User Nickname: ${profile.nickname}.` : "";
   const userInstrStr = profile.instructions && profile.instructions?.length > 0 ? `. User Instructions: ${profile.instructions}.` : "";
@@ -485,8 +486,9 @@ ${userMemories}
 ` : ""}${isMemoryEnabled ? `${tempMemoriesStr}
 
 ` : ""}--- START SYSTEM INSTRUCTION ---
-You are Flux Flow. A CLI Agent. Your tone will be friendly, warm, sassy, approchable, respectable, NO ROMANTIC OR FLIRTY WORDS. Dont mention modes unless explicitly asked. ${mode === "Flux" ? "You are currently operating in FLUX (dev) mode. Keep your agentic approach goal oriented. Use provided tools when needed. And try to minimize number of agentic loops (Agent Loop is limited to 50 per turn, finish your goal by then). Analyze user prompt and project requirements, then plan your approach." : "You are currently operating in Flow (chat) mode. Focus more on conversation quality and user experience. Keep Agentic Loops to minimum (Agent Loop is limited to 7 per turn, finish your goal by then). You will get access to Web Tools only in this mode."}
+You are Flux Flow. A CLI Agent. Your tone will be friendly, warm, sassy, approchable, funny, NO ROMANTIC OR FLIRTY WORDS. Dont mention modes unless explicitly asked. ${mode === "Flux" ? "You are currently operating in FLUX (dev) mode. Keep your agentic approach goal oriented. Use provided tools when needed. And try to minimize number of agentic loops (Agent Loop is limited to 50 per turn, finish your goal by then). Analyze user prompt and project requirements, then plan your approach." : "You are currently operating in Flow (chat) mode. Focus more on conversation quality and user experience. Keep Agentic Loops to minimum (Agent Loop is limited to 7 per turn, finish your goal by then). You will get access to Web Tools only in this mode."}
 CURRENT_WORKING_DIRECTORY: ${cwdStr}.
+OS: ${osDetected}. ${osDetected && mode == "Flux" ? "Your terminal commands will run on CMD. Prefer PS scripts via CMD instead of raw CMD commands." : ""}
 ${nameStr}${nicknameStr}${userInstrStr}
 
 ${thinkingConfig}
@@ -524,6 +526,7 @@ Every ${isMemoryEnabled ? "Prompt, Responses & Memories" : "Prompt & Responses"}
 
 -- START REPONSE FINISH PROTOCOL --
 WHEN YOU ARE DONE AND NEED NO LONGER AGENT LOOP FOR THE TASK, WRITE [turn: finish] AT VERY END OF YOUR RESPONSE TO AVOID AGENT LOOPS. IF YOU ARE NOT COMPLETED YET AND WANT NEXT LOOP WRITE [turn: continue] AT VERY END OF YOUR RESPONSE TO CONTINUE AGENT LOOPS. YOU CAN STACK MULTIPLE TOOLS AT ONCE BUT **HAVE TO** WRITE [turn: continue] AFTER WRITING ALL TOOL CALLS.
+When you 'finish' an agentic loop, you will lose your previous turn 'thinking' data. So only write [turn: finish] when you are absolutely sure that you are done with the task. Or user has to prompt again and re-thinking again from scratch will use tokens that were already planned.
 -- END REPONSE FINISH PROTOCOL --
 Current date and Time is: ${dateTimeStr}
  --- END SYSTEM INSTRUCTION ---`.trim();
@@ -1229,7 +1232,7 @@ ${formatted}${footer}`;
 var ask_user = async (args, context) => {
   const parsed = parseArgs(args);
   const { question } = parsed;
-  if (!question) return 'ERROR: Missing "question" argument for ask_user.';
+  if (!question) return 'ERROR: Missing "question" argument for ask.';
   if (!context.onAskUser) return "ERROR: onAskUser callback not provided in tool context.";
   const options = [];
   Object.keys(parsed).forEach((key) => {
@@ -1295,35 +1298,39 @@ var signalTermination = () => {
 };
 var detectToolCalls = (text) => {
   const results = [];
-  const trigger = "tool:functions.";
-  let searchIdx = 0;
-  while (true) {
-    const startIdx = text.indexOf(trigger, searchIdx);
-    if (startIdx === -1) break;
-    const openParenIdx = text.indexOf("(", startIdx + trigger.length);
-    if (openParenIdx === -1) {
-      searchIdx = startIdx + trigger.length;
-      continue;
-    }
-    const toolName = text.substring(startIdx + trigger.length, openParenIdx).trim();
-    let balance = 1;
-    let endIdx = -1;
-    for (let i = openParenIdx + 1; i < text.length; i++) {
-      if (text[i] === "(") balance++;
-      if (text[i] === ")") balance--;
-      if (balance === 0) {
-        endIdx = i;
-        break;
+  const toolRegex = /(?:\[?\s*tool:functions\.)([a-z0-9_]+)\s*\(([\s\S]*?)\)(?:\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--;
+        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 (endIdx === -1) {
-      searchIdx = openParenIdx + 1;
-      continue;
-    }
-    const fullMatch = text.substring(startIdx, endIdx + 1);
-    const args = text.substring(openParenIdx + 1, endIdx);
-    results.push({ fullMatch, toolName, args });
-    searchIdx = endIdx + 1;
+    results.push({
+      fullMatch: finalFullMatch,
+      toolName: toolName.trim(),
+      args: finalArgs.trim()
+    });
   }
   return results;
 };
@@ -1375,7 +1382,7 @@ USER_PROMPT: ${agentText}`.trim();
       }
     }
     yield { type: "turn_reset", content: true };
-    const contents = modifiedHistory.filter((msg) => (msg.role === "user" || msg.role === "agent" || msg.role === "system") && !String(msg.id).startsWith("welcome")).map((msg) => ({
+    const contents = modifiedHistory.filter((msg) => (msg.role === "user" || msg.role === "agent" || msg.role === "system") && !String(msg.id).startsWith("welcome") && !msg.isMeta).map((msg) => ({
       role: msg.role === "user" || msg.role === "system" ? "user" : "model",
       parts: [{ text: msg.text }]
     }));
@@ -1609,7 +1616,8 @@ ${boxBottom}
       yield { type: "status", content: "Working..." };
     }
     const cleanedTurnText = turnText.replace(/<think>[\s\S]*?<\/think>/g, "").replace(/\[?\s*(turn\s*:)?\s*(continue|finish)\s*\]?/gi, "").trim();
-    if (hasFinish || !shouldContinue && toolResults.length === 0) {
+    const isActuallyFinished = hasFinish;
+    if (isActuallyFinished) {
       const lateHint = await steeringCallback();
       if (lateHint) {
         toolResults.push(`[USER STEERING HINT]: ${lateHint}`);
@@ -1694,13 +1702,11 @@ ${timestamp}`;
       }
       break;
     }
-    if (!shouldContinue && toolResults.length === 0) break;
+    if (isActuallyFinished) break;
     const nextAgentMsg = cleanedTurnText.trim() || "*Working...*";
     modifiedHistory.push({ role: "agent", text: nextAgentMsg });
-    const nextUserMsg = toolResults.length > 0 ? `${toolResults.join("\n")}` : "";
-    if (nextUserMsg) {
-      modifiedHistory.push({ role: "user", text: nextUserMsg });
-    }
+    const nextUserMsg = toolResults.length > 0 ? toolResults.join("\n") : "[turn: continue]";
+    modifiedHistory.push({ role: "user", text: nextUserMsg });
   }
   yield { type: "status", content: null };
 };
@@ -1835,11 +1841,28 @@ function MemoryModal({ onClose }) {
   return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", borderStyle: "double", borderColor: "yellow", padding: 1, width: 80 }, /* @__PURE__ */ React8.createElement(Box8, { justifyContent: "center", marginBottom: 1 }, /* @__PURE__ */ React8.createElement(Text8, { bold: true, color: "yellow" }, "\u{1F9E0} LONG-TERM MEMORY VAULT")), memories.length === 0 ? /* @__PURE__ */ React8.createElement(Box8, { justifyContent: "center", paddingY: 2 }, /* @__PURE__ */ React8.createElement(Text8, { italic: true, color: "gray" }, "The vault is currently empty...")) : memories.map((mem, idx) => /* @__PURE__ */ React8.createElement(Box8, { key: mem.id, paddingX: 1, backgroundColor: idx === selectedIndex ? "#333" : void 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: idx === selectedIndex ? "yellow" : "white" }, idx === selectedIndex ? "\u276F " : "  ", idx + 1, ". ", cleanDisplay(mem.memory)))), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1, borderStyle: "single", borderTop: true, borderBottom: false, borderLeft: false, borderRight: false, paddingTop: 1 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "\u2191/\u2193 Navigate \u2022 ", /* @__PURE__ */ React8.createElement(Text8, { color: "red" }, "x"), " Delete Memory \u2022 ", /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, "Esc"), " Back to Chat")));
 }
 
+// src/utils/terminal.js
+var getTerminalEnv = () => {
+  if (process.env.TERM_PROGRAM === "vscode") return "vscode";
+  if (process.env.WT_SESSION) return "wt";
+  return "default";
+};
+var emojiSpace = (baseSpaces = 2) => {
+  const env = getTerminalEnv();
+  if (env === "wt") {
+    return " ".repeat(Math.max(1, baseSpaces - 1));
+  }
+  if (env === "vscode") {
+    return " ".repeat(baseSpaces);
+  }
+  return " ".repeat(baseSpaces);
+};
+
 // src/app.jsx
 var SESSION_START_TIME = Date.now();
 var CHANGELOG_URL = "https://fluxflow-cli.onrender.com/changelog.html";
-var versionFluxflow = "1.1.1";
-var updatedOn = "2026-04-26";
+var versionFluxflow = "1.1.3";
+var updatedOn = "2026-04-27";
 var ResolutionModal = ({ data, onResolve, onEdit }) => /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", paddingX: 2, paddingY: 1, width: "100%" }, /* @__PURE__ */ React9.createElement(Text9, { color: "magenta", bold: true, underline: true }, "\u{1F7E3} STEERING HINT RESOLUTION"), /* @__PURE__ */ React9.createElement(Text9, { marginTop: 1 }, "The agent already finished the task (turn: finish) before your hint was consumed."), /* @__PURE__ */ React9.createElement(Box9, { marginTop: 1, backgroundColor: "#222", paddingX: 1, width: "100%" }, /* @__PURE__ */ React9.createElement(Text9, { italic: true, color: "gray" }, '"', data, '"')), /* @__PURE__ */ React9.createElement(Box9, { marginTop: 1 }, /* @__PURE__ */ React9.createElement(Text9, { color: "cyan" }, "How would you like to proceed?")), /* @__PURE__ */ React9.createElement(Box9, { marginTop: 1 }, /* @__PURE__ */ React9.createElement(
   CommandMenu,
   {
@@ -1865,6 +1888,7 @@ var FLUX_LOGO = gradient(["#00ffff", "#0077ff", "#ff00ff"]).multiline(
 function App() {
   const { stdout } = useStdout();
   const [input, setInput] = useState5("");
+  const [isExpanded, setIsExpanded] = useState5(false);
   const [mode, setMode] = useState5("Flux");
   const [terminalSize, setTerminalSize] = useState5({
     columns: stdout?.columns || 80,
@@ -1899,7 +1923,8 @@ function App() {
               text: `\u{1F680} **New version 'v${latestVersion}' is available!**
 Type \`npm i -g fluxflow-cli\` to update.
 Check what's new using \`/changelog\` command.`,
-              isUpdateNotification: true
+              isUpdateNotification: true,
+              isMeta: true
             });
             return newMsgs;
           });
@@ -1971,8 +1996,8 @@ Check what's new using \`/changelog\` command.`,
     for (let i = completedIndex - 1; i >= 0; i--) {
       const msg = messages[i];
       if (!msg) continue;
-      let lines = (msg.text || "").split("\n").length;
-      msg.text.split("\n").forEach((l) => {
+      let lines = (msg.text || "").split(/\r?\n/).length;
+      msg.text.split(/\r?\n/).forEach((l) => {
         lines += Math.floor(l.length / width);
       });
       lines += msg.role === "think" ? 3 : 2;
@@ -1987,7 +2012,23 @@ Check what's new using \`/changelog\` command.`,
       isTruncated: startIdx > 0
     };
   }, [messages, completedIndex, stdout?.columns]);
+  const terminalWidth = stdout?.columns || 80;
+  const wrapWidth = Math.max(20, terminalWidth - 10);
+  const wrappedLinesCount = input.split(/\r?\n/).reduce((acc, line) => {
+    return acc + Math.max(1, Math.ceil(line.length / wrapWidth));
+  }, 0);
+  const maxLines = Math.max(1, wrappedLinesCount);
   useInput4((inputText, key) => {
+    if (maxLines > 2 && !isExpanded && activeView === "chat") {
+      if (key.backspace || key.delete) {
+        setInput("");
+        return;
+      }
+      if (key.return) {
+        setIsExpanded(true);
+        return;
+      }
+    }
     if (key.escape) {
       if (isProcessing) {
         if (!escPressed) {
@@ -2068,7 +2109,7 @@ Check what's new using \`/changelog\` command.`,
       setInput(normalizedValue.slice(0, -1) + "\n");
       return;
     }
-    const absoluteClean = normalizedValue.replace(/\\\s*\n/g, "\n").split("\n").map((l) => l.replace(/\\$/, "")).join("\n");
+    const absoluteClean = normalizedValue.replace(/\\\s*\n/g, "\n").split(/\r?\n/).map((l) => l.replace(/\\$/, "")).join("\n");
     if (!absoluteClean.trim()) return;
     if (isProcessing) {
       const hintText = absoluteClean.trim();
@@ -2128,6 +2169,7 @@ ${hintText}`, color: "magenta" }];
           setCompletedIndex(0);
           setChatId(generateChatId());
           setSessionStats({ tokens: 0 });
+          setIsExpanded(false);
           break;
         }
         case "/mode": {
@@ -2136,7 +2178,7 @@ ${hintText}`, color: "magenta" }];
             setMode(newMode);
             setMessages((prev) => {
               setCompletedIndex(prev.length + 1);
-              return [...prev, { id: Date.now(), role: "system", text: `\u2699\uFE0F [SYSTEM] Mode switched to ${newMode}` }];
+              return [...prev, { id: Date.now(), role: "system", text: `\u2699\uFE0F [SYSTEM] Mode switched to ${newMode}`, isMeta: true }];
             });
           } else {
             setActiveView("mode");
@@ -2149,13 +2191,13 @@ ${hintText}`, color: "magenta" }];
             setShowFullThinking(true);
             setMessages((prev) => {
               setCompletedIndex(prev.length + 1);
-              return [...prev, { id: Date.now(), role: "system", text: "\u2699\uFE0F [SYSTEM] Full Thinking Process: VISIBLE" }];
+              return [...prev, { id: Date.now(), role: "system", text: "\u2699\uFE0F [SYSTEM] Full Thinking Process: VISIBLE", isMeta: true }];
             });
           } else if (arg === "hide") {
             setShowFullThinking(false);
             setMessages((prev) => {
               setCompletedIndex(prev.length + 1);
-              return [...prev, { id: Date.now(), role: "system", text: "\u2699\uFE0F [SYSTEM] Full Thinking Process: HIDDEN (Headings only)" }];
+              return [...prev, { id: Date.now(), role: "system", text: "\u2699\uFE0F [SYSTEM] Full Thinking Process: HIDDEN (Headings only)", isMeta: true }];
             });
           } else if (parts[1]) {
             let val = parts[1].toLowerCase();
@@ -2170,7 +2212,7 @@ ${hintText}`, color: "magenta" }];
               setThinkingLevel(formattedLevel);
               setMessages((prev) => {
                 setCompletedIndex(prev.length + 1);
-                return [...prev, { id: Date.now(), role: "system", text: `\u2699\uFE0F [SYSTEM] Thinking level set to ${formattedLevel}` }];
+                return [...prev, { id: Date.now(), role: "system", text: `\u2699\uFE0F [SYSTEM] Thinking level set to ${formattedLevel}`, isMeta: true }];
               });
             }
           } else {
@@ -2184,7 +2226,7 @@ ${hintText}`, color: "magenta" }];
             setActiveModel(mod);
             setMessages((prev) => {
               setCompletedIndex(prev.length + 1);
-              return [...prev, { id: Date.now(), role: "system", text: `\u2699\uFE0F [SYSTEM] Model switched to ${mod}` }];
+              return [...prev, { id: Date.now(), role: "system", text: `\u2699\uFE0F [SYSTEM] Model switched to ${mod}`, isMeta: true }];
             });
           } else {
             setActiveView("model");
@@ -2217,7 +2259,7 @@ ${hintText}`, color: "magenta" }];
           saveChat(chatId, name, messages);
           setMessages((prev) => {
             setCompletedIndex(prev.length + 1);
-            return [...prev, { id: Date.now(), role: "system", text: `\u{1F4BE} [MEMORY] Chat saved as "${name}" (ID: ${chatId})` }];
+            return [...prev, { id: Date.now(), role: "system", text: `\u{1F4BE} [MEMORY] Chat saved as "${name}" (ID: ${chatId})`, isMeta: true }];
           });
           break;
         }
@@ -2228,7 +2270,7 @@ ${hintText}`, color: "magenta" }];
             setMessages((prev) => {
               setCompletedIndex(prev.length + 1);
               return [...prev, { id: Date.now(), role: "system", text: `\u{1F5C3}\uFE0F [HISTORY] Saved Chats:
-${list || "No saved chats found."}` }];
+${list || "No saved chats found."}`, isMeta: true }];
             });
           };
           run();
@@ -2243,7 +2285,7 @@ ${list || "No saved chats found."}` }];
             try {
               setMessages((prev) => {
                 setCompletedIndex(prev.length + 1);
-                return [...prev, { id: Date.now(), role: "system", text: "\u2622\uFE0F [NUCLEAR] Initiating reset..." }];
+                return [...prev, { id: Date.now(), role: "system", text: "\u2622\uFE0F [NUCLEAR] Initiating reset...", isMeta: true }];
               });
               if (fs14.existsSync(LOGS_DIR)) fs14.removeSync(LOGS_DIR);
               if (fs14.existsSync(SECRET_DIR)) fs14.removeSync(SECRET_DIR);
@@ -2269,12 +2311,13 @@ ${list || "No saved chats found."}` }];
         }
         case "/about": {
           const updateStatus = latestVer ? latestVer !== versionFluxflow ? `Update Available [v${latestVer}]` : "No Update Available" : "Checking for updates...";
-          const aboutText = `\u2139\uFE0F  **FluxFlow Version:** v${versionFluxflow}
+          const s = emojiSpace(2);
+          const aboutText = `\u2139\uFE0F${s}**FluxFlow Version:** v${versionFluxflow}
 \u{1F504} **Status:** ${updateStatus}
 \u{1F4C5} **Updated on:** ${updatedOn}`;
           setMessages((prev) => {
             setCompletedIndex(prev.length + 1);
-            return [...prev, { id: Date.now(), role: "system", text: aboutText }];
+            return [...prev, { id: Date.now(), role: "system", text: aboutText, isMeta: true }];
           });
           break;
         }
@@ -2284,21 +2327,21 @@ ${list || "No saved chats found."}` }];
           exec(`${command} ${CHANGELOG_URL}`);
           setMessages((prev) => {
             setCompletedIndex(prev.length + 1);
-            return [...prev, { id: Date.now(), role: "system", text: `\u{1F310} [BROWSER] Opening changelog: ${CHANGELOG_URL}` }];
+            return [...prev, { id: Date.now(), role: "system", text: `\u{1F310} [BROWSER] Opening changelog: ${CHANGELOG_URL}`, isMeta: true }];
           });
           break;
         }
         case "/help": {
           setMessages((prev) => {
             setCompletedIndex(prev.length + 1);
-            return [...prev, { id: Date.now(), role: "system", text: "\u2699\uFE0F [SYSTEM] Available commands: " + COMMANDS.join(", ") }];
+            return [...prev, { id: Date.now(), role: "system", text: "\u2699\uFE0F [SYSTEM] Available commands: " + COMMANDS.join(", "), isMeta: true }];
           });
           break;
         }
         default:
           setMessages((prev) => {
             setCompletedIndex(prev.length + 1);
-            return [...prev, { id: Date.now(), role: "system", text: `\u2699\uFE0F [SYSTEM] Unknown command: ${cmd}` }];
+            return [...prev, { id: Date.now(), role: "system", text: `\u2699\uFE0F [SYSTEM] Unknown command: ${cmd}`, isMeta: true }];
           });
       }
     } else {
@@ -2312,6 +2355,7 @@ ${timestamp}` };
       });
       const streamChat = async () => {
         setIsProcessing(true);
+        setIsExpanded(false);
         try {
           const cleanHistoryForAI = [...messages, userMessage].filter(
             (m) => m.role !== "think" && !String(m.id).startsWith("welcome")
@@ -2534,6 +2578,7 @@ Selection: ${val}`,
       streamChat();
     }
     setInput("");
+    setIsExpanded(false);
   };
   const getSuggestions = () => {
     if (!input.startsWith("/") || input.includes(" ")) return [];
@@ -2602,11 +2647,12 @@ Selection: ${val}`,
           {
             title: "System Settings",
             items: [
-              { label: `Toggle Memory [ ${systemSettings.memory ? "ON" : "OFF"} ]`, value: "memory" },
-              { label: `Toggle Auto-Exec [ ${systemSettings.autoExec ? "ON" : "OFF"} ]`, value: "autoExec" },
-              { label: `External Workspace Access [ ${systemSettings.allowExternalAccess ? "ON" : "OFF"} ]`, value: "externalAccess" },
-              { label: `API Tier [ ${apiTier} ]`, value: "apiTier" },
-              { label: `Auto-Delete History [ ${systemSettings.autoDeleteHistory} ]`, value: "autoDelete" },
+              { label: `Toggle Memory                           [ ${systemSettings.memory ? "ON" : "OFF"} ]`, value: "memory" },
+              { label: `Toggle Auto-Exec                        [ ${systemSettings.autoExec ? "ON" : "OFF"} ]`, value: "autoExec" },
+              { label: `Alternate Screen Buffer (Experimental)  [ ${systemSettings.useAlternateBuffer ? "ON" : "OFF"} ]`, value: "altBuffer" },
+              { label: `External Workspace Access               [ ${systemSettings.allowExternalAccess ? "ON" : "OFF"} ]`, value: "externalAccess" },
+              { label: `API Tier                                [ ${apiTier} ]`, value: "apiTier" },
+              { label: `Auto-Delete History                     [ ${systemSettings.autoDeleteHistory} ]`, value: "autoDelete" },
               { label: "Exit Settings", value: "Cancel" }
             ],
             onSelect: (item) => {
@@ -2970,45 +3016,29 @@ Selection: ${val}`,
           }
         )));
       default:
-        const terminalWidth = stdout.columns || 80;
-        const wrapWidth = Math.max(20, terminalWidth - 10);
-        const wrappedLines = input.split("\n").reduce((acc, line) => {
-          return acc + Math.max(1, Math.ceil(line.length / wrapWidth));
-        }, 0);
-        const maxLines = Math.max(1, wrappedLines);
-        return /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", marginTop: 1, flexShrink: 0, width: "100%" }, /* @__PURE__ */ React9.createElement(Box9, { paddingX: 1, marginBottom: 0, justifyContent: "space-between", width: "100%" }, /* @__PURE__ */ React9.createElement(Box9, null, statusText && /* @__PURE__ */ React9.createElement(Text9, { color: "magenta", italic: true }, "\u23F3 ", statusText)), /* @__PURE__ */ React9.createElement(Text9, { color: "gray", dimColor: true }, "(", tempModelOverride || activeModel, ")")), suggestions.length > 0 && /* @__PURE__ */ React9.createElement(Box9, { paddingX: 1, marginBottom: 0 }, /* @__PURE__ */ React9.createElement(Text9, { color: "gray" }, "\u{1F4A1} Suggestions: "), suggestions.map((s, i) => /* @__PURE__ */ React9.createElement(Text9, { key: s, color: "yellow", bold: i === 0 }, " ", s, " "))), /* @__PURE__ */ React9.createElement(Box9, { backgroundColor: "#333333", paddingX: 1, paddingY: 1, width: "100%" }, /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", width: "100%" }, maxLines > 3 ? /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", width: "100%", paddingY: 0 }, /* @__PURE__ */ React9.createElement(Text9, { color: "gray", dimColor: true }, "[\u{1F4E6} ", maxLines, " lines of text in buffer - Full content will be sent]"), /* @__PURE__ */ React9.createElement(
-          Box9,
+        return /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", marginTop: 1, flexShrink: 0, width: "100%" }, /* @__PURE__ */ React9.createElement(Box9, { paddingX: 1, marginBottom: 0, justifyContent: "space-between", width: "100%" }, /* @__PURE__ */ React9.createElement(Box9, null, statusText && /* @__PURE__ */ React9.createElement(Text9, { color: "magenta", italic: true }, "\u23F3 ", statusText)), /* @__PURE__ */ React9.createElement(Text9, { color: "gray", dimColor: true }, "(", tempModelOverride || activeModel, ")")), suggestions.length > 0 && /* @__PURE__ */ React9.createElement(Box9, { paddingX: 1, marginBottom: 0 }, /* @__PURE__ */ React9.createElement(Text9, { color: "gray" }, "\u{1F4A1} Suggestions: "), suggestions.map((s, i) => /* @__PURE__ */ React9.createElement(Text9, { key: s, color: "yellow", bold: i === 0 }, " ", s, " "))), /* @__PURE__ */ React9.createElement(Box9, { backgroundColor: "#333333", paddingX: 1, paddingY: 1, width: "100%" }, /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "column", width: "100%" }, maxLines > 2 && !isExpanded ? /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "row", width: "100%", paddingY: 0, height: 1, overflow: "hidden" }, /* @__PURE__ */ React9.createElement(Box9, { flexShrink: 0, width: 3 }, /* @__PURE__ */ React9.createElement(Text9, { color: "yellow" }, "\u276F ")), /* @__PURE__ */ React9.createElement(Box9, { flexGrow: 1, flexDirection: "row" }, /* @__PURE__ */ React9.createElement(Box9, { flexShrink: 0 }, /* @__PURE__ */ React9.createElement(Text9, { color: "magenta", bold: true }, "[Pasted ", maxLines, " Lines]")), /* @__PURE__ */ React9.createElement(Box9, { flexGrow: 1, marginLeft: 1 }, /* @__PURE__ */ React9.createElement(
+          MultilineInput,
           {
-            flexDirection: "row",
-            width: "100%",
-            height: 1,
-            overflow: "hidden",
-            alignItems: "flex-end"
-          },
-          /* @__PURE__ */ React9.createElement(Box9, { flexShrink: 0, width: 3 }, /* @__PURE__ */ React9.createElement(Text9, { color: "yellow" }, "\u276F ")),
-          /* @__PURE__ */ React9.createElement(Box9, { flexGrow: 1 }, /* @__PURE__ */ React9.createElement(Box9, { flexGrow: 1, position: "relative" }, input.split("\n").pop() === "" && !isProcessing && /* @__PURE__ */ React9.createElement(Box9, { position: "absolute", paddingLeft: 0 }, /* @__PURE__ */ React9.createElement(Text9, { color: "gray", dimColor: true }, "Type your message...")), /* @__PURE__ */ React9.createElement(
-            MultilineInput,
-            {
-              value: input.split("\n").pop() || "",
-              onChange: (val) => {
-                const cleanVal = val.replace(/\\$/, "");
-                const lines = input.split("\n");
-                lines[lines.length - 1] = cleanVal;
-                setInput(lines.join("\n"));
-              },
-              onSubmit: handleSubmit,
-              keyBindings: {
-                submit: (key) => key.return && !key.shift && !key.ctrl,
-                newline: (key) => key.return && key.shift || key.return && key.ctrl
+            value: "",
+            placeholder: " (Backspace to delete / Enter to expand)",
+            onChange: (val) => {
+              if (val.length > 0) {
+                setIsExpanded(true);
+                setInput(input + val);
               }
+            },
+            onSubmit: () => setIsExpanded(true),
+            keyBindings: {
+              submit: (key) => key.return && !key.shift && !key.ctrl,
+              newline: (key) => key.return && key.shift || key.return && key.ctrl
             }
-          )))
-        )) : /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "row", width: "100%", paddingY: 0 }, /* @__PURE__ */ React9.createElement(Box9, { flexShrink: 0, width: 3 }, /* @__PURE__ */ React9.createElement(Text9, { color: "yellow" }, "\u276F ")), /* @__PURE__ */ React9.createElement(Box9, { flexGrow: 1 }, /* @__PURE__ */ React9.createElement(Box9, { flexGrow: 1, position: "relative" }, input === "" && !isProcessing && /* @__PURE__ */ React9.createElement(Box9, { position: "absolute", paddingLeft: 0 }, /* @__PURE__ */ React9.createElement(Text9, { color: "gray", dimColor: true }, escPressed ? "  Press ESC again to cancel the request." : "  Type your message or /command...")), /* @__PURE__ */ React9.createElement(
+          }
+        )))) : /* @__PURE__ */ React9.createElement(Box9, { flexDirection: "row", width: "100%", paddingY: 0 }, /* @__PURE__ */ React9.createElement(Box9, { flexShrink: 0, width: 3 }, /* @__PURE__ */ React9.createElement(Text9, { color: "yellow" }, "\u276F ")), /* @__PURE__ */ React9.createElement(Box9, { flexGrow: 1 }, /* @__PURE__ */ React9.createElement(Box9, { flexGrow: 1, position: "relative" }, input === "" && !isProcessing && /* @__PURE__ */ React9.createElement(Box9, { position: "absolute", paddingLeft: 0 }, /* @__PURE__ */ React9.createElement(Text9, { color: "gray", dimColor: true }, escPressed ? "  Press ESC again to cancel the request." : "  Type your message or /command...")), /* @__PURE__ */ React9.createElement(
           MultilineInput,
           {
             value: input,
             onChange: (val) => {
-              const cleanVal = val.replace(/\\\s*\n/g, "\n");
+              const cleanVal = val.replace(/\r\n/g, "\n").replace(/\r/g, "\n").replace(/\\\s*\n/g, "\n");
               setInput(cleanVal);
             },
             onSubmit: handleSubmit,
@@ -3035,6 +3065,7 @@ Selection: ${val}`,
       mode,
       thinkingLevel,
       tokens: sessionStats.tokens,
+      tokensTotal: sessionTotalTokens,
       chatId,
       isMemoryEnabled: systemSettings.memory
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "fluxflow-cli",
-	"version": "1.1.1",
+	"version": "1.1.3",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",