fluxflow-cli 1.3.2 → 1.3.3

package/README.md

@@ -1,35 +1,14 @@
-# 🌊 Flux Flow
-![Flux Flow Hero](./fluxflow.png)
+# 🌌 Flux Flow (`fluxflow-cli`)
+![Flux Flow Logo](https://github.com/KushalRoyChowdhury/fluxflow-cli/blob/main/fluxflow.png)
 
-**A Beautiful, Autonomous Terminal AI Agent**
+### *The High-Fidelity Agentic Terminal for the Flux Era.*
 
-Flux Flow is an advanced, fully autonomous AI agent that lives directly in your terminal. Built with Node.js and [Ink](https://github.com/vadimdemedes/ink) (React for interactive command-line apps), it provides a highly responsive, component-based UI powered by a sophisticated dual-model AI architecture.
-
-Whether you need a conversational partner or an autonomous developer that can write code, run shell commands, and read your project files, Flux Flow adapts to your needs.
+**Flux Flow** is not just another CLI—it's a high-speed, sassy, and goal-oriented CLI AI Agent powered by the latest Gemini/Gemma frontier models. Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.
 
 ---
 
-## ✨ Features
-
-- **Responsive Terminal UI**: A gorgeous, reactive interface built with React and Ink, featuring multi-line input, status bars, modals, and diff views.
-- **Dual-Model Architecture**: A primary agent interacts with you and executes tasks, while a silent background "Janitor" model handles chat summarization and long-term memory extraction without blocking the main UI.
-- **Two Operating Modes**:
-  - **Flux (Dev Mode)**: Full system access. The agent can read/write files, execute shell commands, and run autonomous agentic loops (up to 45 iterations) to solve complex coding tasks.
-  - **Flow (Chat Mode)**: Focused on conversation and web research, with limited agentic loops for faster response times.
-- **Advanced Memory System**: Features both temporary session context and persistent, cross-session user memories encrypted locally on your machine.
-- **Agentic Tooling**: Built-in tools for smart file patching, web scraping, web searching, and terminal execution.
-- **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity coding standards and complex workflows.
-- **Customizable "Thinking" Levels**: Adjust the depth of the model's reasoning process (from Minimal to Max).
-- **High-Reliability Fallback**: Automatic failover to a lighter, high-concurrency model (Gemini 3.1 Flash Lite) during peak traffic to ensure 100% session persistence.
-
-## 🚀 Quick Start
-
-### Prerequisites
-- [Node.js](https://nodejs.org/) (v18 or higher recommended)
-- `npm`, `yarn`, or `pnpm`
-
-### Via NPM (Global & Instant)
-You can run the agent instantly or install it globally for high-speed access:
+## 🚀 Instant Ignition (No Setup Required)
+You don't even need to install it. Just fire up your terminal and run:
 
 ```bash
 # Run instantly (Zero Setup)
@@ -37,44 +16,56 @@ npx fluxflow-cli
 
 # OR Install Globally
 npm install -g fluxflow-cli
-fluxflow
+fluxflow-cli
 ```
 
-### From Source (Local Development)
-1. Clone the repository and install dependencies:
-   ```bash
-   git clone <repository-url>
-   cd Flux-Flow
-   npm install
-   ```
+*The agent will prompt you for your Gemini API Key on the first run and store it securely in an XOR-encrypted vault.*
 
-2. Start the agent:
-   ```bash
-   npm start
-   ```
+---
 
-## 📖 Documentation
+## ✨ Why Flux Flow?
 
-To keep this README concise, detailed information about specific components of Flux Flow has been split into separate documents:
+### 🎨 **Premium Visual Sovereignty**
+Experience a terminal UI that feels alive. Built with **Ink** and **React**, Flux Flow features:
+- **Dynamic Status Bar**: Real-time telemetry showing your "Neural Headroom" (token usage), Thinking Level, and Session ID.
+- **Archived Terminal Flow**: See execution outputs transform from live elements into permanent conversation records.
+- **Rich Aesthetics**: High-contrast, sleek design with smooth transitions and micro-animations.
 
-- **[Architecture & Design](./ARCHITECTURE.md)**: Deep dive into the React/Ink rendering, the Agentic Loop, and the Janitor background process.
-- **[Agent Tools & Capabilities](./TOOLS.md)**: A comprehensive list of the tools available to the agent (e.g., File I/O, Execution, Web tools).
-- **[UI & Interaction Features](./UI_FEATURES.md)**: Details on commands, thinking levels, and human-in-the-loop verification.
+### 🧠 **The Dual-Intelligence System**
+- **Flux Mode (Dev)**: High-speed, agentic problem solving with a 50-turn persistent loop for massive coding tasks.
+- **Flow Mode (Chat)**: Optimized for deep research, high-quality conversation, and web-assisted reasoning.
 
-## 🔒 Security & Privacy
+### 🛡️ **Digital Fortress Governance**
+Security isn't an afterthought; it's a boundary.
+- **External Path Hardlock**: Restricts the agent to your Current Working Directory (CWD) unless you explicitly unlock it.
+- **Human-in-the-Loop (HITL)**: Every file write and terminal command requires your high-fidelity approval.
+- **XOR Vaulting**: All local session histories, memories, and API keys are obfuscated and encrypted at rest.
+- **Adaptive Failover**: Automatic multi-stage retry logic with high-concurrency fallback model switching (Gemini 3.1 Flash Lite) during peak API congestion.
 
-Flux Flow runs entirely locally on your machine.
-- **Global Storage**: All history, memories, and API keys are stored securely in your home directory at `~/.fluxflow`. Sensitive data is encrypted.
-- **Nuclear Reset**: Use the `/reset` command to instantly purge all logs, secrets, and settings from the global storage directory.
-- **Configurable Boundaries**: In Flux mode, file access can be strictly confined to the Current Working Directory, or expanded globally via settings.
-- **API Keys**: You supply your own Gemini/Google AI Studio API keys.
+### 🧹 **The Background Janitor**
+While you move at high speed, the Janitor follows behind—refining session titles, compressing data, and ensuring your context window remains at absolute peak performance.
 
-## 🛠️ Built With
+---
+
+## 🛠️ Key Capabilities
+- **Deep File-System Interaction**: Edit, move, and refactor code across multiple files with atomic precision.
+- **Real-Time Web Intelligence**: Autonomous web-searching via DuckDuckGo for live news and technical research.
+- **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity alignment with your coding standards and custom workflows.
+- **High-Reliability Fallback**: Automatic failover to a lighter, high-concurrency model during peak traffic to ensure zero session loss.
+- **Persistent Memory**: The agent learns from your preferences and project requirements across sessions.
+
+---
+
+## ⚙️ Configuration
+Type `/settings` in-app to live-configure:
+- **Thinking Level**: Low, Medium, or High (Deep-Reasoning).
+- **Auto-Execution**: For ultimate high-speed flow (Advanced users only).
+- **Security Perimeter**: Toggle External Workspace access.
+
+---
 
-- **[React](https://react.dev/) & [Ink](https://github.com/vadimdemedes/ink)**: For the interactive CLI rendering.
-- **[@google/genai](https://www.npmjs.com/package/@google/genai)**: The core AI SDK powering the agent's intelligence.
-- **[chalk](https://www.npmjs.com/package/chalk) & [gradient-string](https://www.npmjs.com/package/gradient-string)**: For terminal styling and aesthetics.
-- **[fs-extra](https://www.npmjs.com/package/fs-extra)**: For robust file system operations.
+## 🏁 License
+MIT © 2026 Flux Flow Team.
 
 ---
-*Created as a demonstration of highly capable AI tooling.*
+*Forged with ⚡ and 🧬. Welcome to the FluxFlow.*

package/dist/fluxflow.js

@@ -71,13 +71,14 @@ var init_ChatLayout = __esm({
     };
     InlineMarkdown = React2.memo(({ text, color }) => {
       if (!text) return null;
-      const parts = text.split(/(\*\*.*?\*\*|\*.*?\*|`.*?`|\$\\viewtext\{.*?\}\$|\[.*?\]\(.*?\))/g);
+      const parts = text.split(/(\*\*.*?\*\*|\*.*?\*|`.*?`|\$\\viewtext\{.*?\}\$|\[.*?\]\s*\(.*?\)|\[.*?\]\s*\[.*?\]|https?:\/\/[^\s]+)/g);
       return /* @__PURE__ */ React2.createElement(Text2, { color, wrap: "anywhere" }, parts.map((part, j) => {
+        if (!part) return null;
         if (part.startsWith("**") && part.endsWith("**")) {
-          return /* @__PURE__ */ React2.createElement(Text2, { key: j, bold: true, color: "white" }, part.slice(2, -2));
+          return /* @__PURE__ */ React2.createElement(Text2, { key: j, bold: true, color: "white" }, /* @__PURE__ */ React2.createElement(InlineMarkdown, { text: part.slice(2, -2), color: "white" }));
         }
         if (part.startsWith("*") && part.endsWith("*")) {
-          return /* @__PURE__ */ React2.createElement(Text2, { key: j, italic: true, color: "gray" }, part.slice(1, -1));
+          return /* @__PURE__ */ React2.createElement(Text2, { key: j, italic: true, color: "gray" }, /* @__PURE__ */ React2.createElement(InlineMarkdown, { text: part.slice(1, -1), color: "gray" }));
         }
         if (part.startsWith("`") && part.endsWith("`")) {
           return /* @__PURE__ */ React2.createElement(Text2, { key: j, color: "cyan", backgroundColor: "#003333" }, " ", part.slice(1, -1), " ");
@@ -86,11 +87,16 @@ var init_ChatLayout = __esm({
           const content = part.slice(11, -2);
           return /* @__PURE__ */ React2.createElement(Text2, { key: j, color: "white", backgroundColor: "#4c0099", bold: true, italic: true }, " ", content, " ");
         }
-        if (part.startsWith("[") && part.includes("](")) {
-          const match = part.match(/\[(.*?)\]\((.*?)\)/);
-          if (match) {
-            return /* @__PURE__ */ React2.createElement(Text2, { key: j }, /* @__PURE__ */ React2.createElement(Text2, { color: "cyan", underline: true }, match[1]), /* @__PURE__ */ React2.createElement(Text2, { color: "gray", dimColor: true }, " (", match[2], ")"));
-          }
+        if (part.startsWith("[") && (part.includes("](") || part.includes("] ("))) {
+          const match = part.match(/\[(.*?)\]\s*\((.*?)\)/);
+          if (match) return /* @__PURE__ */ React2.createElement(Text2, { key: j }, /* @__PURE__ */ React2.createElement(Text2, { color: "cyan", underline: true, bold: true }, match[1]), /* @__PURE__ */ React2.createElement(Text2, { color: "gray", dimColor: true, italic: true }, " (", match[2], ")"));
+        }
+        if (part.startsWith("[") && (part.includes("][") || part.includes("] ["))) {
+          const match = part.match(/\[(.*?)\]\s*\[(.*?)\]/);
+          if (match) return /* @__PURE__ */ React2.createElement(Text2, { key: j }, /* @__PURE__ */ React2.createElement(Text2, { color: "cyan", underline: true, bold: true }, match[1]), /* @__PURE__ */ React2.createElement(Text2, { color: "gray", dimColor: true, italic: true }, " [", match[2], "]"));
+        }
+        if (part.startsWith("http")) {
+          return /* @__PURE__ */ React2.createElement(Text2, { key: j, color: "cyan", underline: true, italic: true }, part);
         }
         return part;
       }));
@@ -102,15 +108,8 @@ var init_ChatLayout = __esm({
       );
       const header = rows[0];
       const data = rows.slice(2);
-      const colWidths = header.map((_, i) => {
-        let max = header[i].replace(/\*|`/g, "").length;
-        data.forEach((row) => {
-          const cleanCell = (row[i] || "").replace(/\*|`/g, "");
-          if (cleanCell.length > max) max = cleanCell.length;
-        });
-        return max;
-      });
-      return /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", borderStyle: "single", borderColor: "#333", paddingX: 1, marginY: 1, alignSelf: "flex-start" }, /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "row", marginBottom: 1 }, header.map((cell, i) => /* @__PURE__ */ React2.createElement(Box2, { key: i, width: colWidths[i] + 4, paddingRight: 4 }, /* @__PURE__ */ React2.createElement(InlineMarkdown, { text: cell, color: "cyan" })))), /* @__PURE__ */ React2.createElement(Box2, { borderStyle: "single", borderTop: true, borderBottom: false, borderLeft: false, borderRight: false, borderColor: "#444", width: "100%", marginBottom: 1 }), data.map((row, ri) => /* @__PURE__ */ React2.createElement(Box2, { key: ri, flexDirection: "row", marginBottom: ri === data.length - 1 ? 0 : 1 }, row.map((cell, ci) => /* @__PURE__ */ React2.createElement(Box2, { key: ci, width: colWidths[ci] + 4, paddingRight: 4, flexDirection: "column" }, /* @__PURE__ */ React2.createElement(InlineMarkdown, { text: cell, color: "white" }))))));
+      const colPercentage = Math.floor(100 / header.length);
+      return /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", borderStyle: "single", borderColor: "#333", paddingX: 1, marginY: 1, width: "100%", flexGrow: 1 }, /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "row", borderStyle: "single", borderBottom: true, borderTop: false, borderLeft: false, borderRight: false, borderColor: "#444", marginBottom: 1, paddingBottom: 1, width: "100%" }, header.map((cell, i) => /* @__PURE__ */ React2.createElement(Box2, { key: i, flexBasis: `${colPercentage}%`, flexGrow: 1, flexShrink: 0, paddingRight: 2 }, /* @__PURE__ */ React2.createElement(InlineMarkdown, { text: cell, color: "cyan" })))), data.map((row, ri) => /* @__PURE__ */ React2.createElement(Box2, { key: ri, flexDirection: "row", marginBottom: ri === data.length - 1 ? 0 : 1, width: "100%" }, row.map((cell, ci) => /* @__PURE__ */ React2.createElement(Box2, { key: ci, flexBasis: `${colPercentage}%`, flexGrow: 1, flexShrink: 0, paddingRight: 2, flexDirection: "column" }, /* @__PURE__ */ React2.createElement(InlineMarkdown, { text: cell, color: "white" }))))));
     });
     MarkdownText = React2.memo(({ text, color = "white", columns = 80 }) => {
       if (!text) return null;
@@ -171,7 +170,7 @@ var init_ChatLayout = __esm({
         }
       });
       flushBuffers("final");
-      return /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", width: "100%" }, result);
+      return /* @__PURE__ */ React2.createElement(Box2, { flexDirection: "column", width: columns - 2 }, result);
     });
     DiffLine = React2.memo(({ line }) => {
       const isContext = line.includes("[UI_CONTEXT]");
@@ -262,7 +261,7 @@ var init_ChatLayout = __esm({
         }
         return content;
       }, [content, msg.role, showFullThinking]);
-      return /* @__PURE__ */ React2.createElement(Box2, { marginBottom: 1, flexDirection: "column", flexShrink: 0, width: "100%" }, msg.role === "user" ? /* @__PURE__ */ React2.createElement(
+      return /* @__PURE__ */ React2.createElement(Box2, { marginBottom: 1, flexDirection: "column", flexShrink: 0, width: "100%", flexGrow: 1 }, msg.role === "user" ? /* @__PURE__ */ React2.createElement(
         Box2,
         {
           backgroundColor: "#262626",
@@ -577,7 +576,8 @@ ${isMemoryEnabled ? `2. User-specific long-term memory (USE BASED ON CONVERSATIO
     - Update: tool:functions.memory(action='user', method='update', content-new='string to update', content-old='exact memory id')
 
  Usage Rules:
- - Frequency for 'user' action: Only when explicit context from chat is found or explicitly requested by the user.` : ""}
+ - Frequency for 'user' action: Only when explicit context from chat is found or explicitly requested by the user.
+ - IF YOU WANT TO SAVE SOMETHING, BUT SIMILAR MEMORY ALREADY EXISTS, USE THE UPDATE METHOD NOT THE ADD METHOD` : ""}
 -- END MEMORY TOOLS --`.trim();
   }
 });
@@ -2487,11 +2487,30 @@ Check what's new using \`/changelog\` command.`,
       setTempKey("");
     }
   };
-  const COMMANDS = ["/quit", "/help", "/clear", "/resume", "/save", "/chats", "/mode", "/thinking", "/model", "/settings", "/key", "/profile", "/memory", "/stats", "/reset", "/about", "/changelog", "/update"];
+  const COMMANDS = [
+    { cmd: "/quit", desc: "Exit and shutdown Flux" },
+    { cmd: "/help", desc: "Show all available commands" },
+    { cmd: "/clear", desc: "Clear terminal screen" },
+    { cmd: "/resume", desc: "Load previous session" },
+    { cmd: "/save", desc: "Force save current chat" },
+    { cmd: "/chats", desc: "List all chat sessions" },
+    { cmd: "/mode", desc: "Toggle Flux/Flow modes" },
+    { cmd: "/thinking", desc: "Set AI reasoning depth" },
+    { cmd: "/model", desc: "Switch AI brain model" },
+    { cmd: "/settings", desc: "Configure system prefs" },
+    { cmd: "/key", desc: "Manage API keys" },
+    { cmd: "/profile", desc: "Edit developer persona" },
+    { cmd: "/memory", desc: "Manage agent memory" },
+    { cmd: "/stats", desc: "Show session usage" },
+    { cmd: "/reset", desc: "Wipe all project data" },
+    { cmd: "/about", desc: "Project info & credits" },
+    { cmd: "/changelog", desc: "View latest updates" },
+    { cmd: "/update", desc: "Check/Install updates" }
+  ];
   const handleSubmit = (value) => {
     if (suggestions.length > 0) {
-      const nextCmd = suggestions[selectedIndex] || suggestions[0];
-      setInput(nextCmd + " ");
+      const nextMatch = suggestions[selectedIndex] || suggestions[0];
+      setInput(nextMatch.cmd + " ");
       setSelectedIndex(0);
       return;
     }
@@ -3005,7 +3024,7 @@ Selection: ${val}`,
   };
   const suggestions = useMemo(() => {
     if (!input.startsWith("/") || input.includes(" ")) return [];
-    return COMMANDS.filter((c) => c.startsWith(input.toLowerCase()));
+    return COMMANDS.filter((c) => c.cmd.startsWith(input.toLowerCase()));
   }, [input]);
   useEffect4(() => {
     setSelectedIndex(0);
@@ -3059,7 +3078,7 @@ Selection: ${val}`,
           CommandMenu,
           {
             title: "\u{1F916} Select AI Model",
-            items: [{ label: "Gemma 4 31B (Default)", value: "gemma-4-31b-it" }, { label: "Gemini 3.1 Pro (Req. paid API Key)", value: "gemini-3.1-pro-preview" }, { label: "Gemini 3 Flash", value: "gemini-3-flash-preview" }, { label: "Gemini 3.1 Flash Lite", value: "gemini-3.1-flash-lite-preview" }, { label: "Cancel", value: "Cancel" }],
+            items: [{ label: "Gemma 4 31B            (Recomended - Default)", value: "gemma-4-31b-it" }, { label: "Gemini 3.1 Pro         (Recomended - Req. paid API Key)", value: "gemini-3.1-pro-preview" }, { label: "Gemini 3 Flash         (Paid API Key Recomended)", value: "gemini-3-flash-preview" }, { label: "Gemini 3.1 Flash Lite  (Fastest - For Quick Tasks ONLY)", value: "gemini-3.1-flash-lite-preview" }, { label: "Cancel", value: "Cancel" }],
             onSelect: (item) => {
               if (item.value !== "Cancel") setActiveModel(item.value);
               setActiveView("chat");
@@ -3546,7 +3565,7 @@ Selection: ${val}`,
         )))))));
     }
   };
-  return /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", width: "100%" }, windowedHistory.isTruncated && /* @__PURE__ */ React10.createElement(Box10, { borderStyle: "single", borderColor: "gray", paddingX: 1, marginBottom: 1, width: "100%", justifyContent: "center" }, /* @__PURE__ */ React10.createElement(Text10, { color: "gray", dimColor: true, italic: true }, "[ \u2191 History truncated for performance (showing last ~1000 lines) ]")), /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column" }, windowedHistory.items.map((msg, idx) => /* @__PURE__ */ React10.createElement(MessageItem, { key: msg.id || idx, msg, showFullThinking }))), /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", padding: 1, width: "100%" }, (activeView === "chat" || ["ask", "approval", "terminalApproval"].includes(activeView)) && /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", width: "100%" }, /* @__PURE__ */ React10.createElement(
+  return /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", width: "100%" }, windowedHistory.isTruncated && /* @__PURE__ */ React10.createElement(Box10, { borderStyle: "single", borderColor: "gray", paddingX: 1, marginBottom: 1, width: "100%", justifyContent: "center" }, /* @__PURE__ */ React10.createElement(Text10, { color: "gray", dimColor: true, italic: true }, "[ \u2191 History truncated for performance (showing last ~1000 lines) ]")), /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", width: "100%", flexGrow: 1 }, windowedHistory.items.map((msg, idx) => /* @__PURE__ */ React10.createElement(MessageItem, { key: msg.id || idx, msg, showFullThinking, columns: stdout?.columns || 80 }))), /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", padding: 1, width: "100%" }, (activeView === "chat" || ["ask", "approval", "terminalApproval"].includes(activeView)) && /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", width: "100%" }, /* @__PURE__ */ React10.createElement(
     ChatLayout_default,
     {
       messages: messages.slice(completedIndex),
@@ -3571,7 +3590,33 @@ Selection: ${val}`,
       chatId,
       isMemoryEnabled: systemSettings.memory
     }
-  ))), suggestions.length > 0 && /* @__PURE__ */ React10.createElement(Box10, { position: "absolute", bottom: 9, left: 4, flexDirection: "column", backgroundColor: "#222", borderStyle: "round", borderColor: "yellow", paddingX: 1, paddingY: 0, zIndex: 999 }, suggestions.slice(0, 15).map((s, i) => /* @__PURE__ */ React10.createElement(Box10, { key: s, flexDirection: "row" }, /* @__PURE__ */ React10.createElement(Text10, { color: i === selectedIndex ? "cyan" : "gray" }, i === selectedIndex ? "\u276F " : "  "), /* @__PURE__ */ React10.createElement(Text10, { color: i === selectedIndex ? "yellow" : "gray", bold: i === selectedIndex }, s))), suggestions.length > 15 && /* @__PURE__ */ React10.createElement(Text10, { color: "gray", dimColor: true }, "  ... (", suggestions.length - 15, " more)")));
+  )), suggestions.length > 0 && (() => {
+    const windowSize = 5;
+    const startIdx = Math.max(0, Math.min(selectedIndex - 2, suggestions.length - windowSize));
+    const visible = suggestions.slice(startIdx, startIdx + windowSize);
+    const remaining = suggestions.length - (startIdx + visible.length);
+    return /* @__PURE__ */ React10.createElement(
+      Box10,
+      {
+        flexDirection: "column",
+        backgroundColor: "#222",
+        borderStyle: "round",
+        borderColor: "yellow",
+        paddingX: 1,
+        paddingY: 0,
+        marginTop: 0,
+        width: "100%",
+        minHeight: suggestions.length >= 5 ? 7 : 0
+      },
+      visible.map((s, i) => {
+        const actualIdx = startIdx + i;
+        const isActive = actualIdx === selectedIndex;
+        const cmdText = s.cmd.padEnd(12);
+        return /* @__PURE__ */ React10.createElement(Box10, { key: s.cmd, flexDirection: "row" }, /* @__PURE__ */ React10.createElement(Text10, { color: isActive ? "cyan" : "gray" }, isActive ? "\u276F " : "  "), /* @__PURE__ */ React10.createElement(Text10, { color: isActive ? "yellow" : "gray", bold: isActive }, cmdText), /* @__PURE__ */ React10.createElement(Text10, { color: "gray", dimColor: true, italic: true }, s.desc));
+      }),
+      suggestions.length > 5 && /* @__PURE__ */ React10.createElement(Box10, { height: 1 }, remaining > 0 && /* @__PURE__ */ React10.createElement(Text10, { color: "gray", dimColor: true }, "  ... (", remaining, " more)"))
+    );
+  })()));
 }
 var SESSION_START_TIME, CHANGELOG_URL, versionFluxflow, updatedOn, ResolutionModal, FLUX_LOGO;
 var init_app = __esm({
@@ -3595,8 +3640,8 @@ var init_app = __esm({
     init_terminal();
     SESSION_START_TIME = Date.now();
     CHANGELOG_URL = "https://fluxflow-cli.onrender.com/changelog.html";
-    versionFluxflow = "1.3.2";
-    updatedOn = "2026-04-28";
+    versionFluxflow = "1.3.3";
+    updatedOn = "2026-04-29";
     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.3.2",
+	"version": "1.3.3",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",