@nextclaw/service 0.2.13 → 0.2.14

package/dist/managers/service-gateway.manager.js

@@ -0,0 +1,278 @@
+import { openBrowser, resolveUiConfig, resolveUiStaticDir } from "../utils/cli.utils.js";
+import { localUiRuntimeStore } from "../stores/local-ui-runtime.store.js";
+import { managedServiceStateStore } from "../stores/managed-service-state.store.js";
+import { NextclawDistributionService } from "../services/runtime/nextclaw-distribution.service.js";
+import { GatewayControllerImpl } from "../controllers/gateway.controller.js";
+import { GatewayExtensionManager } from "./gateway-extension.manager.js";
+import { GatewayRemoteManager } from "./gateway-remote.manager.js";
+import { GatewayRestartWakeService } from "../services/gateway/gateway-restart-wake.service.js";
+import { createCronJobHandler } from "../utils/gateway-cron-job-handler.utils.js";
+import { companionRuntimeService } from "../services/ui/companion-runtime.service.js";
+import { handleGatewayDeferredStartupError } from "../utils/gateway-runtime-lifecycle.utils.js";
+import { logStartupTrace, measureStartupAsync, measureStartupSync } from "../utils/startup-trace.utils.js";
+import { NextclawApp } from "../services/gateway/nextclaw-app.service.js";
+import { ServiceBootstrapStatusStore } from "../services/gateway/service-bootstrap-status.service.js";
+import { GatewayRuntimeSupportService, ServiceFileWatcherRegistry, markLocalUiRuntimeIfStarted, watchServiceConfigFile } from "../services/gateway/service-startup-support.service.js";
+import { ServiceMarketplaceInstaller } from "../services/marketplace/service-marketplace-installer.service.js";
+import { NpmRuntimeUpdateHost } from "../services/runtime/npm-runtime-update-host.service.js";
+import { createRuntimeControlHost } from "../services/ui/runtime-control-host.service.js";
+import { readPanelAppClientSdkScript } from "../utils/panel-app-client-sdk/panel-app-client-sdk-script.utils.js";
+import * as NextclawCore from "@nextclaw/core";
+import { AgentRunClient, NextclawKernel, runGatewayInboundLoop } from "@nextclaw/kernel";
+import { resolve } from "node:path";
+import { startUiServer } from "@nextclaw/server";
+import { setImmediate } from "node:timers/promises";
+//#region src/managers/service-gateway.manager.ts
+const { getConfigPath: getConfigPath$1, getDataDir: getDataDir$1, getWorkspacePath: getWorkspacePath$1 } = NextclawCore;
+function resolveApplyRestartMode(uiPort) {
+	const serviceState = managedServiceStateStore.read();
+	if (serviceState?.pid === process.pid) return "managed-service-restart";
+	if (process.env.NEXTCLAW_RUNTIME_BUNDLE_CHILD === "1" && typeof serviceState?.uiPort === "number" && serviceState.uiPort === uiPort) return "managed-service-restart";
+	return "manual-process-restart";
+}
+var ServiceGatewayManager = class {
+	kernel;
+	appEventBus;
+	messageBus;
+	sessionManager;
+	automation;
+	agentRunClient;
+	runtimeControl;
+	runtimeUpdate;
+	ingress;
+	distribution = NextclawDistributionService.get();
+	productVersion;
+	providerManager;
+	gatewayController;
+	configManager;
+	uiConfig;
+	uiStaticDir;
+	workspace;
+	remoteManager;
+	marketplace;
+	extensions;
+	restartWake;
+	bootstrapStatus;
+	uiStartup;
+	fileWatchers = new ServiceFileWatcherRegistry();
+	deferredChannelStarter;
+	constructor(deps, options) {
+		this.deps = deps;
+		this.options = options;
+		const configPath = getConfigPath$1();
+		this.kernel = measureStartupSync("service.gateway.kernel", () => new NextclawKernel({
+			homeDir: getDataDir$1(),
+			configPath
+		}));
+		this.configManager = this.kernel.configManager;
+		const config = this.configManager.config;
+		this.uiConfig = resolveUiConfig(config, options.uiOverrides);
+		this.uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir(this.distribution.uiDistDir) : options.uiStaticDir;
+		this.workspace = getWorkspacePath$1(config.agents.defaults.workspace);
+		this.appEventBus = this.kernel.eventBus;
+		this.ingress = this.kernel.ingress;
+		this.agentRunClient = new AgentRunClient({
+			eventBus: this.kernel.eventBus,
+			ingress: this.kernel.ingress
+		});
+		this.messageBus = this.kernel.messageBus;
+		this.sessionManager = this.kernel.sessionManager;
+		this.automation = this.kernel.automation;
+		this.productVersion = this.distribution.version;
+		this.extensions = new GatewayExtensionManager(this);
+		this.providerManager = this.kernel.llmProviders;
+		this.installConfigHostHooks();
+		this.restartWake = new GatewayRestartWakeService(this);
+		this.bootstrapStatus = this.createBootstrapStatus();
+		this.uiStartup = this.createDisabledUiStartup();
+		this.remoteManager = new GatewayRemoteManager({
+			deps: this.deps,
+			configManager: this.configManager,
+			uiConfig: this.uiConfig,
+			onRemoteStateChange: (state) => this.bootstrapStatus.syncRemoteRuntimeState(state)
+		});
+		this.marketplace = this.createMarketplace();
+		this.runtimeControl = createRuntimeControlHost({
+			serviceCommands: this.deps,
+			requestRestart: this.deps.requestRestart,
+			uiConfig: this.uiConfig
+		});
+		this.runtimeUpdate = process.env.NEXTCLAW_DISABLE_RUNTIME_UPDATE_HOST === "1" ? null : new NpmRuntimeUpdateHost({
+			eventBus: this.appEventBus,
+			applyRestartMode: resolveApplyRestartMode(this.uiConfig.port),
+			requestRestart: this.deps.requestRestart,
+			uiConfig: this.uiConfig
+		});
+		this.gatewayController = this.createGatewayController();
+		this.kernel.provideGatewayController(this.gatewayController);
+		this.deferredChannelStarter = this.startChannels;
+		this.automation.onJob = createCronJobHandler({ agentRunClient: this.agentRunClient });
+	}
+	start = async () => {
+		logStartupTrace("service.start_gateway.begin");
+		await this.reset();
+		this.configureIngressHandlers();
+		this.uiStartup = await this.startUiRuntime();
+		await companionRuntimeService.applyConfig(this.configManager.config);
+		await this.markUiRuntimeReady();
+		await this.startSupportServices();
+		await this.runRuntimeLoop();
+		await companionRuntimeService.ensureStopped();
+		logStartupTrace("service.start_gateway.end");
+	};
+	reset = async () => {
+		await this.fileWatchers.clear();
+		this.bootstrapStatus = this.createBootstrapStatus();
+		this.uiStartup = this.createDisabledUiStartup();
+		this.deferredChannelStarter = this.startChannels;
+	};
+	createBootstrapStatus = () => {
+		const bootstrapStatus = new ServiceBootstrapStatusStore();
+		bootstrapStatus.markChannelsPending();
+		bootstrapStatus.setRemoteState(this.configManager.config.remote.enabled ? "pending" : "disabled");
+		return bootstrapStatus;
+	};
+	createDisabledUiStartup = () => ({ endpoint: "" });
+	startUiRuntime = async () => {
+		const uiStartup = await measureStartupAsync("service.start_ui_runtime", async () => {
+			logStartupTrace("service.start_ui_runtime.begin");
+			if (!this.uiConfig.enabled) return this.createDisabledUiStartup();
+			const uiServer = await startUiServer(this.createUiRouterOptions());
+			const uiUrl = NextclawCore.resolveLocalUiBaseUrl({
+				host: uiServer.host,
+				port: uiServer.port
+			});
+			console.log(`✓ UI API: ${uiUrl}/api`);
+			if (this.uiStaticDir) console.log(`✓ UI frontend: ${uiUrl}`);
+			if (this.uiConfig.open) openBrowser(uiUrl);
+			logStartupTrace("service.start_ui_runtime.ready", {
+				host: uiServer.host,
+				port: uiServer.port
+			});
+			return { endpoint: uiUrl };
+		});
+		markLocalUiRuntimeIfStarted({
+			uiStartup: this.uiConfig.enabled ? uiStartup : null,
+			uiConfig: this.uiConfig
+		});
+		return uiStartup;
+	};
+	createUiRouterOptions = () => ({
+		kernel: this.kernel,
+		configPath: this.configManager.configPath,
+		appEventBus: this.appEventBus,
+		uiConfig: this.uiConfig,
+		uiStaticDir: this.uiStaticDir,
+		panelAppClientSdkScript: readPanelAppClientSdkScript,
+		productVersion: this.productVersion,
+		applyLiveConfigReload: this.configManager.applyLiveConfigReload,
+		initializeAgentHomeDirectory: this.deps.initializeAgentHomeDirectory,
+		marketplace: this.marketplace,
+		cron: this.automation,
+		remoteAccess: this.remoteManager.remoteAccess,
+		runtimeControl: this.runtimeControl,
+		...this.runtimeUpdate ? { runtimeUpdate: this.runtimeUpdate } : {},
+		bootstrapStatus: this.bootstrapStatus,
+		extensions: this.extensions
+	});
+	runRuntimeLoop = async () => {
+		logStartupTrace("service.start_gateway.runtime_loop_begin");
+		let startupTask = null;
+		try {
+			const runtimeLoopTask = runGatewayInboundLoop(this);
+			startupTask = this.startDeferredRuntime();
+			startupTask.catch((error) => handleGatewayDeferredStartupError({
+				bootstrapStatus: this.bootstrapStatus,
+				error
+			}));
+			await runtimeLoopTask;
+		} finally {
+			if (startupTask) await startupTask.catch(() => void 0);
+			await this.cleanup();
+		}
+	};
+	startDeferredRuntime = async () => {
+		await new NextclawApp(this).start();
+	};
+	startDeferredChannels = async () => {
+		await this.deferredChannelStarter();
+	};
+	startChannels = async () => {
+		await this.kernel.channels.start();
+		const enabledChannels = this.kernel.channels.enabledChannels;
+		if (enabledChannels.length > 0) console.log(`✓ Channels enabled: ${enabledChannels.join(", ")}`);
+		else console.log("Warning: No channels enabled");
+		this.bootstrapStatus.markChannelsReady(enabledChannels);
+	};
+	createMarketplace = () => ({
+		apiBaseUrl: process.env.NEXTCLAW_MARKETPLACE_API_BASE,
+		installer: new ServiceMarketplaceInstaller({
+			applyLiveConfigReload: this.configManager.applyLiveConfigReload,
+			runCliSubcommand: this.deps.runCliSubcommand,
+			installBuiltinSkill: this.deps.installBuiltinMarketplaceSkill
+		}).createInstaller()
+	});
+	cleanup = async () => {
+		localUiRuntimeStore.clearIfOwnedByProcess();
+		await this.fileWatchers.clear();
+		await this.kernel.extensions.stop();
+		await this.remoteManager.stop();
+	};
+	markUiRuntimeReady = async () => {
+		this.bootstrapStatus.markShellReady();
+		await setImmediate();
+	};
+	createGatewayController = () => {
+		return measureStartupSync("service.gateway.gateway_controller", () => new GatewayControllerImpl({
+			configManager: this.configManager,
+			channels: this.kernel.channels,
+			cron: this.automation,
+			sessionManager: this.sessionManager,
+			requestRestart: async (options) => {
+				await this.deps.requestRestart({
+					reason: options?.reason ?? "gateway tool restart",
+					manualMessage: "Restart the gateway to apply changes.",
+					strategy: "background-service-or-exit",
+					delayMs: options?.delayMs,
+					silentOnServiceRestart: true
+				});
+			}
+		}));
+	};
+	startSupportServices = async () => {
+		this.extensions.publishConfigChanges();
+		await measureStartupAsync("service.start_gateway_support_services", async () => await new GatewayRuntimeSupportService({
+			automation: this.automation,
+			remoteModule: this.remoteManager.remoteModule,
+			watchConfigFile: () => watchServiceConfigFile({
+				configPath: resolve(getConfigPath$1()),
+				watcherRegistry: this.fileWatchers,
+				scheduleReload: (reason) => this.configManager.scheduleReload(reason)
+			}),
+			watcherRegistry: this.fileWatchers
+		}).start());
+	};
+	installConfigHostHooks = () => {
+		this.configManager.installRuntimeHooks({
+			reloadCompanion: async ({ config: nextConfig }) => {
+				await companionRuntimeService.applyConfig(nextConfig);
+			},
+			onRestartRequired: (paths) => {
+				this.deps.requestRestart({
+					changedPaths: paths,
+					manualMessage: `已保存以下改动，等待你手动重启后生效：${paths.join(", ")}`,
+					mode: "notify",
+					reason: `config reload requires restart: ${paths.join(", ")}`,
+					strategy: "background-service-or-manual"
+				});
+			}
+		});
+	};
+	configureIngressHandlers = () => {
+		this.kernel.extensions.registerIngressHandlers();
+	};
+};
+//#endregion
+export { ServiceGatewayManager };
+
+//# sourceMappingURL=service-gateway.manager.js.map

