@nomad-e/bluma-cli 0.1.74 → 0.1.76

package/README.md

@@ -11,7 +11,7 @@
 
 > **Credit:** BluMa was conceived and architected by **Alex Fonseca**.
 
-**Current Version:** 0.1.60
+**Current Version:** 0.1.74
 
 ---
 
@@ -42,7 +42,7 @@ BluMa operates as a **conversational agent** in the terminal, combining:
 - **Rich UI Layer**: React/Ink 5 components for interactive prompts, live overlays, and real-time feedback
 - **Agent Layer**: LLM orchestration via FactorRouter with tool invocation and context management
 - **Runtime Layer**: Task tracking, plugin system, hooks, diagnostics, session management, and coordinator mode
-- **Tool Layer**: 40+ native tools + MCP SDK integration for external tools
+- **Tool Layer**: 45+ native tools + MCP SDK integration for external tools
 
 The agent maintains persistent conversation history, workspace snapshots, and coding memory across sessions.
 
@@ -67,7 +67,7 @@ The agent maintains persistent conversation history, workspace snapshots, and co
 - **Tool Execution Policy**: Intelligent decisions based on sandbox mode and safety
 
 ### Tools & Skills
-- **40+ Native Tools**: File operations, search, shell commands, web fetch, agent coordination, task management, MCP resources, cron scheduling, LSP queries, notebook editing
+- **45+ Native Tools**: File operations, search, shell commands, web fetch, agent coordination, task management, MCP resources, cron scheduling, LSP queries, notebook editing
 - **Coordinator Mode**: Orchestrator playbook for delegating work to background workers
 - **MCP Integration**: Model Context Protocol SDK for external tool servers
 - **Skills System**: Pluggable knowledge modules (git, PDF, Excel, etc.)
@@ -237,7 +237,7 @@ npm start
 ┌────────────────────────┼────────────────────────────────────┐
 │                    Tools Layer                              │
 │  ┌──────────────────────────────────────────────────────┐  │
-│  │              Native Tools (40+)                      │  │
+│  │              Native Tools (45+)                      │  │
 │  │  edit_tool, file_write, shell_command, grep_search,  │  │
 │  │  spawn_agent, wait_agent, list_agents,               │  │
 │  │  todo, task_boundary, task_create, task_list,        │  │
@@ -260,7 +260,7 @@ npm start
 
 ## Native Tools
 
-BluMa includes **40+ built-in tools** organized by category:
+BluMa includes **45+ built-in tools** organized by category:
 
 ### File Operations
 | Tool | Description |
@@ -341,6 +341,18 @@ BluMa includes **40+ built-in tools** organized by category:
 | `repl` | Interactive code execution (Python, Node, Bash) |
 | `task_output` | Read task output in real-time |
 
+### Specialized
+| Tool | Description |
+|------|-------------|
+| `context_collapse` | Collapse context window |
+| `dream_engine` | Auto-dream feature (coding memory consolidation) |
+| `brief` | Generate project brief |
+| `ctx_inspect` | Inspect current context |
+| `snip` | Code snippet management |
+| `coordinator_tools` | Coordinator mode utilities |
+| `create-next-app` | Scaffold Next.js project with shadcn/ui + Tailwind |
+| `deploy-app` | Deploy Next.js to Severino hosting |
+
 ### Plan Mode
 | Tool | Description |
 |------|-------------|
@@ -349,7 +361,7 @@ BluMa includes **40+ built-in tools** organized by category:
 
 ---
 
-## New Features in v0.1.60
+## Current Features
 
 ### Mailbox System (Bidirectional Communication)
 **Push-based communication** between coordinator and workers using EventEmitter:
