@pheem49/mint 1.2.4 → 1.4.0

package/README.md

@@ -17,11 +17,18 @@
 
 ---
 
-**Mint** is a powerful AI Assistant built with **Electron**, **Node.js**, and **Google Gemini**. It bridges the gap between your Desktop and Terminal, featuring real-time screen vision, web automation, local knowledge search, and a professional CLI for developers who love the command line.
+**Mint** is a powerful AI Assistant built with **Electron**, **Node.js**, and **Google Gemini** (with extended support for Hugging Face, Anthropic, OpenAI, and Local Models). It bridges the gap between your Desktop and Terminal, featuring real-time screen vision, web automation, local knowledge search, and a professional CLI for developers who love the command line.
 
-## 🌟 Highlights
+## Highlights
 
 - **Dual-Mode AI**: Switch between a beautiful **Desktop GUI** and a professional **CLI**.
+- **Code Agent Mode**: Use `mint code "<task>"` to inspect, edit, and verify a project directly from the current terminal workspace.
+- **Chat-First Workflow**: Regular Mint chat can now auto-route coding requests into workspace Code Mode, so the main chat acts as the control surface.
+- **Advanced Multi-Agent Hub**: 
+  - **Smart Routing**: Intelligently routes coding/general tasks to the most capable configured provider (e.g., Claude, OpenAI, Gemini).
+  - **Agent Collaboration**: Enable Multi-Agent Review so that a primary AI writes the code while a secondary AI automatically reviews it in the same loop.
+  - **Resilient Fallback**: Automatically fallbacks to alternative AI providers (Gemini, Anthropic, OpenAI, Hugging Face, LM Studio, Ollama) if your active provider fails.
+- **Visible Mode State**: The CLI status bar now shows whether Mint is currently in `Chat` or `Code` mode.
 - **Interactive Slash Commands**: Manage models and settings in the terminal with `/model`, `/config`, `/clear`, etc.
 - **Smart TUI Experience**: Professional message framing, character-wrapped Thai text support, and mouse scroll wheel navigation.
 - **System Information Action**: Retrieve OS, Kernel, and Architecture details via natural language.
@@ -33,7 +40,7 @@
 
 ---
 
-## 📸 Screenshots
+## Screenshots
 
 <p align="center">
   <img src="assets/Agent_Mint.png" alt="Agent Mint UI" width="48%">
@@ -45,7 +52,7 @@
 
 ---
 
-## ⌨️ CLI Usage (Power Users)
+## CLI Usage (Power Users)
 
 Mint CLI is built for speed and efficiency. Use the **`mint`** command from anywhere.
 
@@ -53,24 +60,49 @@ Mint CLI is built for speed and efficiency. Use the **`mint`** command from anyw
   <img src="assets/CLI_Screen.png" alt="Mint CLI Preview" width="100%">
 </p>
 
-### 🚀 Professional Commands
+### Professional Commands
 - **`mint`** : Start interactive chat mode (Default).
+- **`mint code "task"`** : Run Mint as a workspace-aware coding agent in the current project folder.
 - **`mint agent`** : Run Mint as a headless background agent (Monitoring mode).
-- **`mint agent "task"`** : **[NEW]** Start agent and execute an autonomous task immediately.
+- **`mint agent "task"`** : Start agent and execute an autonomous task immediately.
 - **`mint task "task"`** : Delegate a multi-step task to an already running background agent.
 - **`mint onboard`** : Setup API Key, Model, and initialize global configuration in `~/.mint/`.
 - **`mint list`** : See full list of automation actions and plugins.
 
 ---
 
-### 🤖 Autonomous Agent (Task Delegate)
+### Autonomous Agent (Task Delegate)
 Mint isn't just a chatbot—it's an autonomous worker. Assign complex tasks that require multiple steps of reasoning.
 
+### Code Agent Mode
+Mint now includes a dedicated coding workflow as the first step toward a Claude-Code-like experience in the terminal.
+
+**What it can do now:**
+- Inspect the current workspace before editing
+- Search code across the repo
+- Read targeted file ranges
+- Run non-destructive shell commands in the project with interactive approval
+- Apply patch-based file edits with approval before changes are written
+- Reuse lightweight session memory and git/test context per project
+
+**Usage Example:**
+```bash
+mint code "fix the failing CLI command and verify it"
+```
+
+**Chat-first Example:**
+```bash
+mint
+> สำรวจโปรเจคนี้ให้หน่อย
+```
+
+Mint will classify the request, switch the status bar to `Code`, and return to `Chat` mode after the coding flow finishes.
+
 **Supported Autonomous Tools:**
