agentroam 0.2.0-preview.22 → 0.2.0-preview.23

package/bin/node-preflight.mjs

@@ -7,7 +7,7 @@ import { promisify } from "node:util";
 import { MINIMUM_NODE_VERSION, compareNodeVersions, isSupportedNodeVersion, parseNodeVersion } from "./runtime-policy.mjs";
 
 const execFileAsync = promisify(execFile);
-const RELEASE_VERSION = "0.2.0-preview.22";
+const RELEASE_VERSION = "0.2.0-preview.23";
 const RELEASE_BASE_URL = `https://gitee.com/caoqu/team-agent/releases/download/v${RELEASE_VERSION}`;
 const FORWARDED_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
 

package/dist/codex-runtime-manager.js

@@ -5,6 +5,8 @@ import { delimiter, dirname, isAbsolute, relative, resolve, win32 } from "node:p
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 export const CODEX_RUNTIME_VERSION = "0.153.0";
+// Managed install pin tracks releases; the compatibility floor for user installs is independent.
+export const CODEX_MINIMUM_VERSION = "0.153.0";
 const CODEX_PACKAGE = `@openai/codex@${CODEX_RUNTIME_VERSION}`;
 const NPM_REGISTRY = "https://registry.npmjs.org";
 export const CODEX_INSTALL_TIMEOUT_MS = 60 * 60_000;
@@ -130,6 +132,19 @@ export function parseCodexVersion(output) {
     const match = output.match(/(?:^|\s)(\d+\.\d+\.\d+)(?:\s|$)/);
     return match?.[1] ?? null;
 }