@@ -570,6 +582,7 @@ Level 3b: scripts/*.py
 |-------|-------------|
 | `git-commit` | Conventional commits, staging, commit messages |
 | `git-pr` | Pull requests, code review preparation |
+| `git-release` | Version bumps, changelogs, git tags, GitHub releases |
 | `pdf` | PDF creation, extraction, merging, OCR |
 | `xlsx` | Spreadsheet operations, formulas, charts |
 | `skill-creator` | Author new BluMa skills |
@@ -765,11 +778,29 @@ src/
 │   │   ├── agent.ts                    # Main orchestrator
 │   │   ├── bluma/                      # Core agent logic
 │   │   │   ├── core/
-│   │   │   │   └── bluma.ts            # BluMaAgent class
-│   │   │   └── turn_start_payload.ts   # Backend turn payload
+│   │   │   │   ├── bluma.ts            # BluMaAgent class
+│   │   │   │   └── turn_start_payload.ts
+│   │   │   ├── context/
+│   │   │   │   └── auto_compact.ts     # Automatic context compaction
+│   │   │   ├── memory/
+│   │   │   │   └── session_memory.ts   # Session memory
+│   │   │   └── types/
+│   │   │       └── errors.ts           # Error type definitions
 │   │   ├── config/
-│   │   │   ├── native_tools.json       # Tool definitions (40+)
-│   │   │   └── skills/                 # Bundled skills (git-commit, git-pr, pdf, xlsx, skill-creator)
+│   │   │   ├── native_tools.json       # Tool definitions (45+)
+│   │   │   ├── skills/                 # Bundled skills
+│   │   │   │   ├── git-commit/
+│   │   │   │   ├── git-pr/
+│   │   │   │   ├── git-release/        # Version bumps, changelogs, releases
+│   │   │   │   ├── pdf/
+│   │   │   │   ├── skill-creator/
+│   │   │   │   └── xlsx/
+│   │   │   │       └── scripts/
+│   │   │   │           └── office/     # Office document handling
+│   │   │   │               ├── pack.py
+│   │   │   │               ├── unpack.py
+│   │   │   │               ├── validate.py
+│   │   │   │               └── soffice.py
 │   │   ├── core/                       # LLM, context, prompts
 │   │   │   ├── context-api/            # Context management
 │   │   │   │   ├── context_manager.ts  # Token-aware context
@@ -777,17 +808,32 @@ src/
 │   │   │   │   └── token_counter.ts    # Tiktoken integration
 │   │   │   ├── llm/                    # LLM client
 │   │   │   │   ├── llm.ts              # FactorRouter client
+│   │   │   │   ├── llm_errors.ts       # LLM error formatting
+│   │   │   │   ├── streaming_delta.ts  # Streaming delta handling
 │   │   │   │   └── tool_call_normalizer.ts
-│   │   │   └── prompt/                 # Prompt engineering
-│   │   │       ├── prompt_builder.ts   # Dynamic prompts
-│   │   │       └── workspace_snapshot.ts
+│   │   │   ├── prompt/                 # Prompt engineering
+│   │   │   │   ├── prompt_builder.ts   # Dynamic prompts
+│   │   │   │   ├── workspace_snapshot.ts
+│   │   │   │   ├── mcp_instructions.ts
+│   │   │   │   ├── model_info.ts
+│   │   │   │   ├── production_sandbox_prompt.ts
+│   │   │   │   ├── system_prompt_sections.ts
+│   │   │   │   ├── system_reminders.ts
+│   │   │   │   └── tool_guidance.ts
+│   │   │   └── context_viz.ts          # Context visualization
+│   │   ├── docs/
+│   │   │   └── TOOL_PARITY.md          # Tool parity documentation
 │   │   ├── feedback/
 │   │   │   └── feedback_system.ts      # Smart feedback system
+│   │   │   └── feedback_scoring.ts     # User feedback scoring
 │   │   ├── runtime/                    # Orchestration layer (v0.1.41+)
 │   │   │   ├── diagnostics.ts          # System snapshots
 │   │   │   ├── feature_flags.ts        # Feature gates
 │   │   │   ├── hook_registry.ts        # Event-driven hooks
 │   │   │   ├── native_tool_catalog.ts  # Tool registry
+│   │   │   ├── permission_bridge.ts    # Leader↔Worker permission system
+│   │   │   ├── permission_rules.ts     # Permission rule definitions
+│   │   │   ├── tool_permission_classifier.ts
 │   │   │   ├── plan_mode_session.ts    # Plan mode state
 │   │   │   ├── plugin_registry.ts      # Plugin system
 │   │   │   ├── plugin_runtime.ts       # Plugin execution
@@ -799,21 +845,29 @@ src/
 │   │   │   ├── tool_auto_approve.ts    # Auto-approve rules
 │   │   │   ├── tool_execution_policy.ts
 │   │   │   ├── tool_orchestration.ts   # Parallel read eligibility
-│   │   │   └── tool_permission_classifier.ts
+│   │   │   ├── mailbox_registry.ts     # Mailbox system
+│   │   │   ├── worker_context.ts       # Worker context management
+│   │   │   └── factorai_context.ts     # FactorAI app context
 │   │   ├── session_manager/
 │   │   │   └── session_manager.ts      # Session persistence
 │   │   ├── skills/
-│   │   │   └── skill_loader.ts         # Skill loading
+│   │   │   └── skill_loader.ts         # 3-source skill loading
 │   │   ├── subagents/                  # Subagent system
 │   │   │   ├── base_llm_subagent.ts
 │   │   │   ├── init/                   # Init subagent (BluMa.md)
+│   │   │   │   ├── init_subagent.ts    # Deep project analysis
+│   │   │   │   ├── init_system_prompt.ts
+│   │   │   │   └── contracts.ts
 │   │   │   ├── registry.ts
-│   │   │   ├── subagents_bluma.ts
-│   │   │   └── types.ts
+│   │   │   ├── subagents_bluma.ts      # SubAgent orchestration
+│   │   │   ├── types.ts                # SubAgent type definitions
+│   │   │   └── worker_system_prompt.ts
 │   │   ├── tools/
 │   │   │   ├── mcp/
 │   │   │   │   └── mcp_client.ts       # MCP SDK client
-│   │   │   └── natives/                # 27 native tool implementations
+│   │   │   ├── shared/
+│   │   │   │   └── token_utils.ts      # Token utilities
+│   │   │   └── natives/                # 45+ native tool implementations
 │   │   │       ├── agent_coordination.ts
 │   │   │       ├── ask_user_question.ts
 │   │   │       ├── async_command.ts
@@ -844,29 +898,35 @@ src/
 │   │   ├── types/
 │   │   │   └── index.ts
 │   │   └── utils/
+│   │       ├── blumamd.ts              # BluMa markdown utilities
 │   │       ├── coordinator_prompt.ts   # Coordinator mode playbook
+│   │       ├── logger.ts               # Logging utilities
 │   │       ├── update_check.ts
 │   │       └── user_message_images.ts
 │   └── ui/
 │       ├── App.tsx                     # Main UI component
 │       ├── Asci/
 │       │   └── AsciiArt.ts
-│       ├── components/                 # 24+ UI components
+│       ├── components/                 # 25+ UI components
 │       │   ├── AnimatedBorder.tsx
 │       │   ├── AskUserQuestionPrompt.tsx
 │       │   ├── AssistantMessageDisplay.tsx
 │       │   ├── CollapsibleResult.tsx
+│       │   ├── ConfirmationPrompt.tsx  # Permission confirmation dialog
 │       │   ├── EditToolDiffPanel.tsx   # Diff preview for edits
 │       │   ├── ErrorMessage.tsx
 │       │   ├── ExpandedPreviewBlock.tsx
 │       │   ├── InputPrompt.tsx         # User input
+│       │   ├── InteractiveMenu.tsx     # Interactive menu component
 │       │   ├── MarkdownRenderer.tsx
 │       │   ├── ProgressBar.tsx
 │       │   ├── ReasoningDisplay.tsx    # LLM reasoning
+│   │   │   ├── SessionInfoConnectingMCP.tsx
 │       │   ├── SessionStats.tsx
 │       │   ├── SimpleDiff.tsx
 │       │   ├── SlashCommands.tsx       # 30+ commands
 │       │   ├── StatusNotification.tsx
+│       │   ├── StartupUpdateGate.tsx   # Update check gate
 │       │   ├── StreamingText.tsx       # Live text output
 │       │   ├── TodoPlanDisplay.tsx     # Task visualization
 │       │   ├── ToolCallDisplay.tsx
@@ -875,17 +935,41 @@ src/
 │       │   ├── ToolResultDisplay.tsx
 │       │   ├── TypewriterText.tsx
 │       │   ├── UpdateNotice.tsx
+│       │   ├── WorkerOverlay.tsx       # Worker status overlay
+│       │   ├── WorkerStatusList.tsx    # Active workers list
+│       │   ├── WorkerTranscript.tsx    # Worker conversation transcript
+│       │   ├── WorkingTimer.tsx        # Work duration timer
 │       │   ├── streamingTextFlush.ts
 │       │   └── toolCallRenderers.tsx
 │       ├── constants/
-│       │   ├── historyLayout.ts
-│       │   ├── inputPaste.ts
-│       │   └── toolUiPreview.ts
+│       │   ├── historyLayout.ts        # History layout constants
+│       │   ├── inputPaste.ts           # Input paste constants
+│       │   └── toolUiPreview.ts        # Tool UI preview constants
+│       │   └── toolUiSymbols.ts        # Tool UI symbols
 │       ├── hooks/
-│       │   └── useAtCompletion.ts
+│       │   ├── useAtCompletion.ts      # Completion hook
+│       │   └── useWorkerProgress.ts    # Worker progress hook
+│       ├── prompts/
+│       │   └── initCommandPrompt.ts    # Init command prompt
+│       ├── slash-commands/
+│       │   ├── SlashCommands.types.ts  # Type definitions
+│       │   ├── commandHelpers.tsx      # Command helpers
+│       │   ├── constants.ts            # Slash command constants
+│       │   ├── SessionLivePanel.tsx    # Session live panel
+│       │   ├── streamingTextFlush.ts   # Streaming text flush
+│       │   └── renderers/
+│       │       ├── index.ts
+│       │       ├── configRenderers.tsx
+│       │       ├── infoRenderers.tsx
+│       │       ├── permissionRenderers.tsx
+│       │       ├── pluginRenderers.tsx
+│       │       ├── sessionRenderers.tsx
+│       │       ├── staticRenderers.tsx
+│       │       └── taskRenderers.tsx
 │       ├── theme/
 │       │   ├── blumaTerminal.ts
-│       │   └── m3Layout.tsx
+│       │   ├── themes.ts               # Theme definitions
+│       │   └── m3Layout.tsx            # Material Design 3 layout
 │       └── utils/
 │           ├── clipboardImage.ts
 │           ├── editToolDiffUtils.ts
@@ -896,8 +980,9 @@ src/
 │           ├── pathDisplay.ts
 │           ├── shellToolNames.ts
 │           ├── slashRegistry.ts
-│           ├── terminalTitle.ts
-│           ├── toolDisplayLabels.ts
+│           ├── terminalTitle.ts        # Terminal title keeper
+│           ├── toolActionLabels.ts     # Tool action labels
+│           ├── toolDisplayLabels.ts    # Tool display labels
 │           ├── toolInvocationPairing.ts
 │           └── useSimpleInputBuffer.ts
 ├── main.ts                             # Entry point
@@ -917,7 +1002,7 @@ npm run test:watch  # Watch mode
 ### Test Structure
 
 ```
-tests/                    # 33 test files (flat structure)
+tests/                    # 35+ test files (flat structure)
 ├── agent_*.spec.ts       # Agent routing, overlays, coordination
 ├── edit_tool.spec.ts     # File editing operations
 ├── file_write.spec.ts    # File write operations
@@ -939,6 +1024,9 @@ tests/                    # 33 test files (flat structure)
 ├── web_fetch.spec.ts     # Web fetching
 ├── workspace_snapshot.spec.ts # Workspace analysis
 ├── ui_*.spec.ts(x)       # UI component tests
+├── llm_stream_partial.spec.ts # LLM streaming partial handling
+├── llm_errors.spec.ts    # LLM error handling
+├── jest-resolver.cjs     # Jest resolver configuration
 └── ...                   # Additional integration and unit tests
 ```
 

package/dist/config/native_tools.json

@@ -636,13 +636,13 @@
       "type": "function",
       "function": {
         "name": "search_web",
-        "description": "Search for programming solutions across developer-focused sources: Reddit (programming subreddits), GitHub (issues/discussions), StackOverflow, and X (link only). Use this to find solutions, best practices, and community discussions about errors or implementation approaches.",
+        "description": "Search for programming solutions across developer-focused sources: Reddit (programming subreddits), GitHub (issues/discussions), StackOverflow, and X (link only). Use this to find solutions, best practices, and community discussions about errors or implementation approaches. NEW: Supports domain filtering and rate limiting.",
         "parameters": {
           "type": "object",
           "properties": {
             "query": {
               "type": "string",
-              "description": "Search query, e.g. 'typescript cannot find module', 'react useEffect infinite loop fix'"
+              "description": "Search query, e.g. 'typescript cannot find module', 'react useEffect infinite loop fix'. Must be 2-500 characters."
             },
             "sources": {
               "type": "array",
@@ -664,8 +664,31 @@
             },
             "max_results": {
               "type": "integer",
-              "description": "Maximum total results to return. Default is 10.",
-              "default": 10
+              "description": "Maximum total results to return. Default is 10, max is 50.",
+              "default": 10,
+              "maximum": 50,
+              "minimum": 1
+            },
+            "allowed_domains": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Only include search results from these domains (e.g., ['github.com', 'reddit.com']). Cannot be used with blocked_domains."
+            },
+            "blocked_domains": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Never include search results from these domains (e.g., ['spam-site.com']). Cannot be used with allowed_domains."
+            },
+            "max_uses": {
+              "type": "integer",
+              "description": "Maximum number of sources to search (rate limiting). Default is 8, max is 20.",
+              "default": 8,
+              "maximum": 20,
+              "minimum": 1
             }
           },
           "required": [