@otonix/cli 1.2.0 → 1.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line tool for the [Otonix](https://otonix.tech) sovereign compute platform.
 
-Initialize, register, and manage autonomous AI agents from your terminal.
+Initialize, register, and manage autonomous AI agents from your terminal. Includes built-in access to the Bankr LLM Gateway for multi-model AI inference.
 
 ## Install
 
@@ -64,13 +64,69 @@ 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 |
 |---------|-------------|
 | `otonix engine` | Show autonomic engine status |
+| `otonix marketplace` | List marketplace services |
 | `otonix x402` | Show x402 payment configuration |
 
+### LLM Gateway (Bankr)
+
+Access multi-model AI inference directly from your terminal. Supports Claude, GPT, Gemini, Kimi, Qwen, and more via the [Bankr LLM Gateway](https://bankr.bot/llm).
+
+| Command | Description |
+|---------|-------------|
+| `otonix llm:init <key>` | Configure Bankr LLM Gateway API key |
+| `otonix llm:models` | List available AI models |
+| `otonix llm:chat <prompt>` | Send a chat completion request |
+| `otonix llm:usage` | Show LLM usage summary |
+| `otonix llm:health` | Check gateway health status |
+
+#### LLM Setup
+
+Get your Bankr API key from [bankr.bot/api](https://bankr.bot/api) (make sure LLM Gateway access is enabled):
+
+```bash
+otonix llm:init bk_YOUR_API_KEY
+```
+
+#### LLM Examples
+
+```bash
+# List available models
+otonix llm:models
+
+# Chat with default model (claude-haiku-4.5)
+otonix llm:chat "What is sovereign compute?"
+
+# Chat with a specific model
+otonix llm:chat "Analyze BTC price action" --model gpt-5-mini
+
+# Check usage (last 7 days)
+otonix llm:usage --days 7
+
+# Check gateway health
+otonix llm:health
+```
+
 ## Command Options
 
 ### `otonix register`
@@ -107,6 +163,52 @@ 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
+otonix llm:chat "Your prompt here" --model claude-haiku-4.5
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--model` | `claude-haiku-4.5` | AI model to use |
+
+### `otonix llm:usage`
+
+```bash
+otonix llm:usage --days 7
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--days` | `30` | Number of days to show |
+
 ## Configuration
 
 Config is stored at `~/.otonix/config.json` with file permissions `600`.
@@ -116,7 +218,8 @@ Config is stored at `~/.otonix/config.json` with file permissions `600`.
   "apiKey": "otonix_xxxx",
   "endpoint": "https://app.otonix.tech",
   "agentId": "uuid-xxxx",
-  "agentName": "my-agent"
+  "agentName": "my-agent",
+  "bankrApiKey": "bk_xxxx"
 }
 ```
 
@@ -141,24 +244,26 @@ $ otonix register --name sentinel-01
   Tier:     active
   Interval: 60s
 
+$ otonix llm:init bk_4GYZ...WXFKD
+  Bankr LLM Gateway key saved.
+  Gateway: https://llm.bankr.bot
+  Key:     bk_4GY...XFKD
+
+$ otonix llm:chat "What infrastructure should I monitor?"
+  Model: claude-haiku-4.5
+  Prompt: What infrastructure should I monitor?
+
+  Thinking...
+
+  Focus on CPU usage, memory consumption, disk I/O, network latency,
+  and service uptime. Set up alerts for anomalies in each metric.
+
+  Tokens: 24 in / 87 out
+  Model: claude-haiku-4.5
+
 $ otonix heartbeat
   Heartbeat sent — sentinel-01 [active] tier:active credits:$50.00
 
-$ otonix log "Deployed monitoring stack" --category infra
-  Logged: [infra] Deployed monitoring stack (completed)
-
-$ otonix status
-  Agent Status:
-  ID:          e2998be4-b77c-495e-a535-a6e4ca9dc768
-  Name:        sentinel-01
-  Status:      active
-  Tier:        full
-  Credits:     $50.00
-  Model:       claude-opus-4-6
-  VPS IP:      10.0.1.1
-  Heartbeat:   12s ago
-  Actions:     3
-
 $ otonix engine
   Autonomic Engine Status:
   Running:        yes

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.3.0";
 var CONFIG_DIR = path.join(process.env.HOME || "~", ".otonix");
 var CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
 function loadConfig() {
@@ -106,6 +106,12 @@ 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
     llm:init <key>       Configure Bankr LLM Gateway API key
@@ -471,6 +477,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();
@@ -660,6 +837,24 @@ 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;

package/package.json

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