supermemory 3.57.0__tar.gz → 3.59.0__tar.gz

supermemory-3.59.0/.release-please-manifest.json

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

{supermemory-3.57.0 → supermemory-3.59.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.59.0 (2026-08-14)
+
+Full Changelog: [v3.58.0...v3.59.0](https://github.com/supermemoryai/python-sdk/compare/v3.58.0...v3.59.0)
+
+### Features
+
+* **api:** api update ([556b996](https://github.com/supermemoryai/python-sdk/commit/556b996208d3408931197190237cc571eb8b1ded))
+
+## 3.58.0 (2026-08-14)
+
+Full Changelog: [v3.57.0...v3.58.0](https://github.com/supermemoryai/python-sdk/compare/v3.57.0...v3.58.0)
+
+### Features
+
+* **api:** api update ([28dce44](https://github.com/supermemoryai/python-sdk/commit/28dce44965387f46bc594b796a6054bb4d0472ea))
+
 ## 3.57.0 (2026-08-11)
 
 Full Changelog: [v3.56.0...v3.57.0](https://github.com/supermemoryai/python-sdk/compare/v3.56.0...v3.57.0)

{supermemory-3.57.0 → supermemory-3.59.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: supermemory
-Version: 3.57.0
+Version: 3.59.0
 Summary: The official Python library for the supermemory API
 Project-URL: Homepage, https://github.com/supermemoryai/python-sdk
 Project-URL: Repository, https://github.com/supermemoryai/python-sdk

{supermemory-3.57.0 → supermemory-3.59.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "supermemory"
-version = "3.57.0"
+version = "3.59.0"
 description = "The official Python library for the supermemory API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/_client.py

@@ -254,6 +254,7 @@ class Supermemory(SyncAPIClient):
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -280,6 +281,12 @@ class Supermemory(SyncAPIClient):
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates against this instead of the ingestion time, and documents in a
+              batch are processed oldest-first so newer facts correctly supersede older ones.
+              Set this whenever you backfill historical content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -315,6 +322,7 @@ class Supermemory(SyncAPIClient):
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
@@ -611,6 +619,7 @@ class AsyncSupermemory(AsyncAPIClient):
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -637,6 +646,12 @@ class AsyncSupermemory(AsyncAPIClient):
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates against this instead of the ingestion time, and documents in a
+              batch are processed oldest-first so newer facts correctly supersede older ones.
+              Set this whenever you backfill historical content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -672,6 +687,7 @@ class AsyncSupermemory(AsyncAPIClient):
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/_version.py

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

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/resources/documents.py

@@ -67,6 +67,7 @@ class DocumentsResource(SyncAPIResource):
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: str | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -102,6 +103,13 @@ class DocumentsResource(SyncAPIResource):
           custom_id: Optional custom ID of the document. This could be an ID from your database that
               will uniquely identify this document.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates ('yesterday', 'last quarter') against this instead of the
+              ingestion time, and documents in a batch are processed oldest-first so newer
+              facts correctly supersede older ones. Set this whenever you backfill historical
+              content.
+
           filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
               by supermemoryfs to map documents to filesystem paths.
 
@@ -137,6 +145,7 @@ class DocumentsResource(SyncAPIResource):
                     "container_tags": container_tags,
                     "content": content,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
                     "metadata": metadata,
@@ -262,6 +271,7 @@ class DocumentsResource(SyncAPIResource):
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -288,6 +298,12 @@ class DocumentsResource(SyncAPIResource):
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates against this instead of the ingestion time, and documents in a
+              batch are processed oldest-first so newer facts correctly supersede older ones.
+              Set this whenever you backfill historical content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -323,6 +339,7 @@ class DocumentsResource(SyncAPIResource):
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
@@ -345,6 +362,7 @@ class DocumentsResource(SyncAPIResource):
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -372,6 +390,13 @@ class DocumentsResource(SyncAPIResource):
               containerized by. This can be an ID for your user, a project ID, or any other
               identifier you wish to use to group documents.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates ('yesterday', 'last quarter') against this instead of the
+              ingestion time, and documents in a batch are processed oldest-first so newer
+              facts correctly supersede older ones. Set this whenever you backfill historical
+              content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -413,6 +438,7 @@ class DocumentsResource(SyncAPIResource):
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
@@ -670,6 +696,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: str | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -705,6 +732,13 @@ class AsyncDocumentsResource(AsyncAPIResource):
           custom_id: Optional custom ID of the document. This could be an ID from your database that
               will uniquely identify this document.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates ('yesterday', 'last quarter') against this instead of the
+              ingestion time, and documents in a batch are processed oldest-first so newer
+              facts correctly supersede older ones. Set this whenever you backfill historical
+              content.
+
           filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
               by supermemoryfs to map documents to filesystem paths.
 
@@ -740,6 +774,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
                     "container_tags": container_tags,
                     "content": content,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
                     "metadata": metadata,
@@ -865,6 +900,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -891,6 +927,12 @@ class AsyncDocumentsResource(AsyncAPIResource):
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates against this instead of the ingestion time, and documents in a
+              batch are processed oldest-first so newer facts correctly supersede older ones.
+              Set this whenever you backfill historical content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -926,6 +968,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
@@ -948,6 +991,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -975,6 +1019,13 @@ class AsyncDocumentsResource(AsyncAPIResource):
               containerized by. This can be an ID for your user, a project ID, or any other
               identifier you wish to use to group documents.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates ('yesterday', 'last quarter') against this instead of the
+              ingestion time, and documents in a batch are processed oldest-first so newer
+              facts correctly supersede older ones. Set this whenever you backfill historical
+              content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -1016,6 +1067,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/types/client_add_params.py

@@ -32,6 +32,15 @@ class ClientAddParams(TypedDict, total=False):
     Max 100 characters, alphanumeric with hyphens, underscores, and dots only.
     """
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates against this instead of the ingestion time, and documents in a
+    batch are processed oldest-first so newer facts correctly supersede older ones.
+    Set this whenever you backfill historical content.
+    """
+
     dreaming: Literal["instant", "dynamic"]
     """Processing mode.
 

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/types/connection_create_response.py

@@ -12,8 +12,8 @@ __all__ = ["ConnectionCreateResponse"]
 class ConnectionCreateResponse(BaseModel):
     id: str
 
-    auth_link: str = FieldInfo(alias="authLink")
+    auth_link: Optional[str] = FieldInfo(alias="authLink", default=None)
 
-    expires_in: str = FieldInfo(alias="expiresIn")
+    expires_in: Optional[str] = FieldInfo(alias="expiresIn", default=None)
 
     redirects_to: Optional[str] = FieldInfo(alias="redirectsTo", default=None)

supermemory-3.59.0/src/supermemory/types/connection_delete_by_id_response.py

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .._models import BaseModel
+
+__all__ = ["ConnectionDeleteByIDResponse", "ConnectionDeleteByIDResponseItem"]
+
+
+class ConnectionDeleteByIDResponseItem(BaseModel):
+    id: str
+
+    provider: str
+
+
+ConnectionDeleteByIDResponse: TypeAlias = List[ConnectionDeleteByIDResponseItem]

supermemory-3.59.0/src/supermemory/types/connection_delete_by_provider_response.py

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .._models import BaseModel
+
+__all__ = ["ConnectionDeleteByProviderResponse", "ConnectionDeleteByProviderResponseItem"]
+
+
+class ConnectionDeleteByProviderResponseItem(BaseModel):
+    id: str
+
+    provider: str
+
+
+ConnectionDeleteByProviderResponse: TypeAlias = List[ConnectionDeleteByProviderResponseItem]

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/types/connection_list_documents_response.py

@@ -11,7 +11,7 @@ __all__ = ["ConnectionListDocumentsResponse", "ConnectionListDocumentsResponseIt
 
 
 class ConnectionListDocumentsResponseItem(BaseModel):
-    id: str
+    id: Optional[str] = None
 
     created_at: str = FieldInfo(alias="createdAt")
 

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/types/document_add_params.py

@@ -32,6 +32,15 @@ class DocumentAddParams(TypedDict, total=False):
     Max 100 characters, alphanumeric with hyphens, underscores, and dots only.
     """
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates against this instead of the ingestion time, and documents in a
+    batch are processed oldest-first so newer facts correctly supersede older ones.
+    Set this whenever you backfill historical content.
+    """
+
     dreaming: Literal["instant", "dynamic"]
     """Processing mode.
 

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/types/document_batch_add_params.py

@@ -30,6 +30,16 @@ class DocumentBatchAddParams(TypedDict, total=False):
 
     content: None
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates ('yesterday', 'last quarter') against this instead of the
+    ingestion time, and documents in a batch are processed oldest-first so newer
+    facts correctly supersede older ones. Set this whenever you backfill historical
+    content.
+    """
+
     dreaming: Literal["instant", "dynamic"]
     """Processing mode.
 
@@ -111,6 +121,16 @@ class DocumentsUnionMember0(TypedDict, total=False):
     document.
     """
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates ('yesterday', 'last quarter') against this instead of the
+    ingestion time, and documents in a batch are processed oldest-first so newer
+    facts correctly supersede older ones. Set this whenever you backfill historical
+    content.
+    """
+
     dreaming: Literal["instant", "dynamic"]
     """Processing mode.
 

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/types/document_batch_add_response.py

@@ -20,6 +20,14 @@ class Result(BaseModel):
     error: Optional[str] = None
     """Error message when status is 'error'"""
 
+    url: Optional[str] = None
+    """URL of the failed item, when it had one.
+
+    Only present on failed items, where it may be the only way to tell which input
+    the error belongs to (the id falls back to 'unknown' when the input had neither
+    an id nor a customId).
+    """
+
 
 class DocumentBatchAddResponse(BaseModel):
     failed: float

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/types/document_list_processing_response.py

@@ -14,6 +14,12 @@ class Document(BaseModel):
     id: str
     """Unique identifier of the document."""
 
+    connection_id: Optional[str] = FieldInfo(alias="connectionId", default=None)
+    """Optional ID of connection the document was created from.
+
+    This is useful for identifying the source of the document.
+    """
+
     created_at: str = FieldInfo(alias="createdAt")
     """Creation timestamp"""
 
@@ -36,6 +42,9 @@ class Document(BaseModel):
     status: Literal["unknown", "queued", "extracting", "chunking", "embedding", "indexing", "done", "failed"]
     """Status of the document"""
 
+    summary: Optional[str] = None
+    """Summary of the document content"""
+
     title: Optional[str] = None
     """Title of the document"""
 

{supermemory-3.57.0 → supermemory-3.59.0}/src/supermemory/types/document_update_params.py

@@ -45,6 +45,16 @@ class DocumentUpdateParams(TypedDict, total=False):
     document.
     """
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates ('yesterday', 'last quarter') against this instead of the
+    ingestion time, and documents in a batch are processed oldest-first so newer
+    facts correctly supersede older ones. Set this whenever you backfill historical
+    content.
+    """
+
     filepath: str
     """Optional file path for the document (e.g., '/documents/reports/file.pdf').
 

supermemory-3.59.0/src/supermemory/types/profile_response.py

@@ -0,0 +1,200 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = [
+    "ProfileResponse",
+    "Profile",
+    "SearchResults",
+    "SearchResultsResult",
+    "SearchResultsResultChunk",
+    "SearchResultsResultContext",
+    "SearchResultsResultContextChild",
+    "SearchResultsResultContextParent",
+    "SearchResultsResultContextRelated",
+    "SearchResultsResultDocument",
+]
+
+
+class Profile(BaseModel):
+    buckets: Optional[Dict[str, List[str]]] = None
+    """Per-bucket memory lists, keyed by bucket key"""
+
+    dynamic: Optional[List[str]] = None
+    """Dynamic profile information (recent memories)"""
+
+    static: Optional[List[str]] = None
+    """Static profile information that remains relevant long-term"""
+
+
+class SearchResultsResultChunk(BaseModel):
+    content: str
+    """Content of the chunk"""
+
+    document_id: str = FieldInfo(alias="documentId")
+    """ID of the document this chunk belongs to"""
+
+    position: float
+    """Position of chunk in the document (0-indexed)"""
+
+
+class SearchResultsResultContextChild(BaseModel):
+    memory: str
+    """The contextual memory content"""
+
+    relation: Literal["updates", "extends", "derives"]
+    """Relation type between this memory and its parent/child"""
+
+    updated_at: str = FieldInfo(alias="updatedAt")
+    """Contextual memory last update date"""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Contextual memory metadata"""
+
+    version: Optional[float] = None
+    """
+    Relative version distance from the primary memory (+1 for direct child, +2 for
+    grand-child, etc.)
+    """
+
+
+class SearchResultsResultContextParent(BaseModel):
+    memory: str
+    """The contextual memory content"""
+
+    relation: Literal["updates", "extends", "derives"]
+    """Relation type between this memory and its parent/child"""
+
+    updated_at: str = FieldInfo(alias="updatedAt")
+    """Contextual memory last update date"""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Contextual memory metadata"""
+
+    version: Optional[float] = None
+    """
+    Relative version distance from the primary memory (-1 for direct parent, -2 for
+    grand-parent, etc.)
+    """
+
+
+class SearchResultsResultContextRelated(BaseModel):
+    memory: str
+    """The related memory content"""
+
+    relation: Literal["extends", "derives"]
+    """Relation type"""
+
+    updated_at: str = FieldInfo(alias="updatedAt")
+    """Related memory last update date"""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Related memory metadata"""
+
+
+class SearchResultsResultContext(BaseModel):
+    """
+    Object containing version history (parents/children via updates) and related memories (extends/derives)
+    """
+
+    children: Optional[List[SearchResultsResultContextChild]] = None
+
+    parents: Optional[List[SearchResultsResultContextParent]] = None
+
+    related: Optional[List[SearchResultsResultContextRelated]] = None
+
+
+class SearchResultsResultDocument(BaseModel):
+    id: str
+    """Document ID"""
+
+    created_at: str = FieldInfo(alias="createdAt")
+    """Document creation date"""
+
+    updated_at: str = FieldInfo(alias="updatedAt")
+    """Document last update date"""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Document metadata (only included when documents=true)"""
+
+    summary: Optional[str] = None
+    """Document summary (only included when summaries=true)"""
+
+    title: Optional[str] = None
+    """Document title (only included when documents=true)"""
+
+    type: Optional[str] = None
+    """Document type (only included when documents=true)"""
+
+
+class SearchResultsResult(BaseModel):
+    id: str
+    """Memory entry ID or chunk ID"""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Memory metadata"""
+
+    similarity: float
+    """Similarity score between the query and memory entry"""
+
+    updated_at: str = FieldInfo(alias="updatedAt")
+    """Memory last update date"""
+
+    chunk: Optional[str] = None
+    """The chunk content (only present for chunk results from hybrid search)"""
+
+    chunks: Optional[List[SearchResultsResultChunk]] = None
+    """Relevant chunks from associated documents (only included when chunks=true)"""
+
+    context: Optional[SearchResultsResultContext] = None
+    """
+    Object containing version history (parents/children via updates) and related
+    memories (extends/derives)
+    """
+
+    documents: Optional[List[SearchResultsResultDocument]] = None
+    """Associated documents for this memory entry"""
+
+    filepath: Optional[str] = None
+    """Filepath of the source document this memory or chunk came from"""
+
+    is_aggregated: Optional[bool] = FieldInfo(alias="isAggregated", default=None)
+    """Indicates if this memory was created by aggregating multiple source memories"""
+
+    memory: Optional[str] = None
+    """The memory content (only present for memory results)"""
+
+    root_memory_id: Optional[str] = FieldInfo(alias="rootMemoryId", default=None)
+    """ID of the root (first version) memory entry this one descends from.
+
+    Null for memories that have never been superseded. Only present on memory
+    results, not on standalone chunk results.
+    """
+
+    version: Optional[float] = None
+    """Version number of this memory entry"""
+
+
+class SearchResults(BaseModel):
+    """Search results if a search query was provided"""
+
+    results: List[SearchResultsResult]
+    """Search results for the provided query"""
+
+    timing: float
+    """Search timing in milliseconds"""
+
+    total: float
+    """Total number of search results"""
+
+
+class ProfileResponse(BaseModel):
+    profile: Profile
+
+    search_results: Optional[SearchResults] = FieldInfo(alias="searchResults", default=None)
+    """Search results if a search query was provided"""