@bytevion/cli 0.2.0 → 0.4.0

package/dist/tui/state.js

@@ -0,0 +1,84 @@
+// Pure wizard state machine. No react, no ink, no Date.now / Math.random — every transition
+// is a deterministic function of (state, action) so the whole flow is unit-testable without a
+// terminal. The App component owns the side effects (calling ports) and dispatches results
+// back in here. Errors are NON-FATAL: an ERROR action records what broke and keeps the current
+// step mounted so the user can retry, never unwinding the wizard.
+export const STEPS = ['welcome', 'signin', 'provider', 'model', 'key', 'preset', 'integrate', 'done'];
+export function initialState(initial) {
+    return {
+        step: 'welcome',
+        busy: false,
+        signedIn: initial.signedIn,
+        email: initial.email,
+        providerStatus: 'pending',
+        models: [],
+        preset: 'maximum',
+        byteKey: initial.byteKey,
+        byteKeyRevealed: false,
+    };
+}
+function advance(step) {
+    const i = STEPS.indexOf(step);
+    return i >= 0 && i < STEPS.length - 1 ? STEPS[i + 1] : step;
+}
+export function reducer(state, action) {
+    switch (action.type) {
+        case 'BUSY':
+            return { ...state, busy: action.busy };
+        // Non-fatal: surface the message, drop the busy flag, stay on the same step.
+        case 'ERROR':
+            return { ...state, busy: false, error: { from: action.from, message: action.message } };
+        case 'CLEAR_ERROR':
+            return { ...state, error: undefined };
+        case 'NEXT':
+            return { ...state, step: advance(state.step), error: undefined };
+        case 'GOTO':
+            return { ...state, step: action.step, error: undefined };
+        case 'SIGNED_IN':
+            return { ...state, busy: false, signedIn: true, email: action.email ?? state.email, error: undefined, step: 'provider' };
+        case 'PICK_PROVIDER':
+            return { ...state, providerChoice: action.id, baseUrl: action.baseUrl, error: undefined };
+        case 'PROVIDER_RESULT': {
+            const models = action.models ?? [];
+            // Connected with models → go pick one. Saved/connected without models → skip the model
+            // step and move on; the summary will say "saved" so we never over-claim success.
+            const next = action.status === 'connected' && models.length ? 'model' : 'key';
+            return {
+                ...state,
+                busy: false,
+                error: undefined,
+                providerStatus: action.status,
+                models,
+                connId: action.connId,
+                step: next,
+            };
+        }
+        case 'PROVIDER_SKIP':
+            return { ...state, busy: false, error: undefined, providerStatus: 'skipped', models: [], step: 'key' };
+        // Stay on the provider step so the key entry remounts for another attempt.
+        case 'PROVIDER_RETRY':
+            return { ...state, busy: false, error: undefined, providerStatus: 'pending', step: 'provider' };
+        case 'PICK_MODEL':
+            return { ...state, model: action.model, error: undefined, step: 'key' };
+        case 'KEY_CREATED':
+            return { ...state, busy: false, byteKey: action.key, byteKeyRevealed: true, error: undefined };
+        case 'REVEAL_KEY':
+            return { ...state, byteKeyRevealed: true };
+        case 'PICK_PRESET':
+            return { ...state, preset: action.preset, error: undefined, step: 'integrate' };
+        case 'PICK_CONNECT':
+            return { ...state, connect: action.connect, error: undefined, step: 'done' };
+        default:
+            return state;
+    }
+}
+export function selectSummary(state) {
+    const provider = state.providerStatus === 'pending' ? 'skipped' : state.providerStatus;
+    return {
+        model: state.model,
+        provider,
+        preset: state.preset,
+        byteKeyCreated: Boolean(state.byteKey),
+        connect: state.connect && state.connect !== 'skip' ? state.connect : undefined,
+    };
+}

package/dist/tui/theme.d.ts

@@ -0,0 +1,23 @@
+export declare function hex(t: number): string;
+export declare function gradient(count: number): string[];
+export interface Glyphs {
+    filled: string;
+    check: string;
+    empty: string;
+    arrow: string;
+    bullet: string;
+    border: 'round' | 'classic';
+    spark: string[];
+    brand: string[];
+    divider: string;
+}
+export declare function glyphs(ascii: boolean): Glyphs;
+export interface Tone {
+    accent: string | undefined;
+    ok: string | undefined;
+    warn: string | undefined;
+    bad: string | undefined;
+    muted: string | undefined;
+    brandMid: string | undefined;
+}
+export declare function tones(plainColor: boolean): Tone;

package/dist/tui/theme.js

