@ouro.bot/cli 0.1.0-alpha.26 → 0.1.0-alpha.260

package/dist/senses/bluebubbles/runtime-state.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBlueBubblesRuntimeStatePath = getBlueBubblesRuntimeStatePath;
+exports.readBlueBubblesRuntimeState = readBlueBubblesRuntimeState;
+exports.writeBlueBubblesRuntimeState = writeBlueBubblesRuntimeState;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const identity_1 = require("../../heart/identity");
+const runtime_1 = require("../../nerves/runtime");
+const DEFAULT_RUNTIME_STATE = {
+    upstreamStatus: "unknown",
+    detail: "startup health probe pending",
+    pendingRecoveryCount: 0,
+};
+function getBlueBubblesRuntimeStatePath(agentName, agentRoot = (0, identity_1.getAgentRoot)(agentName)) {
+    return path.join(agentRoot, "state", "senses", "bluebubbles", "runtime.json");
+}
+function readBlueBubblesRuntimeState(agentName, agentRoot) {
+    const filePath = getBlueBubblesRuntimeStatePath(agentName, agentRoot);
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return {
+            upstreamStatus: parsed.upstreamStatus === "ok" || parsed.upstreamStatus === "error"
+                ? parsed.upstreamStatus
+                : "unknown",
+            detail: typeof parsed.detail === "string" && parsed.detail.trim()
+                ? parsed.detail
+                : DEFAULT_RUNTIME_STATE.detail,
+            lastCheckedAt: typeof parsed.lastCheckedAt === "string" ? parsed.lastCheckedAt : undefined,
+            pendingRecoveryCount: typeof parsed.pendingRecoveryCount === "number" && Number.isFinite(parsed.pendingRecoveryCount)
+                ? parsed.pendingRecoveryCount
+                : 0,
+            lastRecoveredAt: typeof parsed.lastRecoveredAt === "string" ? parsed.lastRecoveredAt : undefined,
+            lastRecoveredMessageGuid: typeof parsed.lastRecoveredMessageGuid === "string"
+                ? parsed.lastRecoveredMessageGuid
+                : undefined,
+        };
+    }
+    catch {
+        return { ...DEFAULT_RUNTIME_STATE };
+    }
+}
+function writeBlueBubblesRuntimeState(agentName, state, agentRoot) {
+    const filePath = getBlueBubblesRuntimeStatePath(agentName, agentRoot);
+    try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, JSON.stringify(state, null, 2) + "\n", "utf-8");
+    }
+    catch (error) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "senses",
+            event: "senses.bluebubbles_runtime_state_error",
+            message: "failed to write bluebubbles runtime state",
+            meta: {
+                agentName,
+                upstreamStatus: state.upstreamStatus,
+                reason: error instanceof Error ? error.message : String(error),
+            },
+        });
+        return filePath;
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.bluebubbles_runtime_state_written",
+        message: "wrote bluebubbles runtime state",
+        meta: {
+            agentName,
+            upstreamStatus: state.upstreamStatus,
+            pendingRecoveryCount: state.pendingRecoveryCount,
+            path: filePath,
+        },
+    });
+    return filePath;
+}

package/dist/senses/bluebubbles/session-cleanup.js

@@ -0,0 +1,72 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findObsoleteBlueBubblesThreadSessions = findObsoleteBlueBubblesThreadSessions;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const runtime_1 = require("../../nerves/runtime");
+function findObsoleteBlueBubblesThreadSessions(trunkSessionPath) {
+    const normalized = trunkSessionPath.trim();
+    if (!normalized.endsWith(".json"))
+        return [];
+    const trunkName = path.basename(normalized);
+    if (trunkName.includes("_thread_"))
+        return [];
+    if (!fs.existsSync(normalized))
+        return [];
+    const dir = path.dirname(normalized);
+    const prefix = trunkName.slice(0, -".json".length);
+    const threadLaneFiles = [];
+    for (const entry of fs.readdirSync(dir)) {
+        if (!entry.endsWith(".json"))
+            continue;
+        if (!entry.startsWith(`${prefix}_thread_`))
+            continue;
+        threadLaneFiles.push(path.join(dir, entry));
+    }
+    if (threadLaneFiles.length > 0) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "senses",
+            event: "senses.bluebubbles_thread_lane_artifacts_detected",
+            message: "detected obsolete bluebubbles thread-lane sessions",
+            meta: {
+                sessionPath: normalized,
+                artifactCount: threadLaneFiles.length,
+            },
+        });
+    }
+    return threadLaneFiles;
+}

