@nextclaw/service 0.1.7 → 0.1.9

package/dist/shared/services/runtime/service-managed-startup.service.js

@@ -1,71 +1,19 @@
+import { createTopLevelNextclawCommandEnv } from "../../utils/top-level-nextclaw-command-env.utils.js";
 import { isProcessRunning, openBrowser, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, waitForExit } from "../../utils/cli.utils.js";
-import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
 import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
-import { probeHealthEndpoint } from "../../utils/service-port-probe.utils.js";
+import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
 import { resolveCliSubcommandLaunch } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
-import { createTopLevelNextclawCommandEnv } from "../../utils/top-level-nextclaw-command-env.utils.js";
 import { writeInitialManagedServiceState, writeReadyManagedServiceState } from "./utils/service-remote-runtime.utils.js";
-import { spawn } from "node:child_process";
-import { dirname } from "node:path";
+import { resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate } from "./utils/managed-service-routing.utils.js";
+import { probeHealthEndpoint } from "../../utils/service-port-probe.utils.js";
 import * as NextclawCore from "@nextclaw/core";
 import { FileLogSink } from "@nextclaw/core";
 import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { spawn } from "node:child_process";
 //#region src/shared/services/runtime/service-managed-startup.service.ts
 const { APP_NAME: APP_NAME$1, loadConfig: loadConfig$1 } = NextclawCore;
-function resolveManagedServiceReadySnapshot(params) {
-	const { snapshot, readLocalUiRuntimeState, isProcessRunningFn: providedIsProcessRunningFn } = params;
-	const localUiRuntimeState = (readLocalUiRuntimeState ?? localUiRuntimeStore.read)();
-	const isProcessRunningFn = providedIsProcessRunningFn ?? isProcessRunning;
-	if (!localUiRuntimeState || typeof localUiRuntimeState.pid !== "number" || !Number.isFinite(localUiRuntimeState.pid) || localUiRuntimeState.uiPort !== snapshot.uiPort || !isProcessRunningFn(localUiRuntimeState.pid)) return snapshot;
-	return {
-		...snapshot,
-		pid: localUiRuntimeState.pid,
-		uiUrl: localUiRuntimeState.uiUrl,
-		apiUrl: localUiRuntimeState.apiUrl,
-		uiHost: localUiRuntimeState.uiHost ?? snapshot.uiHost,
-		uiPort: localUiRuntimeState.uiPort ?? snapshot.uiPort
-	};
-}
-function toObjectRecord(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-	return value;
-}
-function hasSessionRoutingMetadata(params) {
-	const context = toObjectRecord(params.metadata.last_delivery_context) ?? {};
-	const hasPrimaryRoute = Boolean(params.normalizeOptionalString(context.channel)) && Boolean(params.normalizeOptionalString(context.chatId));
-	const hasFallbackRoute = Boolean(params.normalizeOptionalString(params.metadata.last_channel)) && Boolean(params.normalizeOptionalString(params.metadata.last_to));
-	return hasPrimaryRoute || hasFallbackRoute;
-}
-function resolveManagedServiceUiBinding(state) {
-	try {
-		const parsed = new URL(state.uiUrl);
-		const parsedPort = Number(parsed.port || 80);
-		return {
-			host: state.uiHost ?? parsed.hostname,
-			port: Number.isFinite(parsedPort) ? parsedPort : state.uiPort ?? 55667
-		};
-	} catch {
-		return {
-			host: state.uiHost ?? "127.0.0.1",
-			port: state.uiPort ?? 55667
-		};
-	}
-}
-function resolveSessionRouteCandidate(params) {
-	const sessionRecord = toObjectRecord(params.session);
-	const key = params.normalizeOptionalString(sessionRecord?.key);
-	if (!key || key.startsWith("cli:")) return null;
-	if (!hasSessionRoutingMetadata({
-		metadata: toObjectRecord(sessionRecord?.metadata) ?? {},
-		normalizeOptionalString: params.normalizeOptionalString
-	})) return null;
-	const updatedAtRaw = params.normalizeOptionalString(sessionRecord?.updated_at);
-	const updatedAt = updatedAtRaw ? Date.parse(updatedAtRaw) : NaN;
-	return {
-		key,
-		updatedAt: Number.isFinite(updatedAt) ? updatedAt : 0
-	};
-}
+const serviceStartupLogger = NextclawCore.getAppLogger("service.startup");
 function spawnManagedService(params) {
 	const { appName, config, uiConfig, uiUrl, apiUrl, healthUrl, startupTimeoutMs, resolveStartupTimeoutMs, appendStartupStage, printStartupFailureDiagnostics, resolveServiceLogPath } = params;
 	const logPath = resolveServiceLogPath();
@@ -119,6 +67,22 @@ function spawnManagedService(params) {
 		readinessTimeoutMs,
 		snapshot
 	});
