@bankr/cli 0.2.11 → 0.2.15

package/README.md

@@ -10,12 +10,14 @@ npm install -g @bankr/cli
 
 ## Quick Start
 
+A [Bankr Club subscription](https://bankr.bot) or LLM credits (Max Mode) is required to use the agent. There is no free tier.
+
 ```bash
 # Authenticate with your API key
 bankr login
 
 # Send a prompt
-bankr prompt "what's trending on base?"
+bankr agent "what's trending on base?"
 
 # Or use the shorthand (no subcommand)
 bankr "what is the price of ETH?"
@@ -60,17 +62,17 @@ bankr logout
 
 ```bash
 # Send a prompt and wait for the response
-bankr prompt "swap 10 USDC to ETH on base"
+bankr agent "swap 10 USDC to ETH on base"
 
 # Shorthand — just pass the prompt directly
 bankr "what are the top holders of VIRTUAL?"
 
 # Continue the most recent conversation
-bankr prompt --continue "and what about SOL?"
-bankr prompt -c "compare them"
+bankr agent --continue "and what about SOL?"
+bankr agent -c "compare them"
 
 # Continue a specific thread
-bankr prompt --thread thr_ABC123 "tell me more"
+bankr agent --thread thr_ABC123 "tell me more"
 ```
 
 ### Token Launch
@@ -95,12 +97,37 @@ bankr launch --name "TESTCOIN" --fee "0x1234..." --fee-type wallet -y
 
 ```bash
 # Check the status of a job
-bankr status job_ABC123DEF456
+bankr agent status job_ABC123DEF456
 
 # Cancel a running job
-bankr cancel job_ABC123DEF456
+bankr agent cancel job_ABC123DEF456
+```
+
+### LLM Gateway
+
+Launch Claude Code / OpenCode routed through the Bankr gateway:
+
+```bash
+# Claude Code (auto-translates dotted model IDs to the Anthropic wire format)
+bankr llm claude --model claude-opus-4-7
+
+# Or use dotted form — bankr llm claude rewrites it to claude-opus-4-7
+bankr llm claude --model claude-opus-4.7
+
+# OpenCode (use the bankr/ prefix with the gateway-canonical dotted form)
+bankr llm opencode -m bankr/claude-opus-4.7
 ```
 
+**Claude Code model format**: Claude Code's `--model` flag expects
+Anthropic-style dashed IDs (`claude-opus-4-7`, `claude-sonnet-4-6`,
+`claude-haiku-4-5`). If you pass the gateway-canonical dotted form
+(`claude-opus-4.7`), Claude Code silently falls back to its default —
+the flag appears honored but the real request is a different model.
+
+`bankr llm claude` translates dotted → dashed for you. If you use older
+versions of the CLI (or invoke `claude` directly via `ANTHROPIC_BASE_URL`),
+pass the dashed form explicitly.
+
 ### Configuration
 
 ```bash

package/dist/cli.js

@@ -23,7 +23,10 @@ import { updateCommand } from "./commands/update.js";
 import { whoamiCommand } from "./commands/whoami.js";
 import { tokensSearchCommand, tokensInfoCommand } from "./commands/tokens.js";
 import { x402InitCommand, x402AddCommand, x402ConfigureCommand, x402DeployCommand, x402ListCommand, x402PauseResumeCommand, x402DeleteCommand, x402RevenueCommand, x402EnvSetCommand, x402EnvListCommand, x402EnvUnsetCommand, x402SearchCommand, x402SchemaCommand, x402CallCommand, } from "./commands/x402.js";
+import { webhooksInitCommand, webhooksAddCommand, webhooksDeployCommand, webhooksListCommand, webhooksPauseResumeCommand, webhooksDeleteCommand, webhooksLogsCommand, webhooksEnvSetCommand, webhooksEnvListCommand, webhooksEnvUnsetCommand, } from "./commands/webhooks.js";
 import { profileViewCommand, profileCreateCommand, profileUpdateCommand, profileDeleteCommand, profileAddUpdateCommand, } from "./commands/profile.js";
+import { filesListCommand, filesUploadCommand, filesDownloadCommand, filesMkdirCommand, filesRmCommand, filesStorageCommand, filesCatCommand, filesEditCommand, filesWriteCommand, filesSearchCommand, filesMvCommand, filesRenameCommand, filesInfoCommand, } from "./commands/files.js";
+import { clubStatusCommand, clubSignupCommand, clubCancelCommand, } from "./commands/club.js";
 import * as output from "./lib/output.js";
 import { checkForUpdate } from "./lib/updateCheck.js";
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
@@ -564,14 +567,19 @@ program
     .command("logout")
     .description("Clear stored credentials")
     .action(logoutCommand);
-// ── Deprecated aliases (kept for backward compat) ──────────────────────
+// ── Deprecated aliases (hidden from help, show runtime warning) ──────
+function deprecatedCmd(oldCmd, newCmd) {
+    output.warn(`"bankr ${oldCmd}" is deprecated and will be removed in a future release. Use "bankr ${newCmd}" instead.`);
+    console.log();
+}
 program
-    .command("balances")
+    .command("balances", { hidden: true })
     .description("Deprecated: use `bankr wallet portfolio` instead")
     .option("--chain <chains>", "Chain(s) to fetch (comma-separated)")
     .option("--json", "Output raw JSON")
     .option("--low-value", "Include low-value tokens (under $1)")
     .action(async (opts) => {
+    deprecatedCmd("balances", "wallet portfolio");
     await balancesCommand({
         chain: opts.chain,
         json: opts.json,
@@ -579,29 +587,37 @@ program
     });
 });
 program
-    .command("prompt [text...]")
+    .command("prompt [text...]", { hidden: true })
     .description("Deprecated: use `bankr agent <prompt>` instead")
     .option("--thread <id>")
     .option("-c, --continue")
     .option("-m, --model <model>")
     .action(async (text, opts, cmd) => {
+    deprecatedCmd("prompt", "agent <prompt>");
     opts.model ?? (opts.model = cmd.parent?.opts()?.model);
     const joined = text.join(" ").trim();
     await promptCommand(joined || (await readPromptInput()), opts);
 });
 program
-    .command("status <jobId>")
+    .command("status <jobId>", { hidden: true })
     .description("Deprecated: use `bankr agent status` instead")
-    .action(statusCommand);
+    .action(async (jobId) => {
+    deprecatedCmd("status", "agent status");
+    await statusCommand(jobId);
+});
 program
-    .command("cancel <jobId>")
+    .command("cancel <jobId>", { hidden: true })
     .description("Deprecated: use `bankr agent cancel` instead")
-    .action(cancelCommand);
+    .action(async (jobId) => {
+    deprecatedCmd("cancel", "agent cancel");
+    await cancelCommand(jobId);
+});
 const profileAliasCmd = program
-    .command("profile")
+    .command("profile", { hidden: true })
     .description("Deprecated: use `bankr agent profile` instead")
     .option("--json", "Output raw JSON")
     .action(async (opts) => {
+    deprecatedCmd("profile", "agent profile");
     await profileViewCommand({ json: opts.json });
 });
 profileAliasCmd
@@ -613,6 +629,7 @@ profileAliasCmd
     .option("--website <url>", "Project website URL")
     .option("--json", "Output raw JSON")
     .action(async (opts) => {
+    deprecatedCmd("profile create", "agent profile create");
     await profileCreateCommand({
         name: opts.name,
         description: opts.description,
@@ -631,6 +648,7 @@ profileAliasCmd
     .option("--website <url>", "Project website URL")
     .option("--json", "Output raw JSON")
     .action(async (opts) => {
+    deprecatedCmd("profile update", "agent profile update");
     await profileUpdateCommand({
         name: opts.name,
         description: opts.description,
@@ -640,13 +658,17 @@ profileAliasCmd
         json: opts.json,
     });
 });
-profileAliasCmd.command("delete").action(profileDeleteCommand);
+profileAliasCmd.command("delete").action(async () => {
+    deprecatedCmd("profile delete", "agent profile delete");
+    await profileDeleteCommand();
+});
 profileAliasCmd
     .command("add-update")
     .option("--title <title>", "Update title")
     .option("--content <text>", "Update content")
     .option("--json", "Output raw JSON")
     .action(async (opts) => {
+    deprecatedCmd("profile add-update", "agent profile add-update");
     await profileAddUpdateCommand({
         title: opts.title,
         content: opts.content,
@@ -654,13 +676,14 @@ profileAliasCmd
     });
 });
 program
-    .command("sign")
+    .command("sign", { hidden: true })
     .description("Deprecated: use `bankr wallet sign` instead")
     .requiredOption("-t, --type <type>", "Signature type")
     .option("-m, --message <message>", "Message to sign")
     .option("--typed-data <json>", "EIP-712 typed data as JSON")
     .option("--transaction <json>", "Transaction as JSON")
     .action(async (opts) => {
+    deprecatedCmd("sign", "wallet sign");
     await signCommand({
         type: opts.type,
         message: opts.message,
@@ -669,7 +692,7 @@ program
     });
 });
 const submitAliasCmd = program
-    .command("submit")
+    .command("submit", { hidden: true })
     .description("Deprecated: use `bankr wallet submit` instead");
 submitAliasCmd
     .command("tx")
@@ -686,6 +709,7 @@ submitAliasCmd
     .option("-d, --description <text>", "Description")
     .option("--no-wait", "Don't wait for confirmation")
     .action(async (opts) => {
+    deprecatedCmd("submit tx", "wallet submit tx");
     await submitCommand({
         to: opts.to,
         chainId: opts.chainId,
@@ -706,6 +730,7 @@ submitAliasCmd
     .option("-d, --description <text>", "Description")
     .option("--no-wait", "Don't wait for confirmation")
     .action(async (transaction, opts) => {
+    deprecatedCmd("submit json", "wallet submit json");
     await submitJsonCommand(transaction, {
         noWait: !opts.wait,
         description: opts.description,
@@ -718,6 +743,96 @@ program
     .action(async (opts) => {
     await updateCommand({ check: opts.check });
 });
+// ── File Storage ────────────────────────────────────────────────────────
+const filesCmd = program
+    .command("files")
+    .description("Manage your file storage")
+    .action(() => filesListCommand({}));
+filesCmd
+    .command("ls")
+    .description("List files")
+    .option("--folder <path>", "Filter by folder path")
+    .action(filesListCommand);
+filesCmd
+    .command("upload <file>")
+    .description("Upload a file from your local machine")
+    .option("--folder <path>", "Destination folder (default: /)")
+    .action(filesUploadCommand);
+filesCmd
+    .command("download <fileId>")
+    .description("Get a download URL for a file")
+    .action(filesDownloadCommand);
+filesCmd
+    .command("mkdir <name>")
+    .description("Create a folder")
+    .option("--parent <path>", "Parent folder path (default: /)")
+    .action(filesMkdirCommand);
+filesCmd
+    .command("rm <fileId>")
+    .description("Delete a file")
+    .action(filesRmCommand);
+filesCmd
+    .command("storage")
+    .description("Show storage usage and quota")
+    .action(filesStorageCommand);
+filesCmd
+    .command("cat <fileId>")
+    .description("Print file contents to stdout (or save to a local path)")
+    .option("-o, --output <path>", "Save contents to a local file instead of stdout")
+    .action(filesCatCommand);
+filesCmd
+    .command("edit <fileId>")
+    .description("Edit a file in place: find-and-replace (--find + --replace) or full overwrite (--content or --from)")
+    .option("-f, --find <text>", "Text to find (requires --replace)")
+    .option("-r, --replace <text>", "Replacement text (requires --find)")
+    .option("--all", "Replace every occurrence (default: must match once)")
+    .option("--content <text>", "Full new file content (overwrite mode)")
+    .option("--from <path>", "Read new file content from a local file (overwrite mode)")
+    .action(filesEditCommand);
+filesCmd
+    .command("write <fileId>")
+    .description("Overwrite a file's text content from a local file or stdin")
+    .option("--from <path>", "Read content from a local file (default: stdin)")
+    .action(filesWriteCommand);
+filesCmd
+    .command("search <query>")
+    .description("Search files by filename, extension, or description")
+    .option("--folder <path>", "Limit search to a specific folder")
+    .option("--mime-type <prefix>", "Filter by MIME type prefix (e.g. text/, image/)")
+    .option("--limit <n>", "Max results (default: 20)")
+    .action(async (query, opts) => filesSearchCommand(query, opts));
+filesCmd
+    .command("mv <fileId> <folder>")
+    .description("Move a file to a different folder")
+    .action(filesMvCommand);
+filesCmd
+    .command("rename <fileId> <name>")
+    .description("Rename a file or folder")
+    .action(filesRenameCommand);
+filesCmd
+    .command("info <fileId>")
+    .description("Show file metadata")
+    .action(filesInfoCommand);
+// ── Bankr Club ────────────────────────────────────────────────────────
+const clubCmd = program
+    .command("club")
+    .description("View Bankr Club membership, sign up, or cancel")
+    .action(clubStatusCommand);
+clubCmd
+    .command("status")
+    .description("Show your Bankr Club membership status")
+    .action(clubStatusCommand);
+clubCmd
+    .command("signup")
+    .description("Sign up for Bankr Club (pays in $BNKR from your wallet)")
+    .option("--yearly", "Subscribe yearly instead of monthly")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .action(clubSignupCommand);
+clubCmd
+    .command("cancel")
+    .description("Cancel your Bankr Club subscription")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .action(clubCancelCommand);
 // ── x402 Endpoint Hosting ─────────────────────────────────────────────
 const x402Cmd = program
     .command("x402")
@@ -773,6 +888,58 @@ x402EnvCmd
     .command("unset <key>")
     .description("Remove an env var")
     .action(x402EnvUnsetCommand);
+// ── User Webhooks ─────────────────────────────────────────────────────
+const webhooksCmd = program
+    .command("webhooks")
+    .description("Deploy and manage user webhooks that trigger the Bankr agent on external events");
+webhooksCmd
+    .command("init")
+    .description("Scaffold webhooks/ folder and bankr.webhooks.json config")
+    .action(webhooksInitCommand);
+webhooksCmd
+    .command("add <name>")
+    .description("Add a new webhook handler")
+    .option("--provider <name>", "Scaffold with a provider template: slack | github | stripe | generic", "generic")
+    .action((name, opts) => webhooksAddCommand(name, { provider: opts.provider }));
+webhooksCmd
+    .command("deploy [name]")
+    .description("Bundle and deploy webhooks to Bankr")
+    .action(webhooksDeployCommand);
+webhooksCmd
+    .command("list")
+    .description("List your deployed webhooks")
+    .action(webhooksListCommand);
+webhooksCmd
+    .command("pause <name>")
+    .description("Pause a deployed webhook")
+    .action(async (name) => webhooksPauseResumeCommand(name, "pause"));
+webhooksCmd
+    .command("resume <name>")
+    .description("Resume a paused webhook")
+    .action(async (name) => webhooksPauseResumeCommand(name, "resume"));
+webhooksCmd
+    .command("delete <name>")
+    .description("Delete a deployed webhook (cannot be undone)")
+    .action(webhooksDeleteCommand);
+webhooksCmd
+    .command("logs <name>")
+    .description("View recent invocations for a webhook")
+    .action(webhooksLogsCommand);
+const webhooksEnvCmd = webhooksCmd
+    .command("env")
+    .description("Manage encrypted environment variables for your webhooks");
+webhooksEnvCmd
+    .command("set <keyValue>")
+    .description("Set an env var (KEY=VALUE)")
+    .action(webhooksEnvSetCommand);
+webhooksEnvCmd
+    .command("list")
+    .description("List env var names")
+    .action(webhooksEnvListCommand);
+webhooksEnvCmd
+    .command("unset <key>")
+    .description("Remove an env var")
+    .action(webhooksEnvUnsetCommand);
 x402Cmd
     .command("search [query...]")
     .description("Search the x402 service marketplace (no auth required)")

package/dist/commands/club.d.ts

@@ -0,0 +1,9 @@
+export declare function clubStatusCommand(): Promise<void>;
+export declare function clubSignupCommand(opts: {
+    yearly?: boolean;
+    yes?: boolean;
+}): Promise<void>;
+export declare function clubCancelCommand(opts: {
+    yes?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=club.d.ts.map

package/dist/commands/club.js

@@ -0,0 +1,151 @@
+import { confirm } from "@inquirer/prompts";
+import { CLI_USER_AGENT, getApiUrl, requireApiKey } from "../lib/config.js";
+import * as output from "../lib/output.js";
+function authHeaders() {
+    return {
+        "X-API-Key": requireApiKey(),
+        "Content-Type": "application/json",
+        "User-Agent": CLI_USER_AGENT,
+    };
+}
+async function fetchStatus() {
+    const res = await fetch(`${getApiUrl()}/bankr-club/`, {
+        headers: authHeaders(),
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({ error: res.statusText }));
+        throw new Error(body.error || res.statusText);
+    }
+    return (await res.json());
+}
+function formatRenewDate(unix) {
+    if (!unix)
+        return "—";
+    return new Date(unix * 1000).toLocaleDateString();
+}
+// ── Status ──────────────────────────────────────────────────────────────
+export async function clubStatusCommand() {
+    const spinner = output.spinner("Fetching Bankr Club status...");
+    try {
+        const status = await fetchStatus();
+        spinner.stop();
+        if (!status.hasBankrClub) {
+            output.label("Membership", output.fmt.dim("Not a member"));
+            output.dim("Run `bankr club signup` to join.");
+            return;
+        }
+        const state = status.active
+            ? output.fmt.success("active")
+            : output.fmt.warn("cancelled (grace period)");
+        output.label("Membership", state);
+        if (status.subscriptionType) {
+            output.label("Plan", status.subscriptionType);
+        }
+        if (status.renewOrCancelOn) {
+            const label = status.active ? "Renews on" : "Ends on";
+            output.label(label, formatRenewDate(status.renewOrCancelOn));
+        }
+        if (typeof status.dailyMessageCount === "number") {
+            output.label("Messages today", String(status.dailyMessageCount));
+        }
+    }
+    catch (err) {
+        spinner.stop();
+        output.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+// ── Sign up ─────────────────────────────────────────────────────────────
+export async function clubSignupCommand(opts) {
+    try {
+        const current = await fetchStatus();
+        if (current.hasBankrClub && current.active) {
+            output.warn("You already have an active Bankr Club subscription.");
+            return;
+        }
+        const yearly = !!opts.yearly;
+        const quoteRes = await fetch(`${getApiUrl()}/bankr-club/quote?yearly=${yearly}`, { headers: authHeaders() });
+        if (!quoteRes.ok) {
+            const body = await quoteRes
+                .json()
+                .catch(() => ({ error: quoteRes.statusText }));
+            throw new Error(body.error || quoteRes.statusText);
+        }
+        const quote = (await quoteRes.json());
+        output.label("Plan", yearly ? "Yearly" : "Monthly");
+        output.label("Price", `${output.formatUsd(quote.usdPrice)} (in $BNKR)`);
+        output.label("Cost", `${quote.priceInBankr} BNKR`);
+        output.dim(`Quote expires ${new Date(quote.expiresAt * 1000).toLocaleString()}.`);
+        output.blank();
+        output.dim("Payment is deducted from the $BNKR balance in your Bankr wallet.");
+        const ok = opts.yes ||
+            (await confirm({
+                message: "Confirm subscription?",
+                default: false,
+                theme: output.bankrTheme,
+            }));
+        if (!ok) {
+            output.dim("Cancelled.");
+            return;
+        }
+        const spinner = output.spinner("Signing up for Bankr Club...");
+        const signUpRes = await fetch(`${getApiUrl()}/bankr-club/sign-up?yearly=${yearly}`, { headers: authHeaders() });
+        spinner.stop();
+        if (!signUpRes.ok) {
+            const body = await signUpRes
+                .json()
+                .catch(() => ({ error: signUpRes.statusText }));
+            throw new Error(body.error || signUpRes.statusText);
+        }
+        output.success("Welcome to Bankr Club!");
+        output.dim("Run `bankr club` to see your status.");
+    }
+    catch (err) {
+        output.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+// ── Cancel ──────────────────────────────────────────────────────────────
+export async function clubCancelCommand(opts) {
+    try {
+        const status = await fetchStatus();
+        if (!status.hasBankrClub) {
+            output.dim("You are not a Bankr Club member.");
+            return;
+        }
+        if (!status.active) {
+            output.dim("Your subscription is already cancelled.");
+            if (status.renewOrCancelOn) {
+                output.dim(`Access ends on ${formatRenewDate(status.renewOrCancelOn)}.`);
+            }
+            return;
+        }
+        const ok = opts.yes ||
+            (await confirm({
+                message: "Cancel Bankr Club? You'll keep access until the current billing period ends.",
+                default: false,
+                theme: output.bankrTheme,
+            }));
+        if (!ok) {
+            output.dim("Cancelled (subscription unchanged).");
+            return;
+        }
+        const spinner = output.spinner("Cancelling subscription...");
+        const res = await fetch(`${getApiUrl()}/bankr-club/cancel`, {
+            method: "POST",
+            headers: authHeaders(),
+        });
+        spinner.stop();
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(body.error || res.statusText);
+        }
+        output.success("Subscription cancelled.");
+        output.dim("You'll keep Bankr Club access until the end of the current billing period.");
+    }
+    catch (err) {
+        output.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=club.js.map

package/dist/commands/files.d.ts

@@ -0,0 +1,34 @@
+export declare function filesListCommand(opts: {
+    folder?: string;
+}): Promise<void>;
+export declare function filesUploadCommand(filePath: string, opts: {
+    folder?: string;
+}): Promise<void>;
+export declare function filesDownloadCommand(fileId: string): Promise<void>;
+export declare function filesMkdirCommand(name: string, opts: {
+    parent?: string;
+}): Promise<void>;
+export declare function filesRmCommand(fileId: string): Promise<void>;
+export declare function filesStorageCommand(): Promise<void>;
+export declare function filesCatCommand(fileId: string, opts: {
+    output?: string;
+}): Promise<void>;
+export declare function filesEditCommand(fileId: string, opts: {
+    find?: string;
+    replace?: string;
+    all?: boolean;
+    content?: string;
+    from?: string;
+}): Promise<void>;
+export declare function filesWriteCommand(fileId: string, opts: {
+    from?: string;
+}): Promise<void>;
+export declare function filesSearchCommand(query: string, opts: {
+    folder?: string;
+    mimeType?: string;
+    limit?: string;
+}): Promise<void>;
+export declare function filesMvCommand(fileId: string, folder: string): Promise<void>;
+export declare function filesRenameCommand(fileId: string, name: string): Promise<void>;
+export declare function filesInfoCommand(fileId: string): Promise<void>;
+//# sourceMappingURL=files.d.ts.map