supermemory 3.0.0a30__py3-none-any.whl → 3.1.0__py3-none-any.whl

supermemory/resources/search.py

@@ -8,7 +8,7 @@ from typing_extensions import Literal
 import httpx
 
 from ..types import search_execute_params, search_memories_params, search_documents_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
+from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -50,24 +50,24 @@ class SearchResource(SyncAPIResource):
         self,
         *,
         q: str,
-        categories_filter: List[Literal["technology", "science", "business", "health"]] | NotGiven = NOT_GIVEN,
-        chunk_threshold: float | NotGiven = NOT_GIVEN,
-        container_tags: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
-        doc_id: str | NotGiven = NOT_GIVEN,
-        document_threshold: float | NotGiven = NOT_GIVEN,
-        filters: search_documents_params.Filters | NotGiven = NOT_GIVEN,
-        include_full_docs: bool | NotGiven = NOT_GIVEN,
-        include_summary: bool | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        only_matching_chunks: bool | NotGiven = NOT_GIVEN,
-        rerank: bool | NotGiven = NOT_GIVEN,
-        rewrite_query: bool | NotGiven = NOT_GIVEN,
+        categories_filter: List[Literal["technology", "science", "business", "health"]] | Omit = omit,
+        chunk_threshold: float | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        doc_id: str | Omit = omit,
+        document_threshold: float | Omit = omit,
+        filters: search_documents_params.Filters | Omit = omit,
+        include_full_docs: bool | Omit = omit,
+        include_summary: bool | Omit = omit,
+        limit: int | Omit = omit,
+        only_matching_chunks: bool | Omit = omit,
+        rerank: bool | Omit = omit,
+        rewrite_query: 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchDocumentsResponse:
         """
         Search memories with advanced filtering
@@ -91,7 +91,7 @@ class SearchResource(SyncAPIResource):
               most documents, more results), 1 is most sensitive (returns lesser documents,
               accurate results)
 
-          filters: Optional filters to apply to the search
+          filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           include_full_docs: If true, include full document in the response. This is helpful if you want a
               chatbot to know the full context of the document.
@@ -149,24 +149,24 @@ class SearchResource(SyncAPIResource):
         self,
         *,
         q: str,
-        categories_filter: List[Literal["technology", "science", "business", "health"]] | NotGiven = NOT_GIVEN,
-        chunk_threshold: float | NotGiven = NOT_GIVEN,
-        container_tags: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
-        doc_id: str | NotGiven = NOT_GIVEN,
-        document_threshold: float | NotGiven = NOT_GIVEN,
-        filters: search_execute_params.Filters | NotGiven = NOT_GIVEN,
-        include_full_docs: bool | NotGiven = NOT_GIVEN,
-        include_summary: bool | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        only_matching_chunks: bool | NotGiven = NOT_GIVEN,
-        rerank: bool | NotGiven = NOT_GIVEN,
-        rewrite_query: bool | NotGiven = NOT_GIVEN,
+        categories_filter: List[Literal["technology", "science", "business", "health"]] | Omit = omit,
+        chunk_threshold: float | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        doc_id: str | Omit = omit,
+        document_threshold: float | Omit = omit,
+        filters: search_execute_params.Filters | Omit = omit,
+        include_full_docs: bool | Omit = omit,
+        include_summary: bool | Omit = omit,
+        limit: int | Omit = omit,
+        only_matching_chunks: bool | Omit = omit,
+        rerank: bool | Omit = omit,
+        rewrite_query: 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchExecuteResponse:
         """
         Search memories with advanced filtering
@@ -190,7 +190,7 @@ class SearchResource(SyncAPIResource):
               most documents, more results), 1 is most sensitive (returns lesser documents,
               accurate results)
 
-          filters: Optional filters to apply to the search
+          filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           include_full_docs: If true, include full document in the response. This is helpful if you want a
               chatbot to know the full context of the document.
@@ -248,19 +248,19 @@ class SearchResource(SyncAPIResource):
         self,
         *,
         q: str,