package/dist/managers/service-gateway.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-gateway.manager.js","names":["getConfigPath","getDataDir","getWorkspacePath","waitForNextTick"],"sources":["../../src/managers/service-gateway.manager.ts"],"sourcesContent":["import * as NextclawCore from \"@nextclaw/core\";\nimport {\n  AgentRunClient,\n  NextclawKernel,\n  runGatewayInboundLoop,\n  type AutomationManager,\n  type ConfigManager,\n  type LlmProviderManager,\n  type SessionManager,\n} from \"@nextclaw/kernel\";\nimport type { EventBus, Ingress } from \"@nextclaw/shared\";\nimport {\n  startUiServer,\n  type MarketplaceApiConfig,\n  type UiRouterOptions,\n  type UiRuntimeControlHost,\n  type UiRuntimeUpdateHost,\n} from \"@nextclaw/server\";\nimport { resolve } from \"node:path\";\nimport { setImmediate as waitForNextTick } from \"node:timers/promises\";\nimport { GatewayControllerImpl } from \"@nextclaw-service/controllers/gateway.controller.js\";\nimport { GatewayExtensionManager } from \"@nextclaw-service/managers/gateway-extension.manager.js\";\nimport { GatewayRemoteManager } from \"@nextclaw-service/managers/gateway-remote.manager.js\";\nimport { GatewayRestartWakeService } from \"@nextclaw-service/services/gateway/gateway-restart-wake.service.js\";\nimport { createCronJobHandler } from \"@nextclaw-service/utils/gateway-cron-job-handler.utils.js\";\nimport { companionRuntimeService } from \"@nextclaw-service/services/ui/companion-runtime.service.js\";\nimport { handleGatewayDeferredStartupError } from \"@nextclaw-service/utils/gateway-runtime-lifecycle.utils.js\";\nimport { NextclawApp, type UiStartupHandle } from \"@nextclaw-service/services/gateway/nextclaw-app.service.js\";\nimport { NextclawDistributionService } from \"@nextclaw-service/services/runtime/nextclaw-distribution.service.js\";\nimport { ServiceBootstrapStatusStore } from \"@nextclaw-service/services/gateway/service-bootstrap-status.service.js\";\nimport { GatewayRuntimeSupportService, ServiceFileWatcherRegistry, markLocalUiRuntimeIfStarted, watchServiceConfigFile } from \"@nextclaw-service/services/gateway/service-startup-support.service.js\";\nimport { ServiceMarketplaceInstaller } from \"@nextclaw-service/services/marketplace/service-marketplace-installer.service.js\";\nimport { NpmRuntimeUpdateHost } from \"@nextclaw-service/services/runtime/npm-runtime-update-host.service.js\";\nimport { createRuntimeControlHost } from \"@nextclaw-service/services/ui/runtime-control-host.service.js\";\nimport { localUiRuntimeStore } from \"@nextclaw-service/stores/local-ui-runtime.store.js\";\nimport { managedServiceStateStore } from \"@nextclaw-service/stores/managed-service-state.store.js\";\nimport type { RequestRestartParams } from \"@nextclaw-service/types/cli.types.js\";\nimport { openBrowser, resolveUiConfig, resolveUiStaticDir } from \"@nextclaw-service/utils/cli.utils.js\";\nimport { readPanelAppClientSdkScript } from \"@nextclaw-service/utils/panel-app-client-sdk/panel-app-client-sdk-script.utils.js\";\nimport { logStartupTrace, measureStartupAsync, measureStartupSync } from \"@nextclaw-service/utils/startup-trace.utils.js\";\n\nconst {\n  getConfigPath,\n  getDataDir,\n  getWorkspacePath,\n} = NextclawCore;\n\nfunction resolveApplyRestartMode(uiPort: number): \"managed-service-restart\" | \"manual-process-restart\" {\n  const serviceState = managedServiceStateStore.read();\n  if (serviceState?.pid === process.pid) {\n    return \"managed-service-restart\";\n  }\n  if (\n    process.env.NEXTCLAW_RUNTIME_BUNDLE_CHILD === \"1\" &&\n    typeof serviceState?.uiPort === \"number\" &&\n    serviceState.uiPort === uiPort\n  ) {\n    return \"managed-service-restart\";\n  }\n  return \"manual-process-restart\";\n}\n\ntype Config = NextclawCore.Config;\ntype MessageBus = NextclawCore.MessageBus;\n\ntype GatewayRuntimeOptions = {\n  uiOverrides?: Partial<Config[\"ui\"]>;\n  uiStaticDir?: string | null;\n};\n\nexport type GatewayRuntimeDeps = {\n  requestRestart: (params: RequestRestartParams) => Promise<void>;\n  initializeAgentHomeDirectory: (homeDirectory: string) => void;\n  startService: (options: { uiOverrides: Record<string, unknown>; open: boolean }) => Promise<void>;\n  stopService: () => Promise<void>;\n  runCliSubcommand: (args: string[]) => Promise<string>;\n  installBuiltinMarketplaceSkill: (slug: string, force: boolean | undefined) => { message: string; output?: string } | null;\n};\n\nexport class ServiceGatewayManager {\n  readonly kernel: NextclawKernel;\n  readonly appEventBus: EventBus;\n  readonly messageBus: MessageBus;\n  readonly sessionManager: SessionManager;\n  readonly automation: AutomationManager;\n  readonly agentRunClient: AgentRunClient;\n  readonly runtimeControl: UiRuntimeControlHost;\n  readonly runtimeUpdate: UiRuntimeUpdateHost | null;\n  readonly ingress: Ingress;\n  readonly distribution = NextclawDistributionService.get();\n  readonly productVersion: string;\n  readonly providerManager: LlmProviderManager;\n  readonly gatewayController: GatewayControllerImpl;\n\n  readonly configManager: ConfigManager;\n  readonly uiConfig: Config[\"ui\"];\n  readonly uiStaticDir: string | null;\n  readonly workspace: string;\n  readonly remoteManager: GatewayRemoteManager;\n  readonly marketplace: MarketplaceApiConfig;\n  readonly extensions: GatewayExtensionManager;\n  readonly restartWake: GatewayRestartWakeService;\n  bootstrapStatus: ServiceBootstrapStatusStore;\n  uiStartup: UiStartupHandle;\n  readonly fileWatchers = new ServiceFileWatcherRegistry();\n  private deferredChannelStarter: () => Promise<void>;\n\n  constructor(\n    private readonly deps: GatewayRuntimeDeps,\n    private readonly options: GatewayRuntimeOptions,\n  ) {\n    const configPath = getConfigPath();\n    this.kernel = measureStartupSync(\n      \"service.gateway.kernel\",\n      () => new NextclawKernel({\n        homeDir: getDataDir(),\n        configPath,\n      }),\n    );\n    this.configManager = this.kernel.configManager;\n    const config = this.configManager.config;\n    this.uiConfig = resolveUiConfig(config, options.uiOverrides);\n    this.uiStaticDir = options.uiStaticDir === undefined ? resolveUiStaticDir(this.distribution.uiDistDir) : options.uiStaticDir;\n    this.workspace = getWorkspacePath(config.agents.defaults.workspace);\n    this.appEventBus = this.kernel.eventBus;\n    this.ingress = this.kernel.ingress;\n    this.agentRunClient = new AgentRunClient({\n      eventBus: this.kernel.eventBus,\n      ingress: this.kernel.ingress,\n    });\n    this.messageBus = this.kernel.messageBus;\n    this.sessionManager = this.kernel.sessionManager;\n    this.automation = this.kernel.automation;\n    this.productVersion = this.distribution.version;\n    this.extensions = new GatewayExtensionManager(this);\n    this.providerManager = this.kernel.llmProviders;\n    this.installConfigHostHooks();\n    this.restartWake = new GatewayRestartWakeService(this);\n    this.bootstrapStatus = this.createBootstrapStatus();\n    this.uiStartup = this.createDisabledUiStartup();\n    this.remoteManager = new GatewayRemoteManager({\n      deps: this.deps,\n      configManager: this.configManager,\n      uiConfig: this.uiConfig,\n      onRemoteStateChange: (state) => this.bootstrapStatus.syncRemoteRuntimeState(state),\n    });\n    this.marketplace = this.createMarketplace();\n    this.runtimeControl = createRuntimeControlHost({\n      serviceCommands: this.deps,\n      requestRestart: this.deps.requestRestart,\n      uiConfig: this.uiConfig,\n    });\n    this.runtimeUpdate =\n      process.env.NEXTCLAW_DISABLE_RUNTIME_UPDATE_HOST === \"1\"\n        ? null\n        : new NpmRuntimeUpdateHost({\n            eventBus: this.appEventBus,\n            applyRestartMode: resolveApplyRestartMode(this.uiConfig.port),\n            requestRestart: this.deps.requestRestart,\n            uiConfig: this.uiConfig,\n    });\n    this.gatewayController = this.createGatewayController();\n    this.kernel.provideGatewayController(this.gatewayController);\n    this.deferredChannelStarter = this.startChannels;\n    this.automation.onJob = createCronJobHandler({\n      agentRunClient: this.agentRunClient,\n    });\n  }\n\n  start = async (): Promise<void> => {\n    logStartupTrace(\"service.start_gateway.begin\");\n    await this.reset();\n    this.configureIngressHandlers();\n    this.uiStartup = await this.startUiRuntime();\n    await companionRuntimeService.applyConfig(this.configManager.config);\n    await this.markUiRuntimeReady();\n    await this.startSupportServices();\n    await this.runRuntimeLoop();\n    await companionRuntimeService.ensureStopped();\n    logStartupTrace(\"service.start_gateway.end\");\n  };\n\n  private reset = async (): Promise<void> => {\n    await this.fileWatchers.clear();\n    this.bootstrapStatus = this.createBootstrapStatus();\n    this.uiStartup = this.createDisabledUiStartup();\n    this.deferredChannelStarter = this.startChannels;\n  };\n\n  private createBootstrapStatus = (): ServiceBootstrapStatusStore => {\n    const bootstrapStatus = new ServiceBootstrapStatusStore();\n    bootstrapStatus.markChannelsPending();\n    bootstrapStatus.setRemoteState(this.configManager.config.remote.enabled ? \"pending\" : \"disabled\");\n    return bootstrapStatus;\n  };\n\n  private createDisabledUiStartup = (): UiStartupHandle => ({\n    endpoint: \"\",\n  });\n\n  private startUiRuntime = async (): Promise<UiStartupHandle> => {\n    const uiStartup = await measureStartupAsync(\"service.start_ui_runtime\", async () => {\n      logStartupTrace(\"service.start_ui_runtime.begin\");\n      if (!this.uiConfig.enabled) {\n        return this.createDisabledUiStartup();\n      }\n      const uiServer = await startUiServer(this.createUiRouterOptions());\n      const uiUrl = NextclawCore.resolveLocalUiBaseUrl({\n        host: uiServer.host,\n        port: uiServer.port,\n      });\n      console.log(`✓ UI API: ${uiUrl}/api`);\n      if (this.uiStaticDir) {\n        console.log(`✓ UI frontend: ${uiUrl}`);\n      }\n      if (this.uiConfig.open) {\n        openBrowser(uiUrl);\n      }\n      logStartupTrace(\"service.start_ui_runtime.ready\", {\n        host: uiServer.host,\n        port: uiServer.port,\n      });\n      return {\n        endpoint: uiUrl,\n      };\n    });\n    markLocalUiRuntimeIfStarted({\n      uiStartup: this.uiConfig.enabled ? uiStartup : null,\n      uiConfig: this.uiConfig,\n    });\n    return uiStartup;\n  };\n\n  private createUiRouterOptions = (): UiRouterOptions => ({\n    kernel: this.kernel,\n    configPath: this.configManager.configPath,\n    appEventBus: this.appEventBus,\n    uiConfig: this.uiConfig,\n    uiStaticDir: this.uiStaticDir,\n    panelAppClientSdkScript: readPanelAppClientSdkScript,\n    productVersion: this.productVersion,\n    applyLiveConfigReload: this.configManager.applyLiveConfigReload,\n    initializeAgentHomeDirectory: this.deps.initializeAgentHomeDirectory,\n    marketplace: this.marketplace,\n    cron: this.automation,\n    remoteAccess: this.remoteManager.remoteAccess,\n    runtimeControl: this.runtimeControl,\n    ...(this.runtimeUpdate ? { runtimeUpdate: this.runtimeUpdate } : {}),\n    bootstrapStatus: this.bootstrapStatus,\n    extensions: this.extensions,\n  });\n\n  private runRuntimeLoop = async (): Promise<void> => {\n    logStartupTrace(\"service.start_gateway.runtime_loop_begin\");\n    let startupTask: Promise<void> | null = null;\n    try {\n      const runtimeLoopTask = runGatewayInboundLoop(this);\n      startupTask = this.startDeferredRuntime();\n      void startupTask.catch((error) => handleGatewayDeferredStartupError({\n        bootstrapStatus: this.bootstrapStatus,\n        error,\n      }));\n      await runtimeLoopTask;\n    } finally {\n      if (startupTask) {\n        await startupTask.catch(() => undefined);\n      }\n      await this.cleanup();\n    }\n  };\n\n  private startDeferredRuntime = async (): Promise<void> => {\n    const app = new NextclawApp(this);\n    await app.start();\n  };\n\n  readonly startDeferredChannels = async (): Promise<void> => {\n    await this.deferredChannelStarter();\n  };\n\n  private readonly startChannels = async (): Promise<void> => {\n    await this.kernel.channels.start();\n    const enabledChannels = this.kernel.channels.enabledChannels;\n    if (enabledChannels.length > 0) {\n      console.log(`✓ Channels enabled: ${enabledChannels.join(\", \")}`);\n    } else {\n      console.log(\"Warning: No channels enabled\");\n    }\n    this.bootstrapStatus.markChannelsReady(enabledChannels);\n  };\n\n  private createMarketplace = (): MarketplaceApiConfig => ({\n    apiBaseUrl: process.env.NEXTCLAW_MARKETPLACE_API_BASE,\n    installer: new ServiceMarketplaceInstaller({\n      applyLiveConfigReload: this.configManager.applyLiveConfigReload,\n      runCliSubcommand: this.deps.runCliSubcommand,\n      installBuiltinSkill: this.deps.installBuiltinMarketplaceSkill,\n    }).createInstaller(),\n  });\n\n  private cleanup = async (): Promise<void> => {\n    localUiRuntimeStore.clearIfOwnedByProcess();\n    await this.fileWatchers.clear();\n    await this.kernel.extensions.stop();\n    await this.remoteManager.stop();\n  };\n\n  private markUiRuntimeReady = async (): Promise<void> => {\n    this.bootstrapStatus.markShellReady();\n    await waitForNextTick();\n  };\n\n  private createGatewayController = (): GatewayControllerImpl => {\n    return measureStartupSync(\n      \"service.gateway.gateway_controller\",\n      () => new GatewayControllerImpl({\n        configManager: this.configManager,\n        channels: this.kernel.channels,\n        cron: this.automation,\n        sessionManager: this.sessionManager,\n        requestRestart: async (options) => {\n          await this.deps.requestRestart({\n            reason: options?.reason ?? \"gateway tool restart\",\n            manualMessage: \"Restart the gateway to apply changes.\",\n            strategy: \"background-service-or-exit\",\n            delayMs: options?.delayMs,\n            silentOnServiceRestart: true,\n          });\n        },\n      })\n    );\n  };\n\n  private startSupportServices = async (): Promise<void> => {\n    this.extensions.publishConfigChanges();\n    await measureStartupAsync(\"service.start_gateway_support_services\", async () =>\n      await new GatewayRuntimeSupportService({\n        automation: this.automation,\n        remoteModule: this.remoteManager.remoteModule,\n        watchConfigFile: () => watchServiceConfigFile({\n          configPath: resolve(getConfigPath()),\n          watcherRegistry: this.fileWatchers,\n          scheduleReload: (reason) => this.configManager.scheduleReload(reason)\n        }),\n        watcherRegistry: this.fileWatchers\n      }).start()\n    );\n  };\n\n  private installConfigHostHooks = (): void => {\n    this.configManager.installRuntimeHooks({\n      reloadCompanion: async ({ config: nextConfig }) => {\n        await companionRuntimeService.applyConfig(nextConfig);\n      },\n      onRestartRequired: (paths) => {\n        void this.deps.requestRestart({\n          changedPaths: paths,\n          manualMessage: `已保存以下改动，等待你手动重启后生效：${paths.join(\", \")}`,\n          mode: \"notify\",\n          reason: `config reload requires restart: ${paths.join(\", \")}`,\n          strategy: \"background-service-or-manual\",\n        });\n      },\n    });\n  };\n\n  private configureIngressHandlers = (): void => {\n    this.kernel.extensions.registerIngressHandlers();\n  };\n\n}\n"],"mappings":"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"}

