@clawstore/clawstore 1.0.0

package/src/commands.ts

@@ -0,0 +1,196 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import type { ClawstoreConfig } from "./types.js";
+import { StoreClient } from "./core/store-client.js";
+import { DEFAULT_AGENT } from "./constants.js";
+import {
+  listInstalledAgents,
+  getInstalledAgent,
+  enableAgent,
+  disableAgent,
+} from "./core/agent-manager.js";
+import { installAgent } from "./core/package-installer.js";
+import { diagnose } from "./core/workspace.js";
+
+/**
+ * Register the `/clawstore` slash command.
+ *
+ * Slash commands return short text and are designed for quick in-session
+ * operations.  Use `--agent <name>` anywhere in args to target a
+ * non-default OpenClaw agent.
+ */
+export function registerClawstoreCommand(api: OpenClawPluginApi): void {
+  const rawConfig = api.pluginConfig as Partial<ClawstoreConfig> | undefined;
+  const client = new StoreClient(rawConfig);
+
+  api.registerCommand({
+    name: "clawstore",
+    description: "Quick access to Clawstore agent marketplace",
+    acceptsArgs: true,
+
+    async handler(ctx) {
+      const raw = (ctx.args ?? "").trim();
+      const { agent, parts } = parseAgentFlag(raw);
+      const action = parts[0]?.toLowerCase() ?? "help";
+      const rest = parts.slice(1);
+
+      switch (action) {
+
+        // ── /clawstore search <query> ───────────────────────────
+        case "search": {
+          const query = rest.join(" ");
+          if (!query) return { text: "Usage: /clawstore search <query>" };
+          try {
+            const results = await client.search(query, { limit: 5 });
+            if (results.total === 0) return { text: `No agents found for "${query}".` };
+            const lines = results.agents.map(
+              (a, i) => `${i + 1}. ${a.id} — ${a.name} (${a.price === 0 ? "Free" : `$${a.price}`}, by ${a.author})`
+            );
+            return { text: `Found ${results.total} agent(s)\n${lines.join("\n")}\n\nUse \`openclaw clawstore search ${query}\` for full results.` };
+          } catch (err) {
+            return { text: `Search failed: ${(err as Error).message}\nThe Clawstore API may not be available yet.` };
+          }
+        }
+
+        // ── /clawstore show <agent-id> ──────────────────────────
+        case "show": {
+          const agentId = rest[0];
+          if (!agentId) return { text: "Usage: /clawstore show <agent-id>" };
+          const local = await getInstalledAgent(agentId, agent);
+          if (local) {
+            return { text: `Agent: ${local.id}\nName: ${local.name}\nVersion: ${local.version}\nStatus: ${local.enabled ? "enabled" : "disabled"}\nCategory: ${local.category}${agent !== DEFAULT_AGENT ? `\nOC Agent: ${agent}` : ""}` };
+          }
+          try {
+            const remote = await client.getAgentDetail(agentId);
+            return { text: `Agent: ${remote.id}\nName: ${remote.name}\nVersion: ${remote.version}\nPrice: ${remote.price === 0 ? "Free" : `$${remote.price}`}\nCategory: ${remote.category}\nStatus: not installed` };
+          } catch {
+            return { text: `Agent '${agentId}' not found.` };
+          }
+        }
+
+        // ── /clawstore install <source> ─────────────────────────
+        case "install": {
+          const source = rest[0];
+          if (!source) return { text: "Usage: /clawstore install <agent-id|path>" };
+          const lines: string[] = [];
+          const result = await installAgent({
+            packagePath: source,
+            agent,
+            log: (msg) => lines.push(msg),
+          });
+          if (result.state === "success") {
+            return { text: `Installed ${result.agentId}${agent !== DEFAULT_AGENT ? ` (agent: ${agent})` : ""}\n\nUse \`openclaw clawstore status ${result.agentId}\` for details.` };
+          }
+          return { text: `Install failed: ${result.error}\n\nUse CLI for details: \`openclaw clawstore install ${source}\`` };
+        }
+
+        // ── /clawstore installed ────────────────────────────────
+        case "installed": {
+          const agents = await listInstalledAgents(agent);
+          if (agents.length === 0) return { text: `No agents installed${agent !== DEFAULT_AGENT ? ` (agent: ${agent})` : ""}.` };
+          const lines = agents.map(
+            (a, i) => `${i + 1}. ${a.id} v${a.version} (${a.enabled ? "enabled" : "disabled"})`
+          );
+          return { text: `Installed agents${agent !== DEFAULT_AGENT ? ` [${agent}]` : ""}: ${agents.length}\n${lines.join("\n")}` };
+        }
+
+        // ── /clawstore enable <agent-id> ────────────────────────
+        case "enable": {
+          const id = rest[0];
+          if (!id) return { text: "Usage: /clawstore enable <agent-id>" };
+          const result = await enableAgent(id, agent);
+          return { text: result ? `Enabled: ${result.name} (${id}). Workspace files restored.` : `Agent '${id}' is not installed.` };
+        }
+
+        // ── /clawstore disable <agent-id> ───────────────────────
+        case "disable": {
+          const id = rest[0];
+          if (!id) return { text: "Usage: /clawstore disable <agent-id>" };
+          const result = await disableAgent(id, agent);
+          return { text: result ? `Disabled: ${result.agent.name} (${id}). Workspace files removed.` : `Agent '${id}' is not installed.` };
+        }
+
+        // ── /clawstore update <agent-id> ────────────────────────
+        case "update": {
+          const id = rest[0];
+          if (!id) return { text: "Usage: /clawstore update <agent-id>\n\nUse CLI for full options: `openclaw clawstore update <agent-id> --package <path>`" };
+          return { text: `Update via slash command is limited.\nUse: \`openclaw clawstore update ${id} --package <path>\`` };
+        }
+
+        // ── /clawstore uninstall <agent-id> ─────────────────────
+        case "uninstall": {
+          const id = rest[0];
+          if (!id) return { text: "Usage: /clawstore uninstall <agent-id>" };
+          return { text: `For safety, uninstall requires the CLI:\n\`openclaw clawstore uninstall ${id}\`` };
+        }
+
+        // ── /clawstore pack ─────────────────────────────────────
+        case "pack": {
+          return { text: "Pack requires the CLI for interactive confirmation:\n`openclaw clawstore pack [path]`" };
+        }
+
+        // ── /clawstore doctor ───────────────────────────────────
+        case "doctor": {
+          const report = await diagnose(undefined, agent);
+          const summary = report.checks
+            .filter((c) => c.status !== "ok")
+            .map((c) => `${c.label}: ${c.detail}`)
+            .join("\n");
+          return {
+            text: report.allOk
+              ? "All checks passed."
+              : `Issues found:\n${summary}\n\nRun \`openclaw clawstore doctor\` for full report.`,
+          };
+        }
+
+        // ── /clawstore help ─────────────────────────────────────
+        case "help":
+        default:
+          return {
+            text: [
+              "Clawstore — Agent Marketplace",
+              "",
+              "Usage: /clawstore <action> [args] [--agent <name>]",
+              "",
+              "Actions:",
+              "  search <query>       Search marketplace",
+              "  show <agent-id>      Show agent details",
+              "  install <source>     Install an agent",
+              "  installed            List installed agents",
+              "  enable <agent-id>    Enable an agent",
+              "  disable <agent-id>   Disable an agent",
+              "  update <agent-id>    Update an agent",
+              "  uninstall <agent-id> Uninstall an agent",
+              "  doctor               Run diagnostics",
+              "  help                 Show this help",
+              "",
+              "Options:",
+              "  --agent <name>       Target OpenClaw agent (default: main)",
+              "",
+              "For full options, use the CLI: `openclaw clawstore --help`",
+            ].join("\n"),
+          };
+      }
+    },
+  });
+}
+
+/**
+ * Extract `--agent <name>` from raw args string and return the remaining
+ * parts plus the resolved agent name.
+ */
+function parseAgentFlag(raw: string): { agent: string; parts: string[] } {
+  const tokens = raw.split(/\s+/).filter(Boolean);
+  let agent = DEFAULT_AGENT;
+  const parts: string[] = [];
+
+  for (let i = 0; i < tokens.length; i++) {
+    if (tokens[i] === "--agent" && i + 1 < tokens.length) {
+      agent = tokens[i + 1];
+      i++;
+    } else {
+      parts.push(tokens[i]);
+    }
+  }
+
+  return { agent, parts };
+}

