remote-pi 0.1.3 → 0.2.1

package/dist/daemon/rpc_child.js

@@ -0,0 +1,130 @@
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+export class RpcChild extends EventEmitter {
+    opts;
+    child = null;
+    _state = "stopped";
+    _startedAt = null;
+    _restartCount = 0;
+    /** Accumulates partial stdout lines while waiting for `\n`. */
+    stdoutBuf = "";
+    constructor(opts) {
+        super();
+        this.opts = opts;
+    }
+    get state() { return this._state; }
+    get pid() { return this.child?.pid; }
+    get restartCount() { return this._restartCount; }
+    get uptimeMs() {
+        return this._startedAt !== null ? Date.now() - this._startedAt : undefined;
+    }
+    /**
+     * Spawn the child process. Idempotent for the same instance: a second
+     * call while already running is a no-op.
+     */
+    spawn() {
+        if (this.child)
+            return;
+        this._state = "starting";
+        const piBin = this.opts.piBin ?? "pi";
+        const args = ["--mode", "rpc", "-e", this.opts.extensionPath];
+        const env = {
+            ...process.env,
+            ...this.opts.env,
+            // Mandatory daemon marker — `_cmdRoot` in index.ts can use this to
+            // bail early if local config is missing (no wizard in RPC mode).
+            REMOTE_PI_DAEMON: "1",
+        };
+        const child = spawn(piBin, args, {
+            cwd: this.opts.cwd,
+            env,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.child = child;
+        this._startedAt = Date.now();
+        this._state = "running";
+        child.stdout?.on("data", (chunk) => this._onStdout(chunk));
+        child.stderr?.on("data", (chunk) => {
+            // Forward stderr to our own stderr so `journalctl --user -u remote-pi-supervisord`
+            // sees daemon logs (with cwd prefix for disambiguation).
+            process.stderr.write(`[${this.opts.cwd}] ${chunk.toString()}`);
+        });
+        child.on("exit", (code, signal) => this._onExit(code, signal));
+        child.on("error", (err) => {
+            // spawn() itself failed (e.g. `pi` binary not found).
+            this._state = "crashed";
+            process.stderr.write(`[remote-pi-supervisord] spawn failed for ${this.opts.cwd}: ${String(err)}\n`);
+            this.emit("exit", { code: null, signal: null, isCrash: true });
+        });
+        this.emit("spawn", { pid: child.pid });
+    }
+    /**
+     * 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, requestId) {
+        if (!this.child || !this.child.stdin || this._state !== "running")
+            return false;
+        const cmd = { id: requestId ?? `sv-${Date.now()}`, type: "prompt", message: text };
+        try {
+            this.child.stdin.write(JSON.stringify(cmd) + "\n");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 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.
+     */
+    async stop(timeoutMs = 5000) {
+        if (!this.child)
+            return;
+        const child = this.child;
+        return new Promise((resolve) => {
+            const onExit = () => { resolve(); };
+            this.once("exit", onExit);
+            try {
+                child.kill("SIGTERM");
+            }
+            catch { /* already dead */ }
+            const t = setTimeout(() => {
+                try {
+                    child.kill("SIGKILL");
+                }
+                catch { /* race — already dead */ }
+            }, timeoutMs);
+            this.once("exit", () => clearTimeout(t));
+        });
+    }
+    _onStdout(chunk) {
+        this.stdoutBuf += chunk.toString();
+        let nl;
+        while ((nl = this.stdoutBuf.indexOf("\n")) >= 0) {
+            const line = this.stdoutBuf.slice(0, nl);
+            this.stdoutBuf = this.stdoutBuf.slice(nl + 1);
+            if (!line.trim())
+                continue;
+            this.emit("stdout", line);
+        }
+    }
+    _onExit(code, signal) {
+        const isCrash = code !== 0 || signal !== null;
+        this._state = isCrash ? "crashed" : "stopped";
+        this.child = null;
+        this._startedAt = null;
+        this.emit("exit", { code, signal, isCrash });
+    }
+    /** Bumps the restart counter — called by the supervisor when it
+     *  decides to re-spawn after a crash. Exposed so tests can drive it. */
+    noteRestart() {
+        this._restartCount += 1;
+    }
+}
+//# sourceMappingURL=rpc_child.js.map

package/dist/daemon/rpc_child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc_child.js","sourceRoot":"","sources":["../../src/daemon/rpc_child.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAyC3C,MAAM,OAAO,QAAS,SAAQ,YAAY;IAQX;IAPrB,KAAK,GAAwB,IAAI,CAAC;IAClC,MAAM,GAAgB,SAAS,CAAC;IAChC,UAAU,GAAkB,IAAI,CAAC;IACjC,aAAa,GAAG,CAAC,CAAC;IAC1B,+DAA+D;IACvD,SAAS,GAAG,EAAE,CAAC;IAEvB,YAA6B,IAAqB;QAChD,KAAK,EAAE,CAAC;QADmB,SAAI,GAAJ,IAAI,CAAiB;IAElD,CAAC;IAED,IAAI,KAAK,KAAkB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,IAAI,GAAG,KAAyB,OAAO,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,YAAY,KAAa,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACzD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAsB;YAC7B,GAAG,OAAO,CAAC,GAAG;YACd,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG;YAChB,mEAAmE;YACnE,iEAAiE;YACjE,gBAAgB,EAAE,GAAG;SACtB,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG;YAClB,GAAG;YACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAExB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,mFAAmF;YACnF,yDAAyD;YACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,sDAAsD;YACtD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4CAA4C,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,CAC9E,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,IAAY,EAAE,SAAkB;QACzC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAChF,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,SAAS,IAAI,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACnF,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YAC3D,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,IAAI,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;YACpE,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,EAAU,CAAC;QACf,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,IAAmB,EAAE,MAA6B;QAChE,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAA8B,CAAC,CAAC;IAC3E,CAAC;IAED;4EACwE;IACxE,WAAW;QACT,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/daemon/supervisor.d.ts

@@ -0,0 +1,38 @@
+export interface SupervisorOptions {
+    /** Absolute path to remote-pi's dist/index.js — passed as -e to each
+     *  spawned `pi`. Defaults to the location relative to where this file
+     *  is bundled (so the supervisor finds itself). */
+    extensionPath: string;
+    /** Override the `pi` binary path. Defaults to "pi" on PATH. */
+    piBin?: string;
+}
+export declare class Supervisor {
+    private readonly opts;
+    private server;
+    private readonly children;
+    private shuttingDown;
+    constructor(opts: SupervisorOptions);
+    /** Bind the control UDS + spawn all registered daemons. */
+    start(): Promise<void>;
+    /** Graceful shutdown: stop all children, close UDS. */
+    stop(): Promise<void>;
+    private _mkdirParent;
+    private _bindUds;
+    private _onConnection;
+    private _handleRequest;
+    private _listInfo;
+    private _opStartAll;
+    private _opStopAll;
+    private _opRestartAll;
+    private _opSend;
+    private _opRegister;
+    private _opUnregister;
+    private _spawnAllFromRegistry;
+    private _spawnEntry;
+    private _onChildExit;
+}
+/** Test helper: derive id from cwd without going through the registry. */
+export declare function _idForCwdForTest(cwd: string): string;
+/** Exported for the bin/supervisord entry + tests to know where the
+ *  supervisor will bind. */
+export declare function getSupervisorSockPath(): string;

package/dist/daemon/supervisor.js

@@ -0,0 +1,301 @@
+import { existsSync, mkdirSync, unlinkSync } from "node:fs";
+import { createServer } from "node:net";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { addDaemon, listDaemons, removeDaemon } from "./registry.js";
+import { daemonIdForCwd } from "./id.js";
+import { loadLocalConfig, defaultAgentName } from "../session/local_config.js";
+import { RpcChild } from "./rpc_child.js";
+import { encodeReply, parseRequest, } from "./control_protocol.js";
+/**
+ * Central process that owns the daemon fleet (plan/26).
+ *
+ * Responsibilities:
+ *   - Spawn one `pi --mode rpc` child per registry entry. Track them in
+ *     `_children: Map<id, RpcChild>`.
+ *   - Auto-restart crashed children with exponential backoff
+ *     (1s, 5s, 30s, 5min). Give up after 4 attempts to avoid log spam
+ *     when the agent is misconfigured.
+ *   - Listen on `~/.pi/remote/supervisor.sock` for `ControlRequest`s from
+ *     the `remote-pi` CLI. Each connection: 1 request → 1 reply → close.
+ *   - Graceful shutdown on SIGTERM/SIGINT: stop all children + unlink
+ *     the UDS file so a next supervisor can bind cleanly.
+ *
+ * The supervisor itself is the only long-running process the user
+ * installs as a system service (plan/26 W3 will generate the unit/plist).
+ * If it crashes, systemd/launchd restarts it; on restart it re-reads
+ * the registry and re-spawns everything.
+ */
+const SUPERVISOR_SOCK_NAME = "supervisor.sock";
+/** Backoff schedule for auto-restart after a crash. After exhausting, the
+ *  child stays in `crashed` state until manual `restart_all` or fresh
+ *  registry add. Keeps logs sane when the agent dies on every boot. */
+const RESTART_BACKOFFS_MS = [1_000, 5_000, 30_000, 5 * 60_000];
+function supervisorSockPath() {
+    const root = process.env["REMOTE_PI_HOME"] || homedir();
+    return join(root, ".pi", "remote", SUPERVISOR_SOCK_NAME);
+}
+export class Supervisor {
+    opts;
+    server = null;
+    children = new Map();
+    shuttingDown = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /** Bind the control UDS + spawn all registered daemons. */
+    async start() {
+        this._mkdirParent();
+        await this._bindUds();
+        this._spawnAllFromRegistry();
+    }
+    /** Graceful shutdown: stop all children, close UDS. */
+    async stop() {
+        this.shuttingDown = true;
+        // Cancel pending restart timers first so they don't race with stop().
+        for (const slot of this.children.values()) {
+            if (slot.restartTimer !== null) {
+                clearTimeout(slot.restartTimer);
+                slot.restartTimer = null;
+            }
+        }
+        await Promise.all([...this.children.values()].map((s) => s.child.stop()));
+        this.children.clear();
+        await new Promise((resolve) => {
+            if (!this.server)
+                return resolve();
+            this.server.close(() => resolve());
+        });
+        this.server = null;
+        // Best-effort: clear the socket file so a next supervisor bind succeeds.
+        try {
+            unlinkSync(supervisorSockPath());
+        }
+        catch { /* ignored */ }
+    }
+    // ── UDS binding ──────────────────────────────────────────────────────────
+    _mkdirParent() {
+        mkdirSync(dirname(supervisorSockPath()), { recursive: true });
+    }
+    async _bindUds() {
+        const path = supervisorSockPath();
+        // If a stale socket file exists from a previous crashed supervisor,
+        // try to connect first — if that fails, unlink and bind. Same self-
+        // healing pattern as cwd_lock / leader_election.
+        if (existsSync(path)) {
+            try {
+                unlinkSync(path);
+            }
+            catch { /* will throw on bind if still held */ }
+        }
+        const server = createServer((socket) => this._onConnection(socket));
+        await new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen(path, () => resolve());
+        });
+        this.server = server;
+    }
+    _onConnection(socket) {
+        let buf = "";
+        socket.setEncoding("utf8");
+        socket.on("data", (chunk) => {
+            buf += chunk;
+            const nl = buf.indexOf("\n");
+            if (nl < 0)
+                return;
+            const line = buf.slice(0, nl);
+            // Single request per connection; ignore anything past the newline.
+            void this._handleRequest(line)
+                .then((reply) => socket.end(encodeReply(reply)))
+                .catch((err) => socket.end(encodeReply({ ok: false, error: String(err) })));
+        });
+        socket.on("error", () => { });
+    }
+    // ── Request dispatch ─────────────────────────────────────────────────────
+    async _handleRequest(line) {
+        let req;
+        try {
+            req = parseRequest(line);
+        }
+        catch (e) {
+            return { ok: false, error: e.message };
+        }
+        switch (req.op) {
+            case "list": return { ok: true, data: { daemons: this._listInfo() } };
+            case "status": return { ok: true, data: { daemons: this._listInfo() } };
+            case "start_all": return this._opStartAll();
+            case "stop_all": return this._opStopAll();
+            case "restart_all": return this._opRestartAll();
+            case "send": return this._opSend(req.id, req.text);
+            case "register": return this._opRegister(req.cwd);
+            case "unregister": return this._opUnregister(req.id);
+            default: {
+                const unknown = req.op;
+                return { ok: false, error: `unknown op: ${unknown}` };
+            }
+        }
+    }
+    // ── Op handlers ──────────────────────────────────────────────────────────
+    _listInfo() {
+        const registry = listDaemons();
+        return registry.map((entry) => {
+            const slot = this.children.get(entry.id);
+            const cfg = loadLocalConfig(entry.cwd);
+            const name = cfg.agent_name ?? defaultAgentName(entry.cwd);
+            const info = {
+                id: entry.id,
+                cwd: entry.cwd,
+                name,
+                state: slot?.child.state ?? "stopped",
+            };
+            if (slot) {
+                if (slot.child.pid !== undefined)
+                    info.pid = slot.child.pid;
+                if (slot.child.uptimeMs !== undefined)
+                    info.uptime_s = Math.floor(slot.child.uptimeMs / 1000);
+                info.restart_count = slot.child.restartCount;
+            }
+            return info;
+        });
+    }
+    _opStartAll() {
+        const started = [];
+        const already = [];
+        for (const entry of listDaemons()) {
+            const slot = this.children.get(entry.id);
+            if (slot && slot.child.state === "running") {
+                already.push(entry.id);
+                continue;
+            }
+            this._spawnEntry(entry.id, entry.cwd);
+            started.push(entry.id);
+        }
+        return { ok: true, data: { started, already_running: already } };
+    }
+    async _opStopAll() {
+        const stopped = [];
+        const already = [];
+        for (const [id, slot] of this.children) {
+            if (slot.child.state !== "running") {
+                already.push(id);
+                continue;
+            }
+            if (slot.restartTimer !== null) {
+                clearTimeout(slot.restartTimer);
+                slot.restartTimer = null;
+            }
+            await slot.child.stop();
+            stopped.push(id);
+        }
+        return { ok: true, data: { stopped, already_stopped: already } };
+    }
+    async _opRestartAll() {
+        const stopReply = await this._opStopAll();
+        if (!stopReply.ok)
+            return stopReply;
+        const startReply = this._opStartAll();
+        if (!startReply.ok)
+            return startReply;
+        const restarted = startReply.data.started;
+        return { ok: true, data: { restarted } };
+    }
+    _opSend(id, text) {
+        const slot = this.children.get(id);
+        if (!slot)
+            return { ok: false, error: `daemon ${id} not running` };
+        if (slot.child.state !== "running") {
+            return { ok: false, error: `daemon ${id} state is ${slot.child.state}` };
+        }
+        const ok = slot.child.sendPrompt(text);
+        return { ok: true, data: { id, delivered: ok } };
+    }
+    _opRegister(rawCwd) {
+        try {
+            const { id, cwd } = addDaemon(rawCwd);
+            return { ok: true, data: { id, cwd } };
+        }
+        catch (e) {
+            return { ok: false, error: e.message };
+        }
+    }
+    async _opUnregister(id) {
+        // Stop the child first so we don't leave an orphan when the registry
+        // entry is gone.
+        const slot = this.children.get(id);
+        if (slot) {
+            if (slot.restartTimer !== null) {
+                clearTimeout(slot.restartTimer);
+                slot.restartTimer = null;
+            }
+            await slot.child.stop();
+            this.children.delete(id);
+        }
+        try {
+            const result = removeDaemon(id);
+            return { ok: true, data: result };
+        }
+        catch (e) {
+            return { ok: false, error: e.message };
+        }
+    }
+    // ── Child lifecycle ──────────────────────────────────────────────────────
+    _spawnAllFromRegistry() {
+        for (const entry of listDaemons()) {
+            this._spawnEntry(entry.id, entry.cwd);
+        }
+    }
+    _spawnEntry(id, cwd) {
+        // Clean up any prior slot (e.g. crashed + waiting for backoff).
+        const existing = this.children.get(id);
+        if (existing) {
+            if (existing.restartTimer !== null)
+                clearTimeout(existing.restartTimer);
+            // If somehow the child is still alive, stop it first so we don't
+            // leak. Fire-and-forget — caller doesn't await.
+            if (existing.child.state === "running")
+                void existing.child.stop();
+        }
+        const childOpts = {
+            extensionPath: this.opts.extensionPath,
+            cwd,
+        };
+        if (this.opts.piBin !== undefined)
+            childOpts.piBin = this.opts.piBin;
+        const child = new RpcChild(childOpts);
+        const slot = { id, cwd, child, restartTimer: null, restartAttempt: 0 };
+        this.children.set(id, slot);
+        child.on("exit", (evt) => this._onChildExit(id, evt));
+        child.spawn();
+    }
+    _onChildExit(id, evt) {
+        if (this.shuttingDown)
+            return;
+        const slot = this.children.get(id);
+        if (!slot)
+            return;
+        if (!evt.isCrash) {
+            // Clean shutdown (e.g. via `stop_all`). Don't auto-restart.
+            return;
+        }
+        // Crash: schedule restart with backoff. After exhausting the schedule
+        // we give up and stay in `crashed`.
+        if (slot.restartAttempt >= RESTART_BACKOFFS_MS.length) {
+            process.stderr.write(`[remote-pi-supervisord] giving up restart for ${id} after ${slot.restartAttempt} attempts\n`);
+            return;
+        }
+        const delay = RESTART_BACKOFFS_MS[slot.restartAttempt];
+        process.stderr.write(`[remote-pi-supervisord] scheduling restart of ${id} in ${delay}ms (attempt ${slot.restartAttempt + 1})\n`);
+        slot.restartTimer = setTimeout(() => {
+            slot.restartTimer = null;
+            slot.restartAttempt += 1;
+            slot.child.noteRestart();
+            slot.child.spawn();
+        }, delay);
+    }
+}
+/** Test helper: derive id from cwd without going through the registry. */
+export function _idForCwdForTest(cwd) { return daemonIdForCwd(cwd); }
+/** Exported for the bin/supervisord entry + tests to know where the
+ *  supervisor will bind. */
+export function getSupervisorSockPath() { return supervisorSockPath(); }
+//# sourceMappingURL=supervisor.js.map

