@nextclaw/service 0.1.8 → 0.1.10

package/dist/commands/channel/channel-list-view.service.d.ts

@@ -0,0 +1,39 @@
+import { Config } from "@nextclaw/core";
+import { PluginChannelBinding } from "@nextclaw/openclaw-compat";
+
+//#region src/commands/channel/channel-list-view.service.d.ts
+type ChannelListEntry = {
+  id: string;
+  label: string;
+  pluginId: string;
+  enabled: boolean;
+  outbound: {
+    text: boolean;
+  };
+  auth: {
+    login: boolean;
+  };
+  defaultAccountId?: string;
+};
+type ChannelListOutput = {
+  channels: ChannelListEntry[];
+};
+declare class ChannelListViewService {
+  private readonly params;
+  constructor(params: {
+    channelLabels: Record<string, string>;
+  });
+  build: (params: {
+    config: Config;
+    workspaceDir: string;
+    pluginBindings: PluginChannelBinding[];
+  }) => ChannelListOutput;
+  private toManifestChannelSources;
+  private toPluginChannelSource;
+  private toChannelListEntry;
+  private mergeChannelSources;
+  private discoverExtensionManifests;
+  private resolveDefaultAccountId;
+}
+//#endregion
+export { ChannelListEntry, ChannelListOutput, ChannelListViewService };

package/dist/commands/channel/channel-list-view.service.js

