@getbags/cash 0.2.0

package/dist/parse.js

@@ -0,0 +1,482 @@
+import { walletDepositsVisible } from './deposits-visible.js';
+function takeFormat(rest, usage) {
+    let format = 'pretty';
+    const out = [];
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        if (arg === '--format') {
+            const value = rest[++i];
+            if (value !== 'json' && value !== 'pretty')
+                return { error: usage };
+            format = value;
+        }
+        else if (arg.startsWith('--format=')) {
+            const value = arg.slice('--format='.length);
+            if (value !== 'json' && value !== 'pretty')
+                return { error: usage };
+            format = value;
+        }
+        else {
+            out.push(arg);
+        }
+    }
+    return { format, rest: out };
+}
+export function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h' || argv[0] === 'help') {
+        return { command: 'help' };
+    }
+    const [cmd, ...rest] = argv;
+    switch (cmd) {
+        case 'redeem': {
+            const code = rest[0];
+            if (!code || code.startsWith('-')) {
+                return { command: 'error', message: 'usage: bags redeem <code>' };
+            }
+            return { command: 'redeem', code };
+        }
+        case 'balance':
+            return { command: 'balance' };
+        case 'discover': {
+            const parsed = takeFormat(rest, 'usage: bags discover [query] [--format json|pretty]');
+            if ('error' in parsed)
+                return { command: 'error', message: parsed.error };
+            const queryWords = [];
+            for (const arg of parsed.rest) {
+                if (arg.startsWith('-')) {
+                    return { command: 'error', message: `unknown flag: ${arg}` };
+                }
+                queryWords.push(arg);
+            }
+            const query = queryWords.join(' ').trim();
+            return { command: 'discover', format: parsed.format, query: query || undefined };
+        }
+        case 'fetch': {
+            let url;
+            let method = 'GET';
+            let body;
+            let maxPriceCents;
+            let paymentProtocol;
+            for (let i = 0; i < rest.length; i++) {
+                const arg = rest[i];
+                if (arg === '-m' || arg === '--method') {
+                    const value = rest[++i];
+                    if (!value) {
+                        return { command: 'error', message: 'usage: bags fetch <url> [-m METHOD]' };
+                    }
+                    method = value;
+                }
+                else if (arg.startsWith('--method=')) {
+                    method = arg.slice('--method='.length);
+                }
+                else if (arg === '-b' || arg === '--body') {
+                    const value = rest[++i];
+                    if (value === undefined) {
+                        return { command: 'error', message: 'usage: bags fetch <url> [-b JSON]' };
+                    }
+                    body = value;
+                }
+                else if (arg.startsWith('--body=')) {
+                    body = arg.slice('--body='.length);
+                }
+                else if (arg === '--max-price-cents') {
+                    const value = rest[++i];
+                    if (value === undefined || Number.isNaN(Number(value))) {
+                        return {
+                            command: 'error',
+                            message: 'usage: bags fetch <url> [--max-price-cents N]',
+                        };
+                    }
+                    maxPriceCents = Number(value);
+                }
+                else if (arg.startsWith('--max-price-cents=')) {
+                    const value = arg.slice('--max-price-cents='.length);
+                    if (Number.isNaN(Number(value))) {
+                        return {
+                            command: 'error',
+                            message: 'usage: bags fetch <url> [--max-price-cents N]',
+                        };
+                    }
+                    maxPriceCents = Number(value);
+                }
+                else if (arg === '--payment-protocol') {
+                    const value = rest[++i];
+                    if (value !== 'x402' && value !== 'mpp' && value !== 'auto') {
+                        return {
+                            command: 'error',
+                            message: 'usage: bags fetch <url> [--payment-protocol x402|mpp|auto]',
+                        };
+                    }
+                    paymentProtocol = value;
+                }
+                else if (arg.startsWith('--payment-protocol=')) {
+                    const value = arg.slice('--payment-protocol='.length);
+                    if (value !== 'x402' && value !== 'mpp' && value !== 'auto') {
+                        return {
+                            command: 'error',
+                            message: 'usage: bags fetch <url> [--payment-protocol x402|mpp|auto]',
+                        };
+                    }
+                    paymentProtocol = value;
+                }
+                else if (arg.startsWith('-')) {
+                    return { command: 'error', message: `unknown flag: ${arg}` };
+                }
+                else if (!url) {
+                    url = arg;
+                }
+                else {
+                    return { command: 'error', message: 'usage: bags fetch <url> [flags]' };
+                }
+            }
+            if (!url) {
+                return { command: 'error', message: 'usage: bags fetch <url> [flags]' };
+            }
+            return { command: 'fetch', url, method, body, maxPriceCents, paymentProtocol };
+        }
+        case 'sessions': {
+            const action = rest[0];
+            if (action !== 'list' && action !== 'close') {
+                return { command: 'error', message: 'usage: bags sessions list|close [id] [--all --yes]' };
+            }
+            const parsed = takeFormat(rest.slice(1), 'usage: bags sessions list|close [--format json|pretty]');
+            if ('error' in parsed)
+                return { command: 'error', message: parsed.error };
+            let sessionId;
+            let channelId;
+            let all = false;
+            let yes = false;
+            for (let i = 0; i < parsed.rest.length; i++) {
+                const arg = parsed.rest[i];
+                if (arg === '--all')
+                    all = true;
+                else if (arg === '--yes' || arg === '-y')
+                    yes = true;
+                else if (arg === '--id') {
+                    const value = parsed.rest[++i];
+                    if (!value)
+                        return { command: 'error', message: 'usage: bags sessions close --id <session-id>' };
+                    sessionId = value;
+                }
+                else if (arg.startsWith('--id=')) {
+                    sessionId = arg.slice('--id='.length);
+                }
+                else if (arg === '--channel') {
+                    const value = parsed.rest[++i];
+                    if (!value) {
+                        return { command: 'error', message: 'usage: bags sessions close --channel <channel-id>' };
+                    }
+                    channelId = value;
+                }
+                else if (arg.startsWith('--channel=')) {
+                    channelId = arg.slice('--channel='.length);
+                }
+                else if (arg.startsWith('-')) {
+                    return { command: 'error', message: `unknown flag: ${arg}` };
+                }
+                else if (!sessionId && !channelId) {
+                    // Positional: prefer UUID → session id, else channel id.
+                    if (/^[0-9a-f-]{36}$/i.test(arg))
+                        sessionId = arg;
+                    else
+                        channelId = arg;
+                }
+                else {
+                    return { command: 'error', message: 'usage: bags sessions list|close [id] [--all --yes]' };
+                }
+            }
+            if (action === 'close' && !all && !sessionId && !channelId) {
+                return {
+                    command: 'error',
+                    message: 'usage: bags sessions close <session-id|channel-id> | --all --yes',
+                };
+            }
+            if (action === 'close' && all && !yes) {
+                return {
+                    command: 'error',
+                    message: 'close --all requires --yes (mppx / AgentCash parity)',
+                };
+            }
+            return { command: 'sessions', action, sessionId, channelId, all, yes, format: parsed.format };
+        }
+        case 'init':
+            return { command: 'init' };
+        case 'fund': {
+            let open = false;
+            let create = false;
+            let network;
+            for (let i = 0; i < rest.length; i++) {
+                const arg = rest[i];
+                if (arg === '--open')
+                    open = true;
+                else if (arg === '--create')
+                    create = true;
+                else if (arg === '--network') {
+                    const value = rest[++i];
+                    if (!value)
+                        return { command: 'error', message: 'usage: bags fund [--network base|solana]' };
+                    network = value;
+                }
+                else if (arg.startsWith('--network=')) {
+                    network = arg.slice('--network='.length);
+                }
+                else if (arg.startsWith('-')) {
+                    return { command: 'error', message: 'usage: bags fund [--open] [--create] [--network NAME]' };
+                }
+                else {
+                    return { command: 'error', message: 'usage: bags fund [--open] [--create] [--network NAME]' };
+                }
+            }
+            return { command: 'fund', open, create, network };
+        }
+        case 'transactions': {
+            const parsed = takeFormat(rest, 'usage: bags transactions [--limit N] [--cursor C] [--format json|pretty]');
+            if ('error' in parsed)
+                return { command: 'error', message: parsed.error };
+            let limit;
+            let cursor;
+            for (let i = 0; i < parsed.rest.length; i++) {
+                const arg = parsed.rest[i];
+                if (arg === '--limit') {
+                    const value = parsed.rest[++i];
+                    if (value === undefined || Number.isNaN(Number(value))) {
+                        return { command: 'error', message: 'usage: bags transactions [--limit N]' };
+                    }
+                    limit = Number(value);
+                }
+                else if (arg.startsWith('--limit=')) {
+                    const value = arg.slice('--limit='.length);
+                    if (Number.isNaN(Number(value))) {
+                        return { command: 'error', message: 'usage: bags transactions [--limit N]' };
+                    }
+                    limit = Number(value);
+                }
+                else if (arg === '--cursor') {
+                    const value = parsed.rest[++i];
+                    if (!value)
+                        return { command: 'error', message: 'usage: bags transactions [--cursor C]' };
+                    cursor = value;
+                }
+                else if (arg.startsWith('--cursor=')) {
+                    cursor = arg.slice('--cursor='.length);
+                }
+                else if (arg.startsWith('-')) {
+                    return { command: 'error', message: `unknown flag: ${arg}` };
+                }
+                else {
+                    return {
+                        command: 'error',
+                        message: 'usage: bags transactions [--limit N] [--cursor C] [--format json|pretty]',
+                    };
+                }
+            }
+            return { command: 'transactions', limit, cursor, format: parsed.format };
+        }
+        case 'policies': {
+            const action = rest[0];
+            if (action !== 'get' && action !== 'set') {
+                return { command: 'error', message: 'usage: bags policies get|set [--key=value ...]' };
+            }
+            const parsed = takeFormat(rest.slice(1), 'usage: bags policies get|set [--format json|pretty]');
+            if ('error' in parsed)
+                return { command: 'error', message: parsed.error };
+            const sets = {};
+            for (const arg of parsed.rest) {
+                if (arg.startsWith('--') && arg.includes('=')) {
+                    const eq = arg.indexOf('=');
+                    const key = arg.slice(2, eq);
+                    const value = arg.slice(eq + 1);
+                    if (!key)
+                        return { command: 'error', message: 'usage: bags policies set --key=value' };
+                    sets[key] = value;
+                }
+                else if (arg.startsWith('-')) {
+                    return { command: 'error', message: `unknown flag: ${arg}` };
+                }
+                else {
+                    return { command: 'error', message: 'usage: bags policies get|set [--key=value ...]' };
+                }
+            }
+            if (action === 'set' && Object.keys(sets).length === 0) {
+                return {
+                    command: 'error',
+                    message: 'usage: bags policies set --per-call-cap-cents=50 [--daily-cap-cents=100]',
+                };
+            }
+            return { command: 'policies', action, format: parsed.format, sets };
+        }
+        case 'keys': {
+            const action = rest[0];
+            if (action !== 'create' && action !== 'list' && action !== 'revoke') {
+                return { command: 'error', message: 'usage: bags keys create|list|revoke' };
+            }
+            const parsed = takeFormat(rest.slice(1), 'usage: bags keys create|list|revoke [--format json|pretty]');
+            if ('error' in parsed)
+                return { command: 'error', message: parsed.error };
+            let label;
+            let id;
+            for (let i = 0; i < parsed.rest.length; i++) {
+                const arg = parsed.rest[i];
+                if (arg === '--label') {
+                    const value = parsed.rest[++i];
+                    if (!value)
+                        return { command: 'error', message: 'usage: bags keys create --label NAME' };
+                    label = value;
+                }
+                else if (arg.startsWith('--label=')) {
+                    label = arg.slice('--label='.length);
+                }
+                else if (arg === '--id') {
+                    const value = parsed.rest[++i];
+                    if (!value)
+                        return { command: 'error', message: 'usage: bags keys revoke --id ID' };
+                    id = value;
+                }
+                else if (arg.startsWith('--id=')) {
+                    id = arg.slice('--id='.length);
+                }
+                else if (arg.startsWith('-')) {
+                    return { command: 'error', message: `unknown flag: ${arg}` };
+                }
+                else if (action === 'revoke' && !id) {
+                    id = arg;
+                }
+                else {
+                    return { command: 'error', message: 'usage: bags keys create|list|revoke' };
+                }
+            }
+            if (action === 'revoke' && !id) {
+                return { command: 'error', message: 'usage: bags keys revoke --id <key-id>' };
+            }
+            return { command: 'keys', action, label, id, format: parsed.format };
+        }
+        case 'check': {
+            let url;
+            let method = 'GET';
+            let body;
+            let format = 'pretty';
+            for (let i = 0; i < rest.length; i++) {
+                const arg = rest[i];
+                if (arg === '-m' || arg === '--method') {
+                    const value = rest[++i];
+                    if (!value)
+                        return { command: 'error', message: 'usage: bags check <url> [-m METHOD]' };
+                    method = value;
+                }
+                else if (arg.startsWith('--method=')) {
+                    method = arg.slice('--method='.length);
+                }
+                else if (arg === '-b' || arg === '--body') {
+                    const value = rest[++i];
+                    if (value === undefined)
+                        return { command: 'error', message: 'usage: bags check <url> [-b JSON]' };
+                    body = value;
+                }
+                else if (arg.startsWith('--body=')) {
+                    body = arg.slice('--body='.length);
+                }
+                else if (arg === '--format') {
+                    const value = rest[++i];
+                    if (value !== 'json' && value !== 'pretty') {
+                        return { command: 'error', message: 'usage: bags check <url> [--format json|pretty]' };
+                    }
+                    format = value;
+                }
+                else if (arg.startsWith('--format=')) {
+                    const value = arg.slice('--format='.length);
+                    if (value !== 'json' && value !== 'pretty') {
+                        return { command: 'error', message: 'usage: bags check <url> [--format json|pretty]' };
+                    }
+                    format = value;
+                }
+                else if (arg.startsWith('-')) {
+                    return { command: 'error', message: `unknown flag: ${arg}` };
+                }
+                else if (!url) {
+                    url = arg;
+                }
+                else {
+                    return { command: 'error', message: 'usage: bags check <url> [flags]' };
+                }
+            }
+            if (!url)
+                return { command: 'error', message: 'usage: bags check <url> [flags]' };
+            return { command: 'check', url, method, body, format };
+        }
+        case 'search': {
+            const parsed = takeFormat(rest, 'usage: bags search <query> [--format json|pretty]');
+            if ('error' in parsed)
+                return { command: 'error', message: parsed.error };
+            const queryWords = [];
+            for (const arg of parsed.rest) {
+                if (arg.startsWith('-'))
+                    return { command: 'error', message: `unknown flag: ${arg}` };
+                queryWords.push(arg);
+            }
+            const query = queryWords.join(' ').trim();
+            if (!query)
+                return { command: 'error', message: 'usage: bags search <query>' };
+            return { command: 'search', query, format: parsed.format };
+        }
+        case 'register': {
+            const origin = rest[0];
+            if (!origin || origin.startsWith('-')) {
+                return { command: 'error', message: 'usage: bags register <origin>' };
+            }
+            return { command: 'register', origin };
+        }
+        default:
+            return { command: 'error', message: `unknown command: ${cmd}` };
+    }
+}
+function buildUsage() {
+    const fundLine = walletDepositsVisible()
+        ? '  fund [--open] [--create]      Print or create deposit addresses (USDC)\n'
+        : '';
+    return `BAGS Cash — hosted agent wallet for x402 + MPP
+
+Usage:
+  npx @getbags/cash <command>
+
+Workflow: balance → discover|search → check → fetch
+MPP streams: fetch (opens session) → sessions close
+
+Commands:
+  redeem <code>                 Redeem an invite code and save the wallet token
+  balance                       Show wallet balance and caps
+${fundLine}  discover [query]              List BAGS merchant endpoints (BAGS first)
+  search <query>                NL search: BAGS catalog + ecosystem index
+  check <url>                   Probe an endpoint for schema + exact quote (no pay)
+  fetch <url> [flags]           Pay and proxy an x402 / MPP endpoint
+  sessions list|close           List or close open MPP tempo:session channels
+  transactions                  List wallet ledger / spend history
+  policies get|set              Read or update spend policies
+  keys create|list|revoke       Manage per-agent wallet keys
+  register <origin>             Register an origin into the discover index
+  init                          Install the bags-cash agent skill into this repo
+
+Hosted skill (prompt paste):
+  Set up https://www.getbags.app/wallet/skill.md
+  Onboard: https://www.getbags.app/wallet/onboard
+
+Fetch / check flags:
+  -m, --method <METHOD>         HTTP method (default: GET)
+  -b, --body <JSON>             Request body as a JSON string
+  --max-price-cents <N>         Cap the payment amount (fetch only)
+  --payment-protocol x402|mpp|auto  Force rail (default: auto)
+  --format json|pretty          Machine or human output
+
+Sessions:
+  bags sessions list
+  bags sessions close <id>      Close one channel (session uuid or channel id)
+  bags sessions close --all --yes
+
+Env:
+  BAGS_API_URL                  API base URL (default: https://www.getbags.app)
+                                Staging example: https://staging.getbags.app
+
+Token is stored at ~/.bags/credentials.json (hosted wallet — no local private keys)
+`;
+}
+/** Help text; recomputed so WALLET_DEPOSITS_VISIBLE is respected at process start. */
+export const USAGE = buildUsage();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@getbags/cash",
+  "version": "0.2.0",
+  "description": "BAGS Cash CLI — hosted agent wallet for x402 (balance → discover → check → fetch)",
+  "type": "module",
+  "bin": {
+    "bags": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "SKILL.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "bags",
+    "x402",
+    "agentic-commerce",
+    "wallet",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getbagsapp/agentic-payments.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://getbags.app",
+  "author": "BAGS <hello@getbags.app>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "6.0.2",
+    "vitest": "^4.0.18"
+  }
+}