mini-coder 0.5.14 → 0.6.0

package/src/ui/help.ts

@@ -1,158 +0,0 @@
-/**
- * `/help` text rendering and command descriptions for the terminal UI.
- *
- * @module
- */
-
-import type { AppState } from "../index.ts";
-import { COMMANDS, SKILL_COMMAND } from "../input.ts";
-import { abbreviatePath } from "./status.ts";
-
-/** Help text inputs derived from application state. */
-export interface HelpRenderState {
-  /** Available provider credentials keyed by provider id. */
-  providers: AppState["providers"];
-  /** Current model selection. */
-  model: AppState["model"];
-  /** Loaded AGENTS.md files. */
-  agentsMd: AppState["agentsMd"];
-  /** Discovered skills. */
-  skills: AppState["skills"];
-  /** Whether reasoning blocks are shown in the log. */
-  showReasoning: AppState["showReasoning"];
-  /** Whether verbose tool rendering is enabled in the log. */
-  verbose: AppState["verbose"];
-  /** Configured MCP servers and their current on/off state. */
-  mcpServers: AppState["mcpServers"];
-}
-
-/** Command descriptions for `/help` and command autocomplete. */
-export const COMMAND_DESCRIPTIONS: Record<string, string> = {
-  model: "Select a model",
-  effort: "Set reasoning effort",
-  session: "Resume a session",
-  new: "New session",
-  fork: "Fork session",
-  undo: "Undo last turn",
-  reasoning: "Toggle thinking display",
-  verbose: "Toggle verbose tool rendering",
-  mcp: "Toggle configured MCP servers",
-  todo: "Show the current todo list",
-  login: "OAuth login",
-  logout: "OAuth logout",
-  help: "Show help",
-};
-
-/** Slash-skill label shown in `/help` and command autocomplete. */
-export const SKILL_REFERENCE_LABEL = `/${SKILL_COMMAND}:name`;
-
-/** Description for the slash-skill input helper. */
-export const SKILL_REFERENCE_DESCRIPTION =
-  "Insert a discovered skill into the next message";
-
-/**
- * Get the `/help` description for a command, including current state when relevant.
- *
- * @param command - Command name.
- * @param state - Help-relevant application state.
- * @returns Markdown-ready command description.
- */
-function getHelpCommandDescription(
-  command: (typeof COMMANDS)[number],
-  state: Pick<HelpRenderState, "showReasoning" | "verbose">,
-): string {
-  const description = COMMAND_DESCRIPTIONS[command] ?? "";
-  if (command === "reasoning") {
-    return `${description} _(currently ${state.showReasoning ? "on" : "off"})_`;
-  }
-  if (command === "verbose") {
-    return `${description} _(currently ${state.verbose ? "on" : "off"})_`;
-  }
-  return description;
-}
-
-function formatInlineCode(text: string): string {
-  return `\`${text}\``;
-}
-
-function formatInlineCodeList(items: readonly string[]): string {
-  return items.map((item) => formatInlineCode(item)).join(", ");
-}
-
-function formatMcpServerState(
-  server: HelpRenderState["mcpServers"][number],
-): string {
-  return `${formatInlineCode(server.name)} (${server.enabled ? "on" : "off"})`;
-}
-
-/**
- * Build the `/help` text shown in the conversation log.
- *
- * @param state - Help-relevant application state.
- * @returns Multi-line markdown help text for display.
- */
-export function buildHelpText(state: HelpRenderState): string {
-  const lines: string[] = ["# Help", "", "## Commands", ""];
-
-  for (const command of COMMANDS) {
-    lines.push(
-      `- ${formatInlineCode(`/${command}`)} — ${getHelpCommandDescription(command, state)}`,
-    );
-  }
-  lines.push(
-    `- ${formatInlineCode(SKILL_REFERENCE_LABEL)} — ${SKILL_REFERENCE_DESCRIPTION}; submit ${formatInlineCode(`/${SKILL_COMMAND}`)} to open the skill picker.`,
-  );
-
-  const providerNames = Array.from(state.providers.keys());
-  const mcpServerStates = state.mcpServers.map((server) =>
-    formatMcpServerState(server),
-  );
-  lines.push(
-    "",
-    "## Keyboard",
-    "",
-    "- `Enter` submits the current draft.",
-    "- `Shift+Enter` inserts a newline.",
-    "- `Tab` opens command autocomplete when the draft starts with `/`, preserving the current draft.",
-    "- Otherwise, `Tab` autocompletes file paths and can open a path picker when there are multiple matches.",
-    "- `Ctrl+R` opens global input history search.",
-    "- `Escape` closes the current overlay and returns focus to the input.",
-    "- With no overlay open, `Escape` interrupts the current turn.",
-    "- Otherwise, `Escape` does nothing.",
-    "- `Ctrl+C` exits gracefully.",
-    "- `Ctrl+D` exits when the input is empty.",
-    "- `Ctrl+Z` suspends the app to the background.",
-    "",
-    "## Current state",
-    "",
-    providerNames.length > 0
-      ? `- Providers: ${formatInlineCodeList(providerNames)}`
-      : "- Providers: none — use `/login`",
-    state.model
-      ? `- Model: ${formatInlineCode(`${state.model.provider}/${state.model.id}`)}`
-      : "- Model: none — use `/model`",
-    mcpServerStates.length > 0
-      ? `- MCP servers: ${mcpServerStates.join(", ")}`
-      : "- MCP servers: none — configure them in `settings.json`",
-  );
-
-  if (state.agentsMd.length > 0) {
-    lines.push("", "## Loaded `AGENTS.md` files", "");
-    for (const agentFile of state.agentsMd) {
-      lines.push(`- ${formatInlineCode(abbreviatePath(agentFile.path))}`);
-    }
-  }
-
-  if (state.skills.length > 0) {
-    lines.push("", "## Skills", "");
-    for (const skill of state.skills) {
-      lines.push(
-        skill.description
-          ? `- ${formatInlineCode(skill.name)} — ${skill.description}`
-          : `- ${formatInlineCode(skill.name)}`,
-      );
-    }
-  }
-
-  return lines.join("\n");
-}

