@evalops/maestro 0.10.46 → 0.10.48

package/dist/update/startup-refresh.js

@@ -0,0 +1,321 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync, } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { parseArgs } from "../cli/args.js";
+import { getAgentDir } from "../config/constants.js";
+import { getGlobalInstallCommand, getPackageName, } from "../package-metadata.js";
+import { withTimeout } from "../utils/async.js";
+import { checkForUpdate, resolveUpdateUrls, } from "./check.js";
+const SKIP_ENV = "MAESTRO_SKIP_STARTUP_UPDATE";
+const STARTUP_UPDATE_ENV = "MAESTRO_STARTUP_UPDATE";
+const STARTUP_UPDATE_STATE_ENV = "MAESTRO_STARTUP_UPDATE_STATE";
+const STARTUP_UPDATE_TIMEOUT_ENV = "MAESTRO_STARTUP_UPDATE_TIMEOUT_MS";
+const STARTUP_UPDATE_TTL_ENV = "MAESTRO_STARTUP_UPDATE_RETRY_MS";
+const DEFAULT_INSTALL_TIMEOUT_MS = 60_000;
+const DEFAULT_RETRY_MS = 24 * 60 * 60 * 1_000;
+const DEFAULT_STARTUP_UPDATE_TIMEOUT_MS = 1_500;
+const NPM_PREFIX_TIMEOUT_MS = 2_000;
+const BUN_PREFIX_TIMEOUT_MS = 2_000;
+const OFF_VALUES = new Set(["0", "false", "off", "skip", "disabled"]);
+const CHECK_ONLY_VALUES = new Set(["check", "notice", "notify"]);
+const INSTALLABLE_VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u;
+const envValue = (env, key) => env[key]?.trim().toLowerCase() ?? "";
+const toErrorMessage = (error) => {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === "string") {
+        return error;
+    }
+    return "Unknown error";
+};
+const shouldSkipForArgs = (args) => {
+    if (args[0] === "a2a") {
+        return "a2a command";
+    }
+    if (args[0] === "exec") {
+        return "non-interactive command";
+    }
+    if (args[0] === "update") {
+        return "manual update command";
+    }
+    if (args.includes("--version") ||
+        args.includes("-v") ||
+        args.includes("--help") ||
+        args.includes("-h")) {
+        return "immediate-exit command";
+    }
+    if (args.includes("--headless") ||
+        args.includes("--json") ||
+        args.includes("--rpc") ||
+        args.includes("rpc")) {
+        return "non-interactive command";
+    }
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--mode" && args[i + 1] === "headless") {
+            return "headless command";
+        }
+        if (arg?.startsWith("--mode=") &&
+            arg.slice("--mode=".length) === "headless") {
+            return "headless command";
+        }
+    }
+    if (parseArgs(args).messages.length > 0) {
+        return "single-shot prompt";
+    }
+    return null;
+};
+export const isInstalledPackageEntrypoint = (entrypoint, packageName = getPackageName(), globalPrefix) => {
+    if (!entrypoint) {
+        return false;
+    }
+    if (isPackageEntrypointPath(entrypoint, packageName, globalPrefix)) {
+        return true;
+    }
+    try {
+        return isPackageEntrypointPath(realpathSync(entrypoint), packageName, globalPrefix);
+    }
+    catch {
+        return false;
+    }
+};
+const isPackageEntrypointPath = (entrypoint, packageName, globalPrefix) => {
+    const normalized = entrypoint.replace(/\\/g, "/");
+    const packageEntrypoint = `/node_modules/${packageName}/dist/cli.js`;
+    if (!normalized.endsWith(packageEntrypoint)) {
+        return false;
+    }
+    if (!globalPrefix) {
+        return true;
+    }
+    const normalizedPrefix = globalPrefix
+        .replace(/\\/g, "/")
+        .replace(/\/+$/u, "");
+    const normalizedPrefixes = new Set([normalizedPrefix]);
+    try {
+        normalizedPrefixes.add(realpathSync(globalPrefix).replace(/\\/g, "/").replace(/\/+$/u, ""));
+    }
+    catch {
+        // A missing prefix will fail the exact path checks below.
+    }
+    for (const prefix of normalizedPrefixes) {
+        if (normalized === `${prefix}/lib/node_modules/${packageName}/dist/cli.js` ||
+            normalized === `${prefix}/node_modules/${packageName}/dist/cli.js`) {
+            return true;
+        }
+    }
+    return false;
+};
+const resolveStatePath = (env = process.env, override) => {
+    if (override) {
+        return override;
+    }
+    if (env[STARTUP_UPDATE_STATE_ENV]) {
+        return resolve(env[STARTUP_UPDATE_STATE_ENV]);
+    }
+    return resolve(getAgentDir(), "startup-update-state.json");
+};
+const readState = (path) => {
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+};
+const writeState = (path, state) => {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(state, null, 2), "utf-8");
+};
+const retryMsFromEnv = (env) => {
+    const parsed = Number.parseInt(env[STARTUP_UPDATE_TTL_ENV] ?? "", 10);
+    if (Number.isFinite(parsed) && parsed >= 0) {
+        return parsed;
+    }
+    return DEFAULT_RETRY_MS;
+};
+const startupCheckTimeoutMsFromEnv = (env) => {
+    const parsed = Number.parseInt(env[STARTUP_UPDATE_TIMEOUT_ENV] ?? "", 10);
+    if (Number.isFinite(parsed) && parsed > 0) {
+        return parsed;
+    }
+    return DEFAULT_STARTUP_UPDATE_TIMEOUT_MS;
+};
+const startupSourceTimeoutMs = (totalTimeoutMs, sourceCount) => Math.max(1, Math.floor(totalTimeoutMs / Math.max(1, sourceCount)));
+const shouldThrottleAttempt = (state, version, now, retryMs) => {
+    if (!state ||
+        state.version !== version ||
+        typeof state.lastAttemptAt !== "number" ||
+        state.lastStatus !== "failed") {
+        return false;
+    }
+    return now - state.lastAttemptAt < retryMs;
+};
+const isInstallableVersion = (version) => INSTALLABLE_VERSION.test(version);
+const defaultInstallPackage = (packageManager, packageName, version) => {
+    const result = spawnSync(packageManager, ["install", "-g", `${packageName}@${version}`], {
+        encoding: "utf-8",
+        stdio: "pipe",
+        timeout: DEFAULT_INSTALL_TIMEOUT_MS,
+    });
+    return { status: result.status, error: result.error };
+};
+const resolveNpmGlobalPrefix = (env = process.env) => {
+    const result = spawnSync("npm", ["prefix", "-g"], {
+        encoding: "utf-8",
+        env,
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: NPM_PREFIX_TIMEOUT_MS,
+    });
+    if (result.error || result.status !== 0) {
+        return null;
+    }
+    const prefix = result.stdout.trim();
+    return prefix.length > 0 ? prefix : null;
+};
+const resolveBunGlobalPrefix = (env = process.env) => {
+    const result = spawnSync("bun", ["pm", "bin", "-g"], {
+        encoding: "utf-8",
+        env,
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: BUN_PREFIX_TIMEOUT_MS,
+    });
+    if (result.error || result.status !== 0) {
+        return null;
+    }
+    const binDir = result.stdout.trim();
+    if (!binDir) {
+        return null;
+    }
+    const bunHome = basename(binDir) === "bin" ? dirname(binDir) : binDir;
+    return join(bunHome, "install", "global");
+};
+const resolveGlobalInstallContexts = (env = process.env) => {
+    const contexts = [];
+    const npmPrefix = resolveNpmGlobalPrefix(env);
+    if (npmPrefix) {
+        contexts.push({ packageManager: "npm", prefix: npmPrefix });
+    }
+    const bunPrefix = resolveBunGlobalPrefix(env);
+    if (bunPrefix) {
+        contexts.push({ packageManager: "bun", prefix: bunPrefix });
+    }
+    return contexts;
+};
+export async function attemptStartupUpdate(options) {
+    const env = options.env ?? process.env;
+    const args = options.args ?? process.argv.slice(2);
+    const argv = options.argv ?? process.argv;
+    const packageName = options.packageName ?? getPackageName();
+    const updateMode = envValue(env, STARTUP_UPDATE_ENV);
+    const now = options.now ?? Date.now();
+    if (env[SKIP_ENV]) {
+        return { status: "skipped", reason: `${SKIP_ENV} is set` };
+    }
+    if (env.CI || env.NODE_ENV === "test") {
+        return { status: "skipped", reason: "test or CI environment" };
+    }
+    if (OFF_VALUES.has(updateMode)) {
+        return { status: "skipped", reason: `${STARTUP_UPDATE_ENV} is disabled` };
+    }
+    if (!(options.isTty ?? Boolean(process.stdin.isTTY && process.stdout.isTTY))) {
+        return { status: "skipped", reason: "non-TTY startup" };
+    }
+    const argsSkipReason = shouldSkipForArgs(args);
+    if (argsSkipReason) {
+        return { status: "skipped", reason: argsSkipReason };
+    }
+    const globalInstallContexts = options.globalInstallContexts ??
+        (options.globalPrefix === undefined
+            ? resolveGlobalInstallContexts(env)
+            : options.globalPrefix
+                ? [{ packageManager: "npm", prefix: options.globalPrefix }]
+                : []);
+    if (globalInstallContexts.length === 0) {
+        return {
+            status: "skipped",
+            reason: options.globalPrefix === null
+                ? "npm global prefix unavailable"
+                : "global package prefix unavailable",
+        };
+    }
+    const installContext = globalInstallContexts.find((context) => isInstalledPackageEntrypoint(argv[1], packageName, context.prefix));
+    if (!installContext) {
+        return {
+            status: "skipped",
+            reason: "not running installed global package",
+        };
+    }
+    const checkTimeoutMs = options.checkTimeoutMs ?? startupCheckTimeoutMsFromEnv(env);
+    const updateUrls = resolveUpdateUrls({}, env);
+    const checkOptions = {
+        timeoutMs: startupSourceTimeoutMs(checkTimeoutMs, updateUrls.length),
+        urls: updateUrls,
+    };
+    const check = await withTimeout((options.checkForUpdateImpl ?? checkForUpdate)(options.currentVersion, checkOptions), checkTimeoutMs, `Startup update check timed out after ${checkTimeoutMs}ms`).catch((error) => ({
+        currentVersion: options.currentVersion,
+        isUpdateAvailable: false,
+        sourceUrl: "",
+        error: toErrorMessage(error),
+    }));
+    if (check.error) {
+        return { status: "failed", check, error: check.error };
+    }
+    if (!check.isUpdateAvailable || !check.latestVersion) {
+        return { status: "current", check };
+    }
+    if (CHECK_ONLY_VALUES.has(updateMode)) {
+        return { status: "available", check };
+    }
+    if (!isInstallableVersion(check.latestVersion)) {
+        return {
+            status: "failed",
+            check,
+            error: `Refusing to install unsupported version ${check.latestVersion}`,
+        };
+    }
+    const statePath = resolveStatePath(env, options.statePath);
+    if (shouldThrottleAttempt(readState(statePath), check.latestVersion, now, retryMsFromEnv(env))) {
+        return { status: "available", check };
+    }
+    writeState(statePath, {
+        version: check.latestVersion,
+        lastAttemptAt: now,
+        lastStatus: "failed",
+    });
+    const install = (options.installPackage ?? defaultInstallPackage)(installContext.packageManager, packageName, check.latestVersion);
+    if (install.error || install.status !== 0) {
+        return {
+            status: "failed",
+            check,
+            error: install.error?.message ??
+                `${getGlobalInstallCommand(installContext.packageManager, `${packageName}@${check.latestVersion}`)} exited ${install.status}`,
+        };
+    }
+    writeState(statePath, {
+        version: check.latestVersion,
+        lastAttemptAt: now,
+        lastStatus: "updated",
+    });
+    if (options.restart === false) {
+        return { status: "updated", check };
+    }
+    const restart = options.restart ??
+        (() => {
+            const result = spawnSync(process.execPath, argv.slice(1), {
+                stdio: "inherit",
+                env: { ...env, [SKIP_ENV]: "1" },
+            });
+            return { status: result.status, error: result.error };
+        });
+    const restarted = restart();
+    if (restarted.error) {
+        return { status: "updated", check };
+    }
+    return { status: "restarted", check, exitCode: restarted.status ?? 0 };
+}
+//# sourceMappingURL=startup-refresh.js.map

