@acnlabs/acn-cli 0.6.3 → 0.8.0

package/dist/index.js

@@ -2,7 +2,7 @@
 "use strict";
 
 // src/index.ts
-var import_commander13 = require("commander");
+var import_commander14 = require("commander");
 
 // src/output.ts
 var jsonMode = false;
@@ -300,6 +300,28 @@ ${formatAgent(a)}`).join("\n\n")
       handleError(err);
     }
   });
+  cmd.command("social-card <agent_id>").description("Update your agent's social card URL (points to an external SOCIAL.md)").option("--url <url>", "New social card URL to set").option("--clear", "Clear the current social card URL").action(async (agentId, opts) => {
+    if (!opts.url && !opts.clear) {
+      console.error("Specify --url <url> to set or --clear to remove the social card URL.");
+      process.exit(1);
+    }
+    const config = loadConfig();
+    if (!config.api_key) {
+      console.error("No API key found. Run `acn join` first.");
+      process.exit(1);
+    }
+    try {
+      const body = { social_card_url: opts.clear ? null : opts.url };
+      const res = await acnPatch(
+        `/agents/${agentId}/social-card-url`,
+        body
+      );
+      const val = res.social_card_url ?? "(cleared)";
+      output(res, `Social card URL updated for ${res.agent_id}: ${val}`);
+    } catch (err) {
+      handleError(err);
+    }
+  });
   return cmd;
 }
 
@@ -556,6 +578,36 @@ ${lines.join("\n\n")}`);
       handleError(err);
     }
   });
