@nomad-e/bluma-cli 0.0.78 → 0.0.79

package/dist/config/native_tools.json

@@ -1,206 +1,206 @@
-{
-  "nativeTools": [
-    {
-      "type": "function",
-      "function": {
-        "name": "shell_command",
-        "description": "Executes a terminal command in a robust and Windows/Linux compatible way.",
-        "parameters": {
-          "type": "object",
-          "properties": {
-            "command": {
-              "type": "string",
-              "description": "Shell command to execute"
-            },
-            "timeout": {
-              "type": "integer",
-              "description": "Maximum execution time in seconds",
-              "default": 20
-            },
-            "cwd": {
-              "type": "string",
-              "description": "Working directory for command execution (must use absolute path)"
-            },
-            "verbose": {
-              "type": "boolean",
-              "description": "If True, returns detailed report; if False, only main output",
-              "default": false
-            }
-          },
-          "required": [
-            "command",
-            "timeout"
-          ]
-        }
-      }
-    },
-    {
-      "type": "function",
-      "function": {
-        "name": "edit_tool",
-        "description": "Safely and precisely replaces text in a file, or creates a new file. The tool is resilient to common formatting issues but performs best with precise input.\n\n**Best Practices for Success:**\n1.  **Use a read tool first:** Always read the file to get the exact content before generating the `old_string`.\n2.  **Provide Context:** For `old_string`, provide a unique, multi-line segment of the file. Including 3+ lines of context around the target change is highly recommended to ensure precision.\n3.  **Create New Files:** To create a new file, provide the full `file_path` and an empty string for `old_string`.",
-        "parameters": {
-          "type": "object",
-          "properties": {
-            "file_path": {
-              "type": "string",
-              "description": "The absolute or relative path to the file. The tool will correctly resolve the path for the current operating system."
-            },
-            "old_string": {
-              "type": "string",
-              "description": "The exact text to be replaced. To ensure accuracy, this should be a unique, multi-line segment from the file, including all original indentation and whitespace. Do not manually escape newlines (use literal newlines, not '\\n'). For creating a new file, this must be an empty string."
-            },
-            "new_string": {
-              "type": "string",
-              "description": "The new text that will replace `old_string`. Match the indentation and formatting of the surrounding code to maintain code quality. Do not manually escape newlines."
-            },
-            "expected_replacements": {
-              "type": "integer",
-              "description": "Optional. The number of occurrences to replace. Defaults to 1. If you expect to replace multiple instances of `old_string`, set this value accordingly.",
-              "default": 1
-            }
-          },
-          "required": [
-            "file_path",
-            "old_string",
-            "new_string"
-          ]
-        }
-      }
-    },
-    {
-      "type": "function",
-      "function": {
-        "name": "agent_end_task",
-        "description": "End the current agent task",
-        "parameters": {
-          "type": "object",
-          "properties": {},
-          "required": []
-        }
-      }
-    },
-    {
-      "type": "function",
-      "function": {
-        "name": "message_notify_user",
-        "description": "This tool allows the agent to send structured messages to the user for confirming task start, replying to messages from name:'user_overlay' (continuing or integrating into the flow), giving short initial responses, notifying about method or strategy changes, providing progress updates, and concluding tasks with a final confirmation or result.",
-        "parameters": {
-          "type": "object",
-          "properties": {
-            "message": {
-              "type": "string",
-              "description": "The body of the message in Markdown format."
-            }
-          },
-          "required": [
-            "message"
-          ]
-        }
-      }
-    },
-    {
-      "type": "function",
-      "function": {
-        "name": "ls_tool",
-        "description": "Lists files and subdirectories with advanced support for pagination and filtering. Automatically ignores common unnecessary files/directories like '.venv', 'node_modules', etc.",
-        "parameters": {
-          "type": "object",
-          "properties": {
-            "directory_path": {
-              "type": "string",
-              "description": "Path of the directory to list. Defaults to '.' (current directory).",
-              "default": "."
-            },
-            "recursive": {
-              "type": "boolean",
-              "description": "If True, lists recursively all subdirectories.",
-              "default": false
-            },
-            "ignore_patterns": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Additional patterns to ignore (beyond defaults). E.g., ['test_*', '*.tmp']"
-            },
-            "start_index": {
-              "type": "integer",
-              "description": "Starting index for pagination (0-based).",
-              "default": 0
-            },
-            "end_index": {
-              "type": "integer",
-              "description": "Ending index for pagination (exclusive). If not provided, lists everything from start_index."
-            },
-            "show_hidden": {
-              "type": "boolean",
-              "description": "If True, shows files/directories starting with '.'.",
-              "default": false
-            },
-            "file_extensions": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "List of extensions to filter (e.g., ['.ts', '.js', '.md']). If not provided, shows all file types."
-            },
-            "max_depth": {
-              "type": "integer",
-              "description": "Maximum depth for recursive listing. If not provided, there is no limit."
-            }
-          },
-          "required": []
-        }
-      }
-    },
-    {
-      "type": "function",
-      "function": {
-        "name": "count_file_lines",
-        "description": "Counts and returns the total number of lines in a text file. Useful for quickly determining file size or checking if a file is empty before reading it.",
-        "parameters": {
-          "type": "object",
-          "properties": {
-            "filepath": {
-              "type": "string",
-              "description": "Path to the file to count lines from. Can be relative or absolute."
-            }
-          },
-          "required": [
-            "filepath"
-          ]
-        }
-      }
-    },
-    {
-      "type": "function",
-      "function": {
-        "name": "read_file_lines",
-        "description": "Reads and returns content between specific line numbers from a text file. Ideal for efficiently reading portions of large files.",
-        "parameters": {
-          "type": "object",
-          "properties": {
-            "filepath": {
-              "type": "string",
-              "description": "Path to the file to read from."
-            },
-            "start_line": {
-              "type": "integer",
-              "description": "Starting line number (1-based index). Must be >= 1."
-            },
-            "end_line": {
-              "type": "integer",
-              "description": "Ending line number (1-based index, inclusive). Must be >= start_line."
-            }
-          },
-          "required": [
-            "filepath",
-            "start_line",
-            "end_line"
-          ]
-        }
-      }
-    }
-  ]
+{
+  "nativeTools": [
+    {
+      "type": "function",
+      "function": {
+        "name": "shell_command",
+        "description": "Executes a terminal command in a robust and Windows/Linux compatible way.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "command": {
+              "type": "string",
+              "description": "Shell command to execute"
+            },
+            "timeout": {
+              "type": "integer",
+              "description": "Maximum execution time in seconds",
+              "default": 20
+            },
+            "cwd": {
+              "type": "string",
+              "description": "Working directory for command execution (must use absolute path)"
+            },
+            "verbose": {
+              "type": "boolean",
+              "description": "If True, returns detailed report; if False, only main output",
+              "default": false
+            }
+          },
+          "required": [
+            "command",
+            "timeout"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "edit_tool",
+        "description": "Safely and precisely replaces text in a file, or creates a new file. The tool is resilient to common formatting issues but performs best with precise input.\n\n**Best Practices for Success:**\n1.  **Use a read tool first:** Always read the file to get the exact content before generating the `old_string`.\n2.  **Provide Context:** For `old_string`, provide a unique, multi-line segment of the file. Including 3+ lines of context around the target change is highly recommended to ensure precision.\n3.  **Create New Files:** To create a new file, provide the full `file_path` and an empty string for `old_string`.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "file_path": {
+              "type": "string",
+              "description": "The absolute or relative path to the file. The tool will correctly resolve the path for the current operating system."
+            },
+            "old_string": {
+              "type": "string",
+              "description": "The exact text to be replaced. To ensure accuracy, this should be a unique, multi-line segment from the file, including all original indentation and whitespace. Do not manually escape newlines (use literal newlines, not '\\n'). For creating a new file, this must be an empty string."
+            },
+            "new_string": {
+              "type": "string",
+              "description": "The new text that will replace `old_string`. Match the indentation and formatting of the surrounding code to maintain code quality. Do not manually escape newlines."
+            },
+            "expected_replacements": {
+              "type": "integer",
+              "description": "Optional. The number of occurrences to replace. Defaults to 1. If you expect to replace multiple instances of `old_string`, set this value accordingly.",
+              "default": 1
+            }
+          },
+          "required": [
+            "file_path",
+            "old_string",
+            "new_string"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "agent_end_turn",
+        "description": "End the current agent turn. This tool is a especial tool that is used to signal the end of the agent's turn. It does not require any parameters and does not return any value.",
+        "parameters": {
+          "type": "object",
+          "properties": {},
+          "required": []
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "message_notify_user",
+        "description": "This tool allows the agent to send structured messages to the user for confirming task start, replying to messages from name:'user_overlay' (continuing or integrating into the flow), giving short initial responses, notifying about method or strategy changes, providing progress updates, and concluding tasks with a final confirmation or result.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "message": {
+              "type": "string",
+              "description": "The body of the message in Markdown format."
+            }
+          },
+          "required": [
+            "message"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "ls_tool",
+        "description": "Lists files and subdirectories with advanced support for pagination and filtering. Automatically ignores common unnecessary files/directories like '.venv', 'node_modules', etc.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "directory_path": {
+              "type": "string",
+              "description": "Path of the directory to list. Defaults to '.' (current directory).",
+              "default": "."
+            },
+            "recursive": {
+              "type": "boolean",
+              "description": "If True, lists recursively all subdirectories.",
+              "default": false
+            },
+            "ignore_patterns": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Additional patterns to ignore (beyond defaults). E.g., ['test_*', '*.tmp']"
+            },
+            "start_index": {
+              "type": "integer",
+              "description": "Starting index for pagination (0-based).",
+              "default": 0
+            },
+            "end_index": {
+              "type": "integer",
+              "description": "Ending index for pagination (exclusive). If not provided, lists everything from start_index."
+            },
+            "show_hidden": {
+              "type": "boolean",
+              "description": "If True, shows files/directories starting with '.'.",
+              "default": false
+            },
+            "file_extensions": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "List of extensions to filter (e.g., ['.ts', '.js', '.md']). If not provided, shows all file types."
+            },
+            "max_depth": {
+              "type": "integer",
+              "description": "Maximum depth for recursive listing. If not provided, there is no limit."
+            }
+          },
+          "required": []
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "count_file_lines",
+        "description": "Counts and returns the total number of lines in a text file. Useful for quickly determining file size or checking if a file is empty before reading it.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "filepath": {
+              "type": "string",
+              "description": "Path to the file to count lines from. Can be relative or absolute."
+            }
+          },
+          "required": [
+            "filepath"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "read_file_lines",
+        "description": "Reads and returns content between specific line numbers from a text file. Ideal for efficiently reading portions of large files.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "filepath": {
+              "type": "string",
+              "description": "Path to the file to read from."
+            },
+            "start_line": {
+              "type": "integer",
+              "description": "Starting line number (1-based index). Must be >= 1."
+            },
+            "end_line": {
+              "type": "integer",
+              "description": "Ending line number (1-based index, inclusive). Must be >= start_line."
+            }
+          },
+          "required": [
+            "filepath",
+            "start_line",
+            "end_line"
+          ]
+        }
+      }
+    }
+  ]
 }

