@unerr-ai/unerr 0.1.0 → 0.1.2

package/dist/commands/timeline.js

@@ -0,0 +1,139 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+// ── Local Timeline from Shadow Ledger ─────────────────────────
+/**
+ * Format a relative time string from an ISO timestamp.
+ */
+export function formatRelativeTime(isoTs) {
+    const diff = Date.now() - new Date(isoTs).getTime();
+    const seconds = Math.floor(diff / 1000);
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes} min ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+/**
+ * Read and parse shadow ledger JSONL file.
+ */
+export function readShadowLedger(ledgerPath) {
+    if (!fs.existsSync(ledgerPath))
+        return [];
+    try {
+        const raw = fs.readFileSync(ledgerPath, "utf-8");
+        const entries = [];
+        for (const line of raw.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                entries.push(JSON.parse(trimmed));
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Load working state snapshot SHAs for star markers.
+ */
+function loadWorkingSnapshots(unerrDir) {
+    const shas = new Set();
+    const stateDir = path.join(unerrDir, "state");
+    if (!fs.existsSync(stateDir))
+        return shas;
+    try {
+        const entries = fs.readdirSync(stateDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith("working-") && entry.name.endsWith(".json")) {
+                try {
+                    const raw = fs.readFileSync(path.join(stateDir, entry.name), "utf-8");
+                    const snapshot = JSON.parse(raw);
+                    if (snapshot.commitSha)
+                        shas.add(snapshot.commitSha);
+                }
+                catch {
+                    // Skip corrupt files
+                }
+            }
+        }
+    }
+    catch {
+        // Non-blocking
+    }
+    return shas;
+}
+export function runTimelineLocal(opts) {
+    const cwd = process.cwd();
+    const unerrDir = path.join(cwd, ".unerr");
+    const ledgerPath = path.join(unerrDir, "ledger", "shadow.jsonl");
+    let entries = readShadowLedger(ledgerPath);
+    if (entries.length === 0) {
+        process.stderr.write("[unerr] No ledger entries found.\n");
+        process.stderr.write("[unerr] The shadow ledger is populated as you use unerr tools.\n");
+        return;
+    }
+    // Apply filters
+    if (opts.branch) {
+        entries = entries.filter((e) => e.branch === opts.branch);
+    }
+    if (opts.tool) {
+        entries = entries.filter((e) => e.tool === opts.tool);
+    }
+    // Take last N entries (most recent)
+    const total = entries.length;
+    entries = entries.slice(-opts.limit);
+    // Load working state markers
+    const workingShas = loadWorkingSnapshots(unerrDir);
+    process.stderr.write("\n");
+    for (const entry of entries) {
+        const timestamp = formatRelativeTime(entry.ts).padEnd(12);
+        const toolName = entry.tool.padEnd(22);
+        const branch = `[${entry.branch}]`;
+        const isWorking = workingShas.has(entry.head_sha);
+        const marker = isWorking ? " *" : "";
+        process.stderr.write(`  ${timestamp}${toolName} ${branch}${marker}\n`);
+        // Show args summary if available
+        if (entry.args_summary && Object.keys(entry.args_summary).length > 0) {
+            const summary = Object.entries(entry.args_summary)
+                .map(([k, v]) => `${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`)
+                .join(", ")
+                .slice(0, 80);
+            process.stderr.write(`    ${summary}\n`);
+        }
+    }
+    const workingCount = entries.filter((e) => workingShas.has(e.head_sha)).length;
+    process.stderr.write(`\n  ${entries.length} entries shown${total > entries.length ? ` (of ${total} total)` : ""} · ${workingCount} working states marked\n\n`);
+}
+export function registerTimelineCommand(program) {
+    program
+        .command("timeline")
+        .description("Show the prompt ledger timeline")
+        .option("--branch <branch>", "Filter by branch")
+        .option("--tool <tool>", "Filter by tool name")
+        .option("--limit <n>", "Number of entries to show", "50")
+        .action(async (opts) => {
+        try {
+            runTimelineLocal({
+                branch: opts.branch,
+                tool: opts.tool,
+                limit: Number.parseInt(opts.limit, 10) || 50,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`Error: ${message}`);
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/uninstall.js

@@ -0,0 +1,230 @@
+/**
+ * `unerr uninstall [agent]` — removes generated configs, skills, hooks, and instructions.
+ *
+ * Two modes:
+ *   - `unerr uninstall claude` — per-agent: reverts exactly what `unerr install claude` did
+ *   - `unerr uninstall` (no args) — removes all agents' configs
+ *
+ * Does NOT remove:
+ *   - .unerr/ data directory (user's indexed data)
+ *   - .gitignore entries (shared across agents)
+ */
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { AGENT_REGISTRY, getAgent, normalizeAgentName, } from "../config/agent-registry.js";
+import { removeDisallowedTools, removePreToolUseBashHook, } from "../config/claude-settings-hooks.js";
+import { removeClaudeHook } from "../config/hook-installer.js";
+import { removeInstructionSection } from "../config/instruction-writer.js";
+import { removeMcpConfig } from "../config/mcp-config-writer.js";
+import { removeInstalledSkills } from "../skills/resolver.js";
+export function registerUninstallCommand(program) {
+    program
+        .command("uninstall [agent]")
+        .description("Remove unerr configs and hooks from this project")
+        .option("--autostart", "Remove the platform auto-start service (launchd/systemd/schtasks)")
+        .action(async (agent, opts) => {
+        const cwd = process.cwd();
+        if (opts.autostart) {
+            try {
+                const { uninstallForCurrentPlatform, removeSentinel } = await import("../daemon/autostart.js");
+                const result = await uninstallForCurrentPlatform();
+                removeSentinel();
+                process.stderr.write(`\x1b[38;2;52;211;153m✓\x1b[0m Platform auto-start removed${result.error ? ` (note: ${result.error})` : ""}\n`);
+            }
+            catch (err) {
+                process.stderr.write(`\x1b[38;2;248;113;113m✗\x1b[0m Failed to remove auto-start: ${err.message}\n`);
+            }
+            return;
+        }
+        if (agent) {
+            const normalized = normalizeAgentName(agent);
+            const agentDef = getAgent(normalized);
+            if (!agentDef) {
+                process.stderr.write(`\x1b[31m✗\x1b[0m Unknown agent: "${agent}"\n`);
+                return;
+            }
+            const result = runUninstall(cwd, normalized);
+            displayUninstallResult(agentDef.name, result);
+        }
+        else {
+            runUninstallAll(cwd);
+        }
+        // Hint about autostart removal
+        try {
+            const { isAutostartInstalled } = await import("../daemon/autostart.js");
+            if (isAutostartInstalled()) {
+                process.stderr.write("\n  \x1b[38;2;251;191;36m⚠\x1b[0m Platform auto-start is still active. Remove with: unerr uninstall --autostart\n\n");
+            }
+        }
+        catch {
+            // Non-blocking
+        }
+    });
+}
+/**
+ * Uninstall unerr for a single agent — symmetric to runInstall().
+ */
+function runUninstall(cwd, ide) {
+    // 1. Remove MCP config
+    const mcpRemoved = removeMcpConfig(cwd, ide);
+    // 2. Remove skills
+    let skillsRemoved = 0;
+    try {
+        skillsRemoved = removeInstalledSkills(ide, cwd);
+    }
+    catch {
+        // Non-blocking
+    }
+    // 3. Remove hooks (agent-specific)
+    let hookRemoved = false;
+    let settingsHookRemoved = false;
+    if (ide === "claude-code") {
+        hookRemoved = removeClaudeHook(cwd);
+        settingsHookRemoved = removePreToolUseBashHook(cwd);
+    }
+    else if (ide === "cursor") {
+        hookRemoved = removeCursorHooks(cwd);
+    }
+    else if (ide === "cline") {
+        hookRemoved = removeClineHooks(cwd);
+    }
+    // 4. Gitignore — NOT reverted (shared across agents, .unerr/ data preserved)
+    // 5. Remove instructions
+    let instructionsRemoved = false;
+    try {
+        instructionsRemoved = removeInstructionSection(cwd, ide);
+    }
+    catch {
+        // Non-blocking
+    }
+    // 6. S8: Remove disallowed tool entries (Claude Code only)
+    let disallowedToolsRemoved = false;
+    if (ide === "claude-code") {
+        try {
+            disallowedToolsRemoved = removeDisallowedTools(cwd);
+        }
+        catch {
+            // Non-blocking
+        }
+    }
+    return {
+        mcpRemoved,
+        skillsRemoved,
+        hookRemoved,
+        settingsHookRemoved,
+        instructionsRemoved,
+        disallowedToolsRemoved,
+    };
+}
+/**
+ * Display per-agent uninstall results (matches install's ANSI style).
+ */
+function displayUninstallResult(agentName, result) {
+    process.stderr.write("\n");
+    process.stderr.write(`  \x1b[38;2;139;92;246m◆\x1b[0m \x1b[1munerr ✗ ${agentName}\x1b[0m\n`);
+    process.stderr.write("\n");
+    const nothingRemoved = !result.mcpRemoved &&
+        result.skillsRemoved === 0 &&
+        !result.hookRemoved &&
+        !result.settingsHookRemoved &&
+        !result.instructionsRemoved &&
+        !result.disallowedToolsRemoved;
+    if (nothingRemoved) {
+        process.stderr.write("  \x1b[38;2;161;161;170m· Nothing to uninstall\x1b[0m\n");
+    }
+    else {
+        if (result.mcpRemoved) {
+            process.stderr.write("  \x1b[38;2;52;211;153m✓\x1b[0m MCP config removed\n");
+        }
+        if (result.skillsRemoved > 0) {
+            process.stderr.write(`  \x1b[38;2;52;211;153m✓\x1b[0m ${result.skillsRemoved} skills removed\n`);
+        }
+        if (result.hookRemoved) {
+            process.stderr.write("  \x1b[38;2;52;211;153m✓\x1b[0m PostToolUse hook removed\n");
+        }
+        if (result.settingsHookRemoved) {
+            process.stderr.write("  \x1b[38;2;52;211;153m✓\x1b[0m PreToolUse settings hook removed\n");
+        }
+        if (result.instructionsRemoved) {
+            process.stderr.write("  \x1b[38;2;52;211;153m✓\x1b[0m Tool preferences removed\n");
+        }
+        if (result.disallowedToolsRemoved) {
+            process.stderr.write("  \x1b[38;2;52;211;153m✓\x1b[0m Disallowed tools restored\n");
+        }
+    }
+    process.stderr.write("\n");
+    process.stderr.write("  \x1b[38;2;161;161;170mData in .unerr/ preserved.\x1b[0m\n");
+    process.stderr.write("\n");
+}
+/**
+ * Uninstall all agents — enhanced version of original behavior.
+ */
+function runUninstallAll(cwd) {
+    const results = [];
+    for (const agent of AGENT_REGISTRY) {
+        const r = runUninstall(cwd, agent.id);
+        if (r.mcpRemoved)
+            results.push(`Removed MCP config for ${agent.id}`);
+        if (r.skillsRemoved > 0)
+            results.push(`Removed ${r.skillsRemoved} skills for ${agent.id}`);
+        if (r.hookRemoved)
+            results.push("Removed PostToolUse hook");
+        if (r.settingsHookRemoved)
+            results.push("Removed PreToolUse settings hook");
+        if (r.instructionsRemoved)
+            results.push(`Removed instructions for ${agent.id}`);
+        if (r.disallowedToolsRemoved)
+            results.push("Restored disallowed built-in tools");
+    }
+    if (results.length === 0) {
+        process.stderr.write("[unerr] Nothing to uninstall — no configs found.\n");
+    }
+    else {
+        for (const r of results) {
+            process.stderr.write(`[unerr] ${r}\n`);
+        }
+        process.stderr.write("[unerr] Uninstall complete. Data in .unerr/ preserved.\n");
+    }
+}
+/**
+ * Remove unerr hook entries from Cursor's `.cursor/hooks.json`.
+ */
+function removeCursorHooks(cwd) {
+    const hooksPath = join(cwd, ".cursor", "hooks.json");
+    if (!existsSync(hooksPath))
+        return false;
+    try {
+        const config = JSON.parse(readFileSync(hooksPath, "utf-8"));
+        if (!Array.isArray(config.hooks))
+            return false;
+        const before = config.hooks.length;
+        config.hooks = config.hooks.filter((h) => h?.name !== "unerr-graph-tools");
+        if (config.hooks.length === before)
+            return false;
+        if (config.hooks.length === 0) {
+            unlinkSync(hooksPath);
+        }
+        else {
+            writeFileSync(hooksPath, `${JSON.stringify(config, null, 2)}\n`);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Remove unerr hook scripts from Cline's `.clinerules/hooks/`.
+ */
+function removeClineHooks(cwd) {
+    const hookPath = join(cwd, ".clinerules", "hooks", "unerr-pre-tool.sh");
+    if (!existsSync(hookPath))
+        return false;
+    try {
+        unlinkSync(hookPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/components/App.js

@@ -0,0 +1,109 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * App — root Ink component for the interactive REPL.
+ *
+ * Manages conversation state, dispatches user input to the QueryEngine,
+ * and renders the message history with streaming responses.
+ */
+import { Box, Text, useApp, useInput } from "ink";
+import { useState, useCallback } from "react";
+import { executeQuery, } from "../core/query-engine.js";
+import { InputBox } from "./InputBox.js";
+import { MessageList } from "./MessageList.js";
+import { StatusLine } from "./StatusLine.js";
+import { ToolProgress } from "./ToolProgress.js";
+export function App({ apiKey, chatProvider, model, systemPrompt, tools, cwd, welcomeMessage, }) {
+    const { exit } = useApp();
+    const [messages, setMessages] = useState([]);
+    const [streamingText, setStreamingText] = useState("");
+    const [isLoading, setIsLoading] = useState(false);
+    const [activeTools, setActiveTools] = useState([]);
+    const [lastUsage, setLastUsage] = useState(null);
+    const [error, setError] = useState(null);
+    // Handle Ctrl+C to exit
+    useInput((input, key) => {
+        if (key.ctrl && input === "c") {
+            exit();
+        }
+    });
+    const handleSubmit = useCallback(async (input) => {
+        if (!input.trim())
+            return;
+        // Handle special commands
+        if (input.trim() === "/exit" || input.trim() === "/quit") {
+            exit();
+            return;
+        }
+        if (input.trim() === "/clear") {
+            setMessages([]);
+            setLastUsage(null);
+            setError(null);
+            return;
+        }
+        if (input.trim() === "/cost") {
+            if (lastUsage) {
+                setError(`Session: ${lastUsage.inputTokens} in / ${lastUsage.outputTokens} out — $${lastUsage.estimatedCost.toFixed(4)}`);
+            }
+            else {
+                setError("No usage data yet");
+            }
+            return;
+        }
+        const userMessage = { role: "user", content: input };
+        const updatedMessages = [...messages, userMessage];
+        setMessages(updatedMessages);
+        setIsLoading(true);
+        setStreamingText("");
+        setActiveTools([]);
+        setError(null);
+        try {
+            const options = {
+                model,
+                apiKey,
+                chatProvider,
+                tools,
+                systemPrompt,
+                toolContext: { cwd },
+            };
+            const result = await executeQuery(updatedMessages, options, {
+                onToken: (token) => {
+                    setStreamingText((prev) => prev + token);
+                },
+                onToolCall: (name) => {
+                    setActiveTools((prev) => [...prev, { name, status: "running" }]);
+                },
+                onToolResult: (name) => {
+                    setActiveTools((prev) => prev.map((t) => t.name === name && t.status === "running"
+                        ? { ...t, status: "done" }
+                        : t));
+                },
+            });
+            const assistantMessage = {
+                role: "assistant",
+                content: result.response,
+                toolCalls: result.toolCalls,
+            };
+            setMessages((prev) => [...prev, assistantMessage]);
+            setLastUsage(result.usage);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+        }
+        finally {
+            setIsLoading(false);
+            setStreamingText("");
+            setActiveTools([]);
+        }
+    }, [
+        messages,
+        model,
+        apiKey,
+        chatProvider,
+        tools,
+        systemPrompt,
+        cwd,
+        exit,
+        lastUsage,
+    ]);
+    return (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "unerr" }), _jsx(Text, { color: "gray", children: " \u2014 AI assistant with code intelligence" }), _jsxs(Text, { color: "gray", children: [" (", model, ")"] })] }), welcomeMessage && messages.length === 0 && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "gray", children: welcomeMessage }) })), _jsx(MessageList, { messages: messages }), streamingText && (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "green", children: streamingText }), _jsx(Text, { color: "gray", children: "\u258A" })] })), activeTools.length > 0 && _jsx(ToolProgress, { tools: activeTools }), error && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "red", children: ["Error: ", error] }) })), lastUsage && _jsx(StatusLine, { usage: lastUsage }), _jsx(InputBox, { onSubmit: handleSubmit, isDisabled: isLoading })] }));
+}

