@pulso/companion 0.2.4 → 0.3.1

package/dist/index.js

@@ -10,7 +10,8 @@ import {
   readdirSync,
   statSync,
   copyFileSync,
-  renameSync
+  renameSync,
+  unlinkSync
 } from "fs";
 import { homedir } from "os";
 import { join, resolve, basename, extname } from "path";
@@ -43,10 +44,16 @@ function safePath(relative) {
 }
 function runAppleScript(script) {
   return new Promise((resolve2, reject) => {
+    const tmpPath = `/tmp/pulso-as-${Date.now()}-${Math.random().toString(36).slice(2, 6)}.scpt`;
+    writeFileSync(tmpPath, script, "utf-8");
     exec(
-      `osascript -e '${script.replace(/'/g, "'\\''")}'`,
+      `osascript ${tmpPath}`,
       { timeout: 15e3 },
       (err, stdout, stderr) => {
+        try {
+          unlinkSync(tmpPath);
+        } catch {
+        }
         if (err) reject(new Error(stderr || err.message));
         else resolve2(stdout.trim());
       }
@@ -682,13 +689,13 @@ async function handleCommand(command, params) {
         const pngPath = `/tmp/pulso-ss-${ts}.png`;
         const jpgPath = `/tmp/pulso-ss-${ts}.jpg`;
         try {
-          await runShell(`screencapture -x ${pngPath}`, 15e3);
+          await runShell(`screencapture -C -x -D1 ${pngPath}`, 15e3);
         } catch (ssErr) {
           const msg = ssErr.message || "";
           if (msg.includes("could not create image") || msg.includes("display")) {
             return {
               success: false,
-              error: "Screen Recording permission required. Go to System Settings \u2192 Privacy & Security \u2192 Screen Recording \u2192 enable Terminal (or your terminal app)."
+              error: "Screen Recording permission required. Go to System Settings \u2192 Privacy & Security \u2192 Screen Recording \u2192 enable your terminal app (Terminal, iTerm, etc). Then restart the companion."
             };
           }
           return { success: false, error: `Screenshot failed: ${msg}` };
@@ -696,7 +703,7 @@ async function handleCommand(command, params) {
         if (!existsSync(pngPath))
           return {
             success: false,
-            error: "Screenshot failed \u2014 Screen Recording permission may be needed. Go to System Settings \u2192 Privacy & Security \u2192 Screen Recording."
+            error: "Screenshot failed \u2014 Screen Recording permission needed. System Settings \u2192 Privacy & Security \u2192 Screen Recording \u2192 enable your terminal app, then restart companion."
           };
         try {
           await runShell(
@@ -705,7 +712,10 @@ async function handleCommand(command, params) {
           );
         } catch {
           const buf2 = readFileSync(pngPath);
-          exec(`rm -f ${pngPath}`);
+          try {
+            unlinkSync(pngPath);
+          } catch {
+          }
           return {
             success: true,
             data: {
@@ -717,7 +727,14 @@ async function handleCommand(command, params) {
         }
         const buf = readFileSync(jpgPath);
         const base64 = buf.toString("base64");
-        exec(`rm -f ${pngPath} ${jpgPath}`);
+        try {
+          unlinkSync(pngPath);
+        } catch {
+        }
+        try {
+          unlinkSync(jpgPath);
+        } catch {
+        }
         let screenSize = "unknown";
         try {
           screenSize = await runShell(
@@ -1159,21 +1176,33 @@ print("\\(x),\\(y)")`;
         const browser = params.browser || "Google Chrome";
         if (!js) return { success: false, error: "Missing JavaScript code" };
         try {
+          const tmpJs = `/tmp/pulso-js-${Date.now()}.js`;
+          writeFileSync(tmpJs, js, "utf-8");
           let result;
           if (browser === "Safari") {
             result = await runAppleScript(
-              `tell application "Safari" to do JavaScript ${JSON.stringify(js)} in front document`
+              `set jsCode to read POSIX file "${tmpJs}" as \xABclass utf8\xBB
+tell application "Safari"
+  do JavaScript jsCode in document 1
+end tell`
             );
           } else {
             result = await runAppleScript(
-              `tell application "${browser.replace(/"/g, '\\"')}" to execute javascript ${JSON.stringify(js)} in active tab of front window`
+              `set jsCode to read POSIX file "${tmpJs}" as \xABclass utf8\xBB
+tell application "${browser.replace(/"/g, '\\"')}"
+  execute javascript jsCode in active tab of front window
+end tell`
             );
           }
-          return { success: true, data: { result: result.slice(0, 5e3) } };
+          try {
+            unlinkSync(tmpJs);
+          } catch {
+          }
+          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}`
+            error: `JS execution failed (enable 'Allow JavaScript from Apple Events' in browser Dev menu): ${err.message}`
           };
         }
       }
@@ -1322,12 +1351,14 @@ print("\\(x),\\(y)")`;
           const p = parseDate(iso);
           if (!p) return "";
           return `set ${varName} to current date
-set year of ${varName} to ${p.y}
-set month of ${varName} to ${p.mo}
-set day of ${varName} to ${p.d}
-set hours of ${varName} to ${p.h}
-set minutes of ${varName} to ${p.mi}
-set seconds of ${varName} to 0`;
+tell ${varName}
+  set its year to ${p.y}
+  set its month to ${p.mo}
+  set its day to ${p.d}
+  set its hours to ${p.h}
+  set its minutes to ${p.mi}
+  set its seconds to 0
+end tell`;
         };
         const startDateScript = buildDateScript("startD", startStr);
         if (!startDateScript)
@@ -1726,11 +1757,7 @@ end tell`);
       case "sys_window_focus": {
         const appName = params.app;
         if (!appName) return { success: false, error: "Missing app name" };
-        await runAppleScript(`
-          tell application "${appName.replace(/"/g, '\\"')}"
-            activate
-            set frontmost to true
-          end tell`);
+        await runAppleScript(`tell application "${appName.replace(/"/g, '\\"')}" to activate`);
         return { success: true, data: { focused: appName } };
       }
       case "sys_window_resize": {
@@ -2167,6 +2194,572 @@ print(text)`;
         );
         return { success: true, data: { room, ...res } };
       }
+      // ── NEW: System Settings ──────────────────────────────
+      case "sys_open_settings": {
+        const pane = params.pane || "";
+        const paneMap = {
+          general: "com.apple.preference.general",
+          wifi: "com.apple.preference.network",
+          network: "com.apple.preference.network",
+          bluetooth: "com.apple.preference.bluetooth",
+          sound: "com.apple.preference.sound",
+          display: "com.apple.preference.displays",
+          wallpaper: "com.apple.preference.desktopscreeneffect",
+          notifications: "com.apple.preference.notifications",
+          focus: "com.apple.preference.focus",
+          keyboard: "com.apple.preference.keyboard",
+          trackpad: "com.apple.preference.trackpad",
+          mouse: "com.apple.preference.mouse",
+          printers: "com.apple.preference.printfax",
+          battery: "com.apple.preference.battery",
+          security: "com.apple.preference.security",
+          privacy: "com.apple.preference.security",
+          siri: "com.apple.preference.speech",
+          spotlight: "com.apple.preference.spotlight",
+          accessibility: "com.apple.preference.universalaccess",
+          storage: "com.apple.preference.storage",
+          timemachine: "com.apple.preference.timemachine",
+          sharing: "com.apple.preference.sharing",
+          users: "com.apple.preference.users",
+          dock: "com.apple.preference.dock"
+        };
+        const paneId = paneMap[pane.toLowerCase()] || pane;
+        if (paneId) {
+          await runShell(
+            `open "x-apple.systempreferences:com.apple.settings.${pane}" 2>/dev/null || open "x-apple.systempreferences:${paneId}" 2>/dev/null || open "System Preferences"`
+          );
+        } else {
+          await runShell(`open "System Preferences" 2>/dev/null || open -a "System Settings"`);
+        }
+        return { success: true, data: { pane: pane || "main" } };
+      }
+      // ── NEW: Dark Mode ──────────────────────────────────────
+      case "sys_dark_mode": {
+        const action = params.action || "status";
+        if (action === "status") {
+          const result = await runAppleScript(
+            `tell application "System Events" to tell appearance preferences to get dark mode`
+          );
+          return {
+            success: true,
+            data: { darkMode: result.trim() === "true" }
+          };
+        } else if (action === "toggle") {
+          await runAppleScript(
+            `tell application "System Events" to tell appearance preferences to set dark mode to not dark mode`
+          );
+          const result = await runAppleScript(
+            `tell application "System Events" to tell appearance preferences to get dark mode`
+          );
+          return {
+            success: true,
+            data: { darkMode: result.trim() === "true" }
+          };
+        } else if (action === "on") {
+          await runAppleScript(
+            `tell application "System Events" to tell appearance preferences to set dark mode to true`
+          );
+          return { success: true, data: { darkMode: true } };
+        } else if (action === "off") {
+          await runAppleScript(
+            `tell application "System Events" to tell appearance preferences to set dark mode to false`
+          );
+          return { success: true, data: { darkMode: false } };
+        }
+        return {
+          success: false,
+          error: "Invalid action. Use: status, toggle, on, off"
+        };
+      }
+      // ── NEW: Spotlight Search ───────────────────────────────
+      case "sys_spotlight_search": {
+        const query = params.query;
+        if (!query) return { success: false, error: "Missing query" };
+        const dir = params.directory;
+        const kind = params.kind;
+        const limit = params.limit || 20;
+        let cmd = `mdfind`;
+        if (dir) cmd += ` -onlyin "${dir}"`;
+        if (kind) {
+          cmd += ` 'kMDItemContentType == "*${kind}*"cd && kMDItemDisplayName == "*${query}*"cd'`;
+        } else {
+          cmd += ` "${query}"`;
+        }
+        cmd += ` | head -${limit}`;
+        const result = await runShell(cmd);
+        const files = result.trim().split("\n").filter((f) => f);
+        return { success: true, data: { query, count: files.length, files } };
+      }
+      // ── NEW: Process Management ─────────────────────────────
+      case "sys_process_list": {
+        const result = await runShell(
+          `ps aux --sort=-%mem | head -25 | awk '{printf "%s|%s|%s|%s|", $1, $2, $3, $4; for(i=11;i<=NF;i++) printf "%s ", $i; print ""}'`
+        );
+        const lines = result.trim().split("\n").slice(1);
+        const processes = lines.map((l) => {
+          const [user, pid, cpu, mem, ...cmdParts] = l.split("|");
+          return {
+            user: user?.trim(),
+            pid: pid?.trim(),
+            cpu: cpu?.trim() + "%",
+            mem: mem?.trim() + "%",
+            command: cmdParts.join("|").trim()
+          };
+        });
+        return { success: true, data: { processes } };
+      }
+      case "sys_process_kill": {
+        const pid = params.pid;
+        const name = params.name;
+        if (!pid && !name)
+          return { success: false, error: "Provide pid or name" };
+        if (pid) {
+          await runShell(`kill ${pid}`);
+          return { success: true, data: { killed: pid } };
+        }
+        const blocked = [
+          "Finder",
+          "loginwindow",
+          "WindowServer",
+          "kernel_task",
+          "launchd"
+        ];
+        if (blocked.some((b) => name.toLowerCase().includes(b.toLowerCase())))
+          return {
+            success: false,
+            error: `Cannot kill system process: ${name}`
+          };
+        await runShell(`pkill -f "${name}"`);
+        return { success: true, data: { killed: name } };
+      }
+      // ── NEW: WiFi Info ──────────────────────────────────────
+      case "sys_wifi_info": {
+        try {
+          const ssid = await runShell(
+            `networksetup -getairportnetwork en0 2>/dev/null | sed 's/Current Wi-Fi Network: //'`
+          );
+          const ip = await runShell(
+            `ipconfig getifaddr en0 2>/dev/null || echo "Not connected"`
+          );
+          const dns = await runShell(
+            `networksetup -getdnsservers Wi-Fi 2>/dev/null || echo "Auto"`
+          );
+          return {
+            success: true,
+            data: {
+              ssid: ssid.trim(),
+              ip: ip.trim(),
+              dns: dns.trim().split("\n")
+            }
+          };
+        } catch {
+          return { success: true, data: { ssid: "Not connected" } };
+        }
+      }
+      // ── NEW: Bluetooth ──────────────────────────────────────
+      case "sys_bluetooth": {
+        const btAction = params.action || "status";
+        try {
+          if (btAction === "status") {
+            try {
+              const power = await runShell(`blueutil --power 2>/dev/null`);
+              const paired = await runShell(
+                `blueutil --paired --format json 2>/dev/null`
+              );
+              return {
+                success: true,
+                data: {
+                  power: power.trim() === "1",
+                  devices: JSON.parse(paired || "[]")
+                }
+              };
+            } catch {
+              const result = await runShell(
+                `system_profiler SPBluetoothDataType -json 2>/dev/null`
+              );
+              return { success: true, data: JSON.parse(result) };
+            }
+          } else if (btAction === "on") {
+            await runShell(`blueutil --power 1`);
+            return { success: true, data: { power: true } };
+          } else if (btAction === "off") {
+            await runShell(`blueutil --power 0`);
+            return { success: true, data: { power: false } };
+          } else if (btAction === "connect") {
+            const address = params.address;
+            if (!address) return { success: false, error: "Missing address" };
+            await runShell(`blueutil --connect "${address}"`);
+            return { success: true, data: { connected: address } };
+          } else if (btAction === "disconnect") {
+            const address = params.address;
+            if (!address) return { success: false, error: "Missing address" };
+            await runShell(`blueutil --disconnect "${address}"`);
+            return { success: true, data: { disconnected: address } };
+          }
+        } catch (e) {
+          return {
+            success: false,
+            error: `Bluetooth requires blueutil: brew install blueutil. ${e.message}`
+          };
+        }
+        return { success: false, error: "Unknown action" };
+      }
+      // ── NEW: Audio Devices ──────────────────────────────────
+      case "sys_audio_devices": {
+        const audioAction = params.action || "list";
+        if (audioAction === "list") {
+          const result = await runAppleScript(`
+set output to ""
+tell application "System Events"
+  set audioOut to name of every audio output device
+  repeat with d in audioOut
+    set output to output & d & linefeed
+  end repeat
+end tell
+return output`);
+          if (!result.trim()) {
+            const spResult = await runShell(
+              `system_profiler SPAudioDataType 2>/dev/null | grep "Device Name" | sed 's/.*: //'`
+            );
+            return {
+              success: true,
+              data: {
+                devices: spResult.trim().split("\n").filter((d) => d)
+              }
+            };
+          }
+          return {
+            success: true,
+            data: {
+              devices: result.trim().split("\n").filter((d) => d)
+            }
+          };
+        } else if (audioAction === "switch") {
+          const device = params.device;
+          if (!device) return { success: false, error: "Missing device name" };
+          try {
+            await runShell(
+              `SwitchAudioSource -s "${device}" 2>/dev/null`
+            );
+            return { success: true, data: { switched: device } };
+          } catch {
+            return {
+              success: false,
+              error: `Requires: brew install switchaudio-osx. Or manually change in System Settings.`
+            };
+          }
+        }
+        return { success: false, error: "Use action: list or switch" };
+      }
+      // ── NEW: Screen Lock ────────────────────────────────────
+      case "sys_screen_lock": {
+        await runShell(
+          `pmset displaysleepnow 2>/dev/null || osascript -e 'tell application "System Events" to keystroke "q" using {control down, command down}'`
+        );
+        return { success: true, data: { locked: true } };
+      }
+      // ── NEW: Trash Operations ───────────────────────────────
+      case "sys_trash": {
+        const trashAction = params.action || "info";
+        if (trashAction === "info") {
+          const count = await runShell(
+            `ls -1 ~/.Trash 2>/dev/null | wc -l`
+          );
+          const size = await runShell(
+            `du -sh ~/.Trash 2>/dev/null | cut -f1`
+          );
+          return {
+            success: true,
+            data: {
+              items: parseInt(count.trim()),
+              size: size.trim()
+            }
+          };
+        } else if (trashAction === "empty") {
+          await runAppleScript(
+            `tell application "Finder" to empty the trash`
+          );
+          return { success: true, data: { emptied: true } };
+        }
+        return { success: false, error: "Use action: info or empty" };
+      }
+      // ── NEW: Archive/Zip Operations ─────────────────────────
+      case "sys_archive": {
+        const archiveAction = params.action || "create";
+        const source = params.source;
+        const destination = params.destination;
+        if (!source) return { success: false, error: "Missing source path" };
+        const safeSrc = safePath(source);
+        if (!safeSrc) return { success: false, error: "Path not allowed" };
+        if (archiveAction === "create") {
+          const dest = destination || `${safeSrc}.zip`;
+          await runShell(`ditto -c -k --keepParent "${safeSrc}" "${dest}"`);
+          return { success: true, data: { archive: dest } };
+        } else if (archiveAction === "extract") {
+          const dest = destination || safeSrc.replace(/\.(zip|tar\.gz|tgz)$/i, "");
+          if (safeSrc.endsWith(".zip")) {
+            await runShell(`ditto -x -k "${safeSrc}" "${dest}"`);
+          } else {
+            await runShell(`tar xzf "${safeSrc}" -C "${dest}"`);
+          }
+          return { success: true, data: { extracted: dest } };
+        }
+        return { success: false, error: "Use action: create or extract" };
+      }
+      // ── NEW: Disk Info ──────────────────────────────────────
+      case "sys_disk_info": {
+        const df = await runShell(`df -h / | tail -1`);
+        const parts = df.trim().split(/\s+/);
+        const volumes = await runShell(
+          `ls -1 /Volumes 2>/dev/null`
+        );
+        return {
+          success: true,
+          data: {
+            filesystem: parts[0],
+            total: parts[1],
+            used: parts[2],
+            available: parts[3],
+            usedPercent: parts[4],
+            mountedVolumes: volumes.trim().split("\n").filter((v) => v)
+          }
+        };
+      }
+      // ── NEW: Focus Mode ─────────────────────────────────────
+      case "sys_focus_mode": {
+        const focusAction = params.action || "status";
+        if (focusAction === "status") {
+          const result = await runShell(
+            `defaults read com.apple.controlcenter "NSStatusItem Visible FocusModes" 2>/dev/null || echo "unknown"`
+          );
+          return {
+            success: true,
+            data: { focusActive: result.trim() !== "0" }
+          };
+        } else if (focusAction === "set") {
+          const mode = params.mode || "Do Not Disturb";
+          try {
+            await runShell(`shortcuts run "Set ${mode}" 2>/dev/null`);
+            return { success: true, data: { mode } };
+          } catch {
+            await runShell(
+              `shortcuts run "Toggle Do Not Disturb" 2>/dev/null`
+            );
+            return {
+              success: true,
+              data: {
+                mode: "DND toggled (custom Focus modes require a Shortcut named 'Set <ModeName>')"
+              }
+            };
+          }
+        }
+        return { success: false, error: "Use action: status or set" };
+      }
+      // ── NEW: Login Items ────────────────────────────────────
+      case "sys_login_items": {
+        const liAction = params.action || "list";
+        if (liAction === "list") {
+          const result = await runAppleScript(
+            `tell application "System Events" to get name of every login item`
+          );
+          return {
+            success: true,
+            data: {
+              items: result.trim().split(", ").filter((i) => i)
+            }
+          };
+        } else if (liAction === "add") {
+          const app = params.app;
+          if (!app) return { success: false, error: "Missing app name/path" };
+          const appPath = app.includes("/") ? app : `/Applications/${app}.app`;
+          await runAppleScript(
+            `tell application "System Events" to make login item at end with properties {path:"${appPath}", hidden:false}`
+          );
+          return { success: true, data: { added: app } };
+        } else if (liAction === "remove") {
+          const app = params.app;
+          if (!app) return { success: false, error: "Missing app name" };
+          await runAppleScript(
+            `tell application "System Events" to delete login item "${app}"`
+          );
+          return { success: true, data: { removed: app } };
+        }
+        return { success: false, error: "Use action: list, add, or remove" };
+      }
+      // ── NEW: Power Management ───────────────────────────────
+      case "sys_power": {
+        const pwrAction = params.action || "status";
+        if (pwrAction === "status") {
+          const batt = await runShell(`pmset -g batt`);
+          const assertions = await runShell(
+            `pmset -g assertions 2>/dev/null | head -5`
+          );
+          return {
+            success: true,
+            data: { battery: batt.trim(), assertions: assertions.trim() }
+          };
+        } else if (pwrAction === "caffeinate") {
+          const duration = params.duration || 3600;
+          exec(`caffeinate -d -t ${duration} &`);
+          return {
+            success: true,
+            data: { caffeinated: true, seconds: duration }
+          };
+        } else if (pwrAction === "sleep") {
+          await runShell(`pmset sleepnow`);
+          return { success: true, data: { sleeping: true } };
+        }
+        return { success: false, error: "Use action: status, caffeinate, sleep" };
+      }
+      // ── NEW: Printer Management ─────────────────────────────
+      case "sys_printer": {
+        const prAction = params.action || "list";
+        if (prAction === "list") {
+          const result = await runShell(`lpstat -p 2>/dev/null || echo "No printers"`);
+          return { success: true, data: { printers: result.trim() } };
+        } else if (prAction === "print") {
+          const file = params.file;
+          if (!file) return { success: false, error: "Missing file path" };
+          const safe = safePath(file);
+          if (!safe) return { success: false, error: "Path not allowed" };
+          const printer = params.printer;
+          const cmd = printer ? `lp -d "${printer}" "${safe}"` : `lp "${safe}"`;
+          await runShell(cmd);
+          return { success: true, data: { printed: file } };
+        }
+        return { success: false, error: "Use action: list or print" };
+      }
+      // ── NEW: Finder Tags ────────────────────────────────────
+      case "sys_finder_tags": {
+        const tagAction = params.action || "get";
+        const filePath = params.path;
+        if (!filePath) return { success: false, error: "Missing path" };
+        const safeFp = safePath(filePath);
+        if (!safeFp) return { success: false, error: "Path not allowed" };
+        if (tagAction === "get") {
+          const result = await runShell(
+            `mdls -name kMDItemUserTags "${safeFp}" | sed 's/kMDItemUserTags = //' | tr -d '()"'`
+          );
+          return {
+            success: true,
+            data: {
+              tags: result.trim().split(",").map((t) => t.trim()).filter((t) => t)
+            }
+          };
+        } else if (tagAction === "set") {
+          const tags = params.tags;
+          if (!tags || !tags.length)
+            return { success: false, error: "Missing tags array" };
+          const tagStr = tags.map((t) => `"${t}"`).join(", ");
+          await runShell(
+            `xattr -w com.apple.metadata:_kMDItemUserTags '(${tagStr})' "${safeFp}"`
+          );
+          return { success: true, data: { path: safeFp, tags } };
+        }
+        return { success: false, error: "Use action: get or set" };
+      }
+      // ── NEW: Quick Note ─────────────────────────────────────
+      case "sys_quick_note": {
+        const body = params.body || "";
+        await runAppleScript(
+          `tell application "Notes" to activate
+tell application "System Events"
+  keystroke "n" using command down
+  delay 0.3
+  keystroke "${body.replace(/"/g, '\\"')}"
+end tell`
+        );
+        return { success: true, data: { created: true } };
+      }
+      // ── NEW: Terminal Tab ───────────────────────────────────
+      case "sys_terminal": {
+        const termAction = params.action || "new_tab";
+        const termCmd = params.command || "";
+        if (termAction === "new_tab") {
+          await runAppleScript(`
+tell application "Terminal"
+  activate
+  do script "${termCmd.replace(/"/g, '\\"')}"
+end tell`);
+          return { success: true, data: { opened: true, command: termCmd } };
+        } else if (termAction === "new_window") {
+          await runAppleScript(`
+tell application "Terminal"
+  activate
+  do script "${termCmd.replace(/"/g, '\\"')}" in (make new window)
+end tell`);
+          return { success: true, data: { opened: true, command: termCmd } };
+        }
+        return { success: false, error: "Use action: new_tab or new_window" };
+      }
+      // ── NEW: PDF Operations ─────────────────────────────────
+      case "sys_pdf": {
+        const pdfAction = params.action || "info";
+        const pdfPath = params.path;
+        if (!pdfPath) return { success: false, error: "Missing path" };
+        const safePdf = safePath(pdfPath);
+        if (!safePdf) return { success: false, error: "Path not allowed" };
+        if (pdfAction === "info") {
+          const result = await runShell(
+            `mdls -name kMDItemNumberOfPages -name kMDItemTitle -name kMDItemAuthors -name kMDItemFSSize "${safePdf}"`
+          );
+          return { success: true, data: { info: result.trim() } };
+        } else if (pdfAction === "text") {
+          try {
+            const text2 = await runShell(
+              `textutil -convert txt -stdout "${safePdf}" 2>/dev/null | head -500`
+            );
+            if (text2.trim())
+              return { success: true, data: { text: text2.trim() } };
+          } catch {
+          }
+          const text = await runShell(
+            `python3 -c "
+import subprocess
+result = subprocess.run(['mdls', '-name', 'kMDItemTextContent', '${safePdf.replace(/'/g, "\\'")}'], capture_output=True, text=True)
+print(result.stdout[:5000])
+" 2>/dev/null || echo "Could not extract text. Install: brew install poppler (for pdftotext)"`
+          );
+          return { success: true, data: { text: text.trim() } };
+        } else if (pdfAction === "merge") {
+          const files = params.files;
+          const output = params.output;
+          if (!files || !output)
+            return { success: false, error: "Missing files array and output" };
+          const safePaths = files.map((f) => `"${safePath(f) || f}"`).join(" ");
+          await runShell(
+            `/System/Library/Automator/Combine\\ PDF\\ Pages.action/Contents/MacOS/join -o "${safePath(output) || output}" ${safePaths}`
+          );
+          return { success: true, data: { merged: output } };
+        }
+        return {
+          success: false,
+          error: "Use action: info, text, or merge"
+        };
+      }
+      // ── NEW: Launchctl / Services ───────────────────────────
+      case "sys_services": {
+        const svcAction = params.action || "list";
+        if (svcAction === "list") {
+          const result = await runShell(
+            `launchctl list 2>/dev/null | head -30`
+          );
+          return { success: true, data: { services: result.trim() } };
+        } else if (svcAction === "start") {
+          const name = params.name;
+          if (!name) return { success: false, error: "Missing service name" };
+          await runShell(`launchctl kickstart gui/$(id -u)/${name} 2>/dev/null`);
+          return { success: true, data: { started: name } };
+        } else if (svcAction === "stop") {
+          const name = params.name;
+          if (!name) return { success: false, error: "Missing service name" };
+          await runShell(
+            `launchctl kill SIGTERM gui/$(id -u)/${name} 2>/dev/null`
+          );
+          return { success: true, data: { stopped: name } };
+        }
+        return { success: false, error: "Use action: list, start, stop" };
+      }
       default:
         return { success: false, error: `Unknown command: ${command}` };
     }
@@ -2586,7 +3179,7 @@ function writeString(view, offset, str) {
 }
 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.3     \u2551");
+console.log("  \u2551    \u{1FAC0} Pulso Mac Companion v0.3.0     \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(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulso/companion",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "type": "module",
   "description": "Pulso Companion — gives your AI agent real control over your computer",
   "bin": {
@@ -22,7 +22,7 @@
     "mac",
     "automation"
   ],
-  "author": "Pulso <hello@pulso.dev>",
+  "author": "Pulso <hello@runpulso.com>",
   "license": "MIT",
   "repository": {
     "type": "git",