@agentis-hq/cli 0.3.2 → 0.4.1

package/dist/index.js

@@ -97,7 +97,9 @@ var SCOPES = [
   "privacy:read",
   "privacy:write",
   "earn:read",
-  "earn:write"
+  "earn:write",
+  "jupiter:read",
+  "jupiter:write"
 ];
 function base64url(bytes) {
   return Buffer.from(bytes).toString("base64url");
@@ -131,8 +133,8 @@ async function login() {
   const server = Bun.serve({
     hostname: "127.0.0.1",
     port: 0,
-    fetch(request) {
-      const url = new URL(request.url);
+    fetch(request2) {
+      const url = new URL(request2.url);
       if (url.pathname !== "/callback") return new Response("Not found", { status: 404 });
       if (!handled) {
         handled = true;
@@ -285,6 +287,9 @@ var DEFAULT_LOCAL_POLICY = {
   maxBudget: null,
   maxPerTx: null,
   allowedDomains: [],
+  allowedMints: [],
+  maxSlippageBps: null,
+  maxDailySwapVolume: null,
   killSwitch: false
 };
 function ensureVaultDir() {
@@ -837,6 +842,9 @@ Policy for ${name} (${scope}):`);
   console.log(`  Monthly limit:  ${p.monthlyLimit !== null ? `$${p.monthlyLimit}` : "unlimited"}`);
   console.log(`  Total budget:   ${p.maxBudget !== null ? `$${p.maxBudget}` : "unlimited"}`);
   console.log(`  Allowed domains: ${p.allowedDomains?.length > 0 ? p.allowedDomains.join(", ") : "all"}`);
+  console.log(`  Allowed mints:   ${p.allowedMints?.length > 0 ? p.allowedMints.join(", ") : "all"}`);
+  console.log(`  Max slippage:    ${p.maxSlippageBps !== null && p.maxSlippageBps !== void 0 ? `${p.maxSlippageBps} bps` : "unlimited"}`);
+  console.log(`  Daily swaps:     ${p.maxDailySwapVolume !== null && p.maxDailySwapVolume !== void 0 ? `$${p.maxDailySwapVolume}` : "unlimited"}`);
   console.log();
 }
 function applyPolicyFlags(existingPolicy, args2) {
@@ -852,6 +860,8 @@ function applyPolicyFlags(existingPolicy, args2) {
   if (get("--daily") !== void 0) policy.dailyLimit = parseFloat(get("--daily"));
   if (get("--monthly") !== void 0) policy.monthlyLimit = parseFloat(get("--monthly"));
   if (get("--budget") !== void 0) policy.maxBudget = parseFloat(get("--budget"));
+  if (get("--max-slippage-bps") !== void 0) policy.maxSlippageBps = parseInt(get("--max-slippage-bps"), 10);
+  if (get("--daily-swap-volume") !== void 0) policy.maxDailySwapVolume = parseFloat(get("--daily-swap-volume"));
   if (get("--allow")) {
     const domain = get("--allow").replace(/^https?:\/\//, "").toLowerCase();
     policy.allowedDomains = [.../* @__PURE__ */ new Set([...policy.allowedDomains ?? [], domain])];
@@ -860,6 +870,14 @@ function applyPolicyFlags(existingPolicy, args2) {
     const domain = get("--disallow").replace(/^https?:\/\//, "").toLowerCase();
     policy.allowedDomains = (policy.allowedDomains ?? []).filter((d) => d !== domain);
   }
+  if (get("--allow-mint")) {
+    const mint = get("--allow-mint");
+    policy.allowedMints = [.../* @__PURE__ */ new Set([...policy.allowedMints ?? [], mint])];
+  }
+  if (get("--disallow-mint")) {
+    const mint = get("--disallow-mint");
+    policy.allowedMints = (policy.allowedMints ?? []).filter((candidate) => candidate !== mint);
+  }
   return policy;
 }
 async function policyGet(nameOrId) {
@@ -1559,6 +1577,236 @@ async function earnSweep(args2) {
   await executeSweep(token, plan);
 }
 
+// src/commands/jupiter.ts
+function getFlag4(args2, flag2) {
+  const index = args2.indexOf(flag2);
+  return index === -1 ? void 0 : args2[index + 1];
+}
+function hasFlag3(args2, flag2) {
+  return args2.includes(flag2);
+}
+async function auth() {
+  const token = await getToken();
+  if (!token) {
+    console.error("Not logged in. Run `agentis login` first.");
+    process.exit(1);
+  }
+  return token;
+}
+async function request(path, token, init = {}) {
+  const response = await apiFetch(path, init, token);
+  const body = await response.json().catch(() => ({}));
+  if (!response.ok) throw new Error(body.error ?? `Agentis API failed (${response.status})`);
+  return body;
+}
+function tradeBody(args2) {
+  const input = getFlag4(args2, "--from");
+  const output = getFlag4(args2, "--to");
+  const amount = getFlag4(args2, "--amount");
+  const slippage = getFlag4(args2, "--slippage-bps");
+  if (!input || !output || !amount) {
+    throw new Error("--from, --to, and --amount are required");
+  }
+  return {
+    input,
+    output,
+    amount,
+    ...slippage ? { slippageBps: Number(slippage) } : {}
+  };
+}
+function printToken(token) {
+  const trust = token.audit?.isSus ? "suspicious" : token.isVerified ? "verified" : "unverified";
+  console.log(`  ${(token.symbol ?? "?").padEnd(10)} ${token.name ?? ""}`);
+  console.log(`             ${token.id}`);
+  console.log(`             ${trust} \xB7 decimals=${token.decimals} \xB7 organic=${token.organicScoreLabel ?? "unknown"}`);
+}
+async function financialCommand(args2) {
+  const area = args2[0];
+  const action = args2[1];
+  const token = await auth();
+  if (area === "tokens" && action === "search") {
+    const query = args2.slice(2).filter((value) => !value.startsWith("--")).join(" ").trim();
+    if (!query) throw new Error("Usage: agentis tokens search <query>");
+    const data = await request(`/agents/jupiter/tokens?query=${encodeURIComponent(query)}`, token);
+    if (hasFlag3(args2, "--json")) return console.log(JSON.stringify(data, null, 2));
+    console.log(`
+Jupiter tokens matching "${query}"
+`);
+    const matches = data.tokens ?? [];
+    for (const item of matches.slice(0, 20)) printToken(item);
+    if (matches.length > 20) console.log(`  ...and ${matches.length - 20} more. Use --json for the full result.`);
+    console.log();
+    return;
+  }
+  if (area === "swap" && (action === "quote" || action === "execute")) {
+    const agentName = args2[2];
+    if (!agentName) throw new Error(`Usage: agentis swap ${action} <agent> --from SOL --to USDC --amount 0.1`);
+    const agent = await resolveAccountAgent(agentName, token);
+    const data = await request(
+      `/agents/${agent.id}/jupiter/swap${action === "quote" ? "/quote" : ""}`,
+      token,
+      { method: "POST", body: JSON.stringify(tradeBody(args2.slice(3))) }
+    );
+    if (hasFlag3(args2, "--json")) return console.log(JSON.stringify(data, null, 2));
+    const quote = data.quote ?? data.order ?? {};
+    console.log(`
+Jupiter swap ${action === "quote" ? "quote" : "executed"} for ${agent.name}`);
+    console.log(`  ${data.amountUi} ${data.inputToken?.symbol ?? data.inputToken?.id} -> ${data.outputToken?.symbol ?? data.outputToken?.id}`);
+    console.log(`  Expected out: ${quote.outAmount ?? data.result?.outputAmountResult ?? "unknown"} atomic`);
+    console.log(`  Router:       ${quote.router ?? "unknown"}`);
+    if (data.result?.signature) console.log(`  Signature:    ${data.result.signature}`);
+    console.log();
+    return;
+  }
+  if (area === "portfolio") {
+    const agentName = args2[1];
+    if (!agentName) throw new Error("Usage: agentis portfolio <agent> [--json]");
+    const agent = await resolveAccountAgent(agentName, token);
+    const data = await request(`/agents/${agent.id}/jupiter/portfolio`, token);
+    if (hasFlag3(args2, "--json")) return console.log(JSON.stringify(data, null, 2));
+    const elements = data.portfolio?.elements ?? [];
+    console.log(`
+Jupiter portfolio for ${agent.name}`);
+    console.log(`  Positions: ${elements.length}`);
+    for (const item of elements.slice(0, 20)) {
+      console.log(`  ${(item.label ?? item.type ?? "position").padEnd(18)} $${Number(item.value ?? 0).toFixed(2)} \xB7 ${item.platformId ?? "jupiter"}`);
+    }
+    console.log();
+    return;
+  }
+  if (area === "recurring" && action === "list") {
+    const agentName = args2[2];
+    if (!agentName) throw new Error("Usage: agentis recurring list <agent> [--history] [--json]");
+    const agent = await resolveAccountAgent(agentName, token);
+    const status = hasFlag3(args2, "--history") ? "history" : "active";
+    const data = await request(`/agents/${agent.id}/jupiter/recurring?status=${status}`, token);
+    if (hasFlag3(args2, "--json")) return console.log(JSON.stringify(data, null, 2));
+    const orders = Array.isArray(data.orders) ? data.orders : data.orders?.orders ?? [];
+    console.log(`
+${status} Jupiter recurring orders for ${agent.name}`);
+    if (!orders.length) console.log("  None.");
+    for (const order of orders) {
+      console.log(`  ${order.orderKey ?? order.publicKey ?? order.id ?? "unknown"} \xB7 ${order.status ?? status}`);
+    }
+    console.log();
+    return;
+  }
+  if (area === "recurring" && action === "create") {
+    const agentName = args2[2];
+    if (!agentName) throw new Error("Usage: agentis recurring create <agent> --from USDC --to SOL --amount 100 --orders 2 --interval 86400");
+    const agent = await resolveAccountAgent(agentName, token);
+    const numberOfOrders = Number(getFlag4(args2, "--orders"));
+    const intervalSeconds = Number(getFlag4(args2, "--interval"));
+    const data = await request(`/agents/${agent.id}/jupiter/recurring`, token, {
+      method: "POST",
+      body: JSON.stringify({
+        ...tradeBody(args2.slice(3)),
+        numberOfOrders,
+        intervalSeconds,
+        startAt: getFlag4(args2, "--start-at") ? Number(getFlag4(args2, "--start-at")) : void 0
+      })
+    });
+    if (hasFlag3(args2, "--json")) return console.log(JSON.stringify(data, null, 2));
+    console.log(`
+Recurring order created for ${agent.name}`);
+    console.log(`  Order:     ${data.result?.order ?? "submitted"}`);
+    console.log(`  Signature: ${data.result?.signature ?? "unknown"}
+`);
+    return;
+  }
+  if (area === "recurring" && action === "cancel") {
+    const agentName = args2[2];
+    const order = args2[3];
+    if (!agentName || !order) throw new Error("Usage: agentis recurring cancel <agent> <order>");
+    const agent = await resolveAccountAgent(agentName, token);
+    const data = await request(`/agents/${agent.id}/jupiter/recurring/${encodeURIComponent(order)}/cancel`, token, { method: "POST" });
+    if (hasFlag3(args2, "--json")) return console.log(JSON.stringify(data, null, 2));
+    console.log(`
+Recurring order cancelled for ${agent.name}`);
+    console.log(`  Signature: ${data.result?.signature ?? "unknown"}
+`);
+    return;
+  }
+  console.log("Usage: agentis <tokens|swap|portfolio|recurring> ...");
+}
+
+// src/lib/command-validation.ts
+var commandTree = {
+  login: null,
+  logout: null,
+  whoami: null,
+  version: null,
+  wallet: ["create", "list"],
+  agent: ["create", "send", "balance"],
+  fetch: null,
+  earn: ["deposit", "withdraw", "positions", "sweep"],
+  tokens: ["search"],
+  swap: ["quote", "execute"],
+  portfolio: null,
+  recurring: ["list", "create", "cancel"],
+  facilitator: ["create", "list", "publish"],
+  privacy: ["status", "register", "balance", "deposit", "withdraw", "create-utxo", "scan", "claim-latest"],
+  policy: ["get", "set", "init-onchain"]
+};
+var CliCommandError = class extends Error {
+  constructor(message, helpCommand = "agentis --help") {
+    super(message);
+    this.helpCommand = helpCommand;
+    this.name = "CliCommandError";
+  }
+  helpCommand;
+};
+function editDistance(left, right) {
+  const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+  for (let i = 1; i <= left.length; i++) {
+    const current = [i];
+    for (let j = 1; j <= right.length; j++) {
+      current[j] = Math.min(
+        current[j - 1] + 1,
+        previous[j] + 1,
+        previous[j - 1] + (left[i - 1] === right[j - 1] ? 0 : 1)
+      );
+    }
+    previous.splice(0, previous.length, ...current);
+  }
+  return previous[right.length];
+}
+function closestMatch(value, choices) {
+  const ranked = choices.map((choice) => ({ choice, distance: editDistance(value, choice) })).sort((a, b) => a.distance - b.distance);
+  const best = ranked[0];
+  if (!best) return null;
+  const threshold = Math.max(1, Math.floor(Math.max(value.length, best.choice.length) / 3));
+  return best.distance <= threshold ? best.choice : null;
+}
+function unknownMessage(kind, value, suggestion, parent) {
+  const context = kind === "subcommand" ? ` for "${parent}"` : "";
+  return `Unknown ${kind} "${value}"${context}.${suggestion ? ` Did you mean "${suggestion}"?` : ""}`;
+}
+function validateCommand(args2) {
+  const command = args2[0];
+  if (!command || command === "--version" || command === "-v" || command === "--help" || command === "-h") return;
+  const subcommands = commandTree[command];
+  if (subcommands === void 0) {
+    throw new CliCommandError(
+      unknownMessage("command", command, closestMatch(command, Object.keys(commandTree)))
+    );
+  }
+  if (!subcommands) return;
+  const subcommand = args2[1];
+  const hasHelp = args2.includes("--help") || args2.includes("-h");
+  if (!subcommand) {
+    if (hasHelp) return;
+    throw new CliCommandError(`Missing command for "${command}".`, `agentis ${command} --help`);
+  }
+  if (subcommand.startsWith("-") && hasHelp) return;
+  if (!subcommands.includes(subcommand)) {
+    throw new CliCommandError(
+      unknownMessage("subcommand", subcommand, closestMatch(subcommand, subcommands), command),
+      `agentis ${command} --help`
+    );
+  }
+}
+
 // src/index.ts
 var args = process.argv.slice(2);
 var cmd = args[0];
@@ -1670,6 +1918,31 @@ var helpSpecs = {
       ["sweep [--dry-run|--no-dry-run]", "sweep all hosted agents mainnet USDC into Jupiter Earn"]
     ]
   },
+  swap: {
+    usage: "agentis swap <quote|execute> <agent> --from <token> --to <token> --amount <ui>",
+    description: "Quote or execute policy-controlled swaps through Jupiter.",
+    commands: [
+      ["quote <agent> --from <token> --to <token> --amount <ui>", "get a policy-checked quote"],
+      ["execute <agent> --from <token> --to <token> --amount <ui>", "execute the swap"]
+    ]
+  },
+  tokens: {
+    usage: "agentis tokens search <query> [--json]",
+    description: "Search Jupiter token metadata and safety signals."
+  },
+  portfolio: {
+    usage: "agentis portfolio <agent> [--json]",
+    description: "Show mainnet Jupiter portfolio positions."
+  },
+  recurring: {
+    usage: "agentis recurring <list|create|cancel> ...",
+    description: "Manage Jupiter time-based recurring swaps.",
+    commands: [
+      ["list <agent> [--history] [--json]", "list active or historical orders"],
+      ["create <agent> --from <token> --to <token> --amount <ui> --orders <n> --interval <seconds>", "create an order"],
+      ["cancel <agent> <order>", "cancel an active order"]
+    ]
+  },
   "earn deposit": {
     usage: "agentis earn deposit <agent> --asset USDC --amount <amount> --mainnet",
     description: "Deposit mainnet USDC from a hosted agent wallet into Jupiter Earn.",
@@ -1829,6 +2102,10 @@ var helpSpecs = {
       ["--budget <usd>", "total lifetime budget cap"],
       ["--allow <domain>", "add domain to whitelist"],
       ["--disallow <domain>", "remove domain from whitelist"],
+      ["--allow-mint <mint>", "add token mint to Jupiter allowlist"],
+      ["--disallow-mint <mint>", "remove token mint from Jupiter allowlist"],
+      ["--max-slippage-bps <bps>", "maximum Jupiter swap slippage"],
+      ["--daily-swap-volume <usd>", "maximum Jupiter volume per 24 hours"],
       ["-h, --help", "display help for command"]
     ]
   },
@@ -1878,6 +2155,14 @@ ${green2}${bold}Commands:${reset2}
   earn positions <agent> --mainnet         show Jupiter Earn positions
   earn sweep [--dry-run|--no-dry-run]      sweep all agents' mainnet USDC into Earn
 
+  tokens search <query>                     search token metadata and safety
+  swap quote <agent>                        quote a mainnet Jupiter swap
+  swap execute <agent>                      execute a policy-checked swap
+  portfolio <agent>                         show Jupiter portfolio positions
+  recurring list <agent>                    list active or historical DCA orders
+  recurring create <agent>                  create a time-based DCA order
+  recurring cancel <agent> <order>          cancel a DCA order
+
   facilitator create <name>                scaffold a Kora-backed x402 facilitator
     --dir <path>                           output directory
     --fee-bps <bps>                        prepaid seller fee rate (default 500)
@@ -1909,6 +2194,10 @@ ${green2}${bold}Commands:${reset2}
     --budget <usd>                         total lifetime budget cap
     --allow <domain>                       add domain to whitelist
     --disallow <domain>                    remove domain from whitelist
+    --allow-mint <mint>                    add token mint to Jupiter allowlist
+    --disallow-mint <mint>                 remove token mint from Jupiter allowlist
+    --max-slippage-bps <bps>               maximum Jupiter swap slippage
+    --daily-swap-volume <usd>              maximum Jupiter volume per 24 hours
 `);
 }
 function hasHelpFlag(values) {
@@ -1943,6 +2232,7 @@ function showCommandHelp(path) {
   console.log();
 }
 async function main() {
+  validateCommand(args);
   if (cmd === "--version" || cmd === "-v" || cmd === "version") {
     console.log(version);
     return;
@@ -1969,8 +2259,6 @@ async function main() {
         case "list":
           await walletList(args.slice(2));
           break;
-        default:
-          console.log("Usage: agentis wallet <create|list>");
       }
       break;
     case "agent":
@@ -1984,8 +2272,6 @@ async function main() {
         case "balance":
           await agentBalance(args[2]);
           break;
-        default:
-          console.log("Usage: agentis agent <create|send|balance>");
       }
       break;
     case "policy":
@@ -1999,8 +2285,6 @@ async function main() {
         case "init-onchain":
           await policyInitOnchain(args[2]);
           break;
-        default:
-          console.log("Usage: agentis policy <get|set|init-onchain>");
       }
       break;
     case "fetch":
@@ -2015,11 +2299,21 @@ async function main() {
     case "earn":
       await earnCommand(args.slice(1));
       break;
-    default:
-      showHelp();
+    case "tokens":
+    case "swap":
+    case "portfolio":
+    case "recurring":
+      await financialCommand(args);
+      break;
   }
 }
 main().catch((err) => {
-  console.error("Error:", err.message);
+  if (err instanceof CliCommandError) {
+    console.error(`Error: ${err.message}
+
+Run \`${err.helpCommand}\` for usage.`);
+  } else {
+    console.error("Error:", err instanceof Error ? err.message : String(err));
+  }
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentis-hq/cli",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "type": "module",
   "bin": {
     "agentis": "dist/index.js"
@@ -41,8 +41,8 @@
     "check": "bun --check src/index.ts"
   },
   "dependencies": {
-    "@agentis-hq/core": "^0.1.0",
-    "@agentis-hq/sdk": "^0.1.0",
+    "@agentis-hq/core": "^0.2.0",
+    "@agentis-hq/sdk": "^0.2.0",
     "@napi-rs/keyring": "^1.2.0",
     "@noble/ciphers": "^2.2.0",
     "@noble/curves": "^2.2.0",