package/dist/components/Banner.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Branded banner: unerr ▸ Code intelligence for AI agents
+ *
+ * Used in startup and setup displays. Renders to stderr via Ink.
+ */
+import { Box, Text } from "ink";
+import { useTheme } from "./Theme.js";
+export function Banner() {
+    const t = useTheme();
+    return (_jsxs(Box, { marginLeft: 2, children: [_jsx(Text, { bold: true, color: t.brand, children: "unerr" }), _jsx(Text, { color: t.dim, children: " \u25B8 " }), _jsx(Text, { color: t.dim, children: "Code intelligence for your AI agents" })] }));
+}

package/dist/components/ConfirmPrompt.js

@@ -0,0 +1,25 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Inline confirm prompt: [Y/n] with context.
+ *
+ * Uses Ink's useInput() for keyboard handling.
+ * Used for entity rewind, dead code removal confirmations.
+ */
+import { Box, Text, useInput } from "ink";
+import { useTheme } from "./Theme.js";
+export function ConfirmPrompt({ message, onConfirm, defaultYes = true, }) {
+    const t = useTheme();
+    const hint = defaultYes ? "[Y/n]" : "[y/N]";
+    useInput((input, key) => {
+        if (input === "y" || input === "Y") {
+            onConfirm(true);
+        }
+        else if (input === "n" || input === "N") {
+            onConfirm(false);
+        }
+        else if (key.return) {
+            onConfirm(defaultYes);
+        }
+    });
+    return (_jsxs(Box, { marginLeft: 2, children: [_jsxs(Text, { children: [message, " "] }), _jsx(Text, { color: t.dim, children: hint })] }));
+}