@@ -0,0 +1,85 @@
+import { resolveChannelConfigView } from "./channel-config-view.js";
+import { ExtensionManifestDiscoveryService } from "../../shared/services/extensions/extension-lifecycle.service.js";
+import { resolveExtensionManifestRoots } from "../../shared/services/extensions/service-extension-runtime.service.js";
+//#region src/commands/channel/channel-list-view.service.ts
+function readRecord(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return;
+	return value;
+}
+function readString(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+var ChannelListViewService = class {
+	constructor(params) {
+		this.params = params;
+	}
+	build = (params) => {
+		const { config, pluginBindings, workspaceDir } = params;
+		const sources = this.mergeChannelSources(pluginBindings.map(this.toPluginChannelSource), this.toManifestChannelSources(this.discoverExtensionManifests(config, workspaceDir)));
+		const channelConfigs = readRecord(resolveChannelConfigView(config, pluginBindings).channels) ?? {};
+		return { channels: sources.map((source) => this.toChannelListEntry(source, channelConfigs[source.id])).sort((left, right) => left.id.localeCompare(right.id)) };
+	};
+	toManifestChannelSources = (manifests) => {
+		const sources = [];
+		for (const manifest of manifests) {
+			const channels = manifest.contributes?.channels ?? [];
+			for (const channel of channels) {
+				const channelId = readString(channel.id);
+				if (!channelId) continue;
+				sources.push({
+					pluginId: manifest.id,
+					id: channelId,
+					label: readString(channel.name) ?? this.params.channelLabels[channelId] ?? channelId,
+					outboundText: channel.outbound?.text === true,
+					login: Boolean(channel.auth)
+				});
+			}
+		}
+		return sources;
+	};
+	toPluginChannelSource = (binding) => ({
+		id: binding.channelId,
+		label: readString(binding.channel.meta?.label) ?? this.params.channelLabels[binding.channelId] ?? binding.channelId,
+		pluginId: binding.pluginId,
+		outboundText: typeof binding.channel.outbound?.sendText === "function",
+		login: typeof binding.channel.auth?.login === "function",
+		resolveDefaultAccountId: (channelConfig) => this.resolveDefaultAccountId(binding, channelConfig)
+	});
+	toChannelListEntry = (source, rawChannelConfig) => {
+		const channelConfig = readRecord(rawChannelConfig);
+		const defaultAccountId = readString(channelConfig?.defaultAccountId) ?? source.resolveDefaultAccountId?.(channelConfig);
+		return {
+			id: source.id,
+			label: source.label,
+			pluginId: source.pluginId,
+			enabled: channelConfig?.enabled === true,
+			outbound: { text: source.outboundText },
+			auth: { login: source.login },
+			...defaultAccountId ? { defaultAccountId } : {}
+		};
+	};
+	mergeChannelSources = (pluginSources, extensionSources) => {
+		const sourcesByChannelId = /* @__PURE__ */ new Map();
+		for (const source of [...pluginSources, ...extensionSources]) sourcesByChannelId.set(source.id, source);
+		return [...sourcesByChannelId.values()];
+	};
+	discoverExtensionManifests = (config, workspaceDir) => {
+		const discovery = new ExtensionManifestDiscoveryService();
+		const roots = resolveExtensionManifestRoots({
+			config,
+			workspace: workspaceDir
+		});
+		return discovery.discoverSync(roots);
+	};
+	resolveDefaultAccountId = (binding, channelConfig) => {
+		const configAdapter = binding.channel.config?.defaultAccountId;
+		if (!configAdapter) return;
+		try {
+			return readString(configAdapter({ channels: { [binding.channelId]: channelConfig ?? {} } }));
+		} catch {
+			return;
+		}
+	};
+};
+//#endregion
+export { ChannelListViewService };

package/dist/commands/channel/index.d.ts

@@ -1,18 +1,21 @@
-import { ChannelsAddOptions, ChannelsLoginOptions, RequestRestartParams } from "../../shared/types/cli.types.js";
+import { ChannelsAddOptions, ChannelsListOptions, ChannelsLoginOptions, RequestRestartParams } from "../../shared/types/cli.types.js";
 import { resolveChannelConfigView } from "./channel-config-view.js";
 
 //#region src/commands/channel/index.d.ts
 declare class ChannelCommands {
   private deps;
+  private readonly channelListView;
   constructor(deps: {
     logo: string;
     getBridgeDir: () => string;
     requestRestart: (params: RequestRestartParams) => Promise<void>;
   });
   status: () => void;
+  list: (opts?: ChannelsListOptions) => void;
   login: (opts?: ChannelsLoginOptions) => Promise<void>;
   private runLegacyBridgeLogin;
   private resolvePluginChannelContext;
+  private buildChannelListOutput;
   private loginPluginChannel;
   private clonePluginConfig;
   private assertValidPluginLoginResult;

package/dist/commands/channel/index.js

@@ -1,5 +1,6 @@
 import { loadPluginRegistry, mergePluginConfigView, toPluginConfigView as toPluginConfigView$1 } from "../plugin/index.js";
 import { resolveChannelConfigView } from "./channel-config-view.js";
+import { ChannelListViewService } from "./channel-list-view.service.js";
 import { getWorkspacePath, loadConfig, saveConfig } from "@nextclaw/core";
 import { buildPluginStatusReport, enablePluginInConfig, getPluginChannelBindings } from "@nextclaw/openclaw-compat";
 import { spawnSync } from "node:child_process";
@@ -23,6 +24,7 @@ function resolveChannelBindings(pluginRegistry) {
 	return getPluginChannelBindings(pluginRegistry);
 }
 var ChannelCommands = class {
+	channelListView = new ChannelListViewService({ channelLabels: CHANNEL_LABELS });
 	constructor(deps) {
 		this.deps = deps;
 	}
@@ -51,6 +53,23 @@ var ChannelCommands = class {
 			}
 		}
 	};
+	list = (opts = {}) => {
+		const output = this.buildChannelListOutput();
+		if (opts.json) {
+			console.log(JSON.stringify(output, null, 2));
+			return;
+		}
+		console.log("Channels");
+		for (const channel of output.channels) {
+			const flags = [
+				channel.enabled ? "enabled" : "disabled",
+				channel.outbound.text ? "outbound:text" : void 0,
+				channel.auth.login ? "login" : void 0,
+				channel.defaultAccountId ? `defaultAccountId=${channel.defaultAccountId}` : void 0
+			].filter(Boolean);
+			console.log(`- ${channel.id} (${channel.label}) [${flags.join(", ")}] plugin=${channel.pluginId}`);
+		}
+	};
 	login = async (opts = {}) => {
 		const channelId = opts.channel?.trim();
 		if (!channelId) {
@@ -92,6 +111,16 @@ var ChannelCommands = class {
 			bindings
 		};
 	};
+	buildChannelListOutput = () => {
+		const config = loadConfig();
+		const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+		const pluginRegistry = loadPluginRegistry(config, workspaceDir);
+		return this.channelListView.build({
+			config,
+			workspaceDir,
+			pluginBindings: resolveChannelBindings(pluginRegistry)
+		});
+	};
 	loginPluginChannel = async (config, channelContext, opts) => {
 		const { binding, bindings } = channelContext;
 		const login = binding.channel.auth?.login;

package/dist/commands/service/services/autostart/windows-task-autostart.service.js

@@ -375,7 +375,8 @@ const defaultRunCommand = async (command, args) => {
 				"ignore",
 				"pipe",
 				"pipe"
-			]
+			],
+			windowsHide: true
 		});
 		let stdout = "";
 		let stderr = "";

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { 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, RemoteConnectCommandOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions } from "./shared/types/cli.types.js";
+import { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsListOptions, ChannelsLoginOptions, ConfigGetOptions, ConfigSetOptions, CronAddOptions, DoctorCommandOptions, GatewayCommandOptions, HealthProbe, LoginCommandOptions, LogsTailCommandOptions, MarketplaceSkillsRecommendCommandOptions, MarketplaceSkillsSearchCommandOptions, McpAddCommandOptions, McpDoctorOptions, McpListOptions, PluginsInfoOptions, PluginsInstallOptions, PluginsListOptions, PluginsUninstallOptions, RemoteConnectCommandOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions } from "./shared/types/cli.types.js";
 import { NextclawServiceRuntime, NextclawServiceRuntimeOptions, runNextclawNpmRuntimeLauncher } from "./service-runtime.service.js";
 import { NextclawDistribution } from "./shared/types/distribution.types.js";
 import { NextclawDistributionService } from "./shared/services/runtime/nextclaw-distribution.service.js";
 import { readLearningLoopRuntimeConfig } from "@nextclaw/kernel";
