@pulso/companion 0.2.1 → 0.2.3

package/dist/index.js

@@ -3,17 +3,29 @@
 // src/index.ts
 import WebSocket from "ws";
 import { exec, execSync } from "child_process";
-import { readFileSync, writeFileSync, existsSync, readdirSync, statSync, copyFileSync, renameSync } from "fs";
+import {
+  readFileSync,
+  writeFileSync,
+  existsSync,
+  readdirSync,
+  statSync,
+  copyFileSync,
+  renameSync
+} from "fs";
 import { homedir } from "os";
 import { join, resolve, basename, extname } from "path";
-var API_URL = process.env.PULSO_API_URL ?? process.argv.find((_, i, a) => a[i - 1] === "--api") ?? "https://pulso-api.vulk.workers.dev";
+var API_URL = process.env.PULSO_API_URL ?? process.argv.find((_, i, a) => a[i - 1] === "--api") ?? "https://api.runpulso.com";
 var TOKEN = process.env.PULSO_TOKEN ?? process.argv.find((_, i, a) => a[i - 1] === "--token") ?? "";
 if (!TOKEN) {
   console.error("\u274C Missing token. Set PULSO_TOKEN or use --token <jwt>");
-  console.error("   Get your token: log in to Pulso \u2192 Settings \u2192 Companion Token");
+  console.error(
+    "   Get your token: log in to Pulso \u2192 Settings \u2192 Companion Token"
+  );
   process.exit(1);
 }
 var ACCESS_LEVEL = process.env.PULSO_ACCESS ?? process.argv.find((_, i, a) => a[i - 1] === "--access") ?? "sandboxed";
+var WAKE_WORD_ENABLED = process.argv.includes("--wake-word");
+var PICOVOICE_ACCESS_KEY = process.env.PICOVOICE_ACCESS_KEY ?? process.argv.find((_, i, a) => a[i - 1] === "--picovoice-key") ?? "";
 var WS_URL = API_URL.replace("https://", "wss://").replace("http://", "ws://") + "/ws/browser?token=" + TOKEN;
 var HOME = homedir();
 var RECONNECT_DELAY = 5e3;