package/dist/components/DriftSummary.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Drift summary — modified/added/deleted counts.
+ *
+ * Used in status and startup displays.
+ */
+import { Box, Text } from "ink";
+import { useTheme } from "./Theme.js";
+export function DriftSummary({ drift }) {
+    const t = useTheme();
+    const total = drift.modified + drift.added + drift.deleted;
+    if (total === 0) {
+        return (_jsx(Box, { marginLeft: 4, children: _jsx(Text, { color: t.dim, children: "No drift detected" }) }));
+    }
+    const parts = [];
+    if (drift.modified > 0)
+        parts.push(`${drift.modified} modified`);
+    if (drift.added > 0)
+        parts.push(`${drift.added} added`);
+    if (drift.deleted > 0)
+        parts.push(`${drift.deleted} deleted`);
+    return (_jsx(Box, { marginLeft: 4, children: _jsxs(Text, { color: t.warning, children: [total, " drifted entit", total !== 1 ? "ies" : "y", ": ", parts.join(", ")] }) }));
+}

package/dist/components/GradeBadge.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Colored grade badge: A, B+, C, D, F
+ *
+ * Color mapped by theme.grade() — A=green, C=yellow, F=red.
+ * Used in health card, status, first-connect displays.
+ */
+import { Text } from "ink";
+import { useTheme } from "./Theme.js";
+export function GradeBadge({ grade, score, bold = true, }) {
+    const t = useTheme();
+    const color = t.grade(grade);
+    const label = score !== undefined ? `${grade}  (${score}/100)` : grade;
+    return (_jsx(Text, { bold: bold, color: color, children: label }));
+}

