@pulso/companion 0.2.3 → 0.3.0

package/dist/index.js

@@ -681,9 +681,23 @@ async function handleCommand(command, params) {
         const ts = Date.now();
         const pngPath = `/tmp/pulso-ss-${ts}.png`;
         const jpgPath = `/tmp/pulso-ss-${ts}.jpg`;
-        await runShell(`screencapture -x ${pngPath}`, 15e3);
+        try {
+          await runShell(`screencapture -x ${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)."
+            };
+          }
+          return { success: false, error: `Screenshot failed: ${msg}` };
+        }
         if (!existsSync(pngPath))
-          return { success: false, error: "Screenshot failed" };
+          return {
+            success: false,
+            error: "Screenshot failed \u2014 Screen Recording permission may be needed. Go to System Settings \u2192 Privacy & Security \u2192 Screen Recording."
+          };
         try {
           await runShell(
             `sips --resampleWidth 1280 --setProperty format jpeg --setProperty formatOptions 60 ${pngPath} --out ${jpgPath}`,
@@ -1259,9 +1273,11 @@ print("\\(x),\\(y)")`;
       // ── Calendar ────────────────────────────────────────────
       case "sys_calendar_list": {
         const days = Number(params.days) || 7;
-        const startDate = /* @__PURE__ */ new Date();
-        const endDate = new Date(Date.now() + days * 864e5);
-        const fmt = (d) => `date "${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}"`;
+        try {
+          await runAppleScript(`tell application "Calendar" to launch`);
+          await new Promise((r) => setTimeout(r, 500));
+        } catch {
+        }
         const script = `
           set output to ""
           tell application "Calendar"
@@ -1297,20 +1313,47 @@ print("\\(x),\\(y)")`;
         const notes = params.notes || "";
         if (!summary || !startStr)
           return { success: false, error: "Missing summary or start time" };
+        const parseDate = (iso) => {
+          const d = new Date(iso);
+          if (isNaN(d.getTime())) return null;
+          return { y: d.getFullYear(), mo: d.getMonth() + 1, d: d.getDate(), h: d.getHours(), mi: d.getMinutes() };
+        };
+        const buildDateScript = (varName, iso) => {
+          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`;
+        };
+        const startDateScript = buildDateScript("startD", startStr);
+        if (!startDateScript)
+          return { success: false, error: `Invalid start date: ${startStr}` };
+        const endDateScript = endStr ? buildDateScript("endD", endStr) : "";
         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, '\\"')}"` : "";
+        const notesPart = notes ? `
+set description of newEvent to "${notes.replace(/"/g, '\\"')}"` : "";
+        const endPart = endDateScript ? `
+set end date of newEvent to endD` : "";
+        try {
+          await runAppleScript(`tell application "Calendar" to launch`);
+          await new Promise((r) => setTimeout(r, 500));
+        } catch {
+        }
         await runAppleScript(`
-          tell application "Calendar"
-            tell ${calTarget}
-              set newEvent to make new event with properties {summary:"${summary.replace(/"/g, '\\"')}", start date:date "${startStr}"}
-              ${endPart}
-              ${notesPart}
-            end tell
-          end tell`);
+${startDateScript}
+${endDateScript}
+tell application "Calendar"
+  tell ${calTarget}
+    set newEvent to make new event with properties {summary:"${summary.replace(/"/g, '\\"')}", start date:startD}${endPart}${notesPart}
+  end tell
+end tell`);
         return {
           success: true,
-          data: { created: summary, start: startStr, end: endStr || "auto" }
+          data: { created: summary, start: startStr, end: endStr || "1 hour" }
         };
       }
       // ── Reminders ───────────────────────────────────────────
@@ -1359,16 +1402,39 @@ print("\\(x),\\(y)")`;
       case "sys_reminder_create": {
         const reminderName = params.name;
         const dueDate = params.due;
-        const listName2 = params.list || "Reminders";
+        let listName2 = params.list || "";
         if (!reminderName)
           return { success: false, error: "Missing reminder name" };
-        const duePart = dueDate ? `, due date:date "${dueDate}"` : "";
-        await runAppleScript(`
-          tell application "Reminders"
-            tell list "${listName2.replace(/"/g, '\\"')}"
-              make new reminder with properties {name:"${reminderName.replace(/"/g, '\\"')}"${duePart}}
-            end tell
-          end tell`);
+        if (!listName2) {
+          try {
+            listName2 = (await runAppleScript(
+              `tell application "Reminders" to return name of default list`
+            )).trim();
+          } catch {
+            listName2 = "Reminders";
+          }
+        }
+        let duePart = "";
+        if (dueDate) {
+          const d = new Date(dueDate);
+          if (!isNaN(d.getTime())) {
+            duePart = `
+set dueD to current date
+set year of dueD to ${d.getFullYear()}
+set month of dueD to ${d.getMonth() + 1}
+set day of dueD to ${d.getDate()}
+set hours of dueD to ${d.getHours()}
+set minutes of dueD to ${d.getMinutes()}
+set seconds of dueD to 0`;
+          }
+        }
+        const dueProperty = duePart ? `, due date:dueD` : "";
+        await runAppleScript(`${duePart}
+tell application "Reminders"
+  tell list "${listName2.replace(/"/g, '\\"')}"
+    make new reminder with properties {name:"${reminderName.replace(/"/g, '\\"')}"${dueProperty}}
+  end tell
+end tell`);
         return {
           success: true,
           data: {
@@ -2101,6 +2167,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}` };
     }
@@ -2520,7 +3152,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.3",
+  "version": "0.3.0",
   "type": "module",
   "description": "Pulso Companion — gives your AI agent real control over your computer",
   "bin": {