npm - @pheem49/mint - Versions diffs - 1.2.4 → 1.3.0 - Mend

@pheem49/mint 1.2.4 → 1.3.0

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 (20) hide show

package/README.md +28 -0
package/index.html +16 -0
package/main.js +36 -83
package/mint-cli-logic.js +19 -0
package/mint-cli.js +117 -15
package/package.json +8 -2
package/src/AI_Brain/Gemini_API.js +175 -9
package/src/AI_Brain/knowledge_base.js +199 -125
package/src/Automation_Layer/file_operations.js +41 -19
package/src/CLI/chat_router.js +166 -0
package/src/CLI/chat_ui.js +239 -110
package/src/CLI/code_agent.js +443 -0
package/src/CLI/code_session_memory.js +62 -0
package/src/CLI/list_features.js +1 -0
package/src/Plugins/mcp_manager.js +95 -0
package/src/Plugins/plugin_manager.js +2 -2
package/src/System/config_manager.js +27 -7
package/src/System/granular_automation.js +88 -0
package/src/UI/settings.html +24 -0
package/src/UI/settings.js +98 -1

package/README.md CHANGED Viewed

@@ -22,6 +22,9 @@
 ## 🌟 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.
+- **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.
@@ -55,6 +58,7 @@ Mint CLI is built for speed and efficiency. Use the **`mint`** command from anyw
 ### 🚀 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 task "task"`** : Delegate a multi-step task to an already running background agent.
@@ -66,6 +70,30 @@ Mint CLI is built for speed and efficiency. Use the **`mint`** command from anyw
 ### 🤖 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.

package/index.html ADDED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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':

package/mint-cli.js CHANGED Viewed

@@ -7,6 +7,8 @@ const { runOnboarding } = require('./src/CLI/onboarding');
 const { startAgent } = require('./src/AI_Brain/headless_agent');
 const { displayFeatures } = require('./src/CLI/list_features');
 const { readConfig, writeConfig } = require('./src/System/config_manager');
+const { executeCodeTask } = require('./src/CLI/code_agent');
+const { detectCodeIntent, runChatRoutedTask } = require('./src/CLI/chat_router');
 const readline = require('readline');
 const { createChatUI } = require('./src/CLI/chat_ui');
@@ -93,23 +95,64 @@ program
         console.log(`${colors.gray}You will receive a notification when it's done.${colors.reset}\n`);
     });