+	serviceStartupLogger.info("runtime.process.started", {
+		runtimeKind: "managed-service",
+		childPid: child.pid,
+		uiUrl,
+		apiUrl,
+		uiHost: uiConfig.host,
+		uiPort: uiConfig.port,
+		entrypoint: `${cliLaunch.command} ${childArgs.join(" ")}`
+	});
+	serviceStartupLogger.info("service_state.written", {
+		runtimeKind: "managed-service",
+		childPid: child.pid,
+		statePath: managedServiceStateStore.path,
+		uiUrl,
+		apiUrl
+	});
 	return {
 		child,
 		logPath,
@@ -162,6 +126,7 @@ async function reportManagedServiceStart(params) {
 var ManagedServiceCommandService = class {
 	loggingRuntime = NextclawCore.getLoggingRuntime();
 	serviceLogger = this.loggingRuntime.getLogger("service");
+	startupLogger = this.serviceLogger.child("startup");
 	constructor(deps) {
 		this.deps = deps;
 	}
@@ -237,6 +202,13 @@ var ManagedServiceCommandService = class {
 			return;
 		}
 		console.log(`Stopping ${APP_NAME$1} (PID ${state.pid})...`);
+		this.serviceLogger.info("runtime.process.stop_requested", {
+			runtimeKind: "managed-service",
+			pid: state.pid,
+			reason: "nextclaw-stop-command",
+			uiUrl: state.uiUrl,
+			apiUrl: state.apiUrl
+		});
 		try {
 			process.kill(state.pid, "SIGTERM");
 		} catch (error) {
@@ -244,6 +216,14 @@ var ManagedServiceCommandService = class {
 			return;
 		}
 		if (!await waitForExit(state.pid, 3e3)) {
+			this.serviceLogger.warn("runtime.process.stop_requested", {
+				runtimeKind: "managed-service",
+				pid: state.pid,
+				reason: "nextclaw-stop-command-force",
+				signal: "SIGKILL",
+				uiUrl: state.uiUrl,
+				apiUrl: state.apiUrl
+			});
 			try {
 				process.kill(state.pid, "SIGKILL");
 			} catch (error) {
@@ -254,6 +234,13 @@ var ManagedServiceCommandService = class {
 		}
 		managedServiceStateStore.clear();
 		localUiRuntimeStore.clearIfOwnedByProcess(state.pid);
+		this.serviceLogger.info("service_state.cleared", {
+			runtimeKind: "managed-service",
+			pid: state.pid,
+			statePath: managedServiceStateStore.path,
+			uiUrl: state.uiUrl,
+			apiUrl: state.apiUrl
+		});
 		console.log(`✓ ${APP_NAME$1} stopped`);
 	};
 	handleExistingManagedService = async (params) => {
@@ -348,13 +335,22 @@ var ManagedServiceCommandService = class {
 		}
 		startup.child.unref();
 		const readySnapshot = resolveManagedServiceReadySnapshot({ snapshot: startup.snapshot });
+		const state = writeReadyManagedServiceState({
+			readinessTimeoutMs: startup.readinessTimeoutMs,
+			readiness,
+			snapshot: readySnapshot
+		});
+		this.startupLogger.info("runtime.process.ready", {
+			runtimeKind: "managed-service",
+			pid: state.pid,
+			uiUrl: state.uiUrl,
+			apiUrl: state.apiUrl,
+			startupState: state.startupState,
+			readinessTimeoutMs: startup.readinessTimeoutMs
+		});
 		await reportManagedServiceStart({
 			appName: APP_NAME$1,
-			state: writeReadyManagedServiceState({
-				readinessTimeoutMs: startup.readinessTimeoutMs,
-				readiness,
-				snapshot: readySnapshot
-			}),
+			state,
 			uiConfig,
 			uiUrl,
 			apiUrl,
@@ -401,7 +397,7 @@ var ManagedServiceCommandService = class {
 	};
 	appendStartupStage = (logPath, message) => {
 		try {
-			this.serviceLogger.child("startup").info(message, { logPath });
+			this.startupLogger.info(message, { logPath });
 		} catch (error) {
 			const detail = error instanceof Error ? error.message : String(error);
 			console.error(`Warning: failed to write startup diagnostics log (${logPath}): ${detail}`);

package/dist/shared/services/runtime/utils/managed-service-routing.utils.d.ts

@@ -0,0 +1,30 @@
+import { ManagedServiceState } from "../../../stores/managed-service-state.store.js";
+import { localUiRuntimeStore } from "../../../stores/local-ui-runtime.store.js";
+
+//#region src/shared/services/runtime/utils/managed-service-routing.utils.d.ts
+type ManagedServiceSnapshot = {
+  pid: number;
+  uiUrl: string;
+  apiUrl: string;
+  uiHost: string;
+  uiPort: number;
+  logPath: string;
+};
+declare function resolveManagedServiceReadySnapshot(params: {
+  snapshot: ManagedServiceSnapshot;
+  readLocalUiRuntimeState?: typeof localUiRuntimeStore.read;
+  isProcessRunningFn?: (pid: number) => boolean;
+}): ManagedServiceSnapshot;
+declare function resolveManagedServiceUiBinding(state: ManagedServiceState): {
+  host: string;
+  port: number;
+};
+declare function resolveSessionRouteCandidate(params: {
+  session: unknown;
+  normalizeOptionalString: (value: unknown) => string | undefined;
+}): {
+  key: string;
+  updatedAt: number;
+} | null;
+//#endregion
+export { ManagedServiceSnapshot, resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate };

package/dist/shared/services/runtime/utils/managed-service-routing.utils.js

@@ -0,0 +1,62 @@
+import { isProcessRunning } from "../../../utils/cli.utils.js";
+import "../../../stores/managed-service-state.store.js";
+import { localUiRuntimeStore } from "../../../stores/local-ui-runtime.store.js";
+//#region src/shared/services/runtime/utils/managed-service-routing.utils.ts
+function resolveManagedServiceReadySnapshot(params) {
+	const { snapshot, readLocalUiRuntimeState, isProcessRunningFn: providedIsProcessRunningFn } = params;
+	const localUiRuntimeState = (readLocalUiRuntimeState ?? localUiRuntimeStore.read)();
+	const isProcessRunningFn = providedIsProcessRunningFn ?? isProcessRunning;
+	if (!localUiRuntimeState || typeof localUiRuntimeState.pid !== "number" || !Number.isFinite(localUiRuntimeState.pid) || localUiRuntimeState.uiPort !== snapshot.uiPort || !isProcessRunningFn(localUiRuntimeState.pid)) return snapshot;
+	return {
+		...snapshot,
+		pid: localUiRuntimeState.pid,
+		uiUrl: localUiRuntimeState.uiUrl,
+		apiUrl: localUiRuntimeState.apiUrl,
+		uiHost: localUiRuntimeState.uiHost ?? snapshot.uiHost,
+		uiPort: localUiRuntimeState.uiPort ?? snapshot.uiPort
+	};
+}
+function toObjectRecord(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	return value;
+}
+function hasSessionRoutingMetadata(params) {
+	const { metadata, normalizeOptionalString } = params;
+	const context = toObjectRecord(metadata.last_delivery_context) ?? {};
+	const hasPrimaryRoute = Boolean(normalizeOptionalString(context.channel)) && Boolean(normalizeOptionalString(context.chatId));
+	const hasFallbackRoute = Boolean(normalizeOptionalString(metadata.last_channel)) && Boolean(normalizeOptionalString(metadata.last_to));
+	return hasPrimaryRoute || hasFallbackRoute;
+}
+function resolveManagedServiceUiBinding(state) {
+	try {
+		const parsed = new URL(state.uiUrl);
+		const parsedPort = Number(parsed.port || 80);
+		return {
+			host: state.uiHost ?? parsed.hostname,
+			port: Number.isFinite(parsedPort) ? parsedPort : state.uiPort ?? 55667
+		};
+	} catch {
+		return {
+			host: state.uiHost ?? "127.0.0.1",
+			port: state.uiPort ?? 55667
+		};
+	}
+}
+function resolveSessionRouteCandidate(params) {
+	const { session, normalizeOptionalString } = params;
+	const sessionRecord = toObjectRecord(session);
+	const key = normalizeOptionalString(sessionRecord?.key);
+	if (!key || key.startsWith("cli:")) return null;
+	if (!hasSessionRoutingMetadata({
+		metadata: toObjectRecord(sessionRecord?.metadata) ?? {},
+		normalizeOptionalString
+	})) return null;
+	const updatedAtRaw = normalizeOptionalString(sessionRecord?.updated_at);
+	const updatedAt = updatedAtRaw ? Date.parse(updatedAtRaw) : NaN;
+	return {
+		key,
+		updatedAt: Number.isFinite(updatedAt) ? updatedAt : 0
+	};
+}
+//#endregion
+export { resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate };

package/dist/shared/services/runtime/utils/service-remote-runtime.utils.js

@@ -1,10 +1,10 @@
 import { isProcessRunning, resolveUiApiBase } from "../../../utils/cli.utils.js";
 import { managedServiceStateStore } from "../../../stores/managed-service-state.store.js";
 import { buildNextclawConfiguredRemoteState, createNextclawRemoteConnector, createNextclawRemoteStatusStore } from "../../../../commands/remote/utils/remote-runtime-support.utils.js";
-import { dirname, resolve } from "node:path";
 import { getDataDir } from "@nextclaw/core";
-import { closeSync, existsSync, mkdirSync, openSync, readFileSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
 import { RemoteServiceModule } from "@nextclaw/remote";
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 //#region src/shared/services/runtime/utils/service-remote-runtime.utils.ts
 function resolveRemoteOwnershipLockPath() {
 	return resolve(getDataDir(), "run", "remote-owner.lock.json");

package/dist/shared/services/session/service-deferred-ncp-agent.service.d.ts

@@ -1,5 +1,5 @@
-import { UiNcpAgent } from "@nextclaw/server";
 import { AgentRuntimeHandle } from "@nextclaw/kernel";
+import { UiNcpAgent } from "@nextclaw/server";
 
 //#region src/shared/services/session/service-deferred-ncp-agent.service.d.ts
 type DeferredUiNcpAgentController = {

package/dist/shared/services/ui/companion-runtime.service.d.ts

@@ -9,6 +9,7 @@ declare class CompanionRuntimeService {
   constructor(runtimeStore?: CompanionRuntimeStore, uiDiscoveryService?: LocalUiDiscoveryService);
   readonly getRunningState: () => CompanionRuntimeState | null;
   readonly resolveDiscoveredBaseUrl: () => string | null;
+  readonly isAvailable: () => boolean;
   readonly applyConfig: (config: Config) => Promise<void>;
   readonly updateEnabled: (enabled: boolean, options?: {
     baseUrl?: string;
@@ -25,6 +26,7 @@ declare class CompanionRuntimeService {
   readonly printStarted: (state: CompanionRuntimeState) => void;
   readonly printStopped: (stopped: boolean) => void;
   private readonly killProcess;
+  private readonly ensureStartedIfAvailable;
   private readonly resolveLaunchSpec;
   private readonly waitForRunningState;
 }

package/dist/shared/services/ui/companion-runtime.service.js

@@ -1,13 +1,22 @@
 import { isProcessRunning } from "../../utils/cli.utils.js";
-import { companionRuntimeStore } from "../../stores/companion-runtime.store.js";
 import { localUiDiscoveryService } from "./local-ui-discovery.service.js";
+import { companionRuntimeStore } from "../../stores/companion-runtime.store.js";
 import { createRequire } from "node:module";
-import { spawn } from "node:child_process";
-import { dirname, resolve } from "node:path";
 import { APP_NAME, getConfigPath, loadConfig, saveConfig } from "@nextclaw/core";
 import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { spawn } from "node:child_process";
 //#region src/shared/services/ui/companion-runtime.service.ts
 const require = createRequire(import.meta.url);
+var CompanionUnavailableError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "CompanionUnavailableError";
+	}
+};
+function isCompanionUnavailableError(error) {
+	return error instanceof CompanionUnavailableError;
+}
 var CompanionRuntimeService = class {
 	constructor(runtimeStore = companionRuntimeStore, uiDiscoveryService = localUiDiscoveryService) {
 		this.runtimeStore = runtimeStore;
@@ -25,12 +34,21 @@ var CompanionRuntimeService = class {
 	resolveDiscoveredBaseUrl = () => {
 		return this.uiDiscoveryService.resolveApiBase();
 	};
+	isAvailable = () => {
+		try {
+			this.resolveLaunchSpec();
+			return true;
+		} catch (error) {
+			if (isCompanionUnavailableError(error)) return false;
+			throw error;
+		}
+	};
 	applyConfig = async (config) => {
 		if (!config.companion.enabled) {
 			await this.ensureStopped();
 			return;
 		}
-		await this.ensureStarted({ baseUrl: this.uiDiscoveryService.resolveLocalOrigin(config) });
+		await this.ensureStartedIfAvailable({ baseUrl: this.uiDiscoveryService.resolveLocalOrigin(config) });
 	};
 	updateEnabled = async (enabled, options = {}) => {
 		const config = loadConfig(getConfigPath());
@@ -45,11 +63,11 @@ var CompanionRuntimeService = class {
 		if (enabled) {
 			const explicitBaseUrl = options.baseUrl?.trim();
 			if (explicitBaseUrl) {
-				await this.ensureStarted({ baseUrl: explicitBaseUrl });
+				await this.ensureStartedIfAvailable({ baseUrl: explicitBaseUrl });
 				return next;
 			}
 			const discoveredBaseUrl = this.uiDiscoveryService.resolveApiBase();
-			if (discoveredBaseUrl) await this.ensureStarted({ baseUrl: discoveredBaseUrl });
+			if (discoveredBaseUrl) await this.ensureStartedIfAvailable({ baseUrl: discoveredBaseUrl });
 			return next;
 		}
 		await this.ensureStopped();
@@ -120,11 +138,25 @@ var CompanionRuntimeService = class {
 	killProcess = (pid, force) => {
 		process.kill(pid, force ? "SIGKILL" : "SIGTERM");
 	};
+	ensureStartedIfAvailable = async (options) => {
+		try {
+			return await this.ensureStarted(options);
+		} catch (error) {
+			if (!isCompanionUnavailableError(error)) throw error;
+			console.warn(error.message);
+			return null;
+		}
+	};
 	resolveLaunchSpec = () => {
-		const packageJsonPath = require.resolve("@nextclaw/companion/package.json");
+		let packageJsonPath;
+		try {
+			packageJsonPath = require.resolve("@nextclaw/companion/package.json");
+		} catch {
+			throw new CompanionUnavailableError("@nextclaw/companion is not installed. Install it separately to use the companion shell.");
+		}
 		const packageRoot = dirname(packageJsonPath);
 		const mainPath = resolve(packageRoot, "dist", "src", "main.js");
-		if (!existsSync(mainPath)) throw new Error(`Companion app build is missing at ${mainPath}. Build @nextclaw/companion first.`);
+		if (!existsSync(mainPath)) throw new CompanionUnavailableError(`Companion app build is missing at ${mainPath}. Install or build @nextclaw/companion separately to use the companion shell.`);
 		return {
 			command: createRequire(packageJsonPath)("electron"),
 			args: [packageRoot]

package/dist/shared/services/ui/local-ui-discovery.service.js

@@ -1,6 +1,6 @@
 import { isProcessRunning } from "../../utils/cli.utils.js";
-import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
 import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
+import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
 import { resolveLocalUiBaseUrl } from "@nextclaw/core";
 //#region src/shared/services/ui/local-ui-discovery.service.ts
 var LocalUiDiscoveryService = class {

package/dist/shared/services/ui/npm-runtime-update-host.service.js

@@ -1,9 +1,9 @@
 import { NpmRuntimeBundleLayoutStore } from "../../../launcher/npm-runtime-bundle-layout.store.js";
 import { NpmRuntimeBundleService } from "../../../launcher/npm-runtime-bundle.service.js";
-import { NpmRuntimeUpdateSourceService } from "../../../launcher/npm-runtime-update-source.service.js";
-import { NpmRuntimeUpdateStateStore } from "../../../launcher/npm-runtime-update-state.store.js";
 import { NpmRuntimeUpdateManager } from "../../../launcher/npm-runtime-update.manager.js";
 import { NpmRuntimeUpdateService } from "../../../launcher/npm-runtime-update.service.js";
+import { NpmRuntimeUpdateSourceService } from "../../../launcher/npm-runtime-update-source.service.js";
+import { NpmRuntimeUpdateStateStore } from "../../../launcher/npm-runtime-update-state.store.js";
 import { NextclawDistributionService } from "../runtime/nextclaw-distribution.service.js";
 import { requestManagedServiceRestart } from "./service-remote-access.service.js";
 import { eventKeys } from "@nextclaw/shared";

package/dist/shared/services/ui/runtime-control-host.service.js

@@ -1,6 +1,6 @@
-import { pendingRestartStore } from "../../stores/pending-restart.store.js";
 import { controlRemoteService, resolveRemoteServiceView } from "../../../commands/remote/services/remote-service-control.service.js";
 import { requestManagedServiceRestart } from "./service-remote-access.service.js";
+import { pendingRestartStore } from "../../stores/pending-restart.store.js";
 //#region src/shared/services/ui/runtime-control-host.service.ts
 const MANAGED_SERVICE_OWNER_LABEL = "Managed local service";
 const DESKTOP_APP_ONLY_REASON = "App restart is only available in the desktop shell.";

package/dist/shared/services/ui/service-remote-access.service.js

@@ -1,7 +1,7 @@
-import { RemoteAccessHost } from "../../../commands/remote/services/remote-access-host.service.js";
 import { RemoteCommands } from "../../../commands/remote/index.js";
 import { PlatformAuthCommands } from "../../../commands/platform-auth/services/platform-auth-commands.service.js";
 import "../../../commands/platform-auth/index.js";
+import { RemoteAccessHost } from "../../../commands/remote/services/remote-access-host.service.js";
 //#region src/shared/services/ui/service-remote-access.service.ts
 function requestManagedServiceRestart(requestRestart, options = {}) {
 	const uiPort = typeof options.uiPort === "number" && Number.isFinite(options.uiPort) ? Math.floor(options.uiPort) : void 0;

package/dist/shared/services/workspace/workspace-manager.service.js

@@ -1,9 +1,9 @@
 import { findExecutableOnPath } from "../../utils/cli.utils.js";
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { dirname, join, resolve } from "node:path";
 import { APP_NAME, getDataDir } from "@nextclaw/core";
 import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
 //#region src/shared/services/workspace/workspace-manager.service.ts
 var WorkspaceManager = class {
 	constructor(logo) {

package/dist/shared/stores/companion-runtime.store.js

@@ -1,6 +1,6 @@
-import { resolve } from "node:path";
 import { getDataDir } from "@nextclaw/core";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
 //#region src/shared/stores/companion-runtime.store.ts
 var CompanionRuntimeStore = class {
 	get path() {

package/dist/shared/stores/local-ui-runtime.store.js

@@ -1,7 +1,7 @@
 import { resolveUiApiBase } from "../utils/cli.utils.js";
-import { resolve } from "node:path";
 import { getDataDir } from "@nextclaw/core";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
 //#region src/shared/stores/local-ui-runtime.store.ts
 var LocalUiRuntimeStore = class {
 	get path() {

package/dist/shared/stores/managed-service-state.store.js

@@ -1,6 +1,6 @@
-import { resolve } from "node:path";
 import { getDataDir } from "@nextclaw/core";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
 //#region src/shared/stores/managed-service-state.store.ts
 var ManagedServiceStateStore = class {
 	get path() {

package/dist/shared/types/cli.types.d.ts

@@ -16,19 +16,6 @@ type StartCommandOptions = {
   open?: boolean;
   startTimeout?: string | number;
 };
-type CompanionStartCommandOptions = {
-  baseUrl?: string;
-};
-type CompanionEnableCommandOptions = {
-  baseUrl?: string;
-};
-type CompanionDisableCommandOptions = Record<string, never>;
-type CompanionStatusCommandOptions = {
-  json?: boolean;
-};
-type CompanionStopCommandOptions = {
-  force?: boolean;
-};
 type ServiceAutostartCommandOptions = {
   user?: boolean;
   system?: boolean;
@@ -69,6 +56,7 @@ type MarketplaceSkillsRecommendCommandOptions = {
 type UpdateCommandOptions = {
   check?: boolean;
   download?: boolean;
+  downloadOnly?: boolean;
   apply?: boolean;
   channel?: string;
   manifestUrl?: string;
@@ -292,4 +280,4 @@ type RequestRestartParams = {
   mode?: "execute" | "notify";
 };
 //#endregion
-export { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsLoginOptions, CompanionDisableCommandOptions, CompanionEnableCommandOptions, CompanionStartCommandOptions, CompanionStatusCommandOptions, CompanionStopCommandOptions, ConfigGetOptions, ConfigSetOptions, CronAddOptions, DoctorCommandOptions, GatewayCommandOptions, HealthProbe, LoginCommandOptions, LogsTailCommandOptions, MarketplaceSkillsRecommendCommandOptions, MarketplaceSkillsSearchCommandOptions, McpAddCommandOptions, McpDoctorOptions, McpListOptions, PluginsInfoOptions, PluginsInstallOptions, PluginsListOptions, PluginsUninstallOptions, type RemoteConnectCommandOptions, type RemoteDoctorCommandOptions, type RemoteEnableCommandOptions, type RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions };
+export { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsLoginOptions, ConfigGetOptions, ConfigSetOptions, CronAddOptions, DoctorCommandOptions, GatewayCommandOptions, HealthProbe, LoginCommandOptions, LogsTailCommandOptions, MarketplaceSkillsRecommendCommandOptions, MarketplaceSkillsSearchCommandOptions, McpAddCommandOptions, McpDoctorOptions, McpListOptions, PluginsInfoOptions, PluginsInstallOptions, PluginsListOptions, PluginsUninstallOptions, type RemoteConnectCommandOptions, type RemoteDoctorCommandOptions, type RemoteEnableCommandOptions, type RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions };

package/dist/shared/utils/cli.utils.js

@@ -1,8 +1,8 @@
 import { getPackageVersion } from "./package/package-manifest.utils.js";
-import { spawn, spawnSync } from "node:child_process";
-import { join, resolve } from "node:path";
 import { createExternalCommandEnv, getLogsPath, resolveLocalUiBaseUrl } from "@nextclaw/core";
 import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { spawn, spawnSync } from "node:child_process";
 import { isIP } from "node:net";
 //#region src/shared/utils/cli.utils.ts
 function resolveUiConfig(config, overrides) {

package/dist/shared/utils/marketplace/cli-subcommand-launch.utils.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
 import { extname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 //#region src/shared/utils/marketplace/cli-subcommand-launch.utils.ts
 const require = createRequire(import.meta.url);
 const TYPESCRIPT_EXTENSIONS = new Set([

package/dist/shared/utils/package/package-manifest.utils.js

@@ -1,7 +1,7 @@
-import { fileURLToPath } from "node:url";
-import { join, resolve } from "node:path";
 import { getPackageVersion as getPackageVersion$1 } from "@nextclaw/core";
 import { readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 //#region src/shared/utils/package/package-manifest.utils.ts
 function readPackageManifest(pkgPath) {
 	try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/service",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "private": false,
   "description": "NextClaw long-running service host and runtime lifecycle.",
   "type": "module",
@@ -26,6 +26,7 @@
   ],
   "nextclaw": {
     "builtinExtensions": [
+      "@nextclaw/channel-extension-feishu",
       "@nextclaw/channel-extension-weixin"
     ]
   },
@@ -34,23 +35,24 @@
     "commander": "^12.1.0",
     "jszip": "^3.10.1",
     "yaml": "^2.8.1",
-    "@nextclaw/channel-extension-weixin": "0.1.3",
-    "@nextclaw/kernel": "0.1.5",
-    "@nextclaw/core": "0.12.16",
-    "@nextclaw/ncp": "0.5.9",
-    "@nextclaw/ncp-agent-runtime": "0.3.19",
-    "@nextclaw/mcp": "0.1.81",
-    "@nextclaw/ncp-mcp": "0.1.83",
-    "@nextclaw/ncp-http-agent-server": "0.3.21",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.8",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.8",
-    "@nextclaw/ncp-toolkit": "0.5.14",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.9",
-    "@nextclaw/openclaw-compat": "1.0.16",
-    "@nextclaw/remote": "0.1.93",
-    "@nextclaw/shared": "0.1.3",
-    "@nextclaw/server": "0.12.16",
-    "@nextclaw/runtime": "0.2.48"
+    "@nextclaw/channel-extension-feishu": "0.1.1",
+    "@nextclaw/core": "0.12.17",
+    "@nextclaw/channel-extension-weixin": "0.1.4",
+    "@nextclaw/ncp-agent-runtime": "0.3.20",
+    "@nextclaw/ncp": "0.5.10",
+    "@nextclaw/ncp-mcp": "0.1.84",
+    "@nextclaw/ncp-http-agent-server": "0.3.22",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.9",
+    "@nextclaw/ncp-toolkit": "0.5.15",
+    "@nextclaw/mcp": "0.1.82",
+    "@nextclaw/kernel": "0.1.6",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.10",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.9",
+    "@nextclaw/openclaw-compat": "1.0.17",
+    "@nextclaw/runtime": "0.2.49",
+    "@nextclaw/shared": "0.1.4",
+    "@nextclaw/remote": "0.1.94",
+    "@nextclaw/server": "0.12.17"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
@@ -60,7 +62,7 @@
     "vitest": "^4.1.2"
   },
   "scripts": {
-    "build": "tsdown $(find src -name '*.ts' ! -name '*.test.ts' ! -path '*/tests/*') --dts --clean --target es2022 --no-fixedExtension --unbundle",
+    "build": "tsdown \"src/**/*.ts\" \"!src/**/*.test.ts\" \"!src/**/tests/**\" --dts --clean --target es2022 --no-fixedExtension --unbundle",
     "lint": "eslint .",
     "tsc": "tsc -p tsconfig.json",
     "test": "vitest"

package/dist/cli/commands/companion/index.d.ts

@@ -1,15 +0,0 @@
-import { CompanionDisableCommandOptions, CompanionEnableCommandOptions, CompanionStartCommandOptions, CompanionStatusCommandOptions, CompanionStopCommandOptions } from "../../../shared/types/cli.types.js";
-import { CompanionProcessService } from "./services/companion-process.service.js";
-
-//#region src/cli/commands/companion/index.d.ts
-declare class CompanionCommands {
-  private readonly companionProcessService;
-  constructor(companionProcessService?: CompanionProcessService);
-  readonly start: (options?: CompanionStartCommandOptions) => Promise<void>;
-  readonly enable: (options?: CompanionEnableCommandOptions) => Promise<void>;
-  readonly disable: (options?: CompanionDisableCommandOptions) => Promise<void>;
-  readonly status: (options?: CompanionStatusCommandOptions) => Promise<void>;
-  readonly stop: (options?: CompanionStopCommandOptions) => Promise<void>;
-}
-//#endregion
-export { CompanionCommands };