agentroam 0.2.0-preview.25 → 0.2.0-preview.26

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.25";
+const RELEASE_VERSION = "0.2.0-preview.26";
 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,6 +1,7 @@
 import { printLocalDesktopUrl } from './local-desktop-url.js';
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
+import { join } from "node:path";
 import { parseArgs } from "./args.js";
 import { ensureCloudflared } from "./cloudflared/installer.js";
 import { resolveCodexRuntime } from "./codex-runtime-manager.js";
@@ -19,6 +20,7 @@ import { currentCliPath, startUpdate } from "./update/update-command.js";
 import { runUpdateWorker } from "./update/update-worker.js";
 import { lockInstanceStartup, stopPreviousInstances } from "./instance-takeover.js";
 import { runUnlockServiceCommand } from "./unlock-service.js";
+import { createCliErrorLog } from "./error-log.js";
 const VERSION = AGENTROAM_VERSION;
 export async function main(argv) {
     if (argv.includes("--help") || argv.includes("-h")) {
@@ -41,6 +43,11 @@ export async function main(argv) {
         return;
     }
     const options = parseArgs(argv);
+    // CLI 进程自身的按天错误日志:<dataDir>/logs/YYYY-MM-DD.log(NDJSON,与
+    // server/desktop 的 core logger 同格式)。uncaughtException 记录后按默认
+    // 语义退出(1),unhandledRejection 只记录。
+    const cliErrorLog = createCliErrorLog(join(options.dataDir, "logs"));
+    cliErrorLog.installGlobalErrorHandlers();
     if (["pair", "devices", "revoke", "approvals", "approve", "deny", "lock", "unlock", "audit"].includes(options.command)) {
         const dataDir = argv.includes("--data-dir") ? options.dataDir : await installedDataDir(options.dataDir);
         if (options.command === "pair")

package/dist/error-log.js

@@ -0,0 +1,113 @@
+import { appendFileSync, existsSync, mkdirSync, readdirSync, statSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+// Self-contained daily error log for the CLI process. The CLI cannot depend
+// on @agent/core (it ships as a thin launcher), so this mirrors the exact
+// NDJSON entry format of core's DailyFileLogger
+// (`{ts, level, source, message, error?, data?}`) into `<dataDir>/logs/`.
+// It records uncaughtException / unhandledRejection so launcher failures are
+// strictly persisted, matching the server/desktop log series.
+const LEVELS = new Set(["debug", "info", "warn", "error", "fatal"]);
+function localDateString(date) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `${y}-${m}-${d}`;
+}
+function serializeError(err) {
+    if (err === undefined || err === null)
+        return undefined;
+    if (err instanceof Error) {
+        const out = { name: err.name, message: err.message };
+        if (err.stack)
+            out.stack = err.stack;
+        return out;
+    }
+    if (typeof err === "object") {
+        const anyErr = err;
+        const out = {
+            name: typeof anyErr.name === "string" ? anyErr.name : "NonError",
+            message: typeof anyErr.message === "string" ? anyErr.message : String(err),
+        };
+        if (typeof anyErr.stack === "string")
+            out.stack = anyErr.stack;
+        return out;
+    }
+    return { name: "NonError", message: String(err) };
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value) ?? "null";
+    }
+    catch {
+        return '"[unserializable]"';
+    }
+}
+export function createCliErrorLog(logsDir) {
+    let reportedWriteFailure = false;
+    const write = (line) => {
+        try {
+            if (!existsSync(logsDir))
+                mkdirSync(logsDir, { recursive: true });
+            appendFileSync(join(logsDir, `${localDateString(new Date())}.log`), line, "utf8");
+        }
+        catch {
+            if (!reportedWriteFailure) {
+                reportedWriteFailure = true;
+                try {
+                    process.stderr.write(`[agentroam] failed to write error log to ${logsDir}; further failures are silent\n`);
+                }
+                catch { /* stderr gone */ }
+            }
+        }
+    };
+    const cleanupOldFiles = () => {
+        // 30-day retention, aligned with the core logger default. Best effort.
+        try {
+            if (!existsSync(logsDir))
+                return;
+            const cutoff = Date.now() - 30 * 24 * 60 * 60 * 1000;
+            for (const name of readdirSync(logsDir)) {
+                if (!/^\d{4}-\d{2}-\d{2}\.log$/.test(name))
+                    continue;
+                const full = join(logsDir, name);
+                try {
+                    if (statSync(full).mtimeMs < cutoff)
+                        unlinkSync(full);
+                }
+                catch { /* concurrent removal */ }
+            }
+        }
+        catch { /* best effort */ }
+    };
+    const log = (level, message, error, data) => {
+        if (!LEVELS.has(level))
+            level = "error";
+        const entry = {
+            ts: new Date().toISOString(),
+            level,
+            source: "cli",
+            message: typeof message === "string" ? message.slice(0, 4000) : String(message),
+        };
+        const serialized = serializeError(error);
+        if (serialized)
+            entry.error = serialized;
+        if (data !== undefined)
+            entry.data = data;
+        write(`${safeStringify(entry)}\n`);
+    };
+    return {
+        log,
+        installGlobalErrorHandlers: (options = {}) => {
+            const exitOnUncaughtException = options.exitOnUncaughtException ?? true;
+            process.on("uncaughtException", (err) => {
+                log("fatal", "uncaughtException", err);
+                if (exitOnUncaughtException)
+                    process.exit(1);
+            });
+            process.on("unhandledRejection", (reason) => {
+                log("error", "unhandledRejection", reason);
+            });
+            cleanupOldFiles();
+        },
+    };
+}

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.25";
+export const AGENTROAM_VERSION = "0.2.0-preview.26";
 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/runtime-manager.js

@@ -36,6 +36,9 @@ export class RuntimeManager {
                 PORT: String(port),
                 HOST: options.localOnly ? "0.0.0.0" : "127.0.0.1",
                 AGENT_DATA_DIR: resolve(dataDir, "data"),
+                // 应用日志收口到 <dataDir>/logs,与 launchd 的 service.stdout/stderr.log
+                // 及 CLI 自身的错误日志同一个目录,用户排障时只需打包这一处。
+                AGENT_LOG_DIR: resolve(dataDir, "logs"),
                 AGENT_WEB_ROOTS: options.roots.join(delimiter),
                 AGENT_TRUST_TUNNEL_PROXY: "1",
                 AGENTROAM_VERSION: resolvePlatformRuntime(target).manifest.packageVersion,

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.25" },
+                    headers: { "user-agent": "agentroam-readiness/0.2.0-preview.26" },
                     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.25"; ./install-agentroam.ps1
+# 例如：$env:AGENTROAM_VERSION = "0.2.0-preview.26"; ./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.25 sh install-agentroam.sh
+# AGENTROAM_VERSION=0.2.0-preview.26 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.25",
+  "version": "0.2.0-preview.26",
   "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.25",
-    "agentroam-runtime-win32-x64": "0.2.0-preview.25",
-    "agentroam-cloudflared-darwin-arm64": "0.2.0-preview.25",
-    "agentroam-cloudflared-win32-x64": "0.2.0-preview.25",
-    "agentroam-tui-darwin-arm64": "0.2.0-preview.25",
-    "@caoqu/agentroam-tui-win32-x64": "0.2.0-preview.25"
+    "agentroam-runtime-darwin-arm64": "0.2.0-preview.26",
+    "agentroam-runtime-win32-x64": "0.2.0-preview.26",
+    "agentroam-cloudflared-darwin-arm64": "0.2.0-preview.26",
+    "agentroam-cloudflared-win32-x64": "0.2.0-preview.26",
+    "agentroam-tui-darwin-arm64": "0.2.0-preview.26",
+    "@caoqu/agentroam-tui-win32-x64": "0.2.0-preview.26"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",