supermemory 3.40.0__tar.gz → 3.42.0__tar.gz

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

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

{supermemory-3.40.0 → supermemory-3.42.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.42.0 (2026-05-12)
+
+Full Changelog: [v3.41.0...v3.42.0](https://github.com/supermemoryai/python-sdk/compare/v3.41.0...v3.42.0)
+
+### Features
+
+* **internal/types:** support eagerly validating pydantic iterators ([5bb354d](https://github.com/supermemoryai/python-sdk/commit/5bb354dc5e11ef9f189fd06400b27bff1c727d39))
+
+## 3.41.0 (2026-05-12)
+
+Full Changelog: [v3.40.0...v3.41.0](https://github.com/supermemoryai/python-sdk/compare/v3.40.0...v3.41.0)
+
+### Features
+
+* **api:** api update ([02a5d82](https://github.com/supermemoryai/python-sdk/commit/02a5d82aaaf3b11183d66ce5adfd154c26ecb324))
+
 ## 3.40.0 (2026-05-11)
 
 Full Changelog: [v3.39.0...v3.40.0](https://github.com/supermemoryai/python-sdk/compare/v3.39.0...v3.40.0)

{supermemory-3.40.0 → supermemory-3.42.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: supermemory
-Version: 3.40.0
+Version: 3.42.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.40.0 → supermemory-3.42.0}/pyproject.toml

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

{supermemory-3.40.0 → supermemory-3.42.0}/src/supermemory/_models.py

@@ -25,7 +25,9 @@ from typing_extensions import (
     ClassVar,
     Protocol,
     Required,
+    Annotated,
     ParamSpec,
+    TypeAlias,
     TypedDict,
     TypeGuard,
     final,
@@ -79,7 +81,15 @@ from ._compat import (
 from ._constants import RAW_RESPONSE_HEADER
 
 if TYPE_CHECKING:
+    from pydantic import GetCoreSchemaHandler, ValidatorFunctionWrapHandler
+    from pydantic_core import CoreSchema, core_schema
     from pydantic_core.core_schema import ModelField, ModelSchema, LiteralSchema, ModelFieldsSchema
+else:
+    try:
+        from pydantic_core import CoreSchema, core_schema
+    except ImportError:
+        CoreSchema = None
+        core_schema = None
 
 __all__ = ["BaseModel", "GenericModel"]
 
@@ -396,6 +406,76 @@ class BaseModel(pydantic.BaseModel):
             )
 
 
+class _EagerIterable(list[_T], Generic[_T]):
+    """
+    Accepts any Iterable[T] input (including generators), consumes it
+    eagerly, and validates all items upfront.
+
+    Validation preserves the original container type where possible
+    (e.g. a set[T] stays a set[T]).  Serialization (model_dump / JSON)
+    always emits a list — round-tripping through model_dump() will not
+    restore the original container type.
+    """
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        source_type: Any,
+        handler: GetCoreSchemaHandler,
+    ) -> CoreSchema:
+        (item_type,) = get_args(source_type) or (Any,)
+        item_schema: CoreSchema = handler.generate_schema(item_type)
+        list_of_items_schema: CoreSchema = core_schema.list_schema(item_schema)
+
+        return core_schema.no_info_wrap_validator_function(
+            cls._validate,
+            list_of_items_schema,
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                cls._serialize,
+                info_arg=False,
+            ),
+        )
+
+    @staticmethod
+    def _validate(v: Iterable[_T], handler: "ValidatorFunctionWrapHandler") -> Any:
+        original_type: type[Any] = type(v)
+
+        # Normalize to list so list_schema can validate each item
+        if isinstance(v, list):
+            items: list[_T] = v
+        else:
+            try:
+                items = list(v)
+            except TypeError as e:
+                raise TypeError("Value is not iterable") from e
+
+        # Validate items against the inner schema
+        validated: list[_T] = handler(items)
+
+        # Reconstruct original container type
+        if original_type is list:
+            return validated
+        # str(list) produces the list's repr, not a string built from items,
+        # so skip reconstruction for str and its subclasses.
+        if issubclass(original_type, str):
+            return validated
+        try:
+            return original_type(validated)
+        except (TypeError, ValueError):
+            # If the type cannot be reconstructed, just return the validated list
+            return validated
+
+    @staticmethod
+    def _serialize(v: Iterable[_T]) -> list[_T]:
+        """Always serialize as a list so Pydantic's JSON encoder is happy."""
+        if isinstance(v, list):
+            return v
+        return list(v)
+
+
+EagerIterable: TypeAlias = Annotated[Iterable[_T], _EagerIterable]
+
+
 def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if value is None:
         return field_get_default(field)

{supermemory-3.40.0 → supermemory-3.42.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.40.0"  # x-release-please-version
+__version__ = "3.42.0"  # x-release-please-version

{supermemory-3.40.0 → supermemory-3.42.0}/src/supermemory/resources/documents.py

@@ -338,6 +338,7 @@ class DocumentsResource(SyncAPIResource):
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        entity_context: 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,
@@ -363,6 +364,9 @@ 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.
 
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
               by supermemoryfs to map documents to filesystem paths.
 
@@ -396,6 +400,7 @@ class DocumentsResource(SyncAPIResource):
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "entity_context": entity_context,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
                     "metadata": metadata,
@@ -915,6 +920,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        entity_context: 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,
@@ -940,6 +946,9 @@ 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.
 
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
               by supermemoryfs to map documents to filesystem paths.
 
@@ -973,6 +982,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "entity_context": entity_context,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
                     "metadata": metadata,

{supermemory-3.40.0 → supermemory-3.42.0}/src/supermemory/types/document_batch_add_params.py

@@ -30,6 +30,12 @@ class DocumentBatchAddParams(TypedDict, total=False):
 
     content: None
 
+    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.
+    """
+
     filepath: str
     """Optional file path for the document (e.g., '/documents/reports/file.pdf').
 
@@ -96,6 +102,12 @@ class DocumentsUnionMember0(TypedDict, total=False):
     document.
     """
 
+    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.
+    """
+
     filepath: str
     """Optional file path for the document (e.g., '/documents/reports/file.pdf').
 

{supermemory-3.40.0 → supermemory-3.42.0}/tests/api_resources/test_documents.py

@@ -39,22 +39,18 @@ class TestDocuments:
     def test_method_update_with_all_params(self, client: Supermemory) -> None:
         document = client.documents.update(
             id="id",
-            container_tag="user_123",
-            container_tags=["user_123", "project_123"],
-            content="This is a detailed article about machine learning concepts...",
-            custom_id="mem_abc123",
+            container_tag="user_alex",
+            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",
             filepath="/documents/reports/file.pdf",
             filter_by_metadata={
                 "department": "engineering",
                 "region": "us",
             },
             metadata={
-                "category": "technology",
-                "isPublic": True,
-                "readingTime": 5,
-                "source": "web",
-                "tag_1": "ai",
-                "tag_2": "machine-learning",
+                "source": "upload",
+                "language": "en",
             },
             task_type="memory",
         )
@@ -104,8 +100,8 @@ class TestDocuments:
     @parametrize
     def test_method_list_with_all_params(self, client: Supermemory) -> None:
         document = client.documents.list(
-            container_tags=["user_123", "project_123"],
-            filepath="/docs/",
+            container_tags=["_:_k--W2K_1V"],
+            filepath="filepath",
             filters={
                 "and_": [
                     {
@@ -252,7 +248,11 @@ class TestDocuments:
     @parametrize
     def test_method_batch_add(self, client: Supermemory) -> None:
         document = client.documents.batch_add(
-            documents=[{"content": "This is a detailed article about machine learning concepts..."}],
+            documents=[
+                {
+                    "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s."
+                }
+            ],
         )
         assert_matches_type(DocumentBatchAddResponse, document, path=["response"])
 
@@ -262,41 +262,35 @@ class TestDocuments:
         document = client.documents.batch_add(
             documents=[
                 {
-                    "content": "This is a detailed article about machine learning concepts...",
-                    "container_tag": "user_123",
-                    "container_tags": ["user_123", "project_123"],
-                    "custom_id": "mem_abc123",
+                    "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.",
+                    "container_tag": "user_alex",
+                    "container_tags": ["_:_k--W2K_1V"],
+                    "custom_id": "doc-api-rate-limits",
+                    "entity_context": "User's name is {XYZ}",
                     "filepath": "/documents/reports/file.pdf",
                     "filter_by_metadata": {
                         "department": "engineering",
                         "region": "us",
                     },
                     "metadata": {
-                        "category": "technology",
-                        "isPublic": True,
-                        "readingTime": 5,
-                        "source": "web",
-                        "tag_1": "ai",
-                        "tag_2": "machine-learning",
+                        "source": "upload",
+                        "language": "en",
                     },
                     "task_type": "memory",
                 }
             ],
-            container_tag="user_123",
-            container_tags=["user_123", "project_123"],
+            container_tag="user_alex",
+            container_tags=["_:_k--W2K_1V"],
             content=None,
+            entity_context="User's name is {XYZ}",
             filepath="/documents/reports/file.pdf",
             filter_by_metadata={
                 "department": "engineering",
                 "region": "us",
             },
             metadata={
-                "category": "technology",
-                "isPublic": True,
-                "readingTime": 5,
-                "source": "web",
-                "tag_1": "ai",
-                "tag_2": "machine-learning",
+                "source": "upload",
+                "language": "en",
             },
             task_type="memory",
         )
@@ -306,7 +300,11 @@ class TestDocuments:
     @parametrize
     def test_raw_response_batch_add(self, client: Supermemory) -> None:
         response = client.documents.with_raw_response.batch_add(
-            documents=[{"content": "This is a detailed article about machine learning concepts..."}],
+            documents=[
+                {
+                    "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s."
+                }
+            ],
         )
 
         assert response.is_closed is True
@@ -318,7 +316,11 @@ class TestDocuments:
     @parametrize
     def test_streaming_response_batch_add(self, client: Supermemory) -> None:
         with client.documents.with_streaming_response.batch_add(
-            documents=[{"content": "This is a detailed article about machine learning concepts..."}],
+            documents=[
+                {
+                    "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s."
+                }
+            ],
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -338,8 +340,8 @@ class TestDocuments:
     @parametrize
     def test_method_delete_bulk_with_all_params(self, client: Supermemory) -> None:
         document = client.documents.delete_bulk(
-            container_tags=["user_123", "project_123"],
-            filepath="/docs/old/",
+            container_tags=["_:_k--W2K_1V"],
+            filepath="filepath",
             ids=["acxV5LHMEsG2hMSNb4umbn", "bxcV5LHMEsG2hMSNb4umbn"],
         )
         assert_matches_type(DocumentDeleteBulkResponse, document, path=["response"])
@@ -450,9 +452,9 @@ class TestDocuments:
         document = client.documents.upload_file(
             file=b"Example data",
             container_tag="user",
-            container_tags='["user_123", "project_123"]',
+            container_tags="containerTags",
             custom_id="mem_abc123",
-            entity_context="This user is a software engineer who prefers concise technical documentation.",
+            entity_context="User's name is {XYZ}",
             filepath="/documents/reports/file.pdf",
             file_type="image",
             filter_by_metadata='{"department": "engineering"}',
@@ -508,22 +510,18 @@ class TestAsyncDocuments:
     async def test_method_update_with_all_params(self, async_client: AsyncSupermemory) -> None:
         document = await async_client.documents.update(
             id="id",
-            container_tag="user_123",
-            container_tags=["user_123", "project_123"],
-            content="This is a detailed article about machine learning concepts...",
-            custom_id="mem_abc123",
+            container_tag="user_alex",
+            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",
             filepath="/documents/reports/file.pdf",
             filter_by_metadata={
                 "department": "engineering",
                 "region": "us",
             },
             metadata={
-                "category": "technology",
-                "isPublic": True,
-                "readingTime": 5,
-                "source": "web",
-                "tag_1": "ai",
-                "tag_2": "machine-learning",
+                "source": "upload",
+                "language": "en",
             },
             task_type="memory",
         )
@@ -573,8 +571,8 @@ class TestAsyncDocuments:
     @parametrize
     async def test_method_list_with_all_params(self, async_client: AsyncSupermemory) -> None:
         document = await async_client.documents.list(
-            container_tags=["user_123", "project_123"],
-            filepath="/docs/",
+            container_tags=["_:_k--W2K_1V"],
+            filepath="filepath",
             filters={
                 "and_": [
                     {
@@ -721,7 +719,11 @@ class TestAsyncDocuments:
     @parametrize
     async def test_method_batch_add(self, async_client: AsyncSupermemory) -> None:
         document = await async_client.documents.batch_add(
-            documents=[{"content": "This is a detailed article about machine learning concepts..."}],
+            documents=[
+                {
+                    "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s."
+                }
+            ],
         )
         assert_matches_type(DocumentBatchAddResponse, document, path=["response"])
 
@@ -731,41 +733,35 @@ class TestAsyncDocuments:
         document = await async_client.documents.batch_add(
             documents=[
                 {
-                    "content": "This is a detailed article about machine learning concepts...",
-                    "container_tag": "user_123",
-                    "container_tags": ["user_123", "project_123"],
-                    "custom_id": "mem_abc123",
+                    "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.",
+                    "container_tag": "user_alex",
+                    "container_tags": ["_:_k--W2K_1V"],
+                    "custom_id": "doc-api-rate-limits",
+                    "entity_context": "User's name is {XYZ}",
                     "filepath": "/documents/reports/file.pdf",
                     "filter_by_metadata": {
                         "department": "engineering",
                         "region": "us",
                     },
                     "metadata": {
-                        "category": "technology",
-                        "isPublic": True,
-                        "readingTime": 5,
-                        "source": "web",
-                        "tag_1": "ai",
-                        "tag_2": "machine-learning",
+                        "source": "upload",
+                        "language": "en",
                     },
                     "task_type": "memory",
                 }
             ],
-            container_tag="user_123",
-            container_tags=["user_123", "project_123"],
+            container_tag="user_alex",
+            container_tags=["_:_k--W2K_1V"],
             content=None,
+            entity_context="User's name is {XYZ}",
             filepath="/documents/reports/file.pdf",
             filter_by_metadata={
                 "department": "engineering",
                 "region": "us",
             },
             metadata={
-                "category": "technology",
-                "isPublic": True,
-                "readingTime": 5,
-                "source": "web",
-                "tag_1": "ai",
-                "tag_2": "machine-learning",
+                "source": "upload",
+                "language": "en",
             },
             task_type="memory",
         )
@@ -775,7 +771,11 @@ class TestAsyncDocuments:
     @parametrize
     async def test_raw_response_batch_add(self, async_client: AsyncSupermemory) -> None:
         response = await async_client.documents.with_raw_response.batch_add(
-            documents=[{"content": "This is a detailed article about machine learning concepts..."}],
+            documents=[
+                {
+                    "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s."
+                }
+            ],
         )
 
         assert response.is_closed is True
@@ -787,7 +787,11 @@ class TestAsyncDocuments:
     @parametrize
     async def test_streaming_response_batch_add(self, async_client: AsyncSupermemory) -> None:
         async with async_client.documents.with_streaming_response.batch_add(
-            documents=[{"content": "This is a detailed article about machine learning concepts..."}],
+            documents=[
+                {
+                    "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s."
+                }
+            ],
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -807,8 +811,8 @@ class TestAsyncDocuments:
     @parametrize
     async def test_method_delete_bulk_with_all_params(self, async_client: AsyncSupermemory) -> None:
         document = await async_client.documents.delete_bulk(
-            container_tags=["user_123", "project_123"],
-            filepath="/docs/old/",
+            container_tags=["_:_k--W2K_1V"],
+            filepath="filepath",
             ids=["acxV5LHMEsG2hMSNb4umbn", "bxcV5LHMEsG2hMSNb4umbn"],
         )
         assert_matches_type(DocumentDeleteBulkResponse, document, path=["response"])
@@ -919,9 +923,9 @@ class TestAsyncDocuments:
         document = await async_client.documents.upload_file(
             file=b"Example data",
             container_tag="user",
-            container_tags='["user_123", "project_123"]',
+            container_tags="containerTags",
             custom_id="mem_abc123",
-            entity_context="This user is a software engineer who prefers concise technical documentation.",
+            entity_context="User's name is {XYZ}",
             filepath="/documents/reports/file.pdf",
             file_type="image",
             filter_by_metadata='{"department": "engineering"}',