use-agently 0.29.0 → 0.31.0

package/README.md

@@ -7,6 +7,7 @@ Manage local EVM wallets, discover agents, and communicate with them via the [A2
 ## Install
 
 ```bash
+npx skills add https://github.com/agentlyhq/use-agently --skill use-agently
 npm install -g use-agently@latest
 ```
 

package/build/bin.js

@@ -91828,7 +91828,7 @@ function PayTransaction(wallet) {
 // ../use-agently-sdk/package.json
 var package_default = {
   name: "@use-agently/sdk",
-  version: "0.29.0",
+  version: "0.31.0",
   description: "Core SDK for the Agently platform — wallet management, A2A, MCP, x402 payments",
   homepage: "https://github.com/AgentlyHQ/use-agently/tree/main/packages/use-agently-sdk",
   bugs: {
@@ -96483,7 +96483,9 @@ Config: ~/.use-agently/config.json (global), .use-agently/config.json (local)`).
 });
 
 // src/commands/whoami.ts
-var whoamiCommand = new Command("whoami").description("Show current wallet info").showHelpAfterError(true).action(async (_options, command) => {
+var whoamiCommand = new Command("whoami").description("Show current wallet info").showHelpAfterError(true).addHelpText("after", `
+Examples:
+  use-agently whoami`).action(async (_options, command) => {
   const config2 = await getConfigOrThrow();
   const wallet = loadWallet(config2.wallet);
   output(command, {
@@ -96493,7 +96495,9 @@ var whoamiCommand = new Command("whoami").description("Show current wallet info"
 });
 
 // src/commands/balance.ts
-var balanceCommand = new Command("balance").description("Check wallet balance on-chain").option("--rpc <url>", "Custom RPC URL").showHelpAfterError(true).action(async (options, command) => {
+var balanceCommand = new Command("balance").description("Check wallet balance on-chain").option("--rpc <url>", "Custom RPC URL").showHelpAfterError(true).addHelpText("after", `
+Examples:
+  use-agently balance`).action(async (options, command) => {
   const config2 = await getConfigOrThrow();
   const wallet = loadWallet(config2.wallet);
   const result = await getBalance2(wallet.address, { rpc: options.rpc });
@@ -96502,7 +96506,7 @@ var balanceCommand = new Command("balance").description("Check wallet balance on
 // package.json
 var package_default2 = {
   name: "use-agently",
-  version: "0.29.0",
+  version: "0.31.0",
   description: "Use Agently CLI",
   homepage: "https://use-agently.com",
   bugs: "https://github.com/AgentlyHQ/use-agently/issues",
@@ -96526,7 +96530,7 @@ var package_default2 = {
     test: "bun test"
   },
   dependencies: {
-    "@use-agently/sdk": "0.29.0",
+    "@use-agently/sdk": "0.31.0",
     boxen: "^8.0.1",
     "cli-table3": "^0.6.5",
     commander: "^14.0.3",
@@ -96554,8 +96558,10 @@ class DryRunPaymentRequired2 extends DryRunPaymentRequired {
     const req = requirements[0];
     const amount = req ? formatUsdcAmount2(req) : null;
     this.message = amount ? `This request requires payment of ${amount}.
-Run the same command with --pay to authorize the transaction and proceed.` : `This request requires payment, but the amount could not be determined.
-Inspect the endpoint manually before running with --pay.`;
+Run the same command with --pay to authorize the transaction and proceed.
+Run "use-agently balance" to check your wallet address and balance, then send USDC on Base to fund it.` : `This request requires payment, but the amount could not be determined.
+Inspect the endpoint manually before running with --pay.
+Run "use-agently balance" to check your wallet address and balance.`;
   }
 }
 function createDryRunFetch2() {
@@ -96761,7 +96767,10 @@ async function resolveTransactionMode(pay) {
   }
   return { client: defaultClient, mode: DryRunTransaction };
 }
-var a2aCommand = new Command("a2a").description("Send messages and fetch agent cards via the A2A protocol").action(function() {
+var a2aCommand = new Command("a2a").description("Send messages and fetch agent cards via the A2A protocol").addHelpText("after", `
+Examples:
+  use-agently a2a send --uri <uri> -m "Hello!"
+  use-agently a2a card --uri <uri>`).action(function() {
   this.outputHelp();
 });
 var a2aSendCommand = new Command("send").description("Send a message to an agent via A2A protocol").requiredOption("-u, --uri <value>", "Agent URL or CAIP-19 ID (e.g. https://example.com/agent or eip155:8453/erc8004:0x1234/1)").requiredOption("-m, --message <text>", "Message to send").option("--pay", "Authorize payment if the agent requires it (default: dry-run, shows cost only)").showHelpAfterError(true).addHelpText("after", `
@@ -96825,7 +96834,10 @@ function checkSpendLimit(err, maxSpendPerCall) {
     throw new SpendLimitExceeded(amountInDollars, maxSpendPerCall);
   }
 }
-var mcpCommand = new Command("mcp").description("Discover and call tools on MCP servers (always list tools before calling)").action(function() {
+var mcpCommand = new Command("mcp").description("Discover and call tools on MCP servers (always list tools before calling)").addHelpText("after", `
+Examples:
+  use-agently mcp tools --uri <uri>
+  use-agently mcp call --uri <uri> --tool <name> --args '{"key":"value"}'`).action(function() {
   this.outputHelp();
 });
 var mcpToolsCommand = new Command("tools").description("List available tools on an MCP server").requiredOption("-u, --uri <value>", "MCP server URL or CAIP-19 ID").showHelpAfterError(true).addHelpText("after", `
@@ -96920,7 +96932,7 @@ function outputMcpResult(result, command) {
             }
             message = `Insufficient funds to pay for this tool.
 Required: ${amountStr}
-Ensure your wallet has sufficient USDC balance and try again.`;
+Run "use-agently balance" to check your wallet address and balance, then send USDC on Base to fund it.`;
           } else {
             message = `Payment error: ${parsed.error}`;
           }
@@ -97182,15 +97194,20 @@ function createMethodSubcommand(method, description, hasBody) {
   const cmd = new Command(method).description(description).argument("<url>", "Full URL to request (e.g. https://api.example.com/data)").showHelpAfterError(true);
   addSharedOptions(cmd, hasBody);
   const bodyExample = hasBody ? ` -d '{"key":"value"}' -H "Content-Type: application/json"` : "";
+  const payExample = !hasBody ? `
+  use-agently web ${method} https://api.example.com/paid-endpoint --pay` : "";
   cmd.addHelpText("after", `
 Examples:
-  use-agently web ${method} https://api.example.com/data${bodyExample} -v`);
+  use-agently web ${method} https://api.example.com/data${bodyExample} -v${payExample}`);
   cmd.action(async (url2, options, command) => {
     await executeHttpRequest(method, url2, options, command);
   });
   return cmd;
 }
-var webCommand = new Command("web").description("Make HTTP requests with automatic x402 payment support (GET, POST, PUT, PATCH, DELETE)").action(function() {
+var webCommand = new Command("web").description("Make HTTP requests with automatic x402 payment support (GET, POST, PUT, PATCH, DELETE)").addHelpText("after", `
+Examples:
+  use-agently web get https://api.example.com/data
+  use-agently web post https://api.example.com/data -d '{"key":"value"}' --pay`).action(function() {
   this.outputHelp();
 });
 webCommand.addCommand(createMethodSubcommand("get", "Make an HTTP GET request", false));
@@ -97201,6 +97218,9 @@ webCommand.addCommand(createMethodSubcommand("delete", "Make an HTTP DELETE requ
 
 // src/commands/doctor.ts
 var doctorCommand = new Command("doctor").description("Run environment checks and report any issues").option("--rpc <url>", "Custom RPC URL to use for network check").showHelpAfterError(true).addHelpText("after", `
+Examples:
+  use-agently doctor
+
 Config: ~/.use-agently/config.json (global), .use-agently/config.json (local)`).action(async (options, command) => {
   const checks3 = [];
   const config2 = await loadConfig();
@@ -97324,7 +97344,10 @@ var updateCommand = new Command("update").description("Update use-agently to the
 });
 
 // src/commands/wallet.ts
-var walletCommand = new Command("wallet").description("Manage wallet settings (spend limits)").action(function() {
+var walletCommand = new Command("wallet").description("Manage wallet settings (spend limits)").addHelpText("after", `
+Examples:
+  use-agently wallet spend
+  use-agently wallet spend set-max 0.5`).action(function() {
   this.outputHelp();
 });
 var spendCommand = new Command("spend").description("View or manage wallet spend limits").showHelpAfterError(true).addHelpText("after", `
@@ -97370,6 +97393,28 @@ cli.addCommand(webCommand.helpGroup("Protocols"));
 cli.addCommand(initCommand.helpGroup("Lifecycle"));
 cli.addCommand(walletCommand.helpGroup("Lifecycle"));
 cli.addCommand(updateCommand.helpGroup("Lifecycle"));
+cli.addHelpText("after", `
+Getting started: use-agently init → use-agently doctor → use-agently search
+
+Quick Reference:
+
+  Send a message or fetch an agent card via A2A:
+    a2a send -u <uri> -m <message> [--pay]
+    a2a card -u <uri>
+
+  List or call tools on an MCP server:
+    mcp tools -u <uri>
+    mcp call  -u <uri> --tool <name> [--args <json>] [--pay]
+
+  HTTP requests with x402 payment support:
+    web get|post|put|patch|delete <url> [-d <body>] [-H <header>] [-v] [--pay]
+
+  Manage wallet spend limits:
+    wallet spend
+    wallet spend set-max <value>
+
+  <uri> = HTTP URL or CAIP-19 ID (e.g. eip155:8453/erc8004:0x…/1)
+  Run "use-agently <command> -h" for full option details.`);
 function enableGlobalOptionsInHelp(cmd) {
   for (const sub of cmd.commands) {
     sub.configureHelp({ showGlobalOptions: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-agently",
-  "version": "0.29.0",
+  "version": "0.31.0",
   "description": "Use Agently CLI",
   "homepage": "https://use-agently.com",
   "bugs": "https://github.com/AgentlyHQ/use-agently/issues",
@@ -24,7 +24,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@use-agently/sdk": "0.29.0",
+    "@use-agently/sdk": "0.31.0",
     "boxen": "^8.0.1",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",