@@ -31,10 +43,14 @@ function safePath(relative) {
 }
 function runAppleScript(script) {
   return new Promise((resolve2, reject) => {
-    exec(`osascript -e '${script.replace(/'/g, "'\\''")}'`, { timeout: 15e3 }, (err, stdout, stderr) => {
-      if (err) reject(new Error(stderr || err.message));
-      else resolve2(stdout.trim());
-    });
+    exec(
+      `osascript -e '${script.replace(/'/g, "'\\''")}'`,
+      { timeout: 15e3 },
+      (err, stdout, stderr) => {
+        if (err) reject(new Error(stderr || err.message));
+        else resolve2(stdout.trim());
+      }
+    );
   });
 }
 function runShell(cmd, timeout = 1e4) {
@@ -58,7 +74,9 @@ function runSwift(code, timeout = 1e4) {
 var SETUP_DONE_FILE = join(HOME, ".pulso-companion-setup");
 async function setupPermissions() {
   const isFirstRun = !existsSync(SETUP_DONE_FILE);
-  console.log(isFirstRun ? "\u{1F510} First run \u2014 setting up permissions...\n" : "\u{1F510} Checking permissions...\n");
+  console.log(
+    isFirstRun ? "\u{1F510} First run \u2014 setting up permissions...\n" : "\u{1F510} Checking permissions...\n"
+  );
   const status = {};
   const browserDefaults = [
     ["Google Chrome", "com.google.Chrome", "AllowJavaScriptAppleEvents"],
@@ -68,15 +86,24 @@ async function setupPermissions() {
   ];
   for (const [name, domain, key] of browserDefaults) {
     try {
-      execSync(`defaults write ${domain} ${key} -bool true 2>/dev/null`, { timeout: 3e3 });
-      if (name === "Google Chrome" || name === "Safari") status[`${name} JS`] = "\u2705";
+      execSync(`defaults write ${domain} ${key} -bool true 2>/dev/null`, {
+        timeout: 3e3
+      });
+      if (name === "Google Chrome" || name === "Safari")
+        status[`${name} JS`] = "\u2705";
     } catch {
-      if (name === "Google Chrome" || name === "Safari") status[`${name} JS`] = "\u26A0\uFE0F";
+      if (name === "Google Chrome" || name === "Safari")
+        status[`${name} JS`] = "\u26A0\uFE0F";
     }
   }
-  for (const [browserName, processName] of [["Google Chrome", "Google Chrome"], ["Safari", "Safari"]]) {
+  for (const [browserName, processName] of [
+    ["Google Chrome", "Google Chrome"],
+    ["Safari", "Safari"]
+  ]) {
     try {
-      const running = execSync(`pgrep -x "${processName}" 2>/dev/null`, { timeout: 2e3 }).toString().trim();
+      const running = execSync(`pgrep -x "${processName}" 2>/dev/null`, {
+        timeout: 2e3
+      }).toString().trim();
       if (!running) continue;
       const enableJsScript = browserName === "Google Chrome" ? `tell application "System Events"
             tell process "Google Chrome"
@@ -101,24 +128,38 @@ async function setupPermissions() {
               end if
             end tell
           end tell` : `return "skip_safari"`;
-      const result = execSync(`osascript -e '${enableJsScript.replace(/'/g, "'\\''")}' 2>/dev/null`, { timeout: 1e4 }).toString().trim();
+      const result = execSync(
+        `osascript -e '${enableJsScript.replace(/'/g, "'\\''")}' 2>/dev/null`,
+        { timeout: 1e4 }
+      ).toString().trim();
       if (result === "enabled") {
-        console.log(`   \u2705 ${browserName}: JavaScript from Apple Events enabled via menu`);
+        console.log(
+          `   \u2705 ${browserName}: JavaScript from Apple Events enabled via menu`
+        );
       }
     } catch {
     }
   }
   try {
-    execSync(`osascript -e 'tell application "System Events" to name of first process' 2>/dev/null`, { timeout: 5e3 });
+    execSync(
+      `osascript -e 'tell application "System Events" to name of first process' 2>/dev/null`,
+      { timeout: 5e3 }
+    );
     status["Accessibility"] = "\u2705";
   } catch (err) {
     const msg = err.message || "";
     if (msg.includes("not allowed") || msg.includes("assistive") || msg.includes("-1719")) {
       status["Accessibility"] = "\u26A0\uFE0F";
       if (isFirstRun) {
-        console.log("   \u26A0\uFE0F  Accessibility: macOS should show a permission dialog.");
-        console.log("      If not, go to: System Settings \u2192 Privacy & Security \u2192 Accessibility");
-        console.log("      Add your terminal app (Terminal, iTerm, Warp, etc.)\n");
+        console.log(
+          "   \u26A0\uFE0F  Accessibility: macOS should show a permission dialog."
+        );
+        console.log(
+          "      If not, go to: System Settings \u2192 Privacy & Security \u2192 Accessibility"
+        );
+        console.log(
+          "      Add your terminal app (Terminal, iTerm, Warp, etc.)\n"
+        );
       }
     } else {
       status["Accessibility"] = "\u2705";
@@ -135,8 +176,12 @@ async function setupPermissions() {
       } else {
         status["Screen Recording"] = "\u26A0\uFE0F";
         if (isFirstRun) {
-          console.log("   \u26A0\uFE0F  Screen Recording: macOS should show a permission dialog.");
-          console.log("      If not, go to: System Settings \u2192 Privacy & Security \u2192 Screen Recording");
+          console.log(
+            "   \u26A0\uFE0F  Screen Recording: macOS should show a permission dialog."
+          );
+          console.log(
+            "      If not, go to: System Settings \u2192 Privacy & Security \u2192 Screen Recording"
+          );
           console.log("      Add your terminal app\n");
         }
       }
@@ -146,8 +191,12 @@ async function setupPermissions() {
   } catch {
     status["Screen Recording"] = "\u26A0\uFE0F";
     if (isFirstRun) {
-      console.log("   \u26A0\uFE0F  Screen Recording: permission needed for screenshots.");
-      console.log("      Go to: System Settings \u2192 Privacy & Security \u2192 Screen Recording\n");
+      console.log(
+        "   \u26A0\uFE0F  Screen Recording: permission needed for screenshots."
+      );
+      console.log(
+        "      Go to: System Settings \u2192 Privacy & Security \u2192 Screen Recording\n"
+      );
     }
   }
   console.log("   Permission Status:");
@@ -164,9 +213,14 @@ async function setupPermissions() {
   }
   const needsManual = status["Accessibility"] === "\u26A0\uFE0F" || status["Screen Recording"] === "\u26A0\uFE0F";
   if (isFirstRun && needsManual) {
-    console.log("   Opening System Settings for you to approve permissions...\n");
+    console.log(
+      "   Opening System Settings for you to approve permissions...\n"
+    );
     try {
-      execSync('open "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"', { timeout: 3e3 });
+      execSync(
+        'open "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"',
+        { timeout: 3e3 }
+      );
     } catch {
     }
   }
@@ -194,7 +248,27 @@ async function spotifySearch(query) {
     }
   } catch {
   }
+  const songKeywords = /\b(song|track|canção|cancion|musica|música|remix|feat|ft\.|version|cover|live|acoustic)\b/i;
+  const hasMultipleWords = key.split(/\s+/).length >= 3;
+  const looksLikeArtist = !songKeywords.test(key) && !hasMultipleWords;
+  if (looksLikeArtist) {
+    const artistId = await searchForSpotifyArtist(query);
+    if (artistId) {
+      const result2 = {
+        uri: `spotify:artist:${artistId}`,
+        name: "Top Songs",
+        artist: query
+      };
+      searchCache.set(key, { ...result2, ts: Date.now() });
+      pushToServerCache(query, result2).catch(() => {
+      });
+      return result2;
+    }
+  }
   let trackIds = await searchBraveForSpotifyTracks(query);
+  if (trackIds.length === 0) {
+    trackIds = await searchDDGForSpotifyTracks(query);
+  }
   if (trackIds.length === 0) {
     trackIds = await searchStartpageForSpotifyTracks(query);
   }
@@ -210,6 +284,72 @@ async function spotifySearch(query) {
   });
   return result;
 }
+async function searchForSpotifyArtist(query) {
+  const engines = [
+    {
+      name: "brave",
+      fn: () => searchWebForSpotifyIds(
+        query,
+        "artist",
+        `https://search.brave.com/search?q=${encodeURIComponent(`${query} artist site:open.spotify.com`)}&source=web`
+      )
+    },
+    {
+      name: "ddg",
+      fn: () => searchWebForSpotifyIds(
+        query,
+        "artist",
+        `https://html.duckduckgo.com/html/?q=${encodeURIComponent(`${query} artist site:open.spotify.com`)}`
+      )
+    }
+  ];
+  for (const engine of engines) {
+    try {
+      const ids = await engine.fn();
+      if (ids.length > 0) return ids[0];
+    } catch {
+    }
+  }
+  return null;
+}
+async function searchWebForSpotifyIds(query, type, url) {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 8e3);
+    const opts = {
+      headers: { "User-Agent": UA, Accept: "text/html" },
+      signal: controller.signal
+    };
+    if (url.includes("duckduckgo.com/html")) {
+      const searchUrl = new URL(url);
+      const q = searchUrl.searchParams.get("q") ?? query;
+      Object.assign(opts, {
+        method: "POST",
+        headers: {
+          ...opts.headers,
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: `q=${encodeURIComponent(q)}`
+      });
+      url = "https://html.duckduckgo.com/html/";
+    }
+    const res = await fetch(url, opts);
+    clearTimeout(timeout);
+    if (!res.ok) return [];
+    const html = await res.text();
+    const ids = /* @__PURE__ */ new Set();
+    const pattern = new RegExp(
+      `open\\.spotify\\.com(?:/intl-[a-z]+)?/${type}/([a-zA-Z0-9]{22})`,
+      "g"
+    );
+    for (const m of html.matchAll(pattern)) {
+      ids.add(m[1]);
+    }
+    return [...ids];
+  } catch {
+    return [];
+  }
+}
 async function searchBraveForSpotifyTracks(query) {
   try {
     const searchQuery = `spotify track ${query} site:open.spotify.com`;
@@ -224,7 +364,33 @@ async function searchBraveForSpotifyTracks(query) {
     if (!res.ok) return [];
     const html = await res.text();
     const trackIds = /* @__PURE__ */ new Set();
-    for (const m of html.matchAll(/https?:\/\/open\.spotify\.com\/track\/([a-zA-Z0-9]{22})/g)) {
+    for (const m of html.matchAll(
+      /https?:\/\/open\.spotify\.com\/track\/([a-zA-Z0-9]{22})/g
+    )) {
+      trackIds.add(m[1]);
+    }
+    return [...trackIds];
+  } catch {
+    return [];
+  }
+}
+async function searchDDGForSpotifyTracks(query) {
+  try {
+    const searchQuery = `spotify track ${query} site:open.spotify.com`;
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(searchQuery)}`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 8e3);
+    const res = await fetch(url, {
+      headers: { "User-Agent": UA, Accept: "text/html" },
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!res.ok) return [];
+    const html = await res.text();
+    const trackIds = /* @__PURE__ */ new Set();
+    for (const m of html.matchAll(
+      /open\.spotify\.com(?:\/intl-[a-z]+)?\/track\/([a-zA-Z0-9]{22})/g
+    )) {
       trackIds.add(m[1]);
     }
     return [...trackIds];
@@ -250,7 +416,9 @@ async function searchStartpageForSpotifyTracks(query) {
     if (!res.ok) return [];
     const html = await res.text();
     const trackIds = /* @__PURE__ */ new Set();
-    for (const m of html.matchAll(/open\.spotify\.com(?:\/intl-[a-z]+)?\/track\/([a-zA-Z0-9]{22})/g)) {
+    for (const m of html.matchAll(
+      /open\.spotify\.com(?:\/intl-[a-z]+)?\/track\/([a-zA-Z0-9]{22})/g
+    )) {
       trackIds.add(m[1]);
     }
     return [...trackIds];
@@ -269,7 +437,9 @@ async function getTrackMetadata(trackId) {
     clearTimeout(timeout);
     if (!res.ok) return null;
     const html = await res.text();
-    const scriptMatch = html.match(/<script[^>]*>(\{"props":\{"pageProps".*?\})<\/script>/s);
+    const scriptMatch = html.match(
+      /<script[^>]*>(\{"props":\{"pageProps".*?\})<\/script>/s
+    );
     if (!scriptMatch) return null;
     const data = JSON.parse(scriptMatch[1]);
     const entity = data?.props?.pageProps?.state?.data?.entity;
@@ -321,7 +491,8 @@ async function handleCommand(command, params) {
       case "sys_notification": {
         const title = params.title;
         const message = params.message;
-        if (!title || !message) return { success: false, error: "Missing title or message" };
+        if (!title || !message)
+          return { success: false, error: "Missing title or message" };
         await runAppleScript(
           `display notification "${message.replace(/"/g, '\\"')}" with title "${title.replace(/"/g, '\\"')}"`
         );
@@ -350,26 +521,48 @@ async function handleCommand(command, params) {
             await runAppleScript('tell application "Spotify" to next track');
             return { success: true, data: { action: "next" } };
           case "previous":
-            await runAppleScript('tell application "Spotify" to previous track');
+            await runAppleScript(
+              'tell application "Spotify" to previous track'
+            );
             return { success: true, data: { action: "previous" } };
           case "now_playing": {
-            const name = await runAppleScript('tell application "Spotify" to name of current track');
-            const artist = await runAppleScript('tell application "Spotify" to artist of current track');
-            const album = await runAppleScript('tell application "Spotify" to album of current track');
-            const state = await runAppleScript('tell application "Spotify" to player state as string');
-            return { success: true, data: { track: name, artist, album, state } };
+            const name = await runAppleScript(
+              'tell application "Spotify" to name of current track'
+            );
+            const artist = await runAppleScript(
+              'tell application "Spotify" to artist of current track'
+            );
+            const album = await runAppleScript(
+              'tell application "Spotify" to album of current track'
+            );
+            const state = await runAppleScript(
+              'tell application "Spotify" to player state as string'
+            );
+            return {
+              success: true,
+              data: { track: name, artist, album, state }
+            };
           }
           case "search_play": {
             const query = params.query;
-            if (!query) return { success: false, error: "Missing search query" };
+            if (!query)
+              return { success: false, error: "Missing search query" };
             const result = await spotifySearch(query);
             if (result) {
-              await runAppleScript(`tell application "Spotify" to play track "${result.uri}"`);
+              await runAppleScript(
+                `tell application "Spotify" to play track "${result.uri}"`
+              );
               await new Promise((r) => setTimeout(r, 1500));
               try {
-                const track = await runAppleScript('tell application "Spotify" to name of current track');
-                const artist = await runAppleScript('tell application "Spotify" to artist of current track');
-                const state = await runAppleScript('tell application "Spotify" to player state as string');
+                const track = await runAppleScript(
+                  'tell application "Spotify" to name of current track'
+                );
+                const artist = await runAppleScript(
+                  'tell application "Spotify" to artist of current track'
+                );
+                const state = await runAppleScript(
+                  'tell application "Spotify" to player state as string'
+                );
                 return {
                   success: true,
                   data: {
@@ -380,10 +573,19 @@ async function handleCommand(command, params) {
                   }
                 };
               } catch {
-                return { success: true, data: { searched: query, resolved: `${result.name} - ${result.artist}`, note: "Playing track" } };
+                return {
+                  success: true,
+                  data: {
+                    searched: query,
+                    resolved: `${result.name} - ${result.artist}`,
+                    note: "Playing track"
+                  }
+                };
               }
             }
-            await runShell(`open "spotify:search:${encodeURIComponent(query)}"`);
+            await runShell(
+              `open "spotify:search:${encodeURIComponent(query)}"`
+            );
             return {
               success: true,
               data: {
@@ -395,34 +597,61 @@ async function handleCommand(command, params) {
           }
           case "volume": {
             const level = params.level;
-            if (level === void 0 || level < 0 || level > 100) return { success: false, error: "Volume must be 0-100" };
-            await runAppleScript(`tell application "Spotify" to set sound volume to ${level}`);
+            if (level === void 0 || level < 0 || level > 100)
+              return { success: false, error: "Volume must be 0-100" };
+            await runAppleScript(
+              `tell application "Spotify" to set sound volume to ${level}`
+            );
             return { success: true, data: { volume: level } };
           }
           case "shuffle": {
             const enabled = params.enabled;
-            await runAppleScript(`tell application "Spotify" to set shuffling to ${enabled ? "true" : "false"}`);
+            await runAppleScript(
+              `tell application "Spotify" to set shuffling to ${enabled ? "true" : "false"}`
+            );
             return { success: true, data: { shuffling: enabled } };
           }
           case "repeat": {
             const mode = params.mode;
-            if (!mode) return { success: false, error: "Missing mode (off, context, track)" };
-            const repeatMap = { off: "off", context: "context", track: "track" };
+            if (!mode)
+              return {
+                success: false,
+                error: "Missing mode (off, context, track)"
+              };
+            const repeatMap = {
+              off: "off",
+              context: "context",
+              track: "track"
+            };
             const val = repeatMap[mode];
-            if (!val) return { success: false, error: "Mode must be: off, context, or track" };
-            await runAppleScript(`tell application "Spotify" to set repeating to ${val !== "off"}`);
+            if (!val)
+              return {
+                success: false,
+                error: "Mode must be: off, context, or track"
+              };
+            await runAppleScript(
+              `tell application "Spotify" to set repeating to ${val !== "off"}`
+            );
             return { success: true, data: { repeating: mode } };
           }
           default:
-            return { success: false, error: `Unknown Spotify action: ${action}` };
+            return {
+              success: false,
+              error: `Unknown Spotify action: ${action}`
+            };
         }
       }
       case "sys_file_read": {
         const path = params.path;
         if (!path) return { success: false, error: "Missing file path" };
         const fullPath = safePath(path);
-        if (!fullPath) return { success: false, error: `Access denied. Only files in ${SAFE_DIRS.join(", ")} are allowed.` };
-        if (!existsSync(fullPath)) return { success: false, error: `File not found: ${path}` };
+        if (!fullPath)
+          return {
+            success: false,
+            error: `Access denied. Only files in ${SAFE_DIRS.join(", ")} are allowed.`
+          };
+        if (!existsSync(fullPath))
+          return { success: false, error: `File not found: ${path}` };
         const content = readFileSync(fullPath, "utf-8");
         return {
           success: true,
@@ -437,9 +666,14 @@ async function handleCommand(command, params) {
       case "sys_file_write": {
         const path = params.path;
         const content = params.content;
-        if (!path || !content) return { success: false, error: "Missing path or content" };
+        if (!path || !content)
+          return { success: false, error: "Missing path or content" };
         const fullPath = safePath(path);
-        if (!fullPath) return { success: false, error: `Access denied. Only files in ${SAFE_DIRS.join(", ")} are allowed.` };
+        if (!fullPath)
+          return {
+            success: false,
+            error: `Access denied. Only files in ${SAFE_DIRS.join(", ")} are allowed.`
+          };
         writeFileSync(fullPath, content, "utf-8");
         return { success: true, data: { path, written: content.length } };
       }
@@ -448,20 +682,33 @@ async function handleCommand(command, params) {
         const pngPath = `/tmp/pulso-ss-${ts}.png`;
         const jpgPath = `/tmp/pulso-ss-${ts}.jpg`;
         await runShell(`screencapture -x ${pngPath}`, 15e3);
-        if (!existsSync(pngPath)) return { success: false, error: "Screenshot failed" };
+        if (!existsSync(pngPath))
+          return { success: false, error: "Screenshot failed" };
         try {
-          await runShell(`sips --resampleWidth 1280 --setProperty format jpeg --setProperty formatOptions 60 ${pngPath} --out ${jpgPath}`, 1e4);
+          await runShell(
+            `sips --resampleWidth 1280 --setProperty format jpeg --setProperty formatOptions 60 ${pngPath} --out ${jpgPath}`,
+            1e4
+          );
         } catch {
           const buf2 = readFileSync(pngPath);
           exec(`rm -f ${pngPath}`);
-          return { success: true, data: { image: `data:image/png;base64,${buf2.toString("base64")}`, format: "png", note: "Full screen screenshot" } };
+          return {
+            success: true,
+            data: {
+              image: `data:image/png;base64,${buf2.toString("base64")}`,
+              format: "png",
+              note: "Full screen screenshot"
+            }
+          };
         }
         const buf = readFileSync(jpgPath);
         const base64 = buf.toString("base64");
         exec(`rm -f ${pngPath} ${jpgPath}`);
         let screenSize = "unknown";
         try {
-          screenSize = await runShell(`system_profiler SPDisplaysDataType 2>/dev/null | grep Resolution | head -1 | sed 's/.*: //'`);
+          screenSize = await runShell(
+            `system_profiler SPDisplaysDataType 2>/dev/null | grep Resolution | head -1 | sed 's/.*: //'`
+          );
         } catch {
         }
         return {
@@ -480,7 +727,8 @@ async function handleCommand(command, params) {
         const x = Number(params.x);
         const y = Number(params.y);
         const button = params.button || "left";
-        if (isNaN(x) || isNaN(y)) return { success: false, error: "Missing x, y coordinates" };
+        if (isNaN(x) || isNaN(y))
+          return { success: false, error: "Missing x, y coordinates" };
         const mouseType = button === "right" ? "rightMouseDown" : "leftMouseDown";
         const mouseTypeUp = button === "right" ? "rightMouseUp" : "leftMouseUp";
         const mouseButton = button === "right" ? ".right" : ".left";
@@ -499,7 +747,8 @@ print("clicked")`;
       case "sys_mouse_double_click": {
         const x = Number(params.x);
         const y = Number(params.y);
-        if (isNaN(x) || isNaN(y)) return { success: false, error: "Missing x, y coordinates" };
+        if (isNaN(x) || isNaN(y))
+          return { success: false, error: "Missing x, y coordinates" };
         const swift = `
 import Cocoa
 let p = CGPoint(x: ${x}, y: ${y})
@@ -527,7 +776,8 @@ print("double-clicked")`;
         const y = Number(params.y) || 0;
         const scrollY = Number(params.scrollY) || 0;
         const scrollX = Number(params.scrollX) || 0;
-        if (!scrollY && !scrollX) return { success: false, error: "Missing scrollY or scrollX" };
+        if (!scrollY && !scrollX)
+          return { success: false, error: "Missing scrollY or scrollX" };
         const swift = `
 import Cocoa
 let p = CGPoint(x: ${x}, y: ${y})
@@ -538,12 +788,17 @@ let scroll = CGEvent(scrollWheelEvent2Source: nil, units: .pixel, wheelCount: 2,
 scroll.post(tap: .cghidEventTap)
 print("scrolled")`;
         await runSwift(swift);
-        return { success: true, data: { scrolled: { x, y, scrollY, scrollX } } };
+        return {
+          success: true,
+          data: { scrolled: { x, y, scrollY, scrollX } }
+        };
       }
       case "sys_keyboard_type": {
         const text = params.text;
         if (!text) return { success: false, error: "Missing text" };
-        await runAppleScript(`tell application "System Events" to keystroke "${text.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`);
+        await runAppleScript(
+          `tell application "System Events" to keystroke "${text.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`
+        );
         return { success: true, data: { typed: text.slice(0, 100) } };
       }
       case "sys_key_press": {
@@ -594,19 +849,27 @@ print("scrolled")`;
         const keyCode = keyCodeMap[key.toLowerCase()];
         if (keyCode !== void 0) {
           const using = modStr.length > 0 ? ` using {${modStr.join(", ")}}` : "";
-          await runAppleScript(`tell application "System Events" to key code ${keyCode}${using}`);
+          await runAppleScript(
+            `tell application "System Events" to key code ${keyCode}${using}`
+          );
         } else if (key.length === 1) {
           const using = modStr.length > 0 ? ` using {${modStr.join(", ")}}` : "";
-          await runAppleScript(`tell application "System Events" to keystroke "${key}"${using}`);
+          await runAppleScript(
+            `tell application "System Events" to keystroke "${key}"${using}`
+          );
         } else {
-          return { success: false, error: `Unknown key: ${key}. Use single characters or: enter, tab, escape, delete, space, up, down, left, right, f1-f12, home, end, pageup, pagedown` };
+          return {
+            success: false,
+            error: `Unknown key: ${key}. Use single characters or: enter, tab, escape, delete, space, up, down, left, right, f1-f12, home, end, pageup, pagedown`
+          };
         }
         return { success: true, data: { pressed: key, modifiers } };
       }
       case "sys_mouse_move": {
         const x = Number(params.x);
         const y = Number(params.y);
-        if (isNaN(x) || isNaN(y)) return { success: false, error: "Missing x, y coordinates" };
+        if (isNaN(x) || isNaN(y))
+          return { success: false, error: "Missing x, y coordinates" };
         const swift = `
 import Cocoa
 let p = CGPoint(x: ${x}, y: ${y})
@@ -621,7 +884,8 @@ print("moved")`;
         const fromY = Number(params.fromY);
         const toX = Number(params.toX);
         const toY = Number(params.toY);
-        if ([fromX, fromY, toX, toY].some(isNaN)) return { success: false, error: "Missing fromX, fromY, toX, toY" };
+        if ([fromX, fromY, toX, toY].some(isNaN))
+          return { success: false, error: "Missing fromX, fromY, toX, toY" };
         const swift = `
 import Cocoa
 let from = CGPoint(x: ${fromX}, y: ${fromY})
@@ -641,7 +905,12 @@ let u = CGEvent(mouseEventSource: nil, mouseType: .leftMouseUp, mouseCursorPosit
 u.post(tap: .cghidEventTap)
 print("dragged")`;
         await runSwift(swift);
-        return { success: true, data: { dragged: { from: { x: fromX, y: fromY }, to: { x: toX, y: toY } } } };
+        return {
+          success: true,
+          data: {
+            dragged: { from: { x: fromX, y: fromY }, to: { x: toX, y: toY } }
+          }
+        };
       }
       case "sys_get_cursor_position": {
         const swift = `
@@ -659,7 +928,13 @@ print("\\(x),\\(y)")`;
       }
       // ── Browser Automation ─────────────────────────────────
       case "sys_browser_list_tabs": {
-        const browsers = ["Google Chrome", "Safari", "Arc", "Firefox", "Microsoft Edge"];
+        const browsers = [
+          "Google Chrome",
+          "Safari",
+          "Arc",
+          "Firefox",
+          "Microsoft Edge"
+        ];
         const allTabs = [];
         for (const browser of browsers) {
           try {
@@ -683,7 +958,12 @@ print("\\(x),\\(y)")`;
               const tabStr = rest.join("~~~");
               const pairs = tabStr.split("|||").filter(Boolean);
               for (let i = 0; i < pairs.length - 1; i += 2) {
-                allTabs.push({ browser: "Safari", title: pairs[i], url: pairs[i + 1], active: pairs[i + 1] === activeURL.trim() });
+                allTabs.push({
+                  browser: "Safari",
+                  title: pairs[i],
+                  url: pairs[i + 1],
+                  active: pairs[i + 1] === activeURL.trim()
+                });
               }
             } else {
               const tabData = await runAppleScript(`
@@ -701,13 +981,21 @@ print("\\(x),\\(y)")`;
               const tabStr = rest.join("~~~");
               const pairs = tabStr.split("|||").filter(Boolean);
               for (let i = 0; i < pairs.length - 1; i += 2) {
-                allTabs.push({ browser, title: pairs[i], url: pairs[i + 1], active: pairs[i + 1] === activeURL.trim() });
+                allTabs.push({
+                  browser,
+                  title: pairs[i],
+                  url: pairs[i + 1],
+                  active: pairs[i + 1] === activeURL.trim()
+                });
               }
             }
           } catch {
           }
         }
-        return { success: true, data: { tabs: allTabs, count: allTabs.length } };
+        return {
+          success: true,
+          data: { tabs: allTabs, count: allTabs.length }
+        };
       }
       case "sys_browser_navigate": {
         const url = params.url;
@@ -735,7 +1023,10 @@ print("\\(x),\\(y)")`;
           }
           return { success: true, data: { navigated: url, browser } };
         } catch (err) {
-          return { success: false, error: `Failed to navigate: ${err.message}` };
+          return {
+            success: false,
+            error: `Failed to navigate: ${err.message}`
+          };
         }
       }
       case "sys_browser_new_tab": {
@@ -758,7 +1049,10 @@ print("\\(x),\\(y)")`;
           }
           return { success: true, data: { opened: url, browser } };
         } catch (err) {
-          return { success: false, error: `Failed to open tab: ${err.message}` };
+          return {
+            success: false,
+            error: `Failed to open tab: ${err.message}`
+          };
         }
       }
       case "sys_browser_read_page": {
@@ -784,32 +1078,53 @@ print("\\(x),\\(y)")`;
           }
         } catch {
           try {
-            const savedClipboard = await runShell("pbpaste 2>/dev/null || true");
-            await runAppleScript(`tell application "${browser.replace(/"/g, '\\"')}" to activate`);
+            const savedClipboard = await runShell(
+              "pbpaste 2>/dev/null || true"
+            );
+            await runAppleScript(
+              `tell application "${browser.replace(/"/g, '\\"')}" to activate`
+            );
             await new Promise((r) => setTimeout(r, 300));
-            await runAppleScript('tell application "System Events" to keystroke "a" using command down');
+            await runAppleScript(
+              'tell application "System Events" to keystroke "a" using command down'
+            );
             await new Promise((r) => setTimeout(r, 200));
-            await runAppleScript('tell application "System Events" to keystroke "c" using command down');
+            await runAppleScript(
+              'tell application "System Events" to keystroke "c" using command down'
+            );
             await new Promise((r) => setTimeout(r, 300));
             content = await runShell("pbpaste");
             method = "clipboard";
-            await runAppleScript('tell application "System Events" to key code 53');
+            await runAppleScript(
+              'tell application "System Events" to key code 53'
+            );
             if (savedClipboard && savedClipboard !== content) {
               execSync(`echo ${JSON.stringify(savedClipboard)} | pbcopy`);
             }
           } catch (clipErr) {
-            return { success: false, error: `Could not read page. Enable 'Allow JavaScript from Apple Events' in ${browser} or grant Accessibility permission. Error: ${clipErr.message}` };
+            return {
+              success: false,
+              error: `Could not read page. Enable 'Allow JavaScript from Apple Events' in ${browser} or grant Accessibility permission. Error: ${clipErr.message}`
+            };
           }
         }
         let pageUrl = "";
         let pageTitle = "";
         try {
           if (browser === "Safari") {
-            pageUrl = await runAppleScript('tell application "Safari" to return URL of front document');
-            pageTitle = await runAppleScript('tell application "Safari" to return name of front document');
+            pageUrl = await runAppleScript(
+              'tell application "Safari" to return URL of front document'
+            );
+            pageTitle = await runAppleScript(
+              'tell application "Safari" to return name of front document'
+            );
           } else {
-            pageUrl = await runAppleScript(`tell application "${browser.replace(/"/g, '\\"')}" to return URL of active tab of front window`);
-            pageTitle = await runAppleScript(`tell application "${browser.replace(/"/g, '\\"')}" to return title of active tab of front window`);
+            pageUrl = await runAppleScript(
+              `tell application "${browser.replace(/"/g, '\\"')}" to return URL of active tab of front window`
+            );
+            pageTitle = await runAppleScript(
+              `tell application "${browser.replace(/"/g, '\\"')}" to return title of active tab of front window`
+            );
           }
         } catch {
         }
@@ -832,13 +1147,20 @@ print("\\(x),\\(y)")`;
         try {
           let result;
           if (browser === "Safari") {
-            result = await runAppleScript(`tell application "Safari" to do JavaScript ${JSON.stringify(js)} in front document`);
+            result = await runAppleScript(
+              `tell application "Safari" to do JavaScript ${JSON.stringify(js)} in front document`
+            );
           } else {
-            result = await runAppleScript(`tell application "${browser.replace(/"/g, '\\"')}" to execute javascript ${JSON.stringify(js)} in active tab of front window`);
+            result = await runAppleScript(
+              `tell application "${browser.replace(/"/g, '\\"')}" to execute javascript ${JSON.stringify(js)} in active tab of front window`
+            );
           }
           return { success: true, data: { result: result.slice(0, 5e3) } };
         } catch (err) {
-          return { success: false, error: `JS execution failed (enable 'Allow JavaScript from Apple Events' in browser): ${err.message}` };
+          return {
+            success: false,
+            error: `JS execution failed (enable 'Allow JavaScript from Apple Events' in browser): ${err.message}`
+          };
         }
       }
       // ── Email ──────────────────────────────────────────────
@@ -847,11 +1169,20 @@ print("\\(x),\\(y)")`;
         const subject = params.subject;
         const body = params.body;
         const method = params.method || "mail";
-        if (!to || !subject || !body) return { success: false, error: "Missing to, subject, or body" };
+        if (!to || !subject || !body)
+          return { success: false, error: "Missing to, subject, or body" };
         if (method === "gmail") {
           const gmailUrl = `https://mail.google.com/mail/u/0/?view=cm&fs=1&to=${encodeURIComponent(to)}&su=${encodeURIComponent(subject)}&body=${encodeURIComponent(body)}`;
           await runShell(`open "${gmailUrl}"`);
-          return { success: true, data: { method: "gmail", to, subject, note: "Gmail compose opened. User needs to click Send." } };
+          return {
+            success: true,
+            data: {
+              method: "gmail",
+              to,
+              subject,
+              note: "Gmail compose opened. User needs to click Send."
+            }
+          };
         }
         try {
           await runAppleScript(`
@@ -862,11 +1193,22 @@ print("\\(x),\\(y)")`;
               end tell
               send newMessage
             end tell`);
-          return { success: true, data: { method: "mail", to, subject, sent: true } };
+          return {
+            success: true,
+            data: { method: "mail", to, subject, sent: true }
+          };
         } catch (err) {
           const gmailUrl = `https://mail.google.com/mail/u/0/?view=cm&fs=1&to=${encodeURIComponent(to)}&su=${encodeURIComponent(subject)}&body=${encodeURIComponent(body)}`;
           await runShell(`open "${gmailUrl}"`);
-          return { success: true, data: { method: "gmail_fallback", to, subject, note: `Mail.app failed (${err.message}). Gmail compose opened instead.` } };
+          return {
+            success: true,
+            data: {
+              method: "gmail_fallback",
+              to,
+              subject,
+              note: `Mail.app failed (${err.message}). Gmail compose opened instead.`
+            }
+          };
         }
       }
       case "sys_run_shortcut": {
@@ -874,21 +1216,44 @@ print("\\(x),\\(y)")`;
         const input = params.input;
         if (!name) return { success: false, error: "Missing shortcut name" };
         const inputFlag = input ? `--input-type text --input "${input.replace(/"/g, '\\"')}"` : "";
-        const result = await runShell(`shortcuts run "${name.replace(/"/g, '\\"')}" ${inputFlag}`, 3e4);
-        return { success: true, data: { shortcut: name, output: result || "Shortcut executed" } };
+        const result = await runShell(
+          `shortcuts run "${name.replace(/"/g, '\\"')}" ${inputFlag}`,
+          3e4
+        );
+        return {
+          success: true,
+          data: { shortcut: name, output: result || "Shortcut executed" }
+        };
       }
       // ── Shell Execution ─────────────────────────────────────
       case "sys_shell": {
         const cmd = params.command;
         if (!cmd) return { success: false, error: "Missing command" };
-        const blocked = ["rm -rf /", "mkfs", "dd if=", "> /dev/", ":(){ :|:& };:"];
-        if (blocked.some((b) => cmd.includes(b))) return { success: false, error: "Command blocked for safety" };
+        const blocked = [
+          "rm -rf /",
+          "mkfs",
+          "dd if=",
+          "> /dev/",
+          ":(){ :|:& };:"
+        ];
+        if (blocked.some((b) => cmd.includes(b)))
+          return { success: false, error: "Command blocked for safety" };
         const timeout = Number(params.timeout) || 15e3;
         try {
           const output = await runShell(cmd, timeout);
-          return { success: true, data: { command: cmd, output: output.slice(0, 1e4), truncated: output.length > 1e4 } };
+          return {
+            success: true,
+            data: {
+              command: cmd,
+              output: output.slice(0, 1e4),
+              truncated: output.length > 1e4
+            }
+          };
         } catch (err) {
-          return { success: false, error: `Shell error: ${err.message.slice(0, 2e3)}` };
+          return {
+            success: false,
+            error: `Shell error: ${err.message.slice(0, 2e3)}`
+          };
         }
       }
       // ── Calendar ────────────────────────────────────────────
