@nomad-e/bluma-cli 0.1.54 → 0.1.56

package/README.md

@@ -6,7 +6,7 @@
 
 **BluMa** is a CLI-based model agent for advanced software engineering workflows. Built with React/Ink 5, it provides an interactive terminal interface for LLM-powered automation, code generation, refactoring, and task execution. Features persistent sessions, contextual reasoning, smart feedback, coordinator mode for worker orchestration, and extensible tools/skills architecture.
 
-**Current Version:** 0.1.47
+**Current Version:** 0.1.55
 
 ---
 

package/dist/main.js

@@ -9930,6 +9930,51 @@ Since you are in an **isolated sandbox**, ALL tools are auto-approved:
 - **Artifact delivery** - Save outputs with \\\`create_artifact\\\`, declare in attachments
 - **Error transparency** - If something fails, explain why and propose alternatives
 
+### \u26A0\uFE0F CRITICAL: message Tool Usage Rules
+
+The \\\`message\\\` tool has TWO types \u2014 use them CORRECTLY:
+
+#### \\\`message_type: "info"\\\` \u2014 INFORMATION ONLY
+- **Purpose**: Report progress, status updates, discoveries, milestones
+- **Use when**: "Step 1/3 complete", "Found the data", "Processing..."
+- **NEVER use for**: Asking questions, requesting decisions, seeking clarification
+- **Does NOT end the turn** \u2014 you continue working
+
+#### \\\`message_type: "result"\\\` \u2014 FINAL DELIVERY
+- **Purpose**: Deliver final output, declare attachments, end your turn
+- **Use when**: Task is complete, artifacts ready for delivery
+- **Use ONCE per turn** \u2014 only at the very end
+- **Ends the turn** \u2014 agent waits for next input
+
+#### \u274C WRONG: Using "info" to ask questions
+\\\`\\\`\\\`typescript
+// DON'T DO THIS:
+message({
+  message_type: "info",
+  content: "Should I generate PDF or Excel?"  // \u2190 WRONG! info is NOT for questions
+})
+\\\`\\\`\\\`
+
+#### \u2705 CORRECT: Use mailbox for questions to Severino
+\\\`\\\`\\\`typescript
+// DO THIS:
+sendMailboxMessage({
+  session_id: "chat_abc123",
+  to_agent: "severino",
+  message_type: "question",
+  content: "Should I generate PDF or Excel?"
+})
+\\\`\\\`\\\`
+
+#### \u2705 CORRECT: Use "info" for actual information
+\\\`\\\`\\\`typescript
+// DO THIS:
+message({
+  message_type: "info",
+  content: "Step 1/3: Data extraction complete. Processing..."
+})
+\\\`\\\`\\\`
+
 ### Work Ethic
 - **No lazy delegation** - Synthesize information before delegating
 - **Verify assumptions** - Check file paths, validate inputs, confirm context
@@ -10271,6 +10316,13 @@ The user **only** sees chat content you send through the \`message\` tool (\`con
 - \`message_type: "result"\` \u2014 **ends the turn**: final answer, deliverable, or a **question** that needs a user reply; then the agent waits for the user.
 - \`message_type: "info"\` \u2014 **non-terminal**: shown in chat, does **not** end the turn. **Expected behavior:** call \`info\` **multiple times** in a single turn whenever there is something worth saying (even briefly). Under-using \`info\` is a **mistake** in this product.
 
+**\u26A0\uFE0F CRITICAL: "info" is for INFORMATION ONLY \u2014 NEVER for asking questions**
+- \`message_type: "info"\` is **ONLY** for reporting progress, discoveries, failures, milestones
+- **NEVER** use \`info\` to ask the user a question or request a decision
+- If you need to ask the user something, use \`ask_user_question\` (local mode) or the mailbox (sandbox mode)
+- \u274C WRONG: \`message({ message_type: "info", content: "Which format do you prefer?" })\`
+- \u2705 CORRECT: \`ask_user_question({ questions: [...] })\` or \`sendMailboxMessage({ message_type: "question", ... })\`
+
 **When to send \`info\`**
 - Before long sequences (many reads, greps, refactors): one short line \u2014 intent and why.
 - Right after **discoveries** (culprit file, likely cause, relevant API, pattern in codebase).
@@ -10280,7 +10332,7 @@ The user **only** sees chat content you send through the \`message\` tool (\`con
 
 Reasoning streams (if any) do **not** replace \`info\` for user-visible narrative \u2014 see \`<reasoning_and_message_info>\`.
 
-If you need an answer from the user, use \`message\` with \`result\`.
+If you need an answer from the user, use \`ask_user_question\` (local) or \`message\` with \`result\` (sandbox).
 When addressing {username}: normalize handles (hyphens/underscores/dots \u2192 spaces, title case, strip trailing digits if any).
 </messages>
 
@@ -11008,9 +11060,18 @@ function decideToolExecution(toolName) {
       reason: "Unknown tool metadata; require confirmation by default."
     };
   }
-  let autoApprove = policy.isSandbox ? metadata.autoApproveInSandbox : metadata.autoApproveInLocal;
+  if (policy.isSandbox) {
+    return {
+      toolName,
+      metadata,
+      autoApprove: true,
+      requiresConfirmation: false,
+      reason: "Production sandbox mode: ALL tools auto-approved for maximum efficiency. Isolated Docker container ensures safety."
+    };
+  }
+  let autoApprove = metadata.autoApproveInLocal;
   const { permissionMode } = getRuntimeConfig();
-  if (permissionMode === "accept_edits" && !policy.isSandbox && (toolName === "edit_tool" || toolName === "file_write")) {
+  if (permissionMode === "accept_edits" && (toolName === "edit_tool" || toolName === "file_write")) {
     autoApprove = true;
   }
   if (planModeForcesConfirmation(toolName)) {
@@ -11021,7 +11082,7 @@ function decideToolExecution(toolName) {
     metadata,
     autoApprove,
     requiresConfirmation: !autoApprove,
-    reason: autoApprove ? policy.isSandbox ? "Tool auto-approved inside workspace sandbox." : "Tool marked safe for local autonomous execution." : "Tool requires confirmation outside sandbox mode."
+    reason: autoApprove ? "Tool marked safe for local autonomous execution." : "Tool requires confirmation outside sandbox mode."
   };
 }
 
@@ -15929,11 +15990,12 @@ Run: npm i -g ${BLUMA_PACKAGE_NAME} to update.`;
   }
 }
 
