@pheem49/mint 1.5.3 → 1.5.4

package/GUIDE_TH.md

@@ -6,15 +6,27 @@
 
 ## 1. การติดตั้ง (Installation)
 
-คุณสามารถติดตั้ง Mint ได้สองวิธีหลักๆ ดังนี้:
+คุณสามารถติดตั้ง Mint ได้ด้วยวิธีต่างๆ ดังนี้:
 
-### วิธีที่ 1: ติดตั้งผ่าน NPM (แนะนำสำหรับผู้ใช้ทั่วไป)
-หากคุณต้องการใช้งานคำสั่ง `mint` ได้จากทุกที่ในเครื่อง:
+### วิธีที่ 1: ติดตั้งแบบด่วน (แนะนำ)
+วิธีนี้จะติดตั้ง Mint CLI ให้อัตโนมัติในคำสั่งเดียว:
+**สำหรับ macOS และ Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/Pheem49/Mint/main/install.sh | bash
+```
+
+**สำหรับ Windows (PowerShell หรือ CMD):**
+```powershell
+powershell -Command "iwr -useb https://raw.githubusercontent.com/Pheem49/Mint/main/install.ps1 | iex"
+```
+
+### วิธีที่ 2: ติดตั้งผ่าน NPM
+หากคุณต้องการใช้งานคำสั่ง `mint` และถนัดการใช้ NPM:
 ```bash
 npm install -g @pheem49/mint@latest
 ```
 
-### วิธีที่ 2: ติดตั้งจาก Source Code (สำหรับนักพัฒนา)
+### วิธีที่ 3: ติดตั้งจาก Source Code (สำหรับนักพัฒนา)
 หากคุณต้องการแก้ไขโค้ดหรือลองฟีเจอร์ใหม่ๆ:
 1. Clone repository: `git clone https://github.com/Pheem49/Mint.git`
 2. เข้าไปที่โฟลเดอร์: `cd Mint`

package/README.md

@@ -39,7 +39,23 @@ Mint is an AI assistant built to live in your desktop and terminal. It combines
 
 ## Installation & Setup
 
-### Global Install
+### Quick Install (Recommended)
+
+The easiest way to install Mint CLI is using our installation script:
+
+**For macOS & Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/Pheem49/Mint/main/install.sh | bash
+```
+
+**For Windows (PowerShell or CMD):**
+```powershell
+powershell -Command "iwr -useb https://raw.githubusercontent.com/Pheem49/Mint/main/install.ps1 | iex"
+```
+
+### NPM Install
+
+If you prefer to install via NPM directly:
 
 ```bash
 npm install -g @pheem49/mint@latest

package/install.ps1

