@noxsoft/anima 2.0.2 → 2.0.4

package/dist/plugins-cli-QSIsMUG7.js

@@ -1,736 +0,0 @@
-import { g as resolveStateDir } from "./paths-C6VCWKo3.js";
-import { B as theme, u as defaultRuntime } from "./subsystem-Dowf8fSU.js";
-import { C as shortenHomePath, S as shortenHomeInString, _ as resolveConfigDir, b as resolveUserPath } from "./utils-Bsw__U-F.js";
-import "./thinking-BLU0jXR8.js";
-import "./subagent-registry-9RLdKxES.js";
-import "./reply-qalRISe_.js";
-import "./exec-Bv3pyjeM.js";
-import "./agent-scope-V1bi9OYL.js";
-import "./model-selection-YcSr9CgC.js";
-import "./boolean-Wzu0-e0P.js";
-import "./env-0lJfCPsw.js";
-import "./lanes-CNxj3tit.js";
-import { i as loadConfig, l as writeConfigFile } from "./config-SY8M0kM_.js";
-import { f as applyExclusiveSlotSelection, o as resolveBundledPluginsDir, p as defaultSlotIdForKey } from "./manifest-registry-CW1zCyRF.js";
-import "./sessions-BfV53TbG.js";
-import "./image-ops-omlvdfah.js";
-import "./polls-CItfB1H8.js";
-import "./mime-C1RlpUSs.js";
-import "./cli-session-BkPTd9Pk.js";
-import "./dock-cPBY4qGl.js";
-import "./logging-54nXj81z.js";
-import "./accounts-Cc5E4IDO.js";
-import "./tokens-DkvqA72p.js";
-import "./sandbox-DxP3IpUP.js";
-import "./chrome-DScZx4Lk.js";
-import { g as promptYesNo } from "./auth-91o2YM96.js";
-import "./server-context-LrlgrZzS.js";
-import "./skills-B-G7UHOa.js";
-import "./routes-CENsHJyg.js";
-import "./paths-BgUi2Z2G.js";
-import "./ports-D94CwCrv.js";
-import "./trash-_x5UZ94k.js";
-import "./message-channel-dSTVVCyX.js";
-import "./plugins-CmSUIUNi.js";
-import "./paths-hcX1Gqg5.js";
-import "./commands-registry-DYfRSVF3.js";
-import "./markdown-tables-DHgOK2vI.js";
-import "./deliver-xrmk7xjh.js";
-import "./pairing-store-DJz_9Gv0.js";
-import "./client-CC94YZrT.js";
-import "./call-Ct7EGP_L.js";
-import "./nodes-screen-1YiLkqr5.js";
-import "./memory-cli-Jmma-xI_.js";
-import "./manager-Cqc1CeH7.js";
-import "./sqlite-CGcOZZ0C.js";
-import "./redact-BHmk44DI.js";
-import "./common-zW9Y2P1B.js";
-import { t as formatDocsLink } from "./links-DPGe0OHw.js";
-import "./progress-Bek_GyWS.js";
-import "./control-service-C8m8F9pr.js";
-import "./dispatcher-3Jae6AiW.js";
-import "./pi-model-discovery-BkqhoPls.js";
-import "./channel-selection-CujyiWGM.js";
-import "./delivery-queue-TnQykYsg.js";
-import "./pi-tools.policy-D81U5xy0.js";
-import "./session-cost-usage-DT9YNXTJ.js";
-import { l as resolveArchiveKind } from "./npm-registry-spec-B-XIShkB.js";
-import "./skill-scanner-Coo4QoCd.js";
-import { i as resolvePluginInstallDir, n as installPluginFromNpmSpec, r as installPluginFromPath, t as recordPluginInstall } from "./installs-C2iMRBVz.js";
-import { t as renderTable } from "./table-BL0lJzsm.js";
-import { t as buildPluginStatusReport } from "./status-RA_uNmK0.js";
-import { n as updateNpmInstalledPlugins } from "./update-LFgxHHPd.js";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import fs$1 from "node:fs/promises";
-
-//#region src/plugins/source-display.ts
-function tryRelative(root, filePath) {
-	const rel = path.relative(root, filePath);
-	if (!rel || rel === ".") return null;
-	if (rel === "..") return null;
-	if (rel.startsWith(`..${path.sep}`) || rel.startsWith("../") || rel.startsWith("..\\")) return null;
-	if (path.isAbsolute(rel)) return null;
-	return rel.replaceAll("\\", "/");
-}
-function resolvePluginSourceRoots(params) {
-	return {
-		stock: resolveBundledPluginsDir(),
-		global: path.join(resolveConfigDir(), "extensions"),
-		workspace: params.workspaceDir ? path.join(params.workspaceDir, ".anima", "extensions") : void 0
-	};
-}
-function formatPluginSourceForTable(plugin, roots) {
-	const raw = plugin.source;
-	if (plugin.origin === "bundled" && roots.stock) {
-		const rel = tryRelative(roots.stock, raw);
-		if (rel) return {
-			value: `stock:${rel}`,
-			rootKey: "stock"
-		};
-	}
-	if (plugin.origin === "workspace" && roots.workspace) {
-		const rel = tryRelative(roots.workspace, raw);
-		if (rel) return {
-			value: `workspace:${rel}`,
-			rootKey: "workspace"
-		};
-	}
-	if (plugin.origin === "global" && roots.global) {
-		const rel = tryRelative(roots.global, raw);
-		if (rel) return {
-			value: `global:${rel}`,
-			rootKey: "global"
-		};
-	}
-	return { value: shortenHomeInString(raw) };
-}
-
-//#endregion
-//#region src/plugins/uninstall.ts
-function resolveUninstallDirectoryTarget(params) {
-	if (!params.hasInstall) return null;
-	if (params.installRecord?.source === "path") return null;
-	let defaultPath;
-	try {
-		defaultPath = resolvePluginInstallDir(params.pluginId, params.extensionsDir);
-	} catch {
-		return null;
-	}
-	const configuredPath = params.installRecord?.installPath;
-	if (!configuredPath) return defaultPath;
-	if (path.resolve(configuredPath) === path.resolve(defaultPath)) return configuredPath;
-	return defaultPath;
-}
-/**
-* Remove plugin references from config (pure config mutation).
-* Returns a new config with the plugin removed from entries, installs, allow, load.paths, and slots.
-*/
-function removePluginFromConfig(cfg, pluginId) {
-	const actions = {
-		entry: false,
-		install: false,
-		allowlist: false,
-		loadPath: false,
-		memorySlot: false
-	};
-	const pluginsConfig = cfg.plugins ?? {};
-	let entries = pluginsConfig.entries;
-	if (entries && pluginId in entries) {
-		const { [pluginId]: _, ...rest } = entries;
-		entries = Object.keys(rest).length > 0 ? rest : void 0;
-		actions.entry = true;
-	}
-	let installs = pluginsConfig.installs;
-	const installRecord = installs?.[pluginId];
-	if (installs && pluginId in installs) {
-		const { [pluginId]: _, ...rest } = installs;
-		installs = Object.keys(rest).length > 0 ? rest : void 0;
-		actions.install = true;
-	}
-	let allow = pluginsConfig.allow;
-	if (Array.isArray(allow) && allow.includes(pluginId)) {
-		allow = allow.filter((id) => id !== pluginId);
-		if (allow.length === 0) allow = void 0;
-		actions.allowlist = true;
-	}
-	let load = pluginsConfig.load;
-	if (installRecord?.source === "path" && installRecord.sourcePath) {
-		const sourcePath = installRecord.sourcePath;
-		const loadPaths = load?.paths;
-		if (Array.isArray(loadPaths) && loadPaths.includes(sourcePath)) {
-			const nextLoadPaths = loadPaths.filter((p) => p !== sourcePath);
-			load = nextLoadPaths.length > 0 ? {
-				...load,
-				paths: nextLoadPaths
-			} : void 0;
-			actions.loadPath = true;
-		}
-	}
-	let slots = pluginsConfig.slots;
-	if (slots?.memory === pluginId) {
-		slots = {
-			...slots,
-			memory: defaultSlotIdForKey("memory")
-		};
-		actions.memorySlot = true;
-	}
-	if (slots && Object.keys(slots).length === 0) slots = void 0;
-	const cleanedPlugins = {
-		...pluginsConfig,
-		entries,
-		installs,
-		allow,
-		load,
-		slots
-	};
-	if (cleanedPlugins.entries === void 0) delete cleanedPlugins.entries;
-	if (cleanedPlugins.installs === void 0) delete cleanedPlugins.installs;
-	if (cleanedPlugins.allow === void 0) delete cleanedPlugins.allow;
-	if (cleanedPlugins.load === void 0) delete cleanedPlugins.load;
-	if (cleanedPlugins.slots === void 0) delete cleanedPlugins.slots;
-	return {
-		config: {
-			...cfg,
-			plugins: Object.keys(cleanedPlugins).length > 0 ? cleanedPlugins : void 0
-		},
-		actions
-	};
-}
-/**
-* Uninstall a plugin by removing it from config and optionally deleting installed files.
-* Linked plugins (source === "path") never have their source directory deleted.
-*/
-async function uninstallPlugin(params) {
-	const { config, pluginId, deleteFiles = true, extensionsDir } = params;
-	const hasEntry = pluginId in (config.plugins?.entries ?? {});
-	const hasInstall = pluginId in (config.plugins?.installs ?? {});
-	if (!hasEntry && !hasInstall) return {
-		ok: false,
-		error: `Plugin not found: ${pluginId}`
-	};
-	const installRecord = config.plugins?.installs?.[pluginId];
-	const isLinked = installRecord?.source === "path";
-	const { config: newConfig, actions: configActions } = removePluginFromConfig(config, pluginId);
-	const actions = {
-		...configActions,
-		directory: false
-	};
-	const warnings = [];
-	const deleteTarget = deleteFiles && !isLinked ? resolveUninstallDirectoryTarget({
-		pluginId,
-		hasInstall,
-		installRecord,
-		extensionsDir
-	}) : null;
-	if (deleteTarget) {
-		const existed = await fs$1.access(deleteTarget).then(() => true).catch(() => false) ?? false;
-		try {
-			await fs$1.rm(deleteTarget, {
-				recursive: true,
-				force: true
-			});
-			actions.directory = existed;
-		} catch (error) {
-			warnings.push(`Failed to remove plugin directory ${deleteTarget}: ${error instanceof Error ? error.message : String(error)}`);
-		}
-	}
-	return {
-		ok: true,
-		config: newConfig,
-		pluginId,
-		actions,
-		warnings
-	};
-}
-
-//#endregion
-//#region src/cli/plugins-cli.ts
-function resolveFileNpmSpecToLocalPath(raw) {
-	const trimmed = raw.trim();
-	if (!trimmed.toLowerCase().startsWith("file:")) return null;
-	const rest = trimmed.slice(5);
-	if (!rest) return {
-		ok: false,
-		error: "unsupported file: spec: missing path"
-	};
-	if (rest.startsWith("///")) return {
-		ok: true,
-		path: rest.slice(2)
-	};
-	if (rest.startsWith("//localhost/")) return {
-		ok: true,
-		path: rest.slice(11)
-	};
-	if (rest.startsWith("//")) return {
-		ok: false,
-		error: "unsupported file: URL host (expected \"file:<path>\" or \"file:///abs/path\")"
-	};
-	return {
-		ok: true,
-		path: rest
-	};
-}
-function formatPluginLine(plugin, verbose = false) {
-	const status = plugin.status === "loaded" ? theme.success("loaded") : plugin.status === "disabled" ? theme.warn("disabled") : theme.error("error");
-	const name = theme.command(plugin.name || plugin.id);
-	const idSuffix = plugin.name && plugin.name !== plugin.id ? theme.muted(` (${plugin.id})`) : "";
-	const desc = plugin.description ? theme.muted(plugin.description.length > 60 ? `${plugin.description.slice(0, 57)}...` : plugin.description) : theme.muted("(no description)");
-	if (!verbose) return `${name}${idSuffix} ${status} - ${desc}`;
-	const parts = [
-		`${name}${idSuffix} ${status}`,
-		`  source: ${theme.muted(shortenHomeInString(plugin.source))}`,
-		`  origin: ${plugin.origin}`
-	];
-	if (plugin.version) parts.push(`  version: ${plugin.version}`);
-	if (plugin.providerIds.length > 0) parts.push(`  providers: ${plugin.providerIds.join(", ")}`);
-	if (plugin.error) parts.push(theme.error(`  error: ${plugin.error}`));
-	return parts.join("\n");
-}
-function applySlotSelectionForPlugin(config, pluginId) {
-	const report = buildPluginStatusReport({ config });
-	const plugin = report.plugins.find((entry) => entry.id === pluginId);
-	if (!plugin) return {
-		config,
-		warnings: []
-	};
-	const result = applyExclusiveSlotSelection({
-		config,
-		selectedId: plugin.id,
-		selectedKind: plugin.kind,
-		registry: report
-	});
-	return {
-		config: result.config,
-		warnings: result.warnings
-	};
-}
-function createPluginInstallLogger() {
-	return {
-		info: (msg) => defaultRuntime.log(msg),
-		warn: (msg) => defaultRuntime.log(theme.warn(msg))
-	};
-}
-function enablePluginInConfig(config, pluginId) {
-	return {
-		...config,
-		plugins: {
-			...config.plugins,
-			entries: {
-				...config.plugins?.entries,
-				[pluginId]: {
-					...config.plugins?.entries?.[pluginId],
-					enabled: true
-				}
-			}
-		}
-	};
-}
-function logSlotWarnings(warnings) {
-	if (warnings.length === 0) return;
-	for (const warning of warnings) defaultRuntime.log(theme.warn(warning));
-}
-function registerPluginsCli(program) {
-	const plugins = program.command("plugins").description("Manage OpenClaw plugins/extensions").addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/plugins", "docs.openclaw.ai/cli/plugins")}\n`);
-	plugins.command("list").description("List discovered plugins").option("--json", "Print JSON").option("--enabled", "Only show enabled plugins", false).option("--verbose", "Show detailed entries", false).action((opts) => {
-		const report = buildPluginStatusReport();
-		const list = opts.enabled ? report.plugins.filter((p) => p.status === "loaded") : report.plugins;
-		if (opts.json) {
-			const payload = {
-				workspaceDir: report.workspaceDir,
-				plugins: list,
-				diagnostics: report.diagnostics
-			};
-			defaultRuntime.log(JSON.stringify(payload, null, 2));
-			return;
-		}
-		if (list.length === 0) {
-			defaultRuntime.log(theme.muted("No plugins found."));
-			return;
-		}
-		const loaded = list.filter((p) => p.status === "loaded").length;
-		defaultRuntime.log(`${theme.heading("Plugins")} ${theme.muted(`(${loaded}/${list.length} loaded)`)}`);
-		if (!opts.verbose) {
-			const tableWidth = Math.max(60, (process.stdout.columns ?? 120) - 1);
-			const sourceRoots = resolvePluginSourceRoots({ workspaceDir: report.workspaceDir });
-			const usedRoots = /* @__PURE__ */ new Set();
-			const rows = list.map((plugin) => {
-				const desc = plugin.description ? theme.muted(plugin.description) : "";
-				const formattedSource = formatPluginSourceForTable(plugin, sourceRoots);
-				if (formattedSource.rootKey) usedRoots.add(formattedSource.rootKey);
-				const sourceLine = desc ? `${formattedSource.value}\n${desc}` : formattedSource.value;
-				return {
-					Name: plugin.name || plugin.id,
-					ID: plugin.name && plugin.name !== plugin.id ? plugin.id : "",
-					Status: plugin.status === "loaded" ? theme.success("loaded") : plugin.status === "disabled" ? theme.warn("disabled") : theme.error("error"),
-					Source: sourceLine,
-					Version: plugin.version ?? ""
-				};
-			});
-			if (usedRoots.size > 0) {
-				defaultRuntime.log(theme.muted("Source roots:"));
-				for (const key of [
-					"stock",
-					"workspace",
-					"global"
-				]) {
-					if (!usedRoots.has(key)) continue;
-					const dir = sourceRoots[key];
-					if (!dir) continue;
-					defaultRuntime.log(`  ${theme.command(`${key}:`)} ${theme.muted(dir)}`);
-				}
-				defaultRuntime.log("");
-			}
-			defaultRuntime.log(renderTable({
-				width: tableWidth,
-				columns: [
-					{
-						key: "Name",
-						header: "Name",
-						minWidth: 14,
-						flex: true
-					},
-					{
-						key: "ID",
-						header: "ID",
-						minWidth: 10,
-						flex: true
-					},
-					{
-						key: "Status",
-						header: "Status",
-						minWidth: 10
-					},
-					{
-						key: "Source",
-						header: "Source",
-						minWidth: 26,
-						flex: true
-					},
-					{
-						key: "Version",
-						header: "Version",
-						minWidth: 8
-					}
-				],
-				rows
-			}).trimEnd());
-			return;
-		}
-		const lines = [];
-		for (const plugin of list) {
-			lines.push(formatPluginLine(plugin, true));
-			lines.push("");
-		}
-		defaultRuntime.log(lines.join("\n").trim());
-	});
-	plugins.command("info").description("Show plugin details").argument("<id>", "Plugin id").option("--json", "Print JSON").action((id, opts) => {
-		const plugin = buildPluginStatusReport().plugins.find((p) => p.id === id || p.name === id);
-		if (!plugin) {
-			defaultRuntime.error(`Plugin not found: ${id}`);
-			process.exit(1);
-		}
-		const install = loadConfig().plugins?.installs?.[plugin.id];
-		if (opts.json) {
-			defaultRuntime.log(JSON.stringify(plugin, null, 2));
-			return;
-		}
-		const lines = [];
-		lines.push(theme.heading(plugin.name || plugin.id));
-		if (plugin.name && plugin.name !== plugin.id) lines.push(theme.muted(`id: ${plugin.id}`));
-		if (plugin.description) lines.push(plugin.description);
-		lines.push("");
-		lines.push(`${theme.muted("Status:")} ${plugin.status}`);
-		lines.push(`${theme.muted("Source:")} ${shortenHomeInString(plugin.source)}`);
-		lines.push(`${theme.muted("Origin:")} ${plugin.origin}`);
-		if (plugin.version) lines.push(`${theme.muted("Version:")} ${plugin.version}`);
-		if (plugin.toolNames.length > 0) lines.push(`${theme.muted("Tools:")} ${plugin.toolNames.join(", ")}`);
-		if (plugin.hookNames.length > 0) lines.push(`${theme.muted("Hooks:")} ${plugin.hookNames.join(", ")}`);
-		if (plugin.gatewayMethods.length > 0) lines.push(`${theme.muted("Gateway methods:")} ${plugin.gatewayMethods.join(", ")}`);
-		if (plugin.providerIds.length > 0) lines.push(`${theme.muted("Providers:")} ${plugin.providerIds.join(", ")}`);
-		if (plugin.cliCommands.length > 0) lines.push(`${theme.muted("CLI commands:")} ${plugin.cliCommands.join(", ")}`);
-		if (plugin.services.length > 0) lines.push(`${theme.muted("Services:")} ${plugin.services.join(", ")}`);
-		if (plugin.error) lines.push(`${theme.error("Error:")} ${plugin.error}`);
-		if (install) {
-			lines.push("");
-			lines.push(`${theme.muted("Install:")} ${install.source}`);
-			if (install.spec) lines.push(`${theme.muted("Spec:")} ${install.spec}`);
-			if (install.sourcePath) lines.push(`${theme.muted("Source path:")} ${shortenHomePath(install.sourcePath)}`);
-			if (install.installPath) lines.push(`${theme.muted("Install path:")} ${shortenHomePath(install.installPath)}`);
-			if (install.version) lines.push(`${theme.muted("Recorded version:")} ${install.version}`);
-			if (install.installedAt) lines.push(`${theme.muted("Installed at:")} ${install.installedAt}`);
-		}
-		defaultRuntime.log(lines.join("\n"));
-	});
-	plugins.command("enable").description("Enable a plugin in config").argument("<id>", "Plugin id").action(async (id) => {
-		const cfg = loadConfig();
-		let next = {
-			...cfg,
-			plugins: {
-				...cfg.plugins,
-				entries: {
-					...cfg.plugins?.entries,
-					[id]: {
-						...(cfg.plugins?.entries)?.[id],
-						enabled: true
-					}
-				}
-			}
-		};
-		const slotResult = applySlotSelectionForPlugin(next, id);
-		next = slotResult.config;
-		await writeConfigFile(next);
-		logSlotWarnings(slotResult.warnings);
-		defaultRuntime.log(`Enabled plugin "${id}". Restart the gateway to apply.`);
-	});
-	plugins.command("disable").description("Disable a plugin in config").argument("<id>", "Plugin id").action(async (id) => {
-		const cfg = loadConfig();
-		await writeConfigFile({
-			...cfg,
-			plugins: {
-				...cfg.plugins,
-				entries: {
-					...cfg.plugins?.entries,
-					[id]: {
-						...(cfg.plugins?.entries)?.[id],
-						enabled: false
-					}
-				}
-			}
-		});
-		defaultRuntime.log(`Disabled plugin "${id}". Restart the gateway to apply.`);
-	});
-	plugins.command("uninstall").description("Uninstall a plugin").argument("<id>", "Plugin id").option("--keep-files", "Keep installed files on disk", false).option("--keep-config", "Deprecated alias for --keep-files", false).option("--force", "Skip confirmation prompt", false).option("--dry-run", "Show what would be removed without making changes", false).action(async (id, opts) => {
-		const cfg = loadConfig();
-		const report = buildPluginStatusReport({ config: cfg });
-		const extensionsDir = path.join(resolveStateDir(process.env, os.homedir), "extensions");
-		const keepFiles = Boolean(opts.keepFiles || opts.keepConfig);
-		if (opts.keepConfig) defaultRuntime.log(theme.warn("`--keep-config` is deprecated, use `--keep-files`."));
-		const plugin = report.plugins.find((p) => p.id === id || p.name === id);
-		const pluginId = plugin?.id ?? id;
-		const hasEntry = pluginId in (cfg.plugins?.entries ?? {});
-		const hasInstall = pluginId in (cfg.plugins?.installs ?? {});
-		if (!hasEntry && !hasInstall) {
-			if (plugin) defaultRuntime.error(`Plugin "${pluginId}" is not managed by plugins config/install records and cannot be uninstalled.`);
-			else defaultRuntime.error(`Plugin not found: ${id}`);
-			process.exit(1);
-		}
-		const install = cfg.plugins?.installs?.[pluginId];
-		const isLinked = install?.source === "path";
-		const preview = [];
-		if (hasEntry) preview.push("config entry");
-		if (hasInstall) preview.push("install record");
-		if (cfg.plugins?.allow?.includes(pluginId)) preview.push("allowlist entry");
-		if (isLinked && install?.sourcePath && cfg.plugins?.load?.paths?.includes(install.sourcePath)) preview.push("load path");
-		if (cfg.plugins?.slots?.memory === pluginId) preview.push(`memory slot (will reset to "memory-core")`);
-		const deleteTarget = !keepFiles ? resolveUninstallDirectoryTarget({
-			pluginId,
-			hasInstall,
-			installRecord: install,
-			extensionsDir
-		}) : null;
-		if (deleteTarget) preview.push(`directory: ${shortenHomePath(deleteTarget)}`);
-		const pluginName = plugin?.name || pluginId;
-		defaultRuntime.log(`Plugin: ${theme.command(pluginName)}${pluginName !== pluginId ? theme.muted(` (${pluginId})`) : ""}`);
-		defaultRuntime.log(`Will remove: ${preview.length > 0 ? preview.join(", ") : "(nothing)"}`);
-		if (opts.dryRun) {
-			defaultRuntime.log(theme.muted("Dry run, no changes made."));
-			return;
-		}
-		if (!opts.force) {
-			if (!await promptYesNo(`Uninstall plugin "${pluginId}"?`)) {
-				defaultRuntime.log("Cancelled.");
-				return;
-			}
-		}
-		const result = await uninstallPlugin({
-			config: cfg,
-			pluginId,
-			deleteFiles: !keepFiles,
-			extensionsDir
-		});
-		if (!result.ok) {
-			defaultRuntime.error(result.error);
-			process.exit(1);
-		}
-		for (const warning of result.warnings) defaultRuntime.log(theme.warn(warning));
-		await writeConfigFile(result.config);
-		const removed = [];
-		if (result.actions.entry) removed.push("config entry");
-		if (result.actions.install) removed.push("install record");
-		if (result.actions.allowlist) removed.push("allowlist");
-		if (result.actions.loadPath) removed.push("load path");
-		if (result.actions.memorySlot) removed.push("memory slot");
-		if (result.actions.directory) removed.push("directory");
-		defaultRuntime.log(`Uninstalled plugin "${pluginId}". Removed: ${removed.length > 0 ? removed.join(", ") : "nothing"}.`);
-		defaultRuntime.log("Restart the gateway to apply changes.");
-	});
-	plugins.command("install").description("Install a plugin (path, archive, or npm spec)").argument("<path-or-spec>", "Path (.ts/.js/.zip/.tgz/.tar.gz) or an npm package spec").option("-l, --link", "Link a local path instead of copying", false).action(async (raw, opts) => {
-		const fileSpec = resolveFileNpmSpecToLocalPath(raw);
-		if (fileSpec && !fileSpec.ok) {
-			defaultRuntime.error(fileSpec.error);
-			process.exit(1);
-		}
-		const resolved = resolveUserPath(fileSpec && fileSpec.ok ? fileSpec.path : raw);
-		const cfg = loadConfig();
-		if (fs.existsSync(resolved)) {
-			if (opts.link) {
-				const existing = cfg.plugins?.load?.paths ?? [];
-				const merged = Array.from(new Set([...existing, resolved]));
-				const probe = await installPluginFromPath({
-					path: resolved,
-					dryRun: true
-				});
-				if (!probe.ok) {
-					defaultRuntime.error(probe.error);
-					process.exit(1);
-				}
-				let next = enablePluginInConfig({
-					...cfg,
-					plugins: {
-						...cfg.plugins,
-						load: {
-							...cfg.plugins?.load,
-							paths: merged
-						}
-					}
-				}, probe.pluginId);
-				next = recordPluginInstall(next, {
-					pluginId: probe.pluginId,
-					source: "path",
-					sourcePath: resolved,
-					installPath: resolved,
-					version: probe.version
-				});
-				const slotResult = applySlotSelectionForPlugin(next, probe.pluginId);
-				next = slotResult.config;
-				await writeConfigFile(next);
-				logSlotWarnings(slotResult.warnings);
-				defaultRuntime.log(`Linked plugin path: ${shortenHomePath(resolved)}`);
-				defaultRuntime.log(`Restart the gateway to load plugins.`);
-				return;
-			}
-			const result = await installPluginFromPath({
-				path: resolved,
-				logger: createPluginInstallLogger()
-			});
-			if (!result.ok) {
-				defaultRuntime.error(result.error);
-				process.exit(1);
-			}
-			let next = enablePluginInConfig(cfg, result.pluginId);
-			const source = resolveArchiveKind(resolved) ? "archive" : "path";
-			next = recordPluginInstall(next, {
-				pluginId: result.pluginId,
-				source,
-				sourcePath: resolved,
-				installPath: result.targetDir,
-				version: result.version
-			});
-			const slotResult = applySlotSelectionForPlugin(next, result.pluginId);
-			next = slotResult.config;
-			await writeConfigFile(next);
-			logSlotWarnings(slotResult.warnings);
-			defaultRuntime.log(`Installed plugin: ${result.pluginId}`);
-			defaultRuntime.log(`Restart the gateway to load plugins.`);
-			return;
-		}
-		if (opts.link) {
-			defaultRuntime.error("`--link` requires a local path.");
-			process.exit(1);
-		}
-		if (raw.startsWith(".") || raw.startsWith("~") || path.isAbsolute(raw) || raw.endsWith(".ts") || raw.endsWith(".js") || raw.endsWith(".mjs") || raw.endsWith(".cjs") || raw.endsWith(".tgz") || raw.endsWith(".tar.gz") || raw.endsWith(".tar") || raw.endsWith(".zip")) {
-			defaultRuntime.error(`Path not found: ${resolved}`);
-			process.exit(1);
-		}
-		const result = await installPluginFromNpmSpec({
-			spec: raw,
-			logger: createPluginInstallLogger()
-		});
-		if (!result.ok) {
-			defaultRuntime.error(result.error);
-			process.exit(1);
-		}
-		let next = enablePluginInConfig(cfg, result.pluginId);
-		next = recordPluginInstall(next, {
-			pluginId: result.pluginId,
-			source: "npm",
-			spec: raw,
-			installPath: result.targetDir,
-			version: result.version
-		});
-		const slotResult = applySlotSelectionForPlugin(next, result.pluginId);
-		next = slotResult.config;
-		await writeConfigFile(next);
-		logSlotWarnings(slotResult.warnings);
-		defaultRuntime.log(`Installed plugin: ${result.pluginId}`);
-		defaultRuntime.log(`Restart the gateway to load plugins.`);
-	});
-	plugins.command("update").description("Update installed plugins (npm installs only)").argument("[id]", "Plugin id (omit with --all)").option("--all", "Update all tracked plugins", false).option("--dry-run", "Show what would change without writing", false).action(async (id, opts) => {
-		const cfg = loadConfig();
-		const installs = cfg.plugins?.installs ?? {};
-		const targets = opts.all ? Object.keys(installs) : id ? [id] : [];
-		if (targets.length === 0) {
-			if (opts.all) {
-				defaultRuntime.log("No npm-installed plugins to update.");
-				return;
-			}
-			defaultRuntime.error("Provide a plugin id or use --all.");
-			process.exit(1);
-		}
-		const result = await updateNpmInstalledPlugins({
-			config: cfg,
-			pluginIds: targets,
-			dryRun: opts.dryRun,
-			logger: {
-				info: (msg) => defaultRuntime.log(msg),
-				warn: (msg) => defaultRuntime.log(theme.warn(msg))
-			}
-		});
-		for (const outcome of result.outcomes) {
-			if (outcome.status === "error") {
-				defaultRuntime.log(theme.error(outcome.message));
-				continue;
-			}
-			if (outcome.status === "skipped") {
-				defaultRuntime.log(theme.warn(outcome.message));
-				continue;
-			}
-			defaultRuntime.log(outcome.message);
-		}
-		if (!opts.dryRun && result.changed) {
-			await writeConfigFile(result.config);
-			defaultRuntime.log("Restart the gateway to load plugins.");
-		}
-	});
-	plugins.command("doctor").description("Report plugin load issues").action(() => {
-		const report = buildPluginStatusReport();
-		const errors = report.plugins.filter((p) => p.status === "error");
-		const diags = report.diagnostics.filter((d) => d.level === "error");
-		if (errors.length === 0 && diags.length === 0) {
-			defaultRuntime.log("No plugin issues detected.");
-			return;
-		}
-		const lines = [];
-		if (errors.length > 0) {
-			lines.push(theme.error("Plugin errors:"));
-			for (const entry of errors) lines.push(`- ${entry.id}: ${entry.error ?? "failed to load"} (${entry.source})`);
-		}
-		if (diags.length > 0) {
-			if (lines.length > 0) lines.push("");
-			lines.push(theme.warn("Diagnostics:"));
-			for (const diag of diags) {
-				const target = diag.pluginId ? `${diag.pluginId}: ` : "";
-				lines.push(`- ${target}${diag.message}`);
-			}
-		}
-		const docs = formatDocsLink("/plugin", "docs.openclaw.ai/plugin");
-		lines.push("");
-		lines.push(`${theme.muted("Docs:")} ${docs}`);
-		defaultRuntime.log(lines.join("\n"));
-	});
-}
-
-//#endregion
-export { registerPluginsCli };