@agentgrant.cash/cli 1.1.0 → 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/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/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.1.0",
+  "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
 ```