-- 🌐 **Web Automation**: Full Puppeteer-based browsing, info extraction, and research.
-- 📁 **File System**: Create, Write, Delete, and Manage folders using `~/` path expansion.
-- 🔍 **Knowledge Search**: Query local files and documentation (RAG).
-- 🛡️ **Safety Mode (Bash)**: Mint proposes commands via notifications; you choose whether to run them.
+- **Web Automation**: Full Puppeteer-based browsing, info extraction, and research.
+- **File System**: Create, Write, Delete, and Manage folders using `~/` path expansion.
+- **Knowledge Search**: Query local files and documentation (RAG).
+- **Safety Mode (Bash)**: Mint proposes commands via notifications; you choose whether to run them.
 
 **Usage Examples:**
 ```bash
@@ -83,28 +115,28 @@ mint task 'Process these 5 files and move them to ~/Documents/Archive'
 
 ---
 
-### ⚡ Slash Commands (Interactive Chat)
+### Slash Commands (Interactive Chat)
 While in terminal chat, type **`/`** to access advanced tools with the new visual autocomplete system.
 > [!TIP]
 > Use **Up/Down arrow keys** to navigate the suggestion list and press **Enter** to select!
 
 - `/help` : View all commands and descriptions.
-- `/models` : List and switch between Gemini/Ollama models.
+- `/models` : List and switch between Gemini, Ollama, Hugging Face, Anthropic, OpenAI, and Local models.
 - `/config` : Check your active API keys and preferences.
 - `/clear` / `/reset` : Clean terminal or reset AI context.
 
 ---
 
-### 🕒 Proactive Monitoring
+### Proactive Monitoring
 When running in `agent` mode, Mint monitors your system in the background:
-- 🔋 **Battery Alerts**: Notifies you when power is low or charging status changes.
-- 🌐 **Network Status**: Alerts you when connection status changes.
-- 📊 **Resource Usage**: Proactive tips if system load is too high (System Metrics).
+- **Battery Alerts**: Notifies you when power is low or charging status changes.
+- **Network Status**: Alerts you when connection status changes.
+- **Resource Usage**: Proactive tips if system load is too high (System Metrics).
 
 
 ---
 
-## 🎨 Desktop GUI Features
+## Desktop GUI Features
 
 - **Floating Widget**: A persistent AI character on your desktop.
 - **Animated Aura**: The widget breathes and glows when Mint is thinking or proactive.
@@ -114,15 +146,15 @@ When running in `agent` mode, Mint monitors your system in the background:
 
 ---
 
-## 🛡️ Security & Privacy
+## Security & Privacy
 
 - **Push Protection**: Automated `.gitignore` patterns for `mint-config.json` and `.env` files.
 - **History Scrubbing**: Integrated tools to ensure API keys are never leaked to Git history.
-- **Local First**: Built-in **Ollama** support for 100% private, offline AI processing.
+- **Local First**: Built-in **Ollama** and **LM Studio (OpenAI Compatible)** support for 100% private, offline AI processing.
 
 ---
 
-## 🛠️ Getting Started
+## Getting Started
 
 ### Prerequisites
 - [Node.js](https://nodejs.org/) (LTS)
@@ -145,7 +177,7 @@ When running in `agent` mode, Mint monitors your system in the background:
 
 ---
 
-## 📂 Project Structure
+## Project Structure
 
 ```text
 Mint/
@@ -163,6 +195,6 @@ Mint/
 
 ---
 
-## 🏛️ License
+## License
 
 Distributed under the **GNU Affero General Public License v3.0**. See `LICENSE` for details.

package/index.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Mint AI</title>
+    <!-- We can add Google Fonts here -->
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=Outfit:wght@500;600;700&display=swap" rel="stylesheet">
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/ui/src/main.jsx"></script>
+  </body>
+</html>

package/main.js

@@ -13,21 +13,22 @@ const { parseCommand } = require('./src/Command_Parser/parser');
 const pluginManager = require('./src/Plugins/plugin_manager');
 const { analyzeAndSuggest } = require('./src/AI_Brain/proactive_engine');
 const { recordBehavior, getBehaviorSummary } = require('./src/AI_Brain/behavior_memory');
-const { indexFile } = require('./src/AI_Brain/knowledge_base');
+const { indexFile, indexFolder } = require('./src/AI_Brain/knowledge_base');
+
 const SystemAutomation = require('./src/System/system_automation');
 const systemEvents = require('./src/System/system_events');
 const customWorkflows = require('./src/System/custom_workflows');
