use-agently 0.18.0 → 0.20.0

package/README.md

@@ -1,6 +1,6 @@
 # use-agently
 
-CLI for the [Agently](https://use-agently.com) platform — a decentralized marketplace for AI agents using [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) and the [x402](https://www.x402.org/) payment protocol.
+CLI for the [Agently](https://use-agently.com) platform — a marketplace for AI agents using the [x402](https://www.x402.org/) payment protocol.
 
 Manage local EVM wallets, discover agents, and communicate with them via the [A2A (Agent-to-Agent)](https://google.github.io/A2A/) protocol.
 
@@ -123,18 +123,10 @@ Connect to an MCP server to list or call tools.
 
 ```bash
 # List tools
-use-agently mcp tools --uri http://localhost:3000
+use-agently mcp tools --uri https://example.com
 
 # Call a tool
-use-agently mcp call echo '{"message":"hello"}' --uri http://localhost:3000
-```
-
-### `erc-8004`
-
-Resolve an ERC-8004 agent URI and display its details from the Agently marketplace.
-
-```bash
-use-agently erc-8004 --uri eip155:8453/erc-8004:0x1234/1
+use-agently mcp call --tool echo --args '{"message":"hello"}' --uri https://example.com
 ```
 
 ### `web`

package/build/bin.js

@@ -65437,11 +65437,20 @@ function renderText(data) {
 }
 function output(command, data) {
   if (command.optsWithGlobals().output === "json") {
-    console.log(JSON.stringify(data, null, 2));
+    console.log(JSON.stringify(data));
   } else {
     console.log(renderText(data));
   }
 }
+function outputCollection(command, items) {
+  if (command.optsWithGlobals().output === "json") {
+    for (const item of items) {
+      console.log(JSON.stringify(item));
+    }
+  } else {
+    console.log(renderText(items));
+  }
+}
 
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 var exports_external = {};
@@ -86858,6 +86867,67 @@ var basePreconf = /* @__PURE__ */ defineChain3({
     }
   }
 });
+// ../../node_modules/.bun/viem@2.46.3+c613ea43c0af028c/node_modules/viem/_esm/chains/definitions/baseSepolia.js
+var sourceId2 = 11155111;
+var baseSepolia = /* @__PURE__ */ defineChain3({
+  ...chainConfig,
+  id: 84532,
+  network: "base-sepolia",
+  name: "Base Sepolia",
+  nativeCurrency: { name: "Sepolia Ether", symbol: "ETH", decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ["https://sepolia.base.org"]
+    }
+  },
+  blockExplorers: {
+    default: {
+      name: "Basescan",
+      url: "https://sepolia.basescan.org",
+      apiUrl: "https://api-sepolia.basescan.org/api"
+    }
+  },
+  contracts: {
+    ...chainConfig.contracts,
+    disputeGameFactory: {
+      [sourceId2]: {
+        address: "0xd6E6dBf4F7EA0ac412fD8b65ED297e64BB7a06E1"
+      }
+    },
+    l2OutputOracle: {
+      [sourceId2]: {
+        address: "0x84457ca9D0163FbC4bbfe4Dfbb20ba46e48DF254"
+      }
+    },
+    portal: {
+      [sourceId2]: {
+        address: "0x49f53e41452c74589e85ca1677426ba426459e85",
+        blockCreated: 4446677
+      }
+    },
+    l1StandardBridge: {
+      [sourceId2]: {
+        address: "0xfd0Bf71F60660E2f608ed56e1659C450eB113120",
+        blockCreated: 4446677
+      }
+    },
+    multicall3: {
+      address: "0xca11bde05977b3631167028862be2a173976ca11",
+      blockCreated: 1059647
+    }
+  },
+  testnet: true,
+  sourceId: sourceId2
+});
+var baseSepoliaPreconf = /* @__PURE__ */ defineChain3({
+  ...baseSepolia,
+  experimental_preconfirmationTime: 200,
+  rpcUrls: {
+    default: {
+      http: ["https://sepolia-preconf.base.org"]
+    }
+  }
+});
 // ../../node_modules/.bun/viem@2.46.3+a78afc2fa6b43151/node_modules/viem/_esm/constants/number.js
 var maxInt84 = 2n ** (8n - 1n) - 1n;
 var maxInt164 = 2n ** (16n - 1n) - 1n;
@@ -92634,13 +92704,19 @@ class EvmPrivateKeyWallet {
   }
   getX402Schemes() {
     const account = privateKeyToAccount(this.privateKey);
-    const transport = this.rpcUrl ? http(this.rpcUrl) : http();
-    const publicClient = createPublicClient({ chain: base, transport });
-    const signer = toClientEvmSigner(account, publicClient);
+    const customTransport = this.rpcUrl ? http(this.rpcUrl) : http();
+    const baseClient = createPublicClient({ chain: base, transport: customTransport });
+    const baseSigner = toClientEvmSigner(account, baseClient);
+    const baseSepoliaClient = createPublicClient({ chain: baseSepolia, transport: customTransport });
+    const baseSepoliaSigner = toClientEvmSigner(account, baseSepoliaClient);
     return [
       {
-        network: "eip155:*",
-        client: new ExactEvmScheme(signer)
+        network: "eip155:8453",
+        client: new ExactEvmScheme(baseSigner)
+      },
+      {
+        network: "eip155:84532",
+        client: new ExactEvmScheme(baseSepoliaSigner)
       }
     ];
   }
@@ -95611,6 +95687,152 @@ function wrapMCPClientWithPaymentFromConfig(mcpClient, config2, options) {
   return new x402MCPClient(mcpClient, paymentClient, options);
 }
 
