nexo-brain 0.2.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.md +19 -7
  2. package/package.json +2 -2
  3. package/src/cognitive.py +1549 -56
  4. package/src/db.py +50 -25
  5. package/src/hooks/auto_capture.py +208 -0
  6. package/src/plugins/cognitive_memory.py +276 -17
  7. package/src/scripts/nexo-catchup.py +32 -15
  8. package/src/scripts/nexo-cognitive-decay.py +2 -4
  9. package/src/scripts/nexo-daily-self-audit.py +148 -29
  10. package/src/scripts/nexo-immune.py +869 -0
  11. package/src/scripts/nexo-postmortem-consolidator.py +42 -40
  12. package/src/scripts/nexo-sleep.py +90 -39
  13. package/src/scripts/nexo-synthesis.py +78 -76
  14. package/src/server.py +10 -0
  15. package/src/tools_sessions.py +8 -2
  16. package/templates/CLAUDE.md 2.template +1 -1
  17. package/templates/CLAUDE.md.template +1 -1
  18. package/src/cognitive 2.py +0 -1224
  19. package/src/db 2.py +0 -2283
  20. package/src/plugin_loader 2.py +0 -136
  21. package/src/server 2.py +0 -560
  22. package/src/tools_coordination 2.py +0 -102
  23. package/src/tools_credentials 2.py +0 -64
  24. package/src/tools_learnings 2.py +0 -180
  25. package/src/tools_menu 2.py +0 -208
  26. package/src/tools_reminders 2.py +0 -80
  27. package/src/tools_reminders_crud 2.py +0 -157
  28. package/src/tools_sessions 2.py +0 -169
  29. package/src/tools_task_history 2.py +0 -57
package/README.md CHANGED
@@ -162,7 +162,7 @@ That's it. No need to run `claude` manually. Atlas will greet you immediately
162
162
  | Component | What | Where |
163
163
  |-----------|------|-------|
164
164
  | Cognitive engine | Python: fastembed, numpy, vector search | pip packages |
165
- | MCP server | 76 tools for memory, learning, guard | ~/.nexo/ |
165
+ | MCP server | 77 tools for memory, learning, guard | ~/.nexo/ |
166
166
  | Plugins | Guard, episodic memory, cognitive memory, entities, preferences | ~/.nexo/plugins/ |
167
167
  | Hooks | Session capture, briefing, stop detection | ~/.nexo/hooks/ |
168
168
  | LaunchAgents | Decay, sleep, audit, postmortem, catch-up | ~/Library/LaunchAgents/ |
@@ -173,19 +173,19 @@ That's it. No need to run `claude` manually. Atlas will greet you immediately
173
173
 
174
174
  - **macOS** (Linux support planned)
175
175
  - **Node.js 18+** (for the installer)
176
- - **Claude Opus (latest version) strongly recommended.** NEXO provides 76 MCP tools across 16 categories. This cognitive load requires a top-tier model with large context window. Smaller models (Haiku, Sonnet) may struggle with tool selection and produce inconsistent results. Opus handles all 76 tools without hesitation.
176
+ - **Claude Opus (latest version) strongly recommended.** NEXO provides 77 MCP tools across 16 categories. This cognitive load requires a top-tier model with large context window. Smaller models (Haiku, Sonnet) may struggle with tool selection and produce inconsistent results. Opus handles all 77 tools without hesitation.
177
177
  - Python 3, Homebrew, and Claude Code are installed automatically if missing.
178
178
 
179
179
  ## Architecture
180
180
 
181
- ### 76 MCP Tools across 16 Categories
181
+ ### 77 MCP Tools across 16 Categories
182
182
 
183
183
  | Category | Count | Tools | Purpose |
184
184
  |----------|-------|-------|---------|
185
185
  | Cognitive | 8 | retrieve, stats, inspect, metrics, dissonance, resolve, sentiment, trust | The brain — memory, RAG, trust, mood |
186
186
  | Guard | 3 | check, stats, log_repetition | Metacognitive error prevention |
187
187
  | Episodic | 10 | change_log/search/commit, decision_log/outcome/search, review_queue, diary_write/read, recall | What happened and why |
188
- | Sessions | 3 | startup, heartbeat, status | Session lifecycle + context shift detection |
188
+ | Sessions | 4 | startup, heartbeat, stop, status | Session lifecycle + context shift detection |
189
189
  | Coordination | 7 | track, untrack, files, send, ask, answer, check_answer | Multi-session file coordination + messaging |
190
190
  | Reminders | 5 | list, create, update, complete, delete | User's tasks and deadlines |
191
191
  | Followups | 4 | create, update, complete, delete | System's autonomous verification tasks |
@@ -270,7 +270,7 @@ openclaw mcp set nexo-brain '{"command":"python3","args":["~/.nexo/src/server.py
270
270
  openclaw gateway restart
271
271
  ```
272
272
 
273
- All 76 NEXO tools become available to your OpenClaw agent immediately.
273
+ All 77 NEXO tools become available to your OpenClaw agent immediately.
274
274
 
275
275
  > **First time?** Run `npx nexo-brain` first to install the cognitive engine and dependencies.
276
276
 
@@ -298,7 +298,19 @@ Configure in `~/.openclaw/openclaw.json`:
298
298
  }
299
299
  ```
300
300
 
301
- 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.
301
+ This replaces OpenClaw's default memory system with NEXO's full cognitive architecture — Atkinson-Shiffrin memory, semantic RAG, trust scoring, guard system, and all 77 tools.
302
+
303
+ ## Listed On
304
+
305
+ | Directory | Type | Link |
306
+ |-----------|------|------|
307
+ | npm | Package | [nexo-brain](https://www.npmjs.com/package/nexo-brain) |
308
+ | Glama | MCP Directory | [glama.ai](https://glama.ai/mcp/servers/@wazionapps/nexo) |
309
+ | mcp.so | MCP Directory | [mcp.so](https://mcp.so/server/nexo/wazionapps) |
310
+ | mcpservers.org | MCP Directory | [mcpservers.org](https://mcpservers.org) |
311
+ | OpenClaw | Native Plugin | [openclaw.com](https://openclaw.ai) |
312
+ | dev.to | Technical Article | [How I Applied Cognitive Psychology to AI Agents](https://dev.to/wazionapps/how-i-applied-cognitive-psychology-to-give-ai-agents-real-memory-2oce) |
313
+ | nexo-brain.com | Official Website | [nexo-brain.com](https://nexo-brain.com) |
302
314
 
303
315
  ## Contributing
304
316
 
@@ -310,4 +322,4 @@ MIT — see [LICENSE](LICENSE)
310
322
 
311
323
  ---
312
324
 
313
- Built by [WAzion](https://wazion.com) | Created by Francisco Garcia
325
+ Built by [WAzion](https://www.wazion.com)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nexo-brain",
3
- "version": "0.2.0",
3
+ "version": "0.3.1",
4
4
  "mcpName": "io.github.wazionapps/nexo",
5
5
  "description": "NEXO — Cognitive co-operator for Claude Code. Atkinson-Shiffrin memory, semantic RAG, trust scoring, and metacognitive error prevention.",
6
6
  "bin": {
@@ -17,7 +17,7 @@
17
17
  "openclaw",
18
18
  "openclaw-plugin"
19
19
  ],
20
- "author": "Francisco Garcia <hello@wazion.com>",
20
+ "author": "WAzion Apps <hello@wazion.com>",
21
21
  "license": "MIT",
22
22
  "repository": {
23
23
  "type": "git",