-export { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsLoginOptions, ConfigGetOptions, ConfigSetOptions, CronAddOptions, DoctorCommandOptions, GatewayCommandOptions, HealthProbe, LoginCommandOptions, LogsTailCommandOptions, MarketplaceSkillsRecommendCommandOptions, MarketplaceSkillsSearchCommandOptions, McpAddCommandOptions, McpDoctorOptions, McpListOptions, type NextclawDistribution, NextclawDistributionService, NextclawServiceRuntime, type NextclawServiceRuntimeOptions, PluginsInfoOptions, PluginsInstallOptions, PluginsListOptions, PluginsUninstallOptions, RemoteConnectCommandOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions, readLearningLoopRuntimeConfig, runNextclawNpmRuntimeLauncher };
+export { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsListOptions, ChannelsLoginOptions, ConfigGetOptions, ConfigSetOptions, CronAddOptions, DoctorCommandOptions, GatewayCommandOptions, HealthProbe, LoginCommandOptions, LogsTailCommandOptions, MarketplaceSkillsRecommendCommandOptions, MarketplaceSkillsSearchCommandOptions, McpAddCommandOptions, McpDoctorOptions, McpListOptions, type NextclawDistribution, NextclawDistributionService, NextclawServiceRuntime, type NextclawServiceRuntimeOptions, PluginsInfoOptions, PluginsInstallOptions, PluginsListOptions, PluginsUninstallOptions, RemoteConnectCommandOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions, readLearningLoopRuntimeConfig, runNextclawNpmRuntimeLauncher };

package/dist/launcher/npm-runtime-bundle.types.d.ts

@@ -1,4 +1,4 @@
-import { UpdateManifest, UpdateProgress, UpdateSnapshot } from "@nextclaw/kernel/update-contract";
+import { UpdateManifest, UpdateProgress, UpdateSnapshot } from "@nextclaw/kernel";
 
 //#region src/launcher/npm-runtime-bundle.types.d.ts
 type NpmRuntimeBundleManifest = {

package/dist/launcher/npm-runtime-launcher.service.js

@@ -6,8 +6,8 @@ import { inferDefaultNpmRuntimeReleaseChannel } from "./npm-runtime-update-sourc
 import { NpmRuntimeUpdateStateStore } from "./npm-runtime-update-state.store.js";
 import { createExternalCommandEnv } from "@nextclaw/core";
 import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 //#region src/launcher/npm-runtime-launcher.service.ts
 var NpmRuntimeLauncher = class {
 	env;
@@ -24,7 +24,8 @@ var NpmRuntimeLauncher = class {
 			env: {
 				...createExternalCommandEnv(this.env),
 				NEXTCLAW_RUNTIME_BUNDLE_CHILD: "1"
-			}
+			},
+			windowsHide: true
 		});
 		process.exit(typeof result.status === "number" ? result.status : 1);
 	};

package/dist/launcher/npm-runtime-update-command.service.js

@@ -14,6 +14,7 @@ var NpmRuntimeUpdateCommandService = class {
 		return snapshot;
 	};
 	runManaged = async (opts) => {
+		const downloadOnly = Boolean(opts.downloadOnly || opts.download);
 		const distribution = NextclawDistributionService.get();
 		const source = new NpmRuntimeUpdateSourceService({ packagedPublicKeyPath: distribution.runtimeUpdatePublicKeyPath });
 		const launcherVersion = distribution.version;
@@ -42,7 +43,7 @@ var NpmRuntimeUpdateCommandService = class {
 		}).run({
 			apply: Boolean(opts.apply),
 			checkOnly: Boolean(opts.check),
-			download: opts.download === void 0 ? true : Boolean(opts.download),
+			applyAfterDownload: !downloadOnly,
 			onProgress: opts.json ? void 0 : this.printProgress
 		});
 	};

package/dist/launcher/npm-runtime-update.manager.d.ts

@@ -3,7 +3,7 @@ import { NpmRuntimeReleaseChannel } from "./npm-runtime-update-source.service.js
 import { NpmRuntimeUpdateStateStore } from "./npm-runtime-update-state.store.js";
 import { NpmRuntimeBundleService } from "./npm-runtime-bundle.service.js";
 import { NpmRuntimeUpdateService } from "./npm-runtime-update.service.js";
