fluxflow-cli 1.12.3 → 1.12.5

package/ARCHITECTURE.md

@@ -15,7 +15,7 @@ The core intelligence of Flux Flow resides in `src/utils/ai.js`. It does not rel
 
 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.
+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., >254k 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.

package/dist/fluxflow.js

@@ -961,7 +961,7 @@ ${mode === "Flux" ? `- FILE TOOLS (path = relative to CWD) -
 2. [tool:functions.ReadFolder(path="...")]. Detailed DIR stats
 3. [tool:functions.WriteFile(path="...", content="...")]. Creates/Overwrites. File Exist? -> update_file > write_file
 4. [tool:functions.PatchFile(path="...", content_to_replace="exact old content", content_to_add="new content")]. Surgical patching. Unsure content_to_replace? -> view_file >> guessing.
-5. [tool:functions.WritePDF(path="...", content="...", orientation="...")]. MUST HAVE PROPER A4 PAGE BREAKS. HTML/CSS for premium layout (100vh/vw). No manual footers
+5. [tool:functions.WritePDF(path="...", content="...", orientation="...")]. **USE PROPER PROACTIVE A4 PAGE BREAKS**. HTML/CSS for PREMIUM layout (100vh/vw). No manual footers
 6. [tool:functions.WriteDoc(path="...", content="...")]. A4 Word doc. Proper margins and page breaks
 7. [tool:functions.Run(command="...")]. Runs a shell command. Destructive/Irreversible ops -> ask user
 8. [tool:functions.SearchKeyword(keyword="...")]. Global search. Finds definitions/logic without reading every file
@@ -992,13 +992,20 @@ Your tool syntax is: '[tool:functions.ToolName(args...)]'
 [tool:functions.Chat(title='<short creative title of FULL conversation in 3-5 words>')]. Consider full chat context to generate title NOT just latest message.
 [tool:functions.Memory(action='temp', content='<summary of the user prompt & model responses ONLY FROM LATEST PROMPT UNDER 40 WORDS>. [Talked on: <date> <hour>]')]
 
-${isMemoryEnabled ? `-- User-specific long-term memory (USE BASED ON CONVERSATION CONTEXT) --
+${isMemoryEnabled ? `-- User-specific long-term/permanent memory (USE BASED ON CONVERSATION CONTEXT, PROACTIVE USAGE) --
 - Add: [tool:functions.Memory(action='user', method='add', content='<string to add>. [Saved on: <date ONLY>]')]
 - Delete: [tool:functions.Memory(action='user', method='delete', content='exact memory id')]
 - Update: [tool:functions.Memory(action='user', method='update', content-new='string to update', content-old='exact memory id')]
 
+Explicit Triggers for permanent memory:
+- User explicitly asks to 'remember' something.
+- User mentions something important that should be remembered.
+- User provides information that could be useful for future reference.
+- User shares personal information or preferences.
+- User talks about a specific topic that should be remembered.
+
 Usage Rules:
-- Frequency for 'user' action: Only when explicit context from chat is found or explicitly requested by the user.
+- Frequency for 'user' action: Based on explicit triggers.
 - IF YOU WANT TO SAVE SOMETHING, BUT SIMILAR MEMORY ALREADY EXISTS, USE THE UPDATE METHOD NOT THE ADD METHOD` : ""}`.trim();
   }
 });
@@ -1087,8 +1094,8 @@ ${foundFiles.map((f) => `- ${f.name}: ${f.desc}`).join("\n")}
 Check these first; these files > training data for project consistency. Safety rules apply` : "";
       return `${nameStr}${nicknameStr}${userInstrStr}
 [SYSTEM (OVERRIDES EVERYTHING)]
-Identity: Flux Flow (by Kushal Roy Chowdhury). Sassy, Friendly, CLI Agent. No flirting ${mode === "Flux" ? "" : ""}
-Mode: ${mode}${thinkingLevel !== "Fast" ? "(Thinking Mode)" : ""}. ${mode === "Flux" ? "Goal-oriented" : "Conversational & UX-focused"}
+Identity: Flux Flow (by Kushal Roy Chowdhury). Sassy, Friendly, Humorous, CLI Agent. No flirting ${mode === "Flux" ? "" : ""}
+Mode: ${mode}${thinkingLevel !== "Fast" ? "(Thinking Mode)" : ""}. ${mode === "Flux" ? "Goal-oriented, Logical" : "Conversational & UX-focused"}
 CWD: ${cwdStr}.${isSystemDir ? " [PROTECTED: ASK BEFORE MODIFYING]" : ""} OS: ${osDetected}${osDetected === "Windows" && mode === "Flux" ? ". PS via CMD" : ""}
 High Priority: [SYSTEM], [STEERING HINT]
 
@@ -3510,6 +3517,8 @@ var init_ai = __esm({
       if (process.stdout.isTTY) {
         process.stdout.write(`\x1B]0;Finalizing...\x07`);
       }
+      const USER_CONTEXT_LENGTH = 4 * (1024 * 2);
+      const AGENT_CONTEXT_LENGTH = 4 * (1024 * 8);
       const { onStatus, onMemoryUpdated, onBackgroundIncrement } = callbacks;
       const { profile, thinkingLevel, mode, janitorModel, chatId, systemSettings, sessionStats } = settings;
       const isMemoryEnabled = systemSettings?.memory !== false;
@@ -3517,7 +3526,7 @@ var init_ai = __esm({
       const janitorUserMemories = persistentStorage.map((m) => `- [${m.id}]: ${m.memory}`).join("\n");
       const janitorContents = history.slice(-12).filter((msg) => msg.text && !msg.text.includes("[TOOL RESULT]") && !msg.text.includes("OBSERVATION:")).map((msg) => {
         let processedText = msg.text.replace(/\[tool:functions\..*?\]/g, "").replace(/<think>[\s\S]*?<\/think>/g, "").replace(/\[Prompted on:.*?\]/g, "").replace(/\[turn: continue\]/g, "").replace(/\[turn: finish\]/g, "").replace(/\[TOOL RESULTS\]/g, "").replace(/\[tool results\]/g, "").replace(/\r?\n\r?\n/g, "\n").replace(/\n\n/g, "\n").replace(/\\n\\n/g, "").trim();
-        const limit = msg.role === "user" ? 1500 : 24e3;
+        const limit = msg.role === "user" ? USER_CONTEXT_LENGTH : AGENT_CONTEXT_LENGTH;
         let truncatedText = processedText.substring(0, limit);
         if (processedText.length > limit) {
           truncatedText += "\n... (truncated) ...";
@@ -3535,14 +3544,14 @@ var init_ai = __esm({
         isMemoryEnabled,
         true
       );
-      let agentRes = `${cleanedFullResponse.replace(/\[tool:functions\..*?\]/g, "").replace(/<think>.*<\/think>/g, "").replace(/\[Prompted on:.*?\]/g, "").replace(/\[turn: continue\]/g, "").replace(/\[turn: finish\]/g, "").replace(/\[TOOL RESULTS\]/g, "").replace(/\[tool results\]/g, "").substring(0, 24e3)}`;
-      if (agentRes.length > 24e3) {
+      let agentRes = `${cleanedFullResponse.replace(/\[tool:functions\..*?\]/g, "").replace(/<think>.*<\/think>/g, "").replace(/\[Prompted on:.*?\]/g, "").replace(/\[turn: continue\]/g, "").replace(/\[turn: finish\]/g, "").replace(/\[TOOL RESULTS\]/g, "").replace(/\[tool results\]/g, "").substring(0, AGENT_CONTEXT_LENGTH)}`;
+      if (agentRes.length > AGENT_CONTEXT_LENGTH) {
         agentRes += "\n... (truncated) ...";
       }
       let originalTextProcessed = agentText.replace(/\[Prompted on:.*?\]/g, "").trim();
       agentRes = agentRes.replace(/\r?\n\r?\n/g, "\n").replace(/\n\n/g, "\n").replace(/\\n\\n/g, "").trim();
-      let userPrompt = `[USER]: ${originalTextProcessed.substring(0, 1500)}
-${originalTextProcessed.length > 1500 ? "... (truncated) ...\n\n" : ""}
+      let userPrompt = `[USER]: ${originalTextProcessed.substring(0, USER_CONTEXT_LENGTH)}
+${originalTextProcessed.length > USER_CONTEXT_LENGTH ? "... (truncated) ...\n\n" : ""}
 [AGENT (current turn)]: ${agentRes}`;
       janitorContents.push({ role: "user", parts: [{ text: userPrompt }] });
       let finalSynthesis = "";
