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

package/dist/commands/skills.js

@@ -1,8 +1,8 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { isSkillPathComponent } from "@rynx-ai/core";
 import { fail } from "./errors.js";
-const SKILL_NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
 const MAX_SKILL_BYTES = 256 * 1024;
 const BUILTIN_SKILL_NAMES = ["browser", "emulator"];
 export async function runSkillsCommand(args) {
@@ -55,7 +55,7 @@ export async function listBuiltinSkills() {
     return guides.filter((guide) => guide !== null);
 }
 export async function readBuiltinSkill(name, full = false) {
-    if (!SKILL_NAME_PATTERN.test(name))
+    if (!isSkillPathComponent(name))
         return null;
     if (!BUILTIN_SKILL_NAMES.includes(name))
         return null;

package/dist/commands/update.d.ts

@@ -0,0 +1,20 @@
+export interface UpdateOptions {
+    check?: boolean;
+    json?: boolean;
+    version?: string;
+}
+export type UpdateCheck = {
+    status: "up_to_date";
+    current: string;
+} | {
+    status: "behind";
+    current: string;
+    latest: string;
+} | {
+    status: "error";
+    detail: string;
+};
+export declare function isNewer(latest: string, current: string): boolean;
+export declare function buildUpdateCheck(current: string, latest: string | null): UpdateCheck;
+export declare function checkStatusLine(current: string, latest: string | null): string;
+export declare function runUpdate(options: UpdateOptions): Promise<number>;

package/dist/commands/update.js

@@ -0,0 +1,234 @@
+import { spawnSync } from "node:child_process";
+import { closeSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, sep } from "node:path";
+import { rynxHome } from "@rynx-ai/core";
+import { stopStandaloneDaemon } from "../standalone.js";
+function selfPackage() {
+    const require = createRequire(import.meta.url);
+    const manifest = require("../../package.json");
+    return {
+        name: manifest.name ?? "@rynx-ai/cli",
+        version: manifest.version ?? "0.0.0",
+    };
+}
+function packageRoot() {
+    const require = createRequire(import.meta.url);
+    return dirname(require.resolve("../../package.json"));
+}
+function isLocalDevInstall() {
+    return !packageRoot().split(sep).includes("node_modules");
+}
+function latestVersion(name, current) {
+    const tag = current.includes("-") ? "next" : "latest";
+    const result = spawnSync("npm", ["view", `${name}@${tag}`, "version"], {
+        encoding: "utf8",
+        timeout: 60_000,
+    });
+    if (result.error || result.status !== 0)
+        return null;
+    return result.stdout.trim() || null;
+}
+export function isNewer(latest, current) {
+    return compareSemver(latest, current) > 0;
+}
+export function buildUpdateCheck(current, latest) {
+    if (!latest)
+        return { status: "error", detail: "could not resolve latest version" };
+    return isNewer(latest, current)
+        ? { status: "behind", current, latest }
+        : { status: "up_to_date", current };
+}
+export function checkStatusLine(current, latest) {
+    const check = buildUpdateCheck(current, latest);
+    if (check.status === "behind")
+        return `behind ${check.current} ${check.latest}`;
+    if (check.status === "up_to_date")
+        return `up_to_date ${check.current}`;
+    return `error ${check.detail}`;
+}
+export async function runUpdate(options) {
+    const { name, version: current } = selfPackage();
+    const latest = latestVersion(name, current);
+    if (options.check) {
+        const result = buildUpdateCheck(current, latest);
+        console.log(options.json ? JSON.stringify(result) : checkStatusLine(current, latest));
+        return result.status === "error" ? 1 : 0;
+    }
+    if (isLocalDevInstall()) {
+        console.error(`update: ${name} is a local development install`);
+        return 1;
+    }
+    const target = options.version ?? latest;
+    if (!target) {
+        console.error(`update: could not resolve a target version for ${name}`);
+        return 1;
+    }
+    if (!options.version && !isNewer(target, current)) {
+        console.log(`Already on the latest ${name}@${current}.`);
+        return 0;
+    }
+    const releaseLock = acquireUpdateLock();
+    if (!releaseLock)
+        return 1;
+    try {
+        if (await stopStandaloneDaemon() !== 0) {
+            console.error("update: could not stop the standalone daemon");
+            return 1;
+        }
+        if (!npmInstallGlobal(name, target)) {
+            console.error("update: npm install failed");
+            startFreshCli();
+            return 1;
+        }
+        if (!freshRuntimeMatches(target) || !startFreshCli()) {
+            console.error(`update: ${name}@${target} failed verification; rolling back to ${current}`);
+            if (!npmInstallGlobal(name, current)) {
+                console.error(`update: rollback to ${name}@${current} failed`);
+                return 1;
+            }
+            if (!freshRuntimeMatches(current) || !startFreshCli()) {
+                console.error(`update: ${name}@${current} was restored but failed to start`);
+            }
+            return 1;
+        }
+        console.log(`Updated ${name} to ${target}.`);
+        return 0;
+    }
+    finally {
+        releaseLock();
+    }
+}
+function compareSemver(left, right) {
+    const parse = (value) => {
+        const [core, prerelease] = value.split("-", 2);
+        const parts = core.split(".").map((part) => Number(part));
+        return { parts, prerelease: prerelease?.split(".") ?? [] };
+    };
+    const a = parse(left);
+    const b = parse(right);
+    for (let index = 0; index < 3; index += 1) {
+        const difference = (a.parts[index] ?? 0) - (b.parts[index] ?? 0);
+        if (difference !== 0)
+            return Math.sign(difference);
+    }
+    if (a.prerelease.length === 0 || b.prerelease.length === 0) {
+        return a.prerelease.length === b.prerelease.length
+            ? 0
+            : a.prerelease.length === 0 ? 1 : -1;
+    }
+    const length = Math.max(a.prerelease.length, b.prerelease.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftPart = a.prerelease[index];
+        const rightPart = b.prerelease[index];
+        if (leftPart === undefined || rightPart === undefined) {
+            return leftPart === rightPart ? 0 : leftPart === undefined ? -1 : 1;
+        }
+        if (leftPart === rightPart)
+            continue;
+        const leftNumber = /^\d+$/.test(leftPart) ? Number(leftPart) : undefined;
+        const rightNumber = /^\d+$/.test(rightPart) ? Number(rightPart) : undefined;
+        if (leftNumber !== undefined && rightNumber !== undefined) {
+            return Math.sign(leftNumber - rightNumber);
+        }
+        if (leftNumber !== undefined)
+            return -1;
+        if (rightNumber !== undefined)
+            return 1;
+        return leftPart.localeCompare(rightPart);
+    }
+    return 0;
+}
+function npmInstallGlobal(name, version) {
+    const installed = spawnSync("npm", ["install", "-g", `${name}@${version}`, "--no-audit", "--no-fund"], { stdio: "inherit", timeout: 600_000 });
+    return !installed.error && installed.status === 0;
+}
+function freshRuntimeMatches(version) {
+    const probe = spawnSync("rynx", ["version", "--json"], {
+        encoding: "utf8",
+        timeout: 60_000,
+    });
+    if (probe.error || probe.status !== 0)
+        return false;
+    try {
+        const runtime = JSON.parse(probe.stdout);
+        return runtime.cliVersion === version && runtime.daemonVersion === version;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run lifecycle through the newly installed bin. Calling an imported lifecycle
+ * module after npm replaces the package graph would execute stale code.
+ */
+function startFreshCli() {
+    const restarted = spawnSync("rynx", ["start"], {
+        stdio: "inherit",
+        timeout: 60_000,
+    });
+    return !restarted.error && restarted.status === 0;
+}
+function acquireUpdateLock() {
+    const directory = join(rynxHome(), "state");
+    const file = join(directory, "update.lock");
+    mkdirSync(directory, { recursive: true, mode: 0o700 });
+    let descriptor;
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        try {
+            descriptor = openSync(file, "wx", 0o600);
+            writeFileSync(descriptor, `${process.pid}\n`, "utf8");
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            const owner = readLockOwner(file);
+            if (owner !== undefined && processIsAlive(owner)) {
+                console.error(`update: another update is running (pid ${owner})`);
+                return null;
+            }
+            try {
+                unlinkSync(file);
+            }
+            catch (unlinkError) {
+                if (unlinkError.code !== "ENOENT") {
+                    console.error("update: could not clear a stale update lock");
+                    return null;
+                }
+            }
+        }
+    }
+    if (descriptor === undefined) {
+        console.error("update: could not acquire the update lock");
+        return null;
+    }
+    return () => {
+        closeSync(descriptor);
+        try {
+            if (readLockOwner(file) === process.pid)
+                unlinkSync(file);
+        }
+        catch {
+            // The update already completed; a stale lock is recoverable next run.
+        }
+    };
+}
+function readLockOwner(file) {
+    try {
+        const value = Number(readFileSync(file, "utf8").trim());
+        return Number.isSafeInteger(value) && value > 0 ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}

package/dist/control-client.d.ts

@@ -1,13 +1,10 @@
 import { type DaemonStatus } from "@rynx-ai/protocol/remote-runtime";
-import { type DaemonBrowserArtifactCleanResult, type DaemonBrowserArtifactInstallInput, type DaemonBrowserArtifactInstallResult, type DaemonBrowserArtifactUpdateInput, type DaemonBrowserArtifactVersionResult, type DaemonCleanupSessionsInput, type DaemonCleanupSessionsResult, type DaemonChromeInspectionConfigureInput, type DaemonChromeInspectionStatus, type DaemonShutdownIfIdleResult } from "@rynx-ai/protocol/control";
+import { type DaemonCleanupSessionsInput, type DaemonCleanupSessionsResult, type DaemonChromeInspectionConfigureInput, type DaemonChromeInspectionStatus, type DaemonShutdownIfIdleResult } from "@rynx-ai/protocol/control";
 import { type RemoteRuntimeRpcMethod, type RemoteRuntimeRpcParams, type RemoteRuntimeRpcResultFor } from "@rynx-ai/protocol/remote-runtime-rpc";
 import { type PairingOffer } from "@rynx-ai/protocol/direct-runtime";
 import { type RuntimeBrowserBootstrapCredential, type RuntimeBrowserEndpointDescriptor } from "@rynx-ai/protocol/runtime-browser-bootstrap";
 import { type PluginInstallCommitInput, type PluginInstallCommitResult, type PluginInstallPreparation, type PluginInstallPrepareInput, type PluginManagementItem, type PluginManagementState, type PluginMarketplaceAddInput, type PluginMarketplaceItem } from "@rynx-ai/protocol/plugin-management";
 export { connectResidentDesktopBrowserHost, type ResidentDesktopBrowserHostConnection, type ResidentDesktopBrowserHostCommandRequest, type ResidentDesktopBrowserHostConnectOptions, type ResidentDesktopBrowserHostFailure, } from "./desktop-browser-host-client.js";
-export interface ResidentDaemon {
-    origin: string;
-}
 export interface ResidentDaemonIdentity {
     installationId: string;
     algorithm: "Ed25519";
@@ -59,8 +56,6 @@ export declare class ResidentRuntimeCallError extends Error {
         outcome?: ResidentRuntimeCallOutcome;
     });
 }
-/** Connect to the resident daemon already owned by the App or standalone supervisor. */
-export declare function ensureResidentDaemon(): Promise<ResidentDaemon>;
 /** Read the stable public identity of the single resident daemon. */
 export declare function getResidentDaemonIdentity(): Promise<ResidentDaemonIdentity>;
 /** Read the transport-independent status of the resident daemon process. */
@@ -73,10 +68,6 @@ export declare function getResidentDaemonRuntimeStatus(): Promise<DaemonStatus>;
 export declare function shutdownResidentDaemonIfIdle(): Promise<DaemonShutdownIfIdleResult>;
 export declare function getResidentChromeInspectionStatus(): Promise<DaemonChromeInspectionStatus>;
 export declare function configureResidentChromeInspection(input: DaemonChromeInspectionConfigureInput): Promise<DaemonChromeInspectionStatus>;
-export declare function installResidentBrowserArtifact(input: DaemonBrowserArtifactInstallInput): Promise<DaemonBrowserArtifactInstallResult>;
-export declare function updateResidentBrowserArtifact(input: DaemonBrowserArtifactUpdateInput): Promise<DaemonBrowserArtifactInstallResult>;
-export declare function getResidentBrowserArtifactVersion(): Promise<DaemonBrowserArtifactVersionResult>;
-export declare function cleanResidentBrowserArtifacts(): Promise<DaemonBrowserArtifactCleanResult>;
 export declare function cleanupResidentSessions(input?: DaemonCleanupSessionsInput): Promise<DaemonCleanupSessionsResult>;
 /** Create one pairing offer on the resident daemon for a selected reachable route. */
 export declare function createResidentRemoteRuntimePairingOffer(input?: {

package/dist/control-client.js

@@ -1,7 +1,7 @@
 import { open } from "node:fs/promises";
 import { isAbsolute } from "node:path";
 import { isDaemonCoreCompatible, parseDaemonStatus, } from "@rynx-ai/protocol/remote-runtime";
-import { DAEMON_BROWSER_ARTIFACT_CLEAN_PATH, DAEMON_BROWSER_ARTIFACT_INSTALL_PATH, DAEMON_BROWSER_ARTIFACT_UPDATE_PATH, DAEMON_BROWSER_ARTIFACT_VERSION_PATH, DAEMON_CHROME_INSPECTION_PATH, DAEMON_CLEANUP_SESSIONS_PATH, DAEMON_SHUTDOWN_IF_IDLE_PATH, parseDaemonBrowserArtifactCleanResult, parseDaemonBrowserArtifactInstallResult, parseDaemonBrowserArtifactVersionResult, parseDaemonCleanupSessionsResult, parseDaemonChromeInspectionConfigureInput, parseDaemonChromeInspectionStatus, parseDaemonShutdownIfIdleResult, } from "@rynx-ai/protocol/control";
+import { DAEMON_CHROME_INSPECTION_PATH, DAEMON_CLEANUP_SESSIONS_PATH, DAEMON_SHUTDOWN_IF_IDLE_PATH, parseDaemonCleanupSessionsResult, parseDaemonChromeInspectionConfigureInput, parseDaemonChromeInspectionStatus, parseDaemonShutdownIfIdleResult, } from "@rynx-ai/protocol/control";
 import { parseRemoteRuntimeRpcRequest, parseRemoteRuntimeRpcResponseForMethod, REMOTE_RUNTIME_RPC_MAX_FRAME_BYTES, REMOTE_RUNTIME_RPC_METHOD_METADATA, } from "@rynx-ai/protocol/remote-runtime-rpc";
 import { parsePairingOffer, } from "@rynx-ai/protocol/direct-runtime";
 import { RUNTIME_BROWSER_BOOTSTRAP_PATH, RUNTIME_BROWSER_CAPABILITY_ENV, RUNTIME_BROWSER_CAPABILITY_HEADER, RUNTIME_BROWSER_CONTEXT_FILE_ENV, RUNTIME_BROWSER_MANAGEMENT_PATH_PREFIX, RUNTIME_BROWSER_RPC_PATH, RUNTIME_BROWSER_SESSION_ID_ENV, RUNTIME_BROWSER_SESSION_ID_HEADER, parseRuntimeBrowserBootstrapCredential, parseRuntimeBrowserEndpointDescriptor, } from "@rynx-ai/protocol/runtime-browser-bootstrap";
@@ -35,8 +35,6 @@ const PLUGIN_CLI_RESPONSE_MAX_BYTES = 4 * 1024 * 1024;
 const PLUGIN_MANAGEMENT_TIMEOUT_MS = 30_000;
 const PLUGIN_INSTALL_OPERATION_TIMEOUT_MS = 15 * 60_000;
 const PLUGIN_MANAGEMENT_RESPONSE_MAX_BYTES = 256 * 1024;
-const BROWSER_ARTIFACT_OPERATION_TIMEOUT_MS = 15 * 60_000;
-const BROWSER_ARTIFACT_RESPONSE_MAX_BYTES = 4 * 1024 * 1024;
 const MAINTENANCE_TIMEOUT_MS = 30_000;
 const MAINTENANCE_RESPONSE_MAX_BYTES = 64 * 1024;
 const CHROME_INSPECTION_TIMEOUT_MS = 30_000;
@@ -56,11 +54,6 @@ export class ResidentRuntimeCallError extends Error {
         this.outcome = options?.outcome;
     }
 }
-/** Connect to the resident daemon already owned by the App or standalone supervisor. */
-export async function ensureResidentDaemon() {
-    const endpoint = await ensureDaemonControlEndpoint();
-    return { origin: endpoint.origin };
-}
 /** Read the stable public identity of the single resident daemon. */
 export async function getResidentDaemonIdentity() {
     const endpoint = await ensureDaemonControlEndpoint();
@@ -160,44 +153,6 @@ export async function configureResidentChromeInspection(input) {
     });
     return parseDaemonChromeInspectionStatus(result);
 }
-export async function installResidentBrowserArtifact(input) {
-    const result = await localManagementJsonRequest(DAEMON_BROWSER_ARTIFACT_INSTALL_PATH, {
-        method: "POST",
-        body: input,
-        timeoutMs: BROWSER_ARTIFACT_OPERATION_TIMEOUT_MS,
-        maxResponseBytes: BROWSER_ARTIFACT_RESPONSE_MAX_BYTES,
-        operation: "Browser artifact install",
-    });
-    return parseDaemonBrowserArtifactInstallResult(result);
-}
-export async function updateResidentBrowserArtifact(input) {
-    const result = await localManagementJsonRequest(DAEMON_BROWSER_ARTIFACT_UPDATE_PATH, {
-        method: "POST",
-        body: input,
-        timeoutMs: BROWSER_ARTIFACT_OPERATION_TIMEOUT_MS,
-        maxResponseBytes: BROWSER_ARTIFACT_RESPONSE_MAX_BYTES,
-        operation: "Browser artifact update",
-    });
-    return parseDaemonBrowserArtifactInstallResult(result);
-}
-export async function getResidentBrowserArtifactVersion() {
-    const result = await localManagementJsonRequest(DAEMON_BROWSER_ARTIFACT_VERSION_PATH, {
-        method: "GET",
-        timeoutMs: MAINTENANCE_TIMEOUT_MS,
-        maxResponseBytes: BROWSER_ARTIFACT_RESPONSE_MAX_BYTES,
-        operation: "Browser artifact version",
-    });
-    return parseDaemonBrowserArtifactVersionResult(result);
-}
-export async function cleanResidentBrowserArtifacts() {
-    const result = await localManagementJsonRequest(DAEMON_BROWSER_ARTIFACT_CLEAN_PATH, {
-        method: "POST",
-        timeoutMs: MAINTENANCE_TIMEOUT_MS,
-        maxResponseBytes: BROWSER_ARTIFACT_RESPONSE_MAX_BYTES,
-        operation: "Browser artifact clean",
-    });
-    return parseDaemonBrowserArtifactCleanResult(result);
-}
 export async function cleanupResidentSessions(input = {}) {
     const result = await localManagementJsonRequest(DAEMON_CLEANUP_SESSIONS_PATH, {
         method: "POST",

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export { runCli } from "./run-cli.js";
 export { USAGE } from "./usage.js";
+export { installedVersion } from "./version.js";

package/dist/index.js

@@ -1,2 +1,3 @@
 export { runCli } from "./run-cli.js";
 export { USAGE } from "./usage.js";
+export { installedVersion } from "./version.js";

package/dist/progress-display.d.ts

@@ -0,0 +1,7 @@
+export interface ProgressDisplay {
+    start(message: string): void;
+    update(message: string): void;
+    succeed(message: string): void;
+    clear(): void;
+}
+export declare function createProgressDisplay(): ProgressDisplay;

package/dist/progress-display.js

@@ -0,0 +1,78 @@
+import * as prompts from "@clack/prompts";
+const DOWNLOAD_PERCENT_PATTERN = /下载进度：(\d{1,3})%$/u;
+export function createProgressDisplay() {
+    if (!prompts.isTTY(process.stdout) || prompts.isCI()) {
+        return {
+            start: (message) => console.log(message),
+            update: (message) => console.log(message),
+            succeed: (message) => console.log(message),
+            clear: () => undefined,
+        };
+    }
+    const spinner = prompts.spinner({ output: process.stdout });
+    const progress = prompts.progress({
+        output: process.stdout,
+        max: 100,
+        size: 28,
+        style: "block",
+    });
+    let spinnerActive = false;
+    let progressActive = false;
+    let completedPercent = 0;
+    const clear = () => {
+        if (progressActive)
+            progress.clear();
+        if (spinnerActive)
+            spinner.clear();
+        progressActive = false;
+        spinnerActive = false;
+        completedPercent = 0;
+    };
+    const finishDownload = () => {
+        if (!progressActive)
+            return;
+        progress.stop("Chrome for Testing 下载完成");
+        progressActive = false;
+        completedPercent = 0;
+    };
+    return {
+        start(message) {
+            clear();
+            spinner.start(message);
+            spinnerActive = true;
+        },
+        update(message) {
+            const match = DOWNLOAD_PERCENT_PATTERN.exec(message);
+            if (match) {
+                const percent = Math.min(100, Number(match[1]));
+                if (spinnerActive) {
+                    spinner.clear();
+                    spinnerActive = false;
+                }
+                if (!progressActive) {
+                    progress.start(message);
+                    progressActive = true;
+                }
+                progress.advance(percent - completedPercent, message);
+                completedPercent = percent;
+                return;
+            }
+            finishDownload();
+            if (spinnerActive)
+                spinner.message(message);
+            else {
+                spinner.start(message);
+                spinnerActive = true;
+            }
+        },
+        succeed(message) {
+            finishDownload();
+            if (spinnerActive)
+                spinner.stop(message);
+            else
+                prompts.log.success(message);
+            spinnerActive = false;
+        },
+        clear,
+    };
+}

package/dist/run-cli.js

@@ -9,13 +9,9 @@ import { runPluginCommand, } from "./commands/plugin.js";
 import { runRuntimeCommand } from "./commands/runtime.js";
 import { runSessionCommand } from "./commands/session.js";
 import { runSkillsCommand } from "./commands/skills.js";
-import { runLegacyDaemonCli } from "./legacy-adapter.js";
 import { USAGE } from "./usage.js";
 import { installedVersion } from "./version.js";
-const LEGACY_TOP_LEVEL_COMMANDS = new Set([
-    "setup",
-    "doctor",
-    "update",
+const LIFECYCLE_COMMANDS = new Set([
     "start",
     "restart",
     "stop",
@@ -27,12 +23,25 @@ export async function runCli(argv) {
     if (shouldUseAppDistributionCommand(command)) {
         return runAppDistributionCommand(command, argv.slice(1));
     }
-    if (command && LEGACY_TOP_LEVEL_COMMANDS.has(command)) {
-        return runLegacyDaemonCli(argv);
+    if (command && LIFECYCLE_COMMANDS.has(command)) {
+        const { runLifecycleCommand } = await import("./commands/lifecycle.js");
+        return runLifecycleCommand(command, argv.slice(1));
     }
     switch (command) {
-        case "version":
+        case "version": {
+            if (argv.length === 2 && argv[1] === "--json") {
+                const { resolveCliDependencyVersions } = await import("./app-runtime.js");
+                console.log(JSON.stringify(resolveCliDependencyVersions()));
+                return 0;
+            }
+            if (argv.length > 1)
+                fail(`version: unexpected argument ${argv[1]}`);
+            console.log(installedVersion());
+            return 0;
+        }
         case "--version":
+            if (argv.length > 1)
+                fail(`--version: unexpected argument ${argv[1]}`);
             console.log(installedVersion());
             return 0;
         case "plugin":
@@ -53,6 +62,23 @@ export async function runCli(argv) {
             return runBrowserCommand(argv.slice(1));
         case "cleanup":
             return runCleanupCommand(argv.slice(1));
+        case "setup": {
+            const { runSetupCommand } = await import("./commands/setup.js");
+            return runSetupCommand(argv.slice(1));
+        }
+        case "doctor": {
+            const { runDoctorCommand } = await import("./commands/setup.js");
+            return runDoctorCommand(argv.slice(1));
+        }
+        case "update": {
+            const { runUpdate } = await import("./commands/update.js");
+            const rest = argv.slice(1);
+            return runUpdate({
+                check: rest.includes("--check"),
+                json: rest.includes("--json"),
+                version: rest.find((argument) => !argument.startsWith("--")),
+            });
+        }
         case undefined:
         case "help":
         case "-h":

package/dist/standalone.d.ts

@@ -0,0 +1,13 @@
+/** Resolve the canonical Builtin Skill directory shipped by this exact CLI. */
+export declare function standaloneBuiltinSkillsDirectory(moduleUrl?: string): string;
+export declare function startStandaloneDaemon(options?: {
+    restart?: boolean;
+    quiet?: boolean;
+}): Promise<number>;
+/** Reuse any healthy owner; otherwise explicitly start the standalone owner. */
+export declare function ensureStandaloneDaemon(): Promise<{
+    origin: string;
+}>;
+export declare function stopStandaloneDaemon(): Promise<number>;
+export declare function statusStandaloneDaemon(): Promise<number>;
+export declare function streamStandaloneDaemonLogs(): Promise<void>;

package/dist/standalone.js

@@ -0,0 +1,57 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveBundledTmux } from "@rynx-ai/tmux";
+import { installedVersion } from "./version.js";
+import { ensureDaemonControlEndpoint, resolveDaemonControlEndpoint, } from "./control-endpoint.js";
+/** Resolve the canonical Builtin Skill directory shipped by this exact CLI. */
+export function standaloneBuiltinSkillsDirectory(moduleUrl = import.meta.url) {
+    return path.resolve(fileURLToPath(new URL("../skills/", moduleUrl)));
+}
+export async function startStandaloneDaemon(options = {}) {
+    const cliVersion = installedVersion();
+    const tmuxBin = resolveBundledTmux();
+    const { startDaemon } = await import("@rynx-ai/daemon/lifecycle");
+    return startDaemon({
+        force: options.restart ?? false,
+        quiet: options.quiet,
+        context: {
+            builtinSkillsDir: standaloneBuiltinSkillsDirectory(),
+            cliVersion,
+            productVersion: cliVersion,
+            ...(tmuxBin ? { tmuxBin } : {}),
+        },
+    });
+}
+/** Reuse any healthy owner; otherwise explicitly start the standalone owner. */
+export async function ensureStandaloneDaemon() {
+    const current = await resolveDaemonControlEndpoint();
+    if (current)
+        return { origin: current.origin };
+    const status = await startStandaloneDaemon({ quiet: true });
+    if (status !== 0)
+        throw new Error("failed to start the standalone daemon");
+    const deadline = Date.now() + 20_000;
+    while (Date.now() < deadline) {
+        try {
+            const endpoint = await ensureDaemonControlEndpoint();
+            return { origin: endpoint.origin };
+        }
+        catch {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+    }
+    const endpoint = await ensureDaemonControlEndpoint();
+    return { origin: endpoint.origin };
+}
+export async function stopStandaloneDaemon() {
+    const { stopDaemon } = await import("@rynx-ai/daemon/lifecycle");
+    return stopDaemon();
+}
+export async function statusStandaloneDaemon() {
+    const { statusDaemon } = await import("@rynx-ai/daemon/lifecycle");
+    return statusDaemon();
+}
+export async function streamStandaloneDaemonLogs() {
+    const { streamLogs } = await import("@rynx-ai/daemon/lifecycle");
+    streamLogs();
+}

package/dist/usage.d.ts

@@ -1 +1 @@
-export declare const USAGE = "Usage: rynx <command>\n\nGeneral:\n  version | --version  print the installed Rynx version\n\nSetup:\n  setup              interactive configuration wizard\n  doctor             read-only health check\n\nLifecycle:\n  start | restart | stop | status | logs\n  update [version] [--check] [--json]\n\nPlugins:\n  market list\n  market add <git-or-local-source> [--alias <id>]\n  market refresh [market-id]\n  market remove <market-id>\n  plugin list\n  plugin install <source|plugin@market> [--force] [--expect-digest <sha256-...>]\n  plugin update <plugin@market> [--expect-digest <sha256-...>]\n  plugin enable|disable|uninstall <plugin@market>\n  plugin <plugin@market> <command>  invoke a plugin-owned command\n\nAgents:\n  agent list\n  agent show <id>\n  agent add <id>\n  agent rm <id>\n\nBuiltin Skills:\n  skills list [--json]\n  skills get <browser|emulator> [--full] [--json]\n\nMaintenance:\n  cleanup sessions [--dry-run]\n\nEmulator:\n  emulator <args...>\n\nRemote Runtime:\n  runtime share --address <host|ws-url> [--label <label>] [--json]\n  runtime add --pairing-code <rynx://...> [--name <name>]\n  runtime list [--json]\n  runtime test <local|daemon-id> [--json]\n  runtime forget <daemon-id>\n  runtime clients list [--json]\n  runtime clients revoke <grant-id>\n\nSessions:\n  session fork <session-id> [--title <title>] [--json]\n\nBrowser:\n  browser install|update|version|clean [...]\n  browser open [url] [--session <id>] [--runtime <local|daemon-id>] [--json]\n  browser status|pages|close [--session <id>] [--runtime <local|daemon-id>] [--json]\n  browser endpoint [--ensure] [--session <local-id>] [--json]\n  browser snapshot [--session <local-id>] [--json]\n  browser navigate <url> [--session <local-id>] [--json]\n  browser click (--ref <ref>|--selector <css>|--x <n> --y <n>) [--session <local-id>] [--json]\n  browser type (--ref <ref>|--selector <css>) --text <text> [--session <local-id>] [--json]\n  browser screenshot --output <absolute-path> [--session <local-id>] [--json]\n";
+export declare const USAGE = "Usage: rynx <command>\n\nGeneral:\n  version [--json] | --version\n                     print the installed Rynx version\n\nSetup:\n  setup [--non-interactive] [--default-runtime <codex|traex|claude>]\n        [--host <host>] [--port <port>] [--log-level <level>]\n        [--install-browser|--skip-browser] [--json|--result-file <path>]\n                     initialize configuration and local dependencies\n  doctor             read-only health check\n\nLifecycle:\n  start | restart | stop | status | logs\n  update [version] [--check] [--json]\n\nPlugins:\n  market list\n  market add <git-or-local-source> [--alias <id>]\n  market refresh [market-id]\n  market remove <market-id>\n  plugin list\n  plugin install <source|plugin@market> [--force] [--expect-digest <sha256-...>]\n  plugin update <plugin@market> [--expect-digest <sha256-...>]\n  plugin enable|disable|uninstall <plugin@market>\n  plugin <plugin@market> <command>  invoke a plugin-owned command\n\nAgents:\n  agent list\n  agent show <id>\n  agent add <id>\n  agent rm <id>\n\nBuiltin Skills:\n  skills list [--json]\n  skills get <browser|emulator> [--full] [--json]\n\nMaintenance:\n  cleanup sessions [--dry-run]\n\nEmulator:\n  emulator <args...>\n\nRemote Runtime:\n  runtime share --address <host|ws-url> [--label <label>] [--json]\n  runtime add --pairing-code <rynx://...> [--name <name>]\n  runtime list [--json]\n  runtime test <local|daemon-id> [--json]\n  runtime forget <daemon-id>\n  runtime clients list [--json]\n  runtime clients revoke <grant-id>\n\nSessions:\n  session fork <session-id> [--title <title>] [--json]\n\nBrowser:\n  browser install|update|version|clean [...]\n  browser open [url] [--session <id>] [--runtime <local|daemon-id>] [--json]\n  browser status|pages|close [--session <id>] [--runtime <local|daemon-id>] [--json]\n  browser endpoint [--ensure] [--session <local-id>] [--json]\n  browser snapshot [--session <local-id>] [--json]\n  browser navigate <url> [--session <local-id>] [--json]\n  browser click (--ref <ref>|--selector <css>|--x <n> --y <n>) [--session <local-id>] [--json]\n  browser type (--ref <ref>|--selector <css>) --text <text> [--session <local-id>] [--json]\n  browser screenshot --output <absolute-path> [--session <local-id>] [--json]\n";

package/dist/usage.js

@@ -1,10 +1,14 @@
 export const USAGE = `Usage: rynx <command>
 
 General:
-  version | --version  print the installed Rynx version
+  version [--json] | --version
+                     print the installed Rynx version
 
 Setup:
-  setup              interactive configuration wizard
+  setup [--non-interactive] [--default-runtime <codex|traex|claude>]
+        [--host <host>] [--port <port>] [--log-level <level>]
+        [--install-browser|--skip-browser] [--json|--result-file <path>]
+                     initialize configuration and local dependencies
   doctor             read-only health check
 
 Lifecycle: