mini-coder 0.5.9 → 0.5.11

package/README.md

@@ -103,7 +103,7 @@ $ printf '%s\n' 'fix the failing tests' | mc
 - Starts when `-p/--prompt` is provided or when stdin or stdout is not a TTY.
 - If stdout is redirected but stdin is still interactive, pass `-p`; headless mode will not fall back to an interactive prompt.
 - Uses the same parser as the TUI for plain text, `/skill:name`, and standalone image paths.
-- With `--json`, writes NDJSON events for completed assistant/tool-result messages plus `done` / `error` / `aborted` outcomes; streaming deltas are omitted.
+- With `--json`, writes NDJSON events for completed assistant/tool-result messages plus `done` / `error` / `aborted` outcomes; queued `user_message` events may also appear. Streaming deltas are omitted.
 - Headless runs still persist like normal sessions and show up in `/session` history for that working directory.
 - Interactive slash commands such as `/model`, `/session`, and `/help` are not available in headless mode.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mini-coder",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "description": "A small, fast CLI coding agent",
   "module": "src/index.ts",
   "type": "module",

package/src/agent.ts

@@ -623,6 +623,10 @@ function getTodoReminderSignature(
   );
 }
 
+function wrapSystemReminder(content: string): string {
+  return `<system_reminder>\n${content}\n</system_reminder>`;
+}
+
 function createTodoReminderMessage(
   messages: readonly Message[],
   remindedTodoSignatures: Set<string>,
@@ -651,7 +655,7 @@ function createTodoReminderMessage(
 
   return {
     role: "user",
-    content: lines.join("\n"),
+    content: wrapSystemReminder(lines.join("\n")),
     timestamp: Date.now(),
   };
 }

package/src/input.ts

@@ -17,7 +17,6 @@ import { extname, isAbsolute, join } from "node:path";
 
 /** All recognized slash commands. */
 export const COMMANDS = [
-  "model",
   "session",
   "new",
   "fork",
@@ -28,6 +27,7 @@ export const COMMANDS = [
   "login",
   "logout",
   "help",
+  "model",
   "effort",
 ] as const;
 

package/src/session.ts

@@ -95,6 +95,9 @@ interface AppendPromptHistoryOpts {
   sessionId?: string;
 }
 
+/** Rich-text format hints supported by persisted UI info messages. */
+export type UiInfoFormat = "markdown";
+
 /** A persisted UI-only info message shown in the conversation log. */
 export interface UiInfoMessage {
   /** Identifies this as an internal UI message. */
@@ -103,6 +106,8 @@ export interface UiInfoMessage {
   kind: "info";
   /** Display text shown in the conversation log. */
   content: string;
+  /** Optional rich-text format hint for the content. */
+  format?: UiInfoFormat;
   /** Unix timestamp in milliseconds. */
   timestamp: number;
 }
@@ -513,7 +518,10 @@ function isUiMessageRecord(value: unknown): value is UiMessage {
   }
 
   if (record.kind === "info") {
-    return typeof record.content === "string";
+    return (
+      typeof record.content === "string" &&
+      (record.format === undefined || record.format === "markdown")
+    );
   }
 
   return (
@@ -629,13 +637,18 @@ export function truncateSessions(
  * Create a persisted UI info message.
  *
  * @param content - Display text shown in the conversation log.
+ * @param format - Optional rich-text format hint for the content.
  * @returns A new {@link UiInfoMessage}.
  */
-export function createUiMessage(content: string): UiInfoMessage {
+export function createUiMessage(
+  content: string,
+  format?: UiInfoFormat,
+): UiInfoMessage {
   return {
     role: "ui",
     kind: "info",
     content,
+    ...(format ? { format } : {}),
     timestamp: Date.now(),
   };
 }

package/src/ui/commands.test.ts

@@ -2,40 +2,19 @@ import { afterEach, describe, expect, test } from "bun:test";
 import { mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import type { ContainerNode, Node } from "@cel-tui/types";
+import type { ContainerNode } from "@cel-tui/types";
 import { registerFauxProvider } from "@mariozechner/pi-ai";
 import type { AppState } from "../index.ts";
-import { COMMANDS } from "../input.ts";
 import {
-  appendPromptHistory,
   computeContextTokens,
   createSession,
   openDatabase,
 } from "../session.ts";
 import { loadSettings } from "../settings.ts";
 import { DEFAULT_THEME } from "../theme.ts";
-import {
-  createCommandController,
-  formatPromptHistoryLabel,
-  formatPromptHistoryPreview,
-  formatRelativeDate,
-  formatSessionLabel,
-} from "./commands.ts";
+import { createCommandController } from "./commands.ts";
 import type { ActiveOverlay } from "./overlay.ts";
 
-function collectText(node: Node | null): string[] {
-  if (!node) {
-    return [];
-  }
-  if (node.type === "text") {
-    return [node.content];
-  }
-  if (node.type === "textinput") {
-    return [];
-  }
-  return node.children.flatMap((child) => collectText(child));
-}
-
 function expectOverlay(overlay: ActiveOverlay | null): ActiveOverlay {
   if (!overlay) {
     throw new Error("Expected an active overlay");
@@ -107,200 +86,6 @@ afterEach(() => {
 });
 
 describe("ui/commands", () => {
-  test("showCommandAutocomplete clears the current draft and opens the commands overlay", () => {
-    const state = createTestState();
-    const runtimeState = { overlay: null as ActiveOverlay | null };
-    let inputValue = "draft";
-    const controller = createCommandController({
-      openOverlay: (nextOverlay) => {
-        runtimeState.overlay = nextOverlay;
-      },
-      dismissOverlay: () => {
-        runtimeState.overlay = null;
-      },
-      setInputValue: (value) => {
-        inputValue = value;
-      },
-      appendInfoMessage: () => {},
-      appendTodoMessage: () => {},
-      scrollConversationToBottom: () => {},
-      render: () => {},
-      reloadPromptContext: async () => {},
-      openInBrowser: () => {},
-    });
-
-    try {
-      controller.showCommandAutocomplete(state);
-
-      const overlay = expectOverlay(runtimeState.overlay);
-
-      expect(inputValue).toBe("");
-      expect(overlay.title).toBe("Commands");
-
-      const text = collectText(overlay.select());
-      for (const command of COMMANDS) {
-        expect(text.some((line) => line.includes(`/${command}`))).toBe(true);
-      }
-    } finally {
-      state.db.close();
-    }
-  });
-
-  test("showInputHistoryOverlay restores the selected raw prompt", () => {
-    const state = createTestState();
-    const runtimeState = { overlay: null as ActiveOverlay | null };
-    let inputValue = "draft";
-    const rawPrompt = "first line\nsecond line";
-    const controller = createCommandController({
-      openOverlay: (nextOverlay) => {
-        runtimeState.overlay = nextOverlay;
-      },
-      dismissOverlay: () => {
-        runtimeState.overlay = null;
-      },
-      setInputValue: (value) => {
-        inputValue = value;
-      },
-      appendInfoMessage: () => {},
-      appendTodoMessage: () => {},
-      scrollConversationToBottom: () => {},
-      render: () => {},
-      reloadPromptContext: async () => {},
-      openInBrowser: () => {},
-    });
-
-    try {
-      appendPromptHistory(state.db, {
-        text: "older prompt",
-        cwd: "/tmp/older",
-      });
-      appendPromptHistory(state.db, { text: rawPrompt, cwd: state.cwd });
-
-      controller.showInputHistoryOverlay(state);
-
-      const overlay = expectOverlay(runtimeState.overlay);
-
-      expect(overlay.title).toBe("Input history");
-
-      const selectNode = renderSelect(overlay);
-
-      selectNode.props.onKeyPress?.("enter");
-
-      expect(runtimeState.overlay).toBeNull();
-      expect(inputValue).toBe(rawPrompt);
-    } finally {
-      state.db.close();
-    }
-  });
-
-  test("showInputHistoryOverlay dismissal leaves the current draft unchanged", () => {
-    const state = createTestState();
-    const runtimeState = { overlay: null as ActiveOverlay | null };
-    let inputValue = "draft prompt";
-    const controller = createCommandController({
-      openOverlay: (nextOverlay) => {
-        runtimeState.overlay = nextOverlay;
-      },
-      dismissOverlay: () => {
-        runtimeState.overlay = null;
-      },
-      setInputValue: (value) => {
-        inputValue = value;
-      },
-      appendInfoMessage: () => {},
-      appendTodoMessage: () => {},
-      scrollConversationToBottom: () => {},
-      render: () => {},
-      reloadPromptContext: async () => {},
-      openInBrowser: () => {},
-    });
-
-    try {
-      appendPromptHistory(state.db, {
-        text: "saved prompt",
-        cwd: state.cwd,
-      });
-
-      controller.showInputHistoryOverlay(state);
-
-      const overlay = expectOverlay(runtimeState.overlay);
-      const selectNode = renderSelect(overlay);
-
-      selectNode.props.onBlur?.();
-
-      expect(runtimeState.overlay).toBeNull();
-      expect(inputValue).toBe("draft prompt");
-    } finally {
-      state.db.close();
-    }
-  });
-
-  test("handleCommand('session') overlay includes the first user preview for disambiguation", () => {
-    const state = createTestState();
-    const runtimeState = { overlay: null as ActiveOverlay | null };
-    const controller = createCommandController({
-      openOverlay: (nextOverlay) => {
-        runtimeState.overlay = nextOverlay;
-      },
-      dismissOverlay: () => {
-        runtimeState.overlay = null;
-      },
-      setInputValue: () => {},
-      appendInfoMessage: () => {},
-      appendTodoMessage: () => {},
-      scrollConversationToBottom: () => {},
-      render: () => {},
-      reloadPromptContext: async () => {},
-      openInBrowser: () => {},
-    });
-    const session = createSession(state.db, {
-      cwd: state.canonicalCwd,
-      model: "test/beta",
-      effort: "high",
-    });
-
-    state.db.run(
-      "INSERT INTO messages (session_id, turn, data, created_at) VALUES (?, ?, ?, ?)",
-      [
-        session.id,
-        null,
-        JSON.stringify({
-          role: "ui",
-          kind: "info",
-          content: "Help output",
-          timestamp: 1,
-        }),
-        1,
-      ],
-    );
-    state.db.run(
-      "INSERT INTO messages (session_id, turn, data, created_at) VALUES (?, ?, ?, ?)",
-      [
-        session.id,
-        1,
-        JSON.stringify({
-          role: "user",
-          content: "Investigate\nthis session label",
-          timestamp: 2,
-        }),
-        2,
-      ],
-    );
-
-    try {
-      expect(controller.handleCommand("session", state)).toBe(true);
-
-      const overlay = expectOverlay(runtimeState.overlay);
-      const text = collectText(renderSelect(overlay));
-
-      expect(
-        text.some((line) => line.includes("Investigate this session")),
-      ).toBe(true);
-    } finally {
-      state.db.close();
-    }
-  });
-
   test("handleCommand('session') restores the selected session and recomputes stats", () => {
     const state = createTestState();
     const runtimeState = { overlay: null as ActiveOverlay | null };
@@ -391,27 +176,6 @@ describe("ui/commands", () => {
     }
   });
 
-  test("handleCommand returns false for unknown commands", () => {
-    const state = createTestState();
-    const controller = createCommandController({
-      openOverlay: () => {},
-      dismissOverlay: () => {},
-      setInputValue: () => {},
-      appendInfoMessage: () => {},
-      appendTodoMessage: () => {},
-      scrollConversationToBottom: () => {},
-      render: () => {},
-      reloadPromptContext: async () => {},
-      openInBrowser: () => {},
-    });
-
-    try {
-      expect(controller.handleCommand("unknown", state)).toBe(false);
-    } finally {
-      state.db.close();
-    }
-  });
-
   test("/new clears the active session state and reloads prompt context", async () => {
     const state = createTestState();
     let reloadCount = 0;
@@ -520,6 +284,44 @@ describe("ui/commands", () => {
     }
   });
 
+  test("/help appends markdown help without creating a session", () => {
+    const state = createTestState();
+    const appended: Array<{
+      text: string;
+      format: string | undefined;
+      sessionId: string | null;
+    }> = [];
+    const controller = createCommandController({
+      openOverlay: () => {},
+      dismissOverlay: () => {},
+      setInputValue: () => {},
+      appendInfoMessage: (text, nextState, format) => {
+        appended.push({
+          text,
+          format,
+          sessionId: nextState.session?.id ?? null,
+        });
+      },
+      appendTodoMessage: () => {},
+      scrollConversationToBottom: () => {},
+      render: () => {},
+      reloadPromptContext: async () => {},
+      openInBrowser: () => {},
+    });
+
+    try {
+      expect(controller.handleCommand("help", state)).toBe(true);
+      expect(appended).toHaveLength(1);
+      expect(appended[0]?.text).toContain("# Help");
+      expect(appended[0]?.text).toContain("## Commands");
+      expect(appended[0]?.format).toBe("markdown");
+      expect(appended[0]?.sessionId).toBeNull();
+      expect(state.session).toBeNull();
+    } finally {
+      state.db.close();
+    }
+  });
+
   test("/todo appends the current todo list without creating a session", () => {
     const state = createTestState();
     state.messages = [
@@ -636,55 +438,4 @@ describe("ui/commands", () => {
       state.db.close();
     }
   });
-
-  test("formatRelativeDate accepts an explicit clock for deterministic output", () => {
-    const now = new Date("2026-04-07T12:00:00Z");
-
-    expect(formatRelativeDate(new Date("2026-04-07T11:59:45Z"), now)).toBe(
-      "just now",
-    );
-    expect(formatRelativeDate(new Date("2026-04-07T11:50:00Z"), now)).toBe(
-      "10m ago",
-    );
-    expect(formatRelativeDate(new Date("2026-04-07T10:00:00Z"), now)).toBe(
-      "2h ago",
-    );
-    expect(formatRelativeDate(new Date("2026-04-04T12:00:00Z"), now)).toBe(
-      "3d ago",
-    );
-  });
-
-  test("formatPromptHistoryPreview collapses whitespace into one line", () => {
-    expect(formatPromptHistoryPreview("  first\n\n second\tthird  ")).toBe(
-      "first second third",
-    );
-  });
-
-  test("formatPromptHistoryLabel_longPromptAndCwd_returnsATruncatedSingleLineLabel", () => {
-    expect(
-      formatPromptHistoryLabel(
-        "  Investigate\n\n this prompt history row because it is much too wide for the overlay  ",
-        "/tmp/projects/very/deeply/nested/mini-coder-audit",
-        "5m ago",
-      ),
-    ).toBe(
-      "Investigate this prompt history…  ·  …/mini-coder-audit  ·  5m ago",
-    );
-  });
-
-  test("formatSessionLabel_longPreviewAndModel_returnsATruncatedReadableLabel", () => {
-    expect(
-      formatSessionLabel(
-        {
-          model: "openai-codex/gpt-5.4-super-long-variant",
-          firstUserPreview:
-            "Audit the session selector because every entry looks identical in real usage",
-        },
-        "just now",
-        true,
-      ),
-    ).toBe(
-      "Audit the session selector…  ·  openai-codex/gpt…  ·  just now  ·  current",
-    );
-  });
 });

package/src/ui/commands.ts

@@ -26,6 +26,7 @@ import {
   listSessions,
   loadMessages,
   type SessionListEntry,
+  type UiInfoFormat,
   undoLastTurn,
 } from "../session.ts";
 import { updateSettings } from "../settings.ts";
@@ -51,7 +52,11 @@ interface UiCommandRuntime {
   /** Update the current input draft. */
   setInputValue: (value: string) => void;
   /** Append a UI-only info message to the conversation log. */
-  appendInfoMessage: (text: string, state: AppState) => void;
+  appendInfoMessage: (
+    text: string,
+    state: AppState,
+    format?: UiInfoFormat,
+  ) => void;
   /** Append a UI-only todo snapshot to the conversation log. */
   appendTodoMessage: (
     todos: ReturnType<typeof getTodoItems>,
@@ -583,7 +588,7 @@ export function createCommandController(
   };
 
   const handleHelpCommand = (state: AppState): void => {
-    runtime.appendInfoMessage(buildHelpText(state), state);
+    runtime.appendInfoMessage(buildHelpText(state), state, "markdown");
   };
 
   const handleTodoCommand = (state: AppState): void => {

package/src/ui/conversation.ts

@@ -1161,14 +1161,28 @@ function renderUiTodoMessage(
 }
 
 /** Render an internal UI message in the conversation log. */
-function renderUiMessage(msg: UiMessage, theme: Theme): Node {
+function renderUiMessage(
+  msg: UiMessage,
+  opts: Pick<ConversationRenderOpts, "previewWidth" | "theme">,
+): Node {
   if (msg.kind === "todo") {
-    return renderUiTodoMessage(msg, theme);
+    return renderUiTodoMessage(msg, opts.theme);
+  }
+
+  if (msg.format === "markdown") {
+    const markdown = renderMarkdownTextBlock(
+      msg.content,
+      opts.theme,
+      opts.previewWidth,
+    );
+    if (markdown) {
+      return markdown;
+    }
   }
 
   return VStack({ padding: { x: 1 } }, [
     Text(msg.content, {
-      fgColor: theme.mutedText,
+      fgColor: opts.theme.mutedText,
       italic: true,
       wrap: "word",
     }),
@@ -1231,7 +1245,7 @@ function renderConversationMessage(
   theme: Theme,
 ): Node | null {
   if (message.role === "ui") {
-    return renderUiMessage(message, theme);
+    return renderUiMessage(message, renderOpts);
   }
   if (message.role === "user") {
     return renderUserMessage(message, theme);

package/src/ui/help.ts

@@ -47,7 +47,7 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
  *
  * @param command - Command name.
  * @param state - Help-relevant application state.
- * @returns Human-readable command description.
+ * @returns Markdown-ready command description.
  */
 function getHelpCommandDescription(
   command: (typeof COMMANDS)[number],
@@ -55,72 +55,86 @@ function getHelpCommandDescription(
 ): string {
   const description = COMMAND_DESCRIPTIONS[command] ?? "";
   if (command === "reasoning") {
-    return `${description} (currently ${state.showReasoning ? "on" : "off"})`;
+    return `${description} _(currently ${state.showReasoning ? "on" : "off"})_`;
   }
   if (command === "verbose") {
-    return `${description} (currently ${state.verbose ? "on" : "off"})`;
+    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(", ");
+}
+
 /**
  * Build the `/help` text shown in the conversation log.
  *
  * @param state - Help-relevant application state.
- * @returns Multi-line help text for display.
+ * @returns Multi-line markdown help text for display.
  */
 export function buildHelpText(state: HelpRenderState): string {
-  const lines: string[] = [];
+  const lines: string[] = ["# Help", "", "## Commands", ""];
 
-  lines.push("Commands:");
   for (const command of COMMANDS) {
-    lines.push(`  /${command}  ${getHelpCommandDescription(command, state)}`);
+    lines.push(
+      `- ${formatInlineCode(`/${command}`)} — ${getHelpCommandDescription(command, state)}`,
+    );
   }
 
   const providerNames = Array.from(state.providers.keys());
-  lines.push("");
-  lines.push("Note:");
-  lines.push(
-    "  Escape closes the current overlay and returns focus to the input.",
-  );
-  lines.push("  With no overlay open, Escape interrupts the current turn.");
-  lines.push("  Otherwise Escape does nothing.");
-
-  lines.push("");
   lines.push(
+    "",
+    "## Keyboard",
+    "",
+    "- `Enter` submits the current draft.",
+    "- `Shift+Enter` inserts a newline.",
+    "- `Tab` opens command autocomplete when the draft starts with `/`.",
+    "- 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: ${providerNames.join(", ")}`
-      : "Providers: none (use /login)",
-  );
-
-  lines.push(
+      ? `- Providers: ${formatInlineCodeList(providerNames)}`
+      : "- Providers: none — use `/login`",
     state.model
-      ? `Model: ${state.model.provider}/${state.model.id}`
-      : "Model: none (use /model)",
+      ? `- Model: ${formatInlineCode(`${state.model.provider}/${state.model.id}`)}`
+      : "- Model: none — use `/model`",
   );
 
   if (state.agentsMd.length > 0) {
-    lines.push("");
-    lines.push("AGENTS.md files:");
+    lines.push("", "## Loaded `AGENTS.md` files", "");
     for (const agentFile of state.agentsMd) {
-      lines.push(`  ${abbreviatePath(agentFile.path)}`);
+      lines.push(`- ${formatInlineCode(abbreviatePath(agentFile.path))}`);
     }
   }
 
   if (state.skills.length > 0) {
-    lines.push("");
-    lines.push("Skills:");
+    lines.push("", "## Skills", "");
     for (const skill of state.skills) {
-      const description = skill.description ? `  ${skill.description}` : "";
-      lines.push(`  ${skill.name}${description}`);
+      lines.push(
+        skill.description
+          ? `- ${formatInlineCode(skill.name)} — ${skill.description}`
+          : `- ${formatInlineCode(skill.name)}`,
+      );
     }
   }
 
   if (state.plugins.length > 0) {
-    lines.push("");
-    lines.push("Plugins:");
+    lines.push("", "## Plugins", "");
     for (const plugin of state.plugins) {
-      lines.push(`  ${plugin.entry.name}`);
+      lines.push(`- ${formatInlineCode(plugin.entry.name)}`);
     }
   }