remote-pi 0.1.3 → 0.2.0

package/dist/daemon/install.js

@@ -0,0 +1,312 @@
+import { execFileSync } from "node:child_process";
+import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { delimiter } from "node:path";
+import { homedir, platform, userInfo } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export function detectPlatform() {
+    switch (platform()) {
+        case "darwin": return "macos";
+        case "linux": return "linux";
+        default: return "unsupported";
+    }
+}
+// ── Path resolution ────────────────────────────────────────────────────────
+/**
+ * Absolute path to the supervisor's compiled entry. We resolve from
+ * `import.meta.url` (this file's location) since wherever the daemon
+ * module lives, `bin/supervisord.js` is a sibling of `daemon/` under
+ * `dist/`.
+ *
+ * After build: `dist/daemon/install.js` → `dist/bin/supervisord.js`.
+ * In dev (`tsx`): same path resolution still lands inside `src/`, which
+ * isn't directly runnable by `node` — dev install isn't expected.
+ */
+export function findSupervisorScript() {
+    const here = fileURLToPath(import.meta.url); // dist/daemon/install.js
+    const daemonDir = dirname(here); // dist/daemon
+    const distRoot = dirname(daemonDir); // dist
+    return resolve(distRoot, "bin/supervisord.js");
+}
+/**
+ * Absolute path to the extension's CLI entry (`dist/index.js`). This is
+ * the file we symlink to `~/.local/bin/remote-pi` so the user can run
+ * `remote-pi <subcommand>` from any shell after installing the extension
+ * through Pi (`pi install npm:remote-pi`).
+ *
+ * Same resolution strategy as `findSupervisorScript`: from
+ * `dist/daemon/install.js` → `dist/index.js`.
+ */
+export function findRemotePiScript() {
+    const here = fileURLToPath(import.meta.url); // dist/daemon/install.js
+    const daemonDir = dirname(here); // dist/daemon
+    const distRoot = dirname(daemonDir); // dist
+    return resolve(distRoot, "index.js");
+}
+export function findNodeBinary() {
+    // `process.execPath` is always absolute and points at the current Node
+    // binary. Embedding it in the service unit means the user gets the
+    // exact same Node version they invoked `remote-pi install` with — no
+    // PATH ambiguity at boot time.
+    return process.execPath;
+}
+export function findTemplate(name) {
+    // Templates ship next to the compiled `dist/` (via `files` in package.json).
+    // From `dist/daemon/install.js` go up two levels and into
+    // `service-templates/`. In the published npm tarball the layout is the
+    // same — `service-templates/` is sibling to `dist/`.
+    const here = fileURLToPath(import.meta.url); // dist/daemon/install.js
+    const pkgRoot = resolve(dirname(dirname(dirname(here)))); // package root
+    const file = name === "systemd"
+        ? "systemd.service.template"
+        : "launchd.plist.template";
+    return resolve(pkgRoot, "service-templates", file);
+}
+// ── Service paths ──────────────────────────────────────────────────────────
+export function systemdUnitPath() {
+    return join(homedir(), ".config", "systemd", "user", "remote-pi-supervisord.service");
+}
+export function launchdPlistPath() {
+    return join(homedir(), "Library", "LaunchAgents", "dev.remotepi.supervisord.plist");
+}
+const LAUNCHD_LABEL = "dev.remotepi.supervisord";
+export function defaultRenderVars() {
+    return {
+        node: findNodeBinary(),
+        supervisor: findSupervisorScript(),
+        home: homedir(),
+        user: userInfo().username,
+        path: process.env["PATH"] ?? "/usr/local/bin:/usr/bin:/bin",
+    };
+}
+/** Replace `{NODE}` / `{SUPERVISOR}` / `{USER}` / `{HOME}` / `{PATH}`. */
+export function renderTemplate(template, vars) {
+    return template
+        .replace(/\{NODE\}/g, vars.node)
+        .replace(/\{SUPERVISOR\}/g, vars.supervisor)
+        .replace(/\{USER\}/g, vars.user)
+        .replace(/\{HOME\}/g, vars.home)
+        .replace(/\{PATH\}/g, vars.path);
+}
+/**
+ * Writes the unit/plist, runs the platform's activation command. Throws
+ * on unsupported OS or when the supervisor script isn't found.
+ *
+ * Idempotent: re-running re-writes the unit (paths could have changed)
+ * and re-activates via the platform tool's idempotent flag.
+ */
+export function installService(vars = defaultRenderVars()) {
+    const plat = detectPlatform();
+    const log = [];
+    if (plat === "unsupported") {
+        throw new Error(`unsupported platform: ${platform()}. Only macOS and Linux.`);
+    }
+    // Sanity: supervisor script must exist on disk.
+    if (!existsSync(vars.supervisor)) {
+        throw new Error(`supervisor script not found at ${vars.supervisor}. ` +
+            "Run `pnpm build` (dev) or `npm install -g remote-pi` (prod) first.");
+    }
+    const templatePath = findTemplate(plat === "macos" ? "launchd" : "systemd");
+    if (!existsSync(templatePath)) {
+        throw new Error(`service template missing: ${templatePath}`);
+    }
+    const tpl = readFileSync(templatePath, "utf8");
+    const rendered = renderTemplate(tpl, vars);
+    const unitPath = plat === "macos" ? launchdPlistPath() : systemdUnitPath();
+    mkdirSync(dirname(unitPath), { recursive: true });
+    writeFileSync(unitPath, rendered);
+    log.push(`wrote ${unitPath}`);
+    if (plat === "macos") {
+        // Unload first in case a stale entry exists from a prior install —
+        // `launchctl bootstrap` errors out otherwise. `bootout` is the modern
+        // API; `unload` is the legacy fallback. Either may fail silently.
+        const uid = userInfo().uid;
+        _tryExec("launchctl", ["bootout", `gui/${uid}`, unitPath], log);
+        _tryExec("launchctl", ["unload", unitPath], log);
+        _exec("launchctl", ["bootstrap", `gui/${uid}`, unitPath], log);
+        log.push(`activated via launchctl bootstrap gui/${uid}`);
+    }
+    else {
+        _exec("systemctl", ["--user", "daemon-reload"], log);
+        _exec("systemctl", ["--user", "enable", "--now", "remote-pi-supervisord.service"], log);
+        log.push("activated via systemctl --user enable --now");
+    }
+    return { platform: plat, unitPath, log };
+}
+export function uninstallService() {
+    const plat = detectPlatform();
+    const log = [];
+    if (plat === "unsupported") {
+        throw new Error(`unsupported platform: ${platform()}. Only macOS and Linux.`);
+    }
+    const unitPath = plat === "macos" ? launchdPlistPath() : systemdUnitPath();
+    if (plat === "macos") {
+        const uid = userInfo().uid;
+        _tryExec("launchctl", ["bootout", `gui/${uid}`, unitPath], log);
+        _tryExec("launchctl", ["unload", unitPath], log);
+        log.push("deactivated via launchctl bootout");
+    }
+    else {
+        _tryExec("systemctl", ["--user", "disable", "--now", "remote-pi-supervisord.service"], log);
+        log.push("deactivated via systemctl --user disable --now");
+    }
+    let removed = false;
+    if (existsSync(unitPath)) {
+        try {
+            unlinkSync(unitPath);
+            removed = true;
+            log.push(`removed ${unitPath}`);
+        }
+        catch (e) {
+            log.push(`failed to remove ${unitPath}: ${String(e)}`);
+        }
+    }
+    if (plat === "linux") {
+        _tryExec("systemctl", ["--user", "daemon-reload"], log);
+    }
+    // Hint about the label for users that want to verify manually.
+    if (plat === "macos")
+        log.push(`(label: ${LAUNCHD_LABEL})`);
+    return { platform: plat, unitPath, removed, log };
+}
+// ── Internals ──────────────────────────────────────────────────────────────
+function _exec(cmd, args, log) {
+    try {
+        const out = execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+        if (out.trim())
+            log.push(`$ ${cmd} ${args.join(" ")}\n${out.trim()}`);
+        else
+            log.push(`$ ${cmd} ${args.join(" ")}`);
+    }
+    catch (e) {
+        const err = e;
+        const stderr = typeof err.stderr === "string" ? err.stderr : err.stderr?.toString() ?? "";
+        throw new Error(`\`${cmd} ${args.join(" ")}\` exited ${err.status ?? "?"}\n${stderr.trim() || err.message}`);
+    }
+}
+/** Like _exec but swallows errors — used for cleanup steps where failure
+ *  is expected (e.g., "unload" before "load" when nothing was loaded). */
+function _tryExec(cmd, args, log) {
+    try {
+        _exec(cmd, args, log);
+    }
+    catch { /* expected, suppress */ }
+}
+export function userLocalBinDir(home = homedir()) {
+    return join(home, ".local", "bin");
+}
+/**
+ * Check whether `dir` is on `process.env.PATH`. Tolerates trailing
+ * slashes and relative entries (which we treat as not matching — `~/.local/bin`
+ * is always absolute on our end).
+ */
+export function isOnPath(dir, envPath = process.env["PATH"] ?? "") {
+    const target = dir.replace(/\/+$/, "");
+    return envPath.split(delimiter).some((entry) => entry.replace(/\/+$/, "") === target);
+}
+/**
+ * Create (or refresh) the `remote-pi` + `pi-supervisord` symlinks in
+ * `~/.local/bin/`. Idempotent — replaces stale links pointing at old
+ * extension paths (Pi can reinstall the extension to a different hash dir
+ * on upgrades, so this MUST overwrite).
+ *
+ * Returns `onPath: false` when `~/.local/bin` isn't in the user's `$PATH`.
+ * The caller is responsible for surfacing the shell-rc instruction —
+ * we don't edit the user's shell config files automatically.
+ */
+export function linkCliBinaries(home = homedir(), paths = {}) {
+    const binDir = userLocalBinDir(home);
+    const log = [];
+    mkdirSync(binDir, { recursive: true });
+    log.push(`ensured ${binDir}`);
+    const remotePi = paths.remotePi ?? findRemotePiScript();
+    const supervisord = paths.supervisord ?? findSupervisorScript();
+    if (!existsSync(remotePi)) {
+        throw new Error(`remote-pi script not found at ${remotePi}. ` +
+            "Run `pnpm build` (dev) or reinstall the extension.");
+    }
+    if (!existsSync(supervisord)) {
+        throw new Error(`supervisor script not found at ${supervisord}. ` +
+            "Run `pnpm build` (dev) or reinstall the extension.");
+    }
+    // tsc strips the executable bit on its outputs; the shebang at the top
+    // of dist/index.js means the file IS a valid interpreter target once
+    // chmod +x is applied. Same for supervisord.js (no shebang — we rely
+    // on `node` resolving via the symlink at exec time).
+    try {
+        chmodSync(remotePi, 0o755);
+    }
+    catch { /* best-effort */ }
+    try {
+        chmodSync(supervisord, 0o755);
+    }
+    catch { /* best-effort */ }
+    const links = [
+        { name: "remote-pi", path: join(binDir, "remote-pi"), target: remotePi },
+        { name: "pi-supervisord", path: join(binDir, "pi-supervisord"), target: supervisord },
+    ];
+    for (const link of links) {
+        _replaceSymlink(link.path, link.target, log);
+    }
+    const onPath = isOnPath(binDir);
+    if (!onPath) {
+        log.push(`WARNING: ${binDir} is not on $PATH. ` +
+            `Add this line to your shell rc (~/.zshrc, ~/.bashrc, etc.): ` +
+            `export PATH="$HOME/.local/bin:$PATH"`);
+    }
+    return { binDir, links, onPath, log };
+}
+export function unlinkCliBinaries(home = homedir()) {
+    const binDir = userLocalBinDir(home);
+    const log = [];
+    const names = ["remote-pi", "pi-supervisord"];
+    const removed = [];
+    for (const name of names) {
+        const path = join(binDir, name);
+        let existed = false;
+        try {
+            // lstatSync (not stat) so a symlink targeting a deleted file still
+            // resolves — we want to remove the LINK itself, not chase it.
+            lstatSync(path);
+            existed = true;
+        }
+        catch { /* not present */ }
+        if (existed) {
+            try {
+                unlinkSync(path);
+                log.push(`removed ${path}`);
+            }
+            catch (e) {
+                log.push(`failed to remove ${path}: ${String(e)}`);
+                existed = false;
+            }
+        }
+        removed.push({ name, path, existed });
+    }
+    return { binDir, removed, log };
+}
+/**
+ * Atomic-ish symlink replace. Idiomatic recipe — `symlinkSync` errors
+ * with `EEXIST` if the path is already a symlink/file, so we remove
+ * first. Race window between unlink and symlink is irrelevant for a
+ * single-user install command (no concurrent writers).
+ */
+function _replaceSymlink(linkPath, target, log) {
+    let existing = null;
+    try {
+        existing = readlinkSync(linkPath);
+    }
+    catch { /* not a symlink, or doesn't exist */ }
+    if (existing === target) {
+        log.push(`symlink ${linkPath} → ${target} (unchanged)`);
+        return;
+    }
+    // Either it doesn't exist, or it points elsewhere. Remove + recreate.
+    try {
+        unlinkSync(linkPath);
+    }
+    catch { /* fine if absent */ }
+    symlinkSync(target, linkPath);
+    log.push(`symlink ${linkPath} → ${target}`);
+}
+//# sourceMappingURL=install.js.map