package/dist/update/startup-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-refresh.js","sourceRoot":"","sources":["../../src/update/startup-refresh.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport {\n\texistsSync,\n\tmkdirSync,\n\treadFileSync,\n\trealpathSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { parseArgs } from \"../cli/args.js\";\nimport { getAgentDir } from \"../config/constants.js\";\nimport {\n\tgetGlobalInstallCommand,\n\tgetPackageName,\n} from \"../package-metadata.js\";\nimport { withTimeout } from \"../utils/async.js\";\nimport {\n\ttype UpdateCheckResult,\n\tcheckForUpdate,\n\tresolveUpdateUrls,\n} from \"./check.js\";\n\nconst SKIP_ENV = \"MAESTRO_SKIP_STARTUP_UPDATE\";\nconst STARTUP_UPDATE_ENV = \"MAESTRO_STARTUP_UPDATE\";\nconst STARTUP_UPDATE_STATE_ENV = \"MAESTRO_STARTUP_UPDATE_STATE\";\nconst STARTUP_UPDATE_TIMEOUT_ENV = \"MAESTRO_STARTUP_UPDATE_TIMEOUT_MS\";\nconst STARTUP_UPDATE_TTL_ENV = \"MAESTRO_STARTUP_UPDATE_RETRY_MS\";\nconst DEFAULT_INSTALL_TIMEOUT_MS = 60_000;\nconst DEFAULT_RETRY_MS = 24 * 60 * 60 * 1_000;\nconst DEFAULT_STARTUP_UPDATE_TIMEOUT_MS = 1_500;\nconst NPM_PREFIX_TIMEOUT_MS = 2_000;\nconst BUN_PREFIX_TIMEOUT_MS = 2_000;\n\ntype PackageManager = \"npm\" | \"bun\";\n\ntype GlobalInstallContext = {\n\tpackageManager: PackageManager;\n\tprefix: string;\n};\n\ntype StartupUpdateState = {\n\tversion?: string;\n\tlastAttemptAt?: number;\n\tlastStatus?: \"failed\" | \"updated\";\n};\n\nexport type StartupUpdateOutcome =\n\t| { status: \"skipped\"; reason: string }\n\t| { status: \"current\"; check: UpdateCheckResult }\n\t| { status: \"available\"; check: UpdateCheckResult }\n\t| { status: \"failed\"; check?: UpdateCheckResult; error: string }\n\t| { status: \"updated\"; check: UpdateCheckResult }\n\t| { status: \"restarted\"; check: UpdateCheckResult; exitCode: number };\n\ntype StartupUpdateOptions = {\n\targs?: string[];\n\targv?: string[];\n\tcurrentVersion: string;\n\tenv?: NodeJS.ProcessEnv;\n\tisTty?: boolean;\n\tnow?: number;\n\tpackageName?: string;\n\tcheckForUpdateImpl?: (\n\t\tcurrentVersion: string,\n\t\toptions?: { timeoutMs?: number; urls?: string[] },\n\t) => Promise<UpdateCheckResult>;\n\tcheckTimeoutMs?: number;\n\tglobalInstallContexts?: GlobalInstallContext[] | null;\n\tglobalPrefix?: string | null;\n\tinstallPackage?: (\n\t\tpackageManager: PackageManager,\n\t\tpackageName: string,\n\t\tversion: string,\n\t) => {\n\t\tstatus: number | null;\n\t\terror?: Error;\n\t};\n\trestart?: false | (() => { status: number | null; error?: Error });\n\tstatePath?: string;\n};\n\nconst OFF_VALUES = new Set([\"0\", \"false\", \"off\", \"skip\", \"disabled\"]);\nconst CHECK_ONLY_VALUES = new Set([\"check\", \"notice\", \"notify\"]);\nconst INSTALLABLE_VERSION = /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$/u;\n\nconst envValue = (env: NodeJS.ProcessEnv, key: string): string =>\n\tenv[key]?.trim().toLowerCase() ?? \"\";\n\nconst toErrorMessage = (error: unknown): string => {\n\tif (error instanceof Error) {\n\t\treturn error.message;\n\t}\n\tif (typeof error === \"string\") {\n\t\treturn error;\n\t}\n\treturn \"Unknown error\";\n};\n\nconst shouldSkipForArgs = (args: string[]): string | null => {\n\tif (args[0] === \"a2a\") {\n\t\treturn \"a2a command\";\n\t}\n\tif (args[0] === \"exec\") {\n\t\treturn \"non-interactive command\";\n\t}\n\tif (args[0] === \"update\") {\n\t\treturn \"manual update command\";\n\t}\n\tif (\n\t\targs.includes(\"--version\") ||\n\t\targs.includes(\"-v\") ||\n\t\targs.includes(\"--help\") ||\n\t\targs.includes(\"-h\")\n\t) {\n\t\treturn \"immediate-exit command\";\n\t}\n\tif (\n\t\targs.includes(\"--headless\") ||\n\t\targs.includes(\"--json\") ||\n\t\targs.includes(\"--rpc\") ||\n\t\targs.includes(\"rpc\")\n\t) {\n\t\treturn \"non-interactive command\";\n\t}\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i];\n\t\tif (arg === \"--mode\" && args[i + 1] === \"headless\") {\n\t\t\treturn \"headless command\";\n\t\t}\n\t\tif (\n\t\t\targ?.startsWith(\"--mode=\") &&\n\t\t\targ.slice(\"--mode=\".length) === \"headless\"\n\t\t) {\n\t\t\treturn \"headless command\";\n\t\t}\n\t}\n\tif (parseArgs(args).messages.length > 0) {\n\t\treturn \"single-shot prompt\";\n\t}\n\treturn null;\n};\n\nexport const isInstalledPackageEntrypoint = (\n\tentrypoint: string | undefined,\n\tpackageName = getPackageName(),\n\tglobalPrefix?: string | null,\n): boolean => {\n\tif (!entrypoint) {\n\t\treturn false;\n\t}\n\tif (isPackageEntrypointPath(entrypoint, packageName, globalPrefix)) {\n\t\treturn true;\n\t}\n\ttry {\n\t\treturn isPackageEntrypointPath(\n\t\t\trealpathSync(entrypoint),\n\t\t\tpackageName,\n\t\t\tglobalPrefix,\n\t\t);\n\t} catch {\n\t\treturn false;\n\t}\n};\n\nconst isPackageEntrypointPath = (\n\tentrypoint: string,\n\tpackageName: string,\n\tglobalPrefix?: string | null,\n): boolean => {\n\tconst normalized = entrypoint.replace(/\\\\/g, \"/\");\n\tconst packageEntrypoint = `/node_modules/${packageName}/dist/cli.js`;\n\tif (!normalized.endsWith(packageEntrypoint)) {\n\t\treturn false;\n\t}\n\tif (!globalPrefix) {\n\t\treturn true;\n\t}\n\tconst normalizedPrefix = globalPrefix\n\t\t.replace(/\\\\/g, \"/\")\n\t\t.replace(/\\/+$/u, \"\");\n\tconst normalizedPrefixes = new Set([normalizedPrefix]);\n\ttry {\n\t\tnormalizedPrefixes.add(\n\t\t\trealpathSync(globalPrefix).replace(/\\\\/g, \"/\").replace(/\\/+$/u, \"\"),\n\t\t);\n\t} catch {\n\t\t// A missing prefix will fail the exact path checks below.\n\t}\n\tfor (const prefix of normalizedPrefixes) {\n\t\tif (\n\t\t\tnormalized === `${prefix}/lib/node_modules/${packageName}/dist/cli.js` ||\n\t\t\tnormalized === `${prefix}/node_modules/${packageName}/dist/cli.js`\n\t\t) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n};\n\nconst resolveStatePath = (\n\tenv: NodeJS.ProcessEnv = process.env,\n\toverride?: string,\n): string => {\n\tif (override) {\n\t\treturn override;\n\t}\n\tif (env[STARTUP_UPDATE_STATE_ENV]) {\n\t\treturn resolve(env[STARTUP_UPDATE_STATE_ENV]);\n\t}\n\treturn resolve(getAgentDir(), \"startup-update-state.json\");\n};\n\nconst readState = (path: string): StartupUpdateState | null => {\n\tif (!existsSync(path)) {\n\t\treturn null;\n\t}\n\ttry {\n\t\treturn JSON.parse(readFileSync(path, \"utf-8\")) as StartupUpdateState;\n\t} catch {\n\t\treturn null;\n\t}\n};\n\nconst writeState = (path: string, state: StartupUpdateState): void => {\n\tmkdirSync(dirname(path), { recursive: true });\n\twriteFileSync(path, JSON.stringify(state, null, 2), \"utf-8\");\n};\n\nconst retryMsFromEnv = (env: NodeJS.ProcessEnv): number => {\n\tconst parsed = Number.parseInt(env[STARTUP_UPDATE_TTL_ENV] ?? \"\", 10);\n\tif (Number.isFinite(parsed) && parsed >= 0) {\n\t\treturn parsed;\n\t}\n\treturn DEFAULT_RETRY_MS;\n};\n\nconst startupCheckTimeoutMsFromEnv = (env: NodeJS.ProcessEnv): number => {\n\tconst parsed = Number.parseInt(env[STARTUP_UPDATE_TIMEOUT_ENV] ?? \"\", 10);\n\tif (Number.isFinite(parsed) && parsed > 0) {\n\t\treturn parsed;\n\t}\n\treturn DEFAULT_STARTUP_UPDATE_TIMEOUT_MS;\n};\n\nconst startupSourceTimeoutMs = (\n\ttotalTimeoutMs: number,\n\tsourceCount: number,\n): number => Math.max(1, Math.floor(totalTimeoutMs / Math.max(1, sourceCount)));\n\nconst shouldThrottleAttempt = (\n\tstate: StartupUpdateState | null,\n\tversion: string,\n\tnow: number,\n\tretryMs: number,\n): boolean => {\n\tif (\n\t\t!state ||\n\t\tstate.version !== version ||\n\t\ttypeof state.lastAttemptAt !== \"number\" ||\n\t\tstate.lastStatus !== \"failed\"\n\t) {\n\t\treturn false;\n\t}\n\treturn now - state.lastAttemptAt < retryMs;\n};\n\nconst isInstallableVersion = (version: string): boolean =>\n\tINSTALLABLE_VERSION.test(version);\n\nconst defaultInstallPackage = (\n\tpackageManager: PackageManager,\n\tpackageName: string,\n\tversion: string,\n) => {\n\tconst result = spawnSync(\n\t\tpackageManager,\n\t\t[\"install\", \"-g\", `${packageName}@${version}`],\n\t\t{\n\t\t\tencoding: \"utf-8\",\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: DEFAULT_INSTALL_TIMEOUT_MS,\n\t\t},\n\t);\n\treturn { status: result.status, error: result.error };\n};\n\nconst resolveNpmGlobalPrefix = (\n\tenv: NodeJS.ProcessEnv = process.env,\n): string | null => {\n\tconst result = spawnSync(\"npm\", [\"prefix\", \"-g\"], {\n\t\tencoding: \"utf-8\",\n\t\tenv,\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t\ttimeout: NPM_PREFIX_TIMEOUT_MS,\n\t});\n\tif (result.error || result.status !== 0) {\n\t\treturn null;\n\t}\n\tconst prefix = result.stdout.trim();\n\treturn prefix.length > 0 ? prefix : null;\n};\n\nconst resolveBunGlobalPrefix = (\n\tenv: NodeJS.ProcessEnv = process.env,\n): string | null => {\n\tconst result = spawnSync(\"bun\", [\"pm\", \"bin\", \"-g\"], {\n\t\tencoding: \"utf-8\",\n\t\tenv,\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t\ttimeout: BUN_PREFIX_TIMEOUT_MS,\n\t});\n\tif (result.error || result.status !== 0) {\n\t\treturn null;\n\t}\n\tconst binDir = result.stdout.trim();\n\tif (!binDir) {\n\t\treturn null;\n\t}\n\tconst bunHome = basename(binDir) === \"bin\" ? dirname(binDir) : binDir;\n\treturn join(bunHome, \"install\", \"global\");\n};\n\nconst resolveGlobalInstallContexts = (\n\tenv: NodeJS.ProcessEnv = process.env,\n): GlobalInstallContext[] => {\n\tconst contexts: GlobalInstallContext[] = [];\n\tconst npmPrefix = resolveNpmGlobalPrefix(env);\n\tif (npmPrefix) {\n\t\tcontexts.push({ packageManager: \"npm\", prefix: npmPrefix });\n\t}\n\tconst bunPrefix = resolveBunGlobalPrefix(env);\n\tif (bunPrefix) {\n\t\tcontexts.push({ packageManager: \"bun\", prefix: bunPrefix });\n\t}\n\treturn contexts;\n};\n\nexport async function attemptStartupUpdate(\n\toptions: StartupUpdateOptions,\n): Promise<StartupUpdateOutcome> {\n\tconst env = options.env ?? process.env;\n\tconst args = options.args ?? process.argv.slice(2);\n\tconst argv = options.argv ?? process.argv;\n\tconst packageName = options.packageName ?? getPackageName();\n\tconst updateMode = envValue(env, STARTUP_UPDATE_ENV);\n\tconst now = options.now ?? Date.now();\n\n\tif (env[SKIP_ENV]) {\n\t\treturn { status: \"skipped\", reason: `${SKIP_ENV} is set` };\n\t}\n\tif (env.CI || env.NODE_ENV === \"test\") {\n\t\treturn { status: \"skipped\", reason: \"test or CI environment\" };\n\t}\n\tif (OFF_VALUES.has(updateMode)) {\n\t\treturn { status: \"skipped\", reason: `${STARTUP_UPDATE_ENV} is disabled` };\n\t}\n\tif (\n\t\t!(options.isTty ?? Boolean(process.stdin.isTTY && process.stdout.isTTY))\n\t) {\n\t\treturn { status: \"skipped\", reason: \"non-TTY startup\" };\n\t}\n\tconst argsSkipReason = shouldSkipForArgs(args);\n\tif (argsSkipReason) {\n\t\treturn { status: \"skipped\", reason: argsSkipReason };\n\t}\n\tconst globalInstallContexts =\n\t\toptions.globalInstallContexts ??\n\t\t(options.globalPrefix === undefined\n\t\t\t? resolveGlobalInstallContexts(env)\n\t\t\t: options.globalPrefix\n\t\t\t\t? [{ packageManager: \"npm\" as const, prefix: options.globalPrefix }]\n\t\t\t\t: []);\n\tif (globalInstallContexts.length === 0) {\n\t\treturn {\n\t\t\tstatus: \"skipped\",\n\t\t\treason:\n\t\t\t\toptions.globalPrefix === null\n\t\t\t\t\t? \"npm global prefix unavailable\"\n\t\t\t\t\t: \"global package prefix unavailable\",\n\t\t};\n\t}\n\tconst installContext = globalInstallContexts.find((context) =>\n\t\tisInstalledPackageEntrypoint(argv[1], packageName, context.prefix),\n\t);\n\tif (!installContext) {\n\t\treturn {\n\t\t\tstatus: \"skipped\",\n\t\t\treason: \"not running installed global package\",\n\t\t};\n\t}\n\n\tconst checkTimeoutMs =\n\t\toptions.checkTimeoutMs ?? startupCheckTimeoutMsFromEnv(env);\n\tconst updateUrls = resolveUpdateUrls({}, env);\n\tconst checkOptions = {\n\t\ttimeoutMs: startupSourceTimeoutMs(checkTimeoutMs, updateUrls.length),\n\t\turls: updateUrls,\n\t};\n\tconst check = await withTimeout(\n\t\t(options.checkForUpdateImpl ?? checkForUpdate)(\n\t\t\toptions.currentVersion,\n\t\t\tcheckOptions,\n\t\t),\n\t\tcheckTimeoutMs,\n\t\t`Startup update check timed out after ${checkTimeoutMs}ms`,\n\t).catch(\n\t\t(error): UpdateCheckResult => ({\n\t\t\tcurrentVersion: options.currentVersion,\n\t\t\tisUpdateAvailable: false,\n\t\t\tsourceUrl: \"\",\n\t\t\terror: toErrorMessage(error),\n\t\t}),\n\t);\n\tif (check.error) {\n\t\treturn { status: \"failed\", check, error: check.error };\n\t}\n\tif (!check.isUpdateAvailable || !check.latestVersion) {\n\t\treturn { status: \"current\", check };\n\t}\n\tif (CHECK_ONLY_VALUES.has(updateMode)) {\n\t\treturn { status: \"available\", check };\n\t}\n\tif (!isInstallableVersion(check.latestVersion)) {\n\t\treturn {\n\t\t\tstatus: \"failed\",\n\t\t\tcheck,\n\t\t\terror: `Refusing to install unsupported version ${check.latestVersion}`,\n\t\t};\n\t}\n\n\tconst statePath = resolveStatePath(env, options.statePath);\n\tif (\n\t\tshouldThrottleAttempt(\n\t\t\treadState(statePath),\n\t\t\tcheck.latestVersion,\n\t\t\tnow,\n\t\t\tretryMsFromEnv(env),\n\t\t)\n\t) {\n\t\treturn { status: \"available\", check };\n\t}\n\n\twriteState(statePath, {\n\t\tversion: check.latestVersion,\n\t\tlastAttemptAt: now,\n\t\tlastStatus: \"failed\",\n\t});\n\tconst install = (options.installPackage ?? defaultInstallPackage)(\n\t\tinstallContext.packageManager,\n\t\tpackageName,\n\t\tcheck.latestVersion,\n\t);\n\tif (install.error || install.status !== 0) {\n\t\treturn {\n\t\t\tstatus: \"failed\",\n\t\t\tcheck,\n\t\t\terror:\n\t\t\t\tinstall.error?.message ??\n\t\t\t\t`${getGlobalInstallCommand(installContext.packageManager, `${packageName}@${check.latestVersion}`)} exited ${install.status}`,\n\t\t};\n\t}\n\n\twriteState(statePath, {\n\t\tversion: check.latestVersion,\n\t\tlastAttemptAt: now,\n\t\tlastStatus: \"updated\",\n\t});\n\n\tif (options.restart === false) {\n\t\treturn { status: \"updated\", check };\n\t}\n\n\tconst restart =\n\t\toptions.restart ??\n\t\t(() => {\n\t\t\tconst result = spawnSync(process.execPath, argv.slice(1), {\n\t\t\t\tstdio: \"inherit\",\n\t\t\t\tenv: { ...env, [SKIP_ENV]: \"1\" },\n\t\t\t});\n\t\t\treturn { status: result.status, error: result.error };\n\t\t});\n\tconst restarted = restart();\n\tif (restarted.error) {\n\t\treturn { status: \"updated\", check };\n\t}\n\treturn { status: \"restarted\", check, exitCode: restarted.status ?? 0 };\n}\n"]}

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "0.10.46",
-  "notes": "Maestro by EvalOps - Deterministic coding agent with TUI/CLI and Web UI for AI-assisted development v0.10.46 is now available."
+  "version": "0.10.48",
+  "notes": "Maestro by EvalOps - Deterministic coding agent with TUI/CLI and Web UI for AI-assisted development v0.10.48 is now available."
 }