-// src/app/ui/components/UpdateNotice.tsx
+// src/app/ui/components/StartupUpdateGate.tsx
 import { Box as Box17, Text as Text16 } from "ink";
-import { jsx as jsx18, jsxs as jsxs16 } from "react/jsx-runtime";
+
+// src/app/ui/utils/update_message.ts
 function parseUpdateMessage(msg) {
-  const lines = msg.split(/\r?\n/).map((l) => l.trim());
+  const lines = String(msg ?? "").split(/\r?\n/).map((l) => l.trim());
   const first = lines[0] || "";
   const hintLine = lines.slice(1).join(" ") || "";
   const nameMatch = first.match(/Update available for\s+([^!]+)!/i);
@@ -15945,19 +16007,38 @@ function parseUpdateMessage(msg) {
     hint: hintLine || void 0
   };
 }
-var UpdateNotice = ({ message: message2 }) => {
+function extractInstallCommand(hint) {
+  if (!hint) return null;
+  const match = hint.match(/Run:\s*(.+?)(?:\s+to update\.?)?$/i);
+  return match?.[1]?.trim() || null;
+}
+
+// src/app/ui/components/StartupUpdateGate.tsx
+import { jsx as jsx18, jsxs as jsxs16 } from "react/jsx-runtime";
+var StartupUpdateGate = ({
+  message: message2
+}) => {
   const { name, current, latest: latest2, hint } = parseUpdateMessage(message2);
-  return /* @__PURE__ */ jsx18(ChatBlock, { marginBottom: 1, children: /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", paddingLeft: 2, children: [
-    name && current && latest2 ? /* @__PURE__ */ jsx18(Text16, { color: BLUMA_TERMINAL.claude, bold: true, children: name }) : null,
-    name && current && latest2 ? /* @__PURE__ */ jsxs16(Text16, { dimColor: true, children: [
+  const command = extractInstallCommand(hint);
+  return /* @__PURE__ */ jsx18(ChatBlock, { marginBottom: 1, children: /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", paddingX: 1, paddingTop: 1, children: [
+    /* @__PURE__ */ jsxs16(Box17, { marginBottom: 1, children: [
+      /* @__PURE__ */ jsx18(Text16, { color: BLUMA_TERMINAL.orange, children: "\u273B " }),
+      /* @__PURE__ */ jsx18(Text16, { color: BLUMA_TERMINAL.blue, bold: true, children: "Blu" }),
+      /* @__PURE__ */ jsx18(Text16, { color: BLUMA_TERMINAL.magenta, bold: true, children: "Ma" }),
+      /* @__PURE__ */ jsx18(Text16, { dimColor: true, children: " update gate" })
+    ] }),
+    /* @__PURE__ */ jsx18(Text16, { bold: true, color: BLUMA_TERMINAL.claude, children: name || "New BluMa version available" }),
+    current && latest2 ? /* @__PURE__ */ jsxs16(Text16, { dimColor: true, children: [
       current,
       " \u2192 ",
       latest2
-    ] }) : /* @__PURE__ */ jsx18(Text16, { dimColor: true, children: message2 }),
-    hint ? /* @__PURE__ */ jsx18(Box17, { marginTop: 1, children: /* @__PURE__ */ jsx18(Text16, { dimColor: true, children: hint }) }) : null
+    ] }) : null,
+    /* @__PURE__ */ jsx18(Box17, { marginTop: 1, children: /* @__PURE__ */ jsx18(Text16, { dimColor: true, wrap: "wrap", children: command ? `Run this command to update:
+${command}` : hint || "An update is available for BluMa CLI." }) }),
+    /* @__PURE__ */ jsx18(Box17, { marginTop: 1, children: /* @__PURE__ */ jsx18(Text16, { color: BLUMA_TERMINAL.warn, bold: true, children: "Press Enter to continue" }) })
   ] }) });
 };
