@xopcai/xopc 0.0.82 → 0.0.83

package/dist/src/gateway/service/config-coordinator.js

@@ -0,0 +1,351 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
+import { getModelRegistry } from "../../providers/model-registry.js";
+import { init_providers } from "../../providers/index.js";
+import { disposeAllSessionMcpRuntimes } from "../../agent/mcp/bundle-mcp-runtime.js";
+import "../../agent/mcp/bundle-mcp-tools.js";
+import { ConfigHotReloader } from "../../config/reload.js";
+import "../../config/index.js";
+import { computeBundledExtensionExtensionsPatch } from "../../extensions/bundled-extension-activation.js";
+import { sanitizeTunnelConfig } from "../../tunnel/tunnel-config.js";
+//#region src/gateway/service/config-coordinator.ts
+init_providers();
+init_logger();
+const log = createLogger("GatewayConfigCoordinator");
+var GatewayConfigCoordinator = class {
+	opts;
+	configReloader = null;
+	channelReloadFlushPromise = null;
+	channelReloadPending = false;
+	constructor(opts) {
+		this.opts = opts;
+	}
+	/** Start the fs.watch-based reloader (idempotent — only starts once). */
+	startHotReloader() {
+		if (this.configReloader) return;
+		this.configReloader = new ConfigHotReloader(this.opts.configPath, this.opts.getConfig(), {
+			onModelsReload: (newConfig) => this.handleModelsReload(newConfig),
+			onAgentDefaultsReload: (newConfig) => this.handleAgentDefaultsReload(newConfig),
+			onChannelsReload: (newConfig) => this.handleChannelsReload(newConfig),
+			onCronReload: (newConfig) => this.handleCronReload(newConfig),
+			onHeartbeatReload: (newConfig) => this.handleHeartbeatReload(newConfig),
+			onToolsReload: (newConfig) => this.handleToolsReload(newConfig),
+			onMcpReload: (newConfig) => this.handleMcpReload(newConfig),
+			onExtensionsReload: async (newConfig, changedPaths) => {
+				await this.handleExtensionsReload(newConfig, changedPaths);
+			},
+			onFullRestart: (newConfig) => {
+				log.warn({
+					requiresProcessRestart: true,
+					hint: "Restart the gateway process (hot reload cannot apply this change)."
+				}, "Config reload: full gateway restart required — see prior \"restartPaths\" info log");
+				this.opts.setConfig(newConfig);
+				this.opts.emit("config.reload", {
+					section: "full",
+					requiresRestart: true
+				});
+			}
+		}, {
+			debounceMs: 300,
+			enabled: this.opts.enableHotReload
+		});
+		this.configReloader.start();
+	}
+	async stopHotReloader() {
+		if (this.configReloader) {
+			await this.configReloader.stop();
+			this.configReloader = null;
+		}
+	}
+	async reloadConfig() {
+		if (!this.configReloader) return {
+			reloaded: false,
+			error: "Config reloader not initialized"
+		};
+		const result = await this.configReloader.triggerReload();
+		return {
+			reloaded: result.success,
+			error: result.error
+		};
+	}
+	async saveConfig(config) {
+		try {
+			await this.writeConfigAndReloadFromDisk(config);
+			this.scheduleChannelPluginsAfterPersist();
+			return { saved: true };
+		} catch (err) {
+			const error = err instanceof Error ? err.message : String(err);
+			log.error({ error }, "Failed to save config");
+			return {
+				saved: false,
+				error
+			};
+		}
+	}
+	/** Merge partial updates into `currentConfig` and persist. */
+	async updateConfig(updates) {
+		try {
+			log.debug("Updating configuration...");
+			const merged = {
+				...this.opts.getConfig(),
+				...updates
+			};
+			this.opts.setConfig(merged);
+			await this.writeConfigAndReloadFromDisk(merged);
+			this.scheduleChannelPluginsAfterPersist();
+			log.debug("Configuration updated successfully");
+			return { updated: true };
+		} catch (err) {
+			const error = err instanceof Error ? err.message : String(err);
+			log.error({ error }, "Failed to update config");
+			return {
+				updated: false,
+				error
+			};
+		}
+	}
+	/**
+	* App store (phase 1): persist `extensions.enabled` / `extensions.disabled`
+	* for a bundled extension. Marketplace-only extensions hot-load on enable;
+	* disable still needs a gateway restart to unload.
+	*/
+	async setBundledExtensionActivationTarget(extensionId, wanted) {
+		const loader = this.opts.getExtensionLoader();
+		if (!loader) return {
+			ok: false,
+			error: "Extension loader unavailable",
+			requiresGatewayRestart: false
+		};
+		const id = extensionId.trim();
+		if (!id) return {
+			ok: false,
+			error: "Invalid extension id",
+			requiresGatewayRestart: false
+		};
+		const patch = computeBundledExtensionExtensionsPatch(loader, this.opts.getConfig(), id, wanted);
+		if (patch.ok === false) return {
+			ok: false,
+			error: patch.error,
+			requiresGatewayRestart: false
+		};
+		const newConfig = {
+			...this.opts.getConfig(),
+			extensions: patch.extensions
+		};
+		const saved = await this.saveConfig(newConfig);
+		if (!saved.saved) return {
+			ok: false,
+			error: saved.error ?? "Failed to save config",
+			requiresGatewayRestart: false
+		};
+		loader.setConfig(this.opts.getConfig());
+		let requiresGatewayRestart = true;
+		if (wanted) try {
+			loader.invalidateManifestCache();
+			await loader.loadByActivationPlan();
+			requiresGatewayRestart = false;
+		} catch (err) {
+			const em = err instanceof Error ? err.message : String(err);
+			log.warn({
+				err,
+				extensionId: id,
+				errorMessage: em
+			}, `Extension hot-load after bundled activation failed: ${em}`);
+			requiresGatewayRestart = true;
+		}
+		this.opts.emit("config.reload", {
+			section: "extensions",
+			source: "bundled-activation"
+		});
+		return {
+			ok: true,
+			requiresGatewayRestart
+		};
+	}
+	async afterWeixinCredentialsPersisted() {
+		const next = loadConfig(this.opts.configPath);
+		this.opts.setConfig(next);
+		this.opts.getAgentService().applyAgentDefaultsFromConfig(next);
+		this.configReloader?.syncCurrentConfig(next);
+		await this.handleChannelsReload(next);
+		const { weixinPlugin } = await import("../../channels/weixin/index.js");
+		await weixinPlugin.reloadMonitorsWithConfig(this.opts.getConfig(), this.opts.bus);
+		log.info("Weixin monitors restarted after credential login");
+	}
+	async afterFeishuCredentialsPersisted() {
+		const next = loadConfig(this.opts.configPath);
+		this.opts.setConfig(next);
+		this.opts.getAgentService().applyAgentDefaultsFromConfig(next);
+		this.configReloader?.syncCurrentConfig(next);
+		await this.handleChannelsReload(next);
+		log.info("Feishu config applied after QR setup");
+	}
+	/**
+	* Apply `latest.channels` to every registered channel plugin (Telegram,
+	* Weixin, extensions). Single runtime path for: file watcher hot reload, API
+	* saves, and Weixin QR follow-up.
+	*/
+	async handleChannelsReload(newConfig) {
+		log.debug("Reloading channels config...");
+		this.opts.setConfig(newConfig);
+		await this.opts.getChannelManager().updateConfig(newConfig);
+		this.opts.emit("config.reload", { section: "channels" });
+		this.opts.emit("channels.status", { channels: this.opts.getChannelsStatus() });
+		log.debug("Channels config reloaded");
+	}
+	/**
+	* Apply `gateway.heartbeat` from current config after PATCH /api/config (and
+	* when hot reload is off). File watcher uses `handleHeartbeatReload` with
+	* the same effect when paths match.
+	*/
+	reloadHeartbeatFromCurrentConfig() {
+		this.handleHeartbeatReload(this.opts.getConfig());
+	}
+	handleModelsReload(newConfig) {
+		log.debug("Reloading models config...");
+		this.opts.setConfig(newConfig);
+		getModelRegistry().refresh();
+		this.opts.emit("config.reload", { section: "models" });
+		log.debug("Models config reloaded");
+	}
+	handleAgentDefaultsReload(newConfig) {
+		log.debug("Reloading agent defaults...");
+		this.opts.setConfig(newConfig);
+		this.opts.getAgentService().applyAgentDefaultsFromConfig(newConfig);
+		this.opts.reconcileBrowserExtensionServer();
+		this.opts.emit("config.reload", { section: "agents" });
+		log.debug("Agent defaults reloaded");
+	}
+	/**
+	* Coalesces rapid saves so Telegram/Weixin do not stop/start repeatedly.
+	* The persist path schedules the channel apply; the same coalescer absorbs
+	* follow-up saves until the first flush settles.
+	*/
+	scheduleChannelPluginsAfterPersist() {
+		this.channelReloadPending = true;
+		if (this.channelReloadFlushPromise) return;
+		this.channelReloadFlushPromise = (async () => {
+			try {
+				while (this.channelReloadPending) {
+					this.channelReloadPending = false;
+					await this.handleChannelsReload(this.opts.getConfig());
+				}
+			} catch (err) {
+				const em = err instanceof Error ? err.message : String(err);
+				log.error({
+					err,
+					errorMessage: em
+				}, `Channel reload after persist failed: ${em}`);
+			} finally {
+				this.channelReloadFlushPromise = null;
+				if (this.channelReloadPending) this.scheduleChannelPluginsAfterPersist();
+			}
+		})();
+	}
+	handleCronReload(newConfig) {
+		log.debug("Reloading cron config...");
+		this.opts.setConfig(newConfig);
+		this.opts.getCronService().updateConfig(newConfig);
+		this.opts.emit("config.reload", { section: "cron" });
+		log.debug("Cron config reloaded");
+	}
+	handleHeartbeatReload(newConfig) {
+		log.debug("Reloading heartbeat config...");
+		this.opts.setConfig(newConfig);
+		this.opts.getHeartbeatService()?.updateConfig(newConfig);
+		this.opts.emit("config.reload", { section: "heartbeat" });
+		log.debug("Heartbeat config reloaded");
+	}
+	handleToolsReload(newConfig) {
+		log.debug("Reloading tools config...");
+		this.opts.setConfig(newConfig);
+		this.opts.emit("config.reload", { section: "tools" });
+		log.debug("Tools config reloaded");
+	}
+	handleMcpReload(newConfig) {
+		log.debug("Reloading MCP config...");
+		this.opts.setConfig(newConfig);
+		disposeAllSessionMcpRuntimes().catch((err) => {
+			log.warn({ err }, "MCP runtime dispose on config reload failed");
+		});
+		this.opts.emit("config.reload", { section: "mcp" });
+		log.debug("MCP config reloaded");
+	}
+	/** Dispatch config hot reload to extensions that registered `registerReload`. */
+	async handleExtensionsReload(newConfig, changedPaths) {
+		this.opts.setConfig(newConfig);
+		const loader = this.opts.getExtensionLoader();
+		loader?.setConfig(newConfig);
+		if (!loader) {
+			this.opts.emit("config.reload", {
+				section: "extensions",
+				source: "extension-reload",
+				changedPaths
+			});
+			return;
+		}
+		const matchingRegs = loader.getRegistry().getMatchingReloadRegistrations(changedPaths);
+		if (matchingRegs.length === 0) {
+			log.debug({ changedPaths }, "No extension reload handlers matched");
+			this.opts.emit("config.reload", {
+				section: "extensions",
+				source: "extension-reload",
+				changedPaths
+			});
+			return;
+		}
+		for (const reg of matchingRegs) {
+			const relevantPaths = changedPaths.filter((p) => reg.configPrefixes.length === 0 || reg.configPrefixes.some((prefix) => p === prefix || p.startsWith(`${prefix}.`)));
+			log.info({
+				extensionId: reg.extensionId,
+				relevantPaths
+			}, "Calling extension reload handler");
+			try {
+				const result = await reg.handler(newConfig, relevantPaths);
+				if (result.success) log.info({ extensionId: reg.extensionId }, "Extension reload succeeded");
+				else log.warn({
+					extensionId: reg.extensionId,
+					error: result.error
+				}, `Extension reload reported failure: ${result.error ?? "unknown"}`);
+			} catch (err) {
+				const errorMessage = err instanceof Error ? err.message : String(err);
+				log.error({
+					err,
+					extensionId: reg.extensionId,
+					errorMessage
+				}, `Extension reload handler threw: ${errorMessage}`);
+			}
+		}
+		this.opts.emit("config.reload", {
+			section: "extensions",
+			source: "extension-reload",
+			changedPaths
+		});
+	}
+	/**
+	* Persist and replace `currentConfig` with the validated file contents so
+	* runtime matches disk (PATCH merge objects can drift from Zod-normalized
+	* output).
+	*/
+	async writeConfigAndReloadFromDisk(configToWrite) {
+		await saveConfig(configToWrite, this.opts.configPath);
+		const reloaded = loadConfig(this.opts.configPath);
+		this.opts.setConfig(reloaded);
+		if (sanitizeTunnelConfig(reloaded)) await saveConfig(reloaded, this.opts.configPath);
+		this.opts.getAgentService().applyAgentDefaultsFromConfig(reloaded);
+		await this.opts.reconcileBrowserExtensionServer();
+		await this.opts.getAgentService().reconcileDreamingNow().catch((err) => {
+			const em = err instanceof Error ? err.message : String(err);
+			log.warn({
+				err,
+				errorMessage: em
+			}, `Dreaming cron reconcile after save failed: ${em}`);
+		});
+		this.configReloader?.syncCurrentConfig(reloaded);
+	}
+};
+//#endregion
+export { GatewayConfigCoordinator };
+
+//# sourceMappingURL=config-coordinator.js.map

package/dist/src/gateway/service/config-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-coordinator.js","names":["writeConfigToDisk"],"sources":["../../../../src/gateway/service/config-coordinator.ts"],"sourcesContent":["/**\n * GatewayConfigCoordinator — owns config persistence, hot-reload, and the\n * per-section reload handlers.\n *\n * Was 350 lines of `GatewayService` covering nine concerns:\n *   - manual `reloadConfig()` (CLI/UI trigger)\n *   - `saveConfig()` / `updateConfig()` (PATCH /api/config)\n *   - `setBundledExtensionActivationTarget` (extension store install)\n *   - `afterWeixinCredentialsPersisted` / `afterFeishuCredentialsPersisted`\n *     (QR-login follow-ups that bypass the watcher)\n *   - `ConfigHotReloader` (fs.watch → debounced per-section dispatch)\n *   - Eight section reload handlers (models / agents / channels / cron /\n *     heartbeat / tools / mcp / extensions)\n *   - `scheduleChannelPluginsAfterPersist` (coalesces rapid saves so\n *     Telegram/Weixin do not stop/start repeatedly)\n *\n * Pulled out so the gateway composition root stays focused on lifecycle, and\n * each handler is reachable from one place when adding a new config section.\n *\n * **Config state ownership.** `GatewayService.config` is still the single\n * source of truth — this coordinator reads it via `getConfig()` and writes it\n * back via `setConfig()` after every reload / persist. We pass through rather\n * than holding our own copy so other coordinators (sessions, marketplace,\n * agent runner) see the latest config the moment a reload commits.\n */\nimport type { Config } from '../../config/schema.js';\nimport type { Config as SurfaceConfig } from '../../config/config-surface.js';\nimport type { AgentService } from '../../agent/service.js';\nimport type { ChannelManager } from '../../channels/manager.js';\nimport type { CronService } from '../../cron/index.js';\nimport type { HeartbeatService } from '../heartbeat/index.js';\nimport type { ExtensionLoader } from '../../extensions/loader.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { ConfigHotReloader } from '../../config/reload.js';\nimport { loadConfig, saveConfig as writeConfigToDisk } from '../../config/index.js';\nimport { sanitizeTunnelConfig } from '../../tunnel/tunnel-config.js';\nimport { getModelRegistry } from '../../providers/index.js';\nimport { disposeAllSessionMcpRuntimes } from '../../agent/mcp/bundle-mcp-tools.js';\nimport { computeBundledExtensionExtensionsPatch } from '../../extensions/bundled-extension-activation.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('GatewayConfigCoordinator');\n\nexport interface GatewayConfigCoordinatorOptions {\n  configPath: string;\n  bus: MessageBus;\n  /** Hot reload (fs.watch) — disabled in tests / certain CLI modes. */\n  enableHotReload: boolean;\n  getConfig: () => Config;\n  /** Writes the new config back into `GatewayService.config`. */\n  setConfig: (next: Config) => void;\n  getAgentService: () => AgentService;\n  getChannelManager: () => ChannelManager;\n  getCronService: () => CronService;\n  getHeartbeatService: () => HeartbeatService | null;\n  getExtensionLoader: () => ExtensionLoader | null;\n  /** Re-evaluate browser-extension server attachment after agent defaults change. */\n  reconcileBrowserExtensionServer: () => Promise<void>;\n  /** Latest channel status snapshot for the `channels.status` SSE event. */\n  getChannelsStatus: () => unknown;\n  /** SSE emit (used for `config.reload` + `channels.status`). */\n  emit: (type: string, payload: unknown) => void;\n}\n\nexport class GatewayConfigCoordinator {\n  private readonly opts: GatewayConfigCoordinatorOptions;\n  private configReloader: ConfigHotReloader | null = null;\n  private channelReloadFlushPromise: Promise<void> | null = null;\n  private channelReloadPending = false;\n\n  constructor(opts: GatewayConfigCoordinatorOptions) {\n    this.opts = opts;\n  }\n\n  // ── Lifecycle ──────────────────────────────────────────────────────────\n\n  /** Start the fs.watch-based reloader (idempotent — only starts once). */\n  startHotReloader(): void {\n    if (this.configReloader) return;\n    this.configReloader = new ConfigHotReloader(\n      this.opts.configPath,\n      this.opts.getConfig(),\n      {\n        onModelsReload: (newConfig) => this.handleModelsReload(newConfig),\n        onAgentDefaultsReload: (newConfig) => this.handleAgentDefaultsReload(newConfig),\n        onChannelsReload: (newConfig) => this.handleChannelsReload(newConfig),\n        onCronReload: (newConfig) => this.handleCronReload(newConfig),\n        onHeartbeatReload: (newConfig) => this.handleHeartbeatReload(newConfig),\n        onToolsReload: (newConfig) => this.handleToolsReload(newConfig),\n        onMcpReload: (newConfig) => this.handleMcpReload(newConfig),\n        onExtensionsReload: async (newConfig, changedPaths) => {\n          await this.handleExtensionsReload(newConfig, changedPaths);\n        },\n        onFullRestart: (newConfig) => {\n          log.warn(\n            { requiresProcessRestart: true, hint: 'Restart the gateway process (hot reload cannot apply this change).' },\n            'Config reload: full gateway restart required — see prior \"restartPaths\" info log',\n          );\n          this.opts.setConfig(newConfig);\n          this.opts.emit('config.reload', { section: 'full', requiresRestart: true });\n        },\n      },\n      {\n        debounceMs: 300,\n        enabled: this.opts.enableHotReload,\n      }\n    );\n    this.configReloader.start();\n  }\n\n  async stopHotReloader(): Promise<void> {\n    if (this.configReloader) {\n      await this.configReloader.stop();\n      this.configReloader = null;\n    }\n  }\n\n  // ── Manual reload (UI trigger) ─────────────────────────────────────────\n\n  async reloadConfig(): Promise<{ reloaded: boolean; error?: string }> {\n    if (!this.configReloader) {\n      return { reloaded: false, error: 'Config reloader not initialized' };\n    }\n    const result = await this.configReloader.triggerReload();\n    return { reloaded: result.success, error: result.error };\n  }\n\n  // ── Persist (PATCH /api/config, marketplace install, etc.) ─────────────\n\n  async saveConfig(config: Config): Promise<{ saved: boolean; error?: string }> {\n    try {\n      await this.writeConfigAndReloadFromDisk(config);\n      this.scheduleChannelPluginsAfterPersist();\n      return { saved: true };\n    } catch (err) {\n      const error = err instanceof Error ? err.message : String(err);\n      log.error({ error }, 'Failed to save config');\n      return { saved: false, error };\n    }\n  }\n\n  /** Merge partial updates into `currentConfig` and persist. */\n  async updateConfig(updates: Partial<Config>): Promise<{ updated: boolean; error?: string }> {\n    try {\n      log.debug('Updating configuration...');\n      const merged = { ...this.opts.getConfig(), ...updates };\n      this.opts.setConfig(merged);\n      await this.writeConfigAndReloadFromDisk(merged);\n      this.scheduleChannelPluginsAfterPersist();\n      log.debug('Configuration updated successfully');\n      return { updated: true };\n    } catch (err) {\n      const error = err instanceof Error ? err.message : String(err);\n      log.error({ error }, 'Failed to update config');\n      return { updated: false, error };\n    }\n  }\n\n  /**\n   * App store (phase 1): persist `extensions.enabled` / `extensions.disabled`\n   * for a bundled extension. Marketplace-only extensions hot-load on enable;\n   * disable still needs a gateway restart to unload.\n   */\n  async setBundledExtensionActivationTarget(\n    extensionId: string,\n    wanted: boolean,\n  ): Promise<{ ok: boolean; error?: string; requiresGatewayRestart: boolean }> {\n    const loader = this.opts.getExtensionLoader();\n    if (!loader) {\n      return { ok: false, error: 'Extension loader unavailable', requiresGatewayRestart: false };\n    }\n    const id = extensionId.trim();\n    if (!id) {\n      return { ok: false, error: 'Invalid extension id', requiresGatewayRestart: false };\n    }\n    const patch = computeBundledExtensionExtensionsPatch(loader, this.opts.getConfig(), id, wanted);\n    if (patch.ok === false) {\n      return { ok: false, error: patch.error, requiresGatewayRestart: false };\n    }\n    const newConfig = { ...this.opts.getConfig(), extensions: patch.extensions } as Config;\n    const saved = await this.saveConfig(newConfig);\n    if (!saved.saved) {\n      return { ok: false, error: saved.error ?? 'Failed to save config', requiresGatewayRestart: false };\n    }\n    loader.setConfig(this.opts.getConfig() as unknown as SurfaceConfig);\n\n    let requiresGatewayRestart = true;\n    if (wanted) {\n      try {\n        loader.invalidateManifestCache();\n        await loader.loadByActivationPlan();\n        requiresGatewayRestart = false;\n      } catch (err) {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, extensionId: id, errorMessage: em },\n          `Extension hot-load after bundled activation failed: ${em}`,\n        );\n        requiresGatewayRestart = true;\n      }\n    }\n\n    this.opts.emit('config.reload', { section: 'extensions', source: 'bundled-activation' });\n    return { ok: true, requiresGatewayRestart };\n  }\n\n  // ── QR-login follow-ups (bypass fs watcher) ────────────────────────────\n\n  async afterWeixinCredentialsPersisted(): Promise<void> {\n    const next = loadConfig(this.opts.configPath);\n    this.opts.setConfig(next);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(next);\n    this.configReloader?.syncCurrentConfig(next);\n    await this.handleChannelsReload(next);\n    const { weixinPlugin } = await import('../../channels/weixin/index.js');\n    await weixinPlugin.reloadMonitorsWithConfig(this.opts.getConfig(), this.opts.bus);\n    log.info('Weixin monitors restarted after credential login');\n  }\n\n  async afterFeishuCredentialsPersisted(): Promise<void> {\n    const next = loadConfig(this.opts.configPath);\n    this.opts.setConfig(next);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(next);\n    this.configReloader?.syncCurrentConfig(next);\n    await this.handleChannelsReload(next);\n    log.info('Feishu config applied after QR setup');\n  }\n\n  // ── Section reload handlers (also used by manual triggers) ─────────────\n\n  /**\n   * Apply `latest.channels` to every registered channel plugin (Telegram,\n   * Weixin, extensions). Single runtime path for: file watcher hot reload, API\n   * saves, and Weixin QR follow-up.\n   */\n  async handleChannelsReload(newConfig: Config): Promise<void> {\n    log.debug('Reloading channels config...');\n    this.opts.setConfig(newConfig);\n    await this.opts.getChannelManager().updateConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'channels' });\n    this.opts.emit('channels.status', { channels: this.opts.getChannelsStatus() });\n    log.debug('Channels config reloaded');\n  }\n\n  /**\n   * Apply `gateway.heartbeat` from current config after PATCH /api/config (and\n   * when hot reload is off). File watcher uses `handleHeartbeatReload` with\n   * the same effect when paths match.\n   */\n  reloadHeartbeatFromCurrentConfig(): void {\n    this.handleHeartbeatReload(this.opts.getConfig());\n  }\n\n  // ── Internals ──────────────────────────────────────────────────────────\n\n  private handleModelsReload(newConfig: Config): void {\n    log.debug('Reloading models config...');\n    this.opts.setConfig(newConfig);\n    getModelRegistry().refresh();\n    this.opts.emit('config.reload', { section: 'models' });\n    log.debug('Models config reloaded');\n  }\n\n  private handleAgentDefaultsReload(newConfig: Config): void {\n    log.debug('Reloading agent defaults...');\n    this.opts.setConfig(newConfig);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(newConfig);\n    void this.opts.reconcileBrowserExtensionServer();\n    this.opts.emit('config.reload', { section: 'agents' });\n    log.debug('Agent defaults reloaded');\n  }\n\n  /**\n   * Coalesces rapid saves so Telegram/Weixin do not stop/start repeatedly.\n   * The persist path schedules the channel apply; the same coalescer absorbs\n   * follow-up saves until the first flush settles.\n   */\n  private scheduleChannelPluginsAfterPersist(): void {\n    this.channelReloadPending = true;\n    if (this.channelReloadFlushPromise) return;\n    this.channelReloadFlushPromise = (async () => {\n      try {\n        while (this.channelReloadPending) {\n          this.channelReloadPending = false;\n          await this.handleChannelsReload(this.opts.getConfig());\n        }\n      } catch (err) {\n        const em = err instanceof Error ? err.message : String(err);\n        log.error({ err, errorMessage: em }, `Channel reload after persist failed: ${em}`);\n      } finally {\n        this.channelReloadFlushPromise = null;\n        if (this.channelReloadPending) {\n          this.scheduleChannelPluginsAfterPersist();\n        }\n      }\n    })();\n  }\n\n  private handleCronReload(newConfig: Config): void {\n    log.debug('Reloading cron config...');\n    this.opts.setConfig(newConfig);\n    this.opts.getCronService().updateConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'cron' });\n    log.debug('Cron config reloaded');\n  }\n\n  private handleHeartbeatReload(newConfig: Config): void {\n    log.debug('Reloading heartbeat config...');\n    this.opts.setConfig(newConfig);\n    this.opts.getHeartbeatService()?.updateConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'heartbeat' });\n    log.debug('Heartbeat config reloaded');\n  }\n\n  private handleToolsReload(newConfig: Config): void {\n    log.debug('Reloading tools config...');\n    this.opts.setConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'tools' });\n    log.debug('Tools config reloaded');\n  }\n\n  private handleMcpReload(newConfig: Config): void {\n    log.debug('Reloading MCP config...');\n    this.opts.setConfig(newConfig);\n    void disposeAllSessionMcpRuntimes().catch((err) => {\n      log.warn({ err }, 'MCP runtime dispose on config reload failed');\n    });\n    this.opts.emit('config.reload', { section: 'mcp' });\n    log.debug('MCP config reloaded');\n  }\n\n  /** Dispatch config hot reload to extensions that registered `registerReload`. */\n  private async handleExtensionsReload(\n    newConfig: Config,\n    changedPaths: string[],\n  ): Promise<void> {\n    this.opts.setConfig(newConfig);\n    const loader = this.opts.getExtensionLoader();\n    loader?.setConfig(newConfig as unknown as SurfaceConfig);\n\n    if (!loader) {\n      this.opts.emit('config.reload', {\n        section: 'extensions',\n        source: 'extension-reload',\n        changedPaths,\n      });\n      return;\n    }\n\n    const registry = loader.getRegistry();\n    const matchingRegs = registry.getMatchingReloadRegistrations(changedPaths);\n\n    if (matchingRegs.length === 0) {\n      log.debug({ changedPaths }, 'No extension reload handlers matched');\n      this.opts.emit('config.reload', {\n        section: 'extensions',\n        source: 'extension-reload',\n        changedPaths,\n      });\n      return;\n    }\n\n    for (const reg of matchingRegs) {\n      const relevantPaths = changedPaths.filter(\n        (p) =>\n          reg.configPrefixes.length === 0 ||\n          reg.configPrefixes.some(\n            (prefix) => p === prefix || p.startsWith(`${prefix}.`),\n          ),\n      );\n\n      log.info(\n        { extensionId: reg.extensionId, relevantPaths },\n        'Calling extension reload handler',\n      );\n\n      try {\n        const result = await reg.handler(newConfig, relevantPaths);\n        if (result.success) {\n          log.info({ extensionId: reg.extensionId }, 'Extension reload succeeded');\n        } else {\n          log.warn(\n            { extensionId: reg.extensionId, error: result.error },\n            `Extension reload reported failure: ${result.error ?? 'unknown'}`,\n          );\n        }\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        log.error(\n          { err, extensionId: reg.extensionId, errorMessage },\n          `Extension reload handler threw: ${errorMessage}`,\n        );\n      }\n    }\n\n    this.opts.emit('config.reload', {\n      section: 'extensions',\n      source: 'extension-reload',\n      changedPaths,\n    });\n  }\n\n  /**\n   * Persist and replace `currentConfig` with the validated file contents so\n   * runtime matches disk (PATCH merge objects can drift from Zod-normalized\n   * output).\n   */\n  private async writeConfigAndReloadFromDisk(configToWrite: Config): Promise<void> {\n    await writeConfigToDisk(configToWrite, this.opts.configPath);\n    const reloaded = loadConfig(this.opts.configPath);\n    this.opts.setConfig(reloaded);\n    if (sanitizeTunnelConfig(reloaded)) {\n      await writeConfigToDisk(reloaded, this.opts.configPath);\n    }\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(reloaded);\n    await this.opts.reconcileBrowserExtensionServer();\n    // Hot-apply: reconcile managed dreaming cron jobs immediately after config persists.\n    await this.opts.getAgentService().reconcileDreamingNow().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Dreaming cron reconcile after save failed: ${em}`);\n    });\n    // Align watcher baseline before channel hooks run so fs `change` does not\n    // re-apply the same diff concurrently.\n    this.configReloader?.syncCurrentConfig(reloaded);\n  }\n}\n"],"mappings":";;;;;;;;;;;;gBAoC4D;aAGP;AAErD,MAAM,MAAM,aAAa,2BAA2B;AAuBpD,IAAa,2BAAb,MAAsC;CACpC;CACA,iBAAmD;CACnD,4BAA0D;CAC1D,uBAA+B;CAE/B,YAAY,MAAuC;AACjD,OAAK,OAAO;;;CAMd,mBAAyB;AACvB,MAAI,KAAK,eAAgB;AACzB,OAAK,iBAAiB,IAAI,kBACxB,KAAK,KAAK,YACV,KAAK,KAAK,WAAW,EACrB;GACE,iBAAiB,cAAc,KAAK,mBAAmB,UAAU;GACjE,wBAAwB,cAAc,KAAK,0BAA0B,UAAU;GAC/E,mBAAmB,cAAc,KAAK,qBAAqB,UAAU;GACrE,eAAe,cAAc,KAAK,iBAAiB,UAAU;GAC7D,oBAAoB,cAAc,KAAK,sBAAsB,UAAU;GACvE,gBAAgB,cAAc,KAAK,kBAAkB,UAAU;GAC/D,cAAc,cAAc,KAAK,gBAAgB,UAAU;GAC3D,oBAAoB,OAAO,WAAW,iBAAiB;AACrD,UAAM,KAAK,uBAAuB,WAAW,aAAa;;GAE5D,gBAAgB,cAAc;AAC5B,QAAI,KACF;KAAE,wBAAwB;KAAM,MAAM;KAAsE,EAC5G,qFACD;AACD,SAAK,KAAK,UAAU,UAAU;AAC9B,SAAK,KAAK,KAAK,iBAAiB;KAAE,SAAS;KAAQ,iBAAiB;KAAM,CAAC;;GAE9E,EACD;GACE,YAAY;GACZ,SAAS,KAAK,KAAK;GACpB,CACF;AACD,OAAK,eAAe,OAAO;;CAG7B,MAAM,kBAAiC;AACrC,MAAI,KAAK,gBAAgB;AACvB,SAAM,KAAK,eAAe,MAAM;AAChC,QAAK,iBAAiB;;;CAM1B,MAAM,eAA+D;AACnE,MAAI,CAAC,KAAK,eACR,QAAO;GAAE,UAAU;GAAO,OAAO;GAAmC;EAEtE,MAAM,SAAS,MAAM,KAAK,eAAe,eAAe;AACxD,SAAO;GAAE,UAAU,OAAO;GAAS,OAAO,OAAO;GAAO;;CAK1D,MAAM,WAAW,QAA6D;AAC5E,MAAI;AACF,SAAM,KAAK,6BAA6B,OAAO;AAC/C,QAAK,oCAAoC;AACzC,UAAO,EAAE,OAAO,MAAM;WACf,KAAK;GACZ,MAAM,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC9D,OAAI,MAAM,EAAE,OAAO,EAAE,wBAAwB;AAC7C,UAAO;IAAE,OAAO;IAAO;IAAO;;;;CAKlC,MAAM,aAAa,SAAyE;AAC1F,MAAI;AACF,OAAI,MAAM,4BAA4B;GACtC,MAAM,SAAS;IAAE,GAAG,KAAK,KAAK,WAAW;IAAE,GAAG;IAAS;AACvD,QAAK,KAAK,UAAU,OAAO;AAC3B,SAAM,KAAK,6BAA6B,OAAO;AAC/C,QAAK,oCAAoC;AACzC,OAAI,MAAM,qCAAqC;AAC/C,UAAO,EAAE,SAAS,MAAM;WACjB,KAAK;GACZ,MAAM,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC9D,OAAI,MAAM,EAAE,OAAO,EAAE,0BAA0B;AAC/C,UAAO;IAAE,SAAS;IAAO;IAAO;;;;;;;;CASpC,MAAM,oCACJ,aACA,QAC2E;EAC3E,MAAM,SAAS,KAAK,KAAK,oBAAoB;AAC7C,MAAI,CAAC,OACH,QAAO;GAAE,IAAI;GAAO,OAAO;GAAgC,wBAAwB;GAAO;EAE5F,MAAM,KAAK,YAAY,MAAM;AAC7B,MAAI,CAAC,GACH,QAAO;GAAE,IAAI;GAAO,OAAO;GAAwB,wBAAwB;GAAO;EAEpF,MAAM,QAAQ,uCAAuC,QAAQ,KAAK,KAAK,WAAW,EAAE,IAAI,OAAO;AAC/F,MAAI,MAAM,OAAO,MACf,QAAO;GAAE,IAAI;GAAO,OAAO,MAAM;GAAO,wBAAwB;GAAO;EAEzE,MAAM,YAAY;GAAE,GAAG,KAAK,KAAK,WAAW;GAAE,YAAY,MAAM;GAAY;EAC5E,MAAM,QAAQ,MAAM,KAAK,WAAW,UAAU;AAC9C,MAAI,CAAC,MAAM,MACT,QAAO;GAAE,IAAI;GAAO,OAAO,MAAM,SAAS;GAAyB,wBAAwB;GAAO;AAEpG,SAAO,UAAU,KAAK,KAAK,WAAW,CAA6B;EAEnE,IAAI,yBAAyB;AAC7B,MAAI,OACF,KAAI;AACF,UAAO,yBAAyB;AAChC,SAAM,OAAO,sBAAsB;AACnC,4BAAyB;WAClB,KAAK;GACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAI,KACF;IAAE;IAAK,aAAa;IAAI,cAAc;IAAI,EAC1C,uDAAuD,KACxD;AACD,4BAAyB;;AAI7B,OAAK,KAAK,KAAK,iBAAiB;GAAE,SAAS;GAAc,QAAQ;GAAsB,CAAC;AACxF,SAAO;GAAE,IAAI;GAAM;GAAwB;;CAK7C,MAAM,kCAAiD;EACrD,MAAM,OAAO,WAAW,KAAK,KAAK,WAAW;AAC7C,OAAK,KAAK,UAAU,KAAK;AACzB,OAAK,KAAK,iBAAiB,CAAC,6BAA6B,KAAK;AAC9D,OAAK,gBAAgB,kBAAkB,KAAK;AAC5C,QAAM,KAAK,qBAAqB,KAAK;EACrC,MAAM,EAAE,iBAAiB,MAAM,OAAO;AACtC,QAAM,aAAa,yBAAyB,KAAK,KAAK,WAAW,EAAE,KAAK,KAAK,IAAI;AACjF,MAAI,KAAK,mDAAmD;;CAG9D,MAAM,kCAAiD;EACrD,MAAM,OAAO,WAAW,KAAK,KAAK,WAAW;AAC7C,OAAK,KAAK,UAAU,KAAK;AACzB,OAAK,KAAK,iBAAiB,CAAC,6BAA6B,KAAK;AAC9D,OAAK,gBAAgB,kBAAkB,KAAK;AAC5C,QAAM,KAAK,qBAAqB,KAAK;AACrC,MAAI,KAAK,uCAAuC;;;;;;;CAUlD,MAAM,qBAAqB,WAAkC;AAC3D,MAAI,MAAM,+BAA+B;AACzC,OAAK,KAAK,UAAU,UAAU;AAC9B,QAAM,KAAK,KAAK,mBAAmB,CAAC,aAAa,UAAU;AAC3D,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,YAAY,CAAC;AACxD,OAAK,KAAK,KAAK,mBAAmB,EAAE,UAAU,KAAK,KAAK,mBAAmB,EAAE,CAAC;AAC9E,MAAI,MAAM,2BAA2B;;;;;;;CAQvC,mCAAyC;AACvC,OAAK,sBAAsB,KAAK,KAAK,WAAW,CAAC;;CAKnD,mBAA2B,WAAyB;AAClD,MAAI,MAAM,6BAA6B;AACvC,OAAK,KAAK,UAAU,UAAU;AAC9B,oBAAkB,CAAC,SAAS;AAC5B,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,UAAU,CAAC;AACtD,MAAI,MAAM,yBAAyB;;CAGrC,0BAAkC,WAAyB;AACzD,MAAI,MAAM,8BAA8B;AACxC,OAAK,KAAK,UAAU,UAAU;AAC9B,OAAK,KAAK,iBAAiB,CAAC,6BAA6B,UAAU;AAC9D,OAAK,KAAK,iCAAiC;AAChD,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,UAAU,CAAC;AACtD,MAAI,MAAM,0BAA0B;;;;;;;CAQtC,qCAAmD;AACjD,OAAK,uBAAuB;AAC5B,MAAI,KAAK,0BAA2B;AACpC,OAAK,6BAA6B,YAAY;AAC5C,OAAI;AACF,WAAO,KAAK,sBAAsB;AAChC,UAAK,uBAAuB;AAC5B,WAAM,KAAK,qBAAqB,KAAK,KAAK,WAAW,CAAC;;YAEjD,KAAK;IACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,QAAI,MAAM;KAAE;KAAK,cAAc;KAAI,EAAE,wCAAwC,KAAK;aAC1E;AACR,SAAK,4BAA4B;AACjC,QAAI,KAAK,qBACP,MAAK,oCAAoC;;MAG3C;;CAGN,iBAAyB,WAAyB;AAChD,MAAI,MAAM,2BAA2B;AACrC,OAAK,KAAK,UAAU,UAAU;AAC9B,OAAK,KAAK,gBAAgB,CAAC,aAAa,UAAU;AAClD,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,QAAQ,CAAC;AACpD,MAAI,MAAM,uBAAuB;;CAGnC,sBAA8B,WAAyB;AACrD,MAAI,MAAM,gCAAgC;AAC1C,OAAK,KAAK,UAAU,UAAU;AAC9B,OAAK,KAAK,qBAAqB,EAAE,aAAa,UAAU;AACxD,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,aAAa,CAAC;AACzD,MAAI,MAAM,4BAA4B;;CAGxC,kBAA0B,WAAyB;AACjD,MAAI,MAAM,4BAA4B;AACtC,OAAK,KAAK,UAAU,UAAU;AAC9B,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,SAAS,CAAC;AACrD,MAAI,MAAM,wBAAwB;;CAGpC,gBAAwB,WAAyB;AAC/C,MAAI,MAAM,0BAA0B;AACpC,OAAK,KAAK,UAAU,UAAU;AACzB,gCAA8B,CAAC,OAAO,QAAQ;AACjD,OAAI,KAAK,EAAE,KAAK,EAAE,8CAA8C;IAChE;AACF,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,OAAO,CAAC;AACnD,MAAI,MAAM,sBAAsB;;;CAIlC,MAAc,uBACZ,WACA,cACe;AACf,OAAK,KAAK,UAAU,UAAU;EAC9B,MAAM,SAAS,KAAK,KAAK,oBAAoB;AAC7C,UAAQ,UAAU,UAAsC;AAExD,MAAI,CAAC,QAAQ;AACX,QAAK,KAAK,KAAK,iBAAiB;IAC9B,SAAS;IACT,QAAQ;IACR;IACD,CAAC;AACF;;EAIF,MAAM,eADW,OAAO,aACK,CAAC,+BAA+B,aAAa;AAE1E,MAAI,aAAa,WAAW,GAAG;AAC7B,OAAI,MAAM,EAAE,cAAc,EAAE,uCAAuC;AACnE,QAAK,KAAK,KAAK,iBAAiB;IAC9B,SAAS;IACT,QAAQ;IACR;IACD,CAAC;AACF;;AAGF,OAAK,MAAM,OAAO,cAAc;GAC9B,MAAM,gBAAgB,aAAa,QAChC,MACC,IAAI,eAAe,WAAW,KAC9B,IAAI,eAAe,MAChB,WAAW,MAAM,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,CACvD,CACJ;AAED,OAAI,KACF;IAAE,aAAa,IAAI;IAAa;IAAe,EAC/C,mCACD;AAED,OAAI;IACF,MAAM,SAAS,MAAM,IAAI,QAAQ,WAAW,cAAc;AAC1D,QAAI,OAAO,QACT,KAAI,KAAK,EAAE,aAAa,IAAI,aAAa,EAAE,6BAA6B;QAExE,KAAI,KACF;KAAE,aAAa,IAAI;KAAa,OAAO,OAAO;KAAO,EACrD,sCAAsC,OAAO,SAAS,YACvD;YAEI,KAAK;IACZ,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AACrE,QAAI,MACF;KAAE;KAAK,aAAa,IAAI;KAAa;KAAc,EACnD,mCAAmC,eACpC;;;AAIL,OAAK,KAAK,KAAK,iBAAiB;GAC9B,SAAS;GACT,QAAQ;GACR;GACD,CAAC;;;;;;;CAQJ,MAAc,6BAA6B,eAAsC;AAC/E,QAAMA,WAAkB,eAAe,KAAK,KAAK,WAAW;EAC5D,MAAM,WAAW,WAAW,KAAK,KAAK,WAAW;AACjD,OAAK,KAAK,UAAU,SAAS;AAC7B,MAAI,qBAAqB,SAAS,CAChC,OAAMA,WAAkB,UAAU,KAAK,KAAK,WAAW;AAEzD,OAAK,KAAK,iBAAiB,CAAC,6BAA6B,SAAS;AAClE,QAAM,KAAK,KAAK,iCAAiC;AAEjD,QAAM,KAAK,KAAK,iBAAiB,CAAC,sBAAsB,CAAC,OAAO,QAAQ;GACtE,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAI,KAAK;IAAE;IAAK,cAAc;IAAI,EAAE,8CAA8C,KAAK;IACvF;AAGF,OAAK,gBAAgB,kBAAkB,SAAS"}

package/dist/src/gateway/service/marketplace-service.d.ts

@@ -0,0 +1,85 @@
+import type { Config } from '../../config/schema.js';
+import type { AgentService } from '../../agent/service.js';
+import type { ChannelManager } from '../../channels/manager.js';
+import type { ExtensionLoader } from '../../extensions/loader.js';
+import type { SkillCatalogEntry } from '../../agent/agent-manager.js';
+import type { ManagedSkillListItem } from '../../agent/skills/managed-store.js';
+import type { SkillMarkdownPreviewPayload } from '../../agent/skills/types.js';
+import type { MarketplaceCategoryOption, SkillsStoreListParams, UnifiedMarketplaceListResponse, UnifiedMarketplacePackageDetail } from '../../agent/skills/skills-marketplace.js';
+import type { MarketplacePackageDetail } from '../../agent/skills/marketplace/adapters/store/store-api-client.js';
+export interface GatewayMarketplaceServiceOptions {
+    getConfig: () => Config;
+    getAgentService: () => AgentService;
+    getExtensionLoader: () => ExtensionLoader | null;
+    getChannelManager: () => ChannelManager;
+    saveConfig: (config: Config) => Promise<{
+        saved: boolean;
+        error?: string;
+    }>;
+    emit: (type: string, payload: unknown) => void;
+}
+export declare class GatewayMarketplaceService {
+    private readonly opts;
+    constructor(opts: GatewayMarketplaceServiceOptions);
+    getSkillsApi(lang?: string): {
+        catalog: SkillCatalogEntry[];
+        managed: ManagedSkillListItem[];
+    };
+    getSkillMarkdownSource(skillName: string, lang?: string): SkillMarkdownPreviewPayload | null;
+    deleteSkill(skillId: string): void;
+    installSkillZip(buffer: Buffer, opts: {
+        skillId?: string;
+        overwrite?: boolean;
+    }): {
+        skillId: string;
+        path: string;
+    };
+    reloadSkills(): void;
+    patchSkillEnabled(skillName: string, enabled: boolean): void;
+    fetchSkillsCatalog(params: SkillsStoreListParams, provider?: string): Promise<UnifiedMarketplaceListResponse>;
+    fetchSkillsCategories(provider?: string): Promise<{
+        items: MarketplaceCategoryOption[];
+    }>;
+    fetchSkillsPackageDetail(packageName: string, provider?: string): Promise<UnifiedMarketplacePackageDetail>;
+    installSkill(opts: {
+        name: string;
+        version?: string;
+        overwrite?: boolean;
+        provider?: string;
+    }): Promise<{
+        skillId: string;
+        path: string;
+    }>;
+    getSkillsProvider(): {
+        provider: string;
+        displayName: string;
+    };
+    /** All registered marketplace providers (built-in + extension-contributed). */
+    getSkillsProviders(): Array<{
+        id: string;
+        displayName: string;
+    }>;
+    /** xopc-store extension package preview (type must be `extension`). */
+    fetchExtensionPackageDetail(packageName: string): Promise<MarketplacePackageDetail>;
+    /**
+     * Install an extension from xopc-store into `~/.xopc/extensions`, append id
+     * to `extensions.enabled`, refresh the loader, and emit `config.reload`.
+     * Returns `requiresGatewayRestart=true` when a new channel plugin would have
+     * to wire into the running gateway (channel registration cannot hot-patch).
+     */
+    installExtension(opts: {
+        name: string;
+        version?: string;
+        overwrite?: boolean;
+    }): Promise<{
+        extensionId: string;
+        version: string;
+        requiresGatewayRestart: boolean;
+    }>;
+    /** Remove a user-installed extension (global or per-agent dir) from disk and config. */
+    uninstallExtension(extensionId: string): Promise<{
+        requiresGatewayRestart: boolean;
+    }>;
+    private mergeExtensionEnabledIntoConfig;
+    private mergeExtensionRemovedFromEnabledConfig;
+}