@clawtrail/init 2.7.1 → 2.10.0

package/dist/index.js

@@ -18,11 +18,13 @@ import JSON5 from "json5";
 import { execSync } from "child_process";
 var SKILL_FILES = {
   SKILL: "https://api.clawtrail.ai/ct/api/skill/clawtrail.md",
-  HEARTBEAT: "https://api.clawtrail.ai/ct/api/skill/HEARTBEAT.md"
+  HEARTBEAT: "https://api.clawtrail.ai/ct/api/skill/HEARTBEAT.md",
+  MESSAGING: "https://api.clawtrail.ai/ct/api/skill/MESSAGING.md"
 };
 var STAGING_SKILL_FILES = {
   SKILL: "https://sapi.clawtrail.ai/ct/api/skill/clawtrail.md",
-  HEARTBEAT: "https://sapi.clawtrail.ai/ct/api/skill/HEARTBEAT.md"
+  HEARTBEAT: "https://sapi.clawtrail.ai/ct/api/skill/HEARTBEAT.md",
+  MESSAGING: "https://sapi.clawtrail.ai/ct/api/skill/MESSAGING.md"
 };
 var MAX_RETRIES = 3;
 var RETRY_DELAYS = [1e3, 3e3, 5e3];
@@ -69,6 +71,11 @@ async function downloadSkillFiles(targetDir, staging = false) {
       url: files.HEARTBEAT,
       dest: path.join(targetDir, "HEARTBEAT.md"),
       name: "HEARTBEAT.md"
+    },
+    {
+      url: files.MESSAGING,
+      dest: path.join(targetDir, "MESSAGING.md"),
+      name: "MESSAGING.md"
     }
   ];
   const results = await Promise.allSettled(
@@ -97,7 +104,53 @@ async function downloadSkillFiles(targetDir, staging = false) {
   }
   return { succeeded, failed };
 }