@@ -0,0 +1,49 @@
+// Byte's terminal palette. The signature is a cyan→blue per-character gradient (no library
+// does true gradients in a terminal, so we interpolate the RGB ramp ourselves and hand Ink a
+// hex per glyph). Everything degrades cleanly: under plainColor the colors collapse to a
+// single accent, under ascii the unicode glyph sets swap for 7-bit equivalents.
+const A = [0x22, 0xd3, 0xee]; // cyan-300  #22d3ee
+const B = [0x3b, 0x82, 0xf6]; // blue-500  #3b82f6
+// Interpolate a single channel/color t∈[0,1] across the cyan→blue ramp → "#rrggbb".
+export function hex(t) {
+    const clamped = t < 0 ? 0 : t > 1 ? 1 : t;
+    return ('#' +
+        A.map((a, i) => Math.round(a + (B[i] - a) * clamped).toString(16).padStart(2, '0')).join(''));
+}
+// Spread N glyphs evenly across the gradient. A single glyph sits at the cyan end.
+export function gradient(count) {
+    if (count <= 1)
+        return [hex(0)];
+    return Array.from({ length: count }, (_, i) => hex(i / (count - 1)));
+}
+const UNICODE = {
+    filled: '●',
+    check: '✓',
+    empty: '○',
+    arrow: '›',
+    bullet: '•',
+    border: 'round',
+    spark: ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'],
+    brand: ['›', 'b', '_'],
+    divider: '─',
+};
+const ASCII = {
+    filled: '[*]',
+    check: '[x]',
+    empty: '[ ]',
+    arrow: '>',
+    bullet: '-',
+    border: 'classic',
+    spark: ['.', ':', '-', '=', '+', '*', '#'],
+    brand: ['>', 'b', '_'],
+    divider: '-',
+};
+export function glyphs(ascii) {
+    return ascii ? ASCII : UNICODE;
+}
+export function tones(plainColor) {
+    if (plainColor) {
+        return { accent: undefined, ok: undefined, warn: undefined, bad: undefined, muted: 'gray', brandMid: undefined };
+    }
+    return { accent: 'cyan', ok: 'green', warn: 'yellow', bad: 'red', muted: 'gray', brandMid: hex(0.5) };
+}

package/oclif.manifest.json

@@ -514,9 +514,9 @@
           "type": "option"
         },
         "model": {
-          "description": "Model or Byte alias",
+          "description": "Model or Byte alias (default: auto — routes to your enabled model)",
           "name": "model",
-          "default": "byte-default",
+          "default": "auto",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -609,12 +609,13 @@
           "type": "option"
         },
         "preset": {
-          "description": "Optimization preset",
+          "description": "Optimization mode",
           "name": "preset",
-          "default": "balanced",
+          "default": "maximum",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "maximum",
             "balanced",
             "max_savings",
             "lowest_latency",
@@ -1198,10 +1199,14 @@
         "rotate.js"
       ]
     },
-    "sessions": {
+    "providers:add": {
       "aliases": [],
       "args": {},
-      "description": "List active terminal sessions (CLI tokens) for the org.",
+      "description": "Connect an upstream provider key (BYOK). Byte stores it encrypted and imports models.",
+      "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 ..."
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1225,11 +1230,53 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider": {
+          "description": "Provider preset id (openai, deepseek, anthropic, …)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "Upstream provider API key",
+          "env": "BYTE_PROVIDER_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "provider-base-url": {
+          "description": "Custom base URL (for --provider custom or to override)",
+          "name": "provider-base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "mode": {
+          "description": "Gateway mode (byte_compatible/byte_messages/byte_generative)",
+          "name": "mode",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "label": {
+          "description": "Label for this connection",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-fetch": {
+          "description": "Skip auto-importing the model list",
+          "name": "no-fetch",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions",
+      "id": "providers:add",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1239,20 +1286,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "index.js"
+        "providers",
+        "add.js"
       ]
     },
-    "sessions:revoke": {
+    "providers:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Session id (see `byte sessions`)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Revoke a terminal session (CLI token) by id.",
+      "args": {},
+      "description": "List upstream provider connections for the current org.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1280,7 +1321,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:revoke",
+      "id": "providers:list",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1290,26 +1331,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "revoke.js"
+        "providers",
+        "list.js"
       ]
     },
