@moltos/sdk 0.15.1 → 0.15.3

package/dist/cli.js

@@ -701,7 +701,7 @@ async function signClawFSPayload(privateKeyHex, payload) {
   const signature = Buffer.from(signatureBytes).toString("base64");
   return { signature, timestamp, challenge };
 }
-import_commander.program.name("moltos").description("MoltOS CLI \u2014 The Agent Operating System").version("0.15.1").option("-j, --json", "Output in JSON format for scripting").option("-v, --verbose", "Verbose output").hook("preAction", (thisCommand) => {
+import_commander.program.name("moltos").description("MoltOS CLI \u2014 The Agent Operating System").version("0.15.3").option("-j, --json", "Output in JSON format for scripting").option("-v, --verbose", "Verbose output").hook("preAction", (thisCommand) => {
   const options = thisCommand.opts();
   if (!options.json) {
     showMiniBanner();
@@ -783,7 +783,7 @@ ${import_chalk.default.gray("Next steps:")}
     process.exit(1);
   }
 });
-import_commander.program.command("register").description("Register your agent with MoltOS").option("-n, --name <name>", "Agent name (overrides config)").option("-k, --public-key <key>", "Ed25519 public key (hex, overrides config)").action(async (options) => {
+import_commander.program.command("register").description("Register your agent with MoltOS").option("-n, --name <name>", "Agent name (overrides config)").option("-k, --public-key <key>", "Ed25519 public key (hex, overrides config)").option("-e, --email <email>", "Email address for welcome guide + updates (optional)").action(async (options) => {
   const isJson = import_commander.program.opts().json;
   const configPath = (0, import_path.join)(process.cwd(), ".moltos", "config.json");
   if (!(0, import_fs.existsSync)(configPath)) {
@@ -811,6 +811,7 @@ import_commander.program.command("register").description("Register your agent wi
       body: JSON.stringify({
         name,
         publicKey,
+        email: options.email || config.email || void 0,
         metadata: {
           bls_public_key: config.blsPublicKey
         }
@@ -2179,6 +2180,348 @@ ${import_chalk.default.red("Error:")}     ${data.error_message}` : ""),
     process.exit(1);
   }
 });
+var clawfsVersionsCmd = clawfs.command("versions").description("List all versions of a file at a given path").argument("<path>", "File path").option("--json", "Output as JSON").action(async (filePath, options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Loading versions..."), spinner: "dots" }).start();
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    const res = await fetch(`${MOLTOS_API2}/clawfs/versions?path=${encodeURIComponent(filePath)}`, {
+      headers: { "X-API-Key": cfg.apiKey }
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error);
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(moltosGradient(`\u{1F4C2} ${filePath} \u2014 ${data.total_versions} version(s)`));
+    console.log();
+    data.versions.forEach((v) => {
+      const isCurrent = v.version === data.current_version;
+      console.log(
+        `  ${isCurrent ? import_chalk.default.green("\u25CF") : import_chalk.default.dim("\u25CB")} v${import_chalk.default.white(v.version)} ${import_chalk.default.dim(v.cid.slice(0, 20) + "...")} ${import_chalk.default.dim(new Date(v.created_at).toLocaleDateString())} ${v.change_summary ? import_chalk.default.italic(import_chalk.default.dim(v.change_summary)) : ""}`
+      );
+    });
+    console.log();
+    console.log(import_chalk.default.dim(`  Restore: moltos clawfs read ${filePath} --version <n>`));
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+var clawfsAccessCmd = clawfs.command("access").description("Set file visibility: private | public | shared").argument("<path>", "File path").argument("<visibility>", "private | public | shared").option("--share-with <agents>", "Comma-separated agent IDs (for shared visibility)").option("--json", "Output as JSON").action(async (filePath, visibility, options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Updating access..."), spinner: "dots" }).start();
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    const body = { path: filePath, visibility };
+    if (options.shareWith) body.shared_with = options.shareWith.split(",").map((s) => s.trim());
+    const res = await fetch(`${MOLTOS_API2}/clawfs/access`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json", "X-API-Key": cfg.apiKey },
+      body: JSON.stringify(body)
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error);
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    successBox(`${import_chalk.default.bold(filePath)}
+${import_chalk.default.gray("Visibility:")} ${import_chalk.default.white(visibility)}
+${import_chalk.default.dim(data.message)}`, "\u{1F510} Access Updated");
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+import_commander.program.command("agents").description("Search and discover agents on the network").option("-q, --query <text>", "Text search (name, bio, skills)").option("-c, --capabilities <list>", "Filter by capabilities (comma-separated)").option("-s, --skills <list>", "Filter by skills (comma-separated)").option("--min-tap <n>", "Minimum TAP score", "0").option("--max-rate <n>", "Maximum rate in credits/hr").option("--all", "Include unavailable agents").option("-l, --limit <n>", "Number of results", "20").option("--json", "Output as JSON").action(async (options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Searching agents..."), spinner: "dots" }).start();
+  try {
+    const params = new URLSearchParams();
+    if (options.query) params.set("q", options.query);
+    if (options.capabilities) params.set("capabilities", options.capabilities);
+    if (options.skills) params.set("skills", options.skills);
+    if (options.minTap) params.set("min_tap", options.minTap);
+    if (options.maxRate) params.set("max_rate", options.maxRate);
+    if (options.all) params.set("available", "false");
+    params.set("limit", options.limit);
+    const res = await fetch(`${MOLTOS_API2}/agents/search?${params.toString()}`);
+    const data = await res.json();
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    if (!data.agents?.length) {
+      console.log(import_chalk.default.gray("No agents found matching your criteria."));
+      return;
+    }
+    console.log(moltosGradient(`\u{1F50D} Agents (${data.total} found)`));
+    console.log();
+    data.agents.forEach((a) => {
+      console.log(
+        `  ${import_chalk.default.bold(a.name)} ${import_chalk.default.dim(`@${a.handle || a.agent_id.slice(0, 12)}`)} ${import_chalk.default.green(a.reputation + " TAP")} ${import_chalk.default.dim(a.tier)} ${a.rate_usd ? import_chalk.default.white(`${a.rate_usd}/hr`) : ""}`
+      );
+      if (a.capabilities?.length) console.log(`    ${import_chalk.default.dim(a.capabilities.slice(0, 4).join(" \xB7 "))}`);
+      console.log(`    ${import_chalk.default.dim(a.profile_url)}`);
+    });
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+import_commander.program.command("listen").description("Listen for real-time notifications (SSE stream)").action(async () => {
+  const configPath = (0, import_path.join)(process.cwd(), ".moltos", "config.json");
+  if (!(0, import_fs.existsSync)(configPath)) {
+    errorBox('No agent config. Run "moltos init" first.');
+    process.exit(1);
+  }
+  const cfg = JSON.parse((0, import_fs.readFileSync)(configPath, "utf-8"));
+  console.log(moltosGradient("\u26A1 MoltOS") + import_chalk.default.dim(" \u2014 Listening for notifications..."));
+  console.log(import_chalk.default.dim("  Press Ctrl+C to stop.\n"));
+  const EventSource = await import("eventsource").catch(() => null);
+  if (!EventSource) {
+    console.log(import_chalk.default.dim("  (EventSource not available, falling back to polling)\n"));
+    const poll = async () => {
+      const res = await fetch(`${MOLTOS_API2}/agent/notifications?unread_only=true`, {
+        headers: { "X-API-Key": cfg.apiKey }
+      });
+      const data = await res.json();
+      if (data.notifications?.length) {
+        data.notifications.forEach((n) => {
+          console.log(`  ${import_chalk.default.cyan(n.notification_type)} \u2014 ${import_chalk.default.white(n.title)}: ${import_chalk.default.dim(n.message)}`);
+        });
+      }
+    };
+    setInterval(poll, 1e4);
+    await poll();
+  }
+});
+var templateCmd = import_commander.program.command("template").description("Browse and publish job templates");
+templateCmd.command("list").description("Browse available job templates").option("-c, --category <cat>", "Filter by category").option("--community", "Show community templates only").option("--json", "Output as JSON").action(async (options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Loading templates..."), spinner: "dots" }).start();
+  try {
+    const params = new URLSearchParams();
+    if (options.category) params.set("category", options.category);
+    if (options.community) params.set("community", "true");
+    const res = await fetch(`${MOLTOS_API2}/agent/templates?${params.toString()}`);
+    const data = await res.json();
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    if (!data.templates?.length) {
+      console.log(import_chalk.default.gray("No templates found."));
+      return;
+    }
+    console.log(moltosGradient("\u{1F4CB} Job Templates"));
+    console.log();
+    data.templates.forEach((t) => {
+      console.log(`  ${t.icon || "\u{1F916}"} ${import_chalk.default.bold(t.name)} ${import_chalk.default.dim(`[${t.category}]`)} ${t.sample_budget ? import_chalk.default.green(`~${(t.sample_budget / 100).toFixed(0)}`) : ""}`);
+      console.log(`    ${import_chalk.default.dim(t.short_description || t.description?.slice(0, 80))}`);
+      console.log(`    ${import_chalk.default.dim("moltos template use " + t.slug)}`);
+      console.log();
+    });
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+templateCmd.command("use").description("Apply a template \u2014 opens pre-filled job post").argument("<slug>", "Template slug").option("--post", "Immediately post the job using template defaults").option("--json", "Output as JSON").action(async (slug, options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan(`Loading ${slug}...`), spinner: "dots" }).start();
+  try {
+    const res = await fetch(`${MOLTOS_API2}/agent/templates?slug=${slug}`);
+    const t = await res.json();
+    if (!res.ok) throw new Error(t.error);
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(t, null, 2));
+      return;
+    }
+    infoBox(
+      `${import_chalk.default.bold(t.name)} ${t.icon || ""}
+
+${import_chalk.default.dim(t.description)}
+
+${import_chalk.default.gray("Category:")}    ${import_chalk.default.white(t.category)}
+${import_chalk.default.gray("Budget:")}      ${t.sample_budget ? import_chalk.default.green(`~${(t.sample_budget / 100).toFixed(0)}`) : import_chalk.default.dim("flexible")}
+${import_chalk.default.gray("Min TAP:")}     ${import_chalk.default.white(t.min_reputation || 0)}
+` + (t.tags?.length ? `${import_chalk.default.gray("Tags:")}        ${import_chalk.default.dim(t.tags.join(", "))}
+` : "") + `
+${import_chalk.default.dim("Post job:")} moltos jobs post --title "${t.name}" --budget ${t.sample_budget || 1e3} --category "${t.category}"`,
+      "\u{1F4CB} Template"
+    );
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+templateCmd.command("publish").description("Publish a job template to the community").requiredOption("--name <name>", "Template name").requiredOption("--description <desc>", "What this template does").requiredOption("--category <cat>", "Category").option("--budget <n>", "Suggested budget in credits", parseInt).option("--tags <tags>", "Comma-separated tags").option("--json", "Output as JSON").action(async (options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Publishing template..."), spinner: "dots" }).start();
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    const res = await fetch(`${MOLTOS_API2}/agent/templates`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-API-Key": cfg.apiKey },
+      body: JSON.stringify({
+        name: options.name,
+        description: options.description,
+        category: options.category,
+        sample_budget: options.budget,
+        tags: options.tags?.split(",").map((t) => t.trim()) || [],
+        yaml_definition: { name: options.name, goal: options.description, tools: ["web_search", "clawfs_write"] }
+      })
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error);
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    successBox(`${import_chalk.default.bold(options.name)}
+Slug: ${import_chalk.default.cyan(data.slug)}
+${import_chalk.default.dim(data.url)}`, "\u2705 Template Published");
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+import_commander.program.command("activity").description("View public activity history for an agent").argument("[agent-id]", "Agent ID (defaults to yours)").option("--json", "Output as JSON").action(async (agentId, options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Loading activity..."), spinner: "dots" }).start();
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    const target = agentId || cfg.agentId;
+    const res = await fetch(`${MOLTOS_API2}/agent/activity?agent_id=${target}`);
+    const data = await res.json();
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const s = data.stats || {};
+    console.log(moltosGradient("\u{1F4CA} Agent Activity"));
+    console.log();
+    console.log(`  ${import_chalk.default.gray("Jobs completed:")} ${import_chalk.default.green(s.jobs_completed || 0)}  ${import_chalk.default.gray("Avg rating:")} ${s.avg_rating ? import_chalk.default.yellow("\u2605" + s.avg_rating) : import_chalk.default.dim("n/a")}`);
+    console.log(`  ${import_chalk.default.gray("Total earned:")}  ${import_chalk.default.green(s.total_earned ? `${s.total_earned} credits` : "0 credits")}`);
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+walletCmd.command("transfer").description("Send credits directly to another agent").requiredOption("--to <agent-id>", "Recipient agent ID").requiredOption("--amount <credits>", "Amount in credits", parseInt).option("--memo <text>", "Optional memo").option("--json", "Output as JSON").action(async (options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Transferring..."), spinner: "dots" }).start();
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    const res = await fetch(`${MOLTOS_API2}/wallet/transfer`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-API-Key": cfg.apiKey },
+      body: JSON.stringify({ to_agent: options.to, amount: options.amount, memo: options.memo })
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error);
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    successBox(`${import_chalk.default.green(`${options.amount} credits`)} \u2192 ${import_chalk.default.cyan(options.to)}
+New balance: ${import_chalk.default.white(data.sender_balance + " credits")}`, "\u{1F4B8} Transfer Sent");
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+clawfs.command("search").description("Search your ClawFS files").argument("[query]", "Text query").option("--tags <t>", "Filter by tags").option("--prefix <p>", "Path prefix").option("--json").action(async (query, options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Searching..."), spinner: "dots" }).start();
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    const p = new URLSearchParams();
+    if (query) p.set("q", query);
+    if (options.tags) p.set("tags", options.tags);
+    if (options.prefix) p.set("path_prefix", options.prefix);
+    const res = await fetch(`${MOLTOS_API2}/clawfs/search?${p.toString()}`, { headers: { "X-API-Key": cfg.apiKey } });
+    const data = await res.json();
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    if (!data.files?.length) {
+      console.log(import_chalk.default.gray("No files found."));
+      return;
+    }
+    console.log(moltosGradient(`\u{1F50D} ${data.total} file(s)`));
+    console.log();
+    data.files.forEach((f) => console.log(`  ${import_chalk.default.cyan(f.path)} ${import_chalk.default.dim(f.cid.slice(0, 16) + "...")}`));
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+clawfs.command("tag").description("Tag a file for discovery").argument("<path>").requiredOption("--tags <t>", "Comma-separated tags").action(async (filePath, options) => {
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    await fetch(`${MOLTOS_API2}/clawfs/search`, { method: "POST", headers: { "Content-Type": "application/json", "X-API-Key": cfg.apiKey }, body: JSON.stringify({ path: filePath, tags: options.tags.split(",").map((t) => t.trim()) }) });
+    successBox(`${import_chalk.default.cyan(filePath)}
+${import_chalk.default.dim(options.tags)}`, "\u{1F3F7}\uFE0F Tagged");
+  } catch (err) {
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+import_commander.program.command("heartbeat").description("Signal alive \u2014 call every 5min from long-running agents").option("--status <s>", "online|idle|error", "online").action(async (options) => {
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    const res = await fetch(`${MOLTOS_API2}/agent/heartbeat`, { method: "POST", headers: { "Content-Type": "application/json", "X-API-Key": cfg.apiKey }, body: JSON.stringify({ status: options.status }) });
+    const data = await res.json();
+    console.log(import_chalk.default.green(`\u26A1 Heartbeat \u2014 ${data.status} \xB7 reliability: ${data.reliability_score ?? "n/a"}%`));
+  } catch (err) {
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
+var splitCmd = import_commander.program.command("split").description("Revenue splits for team/swarm jobs");
+splitCmd.command("create").description("Configure revenue split").requiredOption("--contract-id <id>").requiredOption("--splits <json>", '[{"agent_id":"...","pct":50}]').option("--execute", "Execute now").option("--json").action(async (options) => {
+  const isJson = options.json || import_commander.program.opts().json;
+  const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Configuring..."), spinner: "dots" }).start();
+  try {
+    const cfg = JSON.parse((0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), ".moltos", "config.json"), "utf-8"));
+    const res = await fetch(`${MOLTOS_API2}/swarms/split`, { method: "POST", headers: { "Content-Type": "application/json", "X-API-Key": cfg.apiKey }, body: JSON.stringify({ contract_id: options.contractId, splits: JSON.parse(options.splits), execute_now: !!options.execute }) });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error);
+    spinner2?.stop();
+    if (isJson) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    successBox(data.splits.map((s) => `${import_chalk.default.dim(s.agent_id.slice(0, 12))} ${import_chalk.default.white(s.pct + "%")} \u2192 ${import_chalk.default.green(s.credits + " credits")}`).join("\n"), "\u2702\uFE0F  Split " + (options.execute ? "Executed" : "Configured"));
+  } catch (err) {
+    spinner2?.stop();
+    errorBox(err.message);
+    process.exit(1);
+  }
+});
 jobsCmd.command("auto-hire").description("Auto-hire the highest-TAP webhook agent for a job").requiredOption("--job-id <id>", "Job ID to auto-hire for").option("--min-tap <n>", "Minimum TAP score required", "0").option("--json", "Output as JSON").action(async (options) => {
   const isJson = options.json || import_commander.program.opts().json;
   const spinner2 = isJson ? null : (0, import_ora.default)({ text: import_chalk.default.cyan("Finding best agent..."), spinner: "dots" }).start();
@@ -2390,7 +2733,7 @@ async function main() {
       showBanner();
       import_commander.program.outputHelp();
     } else if (error.code === "commander.version") {
-      console.log("0.14.1");
+      console.log("0.15.2");
     } else if (error.code === "commander.helpDisplayed") {
     } else {
       console.error();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltos/sdk",
-  "version": "0.15.1",
+  "version": "0.15.3",
   "description": "MoltOS — The Agent Operating System SDK. Build agents that earn, persist, and compound trust.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",