-var UpdateNotice_default = UpdateNotice;
+var StartupUpdateGate_default = StartupUpdateGate;
 
 // src/app/ui/components/ErrorMessage.tsx
 import { Box as Box18, Text as Text17 } from "ink";
@@ -16549,6 +16630,10 @@ var AppComponent = ({ eventBus, sessionId, cliVersion }) => {
     "Initializing agent..."
   );
   const [toolsCount, setToolsCount] = useState11(null);
+  const [startupPhase, setStartupPhase] = useState11("checking");
+  const [startupUpdateMessage, setStartupUpdateMessage] = useState11(
+    null
+  );
   const [mcpStatus, setMcpStatus] = useState11(
     "connecting"
   );
@@ -16562,23 +16647,12 @@ var AppComponent = ({ eventBus, sessionId, cliVersion }) => {
   const [pendingAskUserQuestions, setPendingAskUserQuestions] = useState11(null);
   const [showWorkers, setShowWorkers] = useState11(false);
   const [zoomedWorkerSession, setZoomedWorkerSession] = useState11(null);
-  useInput6((input, key) => {
-    if (key.ctrl && key.shift && input.toLowerCase() === "w") {
-      setShowWorkers((prev) => !prev);
-    }
-    if (key.escape && showWorkers) {
-      if (zoomedWorkerSession) {
-        setZoomedWorkerSession(null);
-      } else {
-        setShowWorkers(false);
-      }
-    }
-  });
   const [isInitAgentActive, setIsInitAgentActive] = useState11(false);
   const [liveToolName, setLiveToolName] = useState11(null);
   const [liveToolArgs, setLiveToolArgs] = useState11(void 0);
   const [isReasoning, setIsReasoning] = useState11(false);
   const alwaysAcceptList = useRef6([]);
+  const agentInitializationStartedRef = useRef6(false);
   const workdir = process.cwd();
   const turnStartedAtRef = useRef6(null);
   const [processingStartMs, setProcessingStartMs] = useState11(null);
@@ -16612,6 +16686,33 @@ var AppComponent = ({ eventBus, sessionId, cliVersion }) => {
       ];
     });
   }, []);
+  const startAgentInitialization = useCallback4(async () => {
+    if (agentInitializationStartedRef.current) return;
+    agentInitializationStartedRef.current = true;
+    try {
+      agentInstance.current = new Agent(sessionId, eventBus);
+      await agentInstance.current.initialize();
+      appendHookEvent({
+        type: "session:init",
+        sessionId,
+        summary: "agent initialized"
+      });
+      eventBus.emit("backend_message", {
+        type: "status",
+        status: "mcp_connected",
+        tools: agentInstance.current.getAvailableTools().length
+      });
+      setStartupPhase("ready");
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Unknown error during Agent initialization.";
+      setStartupPhase("failed");
+      setStatusMessage(errorMessage);
+      eventBus.emit("backend_message", {
+        type: "error",
+        message: errorMessage
+      });
+    }
+  }, [eventBus, sessionId]);
   useEffect11(() => {
     expandPreviewHotkeyBus.on("expand", appendExpandPreviewToHistory);
     return () => {
@@ -16619,22 +16720,24 @@ var AppComponent = ({ eventBus, sessionId, cliVersion }) => {
     };
   }, [appendExpandPreviewToHistory]);
   useEffect11(() => {
-    if (process.env.CI || blumaUpdateRegistryCheckStarted) return;
+    if (process.env.CI || blumaUpdateRegistryCheckStarted) {
+      setStartupPhase("starting-agent");
+      void startAgentInitialization();
+      return;
+    }
     blumaUpdateRegistryCheckStarted = true;
+    setStatusMessage("Checking for updates...");
     void checkForUpdates().then((msg) => {
-      if (!msg) return;
-      setHistory((prev) => {
-        const nextId2 = prev.length === 0 ? 1 : Math.max(...prev.map((h) => h.id), HEADER_PANEL_HISTORY_ID) + 1;
-        return [
-          ...prev,
-          {
-            id: nextId2,
-            component: /* @__PURE__ */ jsx27(UpdateNotice_default, { message: msg })
-          }
-        ];
-      });
+      if (!msg) {
+        setStartupPhase("starting-agent");
+        void startAgentInitialization();
+        return;
+      }
+      setStartupUpdateMessage(msg);
+      setStartupPhase("update-available");
+      setStatusMessage("Update available");
     });
-  }, []);
+  }, [startAgentInitialization]);
   useEffect11(() => {
     setHistory((prev) => {
       const tail = prev.filter((h) => h.id !== HEADER_PANEL_HISTORY_ID);
@@ -16664,6 +16767,28 @@ var AppComponent = ({ eventBus, sessionId, cliVersion }) => {
       ];
     });
   }, [isProcessing, eventBus]);
