@bytevion/cli 0.1.0 → 0.3.0

package/README.md

@@ -0,0 +1,66 @@
+# @bytevion/cli — Byte from your terminal
+
+Control the Byte LLM-optimization gateway from the command line: connect a provider, mint a
+Byte key, wire your coding tool, and watch the savings — without leaving the terminal.
+
+```bash
+npm i -g @bytevion/cli      # Node >= 20.12
+byte                        # interactive home menu
+byte setup                  # guided setup (sign in → provider → key → tool)
+```
+
+## Quickstart
+
+```bash
+byte login                  # approve the device in your browser
+byte providers add --provider deepseek --api-key sk-...   # or run `byte setup`
+byte keys create my-key --preset lowest_latency
+byte integrate opencode --write
+byte run "hello from byte"
+byte usage
+```
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `byte` | Interactive home menu (run with no arguments in a terminal) |
+| `byte setup` (alias `init`) | Guided wizard: sign in → connect provider → create key → wire a tool |
+| `byte login` / `logout` / `whoami` | Device-code sign in / out / identity |
+| `byte providers add\|list\|rotate\|test` | Manage upstream provider keys (BYOK) |
+| `byte keys create\|list\|rotate\|revoke` | Manage Byte API keys (optional per-key `--preset`) |
+| `byte opt show\|set\|preset` | Inspect / tune optimizations |
+| `byte integrate <tool>` | Wire a coding harness or SDK (`--list` to see all, `--write` to apply) |
+| `byte run "<prompt>"` | One-off prompt through the gateway |
+| `byte compare "<prompt>"` | Run direct vs Byte and compare cost, latency, quality |
+| `byte usage` / `byte stats` | Usage and savings |
+| `byte env` | Print shell exports for an SDK/tool |
+| `byte doctor` | Connectivity / auth / provider / gateway health |
+| `byte batch submit\|list\|poll` | Offline, cost-optimized batch jobs |
+| `byte sessions` | List / revoke terminal sessions |
+
+## Providers (presets)
+
+`byte providers add --provider <id> --api-key <key>` — base URL and gateway mode are inferred:
+
+`openai`, `anthropic`, `deepseek`, `gemini`, `xai`, `groq`, `mistral`, `openrouter`, `together`,
+`fireworks`, `perplexity`, `cerebras`, `sambanova`, `deepinfra`, `moonshot`, `zhipu`, `qwen`,
+`nebius`, `hyperbolic`, `novita`, plus `custom` (`--provider-base-url`). Azure / Bedrock / Vertex /
+Cohere are advanced (need a deployment URL / SigV4 / OAuth2) — use `--provider-base-url` / the dashboard.
+
+## Tools you can wire (`byte integrate`)
+
+Claude Code, Codex CLI, opencode, Cursor, Cline, Aider, Continue, Roo Code, Windsurf, Zed, Goose,
+Kilo Code, Open Interpreter, Tabby, Cody, GitHub Copilot (BYOK) + Copilot CLI, Qwen Code, Kimi CLI,
+Gemini CLI, and the OpenAI / Anthropic SDKs.
+
+## Environment
+
+`BYTE_TOKEN` (control-plane token, for CI) · `BYTE_API_KEY` (gateway key) · `BYTE_PROFILE` ·
+`BYTE_BASE_URL` · `BYTE_HOME` · `BYTE_NO_MENU=1` (disable the home menu) · `NO_COLOR` · `CI`.
+
+Every command accepts `--json` for machine output and `--profile <name>` for multiple workspaces.
+
+## Exit codes
+
+`0` ok · `2` usage · `3` auth · `4` not configured · `5` offline · `6` upstream.

package/dist/base.js

@@ -6,6 +6,7 @@ const api_1 = require("./lib/api");
 const config_1 = require("./lib/config");
 const credentials_1 = require("./lib/credentials");
 const errors_1 = require("./lib/errors");
