@nopeek/agent-bridge 0.1.0 → 0.2.0

package/dist/service.js

@@ -0,0 +1,174 @@
+// `nopeek-agent-bridge install` — the ONE terminal command. Installs the bridge
+// as an always-on background service (launchd on macOS, systemd --user on
+// Linux) that starts at login and waits, unpaired, for the NoPeek app to
+// connect it. Everything after this happens in the app.
+import { execFileSync, spawnSync } from "node:child_process";
+import { mkdirSync, realpathSync, writeFileSync, rmSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const LABEL = "com.nopeek.agent-bridge";
+const UNIT = "nopeek-agent-bridge.service";
+function xmlEscape(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/**
+ * Resolve the entrypoint the service should run. If we're executing out of the
+ * npx cache (wiped on `npm cache clean` / eviction), install a private copy
+ * under <home>/app first so the service survives.
+ */
+function resolveEntrypoint(homeDir) {
+    const self = realpathSync(process.argv[1]);
+    if (!/[\\/]_npx[\\/]/.test(self))
+        return self;
+    console.log(`[install] running from the npx cache — installing a permanent copy into ${join(homeDir, "app")}`);
+    mkdirSync(join(homeDir, "app"), { recursive: true });
+    const r = spawnSync("npm", ["install", "--prefix", join(homeDir, "app"), "@nopeek/agent-bridge@latest"], {
+        stdio: "inherit",
+    });
+    if (r.status !== 0)
+        throw new Error(`npm install into ${join(homeDir, "app")} failed (exit ${r.status})`);
+    const entry = join(homeDir, "app", "node_modules", "@nopeek/agent-bridge", "dist", "cli.js");
+    if (!existsSync(entry))
+        throw new Error(`expected ${entry} after install — not found`);
+    return entry;
+}
+function launchctl(args, ignoreFailure = false) {
+    try {
+        execFileSync("launchctl", args, { stdio: "pipe" });
+    }
+    catch (err) {
+        if (!ignoreFailure)
+            throw err;
+    }
+}
+export async function installService(cfg) {
+    if (process.platform !== "darwin" && process.platform !== "linux") {
+        throw new Error(`automatic service install supports macOS and Linux. On this platform, run the bridge with any process manager:\n  nopeek-agent-bridge run`);
+    }
+    mkdirSync(join(cfg.homeDir, "logs"), { recursive: true });
+    const entry = resolveEntrypoint(cfg.homeDir);
+    const logFile = join(cfg.homeDir, "logs", "bridge.log");
+    if (process.platform === "darwin") {
+        const plistPath = join(homedir(), "Library", "LaunchAgents", `${LABEL}.plist`);
+        mkdirSync(join(homedir(), "Library", "LaunchAgents"), { recursive: true });
+        // PATH is captured at install time: launchd's default PATH won't find
+        // hermes/claude/… installed via Homebrew or nvm.
+        const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${xmlEscape(process.execPath)}</string>
+    <string>${xmlEscape(entry)}</string>
+    <string>run</string>
+  </array>
+  <key>WorkingDirectory</key><string>${xmlEscape(cfg.homeDir)}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>NOPEEK_BRIDGE_HOME</key><string>${xmlEscape(cfg.homeDir)}</string>
+    <key>PATH</key><string>${xmlEscape(process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin")}</string>
+  </dict>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>StandardOutPath</key><string>${xmlEscape(logFile)}</string>
+  <key>StandardErrorPath</key><string>${xmlEscape(logFile)}</string>
+</dict>
+</plist>
+`;
+        writeFileSync(plistPath, plist);
+        const domain = `gui/${process.getuid?.() ?? 501}`;
+        launchctl(["bootout", `${domain}/${LABEL}`], true); // idempotent reinstall
+        try {
+            launchctl(["bootstrap", domain, plistPath]);
+        }
+        catch {
+            launchctl(["load", "-w", plistPath]); // pre-Catalina fallback
+        }
+        console.log(`[install] launchd service installed: ${plistPath}`);
+    }
+    else {
+        const unitDir = join(homedir(), ".config", "systemd", "user");
+        mkdirSync(unitDir, { recursive: true });
+        const unitPath = join(unitDir, UNIT);
+        writeFileSync(unitPath, `[Unit]
+Description=NoPeek agent bridge (E2EE bots)
+After=network-online.target
+
+[Service]
+ExecStart=${process.execPath} ${entry} run
+WorkingDirectory=${cfg.homeDir}
+Environment=NOPEEK_BRIDGE_HOME=${cfg.homeDir}
+Environment=PATH=${process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin"}
+Restart=always
+RestartSec=3
+
+[Install]
+WantedBy=default.target
+`);
+        execFileSync("systemctl", ["--user", "daemon-reload"], { stdio: "pipe" });
+        execFileSync("systemctl", ["--user", "enable", "--now", UNIT], { stdio: "pipe" });
+        console.log(`[install] systemd user service installed: ${unitPath}`);
+        console.log(`[install] tip: 'loginctl enable-linger ${process.env.USER ?? "$USER"}' keeps it running while logged out`);
+    }
+    // Confirm it actually came up.
+    const status = await waitForBridge(cfg.port, 15_000);
+    if (status) {
+        console.log(`[install] bridge is running (v${String(status.version)}, ${status.paired ? "paired" : "not paired yet"})`);
+    }
+    else {
+        console.warn(`[install] service installed but not answering on :${cfg.port} yet — check ${logFile}`);
+    }
+    console.log(`
+Done. Next step — in the NoPeek app on THIS computer:
+  Contacts -> My Bots -> Connect this computer
+Pairing, choosing your agent (Hermes, …) and everything else happens in the app.
+Logs: ${logFile}`);
+}
+export function uninstallService() {
+    if (process.platform === "darwin") {
+        const plistPath = join(homedir(), "Library", "LaunchAgents", `${LABEL}.plist`);
+        launchctl(["bootout", `gui/${process.getuid?.() ?? 501}/${LABEL}`], true);
+        rmSync(plistPath, { force: true });
+        console.log(`[uninstall] launchd service removed (settings and device keys kept in ~/.nopeek-bridge)`);
+    }
+    else if (process.platform === "linux") {
+        try {
+            execFileSync("systemctl", ["--user", "disable", "--now", UNIT], { stdio: "pipe" });
+        }
+        catch {
+            /* not installed */
+        }
+        rmSync(join(homedir(), ".config", "systemd", "user", UNIT), { force: true });
+        console.log(`[uninstall] systemd user service removed (settings and device keys kept)`);
+    }
+    else {
+        console.log(`[uninstall] no service support on this platform`);
+    }
+}
+export async function printStatus(port) {
+    const status = await waitForBridge(port, 1_500);
+    if (!status) {
+        console.log(`no bridge answering on http://127.0.0.1:${port}/ — is the service installed and running?`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(JSON.stringify(status, null, 2));
+}
+async function waitForBridge(port, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        try {
+            const res = await fetch(`http://127.0.0.1:${port}/`, { signal: AbortSignal.timeout(1_000) });
+            if (res.ok)
+                return (await res.json());
+        }
+        catch {
+            /* not up yet */
+        }
+        if (Date.now() >= deadline)
+            return null;
+        await new Promise((r) => setTimeout(r, 500));
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nopeek/agent-bridge",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Run your own agents as E2EE NoPeek bots. Pairs with a one-time code, runs every bot you own, and pipes messages to any command or webhook.",
   "type": "module",
   "license": "MIT",
@@ -22,8 +22,15 @@
   "engines": {
     "node": ">=22"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "tsc -p tsconfig.json",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
   "dependencies": {
-    "@nopeek/chat": "0.1.0"
+    "@nopeek/chat": "workspace:*"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
@@ -40,11 +47,5 @@
   ],
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "start": "node dist/cli.js",
-    "dev": "tsx src/cli.ts",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}