-async function installContextGraph(staging, agentId, apiKey) {
+async function detectOpenClawAgents() {
+  const openclawDir = path.join(os.homedir(), ".openclaw");
+  const agents = [];
+  try {
+    const configPath = path.join(openclawDir, "openclaw.json");
+    const raw = await fs.readFile(configPath, "utf-8");
+    const config = JSON5.parse(raw);
+    if (config.agents?.list && Array.isArray(config.agents.list)) {
+      for (const agent of config.agents.list) {
+        if (agent.id) {
+          agents.push({
+            id: agent.id,
+            workspace: agent.workspace || path.join(openclawDir, `workspace-${agent.id}`),
+            isDefault: !!agent.default
+          });
+        }
+      }
+    }
+  } catch {
+  }
+  if (agents.length === 0) {
+    try {
+      const agentsDir = path.join(openclawDir, "agents");
+      const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          const id = entry.name;
+          agents.push({
+            id,
+            workspace: id === "main" ? path.join(openclawDir, "workspace") : path.join(openclawDir, `workspace-${id}`),
+            isDefault: id === "main"
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  if (agents.length === 0) {
+    agents.push({
+      id: "main",
+      workspace: path.join(openclawDir, "workspace"),
+      isDefault: true
+    });
+  }
+  return agents;
+}
+async function installContextGraph(staging, agentId, apiKey, trackedAgents) {
   const spinner = ora("Setting up context-graph provenance...").start();
   const openclawDir = path.join(os.homedir(), ".openclaw");
   const extensionsDir = path.join(openclawDir, "extensions", "context-graph");
@@ -117,17 +170,29 @@ async function installContextGraph(staging, agentId, apiKey) {
     config.plugins ??= {};
     config.plugins.entries ??= {};
     const cgRoot = path.join(openclawDir, "workspace", ".context-graph");
+    const cgConfig = {
+      submitUrl: `${apiUrl}/context-graph/submit`,
+      autoSubmit: true,
+      detectHttp: true,
+      environment: staging ? "staging" : "production",
+      contextGraphRoot: cgRoot
+    };
+    if (trackedAgents && trackedAgents.length > 0) {
+      const agentsMap = {};
+      for (const ta of trackedAgents) {
+        agentsMap[ta.openclawId] = {
+          clawtrailId: ta.clawtrailId,
+          apiKey: ta.apiKey
+        };
+      }
+      cgConfig.agents = agentsMap;
+    } else {
+      cgConfig.agentId = agentId || void 0;
+      cgConfig.apiKey = apiKey || void 0;
+    }
     config.plugins.entries["context-graph"] = {
       enabled: true,
-      config: {
-        submitUrl: `${apiUrl}/context-graph/submit`,
-        agentId: agentId || void 0,
-        apiKey: apiKey || void 0,
-        autoSubmit: true,
-        detectHttp: true,
-        environment: staging ? "staging" : "production",
-        contextGraphRoot: cgRoot
-      }
+      config: cgConfig
     };
     await fs.writeFile(
       openclawConfigPath,
@@ -141,10 +206,10 @@ async function installContextGraph(staging, agentId, apiKey) {
   try {
     execSync("openclaw --version", { stdio: "pipe", timeout: 5e3 });
     try {
-      execSync(
-        "openclaw plugins install @clawtrail/context-graph-openclaw",
-        { stdio: "pipe", timeout: 12e4 }
-      );
+      execSync("openclaw plugins install @clawtrail/context-graph-openclaw", {
+        stdio: "pipe",
+        timeout: 12e4
+      });
       packagesInstalled = true;
     } catch (err) {
       installError = err.stderr?.toString().trim() || err.stdout?.toString().trim() || err.message || "Unknown error";
@@ -408,7 +473,9 @@ async function handleUninstall(staging) {
   const spinner1 = ora("Removing skill files...").start();
   const filesToRemove = [
     path.join(openclawDir, "workspace", "HEARTBEAT.md"),
-    path.join(openclawDir, "skills", skillFolder, "SKILL.md")
+    path.join(openclawDir, "workspace", "MESSAGING.md"),
+    path.join(openclawDir, "skills", skillFolder, "SKILL.md"),
+    path.join(os.homedir(), ".config", "clawtrail", "credentials.json")
   ];
   for (const filePath of filesToRemove) {
     try {
@@ -559,7 +626,7 @@ async function main() {
   const program = new Command();
   program.name("clawtrail-init").description(
     "Install ClawTrail skill files, configure heartbeat, and optionally register an agent"
-  ).version("2.7.0").option(
+  ).version("2.10.0").option(
     "-d, --dir <path>",
     "Download directory for skill files",
     "./clawtrail-skills"
@@ -579,6 +646,9 @@ async function main() {
   ).option("--no-restart", "Skip gateway restart after updating files").option(
     "--no-context-graph",
     "Skip context-graph provenance tracking installation"
+  ).option(
+    "--agent <id>",
+    "Track only this OpenClaw agent ID for context-graph (multi-agent mode)"
   ).option(
     "--uninstall",
     "Remove ClawTrail skill files, config, and restart gateway"
@@ -609,6 +679,11 @@ async function main() {
           dest: path.join(workspaceDir, "HEARTBEAT.md"),
           label: `~/.openclaw/workspace/HEARTBEAT.md`
         },
+        {
+          url: files.MESSAGING,
+          dest: path.join(workspaceDir, "MESSAGING.md"),
+          label: `~/.openclaw/workspace/MESSAGING.md`
+        },
         {
           url: files.SKILL,
           dest: path.join(skillsDir, "SKILL.md"),
@@ -674,6 +749,32 @@ async function main() {
       } catch {
       }
     }
+    if (agentId && apiKey) {
+      try {
+        const credDir = path.join(os.homedir(), ".config", "clawtrail");
+        const credPath = path.join(credDir, "credentials.json");
+        await ensureDirectory(credDir);
+        let exists = false;
+        try {
+          await fs.access(credPath);
+          exists = true;
+        } catch {
+        }
+        if (!exists) {
+          const creds = {
+            agentId,
+            apiKey,
+            verificationCode: verificationCode || void 0,
+            environment: env
+          };
+          await fs.writeFile(credPath, JSON.stringify(creds, null, 2), {
+            encoding: "utf-8",
+            mode: 384
+          });
+        }
+      } catch {
+      }
+    }
     let ocConfig;
     if (hasOpenClaw) {
       const spinner = ora("Configuring OpenClaw heartbeat...").start();
@@ -687,14 +788,53 @@ async function main() {
       }
     }
     let cgResult;
-    if (options.contextGraph !== false) {
+    const shouldInstallCG = options.contextGraph !== false && staging;
+    if (shouldInstallCG) {
+      const detectedAgents = await detectOpenClawAgents();
+      const targetAgentId = options.agent;
+      if (detectedAgents.length > 1) {
+        console.log(
+          chalk.cyan("\n  Detected OpenClaw agents:")
+        );
+        for (const a of detectedAgents) {
+          const marker = targetAgentId === a.id ? chalk.green(" \u2190 tracking") : a.isDefault ? chalk.gray(" (default)") : "";
+          console.log(chalk.white(`    \u2022 ${a.id}${marker}`));
+        }
+        if (!targetAgentId) {
+          console.log(
+            chalk.gray(
+              "\n  Tip: Use --agent <id> to track only a specific agent\n"
+            )
+          );
+        }
+      }
       try {
-        cgResult = await installContextGraph(staging, agentId, apiKey);
+        let trackedAgents;
+        if (targetAgentId && agentId && apiKey) {
+          trackedAgents = [
+            {
+              openclawId: targetAgentId,
+              clawtrailId: agentId,
+              apiKey
+            }
+          ];
+        }
+        cgResult = await installContextGraph(
+          staging,
+          agentId,
+          apiKey,
+          trackedAgents
+        );
+        if (targetAgentId) {
+          console.log(
+            chalk.green(
+              `  Context-graph tracking: only agent "${targetAgentId}"`
+            )
+          );
+        }
       } catch (err) {
         console.log(
-          chalk.yellow(
-            `  Context-graph setup skipped: ${err.message}`
-          )
+          chalk.yellow(`  Context-graph setup skipped: ${err.message}`)
         );
       }
     }
@@ -752,6 +892,9 @@ CLAWTRAIL_API_KEY=${apiKey}
     }
     if (agentId) {
       console.log(chalk.white("  Agent ID:     ") + chalk.cyan(agentId));
+      console.log(
+        chalk.white("  Credentials:  ") + chalk.cyan("~/.config/clawtrail/credentials.json")
+      );
     }
     if (verificationCode) {
       console.log(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawtrail/init",
-  "version": "2.7.1",
+  "version": "2.10.0",
   "description": "CLI installer for ClawTrail AI agent skill files",
   "main": "dist/index.js",
   "bin": {