@otonix/cli 1.1.0 → 1.2.1

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
 
@@ -69,8 +69,48 @@ otonix log "Trade executed BTC/USDC" --category trading
 | 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 +147,26 @@ otonix actions --limit 50
 |--------|---------|-------------|
 | `--limit` | `20` | Number of actions to show |
 
+### `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 +176,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 +202,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.1.0";
+var VERSION = "1.2.0";
 var CONFIG_DIR = path.join(process.env.HOME || "~", ".otonix");
 var CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
 function loadConfig() {
@@ -108,6 +108,11 @@ var HELP = `
     engine               Show autonomic engine status
     marketplace          List marketplace services
     x402                 Show x402 payment config
+    llm:init <key>       Configure Bankr LLM Gateway API key
+    llm:models           List available LLM models
+    llm:chat <prompt>    Send a chat completion request
+    llm:usage [--days N] Show LLM usage summary
+    llm:health           Check gateway health
     whoami               Show current configuration
     version              Show CLI version
     help                 Show this help
@@ -119,6 +124,8 @@ var HELP = `
     otonix heartbeat:loop
     otonix log "Trade executed BTC/USDC" --category trading
     otonix actions --limit 20
+    otonix llm:init bk_YOUR_API_KEY
+    otonix llm:chat "Explain smart contracts" --model claude-haiku-4.5
 `;
 async function cmdInit() {
   console.log("\n  Otonix CLI Setup\n");
@@ -476,6 +483,125 @@ async function cmdX402() {
   console.log(`  Facilitator: ${config.facilitatorUrl}
 `);
 }
+function getBankrClient() {
+  const config = loadConfig();
+  if (!config?.bankrApiKey) {
+    console.error("  Error: Bankr LLM key not configured. Run 'otonix llm:init <key>' first.");
+    process.exit(1);
+  }
+  return new import_sdk.BankrLLM({ apiKey: config.bankrApiKey });
+}
+function cmdLlmInit(key) {
+  if (!key) {
+    console.error("  Usage: otonix llm:init <bankr_api_key>");
+    process.exit(1);
+  }
+  if (!key.startsWith("bk_")) {
+    console.error("  Error: Bankr API key must start with 'bk_'");
+    process.exit(1);
+  }
+  const config = loadConfig();
+  if (!config) {
+    console.error("  Error: Run 'otonix init' first to configure Otonix.");
+    process.exit(1);
+  }
+  config.bankrApiKey = key;
+  saveConfig(config);
+  console.log(`
+  Bankr LLM Gateway key saved.`);
+  console.log(`  Gateway: https://llm.bankr.bot`);
+  console.log(`  Key:     ${key.slice(0, 6)}...${key.slice(-4)}
+`);
+}
+async function cmdLlmModels() {
+  const llm = getBankrClient();
+  const models = await llm.listModels();
+  if (!models.length) {
+    console.log("\n  No models available.\n");
+    return;
+  }
+  console.log(`
+  Available Models \u2014 ${models.length} total
+`);
+  printTable(
+    models.map((m) => ({
+      Model: m.id,
+      Provider: m.owned_by
+    }))
+  );
+  console.log();
+}
+async function cmdLlmChat(args) {
+  const llm = getBankrClient();
+  let model = "claude-haiku-4.5";
+  const modelIdx = args.indexOf("--model");
+  if (modelIdx !== -1 && args[modelIdx + 1]) {
+    model = args[modelIdx + 1];
+    args.splice(modelIdx, 2);
+  }
+  const promptText = args.join(" ");
+  if (!promptText) {
+    console.error("  Usage: otonix llm:chat <prompt> [--model <model>]");
+    process.exit(1);
+  }
+  console.log(`
+  Model: ${model}`);
+  console.log(`  Prompt: ${promptText}
+`);
+  console.log("  Thinking...\n");
+  const result = await llm.chat({
+    model,
+    messages: [{ role: "user", content: promptText }]
+  });
+  const content = result.choices?.[0]?.message?.content || "No response";
+  console.log(`  ${content.split("\n").join("\n  ")}`);
+  console.log(`
+  Tokens: ${result.usage?.prompt_tokens || 0} in / ${result.usage?.completion_tokens || 0} out`);
+  console.log(`  Model: ${result.model}
+`);
+}
+async function cmdLlmUsage(args) {
+  const llm = getBankrClient();
+  let days = 30;
+  const daysIdx = args.indexOf("--days");
+  if (daysIdx !== -1 && args[daysIdx + 1]) {
+    days = parseInt(args[daysIdx + 1]) || 30;
+  }
+  const usage = await llm.getUsage(days);
+  console.log(`
+  LLM Usage (${days} days)
+`);
+  console.log(`  Total Requests:   ${usage.totals.totalRequests}`);
+  console.log(`  Input Tokens:     ${usage.totals.totalInputTokens.toLocaleString()}`);
+  console.log(`  Output Tokens:    ${usage.totals.totalOutputTokens.toLocaleString()}`);
+  console.log(`  Total Cost:       $${usage.totals.totalCost.toFixed(2)}`);
+  if (usage.byModel?.length) {
+    console.log(`
+  By Model:`);
+    printTable(
+      usage.byModel.map((m) => ({
+        Model: m.model,
+        Provider: m.provider,
+        Requests: m.requests,
+        Cost: `$${m.totalCost.toFixed(2)}`
+      }))
+    );
+  }
+  console.log();
+}
+async function cmdLlmHealth() {
+  const llm = getBankrClient();
+  const health = await llm.checkHealth();
+  console.log(`
+  LLM Gateway Health:`);
+  console.log(`  Status: ${health.status}`);
+  if (health.providers) {
+    for (const [name, ok] of Object.entries(health.providers)) {
+      console.log(`  ${name}: ${ok ? "online" : "offline"}`);
+    }
+  }
+  console.log();
+}
 function cmdWhoami() {
   const config = loadConfig();
   if (!config) {
@@ -484,11 +610,12 @@ function cmdWhoami() {
   }
   console.log(`
   Current Config:`);
-  console.log(`  Endpoint:  ${config.endpoint}`);
-  console.log(`  API Key:   ${config.apiKey.slice(0, 12)}...${config.apiKey.slice(-4)}`);
-  console.log(`  Agent ID:  ${config.agentId || "not registered"}`);
-  console.log(`  Agent:     ${config.agentName || "\u2014"}`);
-  console.log(`  Config:    ${CONFIG_FILE}
+  console.log(`  Endpoint:   ${config.endpoint}`);
+  console.log(`  API Key:    ${config.apiKey.slice(0, 12)}...${config.apiKey.slice(-4)}`);
+  console.log(`  Agent ID:   ${config.agentId || "not registered"}`);
+  console.log(`  Agent:      ${config.agentName || "\u2014"}`);
+  console.log(`  Bankr LLM:  ${config.bankrApiKey ? config.bankrApiKey.slice(0, 6) + "..." + config.bankrApiKey.slice(-4) : "not configured"}`);
+  console.log(`  Config:     ${CONFIG_FILE}
 `);
 }
 async function main() {
@@ -539,6 +666,21 @@ async function main() {
       case "x402":
         await cmdX402();
         break;
+      case "llm:init":
+        cmdLlmInit(rest[0]);
+        break;
+      case "llm:models":
+        await cmdLlmModels();
+        break;
+      case "llm:chat":
+        await cmdLlmChat(rest);
+        break;
+      case "llm:usage":
+        await cmdLlmUsage(rest);
+        break;
+      case "llm:health":
+        await cmdLlmHealth();
+        break;
       case "whoami":
         cmdWhoami();
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otonix/cli",
-  "version": "1.1.0",
+  "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.",
   "main": "dist/cli.js",
   "bin": {
@@ -38,7 +38,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@otonix/sdk": "^1.1.0"
+    "@otonix/sdk": "^1.2.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",