drexler 0.2.13 → 0.2.15

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.14
+
+- Added a startup Mood panel with a stable boot gauge, percentage-only loading row, and rotating mood-specific posture/detail copy.
+- Anchored the wide startup dashboard so wrapped greeting copy no longer pushes the Mood and Deal Desk boxes down or adds stray rows.
+- Reworked the embedded Deal Desk into satirical mood-shaped product chrome instead of model/context telemetry.
+- Improved Drexler transcript rendering with complete bordered cards, a diamond response marker, cleaned markdown/code fence display, and Dracula-inspired code syntax colors.
+- Updated documentation to match current startup chrome, command palette behavior, keyboard controls, source setup, and layout invariants.
+
 ## 0.2.13
 
 - Hardened startup panel layout across narrow, standard, and wide terminals.

package/README.md

@@ -4,7 +4,7 @@
 [![license](https://img.shields.io/npm/l/drexler.svg)](./LICENSE)
 [![bun](https://img.shields.io/badge/runtime-bun%20%E2%89%A5%201.1-black)](https://bun.sh)
 
-CLI chat with **Drexler**, a corporate-executive AI persona who speaks in broken third-person and treats every conversation like a hostile takeover. Built with Bun + TypeScript. Talks to OpenRouter's Gemma 4 31B model (paid).
+CLI chat with **Drexler**, a corporate-executive AI persona who speaks in broken third-person and treats every conversation like a hostile takeover. Built with Bun + TypeScript, Ink, and OpenRouter-compatible Gemma models.
 
 > "Drexler usually charge consulting fee for this. Today, pro bono. You welcome."
 
@@ -13,7 +13,7 @@ CLI chat with **Drexler**, a corporate-executive AI persona who speaks in broken
 ## Quickstart
 
 ```bash
-bun add -g drexler
+bun install -g drexler@latest
 drexler
 ```
 
@@ -39,7 +39,7 @@ Verify: `bun --version` → should print `1.1.0` or higher.
 ### 2. Install Drexler globally
 
 ```bash
-bun add -g drexler
+bun install -g drexler@latest
 ```
 
 This installs the `drexler` command into `~/.bun/bin/drexler`. Make sure `~/.bun/bin` is on your `$PATH` (Bun's installer does this automatically; if not, add `export PATH="$HOME/.bun/bin:$PATH"` to your shell rc).
@@ -65,9 +65,17 @@ Paste the key, hit return. Drexler saves it to `~/.config/drexler/config.json` (
 ## Update
 
 ```bash
-bun update -g drexler
+bun update -g drexler --latest
 ```
 
+If your Bun install does not have the package in its global lockfile, reinstall it instead:
+
+```bash
+bun install -g drexler@latest
+```
+
+Global updates replace the existing `drexler` package in Bun's global install location; they do not keep stacking duplicate app copies.
+
 ## Uninstall
 
 ```bash
@@ -79,6 +87,33 @@ rm -rf ~/.config/drexler   # optional: wipe stored key + settings
 
 ## Usage
 
+### Interactive UI
+
+Drexler runs as an Ink terminal UI when both stdin and stdout are TTYs. The normal launch shows one integrated startup panel with the mascot, tips, a **Mood** readout, and the **Drexler Deal Desk**. Short terminals automatically suppress oversized startup chrome so the chat stays usable.
+
+The startup panel is designed to stay stable while it boots: the mascot loading bar and Mood gauge animate without changing width, greeting copy is held in a fixed slot, and the Mood and Deal Desk boxes stay aligned when the greeting wraps. After boot, Mood resolves into a rotating Drexler-flavored posture with a short satirical subtext line.
+
+The Deal Desk is intentionally not a frontier-model telemetry panel. It shows mood-shaped corporate nonsense like boardroom status, memo count, mandate, risk, fees, and counsel posture. Values rotate by mood and session so repeated moods still feel alive.
+
+Conversation turns render as bordered cards aligned to the chat input width. User and Drexler responses use separate accents, wrapped text, and fixed-width borders so long responses stay inside the terminal instead of clipping at the right edge. Drexler responses use a diamond body marker. Markdown/code fence labels are cleaned up for display, and code blocks render with Dracula-inspired terminal syntax colors.
+
+Typing `/` opens the directive palette. Use `Tab`, `Enter`, or `↑`/`↓` to select. Commands with fixed arguments open smoother option choosers:
+
+- `/theme` previews all themes with descriptions.
+- `/startup` offers `fast`, `no-intro`, and `normal`.
+- `/retry` offers `terse` and `brutal`.
+- `/export` offers `md`, `txt`, `json`, and `html`.
+- `/model` offers `31b` and `26b`.
+
+`/synergy` runs a rotating animated corporate event in the live UI, then returns control to the chat when the animation completes.
+
+Keyboard notes:
+
+- `Tab`, `Enter`, and `↑`/`↓` operate the directive palette.
+- `PageUp`/`PageDown` scroll transcript history when it exceeds the visible viewport.
+- `Esc` cancels an in-flight model response without quitting.
+- `Ctrl+C` exits gracefully with an in-character farewell.
+
 ### Flags
 
 | flag                              | what                                                              |
@@ -93,12 +128,12 @@ rm -rf ~/.config/drexler   # optional: wipe stored key + settings
 
 ### Slash commands (inside the REPL)
 
-| cmd            | what it do                                       |
+| cmd            | what it does                                     |
 | -------------- | ------------------------------------------------ |
 | `/help`        | list directives                                  |
 | `/clear`       | shred conversation history (system prompt pinned) |
 | `/exit`        | meeting adjourned                                |
-| `/synergy`     | SYNERGY!                                         |
+| `/synergy`     | run a rotating animated morale event             |
 | `/model`       | show current model, or `/model 26b` to switch   |
 | `/theme`       | show/switch theme; append `save` to persist, e.g. `/theme midnight save` |
 | `/startup fast\|no-intro\|normal` | persist startup behavior for future launches |
@@ -114,8 +149,6 @@ rm -rf ~/.config/drexler   # optional: wipe stored key + settings
 | `/save-last [path]` | save Drexler's last response only          |
 | `/copy-last`   | copy Drexler's latest response to the clipboard  |
 
-`Ctrl+C` exits gracefully with an in-character farewell.
-
 ---
 
 ## Configuration
@@ -126,6 +159,8 @@ Drexler reads config in this priority (later wins):
 2. Environment variables
 3. CLI flags
 
+If the current config file does not exist, Drexler also checks the legacy `~/.drexlerrc` path.
+
 ### Environment variables
 
 | var                  | purpose                                              |
@@ -159,13 +194,26 @@ Default `maxHistory`: 50 messages.
 Available launch/config themes: `apollo`, `amber`, `mono`, `terminal`, `dealroom`, `midnight`, `paper`, and `plasma`.
 `NO_COLOR` always forces `mono`.
 
+Theme notes:
+
+| theme      | character                                  |
+| ---------- | ------------------------------------------ |
+| `apollo`   | signature Drexler green, the default        |
+| `amber`    | warm amber deal glow                        |
+| `mono`     | plain high-contrast ANSI colors             |
+| `terminal` | classic green/cyan terminal                 |
+| `dealroom` | restrained teal boardroom palette           |
+| `midnight` | cool blue late-session desk                 |
+| `paper`    | clean document-style contrast               |
+| `plasma`   | high-energy magenta trading-floor accent    |
+
 ---
 
 ## Models
 
 | alias  | id                                  | notes                          |
 | ------ | ----------------------------------- | ------------------------------ |
-| `31b`  | `google/gemma-4-31b-it`             | primary (paid)                 |
+| `31b`  | `google/gemma-4-31b-it`             | primary default                |
 | `26b`  | `google/gemma-4-26b-a4b-it`         | fallback, auto-retry on 429    |
 
 Pass `--model vendor/name:tag` for any other OpenRouter-compatible model.
@@ -178,7 +226,7 @@ Pass `--model vendor/name:tag` for any other OpenRouter-compatible model.
 git clone https://github.com/showOS/Drexler.git
 cd Drexler
 bun install
-cp .env.example .env       # then edit, paste key into OPENROUTER_API_KEY=
+export OPENROUTER_API_KEY=sk-or-v1-your-key
 bun run start
 ```
 
@@ -192,11 +240,12 @@ bun run typecheck
 ### Releasing a new version
 
 ```bash
-npm version <patch|minor>  # bumps package.json, commits, tags
-git push --follow-tags     # CI publishes to npm automatically
+bun run prepublishOnly
+npm version <patch|minor>  # bumps package.json, commits, and tags
+git push origin main --follow-tags
 ```
 
-The `.github/workflows/publish.yml` workflow runs typecheck + tests + `npm publish --provenance` on every `v*` tag push.
+The `.github/workflows/publish.yml` workflow runs install, tag/package version verification, typecheck, tests, and `npm publish --provenance` on every `v*` tag push.
 
 ---
 
@@ -210,6 +259,8 @@ The `.github/workflows/publish.yml` workflow runs typecheck + tests + `npm publi
 | Garbled box-drawing characters                             | Use a UTF-8 terminal with a Nerd Font (e.g. iTerm2, Alacritty, WezTerm)                   |
 | Want to switch themes mid-session                          | Use `/theme midnight`, `/theme dealroom`, `/theme amber`, or any listed theme inside the REPL |
 | Want a faster launch                                       | Use `drexler --fast` or set `"fast": true` in config                                     |
+| Startup panel looks cramped                                | Enlarge the terminal, or use `/startup no-intro` or `/startup fast`                      |
+| Slash command options are not visible                      | Type `/`, `/theme`, `/startup`, `/retry`, `/export`, or `/model`; exact fixed-argument commands open their chooser automatically |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drexler",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "CLI chat with Drexler, a corporate-executive AI persona built on OpenRouter Gemma 4 31B.",
   "license": "MIT",
   "author": "showOS",

package/src/commands.ts

@@ -1,7 +1,13 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, writeFileSync } from "node:fs";
 import { resolve as pathResolve } from "node:path";
-import { resolveModel } from "./config.ts";
+import {
+  getConfigPath,
+  getDrexlerVersion,
+  getResolvedConfigPath,
+  isValidApiKey,
+  resolveModel,
+} from "./config.ts";
 import type { Conversation } from "./conversation.ts";
 import { error, resetMarkedTheme } from "./renderer.ts";
 import { THEME_NAMES, type Config, type ThemeName } from "./types.ts";
@@ -17,6 +23,14 @@ export type CommandAction =
   | { type: "exit"; message?: string }
   | { type: "regenerate"; instruction?: string; removedAssistant: boolean };
 
+export type CommandGroup =
+  | "directives"
+  | "themes"
+  | "models"
+  | "startup"
+  | "retry"
+  | "export";
+
 interface CommandContext {
   conversation: Conversation;
   config: Config;
@@ -33,6 +47,14 @@ const HELP_TEXT = `New memo to staff! Drexler permit following directives:
   /clear         - shred all documents (reset history)
   /exit          - meeting adjourned
   /synergy       - SYNERGY!
+  /feed          - feed Drexler a deal memo
+  /play          - corporate synergy game with Drexler
+  /work          - Drexler grinds the deal pipeline
+  /praise        - affirm Drexler's contributions
+  /rest          - Drexler takes a strategic nap
+  /vibe          - let Drexler choose his own adventure
+  /name [name]   - view or assign Drexler's pet name
+  /profile       - print Drexler's personnel file
   /model         - show or switch model (e.g. /model 26b)
   /theme         - show or switch theme (${THEME_NAMES.join(", ")})
   /startup       - persist startup mode (fast, no-intro, normal)
@@ -46,7 +68,9 @@ const HELP_TEXT = `New memo to staff! Drexler permit following directives:
   /export <fmt> [path] - export as md, txt, json, or html
   /save [path]   - archive conversation to markdown file
   /save-last [path] - save Drexler's last response
-  /copy-last     - copy Drexler's last response to clipboard`;
+  /copy-last     - copy Drexler's last response to clipboard
+  /setup         - show config + API key source
+  /update        - show upgrade instructions`;
 
 const WHITESPACE_RE = /\s+/;
 
@@ -54,27 +78,38 @@ export interface SlashCommand {
   readonly name: string;
   readonly description: string;
   readonly hint?: string;
+  readonly group?: CommandGroup;
 }
 
 export const COMMAND_PALETTE: ReadonlyArray<SlashCommand> = [
-  { name: "/help", description: "Show directives" },
-  { name: "/clear", description: "Reset conversation" },
-  { name: "/exit", description: "Adjourn meeting" },
-  { name: "/synergy", description: "SYNERGY!" },
-  { name: "/model", description: "Show or switch model" },
-  { name: "/theme", description: "Show or switch theme" },
-  { name: "/startup", description: "Persist startup mode" },
-  { name: "/history", description: "Message + token count" },
-  { name: "/regenerate", description: "Re-roll last response" },
-  { name: "/redo", description: "Alias for regenerate" },
-  { name: "/retry", description: "Retry terse or brutal" },
-  { name: "/expand", description: "Print last response" },
-  { name: "/quote", description: "Quote last response" },
-  { name: "/search", description: "Search transcript" },
-  { name: "/export", description: "Export md, txt, json, or html" },
-  { name: "/save", description: "Archive conversation as markdown" },
-  { name: "/save-last", description: "Save last Drexler response" },
-  { name: "/copy-last", description: "Copy last response" },
+  { name: "/help", description: "Show directives", group: "directives" },
+  { name: "/clear", description: "Reset conversation", group: "directives" },
+  { name: "/exit", description: "Adjourn meeting", group: "directives" },
+  { name: "/synergy", description: "SYNERGY!", group: "directives" },
+  { name: "/feed", description: "Feed Drexler a deal memo", group: "directives" },
+  { name: "/play", description: "Play with Drexler", group: "directives" },
+  { name: "/work", description: "Drexler grinds deals", group: "directives" },
+  { name: "/praise", description: "Affirm Drexler", group: "directives" },
+  { name: "/rest", description: "Drexler takes a strategic nap", group: "directives" },
+  { name: "/vibe", description: "Drexler chooses his own adventure", group: "directives" },
+  { name: "/name", description: "Issue or view Drexler's pet name", group: "directives" },
+  { name: "/profile", description: "Print Drexler's personnel file", group: "directives" },
+  { name: "/model", description: "Show or switch model", group: "models" },
+  { name: "/theme", description: "Show or switch theme", group: "themes" },
+  { name: "/startup", description: "Persist startup mode", group: "startup" },
+  { name: "/history", description: "Message + token count", group: "directives" },
+  { name: "/regenerate", description: "Re-roll last response", group: "directives" },
+  { name: "/redo", description: "Alias for regenerate", group: "directives" },
+  { name: "/retry", description: "Retry terse or brutal", group: "retry" },
+  { name: "/expand", description: "Print last response", group: "directives" },
+  { name: "/quote", description: "Quote last response", group: "directives" },
+  { name: "/search", description: "Search transcript", group: "directives" },
+  { name: "/export", description: "Export md, txt, json, or html", group: "export" },
+  { name: "/save", description: "Archive conversation as markdown", group: "directives" },
+  { name: "/save-last", description: "Save last Drexler response", group: "directives" },
+  { name: "/copy-last", description: "Copy last response", group: "directives" },
+  { name: "/setup", description: "Show config + key source", group: "directives" },
+  { name: "/update", description: "Show upgrade instructions", group: "directives" },
 ];
 
 const THEME_PALETTE_COPY: Record<
@@ -265,6 +300,21 @@ export function filterPaletteByPrefix(
   );
 }
 
+const ARGUMENT_BASE_NAMES: ReadonlySet<string> = new Set(
+  ARGUMENT_PALETTE.map((g) => g.command),
+);
+
+/**
+ * True if `name` is a bare command (no space) that has child argument
+ * suggestions. Palette Enter on such a name should NOT execute — it should
+ * open the chooser.
+ */
+export function isArgumentParentCommand(name: string): boolean {
+  if (!name.startsWith("/")) return false;
+  if (name.includes(" ")) return false;
+  return ARGUMENT_BASE_NAMES.has(name.toLowerCase());
+}
+
 export function isSlash(input: string): boolean {
   return input.startsWith("/");
 }
@@ -319,6 +369,19 @@ export function dispatch(input: string, ctx: CommandContext): CommandAction {
       );
       return { type: "continue" };
 
+    case "feed":
+    case "play":
+    case "work":
+    case "praise":
+    case "rest":
+    case "vibe":
+    case "name":
+    case "profile":
+      ctx.print(
+        "Drexler pet directives require the interactive deal desk. Launch Drexler in a TTY.",
+      );
+      return { type: "continue" };
+
     case "model":
       handleModel(args, ctx);
       return { type: "continue" };
@@ -407,6 +470,14 @@ export function dispatch(input: string, ctx: CommandContext): CommandAction {
       return { type: "continue" };
     }
 
+    case "setup":
+      handleSetup(ctx);
+      return { type: "continue" };
+
+    case "update":
+      handleUpdate(ctx);
+      return { type: "continue" };
+
     default:
       ctx.print(
         "Drexler not recognize that corporate directive. Try /help.",
@@ -869,3 +940,39 @@ function handleTheme(args: string[], ctx: CommandContext): CommandAction {
     ? { type: "continue", persistConfig: { theme: requested } }
     : { type: "continue" };
 }
+
+function handleSetup(ctx: CommandContext): void {
+  const envValid = isValidApiKey(process.env.OPENROUTER_API_KEY);
+  const target = getResolvedConfigPath() ?? getConfigPath();
+  const keySourceLabel = envValid
+    ? "(env: OPENROUTER_API_KEY)"
+    : isValidApiKey(ctx.config.apiKey)
+      ? `(config file: ${target})`
+      : "(missing — first-run prompt will request one)";
+
+  const lines = [
+    "Drexler setup ledger:",
+    `  version       : ${getDrexlerVersion()}`,
+    `  config file   : ${target}`,
+    `  API key       : ${keySourceLabel}`,
+    `  model         : ${ctx.config.model}`,
+    `  theme         : ${currentThemeName(ctx.config)}`,
+    `  startup mode  : ${currentStartupMode(ctx.config)}`,
+    `  persona file  : ${ctx.config.personaPath}`,
+  ];
+  ctx.print(lines.join("\n"));
+}
+
+function handleUpdate(ctx: CommandContext): void {
+  const lines = [
+    `Drexler upgrade dossier (drexler v${getDrexlerVersion()}):`,
+    "",
+    "  bun update:    bun update -g drexler --latest",
+    "  bun reinstall: bun install -g drexler@latest",
+    "  npm:           npm install -g drexler@latest",
+    "  pnpm:          pnpm add -g drexler@latest",
+    "",
+    "Drexler will not run installs. Type the command into your shell.",
+  ];
+  ctx.print(lines.join("\n"));
+}

package/src/config.ts

@@ -1,4 +1,4 @@
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import {
   chmod,
   lstat,
@@ -16,6 +16,53 @@ import { MODEL_FALLBACK, MODEL_PRIMARY, THEME_NAMES } from "./types.ts";
 
 const DEFAULT_MAX_HISTORY = 50;
 
+export function getDrexlerVersion(): string {
+  try {
+    const pkgPath = join(import.meta.dir, "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+
+export function getConfigPath(): string {
+  return configPath();
+}
+
+export function getLegacyConfigPath(): string {
+  return legacyConfigPath();
+}
+
+export function getResolvedConfigPath(): string | null {
+  const cp = configPath();
+  const lp = legacyConfigPath();
+  if (existsSync(cp)) return cp;
+  if (existsSync(lp)) return lp;
+  return null;
+}
+
+export type ApiKeySource = "env" | "config-file" | "missing";
+
+export class LaunchConfigError extends Error {
+  readonly reason:
+    | "model-alias"
+    | "persona-path"
+    | "config-unreadable"
+    | "api-key-empty";
+  readonly detail: Record<string, unknown>;
+  constructor(
+    reason: LaunchConfigError["reason"],
+    message: string,
+    detail: Record<string, unknown> = {},
+  ) {
+    super(message);
+    this.name = "LaunchConfigError";
+    this.reason = reason;
+    this.detail = detail;
+  }
+}
+
 function getHome(): string {
   return process.env.HOME ?? process.env.USERPROFILE ?? homedir();
 }
@@ -75,6 +122,35 @@ export function defaultPersonaPath(): string {
   return resolve(import.meta.dir, "..", "prompts", "drexler.md");
 }
 
+async function validatePersonaFile(
+  inputPath: unknown,
+  label: string,
+): Promise<string> {
+  if (typeof inputPath !== "string" || inputPath.trim().length === 0) {
+    throw new LaunchConfigError(
+      "persona-path",
+      `Invalid ${label}: expected a regular .md file path.`,
+      { path: inputPath },
+    );
+  }
+  const resolved = resolve(inputPath);
+  // lstat (not stat) so symlinks pointing to non-.md targets cannot bypass
+  // the extension check via `ln -s /etc/passwd evil.md`.
+  const st = await lstat(resolved).catch(() => null);
+  if (
+    !st?.isFile() ||
+    st.isSymbolicLink() ||
+    !resolved.toLowerCase().endsWith(".md")
+  ) {
+    throw new LaunchConfigError(
+      "persona-path",
+      `Invalid ${label}: ${inputPath} (must be a regular .md file; symlinks rejected).`,
+      { path: inputPath },
+    );
+  }
+  return resolved;
+}
+
 export async function loadConfigFile(): Promise<Partial<Config>> {
   const cp = configPath();
   const lp = legacyConfigPath();
@@ -192,43 +268,38 @@ export async function ensureApiKey(opts?: {
   return apiKey;
 }
 
-export async function resolveConfig(argv: string[]): Promise<Config> {
+export interface LaunchStructural {
+  model: string;
+  personaPath: string;
+  theme?: ThemeName;
+  noIntro?: boolean;
+  fast?: boolean;
+  maxHistory: number;
+  fileCfg: Partial<Config>;
+}
+
+export async function validateLaunchConfig(
+  argv: string[],
+): Promise<LaunchStructural> {
   const flags = parseFlags(argv);
   const fileCfg = await loadConfigFile();
-  const envKey = process.env.OPENROUTER_API_KEY;
   const envModel = process.env.DREXLER_MODEL;
 
-  const apiKey = isValidApiKey(envKey)
-    ? envKey.trim()
-    : isValidApiKey(fileCfg.apiKey)
-    ? fileCfg.apiKey.trim()
-    : "";
-
-  if (!apiKey) {
-    throw new Error(
-      "API key missing. Run drexler interactively to set one, or export OPENROUTER_API_KEY.",
-    );
-  }
-
   const modelInput = flags.model ?? envModel ?? fileCfg.model ?? "31b";
-  const model = resolveModel(modelInput);
-
-  let personaPath: string;
-  if (flags.persona) {
-    const resolved = resolve(flags.persona);
-    // lstat (not stat) so symlinks pointing to non-.md targets cannot bypass
-    // the extension check via `ln -s /etc/passwd evil.md`.
-    const st = await lstat(resolved).catch(() => null);
-    if (!st?.isFile() || !resolved.toLowerCase().endsWith(".md")) {
-      throw new Error(
-        `Invalid --persona: ${flags.persona} (must be a regular .md file; symlinks rejected).`,
-      );
-    }
-    personaPath = resolved;
-  } else {
-    personaPath = fileCfg.personaPath ?? defaultPersonaPath();
+  let model: string;
+  try {
+    model = resolveModel(modelInput);
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new LaunchConfigError("model-alias", msg, { input: modelInput });
   }
 
+  const personaPath = flags.persona
+    ? await validatePersonaFile(flags.persona, "--persona")
+    : fileCfg.personaPath !== undefined
+      ? await validatePersonaFile(fileCfg.personaPath, "config personaPath")
+      : await validatePersonaFile(defaultPersonaPath(), "default persona");
+
   const maxHistory =
     typeof fileCfg.maxHistory === "number" &&
     Number.isInteger(fileCfg.maxHistory) &&
@@ -253,5 +324,43 @@ export async function resolveConfig(argv: string[]): Promise<Config> {
     parseOptionalBoolean(process.env.DREXLER_FAST) ??
     parseOptionalBoolean(fileCfg.fast);
 
-  return { apiKey, model, maxHistory, personaPath, theme, noIntro, fast };
+  return { model, personaPath, theme, noIntro, fast, maxHistory, fileCfg };
+}
+
+export async function describeApiKeySource(): Promise<{
+  source: ApiKeySource;
+  configPath: string | null;
+}> {
+  const envKey = process.env.OPENROUTER_API_KEY;
+  if (isValidApiKey(envKey)) return { source: "env", configPath: null };
+  const fileCfg = await loadConfigFile();
+  if (isValidApiKey(fileCfg.apiKey)) {
+    return { source: "config-file", configPath: getResolvedConfigPath() };
+  }
+  return { source: "missing", configPath: null };
+}
+
+export async function resolveConfig(argv: string[]): Promise<Config> {
+  const structural = await validateLaunchConfig(argv);
+  const envKey = process.env.OPENROUTER_API_KEY;
+  const apiKey = isValidApiKey(envKey)
+    ? envKey.trim()
+    : isValidApiKey(structural.fileCfg.apiKey)
+      ? structural.fileCfg.apiKey.trim()
+      : "";
+  if (!apiKey) {
+    throw new LaunchConfigError(
+      "api-key-empty",
+      "API key missing. Run drexler interactively to set one, or export OPENROUTER_API_KEY.",
+    );
+  }
+  return {
+    apiKey,
+    model: structural.model,
+    maxHistory: structural.maxHistory,
+    personaPath: structural.personaPath,
+    theme: structural.theme,
+    noIntro: structural.noIntro,
+    fast: structural.fast,
+  };
 }

package/src/conversation.ts

@@ -63,10 +63,6 @@ export class Conversation {
     return this.messages.length - 1;
   }
 
-  get totalLength(): number {
-    return this.messages.length;
-  }
-
   get userTurns(): number {
     return this.userTurnCount;
   }