supermemory 3.55.0__tar.gz → 3.57.0__tar.gz

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

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

{supermemory-3.55.0 → supermemory-3.57.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.57.0 (2026-08-11)
+
+Full Changelog: [v3.56.0...v3.57.0](https://github.com/supermemoryai/python-sdk/compare/v3.56.0...v3.57.0)
+
+### Features
+
+* **api:** api update ([307c6ac](https://github.com/supermemoryai/python-sdk/commit/307c6ac6f115b9fac6ef7aaa70416e387cabf8e7))
+
+## 3.56.0 (2026-07-24)
+
+Full Changelog: [v3.55.0...v3.56.0](https://github.com/supermemoryai/python-sdk/compare/v3.55.0...v3.56.0)
+
+### Features
+
+* **api:** api update ([d04a39c](https://github.com/supermemoryai/python-sdk/commit/d04a39c5b163af7e0297417d47bd917d45231751))
+
 ## 3.55.0 (2026-07-24)
 
 Full Changelog: [v3.54.0...v3.55.0](https://github.com/supermemoryai/python-sdk/compare/v3.54.0...v3.55.0)

{supermemory-3.55.0 → supermemory-3.57.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: supermemory
-Version: 3.55.0
+Version: 3.57.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.55.0 → supermemory-3.57.0}/pyproject.toml

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

{supermemory-3.55.0 → supermemory-3.57.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.55.0"  # x-release-please-version
+__version__ = "3.57.0"  # x-release-please-version

{supermemory-3.55.0 → supermemory-3.57.0}/src/supermemory/resources/settings.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import Dict, Union, Iterable, Optional
+from typing_extensions import overload
 
 import httpx
 
@@ -46,6 +47,33 @@ class SettingsResource(SyncAPIResource):
         """
         return SettingsResourceWithStreamingResponse(self)
 
+    @overload
+    def update(
+        self,
+        *,
+        workspace_prompt: Optional[str],
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SettingUpdateResponse:
+        """
+        Update settings for an organization
+
+        Args:
+          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
+        """
+        ...
+
+    @overload
     def update(
         self,
         *,
@@ -65,7 +93,7 @@ class SettingsResource(SyncAPIResource):
         onedrive_client_id: Optional[str] | Omit = omit,
         onedrive_client_secret: Optional[str] | Omit = omit,
         onedrive_custom_key_enabled: Optional[bool] | Omit = omit,
-        profile_buckets: Iterable[setting_update_params.ProfileBucket] | Omit = omit,
+        profile_buckets: Iterable[setting_update_params.Variant1ProfileBucket] | Omit = omit,
         should_llm_filter: Optional[bool] | 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.
@@ -88,10 +116,42 @@ class SettingsResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
+        ...
+
+    def update(
+        self,
+        *,
+        workspace_prompt: Optional[str] | Omit = omit,
+        chunk_size: Optional[int] | Omit = omit,
+        exclude_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | Omit = omit,
+        filter_prompt: Optional[str] | Omit = omit,
+        github_client_id: Optional[str] | Omit = omit,
+        github_client_secret: Optional[str] | Omit = omit,
+        github_custom_key_enabled: Optional[bool] | Omit = omit,
+        google_drive_client_id: Optional[str] | Omit = omit,
+        google_drive_client_secret: Optional[str] | Omit = omit,
+        google_drive_custom_key_enabled: Optional[bool] | Omit = omit,
+        include_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | Omit = omit,
+        notion_client_id: Optional[str] | Omit = omit,
+        notion_client_secret: Optional[str] | Omit = omit,
+        notion_custom_key_enabled: Optional[bool] | Omit = omit,
+        onedrive_client_id: Optional[str] | Omit = omit,
+        onedrive_client_secret: Optional[str] | Omit = omit,
+        onedrive_custom_key_enabled: Optional[bool] | Omit = omit,
+        profile_buckets: Iterable[setting_update_params.Variant1ProfileBucket] | Omit = omit,
+        should_llm_filter: Optional[bool] | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SettingUpdateResponse:
         return self._patch(
             "/v3/settings",
             body=maybe_transform(
                 {
+                    "workspace_prompt": workspace_prompt,
                     "chunk_size": chunk_size,
                     "exclude_items": exclude_items,
                     "filter_prompt": filter_prompt,
@@ -161,6 +221,33 @@ class AsyncSettingsResource(AsyncAPIResource):
         """
         return AsyncSettingsResourceWithStreamingResponse(self)
 
+    @overload
+    async def update(
+        self,
+        *,
+        workspace_prompt: Optional[str],
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SettingUpdateResponse:
+        """
+        Update settings for an organization
+
+        Args:
+          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
+        """
+        ...
+
+    @overload
     async def update(
         self,
         *,
@@ -180,7 +267,7 @@ class AsyncSettingsResource(AsyncAPIResource):
         onedrive_client_id: Optional[str] | Omit = omit,
         onedrive_client_secret: Optional[str] | Omit = omit,
         onedrive_custom_key_enabled: Optional[bool] | Omit = omit,
-        profile_buckets: Iterable[setting_update_params.ProfileBucket] | Omit = omit,
+        profile_buckets: Iterable[setting_update_params.Variant1ProfileBucket] | Omit = omit,
         should_llm_filter: Optional[bool] | 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.
@@ -203,10 +290,42 @@ class AsyncSettingsResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
+        ...
+
+    async def update(
+        self,
+        *,
+        workspace_prompt: Optional[str] | Omit = omit,
+        chunk_size: Optional[int] | Omit = omit,
+        exclude_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | Omit = omit,
+        filter_prompt: Optional[str] | Omit = omit,
+        github_client_id: Optional[str] | Omit = omit,
+        github_client_secret: Optional[str] | Omit = omit,
+        github_custom_key_enabled: Optional[bool] | Omit = omit,
+        google_drive_client_id: Optional[str] | Omit = omit,
+        google_drive_client_secret: Optional[str] | Omit = omit,
+        google_drive_custom_key_enabled: Optional[bool] | Omit = omit,
+        include_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | Omit = omit,
+        notion_client_id: Optional[str] | Omit = omit,
+        notion_client_secret: Optional[str] | Omit = omit,
+        notion_custom_key_enabled: Optional[bool] | Omit = omit,
+        onedrive_client_id: Optional[str] | Omit = omit,
+        onedrive_client_secret: Optional[str] | Omit = omit,
+        onedrive_custom_key_enabled: Optional[bool] | Omit = omit,
+        profile_buckets: Iterable[setting_update_params.Variant1ProfileBucket] | Omit = omit,
+        should_llm_filter: Optional[bool] | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SettingUpdateResponse:
         return await self._patch(
             "/v3/settings",
             body=await async_maybe_transform(
                 {
+                    "workspace_prompt": workspace_prompt,
                     "chunk_size": chunk_size,
                     "exclude_items": exclude_items,
                     "filter_prompt": filter_prompt,

supermemory-3.57.0/src/supermemory/types/client_profile_params.py

@@ -0,0 +1,140 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Union, Iterable
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+
+__all__ = [
+    "ClientProfileParams",
+    "Filters",
+    "FiltersOr",
+    "FiltersOrOr",
+    "FiltersOrOrFilterCondition",
+    "FiltersOrOrOr",
+    "FiltersOrOrAnd",
+    "FiltersAnd",
+    "FiltersAndAnd",
+    "FiltersAndAndFilterCondition",
+    "FiltersAndAndOr",
+    "FiltersAndAndAnd",
+]
+
+
+class ClientProfileParams(TypedDict, total=False):
+    container_tag: Required[Annotated[str, PropertyInfo(alias="containerTag")]]
+    """Tag to filter the profile by.
+
+    This can be an ID for your user, a project ID, or any other identifier you wish
+    to use to filter memories.
+    """
+
+    buckets: SequenceNotStr[str]
+    """Specific bucket keys to return.
+
+    Omit to return all configured buckets. Only relevant when "buckets" is included.
+    """
+
+    filters: Filters
+    """Optional metadata filters to apply to profile results and search results.
+
+    Supports complex AND/OR queries with multiple conditions.
+    """
+
+    include: List[Literal["static", "dynamic", "buckets"]]
+    """Profile sections to return.
+
+    Omit to return all sections. Pass a subset to reduce payload — e.g. ["buckets"]
+    skips static and dynamic entirely.
+    """
+
+    q: str
+    """Optional search query to include search results in the response"""
+
+    threshold: float
+    """Threshold for search results.
+
+    Only results with a score above this threshold will be included.
+    """
+
+
+class FiltersOrOrFilterCondition(TypedDict, total=False):
+    """
+    A single filter condition based on metadata, numeric values, array contents, or string matching
+    """
+
+    key: Required[str]
+
+    value: Required[str]
+
+    filter_type: Annotated[
+        Literal["metadata", "numeric", "array_contains", "string_contains"], PropertyInfo(alias="filterType")
+    ]
+
+    ignore_case: Annotated[Union[bool, Literal["true", "false"]], PropertyInfo(alias="ignoreCase")]
+
+    negate: Union[bool, Literal["true", "false"]]
+
+    numeric_operator: Annotated[Literal[">", "<", ">=", "<=", "="], PropertyInfo(alias="numericOperator")]
+
+
+class FiltersOrOrOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[object], PropertyInfo(alias="OR")]]
+    """OR: Array of conditions or nested expressions"""
+
+
+class FiltersOrOrAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[object], PropertyInfo(alias="AND")]]
+    """AND: Array of conditions or nested expressions"""
+
+
+FiltersOrOr: TypeAlias = Union[FiltersOrOrFilterCondition, FiltersOrOrOr, FiltersOrOrAnd]
+
+
+class FiltersOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[FiltersOrOr], PropertyInfo(alias="OR")]]
+    """Array of OR filter expressions"""
+
+
+class FiltersAndAndFilterCondition(TypedDict, total=False):
+    """
+    A single filter condition based on metadata, numeric values, array contents, or string matching
+    """
+
+    key: Required[str]
+
+    value: Required[str]
+
+    filter_type: Annotated[
+        Literal["metadata", "numeric", "array_contains", "string_contains"], PropertyInfo(alias="filterType")
+    ]
+
+    ignore_case: Annotated[Union[bool, Literal["true", "false"]], PropertyInfo(alias="ignoreCase")]
+
+    negate: Union[bool, Literal["true", "false"]]
+
+    numeric_operator: Annotated[Literal[">", "<", ">=", "<=", "="], PropertyInfo(alias="numericOperator")]
+
+
+class FiltersAndAndOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[object], PropertyInfo(alias="OR")]]
+    """OR: Array of conditions or nested expressions"""
+
+
+class FiltersAndAndAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[object], PropertyInfo(alias="AND")]]
+    """AND: Array of conditions or nested expressions"""
+
+
+FiltersAndAnd: TypeAlias = Union[FiltersAndAndFilterCondition, FiltersAndAndOr, FiltersAndAndAnd]
+
+
+class FiltersAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[FiltersAndAnd], PropertyInfo(alias="AND")]]
+    """Array of AND filter expressions"""
+
+
+Filters: TypeAlias = Union[FiltersOr, FiltersAnd]

{supermemory-3.55.0 → supermemory-3.57.0}/src/supermemory/types/document_get_response.py

@@ -7,12 +7,40 @@ from pydantic import Field as FieldInfo
 
 from .._models import BaseModel
 
-__all__ = ["DocumentGetResponse"]
+__all__ = ["DocumentGetResponse", "Memory"]
 
 
-class DocumentGetResponse(BaseModel):
-    """Document object"""
+class Memory(BaseModel):
+    id: str
+
+    created_at: str = FieldInfo(alias="createdAt")
+    """Creation timestamp"""
+
+    is_forgotten: bool = FieldInfo(alias="isForgotten")
+
+    is_inference: bool = FieldInfo(alias="isInference")
+
+    is_latest: bool = FieldInfo(alias="isLatest")
+
+    is_static: bool = FieldInfo(alias="isStatic")
+
+    memory: str
+
+    metadata: Union[str, float, bool, Dict[str, object], List[object], None] = None
 
+    parent_memory_id: Optional[str] = FieldInfo(alias="parentMemoryId", default=None)
+
+    root_memory_id: Optional[str] = FieldInfo(alias="rootMemoryId", default=None)
+
+    source_count: int = FieldInfo(alias="sourceCount")
+
+    updated_at: Optional[str] = FieldInfo(alias="updatedAt", default=None)
+    """Last update timestamp"""
+
+    version: int
+
+
+class DocumentGetResponse(BaseModel):
     id: str
     """Unique identifier of the document."""
 
@@ -108,5 +136,11 @@ class DocumentGetResponse(BaseModel):
     to use to group documents.
     """
 
+    memories: Optional[List[Memory]] = None
+    """Memories extracted from this document.
+
+    Omitted when the document has no memories (e.g. still processing).
+    """
+
     url: Optional[str] = None
     """URL of the document"""

supermemory-3.57.0/src/supermemory/types/document_list_params.py

@@ -0,0 +1,139 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Iterable
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+
+__all__ = [
+    "DocumentListParams",
+    "Filters",
+    "FiltersOr",
+    "FiltersOrOr",
+    "FiltersOrOrFilterCondition",
+    "FiltersOrOrOr",
+    "FiltersOrOrAnd",
+    "FiltersAnd",
+    "FiltersAndAnd",
+    "FiltersAndAndFilterCondition",
+    "FiltersAndAndOr",
+    "FiltersAndAndAnd",
+]
+
+
+class DocumentListParams(TypedDict, total=False):
+    container_tags: Annotated[SequenceNotStr[str], PropertyInfo(alias="containerTags")]
+    """Optional tags this document should be containerized by.
+
+    This can be an ID for your user, a project ID, or any other identifier you wish
+    to use to group documents.
+    """
+
+    filepath: str
+    """Filter documents by filepath.
+
+    Exact match for full paths, prefix match if ending with /
+    """
+
+    filters: Filters
+    """Optional filters to apply to the search. Can be a JSON string or Query object."""
+
+    include_content: Annotated[bool, PropertyInfo(alias="includeContent")]
+    """Whether to include the content field in the response.
+
+    Warning: This can make responses significantly larger.
+    """
+
+    limit: Union[str, float]
+    """Number of items per page"""
+
+    order: Literal["asc", "desc"]
+    """Sort order"""
+
+    page: Union[str, float]
+    """Page number to fetch"""
+
+    sort: Literal["createdAt", "updatedAt"]
+    """Field to sort by"""
+
+
+class FiltersOrOrFilterCondition(TypedDict, total=False):
+    """
+    A single filter condition based on metadata, numeric values, array contents, or string matching
+    """
+
+    key: Required[str]
+
+    value: Required[str]
+
+    filter_type: Annotated[
+        Literal["metadata", "numeric", "array_contains", "string_contains"], PropertyInfo(alias="filterType")
+    ]
+
+    ignore_case: Annotated[Union[bool, Literal["true", "false"]], PropertyInfo(alias="ignoreCase")]
+
+    negate: Union[bool, Literal["true", "false"]]
+
+    numeric_operator: Annotated[Literal[">", "<", ">=", "<=", "="], PropertyInfo(alias="numericOperator")]
+
+
+class FiltersOrOrOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[object], PropertyInfo(alias="OR")]]
+    """OR: Array of conditions or nested expressions"""
+
+
+class FiltersOrOrAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[object], PropertyInfo(alias="AND")]]
+    """AND: Array of conditions or nested expressions"""
+
+
+FiltersOrOr: TypeAlias = Union[FiltersOrOrFilterCondition, FiltersOrOrOr, FiltersOrOrAnd]
+
+
+class FiltersOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[FiltersOrOr], PropertyInfo(alias="OR")]]
+    """Array of OR filter expressions"""
+
+
+class FiltersAndAndFilterCondition(TypedDict, total=False):
+    """
+    A single filter condition based on metadata, numeric values, array contents, or string matching
+    """
+
+    key: Required[str]
+
+    value: Required[str]
+
+    filter_type: Annotated[
+        Literal["metadata", "numeric", "array_contains", "string_contains"], PropertyInfo(alias="filterType")
+    ]
+
+    ignore_case: Annotated[Union[bool, Literal["true", "false"]], PropertyInfo(alias="ignoreCase")]
+
+    negate: Union[bool, Literal["true", "false"]]
+
+    numeric_operator: Annotated[Literal[">", "<", ">=", "<=", "="], PropertyInfo(alias="numericOperator")]
+
+
+class FiltersAndAndOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[object], PropertyInfo(alias="OR")]]
+    """OR: Array of conditions or nested expressions"""
+
+
+class FiltersAndAndAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[object], PropertyInfo(alias="AND")]]
+    """AND: Array of conditions or nested expressions"""
+
+
+FiltersAndAnd: TypeAlias = Union[FiltersAndAndFilterCondition, FiltersAndAndOr, FiltersAndAndAnd]
+
+
+class FiltersAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[FiltersAndAnd], PropertyInfo(alias="AND")]]
+    """Array of AND filter expressions"""
+
+
+Filters: TypeAlias = Union[FiltersOr, FiltersAnd]