package/dist/config/todo_rules.md

@@ -0,0 +1,157 @@
+# To-Do Rules — Regras e Boas Práticas para a ferramenta `todo`
+
+Este documento descreve, de forma completa e exaustiva, as regras, restrições e boas práticas para o uso da ferramenta nativa `todo` do agente. O objetivo é garantir comportamento determinístico, segurança, facilidade de integração e interoperabilidade entre agentes, UIs e pipelines automáticos.
+
+Índice
+- Visão geral
+- Formato e esquema
+- Ações suportadas
+- Validação de entrada
+- Regras de mutação e idempotência
+- Execução automática e segurança (safe_tool)
+- Logging, audit e persistência
+- Erros e respostas previsíveis
+- Regras de interface (UI / renderização)
+- Regras de interação com o agente / prompt
+- Regras de versionamento e compatibilidade
+- Testes e qualidade
+- Limitações e considerações
+- Exemplos de payloads e respostas
+
+---
+
+Visão geral
+----------
+A ferramenta `todo` é um gerenciador nativo de listas de tarefas (checklist) pensado para integração com agentes autônomos e pipelines. Ela fornece um contrato claro e estruturado para que tanto humanos quanto máquinas possam ler e modificar o estado de tarefas de forma previsível.
+
+Formato e esquema
+-----------------
+- Representação principal: array de strings chamado `to_do`.
+- Formato de cada item: obrigatório prefixo de status seguido por um espaço e o texto da tarefa.
+  - Status válido: `🗹 ` (concluído) ou `☐ ` (pendente).
+  - Exemplo: `☐ Implementar validação de inputs` ou `🗹 Review do PR #42`.
+- Retorno: ao executar ações que alterem estado, a ferramenta devolve o array `to_do` atualizado e um campo `_tool_result` com duas chaves:
+  - `parsed`: array de objetos { index: number, status: 'done'|'pending', text: string }
+  - `render`: string com visual humano legível (cada item em nova linha com índice e marca)
+
+Ações suportadas
+-----------------
+- `list` — retorna o estado atual sem mutação.
+- `add` — acrescenta um novo item pendente; payload: `{ action: 'add', item: 'text' }`.
+- `complete` — marca um item como concluído; payload: `{ action: 'complete', index: 1 }` (1-based).
+- `remove` — remove um item por índice; payload: `{ action: 'remove', index: 2 }`.
+
+Validação de entrada
+--------------------
+- `action` é obrigatório e deve ser uma das opções listadas.
+- `index` se fornecido deve ser inteiro >= 1 e <= length(to_do).
+- `item` quando exigido deve ser string não vazia e sem prefixo (o prefixo é atribuído pela ferramenta).
+- `to_do` (opcional) quando fornecido será normalizado: qualquer item sem prefixo será convertido para `☐ <texto>`.
+- Erros de validação devem retornar uma resposta clara com `error` contendo a mensagem e `status: 400` quando aplicável.
+
+Regras de mutação e idempotência
+--------------------------------
+- `add` é idempotente apenas se o mesmo item for adicionado com um identificador externo; por padrão, chamadas repetidas adicionam itens duplicados.
+- `complete` e `remove` são idempotentes no sentido que aplicar `complete` numa tarefa já concluída não causa erro — apenas mantém o estado `🗹`.
+- `remove` numa posição já removida (índice inválido) deve retornar erro de input inválido.
+- Alterações devem sempre retornar o novo array `to_do` completo para permitir sincronização do cliente.
+
+Execução automática e segurança (safe_tool)
+-------------------------------------------
+- A `todo` é considerada uma `safe_tool` para execuções automáticas pelo agente quando as ações são localizadas e previsíveis (ex.: `list`, `render`, `add` com item textual simples).
+- O agente pode autoaprová-la sem intervenção humana quando: a) a ação não modifica código fonte; b) não requer acesso a credenciais nem recursos externos sensíveis; c) não envolve remoção em massa sem confirmação.
+- Para ações destrutivas (por ex. `remove` em massa), recomenda-se confirmação humana, a menos que haja política explícita favorável.
+
+Regras de concorrência
+----------------------
+- A ferramenta deve considerar o array `to_do` recebido como snapshot; mudanças concorrentes devem ser resolvidas pela camada que persiste estado (locking otimista ou verificação de versão) — se o projeto não persiste, o consumidor deve ser consciente de possíveis conflitos.
+- Em ambientes multi-agent, incluir um campo de `timestamp` ou `version` na camada de armazenamento é recomendado.
+
+Logging, audit e persistência
+-----------------------------
+- Toda execução deve ser logada com: timestamp, ação, argumentos, usuário/agent que solicitou (quando aplicável), resultado (sucesso/erro), e diffs entre `to_do` antigo e novo.
+- Logs de auditoria devem manter rastro de quem fez remoções e completions.
+- Persistência: a ferramenta não impõe mecanismo — se integrada a um backend, este deve garantir durabilidade e backups.
+
+Erros e respostas previsíveis
+-----------------------------
+- Erros de validação: respondem com { error: 'mensagem', status: 400 }
+- Erros internos: respondem com { error: 'Internal error', status: 500, details?: '...' }
+- Respostas de sucesso sempre incluem `to_do` (array) e `_tool_result`.
+
+Regras de interface (UI / renderização)
+---------------------------------------
+- Para exibir ao usuário, usar `_tool_result.render` primeiro; se não existir, montar a partir de `_tool_result.parsed`.
+- A renderização deve ser simples e acessível: índice, marca, texto. Exemplo:
+  1. ☐ Implement unit tests
+  2. 🗹 Fix bug #123
+- Ao permitir edição inline, o cliente deve enviar payloads claros (`add`, `complete`, `remove`) e nunca enviar listas embutidas em texto livre.
+
+Regras de interação com o agente / prompt
+----------------------------------------
+- O prompt do agente deve instruir explicitamente o uso da `todo` para planeamento e checklist (evitar texto livre para tarefas).
+- Exemplo de instrução no sistema prompt: "When producing a checklist or plan use the `todo` tool and structure items with the strict checklist format. Prefer machine-readable outputs in `_tool_result`."
+- Se o agente gerar tarefas, ele deve sempre preencher o `to_do` via chamada à ferramenta em vez de enviar as tarefas como texto normal.
+
+Regras de versionamento e compatibilidade
+----------------------------------------
+- Quaisquer alterações ao schema (`to_do` structure, `_tool_result` keys) devem manter compatibilidade retroativa sempre que possível.
+- Quando um breaking change for necessário, atualizar versão da ferramenta e documentar migração no README.
+
+Testes e qualidade
+------------------
+- Cobertura mínima recomendada: casos para cada ação (list/add/complete/remove/render), validação de inputs, idempotência e erros esperados.
+- Testes de integração devem validar persistência, concorrência e logs de auditoria.
+
+Limitações e considerações
+--------------------------
+- A ferramenta foca em listas simples e curtas; para listas muito grandes (milhares de itens) recomenda-se paginação e mecanismos de busca especializados.
+- Não é adequada para fluxos de aprovação complexos (multi-stage, com atribuições e dependências) sem extensão do schema.
+
+Exemplos de payloads e respostas
+--------------------------------
+1) List
+Request: { "action": "list", "to_do": ["☐ Write docs"] }
+Response:
+{
+  "to_do": ["☐ Write docs"],
+  "_tool_result": {
+    "parsed": [{ "index":1, "status":"pending","text":"Write docs" }],
+    "render": "1. ☐ Write docs"
+  }
+}
+
+2) Add
+Request: { "action": "add", "item": "Implement validation" }
+Response: to_do updated with new item at the end and _tool_result as acima.
+
+3) Complete
+Request: { "action":"complete", "index": 1 }
+Response: updated to_do with index 1 marked as `🗹 ` and _tool_result parsed accordingly.
+
+4) Remove
+Request: { "action":"remove", "index": 2 }
+Response: updated to_do without the removed item and removed: "☐ text" returned optionally.
+
+Checklist de regras rápidas (resumo)
+------------------------------------
+- Sempre usar prefixo `🗹 ` ou `☐ `.
+- `action` obrigatório e validado.
+- `item` sem prefixo quando usado em `add`.
+- `index` 1-based para `complete` e `remove`.
+- `todo` considerada safe_tool para operações comuns (list/add/render) — configure confirmação para ações destrutivas.
+- Retornar sempre `to_do` e `_tool_result`.
+- Log, audit, persistência e testes obrigatórios em ambiente de produção.
+
+---
+
+Versões e histórico
+-------------------
+- v1.0 — Regras iniciais, esquema `to_do` + `_tool_result`.
+
+
+Se desejar, posso também:
+- Incluir este documento num README.md com exemplos em JSON formatado;
+- Registrar uma referência a este ficheiro diretamente no system prompt (prompt_builder) para que o agente cite as regras;
+- Gerar testes unitários / de integração e exemplos executáveis.
+