-        container_tag: str | NotGiven = NOT_GIVEN,
-        filters: search_memories_params.Filters | NotGiven = NOT_GIVEN,
-        include: search_memories_params.Include | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        rerank: bool | NotGiven = NOT_GIVEN,
-        rewrite_query: bool | NotGiven = NOT_GIVEN,
-        threshold: float | NotGiven = NOT_GIVEN,
+        container_tag: str | Omit = omit,
+        filters: search_memories_params.Filters | Omit = omit,
+        include: search_memories_params.Include | Omit = omit,
+        limit: int | Omit = omit,
+        rerank: bool | Omit = omit,
+        rewrite_query: bool | Omit = omit,
+        threshold: float | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchMemoriesResponse:
         """
         Search memory entries - Low latency for conversational
@@ -271,7 +271,7 @@ class SearchResource(SyncAPIResource):
           container_tag: Optional tag this search should be containerized by. This can be an ID for your
               user, a project ID, or any other identifier you wish to use to filter memories.
 
-          filters: Optional filters to apply to the search
+          filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           limit: Maximum number of results to return
 
@@ -339,24 +339,24 @@ class AsyncSearchResource(AsyncAPIResource):
         self,
         *,
         q: str,
-        categories_filter: List[Literal["technology", "science", "business", "health"]] | NotGiven = NOT_GIVEN,
-        chunk_threshold: float | NotGiven = NOT_GIVEN,
-        container_tags: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
-        doc_id: str | NotGiven = NOT_GIVEN,
-        document_threshold: float | NotGiven = NOT_GIVEN,
-        filters: search_documents_params.Filters | NotGiven = NOT_GIVEN,
-        include_full_docs: bool | NotGiven = NOT_GIVEN,
-        include_summary: bool | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        only_matching_chunks: bool | NotGiven = NOT_GIVEN,
-        rerank: bool | NotGiven = NOT_GIVEN,
-        rewrite_query: bool | NotGiven = NOT_GIVEN,
+        categories_filter: List[Literal["technology", "science", "business", "health"]] | Omit = omit,
+        chunk_threshold: float | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        doc_id: str | Omit = omit,
+        document_threshold: float | Omit = omit,
+        filters: search_documents_params.Filters | Omit = omit,
+        include_full_docs: bool | Omit = omit,
+        include_summary: bool | Omit = omit,
+        limit: int | Omit = omit,
+        only_matching_chunks: bool | Omit = omit,
+        rerank: bool | Omit = omit,
+        rewrite_query: 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchDocumentsResponse:
         """
         Search memories with advanced filtering
@@ -380,7 +380,7 @@ class AsyncSearchResource(AsyncAPIResource):
               most documents, more results), 1 is most sensitive (returns lesser documents,
               accurate results)
 
-          filters: Optional filters to apply to the search
+          filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           include_full_docs: If true, include full document in the response. This is helpful if you want a
               chatbot to know the full context of the document.
@@ -438,24 +438,24 @@ class AsyncSearchResource(AsyncAPIResource):
         self,
         *,
         q: str,
