@rynx-ai/cli 0.1.11-beta.2 → 0.1.11-beta.20

package/dist/app-runtime.d.ts

@@ -0,0 +1,10 @@
+export interface CliDependencyVersions {
+    cliVersion: string;
+    daemonVersion: string;
+}
+/** Read the versions in the dependency closure owned by this CLI installation. */
+export declare function resolveCliDependencyVersions(): CliDependencyVersions;
+/** Resolve the CLI-owned process entry used exclusively by Rynx App. */
+export declare function resolveCliAppRuntimeEntry(moduleUrl?: string): string;
+/** Run the App-owned daemon in this dedicated CLI App Runtime process. */
+export declare function runAppRuntimeProcess(): Promise<void>;

package/dist/app-runtime.js

@@ -0,0 +1,34 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { installedDaemonVersion } from "@rynx-ai/daemon/entry-path";
+import { installedVersion } from "./version.js";
+/** Read the versions in the dependency closure owned by this CLI installation. */
+export function resolveCliDependencyVersions() {
+    return {
+        cliVersion: installedVersion(),
+        daemonVersion: installedDaemonVersion(),
+    };
+}
+/** Resolve the CLI-owned process entry used exclusively by Rynx App. */
+export function resolveCliAppRuntimeEntry(moduleUrl = import.meta.url) {
+    return fileURLToPath(moduleUrl);
+}
+/** Run the App-owned daemon in this dedicated CLI App Runtime process. */
+export async function runAppRuntimeProcess() {
+    if (process.env.RYNX_DISTRIBUTION !== "app") {
+        throw new Error("CLI App Runtime requires RYNX_DISTRIBUTION=app");
+    }
+    if (process.env.RYNX_DAEMON_LIFECYCLE !== "follow-app" &&
+        process.env.RYNX_DAEMON_LIFECYCLE !== "resident") {
+        throw new Error("CLI App Runtime requires an App daemon lifecycle");
+    }
+    const { runDaemonProcess } = await import("@rynx-ai/daemon/internal/process");
+    await runDaemonProcess();
+}
+if (process.argv[1] &&
+    path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url))) {
+    runAppRuntimeProcess().catch((error) => {
+        console.error(error instanceof Error ? error.stack ?? error.message : String(error));
+        process.exitCode = 1;
+    });
+}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-export { callManagedRuntimeBrowser, callResidentRuntime, cancelResidentPluginInstallation, commitResidentPluginInstallation, cleanResidentBrowserArtifacts, cleanupResidentSessions, createResidentRemoteRuntimePairingOffer, ensureResidentDaemon, forgetResidentRuntimeTarget, getResidentChromeInspectionStatus, getResidentDaemonIdentity, getResidentDaemonRuntimeStatus, getResidentBrowserArtifactVersion, getResidentRuntimeLocalBrowserEndpoint, invokeResidentPluginCommand, installResidentBrowserArtifact, listResidentPlugins, listResidentRemoteRuntimeClients, listResidentRuntimeTargets, pairResidentRuntimeTarget, prepareResidentPluginInstallation, readManagedRuntimeBrowserCredential, readOptionalManagedRuntimeBrowserCredential, revokeResidentRemoteRuntimeClient, setResidentPluginEnabled, shutdownResidentDaemonIfIdle, configureResidentChromeInspection, testResidentRuntimeTarget, uninstallResidentPlugin, updateResidentBrowserArtifact, connectResidentDesktopBrowserHost, ResidentRuntimeCallError, type InvokeResidentPluginCommandOptions, type ResidentDaemon, type ResidentDaemonIdentity, type ResidentDesktopBrowserHostCommandRequest, type ResidentDesktopBrowserHostConnectOptions, type ResidentDesktopBrowserHostConnection, type ResidentDesktopBrowserHostFailure, type ResidentPluginCommandResult, type ResidentPluginManagementItem, type ResidentPluginManagementState, type ResidentRemoteRuntimeClientGrant, type ResidentRuntimeCallErrorCode, type ResidentRuntimeCallOutcome, type ResidentRuntimeTargetTestResult, type ResidentRuntimeTargetView, } from "./control-client.js";
+export { callManagedRuntimeBrowser, callResidentRuntime, cancelResidentPluginInstallation, commitResidentPluginInstallation, cleanupResidentSessions, createResidentRemoteRuntimePairingOffer, forgetResidentRuntimeTarget, getResidentChromeInspectionStatus, getResidentDaemonIdentity, getResidentDaemonRuntimeStatus, getResidentRuntimeLocalBrowserEndpoint, invokeResidentPluginCommand, listResidentPlugins, listResidentRemoteRuntimeClients, listResidentRuntimeTargets, pairResidentRuntimeTarget, prepareResidentPluginInstallation, readManagedRuntimeBrowserCredential, readOptionalManagedRuntimeBrowserCredential, revokeResidentRemoteRuntimeClient, setResidentPluginEnabled, shutdownResidentDaemonIfIdle, configureResidentChromeInspection, testResidentRuntimeTarget, uninstallResidentPlugin, connectResidentDesktopBrowserHost, ResidentRuntimeCallError, type InvokeResidentPluginCommandOptions, type ResidentDaemonIdentity, type ResidentDesktopBrowserHostCommandRequest, type ResidentDesktopBrowserHostConnectOptions, type ResidentDesktopBrowserHostConnection, type ResidentDesktopBrowserHostFailure, type ResidentPluginCommandResult, type ResidentPluginManagementItem, type ResidentPluginManagementState, type ResidentRemoteRuntimeClientGrant, type ResidentRuntimeCallErrorCode, type ResidentRuntimeCallOutcome, type ResidentRuntimeTargetTestResult, type ResidentRuntimeTargetView, } from "./control-client.js";
 export type { DaemonChromeInspectionConfigureInput, DaemonChromeInspectionStatus, } from "@rynx-ai/protocol/control";
 export type { PluginInstallCommitInput, PluginInstallCommitResult, PluginInstallPreparation, PluginInstallPrepareInput, } from "@rynx-ai/protocol/plugin-management";
 export { ensureDaemonControlEndpoint, resolveDaemonControlEndpoint, type DaemonControlEndpoint, type ResolveDaemonControlEndpointOptions, } from "./control-endpoint.js";