package/dist/daemon/supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/daemon/supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,YAAY,EAA4B,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAgD,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAIL,WAAW,EACX,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAE/C;;uEAEuE;AACvE,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;AAE/D,SAAS,kBAAkB;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,EAAE,CAAC;IACxD,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AAC3D,CAAC;AAmBD,MAAM,OAAO,UAAU;IAKQ;IAJrB,MAAM,GAAkB,IAAI,CAAC;IACpB,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;IACjD,YAAY,GAAG,KAAK,CAAC;IAE7B,YAA6B,IAAuB;QAAvB,SAAI,GAAJ,IAAI,CAAmB;IAAG,CAAC;IAExD,2DAA2D;IAC3D,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,sEAAsE;QACtE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC/B,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,yEAAyE;QACzE,IAAI,CAAC;YAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IACnE,CAAC;IAED,4EAA4E;IAEpE,YAAY;QAClB,SAAS,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;QAClC,oEAAoE;QACpE,oEAAoE;QACpE,iDAAiD;QACjD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,sCAAsC,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QACpE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,aAAa,CAAC,MAAc;QAClC,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAClC,GAAG,IAAI,KAAK,CAAC;YACb,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,EAAE,GAAG,CAAC;gBAAE,OAAO;YACnB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,mEAAmE;YACnE,KAAK,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;iBAC3B,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;iBAC/C,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAU,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAuC,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,4EAA4E;IAEpE,KAAK,CAAC,cAAc,CAAC,IAAY;QACvC,IAAI,GAAmB,CAAC;QACxB,IAAI,CAAC;YAAC,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QACjC,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAEhE,QAAQ,GAAG,CAAC,EAAE,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,CAAS,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC;YAC9E,KAAK,QAAQ,CAAC,CAAO,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC;YAC9E,KAAK,WAAW,CAAC,CAAI,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/C,KAAK,UAAU,CAAC,CAAK,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9C,KAAK,aAAa,CAAC,CAAE,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC;YACjD,KAAK,MAAM,CAAC,CAAS,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3D,KAAK,UAAU,CAAC,CAAK,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtD,KAAK,YAAY,CAAC,CAAG,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,OAAO,GAAI,GAAsB,CAAC,EAAE,CAAC;gBAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,OAAO,EAAE,EAAE,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAEpE,SAAS;QACf,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzC,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,IAAI,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAe;gBACvB,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI;gBACJ,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;aACtC,CAAC;YACF,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS;oBAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;gBAC5D,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS;oBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;gBAC9F,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;YAC/C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW;QACjB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACvB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC/B,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAC3B,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,EAAE;YAAE,OAAO,UAAU,CAAC;QACtC,MAAM,SAAS,GAAI,UAAU,CAAC,IAA8B,CAAC,OAAO,CAAC;QACrE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC;IAC3C,CAAC;IAEO,OAAO,CAAC,EAAU,EAAE,IAAY;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;QACnE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3E,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC;IAEO,WAAW,CAAC,MAAc;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YACtC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;QACzC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,EAAU;QACpC,qEAAqE;QACrE,iBAAiB;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC/B,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAC3B,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;IAED,4EAA4E;IAEpE,qBAAqB;QAC3B,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,EAAU,EAAE,GAAW;QACzC,gEAAgE;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,YAAY,KAAK,IAAI;gBAAE,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACxE,iEAAiE;YACjE,gDAAgD;YAChD,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,KAAK,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrE,CAAC;QAED,MAAM,SAAS,GAAoB;YACjC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;YACtC,GAAG;SACJ,CAAC;QACF,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,IAAI,GAAc,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAClF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAE5B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAsB,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;QACzE,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAEO,YAAY,CAAC,EAAU,EAAE,GAAsB;QACrD,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,4DAA4D;YAC5D,OAAO;QACT,CAAC;QAED,sEAAsE;QACtE,oCAAoC;QACpC,IAAI,IAAI,CAAC,cAAc,IAAI,mBAAmB,CAAC,MAAM,EAAE,CAAC;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iDAAiD,EAAE,UAAU,IAAI,CAAC,cAAc,aAAa,CAC9F,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,cAAc,CAAE,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iDAAiD,EAAE,OAAO,KAAK,eAAe,IAAI,CAAC,cAAc,GAAG,CAAC,KAAK,CAC3G,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAClC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,GAAW,IAAY,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAErF;4BAC4B;AAC5B,MAAM,UAAU,qBAAqB,KAAa,OAAO,kBAAkB,EAAE,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 /**
  * pi-extension — remote-pi slash commands + AgentBridge wiring
  *
@@ -30,7 +31,8 @@
  */
 import type { ExtensionContext, ExtensionFactory } from "@mariozechner/pi-coding-agent";
 import type { ClientMessage, SessionHistoryEvent } from "./protocol/types.js";