+// Compare numeric components, so 0.153.10 and 0.154.0 both exceed 0.153.2.
+export function isCodexVersionAtLeast(version, minimum) {
+    const actual = version.split(".").map(BigInt);
+    const required = minimum.split(".").map(BigInt);
+    for (let index = 0; index < required.length; index += 1) {
+        if (actual[index] !== required[index])
+            return actual[index] > required[index];
+    }
+    return true;
+}
+function meetsCodexMinimum(version) {
+    return isCodexVersionAtLeast(version, CODEX_MINIMUM_VERSION);
+}
 async function findCompatibleGlobalCodex(pathValue, platform, dependencies) {
     const names = platform === "win32" ? ["codex.exe", "codex"] : ["codex"];
     const pathDelimiter = platform === "win32" ? ";" : delimiter;
@@ -257,10 +272,11 @@ async function validateCodex(executable, source, _platform, dependencies) {
     }
     const versionResult = await dependencies.run(executable, ["--version"], 5_000);
     const version = parseCodexVersion(`${versionResult.stdout}\n${versionResult.stderr}`);
-    if (!version)
-        throw new Error(`Unable to parse Codex version from ${executable}`);
-    if (version !== CODEX_RUNTIME_VERSION) {
-        throw new Error(`Codex ${version} at ${executable} is incompatible; AgentRoam requires ${CODEX_RUNTIME_VERSION}`);
+    if (!version) {
+        throw new Error(`Unable to parse a supported stable Codex version from ${executable}`);
+    }
+    if (!meetsCodexMinimum(version)) {
+        throw new Error(`Codex ${version} at ${executable} is incompatible; AgentRoam requires >=${CODEX_MINIMUM_VERSION}`);
     }
     try {
         await dependencies.run(executable, ["app-server", "--help"], 5_000);

package/dist/codex-runtime-manager.test.js

@@ -2,21 +2,31 @@ import { chmod, mkdtemp, mkdir, readdir, rm, writeFile } from "node:fs/promises"
 import { tmpdir } from "node:os";
 import { dirname, resolve, win32 } from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";
-import { CODEX_INSTALL_STALE_LOCK_MS, CODEX_INSTALL_TIMEOUT_MS, CODEX_RUNTIME_VERSION, managedCodexBinaryCandidates, parseCodexVersion, resolveCodexRuntime, resolveNpmExecutor, } from "./codex-runtime-manager.js";
+import { CODEX_INSTALL_STALE_LOCK_MS, CODEX_INSTALL_TIMEOUT_MS, CODEX_MINIMUM_VERSION, CODEX_RUNTIME_VERSION, isCodexVersionAtLeast, managedCodexBinaryCandidates, parseCodexVersion, resolveCodexRuntime, resolveNpmExecutor, } from "./codex-runtime-manager.js";
 const temporaryDirectories = [];
 afterEach(async () => {
     await Promise.all(temporaryDirectories.splice(0).map((path) => rm(path, { recursive: true, force: true })));
 });
 describe("managed Codex runtime", () => {
     it("parses the official version output", () => {
-        expect(parseCodexVersion("codex-cli 0.153.0")).toBe("0.153.0");
+        expect(parseCodexVersion("codex-cli 0.153.5")).toBe("0.153.5");
         expect(parseCodexVersion("codex-cli next")).toBeNull();
     });
+    it("compares versions numerically instead of lexicographically", () => {
+        // Samples stay below the current pin: pins only move forward, so these
+        // literals can never collide with the upgrade script's version replacement.
+        expect(isCodexVersionAtLeast("0.140.12", "0.140.3")).toBe(true);
+        expect(isCodexVersionAtLeast("0.140.3", "0.140.12")).toBe(false);
+        expect(isCodexVersionAtLeast(CODEX_MINIMUM_VERSION, CODEX_MINIMUM_VERSION)).toBe(true);
+        expect(isCodexVersionAtLeast("0.139.9", CODEX_MINIMUM_VERSION)).toBe(false);
+        expect(isCodexVersionAtLeast("0.152.0", "0.140.0")).toBe(true);
+        expect(isCodexVersionAtLeast("1.0.0", "0.140.0")).toBe(true);
+    });
     it("uses a compatible explicit absolute executable first", async () => {
         const root = await temporaryRoot();
         const executable = await fakeExecutable(resolve(root, "codex"));
         const run = vi.fn(async (_command, args) => ({
-            stdout: args[0] === "--version" ? "codex-cli 0.153.0\n" : "app-server help\n",
+            stdout: args[0] === "--version" ? `codex-cli ${CODEX_RUNTIME_VERSION}\n` : "app-server help\n",
             stderr: "",
         }));
         await expect(resolveCodexRuntime({
@@ -32,7 +42,29 @@ describe("managed Codex runtime", () => {
         });
         expect(run.mock.calls.map((call) => call[1])).toEqual([["--version"], ["app-server", "--help"]]);
     });
-    it("rejects an incompatible explicit executable instead of silently replacing it", async () => {
+    it("accepts explicit executables at or above the minimum stable version", async () => {
+        const outputs = [
+            `codex-cli ${CODEX_MINIMUM_VERSION}\n`,
+            `codex-cli ${CODEX_RUNTIME_VERSION}\n`,
+        ];
+        for (const output of outputs) {
+            const root = await temporaryRoot();
+            const executable = await fakeExecutable(resolve(root, "codex"));
+            await expect(resolveCodexRuntime({
+                dataDir: resolve(root, "data"),
+                target: "darwin-arm64",
+                environment: { AGENT_CODEX_BIN: executable, PATH: "" },
+                platform: "darwin",
+                dependencies: {
+                    run: async (_command, args) => ({
+                        stdout: args[0] === "--version" ? output : "app-server help\n",
+                        stderr: "",
+                    }),
+                },
+            })).resolves.toMatchObject({ executable, source: "explicit" });
+        }
+    });
+    it("rejects an explicit executable below the minimum instead of silently replacing it", async () => {
         const root = await temporaryRoot();
         const executable = await fakeExecutable(resolve(root, "codex"));
         await expect(resolveCodexRuntime({
@@ -41,9 +73,22 @@ describe("managed Codex runtime", () => {
             environment: { AGENT_CODEX_BIN: executable, PATH: "" },
             platform: "darwin",
             dependencies: {
-                run: async () => ({ stdout: "codex-cli 0.154.0\n", stderr: "" }),
+                run: async () => ({ stdout: "codex-cli 0.152.9\n", stderr: "" }),
             },
-        })).rejects.toThrow("requires 0.153.0");
+        })).rejects.toThrow(`requires >=${CODEX_MINIMUM_VERSION}`);
+    });
+    it("rejects prerelease or otherwise unparseable version output", async () => {
+        const root = await temporaryRoot();
+        const executable = await fakeExecutable(resolve(root, "codex"));
+        await expect(resolveCodexRuntime({
+            dataDir: resolve(root, "data"),
+            target: "darwin-arm64",
+            environment: { AGENT_CODEX_BIN: executable, PATH: "" },
+            platform: "darwin",
+            dependencies: {
+                run: async () => ({ stdout: "codex-cli 0.150.0-alpha.1\n", stderr: "" }),
+            },
+        })).rejects.toThrow("Unable to parse a supported stable Codex version");
     });
     it("skips an incompatible PATH executable and reuses the managed runtime", async () => {
         const root = await temporaryRoot();
@@ -52,7 +97,7 @@ describe("managed Codex runtime", () => {
         const managed = await fakeExecutable(managedCodexBinaryCandidates(managedRoot, "darwin-arm64")[0]);
         const run = vi.fn(async (command, args) => ({
             stdout: args[0] === "--version"
-                ? command === global ? "codex-cli 0.152.0\n" : "codex-cli 0.153.0\n"
+                ? command === global ? "codex-cli 0.152.0\n" : `codex-cli ${CODEX_RUNTIME_VERSION}\n`
                 : "help\n",
             stderr: "",
         }));
@@ -65,6 +110,22 @@ describe("managed Codex runtime", () => {
         })).resolves.toEqual({ executable: managed, version: CODEX_RUNTIME_VERSION, source: "managed" });
         expect(run.mock.calls.some((call) => call[1].includes("install"))).toBe(false);
     });
+    it("reuses a qualified PATH executable without installing", async () => {
+        const root = await temporaryRoot();
+        const global = await fakeExecutable(resolve(root, "bin", "codex"));
+        const run = vi.fn(async (_command, args) => ({
+            stdout: args[0] === "--version" ? `codex-cli ${CODEX_RUNTIME_VERSION}\n` : "help\n",
+            stderr: "",
+        }));
+        await expect(resolveCodexRuntime({
+            dataDir: resolve(root, "data"),
+            target: "darwin-arm64",
+            environment: { PATH: resolve(root, "bin") },
+            platform: "darwin",
+            dependencies: { run },
+        })).resolves.toEqual({ executable: global, version: CODEX_RUNTIME_VERSION, source: "global" });
+        expect(run.mock.calls.some((call) => call[1].includes("install"))).toBe(false);
+    });
     it("installs the locked official package into a versioned runtime directory", async () => {
         const root = await temporaryRoot();
         const npmExecPath = await fakeExecutable(resolve(root, "npm-cli.js"));
@@ -80,7 +141,7 @@ describe("managed Codex runtime", () => {
                 return { stdout: "installed", stderr: "" };
             }
             return {
-                stdout: args[0] === "--version" ? "codex-cli 0.153.0\n" : "help\n",
+                stdout: args[0] === "--version" ? `codex-cli ${CODEX_RUNTIME_VERSION}\n` : "help\n",
                 stderr: "",
             };
         });
@@ -110,7 +171,7 @@ describe("managed Codex runtime", () => {
                 return { stdout: "installed", stderr: "" };
             }
             return {
-                stdout: args[0] === "--version" ? "codex-cli 0.153.0\n" : "help\n",
+                stdout: args[0] === "--version" ? `codex-cli ${CODEX_RUNTIME_VERSION}\n` : "help\n",
                 stderr: "",
             };
         };

package/dist/platform-packages.js

@@ -2,7 +2,7 @@ import { readFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname } from "node:path";
 import { MINIMUM_NODE_VERSION, assertSupportedNodeVersion } from "../bin/runtime-policy.mjs";
-export const AGENTROAM_VERSION = "0.2.0-preview.22";
+export const AGENTROAM_VERSION = "0.2.0-preview.23";
 export const PLATFORM_DEPENDENCY_VERSIONS = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).optionalDependencies;
 export const PLATFORM_PACKAGES = {
     "darwin-arm64": {

package/dist/tunnel/public-readiness.js

@@ -22,7 +22,7 @@ export async function waitForPublicReadiness(publicUrl, options = {}) {
             try {
                 const response = await fetchImpl(endpoint, {
                     cache: "no-store",
-                    headers: { "user-agent": "agentroam-readiness/0.2.0-preview.22" },
+                    headers: { "user-agent": "agentroam-readiness/0.2.0-preview.23" },
                     signal: options.signal,
                 });
                 if (response.ok) {

package/install/install-agentroam.ps1

@@ -4,6 +4,7 @@ $ProgressPreference = "SilentlyContinue"
 $NodeVersion = "22.22.0"
 $MinimumNodeVersion = "22.22.0"
 # 默认跟随 npm preview 最新标签；可用 $env:AGENTROAM_VERSION 钉精确版本
+# 例如：$env:AGENTROAM_VERSION = "0.2.0-preview.23"; ./install-agentroam.ps1
 $AgentRoamVersionRequest = if ($env:AGENTROAM_VERSION) { $env:AGENTROAM_VERSION } else { "preview" }
 $AgentRoamVersion = "pending-version"
 $NodeArchive = "node-v22.22.0-win-x64.zip"

package/install/install-agentroam.sh

@@ -4,7 +4,7 @@ set -eu
 NODE_VERSION="22.22.0"
 MINIMUM_NODE_VERSION="22.22.0"
 # Default to the newest published preview; pin an exact version via
-# AGENTROAM_VERSION=0.2.0-preview.22 sh install-agentroam.sh
+# AGENTROAM_VERSION=0.2.0-preview.23 sh install-agentroam.sh
 AGENTROAM_VERSION_REQUEST="${AGENTROAM_VERSION:-preview}"
 AGENTROAM_VERSION=""
 NODE_ARCHIVE="node-v22.22.0-darwin-arm64.tar.xz"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentroam",
-  "version": "0.2.0-preview.22",
+  "version": "0.2.0-preview.23",
   "description": "Zero-install mobile remote terminal and file console",
   "type": "module",
   "bin": {
@@ -26,8 +26,8 @@
     "undici": "^6.25.0"
   },
   "optionalDependencies": {
-    "agentroam-runtime-darwin-arm64": "0.2.0-preview.22",
-    "agentroam-runtime-win32-x64": "0.2.0-preview.22",
+    "agentroam-runtime-darwin-arm64": "0.2.0-preview.23",
+    "agentroam-runtime-win32-x64": "0.2.0-preview.23",
     "agentroam-cloudflared-darwin-arm64": "0.2.0-preview.20",
     "agentroam-cloudflared-win32-x64": "0.2.0-preview.20",
     "agentroam-tui-darwin-arm64": "0.2.0-preview.20",