memwal 0.1.9.dev0__tar.gz → 0.1.9.dev2__tar.gz

{memwal-0.1.9.dev0 → memwal-0.1.9.dev2}/CHANGELOG.md

@@ -4,7 +4,9 @@
 
 ### Fixed
 
+- HTTP 503 with `x-auth-error: AUTH_UPSTREAM_UNAVAILABLE` is reported as a retryable credential-verification outage, not a sign-in failure. Other 503s keep the generic sanitized body.
 - `remember_bulk_async` rejects an empty `items` list before the request and raises when the relayer returns a `job_ids` length that does not match the batch.
+- restore `truncated` docs now match WALM-431 retryable semantics.
 
 ## 0.1.8
 

{memwal-0.1.9.dev0 → memwal-0.1.9.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: memwal
-Version: 0.1.9.dev0
+Version: 0.1.9.dev2
 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

{memwal-0.1.9.dev0 → memwal-0.1.9.dev2}/memwal/__init__.py

@@ -122,4 +122,4 @@ __all__ = [
     "RecallManualResult",
 ]
 
-__version__ = "0.1.9.dev0"
+__version__ = "0.1.9.dev2"

{memwal-0.1.9.dev0 → memwal-0.1.9.dev2}/memwal/client.py

@@ -97,6 +97,11 @@ AUTH_REJECTED_MESSAGE = (
     "and dashboard credentials. Full troubleshooting: "
     "https://docs.wal.app/walrus-memory/troubleshooting/overview#401-auth_rejected-errors"
 )
+AUTH_UPSTREAM_UNAVAILABLE = "AUTH_UPSTREAM_UNAVAILABLE"
+UPSTREAM_UNAVAILABLE_MESSAGE = (
+    "Walrus Memory temporarily cannot verify credentials (upstream unavailable). "
+    "Retry; this is not a sign-in failure."
+)
 
 
 logger = logging.getLogger("memwal")
@@ -1285,6 +1290,8 @@ class MemWal:
             raise _HttpStatusError(
                 status=response.status_code,
                 body=err_text,
+                auth_error=response.headers.get("x-auth-error"),
+                retry_after=response.headers.get("retry-after"),
             )
 
         return response.json()
@@ -1328,15 +1335,25 @@ class _HttpStatusError(MemWalError):
     explicitly accepted).
     """
 
-    def __init__(self, status: int, body: str) -> None:
+    def __init__(
+        self,
+        status: int,
+        body: str,
+        auth_error: str | None = None,
+        retry_after: str | None = None,
+    ) -> None:
         if status == 401:
             super().__init__(AUTH_REJECTED_MESSAGE)
+        elif status == 503 and auth_error == AUTH_UPSTREAM_UNAVAILABLE:
+            super().__init__(UPSTREAM_UNAVAILABLE_MESSAGE)
         else:
             super().__init__(
                 f"Walrus Memory API error ({status}): {_redact_internal_urls(body)}"
             )
         self.status = status
         self.body = body
+        self.auth_error = auth_error
+        self.retry_after = retry_after
 
 
 class MemWalRememberJobNotFound(MemWalError):

{memwal-0.1.9.dev0 → memwal-0.1.9.dev2}/memwal/types.py

@@ -206,13 +206,17 @@ class RestoreResult:
     total: int
     namespace: str
     owner: str
-    #: True when this restore is known-incomplete: either more on-chain
-    #: blobs were missing locally than ``limit`` allowed this call to
-    #: restore, or the sidecar's raw on-chain candidate fetch hit its own
-    #: cap before this namespace's blobs were even filtered out of that
-    #: set (WALM-319) -- this can be ``True`` even when ``total == 0``,
-    #: since a cap hit elsewhere can starve this namespace's fetch
-    #: entirely. Raising ``limit`` only helps with the first case.
+    #: True when this restore is known-incomplete: more on-chain blobs were
+    #: missing locally than ``limit`` allowed this call to restore, or the
+    #: sidecar's owner-wide candidate fetch hit its cap *and* raising
+    #: ``limit`` can still expand that fetch (``limit < 20``). Once the cap
+    #: is saturated, truncation follows this call's missing-blob page, not
+    #: on-chain ``total``, so a fully restored namespace does not loop
+    #: (WALM-431 / GH #762).
+    #:
+    #: ``truncated=False`` is not proof the sidecar saw every on-chain blob.
+    #: Blobs beyond the owner-wide sidecar candidate cap can still be
+    #: missing. Follow-up field: WALM-451 (``sourceCapped``).
     #:
     #: Relayers older than WALM-319 don't send this field at all; the SDK
     #: defaults it to ``False`` in that case rather than requiring it.

{memwal-0.1.9.dev0 → memwal-0.1.9.dev2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "memwal"
-version = "0.1.9.dev0"
+version = "0.1.9.dev2"
 description = "Python SDK for Walrus Memory — Privacy-first AI memory with Ed25519 signing"
 readme = "README.md"
 license = "MIT"

memwal-0.1.9.dev2/tests/test_auth_rejected_message.py

@@ -0,0 +1,30 @@
+"""Tests for the AUTH_REJECTED_MESSAGE shown on a 401 from the relayer."""
+
+from __future__ import annotations
+
+from memwal.client import (
+    AUTH_REJECTED_MESSAGE,
+    AUTH_UPSTREAM_UNAVAILABLE,
+    UPSTREAM_UNAVAILABLE_MESSAGE,
+    _HttpStatusError,
+)
+
+
+def test_auth_rejected_message_points_to_troubleshooting_guide() -> None:
+    assert "docs.wal.app/walrus-memory/troubleshooting/overview" in AUTH_REJECTED_MESSAGE
+
+
+def test_auth_503_is_retryable_not_a_credential_failure() -> None:
+    err = _HttpStatusError(
+        503, "upstream unavailable", auth_error=AUTH_UPSTREAM_UNAVAILABLE, retry_after="5"
+    )
+    assert str(err) == UPSTREAM_UNAVAILABLE_MESSAGE
+    assert "sign-in" in str(err)
+    assert "401" not in str(err)
+    assert err.retry_after == "5"
+
+
+def test_non_auth_503_keeps_generic_body() -> None:
+    err = _HttpStatusError(503, "Rate limiter temporarily unavailable")
+    assert "Rate limiter temporarily unavailable" in str(err)
+    assert "cannot verify credentials" not in str(err)

memwal-0.1.9.dev0/tests/test_auth_rejected_message.py

@@ -1,9 +0,0 @@
-"""Tests for the AUTH_REJECTED_MESSAGE shown on a 401 from the relayer."""
-
-from __future__ import annotations
-
-from memwal.client import AUTH_REJECTED_MESSAGE
-
-
-def test_auth_rejected_message_points_to_troubleshooting_guide() -> None:
-    assert "docs.wal.app/walrus-memory/troubleshooting/overview" in AUTH_REJECTED_MESSAGE