supermemory 3.58.0__tar.gz → 3.60.0__tar.gz

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

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

{supermemory-3.58.0 → supermemory-3.60.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.60.0 (2026-09-01)
+
+Full Changelog: [v3.59.0...v3.60.0](https://github.com/supermemoryai/python-sdk/compare/v3.59.0...v3.60.0)
+
+### Features
+
+* **api:** api update ([8531a88](https://github.com/supermemoryai/python-sdk/commit/8531a888ad97a9279708ee9bf0bf370aa8198f2f))
+
+## 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.60.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: supermemory
-Version: 3.58.0
+Version: 3.60.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.60.0}/api.md

@@ -50,7 +50,7 @@ Methods:
 - <code title="post /v3/documents/batch">client.documents.<a href="./src/supermemory/resources/documents.py">batch_add</a>(\*\*<a href="src/supermemory/types/document_batch_add_params.py">params</a>) -> <a href="./src/supermemory/types/document_batch_add_response.py">DocumentBatchAddResponse</a></code>
 - <code title="delete /v3/documents/bulk">client.documents.<a href="./src/supermemory/resources/documents.py">delete_bulk</a>(\*\*<a href="src/supermemory/types/document_delete_bulk_params.py">params</a>) -> <a href="./src/supermemory/types/document_delete_bulk_response.py">DocumentDeleteBulkResponse</a></code>
 - <code title="get /v3/documents/{id}">client.documents.<a href="./src/supermemory/resources/documents.py">get</a>(id) -> <a href="./src/supermemory/types/document_get_response.py">DocumentGetResponse</a></code>
-- <code title="get /v3/documents/processing">client.documents.<a href="./src/supermemory/resources/documents.py">list_processing</a>() -> <a href="./src/supermemory/types/document_list_processing_response.py">DocumentListProcessingResponse</a></code>
+- <code title="get /v3/documents/processing">client.documents.<a href="./src/supermemory/resources/documents.py">list_processing</a>(\*\*<a href="src/supermemory/types/document_list_processing_params.py">params</a>) -> <a href="./src/supermemory/types/document_list_processing_response.py">DocumentListProcessingResponse</a></code>
 - <code title="post /v3/documents/file">client.documents.<a href="./src/supermemory/resources/documents.py">upload_file</a>(\*\*<a href="src/supermemory/types/document_upload_file_params.py">params</a>) -> <a href="./src/supermemory/types/document_upload_file_response.py">DocumentUploadFileResponse</a></code>
 
 # Search

{supermemory-3.58.0 → supermemory-3.60.0}/pyproject.toml

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

{supermemory-3.58.0 → supermemory-3.60.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.60.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.60.0"  # x-release-please-version

{supermemory-3.58.0 → supermemory-3.60.0}/src/supermemory/resources/documents.py

@@ -14,6 +14,7 @@ from ..types import (
     document_batch_add_params,
     document_delete_bulk_params,
     document_upload_file_params,
+    document_list_processing_params,
 )
 from .._files import deepcopy_with_paths
 from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, FileTypes, SequenceNotStr, omit, not_given
@@ -67,6 +68,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 +104,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 +146,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 +272,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 +299,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 +340,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 +363,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 +391,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 +439,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,
@@ -512,6 +539,10 @@ class DocumentsResource(SyncAPIResource):
     def list_processing(
         self,
         *,
+        container_tags: str | Omit = omit,
+        limit: Union[str, float] | Omit = omit,
+        page: Union[str, float] | Omit = omit,
+        view: Literal["active", "all"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -519,11 +550,45 @@ class DocumentsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DocumentListProcessingResponse:
-        """Get documents that are currently being processed"""
+        """Get documents that are currently being processed.
+
+        Default `view=active` is the
+        live in-flight queue. `view=all` also includes failed and stuck documents.
+
+        Args:
+          container_tags: Comma-separated container tags to filter by
+
+          limit: Number of items per page. Used with `view=all`.
+
+          page: Page number to fetch. Used with `view=all`.
+
+          view: `active` returns in-flight documents updated in the last 4 hours. `all` also
+              includes failed and stuck documents.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         return self._get(
             "/v3/documents/processing",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "container_tags": container_tags,
+                        "limit": limit,
+                        "page": page,
+                        "view": view,
+                    },
+                    document_list_processing_params.DocumentListProcessingParams,
+                ),
             ),
             cast_to=DocumentListProcessingResponse,
         )
@@ -670,6 +735,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 +771,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 +813,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 +939,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 +966,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 +1007,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 +1030,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 +1058,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 +1106,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,
@@ -1115,6 +1206,10 @@ class AsyncDocumentsResource(AsyncAPIResource):
     async def list_processing(
         self,
         *,
+        container_tags: str | Omit = omit,
+        limit: Union[str, float] | Omit = omit,
+        page: Union[str, float] | Omit = omit,
+        view: Literal["active", "all"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -1122,11 +1217,45 @@ class AsyncDocumentsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DocumentListProcessingResponse:
-        """Get documents that are currently being processed"""
+        """Get documents that are currently being processed.
+
+        Default `view=active` is the
+        live in-flight queue. `view=all` also includes failed and stuck documents.
+
+        Args:
+          container_tags: Comma-separated container tags to filter by
+
+          limit: Number of items per page. Used with `view=all`.
+
+          page: Page number to fetch. Used with `view=all`.
+
+          view: `active` returns in-flight documents updated in the last 4 hours. `all` also
+              includes failed and stuck documents.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         return await self._get(
             "/v3/documents/processing",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "container_tags": container_tags,
+                        "limit": limit,
+                        "page": page,
+                        "view": view,
+                    },
+                    document_list_processing_params.DocumentListProcessingParams,
+                ),
             ),
             cast_to=DocumentListProcessingResponse,
         )

{supermemory-3.58.0 → supermemory-3.60.0}/src/supermemory/types/__init__.py

@@ -46,6 +46,7 @@ from .document_upload_file_response import DocumentUploadFileResponse as Documen
 from .memory_update_memory_response import MemoryUpdateMemoryResponse as MemoryUpdateMemoryResponse
 from .connection_delete_by_id_params import ConnectionDeleteByIDParams as ConnectionDeleteByIDParams
 from .connection_get_by_tag_response import ConnectionGetByTagResponse as ConnectionGetByTagResponse
+from .document_list_processing_params import DocumentListProcessingParams as DocumentListProcessingParams
 from .connection_delete_by_id_response import ConnectionDeleteByIDResponse as ConnectionDeleteByIDResponse
 from .connection_list_documents_params import ConnectionListDocumentsParams as ConnectionListDocumentsParams
 from .document_list_processing_response import DocumentListProcessingResponse as DocumentListProcessingResponse

{supermemory-3.58.0 → supermemory-3.60.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.60.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.60.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.60.0/src/supermemory/types/document_list_processing_params.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from typing_extensions import Literal, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["DocumentListProcessingParams"]
+
+
+class DocumentListProcessingParams(TypedDict, total=False):
+    container_tags: Annotated[str, PropertyInfo(alias="containerTags")]
+    """Comma-separated container tags to filter by"""
+
+    limit: Union[str, float]
+    """Number of items per page. Used with `view=all`."""
+
+    page: Union[str, float]
+    """Page number to fetch. Used with `view=all`."""
+
+    view: Literal["active", "all"]
+    """`active` returns in-flight documents updated in the last 4 hours.
+
+    `all` also includes failed and stuck documents.
+    """

{supermemory-3.58.0 → supermemory-3.60.0}/src/supermemory/types/document_list_processing_response.py

@@ -7,7 +7,7 @@ from pydantic import Field as FieldInfo
 
 from .._models import BaseModel
 
-__all__ = ["DocumentListProcessingResponse", "Document"]
+__all__ = ["DocumentListProcessingResponse", "Document", "Pagination"]
 
 
 class Document(BaseModel):
@@ -76,6 +76,27 @@ class Document(BaseModel):
     to use to group documents.
     """
 
+    error_code: Optional[str] = FieldInfo(alias="errorCode", default=None)
+    """Stable error code when processing failed, if available"""
+
+    error_message: Optional[str] = FieldInfo(alias="errorMessage", default=None)
+    """Human-readable processing error, if available"""
+
+    stuck: Optional[bool] = None
+    """True when the document is not done/failed and has not been updated for 4 hours"""
+
+
+class Pagination(BaseModel):
+    """Present when `view=all`"""
+
+    current_page: float = FieldInfo(alias="currentPage")
+
+    total_items: float = FieldInfo(alias="totalItems")
+
+    total_pages: float = FieldInfo(alias="totalPages")
+
+    limit: Optional[float] = None
+
 
 class DocumentListProcessingResponse(BaseModel):
     """List of documents currently being processed"""
@@ -84,3 +105,6 @@ class DocumentListProcessingResponse(BaseModel):
 
     total_count: float = FieldInfo(alias="totalCount")
     """Total number of processing documents"""
+
+    pagination: Optional[Pagination] = None
+    """Present when `view=all`"""

{supermemory-3.58.0 → supermemory-3.60.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.60.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.60.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",
@@ -419,6 +423,17 @@ class TestDocuments:
         document = client.documents.list_processing()
         assert_matches_type(DocumentListProcessingResponse, document, path=["response"])
 
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_method_list_processing_with_all_params(self, client: Supermemory) -> None:
+        document = client.documents.list_processing(
+            container_tags="user_123,sm_project_default",
+            limit="50",
+            page="1",
+            view="all",
+        )
+        assert_matches_type(DocumentListProcessingResponse, document, path=["response"])
+
     @pytest.mark.skip(reason="Mock server tests are disabled")
     @parametrize
     def test_raw_response_list_processing(self, client: Supermemory) -> None:
@@ -518,6 +533,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 +701,7 @@ class TestAsyncDocuments:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            document_date="documentDate",
             dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
@@ -742,6 +759,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 +777,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",
@@ -894,6 +913,17 @@ class TestAsyncDocuments:
         document = await async_client.documents.list_processing()
         assert_matches_type(DocumentListProcessingResponse, document, path=["response"])
 
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_method_list_processing_with_all_params(self, async_client: AsyncSupermemory) -> None:
+        document = await async_client.documents.list_processing(
+            container_tags="user_123,sm_project_default",
+            limit="50",
+            page="1",
+            view="all",
+        )
+        assert_matches_type(DocumentListProcessingResponse, document, path=["response"])
+
     @pytest.mark.skip(reason="Mock server tests are disabled")
     @parametrize
     async def test_raw_response_list_processing(self, async_client: AsyncSupermemory) -> None:

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

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