package/dist/daemon/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/daemon/install.ts"],"names":[],"mappings":"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"}

package/dist/daemon/registry.d.ts

@@ -0,0 +1,47 @@
+export interface DaemonEntry {
+    /** Absolute realpath of the cwd this daemon manages. */
+    cwd: string;
+}
+export interface DaemonRegistry {
+    daemons: DaemonEntry[];
+}
+/**
+ * Normalizes a user-provided path: expands `~`/`~/...`, resolves relative
+ * components against `process.cwd()`, and runs `realpath` to canonicalize
+ * symlinks. Throws if the resulting path doesn't exist on disk.
+ *
+ * `/remote-pi create` always stores normalized paths so two registrations
+ * of the same logical folder via different aliases produce a single entry.
+ */
+export declare function normalizeCwd(input: string): string;
+/** Reads the registry, returning an empty one when the file is absent. */
+export declare function loadRegistry(): DaemonRegistry;
+export declare function saveRegistry(reg: DaemonRegistry): void;
+/**
+ * Adds a daemon entry. Refuses duplicates (same normalized cwd already
+ * present). Returns the derived id + normalized cwd so the caller can
+ * report it back to the user.
+ */
+export declare function addDaemon(rawCwd: string): {
+    id: string;
+    cwd: string;
+};
+/**
+ * Removes the daemon entry whose derived id matches `id`. Returns the
+ * removed cwd (if any). Does NOT touch the cwd's local config — `create`
+ * the same cwd later restores the registration idempotently.
+ */
+export declare function removeDaemon(id: string): {
+    removed: boolean;
+    cwd?: string;
+};
+/** Snapshot of all registered daemons with derived ids. Order matches the
+ *  file's insertion order — first-registered first. */
+export declare function listDaemons(): Array<{
+    id: string;
+    cwd: string;
+}>;
+/** Test/diag-only: returns the on-disk path. Exported so tests can poke
+ *  at it (e.g. tmpdir override is done via env, but for now the path is
+ *  hardcoded to ~/.pi/remote/daemons.json). */
+export declare function registryPath(): string;

