@otonix/cli 1.2.1 → 1.4.0

package/README.md

@@ -64,6 +64,22 @@ otonix log "Trade executed BTC/USDC" --category trading
 | `otonix sandboxes` | List VPS sandboxes |
 | `otonix domains` | List registered domains |
 
+### Credits
+
+| Command | Description |
+|---------|-------------|
+| `otonix credits [agentId]` | Show agent credit balance |
+| `otonix credits:transfer` | Transfer credits between agents |
+| `otonix credits:history [agentId]` | Show credit transaction history |
+
+### Templates
+
+| Command | Description |
+|---------|-------------|
+| `otonix templates` | List all available agent templates |
+| `otonix templates:info <slug>` | Show template details by slug |
+| `otonix templates:deploy` | Deploy an agent from a template |
+
 ### Platform
 
 | Command | Description |
@@ -147,6 +163,32 @@ otonix actions --limit 50
 |--------|---------|-------------|
 | `--limit` | `20` | Number of actions to show |
 
+### `otonix credits:transfer`
+
+```bash
+otonix credits:transfer --from <agentId> --to <agentId> --amount 10 --desc "Payment"
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--from` | (interactive) | Source agent ID |
+| `--to` | (interactive) | Destination agent ID |
+| `--amount` | (interactive) | Amount in USDC |
+| `--desc` | — | Transfer description |
+
+### `otonix templates:deploy`
+
+```bash
+otonix templates:deploy --template trading-bot --name my-trader --vps 10.0.1.1 --wallet 0x...
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--template` | (interactive) | Template slug |
+| `--name` | (interactive) | Agent name |
+| `--vps` | — | VPS IP address |
+| `--wallet` | — | Wallet address |
+
 ### `otonix llm:chat`
 
 ```bash

package/dist/cli.js

@@ -28,7 +28,7 @@ var import_sdk = require("@otonix/sdk");
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
 var readline = __toESM(require("readline"));
-var VERSION = "1.2.0";
+var VERSION = "1.4.0";
 var CONFIG_DIR = path.join(process.env.HOME || "~", ".otonix");
 var CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
 function loadConfig() {
@@ -106,8 +106,26 @@ var HELP = `
     domains              List registered domains
     sandboxes            List VPS sandboxes
     engine               Show autonomic engine status
+    credits <agentId>    Show agent credit balance
+    credits:transfer     Transfer credits between agents
+    credits:history <id> Show credit transaction history
+    templates            List available agent templates
+    templates:info <s>   Show template details by slug
+    templates:deploy     Deploy an agent from a template
     marketplace          List marketplace services
     x402                 Show x402 payment config
+    bv7x:promote <id>    Promote an agent to mothership
+    bv7x:spawn           Spawn a satellite from a BV-7X template
+    bv7x:satellites <id> List satellites of a mothership
+    bv7x:destroy <id>    Destroy (terminate) a satellite
+    bv7x:report <id>     Send a satellite data report
+    bv7x:fleet           Show full BV-7X fleet overview
+    webhook:create       Create a new webhook endpoint
+    webhook:list         List registered webhooks
+    webhook:delete <id>  Delete a webhook
+    webhook:test <id>    Send a test delivery to a webhook
+    webhook:deliveries   Show webhook delivery history
+    webhook:events       List all available webhook events
     llm:init <key>       Configure Bankr LLM Gateway API key
     llm:models           List available LLM models
     llm:chat <prompt>    Send a chat completion request