+const friendly_1 = require("./lib/friendly");
 class BaseCommand extends core_1.Command {
     static enableJsonFlag = true;
     static baseFlags = {
@@ -41,7 +42,13 @@ class BaseCommand extends core_1.Command {
     }
     async catch(err) {
         if (err instanceof errors_1.ByteError) {
-            return this.error(err.message, { code: err.code, exit: err.exit });
+            // --json callers want the machine-readable oclif error; humans get a panel that
+            // says what broke, why, and the exact next command — then we exit with the code.
+            if (this.jsonEnabled()) {
+                return this.error(err.message, { code: err.code, exit: err.exit });
+            }
+            this.logToStderr((0, friendly_1.renderErrorPanel)((0, friendly_1.friendlyError)(err)));
+            return this.exit(err.exit);
         }
         return super.catch(err);
     }

package/dist/commands/compare.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../base';
+export default class Compare extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        prompt: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        model: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/compare.js

@@ -0,0 +1,104 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../base");
+const tty_1 = require("../lib/tty");
+const ui = __importStar(require("../lib/ui"));
+const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : Number(v) || 0);
+const usd = (v) => `$${num(v).toFixed(6)}`;
+const tokensOf = (m) => num(m?.tokens_in) + num(m?.tokens_out);
+const pad = (s, n) => s.padEnd(n);
+class Compare extends base_1.BaseCommand {
+    static description = 'Prove the win: run a prompt direct vs through Byte and compare cost, latency, and quality.';
+    static examples = [
+        '<%= config.bin %> compare "Summarize the latest release notes"',
+        '<%= config.bin %> compare "Refactor this function" --model byte-2-deepseek-chat',
+    ];
+    static args = {
+        prompt: core_1.Args.string({ description: 'Prompt to run on both lanes', required: true }),
+    };
+    static flags = {
+        model: core_1.Flags.string({ description: 'Model id (byte alias) or "auto"', default: 'auto' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Compare);
+        this.requireToken(flags);
+        const api = this.api(flags);
+        const body = { messages: [{ role: 'user', content: args.prompt }], model: flags.model };
+        const panels = {};
+        const spin = !this.jsonEnabled() && (0, tty_1.interactive)() ? await ui.spinner() : null;
+        spin?.start('Running the prompt direct and through Byte…');
+        try {
+            for await (const event of api.compareStream(body)) {
+                const panel = String(event?.panel || '');
+                if (event?.metrics && (panel === 'direct' || panel === 'byte'))
+                    panels[panel] = event.metrics;
+            }
+        }
+        finally {
+            spin?.stop('Comparison complete');
+        }
+        const direct = panels.direct || {};
+        const byte = panels.byte || {};
+        const summary = byte.compare_summary || {};
+        if (this.jsonEnabled())
+            return { direct, byte, summary };
+        if (!panels.direct && !panels.byte) {
+            this.log('No comparison result was produced. Make sure a provider and model alias are configured (`byte setup`).');
+            return { direct, byte, summary };
+        }
+        const savings = num(summary.savings_usd ?? byte.savings_usd);
+        const savingsPct = num(byte.savings_pct);
+        const latencySaved = num(summary.latency_saved_ms ?? byte.latency_saved_ms);
+        const dominance = String(byte.dominance_status || summary.dominance_status || 'n/a');
+        const quality = String(byte.quality_guard_state || 'not_measured');
+        this.log('');
+        this.log(`  ${pad('', 16)}${pad('Direct', 18)}Byte`);
+        this.log(`  ${pad('Cost', 16)}${pad(usd(direct.cost_usd), 18)}${usd(byte.cost_usd)}`);
+        this.log(`  ${pad('Latency (ms)', 16)}${pad(String(num(direct.latency_ms)), 18)}${num(byte.latency_ms)}`);
+        this.log(`  ${pad('Tokens', 16)}${pad(String(tokensOf(direct)), 18)}${tokensOf(byte)}`);
+        this.log('');
+        const sign = latencySaved >= 0 ? '−' : '+';
+        this.log(`  Savings    ${usd(savings)} (${savingsPct.toFixed(1)}%)`);
+        this.log(`  Latency    ${sign}${Math.abs(latencySaved)} ms`);
+        this.log(`  Quality    ${quality}`);
+        const verdict = dominance === 'dominant' ? ui.theme.ok('Byte wins (dominant)') : ui.theme.warn(dominance);
+        this.log(`  Verdict    ${verdict}`);
+        this.log('');
+        return { direct, byte, summary };
+    }
+}
+exports.default = Compare;

package/dist/commands/integrate.d.ts

@@ -11,6 +11,7 @@ export default class Integrate extends BaseCommand {
         write: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         key: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        model: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         preset: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<unknown>;

package/dist/commands/integrate.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const node_fs_1 = require("node:fs");
@@ -8,12 +41,15 @@ const api_1 = require("../lib/api");
 const errors_1 = require("../lib/errors");
 const integrations_1 = require("../lib/integrations");
 const shell_1 = require("../lib/shell");
+const tty_1 = require("../lib/tty");
+const ui = __importStar(require("../lib/ui"));
+const util_1 = require("../lib/util");
 class Integrate extends base_1.BaseCommand {
-    static description = 'Wire a coding harness or SDK to Byte (Claude Code, Codex, Cursor, Cline, Aider, OpenAI/Anthropic SDK).';
+    static description = 'Wire a coding harness or SDK to Byte (Claude Code, Codex, opencode, Cursor, Cline, Aider, …).';
     static examples = [
         '<%= config.bin %> integrate --list',
-        '<%= config.bin %> integrate codex',
-        '<%= config.bin %> integrate claude-code --write --preset lowest_latency',
+        '<%= config.bin %> integrate opencode --write',
+        '<%= config.bin %> integrate claude-code --write --model byte-2-deepseek-chat',
     ];
     static args = {
         target: core_1.Args.string({ description: 'Target to wire (run --list to see all)', required: false }),
@@ -24,6 +60,7 @@ class Integrate extends base_1.BaseCommand {
         write: core_1.Flags.boolean({ description: 'Write tool config files (a timestamped .bak is kept)' }),
         yes: core_1.Flags.boolean({ char: 'y', description: 'Skip confirmation prompts' }),
         key: core_1.Flags.string({ description: 'Byte API key to use (defaults to the saved profile key)' }),
+        model: core_1.Flags.string({ description: 'Model id (byte alias) to wire (default byte-default)' }),
         preset: core_1.Flags.string({
             description: 'Apply this optimization preset to the org before wiring',
             options: ['balanced', 'max_savings', 'lowest_latency', 'reliability_first'],
@@ -31,16 +68,27 @@ class Integrate extends base_1.BaseCommand {
     };
     async run() {
         const { args, flags } = await this.parse(Integrate);
-        if (flags.list || !args.target) {
+        if (flags.list)
             return this.showList(flags);
+        let target = args.target;
+        if (!target) {
+            if ((0, tty_1.interactive)() && !this.jsonEnabled()) {
+                target = await ui.select({
+                    message: 'Connect which tool?',
+                    options: (0, integrations_1.listIntegrations)().map((i) => ({ value: i.key, label: i.title, hint: i.compat })),
+                });
+            }
+            else {
+                return this.showList(flags);
+            }
         }
-        const integ = (0, integrations_1.findIntegration)(args.target);
-        if (!integ) {
-            return this.error(`Unknown target "${args.target}". Run \`byte integrate --list\`.`, { exit: 2 });
-        }
+        const integ = (0, integrations_1.findIntegration)(target);
+        if (!integ)
+            return this.error(`Unknown target "${target}". Run \`byte integrate --list\`.`, { exit: 2 });
         const byteKey = flags.key || this.requireByteKey(flags);
         const base = this.baseUrlFrom(flags);
         const shell = (0, shell_1.detectShell)(flags.shell);
+        const modelAlias = flags.model || 'byte-default';
         if (flags.preset) {
             this.requireToken(flags);
             await this.api(flags).optPatch({ default_mode: flags.preset });
@@ -48,11 +96,10 @@ class Integrate extends base_1.BaseCommand {
         if (integ.compat === 'anthropic') {
             const exists = await this.messagesEndpointExists(base, byteKey);
             if (!exists) {
-                this.warn(`${integ.title} needs Byte's Anthropic endpoint (/v1/messages), which did not respond. ` +
-                    'The values below are correct once it is enabled on your gateway.');
+                this.warn(`${integ.title} needs Byte's Anthropic endpoint (/v1/messages). The values below are correct once it is enabled.`);
             }
         }
-        const result = integ.build({ baseUrl: base, byteKey });
+        const result = integ.build({ baseUrl: base, byteKey, modelAlias });
         if (!this.jsonEnabled()) {
             this.log(`Integrating ${integ.title} (${integ.compat}-compatible):`);
             this.log('');
@@ -65,9 +112,8 @@ class Integrate extends base_1.BaseCommand {
                     this.log(`    ${line}`);
             }
             if (result.settingsFile) {
-                if (flags.write) {
+                if (flags.write)
                     this.writeSettings(result.settingsFile);
-                }
                 else {
                     this.log('');
                     this.log(`  Tip: re-run with --write to update ${result.settingsFile.path} automatically.`);
@@ -77,7 +123,7 @@ class Integrate extends base_1.BaseCommand {
         else if (flags.write && result.settingsFile) {
             this.writeSettings(result.settingsFile);
         }
-        return { target: integ.key, compat: integ.compat, env: Object.fromEntries(result.env) };
+        return { target: integ.key, compat: integ.compat, model: modelAlias, env: Object.fromEntries(result.env) };
     }
     writeSettings(file) {
         let existing = {};
@@ -97,24 +143,26 @@ class Integrate extends base_1.BaseCommand {
         this.log(`  Updated ${file.path}`);
     }
     async messagesEndpointExists(base, byteKey) {
-        try {
-            await new api_1.ByteApi(base).probeMessages(byteKey);
-            return true;
-        }
-        catch (err) {
-            // 404 means the endpoint is not deployed; any other status means it exists.
-            if (err instanceof errors_1.ByteError)
-                return err.status !== 404;
-            return false;
-        }
+        const probe = (async () => {
+            try {
+                await new api_1.ByteApi(base).probeMessages(byteKey);
+                return true;
+            }
+            catch (err) {
+                if (err instanceof errors_1.ByteError)
+                    return err.status !== 404;
+                return false;
+            }
+        })();
+        // Never block the UX on a slow gateway; assume reachable on timeout.
+        return (0, util_1.withTimeout)(probe, 4000, true);
     }
     async showList(flags) {
         const targets = (0, integrations_1.listIntegrations)();
         const key = flags.key || this.optionalByteKey(flags);
         let messagesReady;
-        if (key) {
+        if (key)
             messagesReady = await this.messagesEndpointExists(this.baseUrlFrom(flags), key);
-        }
         const rows = targets.map((t) => ({
             target: t.key,
             title: t.title,
@@ -124,8 +172,8 @@ class Integrate extends base_1.BaseCommand {
         if (this.jsonEnabled())
             return rows;
         for (const r of rows) {
-            const status = r.ready === undefined ? 'unknown (sign in / create a key to probe)' : r.ready ? 'ready' : 'needs /v1/messages';
-            this.log(`${r.target.padEnd(14)} ${r.title.padEnd(16)} ${r.compat.padEnd(10)} ${status}`);
+            const status = r.ready === undefined ? 'sign in to probe' : r.ready ? 'ready' : 'needs /v1/messages';
+            this.log(`${r.target.padEnd(16)} ${r.title.padEnd(22)} ${r.compat.padEnd(10)} ${status}`);
         }
         return rows;
     }

package/dist/commands/login.js

@@ -1,76 +1,57 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
-const node_os_1 = require("node:os");
 const base_1 = require("../base");
-const api_1 = require("../lib/api");
-const config_1 = require("../lib/config");
-const credentials_1 = require("../lib/credentials");
-const errors_1 = require("../lib/errors");
-const util_1 = require("../lib/util");
+const auth_1 = require("../lib/auth");
+const ui = __importStar(require("../lib/ui"));
 class Login extends base_1.BaseCommand {
     static description = 'Sign in from this terminal by approving a device code in the dashboard.';
     static examples = ['<%= config.bin %> login', '<%= config.bin %> login --no-browser'];
     static flags = {
-        'no-browser': core_1.Flags.boolean({ description: 'Do not try to open the browser automatically' }),
+        'no-browser': core_1.Flags.boolean({ description: 'Do not open the browser automatically' }),
     };
     async run() {
         const { flags } = await this.parse(Login);
         const profile = this.profileFrom(flags);
         const base = this.baseUrlFrom(flags);
-        const api = new api_1.ByteApi(base);
-        const start = await api.deviceStart(`byte-cli@${(0, node_os_1.hostname)()}`);
-        const verifyUrl = start.verification_uri_complete || start.verification_uri;
-        this.log('');
-        this.log('  Approve this terminal in your browser:');
-        this.log(`    ${verifyUrl}`);
-        this.log('');
-        this.log(`  Verification code: ${start.user_code}`);
-        this.log('');
-        if (!flags['no-browser']) {
-            try {
-                await (0, util_1.openBrowser)(verifyUrl);
-            }
-            catch {
-                // user can open manually
-            }
-        }
-        let interval = (Number(start.interval) || 5) * 1000;
-        const deadline = Date.now() + (Number(start.expires_in) || 600) * 1000;
-        while (Date.now() < deadline) {
-            await (0, util_1.sleep)(interval);
-            try {
-                const tok = await api.deviceToken(start.device_code);
-                (0, credentials_1.setToken)(profile, tok.access_token);
-                (0, config_1.setProfile)(profile, {
-                    base_url: base,
-                    dashboard_url: (0, config_1.getProfile)(profile).dashboard_url || config_1.DEFAULT_DASHBOARD_URL,
-                    org_id: tok.org?.id,
-                    org_name: tok.org?.name,
-                    email: tok.user?.email,
-                });
-                if (!this.jsonEnabled()) {
-                    this.log(`Signed in as ${tok.user?.email} (org: ${tok.org?.name}).`);
-                    this.log('Next: run `byte init` to add a provider key and create your Byte API key.');
-                }
-                return { status: 'signed_in', email: tok.user?.email, org: tok.org?.name, profile };
-            }
-            catch (err) {
-                const code = err instanceof errors_1.ByteError ? err.code : '';
-                if (code === 'authorization_pending')
-                    continue;
-                if (code === 'slow_down') {
-                    interval += 5000;
-                    continue;
-                }
-                if (code === 'access_denied')
-                    return this.error('Authorization was denied in the dashboard.', { exit: 3 });
-                if (code === 'expired_token')
-                    return this.error('The code expired. Run `byte login` again.', { exit: 3 });
-                throw err;
-            }
+        const res = await (0, auth_1.deviceLogin)({ baseUrl: base, profile, noBrowser: flags['no-browser'] });
+        if (!this.jsonEnabled()) {
+            await ui.log.success(`Signed in as ${res.email} (org: ${res.org}). Next: byte setup`);
         }
-        return this.error('Login timed out. Run `byte login` again.', { exit: 3 });
+        return { status: 'signed_in', email: res.email, org: res.org, profile };
     }
 }
 exports.default = Login;

package/dist/commands/opt/preset.js

@@ -2,21 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
+const presets_1 = require("../../lib/presets");
 class OptPreset extends base_1.BaseCommand {
-    static description = 'Apply an optimization preset for the whole org.';
+    static description = 'Apply an optimization mode for the whole org (maximum, balanced, max_savings, lowest_latency, reliability_first).';
     static args = {
         preset: core_1.Args.string({
-            description: 'Preset to apply',
+            description: 'Mode to apply',
             required: true,
-            options: ['balanced', 'max_savings', 'lowest_latency', 'reliability_first'],
+            options: presets_1.PRESET_VALUES,
         }),
     };
     async run() {
         const { args, flags } = await this.parse(OptPreset);
         this.requireToken(flags);
         const res = await this.api(flags).optPatch({ default_mode: args.preset });
-        if (!this.jsonEnabled())
-            this.log(`Optimization preset set to "${args.preset}".`);
+        if (!this.jsonEnabled()) {
+            const card = (0, presets_1.presetCard)(args.preset);
+            this.log(`Optimization mode set to "${args.preset}".${card ? ` ${card.blurb}` : ''}`);
+        }
         return res;
     }
 }

package/dist/commands/opt/show.js

@@ -1,8 +1,13 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+const picocolors_1 = __importDefault(require("picocolors"));
 const base_1 = require("../../base");
+const presets_1 = require("../../lib/presets");
 class OptShow extends base_1.BaseCommand {
-    static description = 'Show the current optimization preset and layer states for the org.';
+    static description = 'Show the current optimization mode and every layer running on your requests.';
     async run() {
         const { flags } = await this.parse(OptShow);
         this.requireToken(flags);
@@ -10,14 +15,23 @@ class OptShow extends base_1.BaseCommand {
         if (this.jsonEnabled())
             return res;
         const settings = res.settings ?? res;
-        this.log(`Preset (default_mode): ${settings.default_mode ?? '-'}`);
-        this.log(`Cache mode:            ${settings.cache_mode ?? '-'}`);
+        const mode = settings.default_mode ?? '-';
+        const card = (0, presets_1.presetCard)(mode);
+        this.log('');
+        this.log(`  ${picocolors_1.default.bold('Optimization mode')}  ${picocolors_1.default.cyan(mode)}${card ? picocolors_1.default.dim(`  ${card.hint}`) : ''}`);
+        this.log(`  ${picocolors_1.default.bold('Cache mode')}         ${picocolors_1.default.cyan(settings.cache_mode ?? '-')}`);
         const layers = Array.isArray(res.layers) ? res.layers : [];
         if (layers.length) {
-            const enabled = layers.filter((l) => l.enabled).length;
-            this.log(`Layers enabled:        ${enabled}/${layers.length}`);
+            const on = layers.filter((l) => l.enabled).length;
+            this.log(`  ${picocolors_1.default.bold('Active layers')}      ${picocolors_1.default.green(String(on))}${picocolors_1.default.dim(`/${layers.length}`)} running on every request`);
+            this.log('');
+            for (const l of layers) {
+                const name = String(l.title ?? l.plain_label ?? l.key ?? 'layer');
+                this.log(l.enabled ? `  ${picocolors_1.default.green('●')} ${name}` : `  ${picocolors_1.default.dim('○')} ${picocolors_1.default.dim(name)}`);
+            }
         }
-        this.log('Run with --json for the full settings object.');
+        this.log('');
+        this.log(picocolors_1.default.dim('  Run with --json for the full settings object.'));
         return res;
     }
 }

package/dist/commands/providers/add.d.ts

@@ -3,8 +3,10 @@ export default class ProvidersAdd extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        provider: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'api-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        mode: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'provider-base-url': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        mode: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         label: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'no-fetch': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };