@bytevion/cli 0.3.0 → 0.4.1

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"
@@ -1199,23 +1199,10 @@
         "rotate.js"
       ]
     },
-    "opt:preset": {
+    "sessions": {
       "aliases": [],
-      "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).",
+      "args": {},
+      "description": "List active terminal sessions (CLI tokens) for the org.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1243,7 +1230,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "opt:preset",
+      "id": "sessions",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1253,80 +1240,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "opt",
-        "preset.js"
+        "sessions",
+        "index.js"
       ]
     },
-    "opt:set": {
+    "sessions:revoke": {
       "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": "Session id (see `byte sessions`)",
+          "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"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "profile": {
-          "description": "Configuration profile to use",
-          "env": "BYTE_PROFILE",
-          "name": "profile",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "base-url": {
-          "description": "Override the API base URL",
-          "env": "BYTE_BASE_URL",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "opt:set",
-      "pluginAlias": "@bytevion/cli",
-      "pluginName": "@bytevion/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "opt",
-        "set.js"
-      ]
-    },
-    "opt:show": {
-      "aliases": [],
-      "args": {},
-      "description": "Show the current optimization mode and every layer running on your requests.",
+      "description": "Revoke a terminal session (CLI token) by id.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1354,7 +1281,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "opt:show",
+      "id": "sessions:revoke",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1364,8 +1291,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "opt",
-        "show.js"
+        "sessions",
+        "revoke.js"
       ]
     },
     "providers:add": {
@@ -1614,10 +1541,23 @@
         "test.js"
       ]
     },
-    "sessions": {
+    "opt:preset": {
       "aliases": [],
-      "args": {},
-      "description": "List active terminal sessions (CLI tokens) for the 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.",
@@ -1645,7 +1585,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions",
+      "id": "opt:preset",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1655,20 +1595,35 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "index.js"
+        "opt",
+        "preset.js"
       ]
     },
-    "sessions:revoke": {
+    "opt:set": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Session id (see `byte sessions`)",
-          "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": "Revoke a terminal session (CLI token) by id.",
+      "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.",
@@ -1696,7 +1651,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:revoke",
+      "id": "opt:set",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1706,10 +1661,55 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "revoke.js"
+        "opt",
+        "set.js"
+      ]
+    },
+    "opt:show": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the current optimization mode and every layer running on your requests.",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "profile": {
+          "description": "Configuration profile to use",
+          "env": "BYTE_PROFILE",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "Override the API base URL",
+          "env": "BYTE_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "opt:show",
+      "pluginAlias": "@bytevion/cli",
+      "pluginName": "@bytevion/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "opt",
+        "show.js"
       ]
     }
   },
-  "version": "0.3.0"
+  "version": "0.4.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytevion/cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Byte — control your LLM optimization gateway from the terminal.",
   "author": "Byte",
   "license": "UNLICENSED",
@@ -8,7 +8,8 @@
     "access": "public"
   },
   "bin": {
-    "byte": "./bin/run.js"
+    "byte": "./bin/run.js",
+    "bytevion": "./bin/run.js"
   },
   "type": "commonjs",
   "engines": {
@@ -23,11 +24,18 @@
     "@clack/prompts": "^1.5.0",
     "@oclif/core": "^4.0.0",
     "cli-table3": "^0.6.5",
-    "picocolors": "^1.1.1"
+    "ink": "^7.0.5",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "picocolors": "^1.1.1",
+    "react": "^19.2.6"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "@types/react": "^19.2.15",
+    "ink-testing-library": "^4.0.0",
     "oclif": "^4.14.0",
+    "tsx": "^4.22.3",
     "typescript": "^5.5.0"
   },
   "oclif": {
@@ -66,7 +74,11 @@
     }
   },
   "scripts": {
-    "build": "tsc -b && oclif manifest",
+    "build": "tsc -b && node scripts/tui-pkg.js && oclif manifest",
+    "postinstall": "node ./bin/postinstall.js",
+    "test": "npm run build && npm run test:unit && npm run test:tui",
+    "test:unit": "tsx --test \"src/**/*.test.ts\" \"src/**/*.test.tsx\"",
+    "test:tui": "node --test \"src/**/*.test.mts\"",
     "clean": "tsc -b --clean",
     "prepublishOnly": "node -e \"const fs=require('fs');for(const f of (fs.existsSync('dist')?fs.readdirSync('dist'):[])){if(f.endsWith('.tar.gz')||f.endsWith('.tar.xz')||f.startsWith('SHA256SUMS'))fs.rmSync('dist/'+f,{force:true})}\"",
     "prepack": "npm run build",