nextclaw 0.18.12-beta.2 → 0.18.12-beta.21

package/dist/cli/launcher/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as NpmRuntimeBundleLayoutStore, n as NpmRuntimeBundleService, o as getPackageVersion$1, t as NpmRuntimeUpdateStateStore } from "../../npm-runtime-update-state.store-DaF0iDY9.js";
+import { c as NpmRuntimeBundleLayoutStore, d as getPackageVersion$1, i as NpmRuntimeBundleService, r as inferDefaultNpmRuntimeReleaseChannel, s as shouldPreferPackagedNpmRuntime, t as NpmRuntimeUpdateStateStore } from "../../npm-runtime-update-state.store-75vzvn0B.js";
 import { createExternalCommandEnv } from "@nextclaw/core";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -26,14 +26,19 @@ var NpmRuntimeLauncher = class {
 	};
 	resolveRuntimeScriptPath = () => {
 		if (this.env.NEXTCLAW_DISABLE_RUNTIME_BUNDLE_LAUNCHER === "1" || this.env.NEXTCLAW_RUNTIME_BUNDLE_CHILD === "1") return this.resolvePackagedAppEntrypoint();
-		const stateStore = new NpmRuntimeUpdateStateStore(this.layout.getStatePath());
+		const stateStore = new NpmRuntimeUpdateStateStore(this.layout.getStatePath(), { defaultChannel: inferDefaultNpmRuntimeReleaseChannel(getPackageVersion$1()) });
 		const bundleService = new NpmRuntimeBundleService({
 			layout: this.layout,
 			stateStore,
 			launcherVersion: getPackageVersion$1()
 		});
 		try {
-			return bundleService.resolveCurrentBundle()?.runtimeScriptPath ?? this.resolvePackagedAppEntrypoint();
+			const currentBundle = bundleService.resolveCurrentBundle();
+			if (currentBundle && shouldPreferPackagedNpmRuntime({
+				launcherVersion: getPackageVersion$1(),
+				currentBundleVersion: currentBundle.manifest.runtimeVersion ?? currentBundle.manifest.bundleVersion
+			})) return this.resolvePackagedAppEntrypoint();
+			return currentBundle?.runtimeScriptPath ?? this.resolvePackagedAppEntrypoint();
 		} catch (error) {
 			console.error(`Cannot start current runtime bundle: ${error instanceof Error ? error.message : String(error)}`);
 			console.error("Falling back to the packaged npm launcher runtime.");

package/dist/{npm-runtime-update-state.store-DaF0iDY9.js → npm-runtime-update-state.store-75vzvn0B.js}

@@ -2,7 +2,7 @@ import { createExternalCommandEnv, getDataDir, getLogsPath, getPackageVersion, r
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { isIP } from "node:net";
 import { cp, readdir, rename, rm } from "node:fs/promises";
 //#region src/cli/shared/utils/cli.utils.ts
@@ -71,6 +71,98 @@ async function waitForExit(pid, timeoutMs) {
 	}
 	return !isProcessRunning(pid);
 }
+function runLookupCommand(command, args) {
+	try {
+		const result = spawnSync(command, args, {
+			encoding: "utf8",
+			env: createExternalCommandEnv(process.env)
+		});
+		if (result.error || result.status !== 0) return {
+			ok: false,
+			stdout: ""
+		};
+		return {
+			ok: true,
+			stdout: result.stdout ?? ""
+		};
+	} catch {
+		return {
+			ok: false,
+			stdout: ""
+		};
+	}
+}
+function parseListeningPidFromLsof(raw) {
+	for (const line of raw.split("\n")) {
+		if (!line.startsWith("p")) continue;
+		const pid = Number(line.slice(1));
+		if (Number.isFinite(pid) && pid > 0) return pid;
+	}
+	return null;
+}
+function parseListeningPidFromNetstat(raw, port) {
+	const portSuffix = `:${port}`;
+	for (const line of raw.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed || !trimmed.includes("LISTEN")) continue;
+		const columns = trimmed.split(/\s+/);
+		if (columns.length < 5) continue;
+		if (!(columns[1] ?? "").endsWith(portSuffix)) continue;
+		const pid = Number(columns[4]);
+		if (Number.isFinite(pid) && pid > 0) return pid;
+	}
+	return null;
+}
+function lookupProcessCommandByPid(pid) {
+	if (!Number.isFinite(pid) || pid <= 0) return null;
+	if (process.platform === "win32") {
+		const result = runLookupCommand("powershell", [
+			"-NoProfile",
+			"-Command",
+			`(Get-CimInstance Win32_Process -Filter "ProcessId = ${pid}").CommandLine`
+		]);
+		if (!result.ok) return null;
+		const command = result.stdout.trim();
+		return command.length > 0 ? command : null;
+	}
+	const result = runLookupCommand("ps", [
+		"-p",
+		String(pid),
+		"-o",
+		"command="
+	]);
+	if (!result.ok) return null;
+	const command = result.stdout.trim();
+	return command.length > 0 ? command : null;
+}
+function findListeningProcessByPort(port) {
+	if (!Number.isFinite(port) || port <= 0) return null;
+	let pid = null;
+	if (process.platform === "win32") {
+		const result = runLookupCommand("netstat", [
+			"-ano",
+			"-p",
+			"tcp"
+		]);
+		if (!result.ok) return null;
+		pid = parseListeningPidFromNetstat(result.stdout, port);
+	} else {
+		const result = runLookupCommand("lsof", [
+			"-nP",
+			`-iTCP:${port}`,
+			"-sTCP:LISTEN",
+			"-F",
+			"p"
+		]);
+		if (!result.ok) return null;
+		pid = parseListeningPidFromLsof(result.stdout);
+	}
+	if (!pid) return null;
+	return {
+		pid,
+		command: lookupProcessCommandByPid(pid)
+	};
+}
 function findNearestPackageManifest(startDir, expectedName) {
 	let current = resolve(startDir);
 	while (current.length > 0) {
@@ -379,53 +471,126 @@ function compareNpmRuntimeVersions(left, right) {
 	}
 	return left.localeCompare(right);
 }
+function resolveEffectiveNpmRuntimeVersion(params) {
+	const launcherVersion = params.launcherVersion?.trim() || null;
+	const currentBundleVersion = params.currentBundleVersion?.trim() || null;
+	if (!launcherVersion) return currentBundleVersion;
+	if (!currentBundleVersion) return launcherVersion;
+	return compareNpmRuntimeVersions(launcherVersion, currentBundleVersion) > 0 ? launcherVersion : currentBundleVersion;
+}
+function shouldPreferPackagedNpmRuntime(params) {
+	const launcherVersion = params.launcherVersion?.trim() || null;
+	const currentBundleVersion = params.currentBundleVersion?.trim() || null;
+	if (!launcherVersion || !currentBundleVersion) return false;
+	return resolveEffectiveNpmRuntimeVersion(params) === launcherVersion;
+}
 function parseVersionParts(version) {
 	return version.split(/[.-]/).map((part) => Number(part)).map((part) => Number.isFinite(part) ? part : 0);
 }
 //#endregion
-//#region src/cli/launcher/npm-runtime-update-state.store.ts
-const DEFAULT_NPM_RUNTIME_UPDATE_STATE = {
-	channel: "stable",
-	currentVersion: null,
-	previousVersion: null,
-	candidateVersion: null,
-	candidateLaunchCount: 0,
-	lastKnownGoodVersion: null,
-	badVersions: [],
-	lastUpdateCheckAt: null,
-	downloadedVersion: null,
-	downloadedReleaseNotesUrl: null,
-	updatePreferences: {
-		automaticChecks: true,
-		autoDownload: false
+//#region src/cli/launcher/npm-runtime-update-source.service.ts
+const DEFAULT_NPM_RUNTIME_UPDATE_BASE_URL = "https://Peiiii.github.io/nextclaw/npm-runtime-updates";
+function normalizeOptionalString$1(value) {
+	if (typeof value !== "string") return null;
+	const trimmed = value.trim();
+	return trimmed ? trimmed : null;
+}
+function normalizeChannel$1(value) {
+	return typeof value === "string" && value.trim().toLowerCase() === "beta" ? "beta" : "stable";
+}
+function inferDefaultNpmRuntimeReleaseChannel(launcherVersion) {
+	return typeof launcherVersion === "string" && launcherVersion.toLowerCase().includes("-beta") ? "beta" : "stable";
+}
+function resolvePackagedPublicKeyPath() {
+	const moduleDir = dirname(fileURLToPath(import.meta.url));
+	const candidates = [
+		resolve(moduleDir, "..", "resources", "update-bundle-public.pem"),
+		resolve(moduleDir, "../../..", "resources", "update-bundle-public.pem"),
+		resolve(moduleDir, "../../../..", "resources", "update-bundle-public.pem")
+	];
+	return candidates.find((candidate) => existsSync(candidate)) ?? candidates[0];
+}
+var NpmRuntimeUpdateSourceService = class {
+	env;
+	platform;
+	arch;
+	constructor(options = {}) {
+		this.env = options.env ?? process.env;
+		this.platform = options.platform ?? process.platform;
+		this.arch = options.arch ?? process.arch;
 	}
+	resolveChannel = (explicitChannel, launcherVersion) => {
+		if (explicitChannel !== void 0 || this.env.NEXTCLAW_UPDATE_CHANNEL !== void 0) return normalizeChannel$1(explicitChannel ?? this.env.NEXTCLAW_UPDATE_CHANNEL);
+		return inferDefaultNpmRuntimeReleaseChannel(launcherVersion);
+	};
+	resolveManifestUrl = (channel, explicitManifestUrl) => {
+		const manifestUrl = normalizeOptionalString$1(explicitManifestUrl) ?? normalizeOptionalString$1(this.env.NEXTCLAW_UPDATE_MANIFEST_URL);
+		if (manifestUrl) return manifestUrl;
+		const baseUrl = normalizeOptionalString$1(this.env.NEXTCLAW_UPDATE_MANIFEST_BASE_URL) ?? DEFAULT_NPM_RUNTIME_UPDATE_BASE_URL;
+		return new URL(`${channel}/manifest-${channel}-${this.platform}-${this.arch}.json`, `${baseUrl.replace(/\/+$/, "")}/`).toString();
+	};
+	resolveBundlePublicKey = () => {
+		const explicitPublicKey = normalizeOptionalString$1(this.env.NEXTCLAW_UPDATE_BUNDLE_PUBLIC_KEY);
+		if (explicitPublicKey) return explicitPublicKey;
+		const publicKeyPath = normalizeOptionalString$1(this.env.NEXTCLAW_UPDATE_BUNDLE_PUBLIC_KEY_PATH);
+		if (!publicKeyPath || !existsSync(publicKeyPath)) {
+			const packagedPublicKeyPath = resolvePackagedPublicKeyPath();
+			return existsSync(packagedPublicKeyPath) ? readFileSync(packagedPublicKeyPath, "utf8").trim() : null;
+		}
+		return readFileSync(publicKeyPath, "utf8").trim();
+	};
 };
+//#endregion
+//#region src/cli/launcher/npm-runtime-update-state.store.ts
+function createDefaultState(channel) {
+	return {
+		channel,
+		currentVersion: null,
+		previousVersion: null,
+		candidateVersion: null,
+		candidateLaunchCount: 0,
+		lastKnownGoodVersion: null,
+		badVersions: [],
+		lastUpdateCheckAt: null,
+		downloadedVersion: null,
+		downloadedReleaseNotesUrl: null,
+		updatePreferences: {
+			automaticChecks: true,
+			autoDownload: true
+		}
+	};
+}
 function normalizeOptionalString(value) {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
 	return trimmed ? trimmed : null;
 }
-function normalizeChannel(value) {
-	return typeof value === "string" && value.trim().toLowerCase() === "beta" ? "beta" : "stable";
+function normalizeChannel(value, fallback) {
+	if (typeof value !== "string") return fallback;
+	const trimmed = value.trim().toLowerCase();
+	if (trimmed === "beta") return "beta";
+	if (trimmed === "stable") return "stable";
+	return fallback;
 }
 function normalizeStringArray(value) {
 	if (!Array.isArray(value)) return [];
 	return [...new Set(value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter(Boolean))];
 }
 function normalizeUpdatePreferences(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return { ...DEFAULT_NPM_RUNTIME_UPDATE_STATE.updatePreferences };
+	const defaultState = createDefaultState("stable");
+	if (!value || typeof value !== "object" || Array.isArray(value)) return { ...defaultState.updatePreferences };
 	const record = value;
 	return {
-		automaticChecks: typeof record.automaticChecks === "boolean" ? record.automaticChecks : DEFAULT_NPM_RUNTIME_UPDATE_STATE.updatePreferences.automaticChecks,
-		autoDownload: typeof record.autoDownload === "boolean" ? record.autoDownload : DEFAULT_NPM_RUNTIME_UPDATE_STATE.updatePreferences.autoDownload
+		automaticChecks: typeof record.automaticChecks === "boolean" ? record.automaticChecks : defaultState.updatePreferences.automaticChecks,
+		autoDownload: typeof record.autoDownload === "boolean" ? record.autoDownload : defaultState.updatePreferences.autoDownload
 	};
 }
-function normalizeState(input) {
+function normalizeState(input, defaultChannel) {
 	if (!input || typeof input !== "object" || Array.isArray(input)) throw new Error("npm runtime update state must be an object");
 	const record = input;
 	const candidateLaunchCount = Number(record.candidateLaunchCount);
 	return {
-		channel: normalizeChannel(record.channel),
+		channel: normalizeChannel(record.channel, defaultChannel),
 		currentVersion: normalizeOptionalString(record.currentVersion),
 		previousVersion: normalizeOptionalString(record.previousVersion),
 		candidateVersion: normalizeOptionalString(record.candidateVersion),
@@ -439,15 +604,20 @@ function normalizeState(input) {
 	};
 }
 var NpmRuntimeUpdateStateStore = class {
-	constructor(statePath) {
+	defaultChannel;
+	constructor(statePath, options = {}) {
 		this.statePath = statePath;
+		this.defaultChannel = options.defaultChannel ?? "stable";
 	}
 	read = () => {
-		if (!existsSync(this.statePath)) return {
-			...DEFAULT_NPM_RUNTIME_UPDATE_STATE,
-			updatePreferences: { ...DEFAULT_NPM_RUNTIME_UPDATE_STATE.updatePreferences }
-		};
-		return normalizeState(JSON.parse(readFileSync(this.statePath, "utf8")));
+		if (!existsSync(this.statePath)) {
+			const defaultState = createDefaultState(this.defaultChannel);
+			return {
+				...defaultState,
+				updatePreferences: { ...defaultState.updatePreferences }
+			};
+		}
+		return normalizeState(JSON.parse(readFileSync(this.statePath, "utf8")), this.defaultChannel);
 	};
 	write = (state) => {
 		mkdirSync(dirname(this.statePath), { recursive: true });
@@ -460,4 +630,4 @@ var NpmRuntimeUpdateStateStore = class {
 	};
 };
 //#endregion
-export { waitForExit as _, findExecutableOnPath as a, isProcessRunning as c, prompt as d, resolvePublicIp as f, resolveUiStaticDir as g, resolveUiConfig as h, NpmRuntimeBundleLayoutStore as i, openBrowser as l, resolveUiApiBase as m, NpmRuntimeBundleService as n, getPackageVersion$1 as o, resolveServiceLogPath as p, compareNpmRuntimeVersions as r, isLoopbackHost as s, NpmRuntimeUpdateStateStore as t, printAgentResponse as u };
+export { waitForExit as S, resolvePublicIp as _, compareNpmRuntimeVersions as a, resolveUiConfig as b, NpmRuntimeBundleLayoutStore as c, getPackageVersion$1 as d, isLoopbackHost as f, prompt as g, printAgentResponse as h, NpmRuntimeBundleService as i, findExecutableOnPath as l, openBrowser as m, NpmRuntimeUpdateSourceService as n, resolveEffectiveNpmRuntimeVersion as o, isProcessRunning as p, inferDefaultNpmRuntimeReleaseChannel as r, shouldPreferPackagedNpmRuntime as s, NpmRuntimeUpdateStateStore as t, findListeningProcessByPort as u, resolveServiceLogPath as v, resolveUiStaticDir as x, resolveUiApiBase as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.18.12-beta.2",
+  "version": "0.18.12-beta.21",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -41,20 +41,21 @@
     "commander": "^12.1.0",
     "jszip": "^3.10.1",
     "yaml": "^2.8.1",
-    "@nextclaw/core": "0.12.13-beta.0",
-    "@nextclaw/kernel": "0.1.2-beta.0",
-    "@nextclaw/mcp": "0.1.77",
-    "@nextclaw/ncp": "0.5.5",
-    "@nextclaw/ncp-mcp": "0.1.79",
-    "@nextclaw/remote": "0.1.89",
-    "@nextclaw/openclaw-compat": "1.0.12",
-    "@nextclaw/server": "0.12.12",
-    "@nextclaw/ncp-toolkit": "0.5.10",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.5",
-    "@nextclaw/ncp-agent-runtime": "0.3.15",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.4",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.4",
-    "@nextclaw/runtime": "0.2.44"
+    "@nextclaw/companion": "0.1.1-beta.5",
+    "@nextclaw/core": "0.12.13-beta.4",
+    "@nextclaw/kernel": "0.1.2-beta.5",
+    "@nextclaw/mcp": "0.1.78-beta.4",
+    "@nextclaw/ncp": "0.5.6-beta.3",
+    "@nextclaw/ncp-mcp": "0.1.80-beta.4",
+    "@nextclaw/ncp-agent-runtime": "0.3.16-beta.4",
+    "@nextclaw/ncp-toolkit": "0.5.11-beta.3",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.5-beta.4",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.5-beta.4",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.6-beta.4",
+    "@nextclaw/openclaw-compat": "1.0.13-beta.5",
+    "@nextclaw/remote": "0.1.90-beta.5",
+    "@nextclaw/runtime": "0.2.45-beta.3",
+    "@nextclaw/server": "0.12.13-beta.5"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
@@ -62,7 +63,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.6.3",
     "vitest": "^4.1.2",
-    "@nextclaw/ui": "0.12.19"
+    "@nextclaw/ui": "0.12.20-beta.5"
   },
   "scripts": {
     "dev": "tsx watch --tsconfig tsconfig.json src/cli/app/index.ts",

package/resources/USAGE.md

@@ -189,6 +189,7 @@ When the gateway is already running, config changes from the UI or `nextclaw con
 - `agents.defaults.model`
 - `agents.context.*`
 - `tools.*`
+- `companion.enabled`
 - `plugins.*` (v1 hot plugin runtime: plugin registry/channel gateways/channels are hot-reloaded)
 
 Restart is still required for:
@@ -211,6 +212,40 @@ Useful commands:
 
 UI note: **Model** page save persists `agents.defaults.model` only.
 
+### Companion feature
+
+NextClaw companion is a persistent system feature backed by `companion.enabled`, not just a one-off background process.
+
+Recommended control path:
+
+- Open the runtime settings page in the UI.
+- Toggle **Companion enabled**.
+- Save the runtime settings.
+
+Behavior:
+
+- enabling starts the companion immediately when a local runtime is available
+- disabling stops any running companion process
+- if it remains enabled, it auto-starts again after the NextClaw runtime restarts
+
+CLI equivalents:
+
+```bash
+nextclaw companion enable
+nextclaw companion disable
+nextclaw companion status --json
+```
+
+Lower-level process controls are also available:
+
+```bash
+nextclaw companion start
+nextclaw companion stop
+```
+
+Use `enable/disable` when you want the feature state to persist in config.
+Use `start/stop` only for direct process control or debugging.
+
 ### Multi-agent routing & session isolation (OpenClaw-aligned)
 
 For agent identities themselves, do **not** create them through `Routing & Runtime` or direct `agents.list` edits.
@@ -464,6 +499,11 @@ Skill loading contract:
 | `nextclaw start` | Start gateway + UI in the background |
 | `nextclaw restart` | Restart the background service with optional start flags |
 | `nextclaw stop` | Stop the background service |
+| `nextclaw companion enable` | Persistently enable the companion feature and start it when a local runtime is available |
+| `nextclaw companion disable` | Persistently disable the companion feature and stop any running companion process |
+| `nextclaw companion status` | Show current companion process/config status (`--json`) |
+| `nextclaw companion start` | Start the companion process without changing the persisted feature toggle |
+| `nextclaw companion stop` | Stop the companion process without changing the persisted feature toggle (`--force` supported) |
 | `nextclaw service install-systemd --user` | Install a user-level Linux `systemd` service for NextClaw |
 | `sudo nextclaw service install-systemd --system` | Install a system-wide Linux `systemd` service for NextClaw |
 | `nextclaw service uninstall-systemd --user` | Remove a user-level Linux `systemd` service |
@@ -531,7 +571,7 @@ Autostart notes:
 
 - `npm i -g nextclaw` installs the CLI only. It does not register host autostart by itself.
 - On Linux, use `nextclaw service install-systemd --user` for a user-level login autostart path.
-- On macOS, use `nextclaw service install-launch-agent` for a LaunchAgent-based login autostart path.
+- On macOS, use `nextclaw service install-launch-agent` for a LaunchAgent-based login autostart path. The agent runs once at login and does not supervise retries after the runtime exits.
 - On Windows, use `nextclaw service install-task` for a Scheduled Task based login autostart path.
 - For machine-wide Linux startup after boot, use `sudo nextclaw service install-systemd --system`.
 - `nextclaw service autostart status` and `nextclaw service autostart doctor` are read-only inspection commands; add `--user` or `--system` only when you need an explicit Linux `systemd` scope.