@ouro.bot/cli 0.1.0-alpha.178 → 0.1.0-alpha.179

package/changelog.json

@@ -1,6 +1,16 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.179",
+      "changes": [
+        "feat(cli): generous vertical whitespace between TUI sections",
+        "feat(cli): image placeholder rendering (\ud83d\uddbc) for markdown images",
+        "feat(cli): Alt+Enter multi-line input with continuation prefix",
+        "feat(cli): terminal width safety (cap at 200, subtract margin)",
+        "fix(cli): settle/ponder/observe/rest fully hidden from imperative tool display"
+      ]
+    },
     {
       "version": "0.1.0-alpha.178",
       "changes": [

package/dist/senses/cli/ouro-tui.js

@@ -40,30 +40,27 @@ function ringColor(elapsedSec) {
     return OURO.scale;
 }
 // ─── Header ─────────────────────────────────────────────────────────
+/** Safe terminal width: capped at 200, with 2-char margin */
+function safeWidth() {
+    return Math.min(process.stdout.columns || 80, 200) - 2;
+}
 function Header({ agentName, model, contextPercent, cwd }) {
     const showCtx = contextPercent > 0;
     const info = [agentName, model, cwd, showCtx ? `ctx ${contextPercent}%` : ""].filter(Boolean).join(" · ");
     // 3-segment snake: TAIL (fixed) + MIDDLE (stretches) + HEAD (fixed)
-    // From the reference art, segments split at the dots:
-    //
-    //    .                  .     ____
-    //  __.__________________.____/ O  \___/
-    // <__.__________________._________/   \
-    //
-    // TAIL:     line1=""     line2=" __"   line3="<__"
-    // MIDDLE:   line1=" "    line2="_"     line3="_" (or text)
-    // HEAD:     line1="     ____"  line2="____/ O  \\___/"  line3="_________/   \\"
     const HEAD1 = "     ____";
     const HEAD2 = "____/ O  \\___/";
     const HEAD3 = "_________/   \\";
     const TAIL1 = "   ";
     const TAIL2 = " __";
     const TAIL3 = "<__";
-    const middleLen = Math.max(info.length, 20);
-    const textPad = middleLen - info.length;
+    const fixedWidth = TAIL1.length + HEAD1.length;
+    const maxMiddle = safeWidth() - fixedWidth;
+    const middleLen = Math.max(Math.min(Math.max(info.length, 20), maxMiddle), 10);
+    const textPad = Math.max(middleLen - info.length, 0);
     const line1 = TAIL1 + " ".repeat(middleLen) + HEAD1;
     const line2 = TAIL2 + "_".repeat(middleLen) + HEAD2;
-    const line3text = info + "_".repeat(textPad);
+    const line3text = (info.length > middleLen ? info.slice(0, middleLen) : info) + "_".repeat(textPad);
     return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.scale, children: line1 }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.scale, children: line2 }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { color: OURO.scale, children: [TAIL3, (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.glow, children: line3text }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.scale, children: HEAD3 })] })] }));
 }
 // ─── Message Rendering ──────────────────────────────────────────────