-import { UpdateProgress, UpdateSnapshot } from "@nextclaw/kernel/update-contract";
+import { UpdateProgress, UpdateSnapshot } from "@nextclaw/kernel";
 
 //#region src/launcher/npm-runtime-update.manager.d.ts
 type NpmRuntimeUpdateManagerOptions = {
@@ -17,8 +17,8 @@ type NpmRuntimeUpdateManagerOptions = {
   now?: () => Date;
 };
 type NpmRuntimeUpdateActionOptions = {
-  download?: boolean;
   apply?: boolean;
+  applyAfterDownload?: boolean;
   checkOnly?: boolean;
   onProgress?: (progress: UpdateProgress) => void;
 };

package/dist/launcher/npm-runtime-update.manager.js

@@ -16,10 +16,14 @@ var NpmRuntimeUpdateManager = class {
 	getSnapshot = () => this.toSnapshotFromState(this.options.stateStore.read(), { status: this.options.stateStore.read().downloadedVersion ? "downloaded" : "idle" });
 	run = async (options = {}) => {
 		if (options.apply) return this.applyDownloadedUpdate();
+		const applyAfterDownload = options.applyAfterDownload ?? true;
 		const checkedSnapshot = await this.checkForUpdate();
-		if (options.checkOnly || checkedSnapshot.status !== "update-available") return checkedSnapshot;
-		if (options.download === false) return checkedSnapshot;
-		return await this.downloadUpdate(options.onProgress);
+		if (options.checkOnly) return checkedSnapshot;
+		if (applyAfterDownload && checkedSnapshot.status === "downloaded") return this.applyDownloadedUpdate();
+		if (checkedSnapshot.status !== "update-available") return checkedSnapshot;
+		const downloadedSnapshot = await this.downloadUpdate(options.onProgress);
+		if (!applyAfterDownload || downloadedSnapshot.status !== "downloaded") return downloadedSnapshot;
+		return this.applyDownloadedUpdate();
 	};
 	checkForUpdate = async () => {
 		const manifestUrl = this.options.resolveManifestUrl(this.options.channel);

package/dist/launcher/npm-runtime-update.service.d.ts

@@ -1,7 +1,7 @@
 import { NpmRuntimeDownloadedUpdate, NpmRuntimeUpdateProgressReporter } from "./npm-runtime-bundle.types.js";
 import { NpmRuntimeBundleLayoutStore } from "./npm-runtime-bundle-layout.store.js";
 import { NpmRuntimeBundleService } from "./npm-runtime-bundle.service.js";
-import { UpdateManifest, UpdateManifestReader } from "@nextclaw/kernel/update-contract";
+import { UpdateManifest, UpdateManifestReader } from "@nextclaw/kernel";
 
 //#region src/launcher/npm-runtime-update.service.d.ts
 type FetchLike = typeof fetch;

package/dist/launcher/npm-runtime-update.service.js

@@ -1,11 +1,11 @@
 import { compareNpmRuntimeVersions } from "./npm-runtime-bundle.service.js";
+import { UpdateManifestReader, serializeUnsignedUpdateManifest } from "@nextclaw/kernel";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { rm } from "node:fs/promises";
 import { createHash, createPublicKey, verify } from "node:crypto";
 import JSZip from "jszip";
-import { UpdateManifestReader, serializeUnsignedUpdateManifest } from "@nextclaw/kernel/update-contract";
 //#region src/launcher/npm-runtime-update.service.ts
 var NpmRuntimeUpdateService = class {
 	platform;

package/dist/service-runtime.service.js

@@ -2,6 +2,7 @@ import { RestartCoordinator } from "./shared/services/restart/restart-coordinato
 import { initializeConfigIfMissing } from "./shared/services/runtime/runtime-config-init.service.js";
 import { writeRestartSentinel } from "./shared/services/restart/restart-sentinel.service.js";
 import { createTopLevelNextclawCommandEnv } from "./shared/utils/top-level-nextclaw-command-env.utils.js";
+import { resolveCliSubcommandLaunch } from "./shared/utils/marketplace/cli-subcommand-launch.utils.js";
 import { logStartupTrace, measureStartupSync } from "./shared/utils/startup-trace.js";
 import { isProcessRunning } from "./shared/utils/cli.utils.js";
 import { NextclawDistributionService } from "./shared/services/runtime/nextclaw-distribution.service.js";
@@ -46,7 +47,6 @@ import { RemoteRuntimeActions } from "@nextclaw/remote";
 import { getPluginChannelBindings, resolvePluginChannelMessageToolHints, setPluginRuntimeBridge } from "@nextclaw/openclaw-compat";
 import { existsSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
-import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
 //#region src/service-runtime.service.ts
 const FORCED_PUBLIC_UI_HOST = "0.0.0.0";
@@ -204,12 +204,16 @@ var NextclawServiceRuntime = class {
 		if (!state || state.pid !== process.pid) return;
 		const uiPort = typeof state.uiPort === "number" && Number.isFinite(state.uiPort) ? state.uiPort : 55667;
 		const delayMs = typeof requestedDelayMs === "number" && Number.isFinite(requestedDelayMs) ? Math.max(0, Math.floor(requestedDelayMs)) : 100;
-		const startArgs = [
-			process.env.NEXTCLAW_SELF_RELAUNCH_CLI?.trim() || fileURLToPath(new URL("./index.js", import.meta.url)),
-			"start",
-			"--ui-port",
-			String(uiPort)
-		];
+		const launch = resolveCliSubcommandLaunch({
+			argvEntry: process.argv[1],
+			importMetaUrl: import.meta.url,
+			cliArgs: [
+				"start",
+				"--ui-port",
+				String(uiPort)
+			],
+			nodePath: process.execPath
+		});
 		const serviceStatePath = managedServiceStateStore.path;
 		const helperScript = [
 			"const { spawnSync } = require(\"node:child_process\");",
@@ -218,9 +222,8 @@ var NextclawServiceRuntime = class {
 			`const delayMs = ${delayMs};`,
 			"const maxWaitMs = 120000;",
 			"const retryIntervalMs = 1000;",
-			"const startTimeoutMs = 60000;",
-			`const nodePath = ${JSON.stringify(process.execPath)};`,
-			`const startArgs = ${JSON.stringify(startArgs)};`,
+			`const command = ${JSON.stringify(launch.command)};`,
+			`const args = ${JSON.stringify(launch.args)};`,
 			`const serviceStatePath = ${JSON.stringify(serviceStatePath)};`,
 			"function isRunning(pid) {",
 			"  try {",
@@ -241,20 +244,17 @@ var NextclawServiceRuntime = class {
 			"  }",
 			"}",
 			"function tryStart() {",
-			"  spawnSync(nodePath, startArgs, {",
+			"  spawnSync(command, args, {",
 			"    stdio: \"ignore\",",
 			"    env: process.env,",
-			"    timeout: startTimeoutMs",
+			"    timeout: 60000,",
+			"    windowsHide: true",
 			"  });",
 			"}",
 			"setTimeout(() => {",
 			"  const startedAt = Date.now();",
 			"  const tick = () => {",
-			"    if (hasReplacementService()) {",
-			"      process.exit(0);",
-			"      return;",
-			"    }",
-			"    if (Date.now() - startedAt >= maxWaitMs) {",
+			"    if (hasReplacementService() || Date.now() - startedAt >= maxWaitMs) {",
 			"      process.exit(0);",
 			"      return;",
 			"    }",
@@ -272,7 +272,8 @@ var NextclawServiceRuntime = class {
 			spawn(process.execPath, ["-e", helperScript], {
 				detached: true,
 				stdio: "ignore",
-				env: createTopLevelNextclawCommandEnv(process.env)
+				env: createTopLevelNextclawCommandEnv(process.env),
+				windowsHide: true
 			}).unref();
 			this.selfRelaunchArmed = true;
 			console.warn(`Gateway self-restart armed (${reason}).`);

package/dist/shared/controllers/gateway.controller.js

@@ -267,11 +267,9 @@ var GatewayControllerImpl = class {
 		});
 	};
 	updateRun = async (params) => {
+		const { note, restartDelayMs, sessionKey, timeoutMs } = params;
 		const versionBefore = getPackageVersion$1();
-		params.timeoutMs;
-		const updateCommand = new NpmRuntimeUpdateCommandService();
-		const downloadedSnapshot = await updateCommand.runManaged({ download: true });
-		const snapshot = downloadedSnapshot.status === "downloaded" ? await updateCommand.runManaged({ apply: true }) : downloadedSnapshot;
+		const snapshot = await new NpmRuntimeUpdateCommandService().runManaged({});
 		if (snapshot.status === "blocked" || snapshot.status === "failed") return {
 			ok: false,
 			error: snapshot.errorMessage ?? snapshot.blockReason ?? "update failed",
@@ -283,12 +281,12 @@ var GatewayControllerImpl = class {
 			}
 		};
 		const versionAfter = getPackageVersion$1();
-		const delayMs = params.restartDelayMs ?? 0;
+		const delayMs = restartDelayMs ?? 0;
 		const sentinelPath = await this.writeRestartSentinelPayload({
 			kind: "update.run",
 			status: "ok",
-			sessionKey: params.sessionKey,
-			note: params.note,
+			sessionKey,
+			note,
 			reason: "update.run",
 			strategy: "runtime-bundle"
 		});
@@ -298,7 +296,7 @@ var GatewayControllerImpl = class {
 		});
 		return {
 			ok: true,
-			note: params.note ?? null,
+			note: note ?? null,
 			restart: {
 				scheduled: true,
 				delayMs

package/dist/shared/services/extensions/extension-lifecycle.service.d.ts

@@ -22,6 +22,9 @@ type ExtensionManifest = {
       configSchema?: Record<string, unknown>;
       configUiHints?: Record<string, Record<string, unknown>>;
       auth?: boolean | Record<string, unknown>;
+      outbound?: {
+        text?: boolean;
+      };
     }>;
   };
 };
@@ -37,8 +40,12 @@ type ExtensionLifecycleServiceOptions = {
 };
 declare class ExtensionManifestDiscoveryService {
   readonly discover: (roots: string[]) => Promise<ExtensionManifest[]>;
+  readonly discoverSync: (roots: string[]) => ExtensionManifest[];
   private readonly discoverRoot;
+  private readonly discoverRootSync;
   private readonly readManifestIfExists;
+  private readonly readManifestIfExistsSync;
+  private readonly readDirectoriesSync;
 }
 declare class ExtensionLifecycleService {
   private readonly options;

package/dist/shared/services/extensions/extension-lifecycle.service.js

@@ -1,3 +1,4 @@
+import { readFileSync, readdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { spawn } from "node:child_process";
 import { readFile, readdir } from "node:fs/promises";
@@ -62,12 +63,22 @@ var ExtensionManifestDiscoveryService = class {
 		for (const root of roots) manifests.push(...await this.discoverRoot(root));
 		return manifests;
 	};
+	discoverSync = (roots) => {
+		const manifests = [];
+		for (const root of roots) manifests.push(...this.discoverRootSync(root));
+		return manifests;
+	};
 	discoverRoot = async (root) => {
 		const directManifest = await this.readManifestIfExists(join(root, EXTENSION_MANIFEST_FILE));
 		if (directManifest) return [directManifest];
 		const entries = await readdir(root, { withFileTypes: true }).catch(() => []);
 		return (await Promise.all(entries.filter((entry) => entry.isDirectory()).map((entry) => this.readManifestIfExists(join(root, entry.name, EXTENSION_MANIFEST_FILE))))).filter((manifest) => Boolean(manifest));
 	};
+	discoverRootSync = (root) => {
+		const directManifest = this.readManifestIfExistsSync(join(root, EXTENSION_MANIFEST_FILE));
+		if (directManifest) return [directManifest];
+		return this.readDirectoriesSync(root).map((entry) => this.readManifestIfExistsSync(join(root, entry, EXTENSION_MANIFEST_FILE))).filter((manifest) => Boolean(manifest));
+	};
 	readManifestIfExists = async (path) => {
 		try {
 			return toManifest(JSON.parse(await readFile(path, "utf-8")), dirname(path));
@@ -76,6 +87,21 @@ var ExtensionManifestDiscoveryService = class {
 			throw error;
 		}
 	};
+	readManifestIfExistsSync = (path) => {
+		try {
+			return toManifest(JSON.parse(readFileSync(path, "utf-8")), dirname(path));
+		} catch (error) {
+			if (error.code === "ENOENT") return null;
+			throw error;
+		}
+	};
+	readDirectoriesSync = (root) => {
+		try {
+			return readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+		} catch {
+			return [];
+		}
+	};
 };
 var ExtensionLifecycleService = class {
 	processes = /* @__PURE__ */ new Map();
@@ -88,13 +114,17 @@ var ExtensionLifecycleService = class {
 	}
 	startAll = async (manifests) => {
 		const started = [];
-		for (const manifest of manifests) started.push(this.start(manifest));
+		for (const manifest of manifests) try {
+			started.push(this.start(manifest));
+		} catch (error) {
+			this.logger.warn(`Extension ${manifest.id} failed to start: ${error instanceof Error ? error.message : String(error)}`);
+		}
 		return started;
 	};
 	start = (manifest) => {
 		const existing = this.processes.get(manifest.id);
 		if (existing) return existing;
-		const child = this.spawnProcess(manifest.server.command, manifest.server.args ?? [], {
+		const child = this.spawnProcess(manifest.server.command === "node" || manifest.server.command === "node.exe" ? process.execPath : manifest.server.command, manifest.server.args ?? [], {
 			cwd: manifest.rootDir,
 			env: {
 				...process.env,
@@ -108,7 +138,8 @@ var ExtensionLifecycleService = class {
 				"ignore",
 				"ignore",
 				"inherit"
-			]
+			],
+			windowsHide: true
 		});
 		const running = {
 			manifest,

package/dist/shared/services/extensions/service-extension-runtime.service.d.ts

@@ -44,6 +44,7 @@ declare class ServiceExtensionRuntime {
   private readonly toContributions;
   private readonly readConfigUiHints;
   private readonly createChannelAuth;
+  private readonly createChannelOutbound;
   private readonly requestExtension;
   private readonly assertAuthorized;
 }

package/dist/shared/services/extensions/service-extension-runtime.service.js

@@ -2,7 +2,7 @@ import { resolveDevFirstPartyPluginDir } from "../../../commands/plugin/developm
 import { ExtensionLifecycleService, ExtensionManifestDiscoveryService } from "./extension-lifecycle.service.js";
 import { createRequire } from "node:module";
 import { getDataPath } from "@nextclaw/core";
-import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomUUID } from "node:crypto";
@@ -13,7 +13,7 @@ const EXTENSION_REQUEST_EVENT_TYPE = "extension.request";
 const EXTENSION_RESPONSE_INGRESS_TYPE = "extension.response";
 const serviceRequire = createRequire(import.meta.url);
 const EXTENSION_REQUEST_TIMEOUT_MS = 6e4;
-var ExtensionChannelAuthClient = class {
+var ExtensionChannelClient = class {
 	constructor(params) {
 		this.params = params;
 	}
@@ -45,6 +45,16 @@ var ExtensionChannelAuthClient = class {
 			sessionId
 		}
 	});
+	sendText = async ({ to, text, accountId }) => await this.params.request({
+		extensionId: this.params.extensionId,
+		kind: "channel.outbound.sendText",
+		payload: {
+			channelId: this.params.channelId,
+			to,
+			text,
+			accountId
+		}
+	});
 };
 function uniquePaths(paths) {
 	const seen = /* @__PURE__ */ new Set();
@@ -67,6 +77,7 @@ function findExtensionManifestRoot(startPath) {
 	}
 }
 function readBuiltinExtensionPackages() {
+	if (process.env.NEXTCLAW_DISABLE_BUILTIN_EXTENSIONS === "1") return [];
 	const packageJsonPath = resolve(dirname(fileURLToPath(import.meta.url)), "../../../..", "package.json");
 	try {
 		const packages = JSON.parse(readFileSync(packageJsonPath, "utf-8")).nextclaw?.builtinExtensions;
@@ -75,43 +86,12 @@ function readBuiltinExtensionPackages() {
 		return [];
 	}
 }
-function readPackageName(packageJsonPath) {
-	try {
-		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-		return typeof packageJson.name === "string" ? packageJson.name : void 0;
-	} catch {
-		return;
-	}
-}
-function readDirectoryNames(root) {
-	try {
-		return readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => String(entry.name));
-	} catch {
-		return [];
-	}
-}
-function findWorkspacePackageRoot(packageName) {
-	const roots = [
-		resolve(process.cwd(), "packages", "extensions"),
-		resolve(process.cwd(), "packages"),
-		resolve(process.cwd(), "apps"),
-		resolve(process.cwd(), "workers")
-	];
-	for (const root of roots) for (const name of readDirectoryNames(root)) {
-		const candidateRoot = join(root, name);
-		if (readPackageName(join(candidateRoot, "package.json")) === packageName && existsSync(join(candidateRoot, "nextclaw.extension.json"))) return candidateRoot;
-	}
-}
 function resolveBuiltinExtensionManifestRoots() {
 	const roots = [];
-	for (const packageName of readBuiltinExtensionPackages()) {
-		try {
-			const root = findExtensionManifestRoot(dirname(serviceRequire.resolve(packageName)));
-			if (root) roots.push(root);
-		} catch {}
-		const workspaceRoot = findWorkspacePackageRoot(packageName);
-		if (workspaceRoot) roots.push(workspaceRoot);
-	}
+	for (const packageName of readBuiltinExtensionPackages()) try {
+		const root = findExtensionManifestRoot(dirname(serviceRequire.resolve(packageName)));
+		if (root) roots.push(root);
+	} catch {}
 	return uniquePaths(roots);
 }
 function readRecord(value) {
@@ -281,7 +261,8 @@ var ServiceExtensionRuntime = class {
 							schema: channel.configSchema,
 							...configUiHints ? { uiHints: configUiHints } : {}
 						} } : {},
-						...channel.auth ? { auth: this.createChannelAuth(manifest.id, channelId) } : {}
+						...channel.auth ? { auth: this.createChannelAuth(manifest.id, channelId) } : {},
+						...channel.outbound?.text ? { outbound: this.createChannelOutbound(manifest.id, channelId) } : {}
 					}
 				});
 				uiMetadata.push({
@@ -300,7 +281,12 @@ var ServiceExtensionRuntime = class {
 		if (!value || typeof value !== "object" || Array.isArray(value)) return;
 		return value;
 	};
-	createChannelAuth = (extensionId, channelId) => new ExtensionChannelAuthClient({
+	createChannelAuth = (extensionId, channelId) => new ExtensionChannelClient({
+		extensionId,
+		channelId,
+		request: this.requestExtension
+	});
+	createChannelOutbound = (extensionId, channelId) => new ExtensionChannelClient({
 		extensionId,
 		channelId,
 		request: this.requestExtension

package/dist/shared/services/gateway/nextclaw-gateway-runtime.service.js

@@ -3,9 +3,9 @@ import { openBrowser, resolveUiConfig, resolveUiStaticDir } from "../../utils/cl
 import { NextclawDistributionService } from "../runtime/nextclaw-distribution.service.js";
 import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
 import { resolveChannelConfigView } from "../../../commands/channel/channel-config-view.js";
+import { ServiceExtensionRuntime } from "../extensions/service-extension-runtime.service.js";
 import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
 import { GatewayControllerImpl } from "../../controllers/gateway.controller.js";
-import { ServiceExtensionRuntime } from "../extensions/service-extension-runtime.service.js";
 import { ServiceFileWatcherRegistry, markLocalUiRuntimeIfStarted, startGatewayRuntimeSupport, watchServiceConfigFile } from "./service-startup-support.service.js";
 import { GatewayPluginManager } from "./managers/gateway-plugin.manager.js";
 import { GatewayRemoteManager } from "./managers/gateway-remote.manager.js";

package/dist/shared/services/runtime/runtime-command.service.js

@@ -1,6 +1,6 @@
+import { resolveCliSubcommandEntry } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
 import { isLoopbackHost, resolvePublicIp, resolveUiStaticDir } from "../../utils/cli.utils.js";
 import { NextclawDistributionService } from "./nextclaw-distribution.service.js";
-import { resolveCliSubcommandEntry } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
 import { describeUnmanagedHealthyTargetMessage, inspectUiTarget } from "../../utils/service-port-probe.utils.js";
 import { ManagedServiceCommandService } from "./service-managed-startup.service.js";
 import { buildMarketplaceSkillInstallArgs, pickUserFacingCommandSummary } from "../../utils/marketplace/service-marketplace-helpers.utils.js";
@@ -86,7 +86,8 @@ var RuntimeCommandService = class {
 					"ignore",
 					"pipe",
 					"pipe"
-				]
+				],
+				windowsHide: true
 			});
 			let stdout = "";
 			let stderr = "";

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

@@ -1,8 +1,8 @@
 import { createTopLevelNextclawCommandEnv } from "../../utils/top-level-nextclaw-command-env.utils.js";
+import { resolveCliSubcommandLaunch } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
 import { isProcessRunning, openBrowser, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, waitForExit } from "../../utils/cli.utils.js";
 import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
 import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
-import { resolveCliSubcommandLaunch } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
 import { writeInitialManagedServiceState, writeReadyManagedServiceState } from "./utils/service-remote-runtime.utils.js";
 import { resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate } from "./utils/managed-service-routing.utils.js";
 import { probeHealthEndpoint } from "../../utils/service-port-probe.utils.js";
@@ -39,7 +39,8 @@ function spawnManagedService(params) {
 	const child = spawn(cliLaunch.command, childArgs, {
 		env: createTopLevelNextclawCommandEnv(process.env),
 		stdio: "ignore",
-		detached: true
+		detached: true,
+		windowsHide: true
 	});
 	appendStartupStage(logPath, `spawned background process pid=${child.pid ?? "unknown"}`);
 	if (!child.pid) {

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

@@ -36,7 +36,7 @@ var DeferredUiNcpAgentControllerOwner = class {
 		},
 		send: async (envelope) => {
 			if (!this.activeAgent) throw createUnavailableError();
-			await this.activeAgent.agentClientEndpoint.send(envelope);
+			return await this.activeAgent.agentClientEndpoint.send(envelope);
 		},
 		stream: async (payload) => {
 			if (!this.activeAgent) throw createUnavailableError();

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

@@ -89,6 +89,7 @@ var CompanionRuntimeService = class {
 		], {
 			detached: true,
 			stdio: "ignore",
+			windowsHide: true,
 			env: {
 				...process.env,
 				NEXTCLAW_COMPANION_RUNTIME_STATE_PATH: this.runtimeStore.path

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

@@ -2,8 +2,8 @@ import { findExecutableOnPath } from "../../utils/cli.utils.js";
 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";
+import { fileURLToPath } from "node:url";
 //#region src/shared/services/workspace/workspace-manager.service.ts
 var WorkspaceManager = class {
 	constructor(logo) {

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

@@ -56,6 +56,7 @@ type MarketplaceSkillsRecommendCommandOptions = {
 type UpdateCommandOptions = {
   check?: boolean;
   download?: boolean;
+  downloadOnly?: boolean;
   apply?: boolean;
   channel?: string;
   manifestUrl?: string;
@@ -125,6 +126,9 @@ type ChannelsAddOptions = {
   url?: string;
   httpUrl?: string;
 };
+type ChannelsListOptions = {
+  json?: boolean;
+};
 type ChannelsLoginOptions = {
   channel?: string;
   account?: string;
@@ -279,4 +283,4 @@ type RequestRestartParams = {
   mode?: "execute" | "notify";
 };
 //#endregion
-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 };
+export { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsListOptions, 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

@@ -193,7 +193,8 @@ function openBrowser(url) {
 		spawn(command, args, {
 			stdio: "ignore",
 			detached: true,
-			env: createExternalCommandEnv(process.env)
+			env: createExternalCommandEnv(process.env),
+			windowsHide: true
 		}).unref();
 		return true;
 	} catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/service",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "private": false,
   "description": "NextClaw long-running service host and runtime lifecycle.",
   "type": "module",
@@ -35,24 +35,24 @@
     "commander": "^12.1.0",
     "jszip": "^3.10.1",
     "yaml": "^2.8.1",
-    "@nextclaw/channel-extension-feishu": "0.1.1",
-    "@nextclaw/core": "0.12.17",
-    "@nextclaw/kernel": "0.1.6",
-    "@nextclaw/mcp": "0.1.82",
-    "@nextclaw/channel-extension-weixin": "0.1.4",
-    "@nextclaw/ncp-http-agent-server": "0.3.22",
-    "@nextclaw/ncp": "0.5.10",
-    "@nextclaw/ncp-toolkit": "0.5.15",
-    "@nextclaw/openclaw-compat": "1.0.17",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.9",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.10",
-    "@nextclaw/ncp-agent-runtime": "0.3.20",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.9",
-    "@nextclaw/remote": "0.1.94",
-    "@nextclaw/ncp-mcp": "0.1.84",
-    "@nextclaw/runtime": "0.2.49",
-    "@nextclaw/shared": "0.1.4",
-    "@nextclaw/server": "0.12.17"
+    "@nextclaw/core": "0.12.18",
+    "@nextclaw/channel-extension-feishu": "0.1.2",
+    "@nextclaw/channel-extension-weixin": "0.1.5",
+    "@nextclaw/kernel": "0.1.7",
+    "@nextclaw/ncp-agent-runtime": "0.3.21",
+    "@nextclaw/ncp": "0.5.11",
+    "@nextclaw/mcp": "0.1.83",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.10",
+    "@nextclaw/ncp-http-agent-server": "0.3.23",
+    "@nextclaw/ncp-toolkit": "0.5.16",
+    "@nextclaw/ncp-mcp": "0.1.85",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.10",
+    "@nextclaw/openclaw-compat": "1.0.18",
+    "@nextclaw/runtime": "0.2.50",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.11",
+    "@nextclaw/shared": "0.1.5",
+    "@nextclaw/remote": "0.1.95",
+    "@nextclaw/server": "0.12.18"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",