package/dist/components/HealthCard.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Health grade card — bordered box with grade, progress bar, and top issues.
+ *
+ * Used in startup (Act 2: Revelation), status, and first-connect displays.
+ */
+import { Box, Text } from "ink";
+import { GradeBadge } from "./GradeBadge.js";
+import { ProgressBar } from "./ProgressBar.js";
+import { useTheme } from "./Theme.js";
+export function HealthCard({ health, compact = false, }) {
+    const t = useTheme();
+    const gradeColor = t.grade(health.grade);
+    if (compact) {
+        return (_jsxs(Box, { marginLeft: 2, children: [_jsx(GradeBadge, { grade: health.grade, score: health.score }), _jsx(Text, { children: " " }), _jsx(ProgressBar, { value: health.score / 100, width: 16, color: gradeColor }), _jsxs(Text, { color: t.dim, children: [" ", health.totalEntities, " entities \u00B7 ", health.totalEdges, " edges"] })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsxs(Box, { children: [_jsx(Text, { children: " " }), _jsx(GradeBadge, { grade: health.grade, score: health.score }), _jsx(Text, { children: " " }), _jsx(ProgressBar, { value: health.score / 100, width: 20, color: gradeColor, showLabel: true })] }), health.deadFunctionCount > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.warning, children: ["\u26A1 ", health.deadFunctionCount, " dead function", health.deadFunctionCount !== 1 ? "s" : "", " \u2014 your agent reads these but nothing calls them"] }) })), health.highRiskEntities.map((entity) => (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.warning, children: ["\u26A0 ", entity.name, " \u2192 ", entity.fan_in, " caller", entity.fan_in !== 1 ? "s" : "", ", ", entity.fan_out, " callee", entity.fan_out !== 1 ? "s" : "", " (chokepoint)"] }) }, entity.name)))] }));
+}