package/dist/senses/cli/image-paste.js

@@ -0,0 +1,211 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMAGE_EXTENSION_REGEX = void 0;
+exports.isImagePath = isImagePath;
+exports.unescapePath = unescapePath;
+exports.tryReadImage = tryReadImage;
+exports.formatImageRef = formatImageRef;
+exports.replacePathsWithRefs = replacePathsWithRefs;
+exports.processSubmitInput = processSubmitInput;
+exports.resolveImageContent = resolveImageContent;
+/**
+ * Image paste detection and resolution for the TUI.
+ *
+ * When a user drags an image file onto the terminal, macOS pastes the absolute
+ * path (often with backslash-escaped spaces). This module detects image paths
+ * in the input text, replaces them with `[Image #N]` references, reads the
+ * files, and produces OpenAI-compatible `image_url` content blocks.
+ */
+const promises_1 = require("fs/promises");
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const runtime_1 = require("../../nerves/runtime");
+/** Matches image file extensions (case-insensitive) */
+exports.IMAGE_EXTENSION_REGEX = /\.(png|jpe?g|gif|webp)$/i;
+/** Check whether a string (possibly backslash-escaped) ends with an image extension */
+function isImagePath(str) {
+    return exports.IMAGE_EXTENSION_REGEX.test(unescapePath(str));
+}
+/** Strip shell escape backslashes from a path (macOS/Linux drag-drop format) */
+function unescapePath(str) {
+    // Handle double-backslashes first (actual backslash in filename)
+    // then remove single escape backslashes
+    return str.replace(/\\(.)/g, "$1");
+}
+/** Detect temp screenshot paths from macOS screencapture */
+const TEMP_SCREENSHOT_RE = /\/TemporaryItems\/.*screencaptureui.*\/Screenshot/i;
+/** Map file extension to MIME media type */
+function extensionToMediaType(ext) {
+    switch (ext.toLowerCase()) {
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".png":
+            return "image/png";
+        case ".gif":
+            return "image/gif";
+        case ".webp":
+            return "image/webp";
+        default:
+            return "image/png";
+    }
+}
+/**
+ * Read an image file and return base64 + media type.
+ * Falls back to clipboard for temp screenshot paths (macOS screencapture
+ * creates ephemeral files in TemporaryItems that are cleaned up quickly).
+ * Returns null on any error.
+ */
+async function tryReadImage(absolutePath) {
+    // Try reading the file directly first
+    try {
+        const buffer = await (0, promises_1.readFile)(absolutePath);
+        if (buffer.length > 0) {
+            const ext = path.extname(absolutePath);
+            return {
+                base64: Buffer.from(buffer).toString("base64"),
+                mediaType: extensionToMediaType(ext),
+            };
+        }
+    }
+    catch {
+        // File not found or permission denied — try clipboard fallback
+    }
+    // Clipboard fallback for macOS temp screenshots
+    /* v8 ignore start -- clipboard fallback requires real macOS screencapture @preserve */
+    if (process.platform === "darwin" && TEMP_SCREENSHOT_RE.test(absolutePath)) {
+        const clipboardImage = await getImageFromClipboard();
+        if (clipboardImage)
+            return clipboardImage;
+    }
+    /* v8 ignore stop */
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.image_read_error",
+        message: `Failed to read image: ${absolutePath}`,
+        meta: { path: absolutePath },
+    });
+    return null;
+}
+/**
+ * Read image data from macOS clipboard via osascript.
+ * Used as fallback when temp screenshot files are already cleaned up.
+ */
+/* v8 ignore start -- macOS clipboard integration @preserve */
+async function getImageFromClipboard() {
+    const tmpPath = "/tmp/ouro_clipboard_image.png";
+    try {
+        // Check if clipboard has image data
+        (0, child_process_1.execFileSync)("osascript", ["-e", "the clipboard as «class PNGf»"], { stdio: "pipe" });
+        // Save clipboard image to temp file
+        (0, child_process_1.execFileSync)("osascript", [
+            "-e", "set png_data to (the clipboard as «class PNGf»)",
+            "-e", `set fp to open for access POSIX file "${tmpPath}" with write permission`,
+            "-e", "write png_data to fp",
+            "-e", "close access fp",
+        ], { stdio: "pipe" });
+        const buffer = await (0, promises_1.readFile)(tmpPath);
+        void (0, promises_1.unlink)(tmpPath).catch(() => { });
+        if (buffer.length === 0)
+            return null;
+        return {
+            base64: Buffer.from(buffer).toString("base64"),
+            mediaType: "image/png",
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/* v8 ignore stop */
+/** Format an image reference placeholder */
+function formatImageRef(n) {
+    return `[Image #${n}]`;
+}
+/**
+ * Scan input for absolute image file paths and replace with [Image #N] references.
+ * Handles backslash-escaped characters (macOS drag-drop) and paths with spaces.
+ */
+function replacePathsWithRefs(input) {
+    const images = new Map();
+    // Match absolute paths: start with /, contain non-whitespace or backslash-escaped chars,
+    // end with an image extension. The (?:\\.|\S) alternation allows `\ ` sequences.
+    const pathRegex = /(?:\/(?:\\.|[^\s])+\.(?:png|jpe?g|gif|webp))/gi;
+    let counter = 0;
+    const text = input.replace(pathRegex, (match) => {
+        counter++;
+        images.set(counter, unescapePath(match));
+        return formatImageRef(counter);
+    });
+    return { text, images };
+}
+/**
+ * Process submit input: detect image paths, replace with refs, return map.
+ * This is the entry point called by InputArea on submit.
+ */
+function processSubmitInput(text) {
+    return replacePathsWithRefs(text);
+}
+/**
+ * Build OpenAI content parts from text + image map.
+ * For each image in the map, reads the file and creates an `image_url` content part.
+ * Images that fail to read are silently skipped.
+ * Returns `[{ type: "text", text }]` when no images resolve.
+ */
+async function resolveImageContent(text, images) {
+    if (images.size === 0) {
+        return [{ type: "text", text }];
+    }
+    const parts = [];
+    // Read all images in parallel
+    const entries = Array.from(images.entries());
+    const results = await Promise.all(entries.map(async ([, absolutePath]) => tryReadImage(absolutePath)));
+    for (const result of results) {
+        if (result) {
+            parts.push({
+                type: "image_url",
+                image_url: { url: `data:${result.mediaType};base64,${result.base64}` },
+            });
+        }
+    }
+    // Always include the text part
+    parts.push({ type: "text", text });
+    // If no images resolved, return just text
+    if (parts.length === 1) {
+        return [{ type: "text", text }];
+    }
+    return parts;
+}

package/dist/senses/cli/ink-app.js

@@ -0,0 +1,156 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InkApp = InkApp;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const ink_1 = require("ink");
+const streaming_markdown_1 = require("./streaming-markdown");
+/**
+ * Ouroboros CLI TUI — Ink application shell.
+ *
+ * Replaces the imperative readline-based CLI with a React/Ink component tree.
+ * Provides: message list, input area, spinner, tool result display.
+ *
+ * Design: Ouroboros-themed (green serpent), NOT Claude/Anthropic design language.
+ * Copy-paste integrity: no padding characters. Visual hierarchy via color/bold/dim only.
+ */
+// Ouroboros brand palette
+const OURO_GREEN = "#2ecc40";
+const OURO_TEAL = "#4ec9b0";
+const OURO_DIM = true;
+// Snake-themed spinner frames: serpent eating its own tail
+const SNAKE_FRAMES = [
+    "\u{1F40D}\u2003", // snake emoji
+    "\u25E0\u2003", // upper half circle
+    "\u25D4\u2003", // circle with upper right quadrant
+    "\u25D1\u2003", // circle with right half
+    "\u25D5\u2003", // circle with all but upper left quadrant
+    "\u25E1\u2003", // lower half circle
+    "\u{1F40D}\u2003", // snake emoji again
+    "\u25CB\u2003", // white circle (tail eaten)
+];
+function UserMessage({ content }) {
+    return ((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, { children: content })] }));
+}
+function AssistantMessage({ content }) {
+    return ((0, jsx_runtime_1.jsx)(ink_1.Box, { children: (0, jsx_runtime_1.jsx)(streaming_markdown_1.StreamingMarkdown, { text: content }) }));
+}
+function ToolCallDisplay({ toolCall }) {
+    let argSummary = "";
+    try {
+        const args = JSON.parse(toolCall.function.arguments);
+        const first = Object.values(args)[0];
+        if (typeof first === "string")
+            argSummary = first.length > 60 ? first.slice(0, 57) + "..." : first;
+    }
+    catch {
+        argSummary = toolCall.function.arguments.slice(0, 60);
+    }
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO_GREEN, bold: true, children: toolCall.function.name }), argSummary ? (0, jsx_runtime_1.jsxs)(ink_1.Text, { dimColor: true, children: [" ", argSummary] }) : null] }));
+}
+function ToolResultDisplay({ result }) {
+    const color = result.success ? OURO_GREEN : "#e74c3c";
+    const icon = result.success ? "\u2713" : "\u2717";
+    const summary = result.result.length > 120
+        ? result.result.slice(0, 117) + "..."
+        : result.result;
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { children: [(0, jsx_runtime_1.jsxs)(ink_1.Text, { color: color, children: [icon, " ", result.name] }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { dimColor: true, children: [" ", summary.replace(/\n/g, " ")] })] }));
+}
+function SpinnerComponent({ text, frame }) {
+    const char = SNAKE_FRAMES[frame % SNAKE_FRAMES.length];
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO_GREEN, children: char }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { dimColor: OURO_DIM, children: [text, "..."] })] }));
+}
+function InputArea({ onSubmit, }) {
+    const [input, setInput] = (0, react_1.useState)("");
+    // Ref tracks the latest input value so useInput callback always sees current state
+    const inputRef = (0, react_1.useRef)("");
+    (0, ink_1.useInput)((inputChar, key) => {
+        if (key.return) {
+            if (inputRef.current.trim() && onSubmit) {
+                onSubmit(inputRef.current);
+            }
+            inputRef.current = "";
+            setInput("");
+            return;
+        }
+        if (key.backspace || key.delete) {
+            inputRef.current = inputRef.current.slice(0, -1);
+            setInput(inputRef.current);
+            return;
+        }
+        if (!key.ctrl && !key.meta && inputChar) {
+            inputRef.current += inputChar;
+            setInput(inputRef.current);
+        }
+    });
+    return ((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, { children: input })] }));
+}
+function MessageList({ messages, toolResults, }) {
+    const toolResultMap = new Map();
+    if (toolResults) {
+        for (const tr of toolResults) {
+            toolResultMap.set(tr.toolCallId, tr);
+        }
+    }
+    return ((0, jsx_runtime_1.jsx)(ink_1.Box, { flexDirection: "column", children: messages.map((msg, i) => {
+            if (msg.role === "user" && msg.content) {
+                return (0, jsx_runtime_1.jsx)(UserMessage, { content: msg.content }, i);
+            }
+            if (msg.role === "assistant") {
+                return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [msg.content ? (0, jsx_runtime_1.jsx)(AssistantMessage, { content: msg.content }) : null, msg.tool_calls?.map(tc => {
+                            const tr = toolResultMap.get(tc.id);
+                            return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ToolCallDisplay, { toolCall: tc }), tr ? (0, jsx_runtime_1.jsx)(ToolResultDisplay, { result: tr }) : null] }, tc.id));
+                        })] }, i));
+            }
+            return null;
+        }) }));
+}
+function InkApp({ messages, onSubmit, loading, spinnerText, toolResults, }) {
+    const [spinnerFrame, setSpinnerFrame] = (0, react_1.useState)(0);
+    // Animate spinner
+    react_1.default.useEffect(() => {
+        if (!loading)
+            return;
+        const iv = setInterval(() => {
+            setSpinnerFrame(f => (f + 1) % SNAKE_FRAMES.length);
+        }, 120);
+        return () => clearInterval(iv);
+    }, [loading]);
+    const handleSubmit = (0, react_1.useCallback)((text) => {
+        onSubmit?.(text);
+    }, [onSubmit]);
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(MessageList, { messages: messages, toolResults: toolResults }), loading && spinnerText ? ((0, jsx_runtime_1.jsx)(SpinnerComponent, { text: spinnerText, frame: spinnerFrame })) : null, (0, jsx_runtime_1.jsx)(InputArea, { onSubmit: handleSubmit })] }));
+}