+// ../use-agently-sdk/utils/transaction.ts
+var DryRunTransaction = { mode: "dry-run" };
+function PayTransaction(wallet) {
+  return { mode: "pay", wallet };
+}
+// ../use-agently-sdk/package.json
+var package_default = {
+  name: "@use-agently/sdk",
+  version: "0.20.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: {
+    url: "https://github.com/AgentlyHQ/use-agently/issues"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/AgentlyHQ/use-agently.git",
+    directory: "packages/use-agently-sdk"
+  },
+  license: "MIT",
+  author: "AgentlyHQ",
+  type: "module",
+  files: [
+    "**/*.ts",
+    "!**/*.test.ts",
+    "README.md"
+  ],
+  scripts: {
+    test: "bun test"
+  },
+  dependencies: {
+    "@a2a-js/sdk": "^0.3.10",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@x402/evm": "^2.5.0",
+    "@x402/fetch": "^2.5.0",
+    "@x402/mcp": "^2.5.0",
+    viem: "^2.46.3",
+    zod: "^4"
+  },
+  devDependencies: {
+    "@types/bun": "^1.3.9",
+    "localhost-aixyz": "^0",
+    testcontainers: "^11",
+    "x402-fl": "^0"
+  },
+  engines: {
+    node: ">=20"
+  }
+};
+
+// ../use-agently-sdk/client.ts
+function createClient4(options) {
+  const fetch2 = createFetch({ userAgent: options.userAgent });
+  return {
+    fetch: fetch2
+  };
+}
+function createFetch(options) {
+  return (input, init) => {
+    const isRequest = input instanceof Request;
+    const headers = new Headers(isRequest ? input.headers : init?.headers);
+    if (isRequest && init?.headers) {
+      for (const [key, value] of new Headers(init.headers).entries()) {
+        headers.set(key, value);
+      }
+    }
+    if (!headers.has("User-Agent")) {
+      headers.set("User-Agent", options?.userAgent ?? `@use-agently/sdk:${package_default.version} (use-agently.com)`);
+    }
+    return fetch(input, { ...init, headers });
+  };
+}
+var clientFetch = createFetch();
+function formatUsdcAmount(req) {
+  try {
+    const { usdcDecimals } = getChainConfigByNetwork(req.network);
+    const raw = formatUnits(BigInt(req.amount), usdcDecimals);
+    const formatted = raw.includes(".") ? raw.replace(/\.?0+$/, "") : raw;
+    const network = req.network ? ` on ${req.network}` : "";
+    return `$${formatted} USDC${network}`;
+  } catch {
+    return `${req.amount} (raw units)`;
+  }
+}
+
+class DryRunPaymentRequired extends Error {
+  requirements;
+  constructor(requirements) {
+    const req = requirements[0];
+    const amount = req ? formatUsdcAmount(req) : null;
+    const payLine = amount ? `This request requires payment of ${amount}.
+Use createPaymentFetch() instead of createDryRunFetch() to authorize the transaction.` : `This request requires payment, but the amount could not be determined.
+Inspect the endpoint manually or use createPaymentFetch() to authorize payment.`;
+    super(payLine);
+    this.name = "DryRunPaymentRequired";
+    this.requirements = requirements;
+  }
+}
+function createDryRunFetch(fetchImpl = clientFetch) {
+  return async (input, init) => {
+    const response = await fetchImpl(input, init);
+    if (response.status === 402) {
+      let requirements = [];
+      const header = response.headers.get("PAYMENT-REQUIRED");
+      if (header) {
+        try {
+          const decoded = JSON.parse(Buffer.from(header, "base64").toString("utf-8"));
+          requirements = decoded.accepts ?? [];
+        } catch (e) {
+          if (!(e instanceof SyntaxError))
+            throw e;
+        }
+      } else {
+        try {
+          const body = await response.clone().json();
+          if (body?.accepts) {
+            requirements = body.accepts;
+          }
+        } catch (e) {
+          if (!(e instanceof SyntaxError))
+            throw e;
+        }
+      }
+      throw new DryRunPaymentRequired(requirements);
+    }
+    return response;
+  };
+}
+function resolveFetchForTransaction(transaction = DryRunTransaction, fetchImpl) {
+  if (transaction.mode === "dry-run")
+    return createDryRunFetch(fetchImpl);
+  return createPaymentFetch(transaction.wallet, fetchImpl);
+}
+function createPaymentFetch(wallet, fetchImpl = clientFetch) {
+  return wrapFetchWithPaymentFromConfig(fetchImpl, {
+    schemes: wallet.getX402Schemes()
+  });
+}
+function createMcpPaymentClient(mcpClient, wallet) {
+  return wrapMCPClientWithPaymentFromConfig(mcpClient, {
+    schemes: wallet.getX402Schemes()
+  });
+}
+// ../use-agently-sdk/a2a.ts
+import { randomUUID } from "node:crypto";
+
 // ../../node_modules/.bun/@a2a-js+sdk@0.3.10+81e50683f7a708c7/node_modules/@a2a-js/sdk/dist/chunk-WMQQYH7W.js
 async function* parseSseStream(response) {
   if (!response.body) {
@@ -98457,198 +98679,49 @@ var CaseInsensitiveMap = class extends Map {
   }
 };
 
-// ../use-agently-sdk/utils/transaction.ts
-var DryRunTransaction = { mode: "dry-run" };
-function PayTransaction(wallet) {
-  return { mode: "pay", wallet };
-}
-// ../use-agently-sdk/package.json
-var package_default = {
-  name: "@use-agently/sdk",
-  version: "0.18.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: {
-    url: "https://github.com/AgentlyHQ/use-agently/issues"
-  },
-  repository: {
-    type: "git",
-    url: "git+https://github.com/AgentlyHQ/use-agently.git",
-    directory: "packages/use-agently-sdk"
-  },
-  license: "MIT",
-  author: "AgentlyHQ",
-  type: "module",
-  files: [
-    "**/*.ts",
-    "!**/*.test.ts",
-    "README.md"
-  ],
-  scripts: {
-    test: "bun test"
-  },
-  dependencies: {
-    "@a2a-js/sdk": "^0.3.10",
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "@x402/evm": "^2.5.0",
-    "@x402/fetch": "^2.5.0",
-    "@x402/mcp": "^2.5.0",
-    viem: "^2.46.3",
-    zod: "^4"
-  },
-  devDependencies: {
-    "@types/bun": "^1.3.9",
-    "localhost-aixyz": "^0",
-    testcontainers: "^11",
-    "x402-fl": "^0"
-  },
-  engines: {
-    node: ">=20"
-  }
-};
-
-// ../use-agently-sdk/client.ts
-var USER_AGENT = `@use-agently/sdk:${package_default.version} (use-agently.com)`;
-function createClientFetch(userAgent = USER_AGENT) {
-  return (input, init) => {
-    const isRequest = input instanceof Request;
-    const headers = new Headers(isRequest ? input.headers : init?.headers);
-    if (isRequest && init?.headers) {
-      for (const [key, value] of new Headers(init.headers).entries()) {
-        headers.set(key, value);
-      }
+// ../use-agently-sdk/agently.ts
+var BASE_URL = "https://api.use-agently.com";
+async function search(client, options) {
+  const url2 = new URL("/search", BASE_URL);
+  if (options?.q)
+    url2.searchParams.set("q", options.q);
+  if (options?.chain_id) {
+    for (const chain of options.chain_id) {
+      url2.searchParams.append("chain_id", chain);
     }
-    if (!headers.has("User-Agent")) {
-      headers.set("User-Agent", userAgent);
-    }
-    return fetch(input, { ...init, headers });
-  };
-}
-var clientFetch = createClientFetch();
-function formatUsdcAmount(req) {
-  try {
-    const { usdcDecimals } = getChainConfigByNetwork(req.network);
-    const raw = formatUnits(BigInt(req.amount), usdcDecimals);
-    const formatted = raw.includes(".") ? raw.replace(/\.?0+$/, "") : raw;
-    const network = req.network ? ` on ${req.network}` : "";
-    return `$${formatted} USDC${network}`;
-  } catch {
-    return `${req.amount} (raw units)`;
   }
-}
-
-class DryRunPaymentRequired extends Error {
-  requirements;
-  constructor(requirements) {
-    const req = requirements[0];
-    const amount = req ? formatUsdcAmount(req) : null;
-    const payLine = amount ? `This request requires payment of ${amount}.
-Use createPaymentFetch() instead of createDryRunFetch() to authorize the transaction.` : `This request requires payment, but the amount could not be determined.
-Inspect the endpoint manually or use createPaymentFetch() to authorize payment.`;
-    super(payLine);
-    this.name = "DryRunPaymentRequired";
-    this.requirements = requirements;
-  }
-}
-function createDryRunFetch(fetchImpl = clientFetch) {
-  return async (input, init) => {
-    const response = await fetchImpl(input, init);
-    if (response.status === 402) {
-      let requirements = [];
-      const header = response.headers.get("PAYMENT-REQUIRED");
-      if (header) {
-        try {
-          const decoded = JSON.parse(Buffer.from(header, "base64").toString("utf-8"));
-          requirements = decoded.accepts ?? [];
-        } catch (e) {
-          if (!(e instanceof SyntaxError))
-            throw e;
-        }
-      } else {
-        try {
-          const body = await response.clone().json();
-          if (body?.accepts) {
-            requirements = body.accepts;
-          }
-        } catch (e) {
-          if (!(e instanceof SyntaxError))
-            throw e;
-        }
-      }
-      throw new DryRunPaymentRequired(requirements);
+  if (options?.protocol) {
+    for (const proto of options.protocol) {
+      url2.searchParams.append("protocol", proto);
     }
-    return response;
-  };
-}
-function resolveFetchForTransaction(transaction = DryRunTransaction, fetchImpl) {
-  if (transaction.mode === "dry-run")
-    return createDryRunFetch(fetchImpl);
-  return createPaymentFetch(transaction.wallet, fetchImpl);
-}
-function createPaymentFetch(wallet, fetchImpl = clientFetch) {
-  return wrapFetchWithPaymentFromConfig(fetchImpl, {
-    schemes: wallet.getX402Schemes()
-  });
-}
-function createMcpPaymentClient(mcpClient, wallet) {
-  return wrapMCPClientWithPaymentFromConfig(mcpClient, {
-    schemes: wallet.getX402Schemes()
-  });
-}
-async function createA2AClient(agentUrl, fetchImpl) {
-  const factory = new ClientFactory({
-    transports: [new JsonRpcTransportFactory({ fetchImpl }), new RestTransportFactory({ fetchImpl })]
-  });
-  return factory.createFromUrl(agentUrl);
-}
-// ../use-agently-sdk/marketplace.ts
-var MARKETPLACE_URL = "https://use-agently.com/marketplace.json";
-
-class AgentNotFoundError extends Error {
-  uri;
-  constructor(uri) {
-    super(`No agent found for URI: ${uri}`);
-    this.uri = uri;
-    this.name = "AgentNotFoundError";
   }
-}
-async function fetchAgents(fetchImpl = clientFetch) {
-  const response = await fetchImpl(MARKETPLACE_URL);
+  if (options?.page !== undefined)
+    url2.searchParams.set("page", String(options.page));
+  if (options?.per_page !== undefined)
+    url2.searchParams.set("per_page", String(options.per_page));
+  const response = await client.fetch(url2);
   if (!response.ok) {
-    throw new Error(`Failed to fetch agents: ${response.status} ${response.statusText}`);
+    throw new Error(`Agently search failed: ${response.status} ${response.statusText}`);
   }
-  const data = await response.json();
-  return data.agents ?? [];
+  return response.json();
 }
-async function searchAgents(options, fetchImpl = clientFetch) {
-  let agents = await fetchAgents(fetchImpl);
-  if (options.query) {
-    const q = options.query.toLowerCase();
-    agents = agents.filter((a) => a.name && a.name.toLowerCase().includes(q) || a.description && a.description.toLowerCase().includes(q) || a.uri && a.uri.toLowerCase().includes(q));
-  }
-  if (options.protocols) {
-    const protocols = options.protocols.map((p) => p.trim().toLowerCase());
-    agents = agents.filter((a) => Array.isArray(a.protocols) && protocols.some((p) => a.protocols.includes(p)));
+async function getAgent(client, id) {
+  const normalizedId = id.startsWith("eip155:") ? id.toLowerCase() : id;
+  const url2 = new URL(`/agents/${normalizedId}`, BASE_URL);
+  const response = await client.fetch(url2);
+  if (response.status === 404) {
+    return;
   }
-  return agents;
-}
-async function resolveErc8004Agent(uri, fetchImpl = clientFetch) {
-  const agents = await fetchAgents(fetchImpl);
-  const agent = agents.find((a) => a.uri === uri);
-  if (!agent) {
-    throw new AgentNotFoundError(uri);
+  if (!response.ok) {
+    throw new Error(`Agently lookup failed: ${response.status} ${response.statusText}`);
   }
-  return agent;
+  return response.json();
 }
+
 // ../use-agently-sdk/a2a.ts
-import { randomUUID } from "node:crypto";
 function extractTextFromParts(parts) {
   return parts.filter((p) => p.kind === "text").map((p) => p.text).join("");
 }
-function resolveAgentUrl(agentInput) {
-  const isDirectUrl = agentInput.startsWith("http://") || agentInput.startsWith("https://");
-  return isDirectUrl ? agentInput : `https://use-agently.com/${agentInput}/`;
-}
 function extractAgentText(result) {
   if (!result) {
     return "The agent processed your request but returned no response.";
@@ -98681,11 +98754,17 @@ function extractStreamEventText(event) {
   }
   return "";
 }
-async function sendA2AMessageStream(uri, message, options) {
-  const agentUrl = resolveAgentUrl(uri);
-  const resolvedFetch = resolveFetchForTransaction(options?.transaction, options?.fetchImpl);
-  const client = await createA2AClient(agentUrl, resolvedFetch);
-  return client.sendMessageStream({
+async function createA2AClient(client, uri, fetchImpl) {
+  const url2 = await getAgentCardURL(client, uri);
+  const factory = new ClientFactory({
+    transports: [new JsonRpcTransportFactory({ fetchImpl }), new RestTransportFactory({ fetchImpl })]
+  });
+  return factory.createFromUrl(url2.toString(), "");
+}
+async function sendMessageStream(client, uri, message, options) {
+  const resolvedFetch = resolveFetchForTransaction(options?.mode, client.fetch);
+  const a2aClient = await createA2AClient(client, uri, resolvedFetch);
+  return a2aClient.sendMessageStream({
     message: {
       kind: "message",
       messageId: randomUUID(),
@@ -98694,10 +98773,32 @@ async function sendA2AMessageStream(uri, message, options) {
     }
   });
 }
-async function getA2ACard(uri, options) {
-  const agentUrl = resolveAgentUrl(uri);
-  const resolver = new DefaultAgentCardResolver(options?.fetchImpl ? { fetchImpl: options.fetchImpl } : undefined);
-  return resolver.resolve(agentUrl);
+async function getAgentCard(client, uri) {
+  const url2 = await getAgentCardURL(client, uri);
+  const response = await client.fetch(url2);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch agent card from ${url2}: ${response.status} ${response.statusText}`);
+  }
+  return response.json();
+}
+async function getAgentCardURL(client, uri) {
+  if (uri.startsWith("eip155:")) {
+    const agent = await getAgent(client, uri);
+    if (!agent) {
+      throw new Error(`Agent (${uri}) not found.`);
+    }
+    const service = agent.metadata?.services?.find((s) => s.name === "a2a");
+    if (!service) {
+      throw new Error(`Agent (${uri}) has no A2A service registered.`);
+    }
+    return new URL(service.endpoint);
+  }
+  const url2 = new URL(uri);
+  if (url2.pathname.endsWith("/.well-known/agent-card.json")) {
+    return url2;
+  }
+  url2.pathname = url2.pathname.replace(/\/?$/, "/.well-known/agent-card.json");
+  return url2;
 }
 // ../../node_modules/.bun/@modelcontextprotocol+sdk@1.27.1/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/transport.js
 function normalizeHeaders(headers) {
@@ -100053,14 +100154,19 @@ class StreamableHTTPClientTransport {
 }
 
 // ../use-agently-sdk/mcp.ts
-function resolveMcpUrl(input) {
-  const isDirectUrl = input.startsWith("http://") || input.startsWith("https://");
-  const base2 = isDirectUrl ? input : `https://use-agently.com/${input}/services/mcp`;
-  const url2 = new URL(base2);
-  if (!url2.pathname.endsWith("/mcp") && !url2.pathname.endsWith("/mcp/")) {
-    url2.pathname = url2.pathname.replace(/\/?$/, "/mcp");
+async function getMcpURL(client, input) {
+  if (input.startsWith("eip155:")) {
+    const agent = await getAgent(client, input);
+    if (!agent) {
+      throw new Error(`Agent (${input}) not found.`);
+    }
+    const service = agent.metadata?.services?.find((s) => s.name === "mcp");
+    if (!service) {
+      throw new Error(`Agent (${input}) has no MCP service registered.`);
+    }
+    return new URL(service.endpoint);
   }
-  return url2.toString();
+  return new URL(input);
 }
 async function createMcpClient(mcpUrl, options) {
   const client = new Client(options?.clientInfo ?? { name: "@use-agently/sdk", version: package_default.version });
@@ -100073,8 +100179,8 @@ async function createMcpClient(mcpUrl, options) {
   await client.connect(transport);
   return client;
 }
-async function listMcpTools(uri, options) {
-  const mcpUrl = resolveMcpUrl(uri);
+async function listMcpTools(sdkClient, uri, options) {
+  const mcpUrl = await (await getMcpURL(sdkClient, uri)).toString();
   const resolvedFetch = resolveFetchForTransaction(options?.transaction, options?.fetchImpl);
   const client = await createMcpClient(mcpUrl, { clientInfo: options?.clientInfo, fetchImpl: resolvedFetch });
   try {
@@ -100084,8 +100190,8 @@ async function listMcpTools(uri, options) {
     await client.close();
   }
 }
-async function callMcpTool(uri, tool, args, options) {
-  const mcpUrl = resolveMcpUrl(uri);
+async function callMcpTool(sdkClient, uri, tool, args, options) {
+  const mcpUrl = await (await getMcpURL(sdkClient, uri)).toString();
   const transaction = options?.transaction ?? DryRunTransaction;
   const resolvedFetch = resolveFetchForTransaction(transaction, options?.fetchImpl);
   if (transaction.mode === "pay") {
@@ -100210,13 +100316,14 @@ async function backupConfig(scope = "global") {
 async function getConfigOrThrow() {
   const config2 = await loadConfig();
   if (!config2?.wallet) {
-    throw new Error("No wallet configured. Initialize a wallet first.");
+    throw new Error("No wallet configured. Run 'use-agently init' to create one.");
   }
   return config2;
 }
 
 // src/commands/init.ts
-var initCommand = new Command("init").description("Generate a new local wallet and save it to config").option("--regenerate", "Backup existing config and generate a new wallet").option("--local", "Save config to the current directory (.use-agently/config.json) instead of the home directory").action(async (options, command) => {
+var initCommand = new Command("init").description("Generate a new local wallet and save it to config").option("--regenerate", "Backup existing config and generate a new wallet").option("--local", "Save config to the current directory (.use-agently/config.json) instead of the home directory").showHelpAfterError(true).addHelpText("after", `
+Config: ~/.use-agently/config.json (global), .use-agently/config.json (local)`).action(async (options, command) => {
   const scope = options.local ? "local" : "global";
   const existing = await loadConfig(scope);
   if (existing?.wallet) {
@@ -100224,7 +100331,8 @@ var initCommand = new Command("init").description("Generate a new local wallet a
       console.error("Wallet already configured. Use --regenerate to create a new wallet.");
       process.exit(1);
     }
-    await backupConfig(scope);
+    const backupPath = await backupConfig(scope);
+    console.error(`Previous config backed up to ${backupPath}`);
   }
   const walletConfig = generateEvmPrivateKeyConfig();
   await saveConfig({ wallet: walletConfig }, scope);
@@ -100235,7 +100343,7 @@ var initCommand = new Command("init").description("Generate a new local wallet a
 });
 
 // src/commands/whoami.ts
-var whoamiCommand = new Command("whoami").description("Show current wallet info").action(async (_options, command) => {
+var whoamiCommand = new Command("whoami").description("Show current wallet info").showHelpAfterError(true).action(async (_options, command) => {
   const config2 = await getConfigOrThrow();
   const wallet = loadWallet(config2.wallet);
   output(command, {
@@ -100245,7 +100353,7 @@ 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").action(async (options, command) => {
+var balanceCommand = new Command("balance").description("Check wallet balance on-chain").option("--rpc <url>", "Custom RPC URL").showHelpAfterError(true).action(async (options, command) => {
   const config2 = await getConfigOrThrow();
   const wallet = loadWallet(config2.wallet);
   const result = await getBalance2(wallet.address, { rpc: options.rpc });
@@ -101613,7 +101721,7 @@ function boxen(text, options) {
 // package.json
 var package_default2 = {
   name: "use-agently",
-  version: "0.18.0",
+  version: "0.20.0",
   description: "Use Agently CLI",
   homepage: "https://use-agently.com",
   bugs: "https://github.com/AgentlyHQ/use-agently/issues",
@@ -101637,7 +101745,7 @@ var package_default2 = {
     test: "bun test"
   },
   dependencies: {
-    "@use-agently/sdk": "0.18.0",
+    "@use-agently/sdk": "0.20.0",
     boxen: "^8.0.1",
     commander: "^14.0.3",
     viem: "^2.46.3",
@@ -101656,7 +101764,8 @@ var package_default2 = {
 
 // src/client.ts
 var CLI_USER_AGENT = `use-agently:${package_default2.version} (use-agently.com)`;
-var clientFetch2 = createClientFetch(CLI_USER_AGENT);
+var defaultClient = createClient4({ userAgent: CLI_USER_AGENT });
+var clientFetch2 = defaultClient.fetch;
 
 class DryRunPaymentRequired2 extends DryRunPaymentRequired {
   constructor(requirements) {
@@ -101702,41 +101811,50 @@ function formatUsdcAmount2(req) {
 }
 function handleDryRunError(err) {
   const cliErr = err instanceof DryRunPaymentRequired2 ? err : new DryRunPaymentRequired2(err.requirements);
-  console.error(boxen(cliErr.message, {
-    title: "Payment Required",
-    titleAlignment: "center",
-    borderColor: "yellow",
-    padding: 1
-  }));
+  if (process.stderr.isTTY) {
+    console.error(boxen(cliErr.message, {
+      title: "Payment Required",
+      titleAlignment: "center",
+      borderColor: "yellow",
+      padding: 1
+    }));
+  } else {
+    console.error(`Payment Required: ${cliErr.message}`);
+  }
   process.exit(1);
 }
 
 // src/commands/agents.ts
 var agentsCommand = new Command("agents").description("List available agents on Agently").action(async (_options, command) => {
-  const agents = await fetchAgents(clientFetch2);
-  output(command, { agents });
+  const result = await search(defaultClient);
+  outputCollection(command, result.hits.map(({ id, name, description, protocols }) => ({ id, name, description, protocols })));
 });
 
 // src/commands/search.ts
-var searchCommand = new Command("search").description("Search the Agently marketplace for agents").argument("[query]", "Search query to filter agents by name or description").option("-p, --protocol <protocols>", "Filter by protocol(s), comma-separated (e.g. a2a,mcp,web)").addHelpText("after", `
+var searchCommand = new Command("search").description("Search the Agently marketplace for agents").argument("[query]", "Search query to filter agents by name or description").option("-p, --protocol <protocols>", "Filter by protocol(s), comma-separated (e.g. a2a,mcp)").showHelpAfterError(true).addHelpText("after", `
 Examples:
   use-agently search
   use-agently search "echo"
   use-agently search --protocol a2a
   use-agently search "assistant" --protocol "a2a,mcp"`).action(async (query, options, command) => {
-  const protocols = options.protocol ? options.protocol.split(",").map((p) => p.trim().toLowerCase()) : undefined;
-  const agents = await searchAgents({ query, protocols }, clientFetch2);
-  output(command, { agents });
+  const protocol = options.protocol ? options.protocol.split(",").map((p) => p.trim().toLowerCase()) : undefined;
+  const result = await search(defaultClient, { q: query, protocol });
+  outputCollection(command, result.hits.map(({ id, name, description, protocols }) => ({ id, name, description, protocols })));
 });
 
-// src/commands/a2a.ts
-function resolveUriOption(options, commandName) {
-  if (!options.uri) {
-    throw new Error(`Missing required option --uri for '${commandName}'.
-Expected a URL or agent URI, e.g. --uri https://example.com/agent or --uri echo-agent`);
+// src/commands/view.ts
+var viewCommand = new Command("view").description("View an agent by its ID (e.g. CAIP-19)").argument("<id>", "Agent ID (e.g. eip155:8453/erc8004:0x1234/1)").showHelpAfterError(true).addHelpText("after", `
+Examples:
+  use-agently view eip155:8453/erc8004:0x1234/1`).action(async (id, _options, command) => {
+  const agent = await getAgent(defaultClient, id);
+  if (!agent) {
+    throw new Error(`No agent found for ID: ${id}
+Run 'use-agently search' to find available agents.`);
   }
-  return options.uri;
-}
+  output(command, agent);
+});
+
+// src/commands/a2a.ts
 async function resolveTransactionMode(pay) {
   if (pay) {
     const config2 = await getConfigOrThrow();
@@ -101748,15 +101866,15 @@ async function resolveTransactionMode(pay) {
 var a2aCommand = new Command("a2a").description("Interact with agents via the A2A protocol").action(function() {
   this.outputHelp();
 });
-var a2aSendCommand = new Command("send").description("Send a message to an agent via A2A protocol").option("--uri <value>", "Agent URI or URL (e.g. https://example.com/agent or echo-agent)").requiredOption("-m, --message <text>", "Message to send").option("--pay", "Authorize payment if the agent requires it (default: dry-run, shows cost only)").addHelpText("after", `
+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", `
 Examples:
   use-agently a2a send --uri https://example.com/agent -m "Hello!"
-  use-agently a2a send --uri echo-agent -m "Hello!"
-  use-agently a2a send --uri paid-agent -m "Hello!" --pay`).action(async (options) => {
-  const uri = resolveUriOption(options, "a2a send");
+  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);
   try {
-    const stream = await sendA2AMessageStream(uri, options.message, { transaction, fetchImpl: clientFetch2 });
+    const stream = await sendMessageStream(defaultClient, uri, options.message, { mode: transaction });
     let wroteText = false;
     let lastResult = null;
     for await (const event of stream) {
@@ -101779,25 +101897,18 @@ Examples:
     throw err;
   }
 });
-var a2aCardSubCommand = new Command("card").description("Fetch and display the A2A agent card").option("--uri <value>", "Agent URI or URL (e.g. https://example.com/agent or echo-agent)").addHelpText("after", `
+var a2aCardSubCommand = new Command("card").description("Fetch and display the A2A agent card").requiredOption("-u, --uri <value>", "Agent URL or CAIP-19 ID (e.g. https://example.com/agent or eip155:8453/erc8004:0x1234/1)").showHelpAfterError(true).addHelpText("after", `
 Examples:
   use-agently a2a card --uri https://example.com/agent
-  use-agently a2a card --uri echo-agent`).action(async (options, command) => {
-  const uri = resolveUriOption(options, "a2a card");
-  const card = await getA2ACard(uri, { fetchImpl: clientFetch2 });
+  use-agently a2a card --uri eip155:8453/erc8004:0x1234/1`).action(async (options, command) => {
+  const uri = options.uri;
+  const card = await getAgentCard(defaultClient, uri);
   output(command, card);
 });
 a2aCommand.addCommand(a2aSendCommand);
 a2aCommand.addCommand(a2aCardSubCommand);
 
 // src/commands/mcp.ts
-function resolveUriOption2(options, commandName) {
-  if (!options.uri) {
-    throw new Error(`Missing required option --uri for '${commandName}'.
-Expected a URL or agent URI, e.g. --uri http://localhost:3000 or --uri my-agent`);
-  }
-  return options.uri;
-}
 async function resolveTransactionMode2(pay) {
   if (pay) {
     const config2 = await getConfigOrThrow();
@@ -101809,35 +101920,34 @@ async function resolveTransactionMode2(pay) {
 var mcpCommand = new Command("mcp").description("Connect to an MCP server and list or call tools").action(function() {
   this.outputHelp();
 });
-var mcpToolsCommand = new Command("tools").description("List available tools on an MCP server").option("--uri <value>", "MCP server URI or URL").addHelpText("after", `
+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", `
 Examples:
-  use-agently mcp tools --uri http://localhost:3000
-  use-agently mcp tools --uri my-agent`).action(async (options, command) => {
-  const uri = resolveUriOption2(options, "mcp tools");
-  const tools = await listMcpTools(uri, {
+  use-agently mcp tools --uri https://example.com/mcp
+  use-agently mcp tools --uri eip155:8453/erc8004:0x1234/1`).action(async (options, command) => {
+  const tools = await listMcpTools(defaultClient, options.uri, {
     clientInfo: { name: "use-agently", version: package_default2.version },
     fetchImpl: clientFetch2
   });
-  output(command, tools);
+  outputCollection(command, tools);
 });
-var mcpCallCommand = new Command("call").description("Call a specific tool on an MCP server").argument("<tool>", "Tool name to call").argument("[args]", "JSON arguments to pass to the tool").option("--uri <value>", "MCP server URI or URL").option("--pay", "Authorize payment if the tool requires it (default: dry-run, shows cost only)").addHelpText("after", `
+var mcpCallCommand = new Command("call").description("Call a specific tool on an MCP server").requiredOption("-u, --uri <value>", "MCP server URL or CAIP-19 ID").requiredOption("--tool <name>", "Tool name to call").option("--args <json>", "JSON arguments to pass to the tool").option("--pay", "Authorize payment if the tool requires it (default: dry-run, shows cost only)").showHelpAfterError(true).addHelpText("after", `
 Examples:
-  use-agently mcp call echo '{"message":"hello"}' --uri http://localhost:3000
-  use-agently mcp call echo --uri my-agent
-  use-agently mcp call paid-tool '{"message":"hello"}' --uri my-agent --pay`).action(async (tool, argsStr, options, command) => {
-  const uri = resolveUriOption2(options, "mcp call");
+  use-agently mcp call --uri https://example.com/mcp --tool echo --args '{"message":"hello"}'
+  use-agently mcp call --uri https://example.com/mcp --tool paid-tool --args '{"message":"hello"}' --pay`).action(async (options, command) => {
+  const uri = options.uri;
+  const tool = options.tool;
   let args = {};
-  if (argsStr !== undefined) {
+  if (options.args !== undefined) {
     try {
-      args = JSON.parse(argsStr);
+      args = JSON.parse(options.args);
     } catch {
-      throw new Error(`Invalid JSON in <args>: ${argsStr}
-Expected a JSON object, e.g. '{"message":"hello"}'`);
+      throw new Error(`Invalid JSON in --args: ${options.args}
+Expected a JSON object, e.g. --args '{"message":"hello"}'`);
     }
   }
   const transaction = await resolveTransactionMode2(options.pay);
   try {
-    const result = await callMcpTool(uri, tool, args, {
+    const result = await callMcpTool(defaultClient, uri, tool, args, {
       transaction,
       clientInfo: { name: "use-agently", version: package_default2.version },
       fetchImpl: clientFetch2
@@ -101867,12 +101977,17 @@ Ensure your wallet has sufficient USDC balance and try again.`;
             } else {
               message = `Payment error: ${parsed.error}`;
             }
-            console.error(boxen(message, {
-              title: parsed.error === "insufficient_funds" ? "Insufficient Funds" : "Payment Error",
-              titleAlignment: "center",
-              borderColor: "red",
-              padding: 1
-            }));
+            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 {}
@@ -101897,31 +102012,6 @@ Ensure your wallet has sufficient USDC balance and try again.`;
 mcpCommand.addCommand(mcpToolsCommand);
 mcpCommand.addCommand(mcpCallCommand);
 
-// src/commands/erc8004.ts
-function resolveUriOption3(options) {
-  if (!options.uri) {
-    throw new Error(`Missing required option --uri for 'erc-8004'.
-Expected an ERC-8004 agent URI, e.g. --uri eip155:8453/erc-8004:0x1234/1`);
-  }
-  return options.uri;
-}
-var erc8004Command = new Command("erc-8004").description("Resolve an ERC-8004 agent URI and display its details").option("--uri <value>", "ERC-8004 agent URI (e.g. eip155:8453/erc-8004:0x1234/1)").addHelpText("after", `
-Examples:
-  use-agently erc-8004 --uri eip155:8453/erc-8004:0x1234/1
-  use-agently erc-8004 --uri eip155:8453/erc-8004:0xAbCd/42`).action(async (options, command) => {
-  const uri = resolveUriOption3(options);
-  try {
-    const agent = await resolveErc8004Agent(uri, clientFetch2);
-    output(command, agent);
-  } catch (err) {
-    if (err instanceof AgentNotFoundError) {
-      throw new Error(`No agent found for URI: ${uri}
-Run 'use-agently agents' to see available agent URIs.`);
-    }
-    throw err;
-  }
-});
-
 // src/commands/web.ts
 function collect(value, previous) {
   return previous.concat([value]);
@@ -102087,7 +102177,7 @@ async function executeHttpRequest(method, url2, options, command) {
       }
       clearTimeout(timer);
       console.log(`Response body written to ${options.outputFile} (HTTP ${response.status})`);
-      if (!response.ok)
+      if (options.fail && !response.ok)
         process.exit(1);
       return;
     }
@@ -102105,7 +102195,7 @@ async function executeHttpRequest(method, url2, options, command) {
         headers: responseHeaders,
         body: responseBody
       });
-      if (!response.ok)
+      if (options.fail && !response.ok)
         process.exit(1);
       return;
     }
@@ -102118,12 +102208,12 @@ async function executeHttpRequest(method, url2, options, command) {
       });
       console.log(headerBlock + `
 ` + responseBody);
-      if (!response.ok)
+      if (options.fail && !response.ok)
         process.exit(1);
       return;
     }
     console.log(responseBody);
-    if (!response.ok)
+    if (options.fail && !response.ok)
       process.exit(1);
   } catch (err) {
     clearTimeout(timer);
@@ -102137,7 +102227,7 @@ async function executeHttpRequest(method, url2, options, command) {
   }
 }
 function addSharedOptions(cmd, hasBody) {
-  cmd.option("-H, --header <value>", 'Request header, repeatable (e.g. "Content-Type: application/json")', collect, []).option("--output-file <path>", "Save response body to file").option("-L, --location", "Follow redirects").option("-v, --verbose", "Show request/response headers on stderr").option("-i, --include", "Include response status and headers in stdout output").option("--timeout <ms>", "Request timeout in milliseconds (default: 30000)").option("--max-filesize <bytes>", "Maximum response size in bytes (default: 104857600 / 100 MB)").option("--pay", "Authorize x402 payment (default: dry-run, shows cost only)");
+  cmd.option("-H, --header <value>", 'Request header, repeatable (e.g. "Content-Type: application/json")', collect, []).option("--output-file <path>", "Save response body to file").option("-L, --location", "Follow redirects").option("-v, --verbose", "Show request/response headers on stderr").option("-i, --include", "Include response status and headers in stdout output").option("--timeout <ms>", "Request timeout in milliseconds (default: 30000)").option("--max-filesize <bytes>", "Maximum response size in bytes (default: 104857600 / 100 MB)").option("--pay", "Authorize x402 payment (default: dry-run, shows cost only)").option("--fail", "Exit with code 1 on HTTP error responses (4xx/5xx)");
   if (hasBody) {
     cmd.option("-d, --data <body>", "Request body (prefix @ to read from file, e.g. @body.json)").option("--data-raw <body>", "Request body sent as-is (@ is not treated as a file reference)");
   }
@@ -102165,7 +102255,8 @@ webCommand.addCommand(createMethodSubcommand("patch", "Make an HTTP PATCH reques
 webCommand.addCommand(createMethodSubcommand("delete", "Make an HTTP DELETE request", false));
 
 // 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").action(async (options, command) => {
+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", `
+Config: ~/.use-agently/config.json (global), .use-agently/config.json (local)`).action(async (options, command) => {
   const checks3 = [];
   const config2 = await loadConfig();
   const hasWallet = !!config2?.wallet;
@@ -102277,7 +102368,7 @@ async function checkAutoUpdate() {
     console.warn("Auto-update failed:", err instanceof Error ? err.message : String(err));
   }
 }
-var updateCommand = new Command("update").description("Update use-agently to the latest version").action(async (_options, command) => {
+var updateCommand = new Command("update").description("Update use-agently to the latest version").showHelpAfterError(true).action(async (_options, command) => {
   try {
     const result = await checkAndUpdate();
     output(command, result);
@@ -102289,7 +102380,7 @@ var updateCommand = new Command("update").description("Update use-agently to the
 
 // src/cli.ts
 var cli = new Command;
-cli.name("use-agently").description("Agently is the way AI coordinate and transact. The routing and settlement layer for your agent economy.").version(package_default2.version).option("-o, --output <format>", "Output format (text, json)", "text").argument("[args...]").action((args) => {
+cli.name("use-agently").description("Agently is the way AI coordinate and transact. The routing and settlement layer for your agent economy.").version(package_default2.version).option("-o, --output <format>", "Output format (text, json)", process.stdout.isTTY ? "text" : "json").argument("[args...]").action((args) => {
   if (args.length > 0) {
     cli.unknownCommand();
     return;
@@ -102301,9 +102392,9 @@ cli.addCommand(whoamiCommand.helpGroup("Diagnostics"));
 cli.addCommand(balanceCommand.helpGroup("Diagnostics"));
 cli.addCommand(agentsCommand.helpGroup("Discovery"));
 cli.addCommand(searchCommand.helpGroup("Discovery"));
+cli.addCommand(viewCommand.helpGroup("Discovery"));
 cli.addCommand(a2aCommand.helpGroup("Protocols"));
 cli.addCommand(mcpCommand.helpGroup("Protocols"));
-cli.addCommand(erc8004Command.helpGroup("Protocols"));
 cli.addCommand(webCommand.helpGroup("Protocols"));
 cli.addCommand(initCommand.helpGroup("Lifecycle"));
 cli.addCommand(updateCommand.helpGroup("Lifecycle"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-agently",
-  "version": "0.18.0",
+  "version": "0.20.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.18.0",
+    "@use-agently/sdk": "0.20.0",
     "boxen": "^8.0.1",
     "commander": "^14.0.3",
     "viem": "^2.46.3",