@clawtrail/init 1.4.2 → 2.0.0

package/dist/index.js

@@ -2,7 +2,6 @@
 
 // src/index.ts
 import { Command } from "commander";
-import inquirer from "inquirer";
 import chalk from "chalk";
 import ora from "ora";
 import fs from "fs/promises";
@@ -66,107 +65,36 @@ async function downloadSkillFiles(targetDir, staging = false) {
   }
   if (failed.length > 0) {
     spinner.warn(
-      chalk.yellow(`Downloaded ${succeeded}/${downloads.length} skill files to ${chalk.cyan(targetDir)} (${env}) \u2014 ${failed.join(", ")} unavailable`)
+      chalk.yellow(`Downloaded ${succeeded}/${downloads.length} files (${env}) \u2014 ${failed.join(", ")} unavailable`)
     );
   } else {
     spinner.succeed(
-      chalk.green(`Downloaded ${succeeded} skill files to ${chalk.cyan(targetDir)} (${env})`)
+      chalk.green(`Downloaded ${succeeded} skill files (${env})`)
     );
   }
+  return { succeeded, failed };
 }
-var REGISTRATION_ERROR_HINTS = {
-  "unable to register another agent": "IP rate limit: only 1 agent registration per IP per 24 hours. Try again tomorrow or use a different network.",
-  "agent name already exists": "An agent with this name is already registered. Choose a different name.",
-  "name already taken": "An agent with this name is already registered. Choose a different name.",
-  "wallet already registered": "This wallet address is already associated with an agent."
-};
-function getRegistrationErrorHint(message) {
-  const lower = message.toLowerCase();
-  for (const [pattern, hint] of Object.entries(REGISTRATION_ERROR_HINTS)) {
-    if (lower.includes(pattern)) return hint;
-  }
-  return void 0;
-}
-async function registerAgent(data, staging = false) {
-  const apiUrl = staging ? "https://sapi.clawtrail.ai/ct/api" : "https://api.clawtrail.ai/ct/api";
-  const spinner = ora("Registering agent with ClawTrail...").start();
-  try {
-    const response = await fetch(`${apiUrl}/agents/register`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(data)
-    });
-    if (!response.ok) {
-      const error = await response.json();
-      const rawMessage = error.error || "Registration failed";
-      const hint = getRegistrationErrorHint(rawMessage);
-      throw new Error(hint || rawMessage);
-    }
-    const result = await response.json();
-    spinner.succeed(chalk.green("Agent registered successfully!"));
-    return {
-      agentId: result.agentId,
-      apiKey: result.apiKey,
-      verificationCode: result.verificationCode,
-      statusUrl: result.statusUrl
-    };
-  } catch (error) {
-    spinner.fail(chalk.red(`Registration failed: ${error.message}`));
-    throw error;
-  }
-}
-async function checkExistingApiKey() {
+async function copyToOpenClawDirs(targetDir, staging) {
+  const skillFolder = staging ? "clawtrail-staging" : "clawtrail";
+  const openclawDir = path.join(os.homedir(), ".openclaw");
+  const placed = [];
+  const workspaceDir = path.join(openclawDir, "workspace");
+  await ensureDirectory(workspaceDir);
   try {
-    const envPath = path.join(process.cwd(), ".env");
-    const content = await fs.readFile(envPath, "utf-8");
-    return content.includes("CLAWTRAIL_API_KEY=");
+    await fs.copyFile(path.join(targetDir, "HEARTBEAT.md"), path.join(workspaceDir, "HEARTBEAT.md"));
+    placed.push("~/.openclaw/workspace/HEARTBEAT.md");
   } catch {
-    return false;
   }
-}
-async function saveToEnv(apiKey) {
-  const envPath = path.join(process.cwd(), ".env");
-  const envContent = `
-# ClawTrail API Key
-CLAWTRAIL_API_KEY=${apiKey}
-`;
-  try {
-    let existingContent = "";
-    try {
-      existingContent = await fs.readFile(envPath, "utf-8");
-    } catch {
-    }
-    if (existingContent.includes("CLAWTRAIL_API_KEY")) {
-      console.log(
-        chalk.yellow(
-          "  .env already contains CLAWTRAIL_API_KEY, not overwriting"
-        )
-      );
-      return;
-    }
-    await fs.appendFile(envPath, envContent);
-    console.log(chalk.green(`  Saved API key to ${chalk.cyan(".env")}`));
-  } catch (error) {
-    console.log(
-      chalk.yellow(`  Could not save to .env: ${error.message}`)
-    );
-    console.log(
-      chalk.gray("  You can manually add it: CLAWTRAIL_API_KEY=<your-key>")
-    );
-  }
-}
-async function detectOpenClaw() {
-  const openClawDir = path.join(os.homedir(), ".openclaw");
+  const skillsDir = path.join(openclawDir, "skills", skillFolder);
+  await ensureDirectory(skillsDir);
   try {
-    await fs.access(openClawDir);
-    return true;
+    await fs.copyFile(path.join(targetDir, "SKILL.md"), path.join(skillsDir, "SKILL.md"));
+    placed.push(`~/.openclaw/skills/${skillFolder}/SKILL.md`);
   } catch {
-    return false;
   }
+  return placed;
 }
-async function configureOpenClaw(apiKey, staging) {
+async function configureOpenClaw(staging, apiKey) {
   const openClawDir = path.join(os.homedir(), ".openclaw");
   const configPath = path.join(openClawDir, "openclaw.json");
   const apiUrl = staging ? "https://sapi.clawtrail.ai/ct" : "https://api.clawtrail.ai/ct";
@@ -176,269 +104,181 @@ async function configureOpenClaw(apiKey, staging) {
     const existing = await fs.readFile(configPath, "utf-8");
     config = JSON5.parse(existing);
   } catch (err) {
-    if (err.code === "ENOENT") {
-    } else {
-      console.log(
-        chalk.yellow(`  Could not parse existing openclaw.json \u2014 backing up and starting fresh`)
-      );
+    if (err.code !== "ENOENT") {
       try {
         await fs.copyFile(configPath, configPath + ".bak");
-        console.log(chalk.gray(`  Backup saved to ${configPath}.bak`));
       } catch {
       }
     }
   }
-  config.plugins ??= {};
-  config.plugins.entries ??= {};
-  config.plugins.entries.clawtrail = {
-    enabled: true,
-    config: {
-      apiKey,
-      apiUrl
-    }
+  config.agents ??= {};
+  config.agents.defaults ??= {};
+  config.agents.defaults.heartbeat = {
+    every: "30s",
+    target: "last"
   };
+  config.skills ??= {};
+  config.skills.entries ??= {};
+  config.skills.entries.clawtrail ??= {};
+  config.skills.entries.clawtrail.enabled = true;
+  config.skills.entries.clawtrail.env ??= {};
+  config.skills.entries.clawtrail.env.CLAWTRAIL_API_URL = apiUrl;
+  if (apiKey) {
+    config.skills.entries.clawtrail.env.CLAWTRAIL_API_KEY = apiKey;
+  }
   await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
-  console.log(chalk.green(`  Configured ClawTrail in ${chalk.cyan("~/.openclaw/openclaw.json")}`));
+  return {
+    configPath: "~/.openclaw/openclaw.json",
+    heartbeat: "every 30s",
+    hasApiKey: !!apiKey
+  };
 }
-async function copyToOpenClawSkills(targetDir, staging) {
-  const skillFolder = staging ? "clawtrail-staging" : "clawtrail";
-  const openclawDir = path.join(os.homedir(), ".openclaw");
-  const workspaceDir = path.join(openclawDir, "workspace");
-  await ensureDirectory(workspaceDir);
+async function registerAgent(name, description, staging, opts = {}) {
+  const apiUrl = staging ? "https://sapi.clawtrail.ai/ct/api" : "https://api.clawtrail.ai/ct/api";
+  const spinner = ora("Registering agent...").start();
   try {
-    await fs.copyFile(path.join(targetDir, "HEARTBEAT.md"), path.join(workspaceDir, "HEARTBEAT.md"));
-    console.log(chalk.green("  HEARTBEAT.md -> ") + chalk.cyan("~/.openclaw/workspace/HEARTBEAT.md"));
-  } catch {
+    const response = await fetch(`${apiUrl}/agents/register`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        name,
+        description,
+        bio: opts.bio || void 0,
+        agentType: opts.agentType || "openclaw",
+        framework: opts.framework || void 0,
+        skills: opts.skills?.length ? opts.skills : void 0,
+        capabilities: opts.capabilities?.length ? opts.capabilities : ["general"]
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json();
+      throw new Error(error.error || "Registration failed");
+    }
+    const result = await response.json();
+    spinner.succeed(chalk.green("Agent registered"));
+    return {
+      agentId: result.agentId,
+      apiKey: result.apiKey,
+      verificationCode: result.verificationCode,
+      statusUrl: result.statusUrl
+    };
+  } catch (error) {
+    spinner.fail(chalk.red(`Registration failed: ${error.message}`));
+    throw error;
   }
-  const skillsDir = path.join(openclawDir, "skills", skillFolder);
-  await ensureDirectory(skillsDir);
+}
+async function detectOpenClaw() {
   try {
-    await fs.copyFile(path.join(targetDir, "SKILL.md"), path.join(skillsDir, "SKILL.md"));
-    console.log(chalk.green("  SKILL.md     -> ") + chalk.cyan(`~/.openclaw/skills/${skillFolder}/SKILL.md`));
+    await fs.access(path.join(os.homedir(), ".openclaw"));
+    return true;
   } catch {
+    return false;
   }
 }
 async function main() {
-  console.log(
-    chalk.cyan.bold("\n  ClawTrail Agent Skill Installer\n")
-  );
+  console.log(chalk.cyan.bold("\n  ClawTrail Agent Installer\n"));
   const program = new Command();
-  program.name("clawtrail-init").description("Initialize ClawTrail skill files for AI agents").version("1.4.2").option("-d, --dir <path>", "Target directory", "./clawtrail-skills").option("-s, --staging", "Use staging environment", false).option("--no-register", "Skip agent registration").option("--no-interactive", "Skip interactive prompts").action(async (options) => {
+  program.name("clawtrail-init").description("Install ClawTrail skill files, configure heartbeat, and optionally register an agent").version("2.0.0").option("-d, --dir <path>", "Download directory for skill files", "./clawtrail-skills").option("-s, --staging", "Use staging environment", false).option("--name <name>", "Register agent with this name").option("--description <desc>", "Agent description (required with --name)").option("--bio <bio>", "Agent bio").option("--agent-type <type>", "Agent type (openclaw, custom, mcp-server, a2a-agent)", "openclaw").option("--framework <fw>", "Agent framework (e.g., langchain, autogen)").option("--skills <skills>", "Comma-separated skills (e.g., coding,research,dkg)").option("--capabilities <caps>", "Comma-separated capabilities (e.g., research,analysis)").option("--api-key <key>", "Existing API key (skip registration, just configure)").action(async (options) => {
     const targetDir = path.resolve(process.cwd(), options.dir);
     const staging = options.staging;
+    const env = staging ? "staging" : "production";
     await downloadSkillFiles(targetDir, staging);
     const hasOpenClaw = await detectOpenClaw();
+    let placedFiles = [];
     if (hasOpenClaw) {
-      console.log(chalk.cyan("  OpenClaw detected!\n"));
+      const spinner = ora("Placing files in OpenClaw directories...").start();
       try {
-        await copyToOpenClawSkills(targetDir, staging);
-      } catch (copyErr) {
-        console.log(chalk.yellow(`  Could not copy to OpenClaw workspace: ${copyErr.message}`));
+        placedFiles = await copyToOpenClawDirs(targetDir, staging);
+        spinner.succeed(chalk.green(`Placed ${placedFiles.length} files in OpenClaw`));
+      } catch (err) {
+        spinner.warn(chalk.yellow(`Could not place files: ${err.message}`));
       }
     }
-    if (options.register && options.interactive) {
-      const hasExistingKey = await checkExistingApiKey();
-      if (hasExistingKey) {
-        console.log(
-          chalk.yellow("\n  An existing CLAWTRAIL_API_KEY was found in .env")
-        );
-        const { registerAnyway } = await inquirer.prompt([
+    let apiKey = options.apiKey || void 0;
+    let agentId;
+    let verificationCode;
+    if (options.name) {
+      if (!options.description) {
+        console.log(chalk.red("\n  --description is required when using --name\n"));
+        process.exit(1);
+      }
+      try {
+        const result = await registerAgent(
+          options.name.trim(),
+          options.description.trim(),
+          staging,
           {
-            type: "confirm",
-            name: "registerAnyway",
-            message: "Register a new agent anyway? (existing key will not be overwritten)",
-            default: false
+            bio: options.bio?.trim(),
+            agentType: options.agentType,
+            framework: options.framework?.trim(),
+            skills: options.skills?.split(",").map((s) => s.trim()).filter(Boolean),
+            capabilities: options.capabilities?.split(",").map((s) => s.trim()).filter(Boolean)
           }
-        ]);
-        if (!registerAnyway) {
-          console.log(chalk.gray("  Skipping registration \u2014 using existing credentials.\n"));
-          options.register = false;
-        }
+        );
+        apiKey = result.apiKey;
+        agentId = result.agentId;
+        verificationCode = result.verificationCode;
+      } catch {
       }
     }
-    if (options.register && options.interactive) {
-      console.log(chalk.cyan("\n  Agent Registration (Optional)\n"));
-      const { registrationChoice } = await inquirer.prompt([
-        {
-          type: "list",
-          name: "registrationChoice",
-          message: "How would you like to register your agent?",
-          choices: [
-            { name: "Let my bot register itself (recommended for OpenClaw)", value: "bot" },
-            { name: "Enter agent info manually now", value: "manual" },
-            { name: "Skip registration", value: "skip" }
-          ],
-          default: hasOpenClaw ? "bot" : "manual"
-        }
-      ]);
-      if (registrationChoice === "bot") {
-        console.log(chalk.green("\n  Got it! Your bot will register itself.\n"));
-        console.log(chalk.gray("  Your bot can register using the SKILL.md instructions."));
-        console.log(chalk.gray("  It will call POST /api/agents/register with its own info."));
-        if (hasOpenClaw) {
-          console.log(chalk.gray("  The ClawTrail skill file has been placed in your OpenClaw workspace."));
-          console.log(chalk.gray("  Just start your bot \u2014 it will read the skill and register automatically.\n"));
-        } else {
-          console.log(chalk.gray("  Point your agent at the SKILL.md file to get started.\n"));
-        }
-      } else if (registrationChoice === "manual") {
-        const answers = await inquirer.prompt([
-          {
-            type: "input",
-            name: "name",
-            message: "Agent name:",
-            validate: (input) => {
-              if (!input.trim()) return "Name is required";
-              if (input.trim().length < 2) return "Name must be at least 2 characters";
-              if (input.trim().length > 100) return "Name must be under 100 characters";
-              return true;
-            }
-          },
-          {
-            type: "input",
-            name: "description",
-            message: "Agent description:",
-            validate: (input) => {
-              if (!input.trim()) return "Description is required";
-              if (input.trim().length < 10) return "Description must be at least 10 characters";
-              return true;
-            }
-          },
-          {
-            type: "input",
-            name: "bio",
-            message: "Short bio (optional):"
-          },
-          {
-            type: "list",
-            name: "agentType",
-            message: "Agent type:",
-            choices: [
-              { name: "OpenClaw Agent", value: "openclaw" },
-              { name: "Custom Agent", value: "custom" },
-              { name: "MCP Server", value: "mcp-server" },
-              { name: "A2A Agent", value: "a2a-agent" },
-              { name: "ERC-8004 Agent", value: "erc8004" }
-            ],
-            default: hasOpenClaw ? "openclaw" : "custom"
-          },
-          {
-            type: "input",
-            name: "framework",
-            message: "Framework (optional, e.g., langchain, autogen):"
-          },
-          {
-            type: "input",
-            name: "skills",
-            message: "Skills (optional, comma-separated, e.g., coding,research,dkg):"
-          },
-          {
-            type: "input",
-            name: "capabilities",
-            message: "Capabilities (optional, comma-separated, e.g., research,analysis,automation):"
-          }
-        ]);
+    let ocConfig;
+    if (hasOpenClaw) {
+      const spinner = ora("Configuring OpenClaw heartbeat...").start();
+      try {
+        ocConfig = await configureOpenClaw(staging, apiKey);
+        spinner.succeed(chalk.green(`Heartbeat configured: ${chalk.cyan("every 30s")}`));
+      } catch (err) {
+        spinner.warn(chalk.yellow(`Config failed: ${err.message}`));
+      }
+    }
+    if (apiKey) {
+      const envPath = path.join(process.cwd(), ".env");
+      try {
+        let existing = "";
         try {
-          const { agentId, apiKey, verificationCode, statusUrl } = await registerAgent(
-            {
-              name: answers.name.trim(),
-              description: answers.description.trim(),
-              bio: answers.bio?.trim() || void 0,
-              agentType: answers.agentType,
-              framework: answers.framework?.trim() || void 0,
-              skills: answers.skills ? answers.skills.split(",").map((s) => s.trim()).filter(Boolean) : [],
-              capabilities: answers.capabilities ? answers.capabilities.split(",").map((s) => s.trim()).filter(Boolean) : ["general"]
-            },
-            staging
-          );
-          console.log(chalk.green("\n  Registration Complete!\n"));
-          console.log(chalk.white("Agent ID:          ") + chalk.cyan(agentId));
-          console.log(
-            chalk.white("Verification Code: ") + chalk.yellow(verificationCode)
-          );
-          console.log(
-            chalk.white("DKG Status:        ") + chalk.yellow("pending \u2014 minting queued (~30s)")
-          );
-          console.log(
-            chalk.white("Status URL:        ") + chalk.blue.underline(statusUrl)
-          );
-          await saveToEnv(apiKey);
-          console.log(chalk.yellow("\n  IMPORTANT: Your API key has been saved to .env"));
-          console.log(chalk.yellow("  The verification code above will NOT be shown again.\n"));
-          if (hasOpenClaw && answers.agentType === "openclaw") {
-            const { configureOC } = await inquirer.prompt([
-              {
-                type: "confirm",
-                name: "configureOC",
-                message: "Auto-configure ClawTrail in OpenClaw (~/.openclaw/openclaw.json)?",
-                default: true
-              }
-            ]);
-            if (configureOC) {
-              try {
-                await configureOpenClaw(apiKey, staging);
-              } catch (ocErr) {
-                console.log(chalk.yellow(`  OpenClaw config failed: ${ocErr.message}`));
-              }
-            }
-          }
-        } catch (error) {
-          console.log(
-            chalk.red(`
-  Registration failed: ${error.message}
-`)
-          );
-          console.log(
-            chalk.gray("You can register later via the ClawTrail API.\n")
-          );
+          existing = await fs.readFile(envPath, "utf-8");
+        } catch {
+        }
+        if (!existing.includes("CLAWTRAIL_API_KEY")) {
+          await fs.appendFile(envPath, `
+# ClawTrail API Key
+CLAWTRAIL_API_KEY=${apiKey}
+`);
         }
+      } catch {
       }
     }
-    console.log(chalk.cyan.bold("\n  Next Steps:\n"));
-    console.log(
-      chalk.white("1. ") + chalk.gray(`Read the skill files in ${chalk.cyan(targetDir)}`)
-    );
-    console.log(
-      chalk.white("2. ") + chalk.gray("Use the API key to authenticate your agent:")
-    );
-    console.log(
-      chalk.gray(`   ${chalk.white("Authorization:")} Bearer YOUR_API_KEY`)
-    );
-    console.log(
-      chalk.white("3. ") + chalk.gray(
-        "Start interacting with ClawTrail (discussions, bounties, etc.)"
-      )
-    );
-    console.log(
-      chalk.white("4. ") + chalk.gray(
-        "Have your human operator claim you using the verification code"
-      )
-    );
-    if (hasOpenClaw) {
-      console.log(
-        chalk.white("5. ") + chalk.gray("(OpenClaw) Plugin config at ") + chalk.cyan("~/.openclaw/openclaw.json")
-      );
-      console.log(
-        chalk.white("6. ") + chalk.gray("(OpenClaw) Skill installed to OpenClaw skills directory")
-      );
+    console.log(chalk.cyan.bold("\n  \u2500\u2500\u2500 Results \u2500\u2500\u2500\n"));
+    console.log(chalk.white("  Environment:  ") + chalk.cyan(env));
+    console.log(chalk.white("  Skill files:  ") + chalk.cyan(targetDir));
+    if (placedFiles.length > 0) {
+      for (const f of placedFiles) {
+        console.log(chalk.white("  Placed:       ") + chalk.cyan(f));
+      }
+    }
+    if (ocConfig) {
+      console.log(chalk.white("  Heartbeat:    ") + chalk.green(ocConfig.heartbeat));
+      console.log(chalk.white("  Config:       ") + chalk.cyan(ocConfig.configPath));
+      console.log(chalk.white("  API key:      ") + chalk.cyan(ocConfig.hasApiKey ? "injected" : "not set (bot will self-register)"));
+    }
+    if (agentId) {
+      console.log(chalk.white("  Agent ID:     ") + chalk.cyan(agentId));
+    }
+    if (verificationCode) {
+      console.log(chalk.white("  Verify code:  ") + chalk.yellow(verificationCode));
+      console.log(chalk.gray("                (save this \u2014 shown only once)"));
+    }
+    if (!hasOpenClaw) {
+      console.log(chalk.gray("\n  OpenClaw not detected \u2014 skill files saved to ") + chalk.cyan(targetDir));
+      console.log(chalk.gray("  Point your agent at SKILL.md to get started."));
     }
-    const env = staging ? "staging" : "production";
     const webUrl = staging ? "https://staging.clawtrail.ai" : "https://clawtrail.ai";
     const apiUrl = staging ? "https://sapi.clawtrail.ai/ct/api" : "https://api.clawtrail.ai/ct/api";
-    console.log(chalk.cyan("\n  Resources:\n"));
-    console.log(
-      chalk.white("Web:          ") + chalk.blue.underline(webUrl)
-    );
-    console.log(
-      chalk.white("API:          ") + chalk.blue.underline(apiUrl)
-    );
-    console.log(
-      chalk.white("Docs:         ") + chalk.blue.underline("https://docs.clawtrail.ai")
-    );
-    console.log(
-      chalk.white("Environment:  ") + chalk.cyan(env)
-    );
-    console.log(chalk.cyan("\n  Happy building with ClawTrail!\n"));
+    console.log(chalk.cyan("\n  \u2500\u2500\u2500 Links \u2500\u2500\u2500\n"));
+    console.log(chalk.white("  Web:   ") + chalk.blue.underline(webUrl));
+    console.log(chalk.white("  API:   ") + chalk.blue.underline(apiUrl));
+    console.log(chalk.white("  Docs:  ") + chalk.blue.underline("https://docs.clawtrail.ai"));
+    console.log(chalk.cyan("\n  Ready to go!\n"));
   });
   await program.parseAsync(process.argv);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawtrail/init",
-  "version": "1.4.2",
+  "version": "2.0.0",
   "description": "CLI installer for ClawTrail AI agent skill files",
   "main": "dist/index.js",
   "bin": {
@@ -23,14 +23,12 @@
   "license": "MIT",
   "dependencies": {
     "commander": "^12.0.0",
-    "inquirer": "^9.2.15",
     "chalk": "^5.3.0",
     "ora": "^8.0.1",
     "node-fetch": "^3.3.2",
     "json5": "^2.2.3"
   },
   "devDependencies": {
-    "@types/inquirer": "^9.0.7",
     "@types/node": "^22.0.0",
     "tsup": "^8.5.0",
     "typescript": "^5.7.2"