+program
+    .command('code')
+    .description('Run Mint in workspace-aware coding mode for the current project')
+    .argument('<task>', 'Coding task to execute in the current working directory')
+    .action(async (task) => {
+        console.log(`\n${colors.mint}${colors.bright}[Mint Code]${colors.reset} Workspace: ${process.cwd()}`);
+        console.log(`${colors.gray}[Mint Code] Task: ${task}${colors.reset}\n`);
+        try {
+            const result = await executeCodeTask(task, {
+                cwd: process.cwd(),
+                onProgress: (message) => {
+                    console.log(`${colors.gray}[Mint Code] ${message}${colors.reset}`);
+                },
+                requestApproval: requestCodeApproval
+            });
+            console.log(`\n${colors.mint}${colors.bright}Summary${colors.reset}`);
+            console.log(result.summary);
+            console.log(`\n${colors.cyan}Verification:${colors.reset} ${result.verification}`);
+            console.log(`${colors.gray}Completed in ${result.steps} step(s).${colors.reset}\n`);
+        } catch (error) {
+            console.error(`\n${colors.pink}[Mint Code Error]${colors.reset} ${error.message}\n`);
+            process.exitCode = 1;
+        }
+    });
 program.parse(process.argv);
 /**
  * The Interactive Chat Loop — Gemini-style TUI
  */
 async function startInteractiveChat(initialMessage = null) {
-    const { screen, appendMessage, setThinking, updateStatusModel, copyLastResponse } = createChatUI({
+    const { screen, appendMessage, setThinking, updateStatusModel, copyLastResponse, requestApproval, setMode } = createChatUI({
         onSubmit: async (text) => {
             if (text.startsWith('/')) {
                 // Slash commands via fake rl-compatible object
                 const fakeRl = { close: () => { } };
                 appendMessage('user', text);
-                await handleSlashCommandUI(text, appendMessage, updateStatusModel, copyLastResponse);
+                await handleSlashCommandUI(text, appendMessage, updateStatusModel, copyLastResponse, setThinking, requestApproval, setMode);
                 return;
             }
             appendMessage('user', text);
+            const routeDecision = await detectCodeIntent(text, process.cwd());
+            if (routeDecision.route === 'code') {
+                appendMessage('system', `Router: entering Code Mode. ${routeDecision.reason}`);
+                await runChatRoutedTask(text, {
+                    appendMessage,
+                    setThinking,
+                    requestApproval,
+                    setMode
+                });
+                return;
+            }
+            setMode('Chat');
             // Start thinking timer
             let seconds = 0;
             setThinking(true, seconds);
@@ -149,18 +192,30 @@ async function startInteractiveChat(initialMessage = null) {
     // Handle initial message if passed via CLI arg
     if (initialMessage) {
         appendMessage('user', initialMessage);
-        let seconds = 0;
-        setThinking(true, seconds);
-        const timer = setInterval(() => { seconds++; setThinking(true, seconds); }, 1000);
-        try {
-            const response = await handleChat(initialMessage);
-            clearInterval(timer);
-            setThinking(false);
-            appendMessage('assistant', response.response, response.timestamp);
-        } catch (err) {
-            clearInterval(timer);
-            setThinking(false);
-            appendMessage('error', err.message);
+        const routeDecision = await detectCodeIntent(initialMessage, process.cwd());
+        if (routeDecision.route === 'code') {
+            appendMessage('system', `Router: entering Code Mode. ${routeDecision.reason}`);
+            await runChatRoutedTask(initialMessage, {
+                appendMessage,
+                setThinking,
+                requestApproval,
+                setMode
+            });
+        } else {
+            setMode('Chat');
+            let seconds = 0;
+            setThinking(true, seconds);
+            const timer = setInterval(() => { seconds++; setThinking(true, seconds); }, 1000);
+            try {
+                const response = await handleChat(initialMessage);
+                clearInterval(timer);
+                setThinking(false);
+                appendMessage('assistant', response.response, response.timestamp);
+            } catch (err) {
+                clearInterval(timer);
+                setThinking(false);
+                appendMessage('error', err.message);
+            }
         }
     }
 }
@@ -168,7 +223,7 @@ async function startInteractiveChat(initialMessage = null) {
 /**
  * Handles slash commands within the TUI context
  */
-async function handleSlashCommandUI(input, appendMessage, updateStatusModel, copyLastResponse) {
+async function handleSlashCommandUI(input, appendMessage, updateStatusModel, copyLastResponse, setThinking, requestApproval, setMode) {
     const parts = input.split(' ');
     const command = parts[0].toLowerCase();
     const args = parts.slice(1);
@@ -178,6 +233,7 @@ async function handleSlashCommandUI(input, appendMessage, updateStatusModel, cop
         case '/?':
             appendMessage('system', [
                 'Mint Slash Commands:',
+                '  /code <task>     — Force workspace Code Mode',
                 '  /models [name]  — List or switch Gemini models',
                 '  /config         — Show current configuration',
                 '  /copy           — Copy last response to clipboard',
@@ -215,6 +271,19 @@ async function handleSlashCommandUI(input, appendMessage, updateStatusModel, cop
             }
             break;
+        case '/code':
+            if (args.length === 0) {
+                appendMessage('system', 'Usage: /code <task>');
+                break;
+            }
+            await runChatRoutedTask(`/code ${args.join(' ')}`, {
+                appendMessage,
+                setThinking,
+                requestApproval,
+                setMode
+            });
+            break;
         case '/config':
             const currentCfg = readConfig();
             appendMessage('system', [
@@ -253,3 +322,36 @@ async function handleSlashCommandUI(input, appendMessage, updateStatusModel, cop
     }
 }
+async function requestCodeApproval(request) {
+    const typeLabel = request.type === 'shell'
+        ? 'Shell Command'
+        : request.type === 'patch'
+            ? 'Patch Edit'
+            : 'File Write';
+    console.log(`\n${colors.yellow}${colors.bright}[Approval Required]${colors.reset} ${typeLabel}`);
+    if (request.label) {
+        console.log(`${colors.gray}${request.label}${colors.reset}`);
+    }
+    if (request.preview) {
+        console.log(`${colors.gray}${request.preview}${colors.reset}\n`);
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    const answer = await new Promise((resolve) => {
+        rl.question('Approve this action? [y/N]: ', (value) => {
+            rl.close();
+            resolve((value || '').trim().toLowerCase());
+        });
+    });
+    const approved = answer === 'y' || answer === 'yes';
+    console.log(approved
+        ? `${colors.mint}[Mint Code] Approved.${colors.reset}\n`
+        : `${colors.pink}[Mint Code] Denied.${colors.reset}\n`);
+    return approved;
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@pheem49/mint",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "A powerful Electron-based AI desktop assistant powered by Google Gemini, featuring screen vision, web automation, and proactive suggestions.",
   "main": "main.js",
   "scripts": {
@@ -22,24 +22,30 @@
   "dependencies": {
     "@google/genai": "^1.44.0",
     "@inkjs/ui": "^2.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "axios": "^1.13.6",
     "blessed": "^0.1.81",
     "cheerio": "^1.2.0",
     "commander": "^14.0.3",
     "dotenv": "^17.3.1",
+    "framer-motion": "^12.38.0",
     "google-tts-api": "^2.0.2",
     "ink": "^7.0.1",
     "ink-text-input": "^6.0.0",
     "inquirer": "^13.4.1",
+    "lucide-react": "^1.9.0",
     "mammoth": "^1.12.0",
     "pdf-parse": "^2.4.5",
     "puppeteer": "^24.38.0",
     "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "xlsx": "^0.18.5"
   },
   "devDependencies": {
+    "@vitejs/plugin-react": "^6.0.1",
     "electron": "^40.7.0",
-    "electron-builder": "^26.8.1"
+    "electron-builder": "^26.8.1",
+    "vite": "^8.0.10"
   },
   "build": {
     "appId": "com.pheem49.mint",