package/dist/senses/cli/inline-diff.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InlineDiff = InlineDiff;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+// Ouroboros brand colors
+const OURO_GREEN = "#2ecc40"; // added lines -- serpent green
+const OURO_RED = "#e74c3c"; // removed lines
+const OURO_HEADER = "#4ec9b0"; // file header -- teal
+const OURO_LINE_NUM = "gray"; // line numbers -- subtle
+/**
+ * Simple line-level diff algorithm (Myers-like via LCS).
+ * Produces a sequence of add/remove/context lines.
+ */
+function computeDiff(before, after) {
+    const oldLines = before ? before.split("\n") : [];
+    const newLines = after ? after.split("\n") : [];
+    // LCS-based diff
+    const m = oldLines.length;
+    const n = newLines.length;
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (oldLines[i - 1] === newLines[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    // Backtrack to build diff
+    const result = [];
+    let i = m;
+    let j = n;
+    while (i > 0 || j > 0) {
+        if (i > 0 && j > 0 && oldLines[i - 1] === newLines[j - 1]) {
+            result.unshift({ type: "context", content: oldLines[i - 1], oldNum: i, newNum: j });
+            i--;
+            j--;
+        }
+        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+            result.unshift({ type: "add", content: newLines[j - 1], newNum: j });
+            j--;
+        }
+        else {
+            result.unshift({ type: "remove", content: oldLines[i - 1], oldNum: i });
+            i--;
+        }
+    }
+    return result;
+}
+function DiffLineComponent({ line }) {
+    const num = line.type === "remove" ? line.oldNum : line.newNum;
+    /* v8 ignore next -- defensive fallback; line numbers always present @preserve */
+    const lineNum = num !== undefined ? String(num) : "";
+    const prefix = line.type === "add" ? "+" : line.type === "remove" ? "-" : " ";
+    const color = line.type === "add" ? OURO_GREEN : line.type === "remove" ? OURO_RED : undefined;
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Text, { children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO_LINE_NUM, children: lineNum.padStart(4) }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: color, children: ` ${prefix} ${line.content}` })] }));
+}
+function InlineDiff({ before, after, filePath }) {
+    const diffLines = computeDiff(before, after);
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO_HEADER, bold: true, children: filePath }), diffLines.map((line, i) => ((0, jsx_runtime_1.jsx)(DiffLineComponent, { line: line }, i)))] }));
+}

