@agentis-hq/cli 0.1.1 → 0.1.3

package/README.md

@@ -4,9 +4,7 @@ Command line tools for Agentis, the financial infrastructure layer for AI agents
 
 The CLI lets you create agent wallets, manage spend policies, pay MPP and x402 URLs, work with Umbra privacy flows, deposit idle USDC into Jupiter Earn, and scaffold x402 facilitators.
 
-![Agentis CLI help](./assets/agentis-help.png)
-
-> Add the screenshot at `packages/cli/assets/agentis-help.png` before publishing if it is not already present in the package.
+![Agentis CLI help](https://unpkg.com/@agentis-hq/cli/assets/agentis-help.png)
 
 ## Install
 
@@ -171,6 +169,13 @@ Deposit USDC into Jupiter Earn:
 agentis earn deposit research-agent --asset USDC --amount 1 --mainnet
 ```
 
+Withdraw USDC from Jupiter Earn. Omit `--amount` to redeem the full USDC Earn position:
+
+```bash
+agentis earn withdraw research-agent --asset USDC --mainnet
+agentis earn withdraw research-agent --asset USDC --amount 1 --mainnet
+```
+
 Show positions:
 
 ```bash
@@ -255,6 +260,7 @@ agentis wallet create --help
 agentis agent send --help
 agentis fetch --help
 agentis earn deposit --help
+agentis earn withdraw --help
 agentis privacy create-utxo --help
 agentis facilitator publish --help
 ```

package/dist/index.js

@@ -269,6 +269,31 @@ function recordLocalSpend(wallet, spend) {
   return updated;
 }
 
+// src/lib/format-agent.ts
+function formatPolicy(agent) {
+  const mode = agent.policyMode ?? "backend";
+  if (mode !== "onchain") return "policy=backend";
+  return `policy=onchain:${agent.onchainPolicy?.initialized ? "ready" : "pending"}`;
+}
+function formatPrivacy(agent) {
+  if (!agent.privacyEnabled && !agent.umbraStatus) return null;
+  return `privacy=${agent.umbraStatus ?? "enabled"}`;
+}
+function formatLocalPolicy(wallet) {
+  return wallet.policy.killSwitch ? "policy=local:killed" : "policy=local";
+}
+function formatBadges(parts) {
+  return parts.filter(Boolean).join(", ");
+}
+function formatHostedAgentLine(agent) {
+  const badges = formatBadges(["hosted", formatPolicy(agent), formatPrivacy(agent)]);
+  return `  ${agent.name.padEnd(20)} ${agent.walletAddress}  [${agent.id}]  ${badges}`;
+}
+function formatLocalWalletLine(wallet) {
+  const badges = formatBadges(["local", formatLocalPolicy(wallet)]);
+  return `  ${wallet.name.padEnd(20)} ${wallet.solanaAddress}  [${wallet.id}]  ${badges}`;
+}
+
 // src/commands/agent.ts
 import { checkPolicy } from "@agentis-hq/core";
 import {
@@ -329,7 +354,7 @@ async function agentList() {
   }
   console.log();
   for (const a of agents) {
-    console.log(`  ${a.name.padEnd(20)} ${a.walletAddress}  [${a.id}]`);
+    console.log(formatHostedAgentLine(a));
   }
   console.log();
 }
@@ -550,7 +575,7 @@ async function walletList() {
         if (hosted.length > 0) {
           console.log("\nHosted wallets:");
           for (const a of hosted) {
-            console.log(`  ${a.name.padEnd(20)} ${a.walletAddress}  [${a.id}]`);
+            console.log(formatHostedAgentLine(a));
           }
         }
       }
@@ -560,7 +585,7 @@ async function walletList() {
   if (localWallets.length > 0) {
     console.log("\nLocal wallets:");
     for (const w of localWallets) {
-      console.log(`  ${w.name.padEnd(20)} ${w.solanaAddress}  [${w.id}]`);
+      console.log(formatLocalWalletLine(w));
     }
   }
   if (localWallets.length === 0 && !token) {
@@ -1044,6 +1069,9 @@ async function earnCommand(args2) {
     case "deposit":
       await earnDeposit(args2.slice(1));
       break;
+    case "withdraw":
+      await earnWithdraw(args2.slice(1));
+      break;
     case "positions":
       await earnPositions(args2.slice(1));
       break;
@@ -1051,7 +1079,7 @@ async function earnCommand(args2) {
       await earnSweep(args2.slice(1));
       break;
     default:
-      console.log("Usage: agentis earn <deposit|positions|sweep>");
+      console.log("Usage: agentis earn <deposit|withdraw|positions|sweep>");
   }
 }
 async function earnDeposit(args2) {
@@ -1091,6 +1119,47 @@ Depositing ${amountNum} ${asset.toUpperCase()} into Jupiter Earn from ${agent.na
   console.log(`  Explorer:  https://solscan.io/tx/${data.signature}
 `);
 }
+async function earnWithdraw(args2) {
+  const agentName = args2[0];
+  const asset = getFlag3(args2, "--asset") ?? "USDC";
+  const amount = getFlag3(args2, "--amount");
+  const mainnet = args2.includes("--mainnet");
+  if (!agentName || !mainnet) {
+    console.error("Usage: agentis earn withdraw <agent> --asset USDC [--amount <amount>] --mainnet");
+    process.exit(1);
+  }
+  if (amount !== void 0) {
+    const amountNum = Number(amount);
+    if (!Number.isFinite(amountNum) || amountNum <= 0) {
+      console.error("Invalid amount");
+      process.exit(1);
+    }
+  }
+  const token = await requireAuth3();
+  const agent = await resolveAccountAgent(agentName, token);
+  const amountLabel = amount === void 0 ? "all supplied" : `${amount} ${asset.toUpperCase()}`;
+  console.log(`
+Withdrawing ${amountLabel} from Jupiter Earn to ${agent.name} on mainnet...`);
+  const res = await apiFetch(`/agents/${agent.id}/earn/withdraw`, {
+    method: "POST",
+    body: JSON.stringify({
+      network: "mainnet",
+      asset,
+      amount
+    })
+  }, token);
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    console.error("Earn withdraw failed:", data.error ?? res.statusText);
+    process.exit(1);
+  }
+  console.log("\nEarn withdraw submitted.");
+  console.log(`  Signature: ${data.signature}`);
+  console.log(`  Amount:    ${data.amount} ${asset.toUpperCase()}`);
+  console.log(`  Mode:      ${data.mode}`);
+  console.log(`  Explorer:  https://solscan.io/tx/${data.signature}
+`);
+}
 async function earnPositions(args2) {
   const agentName = args2[0];
   const mainnet = args2.includes("--mainnet");
@@ -1359,6 +1428,7 @@ var helpSpecs = {
     description: "Manage Jupiter Earn deposits and positions for hosted agent wallets.",
     commands: [
       ["deposit <agent> --asset USDC --amount <amount> --mainnet", "deposit mainnet USDC into Jupiter Earn"],
+      ["withdraw <agent> --asset USDC [--amount <amount>] --mainnet", "withdraw mainnet USDC from Jupiter Earn"],
       ["positions <agent> --mainnet [--all]", "show Jupiter Earn positions"],
       ["sweep [--dry-run|--no-dry-run]", "sweep all hosted agents mainnet USDC into Jupiter Earn"]
     ]
@@ -1373,6 +1443,16 @@ var helpSpecs = {
       ["-h, --help", "display help for command"]
     ]
   },
+  "earn withdraw": {
+    usage: "agentis earn withdraw <agent> --asset USDC [--amount <amount>] --mainnet",
+    description: "Withdraw mainnet USDC from Jupiter Earn back to a hosted agent wallet. Omitting --amount redeems the full USDC Earn position.",
+    options: [
+      ["--asset USDC", "asset to withdraw; currently USDC"],
+      ["--amount <amount>", "optional UI amount, for example 1 for 1 USDC"],
+      ["--mainnet", "required safety flag"],
+      ["-h, --help", "display help for command"]
+    ]
+  },
   "earn positions": {
     usage: "agentis earn positions <agent> --mainnet [--all]",
     description: "Show Jupiter Earn positions for a hosted agent wallet.",
@@ -1556,6 +1636,8 @@ ${green}${bold}Commands:${reset}
     --asset USDC                           asset to deposit
     --amount <amount>                      UI amount, e.g. 1 for 1 USDC
     --mainnet                              required safety flag
+  earn withdraw <agent> --mainnet          withdraw all USDC from Jupiter Earn
+    --amount <amount>                      optional UI amount, e.g. 1 for 1 USDC
   earn positions <agent> --mainnet         show Jupiter Earn positions
   earn sweep [--dry-run|--no-dry-run]      sweep all agents' mainnet USDC into Earn
 

package/package.json

@@ -1,11 +1,30 @@
 {
   "name": "@agentis-hq/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "bin": {
     "agentis": "dist/index.js"
   },
   "description": "Agentis CLI",
+  "keywords": [
+    "agentis",
+    "ai",
+    "agents",
+    "ai-agents",
+    "agentic",
+    "cli",
+    "solana",
+    "payments",
+    "crypto",
+    "wallet",
+    "agent-wallets",
+    "crypto-payments",
+    "x402",
+    "mpp",
+    "jupiter",
+    "umbra",
+    "mcp"
+  ],
   "exports": {
     "./package.json": "./package.json"
   },