@pulso/companion 0.1.0

package/dist/index.js

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import WebSocket from "ws";
+import { exec, execSync } from "child_process";
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { homedir } from "os";
+import { resolve } 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 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");
+  process.exit(1);
+}
+var ACCESS_LEVEL = process.env.PULSO_ACCESS ?? process.argv.find((_, i, a) => a[i - 1] === "--access") ?? "sandboxed";
+var WS_URL = API_URL.replace("https://", "wss://").replace("http://", "ws://") + "/ws/browser?token=" + TOKEN;
+var HOME = homedir();
+var RECONNECT_DELAY = 5e3;
+var SAFE_DIRS = ["Documents", "Desktop", "Downloads", "Projects", "Projetos"];
+function safePath(relative) {
+  const full = resolve(HOME, relative);
+  if (!full.startsWith(HOME)) return null;
+  if (ACCESS_LEVEL === "full") return full;
+  const relFromHome = full.slice(HOME.length + 1);
+  const topDir = relFromHome.split("/")[0];
+  if (!topDir || !SAFE_DIRS.some((d) => topDir.toLowerCase() === d.toLowerCase())) {
+    return null;
+  }
+  return full;
+}
+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());
+    });
+  });
+}
+function runShell(cmd, timeout = 1e4) {
+  return new Promise((resolve2, reject) => {
+    exec(cmd, { timeout }, (err, stdout, stderr) => {
+      if (err) reject(new Error(stderr || err.message));
+      else resolve2(stdout.trim());
+    });
+  });
+}
+async function handleCommand(command, params) {
+  try {
+    switch (command) {
+      case "sys_open_app": {
+        const app = params.app;
+        if (!app) return { success: false, error: "Missing app name" };
+        await runShell(`open -a "${app.replace(/"/g, "")}"`);
+        return { success: true, data: { opened: app } };
+      }
+      case "sys_open_url": {
+        const url = params.url;
+        if (!url) return { success: false, error: "Missing URL" };
+        await runShell(`open "${url.replace(/"/g, "")}"`);
+        return { success: true, data: { opened: url } };
+      }
+      case "sys_speak": {
+        const text = params.text;
+        const voice = params.voice;
+        if (!text) return { success: false, error: "Missing text" };
+        const voiceFlag = voice ? `-v "${voice.replace(/"/g, "")}"` : "";
+        exec(`say ${voiceFlag} "${text.replace(/"/g, '\\"').slice(0, 500)}"`);
+        return { success: true, data: { spoken: text.slice(0, 100) } };
+      }
+      case "sys_notification": {
+        const title = params.title;
+        const message = params.message;
+        if (!title || !message) return { success: false, error: "Missing title or message" };
+        await runAppleScript(
+          `display notification "${message.replace(/"/g, '\\"')}" with title "${title.replace(/"/g, '\\"')}"`
+        );
+        return { success: true, data: { notified: true } };
+      }
+      case "sys_clipboard_read": {
+        const content = await runShell("pbpaste");
+        return { success: true, data: { content: content.slice(0, 5e3) } };
+      }
+      case "sys_clipboard_write": {
+        const text = params.text;
+        if (!text) return { success: false, error: "Missing text" };
+        execSync(`echo ${JSON.stringify(text)} | pbcopy`);
+        return { success: true, data: { copied: text.slice(0, 100) } };
+      }
+      case "sys_spotify": {
+        const action = params.action;
+        switch (action) {
+          case "play":
+            await runAppleScript('tell application "Spotify" to play');
+            return { success: true, data: { action: "play" } };
+          case "pause":
+            await runAppleScript('tell application "Spotify" to pause');
+            return { success: true, data: { action: "pause" } };
+          case "next":
+            await runAppleScript('tell application "Spotify" to next track');
+            return { success: true, data: { action: "next" } };
+          case "previous":
+            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 } };
+          }
+          case "search_play": {
+            const query = params.query;
+            if (!query) return { success: false, error: "Missing search query" };
+            await runShell(`open "spotify:search:${encodeURIComponent(query)}"`);
+            return { success: true, data: { searched: query, note: "Opened Spotify search. Play the first result manually or use 'play' after." } };
+          }
+          default:
+            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}` };
+        const content = readFileSync(fullPath, "utf-8");
+        return {
+          success: true,
+          data: {
+            path,
+            content: content.slice(0, 1e4),
+            size: content.length,
+            truncated: content.length > 1e4
+          }
+        };
+      }
+      case "sys_file_write": {
+        const path = params.path;
+        const content = params.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.` };
+        writeFileSync(fullPath, content, "utf-8");
+        return { success: true, data: { path, written: content.length } };
+      }
+      case "sys_screenshot": {
+        const tmpPath = `/tmp/pulso-screenshot-${Date.now()}.png`;
+        await runShell(`screencapture -x ${tmpPath}`, 15e3);
+        if (!existsSync(tmpPath)) return { success: false, error: "Screenshot failed" };
+        const buf = readFileSync(tmpPath);
+        const base64 = buf.toString("base64");
+        exec(`rm -f ${tmpPath}`);
+        return {
+          success: true,
+          data: {
+            image: `data:image/png;base64,${base64}`,
+            note: "Full screen screenshot captured"
+          }
+        };
+      }
+      case "sys_run_shortcut": {
+        const name = params.name;
+        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" } };
+      }
+      default:
+        return { success: false, error: `Unknown command: ${command}` };
+    }
+  } catch (err) {
+    return { success: false, error: err.message };
+  }
+}
+var ws = null;
+var reconnectTimer = null;
+function connect() {
+  console.log("\u{1F50C} Connecting to Pulso...");
+  console.log(`   ${WS_URL.replace(/token=.*/, "token=***")}`);
+  ws = new WebSocket(WS_URL);
+  ws.on("open", () => {
+    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("");
+    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 Clipboard access");
+    console.log("   \u2022 Screenshots");
+    console.log("   \u2022 Text-to-speech");
+    console.log("   \u2022 Terminal commands");
+    console.log("   \u2022 System notifications");
+    console.log("   \u2022 macOS Shortcuts");
+    console.log("");
+    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" }));
+  });
+  ws.on("message", async (raw) => {
+    try {
+      const msg = JSON.parse(raw.toString());
+      if (msg.type === "ack") {
+        console.log(`   \u2713 Server: ${msg.message}`);
+        return;
+      }
+      if (msg.id && msg.command) {
+        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);
+        ws.send(JSON.stringify({ id: msg.id, result }));
+        return;
+      }
+      console.log("   ? Unknown message:", raw.toString().slice(0, 200));
+    } catch (err) {
+      console.error("   \u274C Error handling message:", err.message);
+    }
+  });
+  ws.on("close", (code, reason) => {
+    console.log(`
+\u{1F50C} Disconnected (${code}: ${reason.toString() || "unknown"})`);
+    scheduleReconnect();
+  });
+  ws.on("error", (err) => {
+    console.error(`\u274C WebSocket error: ${err.message}`);
+  });
+}
+function scheduleReconnect() {
+  if (reconnectTimer) return;
+  console.log(`   Reconnecting in ${RECONNECT_DELAY / 1e3}s...`);
+  reconnectTimer = setTimeout(() => {
+    reconnectTimer = null;
+    connect();
+  }, RECONNECT_DELAY);
+}
+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.1.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("");
+connect();
+process.on("SIGINT", () => {
+  console.log("\n\u{1F44B} Shutting down Pulso Companion...");
+  ws?.close(1e3, "User shutdown");
+  process.exit(0);
+});
+process.on("SIGTERM", () => {
+  ws?.close(1e3, "Process terminated");
+  process.exit(0);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@pulso/companion",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Pulso Companion — gives your AI agent real control over your computer",
+  "bin": {
+    "pulso-companion": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "pulso",
+    "ai",
+    "agent",
+    "companion",
+    "mac",
+    "automation"
+  ],
+  "author": "Pulso <hello@pulso.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pulso-dev/pulso"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.0",
+    "tsx": "^4.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}