feat: ergonomic EverOS client wrapper

[dani1005]

Adds a thin, hand-maintained ergonomic facade over the generated MemoryApi / StorageApi, so users get from everos_cloud import EverOS with plain kwargs/dicts instead of assembling typed models by hand.

from everos_cloud import EverOS

with EverOS(api_key="sk-...") as client:
    client.add(session_id="s1", messages=[{"role": "user", "content": "I love hiking"}])
    hits = client.search("outdoor hobbies")
    key = client.upload("photo.jpg")     # presign + direct-to-S3, returns object_key

What's in it

• everos_cloud/client.py — EverOS with add / search / get / flush / edit / delete, end-to-end upload() (presign + S3 POST) and presign(), plus close() / context-manager.
  • Unified EverOSError hierarchy (EverOSAPIError wraps the SDK's ApiException; EverOSStorageError).
  • Default request timeout (60s, configurable) on every call.
  • flush uses a getattr fallback, so it keeps working across the flush_api_v2_memory_flush_post → flush_memory rename.
  • Low-level client.memory / client.storage stay exposed as escape hatches.
• everos_cloud/__init__.py — exports EverOS (guarded try/except so the factory's bare generated tree, which has no client.py, still imports).
• tests/test_client.py — 18 offline unit tests (API layer mocked).
• ci.yml — runs the wrapper tests and asserts the top-level EverOS export.

Validation

• 18 unit tests green.
• Direct-to-S3 upload mechanics verified against real S3 (HTTP 204, including the presigned Content-Type policy condition) via the storage sign endpoint.
• A real close() bug (the generated ApiClient has no .close()) was caught by live testing and fixed.
• ⏳ Pending: a live v2 memory round-trip (add→flush→search returning 2xx) — blocked because available test accounts are v1-only (v2 returns VERSION_NOT_ALLOWED). Low residual risk; will smoke once a v2 account exists.

Requires factory change

client.py and tests/ are hand-maintained; the SDK factory must preserve them across regeneration and keep the __init__ export. Companion factory MR to follow.

🤖 Generated with Claude Code