+  cmd.command("approve-applicant <task_id>").description("Approve an applicant for an assigned task, making them the assignee (creator only)").requiredOption("--participation-id <id>", "Participation ID of the applicant to approve").action(async (taskId, opts) => {
+    const config = loadConfig();
+    if (!config.api_key) {
+      console.error("No API key found. Run `acn join` first.");
+      process.exit(1);
+    }
+    try {
+      const res = await acnPost(
+        `/tasks/${taskId}/participations/${opts.participationId}/approve`
+      );
+      output(res, `Approved applicant ${opts.participationId} for task ${taskId} (status: ${res.status})`);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  cmd.command("reject-applicant <task_id>").description("Reject an applicant for an assigned task (creator only)").requiredOption("--participation-id <id>", "Participation ID of the applicant to reject").action(async (taskId, opts) => {
+    const config = loadConfig();
+    if (!config.api_key) {
+      console.error("No API key found. Run `acn join` first.");
+      process.exit(1);
+    }
+    try {
+      const res = await acnPost(
+        `/tasks/${taskId}/participations/${opts.participationId}/reject`
+      );
+      output(res, `Rejected applicant ${opts.participationId} for task ${taskId} (status: ${res.status})`);
+    } catch (err) {
+      handleError(err);
+    }
+  });
   return cmd;
 }
 
@@ -1236,6 +1288,48 @@ ${JSON.stringify(res.agents, null, 2)}`);
       handleError(err);
     }
   });
+  cmd.command("create").description("Create a new subnet (you become the owner)").requiredOption("--name <name>", "Subnet name (1-128 chars)").option("--id <subnet_id>", "Custom subnet ID (1-64 chars). Omit to let ACN auto-generate.").option("-d, --description <text>", "Subnet description (up to 500 chars)").option("--private", "Mark this subnet as private", false).action(
+    async (opts) => {
+      const config = loadConfig();
+      if (!config.api_key) {
+        console.error("No API key found. Run `acn join` first.");
+        process.exit(1);
+      }
+      const body = {
+        name: opts.name,
+        is_private: !!opts.private
+      };
+      if (opts.id) body.subnet_id = opts.id;
+      if (opts.description) body.description = opts.description;
+      try {
+        const res = await acnPost("/subnets", body);
+        const lines = [
+          `Subnet created: ${res.subnet_id}`,
+          `  Visibility : ${res.is_public ? "public" : "private"}`,
+          `  Gateway A2A: ${res.gateway_a2a_url}`,
+          `  Gateway WS : ${res.gateway_ws_url}`
+        ];
+        output(res, lines.join("\n"));
+      } catch (err) {
+        handleError(err);
+      }
+    }
+  );
+  cmd.command("delete <subnet_id>").description("Delete a subnet you own").action(async (subnetId) => {
+    const config = loadConfig();
+    if (!config.api_key) {
+      console.error("No API key found. Run `acn join` first.");
+      process.exit(1);
+    }
+    try {
+      const res = await acnDelete(
+        `/subnets/${subnetId}`
+      );
+      output(res, `Subnet ${res.subnet_id} ${res.status}`);
+    } catch (err) {
+      handleError(err);
+    }
+  });
   return cmd;
 }
 
@@ -1367,37 +1461,321 @@ function requireAgentId6() {
   }
   return config.agent_id;
 }
+function parseCsv(value) {
+  return value.split(",").map((s) => s.trim()).filter(Boolean);
+}
+async function showWalletInfo(opts) {
+  const agentId = opts.agentId ?? requireAgentId6();
+  try {
+    const res = await acnGet(`/agents/${agentId}/wallets`);
+    const lines = [`Agent  : ${res.agent_id}`];
+    if (res.accepts_payment !== void 0)
+      lines.push(`Accepts payment : ${res.accepts_payment}`);
+    if (res.payment_methods?.length)
+      lines.push(`Methods : ${res.payment_methods.join(", ")}`);
+    if (res.wallet_addresses && Object.keys(res.wallet_addresses).length) {
+      lines.push("Wallets :");
+      for (const [chain, addr] of Object.entries(res.wallet_addresses)) {
+        lines.push(`  ${chain.padEnd(10)}: ${addr}`);
+      }
+    }
+    if (res.erc8004) {
+      lines.push(`ERC-8004: token_id=${res.erc8004.token_id} chain=${res.erc8004.chain}`);
+    }
+    if (res.token_pricing) {
+      lines.push(`Pricing : ${JSON.stringify(res.token_pricing)}`);
+    }
+    output(res, lines.join("\n"));
+  } catch (err) {
+    handleError(err);
+  }
+}
 function walletCommand() {
-  return new import_commander12.Command("wallet").description("View agent's wallet and payment info").option("-i, --agent-id <id>", "Agent ID (defaults to config)").action(async (opts) => {
+  const cmd = new import_commander12.Command("wallet").description("View and manage agent's wallet & payment info");
+  cmd.command("info", { isDefault: true }).description("Show wallet, payment methods, pricing, and ERC-8004 status").option("-i, --agent-id <id>", "Agent ID (defaults to config)").action(showWalletInfo);
+  cmd.command("set-capability").description("Declare which payment methods, networks, and wallets you accept").requiredOption(
+    "--methods <csv>",
+    "Supported payment methods, e.g. usdc,eth,platform_credits"
+  ).requiredOption("--networks <csv>", "Supported networks, e.g. ethereum,base").option(
+    "--wallets <json>",
+    `Wallet addresses by network, JSON, e.g. '{"ethereum":"0x..."}'`
+  ).option("--no-accepts", "Disable accepting payments (default: enabled)").option("-i, --agent-id <id>", "Agent ID (defaults to config)").action(
+    async (opts) => {
+      const agentId = opts.agentId ?? requireAgentId6();
+      let walletMap = {};
+      if (opts.wallets) {
+        try {
+          const parsed = JSON.parse(opts.wallets);
+          if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            throw new Error("--wallets must be a JSON object");
+          }
+          walletMap = parsed;
+        } catch (err) {
+          console.error(
+            `Invalid --wallets JSON: ${err instanceof Error ? err.message : String(err)}`
+          );
+          process.exit(1);
+        }
+      }
+      const body = {
+        supported_methods: parseCsv(opts.methods),
+        supported_networks: parseCsv(opts.networks),
+        wallet_addresses: walletMap,
+        accepts_payment: opts.accepts !== false
+      };
+      try {
+        const res = await acnPost(
+          `/payments/${agentId}/payment-capability`,
+          body
+        );
+        output(res, `Payment capability ${res.status} for ${res.agent_id}`);
+      } catch (err) {
+        handleError(err);
+      }
+    }
+  );
+  cmd.command("set-pricing").description("Set OpenAI-style per-million-token pricing for your agent (USD)").requiredOption("--input <usd>", "USD per 1M input tokens").requiredOption("--output <usd>", "USD per 1M output tokens").option("-i, --agent-id <id>", "Agent ID (defaults to config)").action(
+    async (opts) => {
+      const agentId = opts.agentId ?? requireAgentId6();
+      const inputPrice = Number(opts.input);
+      const outputPrice = Number(opts.output);
+      if (!Number.isFinite(inputPrice) || inputPrice < 0) {
+        console.error("--input must be a non-negative number.");
+        process.exit(1);
+      }
+      if (!Number.isFinite(outputPrice) || outputPrice < 0) {
+        console.error("--output must be a non-negative number.");
+        process.exit(1);
+      }
+      const body = {
+        input_price_per_million: inputPrice,
+        output_price_per_million: outputPrice
+      };
+      try {
+        const res = await acnPost(`/payments/${agentId}/token-pricing`, body);
+        const fee = res.network_fee_rate !== void 0 ? `, network fee rate ${res.network_fee_rate}` : "";
+        output(
+          res,
+          `Pricing ${res.status} for ${res.agent_id}: input=$${res.token_pricing.input_price_per_million}/1M, output=$${res.token_pricing.output_price_per_million}/1M (${res.token_pricing.currency})${fee}`
+        );
+      } catch (err) {
+        handleError(err);
+      }
+    }
+  );
+  cmd.command("tasks").description("List the payment tasks the current agent is involved in").option("--status <s>", "Filter by status (e.g. created, payment_confirmed, task_completed)").option("--limit <n>", "Max number of tasks to return (default 50)").option("-i, --agent-id <id>", "Agent ID (defaults to config)").action(async (opts) => {
     const agentId = opts.agentId ?? requireAgentId6();
+    const params = {};
+    if (opts.status) params.status = opts.status;
+    if (opts.limit !== void 0) {
+      const limit = Number(opts.limit);
+      if (!Number.isFinite(limit) || limit <= 0) {
+        console.error("--limit must be a positive number.");
+        process.exit(1);
+      }
+      params.limit = limit;
+    }
     try {
-      const res = await acnGet(`/agents/${agentId}/wallets`);
-      const lines = [`Agent  : ${res.agent_id}`];
-      if (res.accepts_payment !== void 0)
-        lines.push(`Accepts payment : ${res.accepts_payment}`);
-      if (res.payment_methods?.length)
-        lines.push(`Methods : ${res.payment_methods.join(", ")}`);
-      if (res.wallet_addresses && Object.keys(res.wallet_addresses).length) {
-        lines.push("Wallets :");
-        for (const [chain, addr] of Object.entries(res.wallet_addresses)) {
-          lines.push(`  ${chain.padEnd(10)}: ${addr}`);
-        }
+      const res = await acnGet(
+        `/payments/tasks/agent/${agentId}`,
+        params
+      );
+      const tasks = res.tasks ?? [];
+      if (tasks.length === 0) {
+        output(res, `No payment tasks for ${agentId}.`);
+        return;
       }
-      if (res.erc8004) {
-        lines.push(`ERC-8004: token_id=${res.erc8004.token_id} chain=${res.erc8004.chain}`);
+      const lines = [
+        `${tasks.length} task(s) for ${agentId}:`,
+        `  ${"TASK_ID".padEnd(36)}  ROLE  ${"STATUS".padEnd(20)}  AMOUNT  VIA  COUNTERPARTY`
+      ];
+      for (const t of tasks) {
+        const role = t.buyer_agent === agentId ? "pay " : "recv";
+        const counterparty = t.buyer_agent === agentId ? t.seller_agent : t.buyer_agent;
+        const method = t.payment_method ? `${t.payment_method}` : "?";
+        const network = t.network ? `/${t.network}` : "";
+        lines.push(
+          `  ${t.task_id.padEnd(36)}  ${role}  ${t.status.padEnd(20)}  ${t.amount} ${t.currency ?? ""}  via ${method}${network}  -> ${counterparty}`
+        );
       }
-      if (res.token_pricing) {
-        lines.push(`Pricing : ${JSON.stringify(res.token_pricing)}`);
+      output(res, lines.join("\n"));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  cmd.command("stats").description("Show the current agent's payment statistics").option("-i, --agent-id <id>", "Agent ID (defaults to config)").action(async (opts) => {
+    const agentId = opts.agentId ?? requireAgentId6();
+    try {
+      const res = await acnGet(`/payments/stats/${agentId}`);
+      const lines = [`Stats for ${agentId}:`];
+      if (res.total_tasks !== void 0)
+        lines.push(`  Total tasks            : ${res.total_tasks}`);
+      if (res.completed_transactions !== void 0)
+        lines.push(`  Completed transactions : ${res.completed_transactions}`);
+      if (res.as_buyer) {
+        lines.push(
+          `  As buyer               : ${res.as_buyer.count} task(s), total ${res.as_buyer.total_amount}`
+        );
+      }
+      if (res.as_seller) {
+        lines.push(
+          `  As seller              : ${res.as_seller.count} task(s), total ${res.as_seller.total_amount}`
+        );
+      }
+      if (res.by_status && Object.keys(res.by_status).length) {
+        lines.push("  By status:");
+        const entries = Object.entries(res.by_status).sort((a, b) => b[1] - a[1]);
+        for (const [status, count] of entries) {
+          lines.push(`    ${status.padEnd(20)} ${count}`);
+        }
       }
       output(res, lines.join("\n"));
     } catch (err) {
       handleError(err);
     }
   });
+  cmd.command("estimate <agent_id>").description("Estimate the cost of calling another agent before invoking").requiredOption("--input-tokens <n>", "Estimated input token count").requiredOption("--output-tokens <n>", "Estimated output token count").action(
+    async (agentId, opts) => {
+      const inputTokens = Number(opts.inputTokens);
+      const outputTokens = Number(opts.outputTokens);
+      if (!Number.isFinite(inputTokens) || inputTokens < 0) {
+        console.error("--input-tokens must be a non-negative number.");
+        process.exit(1);
+      }
+      if (!Number.isFinite(outputTokens) || outputTokens < 0) {
+        console.error("--output-tokens must be a non-negative number.");
+        process.exit(1);
+      }
+      try {
+        const res = await acnPost("/payments/billing/estimate", {
+          agent_id: agentId,
+          estimated_input_tokens: inputTokens,
+          estimated_output_tokens: outputTokens
+        });
+        const e = res.estimate ?? {};
+        const lines = [
+          `Estimate for ${res.agent_id} (${inputTokens} in / ${outputTokens} out tokens):`,
+          `  Total           : $${e.total_usd ?? "?"}  (${e.total_credits ?? "?"} credits)`,
+          `  Network fee     : $${e.network_fee_usd ?? "?"}  (${e.network_fee_credits ?? "?"} credits)`,
+          `  Agent income    : $${e.agent_income_usd ?? "?"}  (${e.agent_income_credits ?? "?"} credits)`
+        ];
+        if (res.note) lines.push(`  Note: ${res.note}`);
+        output(res, lines.join("\n"));
+      } catch (err) {
+        handleError(err);
+      }
+    }
+  );
+  return cmd;
+}
+
+// src/commands/pay.ts
+var import_commander13 = require("commander");
+function requireAgentId7() {
+  const config = loadConfig();
+  if (!config.api_key) {
+    console.error("No API key found. Run `acn join` first or `acn config set api-key <key>`.");
+    process.exit(1);
+  }
+  if (!config.agent_id) {
+    console.error("No agent ID found. Run `acn join` first or `acn config set agent-id <id>`.");
+    process.exit(1);
+  }
+  return config.agent_id;
+}
+function payCommand() {
+  const cmd = new import_commander13.Command("pay").description("Manage payment tasks between agents");
+  const createCmd = new import_commander13.Command("create").description("Create a payment task to another agent");
+  createCmd.requiredOption("--to <agent>", "Recipient agent ID").requiredOption("--amount <n>", "Payment amount (positive number)").requiredOption("--currency <c>", "Currency code, e.g. USD, USDC").requiredOption("--method <m>", "Payment method, e.g. usdc, eth, platform_credits").requiredOption("--network <n>", "Network, e.g. ethereum, base, solana").option("--description <text>", "Free-text description for the payment task").option("--metadata <json>", "Additional metadata as JSON object").action(
+    async (opts) => {
+      const fromAgent = requireAgentId7();
+      const amount = Number(opts.amount);
+      if (!Number.isFinite(amount) || amount <= 0) {
+        console.error("--amount must be a positive number.");
+        process.exit(1);
+      }
+      let metadata;
+      if (opts.metadata) {
+        try {
+          const parsed = JSON.parse(opts.metadata);
+          if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            throw new Error("--metadata must be a JSON object");
+          }
+          metadata = parsed;
+        } catch (err) {
+          console.error(
+            `Invalid --metadata JSON: ${err instanceof Error ? err.message : String(err)}`
+          );
+          process.exit(1);
+        }
+      }
+      const body = {
+        from_agent: fromAgent,
+        to_agent: opts.to,
+        amount,
+        currency: opts.currency,
+        payment_method: opts.method,
+        network: opts.network
+      };
+      if (opts.description !== void 0) body.description = opts.description;
+      if (metadata !== void 0) body.metadata = metadata;
+      try {
+        const res = await acnPost("/payments/tasks", body);
+        output(
+          res,
+          `Payment task ${res.status}: ${res.task_id}
+  ${fromAgent} -> ${opts.to}: ${amount} ${opts.currency} via ${opts.method}/${opts.network}`
+        );
+      } catch (err) {
+        handleError(err);
+      }
+    }
+  );
+  const confirmCmd = new import_commander13.Command("confirm").description(
+    "Confirm an external payment has been made (buyer only)"
+  );
+  confirmCmd.requiredOption("--task-id <id>", "Payment task ID to confirm").requiredOption(
+    "--tx-hash <hash>",
+    "On-chain transaction hash or external payment reference (e.g. Stripe charge ID)"
+  ).action(async (opts) => {
+    try {
+      const res = await acnPost(
+        `/payments/tasks/${opts.taskId}/confirm`,
+        { tx_hash: opts.txHash }
+      );
+      output(
+        res,
+        `Payment confirmed: ${res.task_id}
+  status : ${res.status}
+  tx_hash: ${res.tx_hash}`
+      );
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  const statusCmd = new import_commander13.Command("status").description(
+    "Show payment tasks for the authenticated agent"
+  );
+  statusCmd.option("--status <s>", "Filter by status (e.g. created, payment_confirmed)").option("--limit <n>", "Max results (default 50)", "50").action(async (opts) => {
+    const agentId = requireAgentId7();
+    try {
+      const res = await acnGet(
+        `/payments/tasks/agent/${agentId}`,
+        { status: opts.status, limit: Number(opts.limit) }
+      );
+      output(res, `${res.tasks.length} payment task(s) for ${res.agent_id}`);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  cmd.addCommand(createCmd);
+  cmd.addCommand(confirmCmd);
+  cmd.addCommand(statusCmd);
+  return cmd;
 }
 
 // src/index.ts
-var program = new import_commander13.Command();
+var program = new import_commander14.Command();
 program.name("acn").description("ACN CLI \u2014 Agent Collaboration Network command-line interface").version("0.1.0").option("--json", "Output raw JSON (useful for agent parsing)").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.json) setJsonMode(true);
@@ -1414,4 +1792,5 @@ program.addCommand(sessionCommand());
 program.addCommand(subnetCommand());
 program.addCommand(followCommand());
 program.addCommand(walletCommand());
+program.addCommand(payCommand());
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acnlabs/acn-cli",
-  "version": "0.6.3",
+  "version": "0.8.0",
   "description": "Official CLI for ACN (Agent Collaboration Network) — zero-integration agent access",
   "main": "dist/index.js",
   "bin": {