package/dist/client.js

@@ -1,2 +1,2 @@
-export { callManagedRuntimeBrowser, callResidentRuntime, cancelResidentPluginInstallation, commitResidentPluginInstallation, cleanResidentBrowserArtifacts, cleanupResidentSessions, createResidentRemoteRuntimePairingOffer, ensureResidentDaemon, forgetResidentRuntimeTarget, getResidentChromeInspectionStatus, getResidentDaemonIdentity, getResidentDaemonRuntimeStatus, getResidentBrowserArtifactVersion, getResidentRuntimeLocalBrowserEndpoint, invokeResidentPluginCommand, installResidentBrowserArtifact, listResidentPlugins, listResidentRemoteRuntimeClients, listResidentRuntimeTargets, pairResidentRuntimeTarget, prepareResidentPluginInstallation, readManagedRuntimeBrowserCredential, readOptionalManagedRuntimeBrowserCredential, revokeResidentRemoteRuntimeClient, setResidentPluginEnabled, shutdownResidentDaemonIfIdle, configureResidentChromeInspection, testResidentRuntimeTarget, uninstallResidentPlugin, updateResidentBrowserArtifact, connectResidentDesktopBrowserHost, ResidentRuntimeCallError, } from "./control-client.js";
+export { callManagedRuntimeBrowser, callResidentRuntime, cancelResidentPluginInstallation, commitResidentPluginInstallation, cleanupResidentSessions, createResidentRemoteRuntimePairingOffer, forgetResidentRuntimeTarget, getResidentChromeInspectionStatus, getResidentDaemonIdentity, getResidentDaemonRuntimeStatus, getResidentRuntimeLocalBrowserEndpoint, invokeResidentPluginCommand, listResidentPlugins, listResidentRemoteRuntimeClients, listResidentRuntimeTargets, pairResidentRuntimeTarget, prepareResidentPluginInstallation, readManagedRuntimeBrowserCredential, readOptionalManagedRuntimeBrowserCredential, revokeResidentRemoteRuntimeClient, setResidentPluginEnabled, shutdownResidentDaemonIfIdle, configureResidentChromeInspection, testResidentRuntimeTarget, uninstallResidentPlugin, connectResidentDesktopBrowserHost, ResidentRuntimeCallError, } from "./control-client.js";
 export { ensureDaemonControlEndpoint, resolveDaemonControlEndpoint, } from "./control-endpoint.js";