@@ -471,6 +489,177 @@ async function cmdMarketplace() {
   Use 'curl https://app.otonix.tech/api/marketplace/services/<id>' for details.
 `);
 }
+async function cmdCredits(agentId) {
+  const client = getClient();
+  const config = loadConfig();
+  const id = agentId || config.agentId;
+  if (!id) {
+    console.error("  Usage: otonix credits <agentId> (or register an agent first)");
+    process.exit(1);
+  }
+  const balance = await client.getCreditBalance(id);
+  console.log(`
+  Agent Credit Balance:`);
+  console.log(`  Agent:   ${balance.name}`);
+  console.log(`  Credits: $${balance.credits.toFixed(2)}`);
+  console.log(`  Tier:    ${balance.survivalTier}
+`);
+}
+async function cmdCreditsTransfer(args) {
+  const client = getClient();
+  let fromId = "";
+  let toId = "";
+  let amount = 0;
+  let desc = "";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--from" && args[i + 1]) fromId = args[++i];
+    else if (args[i] === "--to" && args[i + 1]) toId = args[++i];
+    else if (args[i] === "--amount" && args[i + 1]) amount = parseFloat(args[++i]);
+    else if (args[i] === "--desc" && args[i + 1]) desc = args[++i];
+  }
+  if (!fromId) fromId = await prompt("  From Agent ID: ");
+  if (!toId) toId = await prompt("  To Agent ID: ");
+  if (!amount) {
+    const amtStr = await prompt("  Amount (USDC): ");
+    amount = parseFloat(amtStr);
+  }
+  if (!fromId || !toId || !amount || amount <= 0) {
+    console.error("  Error: --from, --to, and --amount (> 0) are required.");
+    process.exit(1);
+  }
+  try {
+    const result = await client.transferCredits({
+      fromAgentId: fromId,
+      toAgentId: toId,
+      amount,
+      description: desc || void 0
+    });
+    if (result.success) {
+      console.log(`
+  Transfer Successful:`);
+      console.log(`  Amount: $${result.transferred.toFixed(2)} USDC`);
+      console.log(`  From:   ${result.from}`);
+      console.log(`  To:     ${result.to}
+`);
+    } else {
+      console.error("  Transfer failed.");
+    }
+  } catch (err) {
+    console.error(`  Error: ${err.message}`);
+    process.exit(1);
+  }
+}
+async function cmdCreditsHistory(agentId) {
+  const client = getClient();
+  const config = loadConfig();
+  const id = agentId || config.agentId;
+  if (!id) {
+    console.error("  Usage: otonix credits:history <agentId>");
+    process.exit(1);
+  }
+  const history = await client.getCreditHistory(id);
+  if (!history.length) {
+    console.log("\n  No credit transactions found.\n");
+    return;
+  }
+  console.log(`
+  Credit History (${history.length} transactions):
+`);
+  printTable(
+    history.map((tx) => ({
+      Type: tx.type,
+      Amount: `${tx.type === "credit" ? "+" : "-"}$${Math.abs(tx.amount).toFixed(2)}`,
+      Description: (tx.description || "\u2014").slice(0, 50),
+      Status: tx.status,
+      Date: new Date(tx.createdAt).toLocaleDateString()
+    }))
+  );
+  console.log();
+}
+async function cmdTemplates() {
+  const client = getClient();
+  const templates = await client.listTemplates();
+  if (!templates.length) {
+    console.log("\n  No templates available.\n");
+    return;
+  }
+  console.log(`
+  Agent Templates (${templates.length}):
+`);
+  printTable(
+    templates.map((t) => ({
+      Slug: t.slug,
+      Name: t.name,
+      Category: t.category,
+      Model: t.model,
+      Cost: `$${t.estimatedCost.toFixed(2)}/day`,
+      Features: t.features?.length || 0
+    }))
+  );
+  console.log();
+}
+async function cmdTemplatesInfo(slug) {
+  if (!slug) {
+    console.error("  Usage: otonix templates:info <slug>");
+    process.exit(1);
+  }
+  const client = getClient();
+  const template = await client.getTemplate(slug);
+  console.log(`
+  Template: ${template.name}`);
+  console.log(`  Slug:        ${template.slug}`);
+  console.log(`  Category:    ${template.category}`);
+  console.log(`  Model:       ${template.model}`);
+  console.log(`  Est. Cost:   $${template.estimatedCost.toFixed(2)}/day`);
+  console.log(`  Description: ${template.description}`);
+  if (template.features?.length) {
+    console.log(`  Features:`);
+    template.features.forEach((f) => console.log(`    - ${f}`));
+  }
+  console.log();
+}
+async function cmdTemplatesDeploy(args) {
+  const client = getClient();
+  let slug = "";
+  let name = "";
+  let vpsIp = "";
+  let wallet = "";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--template" && args[i + 1]) slug = args[++i];
+    else if (args[i] === "--name" && args[i + 1]) name = args[++i];
+    else if (args[i] === "--vps" && args[i + 1]) vpsIp = args[++i];
+    else if (args[i] === "--wallet" && args[i + 1]) wallet = args[++i];
+  }
+  if (!slug) slug = await prompt("  Template slug (e.g. trading-bot): ");
+  if (!name) name = await prompt("  Agent name: ");
+  if (!slug || !name) {
+    console.error("  Error: --template and --name are required.");
+    process.exit(1);
+  }
+  try {
+    const result = await client.deployTemplate({
+      templateSlug: slug,
+      name,
+      vpsIp: vpsIp || void 0,
+      walletAddress: wallet || void 0
+    });
+    if (result.success) {
+      console.log(`
+  Agent Deployed:`);
+      console.log(`  ID:       ${result.agent.id}`);
+      console.log(`  Name:     ${result.agent.name}`);
+      console.log(`  Template: ${result.template.name} (${result.template.category})`);
+      console.log(`  Model:    ${result.agent.model}`);
+      console.log(`  Tier:     ${result.agent.survivalTier}
+`);
+    } else {
+      console.error("  Deploy failed.");
+    }
+  } catch (err) {
+    console.error(`  Error: ${err.message}`);
+    process.exit(1);
+  }
+}
 async function cmdX402() {
   const client = getClient();
   const config = await client.getX402Config();
@@ -602,6 +791,254 @@ async function cmdLlmHealth() {
   }
   console.log();
 }
+async function cmdBv7xPromote(agentId) {
+  if (!agentId) {
+    console.error("  Usage: otonix bv7x:promote <agentId>");
+    process.exit(1);
+  }
+  const client = getClient();
+  const result = await client.promoteMothership(agentId);
+  console.log(`
+  Agent promoted to mothership:`);
+  console.log(`  ID:     ${result.agent.id}`);
+  console.log(`  Name:   ${result.agent.name}`);
+  console.log(`  Role:   ${result.agent.role}
+`);
+}
+async function cmdBv7xSpawn(args) {
+  const client = getClient();
+  let mothershipId = "";
+  let templateSlug = "";
+  let name = "";
+  let vpsIp = "";
+  let wallet = "";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--mothership" && args[i + 1]) mothershipId = args[++i];
+    else if (args[i] === "--template" && args[i + 1]) templateSlug = args[++i];
+    else if (args[i] === "--name" && args[i + 1]) name = args[++i];
+    else if (args[i] === "--vps" && args[i + 1]) vpsIp = args[++i];
+    else if (args[i] === "--wallet" && args[i + 1]) wallet = args[++i];
+  }
+  if (!mothershipId) mothershipId = await prompt("  Mothership Agent ID: ");
+  if (!templateSlug) templateSlug = await prompt("  Template slug (e.g. bv7x-alpha-trader): ");
+  if (!name) name = await prompt("  Satellite name: ");
+  if (!mothershipId || !templateSlug || !name) {
+    console.error("  Error: --mothership, --template, and --name are required.");
+    process.exit(1);
+  }
+  const result = await client.spawnSatellite({
+    mothershipId,
+    templateSlug,
+    name,
+    vpsIp: vpsIp || void 0,
+    walletAddress: wallet || void 0
+  });
+  console.log(`
+  Satellite Spawned:`);
+  console.log(`  ID:          ${result.satellite.id}`);
+  console.log(`  Name:        ${result.satellite.name}`);
+  console.log(`  Model:       ${result.satellite.model}`);
+  console.log(`  Role:        ${result.satellite.role}`);
+  console.log(`  Template:    ${result.template.name}`);
+  console.log(`  Mothership:  ${result.mothership.name} (${result.mothership.childrenCount} satellites)
+`);
+}
+async function cmdBv7xSatellites(mothershipId) {
+  if (!mothershipId) {
+    console.error("  Usage: otonix bv7x:satellites <mothershipId>");
+    process.exit(1);
+  }
+  const client = getClient();
+  const result = await client.getMothershipSatellites(mothershipId);
+  console.log(`
+  Mothership: ${result.mothership.name} (${result.count} satellites)
+`);
+  if (!result.satellites.length) {
+    console.log("  No satellites spawned yet.\n");
+    return;
+  }
+  printTable(result.satellites.map((s) => ({
+    ID: s.id.slice(0, 8),
+    Name: s.name,
+    Status: s.status,
+    Tier: s.survivalTier,
+    Model: s.model,
+    Heartbeat: formatTime(s.lastHeartbeat),
+    Actions: s.totalActions
+  })));
+  console.log();
+}
+async function cmdBv7xDestroy(satelliteId) {
+  if (!satelliteId) {
+    console.error("  Usage: otonix bv7x:destroy <satelliteId>");
+    process.exit(1);
+  }
+  const client = getClient();
+  const result = await client.destroySatellite(satelliteId);
+  console.log(`  ${result.message}`);
+}
+async function cmdBv7xReport(args) {
+  let satelliteId = "";
+  let reportType = "general";
+  let dataStr = "";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--type" && args[i + 1]) reportType = args[++i];
+    else if (args[i] === "--data" && args[i + 1]) dataStr = args[++i];
+    else if (!satelliteId) satelliteId = args[i];
+  }
+  if (!satelliteId) {
+    console.error("  Usage: otonix bv7x:report <satelliteId> --type <type> --data '<json>'");
+    process.exit(1);
+  }
+  let data = {};
+  if (dataStr) {
+    try {
+      data = JSON.parse(dataStr);
+    } catch {
+      console.error("  Error: --data must be valid JSON");
+      process.exit(1);
+    }
+  } else {
+    const raw = await prompt("  Report data (JSON): ");
+    try {
+      data = JSON.parse(raw);
+    } catch {
+      console.error("  Error: Invalid JSON");
+      process.exit(1);
+    }
+  }
+  const client = getClient();
+  await client.satelliteReport(satelliteId, { data, reportType });
+  console.log(`  Report sent (type: ${reportType})`);
+}
+async function cmdBv7xFleet() {
+  const client = getClient();
+  const fleet = await client.getFleet();
+  console.log(`
+  BV-7X Fleet Overview`);
+  console.log(`  Motherships:  ${fleet.totalMotherships}`);
+  console.log(`  Satellites:   ${fleet.totalSatellites}`);
+  if (fleet.fleet.length) {
+    for (const f of fleet.fleet) {
+      console.log(`
+  \u250C Mothership: ${f.mothership.name} [${f.mothership.status}] \u2014 ${f.satelliteCount} satellite(s)`);
+      for (const s of f.satellites) {
+        console.log(`  \u2502  \u2514 ${s.name} [${s.status}] tier:${s.survivalTier} heartbeat:${formatTime(s.lastHeartbeat)}`);
+      }
+    }
+  }
+  if (fleet.orphanedSatellites.length) {
+    console.log(`
+  Orphaned Satellites: ${fleet.orphanedSatellites.length}`);
+    for (const s of fleet.orphanedSatellites) {
+      console.log(`    \u2022 ${s.name} [${s.status}]`);
+    }
+  }
+  console.log();
+}
+async function cmdWebhookCreate(args) {
+  const client = getClient();
+  let url = "";
+  let agentId = "";
+  const events = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--url" && args[i + 1]) url = args[++i];
+    else if (args[i] === "--agent" && args[i + 1]) agentId = args[++i];
+    else if (args[i] === "--event" && args[i + 1]) events.push(args[++i]);
+  }
+  if (!url) url = await prompt("  Webhook URL: ");
+  if (!url) {
+    console.error("  Error: URL is required.");
+    process.exit(1);
+  }
+  const result = await client.createWebhook({
+    url,
+    events: events.length ? events : void 0,
+    agentId: agentId || void 0
+  });
+  console.log(`
+  Webhook Created:`);
+  console.log(`  ID:     ${result.id}`);
+  console.log(`  URL:    ${result.url}`);
+  console.log(`  Events: ${result.events.length ? result.events.join(", ") : "all"}`);
+  console.log(`  Secret: ${result.secret}`);
+  console.log(`
+  Save this secret \u2014 it won't be shown again.
+`);
+}
+async function cmdWebhookList() {
+  const client = getClient();
+  const hooks = await client.listWebhooks();
+  if (!hooks.length) {
+    console.log("\n  No webhooks registered.\n");
+    return;
+  }
+  console.log(`
+  Webhooks (${hooks.length}):
+`);
+  printTable(hooks.map((h) => ({
+    ID: h.id.slice(0, 8),
+    URL: h.url.length > 40 ? h.url.slice(0, 37) + "..." : h.url,
+    Events: h.events.length ? h.events.length + " types" : "all",
+    Status: h.status,
+    Fails: h.failCount,
+    Agent: h.agentId?.slice(0, 8) || "global"
+  })));
+  console.log();
+}
+async function cmdWebhookDelete(webhookId) {
+  if (!webhookId) {
+    console.error("  Usage: otonix webhook:delete <webhookId>");
+    process.exit(1);
+  }
+  const client = getClient();
+  const result = await client.deleteWebhook(webhookId);
+  console.log(`  ${result.message}`);
+}
+async function cmdWebhookTest(webhookId) {
+  if (!webhookId) {
+    console.error("  Usage: otonix webhook:test <webhookId>");
+    process.exit(1);
+  }
+  const client = getClient();
+  const result = await client.testWebhook(webhookId);
+  console.log(`  ${result.message}`);
+}
+async function cmdWebhookDeliveries(args) {
+  let webhookId = args[0] || "";
+  if (!webhookId) {
+    console.error("  Usage: otonix webhook:deliveries <webhookId>");
+    process.exit(1);
+  }
+  const client = getClient();
+  const deliveries = await client.getWebhookDeliveries(webhookId);
+  if (!deliveries.length) {
+    console.log("\n  No deliveries found.\n");
+    return;
+  }
+  console.log(`
+  Webhook Deliveries (${deliveries.length}):
+`);
+  printTable(deliveries.slice(0, 20).map((d) => ({
+    Event: d.event,
+    Status: d.statusCode || "\u2014",
+    Success: d.success ? "yes" : "no",
+    Time: formatTime(d.createdAt),
+    Response: (d.response || "\u2014").slice(0, 30)
+  })));
+  console.log();
+}
+async function cmdWebhookEvents() {
+  const client = getClient();
+  const result = await client.listWebhookEvents();
+  console.log(`
+  Available Webhook Events (${result.events.length}):
+`);
+  for (const event of result.events) {
+    console.log(`    \u2022 ${event}`);
+  }
+  console.log();
+}
 function cmdWhoami() {
   const config = loadConfig();
   if (!config) {
@@ -660,12 +1097,66 @@ async function main() {
       case "engine":
         await cmdEngine();
         break;
+      case "credits":
+        await cmdCredits(rest[0]);
+        break;
+      case "credits:transfer":
+        await cmdCreditsTransfer(rest);
+        break;
+      case "credits:history":
+        await cmdCreditsHistory(rest[0]);
+        break;
+      case "templates":
+        await cmdTemplates();
+        break;
+      case "templates:info":
+        await cmdTemplatesInfo(rest[0]);
+        break;
+      case "templates:deploy":
+        await cmdTemplatesDeploy(rest);
+        break;
       case "marketplace":
         await cmdMarketplace();
         break;
       case "x402":
         await cmdX402();
         break;
+      case "bv7x:promote":
+        await cmdBv7xPromote(rest[0]);
+        break;
+      case "bv7x:spawn":
+        await cmdBv7xSpawn(rest);
+        break;
+      case "bv7x:satellites":
+        await cmdBv7xSatellites(rest[0]);
+        break;
+      case "bv7x:destroy":
+        await cmdBv7xDestroy(rest[0]);
+        break;
+      case "bv7x:report":
+        await cmdBv7xReport(rest);
+        break;
+      case "bv7x:fleet":
+        await cmdBv7xFleet();
+        break;
+      case "webhook:create":
+        await cmdWebhookCreate(rest);
+        break;
+      case "webhook:list":
+        await cmdWebhookList();
+        break;
+      case "webhook:delete":
+        await cmdWebhookDelete(rest[0]);
+        break;
+      case "webhook:test":
+        await cmdWebhookTest(rest[0]);
+        break;
+      case "webhook:deliveries":
+        await cmdWebhookDeliveries(rest);
+        break;
+      case "webhook:events":
+        await cmdWebhookEvents();
+        break;
       case "llm:init":
         cmdLlmInit(rest[0]);
         break;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@otonix/cli",
-  "version": "1.2.1",
-  "description": "CLI tool for the Otonix sovereign compute platform — initialize agents, generate API keys, register, monitor status, and manage infrastructure from the terminal.",
+  "version": "1.4.0",
+  "description": "CLI tool for the Otonix sovereign compute platform — initialize agents, generate API keys, register, monitor status, BV-7X fleet orchestration, webhook management, and manage infrastructure from the terminal.",
   "main": "dist/cli.js",
   "bin": {
     "otonix": "dist/cli.js"
@@ -38,7 +38,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@otonix/sdk": "^1.2.0"
+    "@otonix/sdk": "^1.4.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",