package/dist/managers/service-restart.manager.d.ts

@@ -0,0 +1,22 @@
+import { RequestRestartParams } from "../types/cli.types.js";
+import { ManagedServiceManager } from "./managed-service.manager.js";
+
+//#region src/managers/service-restart.manager.d.ts
+type ServiceRestartManagerDeps = {
+  managedService: ManagedServiceManager;
+};
+declare class ServiceRestartManager {
+  private readonly deps;
+  private readonly restartCoordinator;
+  private serviceRestartTask;
+  private selfRelaunchArmed;
+  constructor(deps: ServiceRestartManagerDeps);
+  requestRestart: (params: RequestRestartParams) => Promise<void>;
+  restartBackgroundService: (reason: string) => Promise<boolean>;
+  writeRestartSentinelFromExecContext: (reason: string) => Promise<void>;
+  private scheduleProcessExit;
+  private armManagedServiceRelaunch;
+}
+//#endregion
+export { ServiceRestartManager };
+//# sourceMappingURL=service-restart.manager.d.ts.map

package/dist/managers/service-restart.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-restart.manager.d.ts","names":[],"sources":["../../src/managers/service-restart.manager.ts"],"mappings":";;;;KAYK,yBAAA;EACH,cAAA,EAAgB,qBAAA;AAAA;AAAA,cAGL,qBAAA;EAAA,iBAWkB,IAAA;EAAA,iBAVZ,kBAAA;EAAA,QAOT,kBAAA;EAAA,QACA,iBAAA;cAEqB,IAAA,EAAM,yBAAA;EAEnC,cAAA,GAAwB,MAAA,EAAQ,oBAAA,KAAuB,OAAA;EAgDvD,wBAAA,GAAkC,MAAA,aAAiB,OAAA;EAsCnD,mCAAA,GAA6C,MAAA,aAAiB,OAAA;EAAA,QA0BtD,mBAAA;EAAA,QAOA,yBAAA;AAAA"}