@@ -78,17 +75,18 @@ function ToolResultLine({ tc }) {
 function MessageBlock({ msg }) {
     if (msg.role === "tool") {
         const visibleCalls = msg.toolCalls?.filter(tc => !FLOW_CONTROL_TOOLS.has(tc.name));
+        // Flow control tools produce no visible output at all
         if (!visibleCalls || visibleCalls.length === 0)
-            return (0, jsx_runtime_1.jsx)(ink_1.Box, { height: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " }) });
+            return (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" });
         return ((0, jsx_runtime_1.jsx)(ink_1.Box, { flexDirection: "column", children: visibleCalls.map((tc, i) => (0, jsx_runtime_1.jsx)(ToolResultLine, { tc: tc }, i)) }));
     }
     if (msg.role === "user") {
-        return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", marginTop: 1, children: [msg.content ? (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.bone, bold: true, children: msg.content }) : null, (0, jsx_runtime_1.jsx)(ink_1.Box, { height: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " }) })] }));
+        return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", marginTop: 1, children: [msg.content ? (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.bone, bold: true, children: msg.content }) : null, (0, jsx_runtime_1.jsx)(ink_1.Box, { marginBottom: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" }) })] }));
     }
     if (msg.role === "assistant") {
-        return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [msg.content ? (0, jsx_runtime_1.jsx)(streaming_markdown_1.StreamingMarkdown, { text: msg.content }) : null, (0, jsx_runtime_1.jsx)(ink_1.Box, { height: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " }) })] }));
+        return ((0, jsx_runtime_1.jsx)(ink_1.Box, { flexDirection: "column", marginBottom: 1, children: msg.content ? (0, jsx_runtime_1.jsx)(streaming_markdown_1.StreamingMarkdown, { text: msg.content, maxWidth: safeWidth() }) : null }));
     }
-    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", marginTop: 1, children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.shadow, children: msg.content }), (0, jsx_runtime_1.jsx)(ink_1.Box, { height: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " }) })] }));
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", marginTop: 1, children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.shadow, children: msg.content }), (0, jsx_runtime_1.jsx)(ink_1.Box, { marginBottom: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" }) })] }));
 }
 // ─── Live Area (re-renders) ─────────────────────────────────────────
 function Spinner({ phrasePool, elapsed }) {
@@ -136,12 +134,12 @@ function formatActiveToolArgs(name, args) {
 function ActiveToolLine({ tool }) {
     // Hide flow control tools from in-progress display
     if (FLOW_CONTROL_TOOLS.has(tool.name))
-        return (0, jsx_runtime_1.jsx)(ink_1.Box, { height: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " }) });
+        return (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" });
     const argStr = formatActiveToolArgs(tool.name, tool.args);
     return ((0, jsx_runtime_1.jsxs)(ink_1.Text, { children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.shadow, children: "∙" }), " ", (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.teal, children: tool.name }), " ", (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.shadow, children: argStr })] }));
 }
 function LiveArea({ live, elapsed }) {
-    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [live.streamingText ? ((0, jsx_runtime_1.jsx)(streaming_markdown_1.StreamingMarkdown, { text: live.streamingText })) : null, live.activeTool ? ((0, jsx_runtime_1.jsx)(ActiveToolLine, { tool: live.activeTool })) : null, live.loading ? ((0, jsx_runtime_1.jsx)(Spinner, { phrasePool: live.spinnerPhrasePool, elapsed: elapsed })) : null, live.errorMessage ? ((0, jsx_runtime_1.jsxs)(ink_1.Text, { color: OURO.fang, children: ["✗ ", live.errorMessage] })) : null, live.kickMessage ? ((0, jsx_runtime_1.jsxs)(ink_1.Text, { color: OURO.gold, children: ["↻ ", live.kickMessage] })) : null] }));
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [live.streamingText ? ((0, jsx_runtime_1.jsx)(streaming_markdown_1.StreamingMarkdown, { text: live.streamingText, maxWidth: safeWidth() })) : null, live.activeTool ? ((0, jsx_runtime_1.jsx)(ActiveToolLine, { tool: live.activeTool })) : null, live.loading ? ((0, jsx_runtime_1.jsx)(Spinner, { phrasePool: live.spinnerPhrasePool, elapsed: elapsed })) : null, live.errorMessage ? ((0, jsx_runtime_1.jsxs)(ink_1.Text, { color: OURO.fang, children: ["✗ ", live.errorMessage] })) : null, live.kickMessage ? ((0, jsx_runtime_1.jsxs)(ink_1.Text, { color: OURO.gold, children: ["↻ ", live.kickMessage] })) : null] }));
 }
 // ─── Input ──────────────────────────────────────────────────────────
 function InputArea({ onSubmit, suppressed, onCtrlC, agentName, model, history }) {
@@ -194,6 +192,12 @@ function InputArea({ onSubmit, suppressed, onCtrlC, agentName, model, history })
             return;
         }
         if (key.return) {
+            // Alt+Enter: insert newline instead of submitting
+            if (key.meta) {
+                inputRef.current += "\n";
+                setInput(inputRef.current);
+                return;
+            }
             const text = inputRef.current;
             if (text.trim())
                 onSubmit(text);
@@ -245,19 +249,21 @@ function InputArea({ onSubmit, suppressed, onCtrlC, agentName, model, history })
         }
     });
     // Get terminal width (capped for sanity)
