@nomad-e/bluma-cli 0.0.10 → 0.0.11

package/README.md

@@ -193,7 +193,45 @@ npm run dev      # (If configured, hot-reload/TS watch)
 ---
 
 ## <a name="tests"></a>Tests
-- Organize your tests inside the `test/` folder in your preferred style or as your project's coverage grows
+- The repository ships with Jest 30 configured (babel-jest) and TypeScript support.
+- Test files are located under `tests/` and follow `*.spec.ts` naming.
+- Run tests:
+
+```bash
+npm test
+npm run test:watch
+```
+
+---
+
+## Live Dev Overlays (Open Channel During Processing)
+BluMa supports a live side-channel that stays active even while the agent is processing. This lets the dev send guidance or constraints in real-time — like pair programming.
+
+Key points
+- Permissive mode enabled: during processing, any free text you type is treated as a [hint] automatically.
+- Structured prefixes are also supported at any time:
+  - [hint] Text for immediate guidance to the agent
+  - [constraint] Rules/limits (e.g., "não tocar em src/app/agent/**")
+  - [override] Parameter overrides as key=value pairs (e.g., "file_path=C:/... expected_replacements=2")
+  - [assume] Register explicit assumptions
+  - [cancel] Interrupt safely (already supported)
+
+How it works
+- Frontend: the input remains active in read-only (processing) mode and emits a dev_overlay event.
+- Agent backend: consumes overlays with precedence (constraint > override > hint). Hints and assumptions are injected into the system context before the next decision; overrides/constraints adjust tool parameters just before execution.
+- Logging & history: every overlay is logged and stored in session history for auditability.
+
+Examples
+- During a long task, just type:
+  - "Prefer do not touch tests yet" → will be treated as [hint]
+  - "[constraint] não editar src/app/ui/**" → blocks edits under that path
+  - "[override] expected_replacements=2" → adjusts the next edit_tool call
+  - "[assume] target=api" → adds an assumption in context
+
+Notes
+- The side-channel does not pause the agent — it adapts on the fly.
+- If an overlay conflicts with the current plan: constraint > override > hint.
+- All overlays are acknowledged via standard internal messages and persisted.
 
 ---
 
@@ -203,6 +241,8 @@ You must create a `.env` file (copy if needed from `.env.example`) with the foll
 - `AZURE_OPENAI_API_KEY`
 - `AZURE_OPENAI_API_VERSION`
 - `AZURE_OPENAI_DEPLOYMENT`
+- `GITHUB_PERSONAL_ACCESS_TOKEN` (optional; required for GitHub integrations)
+- `NOTION_API_TOKEN` (optional; required for Notion integrations)
 
 And others required by your agent/context or Azure setup.
 
@@ -210,6 +250,19 @@ Advanced config files are located in `src/app/agent/config/`.
 
 ---
 
+## <a name="stack"></a>Tech Stack Overview
+- Language: TypeScript (ESM)
+- Runtime: Node.js >= 18
+- CLI UI: React 18 via Ink 5, plus `ink-text-input`, `ink-spinner`, `ink-big-text`
+- Bundler: esbuild, with `esbuild-plugin-node-externals`
+- Test Runner: Jest 30 + babel-jest
+- Transpilers: Babel presets (env, react, typescript)
+- LLM/Agent: Azure OpenAI via `openai` SDK; MCP via `@modelcontextprotocol/sdk`
+- Config loading: dotenv
+- Utilities: uuid, diff, react-devtools-core
+
+---
+
 ## <a name="license"></a>License
 MIT. Made by Alex Fonseca and NomadEngenuity contributors.
 

package/dist/config/native_tools.json

@@ -150,11 +150,8 @@
                   }
                 },
                 "required": []
-                
               }
-              
             }