@@ -912,9 +1277,17 @@ print("\\(x),\\(y)")`;
         const raw = await runAppleScript(script);
         const events = raw.split("\n").filter(Boolean).map((line) => {
           const [cal, summary, start, end] = line.split(" | ");
-          return { calendar: cal?.trim(), summary: summary?.trim(), start: start?.trim(), end: end?.trim() };
+          return {
+            calendar: cal?.trim(),
+            summary: summary?.trim(),
+            start: start?.trim(),
+            end: end?.trim()
+          };
         });
-        return { success: true, data: { events, count: events.length, daysAhead: days } };
+        return {
+          success: true,
+          data: { events, count: events.length, daysAhead: days }
+        };
       }
       case "sys_calendar_create": {
         const summary = params.summary || params.title;
@@ -922,7 +1295,8 @@ print("\\(x),\\(y)")`;
         const endStr = params.end;
         const calendar = params.calendar || "";
         const notes = params.notes || "";
-        if (!summary || !startStr) return { success: false, error: "Missing summary or start time" };
+        if (!summary || !startStr)
+          return { success: false, error: "Missing summary or start time" };
         const calTarget = calendar ? `calendar "${calendar.replace(/"/g, '\\"')}"` : "default calendar";
         const endPart = endStr ? `set end date of newEvent to date "${endStr}"` : "";
         const notesPart = notes ? `set description of newEvent to "${notes.replace(/"/g, '\\"')}"` : "";