-    const cols = Math.min(process.stdout.columns || 80, 200);
+    const cols = safeWidth();
     if (suppressed) {
         // During model generation: show status bar but no input
         return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: "─".repeat(cols) }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { dimColor: true, children: [agentName, model ? ` · ${model}` : ""] }), (0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: "─".repeat(cols) })] }));
     }
-    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: "─".repeat(cols) }), (0, jsx_runtime_1.jsxs)(ink_1.Box, { children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.teal, bold: true, children: ") " }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.bone, children: input }), cursorVisible ? (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.scale, children: "█" }) : (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " })] }), (0, jsx_runtime_1.jsxs)(ink_1.Box, { children: [(0, jsx_runtime_1.jsxs)(ink_1.Text, { dimColor: true, children: [agentName, model ? ` · ${model}` : ""] }), (0, jsx_runtime_1.jsx)(ink_1.Box, { flexGrow: 1 }), tooltip ? (0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: tooltip }) : null] }), (0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: "─".repeat(cols) })] }));
+    const isMultiline = input.includes("\n");
+    const inputLines = input.split("\n");
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: "─".repeat(cols) }), isMultiline ? ((0, jsx_runtime_1.jsx)(ink_1.Box, { flexDirection: "column", children: inputLines.map((line, i) => ((0, jsx_runtime_1.jsxs)(ink_1.Box, { children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.teal, bold: true, children: i === 0 ? ") " : "· " }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.bone, children: line }), i === inputLines.length - 1 ? (cursorVisible ? (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.scale, children: "█" }) : (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " })) : null] }, i))) })) : ((0, jsx_runtime_1.jsxs)(ink_1.Box, { children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.teal, bold: true, children: ") " }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.bone, children: input }), cursorVisible ? (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.scale, children: "█" }) : (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " })] })), (0, jsx_runtime_1.jsxs)(ink_1.Box, { children: [(0, jsx_runtime_1.jsxs)(ink_1.Text, { dimColor: true, children: [agentName, model ? ` · ${model}` : ""] }), (0, jsx_runtime_1.jsx)(ink_1.Box, { flexGrow: 1 }), tooltip ? (0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: tooltip }) : null, isMultiline ? (0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: " (multi-line)" }) : null] }), (0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: "─".repeat(cols) })] }));
 }
 // ─── Main TUI Component ─────────────────────────────────────────────
 function OuroTui({ agentName, model, completedMessages, inputHistory, live, elapsedSeconds, contextPercent, onSubmit, onCtrlC, cwd, }) {
     return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Static, { items: [{ id: "__header__" }, ...completedMessages], children: (item, index) => {
                     if (index === 0) {
-                        return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " }), (0, jsx_runtime_1.jsx)(Header, { agentName: agentName, model: model, contextPercent: contextPercent, cwd: cwd }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.shadow, children: "  Press Ctrl-C twice to exit \u00b7 \u2191\u2193 history \u00b7 Esc clear" }), (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " })] }, "header"));
+                        return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", marginBottom: 2, children: [(0, jsx_runtime_1.jsx)(ink_1.Box, { marginTop: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" }) }), (0, jsx_runtime_1.jsx)(Header, { agentName: agentName, model: model, contextPercent: contextPercent, cwd: cwd }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO.shadow, dimColor: true, children: "  Ctrl-C twice to exit \u00b7 \u2191\u2193 history \u00b7 Esc clear \u00b7 Alt+Enter newline" })] }, "header"));
                     }
                     return (0, jsx_runtime_1.jsx)(MessageBlock, { msg: item }, item.id);