package/src/constants.ts

@@ -0,0 +1,80 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+export const PLUGIN_ID = "clawstore";
+export const PLUGIN_VERSION = "1.0.0";
+
+// ─── OpenClaw Paths ─────────────────────────────────────────────────
+
+export const OPENCLAW_HOME = join(homedir(), ".openclaw");
+export const DEFAULT_AGENT = "main";
+
+export const CLAWSTORE_DIR = join(OPENCLAW_HOME, "clawstore");
+export const CACHE_DIR = join(CLAWSTORE_DIR, "cache");
+export const DOWNLOADS_DIR = join(CLAWSTORE_DIR, "downloads_cache");
+
+// ─── Per-agent path resolvers ───────────────────────────────────────
+// `agent` = OpenClaw agent name (e.g. "main", "sales", "support")
+
+export function agentSessionsDir(agent: string = DEFAULT_AGENT): string {
+  return join(OPENCLAW_HOME, "agents", agent, "sessions");
+}
+
+export function agentSessionsIndex(agent: string = DEFAULT_AGENT): string {
+  return join(agentSessionsDir(agent), "sessions.json");
+}
+
+export function agentRegistryFile(agent: string = DEFAULT_AGENT): string {
+  if (agent === DEFAULT_AGENT) return join(CLAWSTORE_DIR, "installed_agents.json");
+  return join(CLAWSTORE_DIR, "agents", agent, "installed_agents.json");
+}
+
+export function agentSkillRegistryFile(agent: string = DEFAULT_AGENT): string {
+  if (agent === DEFAULT_AGENT) return join(CLAWSTORE_DIR, "installed_skills.json");
+  return join(CLAWSTORE_DIR, "agents", agent, "installed_skills.json");
+}
+
+export function agentBackupDir(agent: string = DEFAULT_AGENT): string {
+  if (agent === DEFAULT_AGENT) return join(CLAWSTORE_DIR, "backups");
+  return join(CLAWSTORE_DIR, "agents", agent, "backups");
+}
+
+// Legacy constants — resolve to "main" agent for backward compatibility
+export const SESSIONS_DIR = agentSessionsDir(DEFAULT_AGENT);
+export const SESSIONS_INDEX = agentSessionsIndex(DEFAULT_AGENT);
+export const REGISTRY_FILE = agentRegistryFile(DEFAULT_AGENT);
+export const SKILL_REGISTRY_FILE = agentSkillRegistryFile(DEFAULT_AGENT);
+export const BACKUP_DIR = agentBackupDir(DEFAULT_AGENT);
+
+// ─── Agent Package File Conventions ─────────────────────────────────
+
+export const REQUIRED_FILES = ["SOUL.md", "IDENTITY.md", "AGENTS.md"] as const;
+
+export const OPTIONAL_FILES = [
+  "USER.md",
+  "BOOTSTRAP.md",
+  "HEARTBEAT.md",
+  "MEMORY.md",
+  "TOOLS.md",
+  "BOOT.md",
+] as const;
+
+export const MANIFEST_FILE = "agent.json";
+
+export const MANIFEST_REQUIRED_FIELDS = [
+  "id",
+  "name",
+  "version",
+  "category",
+] as const;
+
+// ─── Default API ────────────────────────────────────────────────────
+
+export const DEFAULT_API_BASE_URL = "https://api.shopclawmart.com";
+
+// ─── Install Steps ──────────────────────────────────────────────────
+
+export const INSTALL_TOTAL_STEPS = 7;
+export const UPDATE_TOTAL_STEPS = 5;
+export const UNINSTALL_TOTAL_STEPS = 4;
+export const PACK_TOTAL_STEPS = 3;