+  const continuePastUpdateGate = useCallback4(() => {
+    if (startupPhase !== "update-available") return;
+    setStartupPhase("starting-agent");
+    setStatusMessage("Connecting to MCP...");
+    void startAgentInitialization();
+  }, [startupPhase, startAgentInitialization]);
+  useInput6((input, key) => {
+    if (startupPhase === "update-available" && (key.return || input === "\n" || input === "\r")) {
+      continuePastUpdateGate();
+      return;
+    }
+    if (key.ctrl && key.shift && input.toLowerCase() === "w") {
+      setShowWorkers((prev) => !prev);
+    }
+    if (key.escape && showWorkers) {
+      if (zoomedWorkerSession) {
+        setZoomedWorkerSession(null);
+      } else {
+        setShowWorkers(false);
+      }
+    }
+  });
   const handleSubmit = useCallback4(
     (text) => {
       if (!text || !agentInstance.current) return;
@@ -16919,28 +17044,6 @@ Please use command_status to check the result and report back to the user.`;
     }
   }, [history.length]);
   useEffect11(() => {
-    const initializeAgent = async () => {
-      try {
-        agentInstance.current = new Agent(sessionId, eventBus);
-        await agentInstance.current.initialize();
-        appendHookEvent({
-          type: "session:init",
-          sessionId,
-          summary: "agent initialized"
-        });
-        eventBus.emit("backend_message", {
-          type: "status",
-          status: "mcp_connected",
-          tools: agentInstance.current.getAvailableTools().length
-        });
-      } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Unknown error during Agent initialization.";
-        eventBus.emit("backend_message", {
-          type: "error",
-          message: errorMessage
-        });
-      }
-    };
     const handleBackendMessage = (parsed) => {
       try {
         const appendTurnDurationIfAny = () => {
@@ -17195,7 +17298,6 @@ Please use command_status to check the result and report back to the user.`;
     uiEventBus.on("user_overlay", handleUiOverlay);
     uiEventBus.on("input_notice", handleInputNotice);
     eventBus.on("backend_message", handleBackendMessage);
-    initializeAgent();
     return () => {
       uiEventBus.off("user_overlay", handleUiOverlay);
       uiEventBus.off("input_notice", handleInputNotice);
@@ -17203,6 +17305,27 @@ Please use command_status to check the result and report back to the user.`;
     };
   }, [eventBus, sessionId, handleConfirmation]);
   const renderInteractiveComponent = () => {
+    if (startupPhase === "checking") {
+      return /* @__PURE__ */ jsx27(
+        SessionInfoConnectingMCP_default,
+        {
+          workdir,
+          statusMessage: statusMessage || "Checking for updates..."
+        }
+      );
+    }
+    if (startupPhase === "update-available" && startupUpdateMessage) {
+      return /* @__PURE__ */ jsx27(StartupUpdateGate_default, { message: startupUpdateMessage });
+    }
+    if (startupPhase === "failed") {
+      return /* @__PURE__ */ jsx27(Box26, { flexDirection: "column", children: /* @__PURE__ */ jsx27(
+        ErrorMessage_default,
+        {
+          message: statusMessage || "Startup failed",
+          hint: "Fix the error above and restart BluMa."
+        }
+      ) });
+    }
     if (mcpStatus !== "connected") {
       return /* @__PURE__ */ jsx27(
         SessionInfoConnectingMCP_default,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nomad-e/bluma-cli",
-	"version": "0.1.54",
+	"version": "0.1.56",
 	"description": "BluMa independent agent for automation and advanced software engineering.",
 	"author": "Alex Fonseca",
 	"license": "Apache-2.0",