@messenger-agent/client 0.24.0-alpha.2 → 0.24.0-alpha.4

package/dist/args.js

@@ -1,303 +1,5 @@
-import cac from "cac";
-import { defaultConfigPath, defaultDataDir, resolvePath } from "./paths.js";
-import { normalizeReleaseChannel } from "./runtime.js";
-const serverUrlEnvName = "CODING_AGENT_TUNNEL_SERVER_URL";
-const publicCommands = [
-    "install",
-    "upgrade",
-    "sessions",
-    "maintenance",
-    "status",
-    "start",
-    "restart",
-    "stop",
-    "uninstall",
-];
-const allCommands = [...publicCommands, "run-service"];
-export class UsageError extends Error {
-}
-export function parseCliArgs(argv, env = process.env) {
-    if (argv[0] === "--version" || argv[0] === "-v") {
-        if (argv.length > 1)
-            throw new UsageError(`Unknown option for version: ${argv[1]}`);
-        return { command: "version" };
-    }
-    const command = argv[0];
-    if (!command || command === "--help" || command === "-h") {
-        throw new UsageError(usage());
-    }
-    if (argv.includes("--")) {
-        throw new UsageError(`Unknown option for ${command}: --`);
-    }
-    assertKnownOptions(argv);
-    let parsedArgs;
-    const cli = createCli({
-        env,
-        includeInternalCommands: true,
-        onParsed(args) {
-            parsedArgs = args;
-        },
-    });
-    try {
-        cli.parse(["node", "coding-agent", ...argv]);
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new UsageError(normalizeCacError(message, argv));
-    }
-    if (!parsedArgs) {
-        throw new UsageError(`Unknown command: ${command}`);
-    }
-    return parsedArgs;
-}
-export function usage() {
-    const cli = createCli({ includeInternalCommands: false });
-    cli.help();
-    return `${captureConsoleInfo(() => cli.outputHelp())}\n\nGlobal Options:\n  -v, --version  Show the installed client version`;
-}
-function createCli(options) {
-    const cli = cac("coding-agent");
-    const env = options.env ?? process.env;
-    const onParsed = options.onParsed ?? (() => undefined);
-    cli
-        .command("install", "Install and configure the local coding-agent service")
-        .option("--tunnel-id <id>", "Tunnel id")
-        .option("--token <token>", "Tunnel token")
-        .option("--workspace <path>", "Workspace path (default: ~/messenger-workspace)")
-        .option("--server-url <wss-url>", "Tunnel server URL")
-        .option("--config <path>", "Config file path", { default: defaultConfigPath })
-        .option("--data-dir <path>", "Data directory", { default: defaultDataDir })
-        .option("--workspace-id <id>", "Workspace id")
-        .option("--workspace-name <name>", "Workspace display name")
-        .option("--channel <channel>", "Auto-upgrade release channel: latest, beta, or alpha")
-        .action((commandOptions) => {
-        const tunnelId = optionalString(commandOptions.tunnelId);
-        const token = optionalString(commandOptions.token);
-        const workspace = optionalString(commandOptions.workspace);
-        onParsed({
-            command: "install",
-            tunnelId,
-            token,
-            workspace: workspace ? resolvePath(workspace) : undefined,
-            serverUrl: optionalString(commandOptions.serverUrl) ?? env[serverUrlEnvName],
-            configPath: resolvePath(requiredString(commandOptions.config, "--config")),
-            dataDir: resolvePath(requiredString(commandOptions.dataDir, "--data-dir")),
-            workspaceId: optionalString(commandOptions.workspaceId),
-            workspaceName: optionalString(commandOptions.workspaceName),
-            channel: parseChannelOption(commandOptions.channel),
-        });
-    });
-    cli
-        .command("upgrade", "Upgrade the local coding-agent runtime")
-        .option("--version <version>", "Runtime version or release channel", { default: "latest" })
-        .option("--channel <channel>", "Auto-upgrade release channel: latest, beta, or alpha")
-        .option("--config <path>", "Config file path", { default: defaultConfigPath })
-        .option("--delay <seconds>", "Schedule the upgrade after a delay")
-        .option("--allow-waiting", "Allow upgrade while sessions wait for user input")
-        .action((commandOptions) => {
-        const delaySeconds = optionalDelay(commandOptions.delay);
-        const allowWaiting = commandOptions.allowWaiting === true;
-        assertAllowWaitingHasDelay(allowWaiting, delaySeconds);
-        onParsed({
-            command: "upgrade",
-            version: requiredString(commandOptions.version, "--version"),
-            configPath: resolvePath(requiredString(commandOptions.config, "--config")),
-            delaySeconds,
-            allowWaiting,
-            channel: parseChannelOption(commandOptions.channel),
-        });
-    });
-    cli
-        .command("sessions", "Show active and waiting client sessions")
-        .option("--json", "Print machine-readable JSON")
-        .option("--config <path>", "Config file path", { default: defaultConfigPath })
-        .action((commandOptions) => {
-        onParsed({
-            command: "sessions",
-            json: commandOptions.json === true,
-            configPath: resolvePath(requiredString(commandOptions.config, "--config")),
-        });
-    });
-    cli
-        .command("maintenance <action>", "Inspect or cancel scheduled maintenance")
-        .option("--json", "Print machine-readable JSON")
-        .option("--config <path>", "Config file path", { default: defaultConfigPath })
-        .action((action, commandOptions) => {
-        if (action !== "status" && action !== "cancel") {
-            throw new UsageError(`Unknown maintenance action: ${action}`);
-        }
-        onParsed({
-            command: "maintenance",
-            action,
-            json: commandOptions.json === true,
-            configPath: resolvePath(requiredString(commandOptions.config, "--config")),
-        });
-    });
-    for (const command of ["status", "start"]) {
-        cli.command(command, `${capitalize(command)} the local coding-agent service`).action(() => {
-            onParsed({ command });
-        });
-    }
-    cli
-        .command("restart [agent]", "Restart the local service or a specific agent")
-        .option("--delay <seconds>", "Schedule the restart after a delay")
-        .option("--allow-waiting", "Allow restart while sessions wait for user input")
-        .action((agent, commandOptions) => {
-        if (agent !== undefined && agent !== "codex" && agent !== "claude") {
-            throw new UsageError(`Unknown agent for restart: ${agent}`);
-        }
-        const delaySeconds = optionalDelay(commandOptions.delay);
-        const allowWaiting = commandOptions.allowWaiting === true;
-        assertAllowWaitingHasDelay(allowWaiting, delaySeconds);
-        onParsed({ command: "restart", agent, delaySeconds, allowWaiting });
-    });
-    for (const command of ["stop", "uninstall"]) {
-        cli
-            .command(command, `${capitalize(command)} the local coding-agent service`)
-            .option("--delay <seconds>", `Schedule the ${command} after a delay`)
-            .option("--allow-waiting", `Allow ${command} while sessions wait for user input`)
-            .action((commandOptions) => {
-            const delaySeconds = optionalDelay(commandOptions.delay);
-            const allowWaiting = commandOptions.allowWaiting === true;
-            assertAllowWaitingHasDelay(allowWaiting, delaySeconds);
-            onParsed({ command, delaySeconds, allowWaiting });
-        });
-    }
-    if (options.includeInternalCommands) {
-        cli
-            .command("run-service", "Run the managed service supervisor")
-            .option("--config <path>", "Config file path")
-            .action((commandOptions) => {
-            const configPath = optionalString(commandOptions.config);
-            onParsed({ command: "run-service", configPath: configPath ? resolvePath(configPath) : undefined });
-        });
-    }
-    return cli;
-}
-function requiredString(value, name) {
-    const text = optionalString(value);
-    if (!text)
-        throw new UsageError(`Missing value for ${name}`);
-    return text;
-}
-function optionalString(value) {
-    return typeof value === "string" ? value : undefined;
-}
-function parseChannelOption(value) {
-    const text = optionalString(value);
-    if (text === undefined)
-        return undefined;
-    try {
-        return normalizeReleaseChannel(text);
-    }
-    catch {
-        throw new UsageError(`Unknown release channel for --channel: ${text} (expected latest, beta, or alpha)`);
-    }
-}
-function optionalDelay(value) {
-    if (value === undefined)
-        return undefined;
-    const text = typeof value === "number" ? String(value) : requiredString(value, "--delay");
-    if (!/^\d+$/.test(text))
-        throw new UsageError("--delay must be an integer between 1 and 86400 seconds");
-    const delay = Number.parseInt(text, 10);
-    if (delay < 1 || delay > 86_400) {
-        throw new UsageError("--delay must be an integer between 1 and 86400 seconds");
-    }
-    return delay;
-}
-function assertAllowWaitingHasDelay(allowWaiting, delaySeconds) {
-    if (allowWaiting && delaySeconds === undefined) {
-        throw new UsageError("--allow-waiting requires --delay");
-    }
-}
-function normalizeCacError(message, argv) {
-    if (message.startsWith("Unknown option `")) {
-        const rawOption = findFirstUnknownOption(argv);
-        if (rawOption)
-            return `Unknown option for ${argv[0]}: ${rawOption}`;
-    }
-    if (message.startsWith("option `")) {
-        const match = /^option `([^` ]+)/.exec(message);
-        if (match)
-            return `Missing value for ${match[1]}`;
-    }
-    if (message.startsWith("Unused args:")) {
-        const firstUnusedArg = argv.slice(1).find((arg) => !arg.startsWith("-"));
-        if (firstUnusedArg)
-            return `Unknown option for ${argv[0]}: ${firstUnusedArg}`;
-    }
-    return message;
-}
-function findFirstUnknownOption(argv) {
-    const command = argv[0];
-    if (!command || !isKnownCommand(command))
-        return argv.find((arg) => arg.startsWith("-"));
-    const knownOptions = knownOptionsForCommand(command);
-    for (const arg of argv.slice(1)) {
-        if (!arg.startsWith("-"))
-            continue;
-        const optionName = arg.includes("=") ? arg.slice(0, arg.indexOf("=")) : arg;
-        if (!knownOptions.has(optionName))
-            return optionName;
-    }
-    return undefined;
-}
-function assertKnownOptions(argv) {
-    const command = argv[0];
-    if (!command || !isKnownCommand(command))
-        return;
-    const unknownOption = findFirstUnknownOption(argv);
-    if (unknownOption) {
-        throw new UsageError(`Unknown option for ${command}: ${unknownOption}`);
-    }
-}
-function knownOptionsForCommand(command) {
-    switch (command) {
-        case "install":
-            return new Set([
-                "--tunnel-id",
-                "--token",
-                "--workspace",
-                "--server-url",
-                "--config",
-                "--data-dir",
-                "--workspace-id",
-                "--workspace-name",
-                "--channel",
-            ]);
-        case "upgrade":
-            return new Set(["--version", "--channel", "--config", "--delay", "--allow-waiting"]);
-        case "sessions":
-        case "maintenance":
-            return new Set(["--json", "--config"]);
-        case "restart":
-        case "stop":
-        case "uninstall":
-            return new Set(["--delay", "--allow-waiting"]);
-        case "run-service":
-            return new Set(["--config"]);
-        default:
-            return new Set();
-    }
-}
-function isKnownCommand(command) {
-    return allCommands.includes(command);
-}
-function captureConsoleInfo(callback) {
-    const originalInfo = console.info;
-    const output = [];
-    console.info = (...args) => {
-        output.push(args.map(String).join(" "));
-    };
-    try {
-        callback();
-    }
-    finally {
-        console.info = originalInfo;
-    }
-    return output.join("\n");
-}
-function capitalize(value) {
-    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;
-}
+import S from"cac";import{defaultConfigPath as u,defaultDataDir as U,resolvePath as d}from"./paths.js";import{normalizeReleaseChannel as $}from"./runtime.js";const C="CODING_AGENT_TUNNEL_SERVER_URL",v=["install","upgrade","sessions","maintenance","status","start","restart","stop","uninstall"],W=[...v,"run-service"];class r extends Error{}function D(n,t=process.env){if(n[0]==="--version"||n[0]==="-v"){if(n.length>1)throw new r(`Unknown option for version: ${n[1]}`);return{command:"version"}}const o=n[0];if(!o||o==="--help"||o==="-h")throw new r(b());if(n.includes("--"))throw new r(`Unknown option for ${o}: --`);P(n);let i;const e=h({env:t,includeInternalCommands:!0,onParsed(a){i=a}});try{e.parse(["node","coding-agent",...n])}catch(a){const s=a instanceof Error?a.message:String(a);throw new r(I(s,n))}if(!i)throw new r(`Unknown command: ${o}`);return i}function b(){const n=h({includeInternalCommands:!1});return n.help(),`${A(()=>n.outputHelp())}
+
+Global Options:
+  -v, --version  Show the installed client version`}function h(n){const t=S("coding-agent"),o=n.env??process.env,i=n.onParsed??(()=>{});t.command("install","Install and configure the local coding-agent service").option("--tunnel-id <id>","Tunnel id").option("--token <token>","Tunnel token").option("--workspace <path>","Workspace path (default: ~/messenger-workspace)").option("--server-url <wss-url>","Tunnel server URL").option("--config <path>","Config file path",{default:u}).option("--data-dir <path>","Data directory",{default:U}).option("--workspace-id <id>","Workspace id").option("--workspace-name <name>","Workspace display name").option("--channel <channel>","Auto-upgrade release channel: latest, beta, or alpha").action(e=>{const a=c(e.tunnelId),s=c(e.token),l=c(e.workspace);i({command:"install",tunnelId:a,token:s,workspace:l?d(l):void 0,serverUrl:c(e.serverUrl)??o[C],configPath:d(f(e.config,"--config")),dataDir:d(f(e.dataDir,"--data-dir")),workspaceId:c(e.workspaceId),workspaceName:c(e.workspaceName),channel:g(e.channel)})}),t.command("upgrade","Upgrade the local coding-agent runtime").option("--version <version>","Runtime version or release channel",{default:"latest"}).option("--channel <channel>","Auto-upgrade release channel: latest, beta, or alpha").option("--config <path>","Config file path",{default:u}).option("--delay <seconds>","Schedule the upgrade after a delay").option("--allow-waiting","Allow upgrade while sessions wait for user input").action(e=>{const a=p(e.delay),s=e.allowWaiting===!0;w(s,a),i({command:"upgrade",version:f(e.version,"--version"),configPath:d(f(e.config,"--config")),delaySeconds:a,allowWaiting:s,channel:g(e.channel)})}),t.command("sessions","Show active and waiting client sessions").option("--json","Print machine-readable JSON").option("--config <path>","Config file path",{default:u}).action(e=>{i({command:"sessions",json:e.json===!0,configPath:d(f(e.config,"--config"))})}),t.command("maintenance <action>","Inspect or cancel scheduled maintenance").option("--json","Print machine-readable JSON").option("--config <path>","Config file path",{default:u}).action((e,a)=>{if(e!=="status"&&e!=="cancel")throw new r(`Unknown maintenance action: ${e}`);i({command:"maintenance",action:e,json:a.json===!0,configPath:d(f(a.config,"--config"))})});for(const e of["status","start"])t.command(e,`${y(e)} the local coding-agent service`).action(()=>{i({command:e})});t.command("restart [agent]","Restart the local service or a specific agent").option("--delay <seconds>","Schedule the restart after a delay").option("--allow-waiting","Allow restart while sessions wait for user input").action((e,a)=>{if(e!==void 0&&e!=="codex"&&e!=="claude")throw new r(`Unknown agent for restart: ${e}`);const s=p(a.delay),l=a.allowWaiting===!0;w(l,s),i({command:"restart",agent:e,delaySeconds:s,allowWaiting:l})});for(const e of["stop","uninstall"])t.command(e,`${y(e)} the local coding-agent service`).option("--delay <seconds>",`Schedule the ${e} after a delay`).option("--allow-waiting",`Allow ${e} while sessions wait for user input`).action(a=>{const s=p(a.delay),l=a.allowWaiting===!0;w(l,s),i({command:e,delaySeconds:s,allowWaiting:l})});return n.includeInternalCommands&&t.command("run-service","Run the managed service supervisor").option("--config <path>","Config file path").action(e=>{const a=c(e.config);i({command:"run-service",configPath:a?d(a):void 0})}),t}function f(n,t){const o=c(n);if(!o)throw new r(`Missing value for ${t}`);return o}function c(n){return typeof n=="string"?n:void 0}function g(n){const t=c(n);if(t!==void 0)try{return $(t)}catch{throw new r(`Unknown release channel for --channel: ${t} (expected latest, beta, or alpha)`)}}function p(n){if(n===void 0)return;const t=typeof n=="number"?String(n):f(n,"--delay");if(!/^\d+$/.test(t))throw new r("--delay must be an integer between 1 and 86400 seconds");const o=Number.parseInt(t,10);if(o<1||o>86400)throw new r("--delay must be an integer between 1 and 86400 seconds");return o}function w(n,t){if(n&&t===void 0)throw new r("--allow-waiting requires --delay")}function I(n,t){if(n.startsWith("Unknown option `")){const o=m(t);if(o)return`Unknown option for ${t[0]}: ${o}`}if(n.startsWith("option `")){const o=/^option `([^` ]+)/.exec(n);if(o)return`Missing value for ${o[1]}`}if(n.startsWith("Unused args:")){const o=t.slice(1).find(i=>!i.startsWith("-"));if(o)return`Unknown option for ${t[0]}: ${o}`}return n}function m(n){const t=n[0];if(!t||!k(t))return n.find(i=>i.startsWith("-"));const o=x(t);for(const i of n.slice(1)){if(!i.startsWith("-"))continue;const e=i.includes("=")?i.slice(0,i.indexOf("=")):i;if(!o.has(e))return e}}function P(n){const t=n[0];if(!t||!k(t))return;const o=m(n);if(o)throw new r(`Unknown option for ${t}: ${o}`)}function x(n){switch(n){case"install":return new Set(["--tunnel-id","--token","--workspace","--server-url","--config","--data-dir","--workspace-id","--workspace-name","--channel"]);case"upgrade":return new Set(["--version","--channel","--config","--delay","--allow-waiting"]);case"sessions":case"maintenance":return new Set(["--json","--config"]);case"restart":case"stop":case"uninstall":return new Set(["--delay","--allow-waiting"]);case"run-service":return new Set(["--config"]);default:return new Set}}function k(n){return W.includes(n)}function A(n){const t=console.info,o=[];console.info=(...i)=>{o.push(i.map(String).join(" "))};try{n()}finally{console.info=t}return o.join(`
+`)}function y(n){return`${n.charAt(0).toUpperCase()}${n.slice(1)}`}export{r as UsageError,D as parseCliArgs,b as usage};

