@nomad-e/bluma-cli 0.6.1 → 0.6.3

package/README.md

@@ -13,6 +13,8 @@
 
 **BluMa** is an independent AI agent CLI for automation and advanced software engineering. It combines powerful tool orchestration, multi-agent coordination, and intelligent context management to help you build software faster and with higher quality.
 
+**Latest Version:** v0.6.2 (2026-05-09) — Modular tool architecture, native clipboard, thread management, bidirectional mailbox IPC, enhanced multi-agent orchestration, and professional release engineering.
+
 ---
 
 ## 🚀 Quick Start
@@ -75,18 +77,104 @@ Tools are now modularly structured in `src/app/agent/tools/` with separate UI co
 ### 🧠 **Multi-Agent Orchestration**
 - **Coordinator Mode**: Product Owner + Engineering Manager hybrid that delegates to specialist workers
 - **Parallel Execution**: Launch multiple workers concurrently for research, implementation, and verification
-- **Mailbox IPC**: Bidirectional communication between coordinator and workers via `send_message`, `list_mailbox_messages`, `poll_mailbox`, `signal_mailbox`
+- **Mailbox IPC**: **Bidirectional file-based communication** between coordinator and workers
+  - **send_message**: Send follow-ups to running workers without re-spawning
+  - **list_mailbox_messages**: Read progress updates, permission requests, and results
+  - **poll_mailbox**: Poll for new messages from workers
+  - **signal_mailbox**: Send ack/nack/progress/heartbeat signals
+  - **File-based storage**: `~/.bluma/mailboxes/{session_id}.in/out/sig` (JSONL format)
 - **Worker Types**: Researchers, implementers, verifiers with specialized roles
 - **Session Registry**: Track and manage agent sessions with lifecycle events
+- **Task Boundary Tracking**: Use `task_boundary` to track orchestration phases (PLANNING, EXECUTION, VERIFICATION)
 
 ### 📝 **Slash Commands** (80+ commands)
 Quick access to common operations across 5 categories:
 
-- **Session** (25+): `/clear`, `/sessions`, `/attach`, `/follow`, `/bridge`, `/status`, `/logs`, `/resume`, `/kill`, `/compact`, `/export`, `/summarize`, `/history`, `/share`, `/copy`, `/commit`, `/pr`, `/release`, `/snip`, `/collapse`, `/brief`, `/undo`, `/redo`, `/thread` (with subcommands: list/new/resume/fork/rename/archive/delete)
-- **Inspect** (30+): `/plugins`, `/plugin`, `/diagnostics`, `/permissions`, `/features`, `/hooks`, `/model`, `/effort`, `/style`, `/sandbox`, `/worktree`, `/statusline`, `/skills`, `/tools`, `/mcp`, `/debug-workers`, `/cost`, `/memory`, `/stats`, `/theme`, `/keybindings`, `/vim`, `/ctx`, `/dream`, `/diff`, `/editor`, `/config`, `/file`, `/search`, `/context`, `/token`, `/settings`, `/alias`, `/macro`, `/thread stats`
-- **Agent** (15+): `/agent`, `/agents`, `/img`, `/image`, `/init`, `/review`, `/explain`, `/fix`, `/debug`, `/bug`, `/test`, `/optimize`, `/refactor`, `/document`, `/chat`, `/code`, `/terminal`, `/template`
-- **Help**: `/help`
-- **Input**: `Ctrl+V`/`Cmd+V` (paste image/text/file), `Ctrl+Shift+I` (same as Ctrl+V)
+**Session Commands** (25+):
+- `/clear` - Clear current session
+- `/sessions` - List all sessions
+- `/attach` - Attach to existing session
+- `/follow` - Follow session output
+- `/bridge` - Bridge multiple sessions
+- `/status` - Show session status
+- `/logs` - View session logs
+- `/resume` - Resume previous session
+- `/kill` - Terminate session
+- `/compact` - Compress context
+- `/export` - Export session
+- `/summarize` - Summarize conversation
+- `/history` - Command history
+- `/share` - Share session
+- `/copy` - Copy output to clipboard
+- `/commit` - Create git commit
+- `/pr` - Create pull request
+- `/release` - Professional release engineering
+- `/snip` - Extract conversation snippets
+- `/collapse` - Collapse context
+- `/brief` - Generate brief
+- `/undo` - Undo last action
+- `/redo` - Redo undone action
+- `/thread` - Thread management (list/new/resume/fork/rename/archive/delete)
+
+**Inspect Commands** (30+):
+- `/plugins` - List plugins
+- `/plugin` - Plugin details
+- `/diagnostics` - Run diagnostics
+- `/permissions` - Show permissions
+- `/features` - List features
+- `/hooks` - Hook registry
+- `/model` - Model info
+- `/effort` - Effort estimation
+- `/style` - Code style
+- `/sandbox` - Sandbox status
+- `/worktree` - Worktree info
+- `/statusline` - Status line config
+- `/skills` - List skills
+- `/tools` - List tools
+- `/mcp` - MCP resources
+- `/debug-workers` - Worker debug
+- `/cost` - Cost tracking
+- `/memory` - Memory usage
+- `/stats` - Session stats
+- `/theme` - Theme config
+- `/keybindings` - Key bindings
+- `/vim` - Vim mode
+- `/ctx` - Context inspector
+- `/dream` - Dream engine status
+- `/diff` - Show recent changes
+- `/editor` - Open in editor
+- `/config` - Runtime config
+- `/file` - File operations
+- `/search` - Search codebase
+- `/context` - Context management
+- `/token` - Token usage
+- `/settings` - Runtime settings
+- `/alias` - Manage aliases
+- `/macro` - Execute macros
+- `/thread stats` - Thread statistics
+
+**Agent Commands** (15+):
+- `/agent` - Agent info
+- `/agents` - List agents
+- `/img` / `/image` - Image handling
+- `/init` - Initialize project
+- `/review` - Code review
+- `/explain` - Explain code
+- `/fix` - Fix errors
+- `/debug` - Debug issues
+- `/bug` - Report bug
+- `/test` - Run tests
+- `/optimize` - Optimize code
+- `/refactor` - Refactor code
+- `/document` - Generate docs
+- `/chat` - Chat mode
+- `/code` - Code mode
+- `/terminal` - Terminal placeholder
+- `/template` - Create from template
+
+**Input Methods**:
+- `Ctrl+V` / `Cmd+V` - Paste image/text/file
+- `Ctrl+Shift+I` - Same as Ctrl+V
 
 ### 🎯 **Intelligent Context Management**
 - **Auto Memory**: Persistent coding notes across sessions (`coding_memory`)
