nextclaw 0.4.8 → 0.4.10

package/dist/cli/index.js

@@ -2,7 +2,7 @@
 
 // src/cli/index.ts
 import { Command } from "commander";
-import { APP_NAME as APP_NAME2, APP_TAGLINE } from "nextclaw-core";
+import { APP_NAME as APP_NAME2, APP_TAGLINE } from "@nextclaw/core";
 
 // src/cli/runtime.ts
 import {
@@ -30,8 +30,21 @@ import {
   APP_NAME,
   DEFAULT_WORKSPACE_DIR,
   DEFAULT_WORKSPACE_PATH
-} from "nextclaw-core";
-import { startUiServer } from "nextclaw-server";
+} from "@nextclaw/core";
+import {
+  loadOpenClawPlugins,
+  buildPluginStatusReport,
+  enablePluginInConfig,
+  disablePluginInConfig,
+  addPluginLoadPath,
+  recordPluginInstall,
+  installPluginFromPath,
+  installPluginFromNpmSpec,
+  uninstallPlugin,
+  resolveUninstallDirectoryTarget,
+  loadPluginUiMetadata
+} from "@nextclaw/openclaw-compat";
+import { startUiServer } from "@nextclaw/server";
 import {
   closeSync,
   cpSync,
@@ -57,7 +70,7 @@ import {
   buildConfigSchema,
   ConfigSchema,
   redactConfigObject
-} from "nextclaw-core";
+} from "@nextclaw/core";
 
 // src/cli/utils.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from "fs";
@@ -65,7 +78,7 @@ import { join, resolve } from "path";
 import { spawn } from "child_process";
 import { createServer } from "net";
 import { fileURLToPath } from "url";