+const mcpManager = require('./src/Plugins/mcp_manager');
+const granularAutomation = require('./src/System/granular_automation');
 const googleTTS = require('google-tts-api');
 
 let mainWindow;
 let settingsWindow = null;
 let screenPickerWindow = null;
 let spotlightWindow = null;
-let floatingWindow = null;
 let widgetWindow = null;
 let proactiveGlowWindow = null;
 let tray = null;
-let floatingUnreadCount = 0;
 
 // =====================
 // Proactive Loop
@@ -192,7 +193,7 @@ function createWindow() {
     });
 
     mainWindow.on('focus', () => {
-        clearFloatingUnread();
+        // clearFloatingUnread(); // Disabled
     });
 }
 
@@ -291,41 +292,7 @@ function createSpotlightWindow() {
     });
 }
 
-function createFloatingWindow() {
-    if (floatingWindow) return;
-    const display = screen.getPrimaryDisplay();
-    const { x, y, width, height } = display.workArea;
-    const size = 72;
-    const margin = 20;
-    const posX = x + width - size - margin;
-    const posY = y + height - size - margin - 40;
-
-    floatingWindow = new BrowserWindow({
-        width: size,
-        height: size,
-        x: posX,
-        y: posY,
-        frame: false,
-        transparent: true,
-        resizable: false,
-        alwaysOnTop: true,
-        skipTaskbar: true,
-        show: true,
-        webPreferences: {
-            preload: path.join(__dirname, 'src/UI/preload-floating.js'),
-            nodeIntegration: false,
-            contextIsolation: true
-        }
-    });
-
-    floatingWindow.setVisibleOnAllWorkspaces(true, { visibleOnFullScreen: true });
-    floatingWindow.setAlwaysOnTop(true, 'floating');
-    floatingWindow.loadFile('src/UI/floating.html');
-
-    floatingWindow.on('closed', () => {
-        floatingWindow = null;
-    });
-}
+// Floating window logic removed
 
 function createWidgetWindow() {
     if (widgetWindow) return;
@@ -363,28 +330,21 @@ function createWidgetWindow() {
     });
 }
 
