evermemos 0.3.6__tar.gz → 0.3.8__tar.gz

evermemos-0.3.8/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.3.8"
+}

{evermemos-0.3.6 → evermemos-0.3.8}/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.3.8 (2026-01-28)
+
+Full Changelog: [v0.3.7...v0.3.8](https://github.com/evermemos/evermemos-python/compare/v0.3.7...v0.3.8)
+
+### Features
+
+* **api:** api update ([e2cc79c](https://github.com/evermemos/evermemos-python/commit/e2cc79c7b19cd8da12385d59bd6fcb7e83be6c84))
+
+
+### Chores
+
+* update SDK settings ([c6d796d](https://github.com/evermemos/evermemos-python/commit/c6d796d7bbbec539954c1802094932a919d0b8e5))
+* update SDK settings ([11a1c09](https://github.com/evermemos/evermemos-python/commit/11a1c09da854becb6567ad5428db716e38e81ee0))
+
+## 0.3.7 (2026-01-27)
+
+Full Changelog: [v0.3.6...v0.3.7](https://github.com/evermemos/evermemos-python/compare/v0.3.6...v0.3.7)
+
+### Features
+
+* **api:** api update ([b5a5ad3](https://github.com/evermemos/evermemos-python/commit/b5a5ad30160d7b74918456a269d2be73feb173ba))
+* **api:** api update ([ff8658d](https://github.com/evermemos/evermemos-python/commit/ff8658dbfa447af49ad0bf42ddf3a7bf84c5af08))
+
+
+### Chores
+
+* update SDK settings ([7846bc7](https://github.com/evermemos/evermemos-python/commit/7846bc750ca4ab190a39feeb9dfd096854618cb1))
+* update SDK settings ([fa846b9](https://github.com/evermemos/evermemos-python/commit/fa846b9647c78fbd9b072b6d397b8c74bbdfa2d4))
+
 ## 0.3.6 (2026-01-26)
 
 Full Changelog: [v0.3.6...v0.3.6](https://github.com/evermemos/evermemos-python/compare/v0.3.6...v0.3.6)

{evermemos-0.3.6 → evermemos-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: evermemos
-Version: 0.3.6
+Version: 0.3.8
 Summary: The official Python library for the EverMemOS API
 Project-URL: Homepage, https://github.com/evermemos/evermemos-python
 Project-URL: Repository, https://github.com/evermemos/evermemos-python
@@ -68,12 +68,12 @@ client = EverMemOS(
 )
 
 memory = client.v1.memories.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 )
-print(memory.message)
+print(memory.request_id)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -97,12 +97,12 @@ client = AsyncEverMemOS(
 
 async def main() -> None:
     memory = await client.v1.memories.create(
-        content="I prefer morning meetings, usually around 9am works best for me.",
+        content="Let's discuss the technical solution for the new feature today",
         create_time="2025-01-15T10:00:00+00:00",
         message_id="msg_001",
-        sender="user_alice",
+        sender="user_001",
     )
-    print(memory.message)
+    print(memory.request_id)
 
 
 asyncio.run(main())
@@ -136,12 +136,12 @@ async def main() -> None:
         http_client=DefaultAioHttpClient(),
     ) as client:
         memory = await client.v1.memories.create(
-            content="I prefer morning meetings, usually around 9am works best for me.",
+            content="Let's discuss the technical solution for the new feature today",
             create_time="2025-01-15T10:00:00+00:00",
             message_id="msg_001",
-            sender="user_alice",
+            sender="user_001",
         )
-        print(memory.message)
+        print(memory.request_id)
 
 
 asyncio.run(main())
@@ -156,6 +156,34 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## Nested params
+
+Nested parameters are dictionaries, typed using `TypedDict`, for example:
+
+```python
+from evermemos import EverMemOS
+
+client = EverMemOS()
+
+response = client.v1.memories.load(
+    conversation_meta={
+        "group_id": "chat_user_001_assistant",
+        "created_at": "2025-06-26T00:00:00Z",
+        "default_timezone": "UTC",
+        "description": "Conversation between user and assistant",
+        "name": "User Support Chat",
+        "scene": "assistant",
+        "scene_desc": {"description": "bar"},
+        "tags": ["support"],
+        "user_details": {
+            "user_001": "bar",
+            "robot_001": "bar",
+        },
+    },
+)
+print(response.conversation_meta)
+```
+
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `evermemos.APIConnectionError` is raised.
@@ -173,10 +201,10 @@ client = EverMemOS()
 
 try:
     client.v1.memories.create(
-        content="I prefer morning meetings, usually around 9am works best for me.",
+        content="Let's discuss the technical solution for the new feature today",
         create_time="2025-01-15T10:00:00+00:00",
         message_id="msg_001",
-        sender="user_alice",
+        sender="user_001",
     )
 except evermemos.APIConnectionError as e:
     print("The server could not be reached")
@@ -221,10 +249,10 @@ client = EverMemOS(
 
 # Or, configure per-request:
 client.with_options(max_retries=5).v1.memories.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 )
 ```
 
@@ -249,10 +277,10 @@ client = EverMemOS(
 
 # Override per-request:
 client.with_options(timeout=5.0).v1.memories.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 )
 ```
 
@@ -295,15 +323,15 @@ from evermemos import EverMemOS
 
 client = EverMemOS()
 response = client.v1.memories.with_raw_response.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 )
 print(response.headers.get('X-My-Header'))
 
 memory = response.parse()  # get the object that `v1.memories.create()` would have returned
-print(memory.message)
+print(memory.request_id)
 ```
 
 These methods return an [`APIResponse`](https://github.com/evermemos/evermemos-python/tree/main/src/evermemos/_response.py) object.
@@ -318,10 +346,10 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 
 ```python
 with client.v1.memories.with_streaming_response.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{evermemos-0.3.6 → evermemos-0.3.8}/README.md

@@ -33,12 +33,12 @@ client = EverMemOS(
 )
 
 memory = client.v1.memories.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 )
-print(memory.message)
+print(memory.request_id)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -62,12 +62,12 @@ client = AsyncEverMemOS(
 
 async def main() -> None:
     memory = await client.v1.memories.create(
-        content="I prefer morning meetings, usually around 9am works best for me.",
+        content="Let's discuss the technical solution for the new feature today",
         create_time="2025-01-15T10:00:00+00:00",
         message_id="msg_001",
-        sender="user_alice",
+        sender="user_001",
     )
-    print(memory.message)
+    print(memory.request_id)
 
 
 asyncio.run(main())
@@ -101,12 +101,12 @@ async def main() -> None:
         http_client=DefaultAioHttpClient(),
     ) as client:
         memory = await client.v1.memories.create(
-            content="I prefer morning meetings, usually around 9am works best for me.",
+            content="Let's discuss the technical solution for the new feature today",
             create_time="2025-01-15T10:00:00+00:00",
             message_id="msg_001",
-            sender="user_alice",
+            sender="user_001",
         )
-        print(memory.message)
+        print(memory.request_id)
 
 
 asyncio.run(main())
@@ -121,6 +121,34 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## Nested params
+
+Nested parameters are dictionaries, typed using `TypedDict`, for example:
+
+```python
+from evermemos import EverMemOS
+
+client = EverMemOS()
+
+response = client.v1.memories.load(
+    conversation_meta={
+        "group_id": "chat_user_001_assistant",
+        "created_at": "2025-06-26T00:00:00Z",
+        "default_timezone": "UTC",
+        "description": "Conversation between user and assistant",
+        "name": "User Support Chat",
+        "scene": "assistant",
+        "scene_desc": {"description": "bar"},
+        "tags": ["support"],
+        "user_details": {
+            "user_001": "bar",
+            "robot_001": "bar",
+        },
+    },
+)
+print(response.conversation_meta)
+```
+
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `evermemos.APIConnectionError` is raised.
@@ -138,10 +166,10 @@ client = EverMemOS()
 
 try:
     client.v1.memories.create(
-        content="I prefer morning meetings, usually around 9am works best for me.",
+        content="Let's discuss the technical solution for the new feature today",
         create_time="2025-01-15T10:00:00+00:00",
         message_id="msg_001",
-        sender="user_alice",
+        sender="user_001",
     )
 except evermemos.APIConnectionError as e:
     print("The server could not be reached")
@@ -186,10 +214,10 @@ client = EverMemOS(
 
 # Or, configure per-request:
 client.with_options(max_retries=5).v1.memories.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 )
 ```
 
@@ -214,10 +242,10 @@ client = EverMemOS(
 
 # Override per-request:
 client.with_options(timeout=5.0).v1.memories.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 )
 ```
 
@@ -260,15 +288,15 @@ from evermemos import EverMemOS
 
 client = EverMemOS()
 response = client.v1.memories.with_raw_response.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 )
 print(response.headers.get('X-My-Header'))
 
 memory = response.parse()  # get the object that `v1.memories.create()` would have returned
-print(memory.message)
+print(memory.request_id)
 ```
 
 These methods return an [`APIResponse`](https://github.com/evermemos/evermemos-python/tree/main/src/evermemos/_response.py) object.
@@ -283,10 +311,10 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 
 ```python
 with client.v1.memories.with_streaming_response.create(
-    content="I prefer morning meetings, usually around 9am works best for me.",
+    content="Let's discuss the technical solution for the new feature today",
     create_time="2025-01-15T10:00:00+00:00",
     message_id="msg_001",
-    sender="user_alice",
+    sender="user_001",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{evermemos-0.3.6 → evermemos-0.3.8}/api.md

@@ -9,8 +9,9 @@ from evermemos.types.v1 import (
     MemoryType,
     Metadata,
     MemoryCreateResponse,
-    MemoryListResponse,
     MemoryDeleteResponse,
+    MemoryGetResponse,
+    MemoryLoadResponse,
     MemorySearchResponse,
 )
 ```
@@ -18,8 +19,9 @@ from evermemos.types.v1 import (
 Methods:
 
 - <code title="post /api/v1/memories">client.v1.memories.<a href="./src/evermemos/resources/v1/memories/memories.py">create</a>(\*\*<a href="src/evermemos/types/v1/memory_create_params.py">params</a>) -> <a href="./src/evermemos/types/v1/memory_create_response.py">MemoryCreateResponse</a></code>
-- <code title="get /api/v1/memories">client.v1.memories.<a href="./src/evermemos/resources/v1/memories/memories.py">list</a>() -> <a href="./src/evermemos/types/v1/memory_list_response.py">MemoryListResponse</a></code>
 - <code title="delete /api/v1/memories">client.v1.memories.<a href="./src/evermemos/resources/v1/memories/memories.py">delete</a>(\*\*<a href="src/evermemos/types/v1/memory_delete_params.py">params</a>) -> <a href="./src/evermemos/types/v1/memory_delete_response.py">MemoryDeleteResponse</a></code>
+- <code title="get /api/v1/memories">client.v1.memories.<a href="./src/evermemos/resources/v1/memories/memories.py">get</a>() -> <a href="./src/evermemos/types/v1/memory_get_response.py">MemoryGetResponse</a></code>
+- <code title="post /api/v1/memories/import">client.v1.memories.<a href="./src/evermemos/resources/v1/memories/memories.py">load</a>(\*\*<a href="src/evermemos/types/v1/memory_load_params.py">params</a>) -> <a href="./src/evermemos/types/v1/memory_load_response.py">MemoryLoadResponse</a></code>
 - <code title="get /api/v1/memories/search">client.v1.memories.<a href="./src/evermemos/resources/v1/memories/memories.py">search</a>() -> <a href="./src/evermemos/types/v1/memory_search_response.py">MemorySearchResponse</a></code>
 
 ### ConversationMeta
@@ -39,3 +41,17 @@ Methods:
 - <code title="post /api/v1/memories/conversation-meta">client.v1.memories.conversation_meta.<a href="./src/evermemos/resources/v1/memories/conversation_meta.py">create</a>(\*\*<a href="src/evermemos/types/v1/memories/conversation_meta_create_params.py">params</a>) -> <a href="./src/evermemos/types/v1/memories/conversation_meta_create_response.py">ConversationMetaCreateResponse</a></code>
 - <code title="patch /api/v1/memories/conversation-meta">client.v1.memories.conversation_meta.<a href="./src/evermemos/resources/v1/memories/conversation_meta.py">update</a>(\*\*<a href="src/evermemos/types/v1/memories/conversation_meta_update_params.py">params</a>) -> <a href="./src/evermemos/types/v1/memories/conversation_meta_update_response.py">ConversationMetaUpdateResponse</a></code>
 - <code title="get /api/v1/memories/conversation-meta">client.v1.memories.conversation_meta.<a href="./src/evermemos/resources/v1/memories/conversation_meta.py">get</a>() -> <a href="./src/evermemos/types/v1/memories/conversation_meta_get_response.py">ConversationMetaGetResponse</a></code>
+
+## Stats
+
+### Request
+
+Types:
+
+```python
+from evermemos.types.v1.stats import RequestGetResponse
+```
+
+Methods:
+
+- <code title="get /api/v1/stats/request">client.v1.stats.request.<a href="./src/evermemos/resources/v1/stats/request.py">get</a>(\*\*<a href="src/evermemos/types/v1/stats/request_get_params.py">params</a>) -> <a href="./src/evermemos/types/v1/stats/request_get_response.py">RequestGetResponse</a></code>

{evermemos-0.3.6 → evermemos-0.3.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "evermemos"
-version = "0.3.6"
+version = "0.3.8"
 description = "The official Python library for the EverMemOS API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{evermemos-0.3.6 → evermemos-0.3.8}/src/evermemos/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "evermemos"
-__version__ = "0.3.6"  # x-release-please-version
+__version__ = "0.3.8"  # x-release-please-version

{evermemos-0.3.6 → evermemos-0.3.8}/src/evermemos/resources/v1/__init__.py

@@ -8,6 +8,14 @@ from .v1 import (
     V1ResourceWithStreamingResponse,
     AsyncV1ResourceWithStreamingResponse,
 )
+from .stats import (
+    StatsResource,
+    AsyncStatsResource,
+    StatsResourceWithRawResponse,
+    AsyncStatsResourceWithRawResponse,
+    StatsResourceWithStreamingResponse,
+    AsyncStatsResourceWithStreamingResponse,
+)
 from .memories import (
     MemoriesResource,
     AsyncMemoriesResource,
@@ -24,6 +32,12 @@ __all__ = [
     "AsyncMemoriesResourceWithRawResponse",
     "MemoriesResourceWithStreamingResponse",
     "AsyncMemoriesResourceWithStreamingResponse",
+    "StatsResource",
+    "AsyncStatsResource",
+    "StatsResourceWithRawResponse",
+    "AsyncStatsResourceWithRawResponse",
+    "StatsResourceWithStreamingResponse",
+    "AsyncStatsResourceWithStreamingResponse",
     "V1Resource",
     "AsyncV1Resource",
     "V1ResourceWithRawResponse",

{evermemos-0.3.6 → evermemos-0.3.8}/src/evermemos/resources/v1/memories/conversation_meta.py

@@ -52,7 +52,6 @@ class ConversationMetaResource(SyncAPIResource):
         name: str,
         scene: str,
         scene_desc: Dict[str, object],
-        version: str,
         default_timezone: Optional[str] | Omit = omit,
         description: Optional[str] | Omit = omit,
         group_id: Optional[str] | Omit = omit,
@@ -69,19 +68,6 @@ class ConversationMetaResource(SyncAPIResource):
         Save conversation metadata information, including scene, participants, tags,
         etc.
 
-                ## Functionality:
-                - If group_id exists, update the entire record (upsert)
-                - If group_id does not exist, create a new record
-                - If group_id is omitted, save as default config for the scene
-                - All fields must be provided with complete data
-
-                ## Default Config:
-                - Default config is used as fallback when specific group_id config not found
-
-                ## Notes:
-                - This is a full update interface that will replace the entire record
-                - If you only need to update partial fields, use the PATCH /conversation-meta interface
-
         Args:
           created_at: Conversation creation time (ISO 8601 format)
 
@@ -97,8 +83,6 @@ class ConversationMetaResource(SyncAPIResource):
 
           scene_desc: Scene description object, can include fields like description
 
-          version: Metadata version number
-
           default_timezone: Default timezone
 
           description: Conversation description
@@ -126,7 +110,6 @@ class ConversationMetaResource(SyncAPIResource):
                     "name": name,
                     "scene": scene,
                     "scene_desc": scene_desc,
-                    "version": version,
                     "default_timezone": default_timezone,
                     "description": description,
                     "group_id": group_id,
@@ -161,12 +144,6 @@ class ConversationMetaResource(SyncAPIResource):
         """
         Partially update conversation metadata, only updating provided fields
 
-                ## Functionality:
-                - Locate the conversation metadata to update by group_id
-                - When group_id is null or not provided, updates the default config
-                - Only update fields provided in the request, keep unchanged fields as-is
-                - Suitable for scenarios requiring modification of partial information
-
         Args:
           default_timezone: New default timezone
 
@@ -220,22 +197,7 @@ class ConversationMetaResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ConversationMetaGetResponse:
-        """
-        Retrieve conversation metadata by group_id with fallback to default config
-
-                ## Functionality:
-                - Query by group_id to get conversation metadata
-                - If group_id not found, fallback to default config
-                - If group_id not provided, returns default config
-
-                ## Fallback Logic:
-                - Try exact group_id first, then use default config
-
-                ## Use Cases:
-                - Get specific group's metadata
-                - Get default settings (group_id not provided or null)
-                - Auto-fallback to defaults when group config not set
-        """
+        """Retrieve conversation metadata by group_id with fallback to default config"""
         return self._get(
             "/api/v1/memories/conversation-meta",
             options=make_request_options(
@@ -272,7 +234,6 @@ class AsyncConversationMetaResource(AsyncAPIResource):
         name: str,
         scene: str,
         scene_desc: Dict[str, object],
-        version: str,
         default_timezone: Optional[str] | Omit = omit,
         description: Optional[str] | Omit = omit,
         group_id: Optional[str] | Omit = omit,
@@ -289,19 +250,6 @@ class AsyncConversationMetaResource(AsyncAPIResource):
         Save conversation metadata information, including scene, participants, tags,
         etc.
 
-                ## Functionality:
-                - If group_id exists, update the entire record (upsert)
-                - If group_id does not exist, create a new record
-                - If group_id is omitted, save as default config for the scene
-                - All fields must be provided with complete data
-
-                ## Default Config:
-                - Default config is used as fallback when specific group_id config not found
-
-                ## Notes:
-                - This is a full update interface that will replace the entire record
-                - If you only need to update partial fields, use the PATCH /conversation-meta interface
-
         Args:
           created_at: Conversation creation time (ISO 8601 format)
 
@@ -317,8 +265,6 @@ class AsyncConversationMetaResource(AsyncAPIResource):
 
           scene_desc: Scene description object, can include fields like description
 
-          version: Metadata version number
-
           default_timezone: Default timezone
 
           description: Conversation description
@@ -346,7 +292,6 @@ class AsyncConversationMetaResource(AsyncAPIResource):
                     "name": name,
                     "scene": scene,
                     "scene_desc": scene_desc,
-                    "version": version,
                     "default_timezone": default_timezone,
                     "description": description,
                     "group_id": group_id,
@@ -381,12 +326,6 @@ class AsyncConversationMetaResource(AsyncAPIResource):
         """
         Partially update conversation metadata, only updating provided fields
 
-                ## Functionality:
-                - Locate the conversation metadata to update by group_id
-                - When group_id is null or not provided, updates the default config
-                - Only update fields provided in the request, keep unchanged fields as-is
-                - Suitable for scenarios requiring modification of partial information
-
         Args:
           default_timezone: New default timezone
 
@@ -440,22 +379,7 @@ class AsyncConversationMetaResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ConversationMetaGetResponse:
-        """
-        Retrieve conversation metadata by group_id with fallback to default config
-
-                ## Functionality:
-                - Query by group_id to get conversation metadata
-                - If group_id not found, fallback to default config
-                - If group_id not provided, returns default config
-
-                ## Fallback Logic:
-                - Try exact group_id first, then use default config
-
-                ## Use Cases:
-                - Get specific group's metadata
-                - Get default settings (group_id not provided or null)
-                - Auto-fallback to defaults when group config not set
-        """
+        """Retrieve conversation metadata by group_id with fallback to default config"""
         return await self._get(
             "/api/v1/memories/conversation-meta",
             options=make_request_options(