package/dist/auto-upgrade.js

@@ -1,184 +1,2 @@
-import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
-import { dirname } from "node:path";
-import { compareSemverVersions, currentPackageVersion, isPrereleaseVersion, resolveChannelPackageVersion, } from "./runtime.js";
-const activeMaintenanceStatuses = new Set(["scheduled", "waiting", "running", "restarting", "stopping"]);
-export class AutoUpgradeScheduler {
-    options;
-    state;
-    timer;
-    checkIntervalMs;
-    pendingRetryMs;
-    now;
-    getCurrentVersion;
-    getLatestVersion;
-    getChannel;
-    constructor(options) {
-        this.options = options;
-        this.checkIntervalMs = options.checkIntervalMs ?? 2 * 60 * 60 * 1000;
-        this.pendingRetryMs = options.pendingRetryMs ?? 30_000;
-        this.now = options.now ?? Date.now;
-        this.getCurrentVersion = options.getCurrentVersion ?? currentPackageVersion;
-        this.getLatestVersion = options.getLatestVersion ?? resolveChannelPackageVersion;
-        this.getChannel = options.getChannel ?? (() => Promise.resolve("latest"));
-    }
-    async start() {
-        this.state = await this.readState();
-        if (this.state?.status === "pending" || this.state?.status === "scheduled") {
-            this.arm(this.pendingRetryMs);
-            return;
-        }
-        const lastCheckedAt = this.state?.lastCheckedAt ? Date.parse(this.state.lastCheckedAt) : undefined;
-        const untilNextCheck = lastCheckedAt === undefined ? this.checkIntervalMs : this.checkIntervalMs - (this.now() - lastCheckedAt);
-        this.arm(Math.max(0, untilNextCheck));
-    }
-    stop() {
-        if (this.timer)
-            clearTimeout(this.timer);
-        this.timer = undefined;
-    }
-    getState() {
-        return this.state ? structuredClone(this.state) : undefined;
-    }
-    async checkNow() {
-        if (this.timer)
-            clearTimeout(this.timer);
-        this.timer = undefined;
-        await this.tick();
-    }
-    arm(delayMs) {
-        if (this.timer)
-            clearTimeout(this.timer);
-        this.timer = setTimeout(() => void this.tick(), delayMs);
-        this.timer.unref();
-    }
-    async tick() {
-        this.timer = undefined;
-        try {
-            const channel = await this.getChannel();
-            const currentVersion = await this.getCurrentVersion();
-            let latestVersion = this.state?.status === "pending" || this.state?.status === "scheduled" ? this.state.latestVersion : undefined;
-            let lastCheckedAt = this.state?.lastCheckedAt;
-            if (!latestVersion) {
-                latestVersion = await this.getLatestVersion(channel);
-                lastCheckedAt = this.isoNow();
-            }
-            if (compareSemverVersions(latestVersion, currentVersion) <= 0) {
-                await this.updateState({
-                    status: "up-to-date",
-                    currentVersion,
-                    channel,
-                    latestVersion,
-                    lastCheckedAt,
-                    message: `Runtime ${currentVersion} is up to date on the ${channel} channel`,
-                });
-                this.arm(this.checkIntervalMs);
-                return;
-            }
-            if (channel === "latest" && isPrereleaseVersion(currentVersion) && !isPrereleaseVersion(latestVersion)) {
-                await this.updateState({
-                    status: "up-to-date",
-                    currentVersion,
-                    channel,
-                    latestVersion,
-                    lastCheckedAt,
-                    message: `Runtime ${currentVersion} is a pre-release ahead of the latest stable ${latestVersion}`,
-                });
-                this.arm(this.checkIntervalMs);
-                return;
-            }
-            const task = this.options.maintenance.getTask();
-            if (isMatchingAutomaticUpgrade(task, latestVersion)) {
-                await this.updateState({
-                    status: "scheduled",
-                    currentVersion,
-                    channel,
-                    latestVersion,
-                    lastCheckedAt,
-                    message: `Waiting to upgrade to ${latestVersion}`,
-                });
-                this.arm(this.pendingRetryMs);
-                return;
-            }
-            if (task && activeMaintenanceStatuses.has(task.status)) {
-                await this.updateState({
-                    status: "pending",
-                    currentVersion,
-                    channel,
-                    latestVersion,
-                    lastCheckedAt,
-                    message: `Waiting for maintenance task ${task.id}`,
-                });
-                this.arm(this.pendingRetryMs);
-                return;
-            }
-            if (task?.source === "automatic" && (task.status === "failed" || task.status === "cancelled")) {
-                await this.updateState({
-                    status: "failed",
-                    currentVersion,
-                    channel,
-                    latestVersion,
-                    lastCheckedAt,
-                    message: task.message ??
-                        (task.status === "cancelled"
-                            ? `Automatic upgrade to ${latestVersion} was cancelled`
-                            : `Automatic upgrade to ${latestVersion} failed`),
-                });
-                this.arm(this.checkIntervalMs);
-                return;
-            }
-            await this.options.maintenance.schedule({
-                operation: { type: "upgrade", version: latestVersion },
-                delaySeconds: 1,
-                allowWaiting: true,
-                source: "automatic",
-            });
-            await this.updateState({
-                status: "scheduled",
-                currentVersion,
-                channel,
-                latestVersion,
-                lastCheckedAt,
-                message: `Waiting to upgrade to ${latestVersion}`,
-            });
-            this.arm(this.pendingRetryMs);
-        }
-        catch (err) {
-            const currentVersion = await this.getCurrentVersion().catch(() => "unknown");
-            await this.updateState({
-                status: "failed",
-                currentVersion,
-                channel: this.state?.channel ?? "latest",
-                latestVersion: this.state?.latestVersion,
-                lastCheckedAt: this.isoNow(),
-                message: err instanceof Error ? err.message : String(err),
-            });
-            this.arm(this.checkIntervalMs);
-        }
-    }
-    async updateState(state) {
-        this.state = { ...state, updatedAt: this.isoNow() };
-        await mkdir(dirname(this.options.statePath), { recursive: true, mode: 0o700 });
-        const temporaryPath = `${this.options.statePath}.tmp`;
-        await writeFile(temporaryPath, `${JSON.stringify(this.state, null, 2)}\n`, { mode: 0o600 });
-        await rename(temporaryPath, this.options.statePath);
-    }
-    async readState() {
-        try {
-            return JSON.parse(await readFile(this.options.statePath, "utf8"));
-        }
-        catch (err) {
-            if (err.code === "ENOENT")
-                return undefined;
-            throw err;
-        }
-    }
-    isoNow() {
-        return new Date(this.now()).toISOString();
-    }
-}
-function isMatchingAutomaticUpgrade(task, version) {
-    return (task?.source === "automatic" &&
-        activeMaintenanceStatuses.has(task.status) &&
-        task.operation.type === "upgrade" &&
-        task.operation.version === version);
-}
+import{mkdir as o,readFile as c,rename as u,writeFile as d}from"node:fs/promises";import{dirname as l}from"node:path";import{compareSemverVersions as m,currentPackageVersion as g,isPrereleaseVersion as r,resolveChannelPackageVersion as p}from"./runtime.js";const h=new Set(["scheduled","waiting","running","restarting","stopping"]);class y{options;state;timer;checkIntervalMs;pendingRetryMs;now;getCurrentVersion;getLatestVersion;getChannel;constructor(t){this.options=t,this.checkIntervalMs=t.checkIntervalMs??7200*1e3,this.pendingRetryMs=t.pendingRetryMs??3e4,this.now=t.now??Date.now,this.getCurrentVersion=t.getCurrentVersion??g,this.getLatestVersion=t.getLatestVersion??p,this.getChannel=t.getChannel??(()=>Promise.resolve("latest"))}async start(){if(this.state=await this.readState(),this.state?.status==="pending"||this.state?.status==="scheduled"){this.arm(this.pendingRetryMs);return}const t=this.state?.lastCheckedAt?Date.parse(this.state.lastCheckedAt):void 0,e=t===void 0?this.checkIntervalMs:this.checkIntervalMs-(this.now()-t);this.arm(Math.max(0,e))}stop(){this.timer&&clearTimeout(this.timer),this.timer=void 0}getState(){return this.state?structuredClone(this.state):void 0}async checkNow(){this.timer&&clearTimeout(this.timer),this.timer=void 0,await this.tick()}arm(t){this.timer&&clearTimeout(this.timer),this.timer=setTimeout(()=>{this.tick()},t),this.timer.unref()}async tick(){this.timer=void 0;try{const t=await this.getChannel(),e=await this.getCurrentVersion();let s=this.state?.status==="pending"||this.state?.status==="scheduled"?this.state.latestVersion:void 0,i=this.state?.lastCheckedAt;if(s||(s=await this.getLatestVersion(t),i=this.isoNow()),m(s,e)<=0){await this.updateState({status:"up-to-date",currentVersion:e,channel:t,latestVersion:s,lastCheckedAt:i,message:`Runtime ${e} is up to date on the ${t} channel`}),this.arm(this.checkIntervalMs);return}if(t==="latest"&&r(e)&&!r(s)){await this.updateState({status:"up-to-date",currentVersion:e,channel:t,latestVersion:s,lastCheckedAt:i,message:`Runtime ${e} is a pre-release ahead of the latest stable ${s}`}),this.arm(this.checkIntervalMs);return}const a=this.options.maintenance.getTask();if(w(a,s)){await this.updateState({status:"scheduled",currentVersion:e,channel:t,latestVersion:s,lastCheckedAt:i,message:`Waiting to upgrade to ${s}`}),this.arm(this.pendingRetryMs);return}if(a&&h.has(a.status)){await this.updateState({status:"pending",currentVersion:e,channel:t,latestVersion:s,lastCheckedAt:i,message:`Waiting for maintenance task ${a.id}`}),this.arm(this.pendingRetryMs);return}if(a?.source==="automatic"&&(a.status==="failed"||a.status==="cancelled")){await this.updateState({status:"failed",currentVersion:e,channel:t,latestVersion:s,lastCheckedAt:i,message:a.message??(a.status==="cancelled"?`Automatic upgrade to ${s} was cancelled`:`Automatic upgrade to ${s} failed`)}),this.arm(this.checkIntervalMs);return}await this.options.maintenance.schedule({operation:{type:"upgrade",version:s},delaySeconds:1,allowWaiting:!0,source:"automatic"}),await this.updateState({status:"scheduled",currentVersion:e,channel:t,latestVersion:s,lastCheckedAt:i,message:`Waiting to upgrade to ${s}`}),this.arm(this.pendingRetryMs)}catch(t){const e=await this.getCurrentVersion().catch(()=>"unknown");await this.updateState({status:"failed",currentVersion:e,channel:this.state?.channel??"latest",latestVersion:this.state?.latestVersion,lastCheckedAt:this.isoNow(),message:t instanceof Error?t.message:String(t)}),this.arm(this.checkIntervalMs)}}async updateState(t){this.state={...t,updatedAt:this.isoNow()},await o(l(this.options.statePath),{recursive:!0,mode:448});const e=`${this.options.statePath}.tmp`;await d(e,`${JSON.stringify(this.state,null,2)}
+`,{mode:384}),await u(e,this.options.statePath)}async readState(){try{return JSON.parse(await c(this.options.statePath,"utf8"))}catch(t){if(t.code==="ENOENT")return;throw t}}isoNow(){return new Date(this.now()).toISOString()}}function w(n,t){return n?.source==="automatic"&&h.has(n.status)&&n.operation.type==="upgrade"&&n.operation.version===t}export{y as AutoUpgradeScheduler};