-export type RemoteState = "idle" | "started" | "paired";
+import { PlainPeerChannel } from "./transport/peer_channel.js";
+export type RemoteState = "idle" | "started";
 type BufferMsg = {
     role: "user" | "assistant" | "toolResult" | string;
     content?: unknown;
@@ -44,6 +46,26 @@ type BufferMsg = {
     };
 };
 /** Test-only override of the message buffer. */
+/**
+ * Test-only: emulate what `/remote-pi` does on the returning-user path
+ * (join the local mesh, then start the relay) without touching the FS for
+ * a `localConfigExists()` lookup. Lets tests bring the relay up without
+ * mocking the wizard or the local config storage.
+ *
+ * Typed loosely to accept any ctx shape with `ui.notify` + `cwd` — the
+ * unit tests use minimal mocks that don't satisfy the full
+ * `ExtensionContext` interface.
+ */
+export declare function _connectForTest(ctx: unknown): Promise<void>;
+/** Test-only: tear everything down (mirrors `/remote-pi stop`). */
+export declare function _stopForTest(ctx: unknown): Promise<void>;
+/**
+ * Test-only: relay-only startup, no UDS mesh join. Replaces the old
+ * `remote-pi relay start` handler that some tests captured to bring up
+ * the relay in isolation (e.g. ping/pong tests that don't care about the
+ * agent-network broker).
+ */
+export declare function _startRelayForTest(ctx: unknown): Promise<void>;
 export declare function _setMessageBufferForTest(msgs: unknown[]): void;
 /** Test-only accessor: returns a defensive copy of the buffer. */
 export declare function _getMessageBufferForTest(): unknown[];