@@ -102,15 +190,29 @@ Structured problem-solving workflow with 3 phases:
 2. **EXECUTION**: Implementation
 3. **VERIFICATION**: Testing and validation
 
-### 🔧 **Skills System**
-Extendable expertise modules with progressive disclosure:
+### 🔧 **Skills System** (6 skills)
+Extendable expertise modules with **progressive disclosure** — load only when needed:
+
+**Available Skills:**
 - **git-commit**: Conventional commits automation with BluMa watermark
-- **git-pr**: Pull request creation and management
-- **git-release**: Full release engineering workflow (version bumps, changelog, tags, npm publish)
+- **git-pr**: Pull request creation and management (descriptions, reviewers, draft mode)
+- **git-release**: Full release engineering (version bumps, changelog, tags, npm publish, GitHub releases)
 - **pdf**: PDF generation and manipulation (reports, merge, forms, OCR)
 - **xlsx**: Spreadsheet processing (create, edit, formulas, charting, cleaning)
 - **skill-creator**: Create custom skills
 
+**How Skills Work:**
+1. **Discovery**: Skills loaded from `dist/config/skills/`, `{cwd}/.bluma/skills/`, `~/.bluma/skills/`
+2. **Progressive Disclosure**: 
+   - Level 1: One-line description (always visible)
+   - Level 2: Full instructions (loaded on activation)
+   - Level 3: References and scripts (loaded on demand)
+3. **Triggering**: Agent auto-detects when to load skills based on task context
+4. **Priority**: Native > Project > Global (native skills cannot be overridden)
+
+**Create Custom Skills:**
+See [docs/SKILLS.md](docs/SKILLS.md) for complete guide on authoring skills.
+
 ### 🎨 **Modern UI**
 - Built with **Ink** (React for CLI)
 - **Shimmer effects** for working states (WorkingShimmerText, Spinner with ShimmerChar/FlashingChar)
@@ -132,6 +234,17 @@ Extendable expertise modules with progressive disclosure:
 - **ES Modules**: Modern module system with bundler resolution
 - **React 19**: Latest React with concurrent features
 - **Optimized rendering**: Memoized message blocks, offscreen freeze, expandable previews
+- **Parallel tests**: Up to 8 workers for faster test execution
+- **Native modules**: Rust-based clipboard and layout engine for critical paths
+
+### 🔌 **Hooks & Plugins**
+Extensible architecture with hook registry and plugin system:
+
+- **Hook Registry**: Execute custom scripts on events (pre-commit, post-build, etc.)
+- **Plugin System**: Extend BluMa with custom plugins
+- **Event-driven**: Hooks triggered by tool execution, session events, and lifecycle hooks
+
+See [docs/BLUMA_DEVELOPER_GUIDE.md](docs/BLUMA_DEVELOPER_GUIDE.md) for plugin development.
 
 ### 🔌 **MCP Support**
 - **Model Context Protocol**: Connect to external MCP servers
@@ -143,6 +256,28 @@ Extendable expertise modules with progressive disclosure:
 - **Thread stats**: View thread metadata and statistics
 - **Codex-style interface**: Familiar thread management commands
 
