nexo-brain 0.1.2 → 0.2.1

package/README.md

@@ -239,6 +239,67 @@ NEXO isn't just engineering — it's applied cognitive psychology:
 | Synaptic Pruning | Automated cleanup of weak, unused memories |
 | Associative Memory | Semantic search finds related concepts, not just matching words |
 
+## OpenClaw Integration
+
+NEXO Brain works as a cognitive memory backend for [OpenClaw](https://github.com/openclaw/openclaw). Three integration paths, from instant to deep:
+
+### Path 1: MCP Bridge (Zero Code — Works Now)
+
+Add NEXO Brain to your OpenClaw config at `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "nexo-brain": {
+        "command": "python3",
+        "args": ["~/.nexo/src/server.py"],
+        "env": {
+          "NEXO_HOME": "~/.nexo"
+        }
+      }
+    }
+  }
+}
+```
+
+Or via CLI:
+
+```bash
+openclaw mcp set nexo-brain '{"command":"python3","args":["~/.nexo/src/server.py"],"env":{"NEXO_HOME":"~/.nexo"}}'
+openclaw gateway restart
+```
+
+All 76 NEXO tools become available to your OpenClaw agent immediately.
+
+> **First time?** Run `npx nexo-brain` first to install the cognitive engine and dependencies.
+
+### Path 2: ClawHub Skill (Install in Seconds)
+
+```bash
+npx clawhub@latest install nexo-brain
+```
+
+### Path 3: Native Memory Plugin (Replaces Default Memory)
+
+```bash
+npm install @wazionapps/openclaw-memory-nexo-brain
+```
+
+Configure in `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "slots": {
+      "memory": "memory-nexo-brain"
+    }
+  }
+}
+```
+
+This replaces OpenClaw's default memory system with NEXO's full cognitive architecture — Atkinson-Shiffrin memory, semantic RAG, trust scoring, guard system, and all 76 tools.
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Issues and PRs welcome.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO — Cognitive co-operator for Claude Code. Atkinson-Shiffrin memory, semantic RAG, trust scoring, and metacognitive error prevention.",
   "bin": {
@@ -13,7 +13,9 @@
     "memory",
     "ai-assistant",
     "vector-search",
-    "atkinson-shiffrin"
+    "atkinson-shiffrin",
+    "openclaw",
+    "openclaw-plugin"
   ],
   "author": "Francisco Garcia <hello@wazion.com>",
   "license": "MIT",

package/src/db.py

@@ -10,6 +10,7 @@ import pathlib
 from pathlib import Path
 
 NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(Path.home() / ".nexo")))
+NEXO_HOME.mkdir(parents=True, exist_ok=True)
 
 DB_PATH = os.environ.get(
     "NEXO_TEST_DB",
@@ -20,7 +21,7 @@ DB_PATH = os.environ.get(
 )
 
 # TTLs in seconds
-SESSION_STALE_SECONDS = 3600   # 1 hour
+SESSION_STALE_SECONDS = 900    # 15 min (documented TTL)
 MESSAGE_TTL_SECONDS = 3600     # 1 hour
 QUESTION_TTL_SECONDS = 600     # 10 min
 

package/src/server.py

@@ -86,6 +86,16 @@ def nexo_heartbeat(sid: str, task: str) -> str:
     return handle_heartbeat(sid, task)
 
 
+@mcp.tool
+def nexo_stop(sid: str) -> str:
+    """Cleanly close a session. Removes it from active sessions immediately.
+
+    Call this when ending a conversation to avoid ghost sessions.
+    Args:
+        sid: Session ID to close."""
+    from tools_sessions import handle_stop
+    return handle_stop(sid)
+
 @mcp.tool
 def nexo_status(keyword: str = "") -> str:
     """List active sessions. Filter by keyword if provided."""

package/src/tools_sessions.py

@@ -149,6 +149,12 @@ def handle_heartbeat(sid: str, task: str, context_hint: str = '') -> str:
     return "\n".join(parts)
 
 
+def handle_stop(sid: str) -> str:
+    """Cleanly close a session, removing it from active sessions immediately."""
+    complete_session(sid)
+    return f"Sesión {sid} cerrada."
+
+
 def handle_status(keyword: str | None = None) -> str:
     """List active sessions, optionally filtered by keyword."""
     clean_stale_sessions()

package/templates/openclaw.json

@@ -0,0 +1,13 @@
+{
+  "mcp": {
+    "servers": {
+      "nexo-brain": {
+        "command": "python3",
+        "args": ["~/.nexo/src/server.py"],
+        "env": {
+          "NEXO_HOME": "~/.nexo"
+        }
+      }
+    }
+  }
+}