soulhubcli 1.0.13 → 1.0.15

package/dist/index.cjs

@@ -19078,7 +19078,14 @@ function findAllClawDirs(customDir) {
     import_node_path11.default.join(process.cwd(), ".openclaw"),
     import_node_path11.default.join(process.cwd(), ".lightclaw")
   ];
-  return candidates.filter((c) => import_node_fs8.default.existsSync(c));
+  const existing = candidates.filter((c) => import_node_fs8.default.existsSync(c));
+  const seen = /* @__PURE__ */ new Set();
+  return existing.filter((c) => {
+    const real = import_node_fs8.default.realpathSync(c);
+    if (seen.has(real)) return false;
+    seen.add(real);
+    return true;
+  });
 }
 async function promptSelectClawDir(customDir) {
   const dirs = findAllClawDirs(customDir);
@@ -19491,7 +19498,7 @@ function restartOpenClawGateway() {
 }
 
 // src/commands/search.ts
-var searchCommand = new Command("search").description("Search for agent templates in the SoulHub registry").argument("[query]", "Search query (matches name, description, tags)").option("-c, --category <category>", "Filter by category").option("-l, --limit <number>", "Max results to show", "20").action(async (query, options) => {
+var searchCommand = new Command("search").description("Search for agents in the SoulHub registry").argument("[query]", "Search query (matches name, description, tags)").option("-c, --category <category>", "Filter by category").option("-l, --limit <number>", "Max results to show", "20").action(async (query, options) => {
   try {
     const index = await fetchIndex();
     let agents = index.agents;
@@ -19557,7 +19564,7 @@ var searchCommand = new Command("search").description("Search for agent template
 });
 
 // src/commands/info.ts
-var infoCommand = new Command("info").description("View detailed information about an agent template").argument("<name>", "Agent name").option("--identity", "Show IDENTITY.md content").option("--soul", "Show SOUL.md content").action(async (name, options) => {
+var infoCommand = new Command("info").description("Show details of an agent (identity, soul, skills, etc.)").argument("<name>", "Agent name").option("--identity", "Show IDENTITY.md content").option("--soul", "Show SOUL.md content").action(async (name, options) => {
   try {
     const index = await fetchIndex();
     const agent = index.agents.find((a) => a.name === name);
@@ -19718,13 +19725,40 @@ function createSpinner(initialText = "") {
 // src/commands/install.ts
 var import_node_fs9 = __toESM(require("fs"), 1);
 var import_node_path12 = __toESM(require("path"), 1);
+var import_node_readline2 = __toESM(require("readline"), 1);
 async function resolveClawDir(clawDir) {
   if (clawDir) {
     return findOpenClawDir(clawDir);
   }
   return promptSelectClawDir();
 }
-var installCommand = new Command("install").description("Install an agent or team from the SoulHub registry").argument("[name]", "Agent or team name to install").option("--from <source>", "Install from a local directory, ZIP file, or URL").option(
+async function promptInstallRole(agentName) {
+  console.log();
+  console.log(`  How would you like to install ${source_default.cyan(agentName)}?`);
+  console.log();
+  console.log(`    1) ${source_default.blue("Main Agent")}    Install as main agent (workspace/)`);
+  console.log(`    2) ${source_default.green("Worker Agent")}  Install as worker agent (workspace-${agentName}/)`);
+  console.log();
+  const rl = import_node_readline2.default.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question("  Please select (1-2, default: 2): ", (answer) => {
+      rl.close();
+      const trimmed = answer.trim();
+      if (trimmed === "" || trimmed === "2") {
+        resolve(false);
+      } else if (trimmed === "1") {
+        resolve(true);
+      } else {
+        console.log("  Invalid selection, operation cancelled.");
+        resolve(null);
+      }
+    });
+  });
+}
+var installCommand = new Command("install").description("Install an agent or team from the SoulHub registry (default: as worker)").argument("[name]", "Agent or team name to install").option("--from <source>", "Install from a local directory, ZIP file, or URL").option("--main", "Install as main agent (non-interactive)").option("--worker", "Install as worker/sub-agent (non-interactive)").option(
   "--dir <path>",
   "Target directory (defaults to OpenClaw/LightClaw workspace)"
 ).option(
@@ -19732,16 +19766,26 @@ var installCommand = new Command("install").description("Install an agent or tea
   "OpenClaw/LightClaw installation directory (overrides OPENCLAW_HOME/LIGHTCLAW_HOME env var, defaults to ~/.openclaw or ~/.lightclaw)"
 ).action(async (name, options) => {
   try {
+    let asMain;
+    if (options.main && options.worker) {
+      console.error(source_default.red("Error: --main and --worker cannot be used together."));
+      process.exit(1);
+    }
+    if (options.main) asMain = true;
+    if (options.worker) asMain = false;
     if (options.from) {
-      await installFromSource(options.from, options.dir, options.clawDir);
+      await installFromSource(options.from, options.dir, options.clawDir, asMain);
     } else if (name) {
-      await installFromRegistry(name, options.dir, options.clawDir);
+      await installFromRegistry(name, options.dir, options.clawDir, asMain);
     } else {
       console.error(source_default.red("Please specify an agent or team name, or use --from to install from a local source."));
       console.log(source_default.dim("  Examples:"));
-      console.log(source_default.dim("    soulhub install writer-wechat          # \u4ECE registry \u5B89\u88C5\u5355 agent"));
-      console.log(source_default.dim("    soulhub install dev-squad              # \u4ECE registry \u5B89\u88C5\u56E2\u961F"));
-      console.log(source_default.dim("    soulhub install --from ./agent-team/   # \u4ECE\u672C\u5730\u76EE\u5F55\u5B89\u88C5"));
+      console.log(source_default.dim("    soulhub install writer-wechat            # \u4EA4\u4E92\u5F0F\u9009\u62E9\u5B89\u88C5\u4E3A\u4E3B/\u5B50 agent"));
+      console.log(source_default.dim("    soulhub install writer-wechat --main     # \u975E\u4EA4\u4E92\u5F0F\uFF0C\u5B89\u88C5\u4E3A\u4E3B agent (workspace/)"));
+      console.log(source_default.dim("    soulhub install writer-wechat --worker   # \u975E\u4EA4\u4E92\u5F0F\uFF0C\u5B89\u88C5\u4E3A\u5B50 agent (workspace-xxx/)"));
+      console.log(source_default.dim("    soulhub install dev-squad                # \u4ECE registry \u5B89\u88C5\u56E2\u961F"));
+      console.log(source_default.dim("    soulhub install --from ./agent-team/     # \u4ECE\u672C\u5730\u76EE\u5F55\u5B89\u88C5"));
+      console.log(source_default.dim("    soulhub install writer-wechat --claw-dir ~/.lightclaw  # \u975E\u4EA4\u4E92\u5F0F\u6307\u5B9A claw \u76EE\u5F55"));
       process.exit(1);
     }
   } catch (error) {
@@ -19753,15 +19797,15 @@ var installCommand = new Command("install").description("Install an agent or tea
     process.exit(1);
   }
 });
-async function installFromRegistry(name, targetDir, clawDir) {
+async function installFromRegistry(name, targetDir, clawDir, asMain) {
   const spinner = createSpinner(`Checking registry for ${source_default.cyan(name)}...`).start();
   const index = await fetchIndex();
   const agent = index.agents.find((a) => a.name === name);
   const recipe = index.recipes.find((r) => r.name === name);
   if (agent && !recipe) {
     spinner.stop();
-    logger.info(`Installing single agent from registry: ${name}`);
-    await installSingleAgent(name, targetDir, clawDir);
+    logger.info(`Installing single agent from registry: ${name}, asMain=${asMain ?? "interactive"}`);
+    await installSingleAgent(name, targetDir, clawDir, asMain);
   } else if (recipe) {
     spinner.stop();
     logger.info(`Installing team recipe from registry: ${name}`);
@@ -19772,7 +19816,7 @@ async function installFromRegistry(name, targetDir, clawDir) {
     console.log(source_default.dim("  Use 'soulhub search' to find available agents and teams."));
   }
 }
-async function installSingleAgent(name, targetDir, clawDir) {
+async function installSingleAgent(name, targetDir, clawDir, asMain) {
   const spinner = createSpinner(`Checking environment...`).start();
   let selectedClawDir = null;
   if (!targetDir) {
@@ -19783,9 +19827,18 @@ async function installSingleAgent(name, targetDir, clawDir) {
       printOpenClawInstallHelp();
       return;
     }
-    spinner.start();
     const brand = detectClawBrand(selectedClawDir);
-    spinner.text = source_default.dim(`${brand} detected: ${selectedClawDir}`);
+    console.log(source_default.dim(`  ${brand} detected: ${selectedClawDir}`));
+  }
+  const agentId = name.toLowerCase().replace(/[\s_]+/g, "-");
+  if (asMain === void 0) {
+    const choice = await promptInstallRole(agentId);
+    if (choice === null) return;
+    asMain = choice;
+  }
+  logger.info(`Install role resolved: asMain=${asMain}`);
+  if (!targetDir) {
+    spinner.start();
   }
   spinner.text = `Fetching agent ${source_default.cyan(name)}...`;
   const index = await fetchIndex();
@@ -19798,11 +19851,13 @@ async function installSingleAgent(name, targetDir, clawDir) {
   let workspaceDir;
   if (targetDir) {
     workspaceDir = import_node_path12.default.resolve(targetDir);
-  } else {
+  } else if (asMain) {
     workspaceDir = getMainWorkspaceDir(selectedClawDir);
+  } else {
+    workspaceDir = getWorkspaceDir(selectedClawDir, agentId);
   }
   const backupRecord = !targetDir ? createBackupRecord("single-agent", name, selectedClawDir) : null;
-  if (!targetDir) {
+  if (!targetDir && asMain) {
     const mainCheck = checkMainAgentExists(selectedClawDir);
     if (mainCheck.hasContent) {
       spinner.warn(
@@ -19820,7 +19875,21 @@ async function installSingleAgent(name, targetDir, clawDir) {
         });
       }
     }
-  } else {
+  } else if (!targetDir && !asMain) {
+    if (import_node_fs9.default.existsSync(workspaceDir)) {
+      const backupDir = backupAgentWorkspace(workspaceDir);
+      if (backupDir) {
+        console.log(source_default.yellow(`  \u26A0 Existing worker ${agentId} backed up to: ${backupDir}`));
+        addBackupItem(backupRecord, {
+          originalPath: workspaceDir,
+          backupPath: backupDir,
+          method: "cp",
+          role: "worker",
+          agentId
+        });
+      }
+    }
+  } else if (targetDir) {
     const backupDir = backupAgentWorkspace(workspaceDir);
     if (backupDir) {
       console.log(source_default.yellow(`  \u26A0 Existing agent backed up to: ${backupDir}`));
@@ -19830,9 +19899,19 @@ async function installSingleAgent(name, targetDir, clawDir) {
     import_node_fs9.default.mkdirSync(workspaceDir, { recursive: true });
   }
   if (!targetDir) {
-    spinner.text = `Registering ${source_default.cyan(agent.displayName)} as main agent...`;
-    addAgentToOpenClawConfig(selectedClawDir, "main", name, true);
-    spinner.text = source_default.dim(`Main agent registered in config`);
+    if (asMain) {
+      spinner.text = `Registering ${source_default.cyan(agent.displayName)} as main agent...`;
+      addAgentToOpenClawConfig(selectedClawDir, "main", name, true);
+      spinner.text = source_default.dim(`Main agent registered in config`);
+    } else {
+      spinner.text = `Registering ${source_default.cyan(agent.displayName)} as worker agent...`;
+      const regResult = registerAgentToOpenClaw(agentId, workspaceDir, clawDir);
+      if (!regResult.success) {
+        spinner.fail(`Failed to register ${agentId}: ${regResult.message}`);
+        return;
+      }
+      spinner.text = source_default.dim(`Worker agent ${agentId} registered in config`);
+    }
   }
   spinner.text = `Downloading ${source_default.cyan(agent.displayName)} package...`;
   const pkgDir = await downloadAgentPackage(name, agent.version);
@@ -19840,17 +19919,23 @@ async function installSingleAgent(name, targetDir, clawDir) {
   import_node_fs9.default.rmSync(pkgDir, { recursive: true, force: true });
   recordInstall(name, agent.version, workspaceDir);
   if (backupRecord) {
-    backupRecord.installedMainAgent = name;
+    if (asMain) {
+      backupRecord.installedMainAgent = name;
+    } else {
+      backupRecord.installedWorkerIds = [agentId];
+    }
     commitBackupRecord(backupRecord);
   }
-  logger.info(`Single agent installed: ${name}`, { version: agent.version, workspace: workspaceDir });
+  const roleLabel = asMain ? "main agent" : "worker agent";
+  const typeLabel = asMain ? source_default.blue("Single Agent (Main)") : source_default.green("Single Agent (Worker)");
+  logger.info(`Single agent installed as ${roleLabel}: ${name}`, { version: agent.version, workspace: workspaceDir });
   spinner.succeed(
-    `${source_default.cyan.bold(agent.displayName)} installed as main agent!`
+    `${source_default.cyan.bold(agent.displayName)} installed as ${roleLabel}!`
   );
   console.log();
   console.log(`  ${source_default.dim("Location:")} ${workspaceDir}`);
   console.log(`  ${source_default.dim("Version:")}  ${agent.version}`);
-  console.log(`  ${source_default.dim("Type:")}     ${source_default.blue("Single Agent (Main)")}`);
+  console.log(`  ${source_default.dim("Type:")}     ${typeLabel}`);
   if (!targetDir) {
     await tryRestartGateway();
   }
@@ -19948,7 +20033,7 @@ async function installRecipeFromRegistry(name, recipe, targetDir, clawDir) {
     await tryRestartGateway();
   }
 }
-async function installFromSource(source, targetDir, clawDir) {
+async function installFromSource(source, targetDir, clawDir, asMain) {
   const spinner = createSpinner("Analyzing package...").start();
   let packageDir;
   let tempDir = null;
@@ -20002,7 +20087,7 @@ async function installFromSource(source, targetDir, clawDir) {
   spinner.text = `Detected package type: ${source_default.blue(kind)}`;
   if (kind === "agent") {
     spinner.stop();
-    await installSingleAgentFromDir(packageDir, targetDir, clawDir);
+    await installSingleAgentFromDir(packageDir, targetDir, clawDir, asMain);
   } else if (kind === "team") {
     spinner.stop();
     await installTeamFromDir(packageDir, targetDir, clawDir);
@@ -20014,7 +20099,7 @@ async function installFromSource(source, targetDir, clawDir) {
     import_node_fs9.default.rmSync(tempDir, { recursive: true, force: true });
   }
 }
-async function installSingleAgentFromDir(packageDir, targetDir, clawDir) {
+async function installSingleAgentFromDir(packageDir, targetDir, clawDir, asMain) {
   const spinner = createSpinner("Installing single agent...").start();
   const pkg = readSoulHubPackage(packageDir);
   const agentName = pkg?.name || import_node_path12.default.basename(packageDir);
@@ -20027,16 +20112,29 @@ async function installSingleAgentFromDir(packageDir, targetDir, clawDir) {
       printOpenClawInstallHelp();
       return;
     }
+    const brand = detectClawBrand(selectedClawDir);
+    console.log(source_default.dim(`  ${brand} detected: ${selectedClawDir}`));
+  }
+  const agentId = agentName.toLowerCase().replace(/[\s_]+/g, "-");
+  if (asMain === void 0) {
+    const choice = await promptInstallRole(agentId);
+    if (choice === null) return;
+    asMain = choice;
+  }
+  logger.info(`Install role resolved: asMain=${asMain}`);
+  if (!targetDir) {
     spinner.start();
   }
   let workspaceDir;
   if (targetDir) {
     workspaceDir = import_node_path12.default.resolve(targetDir);
-  } else {
+  } else if (asMain) {
     workspaceDir = getMainWorkspaceDir(selectedClawDir);
+  } else {
+    workspaceDir = getWorkspaceDir(selectedClawDir, agentId);
   }
   const localBackupRecord = !targetDir ? createBackupRecord("single-agent-local", agentName, selectedClawDir) : null;
-  if (!targetDir) {
+  if (!targetDir && asMain) {
     const mainCheck = checkMainAgentExists(selectedClawDir);
     if (mainCheck.hasContent) {
       spinner.warn("Existing main agent detected. Backing up...");
@@ -20052,27 +20150,56 @@ async function installSingleAgentFromDir(packageDir, targetDir, clawDir) {
         });
       }
     }
+  } else if (!targetDir && !asMain) {
+    if (import_node_fs9.default.existsSync(workspaceDir)) {
+      const backupDir = backupAgentWorkspace(workspaceDir);
+      if (backupDir) {
+        console.log(source_default.yellow(`  \u26A0 Existing worker ${agentId} backed up to: ${backupDir}`));
+        addBackupItem(localBackupRecord, {
+          originalPath: workspaceDir,
+          backupPath: backupDir,
+          method: "cp",
+          role: "worker",
+          agentId
+        });
+      }
+    }
   }
   if (!import_node_fs9.default.existsSync(workspaceDir)) {
     import_node_fs9.default.mkdirSync(workspaceDir, { recursive: true });
   }
   if (!targetDir) {
-    spinner.text = `Registering ${source_default.cyan(agentName)} as main agent...`;
-    addAgentToOpenClawConfig(selectedClawDir, "main", agentName, true);
+    if (asMain) {
+      spinner.text = `Registering ${source_default.cyan(agentName)} as main agent...`;
+      addAgentToOpenClawConfig(selectedClawDir, "main", agentName, true);
+    } else {
+      spinner.text = `Registering ${source_default.cyan(agentName)} as worker agent...`;
+      const regResult = registerAgentToOpenClaw(agentId, workspaceDir, clawDir);
+      if (!regResult.success) {
+        spinner.fail(`Failed to register ${agentId}: ${regResult.message}`);
+        return;
+      }
+    }
   }
   spinner.text = `Copying soul files...`;
   copyAgentFilesFromDir(packageDir, workspaceDir);
   recordInstall(agentName, pkg?.version || "local", workspaceDir);
   if (localBackupRecord) {
-    localBackupRecord.installedMainAgent = agentName;
+    if (asMain) {
+      localBackupRecord.installedMainAgent = agentName;
+    } else {
+      localBackupRecord.installedWorkerIds = [agentId];
+    }
     commitBackupRecord(localBackupRecord);
   }
-  logger.info(`Single agent installed from dir: ${agentName}`, { source: packageDir, workspace: workspaceDir });
-  spinner.succeed(`${source_default.cyan.bold(agentName)} installed as main agent!`);
+  const roleLabel = asMain ? "main agent" : "worker agent";
+  const typeLabel = asMain ? source_default.blue("Single Agent (Main)") : source_default.green("Single Agent (Worker)");
+  logger.info(`Single agent installed from dir as ${roleLabel}: ${agentName}`, { source: packageDir, workspace: workspaceDir });
+  spinner.succeed(`${source_default.cyan.bold(agentName)} installed as ${roleLabel}!`);
   console.log();
   console.log(`  ${source_default.dim("Location:")} ${workspaceDir}`);
   console.log(`  ${source_default.dim("Source:")}   ${packageDir}`);
-  console.log(`  ${source_default.dim("Type:")}     ${source_default.blue("Single Agent (Main)")}`);
+  console.log(`  ${source_default.dim("Type:")}     ${typeLabel}`);
   if (!targetDir) {
     await tryRestartGateway();
   }
@@ -20294,7 +20421,7 @@ async function tryRestartGateway() {
 }
 
 // src/commands/list.ts
-var listCommand = new Command("list").description("List installed agent templates").alias("ls").action(async () => {
+var listCommand = new Command("list").description("List installed agents").alias("ls").action(async () => {
   try {
     const config = loadConfig();
     if (config.installed.length === 0) {
@@ -20334,7 +20461,7 @@ var listCommand = new Command("list").description("List installed agent template
 
 // src/commands/update.ts
 var import_node_fs10 = __toESM(require("fs"), 1);
-var updateCommand = new Command("update").description("Update installed agent templates to latest versions").argument("[name]", "Agent name to update (updates all if omitted)").action(async (name) => {
+var updateCommand = new Command("update").description("Update installed agents to latest versions").argument("[name]", "Agent name to update (updates all if omitted)").action(async (name) => {
   try {
     const config = loadConfig();
     if (config.installed.length === 0) {
@@ -20575,13 +20702,13 @@ function formatInstallType(type2) {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("soulhub").description("SoulHub CLI - Install and manage AI agent persona templates").version("1.0.13").option("--verbose", "Enable verbose debug logging").hook("preAction", () => {
+program2.name("soulhub").description("SoulHub CLI - Discover, install and manage AI agent souls").version("1.0.15").option("--verbose", "Enable verbose debug logging").hook("preAction", () => {
   const opts = program2.opts();
   const verbose = opts.verbose || process.env.SOULHUB_DEBUG === "1";
   logger.init(verbose);
   logger.info("CLI started", {
     args: process.argv.slice(2),
-    version: "1.0.13",
+    version: "1.0.15",
     node: process.version
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soulhubcli",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "SoulHub CLI - Install and manage AI agent persona templates for OpenClaw",
   "type": "module",
   "bin": {