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

evermemos/resources/v1/v1.py

@@ -4,13 +4,13 @@ from __future__ import annotations
 
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
-from .stats.stats import (
-    StatsResource,
-    AsyncStatsResource,
-    StatsResourceWithRawResponse,
-    AsyncStatsResourceWithRawResponse,
-    StatsResourceWithStreamingResponse,
-    AsyncStatsResourceWithStreamingResponse,
+from .status.status import (
+    StatusResource,
+    AsyncStatusResource,
+    StatusResourceWithRawResponse,
+    AsyncStatusResourceWithRawResponse,
+    StatusResourceWithStreamingResponse,
+    AsyncStatusResourceWithStreamingResponse,
 )
 from .memories.memories import (
     MemoriesResource,
@@ -30,8 +30,8 @@ class V1Resource(SyncAPIResource):
         return MemoriesResource(self._client)
 
     @cached_property
-    def stats(self) -> StatsResource:
-        return StatsResource(self._client)
+    def status(self) -> StatusResource:
+        return StatusResource(self._client)
 
     @cached_property
     def with_raw_response(self) -> V1ResourceWithRawResponse:
@@ -59,8 +59,8 @@ class AsyncV1Resource(AsyncAPIResource):
         return AsyncMemoriesResource(self._client)
 
     @cached_property
-    def stats(self) -> AsyncStatsResource:
-        return AsyncStatsResource(self._client)
+    def status(self) -> AsyncStatusResource:
+        return AsyncStatusResource(self._client)
 
     @cached_property
     def with_raw_response(self) -> AsyncV1ResourceWithRawResponse:
@@ -91,8 +91,8 @@ class V1ResourceWithRawResponse:
         return MemoriesResourceWithRawResponse(self._v1.memories)
 
     @cached_property
-    def stats(self) -> StatsResourceWithRawResponse:
-        return StatsResourceWithRawResponse(self._v1.stats)
+    def status(self) -> StatusResourceWithRawResponse:
+        return StatusResourceWithRawResponse(self._v1.status)
 
 
 class AsyncV1ResourceWithRawResponse:
@@ -104,8 +104,8 @@ class AsyncV1ResourceWithRawResponse:
         return AsyncMemoriesResourceWithRawResponse(self._v1.memories)
 
     @cached_property
-    def stats(self) -> AsyncStatsResourceWithRawResponse:
-        return AsyncStatsResourceWithRawResponse(self._v1.stats)
+    def status(self) -> AsyncStatusResourceWithRawResponse:
+        return AsyncStatusResourceWithRawResponse(self._v1.status)
 
 
 class V1ResourceWithStreamingResponse:
@@ -117,8 +117,8 @@ class V1ResourceWithStreamingResponse:
         return MemoriesResourceWithStreamingResponse(self._v1.memories)
 
     @cached_property
-    def stats(self) -> StatsResourceWithStreamingResponse:
-        return StatsResourceWithStreamingResponse(self._v1.stats)
+    def status(self) -> StatusResourceWithStreamingResponse:
+        return StatusResourceWithStreamingResponse(self._v1.status)
 
 
 class AsyncV1ResourceWithStreamingResponse:
@@ -130,5 +130,5 @@ class AsyncV1ResourceWithStreamingResponse:
         return AsyncMemoriesResourceWithStreamingResponse(self._v1.memories)
 
     @cached_property
-    def stats(self) -> AsyncStatsResourceWithStreamingResponse:
-        return AsyncStatsResourceWithStreamingResponse(self._v1.stats)
+    def status(self) -> AsyncStatusResourceWithStreamingResponse:
+        return AsyncStatusResourceWithStreamingResponse(self._v1.status)

evermemos/types/v1/__init__.py

@@ -4,11 +4,9 @@ from __future__ import annotations
 
 from .metadata import Metadata as Metadata
 from .memory_type import MemoryType as MemoryType
-from .memory_load_params import MemoryLoadParams as MemoryLoadParams
+from .memory_add_params import MemoryAddParams as MemoryAddParams
+from .memory_add_response import MemoryAddResponse as MemoryAddResponse
 from .memory_get_response import MemoryGetResponse as MemoryGetResponse
-from .memory_create_params import MemoryCreateParams as MemoryCreateParams
 from .memory_delete_params import MemoryDeleteParams as MemoryDeleteParams
-from .memory_load_response import MemoryLoadResponse as MemoryLoadResponse
-from .memory_create_response import MemoryCreateResponse as MemoryCreateResponse
 from .memory_delete_response import MemoryDeleteResponse as MemoryDeleteResponse
 from .memory_search_response import MemorySearchResponse as MemorySearchResponse

evermemos/types/v1/memories/conversation_meta_create_params.py

@@ -7,28 +7,19 @@ from typing_extensions import Required, TypedDict
 
 from ...._types import SequenceNotStr
 
-__all__ = ["ConversationMetaCreateParams", "UserDetails"]
+__all__ = [
+    "ConversationMetaCreateParams",
+    "LlmCustomSetting",
+    "LlmCustomSettingBoundary",
+    "LlmCustomSettingExtraction",
+    "UserDetails",
+]
 
 
 class ConversationMetaCreateParams(TypedDict, total=False):
     created_at: Required[str]
     """Conversation creation time (ISO 8601 format)"""
 
-    name: Required[str]
-    """Conversation name"""
-
-    scene: Required[str]
-    """Scene identifier, enum values from ScenarioType:
-
-    - group_chat: work/group chat scenario, suitable for group conversations such as
-      multi-person collaboration and project discussions
-    - assistant: assistant scenario, suitable for one-on-one AI assistant
-      conversations
-    """
-
-    scene_desc: Required[Dict[str, object]]
-    """Scene description object, can include fields like description"""
-
     default_timezone: Optional[str]
     """Default timezone"""
 
@@ -41,6 +32,46 @@ class ConversationMetaCreateParams(TypedDict, total=False):
     When null/not provided, represents default settings for this scene.
     """
 
+    llm_custom_setting: Optional[LlmCustomSetting]
+    """LLM custom settings for algorithm control.
+
+    **Only for global config (group_id=null), not allowed for group config (group_id
+    provided).**
+
+    Allows configuring different LLM providers/models for different tasks like
+    boundary detection and memory extraction.
+    """
+
+    name: Optional[str]
+    """Group/conversation name.
+
+    **Required for group config (group_id provided), not allowed for global config
+    (group_id=null).**
+    """
+
+    scene: Optional[str]
+    """Scene identifier.
+
+    **Required for global config (group_id=null), not allowed for group config
+    (group_id provided).**
+
+    Enum values from ScenarioType:
+
+    - group_chat: work/group chat scenario, suitable for group conversations such as
+      multi-person collaboration and project discussions
+    - assistant: assistant scenario, suitable for one-on-one AI assistant
+      conversations
+    """
+
+    scene_desc: Optional[Dict[str, object]]
+    """Scene description object.
+
+    **Required for global config (group_id=null), not allowed for group config
+    (group_id provided).**
+
+    Can include fields like description, type, etc.
+    """
+
     tags: Optional[SequenceNotStr[str]]
     """Tag list"""
 
@@ -48,12 +79,52 @@ class ConversationMetaCreateParams(TypedDict, total=False):
     """Participant details, key is user ID, value is user detail object"""
 
 
-class UserDetails(TypedDict, total=False):
-    """User details
+class LlmCustomSettingBoundary(TypedDict, total=False):
+    """LLM config for boundary detection (fast, cheap model recommended)"""
+
+    model: Required[str]
+    """Model name"""
+
+    provider: Required[str]
+    """LLM provider name"""
+
+    extra: Optional[Dict[str, object]]
+    """Additional provider-specific configuration"""
+
+
+class LlmCustomSettingExtraction(TypedDict, total=False):
+    """LLM config for memory extraction (high quality model recommended)"""
+
+    model: Required[str]
+    """Model name"""
 
-    Structure for the value of ConversationMetaRequest.user_details
+    provider: Required[str]
+    """LLM provider name"""
+
+    extra: Optional[Dict[str, object]]
+    """Additional provider-specific configuration"""
+
+
+class LlmCustomSetting(TypedDict, total=False):
+    """LLM custom settings for algorithm control.
+
+    **Only for global config (group_id=null),
+    not allowed for group config (group_id provided).**
+
+    Allows configuring different LLM providers/models for different tasks like boundary detection and memory extraction.
     """
 
+    boundary: Optional[LlmCustomSettingBoundary]
+    """LLM config for boundary detection (fast, cheap model recommended)"""
+
+    extra: Optional[Dict[str, object]]
+    """Additional task-specific LLM configurations"""
+
+    extraction: Optional[LlmCustomSettingExtraction]
+    """LLM config for memory extraction (high quality model recommended)"""
+
+
+class UserDetails(TypedDict, total=False):
     custom_role: Optional[str]
     """User's job/position role (e.g. developer, designer, manager)"""
 

evermemos/types/v1/memories/conversation_meta_create_response.py

@@ -4,7 +4,52 @@ from typing import Dict, List, Optional
 
 from ...._models import BaseModel
 
-__all__ = ["ConversationMetaCreateResponse", "Result"]
+__all__ = [
+    "ConversationMetaCreateResponse",
+    "Result",
+    "ResultLlmCustomSetting",
+    "ResultLlmCustomSettingBoundary",
+    "ResultLlmCustomSettingExtraction",
+]
+
+
+class ResultLlmCustomSettingBoundary(BaseModel):
+    """LLM config for boundary detection (fast, cheap model recommended)"""
+
+    model: str
+    """Model name"""
+
+    provider: str
+    """LLM provider name"""
+
+    extra: Optional[Dict[str, object]] = None
+    """Additional provider-specific configuration"""
+
+
+class ResultLlmCustomSettingExtraction(BaseModel):
+    """LLM config for memory extraction (high quality model recommended)"""
+
+    model: str
+    """Model name"""
+
+    provider: str
+    """LLM provider name"""
+
+    extra: Optional[Dict[str, object]] = None
+    """Additional provider-specific configuration"""
+
+
+class ResultLlmCustomSetting(BaseModel):
+    """LLM custom settings (only for global config)"""
+
+    boundary: Optional[ResultLlmCustomSettingBoundary] = None
+    """LLM config for boundary detection (fast, cheap model recommended)"""
+
+    extra: Optional[Dict[str, object]] = None
+    """Additional task-specific LLM configurations"""
+
+    extraction: Optional[ResultLlmCustomSettingExtraction] = None
+    """LLM config for memory extraction (high quality model recommended)"""
 
 
 class Result(BaseModel):
@@ -13,15 +58,9 @@ class Result(BaseModel):
     id: str
     """Document ID"""
 
-    conversation_created_at: str
+    conversation_created_at: Optional[str] = None
     """Conversation creation time"""
 
-    name: str
-    """Conversation name"""
-
-    scene: str
-    """Scene identifier"""
-
     created_at: Optional[str] = None
     """Record creation time"""
 
@@ -29,16 +68,25 @@ class Result(BaseModel):
     """Default timezone"""
 
     description: Optional[str] = None
-    """Conversation description"""
+    """Description"""
 
     group_id: Optional[str] = None
-    """Group ID (null for default config)"""
+    """Group ID (null for global config)"""
 
     is_default: Optional[bool] = None
-    """Whether this is the default config"""
+    """Whether this is the global (default) config"""
+
+    llm_custom_setting: Optional[ResultLlmCustomSetting] = None
+    """LLM custom settings (only for global config)"""
+
+    name: Optional[str] = None
+    """Group/conversation name (only for group config)"""
+
+    scene: Optional[str] = None
+    """Scene identifier (only for global config)"""
 
     scene_desc: Optional[Dict[str, object]] = None
-    """Scene description"""
+    """Scene description (only for global config)"""
 
     tags: Optional[List[str]] = None
     """Tags"""
@@ -51,11 +99,6 @@ class Result(BaseModel):
 
 
 class ConversationMetaCreateResponse(BaseModel):
-    """Save conversation metadata API response
-
-    Response for POST /api/v1/memories/conversation-meta endpoint.
-    """
-
     result: Result
     """Saved conversation metadata"""
 

evermemos/types/v1/memories/conversation_meta_get_response.py

@@ -4,7 +4,52 @@ from typing import Dict, List, Optional
 
 from ...._models import BaseModel
 
-__all__ = ["ConversationMetaGetResponse", "Result"]
+__all__ = [
+    "ConversationMetaGetResponse",
+    "Result",
+    "ResultLlmCustomSetting",
+    "ResultLlmCustomSettingBoundary",
+    "ResultLlmCustomSettingExtraction",
+]
+
+
+class ResultLlmCustomSettingBoundary(BaseModel):
+    """LLM config for boundary detection (fast, cheap model recommended)"""
+
+    model: str
+    """Model name"""
+
+    provider: str
+    """LLM provider name"""
+
+    extra: Optional[Dict[str, object]] = None
+    """Additional provider-specific configuration"""
+
+
+class ResultLlmCustomSettingExtraction(BaseModel):
+    """LLM config for memory extraction (high quality model recommended)"""
+
+    model: str
+    """Model name"""
+
+    provider: str
+    """LLM provider name"""
+
+    extra: Optional[Dict[str, object]] = None
+    """Additional provider-specific configuration"""
+
+
+class ResultLlmCustomSetting(BaseModel):
+    """LLM custom settings (only for global config)"""
+
+    boundary: Optional[ResultLlmCustomSettingBoundary] = None
+    """LLM config for boundary detection (fast, cheap model recommended)"""
+
+    extra: Optional[Dict[str, object]] = None
+    """Additional task-specific LLM configurations"""
+
+    extraction: Optional[ResultLlmCustomSettingExtraction] = None
+    """LLM config for memory extraction (high quality model recommended)"""
 
 
 class Result(BaseModel):
@@ -13,15 +58,9 @@ class Result(BaseModel):
     id: str
     """Document ID"""
 
-    conversation_created_at: str
+    conversation_created_at: Optional[str] = None
     """Conversation creation time"""
 
-    name: str
-    """Conversation name"""
-
-    scene: str
-    """Scene identifier"""
-
     created_at: Optional[str] = None
     """Record creation time"""
 
@@ -29,16 +68,25 @@ class Result(BaseModel):
     """Default timezone"""
 
     description: Optional[str] = None
-    """Conversation description"""
+    """Description"""
 
     group_id: Optional[str] = None
-    """Group ID (null for default config)"""
+    """Group ID (null for global config)"""
 
     is_default: Optional[bool] = None
-    """Whether this is the default config"""
+    """Whether this is the global (default) config"""
+
+    llm_custom_setting: Optional[ResultLlmCustomSetting] = None
+    """LLM custom settings (only for global config)"""
+
+    name: Optional[str] = None
+    """Group/conversation name (only for group config)"""
+
+    scene: Optional[str] = None
+    """Scene identifier (only for global config)"""
 
     scene_desc: Optional[Dict[str, object]] = None
-    """Scene description"""
+    """Scene description (only for global config)"""
 
     tags: Optional[List[str]] = None
     """Tags"""
@@ -51,11 +99,6 @@ class Result(BaseModel):
 
 
 class ConversationMetaGetResponse(BaseModel):
-    """Get conversation metadata API response
-
-    Response for GET /api/v1/memories/conversation-meta endpoint.
-    """
-
     result: Result
     """Conversation metadata"""
 

evermemos/types/v1/memories/conversation_meta_update_params.py

@@ -3,11 +3,17 @@
 from __future__ import annotations
 
 from typing import Dict, Optional
-from typing_extensions import TypedDict
+from typing_extensions import Required, TypedDict
 
 from ...._types import SequenceNotStr
 
-__all__ = ["ConversationMetaUpdateParams", "UserDetails"]
+__all__ = [
+    "ConversationMetaUpdateParams",
+    "LlmCustomSetting",
+    "LlmCustomSettingBoundary",
+    "LlmCustomSettingExtraction",
+    "UserDetails",
+]
 
 
 class ConversationMetaUpdateParams(TypedDict, total=False):
@@ -15,16 +21,31 @@ class ConversationMetaUpdateParams(TypedDict, total=False):
     """New default timezone"""
 
     description: Optional[str]
-    """New conversation description"""
+    """New description"""
 
     group_id: Optional[str]
-    """Group ID to update. When null, updates the default config."""
+    """Group ID to update. When null, updates the global (default) config."""
+
+    llm_custom_setting: Optional[LlmCustomSetting]
+    """New LLM custom settings.
+
+    **Only allowed for global config (group_id=null). Not allowed for group config
+    (inherited from global config).**
+    """
 
     name: Optional[str]
-    """New conversation name"""
+    """New group/conversation name.
+
+    **Only allowed for group config (group_id provided). Not allowed for global
+    config.**
+    """
 
     scene_desc: Optional[Dict[str, object]]
-    """New scene description"""
+    """New scene description.
+
+    **Only allowed for global config (group_id=null). Not allowed for group config
+    (inherited from global config).**
+    """
 
     tags: Optional[SequenceNotStr[str]]
     """New tag list"""
@@ -33,12 +54,50 @@ class ConversationMetaUpdateParams(TypedDict, total=False):
     """New user details (will completely replace existing user_details)"""
 
 
-class UserDetails(TypedDict, total=False):
-    """User details
+class LlmCustomSettingBoundary(TypedDict, total=False):
+    """LLM config for boundary detection (fast, cheap model recommended)"""
+
+    model: Required[str]
+    """Model name"""
+
+    provider: Required[str]
+    """LLM provider name"""
+
+    extra: Optional[Dict[str, object]]
+    """Additional provider-specific configuration"""
+
 
-    Structure for the value of ConversationMetaRequest.user_details
+class LlmCustomSettingExtraction(TypedDict, total=False):
+    """LLM config for memory extraction (high quality model recommended)"""
+
+    model: Required[str]
+    """Model name"""
+
+    provider: Required[str]
+    """LLM provider name"""
+
+    extra: Optional[Dict[str, object]]
+    """Additional provider-specific configuration"""
+
+
+class LlmCustomSetting(TypedDict, total=False):
+    """New LLM custom settings.
+
+    **Only allowed for global config (group_id=null).
+    Not allowed for group config (inherited from global config).**
     """
 
+    boundary: Optional[LlmCustomSettingBoundary]
+    """LLM config for boundary detection (fast, cheap model recommended)"""
+
+    extra: Optional[Dict[str, object]]
+    """Additional task-specific LLM configurations"""
+
+    extraction: Optional[LlmCustomSettingExtraction]
+    """LLM config for memory extraction (high quality model recommended)"""
+
+
+class UserDetails(TypedDict, total=False):
     custom_role: Optional[str]
     """User's job/position role (e.g. developer, designer, manager)"""
 

evermemos/types/v1/memories/conversation_meta_update_response.py

@@ -30,11 +30,6 @@ class Result(BaseModel):
 
 
 class ConversationMetaUpdateResponse(BaseModel):
-    """Patch conversation metadata API response
-
-    Response for PATCH /api/v1/memories/conversation-meta endpoint.
-    """
-
     result: Result
     """Patch result with updated fields"""
 

evermemos/types/v1/{memory_create_params.py → memory_add_params.py}

@@ -7,10 +7,10 @@ from typing_extensions import Required, TypedDict
 
 from ..._types import SequenceNotStr
 
-__all__ = ["MemoryCreateParams"]
+__all__ = ["MemoryAddParams"]
 
 
-class MemoryCreateParams(TypedDict, total=False):
+class MemoryAddParams(TypedDict, total=False):
     content: Required[str]
     """Message content"""
 

evermemos/types/v1/{memory_create_response.py → memory_add_response.py}

@@ -2,10 +2,10 @@
 
 from ..._models import BaseModel
 
-__all__ = ["MemoryCreateResponse"]
+__all__ = ["MemoryAddResponse"]
 
 
-class MemoryCreateResponse(BaseModel):
+class MemoryAddResponse(BaseModel):
     message: str
 
     request_id: str

evermemos/types/v1/memory_delete_params.py

@@ -9,6 +9,12 @@ __all__ = ["MemoryDeleteParams"]
 
 
 class MemoryDeleteParams(TypedDict, total=False):
+    id: Optional[str]
+    """Alias for memory_id (backward compatibility)"""
+
+    event_id: Optional[str]
+    """Alias for memory_id (backward compatibility)"""
+
     group_id: Optional[str]
     """Group ID (filter condition)"""
 

evermemos/types/v1/memory_delete_response.py

@@ -18,11 +18,6 @@ class Result(BaseModel):
 
 
 class MemoryDeleteResponse(BaseModel):
-    """Delete memories API response
-
-    Response for DELETE /api/v1/memories endpoint.
-    """
-
     result: Result
     """Delete operation result"""