use-agently 0.26.0 → 0.28.0

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.26.0",
+  version: "0.28.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: {
@@ -96385,6 +96385,13 @@ async function getBalance2(address, options) {
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { mkdir, rename, readFile, writeFile } from "node:fs/promises";
+function getMaxSpendPerCall(config2) {
+  const spend = config2.wallet?.spend;
+  if (spend && typeof spend === "object" && "max" in spend && typeof spend.max === "number") {
+    return spend.max;
+  }
+  return 0.1;
+}
 function getConfigDir(scope) {
   return scope === "local" ? join(process.cwd(), ".use-agently") : join(homedir(), ".use-agently");
 }
@@ -96495,7 +96502,7 @@ var balanceCommand = new Command("balance").description("Check wallet balance on
 // package.json
 var package_default2 = {
   name: "use-agently",
-  version: "0.26.0",
+  version: "0.28.0",
   description: "Use Agently CLI",
   homepage: "https://use-agently.com",
   bugs: "https://github.com/AgentlyHQ/use-agently/issues",
@@ -96519,7 +96526,7 @@ var package_default2 = {
     test: "bun test"
   },
   dependencies: {
-    "@use-agently/sdk": "0.26.0",
+    "@use-agently/sdk": "0.28.0",
     boxen: "^8.0.1",
     "cli-table3": "^0.6.5",
     commander: "^14.0.3",
@@ -96564,14 +96571,75 @@ function createDryRunFetch2() {
     }
   };
 }
+
+class SpendLimitExceeded extends Error {
+  requestedAmount;
+  maxSpendPerCall;
+  constructor(requestedAmount, maxSpendPerCall) {
+    super(`Payment of ${formatDollars(requestedAmount)} USDC exceeds your spend limit of ${formatDollars(maxSpendPerCall)} USDC per call.
+` + `Run "use-agently wallet spend set-max" to adjust — AI agents must ask the wallet owner for approval before changing spend limits.`);
+    this.name = "SpendLimitExceeded";
+    this.requestedAmount = requestedAmount;
+    this.maxSpendPerCall = maxSpendPerCall;
+  }
+}
+function createSpendLimitedFetch(baseFetch, maxSpendPerCall) {
+  return async (input, init) => {
+    const response = await baseFetch(input, init);
+    if (response.status === 402) {
+      const header = response.headers.get("PAYMENT-REQUIRED");
+      let requirements = [];
+      if (header) {
+        try {
+          const decoded = JSON.parse(Buffer.from(header, "base64").toString("utf-8"));
+          requirements = decoded.accepts ?? [];
+        } catch {}
+      } else {
+        try {
+          const body = await response.clone().json();
+          if (body?.accepts) {
+            requirements = body.accepts;
+          }
+        } catch {}
+      }
+      const req = requirements[0];
+      if (!req) {
+        throw new SpendLimitExceeded(NaN, maxSpendPerCall);
+      }
+      let amountInDollars;
+      try {
+        const { usdcDecimals } = getChainConfigByNetwork(req.network);
+        amountInDollars = Number(formatUnits(BigInt(req.amount), usdcDecimals));
+      } catch {
+        throw new SpendLimitExceeded(NaN, maxSpendPerCall);
+      }
+      if (amountInDollars > maxSpendPerCall) {
+        throw new SpendLimitExceeded(amountInDollars, maxSpendPerCall);
+      }
+    }
+    return response;
+  };
+}
 async function resolveFetch(pay) {
   if (pay) {
     const config2 = await getConfigOrThrow();
     const wallet = loadWallet(config2.wallet);
-    return createPaymentFetch(wallet, clientFetch2);
+    const maxSpend = getMaxSpendPerCall(config2);
+    const limitedFetch = createSpendLimitedFetch(clientFetch2, maxSpend);
+    return createPaymentFetch(wallet, limitedFetch);
   }
   return createDryRunFetch2();
 }
+function createSpendLimitedClient(maxSpendPerCall) {
+  return {
+    fetch: createSpendLimitedFetch(defaultClient.fetch, maxSpendPerCall)
+  };
+}
+function formatDollars(amount) {
+  if (Number.isNaN(amount))
+    return "$? (unknown)";
+  return `$${parseFloat(amount.toFixed(6))}`;
+}
 function formatUsdcAmount2(req) {
   try {
     const { usdcDecimals } = getChainConfigByNetwork(req.network);
@@ -96583,20 +96651,26 @@ function formatUsdcAmount2(req) {
     return `${req.amount} (raw units)`;
   }
 }
-function handleDryRunError(err) {
-  const cliErr = err instanceof DryRunPaymentRequired2 ? err : new DryRunPaymentRequired2(err.requirements);
+function handleErrorAndExit(title, message, borderColor) {
   if (process.stderr.isTTY) {
-    console.error(boxen(cliErr.message, {
-      title: "Payment Required",
+    console.error(boxen(message, {
+      title,
       titleAlignment: "center",
-      borderColor: "yellow",
+      borderColor,
       padding: 1
     }));
   } else {
-    console.error(`Payment Required: ${cliErr.message}`);
+    console.error(`${title}: ${message}`);
   }
   process.exit(1);
 }
+function handleDryRunError(err) {
+  const cliErr = err instanceof DryRunPaymentRequired2 ? err : new DryRunPaymentRequired2(err.requirements);
+  handleErrorAndExit("Payment Required", cliErr.message, "yellow");
+}
+function handleSpendLimitError(err) {
+  handleErrorAndExit("Spend Limit Exceeded", err.message, "red");
+}
 
 // src/commands/agents.ts
 var agentsCommand = new Command("agents").description("List available agents on Agently").action(async (_options, command) => {
@@ -96715,9 +96789,10 @@ async function resolveTransactionMode(pay) {
   if (pay) {
     const config2 = await getConfigOrThrow();
     const wallet = loadWallet(config2.wallet);
-    return PayTransaction(wallet);
+    const maxSpend = getMaxSpendPerCall(config2);
+    return { client: createSpendLimitedClient(maxSpend), mode: PayTransaction(wallet) };
   }
-  return DryRunTransaction;
+  return { client: defaultClient, mode: DryRunTransaction };
 }
 var a2aCommand = new Command("a2a").description("Send messages and fetch agent cards via the A2A protocol").action(function() {
   this.outputHelp();
@@ -96728,9 +96803,9 @@ Examples:
   use-agently a2a send --uri eip155:8453/erc8004:0x1234/1 -m "Hello!"
   use-agently a2a send --uri https://example.com/agent -m "Hello!" --pay`).action(async (options) => {
   const uri = options.uri;
-  const transaction = await resolveTransactionMode(options.pay);
+  const { client, mode: mode2 } = await resolveTransactionMode(options.pay);
   try {
-    const stream = await sendMessageStream(defaultClient, uri, options.message, { mode: transaction });
+    const stream = await sendMessageStream(client, uri, options.message, { mode: mode2 });
     let wroteText = false;
     let lastResult = null;
     for await (const event of stream) {
@@ -96748,6 +96823,8 @@ Examples:
       console.log(extractAgentText(lastResult));
     }
   } catch (err) {
+    if (err instanceof SpendLimitExceeded)
+      handleSpendLimitError(err);
     if (err instanceof DryRunPaymentRequired)
       handleDryRunError(err);
     throw err;
@@ -96765,13 +96842,21 @@ a2aCommand.addCommand(a2aSendCommand);
 a2aCommand.addCommand(a2aCardSubCommand);
 
 // src/commands/mcp.ts
-async function resolveTransactionMode2(pay) {
-  if (pay) {
-    const config2 = await getConfigOrThrow();
-    const wallet = loadWallet(config2.wallet);
-    return PayTransaction(wallet);
+function checkSpendLimit(err, maxSpendPerCall) {
+  const req = err.requirements[0];
+  if (!req) {
+    throw new SpendLimitExceeded(NaN, maxSpendPerCall);
+  }
+  let amountInDollars;
+  try {
+    const { usdcDecimals } = getChainConfigByNetwork(req.network);
+    amountInDollars = Number(formatUnits(BigInt(req.amount), usdcDecimals));
+  } catch {
+    throw new SpendLimitExceeded(NaN, maxSpendPerCall);
+  }
+  if (amountInDollars > maxSpendPerCall) {
+    throw new SpendLimitExceeded(amountInDollars, maxSpendPerCall);
   }
-  return DryRunTransaction;
 }
 var mcpCommand = new Command("mcp").description("Discover and call tools on MCP servers (always list tools before calling)").action(function() {
   this.outputHelp();
@@ -96801,70 +96886,104 @@ Examples:
 Expected a JSON object, e.g. --args '{"message":"hello"}'`);
     }
   }
-  const transaction = await resolveTransactionMode2(options.pay);
-  try {
-    const result = await callMcpTool(defaultClient, uri, tool, args, {
-      transaction,
-      clientInfo: { name: "use-agently", version: package_default2.version },
-      fetchImpl: clientFetch2
-    });
-    const content = result.content;
-    if (result.isError) {
-      const text = content?.find((c) => c.type === "text")?.text;
-      if (text) {
-        try {
-          const parsed = JSON.parse(text);
-          if (parsed?.error && Array.isArray(parsed?.accepts) && parsed.accepts.length > 0) {
-            let message;
-            if (parsed.error === "insufficient_funds") {
-              const req = parsed.accepts[0];
-              let amountStr = "unknown amount";
-              try {
-                const { usdcDecimals } = getChainConfigByNetwork(req.network);
-                const raw = formatUnits(BigInt(req.amount), usdcDecimals);
-                const formatted = raw.includes(".") ? raw.replace(/\.?0+$/, "") : raw;
-                amountStr = `$${formatted} USDC on ${req.network}`;
-              } catch {
-                amountStr = `${req.amount} (raw units)`;
-              }
-              message = `Insufficient funds to pay for this tool.
-Required: ${amountStr}
-Ensure your wallet has sufficient USDC balance and try again.`;
-            } else {
-              message = `Payment error: ${parsed.error}`;
-            }
-            if (process.stderr.isTTY) {
-              console.error(boxen(message, {
-                title: parsed.error === "insufficient_funds" ? "Insufficient Funds" : "Payment Error",
-                titleAlignment: "center",
-                borderColor: "red",
-                padding: 1
-              }));
-            } else {
-              const title = parsed.error === "insufficient_funds" ? "Insufficient Funds" : "Payment Error";
-              console.error(`${title}: ${message}`);
-            }
-            process.exit(1);
-          }
-        } catch {}
-        console.error(text);
+  const mcpClientInfo = { name: "use-agently", version: package_default2.version };
+  if (options.pay) {
+    const config2 = await getConfigOrThrow();
+    const wallet = loadWallet(config2.wallet);
+    const maxSpend = getMaxSpendPerCall(config2);
+    try {
+      const result = await callMcpTool(defaultClient, uri, tool, args, {
+        transaction: DryRunTransaction,
+        clientInfo: mcpClientInfo,
+        fetchImpl: clientFetch2
+      });
+      return outputMcpResult(result, command);
+    } catch (err) {
+      if (err instanceof DryRunPaymentRequired) {
+        checkSpendLimit(err, maxSpend);
       } else {
-        console.error("Tool call returned an error with no text content.");
+        throw err;
       }
-      process.exit(1);
     }
-    if (content?.every((c) => c.type === "text" && c.text)) {
-      const texts = content.map((c) => c.text);
-      output(command, texts.length === 1 ? texts[0] : texts);
-    } else {
-      output(command, result);
+    try {
+      const result = await callMcpTool(defaultClient, uri, tool, args, {
+        transaction: PayTransaction(wallet),
+        clientInfo: mcpClientInfo,
+        fetchImpl: clientFetch2
+      });
+      return outputMcpResult(result, command);
+    } catch (err) {
+      if (err instanceof SpendLimitExceeded)
+        handleSpendLimitError(err);
+      throw err;
     }
+  }
+  try {
+    const result = await callMcpTool(defaultClient, uri, tool, args, {
+      transaction: DryRunTransaction,
+      clientInfo: mcpClientInfo,
+      fetchImpl: clientFetch2
+    });
+    return outputMcpResult(result, command);
   } catch (err) {
     if (err instanceof DryRunPaymentRequired)
       handleDryRunError(err);
     throw err;
   }
 });
+function outputMcpResult(result, command) {
+  const content = result.content;
+  if (result.isError) {
+    const text = content?.find((c) => c.type === "text")?.text;
+    if (text) {
+      try {
+        const parsed = JSON.parse(text);
+        if (parsed?.error && Array.isArray(parsed?.accepts) && parsed.accepts.length > 0) {
+          let message;
+          if (parsed.error === "insufficient_funds") {
+            const req = parsed.accepts[0];
+            let amountStr = "unknown amount";
+            try {
+              const { usdcDecimals } = getChainConfigByNetwork(req.network);
+              const raw = formatUnits(BigInt(req.amount), usdcDecimals);
+              const formatted = raw.includes(".") ? raw.replace(/\.?0+$/, "") : raw;
+              amountStr = `$${formatted} USDC on ${req.network}`;
+            } catch {
+              amountStr = `${req.amount} (raw units)`;
+            }
+            message = `Insufficient funds to pay for this tool.
+Required: ${amountStr}
+Ensure your wallet has sufficient USDC balance and try again.`;
+          } else {
+            message = `Payment error: ${parsed.error}`;
+          }
+          if (process.stderr.isTTY) {
+            console.error(boxen(message, {
+              title: parsed.error === "insufficient_funds" ? "Insufficient Funds" : "Payment Error",
+              titleAlignment: "center",
+              borderColor: "red",
+              padding: 1
+            }));
+          } else {
+            const title = parsed.error === "insufficient_funds" ? "Insufficient Funds" : "Payment Error";
+            console.error(`${title}: ${message}`);
+          }
+          process.exit(1);
+        }
+      } catch {}
+      console.error(text);
+    } else {
+      console.error("Tool call returned an error with no text content.");
+    }
+    process.exit(1);
+  }
+  if (content?.every((c) => c.type === "text" && c.text)) {
+    const texts = content.map((c) => c.text);
+    output(command, texts.length === 1 ? texts[0] : texts);
+  } else {
+    output(command, result);
+  }
+}
 mcpCommand.addCommand(mcpToolsCommand);
 mcpCommand.addCommand(mcpCallCommand);
 
@@ -97073,6 +97192,9 @@ async function executeHttpRequest(method, url2, options, command) {
       process.exit(1);
   } catch (err) {
     clearTimeout(timer);
+    if (err instanceof SpendLimitExceeded) {
+      handleSpendLimitError(err);
+    }
     if (err instanceof DryRunPaymentRequired) {
       handleDryRunError(err);
     }
@@ -97234,6 +97356,33 @@ 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() {
+  this.outputHelp();
+});
+var spendCommand = new Command("spend").description("View or manage wallet spend limits").showHelpAfterError(true).addHelpText("after", `
+Examples:
+  use-agently wallet spend
+  use-agently wallet spend set-max 0.5`).action(async (_options, command) => {
+  const config2 = await getConfigOrThrow();
+  output(command, { max: getMaxSpendPerCall(config2) });
+});
+var setMaxCommand = new Command("set-max").description("Set the maximum USD spend per call").argument("<value>", "Max spend in USD (0–1, e.g. 0.5)").showHelpAfterError(true).addHelpText("after", `
+Examples:
+  use-agently wallet spend set-max 0.5
+  use-agently wallet spend set-max 1`).action(async (value, _options, command) => {
+  const amount = Number(value);
+  if (Number.isNaN(amount) || amount < 0 || amount > 1) {
+    throw new Error(`Invalid value "${value}". Must be a number between 0 and 1 (e.g. 0.1, 0.5, 1).`);
+  }
+  const config2 = await getConfigOrThrow();
+  config2.wallet.spend = { max: amount };
+  await saveConfig(config2);
+  output(command, { max: amount });
+});
+spendCommand.addCommand(setMaxCommand);
+walletCommand.addCommand(spendCommand);
+
 // src/cli.ts
 var cli = new Command;
 cli.name("use-agently").description("Agently is the way AI coordinate and transact. All protocol interactions (A2A, MCP, Web/HTTP) go through this CLI.").version(package_default2.version).option("-o, --output <format>", "Output format (tui, json)", process.stdout.isTTY ? "tui" : "json").argument("[args...]").action((args) => {
@@ -97253,6 +97402,7 @@ cli.addCommand(a2aCommand.helpGroup("Protocols"));
 cli.addCommand(mcpCommand.helpGroup("Protocols"));
 cli.addCommand(webCommand.helpGroup("Protocols"));
 cli.addCommand(initCommand.helpGroup("Lifecycle"));
+cli.addCommand(walletCommand.helpGroup("Lifecycle"));
 cli.addCommand(updateCommand.helpGroup("Lifecycle"));
 function enableGlobalOptionsInHelp(cmd) {
   for (const sub of cmd.commands) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-agently",
-  "version": "0.26.0",
+  "version": "0.28.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.26.0",
+    "@use-agently/sdk": "0.28.0",
     "boxen": "^8.0.1",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",