agentroam 0.2.0-preview.26 → 0.2.0-preview.27

package/dist/service/launcher-cleanup.test.js

@@ -1,81 +0,0 @@
-import { afterEach, expect, it } from "vitest";
-import { mkdtemp, mkdir, writeFile, readFile, rm, symlink, realpath } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { resolve } from "node:path";
-import { cleanupOldLaunchers } from "./launcher-cleanup.js";
-const temporary = [];
-afterEach(async () => { await Promise.all(temporary.splice(0).map(path => rm(path, { recursive: true, force: true }))); });
-async function fixture() {
-    const dataDir = await realpath(await mkdtemp(resolve(tmpdir(), "launcher-cleanup-")));
-    temporary.push(dataDir);
-    async function install(version) {
-        const root = resolve(dataDir, "launcher", version);
-        const pkg = resolve(root, "node_modules/agentroam");
-        await mkdir(resolve(pkg, "bin"), { recursive: true });
-        await writeFile(resolve(pkg, "package.json"), JSON.stringify({ name: "agentroam", version }));
-        await writeFile(resolve(pkg, "bin/agentroam.mjs"), "// fixture");
-        return root;
-    }
-    const current = await install("0.2.0-preview.19");
-    const config = { dataDir, version: "0.2.0-preview.19", cliPath: resolve(current, "node_modules/agentroam/bin/agentroam.mjs"), roots: [] };
-    return { dataDir, current, config, install };
-}
-it("removes an older managed program while retaining current, newer versions and user data", async () => {
-    const f = await fixture();
-    const old = await f.install("0.2.0-preview.18");
-    const newer = await f.install("0.2.0-preview.20");
-    for (const file of ["config.json", "agent.db", "pairing.db"])
-        await writeFile(resolve(f.dataDir, file), "preserve");
-    await cleanupOldLaunchers(f.config, () => { });
-    await expect(readFile(resolve(old, "node_modules/agentroam/package.json"))).rejects.toMatchObject({ code: "ENOENT" });
-    for (const root of [f.current, newer])
-        expect(await readFile(resolve(root, "node_modules/agentroam/package.json"), "utf8")).toContain("agentroam");
-    for (const file of ["config.json", "agent.db", "pairing.db"])
-        expect(await readFile(resolve(f.dataDir, file), "utf8")).toBe("preserve");
-});
-it("preserves project roots, unexpected data, locked installs, and linked versions", async () => {
-    const f = await fixture();
-    const project = await f.install("0.2.0-preview.15");
-    f.config.roots = [project];
-    const data = await f.install("0.2.0-preview.16");
-    await writeFile(resolve(data, "session.db"), "preserve");
-    const locked = await f.install("0.2.0-preview.17");
-    await mkdir(`${locked}.lock`);
-    await symlink(data, resolve(f.dataDir, "launcher/0.2.0-preview.14"));
-    await cleanupOldLaunchers(f.config, () => { });
-    for (const root of [project, data, locked])
-        expect(await readFile(resolve(root, "node_modules/agentroam/package.json"), "utf8")).toContain("agentroam");
-});
-it("does not clean when the active CLI is outside the managed installation", async () => {
-    const f = await fixture();
-    const old = await f.install("0.2.0-preview.18");
-    f.config.cliPath = resolve(f.dataDir, "npx/agentroam.mjs");
-    await cleanupOldLaunchers(f.config, () => { });
-    expect(await readFile(resolve(old, "node_modules/agentroam/package.json"), "utf8")).toContain("agentroam");
-});
-it.each(["starting", "failed", "ready"])("cleans only after a replacement service is ready (%s)", async (status) => {
-    const { runServiceCommand } = await import("./service-command.js");
-    const { parseArgs } = await import("../args.js");
-    const f = await fixture();
-    const old = await f.install("0.2.0-preview.18");
-    const install = async () => {
-        if (status === "failed")
-            throw new Error("activation failed");
-        return { definition: "test", state: { status, version: f.config.version } };
-    };
-    const action = runServiceCommand(parseArgs(["service", "install", "--data-dir", f.dataDir]), {
-        platform: "darwin", arch: "arm64", nodeVersion: "25.8.0", nodePath: process.execPath,
-        cliPath: f.config.cliPath, version: f.config.version, log: () => { },
-        codexResolver: async () => ({ executable: "/test/codex", version: "test", source: "global" }),
-        controller: { install },
-    });
-    if (status === "failed")
-        await expect(action).rejects.toThrow("activation failed");
-    else
-        await action;
-    const manifest = readFile(resolve(old, "node_modules/agentroam/package.json"), "utf8");
-    if (status === "ready")
-        await expect(manifest).rejects.toMatchObject({ code: "ENOENT" });
-    else
-        expect(await manifest).toContain("agentroam");
-});