@@ -934,7 +1308,10 @@ print("\\(x),\\(y)")`;
               ${notesPart}
             end tell
           end tell`);
-        return { success: true, data: { created: summary, start: startStr, end: endStr || "auto" } };
+        return {
+          success: true,
+          data: { created: summary, start: startStr, end: endStr || "auto" }
+        };
       }
       // ── Reminders ───────────────────────────────────────────
       case "sys_reminder_list": {
@@ -958,18 +1335,33 @@ print("\\(x),\\(y)")`;
           const raw = await runAppleScript(script);
           const reminders = raw.split("\n").filter(Boolean).map((line) => {
             const parts = line.split(" | ");
-            return parts.length === 3 ? { list: parts[0]?.trim(), name: parts[1]?.trim(), due: parts[2]?.trim() } : { name: parts[0]?.trim(), due: parts[1]?.trim() };
+            return parts.length === 3 ? {
+              list: parts[0]?.trim(),
+              name: parts[1]?.trim(),
+              due: parts[2]?.trim()
+            } : { name: parts[0]?.trim(), due: parts[1]?.trim() };
           });
-          return { success: true, data: { reminders, count: reminders.length } };
+          return {
+            success: true,
+            data: { reminders, count: reminders.length }
+          };
         } catch {
-          return { success: true, data: { reminders: [], count: 0, note: "No reminders or Reminders app not accessible" } };
+          return {
+            success: true,
+            data: {
+              reminders: [],
+              count: 0,
+              note: "No reminders or Reminders app not accessible"
+            }
+          };
         }
       }
       case "sys_reminder_create": {
         const reminderName = params.name;
         const dueDate = params.due;
         const listName2 = params.list || "Reminders";
-        if (!reminderName) return { success: false, error: "Missing reminder name" };
+        if (!reminderName)
+          return { success: false, error: "Missing reminder name" };
         const duePart = dueDate ? `, due date:date "${dueDate}"` : "";
         await runAppleScript(`
           tell application "Reminders"
@@ -977,20 +1369,34 @@ print("\\(x),\\(y)")`;
               make new reminder with properties {name:"${reminderName.replace(/"/g, '\\"')}"${duePart}}
             end tell
           end tell`);