@@ -53,17 +75,49 @@ export declare function _setSessionStartedAtForTest(ts: number | null): void;
 export declare function _setCurrentModelForTest(name: string | undefined): void;
 /** Test-only: exposes pending reconnect timer state. */
 export declare function _hasPendingReconnect(): boolean;
-/** Exported for tests. */
-export declare function _getState(): RemoteState;
 /**
- * App-level peer disconnect (relay still up).
- * Transitions paired → started and re-installs the auto-listener.
- * Exported so tests can trigger it directly; in production it will be
- * called when the relay sends a peer-disconnect notification (future).
+ * Public state-snapshot helper. Returns the derived UX state, not the raw
+ * `_state` enum: the W2D refactor collapsed the internal machine to
+ * `idle | started` and made `paired` a derived metric
+ * (`_activePeers.size > 0`). Tests and the footer keep the three-state
+ * mental model via this getter.
+ */
+export declare function _getState(): "idle" | "started" | "paired";
+/** Test-only: number of owners currently attached via PlainPeerChannel. */
+export declare function _getActivePeerCountForTest(): number;
+/** Test-only: true if a specific peer (base64 std) has an attached channel. */
+export declare function _hasActivePeerForTest(appPeerIdStd: string): boolean;
+/**
+ * Per-owner disconnect callback. Fires when one specific owner's channel
+ * detaches (e.g. relay told us the peer is gone). Other owners' channels
+ * keep running — relay stays "started".
+ *
+ * Exported so tests can trigger the disconnect path for a specific peer.
+ *
+ * Backward-compat: a no-arg call (legacy tests / pre-W2D callers) falls
+ * back to detaching the most recently attached peer, mirroring the old
+ * singleton semantics.
  */
