evermemos 0.3.9__py3-none-any.whl → 0.3.11__py3-none-any.whl

evermemos/types/v0/memories/conversation_meta_create_response.py

@@ -0,0 +1,109 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+
+from ...._models import BaseModel
+
+__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):
+    """Saved conversation metadata"""
+
+    id: str
+    """Document ID"""
+
+    conversation_created_at: Optional[str] = None
+    """Conversation creation time"""
+
+    created_at: Optional[str] = None
+    """Record creation time"""
+
+    default_timezone: Optional[str] = None
+    """Default timezone"""
+
+    description: Optional[str] = None
+    """Description"""
+
+    group_id: Optional[str] = None
+    """Group ID (null for global config)"""
+
+    is_default: Optional[bool] = None
+    """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 (only for global config)"""
+
+    tags: Optional[List[str]] = None
+    """Tags"""
+
+    updated_at: Optional[str] = None
+    """Record update time"""
+
+    user_details: Optional[Dict[str, Dict[str, object]]] = None
+    """User details"""
+
+
+class ConversationMetaCreateResponse(BaseModel):
+    result: Result
+    """Saved conversation metadata"""
+
+    message: Optional[str] = None
+    """Response message"""
+
+    status: Optional[str] = None
+    """Response status"""

evermemos/types/v0/memories/conversation_meta_get_response.py

@@ -0,0 +1,109 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+
+from ...._models import BaseModel
+
+__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):
+    """Conversation metadata"""
+
+    id: str
+    """Document ID"""
+
+    conversation_created_at: Optional[str] = None
+    """Conversation creation time"""
+
+    created_at: Optional[str] = None
+    """Record creation time"""
+
+    default_timezone: Optional[str] = None
+    """Default timezone"""
+
+    description: Optional[str] = None
+    """Description"""
+
+    group_id: Optional[str] = None
+    """Group ID (null for global config)"""
+
+    is_default: Optional[bool] = None
+    """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 (only for global config)"""
+
+    tags: Optional[List[str]] = None
+    """Tags"""
+
+    updated_at: Optional[str] = None
+    """Record update time"""
+
+    user_details: Optional[Dict[str, Dict[str, object]]] = None
+    """User details"""
+
+
+class ConversationMetaGetResponse(BaseModel):
+    result: Result
+    """Conversation metadata"""
+
+    message: Optional[str] = None
+    """Response message"""
+
+    status: Optional[str] = None
+    """Response status"""

evermemos/types/v0/memories/conversation_meta_update_params.py

@@ -0,0 +1,117 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Optional
+from typing_extensions import Required, TypedDict
+
+from ...._types import SequenceNotStr
+
+__all__ = [
+    "ConversationMetaUpdateParams",
+    "LlmCustomSetting",
+    "LlmCustomSettingBoundary",
+    "LlmCustomSettingExtraction",
+    "UserDetails",
+]
+
+
+class ConversationMetaUpdateParams(TypedDict, total=False):
+    default_timezone: Optional[str]
+    """New default timezone"""
+
+    description: Optional[str]
+    """New description"""
+
+    group_id: Optional[str]
+    """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 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.
+
+    **Only allowed for global config (group_id=null). Not allowed for group config
+    (inherited from global config).**
+    """
+
+    tags: Optional[SequenceNotStr[str]]
+    """New tag list"""
+
+    user_details: Optional[Dict[str, UserDetails]]
+    """New user details (will completely replace existing 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"""
+
+    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)"""
+
+    extra: Optional[Dict[str, object]]
+    """Additional information"""
+
+    full_name: Optional[str]
+    """User full name"""
+
+    role: Optional[str]
+    """
+    User type role, used to identify if this user is a human or AI. Enum values from
+    MessageSenderRole:
+
+    - user: Human user
+    - assistant: AI assistant/bot
+    """

evermemos/types/{v1 → v0}/memories/conversation_meta_update_response.py

@@ -8,22 +8,33 @@ __all__ = ["ConversationMetaUpdateResponse", "Result"]
 
 
 class Result(BaseModel):
+    """Patch result with updated fields"""
+
     id: str
+    """Document ID"""
 
     group_id: Optional[str] = None
+    """Group ID (null for default config)"""
 
     name: Optional[str] = None
+    """Conversation name"""
 
     scene: Optional[str] = None
+    """Scene identifier"""
 
     updated_at: Optional[str] = None
+    """Record update time"""
 
     updated_fields: Optional[List[str]] = None
+    """List of updated field names"""
 
 
 class ConversationMetaUpdateResponse(BaseModel):
     result: Result
+    """Patch result with updated fields"""
 
     message: Optional[str] = None
+    """Response message"""
 
     status: Optional[str] = None
+    """Response status"""

evermemos/types/v0/memory_add_params.py

@@ -0,0 +1,60 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Required, TypedDict
+
+from ..._types import SequenceNotStr
+
+__all__ = ["MemoryAddParams"]
+
+
+class MemoryAddParams(TypedDict, total=False):
+    content: Required[str]
+    """Message content"""
+
+    create_time: Required[str]
+    """Message creation time (ISO 8601 format with Timezone is required)"""
+
+    message_id: Required[str]
+    """Message unique identifier"""
+
+    sender: Required[str]
+    """Sender user ID (required).
+
+    Also used as user_id internally for memory ownership.
+    """
+
+    flush: bool
+    """Force boundary trigger.
+
+    When True, immediately triggers memory extraction instead of waiting for natural
+    boundary detection.
+    """
+
+    group_id: Optional[str]
+    """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: Optional[str]
+    """Group name"""
+
+    refer_list: Optional[SequenceNotStr[str]]
+    """List of referenced message IDs"""
+
+    role: Optional[str]
+    """
+    Message sender role, used to identify the source of the message. Enum values
+    from MessageSenderRole:
+
+    - user: Message from a human user
+    - assistant: Message from an AI assistant
+    """
+
+    sender_name: Optional[str]
+    """Sender name (uses sender if not provided)"""