-        return { success: true, data: { created: reminderName, due: dueDate || "none", list: listName2 } };
+        return {
+          success: true,
+          data: {
+            created: reminderName,
+            due: dueDate || "none",
+            list: listName2
+          }
+        };
       }
       // ── iMessage ────────────────────────────────────────────
       case "sys_imessage_send": {
         const to2 = params.to;
         const msg = params.message;
-        if (!to2 || !msg) return { success: false, error: "Missing 'to' (phone/email) or 'message'" };
+        if (!to2 || !msg)
+          return {
+            success: false,
+            error: "Missing 'to' (phone/email) or 'message'"
+          };
         await runAppleScript(`
           tell application "Messages"
             set targetService to 1st account whose service type = iMessage
             set targetBuddy to participant "${to2.replace(/"/g, '\\"')}" of targetService
             send "${msg.replace(/"/g, '\\"')}" to targetBuddy
           end tell`);
-        return { success: true, data: { sent: true, to: to2, message: msg.slice(0, 100) } };
+        return {
+          success: true,
+          data: { sent: true, to: to2, message: msg.slice(0, 100) }
+        };
       }
       // ── System Info ─────────────────────────────────────────
       case "sys_system_info": {
@@ -1001,7 +1407,9 @@ print("\\(x),\\(y)")`;
           info.battery = "N/A";
         }
         try {
-          info.wifi = (await runShell("networksetup -getairportnetwork en0 2>/dev/null | cut -d: -f2")).trim();
+          info.wifi = (await runShell(
+            "networksetup -getairportnetwork en0 2>/dev/null | cut -d: -f2"
+          )).trim();
         } catch {
           info.wifi = "N/A";
         }
@@ -1016,7 +1424,9 @@ print("\\(x),\\(y)")`;
           info.ip_public = "N/A";
         }
         try {
-          info.disk = (await runShell(`df -h / | tail -1 | awk '{print $3 " used / " $2 " total (" $5 " used)"}'`)).trim();
+          info.disk = (await runShell(
+            `df -h / | tail -1 | awk '{print $3 " used / " $2 " total (" $5 " used)"}'`
+          )).trim();
         } catch {
           info.disk = "N/A";
         }
@@ -1055,7 +1465,9 @@ print("\\(x),\\(y)")`;
           await runAppleScript(`set volume output volume ${vol}`);
           return { success: true, data: { volume: vol } };
         }
-        const raw2 = await runAppleScript("output volume of (get volume settings)");
+        const raw2 = await runAppleScript(
+          "output volume of (get volume settings)"
+        );
         return { success: true, data: { volume: Number(raw2) || 0 } };
       }
       // ── Brightness ──────────────────────────────────────────
@@ -1063,14 +1475,27 @@ print("\\(x),\\(y)")`;
         const level2 = params.level;
         if (level2 !== void 0) {
           const br = Math.max(0, Math.min(1, Number(level2)));
-          await runShell(`brightness ${br} 2>/dev/null || osascript -e 'tell application "System Events" to tell appearance preferences to set dark mode to ${br < 0.3}'`);
+          await runShell(
+            `brightness ${br} 2>/dev/null || osascript -e 'tell application "System Events" to tell appearance preferences to set dark mode to ${br < 0.3}'`
+          );
           return { success: true, data: { brightness: br } };
         }
         try {
-          const raw3 = await runShell("brightness -l 2>/dev/null | grep brightness | head -1 | awk '{print $NF}'");
-          return { success: true, data: { brightness: parseFloat(raw3) || 0.5 } };
+          const raw3 = await runShell(
+            "brightness -l 2>/dev/null | grep brightness | head -1 | awk '{print $NF}'"
+          );
+          return {
+            success: true,
+            data: { brightness: parseFloat(raw3) || 0.5 }
+          };
         } catch {
-          return { success: true, data: { brightness: "unknown", note: "Install 'brightness' via brew for control" } };
+          return {
+            success: true,
+            data: {
+              brightness: "unknown",
+              note: "Install 'brightness' via brew for control"
+            }
+          };
         }
       }
       // ── Do Not Disturb ──────────────────────────────────────
@@ -1078,49 +1503,79 @@ print("\\(x),\\(y)")`;
         const enabled = params.enabled;
         if (enabled !== void 0) {
           try {
-            await runShell(`shortcuts run "Toggle Do Not Disturb" 2>/dev/null || osascript -e 'do shell script "defaults write com.apple.ncprefs dnd_prefs -data 0"'`);
-            return { success: true, data: { dnd: enabled, note: "DND toggled" } };
+            await runShell(
+              `shortcuts run "Toggle Do Not Disturb" 2>/dev/null || osascript -e 'do shell script "defaults write com.apple.ncprefs dnd_prefs -data 0"'`
+            );
+            return {
+              success: true,
+              data: { dnd: enabled, note: "DND toggled" }
+            };
           } catch {
-            return { success: true, data: { dnd: enabled, note: "Set DND manually in Control Center" } };
+            return {
+              success: true,
+              data: {
+                dnd: enabled,
+                note: "Set DND manually in Control Center"
+              }
+            };
           }
         }
-        return { success: true, data: { note: "Pass enabled: true/false to toggle DND" } };
+        return {
+          success: true,
+          data: { note: "Pass enabled: true/false to toggle DND" }
+        };
       }
       // ── File Management ─────────────────────────────────────
       case "sys_file_list": {
         const dirPath = params.path || "Desktop";
         const fullDir = safePath(dirPath);
-        if (!fullDir) return { success: false, error: `Access denied: ${dirPath}` };
-        if (!existsSync(fullDir)) return { success: false, error: `Directory not found: ${dirPath}` };
+        if (!fullDir)
+          return { success: false, error: `Access denied: ${dirPath}` };
+        if (!existsSync(fullDir))
+          return { success: false, error: `Directory not found: ${dirPath}` };
         const entries = readdirSync(fullDir).map((name) => {
           try {
             const st = statSync(join(fullDir, name));
-            return { name, type: st.isDirectory() ? "dir" : "file", size: st.size, modified: st.mtime.toISOString() };
+            return {
+              name,
+              type: st.isDirectory() ? "dir" : "file",
+              size: st.size,
+              modified: st.mtime.toISOString()
+            };
           } catch {
             return { name, type: "unknown", size: 0, modified: "" };
           }
         });
-        return { success: true, data: { path: dirPath, entries, count: entries.length } };
+        return {
+          success: true,
+          data: { path: dirPath, entries, count: entries.length }
+        };
       }
       case "sys_file_move": {
         const src = params.from;
         const dst = params.to;
-        if (!src || !dst) return { success: false, error: "Missing from/to paths" };
+        if (!src || !dst)
+          return { success: false, error: "Missing from/to paths" };
         const fullSrc = safePath(src);
         const fullDst = safePath(dst);
-        if (!fullSrc || !fullDst) return { success: false, error: "Access denied" };
-        if (!existsSync(fullSrc)) return { success: false, error: `Source not found: ${src}` };
+        if (!fullSrc || !fullDst)
+          return { success: false, error: "Access denied" };
+        if (!existsSync(fullSrc))
+          return { success: false, error: `Source not found: ${src}` };
         renameSync(fullSrc, fullDst);
         return { success: true, data: { moved: src, to: dst } };
       }
       case "sys_file_copy": {
         const src2 = params.from;
         const dst2 = params.to;
-        if (!src2 || !dst2) return { success: false, error: "Missing from/to paths" };
+        if (!src2 || !dst2)
+          return { success: false, error: "Missing from/to paths" };
         const fullSrc2 = safePath(src2);
         const fullDst2 = safePath(dst2);
-        if (!fullSrc2 || !fullDst2) return { success: false, error: "Access denied" };
-        if (!existsSync(fullSrc2)) return { success: false, error: `Source not found: ${src2}` };
+        if (!fullSrc2 || !fullDst2)
+          return { success: false, error: "Access denied" };
+        if (!existsSync(fullSrc2))
+          return { success: false, error: `Source not found: ${src2}` };
         copyFileSync(fullSrc2, fullDst2);
         return { success: true, data: { copied: src2, to: dst2 } };
       }
@@ -1129,16 +1584,23 @@ print("\\(x),\\(y)")`;
         if (!target) return { success: false, error: "Missing path" };
         const fullTarget = safePath(target);
         if (!fullTarget) return { success: false, error: "Access denied" };
-        if (!existsSync(fullTarget)) return { success: false, error: `Not found: ${target}` };
-        await runShell(`osascript -e 'tell application "Finder" to delete POSIX file "${fullTarget}"'`);
-        return { success: true, data: { deleted: target, method: "moved_to_trash" } };
+        if (!existsSync(fullTarget))
+          return { success: false, error: `Not found: ${target}` };
+        await runShell(
+          `osascript -e 'tell application "Finder" to delete POSIX file "${fullTarget}"'`
+        );
+        return {
+          success: true,
+          data: { deleted: target, method: "moved_to_trash" }
+        };
       }
       case "sys_file_info": {
         const fPath = params.path;
         if (!fPath) return { success: false, error: "Missing path" };
         const fullF = safePath(fPath);
         if (!fullF) return { success: false, error: "Access denied" };
-        if (!existsSync(fullF)) return { success: false, error: `Not found: ${fPath}` };
+        if (!existsSync(fullF))
+          return { success: false, error: `Not found: ${fPath}` };
         const st = statSync(fullF);
         return {
           success: true,
@@ -1161,9 +1623,15 @@ print("\\(x),\\(y)")`;
         if (!dlUrl) return { success: false, error: "Missing URL" };
         const fullDl = safePath(dlDest);
         if (!fullDl) return { success: false, error: "Access denied" };
-        await runShell(`curl -sL -o "${fullDl}" "${dlUrl.replace(/"/g, '\\"')}"`, 6e4);
+        await runShell(
+          `curl -sL -o "${fullDl}" "${dlUrl.replace(/"/g, '\\"')}"`,
+          6e4
+        );
         const size = existsSync(fullDl) ? statSync(fullDl).size : 0;
