@bankr/cli 0.2.13 → 0.2.15

package/README.md

@@ -10,6 +10,8 @@ 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
@@ -101,6 +103,31 @@ bankr agent status 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"));
@@ -740,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")
@@ -795,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