package/src/ui/input.test.ts

@@ -1,64 +0,0 @@
-import { afterEach, describe, expect, test } from "bun:test";
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { autocompleteInputPath, findInputPathMatches } from "./input.ts";
-
-const tempDirs: string[] = [];
-
-function createTempDir(): string {
-  const dir = mkdtempSync(join(tmpdir(), "mini-coder-ui-input-test-"));
-  tempDirs.push(dir);
-  return dir;
-}
-
-afterEach(() => {
-  for (const dir of tempDirs.splice(0)) {
-    rmSync(dir, { recursive: true, force: true });
-  }
-});
-
-describe("ui/input", () => {
-  test("autocompleteInputPath completes the last file path token when exactly one match is available", () => {
-    const cwd = createTempDir();
-    mkdirSync(join(cwd, "src"), { recursive: true });
-    writeFileSync(join(cwd, "src", "ui.ts"), "", "utf-8");
-
-    expect(autocompleteInputPath("inspect src/u", cwd)).toBe(
-      "inspect src/ui.ts",
-    );
-  });
-
-  test("autocompleteInputPath returns null when multiple matches are available", () => {
-    const cwd = createTempDir();
-    mkdirSync(join(cwd, "src"), { recursive: true });
-    writeFileSync(join(cwd, "src", "ui.ts"), "", "utf-8");
-    writeFileSync(join(cwd, "src", "utils.ts"), "", "utf-8");
-
-    expect(autocompleteInputPath("inspect src/u", cwd)).toBeNull();
-  });
-
-  test("findInputPathMatches returns sorted selectable matches for the last file path token", () => {
-    const cwd = createTempDir();
-    mkdirSync(join(cwd, "src"), { recursive: true });
-    writeFileSync(join(cwd, "src", "alpine.ts"), "", "utf-8");
-    writeFileSync(join(cwd, "src", "alpha.ts"), "", "utf-8");
-
-    expect(findInputPathMatches("inspect src/al", cwd)).toEqual([
-      {
-        label: "src/alpha.ts",
-        value: "inspect src/alpha.ts",
-      },
-      {
-        label: "src/alpine.ts",
-        value: "inspect src/alpine.ts",
-      },
-    ]);
-  });
-
-  test("autocompleteInputPath returns null when no completion is available", () => {
-    const cwd = createTempDir();
-
-    expect(autocompleteInputPath("inspect src/u", cwd)).toBeNull();
-  });
-});