package/dist/managers/service-restart.manager.js

@@ -0,0 +1,183 @@
+import { isProcessRunning } from "../utils/cli.utils.js";
+import { managedServiceStateStore } from "../stores/managed-service-state.store.js";
+import { resolveCliSubcommandLaunch } from "../utils/marketplace/cli-subcommand-launch.utils.js";
+import { createTopLevelNextclawCommandEnv } from "../utils/top-level-nextclaw-command-env.utils.js";
+import { writeRestartSentinel } from "../utils/restart-sentinel.utils.js";
+import { pendingRestartStore } from "../stores/pending-restart.store.js";
+import { RestartCoordinator } from "../services/restart/restart-coordinator.service.js";
+import { APP_NAME } from "@nextclaw/core";
+import { spawn } from "node:child_process";
+//#region src/managers/service-restart.manager.ts
+var ServiceRestartManager = class {
+	restartCoordinator = new RestartCoordinator({
+		readServiceState: managedServiceStateStore.read,
+		isProcessRunning,
+		currentPid: () => process.pid,
+		restartBackgroundService: async (reason) => this.restartBackgroundService(reason),
+		scheduleProcessExit: (delayMs, reason) => this.scheduleProcessExit(delayMs, reason)
+	});
+	serviceRestartTask = null;
+	selfRelaunchArmed = false;
+	constructor(deps) {
+		this.deps = deps;
+	}
+	requestRestart = async (params) => {
+		const { changedPaths, delayMs, manualMessage, mode, reason, silentOnServiceRestart, strategy } = params;
+		if (mode === "notify") {
+			pendingRestartStore.mark({
+				changedPaths,
+				manualMessage,
+				reason
+			});
+			console.warn(manualMessage);
+			return;
+		}
+		this.armManagedServiceRelaunch({
+			reason,
+			strategy,
+			delayMs
+		});
+		const result = await this.restartCoordinator.requestRestart({
+			reason,
+			strategy,
+			delayMs,
+			manualMessage
+		});
+		if (result.status === "manual-required" || result.status === "restart-in-progress") {
+			console.log(result.message);
+			return;
+		}
+		pendingRestartStore.clear();
+		if (result.status === "service-restarted") {
+			if (!silentOnServiceRestart) console.log(result.message);
+			return;
+		}
+		console.warn(result.message);
+	};
+	restartBackgroundService = async (reason) => {
+		if (this.serviceRestartTask) return this.serviceRestartTask;
+		this.serviceRestartTask = (async () => {
+			const state = managedServiceStateStore.read();
+			if (!state || !isProcessRunning(state.pid) || state.pid === process.pid) return false;
+			const uiPort = typeof state.uiPort === "number" && Number.isFinite(state.uiPort) ? state.uiPort : 55667;
+			console.log(`Applying changes (${reason}): restarting ${APP_NAME} background service...`);
+			await this.deps.managedService.stopService();
+			await this.deps.managedService.startService({
+				uiOverrides: {
+					enabled: true,
+					host: "0.0.0.0",
+					port: uiPort
+				},
+				open: false
+			});
+			return true;
+		})();
+		try {
+			return await this.serviceRestartTask;
+		} finally {
+			this.serviceRestartTask = null;
+		}
+	};
+	writeRestartSentinelFromExecContext = async (reason) => {
+		const sessionKeyRaw = process.env.NEXTCLAW_RUNTIME_SESSION_KEY;
+		const sessionKey = typeof sessionKeyRaw === "string" ? sessionKeyRaw.trim() : "";
+		if (!sessionKey) return;
+		try {
+			await writeRestartSentinel({
+				kind: "restart",
+				status: "ok",
+				ts: Date.now(),
+				sessionKey,
+				stats: {
+					reason: reason || "cli.restart",
+					strategy: "exec-tool"
+				}
+			});
+		} catch (error) {
+			console.warn(`Warning: failed to write restart sentinel from exec context: ${String(error)}`);
+		}
+	};
+	scheduleProcessExit = (delayMs, reason) => {
+		console.warn(`Gateway restart requested (${reason}).`);
+		setTimeout(() => {
+			process.exit(0);
+		}, delayMs);
+	};
+	armManagedServiceRelaunch = (params) => {
+		const { delayMs: requestedDelayMs, reason, strategy: requestedStrategy } = params;
+		const strategy = requestedStrategy ?? "background-service-or-manual";
+		if (strategy !== "background-service-or-exit" && strategy !== "exit-process") return;
+		if (this.selfRelaunchArmed) return;
+		const state = managedServiceStateStore.read();
+		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 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");
+const { readFileSync } = require("node:fs");
+const parentPid = ${process.pid};
+const delayMs = ${delayMs};
+const maxWaitMs = 120000;
+const retryIntervalMs = 1000;
+const command = ${JSON.stringify(launch.command)};
+const args = ${JSON.stringify(launch.args)};
+const serviceStatePath = ${JSON.stringify(serviceStatePath)};
+function isRunning(pid) {
+  try { process.kill(pid, 0); return true; } catch { return false; }
+}
+function hasReplacementService() {
+  try {
+    const state = JSON.parse(readFileSync(serviceStatePath, "utf-8"));
+    const pid = Number(state?.pid);
+    return Number.isFinite(pid) && pid > 0 && pid !== parentPid && isRunning(pid);
+  } catch { return false; }
+}
+function tryStart() {
+  spawnSync(command, args, { stdio: "ignore", env: process.env, timeout: 60000, windowsHide: true });
+}
+setTimeout(() => {
+  const startedAt = Date.now();
+  const tick = () => {
+    if (hasReplacementService() || Date.now() - startedAt >= maxWaitMs) {
+      process.exit(0);
+      return;
+    }
+    tryStart();
+    if (hasReplacementService()) {
+      process.exit(0);
+      return;
+    }
+    setTimeout(tick, retryIntervalMs);
+  };
+  tick();
+}, delayMs);
+`.trim();
+		try {
+			spawn(process.execPath, ["-e", helperScript], {
+				detached: true,
+				stdio: "ignore",
+				env: createTopLevelNextclawCommandEnv(process.env),
+				windowsHide: true
+			}).unref();
+			this.selfRelaunchArmed = true;
+			console.warn(`Gateway self-restart armed (${reason}).`);
+		} catch (error) {
+			console.error(`Failed to arm gateway self-restart: ${String(error)}`);
+		}
+	};
+};
+//#endregion
+export { ServiceRestartManager };
+
+//# sourceMappingURL=service-restart.manager.js.map

package/dist/managers/service-restart.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-restart.manager.js","names":[],"sources":["../../src/managers/service-restart.manager.ts"],"sourcesContent":["import { APP_NAME } from \"@nextclaw/core\";\nimport { spawn } from \"node:child_process\";\nimport type { ManagedServiceManager } from \"@nextclaw-service/managers/managed-service.manager.js\";\nimport { RestartCoordinator } from \"@nextclaw-service/services/restart/restart-coordinator.service.js\";\nimport { managedServiceStateStore } from \"@nextclaw-service/stores/managed-service-state.store.js\";\nimport { pendingRestartStore } from \"@nextclaw-service/stores/pending-restart.store.js\";\nimport type { RequestRestartParams } from \"@nextclaw-service/types/cli.types.js\";\nimport { isProcessRunning } from \"@nextclaw-service/utils/cli.utils.js\";\nimport { resolveCliSubcommandLaunch } from \"@nextclaw-service/utils/marketplace/cli-subcommand-launch.utils.js\";\nimport { writeRestartSentinel } from \"@nextclaw-service/utils/restart-sentinel.utils.js\";\nimport { createTopLevelNextclawCommandEnv } from \"@nextclaw-service/utils/top-level-nextclaw-command-env.utils.js\";\n\ntype ServiceRestartManagerDeps = {\n  managedService: ManagedServiceManager;\n};\n\nexport class ServiceRestartManager {\n  private readonly restartCoordinator = new RestartCoordinator({\n    readServiceState: managedServiceStateStore.read,\n    isProcessRunning,\n    currentPid: () => process.pid,\n    restartBackgroundService: async (reason) => this.restartBackgroundService(reason),\n    scheduleProcessExit: (delayMs, reason) => this.scheduleProcessExit(delayMs, reason),\n  });\n  private serviceRestartTask: Promise<boolean> | null = null;\n  private selfRelaunchArmed = false;\n\n  constructor(private readonly deps: ServiceRestartManagerDeps) {}\n\n  requestRestart = async (params: RequestRestartParams): Promise<void> => {\n    const {\n      changedPaths,\n      delayMs,\n      manualMessage,\n      mode,\n      reason,\n      silentOnServiceRestart,\n      strategy\n    } = params;\n    if (mode === \"notify\") {\n      pendingRestartStore.mark({\n        changedPaths,\n        manualMessage,\n        reason\n      });\n      console.warn(manualMessage);\n      return;\n    }\n\n    this.armManagedServiceRelaunch({\n      reason,\n      strategy,\n      delayMs\n    });\n\n    const result = await this.restartCoordinator.requestRestart({\n      reason,\n      strategy,\n      delayMs,\n      manualMessage\n    });\n    if (result.status === \"manual-required\" || result.status === \"restart-in-progress\") {\n      console.log(result.message);\n      return;\n    }\n\n    pendingRestartStore.clear();\n    if (result.status === \"service-restarted\") {\n      if (!silentOnServiceRestart) {\n        console.log(result.message);\n      }\n      return;\n    }\n\n    console.warn(result.message);\n  };\n\n  restartBackgroundService = async (reason: string): Promise<boolean> => {\n    if (this.serviceRestartTask) {\n      return this.serviceRestartTask;\n    }\n\n    this.serviceRestartTask = (async () => {\n      const state = managedServiceStateStore.read();\n      if (!state || !isProcessRunning(state.pid) || state.pid === process.pid) {\n        return false;\n      }\n\n      const uiPort =\n        typeof state.uiPort === \"number\" && Number.isFinite(state.uiPort)\n          ? state.uiPort\n          : 55667;\n\n      console.log(\n        `Applying changes (${reason}): restarting ${APP_NAME} background service...`,\n      );\n      await this.deps.managedService.stopService();\n      await this.deps.managedService.startService({\n        uiOverrides: {\n          enabled: true,\n          host: \"0.0.0.0\",\n          port: uiPort,\n        },\n        open: false,\n      });\n      return true;\n    })();\n\n    try {\n      return await this.serviceRestartTask;\n    } finally {\n      this.serviceRestartTask = null;\n    }\n  };\n\n  writeRestartSentinelFromExecContext = async (reason: string): Promise<void> => {\n    const sessionKeyRaw = process.env.NEXTCLAW_RUNTIME_SESSION_KEY;\n    const sessionKey =\n      typeof sessionKeyRaw === \"string\" ? sessionKeyRaw.trim() : \"\";\n    if (!sessionKey) {\n      return;\n    }\n\n    try {\n      await writeRestartSentinel({\n        kind: \"restart\",\n        status: \"ok\",\n        ts: Date.now(),\n        sessionKey,\n        stats: {\n          reason: reason || \"cli.restart\",\n          strategy: \"exec-tool\",\n        },\n      });\n    } catch (error) {\n      console.warn(\n        `Warning: failed to write restart sentinel from exec context: ${String(error)}`,\n      );\n    }\n  };\n\n  private scheduleProcessExit = (delayMs: number, reason: string): void => {\n    console.warn(`Gateway restart requested (${reason}).`);\n    setTimeout(() => {\n      process.exit(0);\n    }, delayMs);\n  };\n\n  private armManagedServiceRelaunch = (params: {\n    reason: string;\n    strategy?: RequestRestartParams[\"strategy\"];\n    delayMs?: number;\n  }): void => {\n    const { delayMs: requestedDelayMs, reason, strategy: requestedStrategy } = params;\n    const strategy = requestedStrategy ?? \"background-service-or-manual\";\n    if (\n      strategy !== \"background-service-or-exit\" &&\n      strategy !== \"exit-process\"\n    ) {\n      return;\n    }\n    if (this.selfRelaunchArmed) {\n      return;\n    }\n\n    const state = managedServiceStateStore.read();\n    if (!state || state.pid !== process.pid) {\n      return;\n    }\n\n    const uiPort =\n      typeof state.uiPort === \"number\" && Number.isFinite(state.uiPort)\n        ? state.uiPort\n        : 55667;\n    const delayMs =\n      typeof requestedDelayMs === \"number\" && Number.isFinite(requestedDelayMs)\n        ? Math.max(0, Math.floor(requestedDelayMs))\n        : 100;\n    const launch = resolveCliSubcommandLaunch({\n      argvEntry: process.argv[1],\n      importMetaUrl: import.meta.url,\n      cliArgs: [\"start\", \"--ui-port\", String(uiPort)],\n      nodePath: process.execPath\n    });\n    const serviceStatePath = managedServiceStateStore.path;\n    const helperScript = `\nconst { spawnSync } = require(\"node:child_process\");\nconst { readFileSync } = require(\"node:fs\");\nconst parentPid = ${process.pid};\nconst delayMs = ${delayMs};\nconst maxWaitMs = 120000;\nconst retryIntervalMs = 1000;\nconst command = ${JSON.stringify(launch.command)};\nconst args = ${JSON.stringify(launch.args)};\nconst serviceStatePath = ${JSON.stringify(serviceStatePath)};\nfunction isRunning(pid) {\n  try { process.kill(pid, 0); return true; } catch { return false; }\n}\nfunction hasReplacementService() {\n  try {\n    const state = JSON.parse(readFileSync(serviceStatePath, \"utf-8\"));\n    const pid = Number(state?.pid);\n    return Number.isFinite(pid) && pid > 0 && pid !== parentPid && isRunning(pid);\n  } catch { return false; }\n}\nfunction tryStart() {\n  spawnSync(command, args, { stdio: \"ignore\", env: process.env, timeout: 60000, windowsHide: true });\n}\nsetTimeout(() => {\n  const startedAt = Date.now();\n  const tick = () => {\n    if (hasReplacementService() || Date.now() - startedAt >= maxWaitMs) {\n      process.exit(0);\n      return;\n    }\n    tryStart();\n    if (hasReplacementService()) {\n      process.exit(0);\n      return;\n    }\n    setTimeout(tick, retryIntervalMs);\n  };\n  tick();\n}, delayMs);\n`.trim();\n\n    try {\n      const helper = spawn(process.execPath, [\"-e\", helperScript], {\n        detached: true,\n        stdio: \"ignore\",\n        env: createTopLevelNextclawCommandEnv(process.env),\n        windowsHide: true\n      });\n      helper.unref();\n      this.selfRelaunchArmed = true;\n      console.warn(`Gateway self-restart armed (${reason}).`);\n    } catch (error) {\n      console.error(`Failed to arm gateway self-restart: ${String(error)}`);\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/managers/service-workspace.manager.d.ts

@@ -0,0 +1,14 @@
+//#region src/managers/service-workspace.manager.d.ts
+declare class ServiceWorkspaceManager {
+  private readonly pkgRoot;
+  readonly createWorkspaceTemplates: (workspace: string, options?: {
+    force?: boolean;
+  }) => {
+    created: string[];
+  };
+  private readonly ensureWorkspaceDir;
+  private readonly resolveTemplateDir;
+}
+//#endregion
+export { ServiceWorkspaceManager };
+//# sourceMappingURL=service-workspace.manager.d.ts.map

package/dist/managers/service-workspace.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-workspace.manager.d.ts","names":[],"sources":["../../src/managers/service-workspace.manager.ts"],"mappings":";cAKa,uBAAA;EAAA,iBACM,OAAA;EAAA,SASR,wBAAA,GAA4B,SAAA,UAAmB,OAAA;IAAW,KAAA;EAAA;IAA2B,OAAA;EAAA;EAAA,iBA4C7E,kBAAA;EAAA,iBAaA,kBAAA;AAAA"}

package/dist/managers/service-workspace.manager.js

@@ -0,0 +1,86 @@
+import { APP_NAME, DEFAULT_PANELS_DIR, DEFAULT_SKILLS_DIR } from "@nextclaw/core";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/managers/service-workspace.manager.ts
+var ServiceWorkspaceManager = class {
+	pkgRoot = resolve(fileURLToPath(new URL(".", import.meta.url)), "..", "..", "..", "..", "..");
+	createWorkspaceTemplates = (workspace, options = {}) => {
+		const created = [];
+		const force = Boolean(options.force);
+		const templateDir = this.resolveTemplateDir();
+		if (!templateDir) console.warn("Warning: Template directory not found. Skipping workspace templates.");
+		const templateFiles = [
+			{
+				source: "AGENTS.md",
+				target: "AGENTS.md"
+			},
+			{
+				source: "SOUL.md",
+				target: "SOUL.md"
+			},
+			{
+				source: "USER.md",
+				target: "USER.md"
+			},
+			{
+				source: "IDENTITY.md",
+				target: "IDENTITY.md"
+			},
+			{
+				source: "TOOLS.md",
+				target: "TOOLS.md"
+			},
+			{
+				source: "BOOT.md",
+				target: "BOOT.md"
+			},
+			{
+				source: "BOOTSTRAP.md",
+				target: "BOOTSTRAP.md"
+			},
+			{
+				source: "MEMORY.md",
+				target: "MEMORY.md"
+			},
+			{
+				source: "memory/MEMORY.md",
+				target: "memory/MEMORY.md"
+			}
+		];
+		if (templateDir) for (const entry of templateFiles) {
+			const filePath = join(workspace, entry.target);
+			if (!force && existsSync(filePath)) continue;
+			const templatePath = join(templateDir, entry.source);
+			if (!existsSync(templatePath)) {
+				console.warn(`Warning: Template file missing: ${templatePath}`);
+				continue;
+			}
+			const content = readFileSync(templatePath, "utf-8").replace(/\$\{APP_NAME\}/g, APP_NAME);
+			mkdirSync(dirname(filePath), { recursive: true });
+			writeFileSync(filePath, content);
+			created.push(entry.target);
+		}
+		this.ensureWorkspaceDir(workspace, "memory", created);
+		this.ensureWorkspaceDir(workspace, DEFAULT_SKILLS_DIR, created);
+		this.ensureWorkspaceDir(workspace, DEFAULT_PANELS_DIR, created);
+		return { created };
+	};
+	ensureWorkspaceDir = (workspace, dirName, created) => {
+		const dir = join(workspace, dirName);
+		if (existsSync(dir)) return;
+		mkdirSync(dir, { recursive: true });
+		created.push(join(dirName, ""));
+	};
+	resolveTemplateDir = () => {
+		const override = process.env.NEXTCLAW_TEMPLATE_DIR?.trim();
+		if (override) return override;
+		const candidates = [join(this.pkgRoot, "templates")];
+		for (const candidate of candidates) if (existsSync(candidate)) return candidate;
+		return null;
+	};
+};
+//#endregion
+export { ServiceWorkspaceManager };
+
+//# sourceMappingURL=service-workspace.manager.js.map