package/src/core/agent-manager.ts

@@ -0,0 +1,327 @@
+import { readFile, writeFile, mkdir, access, readdir, unlink, cp, rm } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import {
+  DEFAULT_AGENT,
+  REQUIRED_FILES,
+  OPTIONAL_FILES,
+  agentRegistryFile,
+  agentBackupDir,
+  agentSessionsDir,
+  agentSessionsIndex,
+} from "../constants.js";
+import type { AgentRegistry, InstalledAgentRecord, AgentManifest } from "../types.js";
+import { resolveWorkspace } from "./workspace.js";
+
+// In this module, `agent` always refers to the OpenClaw agent name
+// (e.g. "main", "sales"), while `agentId` / `personaId` refers to the
+// Persona package identifier (e.g. "sellex-ecommerce-ops").
+
+// ─── Registry I/O with simple file-lock guard ───────────────────────
+
+let registryLock = false;
+
+async function acquireLock(): Promise<void> {
+  let attempts = 0;
+  while (registryLock && attempts < 50) {
+    await new Promise((r) => setTimeout(r, 100));
+    attempts++;
+  }
+  if (registryLock) throw new Error("Could not acquire registry lock after 5s");
+  registryLock = true;
+}
+
+function releaseLock(): void {
+  registryLock = false;
+}
+
+async function exists(p: string): Promise<boolean> {
+  try {
+    await access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function ensureDirs(agent: string = DEFAULT_AGENT): Promise<void> {
+  const workspace = await resolveWorkspace(agent);
+  const registryFile = agentRegistryFile(agent);
+  const backupDir = agentBackupDir(agent);
+  for (const d of [workspace, dirname(registryFile), backupDir]) {
+    await mkdir(d, { recursive: true });
+  }
+}
+
+export async function loadRegistry(agent: string = DEFAULT_AGENT): Promise<AgentRegistry> {
+  const registryFile = agentRegistryFile(agent);
+  if (!(await exists(registryFile))) {
+    return { agents: {} };
+  }
+  const raw = await readFile(registryFile, "utf-8");
+  return JSON.parse(raw) as AgentRegistry;
+}
+
+export async function saveRegistry(registry: AgentRegistry, agent: string = DEFAULT_AGENT): Promise<void> {
+  const registryFile = agentRegistryFile(agent);
+  await mkdir(dirname(registryFile), { recursive: true });
+  await writeFile(registryFile, JSON.stringify(registry, null, 2), "utf-8");
+}
+
+// ─── Agent CRUD ─────────────────────────────────────────────────────
+
+export async function getInstalledAgent(personaId: string, agent: string = DEFAULT_AGENT): Promise<InstalledAgentRecord | null> {
+  const reg = await loadRegistry(agent);
+  return reg.agents[personaId] ?? null;
+}
+
+export async function listInstalledAgents(agent: string = DEFAULT_AGENT): Promise<InstalledAgentRecord[]> {
+  const reg = await loadRegistry(agent);
+  return Object.values(reg.agents);
+}
+
+export async function registerAgent(record: InstalledAgentRecord, agent: string = DEFAULT_AGENT): Promise<void> {
+  await acquireLock();
+  try {
+    const reg = await loadRegistry(agent);
+    reg.agents[record.id] = record;
+    await saveRegistry(reg, agent);
+  } finally {
+    releaseLock();
+  }
+}
+
+export async function unregisterAgent(personaId: string, agent: string = DEFAULT_AGENT): Promise<InstalledAgentRecord | null> {
+  await acquireLock();
+  try {
+    const reg = await loadRegistry(agent);
+    const record = reg.agents[personaId];
+    if (!record) return null;
+    delete reg.agents[personaId];
+    await saveRegistry(reg, agent);
+    return record;
+  } finally {
+    releaseLock();
+  }
+}
+
+export async function updateAgentRecord(
+  personaId: string,
+  patch: Partial<InstalledAgentRecord>,
+  agent: string = DEFAULT_AGENT,
+): Promise<InstalledAgentRecord | null> {
+  await acquireLock();
+  try {
+    const reg = await loadRegistry(agent);
+    const record = reg.agents[personaId];
+    if (!record) return null;
+    Object.assign(record, patch);
+    await saveRegistry(reg, agent);
+    return record;
+  } finally {
+    releaseLock();
+  }
+}
+
+// ─── Enable / Disable ───────────────────────────────────────────────
+
+export async function enableAgent(personaId: string, agent: string = DEFAULT_AGENT): Promise<InstalledAgentRecord | null> {
+  const record = await getInstalledAgent(personaId, agent);
+  if (!record) return null;
+
+  if (record.disable_backup_path && (await exists(record.disable_backup_path))) {
+    await restoreFromBackup(record.disable_backup_path, agent);
+  }
+
+  return updateAgentRecord(personaId, {
+    enabled: true,
+    disable_backup_path: undefined,
+  }, agent);
+}
+
+export async function disableAgent(personaId: string, agent: string = DEFAULT_AGENT): Promise<{ agent: InstalledAgentRecord; backupPath: string } | null> {
+  const record = await getInstalledAgent(personaId, agent);
+  if (!record) return null;
+
+  const backupPath = await backupCurrentWorkspace(personaId, "disable", agent);
+  await removeAgentFiles(record, agent);
+
+  const workspace = await resolveWorkspace(agent);
+  const skillsDir = join(workspace, "skills");
+  if (await exists(skillsDir)) {
+    await rm(skillsDir, { recursive: true, force: true });
+  }
+
+  const updated = await updateAgentRecord(personaId, {
+    enabled: false,
+    disable_backup_path: backupPath,
+  }, agent);
+
+  return updated ? { agent: updated, backupPath } : null;
+}
+
+// ─── Backup ─────────────────────────────────────────────────────────
+
+export async function backupCurrentWorkspace(personaId: string, label: string = "", agent: string = DEFAULT_AGENT): Promise<string> {
+  const workspace = await resolveWorkspace(agent);
+  const backupDir = agentBackupDir(agent);
+  const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+  const dirName = label ? `${personaId}_${label}_${timestamp}` : `${personaId}_${timestamp}`;
+  const backupPath = join(backupDir, dirName);
+  await mkdir(backupPath, { recursive: true });
+
+  const allFiles = [...REQUIRED_FILES, ...OPTIONAL_FILES];
+  let count = 0;
+  for (const f of allFiles) {
+    const src = join(workspace, f);
+    if (await exists(src)) {
+      await cp(src, join(backupPath, f));
+      count++;
+    }
+  }
+
+  const skillsDir = join(workspace, "skills");
+  if (await exists(skillsDir)) {
+    await cp(skillsDir, join(backupPath, "skills"), { recursive: true });
+    count++;
+  }
+
+  return backupPath;
+}
+
+// ─── Restore (rollback) ────────────────────────────────────────────
+
+export async function restoreFromBackup(backupPath: string, agent: string = DEFAULT_AGENT): Promise<number> {
+  const workspace = await resolveWorkspace(agent);
+  let count = 0;
+
+  const allFiles = [...REQUIRED_FILES, ...OPTIONAL_FILES];
+  for (const f of allFiles) {
+    const src = join(backupPath, f);
+    if (await exists(src)) {
+      await cp(src, join(workspace, f), { force: true });
+      count++;
+    }
+  }
+
+  const skillsBackup = join(backupPath, "skills");
+  if (await exists(skillsBackup)) {
+    const skillsDest = join(workspace, "skills");
+    await cp(skillsBackup, skillsDest, { recursive: true, force: true });
+    count++;
+  }
+
+  return count;
+}
+
+// ─── Uninstall (file removal) ───────────────────────────────────────
+
+export async function removeAgentFiles(record: InstalledAgentRecord, agent: string = DEFAULT_AGENT): Promise<number> {
+  const workspace = await resolveWorkspace(agent);
+  let count = 0;
+
+  for (const f of [...REQUIRED_FILES, ...OPTIONAL_FILES]) {
+    const target = join(workspace, f);
+    if (await exists(target)) {
+      await unlink(target);
+      count++;
+    }
+  }
+
+  if (record.skills && record.skills.length > 0) {
+    const skillsDir = join(workspace, "skills");
+    for (const skillId of record.skills) {
+      const skillFile = join(skillsDir, `${skillId}.md`);
+      if (await exists(skillFile)) {
+        await unlink(skillFile);
+        count++;
+      }
+    }
+    if (await exists(skillsDir)) {
+      const remaining = await readdir(skillsDir);
+      if (remaining.length === 0) {
+        await rm(skillsDir, { recursive: true });
+      }
+    }
+  }
+
+  return count;
+}
+
+/**
+ * Remove all known agent files from workspace without needing a registry record.
+ */
+export async function removeAllWorkspaceAgentFiles(agent: string = DEFAULT_AGENT): Promise<number> {
+  const workspace = await resolveWorkspace(agent);
+  let count = 0;
+
+  for (const f of [...REQUIRED_FILES, ...OPTIONAL_FILES]) {
+    const target = join(workspace, f);
+    if (await exists(target)) {
+      await unlink(target);
+      count++;
+    }
+  }
+
+  const skillsDir = join(workspace, "skills");
+  if (await exists(skillsDir)) {
+    const files = await readdir(skillsDir);
+    for (const f of files) {
+      await unlink(join(skillsDir, f));
+      count++;
+    }
+    await rm(skillsDir, { recursive: true, force: true });
+  }
+
+  return count;
+}
+
+// ─── Status / detail ────────────────────────────────────────────────
+
+export async function getAgentStatus(personaId: string, agent: string = DEFAULT_AGENT): Promise<{
+  agent: InstalledAgentRecord;
+  fileHealth: { file: string; exists: boolean }[];
+  skillHealth: { skillId: string; installed: boolean }[];
+} | null> {
+  const record = await getInstalledAgent(personaId, agent);
+  if (!record) return null;
+
+  const workspace = await resolveWorkspace(agent);
+  const fileHealth: { file: string; exists: boolean }[] = [];
+  for (const f of record.files) {
+    const fp = join(workspace, f);
+    fileHealth.push({ file: f, exists: await exists(fp) });
+  }
+
+  const skillsDir = join(workspace, "skills");
+  const skillHealth: { skillId: string; installed: boolean }[] = [];
+  for (const sid of record.skills) {
+    const sp = join(skillsDir, `${sid}.md`);
+    skillHealth.push({ skillId: sid, installed: await exists(sp) });
+  }
+
+  return { agent: record, fileHealth, skillHealth };
+}
+
+// ─── Session cleanup ────────────────────────────────────────────────
+
+export async function clearSessions(agent: string = DEFAULT_AGENT): Promise<number> {
+  const sessDir = agentSessionsDir(agent);
+  const sessIndex = agentSessionsIndex(agent);
+  let count = 0;
+
+  if (await exists(sessDir)) {
+    const files = await readdir(sessDir);
+    for (const f of files) {
+      if (f.endsWith(".jsonl")) {
+        await unlink(join(sessDir, f));
+        count++;
+      }
+    }
+  }
+
+  if (await exists(sessIndex)) {
+    await writeFile(sessIndex, "{}", "utf-8");
+  }
+
+  return count;
+}