agentram 0.1.9 → 0.1.10

package/README.md

@@ -998,3 +998,14 @@ Supervisor creates plan -> Main agent executes -> Small agent records RAM notes
 ```
 
 Small agent should not own big direction. It records plans, decisions, files, risks, next tasks, and coding facts into RAM.
+
+## Textual TUI
+
+Install rich terminal UI with native scrollable chat pane:
+
+```bash
+pip install agentram[tui]
+agentram tui
+```
+
+When `textual` is installed, AgentRAM uses a real full-screen TUI with mouse wheel scrolling inside the chat frame. If `textual` is missing, it falls back to the basic print-based terminal UI.

package/agentram/cli.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import argparse
+import asyncio
 from concurrent.futures import ThreadPoolExecutor
 import json
 import os
@@ -44,10 +45,10 @@ SLASH_COMMANDS: list[tuple[str, str]] = [
     ("/workflow", "Show supervisor workflow agents"),
     ("/route on|off|status", "Toggle auto prompt routing"),
     ("/orchestrate <task>", "Build multi-model agent plan"),
-    ("/ask <prompt>", "Execute bound models and return outputs"),
-    ("/claude-install [path]", "Install .claude commands and agents"),
-    ("/note <text>", "Save decision note"),
-    ("/clear", "Clear chat"),
+    ("/ask <prompt>", "Execute bound models and return outputs"),
+    ("/claude-install [path]", "Install .claude commands and agents"),
+    ("/note <text>", "Save decision note"),
+    ("/clear", "Clear chat"),
     ("/exit", "Quit"),
     ("Plain text", "Capture coding chat message and retrieve context"),
 ]
@@ -76,9 +77,9 @@ SLASH_HELP = """Slash commands:
 /route on|off|status          Toggle auto prompt routing
 /orchestrate <task>           Build multi-model agent plan
 /ask <prompt>                 Execute bound models and return outputs
-/claude-install [path]        Install .claude commands and agents
-/note <text>                  Save decision note
-/clear                        Clear chat
+/claude-install [path]        Install .claude commands and agents
+/note <text>                  Save decision note
+/clear                        Clear chat
 /exit                         Quit
 Plain text                    Capture coding chat message and retrieve context
 """.strip()
@@ -237,34 +238,121 @@ def run_command(args: argparse.Namespace) -> int:
     raise SystemExit(f"unknown command: {command}")
 
 
-def run_tui(context: McpContext) -> None:
-    context.init_storage()
+def run_tui(context: McpContext) -> None:
+    if run_textual_tui(context):
+        return
+    context.init_storage()
     prompt_session = create_prompt_session()
     input_hint = "live slash autocomplete enabled" if prompt_session else "basic input fallback; install prompt_toolkit for live slash dropdown"
-    messages = [
-        "system > AgentRAM coding-agent CLI ready",
-        f"system > RAM root: {context.ram_root}",
-        f"system > {input_hint}",
-    ]
-    while True:
-        draw_screen(context, messages)
+    messages = [
+        "system > AgentRAM coding-agent CLI ready",
+        f"system > RAM root: {context.ram_root}",
+        f"system > {input_hint}",
+    ]
+    while True:
+        draw_screen(context, messages)
         try:
             user_input = read_tui_input(prompt_session).strip()
         except (EOFError, KeyboardInterrupt):
             return
-        if user_input in {"0", "q", "quit", "exit", "/exit", "/quit"}:
-            return
-        if user_input in BUTTONS:
-            user_input = BUTTONS[user_input]
-        if user_input:
-            messages.append(f"user > {user_input}")
+        if user_input in {"0", "q", "quit", "exit", "/exit", "/quit"}:
+            return
+        if user_input in BUTTONS:
+            user_input = BUTTONS[user_input]
+        if user_input:
+            messages.append(f"user > {user_input}")
         response = run_with_activity(context, messages, user_input)
         if response == "__clear__":
             messages.clear()
             messages.append("system > Chat cleared.")
         elif response:
             messages.append("agentram > " + response)
-        del messages[:-10]
+        del messages[:-200]
+
+def run_textual_tui(context: McpContext) -> bool:
+    try:
+        from textual.app import App, ComposeResult
+        from textual.containers import Horizontal, Vertical
+        from textual.widgets import Footer, Header, Input, RichLog, Static
+    except ImportError:
+        return False
+
+    class AgentRAMTextualApp(App[None]):
+        CSS = """
+        Screen { background: #0b0f14; color: #d7dde8; }
+        #layout { height: 1fr; }
+        #sidebar { width: 32; border: solid #263241; padding: 1; }
+        #main { width: 1fr; }
+        #chat { height: 1fr; border: solid #263241; padding: 1; overflow-y: scroll; }
+        #input { dock: bottom; border: solid #3b82f6; }
+        .muted { color: #8b9bb0; }
+        """
+        BINDINGS = [("ctrl+c", "quit", "Quit")]
+
+        def __init__(self, mcp_context: McpContext) -> None:
+            super().__init__()
+            self.context = mcp_context
+            self.messages: list[str] = []
+            self.busy = False
+
+        def compose(self) -> ComposeResult:
+            yield Header(show_clock=True)
+            with Horizontal(id="layout"):
+                yield Static(id="sidebar")
+                with Vertical(id="main"):
+                    yield RichLog(id="chat", wrap=True, highlight=True, markup=False, auto_scroll=True)
+                    yield Input(placeholder="Prompt hoặc /command. Mouse wheel scroll trong khung chat.", id="input")
+            yield Footer()
+
+        def on_mount(self) -> None:
+            self.context.init_storage()
+            self.chat.write("system > AgentRAM Textual TUI ready")
+            self.chat.write(f"system > RAM root: {self.context.ram_root}")
+            self.refresh_sidebar()
+            self.set_interval(1.0, self.refresh_sidebar)
+
+        @property
+        def chat(self) -> RichLog:
+            return self.query_one("#chat", RichLog)
+
+        def refresh_sidebar(self) -> None:
+            self.query_one("#sidebar", Static).update("\n".join(sidebar_lines(self.context)))
+
+        async def on_input_submitted(self, event: Input.Submitted) -> None:
+            text = event.value.strip()
+            event.input.value = ""
+            if not text:
+                return
+            if text in {"0", "q", "quit", "exit", "/exit", "/quit"}:
+                self.exit()
+                return
+            if text in BUTTONS:
+                text = BUTTONS[text]
+            self.chat.write(f"user > {text}")
+            if text == "/clear":
+                self.chat.clear()
+                self.chat.write("system > Chat cleared.")
+                return
+            if self.busy:
+                self.chat.write("agentram > busy, wait current task")
+                return
+            self.busy = True
+            self.chat.write("agentram > thinking...")
+            try:
+                response = await asyncio.to_thread(handle_chat_input, self.context, text, self.messages)
+            except Exception as error:  # noqa: BLE001 - TUI boundary
+                response = f"error: {error}"
+            finally:
+                self.busy = False
+            if response == "__clear__":
+                self.chat.clear()
+                self.chat.write("system > Chat cleared.")
+            elif response:
+                self.chat.write("agentram > " + response)
+            self.refresh_sidebar()
+
+    AgentRAMTextualApp(context).run()
+    return True
 
 def run_with_activity(context: McpContext, messages: list[str], user_input: str) -> str:
     with ThreadPoolExecutor(max_workers=1) as executor:
@@ -908,7 +996,7 @@ def draw_screen(context: McpContext, messages: list[str], activity: str | None =
     print(box_text("◆ AgentRAM Code  |  RAM + Claude subagents + slash commands", width))
     print("+" + "-" * (width - 2) + "+")
 
-    sidebar = sidebar_lines(context)
+    sidebar = sidebar_lines(context)
     display_messages = [*messages, activity] if activity else messages
     chat = wrap_messages(display_messages, right_width - 4)[-22:]
     rows = max(len(sidebar), len(chat), 22)
@@ -917,7 +1005,7 @@ def draw_screen(context: McpContext, messages: list[str], activity: str | None =
         right = chat[index] if index < len(chat) else ""
         print("| " + left[: left_width - 2].ljust(left_width - 2) + "| " + right[: right_width - 2].ljust(right_width - 2) + "|")
     print("+" + "-" * (left_width - 1) + "+" + "-" * (right_width) + "+")
-    footer = "Thinking/acting..." if activity else "Input: type / for live dropdown. Enter '/' for full palette. /ask calls models."
+    footer = "Thinking/acting..." if activity else "Input: type / for commands. Use mouse wheel or terminal scrollbar for previous output."
     print(box_text(footer, width))
     print("+" + "-" * (width - 2) + "+")
 
@@ -957,7 +1045,8 @@ def sidebar_lines(context: McpContext) -> list[str]:
         "  /ask <prompt>",
     ]
 
-
+
+
 def trim(text: str, limit: int) -> str:
     return text if len(text) <= limit else text[: limit - 1] + "…"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentram",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Async, model-agnostic Working RAM for coding agents.",
   "license": "MIT",
   "homepage": "https://github.com/trancongnghia/AGENT_RAM#readme",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentram"
-version = "0.1.9"
+version = "0.1.10"
 description = "Async, model-agnostic RAM layer for agentic coding tools."
 readme = "README.md"
 license = "MIT"
@@ -22,7 +22,7 @@ requires-python = ">=3.10"
 dependencies = []
 
 [project.optional-dependencies]
-tui = ["prompt_toolkit>=3.0"]
+tui = ["prompt_toolkit>=3.0", "textual>=0.80"]
 
 [project.urls]
 Homepage = "https://github.com/your-org/agentram"