@coldtea/abide 0.0.1 → 0.0.2

package/dist/bin.js

@@ -20,7 +20,7 @@ const main = async () => {
     const [command, ...rest] = process.argv.slice(2);
     switch (command) {
         case "login":
-            return runLogin(rest);
+            return runLogin();
         case "init":
             return runInit(rest);
         case "compile":

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;IAC1D,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,KAAK,IAAqB,EAAE;IACvC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,WAAW;YACd,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,OAAO;YACV,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7B,OAAO,CAAC,CAAC;QACX;YACE,MAAM,SAAS,CAAC,IAAI,KAAK,CAAC,oBAAoB,OAAO,oBAAoB,CAAC,CAAC,CAAC;YAC5E,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC,CAAC;AAEF,IAAI,CAAC;IACH,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC;AAClC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;IAC1D,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,KAAK,IAAqB,EAAE;IACvC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,QAAQ,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,WAAW;YACd,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,OAAO;YACV,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7B,OAAO,CAAC,CAAC;QACX;YACE,MAAM,SAAS,CAAC,IAAI,KAAK,CAAC,oBAAoB,OAAO,oBAAoB,CAAC,CAAC,CAAC;YAC5E,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC,CAAC;AAEF,IAAI,CAAC;IACH,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC;AAClC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands/login.d.ts

@@ -1,3 +1,3 @@
 /** Never a flag: a flag lands in shell history and CI logs. */
-export declare const runLogin: (argv: string[]) => Promise<number>;
+export declare const runLogin: () => Promise<number>;
 //# sourceMappingURL=login.d.ts.map

package/dist/commands/login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AA4CA,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,SAAgB,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CAe7D,CAAC"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AA6BA,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,QAAa,OAAO,CAAC,MAAM,CAY/C,CAAC"}

package/dist/commands/login.js

@@ -1,58 +1,38 @@
-import { parseArgs } from "node:util";
 import { AbideError } from "@coldtea/abide-schema";
-import { GATEWAY_KEY_ENV, TYPESAFE_KEY_ENV } from "../lib/constants.js";
+import { readSecret } from "../lib/secret.js";
 import { saveUserKey } from "../lib/credentials.js";
 import { Callout } from "../ui/components/Callout.js";
-import { showStatic } from "../ui/render.js";
-/** Reads one line without echoing it, so the key never lands in a terminal scrollback. */
-const readSecret = (prompt) => new Promise((resolve) => {
-    const stdin = process.stdin;
-    process.stderr.write(prompt);
-    const wasRaw = stdin.isTTY ? stdin.isRaw : false;
-    if (stdin.isTTY)
-        stdin.setRawMode(true);
-    stdin.setEncoding("utf8");
-    stdin.resume();
-    let value = "";
-    const done = () => {
-        stdin.off("data", onData);
-        if (stdin.isTTY)
-            stdin.setRawMode(wasRaw);
-        stdin.pause();
-        process.stderr.write("\n");
-        resolve(value.trim());
-    };
-    const onData = (chunk) => {
-        for (const ch of chunk) {
-            if (ch === "\u0003") {
-                done();
-                process.exit(1);
-            }
-            if (ch === "\n" || ch === "\r" || ch === "\u0004") {
-                done();
-                return;
-            }
-            if (ch === "\u007f" || ch === "\b") {
-                value = value.slice(0, -1);
-                continue;
-            }
-            value += ch;
-        }
-    };
-    stdin.on("data", onData);
-});
+import { showPicker, showStatic } from "../ui/render.js";
+import { GATEWAY_KEY_ENV, TYPESAFE_KEY_ENV } from "../lib/constants.js";
+const TYPESAFE = {
+    value: { name: TYPESAFE_KEY_ENV, prompt: "TypeSafe API key: " },
+    label: "TypeSafe API key",
+    hint: "from typesafe.ai",
+};
+const GATEWAY = {
+    value: { name: GATEWAY_KEY_ENV, prompt: "Vercel AI Gateway key: " },
+    label: "Vercel AI Gateway key",
+    hint: "a key you already have",
+};
+const chooseProvider = async () => {
+    if (!process.stdin.isTTY)
+        return TYPESAFE.value;
+    const chosen = await showPicker("Which key do you have?", [TYPESAFE, GATEWAY]);
+    if (chosen === undefined)
+        throw new AbideError("NO_API_KEY", "no key was chosen");
+    return chosen.value;
+};
 /** Never a flag: a flag lands in shell history and CI logs. */
-export const runLogin = async (argv) => {
-    const { values } = parseArgs({
-        args: argv,
-        options: { gateway: { type: "boolean", default: false } },
-    });
-    const name = values.gateway ? GATEWAY_KEY_ENV : TYPESAFE_KEY_ENV;
-    const key = await readSecret(values.gateway ? "Vercel AI Gateway key: " : "TypeSafe API key (from typesafe.ai): ");
+export const runLogin = async () => {
+    const provider = await chooseProvider();
+    const key = await readSecret(provider.prompt);
     if (key === "")
         throw new AbideError("NO_API_KEY", "nothing was entered");
-    const file = saveUserKey(name, key);
-    await showStatic(Callout({ tone: "ok", title: `${name} saved to ${file} (owner-only). Run abide init next.` }));
+    const file = saveUserKey(provider.name, key);
+    await showStatic(Callout({
+        tone: "ok",
+        title: `${provider.name} saved to ${file} (owner-only). Run abide init next.`,
+    }));
     return 0;
 };
 //# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIxE,MAAM,QAAQ,GAAyB;IACrC,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,oBAAoB,EAAE;IAC/D,KAAK,EAAE,kBAAkB;IACzB,IAAI,EAAE,kBAAkB;CACzB,CAAC;AAEF,MAAM,OAAO,GAAyB;IACpC,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,yBAAyB,EAAE;IACnE,KAAK,EAAE,uBAAuB;IAC9B,IAAI,EAAE,wBAAwB;CAC/B,CAAC;AAEF,MAAM,cAAc,GAAG,KAAK,IAAuB,EAAE;IACnD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,wBAAwB,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,UAAU,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;IAClF,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,IAAqB,EAAE;IAClD,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,UAAU,CACd,OAAO,CAAC;QACN,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,aAAa,IAAI,qCAAqC;KAC9E,CAAC,CACH,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC,CAAC"}

package/dist/lib/secret.d.ts

@@ -0,0 +1,23 @@
+/** The slice of a stdin the reader needs, so a test can hand in a stream of its own. */
+export type SecretInput = {
+    isTTY: boolean;
+    isRaw: boolean;
+    setRawMode(mode: boolean): unknown;
+    setEncoding(encoding: BufferEncoding): unknown;
+    /** A TTY or pipe has this; a redirected file does not. */
+    ref?(): unknown;
+    resume(): unknown;
+    pause(): unknown;
+    on(event: "data", listener: (chunk: string) => void): unknown;
+    off(event: "data", listener: (chunk: string) => void): unknown;
+};
+type SecretIo = {
+    input: SecretInput;
+    output: {
+        write(text: string): unknown;
+    };
+};
+/** Reads one line without echoing it, so the key never lands in a terminal scrollback. */
+export declare const readSecret: (prompt: string, io?: SecretIo) => Promise<string>;
+export {};
+//# sourceMappingURL=secret.d.ts.map

package/dist/lib/secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.d.ts","sourceRoot":"","sources":["../../src/lib/secret.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACnC,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC;IAC/C,0DAA0D;IAC1D,GAAG,CAAC,IAAI,OAAO,CAAC;IAChB,MAAM,IAAI,OAAO,CAAC;IAClB,KAAK,IAAI,OAAO,CAAC;IACjB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;IAC9D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;CAChE,CAAC;AAEF,KAAK,QAAQ,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAAE,CAAC;AAIjF,0FAA0F;AAC1F,eAAO,MAAM,UAAU,WAAY,MAAM,OAAM,QAAQ,KAAiB,OAAO,CAAC,MAAM,CAsClF,CAAC"}

package/dist/lib/secret.js

@@ -0,0 +1,41 @@
+const processIo = () => ({ input: process.stdin, output: process.stderr });
+/** Reads one line without echoing it, so the key never lands in a terminal scrollback. */
+export const readSecret = (prompt, io = processIo()) => new Promise((resolve) => {
+    const { input, output } = io;
+    output.write(prompt);
+    const wasRaw = input.isTTY ? input.isRaw : false;
+    if (input.isTTY)
+        input.setRawMode(true);
+    input.setEncoding("utf8");
+    if (input.isTTY)
+        input.ref?.();
+    input.resume();
+    let value = "";
+    const done = () => {
+        input.off("data", onData);
+        if (input.isTTY)
+            input.setRawMode(wasRaw);
+        input.pause();
+        output.write("\n");
+        resolve(value.trim());
+    };
+    const onData = (chunk) => {
+        for (const ch of chunk) {
+            if (ch === "\u0003") {
+                done();
+                process.exit(1);
+            }
+            if (ch === "\n" || ch === "\r" || ch === "\u0004") {
+                done();
+                return;
+            }
+            if (ch === "\u007f" || ch === "\b") {
+                value = value.slice(0, -1);
+                continue;
+            }
+            value += ch;
+        }
+    };
+    input.on("data", onData);
+});
+//# sourceMappingURL=secret.js.map

package/dist/lib/secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.js","sourceRoot":"","sources":["../../src/lib/secret.ts"],"names":[],"mappings":"AAgBA,MAAM,SAAS,GAAG,GAAa,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAErF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,EAAE,GAAa,SAAS,EAAE,EAAmB,EAAE,CACxF,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACjD,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1B,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;IAC/B,KAAK,CAAC,MAAM,EAAE,CAAC;IAEf,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,KAAa,EAAQ,EAAE;QACrC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;gBACpB,IAAI,EAAE,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAClD,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YACD,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACnC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC"}

package/dist/ui/components/Picker.d.ts

@@ -0,0 +1,13 @@
+export type PickerItem<T> = {
+    value: T;
+    label: string;
+    hint?: string;
+};
+type PickerProps<T> = {
+    title: string;
+    items: readonly PickerItem<T>[];
+    onDone: (chosen: PickerItem<T> | undefined) => void;
+};
+export declare function Picker<T>({ title, items, onDone }: PickerProps<T>): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Picker.d.ts.map

package/dist/ui/components/Picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Picker.d.ts","sourceRoot":"","sources":["../../../src/ui/components/Picker.tsx"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,KAAK,WAAW,CAAC,CAAC,IAAI;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAChC,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;CACrD,CAAC;AAOF,wBAAgB,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,+BAmEjE"}

package/dist/ui/components/Picker.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import { glyph, palette } from "../theme.js";
+export function Picker({ title, items, onDone }) {
+    const { exit } = useApp();
+    const [state, setState] = useState({ kind: "choosing", index: 0 });
+    // Keys can arrive faster than a re-render, so the handler reads the cursor from here, not from its closure.
+    const cursor = useRef(0);
+    const move = (index) => {
+        cursor.current = index;
+        setState({ kind: "choosing", index });
+    };
+    useInput((input, key) => {
+        if (key.upArrow || input === "k") {
+            move(Math.max(0, cursor.current - 1));
+            return;
+        }
+        if (key.downArrow || input === "j") {
+            move(Math.min(items.length - 1, cursor.current + 1));
+            return;
+        }
+        if (key.return) {
+            setState({ kind: "chosen", index: cursor.current });
+            return;
+        }
+        if (key.escape)
+            setState({ kind: "left", index: cursor.current });
+    }, { isActive: state.kind === "choosing" });
+    // Leave only after the answer has been drawn, not in the same tick it was picked.
+    useEffect(() => {
+        if (state.kind === "choosing")
+            return;
+        onDone(state.kind === "chosen" ? items[state.index] : undefined);
+        exit();
+        // The pick is final; nothing about it changes afterwards.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [state.kind]);
+    const current = items[state.index];
+    if (state.kind === "chosen") {
+        return (_jsxs(Text, { children: [_jsxs(Text, { color: palette.mist, children: [title, " "] }), _jsx(Text, { color: palette.teal, children: current?.label })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { color: palette.cloud, bold: true, children: title }), items.map((item, index) => {
+                const active = index === state.index;
+                return (_jsxs(Box, { children: [_jsxs(Text, { color: active ? palette.teal : palette.ash, children: [active ? glyph.arrow : " ", " "] }), _jsx(Text, { color: active ? palette.teal : palette.cloud, bold: active, children: item.label }), item.hint ? _jsxs(Text, { color: palette.mist, children: [" ", item.hint] }) : null] }, item.label));
+            }), _jsxs(Text, { color: palette.ash, children: ["\u2191\u2193 move ", glyph.dotSep, " enter pick ", glyph.dotSep, " esc quit"] })] }));
+}
+//# sourceMappingURL=Picker.js.map

package/dist/ui/components/Picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Picker.js","sourceRoot":"","sources":["../../../src/ui/components/Picker.tsx"],"names":[],"mappings":"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"}

package/dist/ui/render.d.ts

@@ -1,5 +1,6 @@
 import type { ReactElement, ReactNode } from "react";
 import { type Progress } from "./components/Live.js";
+import { type PickerItem } from "./components/Picker.js";
 /**
  * Draws a finished view once and leaves. Ink prints the final frame on a pipe
  * too, so `abide report | less` still reads well. Nothing in the hooks goes
@@ -15,6 +16,8 @@ type LiveJob<T> = {
 };
 /** Runs a job under a spinner, draws its result, and resolves to the exit code. */
 export declare const showLive: <T>(job: LiveJob<T>) => Promise<number>;
+/** Asks for one choice on a TTY and resolves to it, or to nothing when the person backs out. */
+export declare const showPicker: <T>(title: string, items: readonly PickerItem<T>[]) => Promise<PickerItem<T> | undefined>;
 export declare const showError: (error: unknown) => Promise<void>;
 export {};
 //# sourceMappingURL=render.d.ts.map

package/dist/ui/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/ui/render.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;;GAIG;AACH,eAAO,MAAM,UAAU,YAAmB,YAAY,KAAG,OAAO,CAAC,IAAI,CAIpE,CAAC;AAEF,KAAK,OAAO,CAAC,CAAC,IAAI;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAC;IAC/B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;CAC9B,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,QAAQ,GAAU,CAAC,OAAQ,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,MAAM,CAqBlE,CAAC;AAEF,eAAO,MAAM,SAAS,UAAiB,OAAO,KAAG,OAAO,CAAC,IAAI,CAE5D,CAAC"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/ui/render.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;;GAIG;AACH,eAAO,MAAM,UAAU,YAAmB,YAAY,KAAG,OAAO,CAAC,IAAI,CAIpE,CAAC;AAEF,KAAK,OAAO,CAAC,CAAC,IAAI;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAC;IAC/B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;CAC9B,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,QAAQ,GAAU,CAAC,OAAQ,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,MAAM,CAqBlE,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,UAAU,GAAU,CAAC,SACzB,MAAM,SACN,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,KAC9B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAcnC,CAAC;AAEF,eAAO,MAAM,SAAS,UAAiB,OAAO,KAAG,OAAO,CAAC,IAAI,CAE5D,CAAC"}

package/dist/ui/render.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { render } from "ink";
 import { Live } from "./components/Live.js";
+import { Picker } from "./components/Picker.js";
 import { ErrorView } from "./views/ErrorView.js";
 /**
  * Draws a finished view once and leaves. Ink prints the final frame on a pipe
@@ -26,6 +27,15 @@ export const showLive = async (job) => {
         return job.code(outcome.result.value);
     return outcome.code;
 };
+/** Asks for one choice on a TTY and resolves to it, or to nothing when the person backs out. */
+export const showPicker = async (title, items) => {
+    let chosen;
+    const instance = render(_jsx(Picker, { title: title, items: items, onDone: (item) => {
+            chosen = item;
+        } }), { patchConsole: false, exitOnCtrlC: true });
+    await instance.waitUntilExit();
+    return chosen;
+};
 export const showError = async (error) => {
     await showStatic(_jsx(ErrorView, { error: error }));
 };

package/dist/ui/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/ui/render.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,IAAI,EAAiB,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,OAAqB,EAAiB,EAAE;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnB,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;AACjC,CAAC,CAAC;AAUF,mFAAmF;AACnF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAM,GAAe,EAAmB,EAAE;IACrE,MAAM,OAAO,GAA4C,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAC,IAAI,IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACf,OAAO,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACnC,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,EACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAC,SAAS,IAAC,KAAK,EAAE,KAAK,GAAI,EAC9C,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YACnB,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC1B,CAAC,EACD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GACtC,EACF,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAC3C,CAAC;IACF,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,KAAc,EAAiB,EAAE;IAC/D,MAAM,UAAU,CAAC,KAAC,SAAS,IAAC,KAAK,EAAE,KAAK,GAAI,CAAC,CAAC;AAChD,CAAC,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/ui/render.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,IAAI,EAAiB,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAmB,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,OAAqB,EAAiB,EAAE;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnB,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;AACjC,CAAC,CAAC;AAUF,mFAAmF;AACnF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAM,GAAe,EAAmB,EAAE;IACrE,MAAM,OAAO,GAA4C,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAC,IAAI,IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACf,OAAO,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACnC,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,EACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAC,SAAS,IAAC,KAAK,EAAE,KAAK,GAAI,EAC9C,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YACnB,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC1B,CAAC,EACD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GACtC,EACF,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAC3C,CAAC;IACF,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC,CAAC;AAEF,gGAAgG;AAChG,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,KAAa,EACb,KAA+B,EACK,EAAE;IACtC,IAAI,MAAiC,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAC,MAAM,IACL,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC,GACD,EACF,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAC3C,CAAC;IACF,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,KAAc,EAAiB,EAAE;IAC/D,MAAM,UAAU,CAAC,KAAC,SAAS,IAAC,KAAK,EAAE,KAAK,GAAI,CAAC,CAAC;AAChD,CAAC,CAAC"}

package/dist/ui/views/HelpView.js

@@ -3,7 +3,7 @@ import { Box, Text } from "ink";
 import { Header } from "../components/Header.js";
 import { palette } from "../theme.js";
 const COMMANDS = [
-    ["login [--gateway]", "store your TypeSafe key in ~/.abide/.env, owner-only"],
+    ["login", "store your TypeSafe or Vercel AI Gateway key in ~/.abide/.env, owner-only"],
     ["init [agent] [--project]", "hook into claude, codex, opencode, or every one found here"],
     ["compile", "compile the rubric now, in a headless Claude Code turn"],
     ["tune [--global]", "rewrite rules that never fire, with their statistics attached"],

package/dist/ui/views/HelpView.js.map

@@ -1 +1 @@
-{"version":3,"file":"HelpView.js","sourceRoot":"","sources":["../../../src/ui/views/HelpView.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,QAAQ,GAAuB;IACnC,CAAC,mBAAmB,EAAE,sDAAsD,CAAC;IAC7E,CAAC,0BAA0B,EAAE,4DAA4D,CAAC;IAC1F,CAAC,SAAS,EAAE,wDAAwD,CAAC;IACrE,CAAC,iBAAiB,EAAE,+DAA+D,CAAC;IACpF,CAAC,4BAA4B,EAAE,oDAAoD,CAAC;IACpF,CAAC,sBAAsB,EAAE,oDAAoD,CAAC;IAC9E,CAAC,uBAAuB,EAAE,mDAAmD,CAAC;IAC9E,CAAC,uBAAuB,EAAE,sEAAsE,CAAC;IACjG,CAAC,QAAQ,EAAE,gDAAgD,CAAC;IAC5D;QACE,gBAAgB;QAChB,2FAA2F;KAC5F;IACD,CAAC,kBAAkB,EAAE,6CAA6C,CAAC;IACnE,CAAC,+BAA+B,EAAE,yCAAyC,CAAC;CAC7E,CAAC;AAEF,MAAM,UAAU,QAAQ;IACtB,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,MAAM,IACL,OAAO,EAAC,MAAM,EACd,IAAI,EAAC,sEAAsE,GAC3E,EACD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAC9B,MAAC,GAAG,eACF,KAAC,GAAG,IAAC,KAAK,EAAE,EAAE,YACZ,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,kBAC7B,IAAI,GACA,GACH,EACN,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,IAAI,YAAG,IAAI,GAAQ,KANhC,IAAI,CAOR,CACP,CAAC,EACF,MAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aACvC,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,GAAG,oGAEjB,EACP,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,GAAG,gIAGjB,IACH,IACF,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"HelpView.js","sourceRoot":"","sources":["../../../src/ui/views/HelpView.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,QAAQ,GAAuB;IACnC,CAAC,OAAO,EAAE,2EAA2E,CAAC;IACtF,CAAC,0BAA0B,EAAE,4DAA4D,CAAC;IAC1F,CAAC,SAAS,EAAE,wDAAwD,CAAC;IACrE,CAAC,iBAAiB,EAAE,+DAA+D,CAAC;IACpF,CAAC,4BAA4B,EAAE,oDAAoD,CAAC;IACpF,CAAC,sBAAsB,EAAE,oDAAoD,CAAC;IAC9E,CAAC,uBAAuB,EAAE,mDAAmD,CAAC;IAC9E,CAAC,uBAAuB,EAAE,sEAAsE,CAAC;IACjG,CAAC,QAAQ,EAAE,gDAAgD,CAAC;IAC5D;QACE,gBAAgB;QAChB,2FAA2F;KAC5F;IACD,CAAC,kBAAkB,EAAE,6CAA6C,CAAC;IACnE,CAAC,+BAA+B,EAAE,yCAAyC,CAAC;CAC7E,CAAC;AAEF,MAAM,UAAU,QAAQ;IACtB,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,MAAM,IACL,OAAO,EAAC,MAAM,EACd,IAAI,EAAC,sEAAsE,GAC3E,EACD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAC9B,MAAC,GAAG,eACF,KAAC,GAAG,IAAC,KAAK,EAAE,EAAE,YACZ,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,kBAC7B,IAAI,GACA,GACH,EACN,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,IAAI,YAAG,IAAI,GAAQ,KANhC,IAAI,CAOR,CACP,CAAC,EACF,MAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ,aACvC,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,GAAG,oGAEjB,EACP,KAAC,IAAI,IAAC,KAAK,EAAE,OAAO,CAAC,GAAG,gIAGjB,IACH,IACF,CACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldtea/abide",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Enforce your own AGENTS.md rules on every edit a coding agent makes.",
   "license": "MIT",
   "author": "Coldtea AI",

package/src/bin.ts

@@ -21,7 +21,7 @@ const main = async (): Promise<number> => {
   const [command, ...rest] = process.argv.slice(2);
   switch (command) {
     case "login":
-      return runLogin(rest);
+      return runLogin();
     case "init":
       return runInit(rest);
     case "compile":

package/src/commands/login.ts

@@ -1,61 +1,43 @@
-import { parseArgs } from "node:util";
 import { AbideError } from "@coldtea/abide-schema";
-import { GATEWAY_KEY_ENV, TYPESAFE_KEY_ENV } from "../lib/constants.js";
+import { readSecret } from "../lib/secret.js";
 import { saveUserKey } from "../lib/credentials.js";
 import { Callout } from "../ui/components/Callout.js";
-import { showStatic } from "../ui/render.js";
+import { showPicker, showStatic } from "../ui/render.js";
+import type { PickerItem } from "../ui/components/Picker.js";
+import { GATEWAY_KEY_ENV, TYPESAFE_KEY_ENV } from "../lib/constants.js";
 
-/** Reads one line without echoing it, so the key never lands in a terminal scrollback. */
-const readSecret = (prompt: string): Promise<string> =>
-  new Promise((resolve) => {
-    const stdin = process.stdin;
-    process.stderr.write(prompt);
-    const wasRaw = stdin.isTTY ? stdin.isRaw : false;
-    if (stdin.isTTY) stdin.setRawMode(true);
-    stdin.setEncoding("utf8");
-    stdin.resume();
-    let value = "";
-    const done = (): void => {
-      stdin.off("data", onData);
-      if (stdin.isTTY) stdin.setRawMode(wasRaw);
-      stdin.pause();
-      process.stderr.write("\n");
-      resolve(value.trim());
-    };
-    const onData = (chunk: string): void => {
-      for (const ch of chunk) {
-        if (ch === "\u0003") {
-          done();
-          process.exit(1);
-        }
-        if (ch === "\n" || ch === "\r" || ch === "\u0004") {
-          done();
-          return;
-        }
-        if (ch === "\u007f" || ch === "\b") {
-          value = value.slice(0, -1);
-          continue;
-        }
-        value += ch;
-      }
-    };
-    stdin.on("data", onData);
-  });
+type Provider = { name: string; prompt: string };
+
+const TYPESAFE: PickerItem<Provider> = {
+  value: { name: TYPESAFE_KEY_ENV, prompt: "TypeSafe API key: " },
+  label: "TypeSafe API key",
+  hint: "from typesafe.ai",
+};
+
+const GATEWAY: PickerItem<Provider> = {
+  value: { name: GATEWAY_KEY_ENV, prompt: "Vercel AI Gateway key: " },
+  label: "Vercel AI Gateway key",
+  hint: "a key you already have",
+};
+
+const chooseProvider = async (): Promise<Provider> => {
+  if (!process.stdin.isTTY) return TYPESAFE.value;
+  const chosen = await showPicker("Which key do you have?", [TYPESAFE, GATEWAY]);
+  if (chosen === undefined) throw new AbideError("NO_API_KEY", "no key was chosen");
+  return chosen.value;
+};
 
 /** Never a flag: a flag lands in shell history and CI logs. */
-export const runLogin = async (argv: string[]): Promise<number> => {
-  const { values } = parseArgs({
-    args: argv,
-    options: { gateway: { type: "boolean", default: false } },
-  });
-  const name = values.gateway ? GATEWAY_KEY_ENV : TYPESAFE_KEY_ENV;
-  const key = await readSecret(
-    values.gateway ? "Vercel AI Gateway key: " : "TypeSafe API key (from typesafe.ai): ",
-  );
+export const runLogin = async (): Promise<number> => {
+  const provider = await chooseProvider();
+  const key = await readSecret(provider.prompt);
   if (key === "") throw new AbideError("NO_API_KEY", "nothing was entered");
-  const file = saveUserKey(name, key);
+  const file = saveUserKey(provider.name, key);
   await showStatic(
-    Callout({ tone: "ok", title: `${name} saved to ${file} (owner-only). Run abide init next.` }),
+    Callout({
+      tone: "ok",
+      title: `${provider.name} saved to ${file} (owner-only). Run abide init next.`,
+    }),
   );
   return 0;
 };

package/src/lib/secret.ts

@@ -0,0 +1,58 @@
+/** The slice of a stdin the reader needs, so a test can hand in a stream of its own. */
+export type SecretInput = {
+  isTTY: boolean;
+  isRaw: boolean;
+  setRawMode(mode: boolean): unknown;
+  setEncoding(encoding: BufferEncoding): unknown;
+  /** A TTY or pipe has this; a redirected file does not. */
+  ref?(): unknown;
+  resume(): unknown;
+  pause(): unknown;
+  on(event: "data", listener: (chunk: string) => void): unknown;
+  off(event: "data", listener: (chunk: string) => void): unknown;
+};
+
+type SecretIo = { input: SecretInput; output: { write(text: string): unknown } };
+
+const processIo = (): SecretIo => ({ input: process.stdin, output: process.stderr });
+
+/** Reads one line without echoing it, so the key never lands in a terminal scrollback. */
+export const readSecret = (prompt: string, io: SecretIo = processIo()): Promise<string> =>
+  new Promise((resolve) => {
+    const { input, output } = io;
+    output.write(prompt);
+    const wasRaw = input.isTTY ? input.isRaw : false;
+    if (input.isTTY) input.setRawMode(true);
+    input.setEncoding("utf8");
+
+    if (input.isTTY) input.ref?.();
+    input.resume();
+
+    let value = "";
+    const done = (): void => {
+      input.off("data", onData);
+      if (input.isTTY) input.setRawMode(wasRaw);
+      input.pause();
+      output.write("\n");
+      resolve(value.trim());
+    };
+
+    const onData = (chunk: string): void => {
+      for (const ch of chunk) {
+        if (ch === "\u0003") {
+          done();
+          process.exit(1);
+        }
+        if (ch === "\n" || ch === "\r" || ch === "\u0004") {
+          done();
+          return;
+        }
+        if (ch === "\u007f" || ch === "\b") {
+          value = value.slice(0, -1);
+          continue;
+        }
+        value += ch;
+      }
+    };
+    input.on("data", onData);
+  });

package/src/ui/components/Picker.tsx

@@ -0,0 +1,85 @@
+import { useEffect, useRef, useState } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import { glyph, palette } from "../theme.js";
+
+export type PickerItem<T> = { value: T; label: string; hint?: string };
+
+type PickerProps<T> = {
+  title: string;
+  items: readonly PickerItem<T>[];
+  onDone: (chosen: PickerItem<T> | undefined) => void;
+};
+
+type State =
+  | { kind: "choosing"; index: number }
+  | { kind: "chosen"; index: number }
+  | { kind: "left"; index: number };
+
+export function Picker<T>({ title, items, onDone }: PickerProps<T>) {
+  const { exit } = useApp();
+  const [state, setState] = useState<State>({ kind: "choosing", index: 0 });
+  // Keys can arrive faster than a re-render, so the handler reads the cursor from here, not from its closure.
+  const cursor = useRef(0);
+  const move = (index: number): void => {
+    cursor.current = index;
+    setState({ kind: "choosing", index });
+  };
+
+  useInput(
+    (input, key) => {
+      if (key.upArrow || input === "k") {
+        move(Math.max(0, cursor.current - 1));
+        return;
+      }
+      if (key.downArrow || input === "j") {
+        move(Math.min(items.length - 1, cursor.current + 1));
+        return;
+      }
+      if (key.return) {
+        setState({ kind: "chosen", index: cursor.current });
+        return;
+      }
+      if (key.escape) setState({ kind: "left", index: cursor.current });
+    },
+    { isActive: state.kind === "choosing" },
+  );
+  // Leave only after the answer has been drawn, not in the same tick it was picked.
+  useEffect(() => {
+    if (state.kind === "choosing") return;
+    onDone(state.kind === "chosen" ? items[state.index] : undefined);
+    exit();
+    // The pick is final; nothing about it changes afterwards.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [state.kind]);
+  const current = items[state.index];
+  if (state.kind === "chosen") {
+    return (
+      <Text>
+        <Text color={palette.mist}>{title} </Text>
+        <Text color={palette.teal}>{current?.label}</Text>
+      </Text>
+    );
+  }
+  return (
+    <Box flexDirection="column" marginBottom={1}>
+      <Text color={palette.cloud} bold>
+        {title}
+      </Text>
+      {items.map((item, index) => {
+        const active = index === state.index;
+        return (
+          <Box key={item.label}>
+            <Text color={active ? palette.teal : palette.ash}>{active ? glyph.arrow : " "} </Text>
+            <Text color={active ? palette.teal : palette.cloud} bold={active}>
+              {item.label}
+            </Text>
+            {item.hint ? <Text color={palette.mist}> {item.hint}</Text> : null}
+          </Box>
+        );
+      })}
+      <Text color={palette.ash}>
+        ↑↓ move {glyph.dotSep} enter pick {glyph.dotSep} esc quit
+      </Text>
+    </Box>
+  );
+}

package/src/ui/render.tsx

@@ -1,6 +1,7 @@
 import { render } from "ink";
 import type { ReactElement, ReactNode } from "react";
 import { Live, type Progress } from "./components/Live.js";
+import { Picker, type PickerItem } from "./components/Picker.js";
 import { ErrorView } from "./views/ErrorView.js";
 
 /**
@@ -46,6 +47,26 @@ export const showLive = async <T,>(job: LiveJob<T>): Promise<number> => {
   return outcome.code;
 };
 
+/** Asks for one choice on a TTY and resolves to it, or to nothing when the person backs out. */
+export const showPicker = async <T,>(
+  title: string,
+  items: readonly PickerItem<T>[],
+): Promise<PickerItem<T> | undefined> => {
+  let chosen: PickerItem<T> | undefined;
+  const instance = render(
+    <Picker<T>
+      title={title}
+      items={items}
+      onDone={(item) => {
+        chosen = item;
+      }}
+    />,
+    { patchConsole: false, exitOnCtrlC: true },
+  );
+  await instance.waitUntilExit();
+  return chosen;
+};
+
 export const showError = async (error: unknown): Promise<void> => {
   await showStatic(<ErrorView error={error} />);
 };

package/src/ui/views/HelpView.tsx

@@ -3,7 +3,7 @@ import { Header } from "../components/Header.js";
 import { palette } from "../theme.js";
 
 const COMMANDS: [string, string][] = [
-  ["login [--gateway]", "store your TypeSafe key in ~/.abide/.env, owner-only"],
+  ["login", "store your TypeSafe or Vercel AI Gateway key in ~/.abide/.env, owner-only"],
   ["init [agent] [--project]", "hook into claude, codex, opencode, or every one found here"],
   ["compile", "compile the rubric now, in a headless Claude Code turn"],
   ["tune [--global]", "rewrite rules that never fire, with their statistics attached"],