remote-pi 0.1.2 → 0.2.0

package/dist/daemon/client.js

@@ -0,0 +1,128 @@
+import { existsSync } from "node:fs";
+import { createConnection } from "node:net";
+import { encodeRequest, parseReply, } from "./control_protocol.js";
+import { getSupervisorSockPath } from "./supervisor.js";
+/**
+ * Tiny client for the `remote-pi` CLI to call the supervisor over the
+ * `~/.pi/remote/supervisor.sock` UDS.
+ *
+ * Each call opens a fresh connection, sends one request line, reads one
+ * reply line, closes. No connection pooling — the CLI is short-lived,
+ * latency is dominated by the socket round-trip (<1ms).
+ *
+ * `SupervisorOfflineError` is the common error: thrown when the socket
+ * file is missing OR the connect fails (no listener). The CLI handler
+ * formats it as a friendly "Run `remote-pi install` first" message.
+ */
+const CONNECT_TIMEOUT_MS = 1000;
+const REPLY_TIMEOUT_MS = 5000;
+export class SupervisorOfflineError extends Error {
+    sockPath;
+    constructor(sockPath) {
+        super(`Supervisor is not running. UDS not responding at ${sockPath}.\n` +
+            "Run `remote-pi install` to set it up, or start it manually with `pi-supervisord`.");
+        this.sockPath = sockPath;
+        this.name = "SupervisorOfflineError";
+    }
+}
+/**
+ * Sends a single request and returns the typed reply data.
+ *
+ * Throws:
+ *   - `SupervisorOfflineError` when the supervisor isn't reachable.
+ *   - `Error` from `parseReply` when the reply line is malformed.
+ *   - The supervisor's own error string when `ok: false`.
+ */
+export async function callSupervisor(req) {
+    const sockPath = getSupervisorSockPath();
+    if (!existsSync(sockPath))
+        throw new SupervisorOfflineError(sockPath);
+    const sock = await _connect(sockPath);
+    try {
+        sock.write(encodeRequest(req));
+        const line = await _readLine(sock);
+        const reply = parseReply(line);
+        if (!reply.ok)
+            throw new Error(reply.error);
+        return reply.data;
+    }
+    finally {
+        sock.destroy();
+    }
+}
+/** Returns true when the supervisor is reachable. Used by `/remote-pi
+ *  daemons` to decide whether to query runtime state or fall back to
+ *  registry-only listing. */
+export async function supervisorOnline() {
+    const sockPath = getSupervisorSockPath();
+    if (!existsSync(sockPath))
+        return false;
+    try {
+        const sock = await _connect(sockPath);
+        sock.destroy();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── internals ───────────────────────────────────────────────────────────────
+function _connect(sockPath) {
+    return new Promise((resolve, reject) => {
+        const sock = createConnection({ path: sockPath });
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            sock.destroy();
+            reject(new SupervisorOfflineError(sockPath));
+        }, CONNECT_TIMEOUT_MS);
+        sock.once("connect", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            sock.setEncoding("utf8");
+            resolve(sock);
+        });
+        sock.once("error", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(new SupervisorOfflineError(sockPath));
+        });
+    });
+}
+function _readLine(sock) {
+    return new Promise((resolve, reject) => {
+        let buf = "";
+        const timer = setTimeout(() => {
+            reject(new Error("supervisor reply timeout"));
+            sock.destroy();
+        }, REPLY_TIMEOUT_MS);
+        sock.on("data", (chunk) => {
+            buf += chunk;
+            const nl = buf.indexOf("\n");
+            if (nl >= 0) {
+                clearTimeout(timer);
+                resolve(buf.slice(0, nl));
+            }
+        });
+        sock.on("end", () => {
+            clearTimeout(timer);
+            const nl = buf.indexOf("\n");
+            if (nl >= 0)
+                return resolve(buf.slice(0, nl));
+            if (buf.length > 0)
+                return resolve(buf);
+            reject(new Error("supervisor closed connection without replying"));
+        });
+        sock.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/daemon/client.js.map

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

package/dist/daemon/control_protocol.d.ts

@@ -0,0 +1,100 @@
+/**
+ * CLI ↔ supervisor IPC contract for `~/.pi/remote/supervisor.sock`.
+ *
+ * Framing: one JSON object per line, newline-terminated. The CLI sends a
+ * single `ControlRequest`, the supervisor sends a single `ControlReply`,
+ * both close the connection. No multiplexing, no streaming — each command
+ * is a short round-trip.
+ *
+ * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
+ * children themselves is a separate contract — see
+ * `node_modules/@mariozechner/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
+ * This file is strictly the supervisor's own control plane.
+ */
+/** Per-daemon runtime state observable through the supervisor. */
+export type DaemonState = "running" | "stopped" | "starting" | "crashed";
+export interface DaemonInfo {
+    id: string;
+    cwd: string;
+    name: string;
+    state: DaemonState;
+    pid?: number;
+    uptime_s?: number;
+    restart_count?: number;
+}
+/** Requests sent CLI → supervisor. */
+export type ControlRequest = {
+    op: "list";
+} | {
+    op: "status";
+} | {
+    op: "start_all";
+} | {
+    op: "stop_all";
+} | {
+    op: "restart_all";
+} | {
+    op: "send";
+    id: string;
+    text: string;
+} | {
+    op: "register";
+    cwd: string;
+} | {
+    op: "unregister";
+    id: string;
+};
+/** Replies sent supervisor → CLI. Tagged by `ok` boolean. */
+export type ControlReply<T = unknown> = {
+    ok: true;
+    data?: T;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Response shapes per op. Keep in sync with the supervisor handlers in
+ * `daemon/supervisor.ts`. Used for typed client calls.
+ */
+export interface ControlReplyShapes {
+    list: {
+        daemons: DaemonInfo[];
+    };
+    status: {
+        daemons: DaemonInfo[];
+    };
+    start_all: {
+        started: string[];
+        already_running: string[];
+    };
+    stop_all: {
+        stopped: string[];
+        already_stopped: string[];
+    };
+    restart_all: {
+        restarted: string[];
+    };
+    send: {
+        id: string;
+        delivered: boolean;
+    };
+    register: {
+        id: string;
+        cwd: string;
+    };
+    unregister: {
+        removed: boolean;
+        cwd?: string;
+    };
+}
+/** Convenience for typed `Client.request<...>("op")` calls. */
+export type ControlReplyFor<Op extends ControlRequest["op"]> = Op extends keyof ControlReplyShapes ? ControlReplyShapes[Op] : never;
+export declare function encodeRequest(req: ControlRequest): string;
+export declare function encodeReply<T>(reply: ControlReply<T>): string;
+/**
+ * Parses a single JSON line into a request. Throws on malformed input —
+ * the supervisor catches and replies `{ok:false, error}` so the client
+ * gets a clean error rather than an unframed disconnect.
+ */
+export declare function parseRequest(line: string): ControlRequest;
+export declare function parseReply(line: string): ControlReply<unknown>;

package/dist/daemon/control_protocol.js

@@ -0,0 +1,63 @@
+/**
+ * CLI ↔ supervisor IPC contract for `~/.pi/remote/supervisor.sock`.
+ *
+ * Framing: one JSON object per line, newline-terminated. The CLI sends a
+ * single `ControlRequest`, the supervisor sends a single `ControlReply`,
+ * both close the connection. No multiplexing, no streaming — each command
+ * is a short round-trip.
+ *
+ * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
+ * children themselves is a separate contract — see
+ * `node_modules/@mariozechner/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
+ * This file is strictly the supervisor's own control plane.
+ */
+// ── Serialization helpers ────────────────────────────────────────────────────
+const TRAILING_NEWLINE = "\n";
+export function encodeRequest(req) {
+    return JSON.stringify(req) + TRAILING_NEWLINE;
+}
+export function encodeReply(reply) {
+    return JSON.stringify(reply) + TRAILING_NEWLINE;
+}
+/**
+ * Parses a single JSON line into a request. Throws on malformed input —
+ * the supervisor catches and replies `{ok:false, error}` so the client
+ * gets a clean error rather than an unframed disconnect.
+ */
+export function parseRequest(line) {
+    let obj;
+    try {
+        obj = JSON.parse(line);
+    }
+    catch (e) {
+        throw new Error(`malformed control request: ${e.message}`);
+    }
+    if (!obj || typeof obj !== "object") {
+        throw new Error("control request must be a JSON object");
+    }
+    const op = obj.op;
+    if (typeof op !== "string") {
+        throw new Error("control request missing string `op` field");
+    }
+    // We don't validate every field shape here — supervisor handlers do it
+    // per-op since the error messages are more specific that way.
+    return obj;
+}
+export function parseReply(line) {
+    let obj;
+    try {
+        obj = JSON.parse(line);
+    }
+    catch (e) {
+        throw new Error(`malformed control reply: ${e.message}`);
+    }
+    if (!obj || typeof obj !== "object") {
+        throw new Error("control reply must be a JSON object");
+    }
+    const ok = obj.ok;
+    if (typeof ok !== "boolean") {
+        throw new Error("control reply missing boolean `ok` field");
+    }
+    return obj;
+}
+//# sourceMappingURL=control_protocol.js.map

package/dist/daemon/control_protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control_protocol.js","sourceRoot":"","sources":["../../src/daemon/control_protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkDH,gFAAgF;AAEhF,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,UAAU,aAAa,CAAC,GAAmB;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAAsB;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,8BAA+B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IACpF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,uEAAuE;IACvE,8DAA8D;IAC9D,OAAO,GAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAClF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAA4B,CAAC;AACtC,CAAC"}

package/dist/daemon/id.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Stable 8-character hex id for a daemon, derived from the cwd it manages.
+ *
+ * Derivation: `sha256(realpath(cwd))` truncated to 8 hex chars (32 bits ≈
+ * 4 billion). Collision risk is negligible at fleet sizes a single user
+ * will ever have (<1000 daemons), and 8 hex characters are short enough
+ * to type on the CLI (`/remote-pi send a1b2c3d4 "..."`).
+ *
+ * Same scheme as `roomIdForCwd` in `src/rooms.ts` — but we use hex
+ * instead of base64url so the id has no `_`/`-` (cleaner double-click
+ * selection in terminals).
+ *
+ * Symlinks resolve to a single canonical id via `realpath`, so
+ * `/Users/x/Movies` and `/Users/x/link-to-Movies` map to the same daemon.
+ * Falls back to the raw path when realpath fails (cwd doesn't exist —
+ * shouldn't happen in production but covers test sandboxes).
+ */
+export declare function daemonIdForCwd(cwd: string): string;

package/dist/daemon/id.js

@@ -0,0 +1,30 @@
+import { createHash } from "node:crypto";
+import { realpathSync } from "node:fs";
+/**
+ * Stable 8-character hex id for a daemon, derived from the cwd it manages.
+ *
+ * Derivation: `sha256(realpath(cwd))` truncated to 8 hex chars (32 bits ≈
+ * 4 billion). Collision risk is negligible at fleet sizes a single user
+ * will ever have (<1000 daemons), and 8 hex characters are short enough
+ * to type on the CLI (`/remote-pi send a1b2c3d4 "..."`).
+ *
+ * Same scheme as `roomIdForCwd` in `src/rooms.ts` — but we use hex
+ * instead of base64url so the id has no `_`/`-` (cleaner double-click
+ * selection in terminals).
+ *
+ * Symlinks resolve to a single canonical id via `realpath`, so
+ * `/Users/x/Movies` and `/Users/x/link-to-Movies` map to the same daemon.
+ * Falls back to the raw path when realpath fails (cwd doesn't exist —
+ * shouldn't happen in production but covers test sandboxes).
+ */
+export function daemonIdForCwd(cwd) {
+    let target;
+    try {
+        target = realpathSync(cwd);
+    }
+    catch {
+        target = cwd;
+    }
+    return createHash("sha256").update(target).digest("hex").slice(0, 8);
+}
+//# sourceMappingURL=id.js.map

package/dist/daemon/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/daemon/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/daemon/install.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Generates and activates a system service for `pi-supervisord` so the
+ * daemon fleet survives reboots (plan/26 W3).
+ *
+ * Platform support:
+ *   - **macOS**: writes `~/Library/LaunchAgents/dev.remotepi.supervisord.plist`
+ *     and runs `launchctl bootstrap gui/<uid> <plist>` (modern API) with a
+ *     fallback to `launchctl load` for older macOS.
+ *   - **Linux**: writes `~/.config/systemd/user/remote-pi-supervisord.service`
+ *     and runs `systemctl --user daemon-reload && systemctl --user enable
+ *     --now remote-pi-supervisord.service`.
+ *
+ * Uninstall reverses both. Idempotent — re-running install over an existing
+ * unit refreshes it (paths could have changed if user moved node_modules).
+ *
+ * **What does NOT happen here**: the actual `npm install -g remote-pi` step.
+ * The user has to make the supervisor bin reachable on disk before install
+ * can wire up the service. The `findSupervisorScript` resolver detects
+ * common cases (npm global, pnpm global, local dev clone) and yields a
+ * clear error otherwise.
+ */
+export type SupervisorPlatform = "macos" | "linux" | "unsupported";
+export declare function detectPlatform(): SupervisorPlatform;
+/**
+ * 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 declare function findSupervisorScript(): string;
+/**
+ * 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 declare function findRemotePiScript(): string;
+export declare function findNodeBinary(): string;
+export declare function findTemplate(name: "systemd" | "launchd"): string;
+export declare function systemdUnitPath(): string;
+export declare function launchdPlistPath(): string;
+export interface RenderVars {
+    node: string;
+    supervisor: string;
+    home: string;
+    user: string;
+    /** PATH inherited so `pi --mode rpc` resolves the same way it does
+     *  interactively. We snapshot `process.env.PATH` at install time. */
+    path: string;
+}
+export declare function defaultRenderVars(): RenderVars;
+/** Replace `{NODE}` / `{SUPERVISOR}` / `{USER}` / `{HOME}` / `{PATH}`. */
+export declare function renderTemplate(template: string, vars: RenderVars): string;
+export interface InstallResult {
+    platform: SupervisorPlatform;
+    unitPath: string;
+    /** Lines describing each step taken — surfaced to the user via notify. */
+    log: string[];
+}
+/**
+ * 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 declare function installService(vars?: RenderVars): InstallResult;
+export interface UninstallResult {
+    platform: SupervisorPlatform;
+    unitPath: string;
+    removed: boolean;
+    log: string[];
+}
+export declare function uninstallService(): UninstallResult;
+export interface LinkBinariesResult {
+    /** `~/.local/bin/`. The two symlinks land here. */
+    binDir: string;
+    /** Paths of the two symlinks we created/refreshed. */
+    links: Array<{
+        name: string;
+        path: string;
+        target: string;
+    }>;
+    /** True when `binDir` is already on `$PATH`. False → caller surfaces the
+     *  "add this line to your shell rc" hint to the user. */
+    onPath: boolean;
+    log: string[];
+}
+export declare function userLocalBinDir(home?: string): string;
+/**
+ * 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 declare function isOnPath(dir: string, envPath?: string): boolean;
+/**
+ * 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 declare function linkCliBinaries(home?: string, paths?: {
+    remotePi?: string;
+    supervisord?: string;
+}): LinkBinariesResult;
+/**
+ * Remove the symlinks `linkCliBinaries` created. Idempotent — missing
+ * links are a no-op. Returns whether each link was actually present so
+ * the caller can render a useful summary. Targets (the extension files)
+ * are NOT touched here — they live outside this dir and belong to Pi.
+ */
+export interface UnlinkBinariesResult {
+    binDir: string;
+    removed: Array<{
+        name: string;
+        path: string;
+        existed: boolean;
+    }>;
+    log: string[];
+}
+export declare function unlinkCliBinaries(home?: string): UnlinkBinariesResult;