evermemos 0.3.6__py3-none-any.whl → 0.3.8__py3-none-any.whl

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/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/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(

evermemos/resources/v1/memories/memories.py

@@ -2,14 +2,14 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Iterable, Optional
 
 import httpx
 
 from ...._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
-from ....types.v1 import memory_create_params, memory_delete_params
+from ....types.v1 import memory_load_params, memory_create_params, memory_delete_params
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
     to_raw_response_wrapper,
@@ -26,7 +26,8 @@ from .conversation_meta import (
     ConversationMetaResourceWithStreamingResponse,
     AsyncConversationMetaResourceWithStreamingResponse,
 )
-from ....types.v1.memory_list_response import MemoryListResponse
+from ....types.v1.memory_get_response import MemoryGetResponse
+from ....types.v1.memory_load_response import MemoryLoadResponse
 from ....types.v1.memory_create_response import MemoryCreateResponse
 from ....types.v1.memory_delete_response import MemoryDeleteResponse
 from ....types.v1.memory_search_response import MemorySearchResponse
@@ -65,6 +66,7 @@ class MemoriesResource(SyncAPIResource):
         create_time: str,
         message_id: str,
         sender: str,
+        flush: bool | Omit = omit,
         group_id: Optional[str] | Omit = omit,
         group_name: Optional[str] | Omit = omit,
         refer_list: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -87,9 +89,14 @@ class MemoriesResource(SyncAPIResource):
 
           message_id: Message unique identifier
 
-          sender: Sender user ID
+          sender: Sender user ID (required). Also used as user_id internally for memory ownership.
 
-          group_id: Group ID
+          flush: Force boundary trigger. When True, immediately triggers memory extraction
+              instead of waiting for natural boundary detection.
+
+          group_id: Group ID. If not provided, will automatically generate based on hash(sender) +
+              '\\__group' suffix, representing single-user mode where each user's messages are
+              extracted into separate memory spaces.
 
           group_name: Group name
 
@@ -119,6 +126,7 @@ class MemoriesResource(SyncAPIResource):
                     "create_time": create_time,
                     "message_id": message_id,
                     "sender": sender,
+                    "flush": flush,
                     "group_id": group_id,
                     "group_name": group_name,
                     "refer_list": refer_list,
@@ -133,69 +141,96 @@ class MemoriesResource(SyncAPIResource):
             cast_to=MemoryCreateResponse,
         )
 
