feat: ergonomic EverOS client wrapper

.github/workflows/ci.yml

@@ -41,13 +41,16 @@ jobs:
         if: steps.detect.outputs.has_pkg == 'true'
         run: |
           python - <<'PY'
-          from everos_cloud import ApiClient, Configuration, MemoryApi
+          from everos_cloud import ApiClient, Configuration, MemoryApi, EverOS
           cfg = Configuration(access_token="sk-test")
           assert cfg.host == "https://api.evermind.ai", cfg.host
           assert cfg.auth_settings()["BearerAuth"]["value"] == "Bearer sk-test"
           MemoryApi(ApiClient(cfg))
           for m in ("add_memory", "search_memory", "get_memory", "delete_memory", "edit_profile"):
               assert hasattr(MemoryApi, m), m
+          # ergonomic facade is exported at the top level
+          for m in ("add", "search", "get", "flush", "edit", "delete", "upload", "close"):
+              assert hasattr(EverOS, m), m
           print("import + config OK")
           PY
 
@@ -88,6 +91,13 @@ jobs:
           print("quickstart drift smoke OK")
           PY
 
+      - name: Wrapper unit tests
+        # Offline tests for the hand-maintained ergonomic client (everos_cloud/client.py).
+        if: steps.detect.outputs.has_pkg == 'true' && hashFiles('tests/test_client.py') != ''
+        run: |
+          pip install pytest
+          pytest -q tests/
+
       - name: Build sdist + wheel
         if: steps.detect.outputs.has_pkg == 'true'
         run: |

everos_cloud/__init__.py

@@ -91,3 +91,16 @@
 from everos_cloud.models.update_operation import UpdateOperation
 from everos_cloud.models.validation_error import ValidationError
 from everos_cloud.models.validation_error_loc_inner import ValidationErrorLocInner
+
+# Ergonomic high-level client — hand-maintained, preserved across regeneration
+# (usage in quickstart.md). Guarded so a bare generated tree without client.py
+# (e.g. the factory's build output) still imports cleanly.
+try:
+    from everos_cloud.client import (
+        EverOS,
+        EverOSAPIError,
+        EverOSError,
+        EverOSStorageError,
+    )
+except ImportError:  # pragma: no cover
+    pass