supermemory 3.58.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.58.0 → supermemory-3.59.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: supermemory
-Version: 3.58.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.58.0 → supermemory-3.59.0}/pyproject.toml

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

{supermemory-3.58.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.58.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.58.0"  # x-release-please-version
+__version__ = "3.59.0"  # x-release-please-version

{supermemory-3.58.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.58.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.58.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.58.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.58.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.58.0 → supermemory-3.59.0}/tests/api_resources/test_client.py

@@ -33,6 +33,7 @@ class TestClient:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            document_date="documentDate",
             dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
@@ -148,6 +149,7 @@ class TestAsyncClient:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            document_date="documentDate",
             dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",

{supermemory-3.58.0 → supermemory-3.59.0}/tests/api_resources/test_documents.py

@@ -43,6 +43,7 @@ class TestDocuments:
             container_tags=["_:_k--W2K_1V"],
             content="Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.",
             custom_id="doc-api-rate-limits",
+            document_date="2025-03-14",
             filepath="/documents/reports/file.pdf",
             filter_by_metadata={
                 "department": "engineering",
@@ -210,6 +211,7 @@ class TestDocuments:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            document_date="documentDate",
             dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
@@ -267,6 +269,7 @@ class TestDocuments:
                     "container_tag": "user_alex",
                     "container_tags": ["_:_k--W2K_1V"],
                     "custom_id": "doc-api-rate-limits",
+                    "document_date": "2025-03-14",
                     "dreaming": "instant",
                     "entity_context": "User's name is {XYZ}",
                     "filepath": "/documents/reports/file.pdf",
@@ -284,6 +287,7 @@ class TestDocuments:
             container_tag="user_alex",
             container_tags=["_:_k--W2K_1V"],
             content=None,
+            document_date="2025-03-14",
             dreaming="instant",
             entity_context="User's name is {XYZ}",
             filepath="/documents/reports/file.pdf",
@@ -518,6 +522,7 @@ class TestAsyncDocuments:
             container_tags=["_:_k--W2K_1V"],
             content="Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.",
             custom_id="doc-api-rate-limits",
+            document_date="2025-03-14",
             filepath="/documents/reports/file.pdf",
             filter_by_metadata={
                 "department": "engineering",
@@ -685,6 +690,7 @@ class TestAsyncDocuments:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            document_date="documentDate",
             dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
@@ -742,6 +748,7 @@ class TestAsyncDocuments:
                     "container_tag": "user_alex",
                     "container_tags": ["_:_k--W2K_1V"],
                     "custom_id": "doc-api-rate-limits",
+                    "document_date": "2025-03-14",
                     "dreaming": "instant",
                     "entity_context": "User's name is {XYZ}",
                     "filepath": "/documents/reports/file.pdf",
@@ -759,6 +766,7 @@ class TestAsyncDocuments:
             container_tag="user_alex",
             container_tags=["_:_k--W2K_1V"],
             content=None,
+            document_date="2025-03-14",
             dreaming="instant",
             entity_context="User's name is {XYZ}",
             filepath="/documents/reports/file.pdf",

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

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