-        categories_filter: List[Literal["technology", "science", "business", "health"]] | NotGiven = NOT_GIVEN,
-        chunk_threshold: float | NotGiven = NOT_GIVEN,
-        container_tags: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
-        doc_id: str | NotGiven = NOT_GIVEN,
-        document_threshold: float | NotGiven = NOT_GIVEN,
-        filters: search_execute_params.Filters | NotGiven = NOT_GIVEN,
-        include_full_docs: bool | NotGiven = NOT_GIVEN,
-        include_summary: bool | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        only_matching_chunks: bool | NotGiven = NOT_GIVEN,
-        rerank: bool | NotGiven = NOT_GIVEN,
-        rewrite_query: bool | NotGiven = NOT_GIVEN,
+        categories_filter: List[Literal["technology", "science", "business", "health"]] | Omit = omit,
+        chunk_threshold: float | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        doc_id: str | Omit = omit,
+        document_threshold: float | Omit = omit,
+        filters: search_execute_params.Filters | Omit = omit,
+        include_full_docs: bool | Omit = omit,
+        include_summary: bool | Omit = omit,
+        limit: int | Omit = omit,
+        only_matching_chunks: bool | Omit = omit,
+        rerank: bool | Omit = omit,
+        rewrite_query: 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchExecuteResponse:
         """
         Search memories with advanced filtering
@@ -479,7 +479,7 @@ class AsyncSearchResource(AsyncAPIResource):
               most documents, more results), 1 is most sensitive (returns lesser documents,
               accurate results)
 
-          filters: Optional filters to apply to the search
+          filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           include_full_docs: If true, include full document in the response. This is helpful if you want a
               chatbot to know the full context of the document.
@@ -537,19 +537,19 @@ class AsyncSearchResource(AsyncAPIResource):
         self,
         *,
         q: str,
-        container_tag: str | NotGiven = NOT_GIVEN,
-        filters: search_memories_params.Filters | NotGiven = NOT_GIVEN,
-        include: search_memories_params.Include | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        rerank: bool | NotGiven = NOT_GIVEN,
-        rewrite_query: bool | NotGiven = NOT_GIVEN,
-        threshold: float | NotGiven = NOT_GIVEN,
+        container_tag: str | Omit = omit,
+        filters: search_memories_params.Filters | Omit = omit,
+        include: search_memories_params.Include | Omit = omit,
+        limit: int | Omit = omit,
+        rerank: bool | Omit = omit,
+        rewrite_query: bool | Omit = omit,
+        threshold: float | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchMemoriesResponse:
         """
         Search memory entries - Low latency for conversational
@@ -560,7 +560,7 @@ class AsyncSearchResource(AsyncAPIResource):
           container_tag: Optional tag this search should be containerized by. This can be an ID for your
               user, a project ID, or any other identifier you wish to use to filter memories.
 
-          filters: Optional filters to apply to the search
+          filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           limit: Maximum number of results to return
 

supermemory/resources/settings.py