-import { getDataDir, getPackageVersion } from "nextclaw-core";
+import { getDataDir, getPackageVersion } from "@nextclaw/core";
 function resolveUiConfig(config, overrides) {
   const base = config.ui ?? { enabled: false, host: "127.0.0.1", port: 18791, open: false };
   return { ...base, ...overrides ?? {} };
@@ -331,7 +344,7 @@ function runSelfUpdate(options = {}) {
 
 // src/cli/gateway/controller.ts
 var hashRaw = (raw) => createHash("sha256").update(raw).digest("hex");
-var readConfigSnapshot = (getConfigPath2) => {
+var readConfigSnapshot = (getConfigPath2, plugins2) => {
   const path = getConfigPath2();
   let raw = "";
   let parsed = {};
@@ -355,12 +368,12 @@ var readConfigSnapshot = (getConfigPath2) => {
     raw = JSON.stringify(config, null, 2);
   }
   const hash = hashRaw(raw);
-  const schema = buildConfigSchema({ version: getPackageVersion() });
+  const schema = buildConfigSchema({ version: getPackageVersion(), plugins: plugins2 });
   const redacted = redactConfigObject(config, schema.uiHints);
   return { raw: valid ? JSON.stringify(redacted, null, 2) : null, hash: valid ? hash : null, config, redacted, valid };
 };
-var redactValue = (value) => {
-  const schema = buildConfigSchema({ version: getPackageVersion() });
+var redactValue = (value, plugins2) => {
+  const schema = buildConfigSchema({ version: getPackageVersion(), plugins: plugins2 });
   return redactConfigObject(value, schema.uiHints);
 };
 var mergeDeep = (base, patch) => {
@@ -405,7 +418,8 @@ var GatewayControllerImpl = class {
     return "Restart scheduled";
   }
   async getConfig() {
-    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    const plugins2 = this.deps.getPluginUiMetadata?.() ?? [];
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath, plugins2);
     return {
       raw: snapshot.raw,
       hash: snapshot.hash,
@@ -417,10 +431,11 @@ var GatewayControllerImpl = class {
     };
   }
   async getConfigSchema() {
-    return buildConfigSchema({ version: getPackageVersion() });
+    return buildConfigSchema({ version: getPackageVersion(), plugins: this.deps.getPluginUiMetadata?.() ?? [] });
   }
   async applyConfig(params) {
-    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    const plugins2 = this.deps.getPluginUiMetadata?.() ?? [];
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath, plugins2);
     if (!params.baseHash) {
       return { ok: false, error: "config base hash required; re-run config.get and retry" };
     }
@@ -449,12 +464,13 @@ var GatewayControllerImpl = class {
       ok: true,
       note: params.note ?? null,
       path: this.deps.getConfigPath(),
-      config: redactValue(validated),
+      config: redactValue(validated, plugins2),
       restart: { scheduled: true, delayMs }
     };
   }
   async patchConfig(params) {
-    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    const plugins2 = this.deps.getPluginUiMetadata?.() ?? [];
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath, plugins2);
     if (!params.baseHash) {
       return { ok: false, error: "config base hash required; re-run config.get and retry" };
     }
@@ -484,7 +500,7 @@ var GatewayControllerImpl = class {
       ok: true,
       note: params.note ?? null,
       path: this.deps.getConfigPath(),
-      config: redactValue(validated),
+      config: redactValue(validated, plugins2),
       restart: { scheduled: true, delayMs }
     };
   }
@@ -653,7 +669,12 @@ var ConfigReloader = class {
     }
     this.reloadTask = (async () => {
       await this.channels.stopAll();
-      this.channels = new ChannelManager(nextConfig, this.options.bus, this.options.sessionManager);
+      this.channels = new ChannelManager(
+        nextConfig,
+        this.options.bus,
+        this.options.sessionManager,
+        this.options.getExtensionChannels?.() ?? []
+      );
       await this.channels.startAll();
     })();
     try {
@@ -851,17 +872,23 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
   }
   async agent(opts) {
     const config = loadConfig();
+    const workspace = getWorkspacePath(config.agents.defaults.workspace);
+    const pluginRegistry = this.loadPluginRegistry(config, workspace);
+    const extensionRegistry = this.toExtensionRegistry(pluginRegistry);
+    this.logPluginDiagnostics(pluginRegistry);
     const bus = new MessageBus();
     const provider = this.makeProvider(config);
     const providerManager = new ProviderManager(provider);
     const agentLoop = new AgentLoop({
       bus,
       providerManager,
-      workspace: getWorkspacePath(config.agents.defaults.workspace),
+      workspace,
       braveApiKey: config.tools.web.search.apiKey || void 0,
       execConfig: config.tools.exec,
       restrictToWorkspace: config.tools.restrictToWorkspace,
-      contextConfig: config.agents.context
+      contextConfig: config.agents.context,
+      config,
+      extensionRegistry
     });
     if (opts.message) {
       const response = await agentLoop.processDirect({
@@ -939,6 +966,356 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       console.log(`Tip: restart ${APP_NAME} to apply the update.`);
     }
   }
+  pluginsList(opts = {}) {
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const list = opts.enabled ? report.plugins.filter((plugin) => plugin.status === "loaded") : report.plugins;
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            workspaceDir,
+            plugins: list,
+            diagnostics: report.diagnostics
+          },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    if (list.length === 0) {
+      console.log("No plugins discovered.");
+      return;
+    }
+    for (const plugin of list) {
+      const status = plugin.status === "loaded" ? "loaded" : plugin.status === "disabled" ? "disabled" : "error";
+      const title = plugin.name && plugin.name !== plugin.id ? `${plugin.name} (${plugin.id})` : plugin.id;
+      if (!opts.verbose) {
+        const desc = plugin.description ? plugin.description.length > 80 ? `${plugin.description.slice(0, 77)}...` : plugin.description : "(no description)";
+        console.log(`${title} ${status} - ${desc}`);
+        continue;
+      }
+      console.log(`${title} ${status}`);
+      console.log(`  source: ${plugin.source}`);
+      console.log(`  origin: ${plugin.origin}`);
+      if (plugin.version) {
+        console.log(`  version: ${plugin.version}`);
+      }
+      if (plugin.toolNames.length > 0) {
+        console.log(`  tools: ${plugin.toolNames.join(", ")}`);
+      }
+      if (plugin.channelIds.length > 0) {
+        console.log(`  channels: ${plugin.channelIds.join(", ")}`);
+      }
+      if (plugin.providerIds.length > 0) {
+        console.log(`  providers: ${plugin.providerIds.join(", ")}`);
+      }
+      if (plugin.error) {
+        console.log(`  error: ${plugin.error}`);
+      }
+      console.log("");
+    }
+  }
+  pluginsInfo(id, opts = {}) {
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const plugin = report.plugins.find((entry) => entry.id === id || entry.name === id);
+    if (!plugin) {
+      console.error(`Plugin not found: ${id}`);
+      process.exit(1);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(plugin, null, 2));
+      return;
+    }
+    const install = config.plugins.installs?.[plugin.id];
+    const lines = [];
+    lines.push(plugin.name || plugin.id);
+    if (plugin.name && plugin.name !== plugin.id) {
+      lines.push(`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.channelIds.length > 0) {
+      lines.push(`Channels: ${plugin.channelIds.join(", ")}`);
+    }
+    if (plugin.providerIds.length > 0) {
+      lines.push(`Providers: ${plugin.providerIds.join(", ")}`);
+    }
+    if (plugin.error) {
+      lines.push(`Error: ${plugin.error}`);
+    }
+    if (install) {
+      lines.push("");
+      lines.push(`Install: ${install.source}`);
+      if (install.spec) {
+        lines.push(`Spec: ${install.spec}`);
+      }
+      if (install.sourcePath) {
+        lines.push(`Source path: ${install.sourcePath}`);
+      }
+      if (install.installPath) {
+        lines.push(`Install path: ${install.installPath}`);
+      }
+      if (install.version) {
+        lines.push(`Recorded version: ${install.version}`);
+      }
+      if (install.installedAt) {
+        lines.push(`Installed at: ${install.installedAt}`);
+      }
+    }
+    console.log(lines.join("\n"));
+  }
+  pluginsEnable(id) {
+    const config = loadConfig();
+    const next = enablePluginInConfig(config, id);
+    saveConfig(next);
+    console.log(`Enabled plugin "${id}". Restart the gateway to apply.`);
+  }
+  pluginsDisable(id) {
+    const config = loadConfig();
+    const next = disablePluginInConfig(config, id);
+    saveConfig(next);
+    console.log(`Disabled plugin "${id}". Restart the gateway to apply.`);
+  }
+  async pluginsUninstall(id, opts = {}) {
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const keepFiles = Boolean(opts.keepFiles || opts.keepConfig);
+    if (opts.keepConfig) {
+      console.log("`--keep-config` is deprecated, use `--keep-files`.");
+    }
+    const plugin = report.plugins.find((entry) => entry.id === id || entry.name === id);
+    const pluginId = plugin?.id ?? id;
+    const hasEntry = pluginId in (config.plugins.entries ?? {});
+    const hasInstall = pluginId in (config.plugins.installs ?? {});
+    if (!hasEntry && !hasInstall) {
+      if (plugin) {
+        console.error(
+          `Plugin "${pluginId}" is not managed by plugins config/install records and cannot be uninstalled.`
+        );
+      } else {
+        console.error(`Plugin not found: ${id}`);
+      }
+      process.exit(1);
+    }
+    const install = config.plugins.installs?.[pluginId];
+    const isLinked = install?.source === "path";
+    const preview = [];
+    if (hasEntry) {
+      preview.push("config entry");
+    }
+    if (hasInstall) {
+      preview.push("install record");
+    }
+    if (config.plugins.allow?.includes(pluginId)) {
+      preview.push("allowlist entry");
+    }
+    if (isLinked && install?.sourcePath && config.plugins.load?.paths?.includes(install.sourcePath)) {
+      preview.push("load path");
+    }
+    const deleteTarget = !keepFiles ? resolveUninstallDirectoryTarget({
+      pluginId,
+      hasInstall,
+      installRecord: install
+    }) : null;
+    if (deleteTarget) {
+      preview.push(`directory: ${deleteTarget}`);
+    }
+    const pluginName = plugin?.name || pluginId;
+    const pluginTitle = pluginName !== pluginId ? `${pluginName} (${pluginId})` : pluginName;
+    console.log(`Plugin: ${pluginTitle}`);
+    console.log(`Will remove: ${preview.length > 0 ? preview.join(", ") : "(nothing)"}`);
+    if (opts.dryRun) {
+      console.log("Dry run, no changes made.");
+      return;
+    }
+    if (!opts.force) {
+      const confirmed = await this.confirmYesNo(`Uninstall plugin "${pluginId}"?`);
+      if (!confirmed) {
+        console.log("Cancelled.");
+        return;
+      }
+    }
+    const result = await uninstallPlugin({
+      config,
+      pluginId,
+      deleteFiles: !keepFiles
+    });
+    if (!result.ok) {
+      console.error(result.error);
+      process.exit(1);
+    }
+    for (const warning of result.warnings) {
+      console.warn(warning);
+    }
+    saveConfig(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.directory) {
+      removed.push("directory");
+    }
+    console.log(`Uninstalled plugin "${pluginId}". Removed: ${removed.length > 0 ? removed.join(", ") : "nothing"}.`);
+    console.log("Restart the gateway to apply changes.");
+  }
+  async pluginsInstall(pathOrSpec, opts = {}) {
+    const fileSpec = this.resolveFileNpmSpecToLocalPath(pathOrSpec);
+    if (fileSpec && !fileSpec.ok) {
+      console.error(fileSpec.error);
+      process.exit(1);
+    }
+    const normalized = fileSpec && fileSpec.ok ? fileSpec.path : pathOrSpec;
+    const resolved = resolve4(expandHome(normalized));
+    const config = loadConfig();
+    if (existsSync4(resolved)) {
+      if (opts.link) {
+        const probe = await installPluginFromPath({ path: resolved, dryRun: true });
+        if (!probe.ok) {
+          console.error(probe.error);
+          process.exit(1);
+        }
+        let next3 = addPluginLoadPath(config, resolved);
+        next3 = enablePluginInConfig(next3, probe.pluginId);
+        next3 = recordPluginInstall(next3, {
+          pluginId: probe.pluginId,
+          source: "path",
+          sourcePath: resolved,
+          installPath: resolved,
+          version: probe.version
+        });
+        saveConfig(next3);
+        console.log(`Linked plugin path: ${resolved}`);
+        console.log("Restart the gateway to load plugins.");
+        return;
+      }
+      const result2 = await installPluginFromPath({
+        path: resolved,
+        logger: {
+          info: (message) => console.log(message),
+          warn: (message) => console.warn(message)
+        }
+      });
+      if (!result2.ok) {
+        console.error(result2.error);
+        process.exit(1);
+      }
+      let next2 = enablePluginInConfig(config, result2.pluginId);
+      next2 = recordPluginInstall(next2, {
+        pluginId: result2.pluginId,
+        source: this.isArchivePath(resolved) ? "archive" : "path",
+        sourcePath: resolved,
+        installPath: result2.targetDir,
+        version: result2.version
+      });
+      saveConfig(next2);
+      console.log(`Installed plugin: ${result2.pluginId}`);
+      console.log("Restart the gateway to load plugins.");
+      return;
+    }
+    if (opts.link) {
+      console.error("`--link` requires a local path.");
+      process.exit(1);
+    }
+    if (this.looksLikePath(pathOrSpec)) {
+      console.error(`Path not found: ${resolved}`);
+      process.exit(1);
+    }
+    const result = await installPluginFromNpmSpec({
+      spec: pathOrSpec,
+      logger: {
+        info: (message) => console.log(message),
+        warn: (message) => console.warn(message)
+      }
+    });
+    if (!result.ok) {
+      console.error(result.error);
+      process.exit(1);
+    }
+    let next = enablePluginInConfig(config, result.pluginId);
+    next = recordPluginInstall(next, {
+      pluginId: result.pluginId,
+      source: "npm",
+      spec: pathOrSpec,
+      installPath: result.targetDir,
+      version: result.version
+    });
+    saveConfig(next);
+    console.log(`Installed plugin: ${result.pluginId}`);
+    console.log("Restart the gateway to load plugins.");
+  }
+  pluginsDoctor() {
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const pluginErrors = report.plugins.filter((plugin) => plugin.status === "error");
+    const diagnostics = report.diagnostics.filter((diag) => diag.level === "error");
+    if (pluginErrors.length === 0 && diagnostics.length === 0) {
+      console.log("No plugin issues detected.");
+      return;
+    }
+    if (pluginErrors.length > 0) {
+      console.log("Plugin errors:");
+      for (const entry of pluginErrors) {
+        console.log(`- ${entry.id}: ${entry.error ?? "failed to load"} (${entry.source})`);
+      }
+    }
+    if (diagnostics.length > 0) {
+      if (pluginErrors.length > 0) {
+        console.log("");
+      }
+      console.log("Diagnostics:");
+      for (const diag of diagnostics) {
+        const prefix = diag.pluginId ? `${diag.pluginId}: ` : "";
+        console.log(`- ${prefix}${diag.message}`);
+      }
+    }
+  }
   async skillsInstall(options) {
     const workdir = options.workdir ? expandHome(options.workdir) : getWorkspacePath();
     const result = await installClawHubSkill({
@@ -1071,14 +1448,85 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       }
     }
   }
+  loadPluginRegistry(config, workspaceDir) {
+    return loadOpenClawPlugins({
+      config,
+      workspaceDir,
+      reservedToolNames: [
+        "read_file",
+        "write_file",
+        "edit_file",
+        "list_dir",
+        "exec",
+        "web_search",
+        "web_fetch",
+        "message",
+        "spawn",
+        "sessions_list",
+        "sessions_history",
+        "sessions_send",
+        "memory_search",
+        "memory_get",
+        "subagents",
+        "gateway",
+        "cron"
+      ],
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name),
+      logger: {
+        info: (message) => console.log(message),
+        warn: (message) => console.warn(message),
+        error: (message) => console.error(message),
+        debug: (message) => console.debug(message)
+      }
+    });
+  }
+  toExtensionRegistry(pluginRegistry) {
+    return {
+      tools: pluginRegistry.tools.map((tool) => ({
+        extensionId: tool.pluginId,
+        factory: tool.factory,
+        names: tool.names,
+        optional: tool.optional,
+        source: tool.source
+      })),
+      channels: pluginRegistry.channels.map((channel) => ({
+        extensionId: channel.pluginId,
+        channel: channel.channel,
+        source: channel.source
+      })),
+      diagnostics: pluginRegistry.diagnostics.map((diag) => ({
+        level: diag.level,
+        message: diag.message,
+        extensionId: diag.pluginId,
+        source: diag.source
+      }))
+    };
+  }
+  logPluginDiagnostics(registry) {
+    for (const diag of registry.diagnostics) {
+      const prefix = diag.pluginId ? `${diag.pluginId}: ` : "";
+      const text = `${prefix}${diag.message}`;
+      if (diag.level === "error") {
+        console.error(`[plugins] ${text}`);
+      } else {
+        console.warn(`[plugins] ${text}`);
+      }
+    }
+  }
   async startGateway(options = {}) {
     const config = loadConfig();
+    const workspace = getWorkspacePath(config.agents.defaults.workspace);
+    const pluginRegistry = this.loadPluginRegistry(config, workspace);
+    const extensionRegistry = this.toExtensionRegistry(pluginRegistry);
+    this.logPluginDiagnostics(pluginRegistry);
     const bus = new MessageBus();
     const provider = options.allowMissingProvider === true ? this.makeProvider(config, { allowMissing: true }) : this.makeProvider(config);
     const providerManager = provider ? new ProviderManager(provider) : null;
-    const sessionManager = new SessionManager(getWorkspacePath(config.agents.defaults.workspace));
+    const sessionManager = new SessionManager(workspace);
     const cronStorePath = join3(getDataDir2(), "cron", "jobs.json");
     const cron2 = new CronService(cronStorePath);
+    const pluginUiMetadata = loadPluginUiMetadata({ config, workspaceDir: workspace });
     const uiConfig = resolveUiConfig(config, options.uiOverrides);
     const uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir() : options.uiStaticDir;
     if (!provider) {
@@ -1088,7 +1536,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       });
       return;
     }
-    const channels2 = new ChannelManager(config, bus, sessionManager);
+    const channels2 = new ChannelManager(config, bus, sessionManager, extensionRegistry.channels);
     const reloader = new ConfigReloader({
       initialConfig: config,
       channels: channels2,
@@ -1097,6 +1545,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       providerManager,
       makeProvider: (nextConfig) => this.makeProvider(nextConfig, { allowMissing: true }),
       loadConfig,
+      getExtensionChannels: () => extensionRegistry.channels,
       onRestartRequired: (paths) => {
         console.warn(`Config changes require restart: ${paths.join(", ")}`);
       }
@@ -1105,12 +1554,13 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       reloader,
       cron: cron2,
       getConfigPath,
-      saveConfig
+      saveConfig,
+      getPluginUiMetadata: () => pluginUiMetadata
     });
     const agent = new AgentLoop({
       bus,
       providerManager: providerManager ?? new ProviderManager(provider),
-      workspace: getWorkspacePath(config.agents.defaults.workspace),
+      workspace,
       model: config.agents.defaults.model,
       maxIterations: config.agents.defaults.maxToolIterations,
       braveApiKey: config.tools.web.search.apiKey || void 0,
@@ -1119,7 +1569,9 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       restrictToWorkspace: config.tools.restrictToWorkspace,
       sessionManager,
       contextConfig: config.agents.context,
-      gatewayController
+      gatewayController,
+      config,
+      extensionRegistry
     });
     cron2.onJob = async (job) => {
       const response = await agent.processDirect({
@@ -1140,7 +1592,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       return response;
     };
     const heartbeat = new HeartbeatService(
-      getWorkspacePath(config.agents.defaults.workspace),
+      workspace,
       async (promptText) => agent.processDirect({ content: promptText, sessionKey: "heartbeat" }),
       30 * 60,
       true
@@ -1310,6 +1762,18 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     clearServiceState();
     console.log(`\u2713 ${APP_NAME} stopped`);
   }
+  async confirmYesNo(question) {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    const answer = await new Promise((resolve5) => {
+      rl.question(`${question} [y/N] `, (line) => resolve5(line));
+    });
+    rl.close();
+    const normalized = answer.trim().toLowerCase();
+    return normalized === "y" || normalized === "yes";
+  }
   makeProvider(config, options) {
     const provider = getProvider(config);
     const model = config.agents.defaults.model;
@@ -1330,6 +1794,36 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       wireApi: provider?.wireApi ?? null
     });
   }
+  resolveFileNpmSpecToLocalPath(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed.toLowerCase().startsWith("file:")) {
+      return null;
+    }
+    const rest = trimmed.slice("file:".length);
+    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("//localhost".length) };
+    }
+    if (rest.startsWith("//")) {
+      return {
+        ok: false,
+        error: 'unsupported file: URL host (expected "file:<path>" or "file:///abs/path")'
+      };
+    }
+    return { ok: true, path: rest };
+  }
+  looksLikePath(raw) {
+    return raw.startsWith(".") || raw.startsWith("~") || raw.startsWith("/") || 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");
+  }
+  isArchivePath(filePath) {
+    const lower = filePath.toLowerCase();
+    return lower.endsWith(".zip") || lower.endsWith(".tgz") || lower.endsWith(".tar.gz") || lower.endsWith(".tar");
+  }
   createWorkspaceTemplates(workspace, options = {}) {
     const created = [];
     const force = Boolean(options.force);
@@ -1413,7 +1907,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
   resolveBuiltinSkillsDir() {
     try {
       const require2 = createRequire(import.meta.url);
-      const entry = require2.resolve("nextclaw-core");
+      const entry = require2.resolve("@nextclaw/core");
       const pkgRoot = resolve4(dirname(entry), "..");
       const distSkills = join3(pkgRoot, "dist", "skills");
       if (existsSync4(distSkills)) {
@@ -1516,6 +2010,14 @@ var skills = program.command("skills").description("Manage skills");
 registerClawHubInstall(skills);
 var clawhub = program.command("clawhub").description("Install skills from ClawHub");
 registerClawHubInstall(clawhub);
+var plugins = program.command("plugins").description("Manage OpenClaw-compatible plugins");
+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) => runtime.pluginsList(opts));
+plugins.command("info <id>").description("Show plugin details").option("--json", "Print JSON").action((id, opts) => runtime.pluginsInfo(id, opts));
+plugins.command("enable <id>").description("Enable a plugin in config").action((id) => runtime.pluginsEnable(id));
+plugins.command("disable <id>").description("Disable a plugin in config").action((id) => runtime.pluginsDisable(id));
+plugins.command("uninstall <id>").description("Uninstall a plugin").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) => runtime.pluginsUninstall(id, opts));
+plugins.command("install <path-or-spec>").description("Install a plugin (path, archive, or npm spec)").option("-l, --link", "Link a local path instead of copying", false).action(async (pathOrSpec, opts) => runtime.pluginsInstall(pathOrSpec, opts));
+plugins.command("doctor").description("Report plugin load issues").action(() => runtime.pluginsDoctor());
 var channels = program.command("channels").description("Manage channels");
 channels.command("status").description("Show channel status").action(() => runtime.channelsStatus());
 channels.command("login").description("Link device via QR code").action(() => runtime.channelsLogin());