memwal 0.2.2.dev3__py3-none-any.whl → 0.2.2.dev4__py3-none-any.whl

memwal/__init__.py

@@ -27,6 +27,7 @@ from .client import (
     MemWalClockDriftError,
     MemWalCompatibilityError,
     MemWalError,
+    MemWalJsonBodyError,
     MemWalRateLimited,
     MemWalRememberJobFailed,
     MemWalRememberJobNotFound,
@@ -43,6 +44,7 @@ from .types import (
     AskMemory,
     AskResult,
     EmbedResult,
+    ForgetResult,
     HealthResult,
     MemWalConfig,
     NamespacesResult,
@@ -83,6 +85,7 @@ __all__ = [
     "MemWalError",
     "MemWalCompatibilityError",
     "MemWalClockDriftError",
+    "MemWalJsonBodyError",
     "MemWalRateLimited",
     "MemWalRememberJobFailed",
     "MemWalRememberJobNotFound",
@@ -118,6 +121,7 @@ __all__ = [
     "AnalyzedFact",
     "HealthResult",
     "RestoreResult",
+    "ForgetResult",
     "NamespaceSummary",
     "NamespacesResult",
     "ScoringWeights",
@@ -128,4 +132,4 @@ __all__ = [
     "RecallManualResult",
 ]
 
-__version__ = "0.2.2.dev3"
+__version__ = "0.2.2.dev4"

memwal/client.py

@@ -51,6 +51,7 @@ from .types import (
     AskMemory,
     AskResult,
     EmbedResult,
+    ForgetResult,
     HealthResult,
     MemWalConfig,
     NamespacesResult,
@@ -675,7 +676,7 @@ class MemWal:
         if generated_key:
             self._pending_remember_keys.pop(request_identity, None)
         return RememberAcceptedResult(
-            job_id=data["job_id"],
+            job_id=_require(data, "job_id", "POST /api/remember"),
             status=data.get("status", "pending"),
         )
 
@@ -717,6 +718,10 @@ class MemWal:
                 # Status is metadata. No SEAL decrypt, so no session. Matches TS.
                 include_seal_session=False,
             )
+        except MemWalJsonBodyError as err:
+            if err.status != 404:
+                raise
+            data = None
         except (json.JSONDecodeError, UnicodeDecodeError):
             data = None
         if not isinstance(data, dict):
@@ -800,6 +805,10 @@ class MemWal:
                         )
                     else:
                         raise
+            except MemWalJsonBodyError as err:
+                if err.status == 404:
+                    raise MemWalRememberJobNotFound(job_id) from None
+                raise
             except (json.JSONDecodeError, UnicodeDecodeError):
                 raise MemWalRememberJobNotFound(job_id) from None
             except _HttpStatusError as err:
@@ -1244,6 +1253,30 @@ class MemWal:
             dropped_count=dropped,
         )
 
+    async def forget(self, namespace: Optional[str] = None) -> ForgetResult:
+        """Delete this owner's index rows for ``namespace``.
+
+        Wraps ``POST /api/forget``. Walrus blobs persist; the rows stop being
+        retrievable. Defaults to the client namespace.
+        """
+        resolved_namespace = self._resolve_namespace(namespace)
+        data = await self._signed_request(
+            "POST",
+            "/api/forget",
+            {"namespace": resolved_namespace},
+            include_seal_session=False,
+        )
+        endpoint = "POST /api/forget"
+        return ForgetResult(
+            deleted=int(_require(data, "deleted", endpoint)),
+            namespace=_require(data, "namespace", endpoint),
+            owner=_require(data, "owner", endpoint),
+        )
+
+    async def forget_namespace(self, namespace: Optional[str] = None) -> ForgetResult:
+        """Alias for :meth:`forget` matching :meth:`MemWalMock.forget_namespace`."""
+        return await self.forget(namespace)
+
     async def analyze(
         self,
         text: str,
@@ -1562,7 +1595,7 @@ class MemWal:
             raise _destroyed_client_error()
         if response.status_code != 200:
             raise MemWalError(f"Health check failed: {response.status_code}")
-        data = response.json()
+        data = _parse_json_response(response, "GET /health")
         return HealthResult(
             status=_require(data, "status", "GET /health"),
             version=_require(data, "version", "GET /health"),
@@ -1690,7 +1723,7 @@ class MemWal:
             if self._destroyed:
                 raise _destroyed_client_error()
             if version_response.status_code == 200:
-                metadata = version_response.json()
+                metadata = _parse_json_response(version_response, "GET /version")
             elif version_response.status_code in (404, 405):
                 health_response = await self._http.get(f"{self._server_url}/health")
                 if self._destroyed:
@@ -1701,7 +1734,7 @@ class MemWal:
                         f"GET /version returned {version_response.status_code}, "
                         f"and GET /health returned {health_response.status_code}"
                     )
-                metadata = health_response.json()
+                metadata = _parse_json_response(health_response, "GET /health")
             else:
                 raise MemWalError(
                     "Walrus Memory compatibility check failed: "
@@ -1723,7 +1756,11 @@ class MemWal:
         if response.status_code != 200:
             raise MemWalError(f"GET /config returned {response.status_code}")
 
-        data = response.json()
+        data = _parse_json_response(response, "GET /config")
+        if not isinstance(data, dict):
+            raise MemWalError(
+                f"GET /config response was {type(data).__name__}, expected an object"
+            )
         package_id = data.get("packageId")
         network = data.get("network")
         sui_rpc_url = data.get("suiRpcUrl")
@@ -1758,8 +1795,9 @@ class MemWal:
         )
         if response.status_code != 200:
             raise MemWalError(f"Sui GraphQL returned {response.status_code}")
-        body = response.json()
-        obj = (body.get("data") or {}).get("object")
+        body = _parse_json_response(response, f"POST {graphql_url}")
+        data = body.get("data") if isinstance(body, dict) else None
+        obj = data.get("object") if isinstance(data, dict) else None
         if not isinstance(obj, dict) or obj.get("version") is None:
             raise MemWalError(f"Sui GraphQL could not resolve package {package_id}")
         return obj["version"]
@@ -1780,8 +1818,8 @@ class MemWal:
         if response.status_code != 200:
             raise MemWalError(f"sui_getObject returned {response.status_code}")
 
-        body = response.json()
-        result = body.get("result", {})
+        body = _parse_json_response(response, f"POST {sui_rpc_url}")
+        result = body.get("result", {}) if isinstance(body, dict) else {}
         version = None
         if isinstance(result, dict):
             data = result.get("data")
@@ -1904,7 +1942,7 @@ class MemWal:
         )
         if self._destroyed:
             raise _destroyed_client_error()
-        owner = data.get("owner")
+        owner = data.get("owner") if isinstance(data, dict) else None
         if not owner:
             raise MemWalError(
                 "Walrus Memory could not resolve this account's owner address "
@@ -2052,7 +2090,15 @@ class MemWal:
                 retry_after=response.headers.get("retry-after"),
             )
 
-        return response.json()
+        endpoint = f"{method_upper} {path}"
+        data = _parse_json_response(response, endpoint)
+        if response.status_code != 404 and not isinstance(data, dict):
+            raise MemWalJsonBodyError(
+                status=response.status_code,
+                endpoint=endpoint,
+                body=response.text,
+            )
+        return data
 
 
 class MemWalError(Exception):
@@ -2076,6 +2122,71 @@ class MemWalClockDriftError(MemWalError):
     pass
 
 
+class MemWalJsonBodyError(MemWalError):
+    """Raised when an HTTP response that should carry JSON has an empty or non-JSON body."""
+
+    def __init__(
+        self,
+        status: int,
+        endpoint: str,
+        body: str,
+        *,
+        empty: bool = False,
+    ) -> None:
+        redacted = _redact_internal_urls(body.strip()[:200]) if body else ""
+        if empty:
+            message = (
+                f"MemWal ({endpoint}): HTTP {status} response had an empty body; "
+                "expected JSON"
+            )
+        elif redacted:
+            message = (
+                f"MemWal ({endpoint}): HTTP {status} response was not JSON: "
+                f"{redacted}"
+            )
+        else:
+            message = f"MemWal ({endpoint}): HTTP {status} response was not JSON"
+        super().__init__(message)
+        self.status = status
+        self.endpoint = endpoint
+        self.body = body
+
+
+def _parse_json_response(response: httpx.Response, endpoint: str) -> Any:
+    """Decode a JSON response body or raise :class:`MemWalJsonBodyError` (#1219).
+
+    Mirrors the TypeScript SDK's ``jsonBodyError`` guard (#1201 / #1207): an
+    empty or non-JSON 2xx response from a relayer or proxy in front of one
+    surfaces as a :class:`MemWalError` naming the endpoint and HTTP status
+    rather than Python's raw :class:`json.JSONDecodeError` or
+    :class:`UnicodeDecodeError`.
+    """
+    try:
+        return response.json()
+    except UnicodeDecodeError as exc:
+        raise MemWalJsonBodyError(
+            status=response.status_code,
+            endpoint=endpoint,
+            body="",
+        ) from exc
+    except (json.JSONDecodeError, ValueError) as exc:
+        doc = getattr(exc, "doc", None)
+        if isinstance(doc, str):
+            raw = doc
+        else:
+            try:
+                raw = response.text
+            except UnicodeDecodeError:
+                raw = ""
+        is_empty = not raw or not raw.strip()
+        raise MemWalJsonBodyError(
+            status=response.status_code,
+            endpoint=endpoint,
+            body=raw,
+            empty=is_empty,
+        ) from exc
+
+
 def _redact_internal_urls(text: str) -> str:
     return re.sub(
         r"https?://(?:(?:[\w-]+\.)*localhost|127\.\d{1,3}\.\d{1,3}\.\d{1,3}|\[::1\]|0\.0\.0\.0)(?::\d+)?[^\s)\]>'\"]*",
@@ -2396,6 +2507,14 @@ class MemWalSync:
         :class:`RecallParams` for the recommended object-style call)."""
         return self._run(self._inner.recall(query, limit, namespace, max_distance))
 
+    def forget(self, namespace: Optional[str] = None) -> ForgetResult:
+        """Synchronous version of :meth:`MemWal.forget`."""
+        return self._run(self._inner.forget(namespace))
+
+    def forget_namespace(self, namespace: Optional[str] = None) -> ForgetResult:
+        """Synchronous version of :meth:`MemWal.forget_namespace`."""
+        return self._run(self._inner.forget_namespace(namespace))
+
     def analyze(
         self,
         text: str,

memwal/compatibility.py

@@ -12,6 +12,12 @@ SUPPORTED_RELAYER_API_MAJOR = 1
 def compatibility_error(metadata: Dict[str, Any], server_url: str) -> Optional[str]:
     """Return an actionable error string when relayer metadata is unsupported."""
 
+    if not isinstance(metadata, dict):
+        return (
+            f"Walrus Memory relayer at {server_url} does not expose compatibility metadata. "
+            "Upgrade the relayer to a version that serves GET /version, or use an older SDK."
+        )
+
     api_version = metadata.get("apiVersion")
     relayer_version = metadata.get("relayerVersion")
     min_supported = metadata.get("minSupportedSdk")

memwal/mock.py

@@ -20,6 +20,7 @@ from .types import (
     AskMemory,
     AskResult,
     EmbedResult,
+    ForgetResult,
     HealthResult,
     NamespacesResult,
     NamespaceSummary,
@@ -497,6 +498,13 @@ class MemWalMock:
                 return True
         return False
 
+    async def forget_namespace(self, namespace: Optional[str] = None) -> ForgetResult:
+        resolved = self._namespace if namespace is None else namespace
+        if not resolved:
+            raise ValueError("namespace cannot be empty")
+        deleted = self.clear(resolved)
+        return ForgetResult(deleted=deleted, namespace=resolved, owner=self._owner)
+
     def clear(self, namespace: Optional[str] = None) -> int:
         removed = [
             memory
@@ -717,6 +725,9 @@ class MemWalMockSync:
     def forget(self, blob_id: str) -> bool:
         return self._inner.forget(blob_id)
 
+    def forget_namespace(self, namespace: Optional[str] = None) -> ForgetResult:
+        return self._run(self._inner.forget_namespace(namespace))
+
     def clear(self, namespace: Optional[str] = None) -> int:
         return self._inner.clear(namespace)
 

memwal/types.py

@@ -84,6 +84,14 @@ class RememberResult:
     namespace: str
 
 
+@dataclass
+class ForgetResult:
+    """Result from POST /api/forget. Walrus blobs are not deleted."""
+
+    deleted: int
+    namespace: str
+    owner: str
+
 @dataclass
 class RecallMemory:
     """A single recalled memory."""

{memwal-0.2.2.dev3.dist-info → memwal-0.2.2.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: memwal
-Version: 0.2.2.dev3
+Version: 0.2.2.dev4
 Summary: Python SDK for Walrus Memory — Privacy-first AI memory with Ed25519 signing
 Project-URL: Homepage, https://memory.walrus.xyz
 Project-URL: Documentation, https://memory.walrus.xyz
@@ -147,7 +147,7 @@ async def test_memory_flow():
     assert "dark mode" in result.results[0].text
 ```
 
-The mock supports remember/job polling, bulk remember, recall, analyze, embed, ask, health, restore, list_namespaces, `forget(blob_id)`, and `clear(namespace)`. For deterministic behavior, `analyze` stores its full input as one fact instead of invoking an LLM extractor. Its simple relevance score is for application tests, not production search-quality evaluation.
+The mock supports remember/job polling, bulk remember, recall, analyze, embed, ask, health, restore, list_namespaces, `forget(blob_id)` (synchronous per-blob deletion returning `bool`), `forget_namespace(namespace?)` (namespace erasure returning `ForgetResult`), and `clear(namespace?)`. For deterministic behavior, `analyze` stores its full input as one fact instead of invoking an LLM extractor. Its simple relevance score is for application tests, not production search-quality evaluation.
 
 ### Context Manager
 
@@ -254,6 +254,7 @@ Create a new async client.
 | `await analyze(text, namespace?)` | Extract and store facts |
 | `await ask(question, limit?, namespace?)` | Ask a question answered using memories |
 | `await restore(namespace, limit?)` | Restore a namespace |
+| `await forget(namespace?)` | Delete index rows for the namespace. Walrus blobs stay. Returns `ForgetResult`. |
 | `await list_namespaces(cursor?, limit?)` | List namespaces that hold memories; paginate on `has_more` |
 | `await health()` | Check server health |
 | `await remember_manual(opts)` | Store encrypted payload + pre-computed vector |

memwal-0.2.2.dev4.dist-info/RECORD

@@ -0,0 +1,10 @@
+memwal/__init__.py,sha256=1sCBW-L4ec1F4AX7BCOPRzaPyRmthtaeA0zGjKrdaMs,3232
+memwal/client.py,sha256=eCp7wnvWryITN_Z3fw_NwBV1u1_mlU_mVrdBhLUoltM,102076
+memwal/compatibility.py,sha256=R3Gt1gVRjYSLNa78leNrTpGMZI1UATYo7N8Ie_44CGI,3054
+memwal/middleware.py,sha256=z2xdbvaobBg4byJXnrX7amWdVYE4jfeO4t31DoDBv_o,38413
+memwal/mock.py,sha256=oG0znsO-gekoCkQ0mNgT1kjQwP1ku8TjQEkaNkbRDlQ,24878
+memwal/types.py,sha256=jekUFnpGhVezU_VavY4DEzty6EWb0GxAwspmszk5Cdc,14144
+memwal/utils.py,sha256=RYlELBpKUHN9RuvWQu0cSGMoyXpAdTWlNKawfDpDbQ0,13361
+memwal-0.2.2.dev4.dist-info/METADATA,sha256=qlEbcZYtZStlbKELvyf3pWaF1446Uxvd0VcZ6Hqw0Mo,12151
+memwal-0.2.2.dev4.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+memwal-0.2.2.dev4.dist-info/RECORD,,

memwal-0.2.2.dev3.dist-info/RECORD

@@ -1,10 +0,0 @@
-memwal/__init__.py,sha256=9xGvu4OTUpHjju77Hlwd8qb6oDjc6qvfQKM5nFQ1aU0,3142
-memwal/client.py,sha256=3FBM1AP-YYoYPOzZFAeUA_nAYZtHWnTEuJWIdYThVas,97328
-memwal/compatibility.py,sha256=FsKApCcHOFZeIeNOph3YydWVnZtMJdT0KCt0e6jylho,2799
-memwal/middleware.py,sha256=z2xdbvaobBg4byJXnrX7amWdVYE4jfeO4t31DoDBv_o,38413
-memwal/mock.py,sha256=JrYAkvEk_vkDDHd5RMWdyAqdE72GEgqFPlPbAFzZvkA,24347
-memwal/types.py,sha256=yPNAEIGPY3O1GiFln0zW8stTPuV5sZYXAyQqeIkdbhw,13990
-memwal/utils.py,sha256=RYlELBpKUHN9RuvWQu0cSGMoyXpAdTWlNKawfDpDbQ0,13361
-memwal-0.2.2.dev3.dist-info/METADATA,sha256=WjL3FwG7QR-MjLPYJcPUHFGPIVVGjngRp3hnltvuNek,11911
-memwal-0.2.2.dev3.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-memwal-0.2.2.dev3.dist-info/RECORD,,