supermemory 3.0.0a1__py3-none-any.whl → 3.0.0a19__py3-none-any.whl

supermemory/types/memory_get_response.py

@@ -1,5 +1,11 @@
 # 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__ = ["MemoryGetResponse"]
@@ -7,5 +13,85 @@ __all__ = ["MemoryGetResponse"]
 
 class MemoryGetResponse(BaseModel):
     id: str
+    """Unique identifier of the memory."""
+
+    connection_id: Optional[str] = FieldInfo(alias="connectionId", default=None)
+    """Optional ID of connection the memory was created from.
+
+    This is useful for identifying the source of the memory.
+    """
+
+    content: Optional[str] = None
+    """The content to extract and process into a memory.
+
+    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 memory.
+
+    This could be an ID from your database that will uniquely identify this memory.
+    """
+
+    metadata: Union[str, float, bool, Dict[str, object], List[object], None] = None
+    """Optional metadata for the memory.
+
+    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.
+    """
+
+    og_image: Optional[str] = FieldInfo(alias="ogImage", default=None)
+
+    source: Optional[str] = None
+    """Source of the memory"""
+
+    status: Literal["unknown", "queued", "extracting", "chunking", "embedding", "indexing", "done", "failed"]
+    """Status of the memory"""
+
+    summary: Optional[str] = None
+    """Summary of the memory content"""
+
+    title: Optional[str] = None
+    """Title of the memory"""
+
+    type: Literal[
+        "text",
+        "pdf",
+        "tweet",
+        "google_doc",
+        "google_slide",
+        "google_sheet",
+        "image",
+        "video",
+        "notion_doc",
+        "webpage",
+        "onedrive",
+    ]
+    """Type of the memory"""
+
+    updated_at: datetime = FieldInfo(alias="updatedAt")
+    """Last update timestamp"""
+
+    url: Optional[str] = None
+    """URL of the memory"""
+
+    container_tags: Optional[List[str]] = FieldInfo(alias="containerTags", default=None)
+    """Optional tags this memory 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.
+    """
 
-    status: str
+    raw: None = None
+    """Raw content of the memory"""

supermemory/types/memory_update_params.py