-                } }), (live.loading || live.streamingText || live.activeTool) ? (0, jsx_runtime_1.jsx)(ink_1.Box, { height: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " }) }) : null, (0, jsx_runtime_1.jsx)(LiveArea, { live: live, elapsed: elapsedSeconds }), (live.loading || live.streamingText || live.activeTool) ? (0, jsx_runtime_1.jsx)(ink_1.Box, { height: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: " " }) }) : null, (0, jsx_runtime_1.jsx)(InputArea, { onSubmit: onSubmit, suppressed: live.inputSuppressed, onCtrlC: onCtrlC, agentName: agentName, model: model, history: inputHistory })] }));
+                } }), (live.loading || live.streamingText || live.activeTool) ? (0, jsx_runtime_1.jsx)(ink_1.Box, { marginTop: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" }) }) : null, (0, jsx_runtime_1.jsx)(LiveArea, { live: live, elapsed: elapsedSeconds }), (live.loading || live.streamingText || live.activeTool) ? (0, jsx_runtime_1.jsx)(ink_1.Box, { marginBottom: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" }) }) : null, (0, jsx_runtime_1.jsx)(ink_1.Box, { marginTop: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" }) }), (0, jsx_runtime_1.jsx)(InputArea, { onSubmit: onSubmit, suppressed: live.inputSuppressed, onCtrlC: onCtrlC, agentName: agentName, model: model, history: inputHistory })] }));
 }

package/dist/senses/cli/streaming-markdown.js

@@ -213,7 +213,21 @@ function parseInline(text) {
         placeholders.push({ idx, segment: { text: restoreEscapes(code, escapes), code: true } });
         return `\x00PH${idx}\x00`;
     });
-    // Step 3: extract links [text](url)
+    // Step 3a: extract image references ![alt](url) -> placeholder
+    processed = processed.replace(/!\[([^\]]*)\]\(([^)]*)\)/g, (_m, alt, _url) => {
+        const idx = placeholders.length;
+        const label = alt ? `\ud83d\uddbc ${restoreEscapes(alt, escapes)}` : "\ud83d\uddbc image";
+        placeholders.push({ idx, segment: { text: label, image: true } });
+        return `\x00PH${idx}\x00`;
+    });
+    // Step 3b: extract [Image: ...] references
+    processed = processed.replace(/\[Image:\s*([^\]]*)\]/gi, (_m, desc) => {
+        const idx = placeholders.length;
+        const label = desc.trim() ? `\ud83d\uddbc ${restoreEscapes(desc.trim(), escapes)}` : "\ud83d\uddbc image";
+        placeholders.push({ idx, segment: { text: label, image: true } });
+        return `\x00PH${idx}\x00`;
+    });
+    // Step 3c: extract links [text](url)
     processed = processed.replace(/\[([^\]]*)\]\(([^)]*)\)/g, (_m, linkText, url) => {
         const idx = placeholders.length;
         const restoredText = restoreEscapes(linkText, escapes);
@@ -364,6 +378,9 @@ function wrapText(text, maxWidth) {
 }
 // ─── Segment Renderer ──────────────────────────────────────────────
 function SegmentRenderer({ segment }) {
+    if (segment.image) {
+        return (0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: segment.text });
+    }
     if (segment.codeBlock) {
         return (0, jsx_runtime_1.jsx)(ink_1.Text, { dimColor: true, children: segment.text });
     }

package/dist/senses/cli/tool-display.js

@@ -13,6 +13,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeToolStart = writeToolStart;
 exports.writeToolEnd = writeToolEnd;
 const runtime_1 = require("../../nerves/runtime");
+// Flow control tools are invisible to the user — internal agent mechanics
+const FLOW_CONTROL_TOOLS = new Set(["settle", "ponder", "observe", "rest"]);
 // Ouroboros teal: #4ec9b0 -> RGB escape
 const OURO_TEAL = "\x1b[38;2;78;201;176m";
 const GREEN = "\x1b[32m";
@@ -56,6 +58,8 @@ function getPrimaryArg(name, args) {
  * Shows: [teal tool name] [dim primary arg]
  */
 function writeToolStart(name, args) {
+    if (FLOW_CONTROL_TOOLS.has(name))
+        return;
     const primary = getPrimaryArg(name, args);
     const argDisplay = primary ? ` ${DIM}${primary}${RESET}` : "";
     process.stderr.write(`\r\x1b[K${OURO_TEAL}${BOLD}${name}${RESET}${argDisplay}\n`);
@@ -65,6 +69,8 @@ function writeToolStart(name, args) {
  * Shows: [green check / red cross] [teal tool name] [dim summary]
  */
 function writeToolEnd(name, argSummary, success) {
+    if (FLOW_CONTROL_TOOLS.has(name))
+        return;
     const icon = success ? `${GREEN}\u2713` : `${RED}\u2717`;
     const summary = argSummary ? ` ${DIM}${truncate(argSummary, 100)}${RESET}` : "";
     process.stderr.write(`${icon}${RESET} ${OURO_TEAL}${name}${RESET}${summary}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.178",
+  "version": "0.1.0-alpha.179",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",