package/dist/service/macos-launch-agent.test.js

@@ -1,327 +0,0 @@
-import { chmod, mkdtemp, mkdir, readFile, stat, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { resolve } from "node:path";
-import { describe, expect, it, vi } from "vitest";
-import { MacLaunchAgent, buildLaunchAgentPlist, buildStartArguments, } from "./macos-launch-agent.js";
-import { resolveServicePaths, writePrivateJson, writePrivateText } from "./service-files.js";
-describe("MacLaunchAgent", () => {
-    it("builds one launchd job with separate absolute arguments", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-plist-"));
-        const paths = resolveServicePaths(home, resolve(home, "data with spaces"));
-        const value = config(home, paths.dataDir);
-        expect(buildStartArguments(value)).toEqual([
-            value.nodePath, value.cliPath, "start", "--root", value.roots[0], "--root", value.roots[1],
-            "--port", "3001", "--relay", "custom", "--tunnel-command", "relay --port {port}",
-            "--data-dir", paths.dataDir, "--no-qr",
-        ]);
-        expect(buildLaunchAgentPlist(value, paths)).toMatchObject({
-            Label: "com.agentroam.service",
-            WorkingDirectory: value.roots[0],
-            RunAtLoad: true,
-            KeepAlive: true,
-            ThrottleInterval: 5,
-            EnvironmentVariables: {
-                AGENTROAM_SERVICE: "1",
-                PATH: value.environmentPath,
-                AGENT_CODEX_BIN: value.codexPath,
-                CODEX_HOME: value.codexHome,
-            },
-        });
-    });
-    it("installs, reloads, and waits for a ready service", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-install-"));
-        const paths = resolveServicePaths(home);
-        const value = config(home, paths.dataDir);
-        await createConfigFiles(value);
-        const calls = [];
-        let printCount = 0;
-        const runner = async (command, args) => {
-            calls.push([command, ...args]);
-            if (command === "plutil" && args[0] === "-convert") {
-                await writeFile(args[3], "<?xml version=\"1.0\"?><plist version=\"1.0\"><dict/></plist>");
-            }
-            if (command === "launchctl" && args[0] === "print") {
-                printCount++;
-                return { code: printCount === 1 ? 0 : 1, stdout: "state = exited", stderr: "" };
-            }
-            if (command === "launchctl" && args[0] === "bootstrap") {
-                await writePrivateJson(paths.statePath, {
-                    status: "ready", pid: 777, version: value.version, startedAt: value.installedAt,
-                    updatedAt: value.installedAt, accessUrl: "https://ready.example/web",
-                });
-            }
-            return { code: 0, stdout: "", stderr: "" };
-        };
-        const result = await new MacLaunchAgent({ homeDir: home, uid: 501, runner, readyTimeoutMs: 10 }).install(value);
-        expect(result.state).toMatchObject({ status: "ready", pid: 777 });
-        expect(calls).toContainEqual(["launchctl", "bootout", "gui/501/com.agentroam.service"]);
-        expect(calls).toContainEqual(["launchctl", "bootstrap", "gui/501", paths.plistPath]);
-        expect((await stat(paths.plistPath)).mode & 0o777).toBe(0o600);
-        expect(JSON.parse(await readFile(paths.configPath, "utf8"))).toMatchObject({ roots: value.roots });
-    });
-    it("waits for the previous launchd job and process before bootstrapping a replacement", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-reinstall-"));
-        const paths = resolveServicePaths(home);
-        const value = config(home, paths.dataDir);
-        await createConfigFiles(value);
-        await mkdir(paths.launchAgentsDir, { recursive: true });
-        await writeFile(paths.plistPath, "old plist");
-        await writePrivateJson(paths.configPath, { ...value, version: "0.2.0-preview.8" });
-        await writePrivateJson(paths.statePath, {
-            status: "ready", pid: 700, version: "0.2.0-preview.8", startedAt: "x", updatedAt: "x",
-        });
-        await writePrivateText(resolve(paths.dataDir, "data/keep.txt"), "keep");
-        await writePrivateText(paths.stdoutPath, "keep logs");
-        let loaded = true;
-        let processChecks = 0;
-        const lifecycle = [];
-        const runner = async (command, args) => {
-            if (command === "plutil" && args[0] === "-convert") {
-                await writeFile(args[3], "<?xml version=\"1.0\"?><plist version=\"1.0\"><dict/></plist>");
-            }
-            if (command === "launchctl" && args[0] === "print") {
-                return { code: loaded ? 0 : 1, stdout: loaded ? "state = running" : "", stderr: "" };
-            }
-            if (command === "launchctl" && args[0] === "bootout")
-                lifecycle.push("bootout");
-            if (command === "launchctl" && args[0] === "bootstrap") {
-                lifecycle.push("bootstrap");
-                await writePrivateJson(paths.statePath, {
-                    status: "ready", pid: 701, version: value.version, startedAt: "y", updatedAt: "y",
-                    accessUrl: "https://ready.example/web",
-                });
-            }
-            return { code: 0, stdout: "", stderr: "" };
-        };
-        const processExists = vi.fn(() => {
-            processChecks++;
-            if (processChecks === 1)
-                return true;
-            loaded = false;
-            lifecycle.push("process-exit");
-            return false;
-        });
-        const result = await new MacLaunchAgent({
-            homeDir: home,
-            uid: 501,
-            runner,
-            processExists,
-            readyTimeoutMs: 20,
-            stopTimeoutMs: 50,
-            pollIntervalMs: 1,
-        }).install(value);
-        expect(result.state).toMatchObject({ status: "ready", pid: 701 });
-        expect(lifecycle).toEqual(["bootout", "process-exit", "bootstrap"]);
-        expect(processExists).toHaveBeenCalledWith(700);
-        expect(await readFile(resolve(paths.dataDir, "data/keep.txt"), "utf8")).toBe("keep");
-        expect(await readFile(paths.stdoutPath, "utf8")).toBe("keep logs");
-    });
-    it("waits for launchd to remove a previous job when no runtime pid is available", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-reinstall-no-pid-"));
-        const paths = resolveServicePaths(home);
-        const value = config(home, paths.dataDir);
-        await createConfigFiles(value);
-        let printCount = 0;
-        let bootedOut = false;
-        let bootstrapPrintCount = 0;
-        const runner = async (command, args) => {
-            if (command === "plutil" && args[0] === "-convert") {
-                await writeFile(args[3], "<?xml version=\"1.0\"?><plist version=\"1.0\"><dict/></plist>");
-            }
-            if (command === "launchctl" && args[0] === "print") {
-                printCount++;
-                const loaded = !bootedOut || printCount < 3;
-                return { code: loaded ? 0 : 1, stdout: loaded ? "state = exited" : "", stderr: "" };
-            }
-            if (command === "launchctl" && args[0] === "bootout")
-                bootedOut = true;
-            if (command === "launchctl" && args[0] === "bootstrap") {
-                bootstrapPrintCount = printCount;
-                await writePrivateJson(paths.statePath, {
-                    status: "ready", pid: 701, version: value.version, startedAt: "y", updatedAt: "y",
-                });
-            }
-            return { code: 0, stdout: "", stderr: "" };
-        };
-        await new MacLaunchAgent({
-            homeDir: home,
-            uid: 501,
-            runner,
-            readyTimeoutMs: 20,
-            stopTimeoutMs: 50,
-            pollIntervalMs: 1,
-        }).install(value);
-        expect(bootstrapPrintCount).toBeGreaterThanOrEqual(3);
-    });
-    it("does not bootstrap while the previous launchd job is still loaded", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-reinstall-timeout-"));
-        const paths = resolveServicePaths(home);
-        const value = config(home, paths.dataDir);
-        await createConfigFiles(value);
-        const calls = [];
-        const runner = async (command, args) => {
-            calls.push(`${command} ${args[0] ?? ""}`);
-            if (command === "plutil" && args[0] === "-convert") {
-                await writeFile(args[3], "<?xml version=\"1.0\"?><plist version=\"1.0\"><dict/></plist>");
-            }
-            if (command === "launchctl" && args[0] === "print") {
-                return { code: 0, stdout: "state = exited", stderr: "" };
-            }
-            return { code: 0, stdout: "", stderr: "" };
-        };
-        await expect(new MacLaunchAgent({
-            homeDir: home,
-            uid: 501,
-            runner,
-            stopTimeoutMs: 0,
-            pollIntervalMs: 1,
-        }).install(value)).rejects.toThrow("did not unload after launchctl bootout");
-        expect(calls).not.toContain("launchctl bootstrap");
-    });
-    it("reports ready URLs only while the installed job is running", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-url-"));
-        const paths = resolveServicePaths(home);
-        const value = config(home, paths.dataDir);
-        await mkdir(paths.launchAgentsDir, { recursive: true });
-        await writeFile(paths.plistPath, "plist");
-        await writePrivateJson(paths.configPath, value);
-        await writePrivateJson(paths.statePath, {
-            status: "ready", pid: 777, version: value.version, startedAt: value.installedAt,
-            updatedAt: value.installedAt, accessUrl: "https://ready.example/web",
-        });
-        await writePrivateText(paths.urlPath, "https://ready.example/web\n");
-        const running = async () => ({ code: 0, stdout: "state = running", stderr: "" });
-        expect(await new MacLaunchAgent({ homeDir: home, uid: 501, runner: running }).url())
-            .toBe("https://ready.example/web");
-        await writePrivateText(paths.urlPath, "https://stale.example/web\n");
-        await expect(new MacLaunchAgent({ homeDir: home, uid: 501, runner: running }).url()).rejects.toThrow("stale");
-    });
-    it("starts and stops an installed service while preserving registration", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-start-stop-"));
-        const paths = resolveServicePaths(home);
-        const value = config(home, paths.dataDir);
-        await mkdir(paths.launchAgentsDir, { recursive: true });
-        await writeFile(paths.plistPath, "plist");
-        await writePrivateJson(paths.configPath, value);
-        await writePrivateJson(paths.statePath, {
-            status: "stopped", pid: 700, version: value.version, startedAt: "x", updatedAt: "x",
-        });
-        let loaded = false;
-        let processRunning = false;
-        const calls = [];
-        const runner = async (command, args) => {
-            calls.push([command, ...args]);
-            if (command === "launchctl" && args[0] === "print") {
-                return { code: loaded ? 0 : 1, stdout: loaded ? "state = running" : "", stderr: "" };
-            }
-            if (command === "launchctl" && args[0] === "bootstrap") {
-                loaded = true;
-                processRunning = true;
-                await writePrivateJson(paths.statePath, {
-                    status: "ready", pid: 701, version: value.version, startedAt: "y", updatedAt: "y",
-                    accessUrl: "https://ready.example/web",
-                });
-            }
-            if (command === "launchctl" && args[0] === "bootout") {
-                loaded = false;
-                processRunning = false;
-            }
-            return { code: 0, stdout: "", stderr: "" };
-        };
-        const launchAgent = new MacLaunchAgent({
-            homeDir: home,
-            uid: 501,
-            runner,
-            processExists: () => processRunning,
-            readyTimeoutMs: 50,
-            stopTimeoutMs: 50,
-            pollIntervalMs: 1,
-        });
-        const state = await launchAgent.start();
-        expect(state).toMatchObject({ status: "ready", pid: 701 });
-        expect((await launchAgent.status()).definition).toBe(paths.plistPath);
-        await launchAgent.stop();
-        expect(calls).toContainEqual(["launchctl", "bootstrap", "gui/501", paths.plistPath]);
-        expect(calls).toContainEqual(["launchctl", "bootout", "gui/501/com.agentroam.service"]);
-        expect(await readFile(paths.plistPath, "utf8")).toBe("plist");
-        expect(JSON.parse(await readFile(paths.configPath, "utf8"))).toMatchObject({ version: value.version });
-    });
-    it("uninstalls service control files but preserves application data and logs", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-uninstall-"));
-        const paths = resolveServicePaths(home);
-        const value = config(home, paths.dataDir);
-        await mkdir(paths.launchAgentsDir, { recursive: true });
-        await writeFile(paths.plistPath, "plist");
-        await writePrivateJson(paths.configPath, value);
-        await writePrivateJson(paths.statePath, { status: "starting", pid: 1, version: value.version, startedAt: "x", updatedAt: "x" });
-        await writePrivateText(paths.urlPath, "url\n");
-        await writePrivateText(resolve(paths.dataDir, "data/keep.txt"), "keep");
-        await writePrivateText(paths.stdoutPath, "keep logs");
-        const calls = [];
-        let processRunning = true;
-        let exitWrite = null;
-        const runner = async (command, args) => {
-            calls.push([command, ...args]);
-            if (command === "launchctl" && args[0] === "bootout") {
-                exitWrite = writePrivateJson(paths.statePath, {
-                    status: "stopped", pid: 1, version: value.version, startedAt: "x", updatedAt: "x",
-                }).then(() => { processRunning = false; });
-            }
-            return { code: 0, stdout: "", stderr: "" };
-        };
-        const processExists = vi.fn(() => processRunning);
-        const result = await new MacLaunchAgent({
-            homeDir: home,
-            uid: 501,
-            runner,
-            processExists,
-            pollIntervalMs: 1,
-            stopTimeoutMs: 100,
-        }).uninstall();
-        await exitWrite;
-        expect(result).toEqual({ removed: true, preservedDataDir: paths.dataDir });
-        expect(calls).toContainEqual(["launchctl", "bootout", "gui/501/com.agentroam.service"]);
-        expect(processExists).toHaveBeenCalled();
-        await expect(readFile(paths.configPath)).rejects.toMatchObject({ code: "ENOENT" });
-        await expect(readFile(paths.statePath)).rejects.toMatchObject({ code: "ENOENT" });
-        expect(await readFile(resolve(paths.dataDir, "data/keep.txt"), "utf8")).toBe("keep");
-        expect(await readFile(paths.stdoutPath, "utf8")).toBe("keep logs");
-    });
-    it("rejects an npx cache entrypoint", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-launch-agent-npx-"));
-        const value = config(home, resolve(home, ".agentroam"));
-        value.cliPath = resolve(home, ".npm/_npx/hash/node_modules/agentroam/bin/agentroam.mjs");
-        await expect(new MacLaunchAgent({ homeDir: home }).install(value)).rejects.toThrow("npm install -g");
-    });
-});
-function config(home, dataDir) {
-    const nodePath = resolve(home, "bin/node");
-    const cliPath = resolve(home, "lib/agentroam/bin/agentroam.mjs");
-    const roots = [resolve(home, "workspace one"), resolve(home, "workspace-two")];
-    return {
-        version: "0.2.0-preview.9",
-        nodePath,
-        cliPath,
-        environmentPath: `${resolve(home, "bin")}:/usr/bin:/bin:/usr/sbin:/sbin`,
-        codexPath: resolve(home, "bin/codex"),
-        codexHome: resolve(home, ".codex"),
-        roots,
-        port: 3001,
-        relay: "custom",
-        tunnelCommand: "relay --port {port}",
-        localOnly: false,
-        dataDir,
-        installedAt: "2026-09-03T00:00:00.000Z",
-    };
-}
-async function createConfigFiles(value) {
-    await Promise.all([
-        writePrivateText(value.nodePath, "node"),
-        writePrivateText(value.cliPath, "cli"),
-        ...(value.codexPath ? [writePrivateText(value.codexPath, "codex")] : []),
-        ...value.roots.map((root) => mkdir(root, { recursive: true })),
-    ]);
-    await chmod(value.nodePath, 0o700);
-    if (value.codexPath)
-        await chmod(value.codexPath, 0o700);
-}

