@agentgrant.cash/cli 1.0.2 → 1.2.0

package/dist/cli/commands/portfolio.js

@@ -141,7 +141,7 @@ async function gatherExtras(ctx) {
 }
 async function gather(cmd) {
     const ctx = buildContext(cmd);
-    const [prefsR, moneyR, extrasR, agentR] = await Promise.allSettled([
+    const [prefsR, moneyR, extrasR, agentR, creditR] = await Promise.allSettled([
         ctx.money.connected ? loadDisplayPrefs(ctx) : Promise.resolve(DEFAULT_PREFS),
         ctx.money.connected
             ? ctx.money.getPortfolio("full")
@@ -150,6 +150,9 @@ async function gather(cmd) {
         ctx.agent.connected
             ? ctx.agent.balance()
             : Promise.resolve(null),
+        ctx.agent.connected
+            ? ctx.agent.credit()
+            : Promise.resolve(null),
     ]);
     return {
         ctx,
@@ -159,6 +162,7 @@ async function gather(cmd) {
         moneyFailed: moneyR.status === "rejected",
         agent: agentR.status === "fulfilled" ? agentR.value : null,
         agentFailed: agentR.status === "rejected",
+        credit: creditR.status === "fulfilled" ? creditR.value : null,
     };
 }
 /** Indent every line of a block by two spaces. */
@@ -171,7 +175,7 @@ function indent(block) {
 export function registerPortfolio(program) {
     const run = async (cmd) => {
         const g = await gather(cmd);
-        const { ctx, prefs, money, extras, moneyFailed, agent, agentFailed } = g;
+        const { ctx, prefs, money, extras, moneyFailed, agent, agentFailed, credit } = g;
         emit(ctx, {
             investments: money
                 ? {
@@ -186,6 +190,8 @@ export function registerPortfolio(program) {
                 }
                 : null,
             spending: agent,
+            // The free-credit / wallet split (parity with the app's Spending screen).
+            credit,
         }, () => {
             if (!ctx.money.connected && !ctx.agent.connected)
                 return "Not connected yet. Run `grant login`.";
@@ -208,7 +214,7 @@ export function registerPortfolio(program) {
                 lines.push(ui.dim("  Not connected."));
             }
             else if (agent) {
-                lines.push(formatAgentFunds(agent));
+                lines.push(formatAgentFunds(agent, credit));
             }
             else {
                 lines.push(ui.amber(`  ${agentFailed ? "Temporarily unavailable." : "—"}`));

package/dist/cli/index.js

@@ -37,6 +37,7 @@ import { registerAccount } from "./perfolio-commands/account.js";
 import { registerTx } from "./perfolio-commands/tx.js";
 import { registerSession } from "./perfolio-commands/session.js";
 import { registerLoans } from "./perfolio-commands/loans.js";
+import { registerSpending } from "./perfolio-commands/spending.js";
 let version = "0.0.0";
 try {
     version =
@@ -66,6 +67,7 @@ registerEarn(program);
 registerHyperliquid(program);
 registerPolymarket(program);
 registerLoans(program);
+registerSpending(program);
 registerAccount(program);
 registerTx(program);
 registerSession(program);

package/dist/cli/perfolio-commands/spending.js

@@ -0,0 +1,57 @@
+import { buildCtx, requireAuth, out, fail, resolveCash } from '../money-helpers.js';
+import { describeCashResolution } from '../../lib/index.js';
+import { waitForTx } from '../../lib/verify.js';
+/**
+ * Spending account — the agent's pay-per-use balance (USDC on Base). It is
+ * funded by bridging cash out of the main account, mirroring the other
+ * account-to-account transfers already in the CLI:
+ *   - cash ↔ trading      → `hl deposit` / `hl withdraw`
+ *   - cash ↔ predictions  → `polymarket deposit` / `polymarket withdraw`
+ *   - cash → spending      → `spending deposit`   (this file)
+ *
+ * The reverse (spending → cash) has NO backend route — the spending balance is
+ * receive-only, exactly as in the web app (AccountTransferFlow) — so we offer
+ * only the inbound transfer and don't fabricate a withdraw.
+ */
+export function registerSpending(program) {
+    const spending = program
+        .command('spending')
+        .description('Your agent spending account (pay-per-use balance)');
+    spending
+        .command('deposit')
+        .alias('add')
+        .alias('top-up')
+        .description('Move cash from your account into your agent spending balance (autonomous — no browser)')
+        .requiredOption('--amount <amount>', 'cash to move into spending — in your display currency by default; prefix $/₹ to force one, or pass --usd')
+        .option('--usd', 'interpret --amount as US dollars, ignoring your display currency')
+        .option('--no-wait', 'return immediately without waiting for the bridge tx to confirm')
+        .action(async (opts, cmd) => {
+        const ctx = buildCtx(cmd);
+        requireAuth(ctx);
+        // Autonomous: POST /tx/bridge-base builds the USDT-approve + Across bridge
+        // (ETH USDT → Base USDC) and executes them via the Biconomy session grant
+        // (agent-signed) — no browser. Two-stage settlement, same as `hl deposit`:
+        // the bridge tx confirms the Ethereum leg, but Across fills onto Base a few
+        // MINUTES later. So a confirmed tx means the funds are on their way, NOT
+        // yet spendable — we confirm the tx and say so honestly (no false "done").
+        const m = await resolveCash(ctx, opts.amount, 6, { usd: !!opts.usd });
+        const wait = opts.wait !== false;
+        const label = `Move ${describeCashResolution(m)} cash → spending`;
+        const res = await ctx.client.bridgeToBase({ amountUsdt: m.usdString });
+        const txHash = res?.txHash;
+        const tail = txHash ? ` (tx ${txHash})` : '';
+        if (!wait) {
+            out(ctx, `Submitted: ${label}${tail}.\nFunds arrive in your spending balance a few minutes after the bridge tx confirms — check \`grant portfolio\`.`, { submitted: true, confirmed: false, status: res?.status ?? 'submitted', txHash, quote: res?.quote });
+            return;
+        }
+        const txResult = await waitForTx(ctx.client, txHash);
+        if (txResult.status === 'failed')
+            fail(`${label} failed on-chain${tail}.`, ctx.json);
+        if (txResult.status === 'success') {
+            out(ctx, `✓ ${label}: bridge tx confirmed${tail}. Your spending balance updates in a few minutes once the funds land on Base — check \`grant portfolio\`.`, { submitted: true, confirmed: true, settledOnBase: false, status: 'success', txHash, quote: res?.quote });
+        }
+        else {
+            out(ctx, `${label}: submitted${tail} but not yet confirmed. Re-check with \`grant tx status${txHash ? ` ${txHash}` : ''}\`.`, { submitted: true, confirmed: false, settledOnBase: false, status: txResult.status, txHash, quote: res?.quote });
+        }
+    });
+}

package/dist/lib/agent-client.js

@@ -74,6 +74,15 @@ export class AgentClient {
     balance() {
         return this.request("GET", "/balance", { auth: true });
     }
+    /**
+     * The chain-agnostic spendable split — sign-up free credit + funds you added +
+     * total. Hits `GET /credit` (dual-auth, so the api-key works). This is the same
+     * figure the app shows on the Spending screen; `balance()` (/balance) carries
+     * the session status, so the portfolio uses both.
+     */
+    credit() {
+        return this.request("GET", "/credit", { auth: true });
+    }
     /**
      * Find a payable endpoint in the curated catalog. Hits `GET /marketplace/x402`
      * (the grouped, public catalog route) — NOT `/marketplace`, which does not

package/dist/lib/client.js

@@ -260,6 +260,19 @@ export class PerfolioClient {
      * so its "submitted" was a false positive that moved no funds.)
      */
     hlDeposit(b) { return this.post(this.urls.api, '/tx/bridge-deposit', b); }
+    /**
+     * Autonomous cash → spending bridge. Hits POST /tx/bridge-base, which builds
+     * the USDT-approve + Across bridge (ETH USDT → Base USDC) and executes them via
+     * the Biconomy defi session grant (agent-signed) — no user signature, no
+     * browser. Funds the Grant Cash agent's USDC spending balance on Base. A
+     * returned txHash means the Ethereum leg was SUBMITTED; the spending balance
+     * updates on Base a few minutes later once Across fills. Mirrors hlDeposit
+     * (/tx/bridge-deposit) — same Across Swap API + session execution; only the
+     * destination (Base 8453) and output token (USDC) differ.
+     */
+    bridgeToBase(b) {
+        return this.post(this.urls.api, '/tx/bridge-base', b);
+    }
     /** Autonomous HL → Ethereum withdrawal (server-signs via Privy; no browser). */
     hlWithdraw(b) {
         return this.post(this.urls.api, '/hl/withdraw-to-evm/execute', b);

package/dist/lib/portfolio-format.js

@@ -189,8 +189,15 @@ function usdcMinorPlain(minor) {
     const n = Number(minor) / 1e6;
     return `$${n.toFixed(n !== 0 && Math.abs(n) < 0.01 ? 4 : 2)}`;
 }
-/** Render the agent (spending) funds block as indented lines (no section title). */
-export function formatAgentFunds(bal) {
+/**
+ * Render the agent (spending) funds block as indented lines (no section title).
+ *
+ * When the chain-agnostic `credit` read (GET /credit) is supplied, we render the
+ * full split — total spendable, the sign-up free credit, and (if the user has
+ * funded a wallet) the funds they added — for parity with the app. Without it we
+ * fall back to the `/balance` status shape (USDC/USDT or sign-up-credit total).
+ */
+export function formatAgentFunds(bal, credit) {
     const status = bal.status;
     if (status === "not_set_up" || status === "no_active_session") {
         return [
@@ -203,10 +210,22 @@ export function formatAgentFunds(bal) {
     }
     if (status === "credit_exhausted") {
         return [
-            `  Sign-up credit used up — balance ${usdcMinorPlain(bal.totalMinor)}`,
+            `  Sign-up credit used up — balance ${usdcMinorPlain(bal.totalMinor ?? credit?.totalMinor)}`,
             "  Add funds to keep spending (`grant fetch`/`grant transfer` need a balance).",
         ].join("\n");
     }
+    // Prefer the chain-agnostic credit split (free credit + funds you added) when
+    // available — this is the same figure the app shows on the Spending screen.
+    if (credit && credit.totalMinor !== undefined) {
+        const lines = [`  Spendable: ${usdcMinorPlain(credit.totalMinor)}`];
+        lines.push(`    Free credit: ${usdcMinorPlain(credit.grantMinor)}`);
+        if (credit.walletMinor !== undefined) {
+            lines.push(`    Your wallet: ${usdcMinorPlain(credit.walletMinor)}`);
+        }
+        if (bal.address)
+            lines.push(`  Address:   ${bal.address}`);
+        return lines.join("\n");
+    }
     // active. A funded on-chain session carries live USDC/USDT; a grant-only user
     // carries the chain-agnostic sign-up credit total in minor units.
     if (bal.USDC !== undefined || bal.USDT !== undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentgrant.cash/cli",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "Grant Cash — one CLI for your money (gold) and your agent (pay-per-use services). Routes to the Perfolio backend and the Agent-mode backend behind a single, plain-language surface.",
   "type": "module",
   "bin": {

package/skills/grant-cash/SKILL.md

@@ -126,10 +126,18 @@ Every **cash** amount is in the user's display currency — a bare `50` means
 - `grant schema <slug>` — the exact pay contract for a catalogued service (no charge).
 - `grant fetch <url> [-m POST] [-b '<json>'] [--price <amount>] [--asset USDC|USDT]` (alias `pay`) — pay for and run a service.
 - `grant transfer <recipient> <amount>` — send money to an address.
+- `grant spending deposit --amount <cash>` (aliases `add`, `top-up`) — move cash from the Investments side into the Spending balance (the agent's pay-per-use money). Amount is in the user's currency — a bare `50` means ₹50 for an INR user, $50 for a USD user. Funds land a few minutes after submitting. There is no reverse: Spending is funded from cash, not the other way around.
 - `grant redeem <code>` — claim an invite or bonus credit toward spending.
 - `grant upgrade` — get a one-time link to secure a full account and add spending funds.
 - `grant revoke` (alias `stop`) — stop all agent spending immediately.
 
+**Keeping Spending funded (assistant guidance).** The Spending balance only goes down as the agent pays for services — top it up from the user's cash with `grant spending deposit`:
+- **User asks explicitly** ("move ₹2,000 to spending", "top up my spending balance") → run `grant spending deposit --amount <cash>` directly. No need to ask again.
+- **Running low** (a paid action is about to exceed — or only barely fits — the remaining Spending balance) → before paying, tell the user the balance is low and ask whether to transfer some cash over first. Don't transfer without a yes.
+- **Empty / zero balance** (a `grant fetch`/pay fails for lack of funds, or `grant portfolio` shows Spending at 0) → tell the user their Spending account is empty and suggest moving some money in, **quoted in their local currency** — e.g. *"Your spending balance is empty — shall I move ₹2,000 (≈ $24) over from your cash?"* Then, on confirmation, run `grant spending deposit`.
+
+Always state amounts in the user's display currency (never raw USD/USDT or chains), and only transfer proactively after the user agrees — an explicit request is the go-ahead; a low/empty balance is a prompt to ask.
+
 ### Transactions & self-orientation
 - `grant tx status <txHash>` — check whether a transaction confirmed. `grant tx history [--limit <n>]` — recent transactions.
 - `grant session status` / `grant session grant` — your agent-access (session) status and how to enable it.
@@ -164,6 +172,7 @@ grant polymarket bet 0x1234 --side yes --amount 25    # bet $25 on "yes"
 grant search "web search" --limit 5                   # find a live service (Spending)
 grant check https://api.example.com/run               # what it costs + needs, no charge
 grant fetch https://api.example.com/run -b '{"q":"gold news today"}'   # pay + run
+grant spending deposit --amount 25                    # move $25 of cash into Spending
 grant activity --json                                 # full combined history
 grant revoke                                           # stop all agent spending
 ```