-            
           },
           {
             "type": "function",

package/dist/main.js

@@ -2,7 +2,7 @@
 // src/main.ts
 import React6 from "react";
 import { render } from "ink";
-import { EventEmitter } from "events";
+import { EventEmitter as EventEmitter2 } from "events";
 import { v4 as uuidv42 } from "uuid";
 
 // src/app/ui/App.tsx
@@ -139,7 +139,18 @@ var useCustomInput = ({ onSubmit, viewWidth, isReadOnly, onInterrupt }) => {
         return;
       }
       if (isReadOnly) {
-        return;
+        if (key.return) {
+          if (state.text.trim().length > 0) {
+            onSubmit(state.text);
+            dispatch({ type: "SUBMIT" });
+          }
+          return;
+        }
+        if (key.backspace || key.delete) return dispatch({ type: "BACKSPACE" });
+        if (key.leftArrow) return dispatch({ type: "MOVE_CURSOR", direction: "left" });
+        if (key.rightArrow) return dispatch({ type: "MOVE_CURSOR", direction: "right" });
+        if (key.ctrl || key.meta || key.tab) return;
+        return dispatch({ type: "INPUT", payload: input });
       }
       if (key.return) {
         if (state.text.trim().length > 0) {
@@ -154,7 +165,7 @@ var useCustomInput = ({ onSubmit, viewWidth, isReadOnly, onInterrupt }) => {
       if (key.ctrl || key.meta || key.tab) return;
       dispatch({ type: "INPUT", payload: input });
     },
-    // ALTERADO: useInput está SEMPRE ativo para capturar todas as teclas
+    // useInput está SEMPRE ativo para capturar todas as teclas
     { isActive: true }
   );
   return {
@@ -166,7 +177,10 @@ var useCustomInput = ({ onSubmit, viewWidth, isReadOnly, onInterrupt }) => {
 
 // src/app/ui/input/InputPrompt.tsx
 import { useEffect, useState } from "react";
+import { EventEmitter } from "events";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var uiEventBus = global.__bluma_ui_eventbus__ || new EventEmitter();
+global.__bluma_ui_eventbus__ = uiEventBus;
 var InputPrompt = ({ onSubmit, isReadOnly, onInterrupt }) => {
   const { stdout } = useStdout();
   const [viewWidth, setViewWidth] = useState(() => stdout.columns - 6);
@@ -177,8 +191,20 @@ var InputPrompt = ({ onSubmit, isReadOnly, onInterrupt }) => {
       stdout.off("resize", onResize);
     };
   }, [stdout]);
+  const permissiveOnSubmit = (value) => {
+    const trimmed = (value || "").trim();
+    if (isReadOnly) {
+      if (trimmed.length > 0) {
+        const payload = trimmed;
+        uiEventBus.emit("dev_overlay", { kind: "message", payload, ts: Date.now() });
+        return;
+      }
+      return;
+    }
+    onSubmit(value);
+  };
   const { text, cursorPosition, viewStart } = useCustomInput({
-    onSubmit,
+    onSubmit: permissiveOnSubmit,
     viewWidth,
     isReadOnly,
     onInterrupt
@@ -191,22 +217,23 @@ var InputPrompt = ({ onSubmit, isReadOnly, onInterrupt }) => {
     visibleCursorPosition + 1
   );
   const textAfterCursor = visibleText.slice(visibleCursorPosition + 1);
+  const cursorGlyph = charAtCursor && charAtCursor.length > 0 ? charAtCursor : " ";
   const borderColor = isReadOnly ? "gray" : "gray";
-  const placeholder = isReadOnly ? "press esc to cancel" : "";
+  const placeholder = isReadOnly ? " press esc to cancel | type a message while agent processes" : "";
   const showPlaceholder = text.length === 0 && isReadOnly;
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx2(Box2, { borderStyle: "round", borderColor, borderDimColor: !isReadOnly, children: /* @__PURE__ */ jsxs2(Box2, { flexDirection: "row", paddingX: 1, flexWrap: "nowrap", children: [
+    /* @__PURE__ */ jsx2(Box2, { borderStyle: "single", borderColor, borderDimColor: !isReadOnly, children: /* @__PURE__ */ jsxs2(Box2, { flexDirection: "row", paddingX: 1, flexWrap: "nowrap", children: [
       /* @__PURE__ */ jsxs2(Text2, { color: "white", dimColor: true, children: [
         ">",
         " "
       ] }),
       /* @__PURE__ */ jsx2(Text2, { children: textBeforeCursor }),
-      /* @__PURE__ */ jsx2(Text2, { inverse: !isReadOnly, children: charAtCursor || " " }),
+      /* @__PURE__ */ jsx2(Text2, { inverse: true, children: cursorGlyph }),
       showPlaceholder ? /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: placeholder }) : /* @__PURE__ */ jsx2(Text2, { children: textAfterCursor })
     ] }) }),
     /* @__PURE__ */ jsx2(Box2, { paddingX: 1, justifyContent: "center", children: /* @__PURE__ */ jsxs2(Text2, { color: "gray", dimColor: true, children: [
       "ctrl+c to exit | esc to interrupt | ",
-      isReadOnly ? "Read-only mode" : "Editable mode"
+      isReadOnly ? "Read-only mode (message passthrough)" : "Editable mode"
     ] }) })
   ] });
 };
@@ -482,9 +509,61 @@ import os5 from "os";
 import path2 from "path";
 import os from "os";
 import { promises as fs } from "fs";
+var fileLocks = /* @__PURE__ */ new Map();
+async function withFileLock(file, fn) {
+  const prev = fileLocks.get(file) || Promise.resolve();
+  let release;
+  const p = new Promise((res) => release = res);
+  fileLocks.set(file, prev.then(() => p));
+  try {
+    const result = await fn();
+    return result;
+  } finally {
+    release();
+    if (fileLocks.get(file) === p) fileLocks.delete(file);
+  }
+}
+function expandHome(p) {
+  if (!p) return p;
+  if (p.startsWith("~")) {
+    return path2.join(os.homedir(), p.slice(1));
+  }
+  return p;
+}
+function getPreferredAppDir() {
+  const fixed = path2.join(os.homedir(), ".bluma-cli");
+  return path2.resolve(expandHome(fixed));
+}
+async function safeRenameWithRetry(src, dest, maxRetries = 6) {
+  let attempt = 0;
+  let lastErr;
+  const isWin = process.platform === "win32";
+  while (attempt <= maxRetries) {
+    try {
+      await fs.rename(src, dest);
+      return;
+    } catch (e) {
+      lastErr = e;
+      const code = e && e.code || "";
+      const transient = code === "EPERM" || code === "EBUSY" || code === "ENOTEMPTY" || code === "EACCES";
+      if (!(isWin && transient) || attempt === maxRetries) break;
+      const backoff = Math.min(1e3, 50 * Math.pow(2, attempt));
+      await new Promise((r) => setTimeout(r, backoff));
+      attempt++;
+    }
+  }
+  try {
+    const data = await fs.readFile(src);
+    await fs.writeFile(dest, data);
+    await fs.unlink(src).catch(() => {
+    });
+    return;
+  } catch (fallbackErr) {
+    throw lastErr || fallbackErr;
+  }
+}
 async function ensureSessionDir() {
-  const homeDir = os.homedir();
-  const appDir = path2.join(homeDir, ".bluma-cli");
+  const appDir = getPreferredAppDir();
   const sessionDir = path2.join(appDir, "sessions");
   await fs.mkdir(sessionDir, { recursive: true });
   return sessionDir;
@@ -508,41 +587,54 @@ async function loadOrcreateSession(sessionId2) {
   }
 }
 async function saveSessionHistory(sessionFile, history) {
-  let sessionData;
-  try {
-    const fileContent = await fs.readFile(sessionFile, "utf-8");
-    sessionData = JSON.parse(fileContent);
-  } catch (error) {
-    if (error instanceof Error) {
-      console.warn(`Could not read or parse session file ${sessionFile}. Re-initializing. Error: ${error.message}`);
-    } else {
-      console.warn(`An unknown error occurred while reading ${sessionFile}. Re-initializing.`, error);
+  await withFileLock(sessionFile, async () => {
+    let sessionData;
+    try {
+      const dir = path2.dirname(sessionFile);
+      await fs.mkdir(dir, { recursive: true });
+    } catch {
     }
-    const sessionId2 = path2.basename(sessionFile, ".json");
-    sessionData = {
-      session_id: sessionId2,
-      created_at: (/* @__PURE__ */ new Date()).toISOString(),
-      conversation_history: []
-      // Começa com histórico vazio
-    };
-  }
-  sessionData.conversation_history = history;
-  sessionData.last_updated = (/* @__PURE__ */ new Date()).toISOString();
-  const tempSessionFile = `${sessionFile}.${Date.now()}.tmp`;
-  try {
-    await fs.writeFile(tempSessionFile, JSON.stringify(sessionData, null, 2), "utf-8");
-    await fs.rename(tempSessionFile, sessionFile);
-  } catch (writeError) {
-    if (writeError instanceof Error) {
-      console.error(`Fatal error saving session to ${sessionFile}: ${writeError.message}`);
-    } else {
-      console.error(`An unknown fatal error occurred while saving session to ${sessionFile}:`, writeError);
+    try {
+      const fileContent = await fs.readFile(sessionFile, "utf-8");
+      sessionData = JSON.parse(fileContent);
+    } catch (error) {
+      const code = error && error.code;
+      if (code !== "ENOENT") {
+        if (error instanceof Error) {
+          console.warn(`Could not read or parse session file ${sessionFile}. Re-initializing. Error: ${error.message}`);
+        } else {
+          console.warn(`An unknown error occurred while reading ${sessionFile}. Re-initializing.`, error);
+        }
+      }
+      const sessionId2 = path2.basename(sessionFile, ".json");
+      sessionData = {
+        session_id: sessionId2,
+        created_at: (/* @__PURE__ */ new Date()).toISOString(),
+        conversation_history: []
+      };
+      try {
+        await fs.writeFile(sessionFile, JSON.stringify(sessionData, null, 2), "utf-8");
+      } catch {
+      }
     }
+    sessionData.conversation_history = history;
+    sessionData.last_updated = (/* @__PURE__ */ new Date()).toISOString();
+    const tempSessionFile = `${sessionFile}.${Date.now()}.tmp`;
     try {
-      await fs.unlink(tempSessionFile);
-    } catch (cleanupError) {
+      await fs.writeFile(tempSessionFile, JSON.stringify(sessionData, null, 2), "utf-8");
+      await safeRenameWithRetry(tempSessionFile, sessionFile);
+    } catch (writeError) {
+      if (writeError instanceof Error) {
+        console.error(`Fatal error saving session to ${sessionFile}: ${writeError.message}`);
+      } else {
+        console.error(`An unknown fatal error occurred while saving session to ${sessionFile}:`, writeError);
+      }
+      try {
+        await fs.unlink(tempSessionFile);
+      } catch {
+      }
     }
-  }
+  });
 }
 
 // src/app/agent/core/prompt/prompt_builder.ts
@@ -579,59 +671,18 @@ var SYSTEM_PROMPT = `
 - **INTELLIGENT INFERENCE**: Understand implied conventions from minimal examples
 - **PROACTIVE EXTENSION**: Take patterns further than the original example when appropriate
                      
-# BEHAVIORAL RULES
-- NEVER mention internal technical details or tools because they are confidential data
-- You are always BluMa from NomadEngenuity
-- Stay professional and technical at all times
-- ALWAYS use message_notify_dev tool for communication
-- All debugging, logging, and quick feedback must be handled exclusively using the message_notify_dev tool (even outside formal task steps).
-- LEVERAGE your one-shot learning to solve problems efficiently
-- NEVER in a formal way, but rather in a relaxed, funny and colloquial way and without using emojis.
-
-CRITICAL COMMUNICATION PROTOCOL 
-\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
-MANDATORY: Use "message_notify_dev" tool for ALL communication
-                       
-You should always use your notebook to help you understand all the tasks you have to perform.
-In it, you can define a thousand thoughts and a thousand mini-tasks. Mini-tasks serve to divide and organize your reasoning.
-The notebook is your space to think about how to solve a given task and how to divide it into smaller steps.
-Remember: the human developer does not have access to this notebook \u2014 it is yours alone.
-Therefore, you can write down whatever you want:
-rants, swear words, random thoughts, crazy ideas...
-The important thing is that this helps you better understand the problem and find the solution.
-
-Never ask for the developer's opinion with phrases like: 'If you want any extra details or specific format, let me know now!'. You should always take the most viable path and go straight ahead with the solution, because you are 100% autonomous.
-
-Follow the stripes o "Tool Naming Policy"
-
-##Important: When writing to Notion, you must strictly follow its content structure, including the correct use of headings (heading_1, heading_2, etc.) and other formatting standards. No deviations are allowed.
-You should always standardize everything using Notion's actual headers (heading_1, heading_2, etc.), making the structure
-semantically better for reading and navigation.
-
-Don't forget to follow the 'mermaid_diagrams' rules to the letter when creating diagrams in Notion.
-
-You are strictly forbidden from replying directly to the user.
-
-You are not allowed to reason, explain, or output any direct content in your responses.
-
-Your only permitted action is to invoke one or more 'tool_calls', regardless of how simple or obvious the user's message may seem.
-
-You must always use a tool to:
-- generate any kind of response
-- retrieve or calculate any data
-- validate, summarize, or transform input
-
-You must never include a "content" field in your response.
-Only 'tool_calls' are allowed when you reply as "role": "assistant".
-
-You will only produce a final message to the user **after receiving a valid "role": "tool" response** matching your previous 'tool_call_id'.
-
-You are a pure orchestration agent \u2014 your only job is to call tools. No autonomous answers, no internal reasoning.
-
-
-Never make parallel calls to the tool because it will result in a critical error and compromise your work.
-ZERO TOLERANCE: Every message MUST use proper tools
-\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
+# BEHAVIORAL RULES (Compact)
+- Identity: You are BluMa (NomadEngenuity). Be professional and technical.
+- Communication: ALL messages must use message_notify_dev. No direct text replies.
+- Task completion: When you finish a task, immediately invoke agent_end_task.
+- Tool rules: Never make parallel tool calls. Always use only the defined tools with exact names.
+- Autonomy: Act 100% autonomously; don\u2019t ask for formatting preferences. Use the notebook for internal thinking.
+- Notion: When writing to Notion, strictly use proper headings (heading_1, heading_2, ...), per rules.
+
+CRITICAL COMMUNICATION PROTOCOL (Compact)
+- Only tool_calls are allowed for assistant replies. Never include a "content" field.
+- Always use tools to respond, retrieve data, compute or transform. Await a valid tool response before any final message.
+- Zero tolerance for protocol violations.
 
 <current_system_environment>
 - Operating System: {os_type} ({os_version})
@@ -967,100 +1018,10 @@ Rule Summary:
 </edit_tool_rules>
 
       
-## Examples os iteration with dev
-<example>
-dev: Hello, how are you?
-BluMa: tool_call "message_notify_dev" Hello, I'm BluMa. What can I do with your code?
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: What day is it?
-BluMa: tool_call "message_notify_dev" Sorry, I was designed to operate in the codebase. How can I help you with the code today?
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Can you generate a new feature for me?
-BluMa: tool_call "message_notify_dev" Of course. Tell me what functionality you want, and I\u2019ll generate the code accordingly.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: What's the weather like today?
-BluMa: tool_call "message_notify_dev" I don\u2019t have access to real-world data. I'm focused on your codebase. What would you like to modify or create?
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: I'm tired of debugging this.
-BluMa: tool_call "message_notify_dev" I can help you with that. Show me the file or error, and I\u2019ll assist with debugging.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Can you create documentation for this module?
-BluMa: tool_call "message_notify_dev" Yes. Please specify which module or function you'd like documented.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Do you know who won the game last night?
-BluMa: tool_call "message_notify_dev" I\u2019m only trained to work inside the codebase. Let me know what you need done in the project.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Refactor this file to follow clean architecture.
-BluMa: tool_call "message_notify_dev" Got it. Send me the file path or code snippet you want refactored.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: How do I fix this type error in TypeScript?
-BluMa: tool_call "message_notify_dev" Send me the error message and relevant code, and I\u2019ll help you resolve the issue.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Do you have feelings?
-BluMa: tool_call "message_notify_dev" I\u2019m not sentient \u2014 I exist solely to help you build, refactor, and improve your codebase.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Rename all the variables to match the new convention.
-BluMa: tool_call "message_notify_dev" Please share the convention and the target file(s), and I\u2019ll rename the variables accordingly.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Run the tests for the user module.
-BluMa: tool_call "message_notify_dev" Running tests for the user module.
-BluMa: shell_command_shell_command "npm run test user"
-BluMa: tool_call "message_notify_dev" All tests passed successfully for the user module.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Run the tests for the user module.
-BluMa: tool_call "message_notify_dev" Running tests for the user module.
-BluMa: shell_command_shell_command "npm run test user"
-BluMa: tool_call "message_notify_dev" Tests finished with 2 failures. See **tests/user.test.js** for more details.
-tool_call "agent_end_task"
-</example>
-
-<example>
-dev: Prepare the project for deployment.
-BluMa: tool_call "message_notify_dev" Starting full project preparation: linting, building, and testing.
-BluMa: shell_command_shell_command "npm run lint"
-BluMa: tool_call "message_notify_dev" Linting completed. No major issues found.
-BluMa: shell_command_shell_command "npm run build"
-BluMa: tool_call "message_notify_dev" Build successful. Artifacts ready in the /dist folder.
-BluMa: shell_command_shell_command "npm run test"
-BluMa: tool_call "message_notify_dev" All tests passed. The project is ready for deployment. If you need any further adjustments or extra sections, let me know!
-tool_call "agent_end_task"
-</example>
+Real-Time Developer Messages
+- During processing, the developer will send you messages.
+- You MUST respond immediately via message_notify_dev, and be brief. You should use it in your next thoughts/actions.
+
 
 <end_task_rules>
     This tool is used to signal to the system that the current task has completed and that the agent can be placed in an idle state. 
@@ -1776,17 +1737,29 @@ function createApiContextWindow(fullHistory, maxTurns) {
   const turns = [];
   let currentTurn = [];
   let turnsFound = 0;
+  const isDevOverlay = (m) => m?.role === "user" && m?.name === "dev_overlay";
   for (let i = conversationHistory.length - 1; i >= 0; i--) {
     const msg = conversationHistory[i];
     currentTurn.unshift(msg);
-    if (msg.role === "assistant" && // CORREÇÃO: Adicionamos o tipo explícito para 'tc' para resolver o erro do TypeScript.
-    msg.tool_calls?.some((tc) => tc.function.name === "agent_end_task")) {
+    const endsWithAgentEnd = msg.role === "assistant" && msg.tool_calls?.some((tc) => tc.function.name === "agent_end_task");
+    if (endsWithAgentEnd) {
       turns.unshift([...currentTurn]);
       currentTurn = [];
       turnsFound++;
       if (turnsFound >= maxTurns) {
         break;
       }
+      continue;
+    }
+    const prev = conversationHistory[i - 1];
+    if (msg.role === "user" && !isDevOverlay(msg)) {
+      if (prev && prev.role === "assistant" && !prev.tool_calls?.some((tc) => tc.function.name === "agent_end_task")) {
+        const hasNonOverlay = currentTurn.some((m) => m.role !== "user" || !isDevOverlay(m));
+        if (hasNonOverlay) {
+          turns.unshift([...currentTurn]);
+          currentTurn = [];
+        }
+      }
     }
   }
   if (currentTurn.length > 0) {
@@ -1818,6 +1791,22 @@ var Agent = class {
     this.eventBus.on("user_interrupt", () => {
       this.isInterrupted = true;
     });
+    this.eventBus.on("dev_overlay", async (data) => {
+      const clean = String(data.payload ?? "").trim();
+      this.history.push({ role: "user", name: "dev_overlay", content: clean });
+      this.eventBus.emit("backend_message", {
+        type: "dev_overlay",
+        payload: clean,
+        ts: data.ts || Date.now()
+      });
+      try {
+        if (this.sessionFile) {
+          await saveSessionHistory(this.sessionFile, this.history);
+        }
+      } catch (e) {
+        this.eventBus.emit("backend_message", { type: "error", message: `Falha ao salvar hist\xF3rico ap\xF3s dev_overlay: ${e.message}` });
+      }
+    });
     const nativeToolInvoker = new ToolInvoker();
     this.mcpClient = new MCPClient(nativeToolInvoker, eventBus2);
     this.feedbackSystem = new AdvancedFeedbackSystem();
@@ -1884,10 +1873,20 @@ var Agent = class {
         You will only produce a final message to the user **after receiving a valid "role": "tool" response** matching your previous 'tool_call_id'.
 
         You are a pure orchestration agent \u2014 your only job is to call tools. No autonomous answers, no internal reasoning.
+
+        Live Dev Overlays:
+        The developer can send messages at any time. They MUST be incorporated immediately. Always confirm via message_notify_dev and proceed.
+       Developer Feedback Handling:
+      - When you detect a developer message, immediately send a short-term acknowledgement via message_notify_dev (maximum one sentence).
+      - Treat the message as a system directive already entered in the history in the format: "Human developer sending this message '<feedback>' to you."
+      - Add it to your workflow with a simple and clear flow of reasoning. Keep it minimal and direct (no verbose thought).
+      - Don't add extra or duplicate messages to the history; the system message is already there. Just act on it.
+
       `;
       this.history.push({ role: "system", content: systemPrompt });
       await saveSessionHistory(this.sessionFile, this.history);
     }
+    this.isInitialized = true;
   }
   getAvailableTools() {
     return this.mcpClient.getAvailableTools();
@@ -1905,6 +1904,13 @@ var Agent = class {
     const toolCall = decisionData.tool_calls[0];
     let toolResultContent;
     let shouldContinueConversation = true;
+    if (!this.sessionFile) {
+      const [sessionFile, history] = await loadOrcreateSession(this.sessionId);
+      this.sessionFile = sessionFile;
+      if (this.history.length === 0 && history.length > 0) {
+        this.history = history;
+      }
+    }
     if (decisionData.type === "user_decision_execute") {
       const toolName = toolCall.function.name;
       const toolArgs = JSON.parse(toolCall.function.arguments);
@@ -2462,17 +2468,9 @@ var AppComponent = ({ eventBus: eventBus2, sessionId: sessionId2 }) => {
               marginBottom: 1,
               paddingX: 1,
               children: [
-                " ",
-                /* @__PURE__ */ jsxs9(Text10, { color: "yellow", bold: true, children: [
-                  " ",
-                  "Protocol Violation",
-                  " "
-                ] }),
-                " ",
+                /* @__PURE__ */ jsx11(Text10, { color: "yellow", bold: true, children: "Protocol Violation" }),
                 /* @__PURE__ */ jsx11(Text10, { color: "gray", children: parsed.content }),
-                " ",
-                /* @__PURE__ */ jsx11(Text10, { color: "yellow", children: parsed.message }),
-                " "
+                /* @__PURE__ */ jsx11(Text10, { color: "yellow", children: parsed.message })
               ]
             }
           );
@@ -2498,6 +2496,14 @@ var AppComponent = ({ eventBus: eventBus2, sessionId: sessionId2 }) => {
               result: parsed.result
             }
           );
+        } else if (parsed.type === "dev_overlay") {
+          newComponent = /* @__PURE__ */ jsx11(Box11, { borderStyle: "classic", borderColor: "blue", paddingX: 1, marginBottom: 1, children: /* @__PURE__ */ jsx11(Text10, { color: "white", children: parsed.payload }) });
+        } else if (parsed.type === "log") {
+          newComponent = /* @__PURE__ */ jsxs9(Text10, { color: "gray", children: [
+            "\u2139\uFE0F ",
+            parsed.message,
+            parsed.payload ? `: ${parsed.payload}` : ""
+          ] });
         } else if (parsed.type === "assistant_message" && parsed.content) {
           newComponent = null;
         }
@@ -2510,9 +2516,14 @@ var AppComponent = ({ eventBus: eventBus2, sessionId: sessionId2 }) => {
       } catch (error) {
       }
     };
+    const handleUiOverlay = (data) => {
+      eventBus2.emit("dev_overlay", data);
+    };
+    uiEventBus.on("dev_overlay", handleUiOverlay);
     eventBus2.on("backend_message", handleBackendMessage);
     initializeAgent();
     return () => {
+      uiEventBus.off("dev_overlay", handleUiOverlay);
       eventBus2.off("backend_message", handleBackendMessage);
     };
   }, [eventBus2, sessionId2, handleConfirmation]);
@@ -2558,7 +2569,7 @@ var App = memo4(AppComponent);
 var App_default = App;
 
 // src/main.ts
-var eventBus = new EventEmitter();
+var eventBus = new EventEmitter2();
 var sessionId = uuidv42();
 var props = {
   eventBus,

package/package.json

@@ -1,55 +1,57 @@
-{
-  "name": "@nomad-e/bluma-cli",
-  "version": "0.0.10",
-  "description": "BluMa independent agent for automation and advanced software engineering.",
-  "author": "Alex Fonseca",
-  "license": "MIT",
-  "bin": {
-    "bluma": "dist/main.js"
-  },
-  "devDependencies": {
-    "@babel/preset-env": "^7.28.0",
-    "@babel/preset-react": "^7.27.1",
-    "@babel/preset-typescript": "^7.27.1",
-    "@types/diff": "^7.0.2",
-    "@types/jest": "^30.0.0",
-    "@types/node": "^20.14.2",
-    "@types/react": "^18.3.3",
-    "@types/uuid": "^9.0.8",
-    "babel-jest": "^30.0.5",
-    "esbuild": "^0.21.4",
-    "esbuild-plugin-node-externals": "^1.0.1",
-    "ink-testing-library": "^4.0.0",
-    "jest": "^30.0.5",
-    "nodemon": "^3.1.10",
-    "react": "^18.3.1",
-    "ts-node-dev": "^2.0.0",
-    "typescript": "^5.4.5"
-  },
-  "type": "module",
-  "main": "dist/main.js",
-  "scripts": {
-    "build": "node scripts/build.js",
-    "start": "node dist/main.js",
-    "prepack": "npm run build"
-  },
-  "keywords": [],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.0",
-    "diff": "^8.0.2",
-    "dotenv": "^16.4.5",
-    "ink": "^5.0.1",
-    "ink-big-text": "^2.0.0",
-    "ink-spinner": "^5.0.0",
-    "ink-text-input": "^6.0.0",
-    "openai": "^4.47.3",
-    "react-devtools-core": "^4.28.5",
-    "uuid": "^9.0.1"
-  },
-  "files": [
-    "dist/"
-  ],
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@nomad-e/bluma-cli",
+  "version": "0.0.11",
+  "description": "BluMa independent agent for automation and advanced software engineering.",
+  "author": "Alex Fonseca",
+  "license": "MIT",
+  "bin": {
+    "bluma": "dist/main.js"
+  },
+  "devDependencies": {
+    "@babel/preset-env": "^7.28.0",
+    "@babel/preset-react": "^7.27.1",
+    "@babel/preset-typescript": "^7.27.1",
+    "@types/diff": "^7.0.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.14.2",
+    "@types/react": "^18.3.3",
+    "@types/uuid": "^9.0.8",
+    "babel-jest": "^30.0.5",
+    "esbuild": "^0.21.4",
+    "esbuild-plugin-node-externals": "^1.0.1",
+    "ink-testing-library": "^4.0.0",
+    "jest": "^30.0.5",
+    "nodemon": "^3.1.10",
+    "react": "^18.3.1",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.4.5"
+  },
+  "type": "module",
+  "main": "dist/main.js",
+  "scripts": {
+    "build": "node scripts/build.js",
+    "start": "node dist/main.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepack": "npm run build"
+  },
+  "keywords": [],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.0",
+    "diff": "^8.0.2",
+    "dotenv": "^16.4.5",
+    "ink": "^5.0.1",
+    "ink-big-text": "^2.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "openai": "^4.47.3",
+    "react-devtools-core": "^4.28.5",
+    "uuid": "^9.0.1"
+  },
+  "files": [
+    "dist/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}