mini-coder 0.5.9 → 0.5.10

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.10",
   "description": "A small, fast CLI coding agent",
   "module": "src/index.ts",
   "type": "module",

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

@@ -520,6 +520,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 = [

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.test.ts

@@ -1372,6 +1372,57 @@ describe("ui/conversation", () => {
     expect(text.some((line) => line.startsWith("And "))).toBe(false);
   });
 
+  test("buildConversationLogNodes syntax-highlights markdown-formatted UI info messages", async () => {
+    const theme = {
+      ...DEFAULT_THEME,
+      accentText: "color14",
+      secondaryAccentText: "color09",
+      diffAdded: "color10",
+    } satisfies typeof DEFAULT_THEME;
+    const state = {
+      messages: [
+        {
+          role: "ui" as const,
+          kind: "info" as const,
+          format: "markdown" as const,
+          content: "# Help\n\n## Commands\n\n- `/model` — Select a model",
+          timestamp: 1,
+        },
+      ],
+      showReasoning: false,
+      verbose: false,
+      theme,
+    };
+
+    const rows = await renderBufferRows(
+      VStack(
+        {},
+        buildConversationLogNodes(
+          state,
+          { isStreaming: false, content: [], pendingToolResults: [] },
+          0,
+          PREVIEW_WIDTH,
+        ),
+      ),
+      PREVIEW_WIDTH,
+      24,
+    );
+    const headingRow = rows.find((row) => row.text.includes("# Help"));
+    const bulletRow = rows.find((row) => row.text.includes("- `/model`"));
+
+    expect(headingRow).toBeDefined();
+    expect(bulletRow).toBeDefined();
+    expect(headingRow?.fgColors[headingRow.text.indexOf("#")]).toBe(
+      theme.accentText ?? null,
+    );
+    expect(bulletRow?.fgColors[bulletRow.text.indexOf("-")]).toBe(
+      theme.secondaryAccentText ?? null,
+    );
+    expect(bulletRow?.fgColors[bulletRow.text.indexOf("`")]).toBe(
+      theme.diffAdded ?? null,
+    );
+  });
+
   test("buildConversationLogNodes renders UI todo messages with the shared checklist block", async () => {
     const state = {
       messages: [

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.test.ts

@@ -3,7 +3,7 @@ import { DEFAULT_SHOW_REASONING } from "../settings.ts";
 import { buildHelpText, type HelpRenderState } from "./help.ts";
 
 describe("ui/help", () => {
-  test("buildHelpText includes current reasoning and verbose state", () => {
+  test("buildHelpText formats commands as markdown list items with current state", () => {
     const helpState: HelpRenderState = {
       providers: new Map(),
       model: null,
@@ -16,16 +16,18 @@ describe("ui/help", () => {
 
     const text = buildHelpText(helpState);
 
+    expect(text).toContain("# Help");
+    expect(text).toContain("## Commands");
     expect(text).toContain(
-      `/reasoning  Toggle thinking display (currently ${DEFAULT_SHOW_REASONING ? "on" : "off"})`,
+      `- \`/reasoning\` — Toggle thinking display _(currently ${DEFAULT_SHOW_REASONING ? "on" : "off"})_`,
     );
     expect(text).toContain(
-      "/verbose  Toggle verbose tool rendering (currently off)",
+      "- `/verbose` — Toggle verbose tool rendering _(currently off)_",
     );
-    expect(text).toContain("/todo  Show the current todo list");
+    expect(text).toContain("- `/todo` — Show the current todo list");
   });
 
-  test("buildHelpText describes the current Escape behavior", () => {
+  test("buildHelpText lists the supported keyboard shortcuts in markdown", () => {
     const helpState: HelpRenderState = {
       providers: new Map(),
       model: null,
@@ -38,13 +40,26 @@ describe("ui/help", () => {
 
     const text = buildHelpText(helpState);
 
+    expect(text).toContain("## Keyboard");
+    expect(text).toContain("- `Enter` submits the current draft.");
+    expect(text).toContain("- `Shift+Enter` inserts a newline.");
     expect(text).toContain(
-      "Escape closes the current overlay and returns focus to the input",
+      "- `Tab` opens command autocomplete when the draft starts with `/`.",
     );
     expect(text).toContain(
-      "With no overlay open, Escape interrupts the current turn",
+      "- Otherwise, `Tab` autocompletes file paths and can open a path picker when there are multiple matches.",
     );
-    expect(text).toContain("Otherwise Escape does nothing");
+    expect(text).toContain("- `Ctrl+R` opens global input history search.");
+    expect(text).toContain(
+      "- `Escape` closes the current overlay and returns focus to the input.",
+    );
+    expect(text).toContain(
+      "- With no overlay open, `Escape` interrupts the current turn.",
+    );
+    expect(text).toContain("- Otherwise, `Escape` does nothing.");
+    expect(text).toContain("- `Ctrl+C` exits gracefully.");
+    expect(text).toContain("- `Ctrl+D` exits when the input is empty.");
+    expect(text).toContain("- `Ctrl+Z` suspends the app to the background.");
     expect(text).not.toContain("Escape blurs the input first");
   });
 });

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)}`);
     }
   }
 

package/src/ui.ts

@@ -26,6 +26,7 @@ import {
   appendMessage,
   createUiMessage,
   createUiTodoMessage,
+  type UiInfoFormat,
 } from "./session.ts";
 import type { Theme } from "./theme.ts";
 import {
@@ -660,9 +661,14 @@ function appendUiMessage(
  *
  * @param text - Display text to append.
  * @param state - Application state.
+ * @param format - Optional rich-text format hint for the content.
  */
-function appendInfoMessage(text: string, state: AppState): void {
-  appendUiMessage(createUiMessage(text), state);
+function appendInfoMessage(
+  text: string,
+  state: AppState,
+  format?: UiInfoFormat,
+): void {
+  appendUiMessage(createUiMessage(text, format), state);
 }
 
 /**