@bytevion/cli 0.1.0 → 0.2.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/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/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>;
     };

package/dist/commands/providers/add.js

@@ -1,39 +1,121 @@
 "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 util_1 = require("../../lib/util");
+const providers_1 = require("../../lib/providers");
+const tty_1 = require("../../lib/tty");
+const ui = __importStar(require("../../lib/ui"));
 class ProvidersAdd extends base_1.BaseCommand {
-    static description = 'Add an upstream provider key (BYOK). Byte stores it encrypted and can auto-import models.';
-    static examples = ['<%= config.bin %> providers add', '<%= config.bin %> providers add --api-key sk-... --label "OpenAI prod"'];
+    static description = 'Connect an upstream provider key (BYOK). Byte stores it encrypted and imports models.';
+    static examples = [
+        '<%= config.bin %> providers add --provider deepseek --api-key sk-...',
+        '<%= config.bin %> providers add --provider custom --provider-base-url https://api.example.com/v1 --api-key ...',
+    ];
     static flags = {
+        provider: core_1.Flags.string({ description: 'Provider preset id (openai, deepseek, anthropic, …)' }),
         'api-key': core_1.Flags.string({ description: 'Upstream provider API key', env: 'BYTE_PROVIDER_KEY' }),
-        mode: core_1.Flags.string({ description: 'Gateway mode for this provider', default: 'byte_auto' }),
-        label: core_1.Flags.string({ description: 'A label for this connection' }),
-        'no-fetch': core_1.Flags.boolean({ description: 'Skip auto-importing the provider model list' }),
+        'provider-base-url': core_1.Flags.string({ description: 'Custom base URL (for --provider custom or to override)' }),
+        mode: core_1.Flags.string({ description: 'Gateway mode (byte_compatible/byte_messages/byte_generative)' }),
+        label: core_1.Flags.string({ description: 'Label for this connection' }),
+        'no-fetch': core_1.Flags.boolean({ description: 'Skip auto-importing the model list' }),
     };
     async run() {
         const { flags } = await this.parse(ProvidersAdd);
         this.requireToken(flags);
+        const api = this.api(flags);
+        let preset = flags.provider ? (0, providers_1.findPreset)(flags.provider) : undefined;
+        if (flags.provider && !preset) {
+            return this.error(`Unknown provider "${flags.provider}". Run \`byte providers add --help\` for the list.`, { exit: 2 });
+        }
+        let baseUrl = flags['provider-base-url'] || preset?.base_url;
+        let mode = flags.mode || preset?.gateway_mode || 'byte_compatible';
         let apiKey = flags['api-key'];
+        if ((0, tty_1.interactive)() && !this.jsonEnabled() && (!preset || !baseUrl || !apiKey)) {
+            if (!preset) {
+                const id = await ui.select({
+                    message: 'Which provider?',
+                    options: providers_1.PROVIDER_PRESETS.map((p) => ({ value: p.id, label: p.label, hint: p.advanced ? 'advanced' : undefined })),
+                });
+                preset = (0, providers_1.findPreset)(id);
+                baseUrl = preset.base_url;
+                mode = preset.gateway_mode;
+            }
+            if (preset.custom || !baseUrl) {
+                baseUrl = await ui.text({ message: 'Provider base URL', placeholder: 'https://api.example.com/v1', validate: (v) => (v.startsWith('http') ? undefined : 'Must be a URL') });
+            }
+            if (preset.advanced && preset.note)
+                await ui.log.warn(preset.note);
+            if (!apiKey)
+                apiKey = await ui.password({ message: `${preset.label} API key`, validate: (v) => (v.trim() ? undefined : 'Required') });
+        }
         if (!apiKey)
-            apiKey = await (0, util_1.promptHidden)('Upstream provider API key: ');
-        if (!apiKey)
-            return this.error('A provider API key is required.', { exit: 2 });
-        const body = {
-            api_key: apiKey,
-            gateway_mode: flags.mode,
-            auto_fetch: !flags['no-fetch'],
-        };
+            return this.error('Missing --api-key (or run interactively).', { exit: 2 });
+        if (!baseUrl)
+            return this.error('Missing provider base URL — pass --provider <preset> or --provider-base-url.', { exit: 2 });
+        const body = { api_key: apiKey, gateway_mode: mode, base_url: baseUrl, auto_fetch: !flags['no-fetch'] };
         if (flags.label)
             body.label = flags.label;
-        const res = await this.api(flags).providersAdd(body);
-        if (!this.jsonEnabled()) {
-            const id = res.id ?? res.connection?.id;
-            const imported = res.fetch_result?.imported ?? res.imported ?? 0;
-            this.log(`Provider connection added (id ${id}). Models imported: ${imported}.`);
-            this.log('Next: `byte keys create <name>` then `byte integrate <harness>`.');
+        if ((0, tty_1.interactive)() && !this.jsonEnabled()) {
+            const spin = await ui.spinner();
+            spin.start('Connecting provider…');
+            let res;
+            try {
+                res = await api.providersAdd(body);
+            }
+            catch (err) {
+                spin.stop('Connection failed.');
+                throw err;
+            }
+            const models = res.fetch_result?.models ?? res.models ?? [];
+            spin.stop(`Connected — ${models.length} model(s) imported.`);
+            if (models.length) {
+                const alias = await ui.select({
+                    message: 'Model id to use in your tools',
+                    options: models.slice(0, 50).map((m) => ({ value: m.byte_alias, label: m.byte_alias, hint: m.model_id })),
+                });
+                await ui.note(alias, 'Model id (use this everywhere)');
+            }
+            return res;
         }
+        const res = await api.providersAdd(body);
+        if (this.jsonEnabled())
+            return res;
+        const id = res.id ?? res.connection?.id;
+        const imported = res.fetch_result?.imported ?? res.imported ?? 0;
+        this.log(`Provider connection added (id ${id}). Models imported: ${imported}.`);
         return res;
     }
 }