import fs from "node:fs"; import path from "node:path"; import chalk from "chalk"; import type { Command } from "commander"; import { loadConfig, writeConfigFile } from "../config/config.js"; import { installPluginFromArchive, installPluginFromNpmSpec } from "../plugins/install.js"; import type { PluginRecord } from "../plugins/registry.js"; import { buildPluginStatusReport } from "../plugins/status.js"; import { defaultRuntime } from "../runtime.js"; import { formatDocsLink } from "../terminal/links.js"; import { theme } from "../terminal/theme.js"; import { resolveUserPath } from "../utils.js"; export type PluginsListOptions = { json?: boolean; enabled?: boolean; verbose?: boolean; }; export type PluginInfoOptions = { json?: boolean; }; function formatPluginLine(plugin: PluginRecord, verbose = false): string { const status = plugin.status === "loaded" ? chalk.green("✓") : plugin.status === "disabled" ? chalk.yellow("disabled") : chalk.red("error"); const name = plugin.name ? chalk.white(plugin.name) : chalk.white(plugin.id); const idSuffix = plugin.name !== plugin.id ? chalk.gray(` (${plugin.id})`) : ""; const desc = plugin.description ? chalk.gray( plugin.description.length > 60 ? `${plugin.description.slice(0, 57)}...` : plugin.description, ) : chalk.gray("(no description)"); if (!verbose) { return `${name}${idSuffix} ${status} - ${desc}`; } const parts = [ `${name}${idSuffix} ${status}`, ` source: ${chalk.gray(plugin.source)}`, ` origin: ${plugin.origin}`, ]; if (plugin.version) parts.push(` version: ${plugin.version}`); if (plugin.error) parts.push(chalk.red(` error: ${plugin.error}`)); return parts.join("\n"); } export function registerPluginsCli(program: Command) { const plugins = program.command("plugins").description("Manage Clawdbot plugins/extensions"); 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: PluginsListOptions) => { 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("No plugins found."); return; } const lines: string[] = []; const loaded = list.filter((p) => p.status === "loaded").length; lines.push( `${chalk.bold.cyan("Plugins")} ${chalk.gray(`(${loaded}/${list.length} loaded)`)}`, ); lines.push(""); for (const plugin of list) { lines.push(formatPluginLine(plugin, opts.verbose)); if (opts.verbose) lines.push(""); } defaultRuntime.log(lines.join("\n").trim()); }); plugins .command("info") .description("Show plugin details") .argument("", "Plugin id") .option("--json", "Print JSON") .action((id: string, opts: PluginInfoOptions) => { const report = buildPluginStatusReport(); const plugin = report.plugins.find((p) => p.id === id || p.name === id); if (!plugin) { defaultRuntime.error(`Plugin not found: ${id}`); process.exit(1); } if (opts.json) { defaultRuntime.log(JSON.stringify(plugin, null, 2)); return; } const lines: string[] = []; lines.push(chalk.bold.cyan(plugin.name || plugin.id)); if (plugin.name && plugin.name !== plugin.id) { lines.push(chalk.gray(`id: ${plugin.id}`)); } if (plugin.description) lines.push(plugin.description); lines.push(""); lines.push(`Status: ${plugin.status}`); lines.push(`Source: ${plugin.source}`); lines.push(`Origin: ${plugin.origin}`); if (plugin.version) lines.push(`Version: ${plugin.version}`); if (plugin.toolNames.length > 0) { lines.push(`Tools: ${plugin.toolNames.join(", ")}`); } if (plugin.gatewayMethods.length > 0) { lines.push(`Gateway methods: ${plugin.gatewayMethods.join(", ")}`); } if (plugin.cliCommands.length > 0) { lines.push(`CLI commands: ${plugin.cliCommands.join(", ")}`); } if (plugin.services.length > 0) { lines.push(`Services: ${plugin.services.join(", ")}`); } if (plugin.error) lines.push(chalk.red(`Error: ${plugin.error}`)); defaultRuntime.log(lines.join("\n")); }); plugins .command("enable") .description("Enable a plugin in config") .argument("", "Plugin id") .action(async (id: string) => { const cfg = loadConfig(); const next = { ...cfg, plugins: { ...cfg.plugins, entries: { ...cfg.plugins?.entries, [id]: { ...(cfg.plugins?.entries as Record | undefined)?.[id], enabled: true, }, }, }, }; await writeConfigFile(next); defaultRuntime.log(`Enabled plugin "${id}". Restart the gateway to apply.`); }); plugins .command("disable") .description("Disable a plugin in config") .argument("", "Plugin id") .action(async (id: string) => { const cfg = loadConfig(); const next = { ...cfg, plugins: { ...cfg.plugins, entries: { ...cfg.plugins?.entries, [id]: { ...(cfg.plugins?.entries as Record | undefined)?.[id], enabled: false, }, }, }, }; await writeConfigFile(next); defaultRuntime.log(`Disabled plugin "${id}". Restart the gateway to apply.`); }); plugins .command("install") .description("Install a plugin (path, archive, or npm spec)") .argument("", "Path (.ts/.js/.tgz) or an npm package spec") .action(async (raw: string) => { const resolved = resolveUserPath(raw); const cfg = loadConfig(); if (fs.existsSync(resolved)) { const ext = path.extname(resolved).toLowerCase(); if (ext === ".tgz" || resolved.endsWith(".tar.gz")) { const result = await installPluginFromArchive({ archivePath: resolved, logger: { info: (msg) => defaultRuntime.log(msg), warn: (msg) => defaultRuntime.log(chalk.yellow(msg)), }, }); if (!result.ok) { defaultRuntime.error(result.error); process.exit(1); } const next = { ...cfg, plugins: { ...cfg.plugins, entries: { ...cfg.plugins?.entries, [result.pluginId]: { ...(cfg.plugins?.entries?.[result.pluginId] as object | undefined), enabled: true, }, }, }, }; await writeConfigFile(next); defaultRuntime.log(`Installed plugin: ${result.pluginId}`); defaultRuntime.log(`Restart the gateway to load plugins.`); return; } const existing = cfg.plugins?.load?.paths ?? []; const merged = Array.from(new Set([...existing, resolved])); const next = { ...cfg, plugins: { ...cfg.plugins, load: { ...cfg.plugins?.load, paths: merged, }, }, }; await writeConfigFile(next); defaultRuntime.log(`Added plugin path: ${resolved}`); defaultRuntime.log(`Restart the gateway to load plugins.`); return; } const looksLikePath = 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"); if (looksLikePath) { defaultRuntime.error(`Path not found: ${resolved}`); process.exit(1); } const result = await installPluginFromNpmSpec({ spec: raw, logger: { info: (msg) => defaultRuntime.log(msg), warn: (msg) => defaultRuntime.log(chalk.yellow(msg)), }, }); if (!result.ok) { defaultRuntime.error(result.error); process.exit(1); } const next = { ...cfg, plugins: { ...cfg.plugins, entries: { ...cfg.plugins?.entries, [result.pluginId]: { ...(cfg.plugins?.entries?.[result.pluginId] as object | undefined), enabled: true, }, }, }, }; await writeConfigFile(next); defaultRuntime.log(`Installed plugin: ${result.pluginId}`); 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: string[] = []; if (errors.length > 0) { lines.push(chalk.bold.red("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(chalk.bold.yellow("Diagnostics:")); for (const diag of diags) { const target = diag.pluginId ? `${diag.pluginId}: ` : ""; lines.push(`- ${target}${diag.message}`); } } const docs = formatDocsLink("/plugin", "docs.clawd.bot/plugin"); lines.push(""); lines.push(`${theme.muted("Docs:")} ${docs}`); defaultRuntime.log(lines.join("\n")); }); }