package/src/ui/input.ts

@@ -1,138 +0,0 @@
-/**
- * Input-area rendering and path-autocomplete helpers for the terminal UI.
- *
- * @module
- */
-
-import { readdirSync } from "node:fs";
-import { isAbsolute, join } from "node:path";
-import { Text, TextInput } from "@cel-tui/core";
-import type { Node } from "@cel-tui/types";
-import type { Theme } from "../theme.ts";
-
-const INPUT_PLACEHOLDER =
-  "`Ctrl+R` for input history, `/` + `Tab` for interactive menu, or type a message…";
-
-/** Stable callbacks for the controlled TextInput. */
-export interface InputController {
-  /** Update the controlled input value and re-render. */
-  onChange: (value: string) => void;
-  /** Mark the input as focused and re-render. */
-  onFocus: () => void;
-  /** Mark the input as blurred and re-render. */
-  onBlur: () => void;
-  /** Intercept submit/autocomplete keys before default editing runs. */
-  onKeyPress: (key: string) => boolean | undefined;
-}
-
-/** A selectable path-autocomplete match for the current input draft. */
-export interface InputPathMatch {
-  /** Path label shown in the overlay. */
-  label: string;
-  /** Full draft value to apply when this match is selected. */
-  value: string;
-}
-
-function listInputPathMatches(value: string, cwd: string): InputPathMatch[] {
-  const tokenMatch = /(^|\s)(\S+)$/.exec(value);
-  if (!tokenMatch?.[2]) {
-    return [];
-  }
-
-  const token = tokenMatch[2];
-  const tokenStart = tokenMatch.index + tokenMatch[1]!.length;
-  const slashIndex = token.lastIndexOf("/");
-  const dirToken = slashIndex >= 0 ? token.slice(0, slashIndex + 1) : "";
-  const partial = token.slice(slashIndex + 1);
-  const searchDir = isAbsolute(token)
-    ? dirToken || "/"
-    : join(cwd, dirToken || ".");
-
-  const entries = (() => {
-    try {
-      return readdirSync(searchDir, {
-        encoding: "utf8",
-        withFileTypes: true,
-      });
-    } catch {
-      return null;
-    }
-  })();
-  if (!entries) {
-    return [];
-  }
-
-  const showHidden = partial.startsWith(".");
-  return entries
-    .filter((entry) => (showHidden ? true : !entry.name.startsWith(".")))
-    .filter((entry) => entry.name.startsWith(partial))
-    .sort((a, b) => a.name.localeCompare(b.name))
-    .map((entry) => {
-      const completedPath = `${dirToken}${entry.name}${entry.isDirectory() ? "/" : ""}`;
-      return {
-        label: completedPath,
-        value: `${value.slice(0, tokenStart)}${completedPath}`,
-      };
-    });
-}
-
-/**
- * Find selectable path matches for the final path token in the current draft.
- *
- * @param value - Current input draft.
- * @param cwd - Working directory used to resolve relative paths.
- * @returns Matching path completions with their applied draft values.
- */
-export function findInputPathMatches(
-  value: string,
-  cwd: string,
-): InputPathMatch[] {
-  return listInputPathMatches(value, cwd);
-}
-
-/**
- * Attempt to autocomplete the final path token in the current draft.
- *
- * @param value - Current input draft.
- * @param cwd - Working directory used to resolve relative paths.
- * @returns The completed input value, or `null` when direct completion is unavailable.
- */
-export function autocompleteInputPath(
-  value: string,
-  cwd: string,
-): string | null {
-  const matches = listInputPathMatches(value, cwd);
-  return matches.length === 1 ? matches[0]!.value : null;
-}
-
-/**
- * Render the input area.
- *
- * @param theme - Active UI theme.
- * @param controller - Stable TextInput callbacks.
- * @param value - Current input draft.
- * @param focused - Whether the input should be focused.
- * @returns The input area node.
- */
-export function renderInputArea(
-  theme: Theme,
-  controller: InputController,
-  value: string,
-  focused: boolean,
-): Node {
-  return TextInput({
-    minHeight: 2,
-    maxHeight: 10,
-    padding: { x: 1 },
-    value,
-    onChange: controller.onChange,
-    placeholder: Text(INPUT_PLACEHOLDER, {
-      fgColor: theme.mutedText,
-      italic: true,
-    }),
-    focused,
-    onFocus: controller.onFocus,
-    onBlur: controller.onBlur,
-    onKeyPress: controller.onKeyPress,
-  });
-}