+### 🦀 **Native Modules** (Rust)
+High-performance native extensions for critical operations:
+
+- **bluma-clipboard**: Cross-platform clipboard with image support
+  - Built with Rust (arboard crate)
+  - No dependencies on wl-paste/xclip
+  - Native image reading for terminal paste
+- **yoga-layout**: High-performance layout engine for Ink
+  - Facebook's Yoga layout library
+  - Optimized for terminal UI rendering
+
+### 📦 **VS Code Extension**
+Full BluMa capabilities integrated into VS Code:
+
+- **Chat Panel**: Interactive chat interface with full BluMa capabilities
+- **Session Sync**: Real-time synchronization with terminal sessions
+- **Image Support**: Paste and view images directly in VS Code
+- **File Integration**: Open and edit files from within the chat
+- **Streaming**: Real-time response streaming with markdown rendering
+
+See [vscode-extension/README.md](vscode-extension/README.md) for setup instructions.
+
 ---
 
 ## 🏗️ Architecture
@@ -207,7 +342,12 @@ This modular design enables:
 - **`src/ink/`**: Ink renderer shims and compatibility layer
 - **`src/shims/`**: Build-time shims for react-compiler-runtime and bidi-js
 - **`native/`**: Rust-based native modules (clipboard, yoga-layout)
+  - **bluma-clipboard**: Cross-platform clipboard with image support
+  - **yoga-layout**: High-performance layout engine for Ink
 - **`vscode-extension/`**: VS Code extension for chat integration
+  - Chat panel with full BluMa capabilities
+  - Real-time session sync
+  - Image and file support
 
 ---
 