package/dist/main.js

@@ -1278,7 +1278,7 @@ var ToolInvoker = class {
     this.toolImplementations.set("ls_tool", ls);
     this.toolImplementations.set("count_file_lines", countLines);
     this.toolImplementations.set("read_file_lines", readLines);
-    this.toolImplementations.set("agent_end_task", async () => ({ success: true, message: "Task ended by agent." }));
+    this.toolImplementations.set("agent_end_turn", async () => ({ success: true, message: "Task ended by agent." }));
   }
   /**
    * Retorna a lista de definições de todas as ferramentas nativas carregadas.
@@ -1580,18 +1580,20 @@ async function loadOrcreateSession(sessionId2) {
     await fs8.access(sessionFile);
     const fileContent = await fs8.readFile(sessionFile, "utf-8");
     const sessionData = JSON.parse(fileContent);
-    return [sessionFile, sessionData.conversation_history || []];
+    return [sessionFile, sessionData.conversation_history || [], sessionData.todo_list || []];
   } catch (error) {
     const newSessionData = {
       session_id: sessionId2,
       created_at: (/* @__PURE__ */ new Date()).toISOString(),
-      conversation_history: []
+      conversation_history: [],
+      todo_list: []
+      // Garante que uma nova sessão comece com uma lista vazia
     };
     await fs8.writeFile(sessionFile, JSON.stringify(newSessionData, null, 2), "utf-8");