package/dist/components/InkSpinner.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Animated spinner with status text.
+ *
+ * Named InkSpinner to avoid conflict with ora-based spinners.
+ * Uses Ink's useEffect for frame animation.
+ */
+import { Box, Text } from "ink";
+import { useEffect, useState } from "react";
+import { useTheme } from "./Theme.js";
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+export function InkSpinner({ label, interval = 80, }) {
+    const t = useTheme();
+    const [frame, setFrame] = useState(0);
+    useEffect(() => {
+        const timer = setInterval(() => {
+            setFrame((prev) => (prev + 1) % SPINNER_FRAMES.length);
+        }, interval);
+        return () => clearInterval(timer);
+    }, [interval]);
+    return (_jsxs(Box, { marginLeft: 2, children: [_jsx(Text, { color: t.info, children: SPINNER_FRAMES[frame] }), _jsxs(Text, { children: [" ", label] })] }));
+}

package/dist/components/InputBox.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * InputBox — user input component with prompt indicator.
+ */
+import { Box, Text } from "ink";
+import TextInput from "ink-text-input";
+import { useState } from "react";
+export function InputBox({ onSubmit, isDisabled }) {
+    const [value, setValue] = useState("");
+    const handleSubmit = (input) => {
+        if (isDisabled)
+            return;
+        onSubmit(input);
+        setValue("");
+    };
+    return (_jsxs(Box, { children: [_jsx(Text, { color: isDisabled ? "gray" : "cyan", bold: true, children: isDisabled ? "⏳ " : "❯ " }), isDisabled ? (_jsx(Text, { color: "gray", children: "Thinking..." })) : (_jsx(TextInput, { value: value, onChange: setValue, onSubmit: handleSubmit, placeholder: "Ask anything about your code..." }))] }));
+}

