fluxflow-cli 1.0.7 → 1.0.8

package/ARCHITECTURE.md

@@ -25,7 +25,9 @@ The execution flow of a single user prompt follows this loop:
 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. The loop also features built-in retry logic (with exponential backoff) for handling transient API errors like 429s or 503s.
+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
 

package/README.md

@@ -40,6 +40,7 @@ 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.
 
 ### 🧹 **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.
@@ -50,6 +51,7 @@ While you move at high speed, the Janitor follows behind—refining session titl
 - **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.
 
 ---

package/dist/fluxflow.js

@@ -1284,8 +1284,8 @@ var getAIStream = async function* (modelName, history, settings, steeringCallbac
 USER_PROMPT: ${agentText}`.trim();
   modifiedHistory.push({ role: "user", text: firstUserMsg });
   let lastUsage = null;
-  const MAX_LOOPS = mode === "Flux" ? 50 : 5;
-  const MAX_RETRIES = 3;
+  const MAX_LOOPS = mode === "Flux" ? 50 : 7;
+  const MAX_RETRIES = 7;
   yield { type: "status", content: "Working..." };
   TERMINATION_SIGNAL = false;
   let fullAgentResponse = "";
@@ -1314,8 +1314,15 @@ USER_PROMPT: ${agentText}`.trim();
         if (!await checkQuota("agent", settings)) {
           throw new Error("Error: Daily Quota Exausted for Agent");
         }
+        let targetModel = modelName;
+        if (retryCount >= 5) {
+          targetModel = "gemini-3.1-flash-lite-preview";
+          yield { type: "model_update", content: "Trying with fallback model" };
+        } else if (retryCount > 0) {
+          yield { type: "model_update", content: null };
+        }
         stream = await client.models.generateContentStream({
-          model: modelName,
+          model: targetModel,
           contents,
           config: {
             temperature: mode === "Flux" ? 0.9 : 1.3,
@@ -1326,31 +1333,39 @@ USER_PROMPT: ${agentText}`.trim();
           }
         });
         success = true;
+        yield { type: "model_update", content: null };
       } catch (err) {
-        const errMsg = err.message || String(err);
+        const errMsg = err.status || err.error && err.error.message || String(err);
         const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
         const agentErrDir = path13.join(LOGS_DIR, "agent");
-        if (!fs12.existsSync(agentErrDir)) {
-          fs12.mkdirSync(agentErrDir, { recursive: true });
-        }
+        if (!fs12.existsSync(agentErrDir)) fs12.mkdirSync(agentErrDir, { recursive: true });
         fs12.appendFileSync(path13.join(agentErrDir, "error.log"), `ERROR [${date}]: ${errMsg}
 `);
-        const isRetryable = errMsg.includes("429") || errMsg.includes("503") || errMsg.includes("overloaded") || errMsg.includes("deadline");
-        if (isRetryable && retryCount < MAX_RETRIES) {
+        if (retryCount < MAX_RETRIES) {
           retryCount++;
+          const waitTime = Math.floor(Math.random() * (2e3 - 800 + 1)) + 800;
           yield { type: "status", content: `Retrying (${retryCount}/${MAX_RETRIES})...` };
-          await new Promise((resolve) => setTimeout(resolve, 2e3 * retryCount));
+          await new Promise((resolve) => setTimeout(resolve, waitTime));
         } else {
           throw new Error(`Model cannot be reached: ${errMsg}`);
         }
       }
     }
     let turnText = "";
+    let lastToolSniffed = null;
     for await (const chunk of stream) {
       if (TERMINATION_SIGNAL) break;
       if (chunk.text) {
         turnText += chunk.text;
         yield { type: "text", content: chunk.text };
+        if (turnText.includes("tool:functions.")) {
+          const parts = turnText.split("tool:functions.");
+          const potentialTool = parts[parts.length - 1].split("(")[0].trim();
+          if (potentialTool && /^[a-z_]+$/.test(potentialTool) && potentialTool !== lastToolSniffed) {
+            lastToolSniffed = potentialTool;
+            yield { type: "status", content: `Working (${potentialTool})...` };
+          }
+        }
       }
       if (chunk.usageMetadata) {
         lastUsage = chunk.usageMetadata;
@@ -1510,6 +1525,7 @@ ${boxBottom}
           yield { type: "memory_updated" };
         }
       }
+      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) {
@@ -1831,6 +1847,7 @@ function App() {
   const [escTimer, setEscTimer] = useState4(null);
   const [queuedPrompt, setQueuedPrompt] = useState4(null);
   const [resolutionData, setResolutionData] = useState4(null);
+  const [tempModelOverride, setTempModelOverride] = useState4(null);
   const [messages, setMessages] = useState4([
     { id: "welcome", role: "system", text: FLUX_LOGO + "\n\n\u{1F30A}\u26A1 Welcome to Flux Flow! Type /help for commands.\n" }
   ]);
@@ -2201,6 +2218,10 @@ OUTPUT: ${execOutputRef.current}`;
               setStatusText(packet.content);
               continue;
             }
+            if (packet.type === "model_update") {
+              setTempModelOverride(packet.content);
+              continue;
+            }
             if (packet.type === "turn_reset") {
               currentThinkId = null;
               currentAgentId = null;
@@ -2371,7 +2392,7 @@ OUTPUT: ${execOutputRef.current}`;
           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" }, { label: "Cancel", value: "Cancel" }],
+            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" }],
             onSelect: (item) => {
               if (item.value !== "Cancel") setActiveModel(item.value);
               setActiveView("chat");
@@ -2737,7 +2758,7 @@ OUTPUT: ${execOutputRef.current}`;
           return acc + Math.max(1, Math.ceil(line.length / wrapWidth));
         }, 0);
         const maxLines = Math.max(1, wrappedLines);
-        return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", marginTop: 1, flexShrink: 0, width: "100%" }, statusText && /* @__PURE__ */ React8.createElement(Box8, { paddingX: 1, marginBottom: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "magenta", italic: true }, "\u23F3 ", statusText)), suggestions.length > 0 && /* @__PURE__ */ React8.createElement(Box8, { paddingX: 1, marginBottom: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "\u{1F4A1} Suggestions: "), suggestions.map((s, i) => /* @__PURE__ */ React8.createElement(Text8, { key: s, color: "yellow", bold: i === 0 }, " ", s, " "))), /* @__PURE__ */ React8.createElement(Box8, { backgroundColor: "#333333", paddingX: 1, paddingY: 1, width: "100%" }, /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", width: "100%" }, maxLines > 3 ? /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", width: "100%", paddingY: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray", dimColor: true }, "[\u{1F4E6} ", maxLines, " lines of text in buffer - Full content will be sent]"), /* @__PURE__ */ React8.createElement(
+        return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", marginTop: 1, flexShrink: 0, width: "100%" }, /* @__PURE__ */ React8.createElement(Box8, { paddingX: 1, marginBottom: 0, justifyContent: "space-between", width: "100%" }, /* @__PURE__ */ React8.createElement(Box8, null, statusText && /* @__PURE__ */ React8.createElement(Text8, { color: "magenta", italic: true }, "\u23F3 ", statusText)), /* @__PURE__ */ React8.createElement(Text8, { color: "gray", dimColor: true }, "(", tempModelOverride || activeModel, ")")), suggestions.length > 0 && /* @__PURE__ */ React8.createElement(Box8, { paddingX: 1, marginBottom: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray" }, "\u{1F4A1} Suggestions: "), suggestions.map((s, i) => /* @__PURE__ */ React8.createElement(Text8, { key: s, color: "yellow", bold: i === 0 }, " ", s, " "))), /* @__PURE__ */ React8.createElement(Box8, { backgroundColor: "#333333", paddingX: 1, paddingY: 1, width: "100%" }, /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", width: "100%" }, maxLines > 3 ? /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", width: "100%", paddingY: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray", dimColor: true }, "[\u{1F4E6} ", maxLines, " lines of text in buffer - Full content will be sent]"), /* @__PURE__ */ React8.createElement(
           Box8,
           {
             flexDirection: "row",
@@ -2747,7 +2768,7 @@ OUTPUT: ${execOutputRef.current}`;
             alignItems: "flex-end"
           },
           /* @__PURE__ */ React8.createElement(Box8, { flexShrink: 0, width: 3 }, /* @__PURE__ */ React8.createElement(Text8, { color: "yellow" }, "\u276F ")),
-          /* @__PURE__ */ React8.createElement(Box8, { flexGrow: 1 }, /* @__PURE__ */ React8.createElement(
+          /* @__PURE__ */ React8.createElement(Box8, { flexGrow: 1 }, /* @__PURE__ */ React8.createElement(Box8, { flexGrow: 1, position: "relative" }, input.split("\n").pop() === "" && !isProcessing && /* @__PURE__ */ React8.createElement(Box8, { position: "absolute", paddingLeft: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray", dimColor: true }, "Type your message...")), /* @__PURE__ */ React8.createElement(
             MultilineInput,
             {
               value: input.split("\n").pop() || "",
@@ -2758,14 +2779,13 @@ OUTPUT: ${execOutputRef.current}`;
                 setInput(lines.join("\n"));
               },
               onSubmit: handleSubmit,
-              placeholder: escPressed ? "Press ESC again to cancel the request." : isProcessing ? "Flux Flow is thinking..." : "Type your message or /command...",
               keyBindings: {
                 submit: (key) => key.return && !key.shift && !key.ctrl,
                 newline: (key) => key.return && key.shift || key.return && key.ctrl
               }
             }
