agentram 0.1.10 → 0.1.12

package/README.md

@@ -1009,3 +1009,32 @@ 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

@@ -751,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",
@@ -771,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."

package/bin/agentram-postinstall.js

@@ -0,0 +1,38 @@
+#!/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.10",
-  "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.12",
+  "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.10"
+version = "0.1.12"
 description = "Async, model-agnostic RAM layer for agentic coding tools."
 readme = "README.md"
 license = "MIT"