agentroam 0.2.0-preview.22 → 0.2.0-preview.24

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.24";
 const RELEASE_BASE_URL = `https://gitee.com/caoqu/team-agent/releases/download/v${RELEASE_VERSION}`;
 const FORWARDED_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
 

package/dist/cli.js

@@ -1,3 +1,4 @@
+import { printLocalDesktopUrl } from './local-desktop-url.js';
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { parseArgs } from "./args.js";
@@ -137,6 +138,9 @@ export async function main(argv) {
         }
         void runtime.exited.then(() => controller.abort());
         console.log(`✓ Local server: ${runtime.localUrl}/web`);
+        await serviceReporter?.localReady(runtime.localUrl);
+        if (!serviceReporter)
+            printLocalDesktopUrl(runtime.localUrl);
         const lanUrl = options.localOnly ? findLanUrl(runtime.port) ?? runtime.localUrl : runtime.localUrl;
         relay = await selectRelay({
             cli: options,

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/local-desktop-url.js

@@ -0,0 +1,8 @@
+export function printLocalDesktopUrl(localUrl, log = console.log, platform = process.platform) {
+    log(`远程桌面授权地址：${localUrl.replace(/\/$/, '')}/web`);
+    log('请在运行 CLI 的这台电脑上用浏览器打开此地址，配对后点击“远程授权”（盾牌图标）。');
+    if (platform === 'win32')
+        log('点击“开启共享”。请保持 Windows 已登录且未锁屏；暂不支持 UAC 安全桌面和管理员窗口控制。');
+    else
+        log('按提示授予“屏幕录制”和“辅助功能”权限，然后点击“开启共享”。');
+}

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.24";
 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/service/runtime-state.js

@@ -16,6 +16,9 @@ export class ServiceRuntimeReporter {
         await removeIfExists(this.paths.urlPath);
         await this.write({ status: "starting" });
     }
+    async localReady(localUrl) {
+        await this.write({ status: "starting", localUrl });
+    }
     async ready(ready) {
         await this.write({ status: "ready", ...ready });
         await writePrivateText(this.paths.urlPath, `${ready.accessUrl}\n`);

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

@@ -13,6 +13,9 @@ describe("ServiceRuntimeReporter", () => {
         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",

package/dist/service/service-command.js

@@ -1,3 +1,4 @@
+import { printLocalDesktopUrl } from '../local-desktop-url.js';
 import { delimiter, dirname, isAbsolute, resolve, win32 } from "node:path";
 import { resolveCodexRuntime } from "../codex-runtime-manager.js";
 import { detectPlatform } from "../platform.js";
@@ -60,13 +61,10 @@ export async function runServiceCommand(options, context) {
             log(`✓ AgentRoam service installed: ${definition}`);
             if (state?.status === "ready" && state.version === config.version)
                 await cleanupOldLaunchers(config, log);
+            if (state?.localUrl && state.status !== "stopped")
+                printLocalDesktopUrl(state.localUrl, log, platform);
             if (state?.status === "ready" && state.accessUrl) {
                 log(`Open: ${state.accessUrl}`);
-                if (state.localUrl) {
-                    log(`远程桌面授权地址：${state.localUrl.replace(/\/$/, "")}/web`);
-                    log('请在运行 CLI 的这台电脑上用浏览器打开此地址，配对后点击“远程授权”（盾牌图标）。');
-                    log('按提示授予“屏幕录制”和“辅助功能”权限，然后点击“开启共享”。');
-                }
                 await (context.pairingPrinter ?? printPairingCode)(options.dataDir, log, { accessUrl: state.accessUrl, qr: options.qr, interactive: stdoutIsTTY });
             }
             else
@@ -78,6 +76,8 @@ export async function runServiceCommand(options, context) {
             log("✓ AgentRoam service started");
             if (state?.status === "ready" && state.accessUrl)
                 await logAccessUrl(state.accessUrl);
+            if (state?.localUrl && state.status !== "stopped")
+                printLocalDesktopUrl(state.localUrl, log, platform);
             return;
         }
         case "stop":
@@ -95,6 +95,8 @@ export async function runServiceCommand(options, context) {
                 log(`Version: ${status.config.version}`);
                 log(`Root: ${status.config.roots.join(", ")}`);
             }
+            if (status.running && status.state?.localUrl)
+                printLocalDesktopUrl(status.state.localUrl, log, platform);
             if (status.running && status.state?.status === "ready" && status.state.accessUrl) {
                 await logAccessUrl(status.state.accessUrl);
             }
@@ -118,6 +120,8 @@ export async function runServiceCommand(options, context) {
             log("✓ AgentRoam service restarted");
             if (state?.status === "ready" && state.accessUrl)
                 await logAccessUrl(state.accessUrl);
+            if (state?.localUrl && state.status !== "stopped")
+                printLocalDesktopUrl(state.localUrl, log, platform);
             return;
         }
         case "uninstall": {

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

@@ -173,3 +173,16 @@ function options(serviceAction) {
         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);
+});

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.24" },
                     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.24"; ./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.24 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.24",
   "description": "Zero-install mobile remote terminal and file console",
   "type": "module",
   "bin": {
@@ -26,12 +26,12 @@
     "undici": "^6.25.0"
   },
   "optionalDependencies": {
-    "agentroam-runtime-darwin-arm64": "0.2.0-preview.22",
-    "agentroam-runtime-win32-x64": "0.2.0-preview.22",
-    "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",
-    "@caoqu/agentroam-tui-win32-x64": "0.2.0-preview.20"
+    "agentroam-runtime-darwin-arm64": "0.2.0-preview.24",
+    "agentroam-runtime-win32-x64": "0.2.0-preview.24",
+    "agentroam-cloudflared-darwin-arm64": "0.2.0-preview.24",
+    "agentroam-cloudflared-win32-x64": "0.2.0-preview.24",
+    "agentroam-tui-darwin-arm64": "0.2.0-preview.24",
+    "@caoqu/agentroam-tui-win32-x64": "0.2.0-preview.24"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",