agentram 0.1.9 → 0.1.11

package/README.md

@@ -998,3 +998,43 @@ 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.
+
+## npm Python Dependencies
+
+When installed through npm, AgentRAM runs a `postinstall` step that tries to install Python TUI dependencies for the Python interpreter used by `agentram`:
+
+```text
+textual>=0.80
+prompt_toolkit>=3.0
+```
+
+Set target Python before install when needed:
+
+```powershell
+$env:PYTHON="C:\Users\admin\anaconda3\python.exe"
+npm install -g agentram@latest
+```
+
+Skip automatic Python dependency install:
+
+```powershell
+$env:AGENTRAM_SKIP_PY_DEPS="1"
+npm install -g agentram@latest
+```
+
+If auto install fails, install manually:
+
+```powershell
+python -m pip install textual prompt_toolkit
+```

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:
@@ -663,12 +751,7 @@ def supervisor_workflow_text(context: McpContext, prompt: str) -> str:
                 outputs[slot] = f"error: {model_error_hint(str(error))}"
     if not main_agent:
         outputs["main"] = "No main agent bound. Use /bind-agent main <provider> <model>."
-    if small_agent and outputs.get("small") and not outputs["small"].startswith("error:"):
-        call_tool(
-            context,
-            "agentram_emit_event",
-            {"type": "DECISION", "payload": {"content": outputs["small"]}, "task_id": "codex", "ingest": True},
-        )
+    persist_workflow_memory(context, prompt, plan, outputs)
     return "\n".join(
         [
             "Workflow: supervisor -> main + small -> merge",
@@ -683,6 +766,28 @@ def supervisor_workflow_text(context: McpContext, prompt: str) -> str:
         ]
     )
 
+def persist_workflow_memory(context: McpContext, prompt: str, plan: str, outputs: dict[str, str]) -> None:
+    small_notes = outputs.get("small", "").strip()
+    main_result = outputs.get("main", "").strip()
+    note_parts = [
+        f"User request: {prompt}",
+        f"Supervisor plan: {trim(plan.strip(), 1200)}" if plan.strip() else "Supervisor plan: -",
+    ]
+    if small_notes and not small_notes.startswith("error:"):
+        note_parts.append(f"Small memory notes: {trim(small_notes, 1200)}")
+    else:
+        note_parts.append("Small memory notes: unavailable; persisted supervisor plan as fallback RAM note.")
+    if main_result and not main_result.startswith("error:"):
+        note_parts.append(f"Main result summary: {trim(main_result, 600)}")
+    content = "\n".join(note_parts).strip()
+    if not content:
+        return
+    call_tool(
+        context,
+        "agentram_emit_event",
+        {"type": "DECISION", "payload": {"content": content}, "task_id": "codex", "ingest": True},
+    )
+
 def supervisor_plan(supervisor: AgentModelEndpoint | None, prompt: str, memory_context: str) -> str:
     if not supervisor:
         return "No supervisor bound. Fallback plan: handle user request, run main coding agent, ask small agent to update RAM notes."
@@ -908,7 +1013,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 +1022,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 +1062,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/bin/agentram-postinstall.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+const { spawnSync } = require("node:child_process");
+
+if (process.env.AGENTRAM_SKIP_PY_DEPS === "1") {
+  console.log("AgentRAM: skip Python TUI deps because AGENTRAM_SKIP_PY_DEPS=1");
+  process.exit(0);
+}
+
+const candidates = process.env.PYTHON ? [process.env.PYTHON] : ["python", ...(process.platform === "win32" ? ["py"] : [])];
+const deps = ["textual>=0.80", "prompt_toolkit>=3.0"];
+
+function runPython(command, args) {
+  const finalArgs = command === "py" ? ["-3", ...args] : args;
+  return spawnSync(command, finalArgs, { stdio: "inherit" });
+}
+
+let lastError = null;
+for (const command of candidates) {
+  const probe = runPython(command, ["-c", "import sys; print(sys.executable)"]);
+  if (probe.error || probe.status !== 0) {
+    lastError = probe.error || new Error(`${command} exited ${probe.status}`);
+    continue;
+  }
+  console.log(`AgentRAM: installing Python TUI deps with ${command}`);
+  const install = runPython(command, ["-m", "pip", "install", ...deps]);
+  if (!install.error && install.status === 0) {
+    process.exit(0);
+  }
+  lastError = install.error || new Error(`${command} pip install exited ${install.status}`);
+}
+
+console.warn("AgentRAM: Python TUI deps were not installed automatically.");
+console.warn("AgentRAM: run `python -m pip install textual prompt_toolkit` manually, or set PYTHON to the target interpreter.");
+if (lastError) console.warn(`AgentRAM: ${lastError.message}`);
+process.exit(process.env.AGENTRAM_STRICT_POSTINSTALL === "1" ? 1 : 0);

package/package.json

@@ -1,51 +1,52 @@
-{
-  "name": "agentram",
-  "version": "0.1.9",
-  "description": "Async, model-agnostic Working RAM for coding agents.",
-  "license": "MIT",
-  "homepage": "https://github.com/trancongnghia/AGENT_RAM#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/trancongnghia/AGENT_RAM.git"
-  },
-  "bugs": {
-    "url": "https://github.com/trancongnghia/AGENT_RAM/issues"
-  },
-  "keywords": [
-    "agent",
-    "memory",
-    "codex",
-    "claude",
-    "mcp",
-    "llm"
-  ],
-  "bin": {
-    "agentram": "bin/agentram.js",
-    "agentram-mcp": "bin/agentram-mcp.js"
-  },
-  "scripts": {
-    "agentram": "node bin/agentram.js",
-    "agentram:mcp": "node bin/agentram-mcp.js",
-    "test": "python -m pytest -q",
-    "pack:dry-run": "npm pack --dry-run",
-    "prepublishOnly": "npm test"
-  },
-  "files": [
-    "agentram/*.py",
-    "bin/*.js",
-    ".claude/agents/*.md",
-    ".claude/commands/*.md",
-    "agentram_mcp_server.py",
-    "agentram_daemon.py",
-    "codex_ram.py",
-    "pyproject.toml",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=16"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "agentram",
+  "version": "0.1.11",
+  "description": "Async, model-agnostic Working RAM for coding agents.",
+  "license": "MIT",
+  "homepage": "https://github.com/trancongnghia/AGENT_RAM#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trancongnghia/AGENT_RAM.git"
+  },
+  "bugs": {
+    "url": "https://github.com/trancongnghia/AGENT_RAM/issues"
+  },
+  "keywords": [
+    "agent",
+    "memory",
+    "codex",
+    "claude",
+    "mcp",
+    "llm"
+  ],
+  "bin": {
+    "agentram": "bin/agentram.js",
+    "agentram-mcp": "bin/agentram-mcp.js"
+  },
+  "scripts": {
+    "agentram": "node bin/agentram.js",
+    "agentram:mcp": "node bin/agentram-mcp.js",
+    "test": "python -m pytest -q",
+    "pack:dry-run": "npm pack --dry-run",
+    "prepublishOnly": "npm test",
+    "postinstall": "node bin/agentram-postinstall.js"
+  },
+  "files": [
+    "agentram/*.py",
+    "bin/*.js",
+    ".claude/agents/*.md",
+    ".claude/commands/*.md",
+    "agentram_mcp_server.py",
+    "agentram_daemon.py",
+    "codex_ram.py",
+    "pyproject.toml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentram"
-version = "0.1.9"
+version = "0.1.11"
 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"