@@ -12,7 +12,35 @@ __all__ = ["MemoryUpdateParams"]
 
 class MemoryUpdateParams(TypedDict, total=False):
     content: Required[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.
+
+    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_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
+    """Optional tags this memory 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.
+    """
+
+    custom_id: Annotated[str, PropertyInfo(alias="customId")]
+    """Optional custom ID of the memory.
+
+    This could be an ID from your database that will uniquely identify this memory.
+    """
 
     metadata: Dict[str, Union[str, float, bool]]
+    """Optional metadata for the memory.
+
+    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.
+    """

supermemory/types/setting_get_response.py

@@ -1,6 +1,8 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict
+from typing import Dict, List, Union, Optional
+
+from pydantic import Field as FieldInfo
 
 from .._models import BaseModel
 
@@ -8,4 +10,36 @@ __all__ = ["SettingGetResponse"]
 
 
 class SettingGetResponse(BaseModel):
-    settings: Dict[str, object]
+    exclude_items: Union[str, float, bool, Dict[str, object], List[object], None] = FieldInfo(
+        alias="excludeItems", default=None
+    )
+
+    filter_prompt: Optional[str] = FieldInfo(alias="filterPrompt", default=None)
+
+    filter_tags: Union[str, float, bool, Dict[str, object], List[object], None] = FieldInfo(
+        alias="filterTags", default=None
+    )
+
+    google_drive_client_id: Optional[str] = FieldInfo(alias="googleDriveClientId", default=None)
+
+    google_drive_client_secret: Optional[str] = FieldInfo(alias="googleDriveClientSecret", default=None)
+
+    google_drive_custom_key_enabled: Optional[bool] = FieldInfo(alias="googleDriveCustomKeyEnabled", default=None)
+
+    include_items: Union[str, float, bool, Dict[str, object], List[object], None] = FieldInfo(
+        alias="includeItems", default=None
+    )
+
+    notion_client_id: Optional[str] = FieldInfo(alias="notionClientId", default=None)
+
+    notion_client_secret: Optional[str] = FieldInfo(alias="notionClientSecret", default=None)
+
+    notion_custom_key_enabled: Optional[bool] = FieldInfo(alias="notionCustomKeyEnabled", default=None)
+
+    onedrive_client_id: Optional[str] = FieldInfo(alias="onedriveClientId", default=None)
+
+    onedrive_client_secret: Optional[str] = FieldInfo(alias="onedriveClientSecret", default=None)
+
+    onedrive_custom_key_enabled: Optional[bool] = FieldInfo(alias="onedriveCustomKeyEnabled", default=None)
+
+    should_llm_filter: Optional[bool] = FieldInfo(alias="shouldLLMFilter", default=None)

supermemory/types/setting_update_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, List
+from typing import Dict, Union, Iterable, Optional
 from typing_extensions import Annotated, TypedDict
 
 from .._utils import PropertyInfo
@@ -11,12 +11,36 @@ __all__ = ["SettingUpdateParams"]
 
 
 class SettingUpdateParams(TypedDict, total=False):
-    exclude_items: Annotated[List[str], PropertyInfo(alias="excludeItems")]
+    exclude_items: Annotated[
+        Union[str, float, bool, Dict[str, object], Iterable[object], None], PropertyInfo(alias="excludeItems")
+    ]
 
-    filter_prompt: Annotated[str, PropertyInfo(alias="filterPrompt")]
+    filter_prompt: Annotated[Optional[str], PropertyInfo(alias="filterPrompt")]
 
-    filter_tags: Annotated[Dict[str, List[str]], PropertyInfo(alias="filterTags")]
+    filter_tags: Annotated[
+        Union[str, float, bool, Dict[str, object], Iterable[object], None], PropertyInfo(alias="filterTags")
+    ]
 
-    include_items: Annotated[List[str], PropertyInfo(alias="includeItems")]
+    google_drive_client_id: Annotated[Optional[str], PropertyInfo(alias="googleDriveClientId")]
 
-    should_llm_filter: Annotated[bool, PropertyInfo(alias="shouldLLMFilter")]
+    google_drive_client_secret: Annotated[Optional[str], PropertyInfo(alias="googleDriveClientSecret")]
+
+    google_drive_custom_key_enabled: Annotated[Optional[bool], PropertyInfo(alias="googleDriveCustomKeyEnabled")]
+
+    include_items: Annotated[
+        Union[str, float, bool, Dict[str, object], Iterable[object], None], PropertyInfo(alias="includeItems")
+    ]
+
+    notion_client_id: Annotated[Optional[str], PropertyInfo(alias="notionClientId")]
+
+    notion_client_secret: Annotated[Optional[str], PropertyInfo(alias="notionClientSecret")]
+
+    notion_custom_key_enabled: Annotated[Optional[bool], PropertyInfo(alias="notionCustomKeyEnabled")]
+
+    onedrive_client_id: Annotated[Optional[str], PropertyInfo(alias="onedriveClientId")]
+
+    onedrive_client_secret: Annotated[Optional[str], PropertyInfo(alias="onedriveClientSecret")]
+
+    onedrive_custom_key_enabled: Annotated[Optional[bool], PropertyInfo(alias="onedriveCustomKeyEnabled")]
+
+    should_llm_filter: Annotated[Optional[bool], PropertyInfo(alias="shouldLLMFilter")]

supermemory/types/setting_update_response.py

@@ -1,27 +1,53 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, List, Optional
+from typing import Dict, List, Union, Optional
 
 from pydantic import Field as FieldInfo
 
 from .._models import BaseModel
 
-__all__ = ["SettingUpdateResponse", "Settings"]
+__all__ = ["SettingUpdateResponse", "Updated"]
 
 
-class Settings(BaseModel):
-    exclude_items: Optional[List[str]] = FieldInfo(alias="excludeItems", default=None)
+class Updated(BaseModel):
+    exclude_items: Union[str, float, bool, Dict[str, object], List[object], None] = FieldInfo(
+        alias="excludeItems", default=None
+    )
 
     filter_prompt: Optional[str] = FieldInfo(alias="filterPrompt", default=None)
 
-    filter_tags: Optional[Dict[str, List[str]]] = FieldInfo(alias="filterTags", default=None)
+    filter_tags: Union[str, float, bool, Dict[str, object], List[object], None] = FieldInfo(
+        alias="filterTags", default=None
+    )
 
-    include_items: Optional[List[str]] = FieldInfo(alias="includeItems", default=None)
+    google_drive_client_id: Optional[str] = FieldInfo(alias="googleDriveClientId", default=None)
+
+    google_drive_client_secret: Optional[str] = FieldInfo(alias="googleDriveClientSecret", default=None)
+
+    google_drive_custom_key_enabled: Optional[bool] = FieldInfo(alias="googleDriveCustomKeyEnabled", default=None)
+
+    include_items: Union[str, float, bool, Dict[str, object], List[object], None] = FieldInfo(
+        alias="includeItems", default=None
+    )
+
+    notion_client_id: Optional[str] = FieldInfo(alias="notionClientId", default=None)
+
+    notion_client_secret: Optional[str] = FieldInfo(alias="notionClientSecret", default=None)
+
+    notion_custom_key_enabled: Optional[bool] = FieldInfo(alias="notionCustomKeyEnabled", default=None)
+
+    onedrive_client_id: Optional[str] = FieldInfo(alias="onedriveClientId", default=None)
+
+    onedrive_client_secret: Optional[str] = FieldInfo(alias="onedriveClientSecret", default=None)
+
+    onedrive_custom_key_enabled: Optional[bool] = FieldInfo(alias="onedriveCustomKeyEnabled", default=None)
 
     should_llm_filter: Optional[bool] = FieldInfo(alias="shouldLLMFilter", default=None)
 
 
 class SettingUpdateResponse(BaseModel):
-    message: str
+    org_id: str = FieldInfo(alias="orgId")
+
+    org_slug: str = FieldInfo(alias="orgSlug")
 
-    settings: Settings
+    updated: Updated

{supermemory-3.0.0a1.dist-info → supermemory-3.0.0a19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: supermemory
-Version: 3.0.0a1
+Version: 3.0.0a19
 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
@@ -27,11 +27,14 @@ Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pydantic<3,>=1.9.0
 Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.10
+Provides-Extra: aiohttp
+Requires-Dist: aiohttp; extra == 'aiohttp'
+Requires-Dist: httpx-aiohttp>=0.1.6; extra == 'aiohttp'
 Description-Content-Type: text/markdown
 
 # Supermemory Python API library
 
-[![PyPI version](https://img.shields.io/pypi/v/supermemory.svg)](https://pypi.org/project/supermemory/)
+[![PyPI version](https://github.com/supermemoryai/python-sdk/tree/main/<https://img.shields.io/pypi/v/supermemory.svg?label=pypi%20(stable)>)](https://pypi.org/project/supermemory/)
 
 The Supermemory Python library provides convenient access to the Supermemory REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,
@@ -62,10 +65,10 @@ client = Supermemory(
     api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
 )
 
-response = client.search.execute(
-    q="documents related to python",
+response = client.memories.add(
+    content="This is a detailed article about machine learning concepts...",
 )
-print(response.results)
+print(response.id)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -88,10 +91,10 @@ client = AsyncSupermemory(
 
 
 async def main() -> None:
-    response = await client.search.execute(
-        q="documents related to python",
+    response = await client.memories.add(
+        content="This is a detailed article about machine learning concepts...",
     )
-    print(response.results)
+    print(response.id)
 
 
 asyncio.run(main())
@@ -99,6 +102,40 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+### With aiohttp
+
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
+
+You can enable this by installing `aiohttp`:
+
+```sh
+# install from PyPI
+pip install --pre supermemory[aiohttp]
+```
+
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
+
+```python
+import os
+import asyncio
+from supermemory import DefaultAioHttpClient
+from supermemory import AsyncSupermemory
+
+
+async def main() -> None:
+    async with AsyncSupermemory(
+        api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        response = await client.memories.add(
+            content="This is a detailed article about machine learning concepts...",
+        )
+        print(response.id)
+
+
+asyncio.run(main())
+```
+
 ## Using types
 
 Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
@@ -194,7 +231,7 @@ client.with_options(max_retries=5).memories.add(
 ### Timeouts
 
 By default requests time out after 1 minute. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from supermemory import Supermemory

supermemory-3.0.0a19.dist-info/RECORD

@@ -0,0 +1,48 @@
+supermemory/__init__.py,sha256=PDWpv0_OWO8lBFh21lQl5k0zrlBzcGf643CKXRoQgzM,2664
+supermemory/_base_client.py,sha256=r19iD2PFXhH75y9v6TNYPwd5NdYjZj3shFhuUnHZqlU,66720
+supermemory/_client.py,sha256=IMo1vJ8G5Ha05IPVyuUEFXrCOY83gKJGB6sdyAb-rUk,16388
+supermemory/_compat.py,sha256=VWemUKbj6DDkQ-O4baSpHVLJafotzeXmCQGJugfVTIw,6580
+supermemory/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
+supermemory/_exceptions.py,sha256=5nnX7W8L_eA6LkX3SBl7csJy5d9QEcDqRVuwDq8wVh8,3230
+supermemory/_files.py,sha256=GME47rR56vqhHb7qh5NZtaLIWsA6ZrCHHGdBKjB0Q3s,3620
+supermemory/_models.py,sha256=G1vczEodX0vUySeVKbF-mbzlaObNL1oVAYH4c65agRk,29131
+supermemory/_qs.py,sha256=AOkSz4rHtK4YI3ZU_kzea-zpwBUgEY8WniGmTPyEimc,4846
+supermemory/_resource.py,sha256=_wuaB1exMy-l-qqdJJdTv15hH5qBSN2Rj9CFwjXTZJU,1130
+supermemory/_response.py,sha256=Yh869-U8INkojKZHFsNw69z5Y2BrK2isgRJ8mifEURM,28848
+supermemory/_streaming.py,sha256=MGbosxSTqq0_JG52hvH2Z-Mr_Y95ws5UdFw77_iYukc,10120
+supermemory/_types.py,sha256=ohS8PFDHBFM-0ua6YsUlS55BPHft3xY6DhiIKaYrlN0,6202
+supermemory/_version.py,sha256=b3QTl7IoxrDY0LUsi8hUlqp9Xdg6gXtmipq5XSqohNg,172
+supermemory/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+supermemory/_utils/__init__.py,sha256=PNZ_QJuzZEgyYXqkO1HVhGkj5IU9bglVUcw7H-Knjzw,2062
+supermemory/_utils/_logs.py,sha256=iceljYaEUb4Q4q1SgbSzwSrlJA64ISbaccczzZ8Z9Vg,789
+supermemory/_utils/_proxy.py,sha256=aglnj2yBTDyGX9Akk2crZHrl10oqRmceUy2Zp008XEs,1975
+supermemory/_utils/_reflection.py,sha256=ZmGkIgT_PuwedyNBrrKGbxoWtkpytJNU1uU4QHnmEMU,1364
+supermemory/_utils/_resources_proxy.py,sha256=9MqlmhIEoyeVraNz90vnq1pS6EOxSqvYVlVK-CvLMmQ,614
+supermemory/_utils/_streams.py,sha256=SMC90diFFecpEg_zgDRVbdR3hSEIgVVij4taD-noMLM,289
+supermemory/_utils/_sync.py,sha256=TpGLrrhRNWTJtODNE6Fup3_k7zrWm1j2RlirzBwre-0,2862
+supermemory/_utils/_transform.py,sha256=n7kskEWz6o__aoNvhFoGVyDoalNe6mJwp-g7BWkdj88,15617
+supermemory/_utils/_typing.py,sha256=D0DbbNu8GnYQTSICnTSHDGsYXj8TcAKyhejb0XcnjtY,4602
+supermemory/_utils/_utils.py,sha256=ts4CiiuNpFiGB6YMdkQRh2SZvYvsl7mAF-JWHCcLDf4,12312
+supermemory/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
+supermemory/resources/__init__.py,sha256=iYwzfeiqmu2Lorat88bYVkp4CobBt60Gq_6GcygldLE,1569
+supermemory/resources/connections.py,sha256=PERpnnUiu2hQjDvX_toy1thiipXu25RQaahTIeUwb3w,10656
+supermemory/resources/memories.py,sha256=-CdL69kAKk5ANyAt4YiDksrxPI1KM2fU5hNddk9JK_U,25244
+supermemory/resources/settings.py,sha256=hzijwhQ9U_W5zDRbDjW27QdQU4CwqLkPRWkcALYSCok,12175
+supermemory/types/__init__.py,sha256=s2RgV_b8Nyhy9md8w6ZvmBekOtaKEFz8CuFWCx0y6LA,1172
+supermemory/types/connection_create_params.py,sha256=bYYKu3ns60PX6Mt34UQUpYwThB3SBZsKn5tW0c46DUM,630
+supermemory/types/connection_create_response.py,sha256=i4sb0DSRs7wVVd8xDBOtr7vw-YbaeZ7MydlQLYvlvJs,468
+supermemory/types/connection_get_response.py,sha256=9ujakZecSs89sItCpsyDQWWB59BtymxspKQKVJBofIg,606
+supermemory/types/memory_add_params.py,sha256=QG_aD0YXTJ8aSzwlKkv18nkrzl3asUakfFfR65mk9ss,1528
+supermemory/types/memory_add_response.py,sha256=5lim8sVXM7WzG8tUuKORHEe2lJc6yVWvyjylzNsLGjw,219
+supermemory/types/memory_get_response.py,sha256=sSCvX54IIoaVuifygi0IxiwHMKNNIGgg8eJJ-xu37BI,2850
+supermemory/types/memory_update_params.py,sha256=swEIF-CfcxWGzsiT8O_AbtzkyujMiafZpbi2GEXPuuw,1534
+supermemory/types/memory_update_response.py,sha256=fvfO9lGM8xv2EUOQfOSxqig6fx6-ykq7syW69er_2ng,225
+supermemory/types/memory_upload_file_params.py,sha256=vZUYsfyzEMxESmfSOPBcDINXN_Ts4rdFvdaDiIMkme0,329
+supermemory/types/memory_upload_file_response.py,sha256=KTq6AExBMz7eMt8az1TgMSSNMTktKk0d0xItCwHRNl0,233
+supermemory/types/setting_get_response.py,sha256=_CWSr9_-0alw57qSQOaMm-e_FsdXmxIRYhcmTMpdado,1789
+supermemory/types/setting_update_params.py,sha256=EWbqdSsoTJohQ1nbEbBdAvtR5co_hh7huH6XZ-t7MRM,1854
+supermemory/types/setting_update_response.py,sha256=Evd1U6QQDYyhD_hpKqS9k7ctvh0GNX4GHPdwBChVB44,1947
+supermemory-3.0.0a19.dist-info/METADATA,sha256=B8VKJteQgOwRzxM4rSedi_UHgc5_ubx7SfvBSIGGEa8,14958
+supermemory-3.0.0a19.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+supermemory-3.0.0a19.dist-info/licenses/LICENSE,sha256=M2NcpYEBpakciOULpWzo-xO2Lincf74gGwfaU00Sct0,11341
+supermemory-3.0.0a19.dist-info/RECORD,,