package/dist/components/KeyValue.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Aligned key-value display: Label:  Value
+ *
+ * Label is dimmed, value is normal. Used in status, session summary.
+ */
+import { Box, Text } from "ink";
+import { useTheme } from "./Theme.js";
+export function KeyValue({ label, value, labelWidth = 20, valueColor, }) {
+    const t = useTheme();
+    const padded = label.padEnd(labelWidth);
+    return (_jsxs(Box, { marginLeft: 4, children: [_jsx(Text, { color: t.dim, children: padded }), _jsx(Text, { color: valueColor, children: value })] }));
+}

package/dist/components/MessageList.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * MessageList — renders conversation history.
+ */
+import { Box, Text } from "ink";
+export function MessageList({ messages }) {
+    return (_jsx(Box, { flexDirection: "column", children: messages.map((msg, i) => (_jsx(MessageBubble, { message: msg }, `msg-${msg.role}-${i}`))) }));
+}
+function MessageBubble({ message }) {
+    if (message.role === "user") {
+        return (_jsxs(Box, { marginBottom: 1, children: [_jsxs(Text, { bold: true, color: "blue", children: ["You:", " "] }), _jsx(Text, { children: message.content })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [message.toolCalls && message.toolCalls.length > 0 && (_jsx(Box, { marginBottom: 0, children: message.toolCalls.map((tc, i) => (_jsx(Box, { marginRight: 1, children: _jsxs(Text, { color: "yellow", dimColor: true, children: ["[", tc.name, "]"] }) }, `tc-${tc.name}`))) })), _jsxs(Box, { children: [_jsxs(Text, { bold: true, color: "green", children: ["unerr:", " "] }), _jsx(Text, { children: message.content })] })] }));
+}