agentroam 0.2.0-preview.11 → 0.2.0-preview.13

package/README.md

@@ -20,20 +20,20 @@ npx agentroam@preview
 Or install from tarball:
 
 ```bash
-npm install ./agentroam-cloudflared-darwin-arm64-0.2.0-preview.11.tgz \
-  ./agentroam-runtime-darwin-arm64-0.2.0-preview.11.tgz \
-  ./agentroam-tui-darwin-arm64-0.2.0-preview.11.tgz \
-  ./agentroam-0.2.0-preview.11.tgz
+npm install ./agentroam-cloudflared-darwin-arm64-0.2.0-preview.13.tgz \
+  ./agentroam-runtime-darwin-arm64-0.2.0-preview.13.tgz \
+  ./agentroam-tui-darwin-arm64-0.2.0-preview.13.tgz \
+  ./agentroam-0.2.0-preview.13.tgz
 npx agentroam
 ```
 
 Windows PowerShell:
 
 ```powershell
-npm install ./agentroam-cloudflared-win32-x64-0.2.0-preview.11.tgz `
-  ./agentroam-runtime-win32-x64-0.2.0-preview.11.tgz `
-  ./caoqu-agentroam-tui-win32-x64-0.2.0-preview.11.tgz `
-  ./agentroam-0.2.0-preview.11.tgz
+npm install ./agentroam-cloudflared-win32-x64-0.2.0-preview.13.tgz `
+  ./agentroam-runtime-win32-x64-0.2.0-preview.13.tgz `
+  ./caoqu-agentroam-tui-win32-x64-0.2.0-preview.13.tgz `
+  ./agentroam-0.2.0-preview.13.tgz
 npx agentroam
 ```
 

package/bin/node-preflight.mjs

@@ -7,7 +7,7 @@ import { promisify } from "node:util";
 
 const execFileAsync = promisify(execFile);
 const MANAGED_NODE_VERSION = "22.22.0";
-const RELEASE_VERSION = "0.2.0-preview.11";
+const RELEASE_VERSION = "0.2.0-preview.13";
 const RELEASE_BASE_URL = `https://gitee.com/caoqu/team-agent/releases/download/v${RELEASE_VERSION}`;
 const FORWARDED_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
 

package/dist/cloudflared/bundled-asset.test.js