@@ -0,0 +1,64 @@
+<#
+.SYNOPSIS
+Mint CLI Installation Script for Windows
+.DESCRIPTION
+Installs the Mint CLI package globally via NPM.
+#>
+
+$ErrorActionPreference = "Stop"
+
+Write-Host "Starting Mint CLI installation..." -ForegroundColor Cyan
+
+# 1. Check for Node.js
+try {
+    $nodeVersion = (node -v) 2>$null
+    if ([string]::IsNullOrWhiteSpace($nodeVersion)) {
+        Write-Host "[Error] Node.js is not found on your system!" -ForegroundColor Red
+        Write-Host "Please install Node.js (version 18 or higher) before using Mint CLI." -ForegroundColor Yellow
+        Write-Host "Download at: https://nodejs.org/"
+        exit 1
+    }
+} catch {
+    Write-Host "[Error] Node.js is not found on your system!" -ForegroundColor Red
+    Write-Host "Please install Node.js (version 18 or higher) before using Mint CLI." -ForegroundColor Yellow
+    Write-Host "Download at: https://nodejs.org/"
+    exit 1
+}
+
+# 2. Check for NPM
+try {
+    $npmVersion = (npm -v) 2>$null
+    if ([string]::IsNullOrWhiteSpace($npmVersion)) {
+        Write-Host "[Error] NPM is not found on your system!" -ForegroundColor Red
+        exit 1
+    }
+} catch {
+    Write-Host "[Error] NPM is not found on your system!" -ForegroundColor Red
+    exit 1
+}
+
+# Check Node.js version (recommend 18+)
+$majorVersion = [int]($nodeVersion.Substring(1).Split('.')[0])
+if ($majorVersion -lt 18) {
+    Write-Host "[Warning] Your Node.js version is too old (current: $nodeVersion)" -ForegroundColor Yellow
+    Write-Host "It is recommended to update to version 18 or higher for full functionality." -ForegroundColor Yellow
+}
+
+# 3. Install Mint CLI via NPM
+Write-Host "Downloading and installing @pheem49/mint..." -ForegroundColor Cyan
+
+try {
+    # In Windows, we usually don't need sudo for global npm install if Node was installed for the user.
+    # We will just run the command normally.
+    npm install -g @pheem49/mint@latest
+} catch {
+    Write-Host "[Error] Installation failed. Try running PowerShell as Administrator." -ForegroundColor Red
+    exit 1
+}
+
+Write-Host ""
+Write-Host "Mint CLI installed successfully!" -ForegroundColor Green
+Write-Host "- Run 'mint' to get started."
+Write-Host "- Run 'mint onboard' to set up your API Keys."
+Write-Host "----------------------------------------"
+Write-Host "Happy coding!" -ForegroundColor Cyan

