agentspend 0.1.1

package/dist/commands/card.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerCardCommands(program: Command): void;

package/dist/commands/card.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCardCommands = registerCardCommands;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_child_process_1 = require("node:child_process");
+const node_process_1 = require("node:process");
+const CONFIG_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".agentspend");
+const SETUP_FILE = (0, node_path_1.join)(CONFIG_DIR, "setup.json");
+const CARD_FILE = (0, node_path_1.join)(CONFIG_DIR, "card.json");
+const API_BASE = process.env.AGENTSPEND_API_URL ?? "https://api.agentspend.co";
+async function ensureConfigDir() {
+    await (0, promises_1.mkdir)(CONFIG_DIR, { recursive: true });
+}
+function openUrl(url) {
+    const cmd = node_process_1.platform === "darwin" ? "open" : node_process_1.platform === "win32" ? "start" : "xdg-open";
+    (0, node_child_process_1.exec)(`${cmd} ${JSON.stringify(url)}`);
+}
+async function readSetupId() {
+    try {
+        const data = JSON.parse(await (0, promises_1.readFile)(SETUP_FILE, "utf-8"));
+        if (typeof data.setup_id === "string" && data.setup_id) {
+            return data.setup_id;
+        }
+    }
+    catch {
+        // file doesn't exist or is invalid
+    }
+    throw new Error("No setup_id found. Run 'agentspend card setup' first.");
+}
+async function createCard() {
+    const response = await fetch(`${API_BASE}/v1/card/create`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({})
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Failed to create card (${response.status}): ${body}`);
+    }
+    return (await response.json());
+}
+async function getSetupStatus(setupId) {
+    const response = await fetch(`${API_BASE}/v1/card/setup/${encodeURIComponent(setupId)}`);
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Failed to get setup status (${response.status}): ${body}`);
+    }
+    return (await response.json());
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function registerCardCommands(program) {
+    const card = program
+        .command("card")
+        .description("Manage AgentSpend cards");
+    card
+        .command("status")
+        .description("Check the setup status of a pending card")
+        .action(async () => {
+        try {
+            const setupId = await readSetupId();
+            const status = await getSetupStatus(setupId);
+            console.log(`Setup ID:  ${status.setup_id}`);
+            console.log(`Status:    ${status.status}`);
+            console.log(`Expires:   ${status.expires_at}`);
+            if (status.card_id) {
+                console.log(`Card ID: ${status.card_id}`);
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    card
+        .command("setup")
+        .description("Set up a card and wait until setup is complete")
+        .action(async () => {
+        try {
+            const result = await createCard();
+            console.log(`Setup ID: ${result.setup_id}`);
+            console.log(`Opening setup URL in browser...`);
+            openUrl(result.setup_url);
+            await ensureConfigDir();
+            await (0, promises_1.writeFile)(SETUP_FILE, JSON.stringify({ setup_id: result.setup_id }, null, 2));
+            console.log("Waiting for setup to complete...");
+            while (true) {
+                await sleep(3000);
+                const status = await getSetupStatus(result.setup_id);
+                if (status.status === "ready") {
+                    console.log(`Card is ready!`);
+                    if (status.card_id) {
+                        await (0, promises_1.writeFile)(CARD_FILE, JSON.stringify({ card_id: status.card_id }, null, 2));
+                        console.log(`Card ID saved to ${CARD_FILE}`);
+                    }
+                    // Clean up setup file
+                    await (0, promises_1.unlink)(SETUP_FILE).catch(() => { });
+                    break;
+                }
+                if (status.status === "expired" || status.status === "failed") {
+                    await (0, promises_1.unlink)(SETUP_FILE).catch(() => { });
+                    throw new Error(`Setup ${status.status}. Please try again.`);
+                }
+                process.stdout.write(".");
+            }
+        }
+        catch (err) {
+            console.error(`\nError: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/crypto-wallet.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerCryptoWalletCommands(program: Command): void;

package/dist/commands/crypto-wallet.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCryptoWalletCommands = registerCryptoWalletCommands;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const CONFIG_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".agentspend");
+const CRYPTO_WALLET_FILE = (0, node_path_1.join)(CONFIG_DIR, "crypto-wallet.json");
+async function ensureConfigDir() {
+    await (0, promises_1.mkdir)(CONFIG_DIR, { recursive: true });
+}
+async function readCryptoWalletConfig() {
+    try {
+        const data = JSON.parse(await (0, promises_1.readFile)(CRYPTO_WALLET_FILE, "utf-8"));
+        if (typeof data.address === "string" && data.address) {
+            return data;
+        }
+    }
+    catch {
+        // file doesn't exist or is invalid
+    }
+    return null;
+}
+function registerCryptoWalletCommands(program) {
+    const cryptoWallet = program
+        .command("crypto-wallet")
+        .description("Manage AgentSpend crypto wallets");
+    cryptoWallet
+        .command("setup")
+        .description("Set up a crypto wallet from a private key")
+        .requiredOption("--private-key <key>", "Ethereum private key (0x...)")
+        .option("--network <network>", "Chain identifier", "eip155:8453")
+        .action(async (opts) => {
+        try {
+            const privateKey = opts.privateKey.trim();
+            if (!privateKey.startsWith("0x") || privateKey.length !== 66) {
+                console.error("Error: Private key must be a 0x-prefixed 32-byte hex string (66 characters)");
+                process.exit(1);
+            }
+            // Derive address from private key using viem
+            let address;
+            try {
+                const { privateKeyToAccount } = await import("viem/accounts");
+                const account = privateKeyToAccount(privateKey);
+                address = account.address;
+            }
+            catch (err) {
+                console.error(`Error: Failed to derive address from private key: ${err instanceof Error ? err.message : err}`);
+                process.exit(1);
+            }
+            await ensureConfigDir();
+            const config = {
+                address,
+                network: opts.network
+            };
+            // Store the private key (in production, this should be encrypted)
+            // For now, store it so @x402/fetch can use it
+            const fullConfig = {
+                ...config,
+                private_key: privateKey
+            };
+            await (0, promises_1.writeFile)(CRYPTO_WALLET_FILE, JSON.stringify(fullConfig, null, 2));
+            console.log(`Crypto wallet configured.`);
+            console.log(`  Address: ${address}`);
+            console.log(`  Network: ${opts.network}`);
+            console.log(`  Saved to: ${CRYPTO_WALLET_FILE}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    cryptoWallet
+        .command("status")
+        .description("Show configured crypto wallet address, network, and USDC balance")
+        .action(async () => {
+        try {
+            const config = await readCryptoWalletConfig();
+            if (!config) {
+                console.log("No crypto wallet configured.");
+                console.log("Run: agentspend crypto-wallet setup --private-key 0x...");
+                process.exit(0);
+            }
+            console.log(`Address: ${config.address}`);
+            console.log(`Network: ${config.network}`);
+            // Fetch USDC balance on Base
+            try {
+                const { createPublicClient, http, parseAbi } = await import("viem");
+                const { base } = await import("viem/chains");
+                const client = createPublicClient({
+                    chain: base,
+                    transport: http()
+                });
+                const usdcAddress = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+                const balance = await client.readContract({
+                    address: usdcAddress,
+                    abi: parseAbi(["function balanceOf(address) view returns (uint256)"]),
+                    functionName: "balanceOf",
+                    args: [config.address]
+                });
+                const usdcBalance = Number(balance) / 1e6;
+                console.log(`USDC Balance: ${usdcBalance.toFixed(2)} USDC`);
+            }
+            catch {
+                console.log("USDC Balance: (unable to fetch)");
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/wallet.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerWalletCommands(program: Command): void;

package/dist/commands/wallet.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerWalletCommands = registerWalletCommands;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const CONFIG_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".agentspend");
+const WALLET_FILE = (0, node_path_1.join)(CONFIG_DIR, "wallet.json");
+async function ensureConfigDir() {
+    await (0, promises_1.mkdir)(CONFIG_DIR, { recursive: true });
+}
+async function readWalletConfig() {
+    try {
+        const data = JSON.parse(await (0, promises_1.readFile)(WALLET_FILE, "utf-8"));
+        if (typeof data.address === "string" && data.address) {
+            return data;
+        }
+    }
+    catch {
+        // file doesn't exist or is invalid
+    }
+    return null;
+}
+function registerWalletCommands(program) {
+    const wallet = program
+        .command("wallet")
+        .description("Manage AgentSpend crypto wallets");
+    wallet
+        .command("create")
+        .description("Generate a new crypto wallet for x402 payments")
+        .option("--network <network>", "Chain identifier", "eip155:8453")
+        .action(async (opts) => {
+        try {
+            const existing = await readWalletConfig();
+            if (existing) {
+                console.log(`Wallet already exists.`);
+                console.log(`  Address: ${existing.address}`);
+                console.log(`  Network: ${existing.network}`);
+                console.log(`  Saved at: ${WALLET_FILE}`);
+                process.exit(0);
+            }
+            const { generatePrivateKey, privateKeyToAccount } = await import("viem/accounts");
+            const privateKey = generatePrivateKey();
+            const account = privateKeyToAccount(privateKey);
+            await ensureConfigDir();
+            const config = {
+                address: account.address,
+                network: opts.network,
+                private_key: privateKey,
+            };
+            await (0, promises_1.writeFile)(WALLET_FILE, JSON.stringify(config, null, 2));
+            console.log(`Wallet created. Address: ${account.address} — Fund it with USDC on Base.`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    wallet
+        .command("status")
+        .description("Show wallet address, network, and USDC balance")
+        .action(async () => {
+        try {
+            const config = await readWalletConfig();
+            if (!config) {
+                console.log("No wallet configured.");
+                console.log("Run: agentspend wallet create");
+                process.exit(0);
+            }
+            console.log(`Address: ${config.address}`);
+            console.log(`Network: ${config.network}`);
+            // Fetch USDC balance on Base
+            try {
+                const { createPublicClient, http, parseAbi } = await import("viem");
+                const { base } = await import("viem/chains");
+                const client = createPublicClient({
+                    chain: base,
+                    transport: http(),
+                });
+                const usdcAddress = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+                const balance = await client.readContract({
+                    address: usdcAddress,
+                    abi: parseAbi(["function balanceOf(address) view returns (uint256)"]),
+                    functionName: "balanceOf",
+                    args: [config.address],
+                });
+                const usdcBalance = Number(balance) / 1e6;
+                console.log(`USDC Balance: ${usdcBalance.toFixed(2)} USDC`);
+            }
+            catch {
+                console.log("USDC Balance: (unable to fetch)");
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const card_js_1 = require("./commands/card.js");
+const wallet_js_1 = require("./commands/wallet.js");
+const program = new commander_1.Command();
+program
+    .name("agentspend")
+    .description("AgentSpend CLI — manage cards and billing")
+    .version("0.1.0");
+(0, card_js_1.registerCardCommands)(program);
+(0, wallet_js_1.registerWalletCommands)(program);
+program.parse();

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "agentspend",
+  "version": "0.1.1",
+  "bin": {
+    "agentspend": "dist/index.js"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "viem": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/commands/card.ts

@@ -0,0 +1,144 @@
+import { Command } from "commander";
+import { readFile, writeFile, mkdir, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { exec } from "node:child_process";
+import { platform } from "node:process";
+type CardSetupStatus = "awaiting_card" | "ready" | "expired" | "failed";
+
+interface CardCreateResponse {
+  setup_id: string;
+  setup_url: string;
+  status: CardSetupStatus;
+  expires_at: string;
+}
+
+interface CardSetupStatusResponse {
+  setup_id: string;
+  status: CardSetupStatus;
+  expires_at: string;
+  card_id?: string;
+}
+
+const CONFIG_DIR = join(homedir(), ".agentspend");
+const SETUP_FILE = join(CONFIG_DIR, "setup.json");
+const CARD_FILE = join(CONFIG_DIR, "card.json");
+const API_BASE = process.env.AGENTSPEND_API_URL ?? "https://api.agentspend.co";
+
+async function ensureConfigDir(): Promise<void> {
+  await mkdir(CONFIG_DIR, { recursive: true });
+}
+
+function openUrl(url: string): void {
+  const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  exec(`${cmd} ${JSON.stringify(url)}`);
+}
+
+async function readSetupId(): Promise<string> {
+  try {
+    const data = JSON.parse(await readFile(SETUP_FILE, "utf-8"));
+    if (typeof data.setup_id === "string" && data.setup_id) {
+      return data.setup_id;
+    }
+  } catch {
+    // file doesn't exist or is invalid
+  }
+  throw new Error("No setup_id found. Run 'agentspend card setup' first.");
+}
+
+async function createCard(): Promise<CardCreateResponse> {
+  const response = await fetch(`${API_BASE}/v1/card/create`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({})
+  });
+
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`Failed to create card (${response.status}): ${body}`);
+  }
+
+  return (await response.json()) as CardCreateResponse;
+}
+
+async function getSetupStatus(setupId: string): Promise<CardSetupStatusResponse> {
+  const response = await fetch(`${API_BASE}/v1/card/setup/${encodeURIComponent(setupId)}`);
+
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`Failed to get setup status (${response.status}): ${body}`);
+  }
+
+  return (await response.json()) as CardSetupStatusResponse;
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export function registerCardCommands(program: Command): void {
+  const card = program
+    .command("card")
+    .description("Manage AgentSpend cards");
+
+  card
+    .command("status")
+    .description("Check the setup status of a pending card")
+    .action(async () => {
+      try {
+        const setupId = await readSetupId();
+        const status = await getSetupStatus(setupId);
+        console.log(`Setup ID:  ${status.setup_id}`);
+        console.log(`Status:    ${status.status}`);
+        console.log(`Expires:   ${status.expires_at}`);
+        if (status.card_id) {
+          console.log(`Card ID: ${status.card_id}`);
+        }
+      } catch (err: unknown) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+      }
+    });
+
+  card
+    .command("setup")
+    .description("Set up a card and wait until setup is complete")
+    .action(async () => {
+      try {
+        const result = await createCard();
+        console.log(`Setup ID: ${result.setup_id}`);
+        console.log(`Opening setup URL in browser...`);
+        openUrl(result.setup_url);
+
+        await ensureConfigDir();
+        await writeFile(SETUP_FILE, JSON.stringify({ setup_id: result.setup_id }, null, 2));
+
+        console.log("Waiting for setup to complete...");
+        while (true) {
+          await sleep(3000);
+          const status = await getSetupStatus(result.setup_id);
+
+          if (status.status === "ready") {
+            console.log(`Card is ready!`);
+            if (status.card_id) {
+              await writeFile(CARD_FILE, JSON.stringify({ card_id: status.card_id }, null, 2));
+              console.log(`Card ID saved to ${CARD_FILE}`);
+            }
+            // Clean up setup file
+            await unlink(SETUP_FILE).catch(() => {});
+            break;
+          }
+
+          if (status.status === "expired" || status.status === "failed") {
+            await unlink(SETUP_FILE).catch(() => {});
+            throw new Error(`Setup ${status.status}. Please try again.`);
+          }
+
+          process.stdout.write(".");
+        }
+      } catch (err: unknown) {
+        console.error(`\nError: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+      }
+    });
+}

package/src/commands/wallet.ts

@@ -0,0 +1,115 @@
+import { Command } from "commander";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const CONFIG_DIR = join(homedir(), ".agentspend");
+const WALLET_FILE = join(CONFIG_DIR, "wallet.json");
+
+async function ensureConfigDir(): Promise<void> {
+  await mkdir(CONFIG_DIR, { recursive: true });
+}
+
+interface WalletConfig {
+  address: string;
+  network: string;
+  private_key: string;
+}
+
+async function readWalletConfig(): Promise<WalletConfig | null> {
+  try {
+    const data = JSON.parse(await readFile(WALLET_FILE, "utf-8"));
+    if (typeof data.address === "string" && data.address) {
+      return data as WalletConfig;
+    }
+  } catch {
+    // file doesn't exist or is invalid
+  }
+  return null;
+}
+
+export function registerWalletCommands(program: Command): void {
+  const wallet = program
+    .command("wallet")
+    .description("Manage AgentSpend crypto wallets");
+
+  wallet
+    .command("create")
+    .description("Generate a new crypto wallet for x402 payments")
+    .option("--network <network>", "Chain identifier", "eip155:8453")
+    .action(async (opts: { network: string }) => {
+      try {
+        const existing = await readWalletConfig();
+        if (existing) {
+          console.log(`Wallet already exists.`);
+          console.log(`  Address: ${existing.address}`);
+          console.log(`  Network: ${existing.network}`);
+          console.log(`  Saved at: ${WALLET_FILE}`);
+          process.exit(0);
+        }
+
+        const { generatePrivateKey, privateKeyToAccount } = await import("viem/accounts");
+        const privateKey = generatePrivateKey();
+        const account = privateKeyToAccount(privateKey);
+
+        await ensureConfigDir();
+
+        const config: WalletConfig = {
+          address: account.address,
+          network: opts.network,
+          private_key: privateKey,
+        };
+
+        await writeFile(WALLET_FILE, JSON.stringify(config, null, 2));
+
+        console.log(`Wallet created. Address: ${account.address} — Fund it with USDC on Base.`);
+      } catch (err: unknown) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+      }
+    });
+
+  wallet
+    .command("status")
+    .description("Show wallet address, network, and USDC balance")
+    .action(async () => {
+      try {
+        const config = await readWalletConfig();
+        if (!config) {
+          console.log("No wallet configured.");
+          console.log("Run: agentspend wallet create");
+          process.exit(0);
+        }
+
+        console.log(`Address: ${config.address}`);
+        console.log(`Network: ${config.network}`);
+
+        // Fetch USDC balance on Base
+        try {
+          const { createPublicClient, http, parseAbi } = await import("viem");
+          const { base } = await import("viem/chains");
+
+          const client = createPublicClient({
+            chain: base,
+            transport: http(),
+          });
+
+          const usdcAddress = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" as `0x${string}`;
+          const balance = await client.readContract({
+            address: usdcAddress,
+            abi: parseAbi(["function balanceOf(address) view returns (uint256)"]),
+            functionName: "balanceOf",
+            args: [config.address as `0x${string}`],
+          });
+
+          const usdcBalance = Number(balance) / 1e6;
+          console.log(`USDC Balance: ${usdcBalance.toFixed(2)} USDC`);
+        } catch {
+          console.log("USDC Balance: (unable to fetch)");
+        }
+      } catch (err: unknown) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+      }
+    });
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import { registerCardCommands } from "./commands/card.js";
+import { registerWalletCommands } from "./commands/wallet.js";
+
+const program = new Command();
+
+program
+  .name("agentspend")
+  .description("AgentSpend CLI — manage cards and billing")
+  .version("0.1.0");
+
+registerCardCommands(program);
+registerWalletCommands(program);
+
+program.parse();

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}