@boundless.network/setup 0.1.3 → 0.1.4

package/dist/app.js

@@ -22,12 +22,30 @@ import { LOGO, LOGO_COLUMNS, LOGO_ROWS } from "./ui/logo.js";
 import { ModelSelect } from "./ui/table.js";
 import { BAD, BRAND, MUTED, OK, WARN } from "./ui/theme.js";
 const NAV = "↑↓ navigate  enter select";
+const STEPS = new Set(["welcome", "existing", "harnesses", "scope", "store", "model", "review"]);
+const withBack = (hints, canBack) => (canBack ? `${hints}  esc back` : hints);
 function message(error) {
     return error instanceof Error ? error.message : String(error);
 }
 export function App({ onFinish }) {
     const { exit } = useApp();
     const [screen, setScreen] = useState({ kind: "boot" });
+    const history = useRef([]).current;
+    const canBack = history.length > 0;
+    const go = (next) => {
+        if (STEPS.has(screen.kind)) {
+            history.push(screen);
+        }
+        setScreen(next);
+    };
+    const back = () => {
+        const previous = history.pop();
+        if (previous) {
+            setScreen(previous);
+        }
+    };
+    const forget = () => history.splice(0);
+    const pickModels = () => go(wizard.catalog.length > 0 ? { kind: "model", role: "primary" } : { kind: "catalog" });
     const wizard = useRef({
         background: "",
         backups: [],
@@ -81,12 +99,12 @@ export function App({ onFinish }) {
         if (role === "primary") {
             wizard.primary = id;
             if (hasBackgroundSlot()) {
-                setScreen({ kind: "model", role: "background" });
+                go({ kind: "model", role: "background" });
                 return;
             }
         }
         wizard.background = id;
-        setScreen({ kind: "review" });
+        go({ kind: "review" });
     };
     const finish = () => {
         onFinish(summary());
@@ -98,69 +116,70 @@ export function App({ onFinish }) {
         case "welcome":
             return (_jsx(Welcome, { onSelect: (choice) => {
                     if (choice === "continue") {
-                        setScreen(wizard.existing?.valid ? { kind: "existing" } : { kind: "signin" });
+                        go(wizard.key ? { kind: "harnesses" } : wizard.existing?.valid ? { kind: "existing" } : { kind: "signin" });
                     }
                     else if (choice === "cancel") {
                         exit();
                     }
                     else {
-                        setScreen({ kind: "info", topic: choice });
+                        go({ kind: "info", topic: choice });
                     }
                 }, wizard: wizard }));
         case "info":
-            return _jsx(Info, { onBack: () => setScreen({ kind: "welcome" }), topic: screen.topic });
+            return _jsx(Info, { onBack: back, topic: screen.topic });
         case "existing":
-            return (_jsx(Existing, { onSelect: (choice) => {
+            return (_jsx(Existing, { canBack: canBack, onBack: back, onSelect: (choice) => {
                     if (choice === "reuse") {
                         wizard.key = wizard.existing?.key ?? null;
                         wizard.keyStore = wizard.existing?.source ?? "";
-                        setScreen({ kind: "harnesses" });
+                        go({ kind: "harnesses" });
                     }
                     else if (choice === "new") {
-                        setScreen({ kind: "signin" });
+                        go({ kind: "signin" });
                     }
                     else {
                         exit();
                     }
                 }, source: wizard.existing?.source ?? "" }));
         case "signin":
-            return (_jsx(SignIn, { config: wizard.config, env: wizard.env, onCancel: () => setScreen({ kind: "welcome" }), onError: (error) => fail(error, { kind: "signin" }), onToken: (token) => setScreen({ kind: "exchange", token }) }));
+            return (_jsx(SignIn, { config: wizard.config, env: wizard.env, onCancel: back, onError: (error) => fail(error, { kind: "signin" }), onToken: (token) => setScreen({ kind: "exchange", token }) }));
         case "exchange":
             return (_jsx(Exchange, { onDone: (key, name) => {
                     wizard.key = key;
                     wizard.keyName = name;
+                    forget();
                     setScreen({ kind: "harnesses" });
                 }, onError: (error) => fail(error, error instanceof SetupError && error.code === "setup_recovery_required" ? null : screen), token: screen.token }));
         case "error":
             return (_jsx(ErrorScreen, { message: screen.message, onSelect: (choice) => (choice === "retry" && screen.retry ? setScreen(screen.retry) : exit()), retry: screen.retry !== null }));
         case "harnesses":
-            return (_jsx(Harnesses, { initial: wizard.harnesses.length > 0 ? wizard.harnesses : [...wizard.installed], installed: wizard.installed, onSubmit: (ids) => {
+            return (_jsx(Harnesses, { canBack: canBack, initial: wizard.harnesses.length > 0 ? wizard.harnesses : [...wizard.installed], installed: wizard.installed, onBack: back, onSubmit: (ids) => {
                     wizard.harnesses = ids;
-                    setScreen({ kind: "scope" });
+                    go({ kind: "scope" });
                 } }));
         case "scope":
-            return (_jsxs(Frame, { hints: NAV, children: [_jsx(Title, { children: "Where should this apply?" }), _jsx(Select, { onSelect: (scope) => {
+            return (_jsxs(Frame, { hints: withBack(NAV, canBack), children: [_jsx(Title, { children: "Where should this apply?" }), _jsx(Select, { initial: wizard.scope, onCancel: back, onSelect: (scope) => {
                             wizard.scope = scope;
                             if (scope === "project") {
                                 wizard.store = null;
                                 wizard.keyFile = projectKeyFile(wizard.env.cwd);
                                 wizard.keyStore = tilde(wizard.keyFile);
-                                setScreen({ kind: "catalog" });
+                                pickModels();
                             }
                             else {
-                                setScreen({ kind: "store" });
+                                go({ kind: "store" });
                             }
                         }, options: [
                             { hint: "recommended", label: "My user account", value: "user" },
                             { hint: tilde(wizard.env.cwd), label: "Only this project", value: "project" },
                         ] })] }));
         case "store":
-            return (_jsxs(Frame, { hints: NAV, children: [_jsx(Title, { children: "Where should I keep the key?" }), _jsx(Muted, { center: true, children: "Your shell profile will read it from there; the key itself never goes into a profile." }), _jsx(Select, { onSelect: (kind) => {
+            return (_jsxs(Frame, { hints: withBack(NAV, canBack), children: [_jsx(Title, { children: "Where should I keep the key?" }), _jsx(Muted, { center: true, children: "Your shell profile will read it from there; the key itself never goes into a profile." }), _jsx(Select, { initial: wizard.store?.kind, onCancel: back, onSelect: (kind) => {
                             const store = wizard.stores.find((candidate) => candidate.kind === kind) ?? null;
                             wizard.store = store;
                             wizard.keyFile = store?.path ?? null;
                             wizard.keyStore = store?.label ?? "";
-                            setScreen({ kind: "catalog" });
+                            pickModels();
                         }, options: wizard.stores.map((store, index) => ({
                             hint: index === 0 ? "recommended" : undefined,
                             label: store.label,
@@ -172,11 +191,14 @@ export function App({ onFinish }) {
                     setScreen({ kind: "model", role: "primary" });
                 }, onError: (error) => fail(error, { kind: "catalog" }), wizard: wizard }));
         case "model":
-            return (_jsx(ModelPicker, { catalog: wizard.catalog, onSelect: (id) => chooseModel(screen.role, id), role: screen.role }));
+            return (_jsx(ModelPicker, { canBack: canBack, catalog: wizard.catalog, initial: screen.role === "primary" ? wizard.primary : wizard.background, onBack: back, onSelect: (id) => chooseModel(screen.role, id), role: screen.role }));
         case "review":
-            return (_jsx(Review, { harnesses: chosen(), input: planInput(), onCancel: () => exit(), onPlans: (plans) => {
+            return (_jsx(Review, { harnesses: chosen(), input: planInput(), canBack: canBack, onBack: back, onCancel: () => exit(), onPlans: (plans) => {
                     wizard.plans = plans;
-                }, onProceed: () => setScreen({ kind: "apply" }), wizard: wizard }));
+                }, onProceed: () => {
+                    forget();
+                    setScreen({ kind: "apply" });
+                }, wizard: wizard }));
         case "apply":
             return (_jsx(Apply, { onDone: () => setScreen(wizard.plans.some(({ plan }) => plan.manual.length > 0) ? { kind: "manual" } : { kind: "test" }), onError: (error) => fail(error, { kind: "review" }), wizard: wizard }));
         case "manual":
@@ -247,8 +269,8 @@ function Info({ onBack, topic }) {
     });
     return (_jsxs(Frame, { hints: "enter back", children: [_jsx(Title, { children: topic === "what" ? "What this does" : "Privacy & data" }), topic === "what" ? (_jsxs(_Fragment, { children: [_jsxs(Para, { children: ["1. Opens ", CONSOLE, "/authorize in your browser. You sign in (or sign up) and approve \"Boundless local setup\"."] }), _jsx(Para, { children: "2. Exchanges that approval for one inference key named setup-\u2026 on your account. The secret is shown once, to this program only." }), _jsxs(Para, { children: ["3. Stores the key in your credential store or a private 0600 file, and points your shell at it via ", KEY_ENV, "."] }), _jsx(Para, { children: "4. Backs up and merges each chosen harness's configuration, preserving unrelated providers and settings." }), _jsx(Para, { children: "5. Sends one small request per model to prove it works. That request uses account credits; nothing is purchased." })] })) : (_jsxs(_Fragment, { children: [_jsxs(Para, { children: ["Nothing from this directory is uploaded. The only network calls are to ", CONSOLE, ", its authorization server, and the inference gateway."] }), _jsx(Para, { children: "The sign-in token is used once for the key exchange and then discarded; no refresh token is kept." }), _jsx(Para, { children: "The API key is written only to the store you pick and to harness files that need it, all with owner-only permissions. It never appears in command arguments, shell history, logs, or this screen." }), _jsxs(Para, { children: ["Manage or revoke the key at ", KEYS_URL, "."] })] }))] }));
 }
-function Existing({ onSelect, source }) {
-    return (_jsxs(Frame, { hints: NAV, children: [_jsx(Title, { children: "A Boundless key is already configured" }), _jsxs(Muted, { center: true, children: ["Found in ", source, ", and the gateway accepts it."] }), _jsx(Box, { justifyContent: "center", children: _jsx(Select, { onSelect: onSelect, options: [
+function Existing({ canBack, onBack, onSelect, source, }) {
+    return (_jsxs(Frame, { hints: withBack(NAV, canBack), children: [_jsx(Title, { children: "A Boundless key is already configured" }), _jsxs(Muted, { center: true, children: ["Found in ", source, ", and the gateway accepts it."] }), _jsx(Box, { justifyContent: "center", children: _jsx(Select, { onCancel: onBack, onSelect: onSelect, options: [
                         { hint: "recommended", label: "Reuse it", value: "reuse" },
                         { label: "Sign in and create a separate key", value: "new" },
                         { label: "Cancel", value: "cancel" },
@@ -294,14 +316,14 @@ function Exchange({ onDone, onError, token }) {
 function ErrorScreen({ message: text, onSelect, retry }) {
     return (_jsxs(Frame, { hints: NAV, children: [_jsx(Title, { children: "Something went wrong" }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: BAD, children: text }) }), _jsx(Box, { justifyContent: "center", children: _jsx(Select, { onSelect: onSelect, options: retry ? [{ label: "Try again", value: "retry" }, { label: "Cancel", value: "cancel" }] : [{ label: "Exit", value: "cancel" }] }) })] }));
 }
-function Harnesses({ initial, installed, onSubmit }) {
+function Harnesses({ canBack, initial, installed, onBack, onSubmit, }) {
     const [empty, setEmpty] = useState(false);
     const options = HARNESSES.map((harness) => ({
         hint: installed.has(harness.id) ? "installed" : "not found",
         label: harness.name,
         value: harness.id,
     }));
-    return (_jsxs(Frame, { hints: "space toggle  enter continue", children: [_jsx(Title, { children: "Which harnesses should I configure?" }), _jsx(Muted, { center: true, children: "Installed ones are preselected. Harnesses that are not installed get their configuration written for when they are." }), _jsx(Box, { justifyContent: "center", children: _jsx(MultiSelect, { initial: initial, onSubmit: (ids) => (ids.length === 0 ? setEmpty(true) : onSubmit(ids)), options: options }) }), empty ? (_jsx(Box, { justifyContent: "center", marginTop: 1, children: _jsx(Text, { color: WARN, children: "Pick at least one." }) })) : null] }));
+    return (_jsxs(Frame, { hints: withBack("space toggle  a all/none  enter continue", canBack), children: [_jsx(Title, { children: "Which harnesses should I configure?" }), _jsx(Muted, { center: true, children: "Installed ones are preselected. Harnesses that are not installed get their configuration written for when they are." }), _jsx(Box, { justifyContent: "center", children: _jsx(MultiSelect, { initial: initial, onCancel: onBack, onSubmit: (ids) => (ids.length === 0 ? setEmpty(true) : onSubmit(ids)), options: options }) }), empty ? (_jsx(Box, { justifyContent: "center", marginTop: 1, children: _jsx(Text, { color: WARN, children: "Pick at least one." }) })) : null] }));
 }
 function Catalog({ onDone, onError, wizard }) {
     useEffect(() => {
@@ -309,10 +331,10 @@ function Catalog({ onDone, onError, wizard }) {
     }, []);
     return (_jsx(Frame, { hints: "", children: _jsx(Spinner, { label: "Reading the model catalog" }) }));
 }
-function ModelPicker({ catalog, onSelect, role, }) {
-    return (_jsxs(Frame, { hints: NAV, children: [_jsx(Title, { children: role === "primary" ? "Which model should be the default?" : "Which model for background work?" }), _jsxs(Muted, { center: true, children: [role === "primary" ? "Every configured harness gets this model." : "Cheap, fast tasks (Claude Code haiku slot, OpenCode small_model, omp tiny).", " Prices are USD per 1M tokens from the live catalog."] }), _jsx(ModelSelect, { models: catalog, onSelect: onSelect, recommended: role === "primary" ? RECOMMENDED_MODEL : RECOMMENDED_BACKGROUND }, role)] }));
+function ModelPicker({ canBack, catalog, initial, onBack, onSelect, role, }) {
+    return (_jsxs(Frame, { hints: withBack(NAV, canBack), children: [_jsx(Title, { children: role === "primary" ? "Which model should be the default?" : "Which model for background work?" }), _jsxs(Muted, { center: true, children: [role === "primary" ? "Every configured harness gets this model." : "Cheap, fast tasks (Claude Code haiku slot, OpenCode small_model, omp tiny).", " Prices are USD per 1M tokens from the live catalog."] }), _jsx(ModelSelect, { initial: initial, models: catalog, onBack: onBack, onSelect: onSelect, recommended: role === "primary" ? RECOMMENDED_MODEL : RECOMMENDED_BACKGROUND }, role)] }));
 }
-function Review({ harnesses, input, onCancel, onPlans, onProceed, wizard, }) {
+function Review({ canBack, harnesses, input, onBack, onCancel, onPlans, onProceed, wizard, }) {
     const [plans, setPlans] = useState(null);
     useEffect(() => {
         Promise.all(harnesses.map(async (harness) => ({ harness, plan: await harness.plan(input) }))).then((planned) => {
@@ -329,11 +351,11 @@ function Review({ harnesses, input, onCancel, onPlans, onProceed, wizard, }) {
         : env.os === "windows"
             ? "user environment variable"
             : `exported as ${KEY_ENV} by your shell profile`;
-    return (_jsxs(Frame, { hints: NAV, children: [_jsx(Title, { children: "Review" }), _jsx(Facts, { facts: [
+    return (_jsxs(Frame, { hints: withBack(NAV, canBack), children: [_jsx(Title, { children: "Review" }), _jsx(Facts, { facts: [
                     { label: "Key", value: `${wizard.keyStore} · ${exposure}` },
                     { label: "Model", value: wizard.primary },
                     ...(wizard.background !== wizard.primary ? [{ label: "Background", value: wizard.background }] : []),
-                ] }), _jsx(Box, { flexDirection: "column", marginBottom: 1, children: plans.map(({ harness, plan }) => (_jsxs(Box, { children: [_jsx(Text, { children: harness.name.padEnd(16) }), _jsx(Text, { color: plan.changes.length > 0 ? BRAND : MUTED, children: plan.changes.length > 0 ? plan.changes.map((change) => tilde(change.path)).join(", ") : "manual steps, shown after apply" })] }, harness.id))) }), _jsx(Box, { flexDirection: "column", marginBottom: 1, children: plans.flatMap(({ plan }) => plan.notes.slice(0, 1)).map((note) => (_jsx(Text, { color: MUTED, children: note }, note))) }), _jsx(Muted, { children: "Existing files are backed up next to themselves before they change. Credentials are never displayed." }), _jsx(Box, { justifyContent: "center", children: _jsx(Select, { onSelect: (choice) => (choice === "apply" ? onProceed() : onCancel()), options: [
+                ] }), _jsx(Box, { flexDirection: "column", marginBottom: 1, children: plans.map(({ harness, plan }) => (_jsxs(Box, { children: [_jsx(Text, { children: harness.name.padEnd(16) }), _jsx(Text, { color: plan.changes.length > 0 ? BRAND : MUTED, children: plan.changes.length > 0 ? plan.changes.map((change) => tilde(change.path)).join(", ") : "manual steps, shown after apply" })] }, harness.id))) }), _jsx(Box, { flexDirection: "column", marginBottom: 1, children: plans.flatMap(({ plan }) => plan.notes.slice(0, 1)).map((note) => (_jsx(Text, { color: MUTED, children: note }, note))) }), _jsx(Muted, { children: "Existing files are backed up next to themselves before they change. Credentials are never displayed." }), _jsx(Box, { justifyContent: "center", children: _jsx(Select, { onCancel: onBack, onSelect: (choice) => (choice === "apply" ? onProceed() : onCancel()), options: [
                         { label: "Apply", value: "apply" },
                         { label: "Cancel", value: "cancel" },
                     ] }) })] }));

package/dist/lib/catalog.js

@@ -27,6 +27,7 @@ export async function keyWorks(gatewayUrl, key) {
     }
 }
 /** Exact USD, never rounded away: trailing zeros trimmed, up to twelve decimals. */
+export const usdPerMillion = (amount) => `$${amount.toFixed(2)}`;
 export function usd(amount) {
     return `$${amount.toFixed(12).replace(/0+$/, "").replace(/\.$/, "")}`;
 }

package/dist/ui/menu.js

@@ -2,8 +2,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text, useInput } from "ink";
 import { useState } from "react";
 import { BRAND, MUTED } from "./theme.js";
-export function Select({ onCancel, onSelect, options, }) {
-    const [index, setIndex] = useState(0);
+export function Select({ initial, onCancel, onSelect, options, }) {
+    const [index, setIndex] = useState(Math.max(options.findIndex((option) => option.value === initial), 0));
     const move = (delta) => {
         let next = index;
         for (let step = 0; step < options.length; step += 1) {
@@ -46,6 +46,9 @@ export function MultiSelect({ initial, onCancel, onSubmit, options, }) {
         else if (key.downArrow || input === "j") {
             setIndex((index + 1) % options.length);
         }
+        else if (input === "a") {
+            setChosen(chosen.size === options.length ? new Set() : new Set(options.map((option) => option.value)));
+        }
         else if (input === " ") {
             const value = options[index]?.value;
             if (value !== undefined) {

package/dist/ui/table.js

@@ -1,21 +1,24 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text, useInput } from "ink";
 import { useState } from "react";
-import { usd } from "../lib/catalog.js";
+import { usdPerMillion } from "../lib/catalog.js";
 import { BRAND, MUTED } from "./theme.js";
 const HEADER = ["ID", "Input /1M", "Output /1M", "Context", ""];
 const cells = (model, recommended) => [
     model.id,
-    usd(model.inputPerMillionTokens),
-    usd(model.outputPerMillionTokens),
+    usdPerMillion(model.inputPerMillionTokens),
+    usdPerMillion(model.outputPerMillionTokens),
     model.contextTokens.toLocaleString("en-US"),
     model.id === recommended ? "recommended" : "",
 ];
-export function ModelSelect({ models, onSelect, recommended, }) {
-    const start = Math.max(models.findIndex((model) => model.id === recommended), 0);
+export function ModelSelect({ initial, models, onBack, onSelect, recommended, }) {
+    const start = Math.max(models.findIndex((model) => model.id === initial), models.findIndex((model) => model.id === recommended), 0);
     const [index, setIndex] = useState(start);
     useInput((input, key) => {
-        if (key.upArrow || input === "k") {
+        if (key.escape) {
+            onBack();
+        }
+        else if (key.upArrow || input === "k") {
             setIndex((index + models.length - 1) % models.length);
         }
         else if (key.downArrow || input === "j") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boundless.network/setup",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Set up Boundless as the inference provider for your coding harness. Run: npx -y @boundless.network/setup@latest",
   "license": "MIT",
   "type": "module",