From b20052c50a67c42febd38d9e184dde642e2fd1ad Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 1 Jun 2026 18:27:24 +0000
Subject: [PATCH 1/2] feat(api): api update

---
 .stats.yml                                    |  4 +--
 src/supermemory/_client.py                    | 14 ++++++++++
 src/supermemory/resources/documents.py        | 28 +++++++++++++++++++
 src/supermemory/types/client_add_params.py    |  9 ++++++
 src/supermemory/types/document_add_params.py  |  9 ++++++
 .../types/document_batch_add_params.py        | 18 ++++++++++++
 tests/api_resources/test_client.py            |  2 ++
 tests/api_resources/test_documents.py         |  6 ++++
 8 files changed, 88 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 7ee0237..6e937e0 100644
--- a/.stats.yml
+++ b/.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
diff --git a/src/supermemory/_client.py b/src/supermemory/_client.py
index 74a5f8d..d71473d 100644
--- a/src/supermemory/_client.py
+++ b/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,
diff --git a/src/supermemory/resources/documents.py b/src/supermemory/resources/documents.py
index 7ebc877..a31e52c 100644
--- a/src/supermemory/resources/documents.py
+++ b/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,
diff --git a/src/supermemory/types/client_add_params.py b/src/supermemory/types/client_add_params.py
index 9c2deb6..fcdf98a 100644
--- a/src/supermemory/types/client_add_params.py
+++ b/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.
 
diff --git a/src/supermemory/types/document_add_params.py b/src/supermemory/types/document_add_params.py
index 72fbc81..b503831 100644
--- a/src/supermemory/types/document_add_params.py
+++ b/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.
 
diff --git a/src/supermemory/types/document_batch_add_params.py b/src/supermemory/types/document_batch_add_params.py
index 9f7e792..0369f41 100644
--- a/src/supermemory/types/document_batch_add_params.py
+++ b/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.
 
diff --git a/tests/api_resources/test_client.py b/tests/api_resources/test_client.py
index 3cac91e..c4511bd 100644
--- a/tests/api_resources/test_client.py
+++ b/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"},
diff --git a/tests/api_resources/test_documents.py b/tests/api_resources/test_documents.py
index 10d6e6c..955203f 100644
--- a/tests/api_resources/test_documents.py
+++ b/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={

From f6592ff4379dee75e39ff91a6824de4c501b94d4 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 1 Jun 2026 18:27:50 +0000
Subject: [PATCH 2/2] release: 3.44.0

---
 .release-please-manifest.json | 2 +-
 CHANGELOG.md                  | 8 ++++++++
 pyproject.toml                | 2 +-
 src/supermemory/_version.py   | 2 +-
 4 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index dfb7e1c..e37fcbc 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "3.43.0"
+  ".": "3.44.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2770663..79d6482 100644
--- a/CHANGELOG.md
+++ b/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)
diff --git a/pyproject.toml b/pyproject.toml
index 9ab8010..57c440e 100644
--- a/pyproject.toml
+++ b/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"
diff --git a/src/supermemory/_version.py b/src/supermemory/_version.py
index e92a2d3..0a128c4 100644
--- a/src/supermemory/_version.py
+++ b/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