-    "opt:preset": {
+    "providers:rotate": {
       "aliases": [],
       "args": {
-        "preset": {
-          "description": "Preset to apply",
-          "name": "preset",
-          "options": [
-            "balanced",
-            "max_savings",
-            "lowest_latency",
-            "reliability_first"
-          ],
+        "id": {
+          "description": "Connection id (see `byte providers list`)",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Apply an optimization preset for the whole org.",
+      "description": "Replace the upstream API key on a provider connection (keeps imported models).",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1333,11 +1368,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "api-key": {
+          "description": "New upstream provider API key",
+          "env": "BYTE_PROVIDER_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "opt:preset",
+      "id": "providers:rotate",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1347,35 +1390,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "opt",
-        "preset.js"
+        "providers",
+        "rotate.js"
       ]
     },
-    "opt:set": {
+    "providers:test": {
       "aliases": [],
       "args": {
-        "flag": {
-          "description": "Optimization field name",
-          "name": "flag",
-          "required": true
-        },
-        "value": {
-          "description": "on or off",
-          "name": "value",
-          "options": [
-            "on",
-            "off",
-            "true",
-            "false"
-          ],
+        "id": {
+          "description": "Connection id (see `byte providers list`)",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Toggle a single optimization layer on or off. See field names with `byte opt show --json`.",
-      "examples": [
-        "<%= config.bin %> opt set compression_enabled off",
-        "<%= config.bin %> opt set response_cache_enabled on"
-      ],
+      "description": "Verify a provider connection by re-fetching its model list.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1403,7 +1431,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "opt:set",
+      "id": "providers:test",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1413,14 +1441,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "opt",
-        "set.js"
+        "providers",
+        "test.js"
       ]
     },
-    "opt:show": {
+    "sessions": {
       "aliases": [],
       "args": {},
-      "description": "Show the current optimization preset and layer states for the org.",
+      "description": "List active terminal sessions (CLI tokens) for the org.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1448,7 +1476,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "opt:show",
+      "id": "sessions",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1458,18 +1486,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "opt",
-        "show.js"
+        "sessions",
+        "index.js"
       ]
     },
-    "providers:add": {
+    "sessions:revoke": {
       "aliases": [],
-      "args": {},
-      "description": "Connect an upstream provider key (BYOK). Byte stores it encrypted and imports models.",
-      "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 ..."
-      ],
+      "args": {
+        "id": {
+          "description": "Session id (see `byte sessions`)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Revoke a terminal session (CLI token) by id.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1493,53 +1523,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "provider": {
-          "description": "Provider preset id (openai, deepseek, anthropic, …)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "Upstream provider API key",
-          "env": "BYTE_PROVIDER_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "provider-base-url": {
-          "description": "Custom base URL (for --provider custom or to override)",
-          "name": "provider-base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "mode": {
-          "description": "Gateway mode (byte_compatible/byte_messages/byte_generative)",
-          "name": "mode",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "label": {
-          "description": "Label for this connection",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-fetch": {
-          "description": "Skip auto-importing the model list",
-          "name": "no-fetch",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:add",
+      "id": "sessions:revoke",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1549,14 +1537,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "add.js"
+        "sessions",
+        "revoke.js"
       ]
     },
-    "providers:list": {
+    "opt:preset": {
       "aliases": [],
-      "args": {},
-      "description": "List upstream provider connections for the current org.",
+      "args": {
+        "preset": {
+          "description": "Mode to apply",
+          "name": "preset",
+          "options": [
+            "maximum",
+            "max_savings",
+            "balanced",
+            "lowest_latency",
+            "reliability_first"
+          ],
+          "required": true
+        }
+      },
+      "description": "Apply an optimization mode for the whole org (maximum, balanced, max_savings, lowest_latency, reliability_first).",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1584,7 +1585,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:list",
+      "id": "opt:preset",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1594,20 +1595,35 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "list.js"
+        "opt",
+        "preset.js"
       ]
     },
-    "providers:rotate": {
+    "opt:set": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Connection id (see `byte providers list`)",
-          "name": "id",
+        "flag": {
+          "description": "Optimization field name",
+          "name": "flag",
+          "required": true
+        },
+        "value": {
+          "description": "on or off",
+          "name": "value",
+          "options": [
+            "on",
+            "off",
+            "true",
+            "false"
+          ],
           "required": true
         }
       },
-      "description": "Replace the upstream API key on a provider connection (keeps imported models).",
+      "description": "Toggle a single optimization layer on or off. See field names with `byte opt show --json`.",
+      "examples": [
+        "<%= config.bin %> opt set compression_enabled off",
+        "<%= config.bin %> opt set response_cache_enabled on"
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1631,19 +1647,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "api-key": {
-          "description": "New upstream provider API key",
-          "env": "BYTE_PROVIDER_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:rotate",
+      "id": "opt:set",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1653,20 +1661,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "rotate.js"
+        "opt",
+        "set.js"
       ]
     },
-    "providers:test": {
+    "opt:show": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Connection id (see `byte providers list`)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Verify a provider connection by re-fetching its model list.",
+      "args": {},
+      "description": "Show the current optimization mode and every layer running on your requests.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1694,7 +1696,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:test",
+      "id": "opt:show",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1704,10 +1706,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "test.js"
+        "opt",
+        "show.js"
       ]
     }
   },
-  "version": "0.2.0"
+  "version": "0.4.0"
 }