-        return { success: true, data: { downloaded: dlUrl, saved: dlDest, size } };
+        return {
+          success: true,
+          data: { downloaded: dlUrl, saved: dlDest, size }
+        };
       }
       // ── Window Management ───────────────────────────────────
       case "sys_window_list": {
@@ -1180,7 +1648,12 @@ print("\\(x),\\(y)")`;
           end tell`);
         const windows = raw4.split("\n").filter(Boolean).map((line) => {
           const [app, title, pos, sz] = line.split(" | ");
-          return { app: app?.trim(), title: title?.trim(), position: pos?.trim(), size: sz?.trim() };
+          return {
+            app: app?.trim(),
+            title: title?.trim(),
+            position: pos?.trim(),
+            size: sz?.trim()
+          };
         });
         return { success: true, data: { windows, count: windows.length } };
       }
@@ -1203,7 +1676,11 @@ print("\\(x),\\(y)")`;
         if (!app2) return { success: false, error: "Missing app name" };
         const posPart = x !== void 0 && y !== void 0 ? `set position of window 1 to {${x}, ${y}}` : "";
         const sizePart = w !== void 0 && h !== void 0 ? `set size of window 1 to {${w}, ${h}}` : "";
-        if (!posPart && !sizePart) return { success: false, error: "Provide x,y for position and/or width,height for size" };
+        if (!posPart && !sizePart)
+          return {
+            success: false,
+            error: "Provide x,y for position and/or width,height for size"
+          };
         await runAppleScript(`
           tell application "System Events"
             tell process "${app2.replace(/"/g, '\\"')}"
@@ -1211,7 +1688,14 @@ print("\\(x),\\(y)")`;
               ${sizePart}
             end tell
           end tell`);
-        return { success: true, data: { app: app2, position: posPart ? { x, y } : "unchanged", size: sizePart ? { width: w, height: h } : "unchanged" } };
+        return {
+          success: true,
+          data: {
+            app: app2,
+            position: posPart ? { x, y } : "unchanged",
+            size: sizePart ? { width: w, height: h } : "unchanged"
+          }
+        };
       }
       // ── Apple Notes ─────────────────────────────────────────
       case "sys_notes_list": {
@@ -1227,7 +1711,11 @@ print("\\(x),\\(y)")`;
           end tell`);
         const notes = raw5.split("\n").filter(Boolean).map((line) => {
           const [id, name, date] = line.split(" | ");
-          return { id: id?.trim(), name: name?.trim(), modified: date?.trim() };
+          return {
+            id: id?.trim(),
+            name: name?.trim(),
+            modified: date?.trim()
+          };
         });
         return { success: true, data: { notes, count: notes.length } };
       }
@@ -1267,9 +1755,16 @@ print("\\(x),\\(y)")`;
           end tell`);
         const contacts = raw6.split("\n").filter(Boolean).map((line) => {
           const [name, email, phone] = line.split(" | ");
-          return { name: name?.trim(), email: email?.trim(), phone: phone?.trim() };
+          return {
+            name: name?.trim(),
+            email: email?.trim(),
+            phone: phone?.trim()
+          };
         });
-        return { success: true, data: { contacts, count: contacts.length, query: query2 } };
+        return {
+          success: true,
+          data: { contacts, count: contacts.length, query: query2 }
+        };
       }
       // ── OCR (Vision framework) ──────────────────────────────
       case "sys_ocr": {
@@ -1277,7 +1772,8 @@ print("\\(x),\\(y)")`;
         if (!imgPath) return { success: false, error: "Missing image path" };
         const fullImg = imgPath.startsWith("/tmp/") ? imgPath : safePath(imgPath);
         if (!fullImg) return { success: false, error: "Access denied" };
-        if (!existsSync(fullImg)) return { success: false, error: `Image not found: ${imgPath}` };
+        if (!existsSync(fullImg))
+          return { success: false, error: `Image not found: ${imgPath}` };
         const swiftOcr = `
 import Foundation
 import Vision
@@ -1299,10 +1795,311 @@ let text = results.compactMap { $0.topCandidates(1).first?.string }.joined(separ
 print(text)`;
         try {
           const ocrText = await runSwift(swiftOcr, 3e4);
-          return { success: true, data: { text: ocrText.slice(0, 1e4), length: ocrText.length, path: imgPath } };
+          return {
+            success: true,
+            data: {
+              text: ocrText.slice(0, 1e4),
+              length: ocrText.length,
+              path: imgPath
+            }
+          };
         } catch (err) {
-          return { success: false, error: `OCR failed: ${err.message}` };
+          return {
+            success: false,
+            error: `OCR failed: ${err.message}`
+          };
+        }
+      }
+      // ── Philips Hue (Local Bridge API) ─────────────────────
+      // Commands are prefixed with sys_hue_ (mapped from hue_ in chat.ts → system_hue_ → sys_hue_)
+      case "sys_hue_lights_on": {
+        const light = params.light;
+        if (!light)
+          return { success: false, error: "Missing light ID or name" };
+        const hueConfig = await getHueConfig();
+        if (!hueConfig)
+          return {
+            success: false,
+            error: "Philips Hue not configured. Set HUE_BRIDGE_IP and HUE_USERNAME environment variables, or configure in Pulso Settings."
+          };
+        const lightId = await resolveHueLight(hueConfig, light);
+        if (!lightId)
+          return {
+            success: false,
+            error: `Light '${light}' not found on Hue bridge`
+          };
+        const state = { on: true };
+        if (params.brightness !== void 0)
+          state.bri = Math.max(1, Math.min(254, Number(params.brightness)));
+        if (params.color) {
+          const rgb = parseColorCompanion(params.color);
+          if (rgb) {
+            const [x, y] = rgbToXyCompanion(...rgb);
+            state.xy = [x, y];
+          }
+        }
+        const hueRes = await hueRequest(
+          hueConfig,
+          `lights/${lightId}/state`,
+          "PUT",
+          state
+        );
+        return {
+          success: true,
+          data: { light: lightId, action: "on", ...state, response: hueRes }
+        };
+      }
+      case "sys_hue_lights_off": {
+        const light = params.light;
+        if (!light)
+          return { success: false, error: "Missing light ID or name" };
+        const hueConfig = await getHueConfig();
+        if (!hueConfig)
+          return { success: false, error: "Philips Hue not configured." };
+        const lightId = await resolveHueLight(hueConfig, light);
+        if (!lightId)
+          return { success: false, error: `Light '${light}' not found` };
+        const hueRes = await hueRequest(
+          hueConfig,
+          `lights/${lightId}/state`,
+          "PUT",
+          { on: false }
+        );
+        return {
+          success: true,
+          data: { light: lightId, action: "off", response: hueRes }
+        };
+      }
+      case "sys_hue_lights_color": {
+        const light = params.light;
+        const color = params.color;
+        if (!light || !color)
+          return { success: false, error: "Missing light or color" };
+        const hueConfig = await getHueConfig();
+        if (!hueConfig)
+          return { success: false, error: "Philips Hue not configured." };
+        const lightId = await resolveHueLight(hueConfig, light);
+        if (!lightId)
+          return { success: false, error: `Light '${light}' not found` };
+        const rgb = parseColorCompanion(color);
+        if (!rgb)
+          return { success: false, error: `Unrecognized color: ${color}` };
+        const [x, y] = rgbToXyCompanion(...rgb);
+        const hueRes = await hueRequest(
+          hueConfig,
+          `lights/${lightId}/state`,
+          "PUT",
+          { on: true, xy: [x, y] }
+        );
+        return {
+          success: true,
+          data: { light: lightId, color, xy: [x, y], response: hueRes }
+        };
+      }
+      case "sys_hue_lights_brightness": {
+        const light = params.light;
+        const brightness = Number(params.brightness);
+        if (!light || isNaN(brightness))
+          return { success: false, error: "Missing light or brightness" };
+        const hueConfig = await getHueConfig();
+        if (!hueConfig)
+          return { success: false, error: "Philips Hue not configured." };
+        const lightId = await resolveHueLight(hueConfig, light);
+        if (!lightId)
+          return { success: false, error: `Light '${light}' not found` };
+        const bri = Math.max(1, Math.min(254, brightness));
+        const hueRes = await hueRequest(
+          hueConfig,
+          `lights/${lightId}/state`,
+          "PUT",
+          { on: true, bri }
+        );
+        return {
+          success: true,
+          data: { light: lightId, brightness: bri, response: hueRes }
+        };
+      }
+      case "sys_hue_lights_scene": {
+        const scene = params.scene;
+        const group = params.group || "0";
+        if (!scene) return { success: false, error: "Missing scene name" };
+        const hueConfig = await getHueConfig();
+        if (!hueConfig)
+          return { success: false, error: "Philips Hue not configured." };
+        const scenes = await hueRequest(hueConfig, "scenes", "GET");
+        let sceneId = null;
+        for (const [id, s] of Object.entries(scenes)) {
+          if (s.name?.toLowerCase() === scene.toLowerCase()) {
+            sceneId = id;
+            break;
+          }
         }
+        if (!sceneId)
+          return {
+            success: false,
+            error: `Scene '${scene}' not found. Available: ${Object.values(
+              scenes
+            ).map((s) => s.name).join(", ")}`
+          };
+        const hueRes = await hueRequest(
+          hueConfig,
+          `groups/${group}/action`,
+          "PUT",
+          { scene: sceneId }
+        );
+        return {
+          success: true,
+          data: { scene, sceneId, group, response: hueRes }
+        };
+      }
+      case "sys_hue_lights_list": {
+        const hueConfig = await getHueConfig();
+        if (!hueConfig)
+          return { success: false, error: "Philips Hue not configured." };
+        const [lights, groups, scenes] = await Promise.all([
+          hueRequest(hueConfig, "lights", "GET"),
+          hueRequest(hueConfig, "groups", "GET"),
+          hueRequest(hueConfig, "scenes", "GET")
+        ]);
+        return {
+          success: true,
+          data: {
+            lights: Object.entries(lights).map(([id, l]) => ({
+              id,
+              name: l.name,
+              on: l.state?.on,
+              brightness: l.state?.bri,
+              type: l.type
+            })),
+            groups: Object.entries(groups).map(([id, g]) => ({
+              id,
+              name: g.name,
+              type: g.type,
+              lightCount: g.lights?.length
+            })),
+            scenes: Object.entries(scenes).map(([id, s]) => ({
+              id,
+              name: s.name,
+              group: s.group
+            }))
+          }
+        };
+      }
+      // ── Sonos (Local HTTP API) ──────────────────────────────
+      case "sys_sonos_play": {
+        const room = params.room;
+        if (!room) return { success: false, error: "Missing room name" };
+        const sonosUrl = getSonosApiUrl();
+        if (!sonosUrl)
+          return {
+            success: false,
+            error: "Sonos not configured. Set SONOS_API_URL environment variable (e.g., http://localhost:5005)."
+          };
+        const res = await sonosRequest(
+          sonosUrl,
+          `${encodeURIComponent(room)}/play`
+        );
+        return { success: true, data: { room, action: "play", response: res } };
+      }
+      case "sys_sonos_pause": {
+        const room = params.room;
+        if (!room) return { success: false, error: "Missing room name" };
+        const sonosUrl = getSonosApiUrl();
+        if (!sonosUrl)
+          return { success: false, error: "Sonos not configured." };
+        const res = await sonosRequest(
+          sonosUrl,
+          `${encodeURIComponent(room)}/pause`
+        );
+        return {
+          success: true,
+          data: { room, action: "pause", response: res }
+        };
+      }
+      case "sys_sonos_volume": {
+        const room = params.room;
+        const level = Number(params.level);
+        if (!room || isNaN(level))
+          return { success: false, error: "Missing room or level" };
+        const sonosUrl = getSonosApiUrl();
+        if (!sonosUrl)
+          return { success: false, error: "Sonos not configured." };
+        const vol = Math.max(0, Math.min(100, level));
+        const res = await sonosRequest(
+          sonosUrl,
+          `${encodeURIComponent(room)}/volume/${vol}`
+        );
+        return { success: true, data: { room, volume: vol, response: res } };
+      }
+      case "sys_sonos_play_uri": {
+        const room = params.room;
+        const uri = params.uri;
+        if (!room || !uri)
+          return { success: false, error: "Missing room or URI" };
+        const sonosUrl = getSonosApiUrl();
+        if (!sonosUrl)
+          return { success: false, error: "Sonos not configured." };
+        if (uri.startsWith("spotify:")) {
+          const res2 = await sonosRequest(
+            sonosUrl,
+            `${encodeURIComponent(room)}/spotify/now/${encodeURIComponent(uri)}`
+          );
+          return {
+            success: true,
+            data: { room, uri, type: "spotify", response: res2 }
+          };
+        }
+        const res = await sonosRequest(
+          sonosUrl,
+          `${encodeURIComponent(room)}/setavtransporturi/${encodeURIComponent(uri)}`
+        );
+        return { success: true, data: { room, uri, response: res } };
+      }
+      case "sys_sonos_rooms": {
+        const sonosUrl = getSonosApiUrl();
+        if (!sonosUrl)
+          return { success: false, error: "Sonos not configured." };
+        const res = await sonosRequest(sonosUrl, "zones");
+        return { success: true, data: res };
+      }
+      case "sys_sonos_next": {
+        const room = params.room;
+        if (!room) return { success: false, error: "Missing room name" };
+        const sonosUrl = getSonosApiUrl();
+        if (!sonosUrl)
+          return { success: false, error: "Sonos not configured." };
+        const res = await sonosRequest(
+          sonosUrl,
+          `${encodeURIComponent(room)}/next`
+        );
+        return { success: true, data: { room, action: "next", response: res } };
+      }
+      case "sys_sonos_previous": {
+        const room = params.room;
+        if (!room) return { success: false, error: "Missing room name" };
+        const sonosUrl = getSonosApiUrl();
+        if (!sonosUrl)
+          return { success: false, error: "Sonos not configured." };
+        const res = await sonosRequest(
+          sonosUrl,
+          `${encodeURIComponent(room)}/previous`
+        );
+        return {
+          success: true,
+          data: { room, action: "previous", response: res }
+        };
+      }
+      case "sys_sonos_now_playing": {
+        const room = params.room;
+        if (!room) return { success: false, error: "Missing room name" };
+        const sonosUrl = getSonosApiUrl();
+        if (!sonosUrl)
+          return { success: false, error: "Sonos not configured." };
+        const res = await sonosRequest(
+          sonosUrl,
+          `${encodeURIComponent(room)}/state`
+        );
+        return { success: true, data: { room, ...res } };
       }
       default:
         return { success: false, error: `Unknown command: ${command}` };
@@ -1311,6 +2108,130 @@ print(text)`;
     return { success: false, error: err.message };
   }
 }
