@crouton-kit/humanloop 0.3.25 → 0.3.27

package/dist/tui/render.js

@@ -119,11 +119,6 @@ function buildItemReviewLayout(state, cols, rows) {
     for (const line of wrap(sanitize(interaction.title), maxW)) {
         preLines.push(`  ${BOLD}${line}${RESET}`);
     }
-    if (interaction.subtitle) {
-        for (const line of wrap(sanitize(interaction.subtitle), maxW)) {
-            preLines.push(`  ${DIM}${line}${RESET}`);
-        }
-    }
     // "Previously answered" marker — shown only while the seed is intact (no user
     // override yet). The label comes from preAnswered.label so callers can be
     // domain-specific ("Previously approved", "Carried over from prior pass").
@@ -134,8 +129,17 @@ function buildItemReviewLayout(state, cols, rows) {
             : 'Previously answered';
         preLines.push(`  ${DIM}${ITALIC}◆ ${sanitize(label)} — press n/p to review, or any option to override${RESET}`);
     }
-    // Body: rendered question body + expanded visual block (scrollable)
+    // Body: rendered subtitle + question body + expanded visual block (scrollable).
+    // subtitle and body are both directive-flavored markdown rendered by termrender
+    // and live in the scrollable region so long content never overflows the fixed
+    // header — agents put rich prose in either field, so both must render markdown.
     const bodyLines = [];
+    if (interaction.subtitle) {
+        bodyLines.push('');
+        for (const line of renderMarkdown(interaction.subtitle, maxW)) {
+            bodyLines.push(`  ${line}`);
+        }
+    }
     if (interaction.body) {
         bodyLines.push('');
         for (const line of renderMarkdown(interaction.body, maxW)) {

package/dist/types.d.ts

@@ -28,8 +28,14 @@ export interface InteractionPreAnswer {
 }
 export interface Interaction {
     id: string;
+    /** Short topic — the thing being decided, not the decision. */
     title: string;
+    /** ONE-sentence TL;DR of the choice/stakes. Renders as markdown in the
+     *  scrollable region; keep it a single line — long prose belongs in `body`. */
     subtitle?: string;
+    /** The full explanation: directive-flavored markdown rendered by termrender.
+     *  This is where long or rich content goes (never the wall of detail in
+     *  `subtitle`). `bodyPath` is the same content sourced from a file. */
     body?: string;
     bodyPath?: string;
     options: InteractionOption[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/humanloop",
-  "version": "0.3.25",
+  "version": "0.3.27",
   "description": "Human-in-the-loop decision TUI — agents write questions, humans answer them",
   "type": "module",
   "main": "dist/index.js",