evermemos/types/{v1/memory_create_response.py → v0/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 → v0}/memory_delete_params.py

@@ -9,8 +9,17 @@ __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)"""
 
     memory_id: Optional[str]
+    """Memory id (filter condition)"""
 
     user_id: Optional[str]
+    """User ID (filter condition)"""

evermemos/types/{v1 → v0}/memory_delete_response.py

@@ -8,14 +8,21 @@ __all__ = ["MemoryDeleteResponse", "Result"]
 
 
 class Result(BaseModel):
+    """Delete operation result"""
+
     count: Optional[int] = None
+    """Number of memories deleted"""
 
     filters: Optional[List[str]] = None
+    """List of filter types used for deletion"""
 
 
 class MemoryDeleteResponse(BaseModel):
     result: Result
+    """Delete operation result"""
 
     message: Optional[str] = None
+    """Response message"""
 
     status: Optional[str] = None
+    """Response status"""

evermemos/types/{v1 → v0}/memory_get_response.py

@@ -12,10 +12,6 @@ __all__ = [
     "Result",
     "ResultMemory",
     "ResultMemoryProfileModel",
-    "ResultMemoryGlobalUserProfileModel",
-    "ResultMemoryCombinedProfileModel",
-    "ResultMemoryCombinedProfileModelGlobalProfile",
-    "ResultMemoryCombinedProfileModelProfile",
     "ResultMemoryEpisodicMemoryModel",
     "ResultMemoryEventLogModel",
     "ResultMemoryForesightModel",
@@ -48,100 +44,26 @@ class ResultMemoryProfileModel(BaseModel):
     version: Optional[int] = None
 
 
-class ResultMemoryGlobalUserProfileModel(BaseModel):
-    id: str
-
-    user_id: str
-
-    confidence: Optional[float] = None
-
-    created_at: Optional[datetime] = None
-
-    custom_profile_data: Optional[Dict[str, object]] = None
-
-    memcell_count: Optional[int] = None
-
-    profile_data: Optional[Dict[str, object]] = None
-
-    updated_at: Optional[datetime] = None
-
-
-class ResultMemoryCombinedProfileModelGlobalProfile(BaseModel):
-    id: str
-
-    user_id: str
-
-    confidence: Optional[float] = None
-
-    created_at: Optional[datetime] = None
-
-    custom_profile_data: Optional[Dict[str, object]] = None
-
-    memcell_count: Optional[int] = None
-
-    profile_data: Optional[Dict[str, object]] = None
-
-    updated_at: Optional[datetime] = None
-
-
-class ResultMemoryCombinedProfileModelProfile(BaseModel):
-    id: str
-
-    group_id: str
-
-    user_id: str
-
-    cluster_ids: Optional[List[str]] = None
-
-    confidence: Optional[float] = None
-
-    created_at: Optional[datetime] = None
-
-    last_updated_cluster: Optional[str] = None
-
-    memcell_count: Optional[int] = None
-
-    profile_data: Optional[Dict[str, object]] = None
-
-    scenario: Optional[str] = None
-
-    updated_at: Optional[datetime] = None
-
-    version: Optional[int] = None
-
-
-class ResultMemoryCombinedProfileModel(BaseModel):
-    user_id: str
-
-    global_profile: Optional[ResultMemoryCombinedProfileModelGlobalProfile] = None
-
-    group_id: Optional[str] = None
-
-    profiles: Optional[List[ResultMemoryCombinedProfileModelProfile]] = None
-
-
 class ResultMemoryEpisodicMemoryModel(BaseModel):
     id: str
 
     episode_id: str
 
-    summary: str
-
-    title: str
-
     user_id: str
 
     created_at: Optional[datetime] = None
 
     end_time: Optional[datetime] = None
 
+    episode: Optional[str] = None
+
     extend: Optional[Dict[str, object]] = None
 
     group_id: Optional[str] = None
 
     group_name: Optional[str] = None
 
-    key_events: Optional[List[str]] = None
+    keywords: Optional[List[str]] = None
 
     location: Optional[str] = None
 
@@ -157,6 +79,8 @@ class ResultMemoryEpisodicMemoryModel(BaseModel):
 
     subject: Optional[str] = None
 
+    summary: Optional[str] = None
+
     timestamp: Optional[datetime] = None
 
     updated_at: Optional[datetime] = None
@@ -203,6 +127,8 @@ class ResultMemoryForesightModel(BaseModel):
 
     content: str
 
+    foresight: str
+
     parent_id: str
 
     parent_type: str
@@ -239,16 +165,13 @@ class ResultMemoryForesightModel(BaseModel):
 
 
 ResultMemory: TypeAlias = Union[
-    ResultMemoryProfileModel,
-    ResultMemoryGlobalUserProfileModel,
-    ResultMemoryCombinedProfileModel,
-    ResultMemoryEpisodicMemoryModel,
-    ResultMemoryEventLogModel,
-    ResultMemoryForesightModel,
+    ResultMemoryProfileModel, ResultMemoryEpisodicMemoryModel, ResultMemoryEventLogModel, ResultMemoryForesightModel
 ]
 
 
 class Result(BaseModel):
+    """Memory fetch result"""
+
     has_more: Optional[bool] = None
 
     memories: Optional[List[ResultMemory]] = None
@@ -260,7 +183,10 @@ class Result(BaseModel):
 
 class MemoryGetResponse(BaseModel):
     result: Result
+    """Memory fetch result"""
 
     message: Optional[str] = None
+    """Response message"""
 
     status: Optional[str] = None
+    """Response status"""