+var HUE_CONFIG_FILE = join(HOME, ".pulso-hue-config.json");
+async function getHueConfig() {
+  const ip = process.env.HUE_BRIDGE_IP;
+  const user = process.env.HUE_USERNAME;
+  if (ip && user) return { bridgeIp: ip, username: user };
+  try {
+    if (existsSync(HUE_CONFIG_FILE)) {
+      const data = JSON.parse(readFileSync(HUE_CONFIG_FILE, "utf-8"));
+      if (data.bridgeIp && data.username) return data;
+    }
+  } catch {
+  }
+  return null;
+}
+async function hueRequest(config, path, method, body) {
+  const url = `http://${config.bridgeIp}/api/${config.username}/${path}`;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 1e4);
+  try {
+    const opts = {
+      method,
+      signal: controller.signal,
+      headers: { "Content-Type": "application/json" }
+    };
+    if (body && method !== "GET") opts.body = JSON.stringify(body);
+    const res = await fetch(url, opts);
+    clearTimeout(timeout);
+    return await res.json();
+  } catch (err) {
+    clearTimeout(timeout);
+    throw new Error(
+      `Hue bridge unreachable at ${config.bridgeIp}: ${err.message}`
+    );
+  }
+}
+var hueLightCache = null;
+var hueLightCacheTs = 0;
+async function resolveHueLight(config, lightRef) {
+  if (/^\d+$/.test(lightRef)) return lightRef;
+  if (!hueLightCache || Date.now() - hueLightCacheTs > 3e5) {
+    try {
+      const lights = await hueRequest(config, "lights", "GET");
+      hueLightCache = /* @__PURE__ */ new Map();
+      for (const [id, light] of Object.entries(lights)) {
+        hueLightCache.set(light.name.toLowerCase(), id);
+      }
+      hueLightCacheTs = Date.now();
+    } catch {
+      return null;
+    }
+  }
+  return hueLightCache.get(lightRef.toLowerCase()) ?? null;
+}
+var CSS_COLORS_COMPANION = {
+  red: [255, 0, 0],
+  green: [0, 128, 0],
+  blue: [0, 0, 255],
+  yellow: [255, 255, 0],
+  orange: [255, 165, 0],
+  purple: [128, 0, 128],
+  pink: [255, 192, 203],
+  white: [255, 255, 255],
+  cyan: [0, 255, 255],
+  magenta: [255, 0, 255],
+  lime: [0, 255, 0],
+  teal: [0, 128, 128],
+  coral: [255, 127, 80],
+  salmon: [250, 128, 114],
+  gold: [255, 215, 0],
+  lavender: [230, 230, 250],
+  turquoise: [64, 224, 208],
+  warmwhite: [255, 200, 150],
+  coolwhite: [200, 220, 255]
+};
+function parseColorCompanion(color) {
+  if (color.startsWith("#")) {
+    const hex = color.slice(1);
+    if (hex.length === 6) {
+      return [
+        parseInt(hex.slice(0, 2), 16),
+        parseInt(hex.slice(2, 4), 16),
+        parseInt(hex.slice(4, 6), 16)
+      ];
+    }
+  }
+  return CSS_COLORS_COMPANION[color.toLowerCase()] ?? null;
+}
+function rgbToXyCompanion(r, g, b) {
+  let rr = r / 255;
+  let gg = g / 255;
+  let bb = b / 255;
+  rr = rr > 0.04045 ? Math.pow((rr + 0.055) / 1.055, 2.4) : rr / 12.92;
+  gg = gg > 0.04045 ? Math.pow((gg + 0.055) / 1.055, 2.4) : gg / 12.92;
+  bb = bb > 0.04045 ? Math.pow((bb + 0.055) / 1.055, 2.4) : bb / 12.92;
+  const X = rr * 0.664511 + gg * 0.154324 + bb * 0.162028;
+  const Y = rr * 0.283881 + gg * 0.668433 + bb * 0.047685;
+  const Z = rr * 88e-6 + gg * 0.07231 + bb * 0.986039;
+  const sum = X + Y + Z;
+  if (sum === 0) return [0.3127, 0.329];
+  return [X / sum, Y / sum];
+}
+function getSonosApiUrl() {
+  return process.env.SONOS_API_URL || null;
+}
+async function sonosRequest(baseUrl, path) {
+  const url = `${baseUrl.replace(/\/$/, "")}/${path}`;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 1e4);
+  try {
+    const res = await fetch(url, { signal: controller.signal });
+    clearTimeout(timeout);
+    const text = await res.text();
+    try {
+      return JSON.parse(text);
+    } catch {
+      return { raw: text };
+    }
+  } catch (err) {
+    clearTimeout(timeout);
+    throw new Error(
+      `Sonos API unreachable at ${baseUrl}: ${err.message}`
+    );
+  }
+}
 var ws = null;
 var reconnectTimer = null;
 var heartbeatTimer = null;
