@clawstore/clawstore 1.0.0

package/src/cli.ts

@@ -0,0 +1,513 @@
+import { existsSync } from "node:fs";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import type { ClawstoreConfig } from "./types.js";
+
+import {
+  ensureDirs,
+  listInstalledAgents,
+  getInstalledAgent,
+  enableAgent,
+  disableAgent,
+  unregisterAgent,
+  backupCurrentWorkspace,
+  removeAgentFiles,
+  getAgentStatus,
+  clearSessions,
+} from "./core/agent-manager.js";
+
+import { installAgent, updateAgent } from "./core/package-installer.js";
+import { packAgent, packCurrentAgent } from "./core/packager.js";
+import { diagnose, formatDiagnosticReport, listClawstoreAgents } from "./core/workspace.js";
+import { StoreClient } from "./core/store-client.js";
+import { DEFAULT_API_BASE_URL, DEFAULT_AGENT } from "./constants.js";
+import {
+  agentListItem,
+  detailBlock,
+  searchResultItem,
+} from "./utils/output.js";
+
+// Shorthand reused by every subcommand that supports --agent
+const A_FLAGS = "--agent <name>";
+const A_DESC = "Target OpenClaw agent (default: main)";
+
+// ─── CLI Registration ───────────────────────────────────────────────
+
+export function registerClawstoreCli(api: OpenClawPluginApi): void {
+  const rawConfig = api.pluginConfig as Partial<ClawstoreConfig> | undefined;
+  const client = new StoreClient(rawConfig);
+
+  api.registerCli(
+    ({ program }) => {
+      const root = program
+        .command("clawstore")
+        .description("Clawstore — Agent marketplace for OpenClaw");
+
+      // ── search ──────────────────────────────────────────────────
+      root
+        .command("search [query]")
+        .description("Search the Clawstore marketplace for agents")
+        .option("--category <category>", "Filter by category")
+        .option("--sort <order>", "Sort order: popular|newest|rating", "popular")
+        .option("--limit <n>", "Max results to show", "10")
+        .action(async (query: string | undefined, opts: { category?: string; sort?: string; limit?: string }) => {
+          const q = query ?? "";
+          try {
+            const results = await client.search(q, {
+              category: opts.category,
+              sort: opts.sort,
+              limit: Number(opts.limit) || 10,
+            });
+            if (results.total === 0) {
+              console.log(`\n  No agents found for "${q}".\n`);
+              return;
+            }
+            console.log(`\n  Found ${results.total} agent(s)\n`);
+            results.agents.forEach((a, i) => {
+              console.log(searchResultItem(i + 1, a.id, a.name, a.price, a.currency, a.author, a.rating));
+              console.log("");
+            });
+          } catch (err) {
+            console.log(`\n  Search failed: ${(err as Error).message}`);
+            console.log(`  The Clawstore API may not be available yet.`);
+            console.log(`  Run \`openclaw clawstore doctor\` to check connectivity.\n`);
+          }
+        });
+
+      // ── show ────────────────────────────────────────────────────
+      root
+        .command("show <agent-id>")
+        .description("Show detailed information about an agent")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (agentId: string, opts: { agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+          try {
+            const detail = await client.getAgentDetail(agentId);
+            const local = await getInstalledAgent(agentId, agent);
+            const installStatus = local
+              ? `installed (v${local.version}, ${local.enabled ? "enabled" : "disabled"})`
+              : "not installed";
+
+            console.log(
+              detailBlock({
+                Agent: detail.id,
+                Name: detail.name,
+                Version: detail.version,
+                Author: detail.author,
+                Price: detail.price === 0 ? "Free" : `$${detail.price}`,
+                Category: detail.category,
+                Rating: detail.rating?.toFixed(1),
+                OpenClaw: detail.openclaw_version,
+                Skills:
+                  detail.skills
+                    ?.map((s) => `${s.id} ${s.version}${s.required ? " (required)" : ""}`)
+                    .join(", ") || "none",
+                Status: installStatus,
+                ...(agent !== DEFAULT_AGENT ? { "Target agent": agent } : {}),
+              }),
+            );
+            return;
+          } catch {
+            // Fall back to local
+          }
+
+          const local = await getInstalledAgent(agentId, agent);
+          if (!local) {
+            console.log(`\n  Agent '${agentId}' not found (neither remote nor local).\n`);
+            return;
+          }
+          console.log(
+            detailBlock({
+              Agent: local.id,
+              Name: local.name,
+              Version: local.version,
+              Author: local.author,
+              Category: local.category,
+              Status: local.enabled ? "enabled" : "disabled",
+              Installed: local.installed_at,
+              Updated: local.updated_at,
+              Path: local.install_path,
+              ...(agent !== DEFAULT_AGENT ? { "Target agent": agent } : {}),
+            }),
+          );
+        });
+
+      // ── install ─────────────────────────────────────────────────
+      root
+        .command("install <source>")
+        .description("Install an Agent from local path, ZIP, or marketplace")
+        .option("-f, --force", "Force reinstall if already installed")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (source: string, opts: { force?: boolean; agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+          let packagePath = source;
+
+          const isRemote =
+            !source.includes("/") &&
+            !source.includes("\\") &&
+            !source.endsWith(".zip") &&
+            !existsSync(source);
+
+          if (isRemote) {
+            try {
+              console.log(`\n  Fetching ${source} from Clawstore...`);
+              const url = await client.getDownloadUrl(source);
+              const { downloadPackage } = await import("./core/package-installer.js");
+              packagePath = await downloadPackage(url, source);
+              console.log(`  Downloaded to: ${packagePath}\n`);
+            } catch (err) {
+              console.log(`\n  Failed to download '${source}' from Clawstore: ${(err as Error).message}`);
+              console.log(`  If this is a local path, make sure the file/directory exists.\n`);
+              return;
+            }
+          }
+
+          await installAgent({
+            packagePath,
+            force: opts.force === true,
+            agent,
+            log: console.log,
+          });
+        });
+
+      // ── installed ───────────────────────────────────────────────
+      root
+        .command("installed")
+        .description("List all installed agents")
+        .option("--json", "Output as JSON")
+        .option("--all-agents", "Show installations across all OpenClaw agents")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (opts: { json?: boolean; allAgents?: boolean; agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+
+          if (opts.allAgents) {
+            const agentNames = await listClawstoreAgents();
+            if (agentNames.length === 0) {
+              console.log("\n  No agents with installed Personas found.\n");
+              return;
+            }
+            for (const name of agentNames) {
+              const personas = await listInstalledAgents(name);
+              if (personas.length === 0) continue;
+              console.log(`\n  OpenClaw agent: ${name}`);
+              console.log(`  ${"─".repeat(40)}`);
+              personas.forEach((a, i) => {
+                console.log(agentListItem(i + 1, a.id, a.name, a.version, a.category, a.enabled));
+              });
+            }
+            console.log("");
+            return;
+          }
+
+          await ensureDirs(agent);
+          const personas = await listInstalledAgents(agent);
+
+          if (personas.length === 0) {
+            console.log("\n  No agents installed.");
+            console.log("  Run `openclaw clawstore install <package>` to install one.\n");
+            return;
+          }
+
+          if (opts.json) {
+            console.log(JSON.stringify(personas, null, 2));
+            return;
+          }
+
+          if (agent !== DEFAULT_AGENT) {
+            console.log(`\n  OpenClaw agent: ${agent}`);
+          }
+          console.log(`\n  Installed agents: ${personas.length}\n`);
+          personas.forEach((a, i) => {
+            console.log(agentListItem(i + 1, a.id, a.name, a.version, a.category, a.enabled));
+            console.log(`     Installed: ${a.installed_at.slice(0, 10)}`);
+            if (a.updated_at !== a.installed_at) {
+              console.log(`     Updated:   ${a.updated_at.slice(0, 10)}`);
+            }
+            console.log("");
+          });
+        });
+
+      // ── enable ──────────────────────────────────────────────────
+      root
+        .command("enable <agent-id>")
+        .description("Enable an installed agent")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (agentId: string, opts: { agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+          const result = await enableAgent(agentId, agent);
+          if (!result) {
+            console.log(`\n  Agent '${agentId}' is not installed.\n`);
+            return;
+          }
+          console.log(`\n  Enabled: ${result.name} (${agentId})`);
+          if (agent !== DEFAULT_AGENT) console.log(`  OpenClaw agent: ${agent}`);
+          console.log(`  Workspace files restored. Start a new chat to activate the persona.\n`);
+        });
+
+      // ── disable ─────────────────────────────────────────────────
+      root
+        .command("disable <agent-id>")
+        .description("Disable an installed agent")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (agentId: string, opts: { agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+          const result = await disableAgent(agentId, agent);
+          if (!result) {
+            console.log(`\n  Agent '${agentId}' is not installed.\n`);
+            return;
+          }
+          await clearSessions(agent);
+          console.log(`\n  Disabled: ${result.agent.name} (${agentId})`);
+          if (agent !== DEFAULT_AGENT) console.log(`  OpenClaw agent: ${agent}`);
+          console.log(`  Workspace files backed up and removed.`);
+          console.log(`  Session history cleared — TUI will start fresh.`);
+          console.log(`  Backup: ${result.backupPath}`);
+          console.log(`  Use \`openclaw clawstore enable ${agentId}\` to re-activate.\n`);
+        });
+
+      // ── update ──────────────────────────────────────────────────
+      root
+        .command("update [agent-id]")
+        .description("Update an installed agent")
+        .option("--package <path>", "Path to updated package directory or ZIP")
+        .option("--all", "Update all installed agents")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (agentId: string | undefined, opts: { package?: string; all?: boolean; agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+          if (opts.all) {
+            const personas = await listInstalledAgents(agent);
+            if (personas.length === 0) {
+              console.log("\n  No agents installed.\n");
+              return;
+            }
+            console.log(`\n  Checking updates for ${personas.length} agent(s)...\n`);
+            for (const a of personas) {
+              try {
+                const downloadUrl = await client.getDownloadUrl(a.id);
+                const { downloadPackage } = await import("./core/package-installer.js");
+                const pkgPath = await downloadPackage(downloadUrl, a.id);
+                await updateAgent({ agentId: a.id, packagePath: pkgPath, agent, log: console.log });
+              } catch (err) {
+                console.log(`  ${a.id}: skipped (${(err as Error).message})`);
+              }
+            }
+            return;
+          }
+
+          if (!agentId) {
+            console.log("\n  Usage: openclaw clawstore update <agent-id> --package <path>\n");
+            return;
+          }
+
+          const packagePath = opts.package;
+          if (!packagePath) {
+            try {
+              const url = await client.getDownloadUrl(agentId);
+              const { downloadPackage } = await import("./core/package-installer.js");
+              const dlPath = await downloadPackage(url, agentId);
+              await updateAgent({ agentId, packagePath: dlPath, agent, log: console.log });
+            } catch (err) {
+              console.log(`\n  Could not fetch update from Clawstore: ${(err as Error).message}`);
+              console.log(`  Provide a local package: openclaw clawstore update ${agentId} --package <path>\n`);
+            }
+            return;
+          }
+
+          await updateAgent({ agentId, packagePath, agent, log: console.log });
+        });
+
+      // ── uninstall ───────────────────────────────────────────────
+      root
+        .command("uninstall <agent-id>")
+        .description("Uninstall an agent")
+        .option("-y, --yes", "Skip confirmation")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (agentId: string, opts: { yes?: boolean; agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+          await ensureDirs(agent);
+          const record = await getInstalledAgent(agentId, agent);
+
+          if (!record) {
+            console.log(`\n  Agent '${agentId}' is not in the registry.`);
+            console.log(`  Running cleanup for residual files and sessions...\n`);
+
+            console.log("  [1/2] Clearing workspace residuals ... ");
+            const { removeAllWorkspaceAgentFiles } = await import("./core/agent-manager.js");
+            const removed = await removeAllWorkspaceAgentFiles(agent);
+            console.log(`  [1/2] Clearing workspace residuals ... OK (${removed} files removed)`);
+
+            console.log("  [2/2] Clearing session history ... ");
+            const cleared = await clearSessions(agent);
+            console.log(`  [2/2] Clearing session history ... OK (${cleared} sessions cleared)`);
+
+            console.log(`\n  Cleanup complete. TUI will start fresh on next launch.\n`);
+            return;
+          }
+
+          console.log(`\n  Uninstalling: ${record.name} (${agentId})`);
+          console.log(`  Version: ${record.version}`);
+          if (agent !== DEFAULT_AGENT) console.log(`  OpenClaw agent: ${agent}`);
+          console.log("");
+
+          console.log("  [1/4] Creating safety backup ... ");
+          const backupPath = await backupCurrentWorkspace(agentId, "uninstall", agent);
+          console.log("  [1/4] Creating safety backup ... OK");
+
+          console.log("  [2/4] Removing agent files ... ");
+          const removed = await removeAgentFiles(record, agent);
+          console.log(`  [2/4] Removing agent files ... OK (${removed} files removed)`);
+
+          console.log("  [3/4] Updating registry ... ");
+          await unregisterAgent(agentId, agent);
+          console.log("  [3/4] Updating registry ... OK");
+
+          console.log("  [4/4] Clearing session history ... ");
+          const cleared = await clearSessions(agent);
+          console.log(`  [4/4] Clearing session history ... OK (${cleared} sessions cleared)`);
+
+          console.log(`\n  Uninstalled: ${record.name}`);
+          console.log(`  Backup saved: ${backupPath}`);
+          console.log(`  Sessions cleared — TUI will start fresh on next launch.\n`);
+        });
+
+      // ── status ──────────────────────────────────────────────────
+      root
+        .command("status [agent-id]")
+        .description("Show detailed status of an installed agent")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (agentId: string | undefined, opts: { agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+          await ensureDirs(agent);
+
+          if (agentId) {
+            const status = await getAgentStatus(agentId, agent);
+            if (!status) {
+              console.log(`\n  Agent '${agentId}' is not installed.\n`);
+              return;
+            }
+            printAgentStatus(status, agent);
+          } else {
+            const personas = await listInstalledAgents(agent);
+            if (personas.length === 0) {
+              console.log("\n  No agents installed.\n");
+              return;
+            }
+            for (const a of personas) {
+              const status = await getAgentStatus(a.id, agent);
+              if (status) printAgentStatus(status, agent);
+            }
+          }
+        });
+
+      // ── pack ────────────────────────────────────────────────────
+      root
+        .command("pack [path]")
+        .description("Pack a package directory into a distributable ZIP")
+        .option("-o, --output <dir>", "Output directory for ZIP")
+        .option("--name <name>", "Agent name override")
+        .option("--category <category>", "Category override")
+        .action(async (packagePath: string | undefined, opts: { output?: string; name?: string; category?: string }) => {
+          if (packagePath) {
+            await packAgent({
+              packagePath,
+              outputDir: opts.output,
+              name: opts.name,
+              category: opts.category,
+              log: console.log,
+            });
+          } else {
+            await packCurrentAgent({
+              outputDir: opts.output,
+              name: opts.name,
+              category: opts.category,
+              log: console.log,
+            });
+          }
+        });
+
+      // ── doctor ──────────────────────────────────────────────────
+      root
+        .command("doctor")
+        .description("Diagnose environment and configuration")
+        .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
+        .action(async (opts: { agent?: string }) => {
+          const agent = opts.agent ?? DEFAULT_AGENT;
+          await ensureDirs(agent);
+          const apiUrl = rawConfig?.apiBaseUrl ?? DEFAULT_API_BASE_URL;
+          const report = await diagnose(apiUrl, agent);
+          console.log(formatDiagnosticReport(report));
+        });
+
+      // ── login ───────────────────────────────────────────────────
+      root
+        .command("login")
+        .description("Log in to Clawstore")
+        .option("--email <email>", "Email address")
+        .option("--password <password>", "Password")
+        .action(async (opts: { email?: string; password?: string }) => {
+          if (!opts.email || !opts.password) {
+            console.log("\n  Usage: openclaw clawstore login --email <email> --password <password>\n");
+            return;
+          }
+          try {
+            const result = await client.login(opts.email, opts.password);
+            client.setAuthToken(result.token);
+            console.log(`\n  Logged in as: ${result.user.name} (${result.user.id})\n`);
+          } catch (err) {
+            console.log(`\n  Login failed: ${(err as Error).message}\n`);
+          }
+        });
+
+      // ── whoami ──────────────────────────────────────────────────
+      root
+        .command("whoami")
+        .description("Show current Clawstore user")
+        .action(async () => {
+          const user = await client.whoami();
+          if (user) {
+            console.log(`\n  Logged in as: ${user.name} <${user.email}>\n`);
+          } else {
+            console.log("\n  Not logged in. Run `openclaw clawstore login` to authenticate.\n");
+          }
+        });
+    },
+    { commands: ["clawstore"] },
+  );
+}
+
+// ─── Helpers ────────────────────────────────────────────────────────
+
+function printAgentStatus(
+  status: NonNullable<Awaited<ReturnType<typeof getAgentStatus>>>,
+  agent: string = DEFAULT_AGENT,
+): void {
+  const { agent: record, fileHealth, skillHealth } = status;
+  console.log(`\n  Agent:      ${record.id}`);
+  console.log(`  Name:       ${record.name}`);
+  console.log(`  Version:    ${record.version}`);
+  console.log(`  Category:   ${record.category || "N/A"}`);
+  console.log(`  Author:     ${record.author || "N/A"}`);
+  console.log(`  Status:     ${record.enabled ? "enabled" : "disabled"}`);
+  if (agent !== DEFAULT_AGENT) {
+    console.log(`  OC Agent:   ${agent}`);
+  }
+  console.log(`  Installed:  ${record.installed_at}`);
+  console.log(`  Updated:    ${record.updated_at}`);
+  console.log(`  Path:       ${record.install_path}`);
+
+  console.log(`  Files:`);
+  for (const f of fileHealth) {
+    console.log(`    - ${f.file} [${f.exists ? "OK" : "MISSING"}]`);
+  }
+
+  if (skillHealth.length > 0) {
+    console.log(`  Skills:`);
+    for (const s of skillHealth) {
+      console.log(`    - ${s.skillId} [${s.installed ? "installed" : "not installed"}]`);
+    }
+  }
+
+  if (record.backup_path) {
+    console.log(`  Backup:     ${record.backup_path}`);
+  }
+  console.log("");
+}