package/dist/config-file.js

@@ -1,100 +1 @@
-import { constants } from "node:fs";
-import { access, chmod, mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { parse, stringify } from "yaml";
-import { normalizeReleaseChannel } from "./runtime.js";
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function objectAt(config, key) {
-    const existing = config[key];
-    if (isRecord(existing))
-        return existing;
-    const next = {};
-    config[key] = next;
-    return next;
-}
-export async function ensureClientDirectories(dataDir, configPath) {
-    await mkdir(dirname(configPath), { recursive: true, mode: 0o700 });
-    await chmod(dirname(configPath), 0o700);
-    await mkdir(dataDir, { recursive: true, mode: 0o700 });
-    await mkdir(join(dataDir, "logs"), { recursive: true, mode: 0o700 });
-    await mkdir(join(dataDir, "uploads"), { recursive: true, mode: 0o700 });
-    await mkdir(join(dataDir, "runtime"), { recursive: true, mode: 0o700 });
-}
-async function fileExists(path) {
-    try {
-        await access(path, constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function readConfigYaml(configPath) {
-    if (!(await fileExists(configPath)))
-        return {};
-    const parsed = parse(await readFile(configPath, "utf8"));
-    if (parsed === null || parsed === undefined)
-        return {};
-    if (!isRecord(parsed)) {
-        throw new Error(`Config file must contain a YAML object: ${configPath}`);
-    }
-    return parsed;
-}
-export function mergeClientConfig(existing, options) {
-    const config = { ...existing };
-    config.log_level ??= "info";
-    if (!options.preserveWorkspaces) {
-        config.workspaces = [
-            {
-                id: options.workspaceId,
-                name: options.workspaceName ?? `${options.tunnelId} Default`,
-                path: options.workspacePath,
-            },
-        ];
-    }
-    config.data_dir = options.dataDir;
-    const fileUploads = objectAt(config, "file_uploads");
-    fileUploads.temp_dir = join(options.dataDir, "uploads");
-    const tunnel = objectAt(config, "tunnel");
-    tunnel.enabled = true;
-    if (options.serverUrl)
-        tunnel.server_url = options.serverUrl;
-    tunnel.tunnel_id = options.tunnelId;
-    tunnel.token = options.token;
-    return config;
-}
-export async function readUpgradeChannel(configPath) {
-    const config = await readConfigYaml(configPath);
-    const autoUpgrade = config.auto_upgrade;
-    const value = isRecord(autoUpgrade) ? autoUpgrade.channel : undefined;
-    return normalizeReleaseChannel(value) ?? "latest";
-}
-export async function writeUpgradeChannel(configPath, channel) {
-    const config = await readConfigYaml(configPath);
-    const autoUpgrade = objectAt(config, "auto_upgrade");
-    autoUpgrade.channel = channel;
-    await writeConfigYaml(configPath, config);
-}
-export async function writeConfigYaml(configPath, config) {
-    await mkdir(dirname(configPath), { recursive: true, mode: 0o700 });
-    const tempPath = `${configPath}.${process.pid}.${Date.now()}.tmp`;
-    await writeFile(tempPath, stringify(config), { mode: 0o600 });
-    await chmod(tempPath, 0o600);
-    await rename(tempPath, configPath);
-    await chmod(configPath, 0o600);
-}
-export async function updateClientConfig(options) {
-    await ensureClientDirectories(options.dataDir, options.configPath);
-    const existing = await readConfigYaml(options.configPath);
-    const next = mergeClientConfig(existing, options);
-    await writeConfigYaml(options.configPath, next);
-    return next;
-}
-export async function assertPrivateConfig(configPath) {
-    const mode = (await stat(configPath)).mode & 0o777;
-    if ((mode & 0o077) !== 0) {
-        throw new Error(`Config file permissions are too broad: ${configPath}`);
-    }
-}
+import{constants as m}from"node:fs";import{access as w,chmod as u,mkdir as n,readFile as p,rename as g,stat as x,writeFile as C}from"node:fs/promises";import{dirname as c,join as o}from"node:path";import{parse as y,stringify as v}from"yaml";import{normalizeReleaseChannel as _}from"./runtime.js";function s(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function d(e,r){const t=e[r];if(s(t))return t;const a={};return e[r]=a,a}async function h(e,r){await n(c(r),{recursive:!0,mode:448}),await u(c(r),448),await n(e,{recursive:!0,mode:448}),await n(o(e,"logs"),{recursive:!0,mode:448}),await n(o(e,"uploads"),{recursive:!0,mode:448}),await n(o(e,"runtime"),{recursive:!0,mode:448})}async function k(e){try{return await w(e,m.F_OK),!0}catch{return!1}}async function l(e){if(!await k(e))return{};const r=y(await p(e,"utf8"));if(r==null)return{};if(!s(r))throw new Error(`Config file must contain a YAML object: ${e}`);return r}function U(e,r){const t={...e};t.log_level??="info",r.preserveWorkspaces||(t.workspaces=[{id:r.workspaceId,name:r.workspaceName??`${r.tunnelId} Default`,path:r.workspacePath}]),t.data_dir=r.dataDir;const a=d(t,"file_uploads");a.temp_dir=o(r.dataDir,"uploads");const i=d(t,"tunnel");return i.enabled=!0,r.serverUrl&&(i.server_url=r.serverUrl),i.tunnel_id=r.tunnelId,i.token=r.token,t}async function E(e){const t=(await l(e)).auto_upgrade,a=s(t)?t.channel:void 0;return _(a)??"latest"}async function F(e,r){const t=await l(e),a=d(t,"auto_upgrade");a.channel=r,await f(e,t)}async function f(e,r){await n(c(e),{recursive:!0,mode:448});const t=`${e}.${process.pid}.${Date.now()}.tmp`;await C(t,v(r),{mode:384}),await u(t,384),await g(t,e),await u(e,384)}async function I(e){await h(e.dataDir,e.configPath);const r=await l(e.configPath),t=U(r,e);return await f(e.configPath,t),t}async function Y(e){if(((await x(e)).mode&511&63)!==0)throw new Error(`Config file permissions are too broad: ${e}`)}export{Y as assertPrivateConfig,h as ensureClientDirectories,U as mergeClientConfig,l as readConfigYaml,E as readUpgradeChannel,I as updateClientConfig,f as writeConfigYaml,F as writeUpgradeChannel};