@@ -1323,12 +2244,16 @@ function connect() {
   ws.on("open", () => {
     reconnectAttempts = 0;
     console.log("\u2705 Connected to Pulso!");
-    console.log(`\u{1F5A5}\uFE0F  Companion is active \u2014 ${ACCESS_LEVEL === "full" ? "full device access" : "sandboxed mode"}`);
+    console.log(
+      `\u{1F5A5}\uFE0F  Companion is active \u2014 ${ACCESS_LEVEL === "full" ? "full device access" : "sandboxed mode"}`
+    );
     console.log("");
     console.log("   Available capabilities:");
     console.log("   \u2022 Open apps & URLs");
     console.log("   \u2022 Control Spotify & media");
-    console.log(`   \u2022 Read/write files ${ACCESS_LEVEL === "full" ? "(full device)" : "(Documents, Desktop, Downloads)"}`);
+    console.log(
+      `   \u2022 Read/write files ${ACCESS_LEVEL === "full" ? "(full device)" : "(Documents, Desktop, Downloads)"}`
+    );
     console.log("   \u2022 Clipboard access");
     console.log("   \u2022 Screenshots");
     console.log("   \u2022 Text-to-speech");
@@ -1337,8 +2262,12 @@ function connect() {
     console.log("   \u2022 Terminal commands");
     console.log("   \u2022 System notifications");
     console.log("   \u2022 macOS Shortcuts");
+    console.log("   \u2022 Smart Home: Philips Hue (if configured)");
+    console.log("   \u2022 Smart Home: Sonos (if configured)");
     console.log("");
-    console.log(`   Access: ${ACCESS_LEVEL === "full" ? "\u{1F513} Full (unrestricted)" : "\u{1F512} Sandboxed (safe dirs only)"}`);
+    console.log(
+      `   Access: ${ACCESS_LEVEL === "full" ? "\u{1F513} Full (unrestricted)" : "\u{1F512} Sandboxed (safe dirs only)"}`
+    );
     console.log("   Waiting for commands from Pulso agent...");
     ws.send(JSON.stringify({ type: "extension_ready" }));
     if (heartbeatTimer) clearInterval(heartbeatTimer);
@@ -1359,10 +2288,16 @@ function connect() {
         return;
       }
       if (msg.id && msg.command) {
-        console.log(`
-\u26A1 Command: ${msg.command}`, msg.params ? JSON.stringify(msg.params).slice(0, 200) : "");
+        console.log(
+          `
+\u26A1 Command: ${msg.command}`,
+          msg.params ? JSON.stringify(msg.params).slice(0, 200) : ""
+        );
         const result = await handleCommand(msg.command, msg.params ?? {});
-        console.log(`   \u2192 ${result.success ? "\u2705" : "\u274C"}`, result.success ? JSON.stringify(result.data).slice(0, 200) : result.error);
+        console.log(
+          `   \u2192 ${result.success ? "\u2705" : "\u274C"}`,
+          result.success ? JSON.stringify(result.data).slice(0, 200) : result.error
+        );
         ws.send(JSON.stringify({ id: msg.id, result }));
         return;
       }
@@ -1380,9 +2315,15 @@ function connect() {
       heartbeatTimer = null;
     }
     if (reasonStr === "New connection from same user") {
-      console.log("\n\u26A0\uFE0F  Another Pulso Companion instance is already connected.");
-      console.log("   This instance will exit. Only one companion per account is supported.");
-      console.log("   If this is unexpected, close other terminals running Pulso Companion.\n");
+      console.log(
+        "\n\u26A0\uFE0F  Another Pulso Companion instance is already connected."
+      );
+      console.log(
+        "   This instance will exit. Only one companion per account is supported."
+      );
+      console.log(
+        "   If this is unexpected, close other terminals running Pulso Companion.\n"
+      );
       process.exit(0);
       return;
     }
@@ -1395,29 +2336,209 @@ function connect() {
 function scheduleReconnect() {
   if (reconnectTimer) return;
   reconnectAttempts++;
-  const delay = Math.min(RECONNECT_DELAY * Math.pow(2, reconnectAttempts - 1), 6e4);
-  console.log(`   Reconnecting in ${(delay / 1e3).toFixed(0)}s... (attempt ${reconnectAttempts})`);
+  const delay = Math.min(
+    RECONNECT_DELAY * Math.pow(2, reconnectAttempts - 1),
+    6e4
+  );
+  console.log(
+    `   Reconnecting in ${(delay / 1e3).toFixed(0)}s... (attempt ${reconnectAttempts})`
+  );
   reconnectTimer = setTimeout(() => {
     reconnectTimer = null;
     connect();
   }, delay);
 }
+var wakeWordActive = false;
+async function startWakeWordDetection() {
+  if (!WAKE_WORD_ENABLED) return;
+  if (!PICOVOICE_ACCESS_KEY) {
+    console.log("  \u26A0\uFE0F  Wake word enabled but no Picovoice key provided.");
+    console.log("     Get a free key at https://console.picovoice.ai/");
+    console.log(
+      "     Use: --picovoice-key <key> or PICOVOICE_ACCESS_KEY env var\n"
+    );
+    return;
+  }
+  try {
+    const { Porcupine, BuiltinKeyword } = await import("@picovoice/porcupine-node");
+    const { PvRecorder } = await import("@picovoice/pvrecorder-node");
+    const customKeywordPath = join(HOME, ".pulso-wake-word.ppn");
+    const useCustom = existsSync(customKeywordPath);
+    let porcupine;
+    if (useCustom) {
+      porcupine = new Porcupine(
+        PICOVOICE_ACCESS_KEY,
+        [customKeywordPath],
+        [0.5]
+        // sensitivity
+      );
+      console.log(
+        "  \u{1F3A4} Wake word: custom model loaded from ~/.pulso-wake-word.ppn"
+      );
+    } else {
+      porcupine = new Porcupine(
+        PICOVOICE_ACCESS_KEY,
+        [BuiltinKeyword.HEY_GOOGLE],
+        // Placeholder — replace with custom "Hey Pulso"
+        [0.5]
+      );
+      console.log(
+        '  \u{1F3A4} Wake word: using "Hey Google" as placeholder (create custom "Hey Pulso" at console.picovoice.ai)'
+      );
+    }
+    const frameLength = porcupine.frameLength;
+    const sampleRate = porcupine.sampleRate;
+    const devices = PvRecorder.getAvailableDevices();
+    console.log(`  \u{1F3A4} Audio devices: ${devices.length} found (using default)`);
+    const recorder = new PvRecorder(frameLength, 0);
+    recorder.start();
+    wakeWordActive = true;
+    console.log("  \u{1F3A4} Wake word detection ACTIVE \u2014 listening...\n");
+    const listen = async () => {
+      while (wakeWordActive) {
+        try {
+          const pcm = await recorder.read();
+          const keywordIndex = porcupine.process(pcm);
+          if (keywordIndex >= 0) {
+            console.log("\n  \u{1F5E3}\uFE0F  Wake word detected!");
+            exec("afplay /System/Library/Sounds/Tink.aiff");
+            const audioChunks = [];
+            let silenceFrames = 0;
+            const MAX_SILENCE_FRAMES = Math.ceil(
+              1.5 * sampleRate / frameLength
+            );
+            const MAX_RECORD_FRAMES = Math.ceil(
+              10 * sampleRate / frameLength
+            );
+            let totalFrames = 0;
+            console.log("  \u{1F3A4} Listening for command...");
+            while (totalFrames < MAX_RECORD_FRAMES) {
+              const frame = await recorder.read();
+              audioChunks.push(new Int16Array(frame));
+              totalFrames++;
+              let sum = 0;
+              for (let i = 0; i < frame.length; i++) {
+                sum += frame[i] * frame[i];
+              }
+              const rms = Math.sqrt(sum / frame.length);
+              if (rms < 200) {
+                silenceFrames++;
+                if (silenceFrames >= MAX_SILENCE_FRAMES && totalFrames > 5) {
+                  break;
+                }
+              } else {
+                silenceFrames = 0;
+              }
+            }
+            console.log(
+              `  \u{1F3A4} Captured ${(totalFrames * frameLength / sampleRate).toFixed(1)}s of audio`
+            );
+            const totalSamples = audioChunks.reduce((s, c) => s + c.length, 0);
+            const wavBuffer = createWavBuffer(
+              audioChunks,
+              sampleRate,
+              totalSamples
+            );
+            if (ws && ws.readyState === WebSocket.OPEN) {
+              const base64Audio = Buffer.from(wavBuffer).toString("base64");
+              ws.send(
+                JSON.stringify({
+                  type: "wake_word_audio",
+                  audio: base64Audio,
+                  format: "wav",
+                  sampleRate,
+                  durationMs: Math.round(
+                    totalFrames * frameLength / sampleRate * 1e3
+                  )
+                })
+              );
+              console.log("  \u{1F4E4} Audio sent to server for processing");
+              exec("afplay /System/Library/Sounds/Pop.aiff");
+            } else {
+              console.log("  \u26A0\uFE0F  Not connected to server \u2014 audio discarded");
+            }
+          }
+        } catch (err) {
+          if (wakeWordActive) {
+            console.error("  \u274C Wake word error:", err.message);
+            await new Promise((r) => setTimeout(r, 1e3));
+          }
+        }
+      }
+      recorder.stop();
+      recorder.release();
+      porcupine.release();
+    };
+    listen().catch((err) => {
+      console.error("  \u274C Wake word listener crashed:", err.message);
+      wakeWordActive = false;
+    });
+  } catch (err) {
+    const msg = err.message;
+    if (msg.includes("Cannot find module") || msg.includes("MODULE_NOT_FOUND")) {
+      console.log("  \u26A0\uFE0F  Wake word packages not installed. Run:");
+      console.log(
+        "     npm install @picovoice/porcupine-node @picovoice/pvrecorder-node\n"
+      );
+    } else {
+      console.error("  \u274C Wake word init failed:", msg);
+    }
+  }
+}
+function createWavBuffer(chunks, sampleRate, totalSamples) {
+  const bytesPerSample = 2;
+  const numChannels = 1;
+  const dataSize = totalSamples * bytesPerSample;
+  const buffer = new ArrayBuffer(44 + dataSize);
+  const view = new DataView(buffer);
+  writeString(view, 0, "RIFF");
+  view.setUint32(4, 36 + dataSize, true);
+  writeString(view, 8, "WAVE");
+  writeString(view, 12, "fmt ");
+  view.setUint32(16, 16, true);
+  view.setUint16(20, 1, true);
+  view.setUint16(22, numChannels, true);
+  view.setUint32(24, sampleRate, true);
+  view.setUint32(28, sampleRate * numChannels * bytesPerSample, true);
+  view.setUint16(32, numChannels * bytesPerSample, true);
+  view.setUint16(34, bytesPerSample * 8, true);
+  writeString(view, 36, "data");
+  view.setUint32(40, dataSize, true);
+  let offset = 44;
+  for (const chunk of chunks) {
+    for (let i = 0; i < chunk.length; i++) {
+      view.setInt16(offset, chunk[i], true);
+      offset += 2;
+    }
+  }
+  return buffer;
+}
+function writeString(view, offset, str) {
+  for (let i = 0; i < str.length; i++) {
+    view.setUint8(offset + i, str.charCodeAt(i));
+  }
+}
 console.log("");
 console.log("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
-console.log("  \u2551    \u{1FAC0} Pulso Mac Companion v0.2.1     \u2551");
+console.log("  \u2551    \u{1FAC0} Pulso Mac Companion v0.2.3     \u2551");
 console.log("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D");
 console.log("");
 setupPermissions().then(() => {
   connect();
+  if (WAKE_WORD_ENABLED) {
+    startWakeWordDetection();
+  }
 }).catch(() => {
   connect();
 });
 process.on("SIGINT", () => {
   console.log("\n\u{1F44B} Shutting down Pulso Companion...");
+  wakeWordActive = false;
   ws?.close(1e3, "User shutdown");
   process.exit(0);
 });
 process.on("SIGTERM", () => {
+  wakeWordActive = false;
   ws?.close(1e3, "Process terminated");
   process.exit(0);
 });