synapse-layer 1.2.0__tar.gz → 1.2.1__tar.gz

synapse_layer-1.2.1/PKG-INFO

@@ -0,0 +1,306 @@
+Metadata-Version: 2.4
+Name: synapse-layer
+Version: 1.2.1
+Summary: Persistent memory infrastructure for AI agents — AES-256-GCM encrypted at rest, semantic search, MCP-native.
+Author-email: Ismael Marchi <founder.synapselayer@proton.me>
+License: Apache 2.0
+Project-URL: Homepage, https://synapselayer.org
+Project-URL: Repository, https://github.com/SynapseLayer/synapse-layer
+Project-URL: Documentation, https://synapselayer.org/docs
+Project-URL: Issues, https://github.com/SynapseLayer/synapse-layer/issues
+Project-URL: Changelog, https://github.com/SynapseLayer/synapse-layer/blob/main/CHANGELOG.md
+Project-URL: Security, https://github.com/SynapseLayer/synapse-layer/blob/main/SECURITY.md
+Keywords: mcp,memory,ai-agents,pgvector,encryption,persistent-memory,agentic-ai,cross-agent-memory
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=46.0.7
+Requires-Dist: pydantic>=2.4.0
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.3.0; extra == "langchain"
+Provides-Extra: crewai
+Requires-Dist: crewai>=1.14.0; extra == "crewai"
+Provides-Extra: autogen
+Requires-Dist: autogen-core>=0.7.0; extra == "autogen"
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.11.0; extra == "llamaindex"
+Provides-Extra: semantic-kernel
+Requires-Dist: semantic-kernel>=1.0.0; extra == "semantic-kernel"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: respx>=0.21.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: isort>=5.13.0; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: ruff>=0.3.0; extra == "dev"
+Dynamic: license-file
+
+[![npm version](https://badge.fury.io/js/synapse-layer.svg)](https://www.npmjs.com/package/synapse-layer)
+[![npm version](https://badge.fury.io/js/synapse-layer.svg)](https://www.npmjs.com/package/synapse-layer)
+[![npm downloads](https://img.shields.io/npm/dm/synapse-layer.svg)](https://www.npmjs.com/package/synapse-layer)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+[![npm downloads](https://img.shields.io/npm/dm/synapse-layer.svg)](https://www.npmjs.com/package/synapse-layer)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+<div align="center">
+
+# 🧠 Synapse Layer
+
+### RAG retrieves. Synapse remembers.
+
+**Persistent memory infrastructure for AI agents — AES-256-GCM encrypted at rest, semantic search, MCP-native.**
+
+Synapse Layer is open-source persistent memory infrastructure for AI agents and assistants. Memories are encrypted at rest with AES-256-GCM, indexed via pgvector HNSW for semantic recall, and exposed through MCP JSON-RPC for native integration with Claude, GPT, Gemini, and any MCP-compatible client. Apache 2.0 licensed.
+
+[![PyPI](https://img.shields.io/pypi/v/synapse-layer)](https://pypi.org/project/synapse-layer/)
+[![Python](https://img.shields.io/pypi/pyversions/synapse-layer)](https://pypi.org/project/synapse-layer/)
+[![Downloads](https://img.shields.io/pypi/dm/synapse-layer)](https://pypi.org/project/synapse-layer/)
+[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-6B4FBB)](https://modelcontextprotocol.io)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
+[![Smithery](https://smithery.ai/badge/synapselayer/synapse-protocol)](https://smithery.ai/servers/synapselayer/synapse-protocol)
+
+[Website](https://synapselayer.org) · [Docs](https://forge.synapselayer.org/docs) · [PyPI](https://pypi.org/project/synapse-layer/) · [Forge](https://forge.synapselayer.org)
+
+</div>
+
+---
+
+## ⚡ 30-Second Quickstart
+
+```bash
+pip install synapse-layer
+```
+
+```python
+from synapse_layer import Synapse
+
+s = Synapse(token="sk_connect_YOUR_TOKEN")
+
+s.save("user likes coffee")
+print(s.recall("what does user like?"))
+```
+
+Get your token at [forge.synapselayer.org](https://forge.synapselayer.org) → Dashboard → Connect
+
+---
+
+## What is Synapse Layer?
+
+The **persistent memory layer for AI agents** — the missing piece between stateless LLMs and real continuity of context.
+
+Your AI agents forget everything between sessions. Synapse Layer fixes that.
+
+| Feature | Description |
+|---------|-------------|
+| 🔐 **Encrypted at rest** | AES-256-GCM with per-operation random IV and HMAC-SHA-256 integrity |
+| 🧩 **One-click connect** | Claude Desktop, Cursor, LangChain, CrewAI, n8n |
+| 🌐 **Cross-agent memory** | Save in ChatGPT, recall in Claude |
+| ⚡ **MCP-native** | Any MCP-compatible agent |
+| 🔒 **Header-first auth** | Tokens never in URLs or logs |
+| 🎯 **Trust Quotient** | Deterministic recall — memories ranked by confidence, not recency alone |
+
+---
+
+## Why Synapse Layer?
+
+> Your AI agents forget everything between sessions. Synapse Layer fixes that — in one line.
+
+| Without Synapse Layer | With Synapse Layer |
+|---|---|
+| Agent forgets context every session | Persistent memory across all sessions |
+| Memory locked to one model | Cross-agent: save in ChatGPT, recall in Claude |
+| No audit trail | Trust Quotient scoring on every memory |
+| Complex integration | `pip install synapse-layer` + 3 lines of code |
+| Plaintext stored on servers | AES-256-GCM encrypted at rest |
+
+---
+
+## Use Cases
+
+- **Long-term assistant memory** — persist user preferences, facts, and prior decisions across sessions.
+- **Cross-agent continuity** — save context in one agent and recall it in another.
+- **Secure memory for MCP clients** — connect Claude Desktop, Cursor, and other MCP-compatible tools to a governed memory layer.
+- **Operational memory for teams** — maintain structured context, trust scoring, and searchable recall for production agents.
+
+---
+
+## Install
+
+```bash
+pip install synapse-layer
+```
+
+## Quick Start
+
+### Local SDK — in-process memory
+
+```python
+import asyncio
+from synapse_layer import SynapseClient
+
+async def main():
+    memory = SynapseClient(agent_id="my-agent")
+
+    # Save
+    await memory.store("User prefers dark mode and concise answers")
+
+    # Recall
+    results = await memory.recall("user preferences")
+    for r in results:
+        print(f"[TQ={r.trust_quotient:.2f}] {r.content}")
+
+asyncio.run(main())
+```
+
+### Cloud — Forge API (persistent, cross-agent)
+
+```python
+from synapse_memory.client import Synapse
+
+client = Synapse(token="sk_connect_YOUR_TOKEN")
+client.remember("User prefers dark mode and concise answers")
+results = client.recall("user preferences")
+for r in results:
+    print(r["content"])
+```
+
+Get your token at [forge.synapselayer.org](https://forge.synapselayer.org) → Dashboard → Connect
+
+---
+
+## 13 MCP Tools at a Glance
+
+Synapse Layer currently exposes 13 MCP tools for persistent memory workflows:
+
+- `recall`
+- `save_to_synapse`
+- `process_text`
+- `search`
+- `health_check`
+- `initialize_context`
+- `save_memory`
+- `store_memory`
+- `recall_memory`
+- `list_memories`
+- `memory_feedback`
+- `neural_handover`
+- `slo_report`
+
+These tools cover memory capture, semantic recall, structured storage, feedback loops, agent handoff, and operational observability.
+
+---
+
+## Deployment Modes
+
+### Local SDK
+Use the local SDK when you want in-process memory access inside your Python application.
+
+Best for:
+- local prototypes
+- Python-native workflows
+- fast integration into existing apps
+
+### Cloud / Forge API
+Use Forge when you need persistent, cross-session, and cross-agent memory with managed access tokens.
+
+Best for:
+- production assistants
+- multi-agent systems
+- MCP-based integrations
+- shared memory across tools and sessions
+
+---
+
+## MCP Integration (Claude Desktop / Cursor)
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "synapse-layer": {
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "https://forge.synapselayer.org/mcp",
+        "--header",
+        "x-connect-token: sk_connect_YOUR_TOKEN"
+      ]
+    }
+  }
+}
+```
+
+Config file location:
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+---
+
+## API — Header-First Auth
+
+```bash
+# Health check
+curl -H "x-connect-token: sk_connect_YOUR_TOKEN" \
+  https://forge.synapselayer.org/api/connect/health
+
+# Save memory
+curl -X POST \
+  -H "x-connect-token: sk_connect_YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"content": "User is a Python developer"}' \
+  https://forge.synapselayer.org/api/v1/capture
+```
+
+---
+
+## Security
+
+| Feature | Implementation |
+|---------|---------------|
+| Encryption | AES-256-GCM at rest with per-operation random IV |
+| Integrity | HMAC-SHA-256 on content |
+| Auth | Header-first (`x-connect-token`) — tokens never in URLs or logs |
+| Privacy | Content sanitization + tenant-scoped encrypted storage |
+| Isolation | 1 user = 1 tenant = 1 private mind |
+
+See [SECURITY.md](SECURITY.md) for vulnerability reporting.
+
+---
+
+## Related Projects
+
+| Project | Description |
+|---------|-------------|
+| [synapse-sdk-python](https://github.com/SynapseLayer/synapse-sdk-python) | Python SDK — LangChain, CrewAI, and A2A protocol adapters |
+| [synapse-layer-skill](https://github.com/SynapseLayer/synapse-layer-skill) | MCP skill configuration for Claude Desktop, Cursor, Windsurf |
+| [synapse-layer-langgraph](https://github.com/SynapseLayer/synapse-layer-langgraph) | LangGraph checkpoint saver with encrypted state persistence |
+
+---
+
+## Governance
+
+- All public claims follow the [Public Claims Matrix](docs/PUBLIC_CLAIMS_MATRIX.md).
+- Architecture details that reveal benefits are public; mechanisms that enable them are private.
+- Claim = Reality. If it's not implemented, it's not in the README.
+
+---
+
+## License
+
+Apache-2.0 © Synapse Layer

synapse_layer-1.2.1/README.md

@@ -0,0 +1,256 @@
+[![npm version](https://badge.fury.io/js/synapse-layer.svg)](https://www.npmjs.com/package/synapse-layer)
+[![npm version](https://badge.fury.io/js/synapse-layer.svg)](https://www.npmjs.com/package/synapse-layer)
+[![npm downloads](https://img.shields.io/npm/dm/synapse-layer.svg)](https://www.npmjs.com/package/synapse-layer)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+[![npm downloads](https://img.shields.io/npm/dm/synapse-layer.svg)](https://www.npmjs.com/package/synapse-layer)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+<div align="center">
+
+# 🧠 Synapse Layer
+
+### RAG retrieves. Synapse remembers.
+
+**Persistent memory infrastructure for AI agents — AES-256-GCM encrypted at rest, semantic search, MCP-native.**
+
+Synapse Layer is open-source persistent memory infrastructure for AI agents and assistants. Memories are encrypted at rest with AES-256-GCM, indexed via pgvector HNSW for semantic recall, and exposed through MCP JSON-RPC for native integration with Claude, GPT, Gemini, and any MCP-compatible client. Apache 2.0 licensed.
+
+[![PyPI](https://img.shields.io/pypi/v/synapse-layer)](https://pypi.org/project/synapse-layer/)
+[![Python](https://img.shields.io/pypi/pyversions/synapse-layer)](https://pypi.org/project/synapse-layer/)
+[![Downloads](https://img.shields.io/pypi/dm/synapse-layer)](https://pypi.org/project/synapse-layer/)
+[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-6B4FBB)](https://modelcontextprotocol.io)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
+[![Smithery](https://smithery.ai/badge/synapselayer/synapse-protocol)](https://smithery.ai/servers/synapselayer/synapse-protocol)
+
+[Website](https://synapselayer.org) · [Docs](https://forge.synapselayer.org/docs) · [PyPI](https://pypi.org/project/synapse-layer/) · [Forge](https://forge.synapselayer.org)
+
+</div>
+
+---
+
+## ⚡ 30-Second Quickstart
+
+```bash
+pip install synapse-layer
+```
+
+```python
+from synapse_layer import Synapse
+
+s = Synapse(token="sk_connect_YOUR_TOKEN")
+
+s.save("user likes coffee")
+print(s.recall("what does user like?"))
+```
+
+Get your token at [forge.synapselayer.org](https://forge.synapselayer.org) → Dashboard → Connect
+
+---
+
+## What is Synapse Layer?
+
+The **persistent memory layer for AI agents** — the missing piece between stateless LLMs and real continuity of context.
+
+Your AI agents forget everything between sessions. Synapse Layer fixes that.
+
+| Feature | Description |
+|---------|-------------|
+| 🔐 **Encrypted at rest** | AES-256-GCM with per-operation random IV and HMAC-SHA-256 integrity |
+| 🧩 **One-click connect** | Claude Desktop, Cursor, LangChain, CrewAI, n8n |
+| 🌐 **Cross-agent memory** | Save in ChatGPT, recall in Claude |
+| ⚡ **MCP-native** | Any MCP-compatible agent |
+| 🔒 **Header-first auth** | Tokens never in URLs or logs |
+| 🎯 **Trust Quotient** | Deterministic recall — memories ranked by confidence, not recency alone |
+
+---
+
+## Why Synapse Layer?
+
+> Your AI agents forget everything between sessions. Synapse Layer fixes that — in one line.
+
+| Without Synapse Layer | With Synapse Layer |
+|---|---|
+| Agent forgets context every session | Persistent memory across all sessions |
+| Memory locked to one model | Cross-agent: save in ChatGPT, recall in Claude |
+| No audit trail | Trust Quotient scoring on every memory |
+| Complex integration | `pip install synapse-layer` + 3 lines of code |
+| Plaintext stored on servers | AES-256-GCM encrypted at rest |
+
+---
+
+## Use Cases
+
+- **Long-term assistant memory** — persist user preferences, facts, and prior decisions across sessions.
+- **Cross-agent continuity** — save context in one agent and recall it in another.
+- **Secure memory for MCP clients** — connect Claude Desktop, Cursor, and other MCP-compatible tools to a governed memory layer.
+- **Operational memory for teams** — maintain structured context, trust scoring, and searchable recall for production agents.
+
+---
+
+## Install
+
+```bash
+pip install synapse-layer
+```
+
+## Quick Start
+
+### Local SDK — in-process memory
+
+```python
+import asyncio
+from synapse_layer import SynapseClient
+
+async def main():
+    memory = SynapseClient(agent_id="my-agent")
+
+    # Save
+    await memory.store("User prefers dark mode and concise answers")
+
+    # Recall
+    results = await memory.recall("user preferences")
+    for r in results:
+        print(f"[TQ={r.trust_quotient:.2f}] {r.content}")
+
+asyncio.run(main())
+```
+
+### Cloud — Forge API (persistent, cross-agent)
+
+```python
+from synapse_memory.client import Synapse
+
+client = Synapse(token="sk_connect_YOUR_TOKEN")
+client.remember("User prefers dark mode and concise answers")
+results = client.recall("user preferences")
+for r in results:
+    print(r["content"])
+```
+
+Get your token at [forge.synapselayer.org](https://forge.synapselayer.org) → Dashboard → Connect
+
+---
+
+## 13 MCP Tools at a Glance
+
+Synapse Layer currently exposes 13 MCP tools for persistent memory workflows:
+
+- `recall`
+- `save_to_synapse`
+- `process_text`
+- `search`
+- `health_check`
+- `initialize_context`
+- `save_memory`
+- `store_memory`
+- `recall_memory`
+- `list_memories`
+- `memory_feedback`
+- `neural_handover`
+- `slo_report`
+
+These tools cover memory capture, semantic recall, structured storage, feedback loops, agent handoff, and operational observability.
+
+---
+
+## Deployment Modes
+
+### Local SDK
+Use the local SDK when you want in-process memory access inside your Python application.
+
+Best for:
+- local prototypes
+- Python-native workflows
+- fast integration into existing apps
+
+### Cloud / Forge API
+Use Forge when you need persistent, cross-session, and cross-agent memory with managed access tokens.
+
+Best for:
+- production assistants
+- multi-agent systems
+- MCP-based integrations
+- shared memory across tools and sessions
+
+---
+
+## MCP Integration (Claude Desktop / Cursor)
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "synapse-layer": {
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "https://forge.synapselayer.org/mcp",
+        "--header",
+        "x-connect-token: sk_connect_YOUR_TOKEN"
+      ]
+    }
+  }
+}
+```
+
+Config file location:
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+---
+
+## API — Header-First Auth
+
+```bash
+# Health check
+curl -H "x-connect-token: sk_connect_YOUR_TOKEN" \
+  https://forge.synapselayer.org/api/connect/health
+
+# Save memory
+curl -X POST \
+  -H "x-connect-token: sk_connect_YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"content": "User is a Python developer"}' \
+  https://forge.synapselayer.org/api/v1/capture
+```
+
+---
+
+## Security
+
+| Feature | Implementation |
+|---------|---------------|
+| Encryption | AES-256-GCM at rest with per-operation random IV |
+| Integrity | HMAC-SHA-256 on content |
+| Auth | Header-first (`x-connect-token`) — tokens never in URLs or logs |
+| Privacy | Content sanitization + tenant-scoped encrypted storage |
+| Isolation | 1 user = 1 tenant = 1 private mind |
+
+See [SECURITY.md](SECURITY.md) for vulnerability reporting.
+
+---
+
+## Related Projects
+
+| Project | Description |
+|---------|-------------|
+| [synapse-sdk-python](https://github.com/SynapseLayer/synapse-sdk-python) | Python SDK — LangChain, CrewAI, and A2A protocol adapters |
+| [synapse-layer-skill](https://github.com/SynapseLayer/synapse-layer-skill) | MCP skill configuration for Claude Desktop, Cursor, Windsurf |
+| [synapse-layer-langgraph](https://github.com/SynapseLayer/synapse-layer-langgraph) | LangGraph checkpoint saver with encrypted state persistence |
+
+---
+
+## Governance
+
+- All public claims follow the [Public Claims Matrix](docs/PUBLIC_CLAIMS_MATRIX.md).
+- Architecture details that reveal benefits are public; mechanisms that enable them are private.
+- Claim = Reality. If it's not implemented, it's not in the README.
+
+---
+
+## License
+
+Apache-2.0 © Synapse Layer

{synapse_layer-1.2.0 → synapse_layer-1.2.1}/pyproject.toml

@@ -4,23 +4,21 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "synapse-layer"
-version = "1.2.0"
-description = "Zero-Knowledge Memory Layer for AI Agents — Cognitive Security Protocol with 4 proprietary seals. Giving Agents a Past. Giving Models a Soul."
+version = "1.2.1"
+description = "Persistent memory infrastructure for AI agents — AES-256-GCM encrypted at rest, semantic search, MCP-native."
 readme = "README.md"
 license = {text = "Apache 2.0"}
 authors = [{name = "Ismael Marchi", email = "founder.synapselayer@proton.me"}]
 
 keywords = [
-  "ai-agents",
+  "mcp",
   "memory",
-  "zero-knowledge",
+  "ai-agents",
+  "pgvector",
   "encryption",
-  "mcp",
+  "persistent-memory",
   "agentic-ai",
-  "lgpd",
-  "cognitive-security",
-  "differential-privacy",
-  "neural-handover",
+  "cross-agent-memory",
 ]
 
 classifiers = [
@@ -41,7 +39,6 @@ dependencies = [
   "cryptography>=46.0.7",
   "pydantic>=2.4.0",
   "httpx>=0.27.0",
-  "python-dotenv>=1.0.1",
 ]
 
 [project.optional-dependencies]
@@ -64,6 +61,7 @@ dev = [
   "pytest>=8.0.0",
   "pytest-cov>=5.0.0",
   "pytest-asyncio>=0.23.0",
+  "respx>=0.21.0",
   "black>=24.0.0",
   "isort>=5.13.0",
   "mypy>=1.8.0",

{synapse_layer-1.2.0 → synapse_layer-1.2.1}/synapse_layer/__init__.py

@@ -1,5 +1,5 @@
 """
-Synapse Layer — Zero-Knowledge Memory Layer for AI Agents
+Synapse Layer — Persistent Memory Infrastructure for AI Agents
 
 This module provides the public API surface matching the package name.
 ``from synapse_layer import ...`` works as expected after