package/dist/service/runtime-state.test.js

@@ -1,46 +0,0 @@
-import { access, mkdtemp, readFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { resolve } from "node:path";
-import { describe, expect, it } from "vitest";
-import { ServiceRuntimeReporter } from "./runtime-state.js";
-import { readServiceState, resolveServicePaths, writePrivateJson } from "./service-files.js";
-describe("ServiceRuntimeReporter", () => {
-    it("publishes starting, ready, and stopped state without leaving a stale URL", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-service-state-"));
-        const paths = resolveServicePaths(home);
-        let tick = 0;
-        const reporter = new ServiceRuntimeReporter(paths, "0.2.0-preview.9", 123, () => new Date(1_000 + tick++));
-        await reporter.starting();
-        expect(await readServiceState(paths)).toMatchObject({ status: "starting", pid: 123, version: "0.2.0-preview.9" });
-        await expect(access(paths.urlPath)).rejects.toMatchObject({ code: "ENOENT" });
-        await reporter.localReady("http://127.0.0.1:49157");
-        expect(await readServiceState(paths)).toMatchObject({ status: "starting", localUrl: "http://127.0.0.1:49157", pid: 123 });
-        await expect(access(paths.urlPath)).rejects.toMatchObject({ code: "ENOENT" });
-        await reporter.ready({
-            localUrl: "http://127.0.0.1:3000",
-            publicUrl: "https://example.trycloudflare.com",
-            accessUrl: "https://example.trycloudflare.com/web?pair=secret",
-            provider: "cloudflare",
-        });
-        expect(await readServiceState(paths)).toMatchObject({ status: "ready", provider: "cloudflare" });
-        expect(await readFile(paths.urlPath, "utf8")).toBe("https://example.trycloudflare.com/web?pair=secret\n");
-        expect(await reporter.stopped()).toBe(true);
-        expect(await readServiceState(paths)).toMatchObject({ status: "stopped", pid: 123 });
-        await expect(access(paths.urlPath)).rejects.toMatchObject({ code: "ENOENT" });
-    });
-    it("does not let an older process clear a newer process state", async () => {
-        const home = await mkdtemp(resolve(tmpdir(), "agentroam-service-state-race-"));
-        const paths = resolveServicePaths(home);
-        const reporter = new ServiceRuntimeReporter(paths, "old", 123);
-        await writePrivateJson(paths.statePath, {
-            status: "ready",
-            pid: 456,
-            version: "new",
-            startedAt: "2026-09-03T00:00:00.000Z",
-            updatedAt: "2026-09-03T00:00:01.000Z",
-            accessUrl: "https://new.example/web",
-        });
-        expect(await reporter.stopped()).toBe(false);
-        expect(await readServiceState(paths)).toMatchObject({ status: "ready", pid: 456 });
-    });
-});

