bridgemem 0.1.0__py3-none-any.whl

bridgemem/__init__.py

@@ -0,0 +1,73 @@
+"""Official zero-dependency Python client SDK for BridgeMem nodes (https://bridgemem.com)."""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+from dataclasses import dataclass
+from typing import Any, Dict, Optional
+
+__all__ = ["BridgeMemClient", "BridgeMemError", "__version__"]
+__version__ = "0.1.0"
+
+
+class BridgeMemError(RuntimeError):
+    """Raised when a BridgeMem HTTP or MCP call returns an error."""
+
+    def __init__(self, status: int, message: str) -> None:
+        super().__init__(f"BridgeMem HTTP {status}: {message}")
+        self.status = status
+        self.message = message
+
+
+@dataclass
+class BridgeMemClient:
+    """Lightweight stdlib-only HTTP & MCP JSON-RPC client for a BridgeMem Gate."""
+
+    endpoint: str = "http://127.0.0.1:8508"
+    bearer_token: Optional[str] = None
+    timeout_sec: float = 10.0
+
+    def _request(self, method: str, path: str, payload: Optional[Dict[str, Any]] = None) -> Any:
+        url = f"{self.endpoint.rstrip('/')}/{path.lstrip('/')}"
+        headers = {"Accept": "application/json"}
+        if self.bearer_token:
+            headers["Authorization"] = f"Bearer {self.bearer_token.strip()}"
+        raw = None
+        if payload is not None:
+            raw = json.dumps(payload).encode("utf-8")
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=raw, headers=headers, method=method)
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout_sec) as resp:
+                body = resp.read().decode("utf-8", errors="replace")
+                return json.loads(body) if body else {}
+        except urllib.error.HTTPError as exc:
+            detail = exc.read().decode("utf-8", errors="replace")
+            raise BridgeMemError(exc.code, detail) from exc
+
+    def health(self) -> Any:
+        return self._request("GET", "/healthz")
+
+    def search(self, section_id: str, query: str, top_k: int = 8) -> Any:
+        return self._request(
+            "POST",
+            "/api/v1/search",
+            {"section_id": section_id, "query": query, "top_k": max(1, min(100, int(top_k)))},
+        )
+
+    def mcp_list_tools(self) -> Any:
+        return self._request("POST", "/mcp", {"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}})
+
+    def mcp_call_tool(self, name: str, arguments: Optional[Dict[str, Any]] = None) -> Any:
+        return self._request(
+            "POST",
+            "/mcp",
+            {
+                "jsonrpc": "2.0",
+                "id": 2,
+                "method": "tools/call",
+                "params": {"name": name, "arguments": arguments or {}},
+            },
+        )

bridgemem-0.1.0.dist-info/METADATA

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: bridgemem
+Version: 0.1.0
+Summary: Official lightweight HTTP and Model Context Protocol (MCP) Python client SDK for BridgeMem autonomous AI memory nodes.
+Author-email: BridgeMem <ccaiuss@gmail.com>
+License-Expression: MIT OR Apache-2.0
+Project-URL: Homepage, https://bridgemem.com
+Project-URL: Documentation, https://bridgemem.org
+Project-URL: Repository, https://github.com/bridgemem/bridgemem-py
+Keywords: bridgemem,mcp,ai,memory,rag,zero-knowledge
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# BridgeMem Python SDK (`bridgemem`)
+
+Official zero-dependency Python client for **BridgeMem** autonomous organizational memory and Zero-Knowledge AI vaults (`https://bridgemem.com` | specification at `https://bridgemem.org`).
+
+## Installation
+
+```bash
+pip install bridgemem
+```
+
+## Quick Start
+
+```python
+from bridgemem import BridgeMemClient
+
+client = BridgeMemClient("http://127.0.0.1:8508", bearer_token="brk_example_key")
+print(client.search(section_id="default", query="invoice retention policy"))
+```

bridgemem-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+bridgemem/__init__.py,sha256=b-FOuuKRg11jGTdR4NkiFHiyOQfmDl4ucKsxiS5knKQ,2682
+bridgemem-0.1.0.dist-info/licenses/LICENSE,sha256=-iAn2A2er0Xf0yzlGL3MYJgSmP1tjQEkCh4xb2Dj82M,1066
+bridgemem-0.1.0.dist-info/METADATA,sha256=w9kkbbsfrCHxlLKqIYot2Apfxl9F4-9GUv9LLJPCFAU,1330
+bridgemem-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+bridgemem-0.1.0.dist-info/top_level.txt,sha256=FFjy4biuQPxW0i9bcKywvCP4ARI0Eejiz7_C1bP3veg,10
+bridgemem-0.1.0.dist-info/RECORD,,

bridgemem-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bridgemem-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BridgeMem
+
+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.

bridgemem-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+bridgemem