@must-b/must-b 1.69.0 → 1.69.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +52 -199
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,245 +1,98 @@
1
- # Must-b
1
+ # Must-b: Autonomous AI Operating System 🚀
2
2
 
3
- **Autonomous AI Operating System** — Professional AI agent that thinks, acts, and learns on your behalf.
3
+ **Must-b** is a next-generation, locally hosted autonomous AI agent ecosystem. It transitions AI from being a passive chatbot in a browser tab to an active, autonomous digital workforce operating directly on your machine.
4
4
 
5
- [![Version](https://img.shields.io/badge/version-1.28.0-orange)](https://www.npmjs.com/package/@must-b/must-b)
6
- [![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
7
- [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
5
+ 🌐 **Official Website:** [must-b.com](https://must-b.com) | 📚 **Documentation:** [must-b.com/docs](https://must-b.com/docs)
8
6
 
9
7
  ---
10
8
 
11
- ## What is Must-b?
9
+ ## 🌟 The Paradigm Shift: Why Must-b?
10
+ Must-b changes the game by acting as the **Orchestrator of your entire workflow**. You provide a high-level goal. Must-b dynamically spawns a swarm of specialized AI agents, maps out a parallel execution graph, controls your terminal, edits your local files, navigates the web via automated browsers, and enforces strict security protocols—all without human intervention.
12
11
 
13
- Must-b is an autonomous AI agent platform that runs locally on your machine. It connects to 20+ LLM providers (OpenRouter, Anthropic, OpenAI, Gemini, Ollama, and more), executes multi-step plans, controls your browser, reads and writes files, and learns from every interaction through its long-term memory system.
14
-
15
- Key capabilities:
16
-
17
- - **Autonomous agent pipeline** — goal → plan → execute, fully automatic
18
- - **Browser control** — Playwright-powered web automation with live screenshot feed
19
- - **Multi-channel messaging** — WhatsApp Cloud API, Discord, Telegram, Slack, iMessage
20
- - **Long-term memory** — vector store with semantic search and 30-day temporal decay
21
- - **Skill library** — save, reuse, and share AI workflows
22
- - **Project Intelligence** — automatic codebase indexing and smart suggestions
23
- - **Night Shift** — autonomous background task execution while you sleep
24
- - **Ghost Guard** — real-time RAM/CPU monitoring with safe-mode protection
25
- - **8-language UI** — English, Turkish, German, French, Spanish, Portuguese, Japanese, Chinese
12
+ ## 🏗️ Core Architecture & Features
13
+ * **Multi-Agent Swarms (SwarmCoordinator):** Spawns isolated PM, Frontend, Backend, and QA agents that work in parallel and communicate natively.
14
+ * **DAG Workflow Engine:** Executes complex plans with parallel branching, rollback capabilities, and fault tolerance.
15
+ * **The Shield Protocol (Hookify):** Write natural language rules (e.g., 'never delete databases') that instantly convert to runtime execution blocks.
16
+ * **200+ Native & Assimilated Skills:** Ships with a massive arsenal of tools for GitHub PR reviews, codebase indexing, web scraping, and terminal execution.
17
+ * **Memory & Lifecycle:** HNSW-backed vector store (LTM) with semantic search, plus Ghost Guard (RAM/CPU monitoring) and Night Owl (background execution).
18
+ * **8-Language UI:** Fluent in English, Turkish, German, French, Spanish, Portuguese, Japanese, and Chinese.
26
19
 
27
20
  ---
28
21
 
29
- ## Quick Start
22
+ ## ⚡ Installation & Quick Start
30
23
 
31
- ### Install globally (recommended)
24
+ **Requirements:**
25
+ * **Node.js** >= 20
26
+ * An API key for at least one LLM provider (OpenRouter, Anthropic, OpenAI, Gemini, Ollama).
27
+ * *Optional:* Playwright browsers for web automation (`npx playwright install chromium`).
32
28
 
29
+ **Global Installation**
30
+ Must-b is a proprietary enterprise system distributed securely via NPM.
33
31
  ```bash
34
- npm install -g @must-b/must-b
35
- must-b
36
- ```
37
-
38
- Opens the setup wizard on first run. Follow the prompts to configure your AI provider and start the dashboard.
39
-
40
- ### Run from source
41
-
42
- ```bash
43
- git clone https://github.com/auto-step/must-b.git
44
- cd must-b
45
- npm install
46
- npm run onboard # first-time setup
47
- npm start # start web dashboard on http://localhost:4309
32
+ npm install -g @must-b/must-b@latest
33
+ must-b gateway # Starts the Web Dashboard
48
34
  ```
35
+ *(Typing just `must-b` also defaults to starting the gateway. Follow the setup wizard on the first run.)*
49
36
 
50
37
  ---
51
38
 
52
- ## Requirements
53
-
54
- - **Node.js** >= 20
55
- - An API key for at least one LLM provider (OpenRouter free tier works out of the box)
56
- - Optional: [Playwright browsers](https://playwright.dev) for browser automation (`npx playwright install chromium`)
57
-
58
- ---
59
-
60
- ## Architecture
61
-
62
- ```
63
- User goal (Web UI or CLI)
64
- └─ Orchestrator — classifies: "direct" (single call) vs "agent" (full pipeline)
65
- └─ Planner — decomposes into PlanStep[] using LLM
66
- └─ Executor — dispatches tool calls sequentially
67
- ├─ FilesystemTools (read / write / search)
68
- ├─ TerminalTools (shell execution)
69
- ├─ BrowserTools (Playwright automation)
70
- ├─ VisionTools (screenshot + element detection)
71
- └─ MemoryTools (semantic search & recall)
72
- └─ Socket.io → real-time dashboard updates
73
- ```
74
-
75
- ### Backend (`src/`)
76
-
77
- | Module | Purpose |
78
- |---|---|
79
- | `src/core/orchestrator.ts` | Central agent loop — classify, plan, execute |
80
- | `src/core/provider.ts` | Unified LLM abstraction (20+ providers) |
81
- | `src/core/guard/ghost-guard.ts` | RAM/CPU monitor, lite/safe mode |
82
- | `src/core/automation/night-owl.ts` | Autonomous night-shift scheduler |
83
- | `src/core/intelligence/project-intelligence.ts` | Codebase indexer & whisper hints |
84
- | `src/memory/long-term.ts` | User profile + conversation history |
85
- | `src/core/memory/ltm.ts` | Vector store (episodic + semantic) |
86
- | `src/interface/api.ts` | Express + Socket.io server on port 4309 |
87
-
88
- ### Frontend (`public/must-b-ui/`)
39
+ ## 📡 Autonomous Channels Setup
89
40
 
90
- React 18 + TypeScript + Vite + Tailwind CSS + Radix UI.
91
-
92
- Key pages: `DashboardPage`, `SettingsPage`, `SetupPage`
93
- Key components: `WarRoomPanel`, `MemoryPanel`, `LiveSightPanel`, `ConnectorsPanel`
94
-
95
- ---
96
-
97
- ## Configuration
98
-
99
- Must-b is configured via a `.env` file (created automatically during onboarding):
100
-
101
- ```env
102
- MUSTB_NAME=Must-b
103
- LLM_PROVIDER=openrouter
104
- OPENROUTER_API_KEY=sk-or-...
105
- MUSTB_LANGUAGE=en
106
-
107
- # Optional channels
108
- WHATSAPP_PHONE_NUMBER_ID=...
109
- WHATSAPP_ACCESS_TOKEN=...
110
- WHATSAPP_VERIFY_TOKEN=your-secret-token
111
- DISCORD_BOT_TOKEN=...
112
- DISCORD_CLIENT_ID=...
113
- DISCORD_PUBLIC_KEY=...
114
- TELEGRAM_BOT_TOKEN=...
115
- ```
116
-
117
- ### Supported LLM Providers
118
-
119
- OpenRouter · OpenAI · Anthropic · Google Gemini · Groq · Mistral · XAI (Grok) · DeepSeek · Ollama (local) · Azure OpenAI · and more.
120
-
121
- ---
122
-
123
- ## Autonomous Channels
124
-
125
- When a WhatsApp or Discord message arrives, Must-b automatically:
126
- 1. Receives the message via webhook
127
- 2. Wakes the orchestrator with the message as a goal
128
- 3. Generates a response using the active LLM
129
- 4. (Discord) Sends the reply back via the interaction follow-up API
41
+ Must-b can connect to your daily communication channels. Send a message to your WhatsApp or Discord bot, and Must-b will wake up, execute the task on your computer, and reply with the results. Configuration is stored safely in your local `.env` file.
130
42
 
131
43
  ### WhatsApp Setup
132
-
133
44
  1. Create a Meta App at [developers.facebook.com](https://developers.facebook.com)
134
45
  2. Configure webhook URL: `https://your-domain.com/webhook/whatsapp`
135
- 3. Set `WHATSAPP_VERIFY_TOKEN` in `.env` to match your Meta webhook token
136
- 4. Add `WHATSAPP_PHONE_NUMBER_ID` and `WHATSAPP_ACCESS_TOKEN`
46
+ 3. Set `WHATSAPP_VERIFY_TOKEN` in `.env` to match your Meta webhook token.
47
+ 4. Add `WHATSAPP_PHONE_NUMBER_ID` and `WHATSAPP_ACCESS_TOKEN`.
137
48
 
138
49
  ### Discord Setup
139
-
140
- 1. Create a bot at [discord.com/developers](https://discord.com/developers/applications)
50
+ 1. Create a bot at [discord.com/developers/applications](https://discord.com/developers/applications)
141
51
  2. Set Interactions Endpoint URL: `https://your-domain.com/webhook/discord`
142
- 3. Add `DISCORD_BOT_TOKEN`, `DISCORD_CLIENT_ID`, `DISCORD_PUBLIC_KEY` to `.env`
52
+ 3. Add `DISCORD_BOT_TOKEN`, `DISCORD_CLIENT_ID`, and `DISCORD_PUBLIC_KEY` to your `.env` file.
143
53
 
144
54
  ---
145
55
 
146
- ## CLI Commands
56
+ ## 💻 CLI Commands
147
57
 
148
58
  ```bash
149
- must-b # Start web dashboard (default)
150
- must-b cli # Terminal chat mode
151
- must-b doctor # System health check + auto-repair
152
- must-b onboard # Re-run setup wizard
153
- must-b memory-sync # View memory statistics
59
+ must-b # Start the Web Dashboard (same as 'must-b gateway')
60
+ must-b gateway # Start the Web Dashboard
61
+ must-b cli # Enter Terminal-only Chat Mode
62
+ must-b doctor # Run System Health Check & Auto-Repair
63
+ must-b onboard # Re-run the Setup Wizard
154
64
  ```
155
65
 
156
66
  ---
157
67
 
158
- ## Development
68
+ # Must-b — Türkçe 🇹🇷
159
69
 
160
- ```bash
161
- npm run dev # Backend with live-reload (tsx watch)
162
- npm run dev:frontend # Frontend Vite HMR dev server
163
- npm run build:prod # Production build (esbuild + Vite)
164
- npm run build:bin # Standalone binaries (Win/Linux/macOS)
165
- ```
166
-
167
- ---
168
-
169
- ## License
170
-
171
- MIT © 2026 [Auto Step](https://auto-step.io)
172
-
173
- ---
174
- ---
175
-
176
- # Must-b — Türkçe
70
+ **Otonom Yapay Zeka İşletim Sistemi** — Sizin adınıza düşünen, harekete geçen ve öğrenen profesyonel bir dijital işgücü.
177
71
 
178
- **Otonom Yapay Zeka İşletim Sistemi** — Sizin adınıza düşünen, harekete geçen ve öğrenen profesyonel AI ajanı.
179
-
180
- ---
72
+ 🌐 **Resmi Web Sitesi:** [must-b.com](https://must-b.com) | 📚 **Dokümantasyon:** [must-b.com/docs](https://must-b.com/docs)
181
73
 
182
74
  ## Must-b Nedir?
75
+ Must-b, doğrudan makinenizde çalışan ve ortamınıza tam erişim sağlayan otonom bir sistemdir. Hedefi anlar, plan yapar, terminalinizi kullanır, kodlarınızı düzenler, tarayıcınızı yönetir ve projelerinizi baştan sona kendi başına tamamlar.
183
76
 
184
- Must-b, makinenizde yerel olarak çalışan otonom bir AI ajan platformudur. 20'den fazla LLM sağlayıcısına (OpenRouter, Anthropic, OpenAI, Gemini, Ollama ve daha fazlası) bağlanır, çok adımlı planlar yürütür, tarayıcınızı kontrol eder, dosyaları okuyup yazabilir ve uzun vadeli bellek sistemi aracılığıyla her etkileşimden öğrenir.
185
-
186
- Temel yetenekler:
187
-
188
- - **Otonom ajan pipeline** — hedef → plan → yürütme, tamamen otomatik
189
- - **Tarayıcı kontrolü** — Playwright destekli web otomasyonu ve canlı ekran görüntüsü akışı
190
- - **Çok kanallı mesajlaşma** — WhatsApp Cloud API, Discord, Telegram, Slack, iMessage
191
- - **Uzun vadeli bellek** — anlamsal arama ve 30 günlük zamansal bozunma ile vektör deposu
192
- - **Skill kütüphanesi** — AI iş akışlarını kaydedin, yeniden kullanın ve paylaşın
193
- - **Proje Zekası** — otomatik kod tabanı indeksleme ve akıllı öneriler
194
- - **Gece Vardiyası** — siz uyurken otonom arka plan görev yürütme
195
- - **Ghost Guard** — güvenli mod korumasıyla gerçek zamanlı RAM/CPU izleme
196
- - **8 dil desteği** — Türkçe dahil İngilizce, Almanca, Fransızca, İspanyolca, Portekizce, Japonca, Çince
197
-
198
- ---
199
-
200
- ## Hızlı Başlangıç
201
-
202
- ### Global kurulum (önerilen)
203
-
204
- ```bash
205
- npm install -g @must-b/must-b
206
- must-b
207
- ```
77
+ ## Çekirdek Güçleri
78
+ * **Çoklu Ajan Orkestrası (SwarmCoordinator):** Görevin büyüklüğüne göre kendi içinde PM, Frontend ve QA ajanları yaratır ve projeyi paralel olarak geliştirir.
79
+ * **DAG İş Akışı Motoru:** Görevleri paralel kollar halinde işler. Hata oluştuğunda sistemi çökertmez, işlemi geri alır (Rollback).
80
+ * **Yıkılmaz Güvenlik (Hookify):** Yapay zekanın tehlikeli komutlar çalıştırmasını engellemek için doğal dilde kurallar koyabilirsiniz.
81
+ * **200+ Devasa Yetenek:** GitHub yönetimi, web kazıma, kod analizi ve detaylı terminal kontrolü.
82
+ * **Uzun Süreli Hafıza:** Vektör veritabanı (LTM) ile haftalar önceki bağlamı hatırlar; Ghost Guard ile RAM/CPU izler.
83
+ * **8 Dil Desteği:** Türkçe dahil İngilizce, Almanca, Fransızca, İspanyolca, Portekizce, Japonca ve Çince tam destek.
208
84
 
209
- İlk çalıştırmada kurulum sihirbazı açılır. AI sağlayıcınızı yapılandırın ve paneli başlatın.
85
+ ## Kurulum ve Kullanım
210
86
 
211
- ### Kaynak koddan çalıştırma
87
+ **Gereksinimler:** Node.js >= 20 ve LLM API Anahtarı. (Tarayıcı otomasyonu için: `npx playwright install chromium`)
212
88
 
213
89
  ```bash
214
- git clone https://github.com/auto-step/must-b.git
215
- cd must-b
216
- npm install
217
- npm run onboard # ilk kurulum
218
- npm start # http://localhost:4309 adresinde web panelini başlatır
90
+ npm install -g @must-b/must-b@latest
91
+ must-b gateway # Web panelini başlatır
219
92
  ```
93
+ *(Sadece `must-b` yazmak da varsayılan olarak paneli başlatır.)*
220
94
 
221
- ---
222
-
223
- ## Gereksinimler
224
-
225
- - **Node.js** >= 20
226
- - En az bir LLM sağlayıcı için API anahtarı (OpenRouter ücretsiz katman kutudan çalışır)
227
- - İsteğe bağlı: Tarayıcı otomasyonu için Playwright (`npx playwright install chromium`)
95
+ **Kanal Entegrasyonları (WhatsApp & Discord):** Sisteminizi WhatsApp veya Discord'a bağlamak için gerekli olan API anahtarlarını sırasıyla Meta Developer ve Discord Developer portallarından alıp `.env` dosyanıza ekleyebilirsiniz. Detaylı bilgi için dokümantasyona göz atın.
228
96
 
229
97
  ---
230
-
231
- ## CLI Komutları
232
-
233
- ```bash
234
- must-b # Web panelini başlatır (varsayılan)
235
- must-b cli # Terminal sohbet modu
236
- must-b doctor # Sistem sağlık kontrolü + otomatik onarım
237
- must-b onboard # Kurulum sihirbazını yeniden çalıştırır
238
- must-b memory-sync # Bellek istatistiklerini görüntüler
239
- ```
240
-
241
- ---
242
-
243
- ## Lisans
244
-
245
- MIT © 2026 [Auto Step](https://auto-step.io)
98
+ **License:** MIT © 2026 Must-b Inc. All rights reserved.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@must-b/must-b",
3
- "version": "1.69.0",
4
- "description": "Must-b v1.69.0 — Rebranded external skills folder to must-b-skills for full brand integrity",
3
+ "version": "1.69.6",
4
+ "description": "Must-b v1.69.6 — Closed-source secure README, channel API setup guides restored, enterprise distribution via NPM only",
5
5
  "files": [
6
6
  "dist/",
7
7
  "bin/",