supermemory 3.7.0__py3-none-any.whl

supermemory/types/document_add_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 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.
+    """
+
+    container_tag: Annotated[str, PropertyInfo(alias="containerTag")]
+    """Optional tag this document should be containerized by.
+
+    Max 100 characters, alphanumeric with hyphens and underscores only.
+    """
+
+    container_tags: Annotated[SequenceNotStr[str], PropertyInfo(alias="containerTags")]
+
+    custom_id: Annotated[str, PropertyInfo(alias="customId")]
+    """Optional custom ID of the document.
+
+    Max 100 characters, alphanumeric with hyphens and underscores only.
+    """
+
+    metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
+    """Optional metadata for the document."""

supermemory/types/document_add_response.py

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

supermemory/types/document_get_response.py

@@ -0,0 +1,103 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Union, Optional
+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: str = 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)
+
+    raw: object
+    """Raw content of the document"""
+
+    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: str = 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.
+    """
+
+    url: Optional[str] = None
+    """URL of the document"""

supermemory/types/document_list_params.py

@@ -0,0 +1,52 @@
+# 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", "FiltersAnd"]
+
+
+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 FiltersOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[object], PropertyInfo(alias="OR")]]
+
+
+class FiltersAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[object], PropertyInfo(alias="AND")]]
+
+
+Filters: TypeAlias = Union[FiltersOr, FiltersAnd]

supermemory/types/document_list_response.py

@@ -0,0 +1,94 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Union, Optional
+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: str = 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: str = 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")
+
+    total_items: float = FieldInfo(alias="totalItems")
+
+    total_pages: float = FieldInfo(alias="totalPages")
+
+    limit: Optional[float] = None
+
+
+class DocumentListResponse(BaseModel):
+    memories: List[Memory]
+
+    pagination: Pagination
+    """Pagination metadata"""

supermemory/types/document_update_params.py

@@ -0,0 +1,55 @@
+# 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.
+    """
+
+    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.
+    """

supermemory/types/document_update_response.py

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

supermemory/types/document_upload_file_params.py

@@ -0,0 +1,44 @@
+# 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 container tags.
+
+    Can be either a JSON string of an array (e.g., '["user_123", "project_123"]') or
+    a single string (e.g., 'user_123'). Single strings will be automatically
+    converted to an array.
+    """
+
+    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: str
+    """Optional metadata for the document as a JSON string.
+
+    This is used to store additional information about the document. Keys must be
+    strings and values can be strings, numbers, or booleans.
+    """
+
+    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,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["DocumentUploadFileResponse"]
+
+
+class DocumentUploadFileResponse(BaseModel):
+    id: str
+    """Unique identifier of the document"""
+
+    status: str
+    """Status of the document"""

supermemory/types/memory_add_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 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.
+    """
+
+    container_tag: Annotated[str, PropertyInfo(alias="containerTag")]
+    """Optional tag this document should be containerized by.
+
+    Max 100 characters, alphanumeric with hyphens and underscores only.
+    """
+
+    container_tags: Annotated[SequenceNotStr[str], PropertyInfo(alias="containerTags")]
+
+    custom_id: Annotated[str, PropertyInfo(alias="customId")]
+    """Optional custom ID of the document.
+
+    Max 100 characters, alphanumeric with hyphens and underscores only.
+    """
+
+    metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
+    """Optional metadata for the document."""

supermemory/types/memory_add_response.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["MemoryAddResponse"]
+
+
+class MemoryAddResponse(BaseModel):
+    id: str
+    """Unique identifier of the document"""
+
+    status: str
+    """Status of the document"""

supermemory/types/memory_get_response.py

@@ -0,0 +1,103 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Union, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["MemoryGetResponse"]
+
+
+class MemoryGetResponse(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: str = 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)
+
+    raw: object
+    """Raw content of the document"""
+
+    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: str = 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.
+    """
+
+    url: Optional[str] = None
+    """URL of the document"""

supermemory/types/memory_list_params.py

@@ -0,0 +1,52 @@
+# 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__ = ["MemoryListParams", "Filters", "FiltersOr", "FiltersAnd"]
+
+
+class MemoryListParams(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 FiltersOr(TypedDict, total=False):
+    or_: Required[Annotated[Iterable[object], PropertyInfo(alias="OR")]]
+
+
+class FiltersAnd(TypedDict, total=False):
+    and_: Required[Annotated[Iterable[object], PropertyInfo(alias="AND")]]
+
+
+Filters: TypeAlias = Union[FiltersOr, FiltersAnd]