@@ -7,7 +7,7 @@ from typing import Dict, Union, Iterable, Optional
 import httpx
 
 from ..types import setting_update_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -47,25 +47,25 @@ class SettingsResource(SyncAPIResource):
     def update(
         self,
         *,
-        exclude_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
-        filter_prompt: Optional[str] | NotGiven = NOT_GIVEN,
-        google_drive_client_id: Optional[str] | NotGiven = NOT_GIVEN,
-        google_drive_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
-        google_drive_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
-        include_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
-        notion_client_id: Optional[str] | NotGiven = NOT_GIVEN,
-        notion_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
-        notion_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
-        onedrive_client_id: Optional[str] | NotGiven = NOT_GIVEN,
-        onedrive_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
-        onedrive_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
-        should_llm_filter: Optional[bool] | NotGiven = NOT_GIVEN,
+        exclude_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | Omit = omit,
+        filter_prompt: Optional[str] | 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,
+        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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SettingUpdateResponse:
         """
         Update settings for an organization
@@ -113,7 +113,7 @@ class SettingsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SettingGetResponse:
         """Get settings for an organization"""
         return self._get(
@@ -148,25 +148,25 @@ class AsyncSettingsResource(AsyncAPIResource):
     async def update(
         self,
         *,
-        exclude_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
-        filter_prompt: Optional[str] | NotGiven = NOT_GIVEN,
-        google_drive_client_id: Optional[str] | NotGiven = NOT_GIVEN,
-        google_drive_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
-        google_drive_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
-        include_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
-        notion_client_id: Optional[str] | NotGiven = NOT_GIVEN,
-        notion_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
-        notion_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
-        onedrive_client_id: Optional[str] | NotGiven = NOT_GIVEN,
-        onedrive_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
-        onedrive_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
-        should_llm_filter: Optional[bool] | NotGiven = NOT_GIVEN,
+        exclude_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | Omit = omit,
+        filter_prompt: Optional[str] | 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,
+        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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SettingUpdateResponse:
         """
         Update settings for an organization
@@ -214,7 +214,7 @@ class AsyncSettingsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SettingGetResponse:
         """Get settings for an organization"""
         return await self._get(

supermemory/types/__init__.py

@@ -2,10 +2,23 @@
 
 from __future__ import annotations
 
+from .memory_add_params import MemoryAddParams as MemoryAddParams
+from .memory_list_params import MemoryListParams as MemoryListParams
+from .document_add_params import DocumentAddParams as DocumentAddParams
+from .memory_add_response import MemoryAddResponse as MemoryAddResponse
+from .memory_get_response import MemoryGetResponse as MemoryGetResponse
+from .document_list_params import DocumentListParams as DocumentListParams
+from .memory_list_response import MemoryListResponse as MemoryListResponse
+from .memory_update_params import MemoryUpdateParams as MemoryUpdateParams
 from .setting_get_response import SettingGetResponse as SettingGetResponse
+from .document_add_response import DocumentAddResponse as DocumentAddResponse
+from .document_get_response import DocumentGetResponse as DocumentGetResponse
 from .search_execute_params import SearchExecuteParams as SearchExecuteParams
 from .setting_update_params import SettingUpdateParams as SettingUpdateParams
 from .connection_list_params import ConnectionListParams as ConnectionListParams
+from .document_list_response import DocumentListResponse as DocumentListResponse
+from .document_update_params import DocumentUpdateParams as DocumentUpdateParams
+from .memory_update_response import MemoryUpdateResponse as MemoryUpdateResponse
 from .search_memories_params import SearchMemoriesParams as SearchMemoriesParams
 from .search_documents_params import SearchDocumentsParams as SearchDocumentsParams
 from .search_execute_response import SearchExecuteResponse as SearchExecuteResponse
@@ -13,12 +26,17 @@ from .setting_update_response import SettingUpdateResponse as SettingUpdateRespo
 from .connection_create_params import ConnectionCreateParams as ConnectionCreateParams
 from .connection_import_params import ConnectionImportParams as ConnectionImportParams
 from .connection_list_response import ConnectionListResponse as ConnectionListResponse
+from .document_update_response import DocumentUpdateResponse as DocumentUpdateResponse
 from .search_memories_response import SearchMemoriesResponse as SearchMemoriesResponse
+from .memory_upload_file_params import MemoryUploadFileParams as MemoryUploadFileParams
 from .search_documents_response import SearchDocumentsResponse as SearchDocumentsResponse
 from .connection_create_response import ConnectionCreateResponse as ConnectionCreateResponse
 from .connection_import_response import ConnectionImportResponse as ConnectionImportResponse
+from .document_upload_file_params import DocumentUploadFileParams as DocumentUploadFileParams
+from .memory_upload_file_response import MemoryUploadFileResponse as MemoryUploadFileResponse
 from .connection_get_by_id_response import ConnectionGetByIDResponse as ConnectionGetByIDResponse
 from .connection_get_by_tags_params import ConnectionGetByTagsParams as ConnectionGetByTagsParams
+from .document_upload_file_response import DocumentUploadFileResponse as DocumentUploadFileResponse
 from .connection_get_by_tags_response import ConnectionGetByTagsResponse as ConnectionGetByTagsResponse
 from .connection_delete_by_id_response import ConnectionDeleteByIDResponse as ConnectionDeleteByIDResponse
 from .connection_list_documents_params import ConnectionListDocumentsParams as ConnectionListDocumentsParams

supermemory/types/document_add_params.py

@@ -0,0 +1,69 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+
+__all__ = ["DocumentAddParams"]
+
+
+class DocumentAddParams(TypedDict, total=False):
+    content: Required[str]
+    """The content to extract and process into a document.
+
+    This can be a URL to a website, a PDF, an image, or a video.
+
+    Plaintext: Any plaintext format
+
+    URL: A URL to a website, PDF, image, or video
+
+    We automatically detect the content type from the url's response format.
+    """
+
+    container_tag: Annotated[str, PropertyInfo(alias="containerTag")]
+    """Optional tag 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.
+    """
+
+    container_tags: Annotated[SequenceNotStr[str], PropertyInfo(alias="containerTags")]
+    """
+    (DEPRECATED: Use containerTag instead) 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.
+    """
+
+    custom_id: Annotated[str, PropertyInfo(alias="customId")]
+    """Optional custom ID of the document.
+
+    This could be an ID from your database that will uniquely identify this
+    document.
+    """
+
+    file_type: Annotated[str, PropertyInfo(alias="fileType")]
+    """Optional file type override to force specific processing behavior.
+
+    Valid values: text, pdf, tweet, google_doc, google_slide, google_sheet, image,
+    video, notion_doc, webpage, onedrive
+    """
+
+    metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
+    """Optional metadata for the document.
+
+    This is used to store additional information about the document. You can use
+    this to store any additional information you need about the document. Metadata
+    can be filtered through. Keys must be strings and are case sensitive. Values can
+    be strings, numbers, or booleans. You cannot nest objects.
+    """
+
+    mime_type: Annotated[str, PropertyInfo(alias="mimeType")]
+    """Required when fileType is 'image' or 'video'.
+
+    Specifies the exact MIME type to use (e.g., 'image/png', 'image/jpeg',
+    'video/mp4', 'video/webm')
+    """

supermemory/types/document_add_response.py

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["DocumentAddResponse"]
+
+
+class DocumentAddResponse(BaseModel):
+    id: str
+
+    status: str

supermemory/types/document_get_response.py

@@ -0,0 +1,104 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["DocumentGetResponse"]
+
+
+class DocumentGetResponse(BaseModel):
+    id: str
+    """Unique identifier of the document."""
+
+    connection_id: Optional[str] = FieldInfo(alias="connectionId", default=None)
+    """Optional ID of connection the document was created from.
+
+    This is useful for identifying the source of the document.
+    """
+
+    content: Optional[str] = None
+    """The content to extract and process into a document.
+
+    This can be a URL to a website, a PDF, an image, or a video.
+
+    Plaintext: Any plaintext format
+
+    URL: A URL to a website, PDF, image, or video
+
+    We automatically detect the content type from the url's response format.
+    """
+
+    created_at: datetime = FieldInfo(alias="createdAt")
+    """Creation timestamp"""
+
+    custom_id: Optional[str] = FieldInfo(alias="customId", default=None)
+    """Optional custom ID of the document.
+
+    This could be an ID from your database that will uniquely identify this
+    document.
+    """
+
+    metadata: Union[str, float, bool, Dict[str, object], List[object], None] = None
+    """Optional metadata for the document.
+
+    This is used to store additional information about the document. You can use
+    this to store any additional information you need about the document. Metadata
+    can be filtered through. Keys must be strings and are case sensitive. Values can
+    be strings, numbers, or booleans. You cannot nest objects.
+    """
+
+    og_image: Optional[str] = FieldInfo(alias="ogImage", default=None)
+
+    source: Optional[str] = None
+    """Source of the document"""
+
+    status: Literal["unknown", "queued", "extracting", "chunking", "embedding", "indexing", "done", "failed"]
+    """Status of the document"""
+
+    summary: Optional[str] = None
+    """Summary of the document content"""
+
+    summary_embedding_model: Optional[str] = FieldInfo(alias="summaryEmbeddingModel", default=None)
+
+    summary_embedding_model_new: Optional[str] = FieldInfo(alias="summaryEmbeddingModelNew", default=None)
+
+    summary_embedding_new: Optional[List[float]] = FieldInfo(alias="summaryEmbeddingNew", default=None)
+
+    title: Optional[str] = None
+    """Title of the document"""
+
+    type: Literal[
+        "text",
+        "pdf",
+        "tweet",
+        "google_doc",
+        "google_slide",
+        "google_sheet",
+        "image",
+        "video",
+        "notion_doc",
+        "webpage",
+        "onedrive",
+    ]
+    """Type of the document"""
+
+    updated_at: datetime = FieldInfo(alias="updatedAt")
+    """Last update timestamp"""
+
+    container_tags: Optional[List[str]] = FieldInfo(alias="containerTags", default=None)
+    """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.
+    """
+
+    raw: None = None
+    """Raw content of the document"""
+
+    url: Optional[str] = None
+    """URL of the document"""