NWcortex 1.0.2__tar.gz → 1.0.3__tar.gz

{nwcortex-1.0.2 → nwcortex-1.0.3}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Thatgfsj
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Thatgfsj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{nwcortex-1.0.2 → nwcortex-1.0.3}/MANIFEST.in

@@ -1,10 +1,11 @@
-include README.md
-include LICENSE
-include star_graph/defaults.yaml
-recursive-include examples *.py
-prune venv
-prune dist
-prune build
-prune .git
-prune __pycache__
-global-exclude *.pyc
+include README.md
+include LICENSE
+include star_graph/defaults.yaml
+recursive-include star_graph/contrib *.py
+recursive-include examples *.py
+prune venv
+prune dist
+prune build
+prune .git
+prune __pycache__
+global-exclude *.pyc

{nwcortex-1.0.2 → nwcortex-1.0.3/NWcortex.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: NWcortex
-Version: 1.0.2
+Version: 1.0.3
 Summary: NeuroWeave Cortex (NWC) — Graph-first cognitive memory runtime for AI agents. Hippocampal-inspired architecture with domain routing, spreading activation, edge budget management, 4-layer compression, thermal storage, personality modeling, and 8-phase sleep consolidation.
 Author-email: Thatgfsj <thatgfsj@users.noreply.github.com>
 License: MIT
@@ -24,6 +24,11 @@ Requires-Dist: PyYAML>=6.0
 Requires-Dist: scikit-learn>=1.3.0
 Provides-Extra: embeddings
 Requires-Dist: sentence-transformers>=2.2.0; extra == "embeddings"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: all
+Requires-Dist: sentence-transformers>=2.2.0; extra == "all"
+Requires-Dist: mcp>=1.0.0; extra == "all"
 Dynamic: license-file
 
 # NeuroWeave Cortex (NWC) — Cognitive Memory Runtime
@@ -264,11 +269,14 @@ See `star_graph/defaults.yaml` for all 300+ tunable parameters.
 # From PyPI (package name: NWcortex, import as: star_graph)
 pip install NWcortex
 
-# With sentence-transformers for semantic embeddings (~2GB model download on first use)
+# With sentence-transformers for semantic embeddings
 pip install "NWcortex[embeddings]"
 
-# Optional: for SQLite storage backend
-pip install aiosqlite
+# With MCP server support (for AI agent integration)
+pip install "NWcortex[mcp]"
+
+# Everything
+pip install "NWcortex[all]"
 
 # Run demo
 python examples/emergence_demo.py
@@ -276,6 +284,91 @@ python examples/emergence_demo.py
 
 **Note:** Without `[embeddings]`, the system uses a lightweight TF-IDF fallback for text encoding. Install `sentence-transformers` only if you need semantic-quality embeddings.
 
+## MCP Server — AI Agent Integration
+
+NeuroWeave Cortex ships with a [Model Context Protocol](https://modelcontextprotocol.io) server. Connect any MCP-compatible AI agent (Claude Desktop, OpenClaw, Cursor, etc.) for persistent cognitive memory across conversations.
+
+### Quick start
+
+```bash
+# Install with MCP support
+pip install "NWcortex[mcp]"
+
+# Launch the MCP server on stdio
+nwc-mcp
+
+# With persistent storage
+nwc-mcp --storage agent_memory.json
+
+# Load a previously saved memory graph
+nwc-mcp --load my_memories.json
+```
+
+### Tool reference (12 tools)
+
+| Tool | Description |
+|------|-------------|
+| `remember` | Store a long-term memory (tags, importance, emotional valence) |
+| `remember_working` | Store in fast ephemeral working-memory buffer (current task context) |
+| `recall` | Context-aware semantic retrieval with task-type routing |
+| `forget` | Remove a memory, creating a ghost trace for potential fuzzy recall |
+| `sleep` | Run 5-phase sleep consolidation — merges, prunes, forms schemas |
+| `consolidate` | Micro-consolidation — incremental, non-blocking |
+| `stats` | Memory system statistics (anchors, edges, ghosts, schemas, cognitive health) |
+| `fuzzy_recall` | Low-confidence recall from ghost traces ("I seem to remember...") |
+| `get_profile` | Inferred user profile from accumulated memories |
+| `evolve` | Memory evolution cycle (decay, boost, conflict resolution) |
+| `save` | Persist memory graph to disk (JSON) |
+| `load` | Load memory graph from disk (JSON) |
+
+### Claude Desktop config
+
+```json
+{
+  "mcpServers": {
+    "neuroweave-cortex": {
+      "command": "nwc-mcp",
+      "args": ["--storage", "/path/to/agent_memory.json"]
+    }
+  }
+}
+```
+
+### OpenClaw config
+
+```json
+{
+  "mcpServers": {
+    "neuroweave-cortex": {
+      "command": "nwc-mcp",
+      "args": ["--storage", "/path/to/agent_memory.json"]
+    }
+  }
+}
+```
+
+## REST API Server
+
+```bash
+# Start the REST server
+nwc-server --port 8420
+
+# Or via module
+python -m star_graph.server --port 8420
+```
+
+Endpoints:
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/health` | Health check with anchor/edge counts |
+| GET | `/metrics` | Prometheus-format metrics |
+| GET | `/stats` | Full memory system statistics |
+| POST | `/remember` | Store a memory `{"text": "...", "tags": [...]}` |
+| POST | `/recall` | Retrieve memories `{"query": "...", "max_items": 10}` |
+| POST | `/sleep` | Run sleep consolidation |
+| POST | `/consolidate` | Run micro-consolidation |
+
 ## Interactive Demo
 
 ```bash

{nwcortex-1.0.2 → nwcortex-1.0.3}/NWcortex.egg-info/entry_points.txt

@@ -1,4 +1,6 @@
 [console_scripts]
+nwc-mcp = star_graph.mcp_server:entry
+nwc-server = star_graph.server:entry
 sg-add = star_graph.cli:add
 sg-query = star_graph.cli:query
 sg-sleep = star_graph.cli:sleep_cmd

{nwcortex-1.0.2 → nwcortex-1.0.3}/NWcortex.egg-info/requires.txt

@@ -2,5 +2,12 @@ numpy>=1.24.0
 PyYAML>=6.0
 scikit-learn>=1.3.0
 
+[all]
+sentence-transformers>=2.2.0
+mcp>=1.0.0
+
 [embeddings]
 sentence-transformers>=2.2.0
+
+[mcp]
+mcp>=1.0.0

{nwcortex-1.0.2/NWcortex.egg-info → nwcortex-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: NWcortex
-Version: 1.0.2
+Version: 1.0.3
 Summary: NeuroWeave Cortex (NWC) — Graph-first cognitive memory runtime for AI agents. Hippocampal-inspired architecture with domain routing, spreading activation, edge budget management, 4-layer compression, thermal storage, personality modeling, and 8-phase sleep consolidation.
 Author-email: Thatgfsj <thatgfsj@users.noreply.github.com>
 License: MIT
@@ -24,6 +24,11 @@ Requires-Dist: PyYAML>=6.0
 Requires-Dist: scikit-learn>=1.3.0
 Provides-Extra: embeddings
 Requires-Dist: sentence-transformers>=2.2.0; extra == "embeddings"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: all
+Requires-Dist: sentence-transformers>=2.2.0; extra == "all"
+Requires-Dist: mcp>=1.0.0; extra == "all"
 Dynamic: license-file
 
 # NeuroWeave Cortex (NWC) — Cognitive Memory Runtime
@@ -264,11 +269,14 @@ See `star_graph/defaults.yaml` for all 300+ tunable parameters.
 # From PyPI (package name: NWcortex, import as: star_graph)
 pip install NWcortex
 
-# With sentence-transformers for semantic embeddings (~2GB model download on first use)
+# With sentence-transformers for semantic embeddings
 pip install "NWcortex[embeddings]"
 
-# Optional: for SQLite storage backend
-pip install aiosqlite
+# With MCP server support (for AI agent integration)
+pip install "NWcortex[mcp]"
+
+# Everything
+pip install "NWcortex[all]"
 
 # Run demo
 python examples/emergence_demo.py
@@ -276,6 +284,91 @@ python examples/emergence_demo.py
 
 **Note:** Without `[embeddings]`, the system uses a lightweight TF-IDF fallback for text encoding. Install `sentence-transformers` only if you need semantic-quality embeddings.
 
+## MCP Server — AI Agent Integration
+
+NeuroWeave Cortex ships with a [Model Context Protocol](https://modelcontextprotocol.io) server. Connect any MCP-compatible AI agent (Claude Desktop, OpenClaw, Cursor, etc.) for persistent cognitive memory across conversations.
+
+### Quick start
+
+```bash
+# Install with MCP support
+pip install "NWcortex[mcp]"
+
+# Launch the MCP server on stdio
+nwc-mcp
+
+# With persistent storage
+nwc-mcp --storage agent_memory.json
+
+# Load a previously saved memory graph
+nwc-mcp --load my_memories.json
+```
+
+### Tool reference (12 tools)
+
+| Tool | Description |
+|------|-------------|
+| `remember` | Store a long-term memory (tags, importance, emotional valence) |
+| `remember_working` | Store in fast ephemeral working-memory buffer (current task context) |
+| `recall` | Context-aware semantic retrieval with task-type routing |
+| `forget` | Remove a memory, creating a ghost trace for potential fuzzy recall |
+| `sleep` | Run 5-phase sleep consolidation — merges, prunes, forms schemas |
+| `consolidate` | Micro-consolidation — incremental, non-blocking |
+| `stats` | Memory system statistics (anchors, edges, ghosts, schemas, cognitive health) |
+| `fuzzy_recall` | Low-confidence recall from ghost traces ("I seem to remember...") |
+| `get_profile` | Inferred user profile from accumulated memories |
+| `evolve` | Memory evolution cycle (decay, boost, conflict resolution) |
+| `save` | Persist memory graph to disk (JSON) |
+| `load` | Load memory graph from disk (JSON) |
+
+### Claude Desktop config
+
+```json
+{
+  "mcpServers": {
+    "neuroweave-cortex": {
+      "command": "nwc-mcp",
+      "args": ["--storage", "/path/to/agent_memory.json"]
+    }
+  }
+}
+```
+
+### OpenClaw config
+
+```json
+{
+  "mcpServers": {
+    "neuroweave-cortex": {
+      "command": "nwc-mcp",
+      "args": ["--storage", "/path/to/agent_memory.json"]
+    }
+  }
+}
+```
+
+## REST API Server
+
+```bash
+# Start the REST server
+nwc-server --port 8420
+
+# Or via module
+python -m star_graph.server --port 8420
+```
+
+Endpoints:
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/health` | Health check with anchor/edge counts |
+| GET | `/metrics` | Prometheus-format metrics |
+| GET | `/stats` | Full memory system statistics |
+| POST | `/remember` | Store a memory `{"text": "...", "tags": [...]}` |
+| POST | `/recall` | Retrieve memories `{"query": "...", "max_items": 10}` |
+| POST | `/sleep` | Run sleep consolidation |
+| POST | `/consolidate` | Run micro-consolidation |
+
 ## Interactive Demo
 
 ```bash