@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/daemon/cli.js

@@ -0,0 +1,468 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { open } from "node:fs/promises";
+import { createInterface } from "node:readline";
+import { getAgentDir, VERSION } from "../config.js";
+import { createDaemonClient } from "./control-client.js";
+import { createIrohDaemonService } from "./iroh-service.js";
+import { readPidfile, runVoltDaemon } from "./main.js";
+import { getDaemonPaths } from "./paths.js";
+import { verifyPidfileProcess } from "./process-identity.js";
+import { installDaemonService, uninstallDaemonService } from "./service-install.js";
+import { DAEMON_SHUTDOWN_TIMEOUT_MS, ensureDaemonRunning, probeDaemon, waitForDaemonExit } from "./spawn.js";
+import { inspectVoltdStateFiles, regenerateInvalidVoltdState } from "./state.js";
+const STOP_TIMEOUT_MS = DAEMON_SHUTDOWN_TIMEOUT_MS; // 60s drain cap + margin
+const DEFAULT_LOG_TAIL_LINES = 200;
+function printDaemonUsage() {
+    console.error(`Usage: volt daemon <command>
+
+Commands:
+  start                 Start the background daemon (no-op if already running).
+  stop                  Ask the daemon to shut down gracefully.
+  status [--json]       Show daemon status; exit 0 when running, 1 when not.
+  restart               Stop then start; persistent state survives.
+  regenerate-state      Back up invalid state and regenerate it after confirmation.
+  keep-awake [on|off]   Prevent the host from sleeping while voltd runs; no arg prints state.
+  logs [-f] [-n N]      Tail the daemon log (default ${DEFAULT_LOG_TAIL_LINES} lines).
+  install-service       Register a login service (launchd/systemd) that starts the daemon.
+  uninstall-service     Remove the login service.
+  run --foreground      Run the daemon in this process (internal; used by start).
+`);
+}
+async function requestStatus(agentDir) {
+    const probe = await probeDaemon(agentDir);
+    if (!probe.healthy) {
+        return undefined;
+    }
+    const client = createDaemonClient({
+        socketPath: probe.socketPath,
+        client: "cli",
+        version: VERSION,
+        authToken: probe.authToken,
+        reconnect: false,
+    });
+    try {
+        const statusProbe = await client.request({ type: "status" });
+        return statusProbe.type === "status_result" ? statusProbe : undefined;
+    }
+    finally {
+        await client.close();
+    }
+}
+async function daemonStart(agentDir) {
+    const result = await ensureDaemonRunning(agentDir);
+    if (!result.healthy) {
+        if (result.state === "protocol-mismatch") {
+            console.error("Error: a different voltd protocol version is already running; stop it before starting this version.");
+        }
+        else if (result.state === "unresponsive") {
+            console.error("Error: voltd socket is occupied but not responding; not starting a second daemon.");
+        }
+        else if (result.state === "auth-failed") {
+            console.error("Error: voltd rejected the local daemon metadata; not starting a second daemon.");
+        }
+        else if (result.state === "shutting-down") {
+            console.error("Error: existing voltd did not finish shutting down within the timeout.");
+        }
+        else {
+            console.error(`Error: ${result.error ?? "failed to start voltd (daemon did not become healthy within 5s)."}`);
+            if (result.invalidState) {
+                console.error("Run `volt daemon regenerate-state` to review and confirm regeneration.");
+            }
+        }
+        console.error(`Check the log: ${getDaemonPaths(agentDir).logPath}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.error(`voltd ${result.version ?? VERSION} ${result.spawned ? "started" : "already running"} (pid ${result.pid})`);
+    console.error(`socket: ${result.socketPath}`);
+}
+/**
+ * SIGTERM a pidfile-recorded daemon, but only after verifying the pid still
+ * refers to the voltd that wrote the pidfile (a recycled pid must never
+ * receive the signal). Returns whether SIGTERM was sent, refused, or the
+ * process was already gone.
+ */
+async function signalPidfileDaemon(pidfilePath, context) {
+    const pidfile = readPidfile(pidfilePath);
+    if (!pidfile) {
+        return "gone";
+    }
+    const verification = await verifyPidfileProcess(pidfile);
+    if (verification === "mismatch") {
+        console.error(`Error: pid ${pidfile.pid} from the pidfile is not verifiable as voltd (recycled pid?); not sending SIGTERM.`);
+        console.error(`Remove ${pidfilePath} if it is stale.`);
+        process.exitCode = 1;
+        return "refused";
+    }
+    if (verification === "gone") {
+        return "gone";
+    }
+    try {
+        process.kill(pidfile.pid, "SIGTERM");
+        console.error(`${context}; sent SIGTERM to pid ${pidfile.pid}`);
+        return "sent";
+    }
+    catch {
+        // Process exited between verification and signal.
+        return "gone";
+    }
+}
+async function daemonStop(agentDir) {
+    const paths = getDaemonPaths(agentDir);
+    const probe = await probeDaemon(agentDir);
+    const pidfile = readPidfile(paths.pidfilePath);
+    if (!probe.healthy) {
+        if (probe.state === "shutting-down") {
+            console.error("voltd is already draining; waiting for exit");
+            if ((await waitForDaemonExit({
+                agentDir,
+                pidfile,
+                socketPath: probe.socketPath,
+                timeoutMs: STOP_TIMEOUT_MS,
+            })) === "exited") {
+                console.error("voltd stopped");
+                return;
+            }
+        }
+        const signalResult = await signalPidfileDaemon(paths.pidfilePath, "voltd socket unreachable");
+        if (signalResult === "sent") {
+            if ((await waitForDaemonExit({ agentDir, pidfile, timeoutMs: STOP_TIMEOUT_MS })) === "exited") {
+                console.error("voltd stopped");
+                return;
+            }
+            console.error("Error: voltd did not stop after SIGTERM");
+            process.exitCode = 1;
+            return;
+        }
+        if (signalResult === "refused") {
+            return;
+        }
+        console.error("voltd is not running");
+        return;
+    }
+    const client = createDaemonClient({
+        socketPath: probe.socketPath,
+        client: "cli",
+        version: VERSION,
+        authToken: probe.authToken,
+        reconnect: false,
+    });
+    try {
+        await client.request({ type: "shutdown" });
+    }
+    catch {
+        // The daemon may close the socket before the ok lands; fall through to the poll.
+    }
+    finally {
+        await client.close();
+    }
+    if ((await waitForDaemonExit({
+        agentDir,
+        pid: probe.pid,
+        pidfile,
+        socketPath: probe.socketPath,
+        timeoutMs: STOP_TIMEOUT_MS,
+    })) === "exited") {
+        console.error("voltd stopped");
+        return;
+    }
+    const signalResult = await signalPidfileDaemon(paths.pidfilePath, "voltd did not stop over the control socket");
+    if (signalResult === "sent") {
+        if ((await waitForDaemonExit({ agentDir, pidfile, socketPath: probe.socketPath, timeoutMs: STOP_TIMEOUT_MS })) ===
+            "exited") {
+            console.error("voltd stopped");
+            return;
+        }
+        console.error("Error: voltd did not stop after SIGTERM");
+        process.exitCode = 1;
+        return;
+    }
+    if (signalResult === "refused") {
+        return;
+    }
+    console.error("Error: voltd did not stop within the timeout");
+    process.exitCode = 1;
+}
+function formatKeepAwake(keepAwake) {
+    // Older daemons predate the field; report that instead of guessing "off".
+    if (!keepAwake) {
+        return "unknown (daemon predates keep-awake)";
+    }
+    if (!keepAwake.enabled) {
+        return "off";
+    }
+    return keepAwake.state === "active" ? "on (active)" : `on (degraded: ${keepAwake.reason ?? "unknown"})`;
+}
+function formatUptime(startedAtMs) {
+    const totalSeconds = Math.max(0, Math.floor((Date.now() - startedAtMs) / 1000));
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    return hours > 0 ? `${hours}h${minutes}m${seconds}s` : minutes > 0 ? `${minutes}m${seconds}s` : `${seconds}s`;
+}
+async function daemonStatus(agentDir, json) {
+    const status = await requestStatus(agentDir);
+    if (!status) {
+        if (json) {
+            console.log(JSON.stringify({ running: false }));
+        }
+        else {
+            console.error("voltd is not running");
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (json) {
+        console.log(JSON.stringify({ running: true, ...status, id: undefined, type: undefined }));
+        return;
+    }
+    console.error(`voltd ${status.version} (protocol ${status.protocolVersion})`);
+    console.error(`pid: ${status.pid}`);
+    console.error(`uptime: ${formatUptime(status.startedAtMs)}`);
+    console.error(`keep awake: ${formatKeepAwake(status.keepAwake)}`);
+    console.error(`phone connections: ${status.phoneConnections}`);
+    console.error(`workspaces: ${status.workspaces.length}`);
+    for (const workspace of status.workspaces) {
+        console.error(`  ${workspace.name} -> ${workspace.path}`);
+    }
+    console.error(`paired clients: ${status.clients.length}`);
+    for (const client of status.clients) {
+        console.error(`  ${client.clientNodeId}${client.label ? ` (${client.label})` : ""}`);
+    }
+    console.error(`leases: ${status.leases.length}`);
+    for (const lease of status.leases) {
+        console.error(`  ${lease.workspaceName}/${lease.sessionId}: ${lease.state} (streams ${lease.streamCount}, relays ${lease.relayCount})`);
+    }
+}
+async function daemonKeepAwake(agentDir, args) {
+    const mode = args[0];
+    if (mode !== undefined && mode !== "on" && mode !== "off" && mode !== "status") {
+        console.error("Error: volt daemon keep-awake takes on, off, or no argument");
+        process.exitCode = 1;
+        return;
+    }
+    if (mode === undefined || mode === "status") {
+        const status = await requestStatus(agentDir);
+        if (!status) {
+            console.error("voltd is not running");
+            process.exitCode = 1;
+            return;
+        }
+        console.error(`keep awake: ${formatKeepAwake(status.keepAwake)}`);
+        return;
+    }
+    const probe = await probeDaemon(agentDir);
+    if (!probe.healthy) {
+        console.error("voltd is not running");
+        process.exitCode = 1;
+        return;
+    }
+    const client = createDaemonClient({
+        socketPath: probe.socketPath,
+        client: "cli",
+        version: VERSION,
+        authToken: probe.authToken,
+        reconnect: false,
+    });
+    try {
+        const response = await client.request({ type: "keep_awake_set", enabled: mode === "on" });
+        if (response.type === "error") {
+            console.error(`Error: ${response.message}`);
+            process.exitCode = 1;
+            return;
+        }
+        if (response.type !== "keep_awake_result") {
+            console.error("Error: this voltd version does not support keep-awake; restart the daemon after upgrading");
+            process.exitCode = 1;
+            return;
+        }
+        console.error(`keep awake: ${formatKeepAwake(response.keepAwake)}`);
+        if (response.keepAwake.enabled && response.keepAwake.state === "degraded") {
+            process.exitCode = 1;
+        }
+    }
+    finally {
+        await client.close();
+    }
+}
+function tailLines(content, count) {
+    const lines = content.split("\n");
+    if (lines.at(-1) === "") {
+        lines.pop();
+    }
+    return lines.slice(-count);
+}
+async function promptConfirm(message) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return false;
+    }
+    return new Promise((resolve) => {
+        const readline = createInterface({ input: process.stdin, output: process.stdout });
+        readline.question(`${message} [y/N] `, (answer) => {
+            readline.close();
+            resolve(answer.trim().toLowerCase() === "y" || answer.trim().toLowerCase() === "yes");
+        });
+    });
+}
+async function daemonRegenerateState(agentDir) {
+    const probe = await probeDaemon(agentDir);
+    if (probe.healthy || probe.state !== "not-running") {
+        console.error(`Error: voltd must be fully stopped before regenerating state (currently ${probe.state}).`);
+        process.exitCode = 1;
+        return;
+    }
+    const invalidState = inspectVoltdStateFiles(agentDir);
+    if (!invalidState) {
+        console.error("Daemon state is valid; regeneration is not needed.");
+        return;
+    }
+    console.error(invalidState.error);
+    console.error("Regeneration preserves validated identity/settings when safe and drops invalid access records.");
+    console.error("If the identity cannot be preserved, all phones will need to pair again.");
+    if (!(await promptConfirm("Back up the invalid file and regenerate daemon state?"))) {
+        console.error("Daemon state was not changed.");
+        process.exitCode = 1;
+        return;
+    }
+    const { backupPath, preservedIdentity } = await regenerateInvalidVoltdState(agentDir);
+    console.error(`Backed up invalid daemon state to ${backupPath}`);
+    console.error(preservedIdentity ? "Preserved the Iroh identity." : "A new Iroh identity will be created.");
+    console.error("Run `volt daemon start` to create fresh state.");
+}
+async function daemonLogs(agentDir, args) {
+    const paths = getDaemonPaths(agentDir);
+    const follow = args.includes("-f") || args.includes("--follow");
+    let lineCount = DEFAULT_LOG_TAIL_LINES;
+    const nIndex = args.indexOf("-n");
+    if (nIndex !== -1) {
+        const parsed = Number(args[nIndex + 1]);
+        if (!Number.isInteger(parsed) || parsed <= 0) {
+            console.error("Error: -n requires a positive integer");
+            process.exitCode = 1;
+            return;
+        }
+        lineCount = parsed;
+    }
+    if (!existsSync(paths.logPath)) {
+        console.error(`No daemon log at ${paths.logPath}`);
+        process.exitCode = 1;
+        return;
+    }
+    for (const line of tailLines(readFileSync(paths.logPath, "utf8"), lineCount)) {
+        console.log(line);
+    }
+    if (!follow) {
+        return;
+    }
+    let offset = statSync(paths.logPath).size;
+    while (true) {
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        let size;
+        try {
+            size = statSync(paths.logPath).size;
+        }
+        catch {
+            continue;
+        }
+        if (size < offset) {
+            offset = 0; // rotated
+        }
+        if (size === offset) {
+            continue;
+        }
+        const handle = await open(paths.logPath, "r");
+        try {
+            const { buffer, bytesRead } = await handle.read(Buffer.alloc(size - offset), 0, size - offset, offset);
+            process.stdout.write(buffer.subarray(0, bytesRead));
+            offset += bytesRead;
+        }
+        finally {
+            await handle.close();
+        }
+    }
+}
+/** Router for `volt daemon <command>`; returns true when the args were handled. */
+export async function handleDaemonCommand(args, options) {
+    if (args[0] !== "daemon") {
+        return false;
+    }
+    const command = args[1];
+    if (command === undefined || command === "--help" || command === "-h") {
+        printDaemonUsage();
+        return true;
+    }
+    if (options.isStandaloneBinary) {
+        console.error("Error: volt daemon is not available from the standalone binary release.");
+        console.error("Use a Node.js npm install or a source checkout with optional @number0/iroh dependencies.");
+        process.exitCode = 1;
+        return true;
+    }
+    const agentDir = options.agentDir ?? getAgentDir();
+    const rest = args.slice(2);
+    switch (command) {
+        case "start":
+            await daemonStart(agentDir);
+            return true;
+        case "stop":
+            await daemonStop(agentDir);
+            return true;
+        case "status":
+            await daemonStatus(agentDir, rest.includes("--json"));
+            return true;
+        case "restart":
+            await daemonStop(agentDir);
+            if ((process.exitCode ?? 0) === 0) {
+                await daemonStart(agentDir);
+            }
+            return true;
+        case "regenerate-state":
+            await daemonRegenerateState(agentDir);
+            return true;
+        case "keep-awake":
+            await daemonKeepAwake(agentDir, rest);
+            return true;
+        case "logs":
+            await daemonLogs(agentDir, rest);
+            return true;
+        case "install-service": {
+            const result = await installDaemonService({ agentDir });
+            for (const message of result.messages) {
+                console.error(message);
+            }
+            if (!result.ok) {
+                process.exitCode = 1;
+            }
+            return true;
+        }
+        case "uninstall-service": {
+            const result = await uninstallDaemonService({ agentDir });
+            for (const message of result.messages) {
+                console.error(message);
+            }
+            if (!result.ok) {
+                process.exitCode = 1;
+            }
+            return true;
+        }
+        case "run": {
+            if (!rest.includes("--foreground")) {
+                console.error("Error: volt daemon run requires --foreground");
+                process.exitCode = 1;
+                return true;
+            }
+            const code = await runVoltDaemon({ agentDir, foreground: true }, [createIrohDaemonService()]);
+            // The run loop resolves only after shutdown() has awaited all cleanup, but
+            // the native iroh handle can keep the event loop alive afterwards (notably
+            // on Windows), leaving a zombie that clients still probe as "draining".
+            // Exit deterministically now that teardown is complete.
+            process.exit(code);
+            return true;
+        }
+        default:
+            console.error(`Error: Unknown daemon command: ${command}`);
+            printDaemonUsage();
+            process.exitCode = 1;
+            return true;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/daemon/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/daemon/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, statSync } from \"node:fs\";\nimport { open } from \"node:fs/promises\";\nimport { createInterface } from \"node:readline\";\nimport { getAgentDir, VERSION } from \"../config.ts\";\nimport { createDaemonClient } from \"./control-client.ts\";\nimport type { ControlKeepAwakeStatus, ControlResponse } from \"./control-protocol.ts\";\nimport { createIrohDaemonService } from \"./iroh-service.ts\";\nimport { readPidfile, runVoltDaemon } from \"./main.ts\";\nimport { getDaemonPaths } from \"./paths.ts\";\nimport { verifyPidfileProcess } from \"./process-identity.ts\";\nimport { installDaemonService, uninstallDaemonService } from \"./service-install.ts\";\nimport { DAEMON_SHUTDOWN_TIMEOUT_MS, ensureDaemonRunning, probeDaemon, waitForDaemonExit } from \"./spawn.ts\";\nimport { inspectVoltdStateFiles, regenerateInvalidVoltdState } from \"./state.ts\";\n\nconst STOP_TIMEOUT_MS = DAEMON_SHUTDOWN_TIMEOUT_MS; // 60s drain cap + margin\nconst DEFAULT_LOG_TAIL_LINES = 200;\n\ntype StatusResult = ControlResponse & { type: \"status_result\" };\n\nfunction printDaemonUsage(): void {\n\tconsole.error(`Usage: volt daemon <command>\n\nCommands:\n  start                 Start the background daemon (no-op if already running).\n  stop                  Ask the daemon to shut down gracefully.\n  status [--json]       Show daemon status; exit 0 when running, 1 when not.\n  restart               Stop then start; persistent state survives.\n  regenerate-state      Back up invalid state and regenerate it after confirmation.\n  keep-awake [on|off]   Prevent the host from sleeping while voltd runs; no arg prints state.\n  logs [-f] [-n N]      Tail the daemon log (default ${DEFAULT_LOG_TAIL_LINES} lines).\n  install-service       Register a login service (launchd/systemd) that starts the daemon.\n  uninstall-service     Remove the login service.\n  run --foreground      Run the daemon in this process (internal; used by start).\n`);\n}\n\nasync function requestStatus(agentDir: string): Promise<StatusResult | undefined> {\n\tconst probe = await probeDaemon(agentDir);\n\tif (!probe.healthy) {\n\t\treturn undefined;\n\t}\n\tconst client = createDaemonClient({\n\t\tsocketPath: probe.socketPath,\n\t\tclient: \"cli\",\n\t\tversion: VERSION,\n\t\tauthToken: probe.authToken,\n\t\treconnect: false,\n\t});\n\ttry {\n\t\tconst statusProbe = await client.request({ type: \"status\" });\n\t\treturn statusProbe.type === \"status_result\" ? statusProbe : undefined;\n\t} finally {\n\t\tawait client.close();\n\t}\n}\n\nasync function daemonStart(agentDir: string): Promise<void> {\n\tconst result = await ensureDaemonRunning(agentDir);\n\tif (!result.healthy) {\n\t\tif (result.state === \"protocol-mismatch\") {\n\t\t\tconsole.error(\n\t\t\t\t\"Error: a different voltd protocol version is already running; stop it before starting this version.\",\n\t\t\t);\n\t\t} else if (result.state === \"unresponsive\") {\n\t\t\tconsole.error(\"Error: voltd socket is occupied but not responding; not starting a second daemon.\");\n\t\t} else if (result.state === \"auth-failed\") {\n\t\t\tconsole.error(\"Error: voltd rejected the local daemon metadata; not starting a second daemon.\");\n\t\t} else if (result.state === \"shutting-down\") {\n\t\t\tconsole.error(\"Error: existing voltd did not finish shutting down within the timeout.\");\n\t\t} else {\n\t\t\tconsole.error(`Error: ${result.error ?? \"failed to start voltd (daemon did not become healthy within 5s).\"}`);\n\t\t\tif (result.invalidState) {\n\t\t\t\tconsole.error(\"Run `volt daemon regenerate-state` to review and confirm regeneration.\");\n\t\t\t}\n\t\t}\n\t\tconsole.error(`Check the log: ${getDaemonPaths(agentDir).logPath}`);\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tconsole.error(\n\t\t`voltd ${result.version ?? VERSION} ${result.spawned ? \"started\" : \"already running\"} (pid ${result.pid})`,\n\t);\n\tconsole.error(`socket: ${result.socketPath}`);\n}\n\n/**\n * SIGTERM a pidfile-recorded daemon, but only after verifying the pid still\n * refers to the voltd that wrote the pidfile (a recycled pid must never\n * receive the signal). Returns whether SIGTERM was sent, refused, or the\n * process was already gone.\n */\nasync function signalPidfileDaemon(pidfilePath: string, context: string): Promise<\"sent\" | \"refused\" | \"gone\"> {\n\tconst pidfile = readPidfile(pidfilePath);\n\tif (!pidfile) {\n\t\treturn \"gone\";\n\t}\n\tconst verification = await verifyPidfileProcess(pidfile);\n\tif (verification === \"mismatch\") {\n\t\tconsole.error(\n\t\t\t`Error: pid ${pidfile.pid} from the pidfile is not verifiable as voltd (recycled pid?); not sending SIGTERM.`,\n\t\t);\n\t\tconsole.error(`Remove ${pidfilePath} if it is stale.`);\n\t\tprocess.exitCode = 1;\n\t\treturn \"refused\";\n\t}\n\tif (verification === \"gone\") {\n\t\treturn \"gone\";\n\t}\n\ttry {\n\t\tprocess.kill(pidfile.pid, \"SIGTERM\");\n\t\tconsole.error(`${context}; sent SIGTERM to pid ${pidfile.pid}`);\n\t\treturn \"sent\";\n\t} catch {\n\t\t// Process exited between verification and signal.\n\t\treturn \"gone\";\n\t}\n}\n\nasync function daemonStop(agentDir: string): Promise<void> {\n\tconst paths = getDaemonPaths(agentDir);\n\tconst probe = await probeDaemon(agentDir);\n\tconst pidfile = readPidfile(paths.pidfilePath);\n\tif (!probe.healthy) {\n\t\tif (probe.state === \"shutting-down\") {\n\t\t\tconsole.error(\"voltd is already draining; waiting for exit\");\n\t\t\tif (\n\t\t\t\t(await waitForDaemonExit({\n\t\t\t\t\tagentDir,\n\t\t\t\t\tpidfile,\n\t\t\t\t\tsocketPath: probe.socketPath,\n\t\t\t\t\ttimeoutMs: STOP_TIMEOUT_MS,\n\t\t\t\t})) === \"exited\"\n\t\t\t) {\n\t\t\t\tconsole.error(\"voltd stopped\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tconst signalResult = await signalPidfileDaemon(paths.pidfilePath, \"voltd socket unreachable\");\n\t\tif (signalResult === \"sent\") {\n\t\t\tif ((await waitForDaemonExit({ agentDir, pidfile, timeoutMs: STOP_TIMEOUT_MS })) === \"exited\") {\n\t\t\t\tconsole.error(\"voltd stopped\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.error(\"Error: voltd did not stop after SIGTERM\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tif (signalResult === \"refused\") {\n\t\t\treturn;\n\t\t}\n\t\tconsole.error(\"voltd is not running\");\n\t\treturn;\n\t}\n\n\tconst client = createDaemonClient({\n\t\tsocketPath: probe.socketPath,\n\t\tclient: \"cli\",\n\t\tversion: VERSION,\n\t\tauthToken: probe.authToken,\n\t\treconnect: false,\n\t});\n\ttry {\n\t\tawait client.request({ type: \"shutdown\" });\n\t} catch {\n\t\t// The daemon may close the socket before the ok lands; fall through to the poll.\n\t} finally {\n\t\tawait client.close();\n\t}\n\n\tif (\n\t\t(await waitForDaemonExit({\n\t\t\tagentDir,\n\t\t\tpid: probe.pid,\n\t\t\tpidfile,\n\t\t\tsocketPath: probe.socketPath,\n\t\t\ttimeoutMs: STOP_TIMEOUT_MS,\n\t\t})) === \"exited\"\n\t) {\n\t\tconsole.error(\"voltd stopped\");\n\t\treturn;\n\t}\n\tconst signalResult = await signalPidfileDaemon(paths.pidfilePath, \"voltd did not stop over the control socket\");\n\tif (signalResult === \"sent\") {\n\t\tif (\n\t\t\t(await waitForDaemonExit({ agentDir, pidfile, socketPath: probe.socketPath, timeoutMs: STOP_TIMEOUT_MS })) ===\n\t\t\t\"exited\"\n\t\t) {\n\t\t\tconsole.error(\"voltd stopped\");\n\t\t\treturn;\n\t\t}\n\t\tconsole.error(\"Error: voltd did not stop after SIGTERM\");\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tif (signalResult === \"refused\") {\n\t\treturn;\n\t}\n\tconsole.error(\"Error: voltd did not stop within the timeout\");\n\tprocess.exitCode = 1;\n}\n\nfunction formatKeepAwake(keepAwake: ControlKeepAwakeStatus | undefined): string {\n\t// Older daemons predate the field; report that instead of guessing \"off\".\n\tif (!keepAwake) {\n\t\treturn \"unknown (daemon predates keep-awake)\";\n\t}\n\tif (!keepAwake.enabled) {\n\t\treturn \"off\";\n\t}\n\treturn keepAwake.state === \"active\" ? \"on (active)\" : `on (degraded: ${keepAwake.reason ?? \"unknown\"})`;\n}\n\nfunction formatUptime(startedAtMs: number): string {\n\tconst totalSeconds = Math.max(0, Math.floor((Date.now() - startedAtMs) / 1000));\n\tconst hours = Math.floor(totalSeconds / 3600);\n\tconst minutes = Math.floor((totalSeconds % 3600) / 60);\n\tconst seconds = totalSeconds % 60;\n\treturn hours > 0 ? `${hours}h${minutes}m${seconds}s` : minutes > 0 ? `${minutes}m${seconds}s` : `${seconds}s`;\n}\n\nasync function daemonStatus(agentDir: string, json: boolean): Promise<void> {\n\tconst status = await requestStatus(agentDir);\n\tif (!status) {\n\t\tif (json) {\n\t\t\tconsole.log(JSON.stringify({ running: false }));\n\t\t} else {\n\t\t\tconsole.error(\"voltd is not running\");\n\t\t}\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tif (json) {\n\t\tconsole.log(JSON.stringify({ running: true, ...status, id: undefined, type: undefined }));\n\t\treturn;\n\t}\n\tconsole.error(`voltd ${status.version} (protocol ${status.protocolVersion})`);\n\tconsole.error(`pid: ${status.pid}`);\n\tconsole.error(`uptime: ${formatUptime(status.startedAtMs)}`);\n\tconsole.error(`keep awake: ${formatKeepAwake(status.keepAwake)}`);\n\tconsole.error(`phone connections: ${status.phoneConnections}`);\n\tconsole.error(`workspaces: ${status.workspaces.length}`);\n\tfor (const workspace of status.workspaces) {\n\t\tconsole.error(`  ${workspace.name} -> ${workspace.path}`);\n\t}\n\tconsole.error(`paired clients: ${status.clients.length}`);\n\tfor (const client of status.clients) {\n\t\tconsole.error(`  ${client.clientNodeId}${client.label ? ` (${client.label})` : \"\"}`);\n\t}\n\tconsole.error(`leases: ${status.leases.length}`);\n\tfor (const lease of status.leases) {\n\t\tconsole.error(\n\t\t\t`  ${lease.workspaceName}/${lease.sessionId}: ${lease.state} (streams ${lease.streamCount}, relays ${lease.relayCount})`,\n\t\t);\n\t}\n}\n\nasync function daemonKeepAwake(agentDir: string, args: string[]): Promise<void> {\n\tconst mode = args[0];\n\tif (mode !== undefined && mode !== \"on\" && mode !== \"off\" && mode !== \"status\") {\n\t\tconsole.error(\"Error: volt daemon keep-awake takes on, off, or no argument\");\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tif (mode === undefined || mode === \"status\") {\n\t\tconst status = await requestStatus(agentDir);\n\t\tif (!status) {\n\t\t\tconsole.error(\"voltd is not running\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tconsole.error(`keep awake: ${formatKeepAwake(status.keepAwake)}`);\n\t\treturn;\n\t}\n\tconst probe = await probeDaemon(agentDir);\n\tif (!probe.healthy) {\n\t\tconsole.error(\"voltd is not running\");\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tconst client = createDaemonClient({\n\t\tsocketPath: probe.socketPath,\n\t\tclient: \"cli\",\n\t\tversion: VERSION,\n\t\tauthToken: probe.authToken,\n\t\treconnect: false,\n\t});\n\ttry {\n\t\tconst response = await client.request({ type: \"keep_awake_set\", enabled: mode === \"on\" });\n\t\tif (response.type === \"error\") {\n\t\t\tconsole.error(`Error: ${response.message}`);\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tif (response.type !== \"keep_awake_result\") {\n\t\t\tconsole.error(\"Error: this voltd version does not support keep-awake; restart the daemon after upgrading\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tconsole.error(`keep awake: ${formatKeepAwake(response.keepAwake)}`);\n\t\tif (response.keepAwake.enabled && response.keepAwake.state === \"degraded\") {\n\t\t\tprocess.exitCode = 1;\n\t\t}\n\t} finally {\n\t\tawait client.close();\n\t}\n}\n\nfunction tailLines(content: string, count: number): string[] {\n\tconst lines = content.split(\"\\n\");\n\tif (lines.at(-1) === \"\") {\n\t\tlines.pop();\n\t}\n\treturn lines.slice(-count);\n}\n\nasync function promptConfirm(message: string): Promise<boolean> {\n\tif (!process.stdin.isTTY || !process.stdout.isTTY) {\n\t\treturn false;\n\t}\n\treturn new Promise((resolve) => {\n\t\tconst readline = createInterface({ input: process.stdin, output: process.stdout });\n\t\treadline.question(`${message} [y/N] `, (answer) => {\n\t\t\treadline.close();\n\t\t\tresolve(answer.trim().toLowerCase() === \"y\" || answer.trim().toLowerCase() === \"yes\");\n\t\t});\n\t});\n}\n\nasync function daemonRegenerateState(agentDir: string): Promise<void> {\n\tconst probe = await probeDaemon(agentDir);\n\tif (probe.healthy || probe.state !== \"not-running\") {\n\t\tconsole.error(`Error: voltd must be fully stopped before regenerating state (currently ${probe.state}).`);\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tconst invalidState = inspectVoltdStateFiles(agentDir);\n\tif (!invalidState) {\n\t\tconsole.error(\"Daemon state is valid; regeneration is not needed.\");\n\t\treturn;\n\t}\n\tconsole.error(invalidState.error);\n\tconsole.error(\"Regeneration preserves validated identity/settings when safe and drops invalid access records.\");\n\tconsole.error(\"If the identity cannot be preserved, all phones will need to pair again.\");\n\tif (!(await promptConfirm(\"Back up the invalid file and regenerate daemon state?\"))) {\n\t\tconsole.error(\"Daemon state was not changed.\");\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tconst { backupPath, preservedIdentity } = await regenerateInvalidVoltdState(agentDir);\n\tconsole.error(`Backed up invalid daemon state to ${backupPath}`);\n\tconsole.error(preservedIdentity ? \"Preserved the Iroh identity.\" : \"A new Iroh identity will be created.\");\n\tconsole.error(\"Run `volt daemon start` to create fresh state.\");\n}\n\nasync function daemonLogs(agentDir: string, args: string[]): Promise<void> {\n\tconst paths = getDaemonPaths(agentDir);\n\tconst follow = args.includes(\"-f\") || args.includes(\"--follow\");\n\tlet lineCount = DEFAULT_LOG_TAIL_LINES;\n\tconst nIndex = args.indexOf(\"-n\");\n\tif (nIndex !== -1) {\n\t\tconst parsed = Number(args[nIndex + 1]);\n\t\tif (!Number.isInteger(parsed) || parsed <= 0) {\n\t\t\tconsole.error(\"Error: -n requires a positive integer\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tlineCount = parsed;\n\t}\n\tif (!existsSync(paths.logPath)) {\n\t\tconsole.error(`No daemon log at ${paths.logPath}`);\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tfor (const line of tailLines(readFileSync(paths.logPath, \"utf8\"), lineCount)) {\n\t\tconsole.log(line);\n\t}\n\tif (!follow) {\n\t\treturn;\n\t}\n\tlet offset = statSync(paths.logPath).size;\n\twhile (true) {\n\t\tawait new Promise((resolve) => setTimeout(resolve, 500));\n\t\tlet size: number;\n\t\ttry {\n\t\t\tsize = statSync(paths.logPath).size;\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tif (size < offset) {\n\t\t\toffset = 0; // rotated\n\t\t}\n\t\tif (size === offset) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst handle = await open(paths.logPath, \"r\");\n\t\ttry {\n\t\t\tconst { buffer, bytesRead } = await handle.read(Buffer.alloc(size - offset), 0, size - offset, offset);\n\t\t\tprocess.stdout.write(buffer.subarray(0, bytesRead));\n\t\t\toffset += bytesRead;\n\t\t} finally {\n\t\t\tawait handle.close();\n\t\t}\n\t}\n}\n\nexport interface DaemonCommandOptions {\n\tagentDir?: string;\n\t/** Standalone releases omit the native Iroh adapter. */\n\tisStandaloneBinary: boolean;\n}\n\n/** Router for `volt daemon <command>`; returns true when the args were handled. */\nexport async function handleDaemonCommand(args: string[], options: DaemonCommandOptions): Promise<boolean> {\n\tif (args[0] !== \"daemon\") {\n\t\treturn false;\n\t}\n\tconst command = args[1];\n\tif (command === undefined || command === \"--help\" || command === \"-h\") {\n\t\tprintDaemonUsage();\n\t\treturn true;\n\t}\n\tif (options.isStandaloneBinary) {\n\t\tconsole.error(\"Error: volt daemon is not available from the standalone binary release.\");\n\t\tconsole.error(\"Use a Node.js npm install or a source checkout with optional @number0/iroh dependencies.\");\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\tconst agentDir = options.agentDir ?? getAgentDir();\n\tconst rest = args.slice(2);\n\n\tswitch (command) {\n\t\tcase \"start\":\n\t\t\tawait daemonStart(agentDir);\n\t\t\treturn true;\n\t\tcase \"stop\":\n\t\t\tawait daemonStop(agentDir);\n\t\t\treturn true;\n\t\tcase \"status\":\n\t\t\tawait daemonStatus(agentDir, rest.includes(\"--json\"));\n\t\t\treturn true;\n\t\tcase \"restart\":\n\t\t\tawait daemonStop(agentDir);\n\t\t\tif ((process.exitCode ?? 0) === 0) {\n\t\t\t\tawait daemonStart(agentDir);\n\t\t\t}\n\t\t\treturn true;\n\t\tcase \"regenerate-state\":\n\t\t\tawait daemonRegenerateState(agentDir);\n\t\t\treturn true;\n\t\tcase \"keep-awake\":\n\t\t\tawait daemonKeepAwake(agentDir, rest);\n\t\t\treturn true;\n\t\tcase \"logs\":\n\t\t\tawait daemonLogs(agentDir, rest);\n\t\t\treturn true;\n\t\tcase \"install-service\": {\n\t\t\tconst result = await installDaemonService({ agentDir });\n\t\t\tfor (const message of result.messages) {\n\t\t\t\tconsole.error(message);\n\t\t\t}\n\t\t\tif (!result.ok) {\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\t\tcase \"uninstall-service\": {\n\t\t\tconst result = await uninstallDaemonService({ agentDir });\n\t\t\tfor (const message of result.messages) {\n\t\t\t\tconsole.error(message);\n\t\t\t}\n\t\t\tif (!result.ok) {\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\t\tcase \"run\": {\n\t\t\tif (!rest.includes(\"--foreground\")) {\n\t\t\t\tconsole.error(\"Error: volt daemon run requires --foreground\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\tconst code = await runVoltDaemon({ agentDir, foreground: true }, [createIrohDaemonService()]);\n\t\t\t// The run loop resolves only after shutdown() has awaited all cleanup, but\n\t\t\t// the native iroh handle can keep the event loop alive afterwards (notably\n\t\t\t// on Windows), leaving a zombie that clients still probe as \"draining\".\n\t\t\t// Exit deterministically now that teardown is complete.\n\t\t\tprocess.exit(code);\n\t\t\treturn true;\n\t\t}\n\t\tdefault:\n\t\t\tconsole.error(`Error: Unknown daemon command: ${command}`);\n\t\t\tprintDaemonUsage();\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn true;\n\t}\n}\n"]}

package/dist/daemon/control-client.d.ts

@@ -0,0 +1,60 @@
+import type { Duplex } from "node:stream";
+import { type ControlClientKind, type ControlEvent, type ControlRequest, type ControlResponse, type RelayPreamble } from "./control-protocol.ts";
+export type DaemonClientConnectionState = "connected" | "reconnecting" | "gone";
+export type DaemonClientGoneReason = "closed" | "protocol_mismatch" | "dial_failed";
+export interface DaemonClientEndpoint {
+    socketPath: string;
+    authToken?: string;
+}
+export interface DaemonClientOptions {
+    socketPath: string;
+    client: ControlClientKind;
+    version: string;
+    /** Per-daemon instance token read from the local pidfile. */
+    authToken?: string;
+    /** Re-read daemon discovery metadata before every dial after the first. */
+    refreshEndpoint?(): DaemonClientEndpoint | undefined;
+    /** Capabilities advertised in the control hello (e.g. "worktrees"). */
+    capabilities?: string[];
+    onEvent?(event: ControlEvent): void;
+    onConnectionStateChange?(state: DaemonClientConnectionState): void;
+    /** Reconnect forever with backoff (default true for TUI clients). */
+    reconnect?: boolean;
+    minBackoffMs?: number;
+    maxBackoffMs?: number;
+    helloTimeoutMs?: number;
+}
+export interface RelayOfferInfo {
+    relayId: string;
+    relayToken: string;
+}
+export declare class DaemonClientClosedError extends Error {
+    constructor(message?: string);
+}
+export interface DaemonClient {
+    readonly connectionState: DaemonClientConnectionState;
+    /** hello_ack payload of the current connection, when connected. */
+    readonly serverInfo: {
+        version?: string;
+        protocolVersion?: number;
+        connectionId?: string;
+    } | undefined;
+    readonly goneReason: DaemonClientGoneReason | undefined;
+    /** Connect (or await the in-flight connect). Rejects when reconnect is off and the dial fails. */
+    connect(): Promise<void>;
+    request(req: DistributiveOmit<ControlRequest, "id">): Promise<ControlResponse>;
+    /**
+     * Await the next response for a request id (used after a provisional
+     * lease_pending). Rejects with DaemonClientClosedError on disconnect.
+     */
+    waitForResponse(id: string): Promise<ControlResponse>;
+    /** Dial a fresh control endpoint with role:"relay"; returns the raw duplex after the preamble. */
+    openRelay(offer: RelayOfferInfo): Promise<{
+        preamble: RelayPreamble;
+        stream: Duplex;
+    }>;
+    close(): Promise<void>;
+}
+export type DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;
+export declare function createDaemonClient(options: DaemonClientOptions): DaemonClient;
+//# sourceMappingURL=control-client.d.ts.map

package/dist/daemon/control-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-client.d.ts","sourceRoot":"","sources":["../../src/daemon/control-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAEjB,KAAK,cAAc,EACnB,KAAK,eAAe,EAQpB,KAAK,aAAa,EAClB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,cAAc,GAAG,MAAM,CAAC;AAChF,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,mBAAmB,GAAG,aAAa,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,eAAe,CAAC,IAAI,oBAAoB,GAAG,SAAS,CAAC;IACrD,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,uBAAuB,CAAC,CAAC,KAAK,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACnE,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,YAAY,OAAO,SAA6B,EAG/C;CACD;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,eAAe,EAAE,2BAA2B,CAAC;IACtD,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACvG,QAAQ,CAAC,UAAU,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACxD,kGAAkG;IAClG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,EAAE,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/E;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACtD,kGAAkG;IAClG,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAgB5F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAqZ7E","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { createConnection, type Socket } from \"node:net\";\nimport type { Duplex } from \"node:stream\";\nimport {\n\ttype ControlClientKind,\n\ttype ControlEvent,\n\tControlLineDecoder,\n\ttype ControlRequest,\n\ttype ControlResponse,\n\tencodeControlLine,\n\ttype HelloAck,\n\tisControlEvent,\n\tisControlResponse,\n\tisHelloAck,\n\tisRelayPreamble,\n\tPROTOCOL_VERSION,\n\ttype RelayPreamble,\n} from \"./control-protocol.ts\";\n\nexport type DaemonClientConnectionState = \"connected\" | \"reconnecting\" | \"gone\";\nexport type DaemonClientGoneReason = \"closed\" | \"protocol_mismatch\" | \"dial_failed\";\n\nexport interface DaemonClientEndpoint {\n\tsocketPath: string;\n\tauthToken?: string;\n}\n\nexport interface DaemonClientOptions {\n\tsocketPath: string;\n\tclient: ControlClientKind;\n\tversion: string;\n\t/** Per-daemon instance token read from the local pidfile. */\n\tauthToken?: string;\n\t/** Re-read daemon discovery metadata before every dial after the first. */\n\trefreshEndpoint?(): DaemonClientEndpoint | undefined;\n\t/** Capabilities advertised in the control hello (e.g. \"worktrees\"). */\n\tcapabilities?: string[];\n\tonEvent?(event: ControlEvent): void;\n\tonConnectionStateChange?(state: DaemonClientConnectionState): void;\n\t/** Reconnect forever with backoff (default true for TUI clients). */\n\treconnect?: boolean;\n\tminBackoffMs?: number;\n\tmaxBackoffMs?: number;\n\thelloTimeoutMs?: number;\n}\n\nexport interface RelayOfferInfo {\n\trelayId: string;\n\trelayToken: string;\n}\n\nexport class DaemonClientClosedError extends Error {\n\tconstructor(message = \"daemon connection closed\") {\n\t\tsuper(message);\n\t\tthis.name = \"DaemonClientClosedError\";\n\t}\n}\n\nexport interface DaemonClient {\n\treadonly connectionState: DaemonClientConnectionState;\n\t/** hello_ack payload of the current connection, when connected. */\n\treadonly serverInfo: { version?: string; protocolVersion?: number; connectionId?: string } | undefined;\n\treadonly goneReason: DaemonClientGoneReason | undefined;\n\t/** Connect (or await the in-flight connect). Rejects when reconnect is off and the dial fails. */\n\tconnect(): Promise<void>;\n\trequest(req: DistributiveOmit<ControlRequest, \"id\">): Promise<ControlResponse>;\n\t/**\n\t * Await the next response for a request id (used after a provisional\n\t * lease_pending). Rejects with DaemonClientClosedError on disconnect.\n\t */\n\twaitForResponse(id: string): Promise<ControlResponse>;\n\t/** Dial a fresh control endpoint with role:\"relay\"; returns the raw duplex after the preamble. */\n\topenRelay(offer: RelayOfferInfo): Promise<{ preamble: RelayPreamble; stream: Duplex }>;\n\tclose(): Promise<void>;\n}\n\nexport type DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;\n\ninterface PendingRequest {\n\tresolve(response: ControlResponse): void;\n\treject(error: Error): void;\n}\n\n/** Responses that announce a later terminal response for the same id. */\nfunction isProvisionalControlResponse(response: ControlResponse): boolean {\n\treturn response.type === \"lease_pending\";\n}\n\nconst DEFAULT_MIN_BACKOFF_MS = 250;\nconst DEFAULT_MAX_BACKOFF_MS = 5000;\nconst DEFAULT_HELLO_TIMEOUT_MS = 5000;\n\nexport function createDaemonClient(options: DaemonClientOptions): DaemonClient {\n\tconst reconnectEnabled = options.reconnect ?? true;\n\tconst minBackoffMs = options.minBackoffMs ?? DEFAULT_MIN_BACKOFF_MS;\n\tconst maxBackoffMs = options.maxBackoffMs ?? DEFAULT_MAX_BACKOFF_MS;\n\tconst helloTimeoutMs = options.helloTimeoutMs ?? DEFAULT_HELLO_TIMEOUT_MS;\n\n\tlet state: DaemonClientConnectionState = \"reconnecting\";\n\tlet socket: Socket | undefined;\n\tlet endpoint: DaemonClientEndpoint = {\n\t\tsocketPath: options.socketPath,\n\t\t...(options.authToken === undefined ? {} : { authToken: options.authToken }),\n\t};\n\tlet connectedEndpoint: DaemonClientEndpoint | undefined;\n\tlet hasAttemptedDial = false;\n\t// The socket for an in-flight dial (before hello_ack promotes it to `socket`).\n\t// Tracked so close() can destroy a mid-handshake dial instead of leaking it.\n\tlet dialing: Socket | undefined;\n\tlet serverInfo: { version?: string; protocolVersion?: number; connectionId?: string } | undefined;\n\tlet closed = false;\n\tlet goneReason: DaemonClientGoneReason | undefined;\n\tlet backoffMs = minBackoffMs;\n\tlet reconnectTimer: NodeJS.Timeout | undefined;\n\tlet connectPromise: Promise<void> | undefined;\n\tconst pending = new Map<string, PendingRequest>();\n\t/**\n\t * Terminal-response promises armed when a provisional response resolves the\n\t * original request. Armed synchronously inside the data handler: the\n\t * provisional and terminal frames can arrive in one socket read, while the\n\t * caller's waitForResponse only runs after the resolve's microtask — without\n\t * this, the terminal response would resolve the already-resolved original\n\t * promise and be lost.\n\t */\n\tconst followUps = new Map<string, Promise<ControlResponse>>();\n\n\tconst setState = (next: DaemonClientConnectionState) => {\n\t\tif (state === next) {\n\t\t\treturn;\n\t\t}\n\t\tstate = next;\n\t\toptions.onConnectionStateChange?.(next);\n\t};\n\n\tconst failPending = () => {\n\t\tconst entries = Array.from(pending.values());\n\t\tpending.clear();\n\t\tfollowUps.clear();\n\t\tfor (const entry of entries) {\n\t\t\tentry.reject(new DaemonClientClosedError());\n\t\t}\n\t};\n\n\tconst scheduleReconnect = () => {\n\t\tif (closed || !reconnectEnabled || reconnectTimer) {\n\t\t\treturn;\n\t\t}\n\t\tsetState(\"reconnecting\");\n\t\tconst jitter = 1 + (Math.random() * 0.4 - 0.2);\n\t\tconst delay = Math.min(maxBackoffMs, backoffMs) * jitter;\n\t\tbackoffMs = Math.min(maxBackoffMs, backoffMs * 2);\n\t\treconnectTimer = setTimeout(() => {\n\t\t\treconnectTimer = undefined;\n\t\t\tvoid dial().catch(() => {\n\t\t\t\tscheduleReconnect();\n\t\t\t});\n\t\t}, delay);\n\t\treconnectTimer.unref?.();\n\t};\n\n\tconst dial = (): Promise<void> => {\n\t\tif (closed) {\n\t\t\treturn Promise.reject(new DaemonClientClosedError());\n\t\t}\n\t\tif (connectPromise) {\n\t\t\treturn connectPromise;\n\t\t}\n\t\tif (socket && !socket.destroyed) {\n\t\t\t// A racing dial (manual connect vs the backoff timer) must never stack\n\t\t\t// a second live connection: the orphaned socket would keep delivering\n\t\t\t// duplicate events and hold a phantom daemon connection open.\n\t\t\treturn Promise.resolve();\n\t\t}\n\t\tif (hasAttemptedDial && options.refreshEndpoint) {\n\t\t\ttry {\n\t\t\t\tconst refreshed = options.refreshEndpoint();\n\t\t\t\tif (refreshed) {\n\t\t\t\t\t// Replace the complete endpoint so a tokenless legacy pidfile also\n\t\t\t\t\t// clears credentials from the previous daemon instance.\n\t\t\t\t\tendpoint = {\n\t\t\t\t\t\tsocketPath: refreshed.socketPath,\n\t\t\t\t\t\t...(refreshed.authToken === undefined ? {} : { authToken: refreshed.authToken }),\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tconst refreshError = error instanceof Error ? error : new Error(String(error));\n\t\t\t\tif (reconnectEnabled) {\n\t\t\t\t\tscheduleReconnect();\n\t\t\t\t} else {\n\t\t\t\t\tgoneReason = \"dial_failed\";\n\t\t\t\t\tsetState(\"gone\");\n\t\t\t\t}\n\t\t\t\treturn Promise.reject(refreshError);\n\t\t\t}\n\t\t}\n\t\thasAttemptedDial = true;\n\t\tconst dialEndpoint = endpoint;\n\t\tconnectPromise = new Promise<void>((resolve, reject) => {\n\t\t\tconst dialed = createConnection(dialEndpoint.socketPath);\n\t\t\tdialing = dialed;\n\t\t\tconst decoder = new ControlLineDecoder();\n\t\t\tlet acked = false;\n\t\t\tlet dialSettled = false;\n\t\t\tconst helloTimer = setTimeout(() => {\n\t\t\t\tfailDial(new Error(\"daemon hello timed out\"));\n\t\t\t}, helloTimeoutMs);\n\t\t\thelloTimer.unref?.();\n\n\t\t\tconst failDial = (error: Error, fatalReason?: DaemonClientGoneReason) => {\n\t\t\t\tif (dialSettled) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tdialSettled = true;\n\t\t\t\tclearTimeout(helloTimer);\n\t\t\t\tconnectPromise = undefined;\n\t\t\t\tdialing = undefined;\n\t\t\t\tdialed.destroy();\n\t\t\t\tif (fatalReason) {\n\t\t\t\t\tclosed = true;\n\t\t\t\t\tgoneReason = fatalReason;\n\t\t\t\t\tsetState(\"gone\");\n\t\t\t\t} else if (reconnectEnabled && !closed) {\n\t\t\t\t\tscheduleReconnect();\n\t\t\t\t} else {\n\t\t\t\t\tgoneReason = \"dial_failed\";\n\t\t\t\t\tsetState(\"gone\");\n\t\t\t\t}\n\t\t\t\treject(error);\n\t\t\t};\n\n\t\t\tdialed.on(\"connect\", () => {\n\t\t\t\tdialed.write(\n\t\t\t\t\tencodeControlLine({\n\t\t\t\t\t\ttype: \"hello\",\n\t\t\t\t\t\trole: \"control\",\n\t\t\t\t\t\tprotocolVersion: PROTOCOL_VERSION,\n\t\t\t\t\t\tpid: process.pid,\n\t\t\t\t\t\tversion: options.version,\n\t\t\t\t\t\tclient: options.client,\n\t\t\t\t\t\t...(dialEndpoint.authToken === undefined ? {} : { controlToken: dialEndpoint.authToken }),\n\t\t\t\t\t\t...(options.capabilities === undefined ? {} : { capabilities: options.capabilities }),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t});\n\t\t\tdialed.on(\"data\", (chunk) => {\n\t\t\t\tlet messages: unknown[];\n\t\t\t\ttry {\n\t\t\t\t\tmessages = decoder.push(chunk);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tdialed.destroy(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tfor (const message of messages) {\n\t\t\t\t\tif (!acked) {\n\t\t\t\t\t\tif (!isHelloAck(message)) {\n\t\t\t\t\t\t\tfailDial(new Error(\"daemon did not answer hello\"));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst ack: HelloAck = message;\n\t\t\t\t\t\tif (!ack.ok) {\n\t\t\t\t\t\t\tfailDial(\n\t\t\t\t\t\t\t\tnew Error(`daemon rejected hello: ${ack.error ?? \"unknown\"}`),\n\t\t\t\t\t\t\t\tack.error === \"protocol_mismatch\" ? \"protocol_mismatch\" : undefined,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (closed) {\n\t\t\t\t\t\t\t// close() ran while this dial was mid-handshake. Do not adopt\n\t\t\t\t\t\t\t// the socket or flip to \"connected\"; drop the late ack and the\n\t\t\t\t\t\t\t// now-orphaned connection instead of leaking it.\n\t\t\t\t\t\t\tdialSettled = true;\n\t\t\t\t\t\t\tclearTimeout(helloTimer);\n\t\t\t\t\t\t\tconnectPromise = undefined;\n\t\t\t\t\t\t\tdialing = undefined;\n\t\t\t\t\t\t\tdialed.destroy();\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tacked = true;\n\t\t\t\t\t\tdialSettled = true;\n\t\t\t\t\t\tclearTimeout(helloTimer);\n\t\t\t\t\t\tdialing = undefined;\n\t\t\t\t\t\tsocket = dialed;\n\t\t\t\t\t\tconnectedEndpoint = dialEndpoint;\n\t\t\t\t\t\tserverInfo = {\n\t\t\t\t\t\t\tversion: ack.version,\n\t\t\t\t\t\t\tprotocolVersion: ack.protocolVersion,\n\t\t\t\t\t\t\tconnectionId: ack.connectionId,\n\t\t\t\t\t\t};\n\t\t\t\t\t\tbackoffMs = minBackoffMs;\n\t\t\t\t\t\t// A pending backoff dial is now redundant (and dial()'s live-socket\n\t\t\t\t\t\t// guard would make it a no-op anyway); drop it.\n\t\t\t\t\t\tif (reconnectTimer) {\n\t\t\t\t\t\t\tclearTimeout(reconnectTimer);\n\t\t\t\t\t\t\treconnectTimer = undefined;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconnectPromise = undefined;\n\t\t\t\t\t\tgoneReason = undefined;\n\t\t\t\t\t\tsetState(\"connected\");\n\t\t\t\t\t\tresolve();\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tif (isControlResponse(message)) {\n\t\t\t\t\t\tconst entry = pending.get(message.id);\n\t\t\t\t\t\tif (entry) {\n\t\t\t\t\t\t\tif (isProvisionalControlResponse(message)) {\n\t\t\t\t\t\t\t\tconst followUp = registerPending(message.id);\n\t\t\t\t\t\t\t\t// Unclaimed on disconnect is fine; waitForResponse consumers\n\t\t\t\t\t\t\t\t// still observe the rejection through the same promise.\n\t\t\t\t\t\t\t\tfollowUp.catch(() => {});\n\t\t\t\t\t\t\t\tfollowUps.set(message.id, followUp);\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t// Keep any armed followUps entry: the terminal response may\n\t\t\t\t\t\t\t\t// resolve it before waitForResponse claims it.\n\t\t\t\t\t\t\t\tpending.delete(message.id);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tentry.resolve(message);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tif (isControlEvent(message)) {\n\t\t\t\t\t\toptions.onEvent?.(message);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t\tdialed.on(\"error\", (error) => {\n\t\t\t\tif (!acked) {\n\t\t\t\t\tfailDial(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t}\n\t\t\t});\n\t\t\tdialed.on(\"close\", () => {\n\t\t\t\tif (!acked) {\n\t\t\t\t\tfailDial(new DaemonClientClosedError(\"daemon connection closed before hello\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (socket === dialed) {\n\t\t\t\t\tsocket = undefined;\n\t\t\t\t\tconnectedEndpoint = undefined;\n\t\t\t\t\tserverInfo = undefined;\n\t\t\t\t\tfailPending();\n\t\t\t\t\tif (closed) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (reconnectEnabled) {\n\t\t\t\t\t\tscheduleReconnect();\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// A reconnect-disabled client (e.g. `volt remote pair`) has no path\n\t\t\t\t\t\t// back to the daemon once its established connection drops.\n\t\t\t\t\t\t// Transition to \"gone\" so onConnectionStateChange fires and callers\n\t\t\t\t\t\t// awaiting the connection (whenConnectionLost) unblock instead of\n\t\t\t\t\t\t// hanging forever.\n\t\t\t\t\t\tgoneReason = \"closed\";\n\t\t\t\t\t\tsetState(\"gone\");\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t\treturn connectPromise;\n\t};\n\n\tconst send = (request: ControlRequest): void => {\n\t\tif (!socket || socket.destroyed) {\n\t\t\tthrow new DaemonClientClosedError(\"not connected to daemon\");\n\t\t}\n\t\tsocket.write(encodeControlLine(request));\n\t};\n\n\tconst registerPending = (id: string): Promise<ControlResponse> => {\n\t\treturn new Promise<ControlResponse>((resolve, reject) => {\n\t\t\tpending.set(id, { resolve, reject });\n\t\t});\n\t};\n\n\treturn {\n\t\tget connectionState() {\n\t\t\treturn state;\n\t\t},\n\t\tget serverInfo() {\n\t\t\treturn serverInfo;\n\t\t},\n\t\tget goneReason() {\n\t\t\treturn goneReason;\n\t\t},\n\t\tasync connect() {\n\t\t\tif (closed) {\n\t\t\t\tthrow new DaemonClientClosedError();\n\t\t\t}\n\t\t\tif (socket && !socket.destroyed) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tawait dial();\n\t\t},\n\t\tasync request(req) {\n\t\t\tif (!socket || socket.destroyed) {\n\t\t\t\tif (reconnectTimer && !connectPromise) {\n\t\t\t\t\tthrow new DaemonClientClosedError(\"not connected to daemon\");\n\t\t\t\t}\n\t\t\t\tawait this.connect();\n\t\t\t}\n\t\t\tconst id = randomUUID();\n\t\t\tconst responsePromise = registerPending(id);\n\t\t\tsend({ ...req, id } as ControlRequest);\n\t\t\treturn responsePromise;\n\t\t},\n\t\twaitForResponse(id: string) {\n\t\t\tconst followUp = followUps.get(id);\n\t\t\tif (followUp) {\n\t\t\t\tfollowUps.delete(id);\n\t\t\t\treturn followUp;\n\t\t\t}\n\t\t\treturn registerPending(id);\n\t\t},\n\t\topenRelay(offer: RelayOfferInfo) {\n\t\t\t// Established clients use the exact endpoint that issued the offer;\n\t\t\t// direct relay-only clients retain the original static endpoint.\n\t\t\tconst relayEndpoint = connectedEndpoint ?? endpoint;\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tconst relaySocket = createConnection(relayEndpoint.socketPath);\n\t\t\t\tconst decoder = new ControlLineDecoder();\n\t\t\t\tlet acked = false;\n\t\t\t\tlet settled = false;\n\n\t\t\t\tconst fail = (error: Error) => {\n\t\t\t\t\tif (settled) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tsettled = true;\n\t\t\t\t\trelaySocket.destroy();\n\t\t\t\t\treject(error);\n\t\t\t\t};\n\n\t\t\t\tconst onData = (chunk: Buffer) => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\t// One line at a time: bytes after the preamble are raw relay\n\t\t\t\t\t\t// payload and must never be JSON-decoded.\n\t\t\t\t\t\tdecoder.pushEach(chunk, (message) => {\n\t\t\t\t\t\t\tif (!acked) {\n\t\t\t\t\t\t\t\tif (!isHelloAck(message) || !message.ok) {\n\t\t\t\t\t\t\t\t\tfail(new Error(\"relay hello rejected\"));\n\t\t\t\t\t\t\t\t\treturn \"stop\";\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tacked = true;\n\t\t\t\t\t\t\t\treturn \"continue\";\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tif (!isRelayPreamble(message)) {\n\t\t\t\t\t\t\t\tfail(new Error(\"expected relay preamble\"));\n\t\t\t\t\t\t\t\treturn \"stop\";\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tsettled = true;\n\t\t\t\t\t\t\trelaySocket.removeListener(\"data\", onData);\n\t\t\t\t\t\t\trelaySocket.pause();\n\t\t\t\t\t\t\tconst remainder = decoder.drainRemainder();\n\t\t\t\t\t\t\tif (remainder.length > 0) {\n\t\t\t\t\t\t\t\trelaySocket.unshift(remainder);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tresolve({ preamble: message, stream: relaySocket });\n\t\t\t\t\t\t\treturn \"stop\";\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tfail(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\trelaySocket.on(\"connect\", () => {\n\t\t\t\t\trelaySocket.write(\n\t\t\t\t\t\tencodeControlLine({\n\t\t\t\t\t\t\ttype: \"hello\",\n\t\t\t\t\t\t\trole: \"relay\",\n\t\t\t\t\t\t\tprotocolVersion: PROTOCOL_VERSION,\n\t\t\t\t\t\t\trelayId: offer.relayId,\n\t\t\t\t\t\t\trelayToken: offer.relayToken,\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t\t\trelaySocket.on(\"data\", onData);\n\t\t\t\trelaySocket.on(\"error\", (error) => fail(error instanceof Error ? error : new Error(String(error))));\n\t\t\t\trelaySocket.on(\"close\", () => fail(new DaemonClientClosedError(\"relay connection closed\")));\n\t\t\t});\n\t\t},\n\t\tasync close() {\n\t\t\tclosed = true;\n\t\t\tgoneReason = \"closed\";\n\t\t\tif (reconnectTimer) {\n\t\t\t\tclearTimeout(reconnectTimer);\n\t\t\t\treconnectTimer = undefined;\n\t\t\t}\n\t\t\tfailPending();\n\t\t\tsocket?.destroy();\n\t\t\tsocket = undefined;\n\t\t\tconnectedEndpoint = undefined;\n\t\t\t// Destroy a dial that is still mid-handshake; otherwise a late hello_ack\n\t\t\t// would leave a live, owner-less daemon connection open.\n\t\t\tdialing?.destroy();\n\t\t\tdialing = undefined;\n\t\t\tconnectPromise = undefined;\n\t\t\tsetState(\"gone\");\n\t\t},\n\t};\n}\n"]}