release: 3.44.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.43.0"
+  ".": "3.44.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc/supermemory-new-c447b3b1739c61ad5c7d154b756a27babca059729c781af4426a48c289f5f0b3.yml
-openapi_spec_hash: c498629fb2c104767bf108daca8fcd9d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc/supermemory-new-a02634cf1b1c465ad3c8505ea2402e2a2bef732858a9f4d2337aeea5a99c14bc.yml
+openapi_spec_hash: f859a6666196eea26ea9e6078d218129
 config_hash: cde97ef3188581c5f4924c633ec33ddb

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 3.44.0 (2026-06-01)
+
+Full Changelog: [v3.43.0...v3.44.0](https://github.com/supermemoryai/python-sdk/compare/v3.43.0...v3.44.0)
+
+### Features
+
+* **api:** api update ([b20052c](https://github.com/supermemoryai/python-sdk/commit/b20052c50a67c42febd38d9e184dde642e2fd1ad))
+
 ## 3.43.0 (2026-05-22)
 
 Full Changelog: [v3.42.0...v3.43.0](https://github.com/supermemoryai/python-sdk/compare/v3.42.0...v3.43.0)

pyproject.toml

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

src/supermemory/_client.py

@@ -254,6 +254,7 @@ def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -279,6 +280,11 @@ def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          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
+              extra operation per document.
+
           entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
               document processing to guide memory extraction.
 
@@ -309,6 +315,7 @@ def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
@@ -594,6 +601,7 @@ async def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -619,6 +627,11 @@ async def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          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
+              extra operation per document.
+
           entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
               document processing to guide memory extraction.
 
@@ -649,6 +662,7 @@ async def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,

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

src/supermemory/resources/documents.py

@@ -262,6 +262,7 @@ def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -287,6 +288,11 @@ def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          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
+              extra operation per document.
+
           entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
               document processing to guide memory extraction.
 
@@ -317,6 +323,7 @@ def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
@@ -338,6 +345,7 @@ def batch_add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -364,6 +372,11 @@ def batch_add(
               containerized by. This can be an ID for your user, a project ID, or any other
               identifier you wish to use to group documents.
 
+          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
+              extra operation per document.
+
           entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
               document processing to guide memory extraction.
 
@@ -400,6 +413,7 @@ def batch_add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
@@ -844,6 +858,7 @@ async def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -869,6 +884,11 @@ async def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          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
+              extra operation per document.
+
           entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
               document processing to guide memory extraction.
 
@@ -899,6 +919,7 @@ async def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
@@ -920,6 +941,7 @@ async def batch_add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -946,6 +968,11 @@ async def batch_add(
               containerized by. This can be an ID for your user, a project ID, or any other
               identifier you wish to use to group documents.
 
+          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
+              extra operation per document.
+
           entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
               document processing to guide memory extraction.
 
@@ -982,6 +1009,7 @@ async def batch_add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,

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.
     """
 
+    dreaming: Literal["instant", "dynamic"]
+    """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 extra operation per
+    document.
+    """
+
     entity_context: Annotated[str, PropertyInfo(alias="entityContext")]
     """Optional entity context for this container tag.
 

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.
     """
 
+    dreaming: Literal["instant", "dynamic"]
+    """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 extra operation per
+    document.
+    """
+
     entity_context: Annotated[str, PropertyInfo(alias="entityContext")]
     """Optional entity context for this container tag.
 

src/supermemory/types/document_batch_add_params.py

@@ -30,6 +30,15 @@ class DocumentBatchAddParams(TypedDict, total=False):
 
     content: None
 
+    dreaming: Literal["instant", "dynamic"]
+    """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 extra operation per
+    document.
+    """
+
     entity_context: Annotated[str, PropertyInfo(alias="entityContext")]
     """Optional entity context for this container tag.
 
@@ -102,6 +111,15 @@ class DocumentsUnionMember0(TypedDict, total=False):
     document.
     """
 
+    dreaming: Literal["instant", "dynamic"]
+    """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 extra operation per
+    document.
+    """
+
     entity_context: Annotated[str, PropertyInfo(alias="entityContext")]
     """Optional entity context for this container tag.
 

tests/api_resources/test_client.py

@@ -33,6 +33,7 @@ def test_method_add_with_all_params(self, client: Supermemory) -> None:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
             filter_by_metadata={"foo": "string"},
@@ -145,6 +146,7 @@ async def test_method_add_with_all_params(self, async_client: AsyncSupermemory)
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
             filter_by_metadata={"foo": "string"},

tests/api_resources/test_documents.py

@@ -210,6 +210,7 @@ def test_method_add_with_all_params(self, client: Supermemory) -> None:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
             filter_by_metadata={"foo": "string"},
@@ -266,6 +267,7 @@ def test_method_batch_add_with_all_params(self, client: Supermemory) -> None:
                     "container_tag": "user_alex",
                     "container_tags": ["_:_k--W2K_1V"],
                     "custom_id": "doc-api-rate-limits",
+                    "dreaming": "instant",
                     "entity_context": "User's name is {XYZ}",
                     "filepath": "/documents/reports/file.pdf",
                     "filter_by_metadata": {
@@ -282,6 +284,7 @@ def test_method_batch_add_with_all_params(self, client: Supermemory) -> None:
             container_tag="user_alex",
             container_tags=["_:_k--W2K_1V"],
             content=None,
+            dreaming="instant",
             entity_context="User's name is {XYZ}",
             filepath="/documents/reports/file.pdf",
             filter_by_metadata={
@@ -681,6 +684,7 @@ async def test_method_add_with_all_params(self, async_client: AsyncSupermemory)
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
             filter_by_metadata={"foo": "string"},
@@ -737,6 +741,7 @@ async def test_method_batch_add_with_all_params(self, async_client: AsyncSuperme
                     "container_tag": "user_alex",
                     "container_tags": ["_:_k--W2K_1V"],
                     "custom_id": "doc-api-rate-limits",
+                    "dreaming": "instant",
                     "entity_context": "User's name is {XYZ}",
                     "filepath": "/documents/reports/file.pdf",
                     "filter_by_metadata": {
@@ -753,6 +758,7 @@ async def test_method_batch_add_with_all_params(self, async_client: AsyncSuperme
             container_tag="user_alex",
             container_tags=["_:_k--W2K_1V"],
             content=None,
+            dreaming="instant",
             entity_context="User's name is {XYZ}",
             filepath="/documents/reports/file.pdf",
             filter_by_metadata={