package/dist/service/service-command.test.js

@@ -1,189 +0,0 @@
-import { resolve } from "node:path";
-import { describe, expect, it, vi } from "vitest";
-import { buildServiceEnvironmentPath, runServiceCommand } from "./service-command.js";
-describe("runServiceCommand", () => {
-    it.each(["22.22.0", "24.0.0", "25.8.0", "26.0.0"])("keeps the selected Node %s when installing a service", async (nodeVersion) => {
-        const install = vi.fn(async () => ({ definition: "/test/service.plist" }));
-        const nodePath = `/runtimes/node-${nodeVersion}/bin/node`;
-        const codexResolver = vi.fn(async () => ({ executable: "/tools/codex", version: "test", source: "global" }));
-        await runServiceCommand(options("install"), {
-            platform: "darwin", arch: "arm64", nodeVersion, nodePath,
-            cliPath: "/agentroam.mjs", version: "test", environment: { PATH: "/usr/bin" },
-            codexResolver, controller: controller({ install }), log: vi.fn(),
-        });
-        expect(install).toHaveBeenCalledWith(expect.objectContaining({ nodePath }));
-        expect(codexResolver).toHaveBeenCalledWith(expect.objectContaining({ nodeExecutable: nodePath }));
-    });
-    it("rejects a below-minimum service runtime before installation", async () => {
-        const install = vi.fn();
-        await expect(runServiceCommand(options("install"), {
-            platform: "darwin", nodePath: "/node", nodeVersion: "22.21.9", cliPath: "/agentroam.mjs",
-            version: "test", controller: controller({ install }),
-        })).rejects.toThrow("Node.js >=22.22.0");
-        expect(install).not.toHaveBeenCalled();
-    });
-    it("installs the service using absolute runtime context and parsed start options", async () => {
-        const install = vi.fn(async (config) => ({
-            paths: { plistPath: "/Users/test/Library/LaunchAgents/com.agentroam.service.plist" },
-            state: { status: "ready", accessUrl: "https://ready.example/web", localUrl: "http://127.0.0.1:4317/" },
-            definition: "/Users/test/Library/LaunchAgents/com.agentroam.service.plist",
-        }));
-        const log = vi.fn();
-        await runServiceCommand(options("install"), {
-            platform: "darwin",
-            nodePath: "/node",
-            cliPath: "/agentroam.mjs",
-            version: "0.2.0-preview.9",
-            nodeVersion: "22.22.0",
-            environment: { PATH: "/nvm/versions/node/v22.22.0/bin:/usr/bin", CODEX_HOME: "/Users/test/.custom-codex" },
-            codexResolver: vi.fn(async () => ({ executable: "/nvm/versions/node/v22.22.0/bin/codex", version: "0.153.0", source: "global" })),
-            now: () => new Date("2026-09-03T00:00:00.000Z"),
-            log,
-            controller: controller({ install }),
-            pairingPrinter: vi.fn(async () => { }),
-        });
-        expect(install).toHaveBeenCalledWith(expect.objectContaining({
-            nodePath: "/node",
-            cliPath: "/agentroam.mjs",
-            roots: [resolve("workspace")],
-            version: "0.2.0-preview.9",
-            environmentPath: "/:/nvm/versions/node/v22.22.0/bin:/usr/bin:/bin:/usr/sbin:/sbin",
-            codexPath: "/nvm/versions/node/v22.22.0/bin/codex",
-            codexHome: "/Users/test/.custom-codex",
-            installedAt: "2026-09-03T00:00:00.000Z",
-        }));
-        expect(log).toHaveBeenCalledWith("Open: https://ready.example/web");
-        expect(log).toHaveBeenCalledWith("远程桌面授权地址：http://127.0.0.1:4317/web");
-        expect(log).toHaveBeenCalledWith(expect.stringContaining("屏幕录制"));
-    });
-    it("prints a scannable QR code after the URL on interactive terminals", async () => {
-        const log = vi.fn();
-        await runServiceCommand({ ...options("start"), qr: true }, {
-            platform: "darwin",
-            nodePath: "/node",
-            cliPath: "/agentroam.mjs",
-            version: "test",
-            isTTY: true,
-            log,
-            controller: controller({ start: vi.fn(async () => ({ status: "ready", accessUrl: "https://ready.example/web" })) }),
-        });
-        const openIndex = log.mock.calls.findIndex(([line]) => line === "Open: https://ready.example/web");
-        expect(openIndex).toBeGreaterThanOrEqual(0);
-        const qr = log.mock.calls[openIndex + 2]?.[0];
-        expect(qr).toMatch(/[▀▄█]/);
-        expect(qr).toContain("\n");
-    });
-    it("keeps service output QR-free when piped or when --no-qr is set", async () => {
-        const log = vi.fn();
-        const start = vi.fn(async () => ({ status: "ready", accessUrl: "https://ready.example/web" }));
-        await runServiceCommand({ ...options("start"), qr: true }, {
-            platform: "darwin",
-            nodePath: "/node",
-            cliPath: "/agentroam.mjs",
-            version: "test",
-            isTTY: false,
-            log,
-            controller: controller({ start }),
-        });
-        await runServiceCommand(options("start"), {
-            platform: "darwin",
-            nodePath: "/node",
-            cliPath: "/agentroam.mjs",
-            version: "test",
-            isTTY: true,
-            log,
-            controller: controller({ start }),
-        });
-        const lines = log.mock.calls.map(([line]) => line);
-        expect(lines).toContain("Open: https://ready.example/web");
-        expect(lines.some((line) => /[▀▄█]/.test(String(line)))).toBe(false);
-    });
-    it("pins the selected Node directory ahead of the inherited service PATH", () => {
-        expect(buildServiceEnvironmentPath("/Users/test/.nvm/versions/node/v22.22.2/bin/node", "/usr/bin:/Users/test/.nvm/versions/node/v22.22.2/bin", "darwin")).toBe("/Users/test/.nvm/versions/node/v22.22.2/bin:/usr/bin:/bin:/usr/sbin:/sbin");
-    });
-    it("reports status without mutating an uninstalled service", async () => {
-        const log = vi.fn();
-        await runServiceCommand(options("status"), {
-            platform: "darwin",
-            nodePath: "/node",
-            cliPath: "/agentroam.mjs",
-            version: "test",
-            log,
-            controller: controller({ status: vi.fn(async () => ({ installed: false })) }),
-        });
-        expect(log).toHaveBeenCalledWith("AgentRoam service: not installed");
-    });
-    it("starts and stops a Windows service through the same command contract", async () => {
-        const start = vi.fn(async () => ({ status: "ready", accessUrl: "https://ready.example/web" }));
-        const stop = vi.fn(async () => undefined);
-        const log = vi.fn();
-        await runServiceCommand(options("start"), {
-            platform: "win32",
-            nodePath: "C:\\node.exe",
-            cliPath: "C:\\agentroam.mjs",
-            version: "test",
-            controller: controller({ start }),
-            log,
-        });
-        await runServiceCommand(options("stop"), {
-            platform: "win32",
-            nodePath: "C:\\node.exe",
-            cliPath: "C:\\agentroam.mjs",
-            version: "test",
-            controller: controller({ stop }),
-            log,
-        });
-        expect(start).toHaveBeenCalledOnce();
-        expect(stop).toHaveBeenCalledOnce();
-        expect(log).toHaveBeenCalledWith("✓ AgentRoam service started");
-        expect(log).toHaveBeenCalledWith("✓ AgentRoam service stopped");
-    });
-    it("rejects service management outside supported platforms", async () => {
-        await expect(runServiceCommand(options("status"), {
-            platform: "linux",
-            nodePath: "/node",
-            cliPath: "/agentroam.mjs",
-            version: "test",
-        })).rejects.toThrow("supported platforms are macOS and Windows");
-    });
-});
-function controller(overrides) {
-    return {
-        install: vi.fn(),
-        start: vi.fn(),
-        stop: vi.fn(),
-        status: vi.fn(),
-        url: vi.fn(),
-        logs: vi.fn(),
-        restart: vi.fn(),
-        uninstall: vi.fn(),
-        ...overrides,
-    };
-}
-function options(serviceAction) {
-    return {
-        command: "service",
-        serviceAction,
-        unlockServiceAction: null,
-        roots: [resolve("workspace")],
-        port: null,
-        relay: "auto",
-        tunnelCommand: null,
-        localOnly: false,
-        qr: false,
-        dataDir: resolve("data"),
-    };
-}
-it.each(['install', 'start', 'restart', 'status'])('prints the actual Windows local address for %s before tunnel readiness', async (action) => {
-    const state = { status: 'starting', localUrl: 'http://127.0.0.1:49157', pid: 123 };
-    const log = vi.fn();
-    const control = controller({
-        install: vi.fn(async () => ({ state, definition: 'task' })), start: vi.fn(async () => state), restart: vi.fn(async () => state),
-        status: vi.fn(async () => ({ installed: true, running: true, state, config: null })),
-    });
-    await runServiceCommand(options(action), { platform: 'win32', arch: 'x64', nodePath: 'C:\\node.exe', cliPath: 'C:\\agentroam.mjs', version: 'test', nodeVersion: '22.22.0', controller: control, log,
-        codexResolver: vi.fn(async () => ({ executable: 'C:\\codex.exe', version: 'test', source: 'global' })) });
-    expect(log).toHaveBeenCalledWith('远程桌面授权地址：http://127.0.0.1:49157/web');
-    expect(log).toHaveBeenCalledWith(expect.stringContaining('保持 Windows 已登录'));
-    expect(log.mock.calls.some(([line]) => line.includes('屏幕录制') || line.includes('辅助功能'))).toBe(false);
-});