@@ -3894,6 +3903,7 @@ ${thinkingLevel != "Fast" ? "[SYSTEM] **STRICTLY FOLLOW THINKING POLICY AS STRIC
       yield { type: "status", content: "Connecting..." };
       TERMINATION_SIGNAL = false;
       let fullAgentResponseChunks = [];
+      let wasToolCalledInLastLoop = false;
       modifiedHistory.forEach((msg) => {
         if (msg.text && msg.role === "agent") {
           msg.text = msg.text.replace(/<(think|thought)>[\s\S]*?<\/(think|thought)>/gi, "").trim();
@@ -3932,6 +3942,7 @@ ${thinkingLevel != "Fast" ? "[SYSTEM] **STRICTLY FOLLOW THINKING POLICY AS STRIC
         let lastToolFinishedAt = 0;
         let toolResults = [];
         let toolCallPointer = 0;
+        let anyToolExecutedInThisTurn = false;
         let isThinkingLoop = false;
         let isStutteringLoop = false;
         let isGeneralLoop = false;
@@ -4402,6 +4413,7 @@ ${boxBottom}` };
                   }
                   const aiContent = `[TOOL RESULT]: ${(result || "").toString().split(/\r?\n/).filter((line) => !line.includes("[UI_CONTEXT]")).join("\n")}`;
                   toolResults.push({ role: "user", text: aiContent, binaryPart });
+                  anyToolExecutedInThisTurn = true;
                   let uiContent = `[TOOL RESULT]: ${result || ""}`;
                   if (normToolName === "view_file" || normToolName === "web_scrape") {
                     uiContent = `[TOOL RESULT]: ${label} (Context Locked for UI Clarity)`;
@@ -4587,14 +4599,19 @@ ${timestamp}`;
         if (isActuallyFinished) break;
         const nextAgentMsg = cleanedTurnText.trim() || "*Working...*";
         modifiedHistory.push({ role: "agent", text: nextAgentMsg });
-        if (toolResults.length > 0) {
+        if (toolResults.length > 0 || anyToolExecutedInThisTurn) {
           toolResults.forEach((tr) => modifiedHistory.push(tr));
         } else {
-          modifiedHistory.push({ role: "user", text: `[SYSTEM] ${isStutteringLoop && !isThinkingLoop ? `STUTTERING DETECTED by Internal System. Re-calibrate your response & proceed.` : `${isThinkingLoop ? " OVER-THINKING" : " LOOP"} DETECTED by Internal System${isThinkingLoop ? " for current EFFORT_LEVEL" : ""}. ${isThinkingLoop ? "If you have planned the task, prioritize the execution/output. " : "If you have finished your task use [turn: finish] else continue."}`}` });
+          if (wasToolCalledInLastLoop) {
+            modifiedHistory.push({ role: "user", text: `[SYSTEM] System executed the tool with no explicit result, continue with your task or use  [turn: finish] if completed.` });
+          } else {
+            modifiedHistory.push({ role: "user", text: `[SYSTEM] ${isStutteringLoop && !isThinkingLoop ? `STUTTERING DETECTED by Internal System. Re-calibrate your response & proceed.` : `${isThinkingLoop ? " OVER-THINKING" : " LOOP"} DETECTED by Internal System${isThinkingLoop ? " for current EFFORT_LEVEL" : ""}. ${isThinkingLoop ? "If you have planned the task, prioritize the execution/output. " : "If you have finished your task use [turn: finish] else continue."}`}` });
+          }
           isThinkingLoop = false;
           isStutteringLoop = false;
           isGeneralLoop = false;
         }
+        wasToolCalledInLastLoop = toolCallPointer > 0 || anyToolExecutedInThisTurn;
       }
       yield { type: "status", content: null };
     };
@@ -4729,7 +4746,8 @@ function MemoryModal({ onClose }) {
     }
   });
   const cleanDisplay = (text) => {
-    return text.replace(/\[Saved on: .*?\]/g, "").trim();
+    if (!text) return "";
+    return text.replace(/\[Saved on: .*?\]/g, "").replace(/\\+'/g, "'").trim();
   };
   const s = emojiSpace(2);
   return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", borderStyle: "round", borderColor: "gray", padding: 0, width: 80 }, /* @__PURE__ */ React8.createElement(Box8, { paddingX: 1, marginBottom: 1 }, /* @__PURE__ */ React8.createElement(Text8, { color: "cyan", bold: true }, "\u{1F9E0} AGENT MEMORY: LONG-TERM KNOWLEDGE")), !isMemoryOn && memories.length > 0 ? /* @__PURE__ */ React8.createElement(Box8, { paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React8.createElement(Text8, { italic: true, color: "gray" }, "Memory is currently Off...")) : memories.length === 0 ? /* @__PURE__ */ React8.createElement(Box8, { paddingX: 2, paddingY: 1 }, /* @__PURE__ */ React8.createElement(Text8, { italic: true, color: "gray" }, isMemoryOn ? "Learning..." : "Memory not available...")) : /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column" }, memories.map((mem, idx) => {
@@ -5616,7 +5634,7 @@ ${hintText}`, color: "magenta" }];
             if (newMode === "Flow") {
               setThinkingLevel("Fast");
             } else if (newMode === "Flux") {
-              setThinkingLevel("Medium");
+              setThinkingLevel("High");
             }
             const s2 = emojiSpace(2);
             setMessages((prev) => {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "fluxflow-cli",
-	"version": "1.12.3",
-	"date": "2026-05-21",
+	"version": "1.12.5",
+	"date": "2026-05-22",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",