-export declare function _onPeerDisconnect(): void;
+export declare function _onPeerDisconnect(appPeerId?: string): void;
 declare const extension: ExtensionFactory;
 export default extension;
+/**
+ * Per-channel router. Replaces the W2D-pre `routeClientMessage` which
+ * implicitly used the `_peerChannel` singleton for replies. Each
+ * PlainPeerChannel now carries its own `sender` and passes it here so
+ * sender-specific responses (cancelled, pong, session_history) flow back
+ * through the right wire instead of being broadcast.
+ *
+ * Broadcast messages (user_input mirror, agent_chunk, tool_*) still use
+ * `_broadcastToActive` from the SDK event handlers; this router only
+ * handles incoming app→pi requests.
+ */
+export declare function _routeClientMessageFrom(sender: PlainPeerChannel, msg: ClientMessage, ctx: Pick<ExtensionContext, "abort">): void;
+/**
+ * Backward-compatible shim for legacy callers + tests that didn't track
+ * a specific sender channel. Routes to the most recently attached owner,
+ * mirroring the pre-W2D singleton behavior.
+ */
 export declare function routeClientMessage(msg: ClientMessage, ctx: Pick<ExtensionContext, "abort">): void;
 /**
  * Maps SDK AgentMessage[] (UserMessage / AssistantMessage / ToolResultMessage)