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

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"""

supermemory/types/document_list_params.py

@@ -0,0 +1,111 @@
+# 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",
+    "FiltersOrOrUnionMember0",
+    "FiltersOrOrOr",
+    "FiltersOrOrAnd",
+    "FiltersAnd",
+    "FiltersAndAnd",
+    "FiltersAndAndUnionMember0",
+    "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.
+    """
+
+    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 FiltersOrOrUnionMember0(TypedDict, total=False):
+    key: Required[str]
+
+    value: Required[str]
+
+    filter_type: Annotated[Literal["metadata", "numeric", "array_contains"], PropertyInfo(alias="filterType")]
+
+    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")]]
+
+
+class FiltersOrOrAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[object], PropertyInfo(alias="AND")]]
+
+
+FiltersOrOr: TypeAlias = Union[FiltersOrOrUnionMember0, FiltersOrOrOr, FiltersOrOrAnd]
+
+
+class FiltersOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[FiltersOrOr], PropertyInfo(alias="OR")]]
+
+
+class FiltersAndAndUnionMember0(TypedDict, total=False):
+    key: Required[str]
+
+    value: Required[str]
+
+    filter_type: Annotated[Literal["metadata", "numeric", "array_contains"], PropertyInfo(alias="filterType")]
+
+    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")]]
+
+
+class FiltersAndAndAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[object], PropertyInfo(alias="AND")]]
+
+
+FiltersAndAnd: TypeAlias = Union[FiltersAndAndUnionMember0, FiltersAndAndOr, FiltersAndAndAnd]
+
+
+class FiltersAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[FiltersAndAnd], PropertyInfo(alias="AND")]]
+
+
+Filters: TypeAlias = Union[FiltersOr, FiltersAnd]

supermemory/types/document_list_response.py

@@ -0,0 +1,95 @@
+# 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__ = ["DocumentListResponse", "Memory", "Pagination"]
+
+
+class Memory(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.
+    """
+
+    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.
+    """
+
+    status: Literal["unknown", "queued", "extracting", "chunking", "embedding", "indexing", "done", "failed"]
+    """Status of the document"""
+
+    summary: Optional[str] = None
+    """Summary of the document content"""
+
+    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.
+    """
+
+    content: Optional[str] = None
+    """Content of the document (only included when includeContent=true)"""
+
+
+class Pagination(BaseModel):
+    current_page: float = FieldInfo(alias="currentPage")
+
+    limit: float
+
+    total_items: float = FieldInfo(alias="totalItems")
+
+    total_pages: float = FieldInfo(alias="totalPages")
+
+
+class DocumentListResponse(BaseModel):
+    memories: List[Memory]
+
+    pagination: Pagination
+    """Pagination metadata"""

supermemory/types/document_update_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 Annotated, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+
+__all__ = ["DocumentUpdateParams"]
+
+
+class DocumentUpdateParams(TypedDict, total=False):
+    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.
+    """
+
+    content: 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.
+    """
+
+    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_update_response.py

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

supermemory/types/document_upload_file_params.py

@@ -0,0 +1,36 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._types import FileTypes
+from .._utils import PropertyInfo
+
+__all__ = ["DocumentUploadFileParams"]
+
+
+class DocumentUploadFileParams(TypedDict, total=False):
+    file: Required[FileTypes]
+    """File to upload and process"""
+
+    container_tags: Annotated[str, PropertyInfo(alias="containerTags")]
+    """Optional JSON string of container tags array.
+
+    This can be an ID for your user, a project ID, or any other identifier you wish
+    to use to group documents.
+    """
+
+    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
+    """
+
+    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_upload_file_response.py

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

supermemory/types/memory_add_params.py

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

supermemory/types/memory_get_response.py

@@ -13,16 +13,16 @@ __all__ = ["MemoryGetResponse"]
 
 class MemoryGetResponse(BaseModel):
     id: str
-    """Unique identifier of the memory."""
+    """Unique identifier of the document."""
 
     connection_id: Optional[str] = FieldInfo(alias="connectionId", default=None)
-    """Optional ID of connection the memory was created from.
+    """Optional ID of connection the document was created from.
 
-    This is useful for identifying the source of the memory.
+    This is useful for identifying the source of the document.
     """
 
     content: Optional[str] = None
-    """The content to extract and process into a memory.
+    """The content to extract and process into a document.
 
     This can be a URL to a website, a PDF, an image, or a video.
 
@@ -37,30 +37,31 @@ class MemoryGetResponse(BaseModel):
     """Creation timestamp"""
 
     custom_id: Optional[str] = FieldInfo(alias="customId", default=None)
-    """Optional custom ID of the memory.
+    """Optional custom ID of the document.
 
-    This could be an ID from your database that will uniquely identify this memory.
+    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 memory.
+    """Optional metadata for the document.
 
-    This is used to store additional information about the memory. You can use this
-    to store any additional information you need about the memory. Metadata can be
-    filtered through. Keys must be strings and are case sensitive. Values can be
-    strings, numbers, or booleans. You cannot nest objects.
+    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 memory"""
+    """Source of the document"""
 
     status: Literal["unknown", "queued", "extracting", "chunking", "embedding", "indexing", "done", "failed"]
-    """Status of the memory"""
+    """Status of the document"""
 
     summary: Optional[str] = None
-    """Summary of the memory content"""
+    """Summary of the document content"""
 
     summary_embedding_model: Optional[str] = FieldInfo(alias="summaryEmbeddingModel", default=None)
 
@@ -69,7 +70,7 @@ class MemoryGetResponse(BaseModel):
     summary_embedding_new: Optional[List[float]] = FieldInfo(alias="summaryEmbeddingNew", default=None)
 
     title: Optional[str] = None
-    """Title of the memory"""
+    """Title of the document"""
 
     type: Literal[
         "text",
@@ -84,20 +85,20 @@ class MemoryGetResponse(BaseModel):
         "webpage",
         "onedrive",
     ]
-    """Type of the memory"""
+    """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 memory should be containerized by.
+    """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 memories.
+    to use to group documents.
     """
 
     raw: None = None
-    """Raw content of the memory"""
+    """Raw content of the document"""
 
     url: Optional[str] = None
-    """URL of the memory"""
+    """URL of the document"""