-function updateFloatingUnread() {
-    if (floatingWindow && !floatingWindow.isDestroyed()) {
-        floatingWindow.webContents.send('floating-notify', floatingUnreadCount);
-    }
-}
-
-function clearFloatingUnread() {
-    if (floatingUnreadCount === 0) return;
-    floatingUnreadCount = 0;
-    updateFloatingUnread();
-}
+// Floating unread logic removed
 
 app.whenReady().then(() => {
     const config = readConfig();
     createWindow();
     createTray();
-    createFloatingWindow();
+    // createFloatingWindow(); // Removed
     
     // Only show AI widget if enabled in settings
     if (config.showDesktopWidget !== false) {
         createWidgetWindow();
     }
+
+    // Initialize MCP Servers
+    mcpManager.init().catch(err => console.error('[MCP] Init Error:', err));
     
     // Start monitoring system events (battery, wifi, etc.)
     systemEvents.startMonitoring();
@@ -395,7 +355,7 @@ app.whenReady().then(() => {
     systemEvents.on('low-battery', (level) => {
         if (mainWindow && !mainWindow.isDestroyed()) {
             mainWindow.webContents.send('proactive-notification', {
-                message: `⚠️ แบตเตอรี่เหลือน้อยแล้วนะคะ (${level}%) อย่าลืมเสียบสายชาร์จนะค๊า ✨`,
+                message: `⚠️ Battery is low (${level}%). Please plug in your charger. ✨`,
                 type: 'warning'
             });
         }
@@ -403,7 +363,7 @@ app.whenReady().then(() => {
 
     systemEvents.on('connection-change', (isOnline) => {
         if (mainWindow && !mainWindow.isDestroyed()) {
-            const msg = isOnline ? '✅ เชื่อมต่ออินเทอร์เน็ตได้แล้วค่ะ ✨' : '❌ การเชื่อมต่ออินเทอร์เน็ตขาดหายไปนะคะ';
+            const msg = isOnline ? '✅ Internet connection restored. ✨' : '❌ Internet connection lost.';
             mainWindow.webContents.send('proactive-notification', { message: msg, type: 'info' });
         }
     });
@@ -438,6 +398,7 @@ app.on('window-all-closed', (e) => {
 
 app.on('will-quit', () => {
     globalShortcut.unregisterAll();
+    mcpManager.shutdown();
 });
 
 // =====================
@@ -473,7 +434,7 @@ ipcMain.on('close-window', (event) => {
 });
 
 ipcMain.on('minimize-window', (event) => {
-    if (mainWindow) mainWindow.hide();
+    if (mainWindow) mainWindow.minimize();
 });
 
 ipcMain.on('quit-app', (event) => {
@@ -512,6 +473,7 @@ ipcMain.handle('get-settings', () => {
 });
 
 ipcMain.handle('save-settings', (event, config) => {
+    console.log('[Settings] Saving new config. MCP Servers count:', Object.keys(config.mcpServers || {}).length);
     const result = writeConfig(config);
     // Refresh API key if user updated it in settings
     refreshApiKeyFromConfig();
@@ -597,33 +559,7 @@ ipcMain.on('spotlight-resize', (event, width, height) => {
     }
 });
 
-// =====================
-// IPC — Floating Icon
-// =====================
-ipcMain.on('floating-click', () => {
-    if (mainWindow) {
-        mainWindow.show();
-        mainWindow.focus();
-    }
-    clearFloatingUnread();
-});
-
-ipcMain.on('ai-notify', () => {
-    floatingUnreadCount += 1;
-    updateFloatingUnread();
-});
-
-ipcMain.on('ai-notify-clear', () => {
-    clearFloatingUnread();
-});
-
-ipcMain.on('floating-drag-move', (_event, x, y) => {
-    if (!floatingWindow || floatingWindow.isDestroyed()) return;
-    const [width, height] = floatingWindow.getSize();
-    const posX = Math.round(x - width / 2);
-    const posY = Math.round(y - height / 2);
-    floatingWindow.setBounds({ x: posX, y: posY, width, height });
-});
+// Floating IPC removed
 
 ipcMain.handle('open-external', (event, url) => {
     shell.openExternal(url);
@@ -924,8 +860,11 @@ async function executeAction(action) {
             createFolder(action.target);
             break;
         case 'open_file':
-            await openFile(action.target);
-            break;
+            const fileRes = await openFile(action.target);
+            return fileRes || `Successfully opened file: ${action.target} ✅`;
+        case 'open_folder':
+            const folderRes = await openFile(action.target);
+            return folderRes || `Successfully opened folder: ${action.target} ✅`;
         case 'delete_file':
             await deleteFile(action.target);
             break;
@@ -934,6 +873,20 @@ async function executeAction(action) {
             break;
         case 'learn_file':
             return await indexFile(action.target);
+        case 'learn_folder':
+            const { indexFolder } = require('./src/AI_Brain/knowledge_base');
+            return await indexFolder(action.target);
+        case 'mcp_tool':
+            const mcpResult = await mcpManager.callTool(action.server, action.target, action.args);
+            return JSON.stringify(mcpResult.content);
+        case 'mouse_move':
+            return await granularAutomation.mouseMove(action.x, action.y);
+        case 'mouse_click':
+            return await granularAutomation.mouseClick(action.x, action.y, action.button || 1);
+        case 'type_text':
+            return await granularAutomation.typeText(action.target);
+        case 'key_tap':
+            return await granularAutomation.keyTap(action.target);
         case 'plugin':
             return await pluginManager.executePlugin(action.pluginName, action.target);
         case 'system_automation':

package/mint-cli-logic.js

@@ -26,11 +26,30 @@ async function executeAction(action) {
             case 'open_file':
                 await openFile(action.target);
                 return `Opening: ${action.target}`;
+            case 'open_folder':
+                await openFile(action.target);
+                return `Opening folder: ${action.target}`;
             case 'delete_file':
                 await deleteFile(action.target);
                 return `Deleted: ${action.target}`;
             case 'learn_file':
                 return await indexFile(action.target);
+            case 'mcp_tool':
+                const mcpManager = require('./src/Plugins/mcp_manager');
+                const mcpResult = await mcpManager.callTool(action.server, action.target, action.args);
+                return JSON.stringify(mcpResult.content);
+            case 'mouse_move':
+                const granularAutomation = require('./src/System/granular_automation');
+                return await granularAutomation.mouseMove(action.x, action.y);
+            case 'mouse_click':
+                const granularAutomationClick = require('./src/System/granular_automation');
+                return await granularAutomationClick.mouseClick(action.x, action.y, action.button || 1);
+            case 'type_text':
+                const granularAutomationType = require('./src/System/granular_automation');
+                return await granularAutomationType.typeText(action.target);
+            case 'key_tap':
+                const granularAutomationKey = require('./src/System/granular_automation');
+                return await granularAutomationKey.keyTap(action.target);
             case 'plugin':
                 return await pluginManager.executePlugin(action.pluginName, action.target);
             case 'system_automation':