package/src/ui/overlay.ts

@@ -1,59 +0,0 @@
-/**
- * Overlay rendering primitives for the terminal UI.
- *
- * @module
- */
-
-import type { SelectInstance } from "@cel-tui/components";
-import { Text, VStack } from "@cel-tui/core";
-import type { Node } from "@cel-tui/types";
-import type { Theme } from "../theme.ts";
-
-/** Max visible items in the overlay Select. */
-export const OVERLAY_MAX_VISIBLE = 15;
-
-/** Horizontal padding around the overlay modal. */
-export const OVERLAY_PADDING_X = 4;
-
-/** Active overlay for interactive commands such as `/model` and `/session`. */
-export interface ActiveOverlay {
-  /** The Select component instance. */
-  select: SelectInstance;
-  /** Title displayed above the Select. */
-  title: string;
-}
-
-/**
- * Render the centered overlay modal for an active Select.
- *
- * @param theme - Active UI theme.
- * @param overlay - Overlay title and Select instance to render.
- * @returns The overlay node.
- */
-export function renderOverlay(theme: Theme, overlay: ActiveOverlay): Node {
-  const modalHeight = OVERLAY_MAX_VISIBLE + 3;
-
-  return VStack(
-    {
-      height: "100%",
-      justifyContent: "center",
-      padding: { x: OVERLAY_PADDING_X },
-    },
-    [
-      VStack(
-        {
-          height: modalHeight,
-          bgColor: theme.overlayBg,
-          padding: { x: 1 },
-        },
-        [
-          Text(overlay.title, {
-            bold: true,
-            fgColor: theme.accentText,
-          }),
-          overlay.select(),
-        ],
-      ),
-    ],
-  );
-}

package/src/ui/runtime.ts

@@ -1,69 +0,0 @@
-/**
- * Runtime-only helper bindings for the terminal UI.
- *
- * @module
- */
-
-import type { AppState } from "../index.ts";
-import {
-  appendConversationMessage,
-  appendMessage,
-  createUiMessage,
-  createUiTodoMessage,
-  type UiInfoFormat,
-  type UiMessage,
-} from "../session.ts";
-import type { TodoItem } from "../tools.ts";
-
-/** Render scheduling priorities used by the terminal UI. */
-export type UiRenderPriority = "immediate" | "normal" | "stream" | "animation";
-
-interface UiRuntimeHooks {
-  /** Schedule a UI render. */
-  requestRender: (priority?: UiRenderPriority) => void;
-  /** Re-enable stick-to-bottom behavior for the conversation log. */
-  scrollConversationToBottom: () => void;
-}
-
-interface UiRuntimeHelpers {
-  /** Append a UI-only info message to the conversation log. */
-  appendInfoMessage: (
-    text: string,
-    state: AppState,
-    format?: UiInfoFormat,
-  ) => void;
-  /** Append a UI-only todo snapshot to the conversation log. */
-  appendTodoMessage: (todos: readonly TodoItem[], state: AppState) => void;
-}
-
-function appendUiMessage(
-  message: UiMessage,
-  state: AppState,
-  runtime: UiRuntimeHooks,
-): void {
-  if (state.session) {
-    appendMessage(state.db, state.session.id, message);
-  }
-  appendConversationMessage(state, message);
-  runtime.scrollConversationToBottom();
-  runtime.requestRender("normal");
-}
-
-/**
- * Create runtime-bound helpers that append UI-only conversation messages.
- *
- * @param runtime - Render and scroll hooks owned by `ui.ts`.
- * @returns Helpers shared by the command and agent controllers.
- */
-export function createUiRuntimeHelpers(
-  runtime: UiRuntimeHooks,
-): UiRuntimeHelpers {
-  return {
-    appendInfoMessage: (text, state, format) => {
-      appendUiMessage(createUiMessage(text, format), state, runtime);
-    },
-    appendTodoMessage: (todos, state) => {
-      appendUiMessage(createUiTodoMessage(todos), state, runtime);
-    },
-  };
-}