release: 3.22.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.21.0"
+  ".": "3.22.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-228aa031e151ca6ab0d83088f067b165e13605944950869825bb68b940d2882f.yml
-openapi_spec_hash: db114c74a43b04b89ef63d1ec10cb8a8
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-c52fac62512bd29d68804cbd226eebe5ad4e6b07a94a0db480e89d0049293e6e.yml
+openapi_spec_hash: 655aacb90af901248f2629ede34595da
 config_hash: 4bcc46df5333a2be6812a59a40afdb5e

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 3.22.0 (2026-02-03)
+
+Full Changelog: [v3.21.0...v3.22.0](https://github.com/supermemoryai/python-sdk/compare/v3.21.0...v3.22.0)
+
+### Features
+
+* **api:** api update ([70a03ea](https://github.com/supermemoryai/python-sdk/commit/70a03eaf972c0b12191b1ef64d70efeec0dcd19a))
+
 ## 3.21.0 (2026-01-30)
 
 Full Changelog: [v3.20.1...v3.21.0](https://github.com/supermemoryai/python-sdk/compare/v3.20.1...v3.21.0)

pyproject.toml

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

src/supermemory/_client.py

@@ -241,6 +241,7 @@ def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        entity_context: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | 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.
@@ -262,6 +263,9 @@ def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens and underscores only.
 
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           metadata: Optional metadata for the document.
 
           extra_headers: Send extra headers
@@ -280,6 +284,7 @@ def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "entity_context": entity_context,
                     "metadata": metadata,
                 },
                 client_add_params.ClientAddParams,
@@ -544,6 +549,7 @@ async def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        entity_context: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | 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.
@@ -565,6 +571,9 @@ async def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens and underscores only.
 
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           metadata: Optional metadata for the document.
 
           extra_headers: Send extra headers
@@ -583,6 +592,7 @@ async def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "entity_context": entity_context,
                     "metadata": metadata,
                 },
                 client_add_params.ClientAddParams,

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

src/supermemory/resources/documents.py

@@ -239,6 +239,7 @@ def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        entity_context: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | 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.
@@ -260,6 +261,9 @@ def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens and underscores only.
 
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           metadata: Optional metadata for the document.
 
           extra_headers: Send extra headers
@@ -278,6 +282,7 @@ def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "entity_context": entity_context,
                     "metadata": metadata,
                 },
                 document_add_params.DocumentAddParams,
@@ -721,6 +726,7 @@ async def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        entity_context: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | 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.
@@ -742,6 +748,9 @@ async def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens and underscores only.
 
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           metadata: Optional metadata for the document.
 
           extra_headers: Send extra headers
@@ -760,6 +769,7 @@ async def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "entity_context": entity_context,
                     "metadata": metadata,
                 },
                 document_add_params.DocumentAddParams,

src/supermemory/resources/memories.py

@@ -238,6 +238,7 @@ def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        entity_context: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | 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.
@@ -259,6 +260,9 @@ def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens and underscores only.
 
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           metadata: Optional metadata for the document.
 
           extra_headers: Send extra headers
@@ -277,6 +281,7 @@ def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "entity_context": entity_context,
                     "metadata": metadata,
                 },
                 memory_add_params.MemoryAddParams,
@@ -709,6 +714,7 @@ async def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        entity_context: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | 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.
@@ -730,6 +736,9 @@ async def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens and underscores only.
 
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           metadata: Optional metadata for the document.
 
           extra_headers: Send extra headers
@@ -748,6 +757,7 @@ async def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "entity_context": entity_context,
                     "metadata": metadata,
                 },
                 memory_add_params.MemoryAddParams,

src/supermemory/types/client_add_params.py

@@ -32,5 +32,11 @@ class ClientAddParams(TypedDict, total=False):
     Max 100 characters, alphanumeric with hyphens and underscores only.
     """
 
+    entity_context: Annotated[str, PropertyInfo(alias="entityContext")]
+    """Optional entity context for this container tag.
+
+    Max 1500 characters. Used during document processing to guide memory extraction.
+    """
+
     metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
     """Optional metadata for the document."""

src/supermemory/types/document_add_params.py

@@ -32,5 +32,11 @@ class DocumentAddParams(TypedDict, total=False):
     Max 100 characters, alphanumeric with hyphens and underscores only.
     """
 
+    entity_context: Annotated[str, PropertyInfo(alias="entityContext")]
+    """Optional entity context for this container tag.
+
+    Max 1500 characters. Used during document processing to guide memory extraction.
+    """
+
     metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
     """Optional metadata for the document."""

src/supermemory/types/memory_add_params.py

@@ -32,5 +32,11 @@ class MemoryAddParams(TypedDict, total=False):
     Max 100 characters, alphanumeric with hyphens and underscores only.
     """
 
+    entity_context: Annotated[str, PropertyInfo(alias="entityContext")]
+    """Optional entity context for this container tag.
+
+    Max 1500 characters. Used during document processing to guide memory extraction.
+    """
+
     metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
     """Optional metadata for the document."""

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",
+            entity_context="entityContext",
             metadata={"foo": "string"},
         )
         assert_matches_type(AddResponse, client_, path=["response"])
@@ -129,6 +130,7 @@ async def test_method_add_with_all_params(self, async_client: AsyncSupermemory)
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            entity_context="entityContext",
             metadata={"foo": "string"},
         )
         assert_matches_type(AddResponse, client, path=["response"])

tests/api_resources/test_documents.py

@@ -207,6 +207,7 @@ def test_method_add_with_all_params(self, client: Supermemory) -> None:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            entity_context="entityContext",
             metadata={"foo": "string"},
         )
         assert_matches_type(DocumentAddResponse, document, path=["response"])
@@ -646,6 +647,7 @@ async def test_method_add_with_all_params(self, async_client: AsyncSupermemory)
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            entity_context="entityContext",
             metadata={"foo": "string"},
         )
         assert_matches_type(DocumentAddResponse, document, path=["response"])

tests/api_resources/test_memories.py

@@ -206,6 +206,7 @@ def test_method_add_with_all_params(self, client: Supermemory) -> None:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            entity_context="entityContext",
             metadata={"foo": "string"},
         )
         assert_matches_type(MemoryAddResponse, memory, path=["response"])
@@ -606,6 +607,7 @@ async def test_method_add_with_all_params(self, async_client: AsyncSupermemory)
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            entity_context="entityContext",
             metadata={"foo": "string"},
         )
         assert_matches_type(MemoryAddResponse, memory, path=["response"])