package/dist/daemon/registry.js

@@ -0,0 +1,123 @@
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve as resolvePath } from "node:path";
+import { daemonIdForCwd } from "./id.js";
+/**
+ * The global daemon registry: which working directories are promoted to
+ * always-on daemons under the supervisor.
+ *
+ * Schema rationale (decision Q in plan/26): the registry stores **only**
+ * `cwd` per entry. Everything else (agent_name, auto_start_relay, etc.)
+ * is the cwd's local config at `<cwd>/.pi/remote-pi/config.json` — single
+ * source of truth, no duplication. The daemon `id` is *derived* from cwd
+ * via `daemonIdForCwd`, never persisted.
+ *
+ * Cwds are always normalized to an **absolute realpath** before storage.
+ * A user typing `/remote-pi create ~/Movies` or `/remote-pi create .`
+ * results in the same entry as `/remote-pi create /Users/x/Movies` — no
+ * surprise duplicates, symlinks collapse correctly.
+ */
+/** Resolved at call time so tests can override via `REMOTE_PI_HOME`. The
+ *  prod path is always `~/.pi/remote/daemons.json`. */
+function registryPathInternal() {
+    const root = process.env["REMOTE_PI_HOME"] || homedir();
+    return join(root, ".pi", "remote", "daemons.json");
+}
+/**
+ * Normalizes a user-provided path: expands `~`/`~/...`, resolves relative
+ * components against `process.cwd()`, and runs `realpath` to canonicalize
+ * symlinks. Throws if the resulting path doesn't exist on disk.
+ *
+ * `/remote-pi create` always stores normalized paths so two registrations
+ * of the same logical folder via different aliases produce a single entry.
+ */
+export function normalizeCwd(input) {
+    if (!input || !input.trim()) {
+        throw new Error("cwd is required");
+    }
+    let p = input.trim();
+    // Expand `~` / `~/relative`. Shell wouldn't expand inside slash command args.
+    if (p === "~")
+        p = homedir();
+    else if (p.startsWith("~/"))
+        p = join(homedir(), p.slice(2));
+    if (!isAbsolute(p))
+        p = resolvePath(process.cwd(), p);
+    // realpath canonicalizes symlinks + throws if path doesn't exist.
+    return realpathSync(p);
+}
+/** Reads the registry, returning an empty one when the file is absent. */
+export function loadRegistry() {
+    if (!existsSync(registryPathInternal()))
+        return { daemons: [] };
+    try {
+        const raw = readFileSync(registryPathInternal(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return { daemons: [] };
+        const arr = parsed.daemons;
+        if (!Array.isArray(arr))
+            return { daemons: [] };
+        const daemons = [];
+        for (const item of arr) {
+            if (!item || typeof item !== "object")
+                continue;
+            const cwd = item.cwd;
+            if (typeof cwd === "string" && cwd.length > 0) {
+                daemons.push({ cwd });
+            }
+        }
+        return { daemons };
+    }
+    catch {
+        return { daemons: [] };
+    }
+}
+export function saveRegistry(reg) {
+    mkdirSync(dirname(registryPathInternal()), { recursive: true });
+    writeFileSync(registryPathInternal(), JSON.stringify(reg, null, 2) + "\n");
+}
+/**
+ * Adds a daemon entry. Refuses duplicates (same normalized cwd already
+ * present). Returns the derived id + normalized cwd so the caller can
+ * report it back to the user.
+ */
+export function addDaemon(rawCwd) {
+    const cwd = normalizeCwd(rawCwd);
+    const reg = loadRegistry();
+    if (reg.daemons.some((d) => d.cwd === cwd)) {
+        throw new Error(`Daemon already registered for cwd: ${cwd}`);
+    }
+    reg.daemons.push({ cwd });
+    saveRegistry(reg);
+    return { id: daemonIdForCwd(cwd), cwd };
+}
+/**
+ * Removes the daemon entry whose derived id matches `id`. Returns the
+ * removed cwd (if any). Does NOT touch the cwd's local config — `create`
+ * the same cwd later restores the registration idempotently.
+ */
+export function removeDaemon(id) {
+    const reg = loadRegistry();
+    const idx = reg.daemons.findIndex((d) => daemonIdForCwd(d.cwd) === id);
+    if (idx === -1)
+        return { removed: false };
+    const [removed] = reg.daemons.splice(idx, 1);
+    saveRegistry(reg);
+    return { removed: true, cwd: removed.cwd };
+}
+/** Snapshot of all registered daemons with derived ids. Order matches the
+ *  file's insertion order — first-registered first. */
+export function listDaemons() {
+    return loadRegistry().daemons.map((d) => ({
+        id: daemonIdForCwd(d.cwd),
+        cwd: d.cwd,
+    }));
+}
+/** Test/diag-only: returns the on-disk path. Exported so tests can poke
+ *  at it (e.g. tmpdir override is done via env, but for now the path is
+ *  hardcoded to ~/.pi/remote/daemons.json). */
+export function registryPath() {
+    return registryPathInternal();
+}
+//# sourceMappingURL=registry.js.map

package/dist/daemon/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/daemon/registry.ts"],"names":[],"mappings":"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"}

package/dist/daemon/rpc_child.d.ts

@@ -0,0 +1,76 @@
+import { EventEmitter } from "node:events";
+import type { DaemonState } from "./control_protocol.js";
+/**
+ * Wrapper around a `pi --mode rpc -e <extension>` child process for the
+ * supervisor.
+ *
+ * Lifecycle:
+ *   - `spawn()` boots the child with the daemon's cwd + `REMOTE_PI_DAEMON=1`
+ *     env so the extension knows to skip the interactive wizard.
+ *   - `sendPrompt(text)` writes a Pi RPC `prompt` command to stdin.
+ *   - The child's stdout (Pi RPC events) is currently consumed line-by-line
+ *     and ignored — wave 2 only needs fire-and-forget. Later waves can
+ *     surface the events back through the supervisor's status op.
+ *   - Exit/crash fires `exit` event with `{code, signal, isCrash}` so the
+ *     supervisor can decide whether to auto-restart.
+ *
+ * Each `RpcChild` instance maps 1:1 to a registry entry (single cwd).
+ * The supervisor owns the map of these and addresses them by `id`.
+ */
+export interface RpcChildOptions {
+    /** Path to the `pi` binary. Defaults to "pi" (must be on PATH). */
+    piBin?: string;
+    /** Absolute path to the remote-pi `dist/index.js` to load as -e. */
+    extensionPath: string;
+    /** Working directory for the spawned process. Determines which local
+     *  config the extension reads. */
+    cwd: string;
+    /** Additional env vars merged on top of `process.env` + the mandatory
+     *  `REMOTE_PI_DAEMON=1`. */
+    env?: NodeJS.ProcessEnv;
+}
+export interface RpcChildExitEvent {
+    code: number | null;
+    signal: NodeJS.Signals | null;
+    /** True when exit was not clean (non-zero or signal). */
+    isCrash: boolean;
+}
+export declare class RpcChild extends EventEmitter {
+    private readonly opts;
+    private child;
+    private _state;
+    private _startedAt;
+    private _restartCount;
+    /** Accumulates partial stdout lines while waiting for `\n`. */
+    private stdoutBuf;
+    constructor(opts: RpcChildOptions);
+    get state(): DaemonState;
+    get pid(): number | undefined;
+    get restartCount(): number;
+    get uptimeMs(): number | undefined;
+    /**
+     * Spawn the child process. Idempotent for the same instance: a second
+     * call while already running is a no-op.
+     */
+    spawn(): void;
+    /**
+     * Sends a Pi RPC `prompt` command to the child's stdin. Fire-and-forget
+     * — we don't wait for the response (response would be the success ack;
+     * the actual agent output streams via the relay/UDS, not back through
+     * stdout).
+     *
+     * Returns false if the child isn't running (caller decides how to report).
+     */
+    sendPrompt(text: string, requestId?: string): boolean;
+    /**
+     * Asks the child to exit gracefully. Sends SIGTERM; if the child doesn't
+     * exit within `timeoutMs`, escalates to SIGKILL. Resolves when the
+     * `exit` event fires.
+     */
+    stop(timeoutMs?: number): Promise<void>;
+    private _onStdout;
+    private _onExit;
+    /** Bumps the restart counter — called by the supervisor when it
+     *  decides to re-spawn after a crash. Exposed so tests can drive it. */
+    noteRestart(): void;
+}