package/install.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# Mint CLI Installation Script
+# Usage: curl -fsSL <URL>/install.sh | bash
+
+set -e
+
+echo "Starting Mint CLI installation..."
+
+# 1. Check for Node.js
+if ! command -v node &> /dev/null
+then
+    echo "[Error] Node.js is not found on your system!"
+    echo "Please install Node.js (version 18 or higher) before using Mint CLI."
+    echo "Download at: https://nodejs.org/"
+    exit 1
+fi
+
+# 2. Check for NPM
+if ! command -v npm &> /dev/null
+then
+    echo "[Error] NPM is not found on your system!"
+    exit 1
+fi
+
+# Check Node.js version (recommend 18+)
+NODE_VERSION=$(node -v | cut -d 'v' -f 2 | cut -d '.' -f 1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    echo "[Warning] Your Node.js version is too old (current: v${NODE_VERSION})"
+    echo "It is recommended to update to version 18 or higher for full functionality."
+fi
+
+# 3. Install Mint CLI via NPM
+echo "Downloading and installing @pheem49/mint (may require Admin/Root privileges)..."
+
+# Determine if we need sudo
+if [ "$EUID" -ne 0 ] && command -v sudo &> /dev/null; then
+    # Check if npm global directory is writable by the current user (e.g., using NVM)
+    NPM_PREFIX=$(npm config get prefix 2>/dev/null || echo "/usr/local")
+    if [ -w "$NPM_PREFIX" ] || [ -w "$NPM_PREFIX/lib/node_modules" ]; then
+        npm install -g @pheem49/mint@latest
+    else
+        # Preserve user's PATH so sudo can find npm if it's installed via custom paths
+        sudo env "PATH=$PATH" npm install -g @pheem49/mint@latest
+    fi
+else
+    npm install -g @pheem49/mint@latest
+fi
+
+echo ""
+echo "Mint CLI installed successfully!"
+echo "- Run 'mint' to get started."
+echo "- Run 'mint onboard' to set up your API Keys."
+echo "----------------------------------------"
+echo "Happy coding!"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pheem49/mint",
-  "version": "1.5.3",
+  "version": "1.5.4",
   "description": "A powerful Electron-based AI desktop assistant powered by Google Gemini, featuring screen vision, web automation, and proactive suggestions.",
   "main": "main.js",
   "scripts": {
@@ -46,7 +46,8 @@
     "ink-text-input": "^6.0.0",
     "mammoth": "^1.12.0",
     "pdf-parse": "^2.4.5",
-    "react": "^19.2.5"
+    "react": "^19.2.5",
+    "read-excel-file": "^9.0.10"
   },
   "peerDependenciesOptional": {
     "puppeteer": ">=22.0.0",

package/preload.js

@@ -25,12 +25,14 @@ contextBridge.exposeInMainWorld('api', {
     startVision: () => ipcRenderer.invoke('start-screen-capture'),
     onVisionReady: (callback) => ipcRenderer.on('vision-ready', (event, data) => callback(data)),
     captureSilentScreen: () => ipcRenderer.invoke('capture-silent-screen'),
+    getSmartContext: () => ipcRenderer.invoke('get-smart-context'),
     // Proactive Assistant
     onProactiveSuggestion: (callback) => ipcRenderer.on('proactive-suggestion', (event, data) => callback(data)),
     onProactiveNotification: (callback) => ipcRenderer.on('proactive-notification', (event, data) => callback(data)),
     toggleProactive: (isOn) => ipcRenderer.send('toggle-proactive', isOn),
     recordBehavior: (context) => ipcRenderer.send('record-behavior', context),
     executeProactiveAction: (action) => ipcRenderer.invoke('execute-proactive-action', action),
+    executeApprovedAction: (action) => ipcRenderer.invoke('execute-approved-action', action),
     onSpotlightToChat: (callback) => ipcRenderer.on('spotlight-to-chat', (_event, query) => callback(query)),
     notifyAiResponse: () => ipcRenderer.send('ai-notify'),
     clearAiNotifications: () => ipcRenderer.send('ai-notify-clear'),

package/src/AI_Brain/Gemini_API.js

@@ -47,6 +47,34 @@ function normalizeImageList(base64Image) {
   return Array.isArray(base64Image) ? base64Image.filter(Boolean) : [base64Image];
 }
 
+const CHAT_MODE_ACTION_POLICY = `GOAL:
+Your goal is to help the user with their queries. This Electron app is Chat Mode: use at most ONE simple action per user message, only when the latest message explicitly asks for that local action. If the user asks a question or asks you to provide text/commands, answer with action "none".
+
+ACTION DISCIPLINE:
+- Always return a single JSON object. Never return a JSON array or multiple actions.
+- If the user asks "พิมพ์คำสั่งให้หน่อย", "บอกคำสั่ง", "ขอคำสั่ง", "what command", or "type the command", provide the command in "response" and set action "none". Do NOT use "type_text" or "key_tap".
+- Use "type_text", "key_tap", "mouse_click", or "mouse_move" only when the user explicitly asks you to control the currently focused UI, not when they ask for a command to copy/type themselves.
+- If the user asks to run terminal commands or code, Chat Mode should provide the command or tell them to use the Mint CLI agent. Do not type or press Enter on their behalf.
+- Never say you opened, checked, inspected, or verified a file/folder unless the selected action actually does it and the app will execute that action.
+- If the request needs workspace code inspection, edits, tests, or shell execution, tell the user to use the Mint CLI agent instead of pretending to inspect files.`;
+
+const AGENT_MODE_ACTION_POLICY = `GOAL:
+Your goal is to act as Mint's Desktop Agent Mode. You may use ONE concrete desktop action per response when it directly advances the user's latest request or a clear desktop task implied by Smart Context. Prefer useful action over explaining when the user asked Mint to do something.
+
+ACTION DISCIPLINE:
+- Always return a single JSON object. Never return a JSON array or multiple actions.
+- Choose exactly one action when a desktop action is useful and the user's intent is clear; otherwise use action "none" and ask a concise follow-up.
+- You may use safe desktop actions such as open_url, search, open_app, find_path, open_file, open_folder, create_folder, clipboard_write, learn_file, learn_folder, plugin, mcp_tool, web_automation, system_info, mouse_move, mouse_click, type_text, and key_tap when they match the request.
+- Approval and dangerous actions are handled by Mint's UI. You may propose system_automation or delete_file only when the user clearly requested it; the app will ask for permission before running.
+- For UI-control actions (mouse_click, mouse_move, type_text, key_tap), rely on Smart Context or the attached screenshot. If the target is ambiguous, ask before acting.
+- If the user asks "พิมพ์คำสั่งให้หน่อย", "บอกคำสั่ง", "ขอคำสั่ง", "what command", or "type the command", provide the command in "response" and set action "none" unless they explicitly ask Mint to type it into the active UI.
+- If the request needs workspace code inspection, edits, tests, or shell execution, tell the user to use the Mint CLI agent instead of pretending to inspect files or run commands from Chat UI.
+- Never say you opened, checked, inspected, or verified something unless the selected action actually does it and the app will execute that action.`;
+
+function buildActionModeInstruction(config = readConfig()) {
+  return config.assistantMode === 'agent' ? AGENT_MODE_ACTION_POLICY : CHAT_MODE_ACTION_POLICY;
+}
+
 const systemInstruction = `You are "Mint" (มิ้นท์), a cute, cheerful, and highly helpful female Local AI Desktop Agent. 
 
 PERSONALITY & TONE:
@@ -71,16 +99,7 @@ NATURAL CHAT FLOW:
 - The latest user message is authoritative. Do not continue or describe older tasks unless the latest message explicitly asks you to continue them.
 - For greetings, name-calls, acknowledgements, and backchannels such as "มิ้น", "มิ้นๆ", "อ๋อ", "โอเค", "ขอบคุณ", "hi", "hello", "ok", or "thanks", return action "none" and a short reply only.
 
-GOAL:
-Your goal is to help the user with their queries. This Electron app is Chat Mode, not Code Agent Mode: use at most ONE simple action per user message, only when the latest message explicitly asks for that local action. If the user asks a question or asks you to provide text/commands, answer with action "none".
-
-ACTION DISCIPLINE:
-- Always return a single JSON object. Never return a JSON array or multiple actions.
-- If the user asks "พิมพ์คำสั่งให้หน่อย", "บอกคำสั่ง", "ขอคำสั่ง", "what command", or "type the command", provide the command in "response" and set action "none". Do NOT use "type_text" or "key_tap".
-- Use "type_text", "key_tap", "mouse_click", or "mouse_move" only when the user explicitly asks you to control the currently focused UI, not when they ask for a command to copy/type themselves.
-- If the user asks to run terminal commands or code, Chat Mode should provide the command or tell them to use the CLI agent. Do not type or press Enter on their behalf.
-- Never say you opened, checked, inspected, or verified a file/folder unless the selected action actually does it and the app will execute that action.
-- If the request needs workspace code inspection, edits, tests, or shell execution, tell the user to use the Mint CLI agent instead of pretending to inspect files.
+{{ACTION_MODE_INSTRUCTION}}
 
 CREATOR INFO:
 - The creator is Pheem49.
@@ -144,6 +163,7 @@ ${toolRegistry.buildToolPromptSection()}
 // Replaces 5 previously duplicated mcpPrompt blocks.
 // ─────────────────────────────────────────────────────────────────────────────
 function buildSystemPrompt() {
+    const config = readConfig();
     pluginManager.loadPlugins();
     const mcpTools = mcpManager.getAllTools();
 
@@ -171,7 +191,9 @@ function buildSystemPrompt() {
         workspaceSection = `\n\n[WORKSPACE DETECTED: ${ws.name}]\nPath: ${ws.path}\nProject Instructions: ${ws.instructions}\n`;
     }
 
-    return systemInstruction + personaInstruction + workspaceSection + pluginManager.getPromptDescriptions() + mcpSection + userContext;
+    const modeInstruction = buildActionModeInstruction(config);
+    const baseInstruction = systemInstruction.replace('{{ACTION_MODE_INSTRUCTION}}', modeInstruction);
+    return baseInstruction + personaInstruction + workspaceSection + pluginManager.getPromptDescriptions() + mcpSection + userContext;
 }
 
 function buildMessageWithRelevantMemory(finalMessage) {
@@ -197,10 +219,15 @@ function stripRelevantMemoryBlock(text) {
     return input
         .replace(/\n?\[Relevant long-term memory for this user message\][\s\S]*?\[End relevant memory\]\n?/g, '\n')
         .replace(/^\s*\[Relevant long-term memory for this user message\][\s\S]*?\[End relevant memory\]\s*/g, '')
+        .replace(/\n?\[SMART_CONTEXT\][\s\S]*?\[\/SMART_CONTEXT\]\n?/g, '\n')
         .replace(/\n?\[LOCAL KNOWLEDGE BASE - USE THIS CONTEXT TO ANSWER\][\s\S]*/g, '')
         .trim();
 }
 
+function hasSmartContextBlock(text) {
+    return /\[SMART_CONTEXT\][\s\S]*?\[\/SMART_CONTEXT\]/.test(String(text || ''));
+}
+
 function cleanHistoryForStorage(history) {
     if (!Array.isArray(history)) return [];
     return history.map(msg => ({
@@ -467,13 +494,15 @@ async function handleChat(message, base64Image = null, base64Audio = null) {
     const config = readConfig();
     const images = normalizeImageList(base64Image);
     const previousHistory = readChatHistory();
+    const userVisibleMessage = stripRelevantMemoryBlock(message);
+    const containsSmartContext = hasSmartContextBlock(message);
 
     let finalMessage = message;
     
     // Inject Local RAG Context
-    if (message && message.trim().length > 0 && shouldUseKnowledgeSearch(message)) {
+    if (userVisibleMessage && userVisibleMessage.trim().length > 0 && shouldUseKnowledgeSearch(userVisibleMessage)) {
         const { searchKnowledge } = require('./knowledge_base');
-        const retrievedDocs = await searchKnowledge(message);
+        const retrievedDocs = await searchKnowledge(userVisibleMessage);
         if (retrievedDocs && retrievedDocs.length > 0) {
             let contextString = `\n\n[LOCAL KNOWLEDGE BASE - USE THIS CONTEXT TO ANSWER]\n`;
             retrievedDocs.forEach(doc => {
@@ -483,8 +512,8 @@ async function handleChat(message, base64Image = null, base64Audio = null) {
         }
     }
 
-    if (finalMessage && images.length === 0 && !base64Audio) {
-      const cached = memoryStore.getCachedResponse(finalMessage);
+    if (!containsSmartContext && userVisibleMessage && images.length === 0 && !base64Audio) {
+      const cached = memoryStore.getCachedResponse(userVisibleMessage);
       if (cached) return cached;
     }
 
@@ -507,15 +536,15 @@ async function handleChat(message, base64Image = null, base64Audio = null) {
       model: getProviderModel(provider, config),
       usage: client.getUsageSummary()
     };
-    const parsedResult = parseChatProviderResponse(outputText, finalMessage, now);
+    const parsedResult = parseChatProviderResponse(outputText, userVisibleMessage || finalMessage, now);
     parsedResult.providerInfo = providerInfo;
-    appendChatProviderHistory(previousHistory, finalMessage, outputText, providerInfo, now);
+    appendChatProviderHistory(previousHistory, userVisibleMessage || finalMessage, outputText, providerInfo, now);
 
-    if (finalMessage && parsedResult.response) {
+    if ((userVisibleMessage || finalMessage) && parsedResult.response) {
       setImmediate(() => {
-        memoryStore.recordInteraction(finalMessage, parsedResult.response);
-        if (images.length === 0 && !base64Audio) {
-          memoryStore.cacheResponse(finalMessage, parsedResult);
+        memoryStore.recordInteraction(userVisibleMessage || finalMessage, parsedResult.response);
+        if (!containsSmartContext && images.length === 0 && !base64Audio) {
+          memoryStore.cacheResponse(userVisibleMessage || finalMessage, parsedResult);
         }
       });
     }
@@ -761,6 +790,7 @@ module.exports = {
     refreshApiKeyFromConfig,
     _helpers: {
         getProviderAttemptOrder,
-        normalizeParsedResult
+        normalizeParsedResult,
+        buildActionModeInstruction
     }
 };

package/src/Automation_Layer/file_operations.js

@@ -18,6 +18,8 @@ const IGNORED_DIRECTORY_NAMES = new Set([
     'coverage'
 ]);
 
+const COMMON_HOME_FOLDERS = ['Downloads', 'Desktop', 'Documents', 'Videos', 'Pictures', 'Music', 'vscode', 'Games'];
+
 function getSearchRoots() {
     return Array.from(new Set([
         process.cwd(),
@@ -34,8 +36,6 @@ function resolveSmartPath(target) {
     if (!target) return target;
 
     const home = os.homedir();
-    const commonFolders = ['Downloads', 'Desktop', 'Documents', 'Videos', 'Pictures', 'Music', 'vscode', 'Games'];
-
     // 1. If it's already an absolute path and exists, use it
     if (path.isAbsolute(target) && fs.existsSync(target)) return target;
 
@@ -54,13 +54,13 @@ function resolveSmartPath(target) {
     // 4. Check if the target itself starts with a common folder (e.g., "Downloads/resume.pdf")
     const parts = target.split(/[/\\]/);
     const firstPart = parts[0];
-    if (commonFolders.includes(firstPart)) {
+    if (COMMON_HOME_FOLDERS.includes(firstPart)) {
         const potentialPath = path.join(home, target);
         if (fs.existsSync(potentialPath)) return potentialPath;
     }
 
     // 5. Try searching the filename in all common folders
-    for (const folder of commonFolders) {
+    for (const folder of COMMON_HOME_FOLDERS) {
         const potentialPath = path.join(home, folder, target);
         if (fs.existsSync(potentialPath)) return potentialPath;
     }
@@ -76,6 +76,18 @@ function findPath(target, options = {}) {
 
     const normalizedType = ['file', 'dir', 'any'].includes(options.type) ? options.type : 'any';
     const loweredQuery = target.trim().toLowerCase();
+    const directPath = resolveSmartPath(target.trim());
+    if (directPath && path.isAbsolute(directPath) && fs.existsSync(directPath)) {
+        const stat = fs.statSync(directPath);
+        const directType = stat.isDirectory() ? 'dir' : 'file';
+        if (normalizedType === 'any' || normalizedType === directType) {
+            return {
+                success: true,
+                matches: [{ path: directPath, type: directType }]
+            };
+        }
+    }
+
     const exactMatches = [];
     const partialMatches = [];
     const visited = new Set();
@@ -271,4 +283,4 @@ async function deleteFile(target) {
     }
 }
 
-module.exports = { createFolder, openFile, deleteFile, findPath };
+module.exports = { createFolder, openFile, deleteFile, findPath, resolveSmartPath };

package/src/System/config_manager.js

@@ -45,6 +45,7 @@ const DEFAULT_CONFIG = {
     apiKey: '',
     geminiModel: 'gemini-2.5-flash',
     language: 'th-TH',
+    assistantMode: 'chat',
     automationBrowser: 'chromium',
     proactiveInterval: 60,   // seconds between screen captures
     proactiveCooldown: 120,   // seconds minimum between actual suggestions

package/src/System/ipc_handlers.js

@@ -1,3 +1,43 @@
+const safetyManager = require('./safety_manager');
+const { getSmartContext } = require('./smart_context');
+
+function buildApprovalRequest(action) {
+    const classification = safetyManager.classifyAction(action);
+    if (
+        classification.tier !== safetyManager.TIERS.APPROVAL &&
+        classification.tier !== safetyManager.TIERS.DANGEROUS
+    ) {
+        return null;
+    }
+
+    return {
+        required: true,
+        tier: classification.tier,
+        reason: classification.reason,
+        action
+    };
+}
+
+async function executeApprovedAction(executeAction, action, clipboard) {
+    const classification = safetyManager.classifyAction(action);
+    const options = {
+        clipboard,
+        source: 'user_approved_action',
+        allowApproval: classification.tier === safetyManager.TIERS.APPROVAL,
+        allowDangerous: classification.tier === safetyManager.TIERS.DANGEROUS
+    };
+    const result = await executeAction(action, options);
+    return {
+        success: true,
+        action,
+        tier: classification.tier,
+        result,
+        message: result && typeof result === 'string'
+            ? result
+            : 'Action completed.'
+    };
+}
+
 function registerIpcHandlers({
     app,
     ipcMain,
@@ -36,6 +76,12 @@ function registerIpcHandlers({
 
             if (aiResponse.action && aiResponse.action.type !== 'none') {
                 try {
+                    const approval = buildApprovalRequest(aiResponse.action);
+                    if (approval) {
+                        aiResponse.approval = approval;
+                        return aiResponse;
+                    }
+
                     const actionResult = await executeAction(aiResponse.action, { clipboard });
                     if (actionResult && typeof actionResult === 'string') {
                         aiResponse.response += `\n\n${actionResult}`;
@@ -53,6 +99,18 @@ function registerIpcHandlers({
         }
     });
 
+    ipcMain.handle('execute-approved-action', async (event, action) => {
+        try {
+            if (!action || action.type === 'none') {
+                return { success: false, message: 'No action to execute.' };
+            }
+            return await executeApprovedAction(executeAction, action, clipboard);
+        } catch (err) {
+            console.error('[ApprovedAction] Error:', err);
+            return { success: false, message: err.message || 'Action failed.' };
+        }
+    });
+
     ipcMain.on('close-window', () => {
         const mainWindow = windowManager.getMainWindow();
         if (mainWindow) mainWindow.hide();
@@ -167,6 +225,30 @@ function registerIpcHandlers({
         }
     });
 
+    ipcMain.handle('spotlight-action', async (event, action) => {
+        const spotlightWindow = windowManager.getSpotlightWindow();
+        if (spotlightWindow) spotlightWindow.hide();
+
+        if (!action || action.type === 'none') {
+            return { success: false, message: 'No Spotlight action to execute.' };
+        }
+
+        try {
+            const result = await executeAction(action, {
+                clipboard,
+                source: 'spotlight'
+            });
+            return {
+                success: true,
+                action,
+                message: result && typeof result === 'string' ? result : 'Spotlight action completed.'
+            };
+        } catch (err) {
+            console.error('[SpotlightAction] Error:', err);
+            return { success: false, message: err.message || 'Spotlight action failed.' };
+        }
+    });
+
     ipcMain.on('spotlight-resize', (event, width, height) => {
         const spotlightWindow = windowManager.getSpotlightWindow();
         if (spotlightWindow) spotlightWindow.setSize(width, height);
@@ -207,6 +289,8 @@ function registerIpcHandlers({
     ipcMain.on('vision-cancel', () => screenCapture.cancel());
     ipcMain.handle('capture-silent-screen', () => screenCapture.captureSilentScreen());
 
+    ipcMain.handle('get-smart-context', () => getSmartContext({ clipboard }));
+
     ipcMain.on('toggle-proactive', (event, isOn) => {
         if (isOn) {
             proactiveLoop.start();
@@ -245,4 +329,4 @@ function registerIpcHandlers({
     });
 }
 
-module.exports = { registerIpcHandlers };
+module.exports = { registerIpcHandlers, buildApprovalRequest, executeApprovedAction };