package/dist/commands/app-distribution.d.ts

@@ -1,6 +1,6 @@
 export declare function shouldUseAppDistributionCommand(command: string | undefined, env?: NodeJS.ProcessEnv): boolean;
 /**
- * Prevent the App launcher from falling through to the compatibility daemon
- * CLI and accidentally creating or inspecting a PM2-owned second lifecycle.
+ * Prevent the App launcher from falling through to standalone lifecycle
+ * commands and accidentally creating or inspecting a PM2-owned second owner.
  */
 export declare function runAppDistributionCommand(command: string, args: readonly string[]): Promise<number>;

package/dist/commands/app-distribution.js

@@ -4,7 +4,6 @@ import { rynxHome } from "@rynx-ai/core";
 import { resolveDaemonControlEndpoint } from "../control-endpoint.js";
 import { fail } from "./errors.js";
 const APP_ONLY_COMMANDS = new Set([
-    "setup",
     "update",
     "start",
     "restart",
@@ -19,8 +18,8 @@ export function shouldUseAppDistributionCommand(command, env = process.env) {
         && env.RYNX_DISTRIBUTION === "app";
 }
 /**
- * Prevent the App launcher from falling through to the compatibility daemon
- * CLI and accidentally creating or inspecting a PM2-owned second lifecycle.
+ * Prevent the App launcher from falling through to standalone lifecycle
+ * commands and accidentally creating or inspecting a PM2-owned second owner.
  */
 export async function runAppDistributionCommand(command, args) {
     const json = args.includes("--json");
@@ -44,9 +43,6 @@ export async function runAppDistributionCommand(command, args) {
         printRecentDaemonLogs();
         return 0;
     }
-    if (command === "setup") {
-        fail("Rynx App setup is completed in its onboarding and Desktop Settings.");
-    }
     if (command === "update") {
         fail("Rynx App updates are managed from Rynx > Check for Updates.");
     }

package/dist/commands/browser.js

@@ -3,7 +3,8 @@ import path from "node:path";
 import { connectBrowserAutomation, } from "@rynx-ai/browser-cdp";
 import WebSocket from "ws";
 import { parseBrowserCliArgs, resolveBrowserCliTarget, } from "../browser-cli-args.js";
-import { callManagedRuntimeBrowser, callResidentRuntime, cleanResidentBrowserArtifacts, getResidentBrowserArtifactVersion, getResidentRuntimeLocalBrowserAutomationAccess, getResidentRuntimeLocalBrowserEndpoint, installResidentBrowserArtifact, readOptionalManagedRuntimeBrowserCredential, updateResidentBrowserArtifact, } from "../control-client.js";
+import { callManagedRuntimeBrowser, callResidentRuntime, getResidentRuntimeLocalBrowserAutomationAccess, getResidentRuntimeLocalBrowserEndpoint, readOptionalManagedRuntimeBrowserCredential, } from "../control-client.js";
+import { createProgressDisplay } from "../progress-display.js";
 import { fail } from "./errors.js";
 export async function runBrowserCommand(args) {
     let parsed;
@@ -18,9 +19,20 @@ export async function runBrowserCommand(args) {
             fail("browser install: choose either --version or --channel");
         }
         const channel = browserReleaseChannel(parsed.channel);
-        const result = parsed.subcommand === "install"
-            ? await installResidentBrowserArtifact(parsed.version ? { version: parsed.version } : { channel })
-            : await updateResidentBrowserArtifact({ channel });
+        const { createBrowserArtifactManagementService } = await import("@rynx-ai/daemon/browser-artifacts");
+        const artifacts = createBrowserArtifactManagementService();
+        const progress = parsed.json ? undefined : createProgressDisplay();
+        progress?.start(parsed.subcommand === "install" ? "正在安装 Rynx Browser" : "正在更新 Rynx Browser");
+        let result;
+        try {
+            result = parsed.subcommand === "install"
+                ? await artifacts.install(parsed.version ? { version: parsed.version } : { channel }, progress ? { onProgress: (message) => progress.update(message) } : {})
+                : await artifacts.update({ channel }, progress ? { onProgress: (message) => progress.update(message) } : {});
+        }
+        catch (error) {
+            progress?.clear();
+            throw error;
+        }
         if (parsed.json) {
             console.log(JSON.stringify({
                 resolved: result.resolved,
@@ -28,14 +40,13 @@ export async function runBrowserCommand(args) {
             }, null, 2));
         }
         else {
-            for (const message of result.messages)
-                console.log(message);
-            console.log(`Active Browser engine: Chrome for Testing ${result.installed.version}.`);
+            progress.succeed(`Rynx Browser 已就绪：Chrome for Testing ${result.installed.version}`);
         }
         return 0;
     }
     if (parsed.subcommand === "version") {
-        const { installed } = await getResidentBrowserArtifactVersion();
+        const { createBrowserArtifactManagementService } = await import("@rynx-ai/daemon/browser-artifacts");
+        const { installed } = createBrowserArtifactManagementService().version();
         if (parsed.json)
             console.log(JSON.stringify({ installed }, null, 2));
         else if (installed) {
@@ -47,7 +58,8 @@ export async function runBrowserCommand(args) {
         return 0;
     }
     if (parsed.subcommand === "clean") {
-        const result = await cleanResidentBrowserArtifacts();
+        const { createBrowserArtifactManagementService } = await import("@rynx-ai/daemon/browser-artifacts");
+        const result = createBrowserArtifactManagementService().clean();
         if (parsed.json)
             console.log(JSON.stringify(result, null, 2));
         else if (result.removedBuilds.length === 0) {

package/dist/commands/lifecycle.d.ts

@@ -0,0 +1 @@
+export declare function runLifecycleCommand(command: string, args: readonly string[]): Promise<number>;

package/dist/commands/lifecycle.js

@@ -0,0 +1,21 @@
+import { startStandaloneDaemon, statusStandaloneDaemon, stopStandaloneDaemon, streamStandaloneDaemonLogs, } from "../standalone.js";
+import { fail } from "./errors.js";
+export async function runLifecycleCommand(command, args) {
+    if (args.length > 0)
+        fail(`${command}: unexpected argument ${args[0]}`);
+    switch (command) {
+        case "start":
+            return startStandaloneDaemon();
+        case "restart":
+            return startStandaloneDaemon({ restart: true });
+        case "stop":
+            return stopStandaloneDaemon();
+        case "status":
+            return statusStandaloneDaemon();
+        case "logs":
+            await streamStandaloneDaemonLogs();
+            return 0;
+        default:
+            fail(`unknown lifecycle command: ${command}`);
+    }
+}

package/dist/commands/plugin.js

@@ -1,14 +1,25 @@
 import { createInterface } from "node:readline/promises";
-import { cancelResidentPluginInstallation, commitResidentPluginInstallation, invokeResidentPluginCommand, listResidentPlugins, prepareResidentPluginInstallation, setResidentPluginEnabled, uninstallResidentPlugin, } from "../control-client.js";
+import { cancelResidentPluginInstallation, commitResidentPluginInstallation, prepareResidentPluginInstallation, setResidentPluginEnabled, uninstallResidentPlugin, } from "../control-client.js";
 import { fail } from "./errors.js";
-const PLUGIN_STDIN_MAX_BYTES = 256 * 1024;
 const PLUGIN_DIGEST_PATTERN = /^sha256-[A-Za-z0-9+/]{43}={0,2}$/;
 const CANONICAL_PLUGIN_ID_PATTERN = /^[a-z][a-z0-9-]{0,62}@[a-z0-9][a-z0-9-]{0,62}(?:\/[a-z0-9][a-z0-9._-]{0,99})?$/;
+const PLUGIN_USAGE = `Usage: rynx plugin <command|plugin-id>
+
+Management:
+  list
+  install <source|plugin@market> [--force] [--expect-digest <sha256-...>]
+  update <plugin@market> [--expect-digest <sha256-...>]
+  enable|disable|uninstall <plugin@market>
+
+Plugin commands:
+  <plugin-id> <command> [args...]
+  <plugin-id> --help`;
 export async function runPluginManageCommand(args, options = {}) {
     const [subcommand, pluginId] = args;
     switch (subcommand) {
         case "list": {
-            const plugins = await listResidentPlugins();
+            const { listInstalledPlugins } = await import("@rynx-ai/daemon/plugin-cli");
+            const plugins = listInstalledPlugins();
             console.log("Plugins");
             if (plugins.length === 0) {
                 console.log("  (none)");
@@ -126,23 +137,50 @@ export async function runPluginCommand(args) {
     const [pluginId, command] = args;
     if (!pluginId)
         fail("plugin: missing plugin id");
+    if (pluginId === "--help" || pluginId === "-h" || pluginId === "help") {
+        console.log(PLUGIN_USAGE);
+        return 0;
+    }
     if (["list", "install", "update", "uninstall", "enable", "disable"].includes(pluginId)) {
         return runPluginManageCommand(args);
     }
     if (!command)
         fail(`plugin ${pluginId}: missing command`);
-    const stdin = process.stdin.isTTY
-        ? undefined
-        : await readStdinBounded(PLUGIN_STDIN_MAX_BYTES);
-    const result = await invokeResidentPluginCommand(pluginId, args.slice(1), stdin === undefined ? {} : { stdin });
-    if (result.stdout)
-        process.stdout.write(result.stdout);
-    if (result.stderr)
-        process.stderr.write(result.stderr);
-    if (result.truncated) {
-        process.stderr.write("rynx: plugin command output was truncated by the daemon\n");
+    const pluginCli = await import("@rynx-ai/daemon/plugin-cli");
+    if (command === "--help" || command === "-h") {
+        console.log(pluginCli.installedPluginCommandUsage(pluginId));
+        return 0;
+    }
+    return runPluginCliWithForwardedSignals((signal) => pluginCli.runPluginCliCommand(pluginId, args.slice(1), {
+        stdio: "inherit",
+        signal,
+    }));
+}
+async function runPluginCliWithForwardedSignals(run) {
+    const controller = new AbortController();
+    let interruptedBy;
+    const interrupt = (signal) => {
+        interruptedBy ??= signal;
+        if (!controller.signal.aborted) {
+            controller.abort(new Error(`plugin command interrupted by ${signal}`));
+        }
+    };
+    const onSigint = () => interrupt("SIGINT");
+    const onSigterm = () => interrupt("SIGTERM");
+    process.on("SIGINT", onSigint);
+    process.on("SIGTERM", onSigterm);
+    try {
+        return (await run(controller.signal)).code;
+    }
+    catch (error) {
+        if (interruptedBy)
+            return interruptedBy === "SIGINT" ? 130 : 143;
+        throw error;
+    }
+    finally {
+        process.off("SIGINT", onSigint);
+        process.off("SIGTERM", onSigterm);
     }
-    return result.code;
 }
 function parseInstallationArgs(operation, args) {
     const target = args[0];
@@ -219,15 +257,3 @@ async function confirmInTerminal(message) {
         prompt.close();
     }
 }
-async function readStdinBounded(maxBytes) {
-    const chunks = [];
-    let bytes = 0;
-    for await (const chunk of process.stdin) {
-        const value = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-        bytes += value.byteLength;
-        if (bytes > maxBytes)
-            fail(`plugin stdin exceeds ${maxBytes} bytes`);
-        chunks.push(value);
-    }
-    return Buffer.concat(chunks, bytes).toString("utf8");
-}

package/dist/commands/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function runSetupCommand(args: readonly string[]): Promise<number>;
+export declare function runDoctorCommand(args: readonly string[]): Promise<number>;

package/dist/commands/setup.js

@@ -0,0 +1,363 @@
+import { spawnSync } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, openSync, closeSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import path from "node:path";
+import * as prompts from "@clack/prompts";
+import { AGENT_RUNTIME_IDS, getRuntimeProfile, loadConfig, rynxConfigFile, } from "@rynx-ai/core";
+import { inspectDaemonDiagnostics, inspectSystemDependencies, prepareBundledPlugins, } from "@rynx-ai/daemon/setup-service";
+import { BUNDLED_TMUX_UNAVAILABLE_MESSAGE, resolveBundledTmux, } from "@rynx-ai/tmux";
+import { createProgressDisplay } from "../progress-display.js";
+import { fail } from "./errors.js";
+export async function runSetupCommand(args) {
+    const options = parseSetupOptions(args);
+    const progress = options.json ? undefined : createProgressDisplay();
+    const interactive = !options.nonInteractive &&
+        !options.hasConfigurationArguments &&
+        Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    const existing = readRawConfig();
+    const created = !existsSync(rynxConfigFile());
+    const defaults = loadConfig({});
+    const next = {
+        ...existing,
+        HOST: existing.HOST ?? defaults.HOST,
+        PORT: existing.PORT ?? defaults.PORT,
+        LOG_LEVEL: existing.LOG_LEVEL ?? defaults.LOG_LEVEL,
+        DEFAULT_RUNTIME: existing.DEFAULT_RUNTIME ?? defaults.DEFAULT_RUNTIME,
+    };
+    if (interactive) {
+        if (!await collectInteractiveSetup(next))
+            return 0;
+    }
+    else {
+        if (options.defaultRuntime !== undefined)
+            next.DEFAULT_RUNTIME = options.defaultRuntime;
+        if (options.host !== undefined)
+            next.HOST = options.host;
+        if (options.port !== undefined)
+            next.PORT = options.port;
+        if (options.logLevel !== undefined)
+            next.LOG_LEVEL = options.logLevel;
+    }
+    validateSetupConfig(next);
+    const updated = ["HOST", "PORT", "LOG_LEVEL", "DEFAULT_RUNTIME"].filter((key) => existing[key] !== next[key]);
+    writeConfigAtomically(next);
+    const result = {
+        configPath: rynxConfigFile(),
+        created,
+        updated,
+        browser: {
+            action: options.browser,
+            status: "skipped",
+        },
+        plugins: {
+            status: "ready",
+        },
+    };
+    let failed = false;
+    progress?.start("正在准备 Rynx 内置插件");
+    try {
+        const plugins = await prepareBundledPlugins();
+        result.plugins = {
+            status: plugins.status,
+            changed: [...plugins.installed, ...plugins.updated],
+        };
+        progress?.succeed("Rynx 内置插件已就绪");
+    }
+    catch (error) {
+        failed = true;
+        progress?.clear();
+        const detail = errorMessage(error);
+        result.plugins = {
+            status: "error",
+            detail,
+        };
+        console.error(`Rynx 内置插件准备失败：${detail}`);
+    }
+    progress?.start("正在检查 Rynx Browser");
+    const diagnostics = await inspectDaemonDiagnostics();
+    if (!diagnostics.browser.supported) {
+        result.browser = { action: options.browser, status: "unsupported" };
+        progress?.succeed("当前平台不支持 Rynx Browser");
+    }
+    else if (diagnostics.browser.installedVersion) {
+        result.browser = {
+            action: options.browser,
+            status: "ready",
+            version: diagnostics.browser.installedVersion,
+        };
+        progress?.succeed(`Rynx Browser 已就绪：${diagnostics.browser.installedVersion}`);
+    }
+    else if (options.browser !== "skip") {
+        progress?.update("正在安装 Rynx Browser");
+        try {
+            const { createBrowserArtifactManagementService } = await import("@rynx-ai/daemon/browser-artifacts");
+            const installed = await createBrowserArtifactManagementService().install({ channel: "stable" }, progress ? { onProgress: (message) => progress.update(message) } : {});
+            result.browser = {
+                action: options.browser,
+                status: "ready",
+                version: installed.installed.version,
+            };
+            progress?.succeed(`Rynx Browser 已就绪：${installed.installed.version}`);
+        }
+        catch (error) {
+            failed = true;
+            progress?.clear();
+            const detail = errorMessage(error);
+            result.browser = {
+                action: options.browser,
+                status: "error",
+                detail,
+            };
+            console.error(`Rynx Browser 安装失败：${detail}`);
+        }
+    }
+    else {
+        progress?.succeed("已跳过 Rynx Browser 安装");
+    }
+    if (options.resultFile) {
+        writeJsonAtomically(options.resultFile, result);
+    }
+    else if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else if (interactive) {
+        prompts.log.success(`已写入 ${result.configPath}`);
+        prompts.log.info(`HOST=${next.HOST} PORT=${next.PORT} DEFAULT_RUNTIME=${next.DEFAULT_RUNTIME}`);
+        if (result.browser.status === "ready") {
+            prompts.log.success(`Session Browser ${result.browser.version ?? "ready"}`);
+        }
+        else if (result.browser.status === "error") {
+            prompts.log.warn(`Session Browser: ${result.browser.detail}`);
+        }
+        prompts.outro(failed ? "初始化完成，但存在失败项" : "配置完成");
+    }
+    else {
+        console.log(`Initialized ${result.configPath}`);
+        if (result.browser.status === "ready") {
+            console.log(`Browser ready${result.browser.version ? `: ${result.browser.version}` : ""}`);
+        }
+    }
+    return failed ? 1 : 0;
+}
+export async function runDoctorCommand(args) {
+    const json = args.includes("--json");
+    if (args.some((arg) => arg !== "--json")) {
+        fail(`doctor: unexpected argument ${args.find((arg) => arg !== "--json")}`);
+    }
+    let config;
+    let configError;
+    try {
+        config = loadConfig();
+    }
+    catch (error) {
+        configError = errorMessage(error);
+    }
+    const runtimes = AGENT_RUNTIME_IDS.map((id) => {
+        const binary = getRuntimeProfile(id).defaultBinary;
+        const probe = spawnSync(binary, ["--version"], {
+            stdio: "ignore",
+            timeout: 8_000,
+        });
+        return { id, installed: !probe.error && probe.status === 0 };
+    });
+    const daemon = await inspectDaemonDiagnostics();
+    const tmuxBin = resolveBundledTmux();
+    const systemDependencies = tmuxBin
+        ? await inspectSystemDependencies({ tmuxBin })
+        : {
+            tmux: {
+                installed: false,
+                detail: BUNDLED_TMUX_UNAVAILABLE_MESSAGE,
+            },
+        };
+    const result = {
+        ok: configError === undefined &&
+            runtimes.some((runtime) => runtime.installed) &&
+            systemDependencies.tmux.installed,
+        configPath: rynxConfigFile(),
+        config,
+        configError,
+        runtimes,
+        daemon,
+        systemDependencies,
+    };
+    if (json)
+        console.log(JSON.stringify(result, null, 2));
+    else {
+        console.log(`config: ${result.configPath}`);
+        if (configError)
+            console.error(`config: ${configError}`);
+        else
+            console.log(`default runtime: ${config.DEFAULT_RUNTIME}`);
+        for (const runtime of runtimes) {
+            console.log(`${runtime.id}: ${runtime.installed ? "installed" : "not installed"}`);
+        }
+        console.log(`tmux: ${systemDependencies.tmux.installed ? "installed" : "not installed"}`);
+        if (daemon.browser.supported) {
+            console.log(`browser: ${daemon.browser.installedVersion ?? daemon.browser.error ?? "not installed"}`);
+        }
+        else {
+            console.log("browser: unsupported");
+        }
+    }
+    return result.ok ? 0 : 1;
+}
+function parseSetupOptions(args) {
+    const options = {
+        nonInteractive: false,
+        json: false,
+        browser: "auto",
+        hasConfigurationArguments: false,
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--non-interactive") {
+            options.nonInteractive = true;
+            continue;
+        }
+        if (arg === "--json") {
+            options.json = true;
+            options.nonInteractive = true;
+            continue;
+        }
+        if (arg === "--result-file") {
+            if (options.resultFile !== undefined)
+                fail("setup: duplicate option --result-file");
+            const value = args[index + 1];
+            if (!value || value.startsWith("--"))
+                fail("setup: --result-file requires a value");
+            options.resultFile = path.resolve(value);
+            options.nonInteractive = true;
+            index += 1;
+            continue;
+        }
+        if (arg === "--install-browser" || arg === "--skip-browser") {
+            if (options.browser !== "auto")
+                fail("setup: choose only one Browser action");
+            options.browser = arg === "--install-browser" ? "install" : "skip";
+            options.hasConfigurationArguments = true;
+            continue;
+        }
+        const value = args[index + 1];
+        if (!value || value.startsWith("--"))
+            fail(`setup: ${arg} requires a value`);
+        index += 1;
+        options.hasConfigurationArguments = true;
+        if (arg === "--default-runtime") {
+            if (!AGENT_RUNTIME_IDS.includes(value)) {
+                fail("setup: --default-runtime must be codex, traex, or claude");
+            }
+            options.defaultRuntime = value;
+        }
+        else if (arg === "--host") {
+            if (!value.trim() || value.length > 255)
+                fail("setup: --host is invalid");
+            options.host = value;
+        }
+        else if (arg === "--port") {
+            const port = Number(value);
+            if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+                fail("setup: --port must be an integer from 1 to 65535");
+            }
+            options.port = port;
+        }
+        else if (arg === "--log-level") {
+            if (!value.trim() || value.length > 32)
+                fail("setup: --log-level is invalid");
+            options.logLevel = value;
+        }
+        else {
+            fail(`setup: unknown option ${arg}`);
+        }
+    }
+    if (options.json && options.resultFile) {
+        fail("setup: choose either --json or --result-file");
+    }
+    return options;
+}
+async function collectInteractiveSetup(config) {
+    prompts.intro("rynx setup");
+    const runtime = await prompts.select({
+        message: "Default runtime",
+        initialValue: config.DEFAULT_RUNTIME,
+        options: AGENT_RUNTIME_IDS.map((id) => ({ value: id, label: id })),
+    });
+    if (prompts.isCancel(runtime))
+        return cancelled();
+    config.DEFAULT_RUNTIME = runtime;
+    const port = await prompts.text({
+        message: "HTTP port",
+        initialValue: String(config.PORT),
+        validate: (value) => {
+            const parsed = Number(value);
+            return Number.isInteger(parsed) && parsed > 0 && parsed <= 65_535
+                ? undefined
+                : "Enter a port from 1 to 65535";
+        },
+    });
+    if (prompts.isCancel(port))
+        return cancelled();
+    config.PORT = Number(port);
+    const host = await prompts.text({
+        message: "Bind host",
+        initialValue: String(config.HOST),
+    });
+    if (prompts.isCancel(host))
+        return cancelled();
+    config.HOST = host;
+    const logLevel = await prompts.text({
+        message: "Log level",
+        initialValue: String(config.LOG_LEVEL),
+    });
+    if (prompts.isCancel(logLevel))
+        return cancelled();
+    config.LOG_LEVEL = logLevel;
+    return true;
+}
+function cancelled() {
+    prompts.cancel("Cancelled");
+    return false;
+}
+function validateSetupConfig(config) {
+    loadConfig({
+        HOST: String(config.HOST),
+        PORT: String(config.PORT),
+        LOG_LEVEL: String(config.LOG_LEVEL),
+        DEFAULT_RUNTIME: String(config.DEFAULT_RUNTIME),
+    });
+}
+function readRawConfig() {
+    try {
+        const parsed = JSON.parse(readFileSync(rynxConfigFile(), "utf8"));
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfigAtomically(config) {
+    writeJsonAtomically(rynxConfigFile(), config);
+}
+function writeJsonAtomically(file, value) {
+    const directory = path.dirname(file);
+    mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const temporary = path.join(directory, `.${path.basename(file)}.${process.pid}.tmp`);
+    let descriptor;
+    try {
+        descriptor = openSync(temporary, "wx", 0o600);
+        writeFileSync(descriptor, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+        closeSync(descriptor);
+        descriptor = undefined;
+        renameSync(temporary, file);
+        chmodSync(file, 0o600);
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+        rmSync(temporary, { force: true });
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}