package/dist/senses/cli/message-list.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScrollableMessageList = ScrollableMessageList;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const ink_1 = require("ink");
+const streaming_markdown_1 = require("./streaming-markdown");
+/**
+ * Scrollable message list with virtual rendering.
+ *
+ * Only renders messages within the viewport window. Supports:
+ * - Auto-scroll to bottom (pinned mode, default)
+ * - Scroll lock at a specific offset
+ * - "N below" indicator when scrolled up
+ *
+ * Ouroboros-themed: green serpent palette, no padding decoration.
+ */
+// Ouroboros brand palette
+const OURO_TEAL = "#4ec9b0";
+const OURO_INDICATOR = "#2ecc40";
+function MessageItem({ message }) {
+    if (message.role === "user" && message.content) {
+        return ((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, { children: message.content })] }));
+    }
+    if (message.role === "assistant" && message.content) {
+        return (0, jsx_runtime_1.jsx)(streaming_markdown_1.StreamingMarkdown, { text: message.content });
+    }
+    // system or empty messages render nothing visible
+    return (0, jsx_runtime_1.jsx)(ink_1.Text, { children: "" });
+}
+function ScrollableMessageList({ messages, viewportHeight, scrollOffset, }) {
+    const { visibleMessages, belowCount } = (0, react_1.useMemo)(() => {
+        if (messages.length === 0) {
+            return { visibleMessages: [], belowCount: 0 };
+        }
+        let start;
+        if (scrollOffset !== undefined) {
+            start = Math.max(0, Math.min(scrollOffset, messages.length - 1));
+        }
+        else {
+            // Auto-scroll: pin to bottom
+            start = Math.max(0, messages.length - viewportHeight);
+        }
+        const end = Math.min(start + viewportHeight, messages.length);
+        return {
+            visibleMessages: messages.slice(start, end),
+            belowCount: messages.length - end,
+        };
+    }, [messages, viewportHeight, scrollOffset]);
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [visibleMessages.map((msg, i) => ((0, jsx_runtime_1.jsx)(MessageItem, { message: msg }, i))), belowCount > 0 ? ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: OURO_INDICATOR, dimColor: true, children: `${belowCount} below` })) : null] }));
+}