drexler 0.1.1 → 0.2.0

package/src/config.ts

@@ -11,8 +11,8 @@ import {
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import * as readline from "node:readline/promises";
-import type { CliFlags, Config } from "./types.ts";
-import { MODEL_FALLBACK, MODEL_PRIMARY } from "./types.ts";
+import type { CliFlags, Config, ThemeName } from "./types.ts";
+import { MODEL_FALLBACK, MODEL_PRIMARY, THEME_NAMES } from "./types.ts";
 
 const DEFAULT_MAX_HISTORY = 50;
 
@@ -47,6 +47,10 @@ export function parseFlags(argv: string[]): CliFlags {
       flags.persona = argv[++i];
     } else if (a === "--theme" && valueAfter(i) !== undefined) {
       flags.theme = argv[++i];
+    } else if (a === "--no-intro") {
+      flags.noIntro = true;
+    } else if (a === "--fast") {
+      flags.fast = true;
     } else if (a !== undefined && a.startsWith("--model=")) {
       flags.model = a.slice("--model=".length);
     } else if (a !== undefined && a.startsWith("--persona=")) {
@@ -132,6 +136,25 @@ export function isValidApiKey(k: string | undefined | null): k is string {
   return true;
 }
 
+function parseOptionalBoolean(value: unknown): boolean | undefined {
+  if (typeof value === "boolean") return value;
+  if (typeof value !== "string") return undefined;
+  switch (value.trim().toLowerCase()) {
+    case "1":
+    case "true":
+    case "yes":
+    case "on":
+      return true;
+    case "0":
+    case "false":
+    case "no":
+    case "off":
+      return false;
+    default:
+      return undefined;
+  }
+}
+
 async function readApiKeyFromStdin(): Promise<string | null> {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -146,16 +169,20 @@ async function readApiKeyFromStdin(): Promise<string | null> {
   }
 }
 
-export async function ensureApiKey(): Promise<string> {
+export async function ensureApiKey(opts?: {
+  prompt?: () => Promise<string | null>;
+}): Promise<string> {
   const fileCfg = await loadConfigFile();
   const envKey = process.env.OPENROUTER_API_KEY;
   if (isValidApiKey(envKey)) return envKey.trim();
   if (isValidApiKey(fileCfg.apiKey)) return fileCfg.apiKey.trim();
 
-  console.log("Drexler notice no API key on file. Even CEO need credentials.");
-  console.log("Get free key at: https://openrouter.ai/keys");
+  if (!opts?.prompt) {
+    console.log("Drexler notice no API key on file. Even CEO need credentials.");
+    console.log("Get free key at: https://openrouter.ai/keys");
+  }
 
-  const entered = await readApiKeyFromStdin();
+  const entered = await (opts?.prompt ?? readApiKeyFromStdin)();
   if (!isValidApiKey(entered)) {
     console.error("No valid API key provided. Drexler refuse to work pro bono.");
     process.exit(1);
@@ -212,11 +239,19 @@ export async function resolveConfig(argv: string[]): Promise<Config> {
   const themeCandidate =
     flags.theme ?? process.env.DREXLER_THEME ?? fileCfg.theme;
   const theme =
-    themeCandidate === "apollo" ||
-    themeCandidate === "amber" ||
-    themeCandidate === "mono"
-      ? themeCandidate
+    typeof themeCandidate === "string" &&
+    THEME_NAMES.includes(themeCandidate as ThemeName)
+      ? (themeCandidate as ThemeName)
       : undefined;
 
-  return { apiKey, model, maxHistory, personaPath, theme };
+  const noIntro =
+    flags.noIntro ??
+    parseOptionalBoolean(process.env.DREXLER_NO_INTRO) ??
+    parseOptionalBoolean(fileCfg.noIntro);
+  const fast =
+    flags.fast ??
+    parseOptionalBoolean(process.env.DREXLER_FAST) ??
+    parseOptionalBoolean(fileCfg.fast);
+
+  return { apiKey, model, maxHistory, personaPath, theme, noIntro, fast };
 }

package/src/index.ts

@@ -20,6 +20,7 @@ import {
 import { startRepl } from "./repl.ts";
 import { App } from "./ui/App.tsx";
 import { MascotIntro } from "./ui/MascotIntro.tsx";
+import { promptForApiKeyWithInk } from "./ui/SetupPrompt.tsx";
 import { ThemeProvider } from "./ui/ThemeContext.tsx";
 import { getActiveTheme, selectTheme, setActiveTheme } from "./ui/themes.ts";
 
@@ -41,7 +42,9 @@ Usage: drexler [options]
 Options:
   --model <31b|26b|id>           model alias or full OpenRouter id
   --persona <path>               custom persona markdown
-  --theme <apollo|amber|mono>    color theme (default apollo)
+  --theme <name>                 color theme (default apollo)
+  --no-intro                     skip startup banner and mascot
+  --fast                         fast startup mode, implies --no-intro
   --version, -v                  print version
   --help, -h                     this help
 
@@ -51,9 +54,18 @@ Slash commands inside REPL:
   /exit          exit
   /synergy       SYNERGY!
   /model [id]    show or switch model
+  /theme [name]  show or switch theme; append save to persist
+  /startup [mode] persist startup mode: fast, no-intro, normal
   /history       message + token count
   /regenerate    re-roll last response
+  /retry [style] re-roll last response as terse or brutal
+  /expand        print latest response
+  /quote         quote latest response
+  /search <term> search transcript
+  /export <fmt> [path] export md, txt, json, or html
   /save [path]   archive conversation as markdown
+  /save-last [path] save latest response
+  /copy-last     copy latest response to clipboard
 
 Ctrl+C exits gracefully.`;
 
@@ -70,8 +82,13 @@ async function main(): Promise<void> {
     process.exit(0);
   }
 
+  const isInteractive =
+    process.stdout.isTTY === true && process.stdin.isTTY === true;
+
   // Acquire API key. Prompts interactively if missing — runs BEFORE banner.
-  await ensureApiKey();
+  await ensureApiKey({
+    prompt: isInteractive ? promptForApiKeyWithInk : undefined,
+  });
 
   let config;
   try {
@@ -105,27 +122,27 @@ async function main(): Promise<void> {
     systemPromptWithMood,
     config.maxHistory,
   );
-
-  const isInteractive =
-    process.stdout.isTTY === true && process.stdin.isTTY === true;
+  const skipIntro = config.noIntro === true || config.fast === true;
 
   if (isInteractive) {
-    // Print intro to stdout before Ink mounts. Ink's <Static> can't host
-    // animated state, and we want the banner visible from boot.
-    console.log("");
-    await typewriterBanner();
-    console.log(tagline());
-    console.log("");
-    // Animated welcome card via transient Ink instance.
-    const intro = render(
-      React.createElement(ThemeProvider, {
-        value: getActiveTheme(),
-        children: React.createElement(MascotIntro, { greeting }),
-      }),
-      { exitOnCtrlC: false },
-    );
-    await intro.waitUntilExit();
-    intro.unmount();
+    if (!skipIntro) {
+      // Print intro to stdout before Ink mounts. Ink's <Static> can't host
+      // animated state, and we want the banner visible from boot.
+      console.log("");
+      await typewriterBanner();
+      console.log(tagline());
+      console.log("");
+      // Animated welcome card via transient Ink instance.
+      const intro = render(
+        React.createElement(ThemeProvider, {
+          value: getActiveTheme(),
+          children: React.createElement(MascotIntro, { greeting }),
+        }),
+        { exitOnCtrlC: false },
+      );
+      await intro.waitUntilExit();
+      intro.unmount();
+    }
 
     console.log("");
     console.log("  " + infoLine() + "  ·  mood: " + mood);
@@ -134,7 +151,7 @@ async function main(): Promise<void> {
     const { waitUntilExit } = render(
       React.createElement(ThemeProvider, {
         value: getActiveTheme(),
-        children: React.createElement(App, { conversation, config }),
+        children: React.createElement(App, { conversation, config, mood }),
       }),
       { exitOnCtrlC: false },
     );
@@ -144,11 +161,13 @@ async function main(): Promise<void> {
 
   // Non-TTY fallback: linear output, readline-based REPL.
   console.log("");
-  console.log(banner());
-  console.log(tagline());
-  console.log("");
-  console.log(welcomeBox(greeting, termCols()));
-  console.log("");
+  if (!skipIntro) {
+    console.log(banner());
+    console.log(tagline());
+    console.log("");
+    console.log(welcomeBox(greeting, termCols()));
+    console.log("");
+  }
   console.log("  " + infoLine() + "  ·  mood: " + mood);
   console.log("");
 

package/src/renderer.ts

@@ -1,5 +1,4 @@
 import chalk from "chalk";
-import { highlight } from "cli-highlight";
 import { marked } from "marked";
 import { markedTerminal } from "marked-terminal";
 import { THINKING_LINES, WITTICISMS } from "./sayings.ts";
@@ -10,13 +9,26 @@ export function getColors() {
   return buildChalkColors(getActiveTheme());
 }
 
+// cli-highlight is ~160KB and only used for code blocks inside markdown.
+// Pre-warm in background so cold boot doesn't pay parse cost on critical path;
+// fall back to dim raw text on the off-chance a code block renders pre-load.
+type HighlightFn = (code: string, opts: { language?: string; ignoreIllegals?: boolean }) => string;
+let highlightFn: HighlightFn | null = null;
+void import("cli-highlight").then((m) => {
+  highlightFn = m.highlight as HighlightFn;
+});
+
 function highlightCodeBlock(code: string, lang: string | undefined): string {
   let body: string;
-  try {
-    body = lang
-      ? highlight(code, { language: lang, ignoreIllegals: true })
-      : highlight(code, { ignoreIllegals: true });
-  } catch {
+  if (highlightFn) {
+    try {
+      body = lang
+        ? highlightFn(code, { language: lang, ignoreIllegals: true })
+        : highlightFn(code, { ignoreIllegals: true });
+    } catch {
+      body = chalk.gray(code);
+    }
+  } else {
     body = chalk.gray(code);
   }
   const c = getColors();
@@ -327,18 +339,10 @@ export function error(msg: string): string {
   return getColors().error(msg);
 }
 
-export function warning(msg: string): string {
-  return getColors().warning(msg);
-}
-
 export function dim(msg: string): string {
   return getColors().dim(msg);
 }
 
-export function separator(): string {
-  return getColors().apolloDim("─".repeat(BOX_WIDTH));
-}
-
 export function pickThinkingLine(): string {
   return THINKING_LINES[Math.floor(Math.random() * THINKING_LINES.length)] ?? "Drexler thinking";
 }

package/src/repl.ts

@@ -5,6 +5,7 @@ import {
   isSlash,
   type CommandAction,
 } from "./commands.ts";
+import { saveConfig } from "./config.ts";
 import type { Conversation } from "./conversation.ts";
 import { streamChat, type FetchFn } from "./llm.ts";
 import type { Message } from "./types.ts";
@@ -40,11 +41,25 @@ export interface ReplDeps {
   print: (s: string) => void;
 }
 
-function pickFallback(currentModel: string): string {
+async function persistPreferences(
+  partial: Partial<Config> | undefined,
+  print: (s: string) => void,
+): Promise<void> {
+  if (!partial) return;
+  try {
+    await saveConfig(partial);
+    print(info("Drexler preferences filed."));
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    print(error(`Could not save preferences: ${msg}`));
+  }
+}
+
+export function pickFallback(currentModel: string): string {
   return currentModel === MODEL_PRIMARY ? MODEL_FALLBACK : MODEL_PRIMARY;
 }
 
-function buildMessagesWithReminder(conv: Conversation): Message[] {
+export function buildMessagesWithReminder(conv: Conversation): Message[] {
   const snap = conv.snapshot();
   const turns = conv.userTurns;
   if (turns > 0 && turns % REMINDER_INTERVAL === 0) {
@@ -70,7 +85,10 @@ interface KeypressKey {
 }
 type KeypressListener = (str: string | undefined, key: KeypressKey) => void;
 
-async function streamFromHistory(deps: ReplDeps): Promise<void> {
+async function streamFromHistory(
+  deps: ReplDeps,
+  instruction?: string,
+): Promise<void> {
   const spinner = startSpinner();
   let firstToken = true;
   const accent = createAccentBarWriter();
@@ -102,7 +120,12 @@ async function streamFromHistory(deps: ReplDeps): Promise<void> {
       apiKey: deps.config.apiKey,
       model: deps.config.model,
       fallbackModel: pickFallback(deps.config.model),
-      messages: buildMessagesWithReminder(deps.conversation),
+      messages: instruction
+        ? [
+            ...buildMessagesWithReminder(deps.conversation),
+            { role: "system", content: instruction },
+          ]
+        : buildMessagesWithReminder(deps.conversation),
       onToken,
       signal: abort.signal,
       fetchFn: deps.fetchFn,
@@ -151,8 +174,11 @@ export async function handleLine(
       config: deps.config,
       print: deps.print,
     });
+    if (action.type === "continue") {
+      await persistPreferences(action.persistConfig, deps.print);
+    }
     if (action.type === "regenerate") {
-      await streamFromHistory(deps);
+      await streamFromHistory(deps, action.instruction);
       return { type: "continue" };
     }
     return action;

package/src/types.ts

@@ -8,12 +8,27 @@ export interface Message {
 export const MODEL_PRIMARY = "google/gemma-4-31b-it";
 export const MODEL_FALLBACK = "google/gemma-4-26b-a4b-it";
 
+export const THEME_NAMES = [
+  "apollo",
+  "amber",
+  "mono",
+  "terminal",
+  "dealroom",
+  "midnight",
+  "paper",
+  "plasma",
+] as const;
+
+export type ThemeName = (typeof THEME_NAMES)[number];
+
 export interface Config {
   apiKey: string;
   model: string;
   maxHistory: number;
   personaPath: string;
-  theme?: string;
+  theme?: ThemeName;
+  noIntro?: boolean;
+  fast?: boolean;
 }
 
 export interface PersonaData {
@@ -25,6 +40,8 @@ export interface CliFlags {
   model?: string;
   persona?: string;
   theme?: string;
+  noIntro?: boolean;
+  fast?: boolean;
 }
 
 export interface OpenRouterRequestBody {