-          ))
-        )) : /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "row", width: "100%", paddingY: 0 }, /* @__PURE__ */ React8.createElement(Box8, { flexShrink: 0, width: 3 }, /* @__PURE__ */ React8.createElement(Text8, { color: "yellow" }, "\u276F ")), /* @__PURE__ */ React8.createElement(Box8, { flexGrow: 1 }, /* @__PURE__ */ React8.createElement(
+          )))
+        )) : /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "row", width: "100%", paddingY: 0 }, /* @__PURE__ */ React8.createElement(Box8, { flexShrink: 0, width: 3 }, /* @__PURE__ */ React8.createElement(Text8, { color: "yellow" }, "\u276F ")), /* @__PURE__ */ React8.createElement(Box8, { flexGrow: 1 }, /* @__PURE__ */ React8.createElement(Box8, { flexGrow: 1, position: "relative" }, input === "" && !isProcessing && /* @__PURE__ */ React8.createElement(Box8, { position: "absolute", paddingLeft: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "gray", dimColor: true }, escPressed ? "  Press ESC again to cancel the request." : "  Type your message or /command...")), /* @__PURE__ */ React8.createElement(
           MultilineInput,
           {
             value: input,
@@ -2774,14 +2794,13 @@ OUTPUT: ${execOutputRef.current}`;
               setInput(cleanVal);
             },
             onSubmit: handleSubmit,
-            placeholder: escPressed ? "Press ESC again to cancel the request." : isProcessing ? "Flux Flow is thinking..." : "Type your message or /command...",
             maxRows: 3,
             keyBindings: {
               submit: (key) => key.return && !key.shift && !key.ctrl,
               newline: (key) => key.return && key.shift || key.return && key.ctrl
             }
           }
-        ))))));
+        )))))));
     }
   };
   return /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", width: "100%" }, /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column" }, messages.slice(0, completedIndex).map((msg, idx) => /* @__PURE__ */ React8.createElement(ChatLayout, { key: msg.id || idx, messages: [msg], showFullThinking }))), /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", padding: 1, width: "100%" }, activeView === "chat" && /* @__PURE__ */ React8.createElement(Box8, { flexDirection: "column", width: "100%" }, /* @__PURE__ */ React8.createElement(ChatLayout, { messages: messages.slice(completedIndex), showFullThinking }), activeCommand && /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, /* @__PURE__ */ React8.createElement(TerminalBox, { command: activeCommand, output: execOutput }))), isInitializing ? /* @__PURE__ */ React8.createElement(Box8, { borderStyle: "double", borderColor: "magenta", padding: 1, flexShrink: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "magenta" }, "\u{1F30A} Starting Flux Flow...")) : !apiKey ? /* @__PURE__ */ React8.createElement(Box8, { borderStyle: "bold", borderColor: "yellow", padding: 1, flexDirection: "column", flexShrink: 0 }, /* @__PURE__ */ React8.createElement(Text8, { color: "yellow", bold: true }, "\u{1F511} API KEY REQUIRED"), /* @__PURE__ */ React8.createElement(Text8, null, "Please enter your Gemini API Key to initialize the agent's brain."), /* @__PURE__ */ React8.createElement(Box8, { marginTop: 1 }, /* @__PURE__ */ React8.createElement(Text8, { color: "cyan" }, "\u276F "), /* @__PURE__ */ React8.createElement(

package/package.json

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