-    def list(
+    def delete(
         self,
         *,
+        group_id: Optional[str] | Omit = omit,
+        memory_id: Optional[str] | Omit = omit,
+        user_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> MemoryListResponse:
+    ) -> MemoryDeleteResponse:
+        """
+        Delete memory records based on combined filter criteria
+
+        Args:
+          group_id: Group ID (filter condition)
+
+          memory_id: Memory id (filter condition)
+
+          user_id: User ID (filter condition)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._delete(
+            "/api/v1/memories",
+            body=maybe_transform(
+                {
+                    "group_id": group_id,
+                    "memory_id": memory_id,
+                    "user_id": user_id,
+                },
+                memory_delete_params.MemoryDeleteParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=MemoryDeleteResponse,
+        )
+
+    def get(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> MemoryGetResponse:
         """Retrieve memory records by memory_type with optional filters"""
         return self._get(
             "/api/v1/memories",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MemoryListResponse,
+            cast_to=MemoryGetResponse,
         )
 
-    def delete(
+    def load(
         self,
         *,
-        event_id: Optional[str] | Omit = omit,
-        group_id: Optional[str] | Omit = omit,
-        user_id: Optional[str] | Omit = omit,
+        conversation_meta: memory_load_params.ConversationMeta,
+        conversation_list: Optional[Iterable[memory_load_params.ConversationList]] | Omit = omit,
+        version: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> MemoryDeleteResponse:
-        """
-        Delete memory records based on combined filter criteria
-
-                ## Functionality:
-                - Delete records matching combined filter conditions
-                - If multiple conditions provided, ALL must be satisfied (AND logic)
-                - At least one filter must be specified
+    ) -> MemoryLoadResponse:
+        """Import conversation metadata and message list in one request.
 
-                ## Filter Parameters (combined with AND):
-                - **event_id**: Filter by specific event_id
-                - **user_id**: Filter by user ID
-                - **group_id**: Filter by group ID
-
-                ## Examples:
-                - event_id only: Delete specific memory
-                - user_id only: Delete all user's memories
-                - user_id + group_id: Delete user's memories in specific group
-                - event_id + user_id + group_id: Delete if all conditions match
-
-                ## Use cases:
-                - User requests data deletion
-                - Group chat cleanup
-                - Privacy compliance (GDPR, etc.)
-                - Conversation history management
+        Messages are
+        queued for processing.
 
         Args:
-          event_id: Memory event_id (filter condition)
+          conversation_meta: Conversation metadata for batch import.
 
-          group_id: Group ID (filter condition)
+          conversation_list: Message list.
 
-          user_id: User ID (filter condition)
+          version: Format version.
 
           extra_headers: Send extra headers
 
@@ -205,20 +240,20 @@ class MemoriesResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return self._delete(
-            "/api/v1/memories",
+        return self._post(
+            "/api/v1/memories/import",
             body=maybe_transform(
                 {
-                    "event_id": event_id,
-                    "group_id": group_id,
-                    "user_id": user_id,
+                    "conversation_meta": conversation_meta,
+                    "conversation_list": conversation_list,
+                    "version": version,
                 },
-                memory_delete_params.MemoryDeleteParams,
+                memory_load_params.MemoryLoadParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MemoryDeleteResponse,
+            cast_to=MemoryLoadResponse,
         )
 
     def search(
@@ -275,6 +310,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
         create_time: str,
         message_id: str,
         sender: str,
+        flush: bool | Omit = omit,
         group_id: Optional[str] | Omit = omit,
         group_name: Optional[str] | Omit = omit,
         refer_list: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -297,9 +333,14 @@ class AsyncMemoriesResource(AsyncAPIResource):
 
           message_id: Message unique identifier
 
-          sender: Sender user ID
+          sender: Sender user ID (required). Also used as user_id internally for memory ownership.
 
-          group_id: Group ID
+          flush: Force boundary trigger. When True, immediately triggers memory extraction
+              instead of waiting for natural boundary detection.
+
+          group_id: Group ID. If not provided, will automatically generate based on hash(sender) +
+              '\\__group' suffix, representing single-user mode where each user's messages are
+              extracted into separate memory spaces.
 
           group_name: Group name
 
@@ -329,6 +370,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
                     "create_time": create_time,
                     "message_id": message_id,
                     "sender": sender,
+                    "flush": flush,
                     "group_id": group_id,
                     "group_name": group_name,
                     "refer_list": refer_list,
@@ -343,7 +385,54 @@ class AsyncMemoriesResource(AsyncAPIResource):
             cast_to=MemoryCreateResponse,
         )
 
-    async def list(
+    async def delete(
+        self,
+        *,
+        group_id: Optional[str] | Omit = omit,
+        memory_id: Optional[str] | Omit = omit,
+        user_id: Optional[str] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> MemoryDeleteResponse:
+        """
+        Delete memory records based on combined filter criteria
+
+        Args:
+          group_id: Group ID (filter condition)
+
+          memory_id: Memory id (filter condition)
+
+          user_id: User ID (filter condition)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._delete(
+            "/api/v1/memories",
+            body=await async_maybe_transform(
+                {
+                    "group_id": group_id,
+                    "memory_id": memory_id,
+                    "user_id": user_id,
+                },
+                memory_delete_params.MemoryDeleteParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=MemoryDeleteResponse,
+        )
+
+    async def get(
         self,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -352,60 +441,40 @@ class AsyncMemoriesResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> MemoryListResponse:
+    ) -> MemoryGetResponse:
         """Retrieve memory records by memory_type with optional filters"""
         return await self._get(
             "/api/v1/memories",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MemoryListResponse,
+            cast_to=MemoryGetResponse,
         )
 
-    async def delete(
+    async def load(
         self,
         *,
-        event_id: Optional[str] | Omit = omit,
-        group_id: Optional[str] | Omit = omit,
-        user_id: Optional[str] | Omit = omit,
+        conversation_meta: memory_load_params.ConversationMeta,
+        conversation_list: Optional[Iterable[memory_load_params.ConversationList]] | Omit = omit,
+        version: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> MemoryDeleteResponse:
-        """
-        Delete memory records based on combined filter criteria
-
-                ## Functionality:
-                - Delete records matching combined filter conditions
-                - If multiple conditions provided, ALL must be satisfied (AND logic)
-                - At least one filter must be specified
-
-                ## Filter Parameters (combined with AND):
-                - **event_id**: Filter by specific event_id
-                - **user_id**: Filter by user ID
-                - **group_id**: Filter by group ID
-
-                ## Examples:
-                - event_id only: Delete specific memory
-                - user_id only: Delete all user's memories
-                - user_id + group_id: Delete user's memories in specific group
-                - event_id + user_id + group_id: Delete if all conditions match
+    ) -> MemoryLoadResponse:
+        """Import conversation metadata and message list in one request.
 
-                ## Use cases:
-                - User requests data deletion
-                - Group chat cleanup
-                - Privacy compliance (GDPR, etc.)
-                - Conversation history management
+        Messages are
+        queued for processing.
 
         Args:
-          event_id: Memory event_id (filter condition)
+          conversation_meta: Conversation metadata for batch import.
 
-          group_id: Group ID (filter condition)
+          conversation_list: Message list.
 
-          user_id: User ID (filter condition)
+          version: Format version.
 
           extra_headers: Send extra headers
 
@@ -415,20 +484,20 @@ class AsyncMemoriesResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return await self._delete(
-            "/api/v1/memories",
+        return await self._post(
+            "/api/v1/memories/import",
             body=await async_maybe_transform(
                 {
-                    "event_id": event_id,
-                    "group_id": group_id,
-                    "user_id": user_id,
+                    "conversation_meta": conversation_meta,
+                    "conversation_list": conversation_list,
+                    "version": version,
                 },
-                memory_delete_params.MemoryDeleteParams,
+                memory_load_params.MemoryLoadParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MemoryDeleteResponse,
+            cast_to=MemoryLoadResponse,
         )
 
     async def search(
@@ -461,12 +530,15 @@ class MemoriesResourceWithRawResponse:
         self.create = to_raw_response_wrapper(
             memories.create,
         )
-        self.list = to_raw_response_wrapper(
-            memories.list,
-        )
         self.delete = to_raw_response_wrapper(
             memories.delete,
         )
+        self.get = to_raw_response_wrapper(
+            memories.get,
+        )
+        self.load = to_raw_response_wrapper(
+            memories.load,
+        )
         self.search = to_raw_response_wrapper(
             memories.search,
         )
@@ -483,12 +555,15 @@ class AsyncMemoriesResourceWithRawResponse:
         self.create = async_to_raw_response_wrapper(
             memories.create,
         )
-        self.list = async_to_raw_response_wrapper(
-            memories.list,
-        )
         self.delete = async_to_raw_response_wrapper(
             memories.delete,
         )
+        self.get = async_to_raw_response_wrapper(
+            memories.get,
+        )
+        self.load = async_to_raw_response_wrapper(
+            memories.load,
+        )
         self.search = async_to_raw_response_wrapper(
             memories.search,
         )
@@ -505,12 +580,15 @@ class MemoriesResourceWithStreamingResponse:
         self.create = to_streamed_response_wrapper(
             memories.create,
         )
-        self.list = to_streamed_response_wrapper(
-            memories.list,
-        )
         self.delete = to_streamed_response_wrapper(
             memories.delete,
         )
+        self.get = to_streamed_response_wrapper(
+            memories.get,
+        )
+        self.load = to_streamed_response_wrapper(
+            memories.load,
+        )
         self.search = to_streamed_response_wrapper(
             memories.search,
         )
@@ -527,12 +605,15 @@ class AsyncMemoriesResourceWithStreamingResponse:
         self.create = async_to_streamed_response_wrapper(
             memories.create,
         )
-        self.list = async_to_streamed_response_wrapper(
-            memories.list,
-        )
         self.delete = async_to_streamed_response_wrapper(
             memories.delete,
         )
+        self.get = async_to_streamed_response_wrapper(
+            memories.get,
+        )
+        self.load = async_to_streamed_response_wrapper(
+            memories.load,
+        )
         self.search = async_to_streamed_response_wrapper(
             memories.search,
         )