@@ -352,6 +492,24 @@ bluma
 /pr "feat: add new authentication"  # Create PR with conventional commit
 ```
 
+### 5. **Web Integration**
+```bash
+# Use the embeddable React chat widget
+import { useChatWidget } from '@nomad-e/bluma-cli/chat-widget';
+
+// Embed BluMa capabilities in your web app
+const { messages, streamResponse } = useChatWidget();
+```
+
+### 6. **VS Code Integration**
+```bash
+# Install the VS Code extension
+# Access full BluMa capabilities from within VS Code
+- Chat panel with session sync
+- Image and file support
+- Real-time streaming
+```
+
 ---
 
 ## 📄 License
@@ -366,4 +524,30 @@ Apache 2.0 — see [LICENSE](LICENSE) for details.
 
 ---
 
-*BluMa CLI v0.3.1 — Built with TypeScript, React/Ink, and ES modules.*
+## 📰 Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed release notes.
+
+### What's New in v0.6.2 (2026-05-09)
+
+**Major Features:**
+- **Modular Tool Architecture**: All 45+ tools now have dedicated directories with separate logic, UI, and types
+- **Native Clipboard Support**: Rust-based clipboard implementation for cross-platform image handling
+- **Thread Management**: Full thread lifecycle with create, resume, fork, rename, archive, delete operations
+- **Enhanced Multi-Agent Orchestration**: Improved coordinator-worker communication with bidirectional mailbox IPC
+- **Chat Widget**: Embeddable React chat component for web integration
+
+**Improvements:**
+- 27 new slash commands for session management, inspection, and agent control
+- Performance optimizations in UI rendering and context management
+- Enhanced sandbox security with improved policy enforcement
+- Better error handling and user-friendly error messages
+
+**Fixes:**
+- Resolved circular dependency in tool metadata
+- Fixed worker registration for UI visibility
+- Improved session persistence on LLM errors
+
+---
+
+*BluMa CLI v0.6.2 — Built with TypeScript, React 19, Ink, and ES modules.*

package/dist/config/native_tools.json

@@ -570,13 +570,14 @@
       "type": "function",
       "function": {
         "name": "task_boundary",
-        "description": "Indicate the start of a task or make an update to the current task. Use this to organize complex work into phases (PLANNING, EXECUTION, VERIFICATION). The UI will show this as a structured task view with progress tracking.",
+        "description": "Indicate the start of a task or make an update to the current task. Use this to organize complex work into phases (PLANNING, EXECUTION, VERIFICATION). The UI will show this as a structured task view with progress tracking. **IMPORTANT: All 4 fields are required and must not be empty.**",
         "parameters": {
           "type": "object",
           "properties": {
             "task_name": {
               "type": "string",
-              "description": "Name of the task, e.g. 'Implementing Authentication'. Use the same name to update an existing task."
+              "minLength": 1,
+              "description": "Name of the task, e.g. 'Implementing Authentication'. Use the same name to update an existing task. **REQUIRED: Must not be empty.**"
             },
             "mode": {
               "type": "string",
@@ -585,15 +586,17 @@
                 "EXECUTION",
                 "VERIFICATION"
               ],
-              "description": "Current mode: PLANNING (research/design), EXECUTION (implementing), VERIFICATION (testing)."
+              "description": "Current mode: PLANNING (research/design), EXECUTION (implementing), VERIFICATION (testing). **REQUIRED.**"
             },
             "task_status": {
               "type": "string",
-              "description": "Current activity, e.g. 'Creating authentication middleware'. Describes what you are about to do."
+              "minLength": 1,
+              "description": "Current activity, e.g. 'Creating authentication middleware'. Describes what you are about to do. **REQUIRED: Must not be empty.**"
             },
             "task_summary": {
               "type": "string",
-              "description": "Summary of what has been accomplished so far. Should be concise but comprehensive."
+              "minLength": 1,
+              "description": "Summary of what has been accomplished so far. Should be concise but comprehensive. **REQUIRED: Must not be empty.**"
             }
           },
           "required": [

package/dist/main.js

@@ -396,6 +396,118 @@ var init_sandbox_policy = __esm({
   }
 });
 
+// src/app/agent/runtime/task_store.ts
+import fs12 from "fs";
+import path10 from "path";
+function getStorePath() {
+  const policy = getSandboxPolicy();
+  return path10.join(policy.workspaceRoot, ".bluma", "task_state.json");
+}
+function getDefaultState() {
+  return {
+    tasks: [],
+    nextId: 1,
+    activeTask: null,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function ensureLoaded() {
+  const storePath = getStorePath();
+  if (cache2 && cachePath === storePath) {
+    return cache2;
+  }
+  try {
+    if (fs12.existsSync(storePath)) {
+      const raw = fs12.readFileSync(storePath, "utf-8");
+      const parsed = JSON.parse(raw);
+      cache2 = {
+        tasks: Array.isArray(parsed.tasks) ? parsed.tasks : [],
+        nextId: typeof parsed.nextId === "number" ? parsed.nextId : 1,
+        activeTask: parsed.activeTask ?? null,
+        updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : (/* @__PURE__ */ new Date()).toISOString()
+      };
+      cachePath = storePath;
+      return cache2;
+    }
+  } catch {
+  }
+  cache2 = getDefaultState();
+  cachePath = storePath;
+  return cache2;
+}
+function persist(state2) {
+  const storePath = getStorePath();
+  fs12.mkdirSync(path10.dirname(storePath), { recursive: true });
+  state2.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  fs12.writeFileSync(storePath, JSON.stringify(state2, null, 2), "utf-8");
+  cache2 = state2;
+  cachePath = storePath;
+}
+function updateTaskStore(mutator) {
+  const current = ensureLoaded();
+  const clone = {
+    tasks: current.tasks.map((task) => ({ ...task })),
+    nextId: current.nextId,
+    activeTask: current.activeTask ? { ...current.activeTask } : null,
+    updatedAt: current.updatedAt
+  };
+  mutator(clone);
+  persist(clone);
+  return clone;
+}
+function calculateTaskStats(tasks) {
+  const total = tasks.length;
+  const pending = tasks.filter((t) => t.status === "pending").length;
+  const inProgress = tasks.filter((t) => t.status === "in_progress").length;
+  const completed = tasks.filter((t) => t.status === "completed").length;
+  const progress = total > 0 ? Math.round(completed / total * 100) : 0;
+  return { total, pending, inProgress, completed, progress };
+}
+function buildTaskSnapshot() {
+  const state2 = ensureLoaded();
+  return {
+    tasks: state2.tasks.map((task) => ({ ...task })),
+    activeTask: state2.activeTask ? { ...state2.activeTask } : null,
+    stats: calculateTaskStats(state2.tasks),
+    updatedAt: state2.updatedAt
+  };
+}
+function registerWorker(worker) {
+  activeWorkers.set(worker.id, worker);
+}
+function completeWorker(workerId) {
+  const worker = activeWorkers.get(workerId);
+  if (worker) {
+    worker.status = "completed";
+    worker.endTime = Date.now();
+    worker.progress = {
+      ...worker.progress,
+      completed: true,
+      statusText: "Done"
+    };
+    worker.evictAfter = Date.now() + 3e4;
+  }
+}
+function evictWorkerTask(workerId) {
+  activeWorkers.delete(workerId);
+}
+function getVisibleWorkers() {
+  const now2 = Date.now();
+  return Array.from(activeWorkers.values()).filter(
+    (w) => (w.evictAfter ?? Infinity) > now2
+  );
+}
+var cache2, cachePath, activeWorkers;
+var init_task_store = __esm({
+  "src/app/agent/runtime/task_store.ts"() {
+    "use strict";
+    init_sandbox_policy();
+    cache2 = null;
+    cachePath = null;
+    activeWorkers = /* @__PURE__ */ new Map();
+  }
+});
+
 // src/app/agent/tools/CommandStatusTool/CommandStatusTool.ts
 var CommandStatusTool_exports = {};
 __export(CommandStatusTool_exports, {
@@ -1364,12 +1476,33 @@ async function spawnAgent(args) {
   );
   child.unref();
   updateSession(sessionId, { pid: child.pid });
-  spawnLog.info("Worker spawned successfully", {
+  const workerTask = {
+    id: sessionId,
+    title,
+    description: args.task,
+    status: "running",
+    task: args.task,
+    progress: {
+      step: 1,
+      totalSteps: 10,
+      currentTask: args.task?.slice(0, 100) || "Initializing...",
+      statusText: "Running",
+      lastActivity: Date.now()
+    },
+    startTime: Date.now(),
+    endTime: void 0,
+    evictAfter: void 0,
+    agentType: args.agent_type || "general",
+    parentSessionId: parentSessionId || void 0
+  };
+  registerWorker(workerTask);
+  spawnLog.info("Worker spawned and registered", {
     sessionId,
     pid: child.pid,
     title,
     timeoutMs,
-    sandbox: true
+    sandbox: true,
+    workerTaskId: sessionId
   });
   return {
     success: true,
@@ -1411,6 +1544,19 @@ async function waitAgent(args) {
     }
     if (session.status !== "running") {
       waitLog.info("Agent completed", { sessionId, status: session.status });
+      if (session.status === "completed") {
+        completeWorker(sessionId);
+      } else if (session.status === "cancelled") {
+        const workerTask = {
+          id: sessionId,
+          title: session.title,
+          description: session.title,
+          status: "killed",
+          startTime: Date.now(),
+          endTime: Date.now()
+        };
+        registerWorker(workerTask);
+      }
       return {
         success: true,
         completed: true,
@@ -1501,6 +1647,7 @@ var init_AgentCoordinationTool = __esm({
   "src/app/agent/tools/AgentCoordinationTool/AgentCoordinationTool.ts"() {
     "use strict";
     init_session_registry();
+    init_task_store();
     init_logger();
     init_errors();
     init_worker_context();
@@ -15596,97 +15743,8 @@ async function countLines(args) {
   }
 }
 
-// src/app/agent/runtime/task_store.ts
-init_sandbox_policy();
-import fs12 from "fs";
-import path10 from "path";
-var cache2 = null;
-var cachePath = null;
-function getStorePath() {
-  const policy = getSandboxPolicy();
-  return path10.join(policy.workspaceRoot, ".bluma", "task_state.json");
-}
-function getDefaultState() {
-  return {
-    tasks: [],
-    nextId: 1,
-    activeTask: null,
-    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-function ensureLoaded() {
-  const storePath = getStorePath();
-  if (cache2 && cachePath === storePath) {
-    return cache2;
-  }
-  try {
-    if (fs12.existsSync(storePath)) {
-      const raw = fs12.readFileSync(storePath, "utf-8");
-      const parsed = JSON.parse(raw);
-      cache2 = {
-        tasks: Array.isArray(parsed.tasks) ? parsed.tasks : [],
-        nextId: typeof parsed.nextId === "number" ? parsed.nextId : 1,
-        activeTask: parsed.activeTask ?? null,
-        updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : (/* @__PURE__ */ new Date()).toISOString()
-      };
-      cachePath = storePath;
-      return cache2;
-    }
-  } catch {
-  }
-  cache2 = getDefaultState();
-  cachePath = storePath;
-  return cache2;
-}
-function persist(state2) {
-  const storePath = getStorePath();
-  fs12.mkdirSync(path10.dirname(storePath), { recursive: true });
-  state2.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  fs12.writeFileSync(storePath, JSON.stringify(state2, null, 2), "utf-8");
-  cache2 = state2;
-  cachePath = storePath;
-}
-function updateTaskStore(mutator) {
-  const current = ensureLoaded();
-  const clone = {
-    tasks: current.tasks.map((task) => ({ ...task })),
-    nextId: current.nextId,
-    activeTask: current.activeTask ? { ...current.activeTask } : null,
-    updatedAt: current.updatedAt
-  };
-  mutator(clone);
-  persist(clone);
-  return clone;
-}
-function calculateTaskStats(tasks) {
-  const total = tasks.length;
-  const pending = tasks.filter((t) => t.status === "pending").length;
-  const inProgress = tasks.filter((t) => t.status === "in_progress").length;
-  const completed = tasks.filter((t) => t.status === "completed").length;
-  const progress = total > 0 ? Math.round(completed / total * 100) : 0;
-  return { total, pending, inProgress, completed, progress };
-}
-function buildTaskSnapshot() {
-  const state2 = ensureLoaded();
-  return {
-    tasks: state2.tasks.map((task) => ({ ...task })),
-    activeTask: state2.activeTask ? { ...state2.activeTask } : null,
-    stats: calculateTaskStats(state2.tasks),
-    updatedAt: state2.updatedAt
-  };
-}
-var activeWorkers = /* @__PURE__ */ new Map();
-function evictWorkerTask(workerId) {
-  activeWorkers.delete(workerId);
-}
-function getVisibleWorkers() {
-  const now2 = Date.now();
-  return Array.from(activeWorkers.values()).filter(
-    (w) => (w.evictAfter ?? Infinity) > now2
-  );
-}
-
 // src/app/agent/tools/TodoTool/TodoTool.ts
+init_task_store();
 function validateDescription(desc) {
   if (!desc || typeof desc !== "string") return "Description is required";
   if (desc.trim().length === 0) return "Description cannot be empty";
@@ -16527,6 +16585,7 @@ init_CommandStatusTool();
 
 // src/app/agent/tools/TaskBoundaryTool/TaskBoundaryTool.ts
 init_sandbox_policy();
+init_task_store();
 import path14 from "path";
 import { promises as fs13 } from "fs";
 var artifactsDir = null;
@@ -16558,31 +16617,26 @@ async function updateTaskFile(task) {
 async function taskBoundary(args) {
   try {
     const { task_name, mode, task_status, task_summary } = args;
+    const missingFields = [];
     if (!task_name || typeof task_name !== "string") {
-      return {
-        success: false,
-        task_name: "",
-        mode: "EXECUTION",
-        status: "",
-        message: "task_name is required"
-      };
+      missingFields.push("task_name");
     }
-    if (!["PLANNING", "EXECUTION", "VERIFICATION"].includes(mode)) {
-      return {
-        success: false,
-        task_name,
-        mode: "EXECUTION",
-        status: "",
-        message: `Invalid mode: ${mode}. Must be PLANNING, EXECUTION, or VERIFICATION`
-      };
+    if (!mode || !["PLANNING", "EXECUTION", "VERIFICATION"].includes(mode)) {
+      missingFields.push("mode");
     }
     if (!task_status || typeof task_status !== "string") {
+      missingFields.push("task_status");
+    }
+    if (!task_summary || typeof task_summary !== "string") {
+      missingFields.push("task_summary");
+    }
+    if (missingFields.length > 0) {
       return {
         success: false,
-        task_name,
-        mode,
-        status: "",
-        message: "task_status is required"
+        task_name: task_name || "",
+        mode: mode || "EXECUTION",
+        status: task_status || "",
+        message: `Missing required fields: ${missingFields.join(", ")}. All 4 fields are required: task_name, mode, task_status, task_summary`
       };
     }
     const now2 = Date.now();
@@ -23483,53 +23537,6 @@ function disableCoordinatorMode() {
   delete process.env.BLUMA_COORDINATOR_MODE;
 }
 
-// src/app/agent/core/prompt/tool_guidance.ts
-var TOOL_GUIDANCE_RULES = [
-  {
-    toolName: "read_file_lines",
-    guidance: "To read files use `read_file_lines` instead of cat, head, tail, or sed"
-  },
-  {
-    toolName: "edit_tool",
-    guidance: "To edit files use `edit_tool` instead of sed or awk"
-  },
-  {
-    toolName: "file_write",
-    guidance: "To create files use `file_write` instead of cat with heredoc or echo redirection"
-  },
-  {
-    toolName: "grep_search",
-    guidance: "To search file content use `grep_search` instead of grep or rg"
-  },
-  {
-    toolName: "find_by_name",
-    guidance: "To search for files use `find_by_name` instead of find or ls"
-  },
-  {
-    toolName: "view_file_outline",
-    guidance: "To understand file structure use `view_file_outline` instead of opening the whole file"
-  }
-];
-var ALWAYS_INCLUDED = [
-  "Reserve using `shell_command` exclusively for system commands and terminal operations that require shell execution. If you are unsure and there is a relevant dedicated tool, default to using the dedicated tool.",
-  "You can call multiple tools in a single response. If you intend to call multiple tools and there are no dependencies between them, make all independent tool calls in parallel. Maximize use of parallel tool calls where possible to increase efficiency.",
-  "Do NOT use `shell_command` to run commands when a relevant dedicated tool is provided. Using dedicated tools allows the user to better understand and review your work."
-];
-function buildToolGuidanceSection(availableTools) {
-  const toolSet = new Set(availableTools);
-  const activeRules = TOOL_GUIDANCE_RULES.filter((rule) => toolSet.has(rule.toolName)).map((rule) => rule.guidance);
-  if (activeRules.length === 0) {
-    return "";
-  }
-  const lines = [
-    "# Using your tools",
-    "",
-    ...activeRules.map((r) => `- ${r}`),
-    ...ALWAYS_INCLUDED.map((r) => `- ${r}`)
-  ];
-  return lines.join("\n");
-}
-
 // src/app/agent/core/prompt/model_info.ts
 var KNOWLEDGE_CUTOFFS = [
   { match: "claude-sonnet-4-6", cutoff: "August 2025" },
@@ -23752,16 +23759,6 @@ function isAutoMemoryEnabled() {
 }
 
 // src/app/agent/core/prompt/prompt_builder.ts
-var INTERNAL_TOOLS = /* @__PURE__ */ new Set([
-  "spawn_agent",
-  "wait_agent",
-  "list_agents",
-  "send_message",
-  "list_mailbox_messages",
-  "poll_mailbox",
-  "signal_mailbox",
-  "kill_agent"
-]);
 function getNodeVersion() {
   return process.version;
 }
@@ -24108,14 +24105,6 @@ ${formatFactorAiAppContextSummary(appContext)}
   if (modelInfo) prompt += `
 
 ${modelInfo}`;
-  const allToolNames = options?.availableToolNames ?? [];
-  if (allToolNames.length > 0) {
-    const visibleTools = isSandbox ? allToolNames : allToolNames.filter((n) => !INTERNAL_TOOLS.has(n));
-    const guidance = buildToolGuidanceSection(visibleTools);
-    if (guidance) prompt += `
-
-${guidance}`;
-  }
   prompt += `
 
 ${buildSystemRemindersSection()}`;
@@ -25220,6 +25209,9 @@ var ToolCallNormalizer = class {
   }
   /**
    * Valida se um tool call normalizado é válido
+   * Validação dupla:
+   * 1. JSON dos argumentos é válido
+   * 2. A ferramenta existe no catálogo de ferramentas nativas
    */
   static isValidToolCall(call) {
     if (!(call.id && call.type === "function" && call.function?.name && typeof call.function.arguments === "string")) {
@@ -25227,10 +25219,14 @@ var ToolCallNormalizer = class {
     }
     try {
       JSON.parse(call.function.arguments);
-      return true;
     } catch {
       return false;
     }
+    const toolMetadata = getNativeToolMetadata(call.function.name);
+    if (!toolMetadata) {
+      return false;
+    }
+    return true;
   }
 };
 
@@ -25277,7 +25273,7 @@ function checkFilePermissionRules(toolName, filePath, policy) {
   }
   return { allowed: false, reason: `No permission rule found for file "${filePath}".` };
 }
-function decideToolExecution(toolName, args) {
+function decideToolExecution(toolName, args, sessionId) {
   const policy = getSandboxPolicy();
   const metadata = getNativeToolMetadata(toolName);
   if (!metadata) {
@@ -25288,6 +25284,15 @@ function decideToolExecution(toolName, args) {
       reason: "Unknown tool metadata; require confirmation by default."
     };
   }
+  if (sessionId && getEffectivePermissionMode(sessionId) === "full") {
+    return {
+      toolName,
+      metadata,
+      autoApprove: true,
+      requiresConfirmation: false,
+      reason: "Full permission mode: ALL tools auto-approved. User explicitly enabled unrestricted mode."
+    };
+  }
   const ruleDecision = permissionRulesEngine.checkPermission(toolName, args);
   if (ruleDecision === "deny") {
     return {
@@ -25560,10 +25565,10 @@ var PARALLEL_SAFE_TOOL_NAMES = /* @__PURE__ */ new Set([
   "read_mcp_resource",
   "todo"
 ]);
-function toolEligibleForParallelRead(toolName) {
+function toolEligibleForParallelRead(toolName, sessionId) {
   const name = String(toolName || "").trim();
   if (!name || !PARALLEL_SAFE_TOOL_NAMES.has(name)) return false;
-  if (!decideToolExecution(name).autoApprove) return false;
+  if (!decideToolExecution(name, void 0, sessionId).autoApprove) return false;
   const meta = getNativeToolMetadata(name);
   return meta?.riskLevel === "safe";
 }
@@ -25869,7 +25874,7 @@ var BluMaAgent = class _BluMaAgent {
   }
   /** Política mostrada na UI: combina metadata base com auto-approve efectivo (incl. permission_ml). */
   buildToolPolicyForUi(toolName, toolArgs) {
-    const base = decideToolExecution(toolName);
+    const base = decideToolExecution(toolName, void 0, this.sessionId);
     const argsStr = typeof toolArgs === "string" ? toolArgs : JSON.stringify(toolArgs ?? {});
     const synthetic = { function: { name: toolName, arguments: argsStr } };
     const auto = effectiveToolAutoApprove(synthetic, this.sessionId, { logClassifier: false });
@@ -25929,10 +25934,6 @@ var BluMaAgent = class _BluMaAgent {
         role: "system",
         content: `[SYSTEM] Tool "${toolName}" is not found in the agent's available tools. Please use only tools that are listed in your tool catalog.`
       });