@@ -2,6 +2,7 @@ import { mkdtemp, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { resolve } from "node:path";
 import { describe, expect, it } from "vitest";
+import { AGENTROAM_VERSION } from "../platform-packages.js";
 import { resolveBundledCloudflared } from "./bundled-asset.js";
 describe("resolveBundledCloudflared", () => {
     it("resolves a valid platform package manifest and archive", async () => {
@@ -10,7 +11,7 @@ describe("resolveBundledCloudflared", () => {
         const archivePath = resolve(root, "cloudflared.tgz");
         await writeFile(archivePath, "archive");
         await writeFile(manifestPath, JSON.stringify({
-            packageVersion: "0.2.0-preview.11",
+            packageVersion: AGENTROAM_VERSION,
             upstreamVersion: "2026.8.2",
             target: "darwin-arm64",
             assetFormat: "tgz",
@@ -51,7 +52,7 @@ describe("resolveBundledCloudflared", () => {
         const assetPath = resolve(root, "cloudflared.exe");
         await writeFile(assetPath, "binary");
         await writeFile(manifestPath, JSON.stringify({
-            packageVersion: "0.2.0-preview.11",
+            packageVersion: AGENTROAM_VERSION,
             upstreamVersion: "2026.8.2",
             target: "windows-amd64",
             assetFormat: "executable",

package/dist/codex-runtime-manager.js

@@ -7,8 +7,10 @@ const execFileAsync = promisify(execFile);
 export const CODEX_RUNTIME_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;
 const DEFAULT_LOCK_WAIT_MS = 190_000;
-const DEFAULT_STALE_LOCK_MS = 5 * 60_000;
+export const CODEX_INSTALL_STALE_LOCK_MS = CODEX_INSTALL_TIMEOUT_MS + 5 * 60_000;
+const DEFAULT_STALE_LOCK_MS = CODEX_INSTALL_STALE_LOCK_MS;
 const defaultDependencies = {
     async run(command, args, timeoutMs) {
         try {
@@ -176,7 +178,7 @@ async function installManagedCodex(options) {
             "--prefix",
             temporaryRoot,
             CODEX_PACKAGE,
-        ], 180_000);
+        ], CODEX_INSTALL_TIMEOUT_MS);
         const temporary = await validateManagedRuntime(temporaryRoot, options.target, options.platform, options.dependencies);
         if (!temporary) {
             throw new Error(`Codex runtime validation failed after installing ${CODEX_PACKAGE}`);

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

@@ -2,7 +2,7 @@ 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_RUNTIME_VERSION, managedCodexBinaryCandidates, parseCodexVersion, resolveCodexRuntime, resolveNpmExecutor, } from "./codex-runtime-manager.js";
+import { CODEX_INSTALL_STALE_LOCK_MS, CODEX_INSTALL_TIMEOUT_MS, CODEX_RUNTIME_VERSION, 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 })));
@@ -69,13 +69,14 @@ describe("managed Codex runtime", () => {
         const root = await temporaryRoot();
         const npmExecPath = await fakeExecutable(resolve(root, "npm-cli.js"));
         let installs = 0;
-        const run = vi.fn(async (command, args) => {
+        const run = vi.fn(async (command, args, timeoutMs) => {
             if (command === "/test/node" && args.includes("install")) {
                 installs += 1;
                 const prefix = args[args.indexOf("--prefix") + 1];
                 await fakeExecutable(managedCodexBinaryCandidates(prefix, "darwin-arm64")[0]);
                 expect(args).toContain("@openai/codex@0.153.0");
                 expect(args).toContain("--registry=https://registry.npmjs.org");
+                expect(timeoutMs).toBe(60 * 60_000);
                 return { stdout: "installed", stderr: "" };
             }
             return {
@@ -92,6 +93,7 @@ describe("managed Codex runtime", () => {
             dependencies: { run },
         });
         expect(installs).toBe(1);
+        expect(CODEX_INSTALL_STALE_LOCK_MS).toBeGreaterThan(CODEX_INSTALL_TIMEOUT_MS);
         expect(resolution.executable).toContain(`/runtimes/codex/${CODEX_RUNTIME_VERSION}/`);
         expect(resolution.source).toBe("managed");
     });

package/dist/platform-packages.js

@@ -1,7 +1,7 @@
 import { readFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname } from "node:path";
-export const AGENTROAM_VERSION = "0.2.0-preview.11";
+export const AGENTROAM_VERSION = "0.2.0-preview.13";
 export const PLATFORM_PACKAGES = {
     "darwin-arm64": {
         runtime: "agentroam-runtime-darwin-arm64",

package/dist/service/service-command.js

@@ -1,11 +1,20 @@
 import { delimiter, dirname, isAbsolute, resolve, win32 } from "node:path";
 import { resolveCodexRuntime } from "../codex-runtime-manager.js";
 import { detectPlatform } from "../platform.js";
+import { renderQr } from "../qr.js";
 import { MacLaunchAgent } from "./macos-launch-agent.js";
 import { WindowsTaskService } from "./windows-task-service.js";
 export async function runServiceCommand(options, context) {
     const platform = context.platform ?? process.platform;
     const log = context.log ?? console.log;
+    const stdoutIsTTY = context.isTTY ?? process.stdout.isTTY === true;
+    const logAccessUrl = async (accessUrl) => {
+        log(`Open: ${accessUrl}`);
+        if (!options.qr || !stdoutIsTTY)
+            return;
+        log("");
+        log(await renderQr(accessUrl));
+    };
     const controller = context.controller ?? context.launchAgent ?? createController(platform, context.homeDir);
     switch (options.serviceAction) {
         case "install": {
@@ -49,7 +58,7 @@ export async function runServiceCommand(options, context) {
             const { definition, state } = await controller.install(config);
             log(`✓ AgentRoam service installed: ${definition}`);
             if (state?.status === "ready" && state.accessUrl)
-                log(`Open: ${state.accessUrl}`);
+                await logAccessUrl(state.accessUrl);
             else
                 log("Service is starting. Run `agentroam service url` shortly.");
             return;
@@ -58,7 +67,7 @@ export async function runServiceCommand(options, context) {
             const state = await controller.start();
             log("✓ AgentRoam service started");
             if (state?.status === "ready" && state.accessUrl)
-                log(`Open: ${state.accessUrl}`);
+                await logAccessUrl(state.accessUrl);
             return;
         }
         case "stop":
@@ -77,7 +86,7 @@ export async function runServiceCommand(options, context) {
                 log(`Root: ${status.config.roots.join(", ")}`);
             }
             if (status.running && status.state?.status === "ready" && status.state.accessUrl) {
-                log(`Open: ${status.state.accessUrl}`);
+                await logAccessUrl(status.state.accessUrl);
             }
             return;
         }
@@ -98,7 +107,7 @@ export async function runServiceCommand(options, context) {
             const state = await controller.restart();
             log("✓ AgentRoam service restarted");
             if (state?.status === "ready" && state.accessUrl)
-                log(`Open: ${state.accessUrl}`);
+                await logAccessUrl(state.accessUrl);
             return;
         }
         case "uninstall": {

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

@@ -33,6 +33,48 @@ describe("runServiceCommand", () => {
         }));
         expect(log).toHaveBeenCalledWith("Open: https://ready.example/web");
     });
+    it("prints a scannable QR code after the URL on interactive terminals", async () => {
+        const log = vi.fn();
+        await runServiceCommand({ ...options("start"), qr: true }, {
+            platform: "darwin",
+            nodePath: "/node",
+            cliPath: "/agentroam.mjs",
+            version: "test",
+            isTTY: true,
+            log,
+            controller: controller({ start: vi.fn(async () => ({ status: "ready", accessUrl: "https://ready.example/web" })) }),
+        });
+        const openIndex = log.mock.calls.findIndex(([line]) => line === "Open: https://ready.example/web");
+        expect(openIndex).toBeGreaterThanOrEqual(0);
+        const qr = log.mock.calls[openIndex + 2]?.[0];
+        expect(qr).toMatch(/[▀▄█]/);
+        expect(qr).toContain("\n");
+    });
+    it("keeps service output QR-free when piped or when --no-qr is set", async () => {
+        const log = vi.fn();
+        const start = vi.fn(async () => ({ status: "ready", accessUrl: "https://ready.example/web" }));
+        await runServiceCommand({ ...options("start"), qr: true }, {
+            platform: "darwin",
+            nodePath: "/node",
+            cliPath: "/agentroam.mjs",
+            version: "test",
+            isTTY: false,
+            log,
+            controller: controller({ start }),
+        });
+        await runServiceCommand(options("start"), {
+            platform: "darwin",
+            nodePath: "/node",
+            cliPath: "/agentroam.mjs",
+            version: "test",
+            isTTY: true,
+            log,
+            controller: controller({ start }),
+        });
+        const lines = log.mock.calls.map(([line]) => line);
+        expect(lines).toContain("Open: https://ready.example/web");
+        expect(lines.some((line) => /[▀▄█]/.test(String(line)))).toBe(false);
+    });
     it("pins the selected Node directory ahead of the inherited service PATH", () => {
         expect(buildServiceEnvironmentPath("/Users/test/.nvm/versions/node/v22.22.2/bin/node", "/usr/bin:/Users/test/.nvm/versions/node/v22.22.2/bin", "darwin")).toBe("/Users/test/.nvm/versions/node/v22.22.2/bin:/usr/bin:/bin:/usr/sbin:/sbin");
     });

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

package/install/README.md

@@ -5,7 +5,7 @@ These versioned installers support macOS Apple Silicon and Windows x64. They reu
 ## macOS Apple Silicon
 
 ```sh
-curl -fsSL https://gitee.com/caoqu/team-agent/releases/download/v0.2.0-preview.11/install-agentroam.sh | sh
+curl -fsSL https://gitee.com/caoqu/team-agent/releases/download/v0.2.0-preview.13/install-agentroam.sh | sh
 ```
 
 The command installs the wrapper at `~/.local/bin/agentroam`. If that directory is not already in `PATH`, the installer prints the required shell setting without editing shell profiles.
@@ -13,7 +13,7 @@ The command installs the wrapper at `~/.local/bin/agentroam`. If that directory
 ## Windows x64
 
 ```powershell
-irm https://gitee.com/caoqu/team-agent/releases/download/v0.2.0-preview.11/install-agentroam.ps1 | iex
+irm https://gitee.com/caoqu/team-agent/releases/download/v0.2.0-preview.13/install-agentroam.ps1 | iex
 ```
 
 The command installs `%USERPROFILE%\.agentroam\bin\agentroam.cmd` and adds only that user directory to the user-level `PATH`. It does not require administrator access or change the machine-level `PATH`.
@@ -24,6 +24,8 @@ Run the installer from the project directory AgentRoam should expose, or set `AG
 
 The installer registers and starts the service after Node, CLI, and `doctor` validation. When a previous AgentRoam user service is installed, the new CLI stops it, waits for its process and platform registration to exit, removes only the old service registration, and then registers the replacement. Session data, pairing state, managed runtimes, and logs remain in the data directory. While foreground AgentRoam or the service is running, it prevents idle system sleep but still allows the display to dim and turn off. Lid close, explicit sleep, hibernation, shutdown, and low-battery forced sleep remain controlled by the operating system.
 
+On interactive terminals, `service install`, `start`, `status`, and `restart` print a scannable QR code beside the `Open:` URL. Piped or redirected output stays plain text, and `agentroam service install --no-qr` suppresses the code. `service url` always prints only the raw URL for scripting.
+
 Use the installer for first installation, upgrades, and repair. Use these commands for routine control:
 
 ```text
@@ -38,7 +40,7 @@ agentroam service uninstall
 
 ## Data and updates
 
-Set `AGENTROAM_DATA_DIR` before running either installer to override the default `~/.agentroam` data directory. Node is stored at `<data-dir>/runtimes/node/22.22.0`, and the launcher is stored at `<data-dir>/launcher/0.2.0-preview.11`.
+Set `AGENTROAM_DATA_DIR` before running either installer to override the default `~/.agentroam` data directory. Node is stored at `<data-dir>/runtimes/node/22.22.0`, and the launcher is stored at `<data-dir>/launcher/0.2.0-preview.13`.
 
 Each AgentRoam release pins its own Node patch and installer assets. Updates happen only by running a newer versioned installer or installing a newer AgentRoam release; startup never follows a moving Node.js release channel.
 

package/install/install-agentroam.ps1

@@ -2,7 +2,7 @@ $ErrorActionPreference = "Stop"
 $ProgressPreference = "SilentlyContinue"
 
 $NodeVersion = "22.22.0"
-$AgentRoamVersion = "0.2.0-preview.11"
+$AgentRoamVersion = "0.2.0-preview.13"
 $NodeArchive = "node-v22.22.0-win-x64.zip"
 $NodeSha256 = "c97fa376d2becdc8863fcd3ca2dd9a83a9f3468ee7ccf7a6d076ec66a645c77a"
 $NodeUrl = "https://nodejs.org/dist/v22.22.0/$NodeArchive"

package/install/install-agentroam.sh

@@ -2,7 +2,7 @@
 set -eu
 
 NODE_VERSION="22.22.0"
-AGENTROAM_VERSION="0.2.0-preview.11"
+AGENTROAM_VERSION="0.2.0-preview.13"
 NODE_ARCHIVE="node-v22.22.0-darwin-arm64.tar.xz"
 NODE_SHA256="2bd596bbfc4a275ceb8721a5954ee97daea5ebe673e96a185ebd732f6fb023ac"
 NODE_URL="https://nodejs.org/dist/v22.22.0/$NODE_ARCHIVE"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentroam",
-  "version": "0.2.0-preview.11",
+  "version": "0.2.0-preview.13",
   "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.11",
-    "agentroam-runtime-win32-x64": "0.2.0-preview.11",
-    "agentroam-cloudflared-darwin-arm64": "0.2.0-preview.11",
-    "agentroam-cloudflared-win32-x64": "0.2.0-preview.11",
-    "agentroam-tui-darwin-arm64": "0.2.0-preview.11",
-    "@caoqu/agentroam-tui-win32-x64": "0.2.0-preview.11"
+    "agentroam-runtime-darwin-arm64": "0.2.0-preview.13",
+    "agentroam-runtime-win32-x64": "0.2.0-preview.13",
+    "agentroam-cloudflared-darwin-arm64": "0.2.0-preview.13",
+    "agentroam-cloudflared-win32-x64": "0.2.0-preview.13",
+    "agentroam-tui-darwin-arm64": "0.2.0-preview.13",
+    "@caoqu/agentroam-tui-win32-x64": "0.2.0-preview.13"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",