synapse-layer 2.3.2__tar.gz → 2.4.0__tar.gz

synapse_layer-2.4.0/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 Synapse Layer
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

{synapse_layer-2.3.2 → synapse_layer-2.4.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: synapse-layer
-Version: 2.3.2
-Summary: Persistent memory infrastructure for AI agents — State Continuity Layer.
+Version: 2.4.0
+Summary: Python SDK for Synapse Layer — persistent, encrypted, cross-agent memory for AI agents.
 Author-email: Synapse Layer <founder.synapselayer@proton.me>
 Project-URL: Homepage, https://synapselayer.org
 Project-URL: Bug Tracker, https://github.com/SynapseLayer/synapse-sdk-python/issues
@@ -14,19 +14,22 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Intended Audience :: Developers
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: requests>=2.25.0
 Requires-Dist: pydantic>=2.0.0
+Requires-Dist: aiohttp>=3.8.0
 Provides-Extra: langchain
 Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
 Provides-Extra: crewai
 Requires-Dist: crewai>=0.1.0; extra == "crewai"
+Dynamic: license-file
 
 # Synapse Layer
 
 [![PyPI](https://img.shields.io/pypi/v/synapse-layer?label=PyPI&color=blue)](https://pypi.org/project/synapse-layer/)
 [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-6B4FBB)](https://modelcontextprotocol.io/)
 [![AES-256-GCM](https://img.shields.io/badge/AES--256--GCM-Encrypted_at_Rest-success)](https://github.com/SynapseLayer/synapse-sdk-python)
-[![Server Never Sees Plaintext](https://img.shields.io/badge/Server-Never_Sees_Plaintext-informational)](https://github.com/SynapseLayer/synapse-sdk-python)
+[![State Continuity](https://img.shields.io/badge/State_Continuity-Layer-informational)](https://github.com/SynapseLayer/synapse-sdk-python)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE)
 [![Tests Passing](https://img.shields.io/badge/Tests-Passing-brightgreen)](https://github.com/SynapseLayer/synapse-sdk-python)
 
@@ -36,6 +39,25 @@ Persistent memory infrastructure for AI agents — encrypted, governed, and cros
 
 ---
 
+## ⚡ 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
+
+---
+
 ## Why Synapse?
 
 Superpowers proved agents need discipline. Synapse provides the **continuity layer** that makes that discipline persistent across sessions, tools, and handoffs.
@@ -45,7 +67,7 @@ Superpowers proved agents need discipline. Synapse provides the **continuity lay
 | Capability | Description |
 |---|---|
 | **State Continuity** | OAuth for AI Memory. Persistent context across sessions and models. |
-| **Privacy First** | Server never sees plaintext. AES-256-GCM client-side encryption. |
+| **Privacy First** | Server never sees plaintext. AES-256-GCM encrypted at rest with per-operation random IV. |
 | **Agent-Native** | 30-second install. Built for the MCP ecosystem. |
 | **Cross-Agent** | Share memory between agents via A2A protocol. |
 | **Trust Quotient** | Weighted memory ranking: confidence, recency, and usage. |
@@ -163,7 +185,7 @@ recall_tool = SynapseRecallMemoryTool(api_key="your-key")
 | **Privacy** | Differential privacy via Gaussian noise on embeddings. |
 | **Validation** | Intent validation pipeline with confidence scoring. |
 
-> The server never sees plaintext. All sensitive data is encrypted before storage.
+> Server never sees plaintext. All sensitive data is AES-256-GCM encrypted at rest with per-operation random IV. Designed for LGPD/GDPR alignment.
 
 ---
 

{synapse_layer-2.3.2 → synapse_layer-2.4.0}/README.md

@@ -3,7 +3,7 @@
 [![PyPI](https://img.shields.io/pypi/v/synapse-layer?label=PyPI&color=blue)](https://pypi.org/project/synapse-layer/)
 [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-6B4FBB)](https://modelcontextprotocol.io/)
 [![AES-256-GCM](https://img.shields.io/badge/AES--256--GCM-Encrypted_at_Rest-success)](https://github.com/SynapseLayer/synapse-sdk-python)
-[![Server Never Sees Plaintext](https://img.shields.io/badge/Server-Never_Sees_Plaintext-informational)](https://github.com/SynapseLayer/synapse-sdk-python)
+[![State Continuity](https://img.shields.io/badge/State_Continuity-Layer-informational)](https://github.com/SynapseLayer/synapse-sdk-python)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE)
 [![Tests Passing](https://img.shields.io/badge/Tests-Passing-brightgreen)](https://github.com/SynapseLayer/synapse-sdk-python)
 
@@ -13,6 +13,25 @@ Persistent memory infrastructure for AI agents — encrypted, governed, and cros
 
 ---
 
+## ⚡ 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
+
+---
+
 ## Why Synapse?
 
 Superpowers proved agents need discipline. Synapse provides the **continuity layer** that makes that discipline persistent across sessions, tools, and handoffs.
@@ -22,7 +41,7 @@ Superpowers proved agents need discipline. Synapse provides the **continuity lay
 | Capability | Description |
 |---|---|
 | **State Continuity** | OAuth for AI Memory. Persistent context across sessions and models. |
-| **Privacy First** | Server never sees plaintext. AES-256-GCM client-side encryption. |
+| **Privacy First** | Server never sees plaintext. AES-256-GCM encrypted at rest with per-operation random IV. |
 | **Agent-Native** | 30-second install. Built for the MCP ecosystem. |
 | **Cross-Agent** | Share memory between agents via A2A protocol. |
 | **Trust Quotient** | Weighted memory ranking: confidence, recency, and usage. |
@@ -140,7 +159,7 @@ recall_tool = SynapseRecallMemoryTool(api_key="your-key")
 | **Privacy** | Differential privacy via Gaussian noise on embeddings. |
 | **Validation** | Intent validation pipeline with confidence scoring. |
 
-> The server never sees plaintext. All sensitive data is encrypted before storage.
+> Server never sees plaintext. All sensitive data is AES-256-GCM encrypted at rest with per-operation random IV. Designed for LGPD/GDPR alignment.
 
 ---
 

{synapse_layer-2.3.2 → synapse_layer-2.4.0}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "synapse-layer"
-version = "2.3.2"
+version = "2.4.0"
 authors = [
   { name="Synapse Layer", email="founder.synapselayer@proton.me" },
 ]
-description = "Persistent memory infrastructure for AI agents — State Continuity Layer."
+description = "Python SDK for Synapse Layer — persistent, encrypted, cross-agent memory for AI agents."
 readme = "README.md"
 requires-python = ">=3.9"
 classifiers = [
@@ -21,6 +21,7 @@ classifiers = [
 dependencies = [
     "requests>=2.25.0",
     "pydantic>=2.0.0",
+    "aiohttp>=3.8.0",
 ]
 
 [project.optional-dependencies]

{synapse_layer-2.3.2 → synapse_layer-2.4.0}/synapse_layer/__init__.py

@@ -14,10 +14,11 @@ CrewAI tools (requires crewai):
     from synapse_layer import SynapseStoreMemoryTool, SynapseRecallMemoryTool
 """
 
-__version__ = "2.3.2"
+__version__ = "2.4.0"
 
 # Core — always importable, zero optional deps
 from .a2a_client import SynapseA2AClient
+from .client import Synapse
 
 
 # ---------------------------------------------------------------------------
@@ -60,6 +61,7 @@ __all__ = [
     "__version__",
     # Core
     "SynapseA2AClient",
+    "Synapse",
     # LangChain (lazy)
     "SynapseMemory",
     "SynapseChatHistory",

{synapse_layer-2.3.2 → synapse_layer-2.4.0}/synapse_layer/a2a_client.py

@@ -21,7 +21,7 @@ import aiohttp
 
 
 # Constants
-DEFAULT_BASE_URL = "https://rbeycxzizrrdmxpilepc.supabase.co/functions/v1/mcp-server"
+DEFAULT_BASE_URL = "https://forge.synapselayer.org/api/mcp"
 VALID_SKILL_IDS = {
     "store_memory",
     "recall_memory",

synapse_layer-2.4.0/synapse_layer/client.py

@@ -0,0 +1,217 @@
+"""Synapse Layer — Simple Sync Client.
+
+Minimal sync HTTP client for Forge API. AES-256-GCM encryption at rest
+is handled server-side; this client sends plaintext over HTTPS.
+
+Usage::
+
+    from synapse_layer import Synapse
+
+    s = Synapse(token="sk_connect_YOUR_TOKEN")
+    s.save("user prefers dark mode")
+    results = s.recall("user preferences")
+    for r in results:
+        print(r["content"])
+
+Get your token at https://forge.synapselayer.org → Dashboard → Connect
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+import time
+from typing import Any, Dict, List, Optional
+
+import requests
+
+
+_DEFAULT_BASE_URL = os.environ.get(
+    "SYNAPSE_FORGE_URL", "https://forge.synapselayer.org"
+)
+_DEFAULT_TIMEOUT = 15
+_DEFAULT_AGENT = "sdk-client"
+
+
+class SynapseError(Exception):
+    """Base exception for Synapse client errors."""
+
+
+class SynapseAuthError(SynapseError):
+    """Authentication failed (401)."""
+
+
+class SynapseRateLimitError(SynapseError):
+    """Rate limit exceeded (429)."""
+
+
+class Synapse:
+    """Synchronous Synapse client — minimal one-liner API.
+
+    Args:
+        token: ``sk_connect_*`` token. Also accepts ``api_key`` kwarg
+            or ``SYNAPSE_TOKEN`` env var.
+        base_url: Forge base URL. Defaults to ``https://forge.synapselayer.org``.
+        agent_id: Agent identifier for memory tagging.
+        timeout: HTTP timeout in seconds.
+    """
+
+    def __init__(
+        self,
+        token: Optional[str] = None,
+        *,
+        api_key: Optional[str] = None,
+        base_url: str = _DEFAULT_BASE_URL,
+        agent_id: str = _DEFAULT_AGENT,
+        timeout: int = _DEFAULT_TIMEOUT,
+    ) -> None:
+        resolved = token or api_key or os.environ.get("SYNAPSE_TOKEN", "")
+        if not resolved:
+            print(
+                "\n\u274c Missing SYNAPSE_TOKEN — get one at "
+                "https://forge.synapselayer.org/dashboard/connect\n",
+                file=sys.stderr,
+            )
+            raise SynapseAuthError(
+                "Missing token. Set SYNAPSE_TOKEN env var or pass token= argument. "
+                "Get your token at https://forge.synapselayer.org/dashboard/connect"
+            )
+        if not resolved.startswith("sk_connect_"):
+            raise SynapseAuthError(
+                "Token must start with 'sk_connect_' — "
+                "get one at https://forge.synapselayer.org/dashboard/connect"
+            )
+
+        self._token = resolved
+        self._base = base_url.rstrip("/")
+        self._agent = agent_id
+        self._timeout = timeout
+        self._session: Optional[requests.Session] = None
+
+    def _get_session(self) -> requests.Session:
+        if self._session is None:
+            self._session = requests.Session()
+            self._session.headers.update({
+                "x-connect-token": self._token,
+                "Content-Type": "application/json",
+            })
+        return self._session
+
+    # ── Store ──────────────────────────────────────────────────────
+
+    def save(self, content: str, **kwargs: Any) -> Dict[str, Any]:
+        """Save a memory to Synapse.
+
+        Args:
+            content: Text to persist in encrypted memory.
+            **kwargs: Optional overrides (memory_type, metadata, agent).
+
+        Returns:
+            Dict with memory_id, tq_score, and other metadata.
+        """
+        payload: Dict[str, Any] = {
+            "content": content,
+            "agent": kwargs.get("agent", self._agent),
+            "memory_type": kwargs.get("memory_type", "long_term"),
+        }
+        if "metadata" in kwargs:
+            payload["metadata"] = kwargs["metadata"]
+
+        session = self._get_session()
+        resp = session.post(
+            f"{self._base}/api/mcp",
+            json={
+                "jsonrpc": "2.0",
+                "method": "tools/call",
+                "params": {
+                    "name": "save_to_synapse",
+                    "arguments": payload,
+                },
+                "id": 1,
+            },
+            timeout=self._timeout,
+        )
+        return self._handle(resp)
+
+    def remember(self, content: str, **kwargs: Any) -> Dict[str, Any]:
+        """Alias for :meth:`save`."""
+        return self.save(content, **kwargs)
+
+    def store(self, content: str, **kwargs: Any) -> Dict[str, Any]:
+        """Alias for :meth:`save`."""
+        return self.save(content, **kwargs)
+
+    # ── Recall ─────────────────────────────────────────────────────
+
+    def recall(self, query: str, *, limit: int = 5) -> List[Dict[str, Any]]:
+        """Recall relevant memories.
+
+        Args:
+            query: Natural language query.
+            limit: Max results (default 5).
+
+        Returns:
+            List of memory dicts with content, trust_quotient, etc.
+        """
+        session = self._get_session()
+        resp = session.post(
+            f"{self._base}/api/mcp",
+            json={
+                "jsonrpc": "2.0",
+                "method": "tools/call",
+                "params": {
+                    "name": "recall",
+                    "arguments": {"query": query, "limit": limit},
+                },
+                "id": 2,
+            },
+            timeout=self._timeout,
+        )
+        data = self._handle(resp)
+        # Extract memories list from MCP tool response
+        if isinstance(data, dict):
+            # MCP returns {content: [{type: "text", text: JSON}]}
+            content_list = data.get("content", [])
+            if content_list and isinstance(content_list, list):
+                import json as _json
+                try:
+                    text = content_list[0].get("text", "{}")
+                    parsed = _json.loads(text)
+                    return parsed.get("memories", [])
+                except (ValueError, KeyError, IndexError):
+                    pass
+            return data.get("memories", [])
+        return []
+
+    # ── Helpers ────────────────────────────────────────────────────
+
+    def _handle(self, resp: requests.Response) -> Dict[str, Any]:
+        if resp.status_code == 401:
+            raise SynapseAuthError(f"Authentication failed (401): {resp.text[:200]}")
+        if resp.status_code == 429:
+            raise SynapseRateLimitError(f"Rate limit exceeded (429)")
+        if resp.status_code != 200:
+            raise SynapseError(f"Request failed ({resp.status_code}): {resp.text[:200]}")
+
+        data = resp.json()
+        if "error" in data:
+            err = data["error"]
+            msg = err.get("message", str(err)) if isinstance(err, dict) else str(err)
+            raise SynapseError(f"API error: {msg}")
+
+        return data.get("result", data)
+
+    def close(self) -> None:
+        """Close the HTTP session."""
+        if self._session:
+            self._session.close()
+            self._session = None
+
+    def __enter__(self) -> "Synapse":
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()
+
+    def __repr__(self) -> str:
+        return f"Synapse(agent='{self._agent}', base='{self._base}')"

{synapse_layer-2.3.2 → synapse_layer-2.4.0}/synapse_layer.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: synapse-layer
-Version: 2.3.2
-Summary: Persistent memory infrastructure for AI agents — State Continuity Layer.
+Version: 2.4.0
+Summary: Python SDK for Synapse Layer — persistent, encrypted, cross-agent memory for AI agents.
 Author-email: Synapse Layer <founder.synapselayer@proton.me>
 Project-URL: Homepage, https://synapselayer.org
 Project-URL: Bug Tracker, https://github.com/SynapseLayer/synapse-sdk-python/issues
@@ -14,19 +14,22 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Intended Audience :: Developers
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: requests>=2.25.0
 Requires-Dist: pydantic>=2.0.0
+Requires-Dist: aiohttp>=3.8.0
 Provides-Extra: langchain
 Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
 Provides-Extra: crewai
 Requires-Dist: crewai>=0.1.0; extra == "crewai"
+Dynamic: license-file
 
 # Synapse Layer
 
 [![PyPI](https://img.shields.io/pypi/v/synapse-layer?label=PyPI&color=blue)](https://pypi.org/project/synapse-layer/)
 [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-6B4FBB)](https://modelcontextprotocol.io/)
 [![AES-256-GCM](https://img.shields.io/badge/AES--256--GCM-Encrypted_at_Rest-success)](https://github.com/SynapseLayer/synapse-sdk-python)
-[![Server Never Sees Plaintext](https://img.shields.io/badge/Server-Never_Sees_Plaintext-informational)](https://github.com/SynapseLayer/synapse-sdk-python)
+[![State Continuity](https://img.shields.io/badge/State_Continuity-Layer-informational)](https://github.com/SynapseLayer/synapse-sdk-python)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE)
 [![Tests Passing](https://img.shields.io/badge/Tests-Passing-brightgreen)](https://github.com/SynapseLayer/synapse-sdk-python)
 
@@ -36,6 +39,25 @@ Persistent memory infrastructure for AI agents — encrypted, governed, and cros
 
 ---
 
+## ⚡ 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
+
+---
+
 ## Why Synapse?
 
 Superpowers proved agents need discipline. Synapse provides the **continuity layer** that makes that discipline persistent across sessions, tools, and handoffs.
@@ -45,7 +67,7 @@ Superpowers proved agents need discipline. Synapse provides the **continuity lay
 | Capability | Description |
 |---|---|
 | **State Continuity** | OAuth for AI Memory. Persistent context across sessions and models. |
-| **Privacy First** | Server never sees plaintext. AES-256-GCM client-side encryption. |
+| **Privacy First** | Server never sees plaintext. AES-256-GCM encrypted at rest with per-operation random IV. |
 | **Agent-Native** | 30-second install. Built for the MCP ecosystem. |
 | **Cross-Agent** | Share memory between agents via A2A protocol. |
 | **Trust Quotient** | Weighted memory ranking: confidence, recency, and usage. |
@@ -163,7 +185,7 @@ recall_tool = SynapseRecallMemoryTool(api_key="your-key")
 | **Privacy** | Differential privacy via Gaussian noise on embeddings. |
 | **Validation** | Intent validation pipeline with confidence scoring. |
 
-> The server never sees plaintext. All sensitive data is encrypted before storage.
+> Server never sees plaintext. All sensitive data is AES-256-GCM encrypted at rest with per-operation random IV. Designed for LGPD/GDPR alignment.
 
 ---
 

{synapse_layer-2.3.2 → synapse_layer-2.4.0}/synapse_layer.egg-info/SOURCES.txt

@@ -1,7 +1,9 @@
+LICENSE
 README.md
 pyproject.toml
 synapse_layer/__init__.py
 synapse_layer/a2a_client.py
+synapse_layer/client.py
 synapse_layer/crewai_tools.py
 synapse_layer/langchain_memory.py
 synapse_layer.egg-info/PKG-INFO

{synapse_layer-2.3.2 → synapse_layer-2.4.0}/synapse_layer.egg-info/requires.txt

@@ -1,5 +1,6 @@
 requests>=2.25.0
 pydantic>=2.0.0
+aiohttp>=3.8.0
 
 [crewai]
 crewai>=0.1.0