-      this.eventBus.emit("backend_message", {
-        type: "error",
-        message: `Tool "${toolName}" does not exist in the agent catalog.`
-      });
       this.persistSession();
       return true;
     }
@@ -26119,10 +26120,6 @@ var BluMaAgent = class _BluMaAgent {
             role: "system",
             content: `[SYSTEM] Tool "${toolName}" is not found in the agent's available tools. Please use only tools that are listed in your tool catalog.`
           });
-          this.eventBus.emit("backend_message", {
-            type: "error",
-            message: `Tool "${toolName}" does not exist in the agent catalog.`
-          });
           this.persistSession();
           return true;
         }
@@ -26271,13 +26268,13 @@ var BluMaAgent = class _BluMaAgent {
     let i = 0;
     while (i < calls.length && shouldContinue && !this.isInterrupted) {
       const name = calls[i].function.name;
-      if (!toolEligibleForParallelRead(name)) {
+      if (!toolEligibleForParallelRead(name, this.sessionId)) {
         shouldContinue = await this.executeApprovedToolInvocation(calls[i], decisionData);
         i += 1;
         continue;
       }
       let j = i;
-      while (j < calls.length && toolEligibleForParallelRead(calls[j].function.name)) {
+      while (j < calls.length && toolEligibleForParallelRead(calls[j].function.name, this.sessionId)) {
         j += 1;
       }
       const slice = calls.slice(i, j);
@@ -26565,7 +26562,7 @@ ${editData.error.display}`;
       }
       if (confirmationToolCalls.length > 0) {
         const toolToCall = confirmationToolCalls[0];
-        const decision = decideToolExecution(toolToCall.function.name);
+        const decision = decideToolExecution(toolToCall.function.name, void 0, this.sessionId);
         const toolName = toolToCall.function.name;
         let previewContent;
         if (toolName === "edit_tool") {
@@ -26640,7 +26637,7 @@ ${editData.error.display}`;
       }
       if (confirmationToolCalls.length > 0) {
         const toolToCall = confirmationToolCalls[0];
-        const decision = decideToolExecution(toolToCall.function.name);
+        const decision = decideToolExecution(toolToCall.function.name, void 0, this.sessionId);
         const toolName = toolToCall.function.name;
         let previewContent;
         if (toolName === "edit_tool") {
@@ -27588,7 +27585,7 @@ var BaseLLMSubAgent = class {
           break;
         }
         if (message2.tool_calls) {
-          const decision = decideToolExecution(message2.tool_calls[0].function.name);
+          const decision = decideToolExecution(message2.tool_calls[0].function.name, void 0, `${this.id}`);
           if (!decision.autoApprove) {
             this.emitEvent("error", {
               message: `Subagent tool "${message2.tool_calls[0].function.name}" requires confirmation outside sandbox mode.`
@@ -27712,7 +27709,7 @@ ${editData.error.display}`;
         }
       }
       if (message2.tool_calls) {
-        const decision = decideToolExecution(message2.tool_calls[0].function.name);
+        const decision = decideToolExecution(message2.tool_calls[0].function.name, void 0, `${this.id}`);
         if (!decision.autoApprove) {
           this.emitEvent("error", {
             message: `Subagent tool "${message2.tool_calls[0].function.name}" requires confirmation outside sandbox mode.`
@@ -27762,7 +27759,7 @@ ${editData.error.display}`;
         tool_name: toolName,
         arguments: toolArgs,
         preview: previewContent,
-        tool_policy: decideToolExecution(toolName)
+        tool_policy: decideToolExecution(toolName, void 0, `${this.id}`)
       });
       try {
         if (this.isInterrupted) {
@@ -35533,6 +35530,9 @@ function useTerminalSize() {
   return size;
 }
 
+// src/app/ui/components/CoordinatorTaskPanel.tsx
+init_task_store();
+
 // src/utils/format.ts
 function formatDuration2(ms, options) {
   if (ms < 6e4) {
@@ -36110,6 +36110,7 @@ var renderBridgePanel = () => {
 };
 
 // src/app/ui/components/slash-commands/renderers/taskRenderers.tsx
+init_task_store();
 import { Fragment as Fragment13, jsx as jsx87, jsxs as jsxs72 } from "react/jsx-runtime";
 var renderMasonSnapshot = () => {
   const snapshot = buildTaskSnapshot();
@@ -36227,6 +36228,7 @@ var runTasksClear = (agentRef) => {
 init_runtime_config();
 init_sessionPermissionState();
 init_sandbox_policy();
+init_task_store();
 import { Fragment as Fragment14, jsx as jsx88, jsxs as jsxs73 } from "react/jsx-runtime";
 var renderStatusline = () => {
   const cfg = getRuntimeConfig();
@@ -36420,10 +36422,10 @@ var runWorktreeSet = (_agentRef, _path, _setIsProcessing, _markTurnStarted) => {
 var runPermissionSet = (_agentRef, mode, _setIsProcessing, _markTurnStarted, sessionId) => {
   if (mode === "full") {
     if (sessionId) {
-      setSessionPermissionMode(sessionId, "accept_edits");
+      setSessionPermissionMode(sessionId, "full");
       return usageBox("Permission", "Set to full");
     } else {
-      setRuntimeConfig({ permissionMode: "accept_edits", sandboxEnabled: false });
+      setRuntimeConfig({ permissionMode: "full", sandboxEnabled: false });
       return usageBox("Permission", "Set to full (global)");
     }
   }
@@ -36474,6 +36476,7 @@ var renderPermissionsSnapshot = (sessionId) => {
 };
 
 // src/app/agent/runtime/diagnostics.ts
+init_task_store();
 init_runtime_config();
 init_sandbox_policy();
 init_session_registry();

package/package.json

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