agentroam 0.2.0-preview.23 → 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.23";
+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/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.23";
+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.23" },
+                    headers: { "user-agent": "agentroam-readiness/0.2.0-preview.24" },
                     signal: options.signal,
                 });
                 if (response.ok) {

package/install/install-agentroam.ps1

@@ -4,7 +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
+# 例如：$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.23 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.23",
+  "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.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",
-    "@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",