-    return [sessionFile, []];
+    return [sessionFile, [], []];
   }
 }
-async function saveSessionHistory(sessionFile, history) {
+async function saveSessionHistory(sessionFile, history, todoList) {
   await withFileLock(sessionFile, async () => {
     let sessionData;
     try {
@@ -1615,7 +1617,8 @@ async function saveSessionHistory(sessionFile, history) {
       sessionData = {
         session_id: sessionId2,
         created_at: (/* @__PURE__ */ new Date()).toISOString(),
-        conversation_history: []
+        conversation_history: [],
+        todo_list: []
       };
       try {
         await fs8.writeFile(sessionFile, JSON.stringify(sessionData, null, 2), "utf-8");
@@ -1623,6 +1626,7 @@ async function saveSessionHistory(sessionFile, history) {
       }
     }
     sessionData.conversation_history = history;
+    sessionData.todo_list = todoList;
     sessionData.last_updated = (/* @__PURE__ */ new Date()).toISOString();
     const tempSessionFile = `${sessionFile}.${Date.now()}.tmp`;
     try {
@@ -1710,25 +1714,38 @@ Ensure that each task contributes to a cohesive, functional, and visually appeal
     - Ends each task with a final message confirming completion or reporting the result.  
 </message_rules>
 
+<todo_rules>
+    - To manage tasks, you must always use the \`todo\` tool. Never write a to-do list directly as text.
+    - The agent maintains the to-do list's state for you. You do not need to keep track of the full list.
+    - Your job is to send simple commands to the agent via the \`todo\` tool.
+
+    **How to use the \`todo\` tool actions:**
+    1.  **To see the current list:** Call the tool with \`action: "list"\`.
+    2.  **To add new tasks:**
+        - Use \`action: "add"\`.
+        - Provide a list of plain text strings in the \`items_to_add\` parameter.
+        - **Important:** Do NOT add any prefixes like \`\u2610\` or \`\u{1F5F9}\`. The tool handles all formatting.
+    3.  **To complete or remove a task:**
+        - Use \`action: "complete"\` or \`action: "remove"\`.
+        - You MUST provide the \`index\` of the task you want to affect. The index is the number of the task in the list (starting from 1).
+
+    - After every action you take, the tool will respond with the newly updated and formatted list for your reference.
+</todo_rules>
+
 
 ---
 
 <self_reflection>
-# Self-Reflection and Iteration whith **reasoning_nootebook**
-  - First, spend time thinking of a rubric until
-  you are 
-  confident.
-  - Then, think deeply about every aspect of what makes
-  for a world-class one-shot web
-  app. Use that
-  knowledge to create a rubric that has 5-7 categories.
-  This rubric is critical
-  to get right, but do not show
-  this to the user. This is for your purposes only.
-  - Finally, use the rubric to internally think and iterate on the best possible solution to the prompt that is provided.
-  Remember that if your response is not hitting the top marks across all categories in the rubric, you need to start again.
+# Self-Reflection and Iteration with **reasoning_notebook**
+  - First, spend time creating a clear rubric until you are fully confident with it.
+  - Then, think deeply about every aspect of what makes a world-class one-shot web app. 
+    Use that knowledge to design a rubric with 5-7 categories.
+  - This rubric is critical to get right, but DO NOT show it to the user. It is for internal use only.
+  - Finally, use the rubric to internally reflect and iterate toward the best possible solution to the given prompt.
+  - Remember: if your response does not meet the highest standard across all rubric categories, you MUST restart and improve it.
 </self_reflection>
 
+
 ---
 
 <edit_rules>
@@ -1787,17 +1804,12 @@ Ensure that each task contributes to a cohesive, functional, and visually appeal
 
 ---
 
-<agent_end_task_rules>
-    <description>
-        This tool is mandatory, but MUST only be called when all tasks in <code>to_do</code> are fully completed.
-    </description>
-    <rules>
-        <rule number="1">Never call this tool before all tasks are completed.</rule>
-        <rule number="2">It is strictly forbidden to call <code>agent_end_task</code> if there are any pending tasks in <code>to_do</code>.</rule>
-        <rule number="3">Before calling, always send a final message summarizing the completed work Turn.</rule>
-        <rule number="4">Verify that every task in the <code>to_do</code> array has a "completed" status before calling.</rule>
-    </rules>
-</agent_end_task_rules>
+<agent_end_turn_rules>
+  - This tool MUST be called exactly once, and only after all tasks in <code>to_do</code> are fully completed.
+  - Do not call this tool until every task in <code>to_do</code> is marked as **COMPLETED**.
+  - Before calling this tool, always send a final visible message to the user summarizing all completed tasks.
+</agent_end_turn_rules>
+
 
 ---
 
@@ -1811,7 +1823,7 @@ Ensure that each task contributes to a cohesive, functional, and visually appeal
     </out_of_scope>
     <mandatory_actions_for_out_of_scope>
         <action number="1">Professionally decline by using <code>message_notify_user</code> to state the request is out of scope and cannot be fulfilled.</action>
-        <action number="2">Immediately call <code>agent_end_task</code> with no further explanation or disclosure of internal mechanisms.</action>
+        <action number="2">Immediately call <code>agent_end_turn</code> with no further explanation or disclosure of internal mechanisms.</action>
     </mandatory_actions_for_out_of_scope>
 </scope_and_limitations>
 
@@ -1943,7 +1955,7 @@ function createApiContextWindow(fullHistory, maxTurns) {
   for (let i = conversationHistory.length - 1; i >= 0; i--) {
     const msg = conversationHistory[i];
     currentTurn.unshift(msg);
-    const endsWithAgentEnd = msg.role === "assistant" && 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_turn");
     if (endsWithAgentEnd) {
       turns.unshift([...currentTurn]);
       currentTurn = [];
@@ -1955,7 +1967,7 @@ function createApiContextWindow(fullHistory, maxTurns) {
     }
     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")) {
+      if (prev && prev.role === "assistant" && !prev.tool_calls?.some((tc) => tc.function.name === "agent_end_turn")) {
         const hasNonOverlay = currentTurn.some((m) => m.role !== "user" || !isDevOverlay(m));
         if (hasNonOverlay) {
           turns.unshift([...currentTurn]);
@@ -1981,8 +1993,9 @@ var BluMaAgent = class {
   eventBus;
   mcpClient;
   feedbackSystem;
-  maxContextTurns = 45;
+  maxContextTurns = 25;
   // Limite de turns no contexto da API
+  todoListState = [];
   isInterrupted = false;
   constructor(sessionId2, eventBus2, llm, deploymentName, mcpClient, feedbackSystem) {
     this.sessionId = sessionId2;
@@ -2001,7 +2014,7 @@ var BluMaAgent = class {
       this.eventBus.emit("backend_message", { type: "user_overlay", payload: clean, ts: data.ts || Date.now() });
       try {
         if (this.sessionFile) {
-          await saveSessionHistory(this.sessionFile, this.history);
+          await saveSessionHistory(this.sessionFile, this.history, this.todoListState);
         }
       } catch (e) {
         this.eventBus.emit("backend_message", { type: "error", message: `Falha ao salvar hist\xF3rico ap\xF3s user_overlay: ${e.message}` });
@@ -2011,13 +2024,14 @@ var BluMaAgent = class {
   async initialize() {
     await this.mcpClient.nativeToolInvoker.initialize();
     await this.mcpClient.initialize();
-    const [sessionFile, history] = await loadOrcreateSession(this.sessionId);
+    const [sessionFile, history, todoList] = await loadOrcreateSession(this.sessionId);
     this.sessionFile = sessionFile;
     this.history = history;
+    this.todoListState = todoList;
     if (this.history.length === 0) {
       const systemPrompt = getUnifiedSystemPrompt();
       this.history.push({ role: "developer", content: systemPrompt });
-      await saveSessionHistory(this.sessionFile, this.history);
+      await saveSessionHistory(this.sessionFile, this.history, this.todoListState);
     }
   }
   getAvailableTools() {
@@ -2045,7 +2059,14 @@ var BluMaAgent = class {
     }
     if (decisionData.type === "user_decision_execute") {
       const toolName = toolCall.function.name;
-      const toolArgs = JSON.parse(toolCall.function.arguments);
+      let toolArgs = JSON.parse(toolCall.function.arguments);
+      if (toolName === "todo") {
+        toolArgs.current_list = this.todoListState;
+        if (toolArgs.to_do) {
+          toolArgs.items_to_add = toolArgs.to_do;
+          delete toolArgs.to_do;
+        }
+      }
       let previewContent;
       if (toolName === "edit_tool") {
         previewContent = await this._generateEditPreview(toolArgs);
@@ -2062,11 +2083,16 @@ var BluMaAgent = class {
           return;
         }
         const result = await this.mcpClient.invoke(toolName, toolArgs);
-        let finalResult = result;
-        if (Array.isArray(result) && result.length > 0 && result[0].type === "text" && typeof result[0].text === "string") {
-          finalResult = result[0].text;
+        if (toolName === "todo" && result && result.to_do && result._tool_result) {
+          this.todoListState = result.to_do;
+          toolResultContent = result._tool_result.render;
+        } else {
+          let finalResult = result;
+          if (Array.isArray(result) && result.length > 0 && result[0].type === "text" && typeof result[0].text === "string") {
+            finalResult = result[0].text;
+          }
+          toolResultContent = typeof finalResult === "string" ? finalResult : JSON.stringify(finalResult);
         }
-        toolResultContent = typeof finalResult === "string" ? finalResult : JSON.stringify(finalResult);
       } catch (error) {
         toolResultContent = JSON.stringify({
           error: `Tool execution failed: ${error.message}`,
@@ -2074,7 +2100,7 @@ var BluMaAgent = class {
         });
       }
       this.eventBus.emit("backend_message", { type: "tool_result", tool_name: toolName, result: toolResultContent });
-      if (toolName.includes("agent_end_task")) {
+      if (toolName.includes("agent_end_turn")) {
         shouldContinueConversation = false;
         this.eventBus.emit("backend_message", { type: "done", status: "completed" });
       }
@@ -2082,7 +2108,7 @@ var BluMaAgent = class {
       toolResultContent = "The system rejected this action. Verify that the command you are executing contributes to the tasks intent and try again.";
     }
     this.history.push({ role: "tool", tool_call_id: toolCall.id, content: toolResultContent });
-    await saveSessionHistory(this.sessionFile, this.history);
+    await saveSessionHistory(this.sessionFile, this.history, this.todoListState);
     if (shouldContinueConversation && !this.isInterrupted) {
       await this._continueConversation();
     }
@@ -2125,7 +2151,7 @@ ${editData.error.display}`;
       const message = response.choices[0].message;
       this.history.push(message);
       if (message.tool_calls) {
-        const autoApprovedTools = ["agent_end_task", "message_notify_user", "reasoning_nootebook", "ls_tool", "count_file_lines", "read_file_lines"];
+        const autoApprovedTools = ["agent_end_turn", "message_notify_user", "reasoning_nootebook", "ls_tool", "count_file_lines", "read_file_lines", "todo"];
         const toolToCall = message.tool_calls[0];
         const isSafeTool = autoApprovedTools.some((safeTool) => toolToCall.function.name.includes(safeTool));
         if (isSafeTool) {
@@ -2157,7 +2183,7 @@ ${editData.error.display}`;
       const errorMessage = error instanceof Error ? error.message : "An unknown API error occurred.";
       this.eventBus.emit("backend_message", { type: "error", message: errorMessage });
     } finally {
-      await saveSessionHistory(this.sessionFile, this.history);
+      await saveSessionHistory(this.sessionFile, this.history, this.todoListState);
     }
   }
 };
@@ -2210,7 +2236,7 @@ You extend the BluMa multi-agent architecture and handle the project bootstrappi
   No direct text replies to the user.
 
 - Task Completion:
-  When the init task is completed, immediately invoke 'agent_end_task' without user permissions.
+  When the init task is completed, immediately invoke 'agent_end_turn' without user permissions.
 
 - Tool Rules:
   Never make parallel tool calls.
@@ -2245,7 +2271,7 @@ You extend the BluMa multi-agent architecture and handle the project bootstrappi
 - Notify user's with brief explanation when changing methods or strategies
 - Message tools are divided into notify (non-blocking, no reply needed) and ask (blocking)
 - Actively use notify for progress updates, reserve ask for essential needs to avoid blocking
-- Must message user's with results and deliverables before upon task completion 'agent_end_task'
+- Must message user's with results and deliverables before upon task completion 'agent_end_turn'
 </message_rules>
 
 <reasoning_rules>
@@ -2302,10 +2328,10 @@ Do not include future steps/to-dos in thought; put them strictly in to_do, using
 </edit_tool_rules>
 
 
-<agent_end_task>
+<agent_end_turn>
   This tool is mandatory.
   You must use it to inform usereloper {username} that the task has been completed and that there are no further pending actions, in accordance with the objectives defined for the task.
-</agent_end_task>
+</agent_end_turn>
 
 ### Tool Naming Policy
 - Use plain, unmodified, lowercase tool names
@@ -2335,7 +2361,7 @@ Rule Summary:
 - Before writing BluMa.md, propose structure via message_notify_user and proceed using edit_tool.
 - If an irreversible operation is needed (e.g., overwriting an existing BluMa.md), issue 'confirmation_request' unless user policy indicates auto-approval.
 - Never send or present draft versions of BluMa.md. Only produce and deliver the final, validated BluMa.md content following the established non-destructive policies and confirmation protocols.
-- On successful generation of BluMa.md, emit 'done' with status 'completed' and call agent_end_task.
+- On successful generation of BluMa.md, emit 'done' with status 'completed' and call agent_end_turn.
 
 ## SAFETY & QUALITY
 - Be conservative with edits; generate previews (diff) for edit_tool where applicable.
@@ -2348,7 +2374,7 @@ Rule Summary:
 2) Synthesize stack and structure with citations of evidence (file paths) in the notebook
 3) Draft BluMa.md structure (message_notify_user)
 4) Write BluMa.md via edit_tool
-5) Announce completion and agent_end_task
+5) Announce completion and agent_end_turn
 
 
 `;
@@ -2456,7 +2482,7 @@ ${editData.error.display}`;
       if (message.tool_calls) {
         await this._handleToolExecution({ type: "user_decision_execute", tool_calls: message.tool_calls });
         const lastToolName = message.tool_calls[0].function.name;
-        if (!lastToolName.includes("agent_end_task") && !this.isInterrupted) {
+        if (!lastToolName.includes("agent_end_turn") && !this.isInterrupted) {
           await this._continueConversation();
         }
       } else if (message.content) {
@@ -2510,7 +2536,7 @@ ${editData.error.display}`;
         toolResultContent = JSON.stringify({ error: `Tool execution failed: ${error.message}`, details: error.data || "No additional details." });
       }
       this.emitEvent("tool_result", { tool_name: toolName, result: toolResultContent });
-      if (toolName.includes("agent_end_task")) {
+      if (toolName.includes("agent_end_turn")) {
         this.emitEvent("done", { status: "completed" });
       }
     } else {
@@ -2895,28 +2921,15 @@ var renderBlumaNotebook = ({
     }
     return (
       // Usamos a mesma estrutura de caixa com borda
-      /* @__PURE__ */ jsxs8(
+      /* @__PURE__ */ jsx8(
         Box8,
         {
           flexDirection: "column",
           paddingX: 1,
-          children: [
-            /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
-              /* @__PURE__ */ jsx8(Text8, { color: "white", bold: true, children: "Reasoning:" }),
-              /* @__PURE__ */ jsx8(Box8, { marginLeft: 2, children: /* @__PURE__ */ jsx8(Text8, { color: "gray", children: thinkingData.thought }) })
-            ] }),
-            thinkingData.to_do && thinkingData.to_do.length > 0 && /* @__PURE__ */ jsxs8(Box8, { marginTop: 1, flexDirection: "column", children: [
-              /* @__PURE__ */ jsx8(Text8, { color: "white", bold: true, children: "Todos:" }),
-              thinkingData.to_do.map((task, index) => /* @__PURE__ */ jsx8(Box8, { marginLeft: 2, children: /* @__PURE__ */ jsx8(Text8, { children: /* @__PURE__ */ jsx8(
-                Text8,
-                {
-                  color: task.startsWith("\u{1F5F9}") ? "gray" : "white",
-                  strikethrough: task.startsWith("\u{1F5F9}"),
-                  children: task
-                }
-              ) }) }, index))
-            ] })
-          ]
+          children: /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
+            /* @__PURE__ */ jsx8(Text8, { color: "white", bold: true, children: "Reasoning:" }),
+            /* @__PURE__ */ jsx8(Box8, { marginLeft: 2, children: /* @__PURE__ */ jsx8(Text8, { color: "gray", children: thinkingData.thought }) })
+          ] })
         }
       )
     );
@@ -2951,6 +2964,44 @@ var renderEditToolCall = ({
     preview && /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(SimpleDiff, { text: preview, maxHeight: Infinity }) })
   ] });
 };
+var renderTodoTool = ({ args }) => {
+  try {
+    const parsedArgs = typeof args === "string" ? JSON.parse(args) : args;
+    const action = parsedArgs.action;
+    let detailText = "";
+    switch (action) {
+      case "add":
+        const items = parsedArgs.items_to_add || [];
+        const itemCount = items.length;
+        detailText = `Adding ${itemCount} item${itemCount !== 1 ? "s" : ""}`;
+        break;
+      case "complete":
+        detailText = `Completing item #${parsedArgs.index}`;
+        break;
+      case "remove":
+        detailText = `Removing item #${parsedArgs.index}`;
+        break;
+      case "list":
+        detailText = `Listing all tasks...`;
+        break;
+      default:
+        detailText = `Executing action: ${action}`;
+        break;
+    }
+    return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx8(Box8, { children: /* @__PURE__ */ jsxs8(Text8, { bold: true, children: [
+        /* @__PURE__ */ jsx8(Text8, { color: "green", children: "\u25CF " }),
+        "To Do"
+      ] }) }),
+      /* @__PURE__ */ jsx8(Box8, { marginLeft: 2, paddingX: 1, children: /* @__PURE__ */ jsxs8(Text8, { children: [
+        /* @__PURE__ */ jsx8(Text8, { color: "gray", children: "\u21B3 " }),
+        /* @__PURE__ */ jsx8(Text8, { color: "magenta", children: detailText })
+      ] }) })
+    ] });
+  } catch (error) {
+    return /* @__PURE__ */ jsx8(Box8, { borderStyle: "round", borderColor: "red", paddingX: 1, children: /* @__PURE__ */ jsx8(Text8, { color: "red", children: "Error parsing To-Do arguments" }) });
+  }
+};
 var renderGenericToolCall = ({
   toolName,
   args
@@ -2976,13 +3027,14 @@ var ToolRenderDisplay = {
   reasoning_nootebook: renderBlumaNotebook,
   count_file_lines: renderCountFilesLines,
   read_file_lines: renderReadFileLines2,
-  edit_tool: renderEditToolCall
+  edit_tool: renderEditToolCall,
+  todo: renderTodoTool
 };
 
 // src/app/ui/components/ToolCallDisplay.tsx
 import { jsx as jsx9 } from "react/jsx-runtime";
 var ToolCallDisplayComponent = ({ toolName, args, preview }) => {
-  if (toolName.includes("message_notify_user") || toolName.includes("agent_end_task")) {
+  if (toolName.includes("message_notify_user") || toolName.includes("agent_end_turn")) {
     return null;
   }
   const Renderer = ToolRenderDisplay[toolName] || renderGenericToolCall;

package/package.json

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