release: 0.3.11

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.3.10"
+  ".": "0.4.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/evermind%2FEverMemOS-6732e30cb627515a31477d31f17edfcdd7de9a036431d715f07b2b1cb632ff98.yml
-openapi_spec_hash: d76a11e32ffb7eac60a3d7d6b1ed6902
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/evermind%2FEverMemOS-e76866b5bfe72eee03b46ef6024f32aa6dd9fc8d0ac9e249dfa9d6d6d261eaa2.yml
+openapi_spec_hash: fe54cd57f4321a58ede4f6513e0aaccb
 config_hash: 557b0f53b8ae061106486cf953c2584a

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.0 (2026-02-05)
+
+Full Changelog: [v0.3.10...v0.4.0](https://github.com/evermemos/evermemos-python/compare/v0.3.10...v0.4.0)
+
+### Features
+
+* **api:** api update ([0981f02](https://github.com/evermemos/evermemos-python/commit/0981f021d776d39cb9278f8ced62d749459fd613))
+
 ## 0.3.10 (2026-01-31)
 
 Full Changelog: [v0.3.9...v0.3.10](https://github.com/evermemos/evermemos-python/compare/v0.3.9...v0.3.10)

pyproject.toml

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

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.10"  # x-release-please-version
+__version__ = "0.4.0"  # x-release-please-version

src/evermemos/resources/v1/memories/conversation_meta.py

@@ -70,7 +70,7 @@ def create(
         etc.
 
         Args:
-          created_at: Conversation creation time (ISO 8601 format)
+          created_at: Conversation creation time (ISO 8601 format with Timezone is required)
 
           default_timezone: Default timezone
 
@@ -273,7 +273,7 @@ async def create(
         etc.
 
         Args:
-          created_at: Conversation creation time (ISO 8601 format)
+          created_at: Conversation creation time (ISO 8601 format with Timezone is required)
 
           default_timezone: Default timezone
 

src/evermemos/resources/v1/memories/memories.py

@@ -134,12 +134,12 @@ def add(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryAddResponse:
         """
-        Store a single message into memory.
+        Extract memory from message.
 
         Args:
           content: Message content
 
-          create_time: Message creation time (ISO 8601 format)
+          create_time: Message creation time (ISO 8601 format with Timezone is required)
 
           message_id: Message unique identifier
 
@@ -337,12 +337,12 @@ async def add(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryAddResponse:
         """
-        Store a single message into memory.
+        Extract memory from message.
 
         Args:
           content: Message content
 
-          create_time: Message creation time (ISO 8601 format)
+          create_time: Message creation time (ISO 8601 format with Timezone is required)
 
           message_id: Message unique identifier
 

src/evermemos/types/v1/memories/conversation_meta_create_params.py

@@ -18,7 +18,7 @@
 
 class ConversationMetaCreateParams(TypedDict, total=False):
     created_at: Required[str]
-    """Conversation creation time (ISO 8601 format)"""
+    """Conversation creation time (ISO 8601 format with Timezone is required)"""
 
     default_timezone: Optional[str]
     """Default timezone"""

src/evermemos/types/v1/memory_add_params.py

@@ -15,7 +15,7 @@ class MemoryAddParams(TypedDict, total=False):
     """Message content"""
 
     create_time: Required[str]
-    """Message creation time (ISO 8601 format)"""
+    """Message creation time (ISO 8601 format with Timezone is required)"""
 
     message_id: Required[str]
     """Message unique identifier"""

src/evermemos/types/v1/memory_search_response.py

@@ -1,29 +1,135 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, List, Optional
+from typing import Dict, List, Union, Optional
 from datetime import datetime
-from typing_extensions import Literal
+from typing_extensions import Literal, TypeAlias
 
 from .metadata import Metadata
 from ..._models import BaseModel
 from .memory_type import MemoryType
 
-__all__ = ["MemorySearchResponse", "Result", "ResultMemory", "ResultPendingMessage"]
+__all__ = [
+    "MemorySearchResponse",
+    "Result",
+    "ResultMemory",
+    "ResultMemoryEpisodeMemory",
+    "ResultMemoryEventLog",
+    "ResultMemoryForesight",
+    "ResultPendingMessage",
+]
 
 
-class ResultMemory(BaseModel):
-    memory_type: MemoryType
+class ResultMemoryEpisodeMemory(BaseModel):
+    memory_type: Union[MemoryType, str]
+
+    timestamp: datetime
+
+    user_id: str
+
+    id: Optional[str] = None
+
+    episode: Optional[str] = None
+
+    extend: Optional[Dict[str, object]] = None
+
+    group_id: Optional[str] = None
+
+    group_name: Optional[str] = None
+
+    keywords: Optional[List[str]] = None
+
+    linked_entities: Optional[List[str]] = None
+
+    ori_event_id_list: Optional[List[str]] = None
+
+    original_data: Optional[List[Dict[str, object]]] = None
+
+    parent_id: Optional[str] = None
+
+    parent_type: Optional[str] = None
+
+    participants: Optional[List[str]] = None
+
+    score: Optional[float] = None
+
+    subject: Optional[str] = None
+
+    summary: Optional[str] = None
+
+    type: Optional[Literal["Conversation"]] = None
+
+    user_name: Optional[str] = None
+
+    vector: Optional[List[float]] = None
+
+    vector_model: Optional[str] = None
+
+
+class ResultMemoryEventLog(BaseModel):
+    memory_type: Union[MemoryType, str]
+
+    timestamp: datetime
+
+    user_id: str
+
+    id: Optional[str] = None
+
+    atomic_fact: Union[str, List[str], None] = None
+
+    extend: Optional[Dict[str, object]] = None
+
+    fact_embeddings: Optional[List[List[float]]] = None
+
+    group_id: Optional[str] = None
+
+    group_name: Optional[str] = None
+
+    keywords: Optional[List[str]] = None
+
+    linked_entities: Optional[List[str]] = None
+
+    ori_event_id_list: Optional[List[str]] = None
+
+    original_data: Optional[List[Dict[str, object]]] = None
+
+    parent_id: Optional[str] = None
+
+    parent_type: Optional[str] = None
+
+    participants: Optional[List[str]] = None
+
+    score: Optional[float] = None
+
+    time: Optional[str] = None
+
+    type: Optional[Literal["Conversation"]] = None
+
+    user_name: Optional[str] = None
+
+    vector: Optional[List[float]] = None
+
+    vector_model: Optional[str] = None
 
-    ori_event_id_list: List[str]
+
+class ResultMemoryForesight(BaseModel):
+    memory_type: Union[MemoryType, str]
 
     timestamp: datetime
 
     user_id: str
 
     id: Optional[str] = None
 
+    duration_days: Optional[int] = None
+
+    end_time: Optional[str] = None
+
+    evidence: Optional[str] = None
+
     extend: Optional[Dict[str, object]] = None
 
+    foresight: Optional[str] = None
+
     group_id: Optional[str] = None
 
     group_name: Optional[str] = None
@@ -32,10 +138,20 @@ class ResultMemory(BaseModel):
 
     linked_entities: Optional[List[str]] = None
 
-    memcell_event_id_list: Optional[List[str]] = None
+    ori_event_id_list: Optional[List[str]] = None
+
+    original_data: Optional[List[Dict[str, object]]] = None
+
+    parent_id: Optional[str] = None
+
+    parent_type: Optional[str] = None
 
     participants: Optional[List[str]] = None
 
+    score: Optional[float] = None
+
+    start_time: Optional[str] = None
+
     type: Optional[Literal["Conversation"]] = None
 
     user_name: Optional[str] = None
@@ -45,6 +161,9 @@ class ResultMemory(BaseModel):
     vector_model: Optional[str] = None
 
 
+ResultMemory: TypeAlias = Union[ResultMemoryEpisodeMemory, ResultMemoryEventLog, ResultMemoryForesight]
+
+
 class ResultPendingMessage(BaseModel):
     id: str
 
@@ -82,14 +201,10 @@ class Result(BaseModel):
 
     metadata: Optional[Metadata] = None
 
-    original_data: Optional[List[Dict[str, object]]] = None
-
     pending_messages: Optional[List[ResultPendingMessage]] = None
 
     query_metadata: Optional[Metadata] = None
 
-    scores: Optional[List[float]] = None
-
     total_count: Optional[int] = None